The BOX series development boards support updating firmware through USB, you just need:
- USB Type-C cable
- Latest firmware bin file
Important Note:
If USB download fails, please hold down
Bootbutton and then pressResetbutton to initiates Firmware Download mode.
For the latest firmware, please refer to: https://github.com/espressif/esp-box/releases
- Choose the latest release version
- Click
Assetsto show more files - Choose an
xxxxxx.binto download
Please follow the link below correspond to your OS to update the firmware.
| Windows | Linux | macOS |
|---|---|---|
![]() |
![]() |
![]() |
We recommend using Windows 10 and above system. Under Windows 10 system, the driver of USB-Serial-Jtag will be downloaded automatically. If you use the Windows 7, please download and install USB-Serial-JTAG drive manually.
-
Connect your development board to the computer through USB Type-C cable.
-
Please make sure the computer is connected to the Internet first. When the driver is installed, you can find two new devices appear on
Device Managerlist,COMX(COM2for example) andUSB JTAG/serial debug unit, the former is used to download firmware or output program logs, the latter is used for JTAG debugging. -
Download Windows download tool and unzip it to any folder, then run the executable file
flash_download_tool_x.x.x.exe -
Please choose
chipType:ESP32S3,workMode:develop,loadMode:usb, then clickOKto enter the download tool config interface. -
Follow the instruction below to configure the downloaded tool:
- Choose the path of firmware
xxxx.bin, then set the download address to0x0. - Select the COM port, like
COM2for this PC. - Click
STARTto start the downloading.
- Choose the path of firmware
-
After downloading,
FINISHwill appear on the tool. Next, please reboot to run the new firmware!
-
Connect your development board to the computer through USB Type-C cable, there is no need to install the driver of
USB-Serial-Jtagunder Linux system. -
Install
esptool, input the following commands inTerminal(pipcan be specified aspip3) :pip install esptool -
Follow the instruction to download the firmware (
pipcan be specified aspip3):python -m esptool --chip esp32s3 write_flash 0x0 download_path/test_bin.bin0x0is the fixed flash addressdownload_path/test_bin.binneed be replaced with your firmware path and name.
-
After updating, the download tool will prompt
Hash of data verified. Next, please reboot to run the new firmware!
-
Connect your development board to the computer through USB Type-C cable, there is no need to install the driver of
USB-Serial-Jtagunder macOS. -
Install
esptool, input the following codes inTerminal(pip3can be specified aspip) :pip3 install esptool -
Follow the instruction to download the firmware (
pip3can be specified aspip):python3 -m esptool --chip esp32s3 write_flash 0x0 download_path/test_bin.bin0x0is the fixed flash address.download_path/test_bin.binneed be replaced with your firmware path and name.
-
After updating, the download tool will prompt
Hash of data verified. Next, please reboot to run the new firmware!











