Skip to content

Installation

Paul Andrews edited this page Apr 21, 2024 · 7 revisions

Overview

If this is your first install you might want to back up the existing firmware, however to do this you will need to install python3 and esptool.py. If you don't care to do this, just skip to one of the installation options below.

The preferred method of installation is to use a web browser, which has to be one of Chrome, Edge or Opera.

Backup

Once you have installed python and esptool.py run this command (replace <your port name> with the actual port your clock is connected to and adjust for location of files etc):

esptool.py --port <your port name> read_flash 0x0 0x400000 elekstubeipsv1.bin

Installation

I recommend you do a full install, i.e. choose 'Full Install' if you use the web browser method, or flash all of the binaries if you use one of the other methods.

If you installed the previous version, you could get away with just choosing 'Firmware Only' option if you use the web browser method, or just flashing firmware.bin if you use one of the other methods.

Using a Web Browser

Go here and scroll down to the Installation section.

  • Choose 'Full Install'. If this is the first time installing this software, choose 'erase' from the dialog that pops up, otherwise you only need to install the software. If the clock can't connect to WiFi you will be given the option to configure the connection.

Other Web Download Tools

Adafruit WebSerial ESPTool. You can only flash four files at a time. Flash all but littlefs.bin first, then flash littlefs.bin. You will need the table of file names and locations in the section below.

Using the Download Tool

  • Download the espressif download tool(!). The download includes documentation.
  • Download the binaries below.
  • Use the tool to flash the binaries to your clock

These are the binaries and the locations they need to be flashed to:

Binary Location
bootloader.bin 0x1000
partitions.bin 0x8000
boot_app0.bin 0xe000
firmware.bin 0x10000
littlefs.bin 0x180000

Using the Command Line

python esptool.py --chip esp32 --port <your port name> --baud 460800 --before default_reset --after hard_reset write_flash -z --flash_mode dio --flash_freq 40m --flash_size 4MB 0x1000 bootloader.bin 0x8000 partitions.bin 0xe000 boot_app0.bin 0x10000 firmware.bin 0x180000 littlefs.bin

Using the Adafruit Web Tools

  • Go the the Adafruit Web Tools page.
  • Set the the baud rate to 921600
  • Use the table below to upload the files. The web tools page only allows you to upload 4 files at once. Do the first four first, then the last one:
Binary Location
bootloader.bin 0x1000
partitions.bin 0x8000
boot_app0.bin 0xe000
firmware.bin 0x10000
littlefs.bin 0x180000

Restore the Original Firmware

If you want to or need to:

esptool.py --port <your port name> write_flash 0x0 elekstubeipsv1.bin

You might need to specify baud rate and flash frequency

Notes

  • Naturally esptool.py may not be in the same directory as the binaries
  • python might be called python3