Flashing ESP32 devices firmware MACOS


Check Data Cable
Plug your device into your computer using a USB cable and then do the following:
You may need to install a driver from Silicon Labs for the CP210X USB to UART bridge

Navigate to Apple Menu  > About This Mac > System Report... > Hardware > USB .
You should see something like CP210X USB to UART Bridge Controller . If you don't, you will need to install the appropriate driver from Silicon Labs.

Command Line Interface Instructions

Install Prerequisite Software

OS X comes with Python 2.7 installed, but not pip . The following uses Homebrew to install python3 which includes pip3 . On MacOS you will use pip3 instead > of pip .
Check if you have Homebrew installed with the following command. If it's not installed, follow the instructions on the Homebrew website before continuing.

brew -v

Check if you have python3 and pip installed with the following command.

python3 --version
pip3 --version

If python3 is not installed, install with Install Python3

brew install python3

Confirm pip3 was installed alongside python3

pip3 -v

Install esptool

pip3 install --upgrade esptool

Confirm Communication With Chip
Connect the radio to your computer using a data USB cable. Confirm your device is talking to your computer using the following command:

esptools.py chip_id .

# You should see a result similar to this:

mydir$ esptool chip_id
esptool.py v2.6
Found 2 serial ports
Serial port /dev/ttyUSB0
Detecting chip type... ESP32
Chip is ESP32D0WDQ6 (revision 1)
Features: WiFi, BT, Dual Core, 240MHz, VRef calibration in efuse,
Coding Scheme None
MAC: 24:6f:28:b5:36:71
Uploading stub...
Running stub...
Stub running...
Warning: ESP32 has no Chip ID. Reading MAC instead.
MAC: 24:6f:28:b5:36:71
Hard resetting via RTS pin...


Install/Update Firmware

Navigate to Firmware
cd into the directory where you unzipped the latest release. For example:

cd /Downloads/firmware/


./device-install.sh -f firmware-BOARD-VERSION.bin


./device-update.sh -f firmware-BOARD-VERSION.bin