ESP32-CC-Tool is an open-source, web-based tool for servicing Texas Instruments CC253x/CC254x single-chip systems.
It enables firmware flashing, backup and restore, memory access, device diagnostics, and recovery operations through a modern browser interface hosted on an ESP32-C3.
- 🌐 Embedded Web UI — no desktop software required
- 📄 Native Intel HEX (.hex) and binary (.bin) firmware support
- ⚡ Firmware flashing with verification
- 💾 Flash backup and restore
- 🔍 Automatic chip identification
- 🛠 Advanced debugger with execution control, register editing, memory inspection, and integrated disassembly
- 🔧 Flexible GPIO configuration with integrated wiring reference
- 🔓 Flash lock and unlock operations
- 📜 Comprehensive real-time operation log
- 📱 Full-featured interface for desktop and mobile browsers
ESP32-CC-Tool is a standalone web-based utility for servicing TI CC253x/CC254x devices using inexpensive ESP32-C3 hardware.
The application runs entirely on an ESP32-C3 and provides a responsive browser-based interface, eliminating the need for dedicated desktop software or proprietary programming tools for everyday service tasks.
ESP32-CC-Tool combines firmware flashing, backup and recovery, diagnostics, and advanced debugging in a single compact and portable solution.
Host
Any hardware based on the ESP32-C3.
Target
Any device or module based on the following Texas Instruments wireless SoCs:
- CC2530 / CC2531 / CC2533 — ZigBee®
- CC2540 / CC2541 — Bluetooth® Low Energy (BLE)
Download the latest prebuilt firmware from the Releases page.
Each release includes a ready-to-flash firmware image for compatible ESP32-C3 boards and modules.
Flash the downloaded firmware to any ESP32-C3-based board or module using one of the following tools:
- ESP Web Tool (browser-based, recommended)
- esptool.py (command line)
- Any other compatible ESP32 flashing utility
- Connect the ESP32-C3 board via USB.
- Load ESP32-CC-Tool.bin at flash address 0x0000.
- Click Program and wait for the flashing process to complete.
If the tool displays multiple flash segments by default, remove them and use only the merged firmware image at address 0x0000.
On the first boot, ESP32-CC-Tool starts in Access Point (AP) mode.
Connect to the Wi-Fi network:
SSID: ESP32-CC-Tool
Password: 12345678
Then open:
You can use the tool immediately in AP mode without connecting it to your local Wi-Fi network.
To access the tool from your local network, open the Settings page, enter your Wi-Fi credentials, and save the configuration.
After rebooting, the tool will be available at:
or by the IP address assigned by your router.
Provides fast and reliable firmware maintenance of TI CC253x/CC254x devices.
Features automatic chip identification, firmware programming, verification, flash backup, firmware recovery, and flash protection operations.
Supports direct programming of both Intel® HEX (.hex) and binary (.bin) firmware images. Flash contents can be backed up directly from the target device and saved as binary (.bin) images without requiring any file conversion.
Designed for developers and advanced users.
Provides CPU execution control, register inspection and modification, direct SFR and XREG access, XDATA memory browsing with integrated disassembly, breakpoint support, and GPIO monitoring for diagnostics, firmware analysis, and service operations.
Full Log provides a comprehensive real-time record of all communication with the target device, including executed commands, register access, memory operations, device responses, and diagnostic messages.
The Settings page allows Wi-Fi configuration and GPIO assignment customization for different ESP32-C3-based boards and modules directly from the web interface.
ESP32-CC-Tool has reached Stable Release status and is considered feature-complete.
Future updates will primarily focus on:
- 🎨 User interface refinements
- 🌍 Additional language localizations
- 🐞 Bug fixes and stability improvements
- 📖 Documentation enhancements
- 🔌 Support for additional ESP32 host platforms
No major architectural changes are currently planned.
Prebuilt firmware is available on the Releases page and is recommended for most users.
If you want to modify the project or build the latest development version, ESP32-CC-Tool is based on ESP-IDF and uses PlatformIO as its build environment.
Clone the repository, open it in Visual Studio Code with the PlatformIO extension installed, then build and upload the project using the standard PlatformIO workflow.
In addition to the standard PlatformIO build output, the build process automatically generates a merged firmware image (ESP32-CC-Tool.bin) in the firmware/ directory, which is created automatically if it does not already exist.
For a detailed description of the project architecture, module organization, implementation details, and HTTP API, see README-DEV.md and API.md.
ESP32-CC-Tool builds upon:
- ESP_CC_Flasher by atc1441
- ESP32-CC-Tool-Pro by z9m, which extended and adapted the original project for the ESP32 platform.
ESP32-CC-Tool continues this work with a substantially redesigned architecture, rewritten low-level communication layer, expanded functionality, and an enhanced web interface while remaining licensed under the GNU General Public License v3.0.
Special thanks to the original authors and contributors whose work made this project possible.
ESP32-CC-Tool is an open-source project developed and maintained in my spare time.
If you find this project useful and would like to say thank you:
Your support is sincerely appreciated, but never expected.
This project is licensed under the GNU General Public License v3.0 (GPL-3.0).
See the LICENSE file for the full license text.