Binary Installation

The pre-compiled binary files can be found here on the GitHub Releases Page (the right column on the projects start page). Currently there exists only one main firmware file called opendtu-generic.bin. This file contains the firmware for the ESP-WROOM32 module. Pre-compiled binaries for other controllers like the ESP32C2 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	Comment
opendtu-generic.bin	ESP32	No	Deprecated!
opendtu-generic_esp32.bin	ESP32	Yes
opendtu-generic_esp32s3.bin	ESP32-S3	Yes	For boards with usb-uart bridge
opendtu-generic_esp32s3_usb.bin	ESP32-S3	Yes	For boards with integrated usb connection

Initial flash procedure

Flash all in one .factory.bin file

For a first installation on an ESP32, download opendtu-generic*.factory.bin 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)

Download link

• On startup, select Chip Type -> "ESP32" / WorkMode -> "Develop"
• Prepare all settings (see picture). Make sure to uncheck the DoNotChgBin option. Otherwise you may get errors like "invalid header".
• 
• Press "Erase" button on screen. Look into the terminal window, you should see dots appear. Then 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.
• 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.