Skip to main content

esp32-arduino Build Instructions

For ESP32 boards, we use our own custom version of arduino-esp32 core. You can find the version used in the platform_packages argument in platformio.ini in the Meshtastic-device repo. It is built using a modified esp32-arduino-lib-builder which pulls the correct repos for some modified libraries. This allows for some fixes we've made that haven't yet been merged in master.

Most developers should not care about this, because you'll automatically get our fixed libraries. However, if you would like to tweak the core options this documentation describes how to do it in Linux:

Install ESP32 Arduino Lib Builder:

sudo apt-get install git wget curl libssl-dev libncurses-dev flex bison gperf python python-pip python-setuptools python-serial python-click python-cryptography python-future python-pyparsing python-pyelftools cmake ninja-build ccache
sudo pip install --upgrade pip
git clone
cd esp32-arduino-lib-builder

Install esp-idf (needed if you want to make menuconfig, will install it automatically if needed):


Run menuconfig and change options as needed:

make IDF_PATH=$(pwd)/esp-idf menuconfig

Patch the Azure_IoT library:

cd components/arduino/libraries/AzureIoT
patch -p1 < 15.patch
cd ../../../../

Build esp32-arduino:


Copy SDK files into the PlatformIO framework:

  cp -ar out/tools/sdk/* ~/.platformio/packages/framework-arduinoespressif32/tools/sdk

Flash the new bootloader if needed:

esp-idf/components/esptool_py/esptool/ --chip esp32 --port your_port --baud 921600 --before default_reset --after hard_reset write_flash -z --flash_mode dout --flash_freq 40m --flash_size detect 0x1000 build/bootloader/bootloader.bin