Skip to main content

Flashing Firmware

Prerequisites#

Check Data Cable#

To check if you have a data cable that will work, plug your device into the computer and then navigate to Terminal and enter the following command:

lsusb

you should see something like CP210X USB to UART Bridge Controller.

note

You may need to install a driver from Silicon Labs for the CP210X USB to UART bridge

Download Latest Firmware#

Prebuilt binaries for the supported radios are available in our releases. Your initial installation has to happen over USB from your Mac, Windows or Linux PC. Once our software is installed, all future software updates happen over bluetooth from your phone.

Current FirmwareList of Firmware Versions
note

The T-Beam 0.7 board is an earlier version of the T-Beam board, and due to changes in the design in subsequent iterations this board uses a specific firmware file different from the other T-Beam boards.

firmware-tbeam0.7-1.x.x.bin is the correct firmware. firmware-tbeam-1.x.x.bin is incompatible. For all other T-Beam boards firmware-tbeam-1.x.x.bin is the correct selection.

Command Line Interface Instructions#

Install Prerequisite Software#

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

python3 --version
pip3 --version

If python3 is not installed, install with

sudo apt-get update
sudo apt-get install python3.6

If pip is not installed, install with

sudo apt-get install python3-pip

Install esptool#

pip 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:

Command
esptool chip_id
Expected Output
# You should see a result similar to this:
mydir$ esptool chip_id
esptool.py v2.6
Found 2 serial ports
Serial port /dev/ttyUSB0
Connecting....
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...

Navigate to Firmware#

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

Example
cd /Downloads/firmware/

Install/Update Firmware#

caution

Be very careful to install the correct load for your board. In particular the popular 'T-BEAM' radio from TTGO is not called 'TTGO-Lora' (that is a different board). So don't install the 'TTGO-Lora' build on a TBEAM, it won't work correctly.

Install Firmware#

Install the correct firmware for your board using the following command. Be sure to select the correct board and frequency.

Command
./device-install.sh -f firmware-BOARD-VERSION.bin
Example
./device-install.sh -f firmware-heltec-EU865-1.2.0.bin

Update Firmware#

To update a the firmware on an existing Meshtastic device use the following command. Be sure to select the correct board and frequency.

Command
./device-update.sh -f firmware-BOARD-VERSION.bin
Example
./device-update.sh -f firmware-heltec-EU865-1.2.0.bin

Graphical User Interface Instructions#

Download ESPHome Flasher#

note

ESPHome Flasher also provides instructions to build from source or install via pip on their README.

ESPHome Flasher
note

ESPHome Flasher for linux is a prebuilt binary for Ubuntu. These instructions were only tested on Ubuntu. Mileage may very on other distros.

Open ESPHome Flasher#

There should be no installation required. Connect your device using a data USB cable and refresh the Serial Port. Select the port that your device is connected to.

note

If your device is not showing under Serial Port you may need to install the drivers for the CP210X USB to UART bridge.

Select Firmware#

Browse to the previously downloaded firmware and select the correct firmware based on the board type and frequency.

caution

Be very careful to install the correct load for your board. In particular the popular 'T-BEAM' radio from TTGO is not called 'TTGO-Lora' (that is a different board). So don't install the 'TTGO-Lora' build on a TBEAM, it won't work correctly.

Flash Firmware#

Select Flash ESP. It may take a minute or two. Once complete, "Done! Flashing is complete!" will be shown.

Over the Air Update Instructions#

OTA updates are only currently available on Android.