Flash Firmware on ESP32

Requirements

• Windows PC (for the official Homatic Flash Tool)
• USB data cable (not charge-only)
• USB-Serial driver (CH340 / CP2102)

Steps

1. Download Flash Tool

From the project repository: flash-tool/ — build or download the release from Homatic.

2. Connect ESP32

1. Plug ESP32 into USB.
2. Open Device Manager and confirm a COM port appears (for example COM3).

3. Run the tool

1. Open Homatic Flash Tool.
2. Select the correct COM Port.
3. Choose the firmware file (.bin or path from firmware/esp32-smarthome).
4. (Optional) Set DEVICE_NAME in the sketch before build to match esp32_name in the dashboard.

4. Flash

1. Click Flash.
2. Wait for Done or Success (typically 30–90 seconds).
3. Reset the ESP32 (RESET button).

5. Verify

1. Complete WiFi provisioning.
2. Monitor Serial output: WiFi connected + MQTT connected.

Troubleshooting

Error	Fix
Failed to connect	Hold BOOT during flash; try another cable/port
Timed out	Lower baud rate in advanced settings
Wrong chip	Select ESP32 (not ESP8266)

Next

WiFi provisioning step by step