Skip to content

Firmware Installation

Download Firmware

The pre-compiled binary files can be found 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.

Factory-Binaries

Important

When flashing OpenDTU-OnBattery onto the ESP32 for the first time, you need to flash it with the factory firmware binary file.

Binaries with .factory in their name include the firmware, the respective partition table, as well as the bootloader. Use these files to flash an ESP32 for the first time and after erasing the flash (to start from scratch).

Overview of Firmware Variants

  • All binary names start with opendtu-onbattery- and include the respective PlatformIO (PIO) environment name.
  • Use the non-factory binaries to perform OTA updates.
PIO Environmenti MCU Flash Size Comment
generic_esp32s3_usb[.factory].bin ESP32-S3 ≥ 8 MB For OpenDTU Fusion and ESP32-S3 boards with native USB connection.
generic_esp32s3[.factory].bin ESP32-S3 ≥ 8 MB For boards that only have a USB-UART bridge to the ESP32-S3.
generic_esp32_8mb[.factory].bin ESP32 ≥ 8 MB For ESP32 with at least 8 MB of flash.
generic_esp32_4mb_no_ota.factory.bin ESP32 4 MB For ESP32 with only 4 MB of flash, without support for OTA updates.
generic_esp32[.factory].bin ESP32 4 MB End of Life, do not use for new devices.
generic[.factory].bin ESP32 4 MB End of Life, previously deprecated, do not use for new devices.

Note

All firmware variants require a Device Profile to be configured after installing the firmware.

Write Firmware to ESP32

Follow the instructions to write ESP32 flash memory.