The TekOnline 8-Zone Controller uses an ESP32, so recovery firmware can be installed over USB. I wanted that process to stay straightforward even when the service laptop has no internet connection.
General ESP32 flashing tools already exist. ESPHome provides a desktop flasher, and ESP Web Tools can flash from a supported browser. This small Python GUI is tailored to the 8-zone service workflow: select a COM port and local factory image, then flash one or more selected controllers sequentially. Espressif’s esptool does the actual writing.
Prepare once, then flash offline
Install Python and the listed packages while online, then keep the flasher folder and factory .bin on the laptop. At flash time, the program does not download or compile anything. It writes the selected combined factory image at address 0x0 and reports the result for each selected serial port.
The bundled image is the latest factory release currently packaged in this project, dated 9 November 2026. The tool rejects ESPHome .ota.bin images because they are intended for updates to an already running compatible installation, not full factory recovery.
Match the image to the board revision
The 9 November image maps Zone 7 to GPIO4 and expects GPIO0 to remain available for ESP32 boot and programming. Older 8-zone boards use a different GPIO0 route, and the project records a resistor-patched test board. Check the board revision and its matching firmware notes before writing an image; a COM port alone does not identify the hardware.
The controller has relay outputs, so reset behavior matters during flashing. Confirm the connected hardware is safe to reset and follow the commissioning instructions for that board.
Existing tools
- ESPHome Flasher is a general desktop USB flasher.
- ESP Web Tools provides browser-based ESP flashing.
- Espressif esptool documentation describes the underlying flash commands.