Binary Installation - tbnobody/OpenDTU GitHub Wiki
The pre-compiled binary files can be found here on the GitHub Releases Page (the right column on the projects start page). Currently there are pre-compiled binaries for ESP32 and ESP32-S3 MCUs. Pre-compiled binaries for other controllers like the ESP32-C2 etc. may follow in future.
Overview of pre-compiled binaries
All pre-compiled binaries require a mandatory Device Profile. You have to upload one after flashing the firmware!
| Binary | MCU | Device Profile mandatory | First Flash / OTA | Comment |
|---|---|---|---|---|
| opendtu-generic.bin | ESP32 | No | OTA | Deprecated! |
| opendtu-generic.factory.bin | ESP32 | No | First Flash | Deprecated! |
| opendtu-generic_esp32.bin | ESP32 | Yes | OTA | |
| opendtu-generic_esp32.factory.bin | ESP32 | Yes | First Flash | |
| opendtu-generic_esp32s3.bin | ESP32-S3 | Yes | OTA | For boards with usb-uart bridge |
| opendtu-generic_esp32s3.factory.bin | ESP32-S3 | Yes | First Flash | For boards with usb-uart bridge |
| opendtu-generic_esp32s3_usb.bin | ESP32-S3 | Yes | OTA | For boards with integrated usb connection |
| opendtu-generic_esp32s3_usb.factory.bin | ESP32-S3 | Yes | First Flash | For boards with integrated usb connection |
Initial flash procedure
Flash all in one .factory.bin file
For a first installation, download opendtu-generic*.factory.bin (depending on your MCU) and use a ESP32 flash tool of your choice to flash the .bin file to the address 0x0.
Available Flash Tools
Flash with esptool.py (Linux)
Replace the port /dev/ttyUSB0 for your needs.
esptool.py --port /dev/ttyUSB0 --chip esp32 --before default_reset --after hard_reset \
write_flash --flash_mode dout --flash_freq 40m --flash_size detect \
0x0 opendtu-generic*.factory.bin
Flash with Espressif Flash Download Tool (Windows)
- On startup, select Chip Type -> "ESP32" / WorkMode -> "Develop"
- Prepare all settings (see picture). Make sure to uncheck the
DoNotChgBinoption. Otherwise you may get errors like "invalid header". - Press "Erase" button on screen. Look into the terminal window, you should see dots appear. On some boards, the automatic bootloader selection does not work. In this case you have to manually press the "Boot" button on the ESP32 board. Wait for "FINISH" to see if flashing/erasing is done.
- To program, press "Start" on screen, then the "Boot" button (if required).
- When flashing is complete (FINISH appears) then press the Reset button on the ESP32 board (or powercycle ) to start the OpenDTU application.
Flash with ESP_Flasher (Windows)
Users report that ESP_Flasher is suitable for flashing OpenDTU on Windows.
Flash with ESP_Flasher - web version
It is also possible to flash it via the web tools which might be more convenient and is platform independent.