Skip to content
This repository was archived by the owner on Nov 26, 2024. It is now read-only.

firmware_update.md

Latest commit

 

History

History
138 lines (94 loc) · 6.74 KB

firmware_update.md

File metadata and controls

138 lines (94 loc) · 6.74 KB

Updating Firmware

Warning:

The firmware released in the latest Tag branch (Version v0.5.0) is only applicable to ESP32-S3-BOX and ESP32-S3-BOX-Lite. For users who have purchased ESP32-S3-BOX-3, we will release firmware updates during the project's progression. We suggest that users update the firmware via Espressif's online firmware flashing tool ESP Launchpad.

The BOX series development boards support updating firmware through USB. To update firmware, you only need:

  1. A USB Type-C cable
  2. Latest firmware (bin file)

Important Note:

If the downloading through USB fails, please hold down the Boot button and then press the Reset button to initiate Firmware Download mode manually.

Downloading Latest Firmware

For the latest firmware, please go to https://github.com/espressif/esp-box/releases.

  1. Choose the latest release version.
  2. Click Assets to show more files.
  3. Choose an xxxxxx.bin and download it.

Updating Firmware

Please follow the link below corresponding to your OS to update the firmware.

ESP Launchpad Windows Linux macOS
Try it with ESP Launchpad

Updating Firmware with ESP-Launchpad (Recommended)

ESP Launchpad is a web based tool, available for flashing firmware application to the ESP32 device connected via USB serial port. You can just click here to start.

  1. Connect your development board to the computer through a USB Type-C cable.

  2. Connect the device follow indicated steps in the figure below.

  3. Choose a bin from Select Application and click Flash to update.

Updating Firmware for Windows

We recommend using Windows 10 and above. Under Windows 10 system, the driver of USB-Serial-Jtag will be downloaded automatically. If you use Windows 7, please download and install USB-Serial-JTAG drive manually.

  1. Download the latest firmware.

  2. Connect your development board to the computer through a USB Type-C cable.

  3. Please make sure the computer is connected to the Internet first. When the driver is installed, you can find two new devices appear on the Device Manager list, COMX (COM2 for example) and USB JTAG/serial debug unit. The first one is used to download firmware or output program logs, and the second one is used for JTAG debugging.

  4. Download Windows download tool, Flash Download Tools, and unzip it to any folder. Then double-click to run the executable file flash_download_tool_x.x.x.exe.

  5. Please set chipType to ESP32S3, workMode to develop, loadMode to usb. Then, click OK to enter the download tool configuration interface.

  6. Follow the instructions below to configure the downloaded tool:

    1. Choose the path of firmware xxxx.bin, and set the download address to 0x0.
    2. Select the COMX port (COM2 for example) for your PC.
    3. Click START to start the downloading.

  7. After the firmware is downloaded, FINISH will appear on the tool. Next, please press the Reset button to run the new firmware!

Updating Firmware for Linux

  1. Download the latest firmware.

  2. Connect your development board to the computer through a USB Type-C cable. There is no need to install the driver of USB-Serial-Jtag under Linux system.

  3. Install esptool by entering the following command in Terminal (pip can be specified as pip3):

    pip install esptool

  4. Follow the below instruction to download the firmware (pip can be specified as pip3):

    python -m esptool --chip esp32s3 write_flash 0x0 download_path/test_bin.bin
    1. 0x0 is the fixed flash address.
    2. download_path/test_bin.bin should be replaced with your firmware path and name.

  5. After the firmware is updated, the download tool will prompt Hash of data verified. Next, please press the Reset button to run the new firmware!

Updating Firmware for macOS

  1. Download the latest firmware.

  2. Connect your development board to the computer through a USB Type-C cable. There is no need to install the driver of USB-Serial-Jtag under macOS.

  3. Install esptool by entering the following command in Terminal (pip3 can be specified as pip):

    pip3 install esptool

  4. Follow the below instruction to download the firmware (pip3 can be specified as pip):

    python3 -m esptool --chip esp32s3 write_flash 0x0 download_path/test_bin.bin
    1. 0x0 is the fixed flash address.
    2. download_path/test_bin.bin should be replaced with your firmware path and name.

  5. After the firmware is updated, the download tool will prompt Hash of data verified. Next, please press the Reset button to run the new firmware!