Skip to content

Binary Installation

tbnobody edited this page May 25, 2023 · 12 revisions

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.

Initial flash procedure

Flash all in one .bin file

tbd.

Flash individual .bin files

For a first installation on an ESP32, download opendtu-generic.zip, unpack and use a ESP32 flash tool of your choice (see next chapter) to flash the .bin files to the right addresses.

Address File
0x1000 bootloader.bin
0x8000 partitions.bin
0xe000 boot_app0.bin
0x10000 opendtu-*.bin

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 \
  0x1000 bootloader.bin \
  0x8000 partitions.bin \
  0xe000 boot_app0.bin \
  0x10000 opendtu-generic.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". image
  • 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.

Future Updates

For further updates download opendtu-generic.bin and use the over-the-air firmware update in OpenDTU's web interface (Settings --> Firmware Update).

Clone this wiki locally