php-baremetal/phpbm

Firmware Tools First-party

You're too curious come back at the end of November

phpbm · Guide

Toolchains

Each SDK names the compiler and flashing tools it builds with. phpbm installs them once per machine under ~/.phpbm/toolchains.

phpbm toolchain:install, run inside a project, installs the toolchain of the project's SDK, or says it is already there. build, flash and sync check the toolchain first and stop with the reason when it is missing or unusable.

esp32: ESP-IDF

The esp32 SDK 2.0 builds with ESP-IDF v6.1, for the ESP32-S3 and ESP32-P4.

Needs Python 3.10 or later on the machine, and git.
Installs A shallow clone of ESP-IDF v6.1 into ~/.phpbm/toolchains/esp32/esp-idf-v6.1, its tools for both chips and its Python environment into ~/.phpbm/toolchains/esp32/tools.
Size About 6 GB.

A failed step (network, disk) stops with the reason; run phpbm toolchain:install again to resume.

Warning Windows

Install Python from python.org and tick "Add python.exe to PATH". ESP-IDF does not work from a path with spaces or non-ASCII characters: this applies to PHPBM_HOME and to your projects.

Variables the esp32 SDK reads:

Variable Meaning
PHPBM_PYTHON The Python 3.10+ to use, tried before python3 / py -3 on PATH.
PHPBM_ESP32_IDF_PATH An ESP-IDF v6.1 you manage yourself. phpbm uses it and never installs into it: install its tools with ESP-IDF's own idf_tools.py.
PHPBM_ESP32_IDF_TOOLS_PATH With PHPBM_ESP32_IDF_PATH: where that ESP-IDF's tools live. IDF_TOOLS_PATH is also read; the default is ~/.espressif.
Last updated 2026-11-05 · v0.0.x Edit on GitHub Report issue