WebFlasher_Introduction

Canonical Documentation

Please also have a look at the installation documentation in the canonical documentation.

Community WebFlasher

Community WebFlasher
Quick guide: Please connect the ESP module to be flashed to a Mac, Linux PC or Windows PC using a USB cable (for Windows, please wait until the drivers have been installed, this may take a few minutes). / Kurzanleitung: Bitte das zu flashende ESP-Modul per USB-Kabel an einen Mac, Linux PC, oder Windows PC anstecken (bei Windows bitte warten, bis die Treiber installiert wurden, dies kann einige Minuten dauern).

Select the desired firmware version (Stable Release/Dev) and the language (if available) / Die gewünschte Firmware Version wählen (Stable Release/Dev) sowie die Sprache auswählen (falls verfügbar)

After the selection, a list of compatible ESP boards appears at the top. / Nach der Auswahl erscheint oben eine Liste der kompatiblen ESP Boards.

If the existing ESP board appears in the list, click on the Install Release/Development Build button. / Wenn das vorhandene ESP Board in der Liste erscheint, auf den Release/Development Build installieren Button klicken.

Select the appropriate USB Serial Port and click Connect. / den zutreffenden USB Serial Port auswählen, und auf Verbinden klicken.

---

Note #1: Before starting the flash process you may have to manually put the ESP into bootloader mode.
Most boards are able to do this automatically, but sometimes that is not working . If so, then you have to do it manually:

• Connect GPIO0 to GND before booting the device (often there is a BOOT or similar button which does this when pressed)
• Power-on or reset the ESP32 while GPIO0 is connected to GND
• Start the flash process

Note #2: Before starting the flash process remove any connected hardware you may have on your board. There have been cases where the flash process could not start without removing connected HW.

Note #3: If you have an ESP32-S3, you can use either of the two USB Type-C Ports, in theory it should not make a difference.
Many users however have experienced problems! If you do, switch USB Port and try again.

---

---

Extra Information for OpenDTU Fusion Users

You are installing opendtu-onbattery-generic_esp32s3_usb.factory.bin (ofcourse). For OpenDTU Fusion boards, the pin_mapping.json (see device profile) is installed automatically, and does not need to be uploaded to OpenDTU afterwards. / Anmerkung: Bei OpenDTU Fusion Boards wird die pin_mapping.json (see device profile) automatisch installiert, und muss nicht nachträglich in die OpenDTU hochgeladen werden.

Extra Information for ESP32-S3 Users using pre-compiled binaries

Most ESP32-S3 boards have two Type-C connection Ports, one native USB and one USB-to-UART).

As a rule of the thumb, use the pre-compiled binaries with _usb at the end of the name (whether you flash with cable or OTA).

• First Flash:
  • Use opendtu-onbattery-generic_esp32s3_usb.factory.bin (For boards with integrated usb connection)
  • With cable, you can flash opendtu-generic_esp32s3_usb.factory.bin using any of the two Ports.

If you are connected to the port with the USB-to-UART bridge, there will be no output after starting because the console's output is sent to the native USB port.

• OTA Update:
  • Use opendtu-onbattery-generic_esp32s3_usb.bin (For boards with integrated usb connection)

The variant opendtu-onbattery-generic_esp32s3.factory.bin / opendtu-onbattery-generic_esp32s3.bin (For boards with USB-UART bridge) continues to write messages via UART, using a hardware UART, and this data is then translated to USB by the UART bridge. This, however, occupies one of the three available hardware UARTs, which is generally undesirable.

Extra information for users with onBattery Pro PCB Boards

The boards arrive already flashed.

For OTA Updates, use opendtu-onbattery-generic_esp32s3_usb.bin.