- Python: Installed on your computer
- Pip: Python package installer
- USB Cable: Appropriate for your device
- Meshtastic Device: Ensure the antenna is connected before powering on
-
Install esptool
- Open your terminal or command prompt.
- Install esptool by running:
pip install esptool
-
Download Firmware
- Visit the Meshtastic Firmware Releases page.
- Download the appropriate
.bin
firmware file for your device.
-
Identify Serial Port
- Determine the serial port your device is connected to:
- Windows: Check Device Manager under "Ports (COM & LPT)".
- macOS/Linux: Run
ls /dev/tty.*
orls /dev/serial/by-id/*
.
- Determine the serial port your device is connected to:
-
Put Device in Bootloader Mode
- For devices with a reset button: Press the reset button twice quickly.
- For devices without a reset button: Consult your device's manual.
-
Flash Firmware
- Run the following command, replacing
[PORT]
with your device's port and[FIRMWARE_FILE]
with the path to the firmware file:esptool.py --chip esp32 --port [PORT] write_flash -z 0x1000 [FIRMWARE_FILE]
- Run the following command, replacing
-
Completion
- Once flashing is complete, reset the device to exit bootloader mode.
- Ensure esptool is installed correctly and accessible in your PATH.
- Verify the correct serial port is used.
- For detailed instructions, refer to the Meshtastic CLI Flashing Guide.