Downloadable IDF Tools
The ESP-IDF build process relies on a number of tools: cross-compiler toolchains, CMake build system, and others.
Installing the tools using an OS-specific package manager (e.g., apt, yum, brew, etc.) is the preferred method, when the required version of the tool is available. This recommendation is reflected in the Get Started. For example, on Linux and macOS, it is recommended to install CMake using an OS package manager.
However, some of the tools are specific to ESP-IDF and are not available in OS package repositories. Furthermore, different ESP-IDF versions require different tool versions for proper operation. To solve these two problems, ESP-IDF provides a set of scripts that can download and install the correct tool versions and set up the environment accordingly.
The rest of the document refers to these downloadable tools simply as "tools". Other kinds of tools used in ESP-IDF are:
Python scripts bundled with ESP-IDF such as
idf.py
Python packages installed from PyPI
The following sections explain the installation method and provide the list of tools installed on each platform.
Note
This document is provided for advanced users who need to customize their installation, users who wish to understand the installation process, and ESP-IDF developers.
If you are looking for instructions on how to install the tools, see Get Started.
Tools Metadata File
The list of tools and tool versions required for each platform is located in tools/tools.json. The schema of this file is defined by tools/tools_schema.json.
This file is used by the tools/idf_tools.py script when installing the tools or setting up the environment variables.
Tools Installation Directory
The IDF_TOOLS_PATH
environment variable specifies the location where the tools are to be downloaded and installed. If not set, the default location will be HOME/.espressif
on Linux and macOS, and %USER_PROFILE%\.espressif
on Windows.
Inside the IDF_TOOLS_PATH
directory, the tools installation scripts create the following directories and files:
dist
— where the archives of the tools are downloaded.tools
— where the tools are extracted. The tools are extracted into subdirectories:tools/TOOL_NAME/VERSION/
. This arrangement allows different versions of tools to be installed side by side.idf-env.json
— user install options, such as targets and features, are stored in this file. Targets are selected chip targets for which tools are installed and kept up-to-date. Features determine the Python package set which should be installed. These options will be discussed later.python_env
— not related to the tools; virtual Python environments are installed in the sub-directories. Note that the Python environment directory can be placed elsewhere by setting theIDF_PYTHON_ENV_PATH
environment variable.idf_version.txt
— located within each specific Python environment sub-directory underpython_env
, this file records the ESP-IDF version corresponding to that environment. The version is stored in a format like5.3
to represent ESP-IDF versionv5.3
.
espidf.constraints.*.txt
— one constraint file for each ESP-IDF release containing Python package version requirements.
GitHub Assets Mirror
Most of the tools downloaded by the tools installer are GitHub Release Assets, which are files attached to a software release on GitHub.
If GitHub downloads are inaccessible or slow to access, a GitHub assets mirror can be configured.
To use Espressif's download server, set the environment variable IDF_GITHUB_ASSETS
to dl.espressif.com/github_assets
, or dl.espressif.cn/github_assets
for faster download in China. When the install process is downloading a tool from github.com
, the URL will be rewritten to use this server instead.
Any mirror server can be used provided the URL matches the github.com
download URL format. For any GitHub asset URL that the install process downloads, it will replace https://github.com
with https://${IDF_GITHUB_ASSETS}
.
Note
The Espressif download server currently does not mirror everything from GitHub, but only files attached as Assets to some releases, as well as source archives for some releases.
idf_tools.py
Script
The tools/idf_tools.py script bundled with ESP-IDF performs several functions:
install
: Download the tool into the${IDF_TOOLS_PATH}/dist
directory and extract it into${IDF_TOOLS_PATH}/tools/TOOL_NAME/VERSION
.The
install
command accepts the list of tools to install in theTOOL_NAME
orTOOL_NAME@VERSION
format. Ifall
is given, all the tools, including required and optional ones, are installed. If no argument orrequired
is given, only the required tools are installed.download
: Similar toinstall
but doesn't extract the tools. An optional--platform
argument may be used to download the tools for the specific platform.export
: Lists the environment variables that need to be set to use the installed tools. For most of the tools, setting thePATH
environment variable is sufficient, but some tools require extra environment variables.The environment variables can be listed in either
shell
orkey-value
formats, which can be set using the--format
parameter:export
optional parameters:--unset
: Creates a statement that unsets specific global variables and restores the environment to its state before callingexport.{sh/fish}
.--add_paths_extras
: Adds extra ESP-IDF-related paths of$PATH
to${IDF_TOOLS_PATH}/esp-idf.json
, which is used to remove global variables when the active ESP-IDF environment is deactivated. For example, while processing theexport.{sh/fish}
script, if new paths are added to the global variable$PATH
, this option saves these new paths to the${IDF_TOOLS_PATH}/esp-idf.json
file.
shell
: Produces output suitable for evaluation in the shell. For example, produce the following output on Linux and macOS:export PATH="/home/user/.espressif/tools/tool/v1.0.0/bin:$PATH"
Produce the following output on Windows:
set "PATH=C:\Users\user\.espressif\tools\v1.0.0\bin;%PATH%"
Note
Exporting environment variables in Powershell format is not supported at the moment.
key-value
format may be used instead.The output of this command may be used to update the environment variables if the shell supports it. For example
eval $($IDF_PATH/tools/idf_tools.py export)
key-value
: Produces output in theVARIABLE=VALUE
format that is suitable for parsing by other scriptsPATH=/home/user/.espressif/tools/tool/v1.0.0:$PATH
Note that the script consuming this output has to perform expansion of
$VAR
or%VAR%
patterns found in the output.
list
: Lists the known versions of the tools, and indicates which ones are installed.The following option is available to customize the output.
--outdated
: Lists only outdated versions of tools installed inIDF_TOOLS_PATH
.
check
: For each tool, checks whether the tool is available in the system path and inIDF_TOOLS_PATH
.install-python-env
: Creates a Python virtual environment in the${IDF_TOOLS_PATH}/python_env
directory or directly in the directory set by theIDF_PYTHON_ENV_PATH
environment variable, and install the required Python packages there.An optional
--features
argument allows one to specify a comma-separated list of features to be added or removed.A feature that begins with
-
will be removed, and features with+
or without any sign will be added. Example syntax for removing featureXY
is--features=-XY
, and for adding featureXY
is--features=+XY
or--features=XY
. If both removing and adding options are provided with the same feature, no operation is performed.For each feature, a requirements file must exist. For example, feature
XY
is a valid feature if${IDF_PATH}/tools/requirements/requirements.XY.txt
is an existing file with a list of Python packages to be installed.There is one mandatory
core
feature ensuring the core functionality of ESP-IDF, e.g., build, flash, monitor, debug in console. There can be an arbitrary number of optional features.The selected list of features is stored in
idf-env.json
.The requirement files contain a list of the desired Python packages to be installed and the
espidf.constraints.*.txt
file downloaded from https://dl.espressif.com and stored in${IDF_TOOLS_PATH}
, which contains the package version requirements for a given ESP-IDF version.
Note
Although it is not recommended, the download and use of constraint files can be disabled with the
--no-constraints
argument or setting theIDF_PYTHON_CHECK_CONSTRAINTS
environment variable tono
.check-python-dependencies
: Checks if all required Python packages are installed. Packages from${IDF_PATH}/tools/requirements/requirements.*.txt
files selected by the feature list ofidf-env.json
are checked with the package versions specified in theespidf.constraints.*.txt
file.Note
The constraint file is downloaded with the
install-python-env
command. Similar to theinstall-python-env
command, the use of constraint files can be disabled with the--no-constraints
argument or setting theIDF_PYTHON_CHECK_CONSTRAINTS
environment variable tono
.uninstall
: Prints and removes tools that are currently not used by the active ESP-IDF version.--dry-run
: Prints installed unused tools.--remove-archives
: Additionally removes all older versions of previously downloaded installation packages.
Install Scripts
Shell-specific user-facing installation scripts are provided in the root directory of ESP-IDF repository to facilitate tools installation. These are:
install.bat
for Windows Command Promptinstall.ps1
for Powershellinstall.sh
for Bashinstall.fish
for Fish
Apart from downloading and installing the tools in IDF_TOOLS_PATH
, these scripts prepare a Python virtual environment, and install the required packages into that environment.
These scripts accept optionally a comma-separated list of chip targets and --enable-*
arguments for enabling features. These arguments are passed to the idf_tools.py
script which stores them in idf-env.json
. Therefore, chip targets and features can be enabled incrementally.
To install tools for all chip targets, run the scripts without any optional arguments using idf_tools.py install --targets=all
. Similarly, to install Python packages for core ESP-IDF functionality, run idf_tools.py install-python-env --features=core
.
It is also possible to install tools for specific chip targets. For example, install.sh esp32
installs tools only for ESP32. See Step 3. Set up the Tools for more examples.
install.sh --enable-XY
enables feature XY
(by running idf_tools.py install-python-env --features=core,XY
).
Export Scripts
Since the installed tools are not permanently added to the user or system PATH
environment variable, an extra step is required to use them in the command line. The following scripts modify the environment variables in the current shell to make the correct versions of the tools available:
export.bat
for Windows Command Promptexport.ps1
for Powershellexport.sh
for Bashexport.fish
for Fish
Note
To modify the shell environment in Bash, export.sh
must be "sourced" by using the command . ./export.sh
. Please ensure to include the leading dot and space.
export.sh
may be used with various shells like Bash, Zsh, sh, dash, etc. When using Bash or Zsh, you can run it from any path (e.g., . ./<<some_path>>/export.sh
) as it automatically detects IDF_PATH
. For other shells, it must be run from the ESP-IDF directory (. ./export.sh
) to locate IDF_PATH
correctly.
activate.py
The environment setup is handled by the underlying tools/activate.py
Python script. This script performs all necessary preparations and checks, generating a temporary file that is subsequently sourced by the export script.
activate.py
can also function as a standalone command. When run, it launches a new child shell with an ESP-IDF environment, which can be utilized and then exited with the exit
command. Upon exiting the child shell, you will return to the parent shell from which the script was initially executed.
Additionally, the specific behavior of the activate.py
script can be modified with various options, such as spawning a specific shell with ESP-IDF using the --shell
option. For more information on available options, use the activate.py --help
command.
Note
When using activate.py
on Windows, it should be executed with python activate.py
. This ensures the script runs in the current terminal window rather than launching a new one that closes immediately.
Other Installation Methods
Depending on the environment, more user-friendly wrappers for idf_tools.py
are provided:
ESP-IDF Tools Installer can download and install the tools. Internally the installer uses
idf_tools.py
.ESP-IDF Eclipse Plugin includes a menu item to set up the tools. Internally the plugin calls
idf_tools.py
.VSCode ESP-IDF Extension includes an onboarding flow. This flow helps set up the tools. Although the extension does not rely on
idf_tools.py
, the same installation method is used.
Custom Installation
Although the methods above are recommended for ESP-IDF users, they are not a must for building ESP-IDF applications. ESP-IDF build system expects that all the necessary tools are installed somewhere, and made available in the PATH
.
When performing a custom installation, ensure that the ESP_IDF_VERSION
environment variable is set to reflect the current ESP-IDF version, using a format like 5.3
to represent ESP-IDF version v5.3
. This variable is required by some components for version-specific configurations and is typically set by the idf_tools.py export
script in standard installations.
Uninstall ESP-IDF
Uninstalling ESP-IDF requires removing both the tools and the environment variables that have been configured during the installation.
Windows users using the Windows ESP-IDF Tools Installer can simply run the uninstall wizard to remove ESP-IDF.
To remove an installation performed by running the supported install scripts, simply delete the tools installation directory including the downloaded and installed tools. Any environment variables set by the export scripts are not permanent and will not be present after opening a new environment.
When dealing with a custom installation, in addition to deleting the tools as mentioned above, you may also need to manually revert any changes to environment variables or system paths that were made to accommodate the ESP-IDF tools (e.g.,
IDF_PYTHON_ENV_PATH
orIDF_TOOLS_PATH
). If you manually copied any tools, you would need to track and delete those files manually.If you installed any plugins like the ESP-IDF Eclipse Plugin or VSCode ESP-IDF Extension, you should follow the specific uninstallation instructions described in the documentation of those components.
Note
Uninstalling the ESP-IDF tools does not remove any project files or your code. Be mindful of what you are deleting to avoid losing any work. If you are unsure about a step, refer back to the installation instructions.
These instructions assume that the tools were installed following the procedures in this provided document. If you've used a custom installation method, you might need to adapt these instructions accordingly.
List of ESP-IDF Tools
xtensa-esp-elf-gdb
GDB for Xtensa
License: GPL-3.0-or-later
More info: https://github.com/espressif/binutils-gdb
Platform |
Required |
Download |
---|---|---|
linux-amd64 |
required |
SHA256: 18774349d2b1c7d7f5ba984563f7022aef4a3df4b706ed8821c53266f599343d |
linux-arm64 |
required |
SHA256: 77cb3b2c85d6cfbb40b7f99eebbc2b1c3f4fe13eba20b3da798bdbbc6eb8e87c |
linux-armel |
required |
SHA256: b87af0539de118eb9d43a4a89c8c1b0a6ab2557560015155104c44f91b5c4aa0 |
linux-armhf |
required |
SHA256: 6afad8093ef8adb617914be153256308fe557a0335c600afe75dcbd8ec8a494b |
linux-i686 |
required |
SHA256: 2c7531bd390928fed479999ac9089b39a25f56ca4f4cc330db7d7a633a37405b |
macos |
required |
SHA256: ba2907be9a4c22c4e418f42ec84cf57401570a71dabbe69425227114ebf351a7 |
macos-arm64 |
required |
SHA256: 893500d6de354a6870820b9398531d8cd37d1cd85f3ae9b1f8a4c070b8048707 |
win32 |
required |
SHA256: 328181380fccb252105c51a86071edbc5ef63e0114540edc4f8b2d62acf44916 |
win64 |
required |
SHA256: 9c1949058d7aa1fa6f6f2d03173659b9f54e3c3940cbeebc1d56ae169c604ab2 |
riscv32-esp-elf-gdb
GDB for RISC-V
License: GPL-3.0-or-later
More info: https://github.com/espressif/binutils-gdb
Platform |
Required |
Download |
---|---|---|
linux-amd64 |
required |
SHA256: bfca245b3d84244ad3b6156496728d916ac5ccc0d7f8e048194b7eba5cdbe047 |
linux-arm64 |
required |
SHA256: 8536da9e3093b8f25e0b5204b04ed4afea432d1fd262f2abb466016d3d750ea6 |
linux-armel |
required |
SHA256: 33a80d5e6604bb7d08b15492b8ec84c9176245e066d0bf8aad7570786ca44081 |
linux-armhf |
required |
SHA256: 8045a8e187a1fd20b781315fba117cb3c37727600ba8e0c55dac0616145e28fb |
linux-i686 |
required |
SHA256: ba448ecf2c80064013eaacb0e7be514a5ef17516f49ff3e50bc41c5578b8d88e |
macos |
required |
SHA256: bdd07c54fe3216eb5c34f92cac514eb4af777c951573f186c33408c75f56bb4b |
macos-arm64 |
required |
SHA256: 9924f439ae77c3346e532a48a0d56330466c33ce1abd8d72b77f9f7f5c3b1196 |
win32 |
required |
SHA256: dcdafd30854b092671f555d844d94b0733e2ffcac8c026b4fb7b8a72ebef0016 |
win64 |
required |
SHA256: 6ec8b3a073f2c5835321b4b560f8fc56180458204d071da139ff983436ea45e5 |
xtensa-esp-elf
Toolchain for 32-bit Xtensa based on GCC
License: GPL-3.0-with-GCC-exception
More info: https://github.com/espressif/crosstool-NG
Platform |
Required |
Download |
---|---|---|
linux-amd64 |
required |
SHA256: e3e6dcf3d275c3c9ab0e4c8a9d93fd10e7efc035d435460576c9d95b4140c676 |
linux-arm64 |
required |
SHA256: ac2b311dc0003386425086bfc813bf2aeb3cdf3b117845802df6ebef5f69955f |
linux-armel |
required |
SHA256: c54c2877582070115fe6f4870a88a4db4f2f945becf2d70bb1f71e5ab1cac673 |
linux-armhf |
required |
SHA256: 04addfee56b45d62b6980967c71fafd6aec2be6dee6d8501e9db70345a6179d2 |
linux-i686 |
required |
SHA256: acf3fb7e37274413cd8c812894a6a0e3a0b3a78e9d5b533893d304008cc996c2 |
macos |
required |
SHA256: 1ca7a93825d5b84f6547fa73e6174acadb9af5c877f365e50e176936784383ea |
macos-arm64 |
required |
SHA256: b9732bb3cdcd6a50420c25eb9a8d90eb1216a0a0a274c8ffd4c2037167b5081f |
win32 |
required |
SHA256: b30e450e0af279783c54a9ae77c3b367dd556b78eda930a92ec7b784a74c28c8 |
win64 |
required |
SHA256: 62ae704777d73c30689efff6e81178632a1ca44d1a2d60f4621eb997e040e028 |
esp-clang
Toolchain for all Espressif chips based on clang
License: Apache-2.0
More info: https://github.com/espressif/llvm-project
Platform |
Required |
Download |
---|---|---|
linux-amd64 |
optional |
SHA256: aee15b8e02440f9ec6a8070f017621dc400dbd62a4701f9cf456dbe34d2a0c4d |
linux-arm64 |
optional |
SHA256: 14abbc368d9c153270aa4d22ce28d78633cb0f1ca83d4be70591d9e39ae9bc82 |
linux-armhf |
optional |
SHA256: 4133285303aabb1831c477536a13413319a569170b0aa54b92abe69cc0e7b938 |
macos |
optional |
SHA256: b4641ec4dd574b6b7d037aa1bb2e5ff5a8a4623c88e89668db656282eb1d9dc8 |
macos-arm64 |
optional |
SHA256: 5d2e187ef40ecc9996630a7c6efcc19bdfd32ec4ce8cc4dd3014cd24e7016560 |
win64 |
optional |
SHA256: c4af15073b105dc174c0452dfd1875bab200412fa3151c0363cfc0d30abf5173 |
riscv32-esp-elf
Toolchain for 32-bit RISC-V based on GCC
License: GPL-3.0-with-GCC-exception
More info: https://github.com/espressif/crosstool-NG
Platform |
Required |
Download |
---|---|---|
linux-amd64 |
required |
SHA256: 7faaa86d272f3e43c233f8a5ffeba327673224a752c2eb72394655d5e7950000 |
linux-arm64 |
required |
SHA256: 762eac9ee3d909cf806dcbd26feeb4a83061640d1afea39bc36efdb566b77b03 |
linux-armel |
required |
SHA256: f5b92a7f91c97e11f8c871cffbb040310a3cea1049e967621e5dfc0ff1a601bc |
linux-armhf |
required |
SHA256: 14e7962cb4d00ef5c45bc2df2d5f7f2af796d4b68def9f9861d82ac05bb1831f |
linux-i686 |
required |
SHA256: 39f12f204d3aef7b0c4f3f3e58846ff1ee0a90526db56e91d11bc1c093b645c0 |
macos |
required |
SHA256: fd7543ca97f4d971798b8323e1e7315e648dded4cf2c16a82c3093447b0358fa |
macos-arm64 |
required |
SHA256: b0e54a077c8abd261a588ee96b4079a95218ad9c3124b70ef7275c5de262277d |
win32 |
required |
SHA256: 54193a97bd75205678ead8d11f00b351cfa3c2a6e5ab5d966341358b9f9422d7 |
win64 |
required |
SHA256: 24c8407fa467448d394e0639436a5ede31caf1838e35e8435e19df58ebed438c |
esp32ulp-elf
Toolchain for ESP32 ULP coprocessor
License: GPL-3.0-or-later
More info: https://github.com/espressif/binutils-gdb
Platform |
Required |
Download |
---|---|---|
linux-amd64 |
required |
SHA256: d13a808365b78465fa6591636dfbbb9604d9d15a397c3d9cd22626d54828ac2c |
linux-arm64 |
required |
SHA256: ecce0788ce1000e5c669c5adaf2fd5bf7f9bf96dcdbd3555d1d9ce4dcb311038 |
linux-armel |
required |
SHA256: 7228b01277f7908d72eb659470f82e143c4c66b444538a464290d88ece16130e |
linux-armhf |
required |
SHA256: 951b089c66561bc2190a8d57c316dfaef985a778728a7c30e1edcd29fe180016 |
linux-i686 |
required |
SHA256: df323d40962313168f6feeb2d9471c6010ff23a7896f40244e62991517d9745b |
macos |
required |
SHA256: b2aeba8eaafdf156e9e30be928dde1f133b00eaf33802d96827ec544ac7c864c |
macos-arm64 |
required |
SHA256: e3a4dfea043e2bce8cd00b3a0b260a59249fa61ca5931bf02f18a3d43c18deb4 |
win32 |
required |
SHA256: d33b64f49df27dcfa4a24d3af1a5ead77b020f85f33448994c31b98f88e66bb4 |
win64 |
required |
SHA256: 3a7627008ac92d1580542b95c696449e56aaa1d0881dc3ef5fd5c60afc77a49d |
cmake
CMake build system
On Linux and macOS, it is recommended to install CMake using the OS-specific package manager (like apt, yum, brew, etc.). However, for convenience it is possible to install CMake using idf_tools.py along with the other tools.
License: BSD-3-Clause
More info: https://github.com/Kitware/CMake
Platform |
Required |
Download |
---|---|---|
linux-amd64 |
optional |
https://github.com/Kitware/CMake/releases/download/v3.30.2/cmake-3.30.2-linux-x86_64.tar.gz SHA256: cdd7fb352605cee3ae53b0e18b5929b642900e33d6b0173e19f6d4f2067ebf16 |
linux-arm64 |
optional |
https://github.com/Kitware/CMake/releases/download/v3.30.2/cmake-3.30.2-linux-aarch64.tar.gz SHA256: d18f50f01b001303d21f53c6c16ff12ee3aa45df5da1899c2fe95be7426aa026 |
linux-armel |
optional |
https://dl.espressif.com/dl/cmake/cmake-3.30.2-Linux-armv7l.tar.gz SHA256: 446650c69ea74817a770f96446c162bb7ad24ffecaacb35fcd4845ec7d3c9099 |
linux-armhf |
optional |
https://dl.espressif.com/dl/cmake/cmake-3.30.2-Linux-armv7l.tar.gz SHA256: 446650c69ea74817a770f96446c162bb7ad24ffecaacb35fcd4845ec7d3c9099 |
macos |
optional |
https://github.com/Kitware/CMake/releases/download/v3.30.2/cmake-3.30.2-macos-universal.tar.gz SHA256: c6fdda745f9ce69bca048e91955c7d043ba905d6388a62e0ff52b681ac17183c |
macos-arm64 |
optional |
https://github.com/Kitware/CMake/releases/download/v3.30.2/cmake-3.30.2-macos-universal.tar.gz SHA256: c6fdda745f9ce69bca048e91955c7d043ba905d6388a62e0ff52b681ac17183c |
win32 |
required |
https://github.com/Kitware/CMake/releases/download/v3.30.2/cmake-3.30.2-windows-x86_64.zip SHA256: 48bf4b3dc2d668c578e0884cac7878e146b036ca6b5ce4f8b5572f861b004c25 |
win64 |
required |
https://github.com/Kitware/CMake/releases/download/v3.30.2/cmake-3.30.2-windows-x86_64.zip SHA256: 48bf4b3dc2d668c578e0884cac7878e146b036ca6b5ce4f8b5572f861b004c25 |
openocd-esp32
OpenOCD for ESP32
License: GPL-2.0-only
More info: https://github.com/espressif/openocd-esp32
Platform |
Required |
Download |
---|---|---|
linux-amd64 |
required |
SHA256: e82b0f036dc99244bead5f09a86e91bb2365cbcd1122ac68261e5647942485df |
linux-arm64 |
required |
SHA256: 8f8daf5bd22ec5d2fa9257b0862ec33da18ee677e023fb9a9eb17f74ce208c76 |
linux-armel |
required |
SHA256: bc9c020ecf20e2000f76cffa44305fd5bc44d2e688ea78cce423399d33f19767 |
linux-armhf |
required |
SHA256: 2cd6436465333e998000b1c311d301b295d8ebaa3fb1c9aa9d4393539dc16ec6 |
macos |
required |
SHA256: 02a2dffe801a2d005fa9e614d80ff8173395b2cb0b5d3118d0229d094a9946a7 |
macos-arm64 |
required |
SHA256: c382f9e884d6565cb6089bff5f200f4810994667d885f062c3d3c5625a0fa9d6 |
win32 |
required |
SHA256: 3b5d615e0a72cc771a45dd469031312d5881c01d7b6bc9edb29b8b6bda8c2e90 |
win64 |
required |
SHA256: 5e7b2fd1947d3a8625f6a11db7a2340cf2f41ff4c61284c022c7d7c32b18780a |
ninja
Ninja build system
On Linux and macOS, it is recommended to install ninja using the OS-specific package manager (like apt, yum, brew, etc.). However, for convenience it is possible to install ninja using idf_tools.py along with the other tools.
License: Apache-2.0
More info: https://github.com/ninja-build/ninja
Platform |
Required |
Download |
---|---|---|
linux-amd64 |
optional |
https://github.com/ninja-build/ninja/releases/download/v1.12.1/ninja-linux.zip SHA256: 6f98805688d19672bd699fbbfa2c2cf0fc054ac3df1f0e6a47664d963d530255 |
macos |
optional |
https://github.com/ninja-build/ninja/releases/download/v1.12.1/ninja-mac.zip SHA256: 89a287444b5b3e98f88a945afa50ce937b8ffd1dcc59c555ad9b1baf855298c9 |
macos-arm64 |
optional |
https://github.com/ninja-build/ninja/releases/download/v1.12.1/ninja-mac.zip SHA256: 89a287444b5b3e98f88a945afa50ce937b8ffd1dcc59c555ad9b1baf855298c9 |
win64 |
required |
https://github.com/ninja-build/ninja/releases/download/v1.12.1/ninja-win.zip SHA256: f550fec705b6d6ff58f2db3c374c2277a37691678d6aba463adcbb129108467a |
idf-exe
IDF wrapper tool for Windows
License: Apache-2.0
More info: https://github.com/espressif/idf_py_exe_tool
Platform |
Required |
Download |
---|---|---|
win32 |
required |
https://github.com/espressif/idf_py_exe_tool/releases/download/v1.0.3/idf-exe-v1.0.3.zip SHA256: 7c81ef534c562354a5402ab6b90a6eb1cc8473a9f4a7b7a7f93ebbd23b4a2755 |
win64 |
required |
https://github.com/espressif/idf_py_exe_tool/releases/download/v1.0.3/idf-exe-v1.0.3.zip SHA256: 7c81ef534c562354a5402ab6b90a6eb1cc8473a9f4a7b7a7f93ebbd23b4a2755 |
ccache
Ccache (compiler cache)
License: GPL-3.0-or-later
More info: https://github.com/ccache/ccache
Platform |
Required |
Download |
---|---|---|
win64 |
required |
https://github.com/ccache/ccache/releases/download/v4.10.2/ccache-4.10.2-windows-x86_64.zip SHA256: 6252f081876a9a9f700fae13a5aec5d0d486b28261d7f1f72ac11c7ad9df4da9 |
dfu-util
dfu-util (Device Firmware Upgrade Utilities)
License: GPL-2.0-only
More info: http://dfu-util.sourceforge.net/
Platform |
Required |
Download |
---|---|---|
win64 |
required |
https://dl.espressif.com/dl/dfu-util-0.11-win64.zip SHA256: 652eb94cb1c074c6dbead9e47adb628922aeb198a4d440a346ab32e7a0e9bf64 |
esp-rom-elfs
ESP ROM ELFs
License: Apache-2.0
More info: https://github.com/espressif/esp-rom-elfs
Platform |
Required |
Download |
---|---|---|
any |
required |
https://github.com/espressif/esp-rom-elfs/releases/download/20241011/esp-rom-elfs-20241011.tar.gz SHA256: 921f000164a421c7628fbfee55b173384aafaa51883adc65cd27bf9b0af9e9a9 |
qemu-xtensa
QEMU for Xtensa
Some ESP-specific instructions for running QEMU for Xtensa chips are here: https://github.com/espressif/esp-toolchain-docs/blob/main/qemu/esp32/README.md
License: GPL-2.0-only
More info: https://github.com/espressif/qemu
Platform |
Required |
Download |
---|---|---|
linux-amd64 |
optional |
SHA256: 071d117c44a6e9a1bc8664ab63b592d3e17ceb779119dcb46c59571a4a7a88c9 |
linux-arm64 |
optional |
SHA256: 43552f32b303a6820d0d9551903e54fc221aca98ccbd04e5cbccbca881548008 |
macos |
optional |
SHA256: 0096734280ce04f558cd9bd72f35db39667f80d44309a35565f2f8c02d1f9cc3 |
macos-arm64 |
optional |
SHA256: fb4ca6be7b1a4dbcf153879cf0582300f974371def0826c0c5b728f12812ad08 |
win64 |
optional |
SHA256: 281659f7a1d49761ac6f54d0aeb14366cb93c002f21948b847a0e15c0b8f5425 |
qemu-riscv32
QEMU for RISC-V
Some ESP-specific instructions for running QEMU for RISC-V chips are here: https://github.com/espressif/esp-toolchain-docs/blob/main/qemu/esp32c3/README.md
License: GPL-2.0-only
More info: https://github.com/espressif/qemu
Platform |
Required |
Download |
---|---|---|
linux-amd64 |
optional |
SHA256: 47120e826cfec7180db8cb611a7a4aed2e9b2191c2a739194f8ce085e63cdd8d |
linux-arm64 |
optional |
SHA256: 3b6221a8b1881d2c9b9fa0b0bf8d7065c84153d2a54e429307bde9feae235c27 |
macos |
optional |
SHA256: 3afa55d5abea52ccf18d0bc41fe819d568bd4ee1582989b1ee9b1ee4a609a31e |
macos-arm64 |
optional |
SHA256: 69ba5154594fb2922d5490a49ea6b4925c024c6c37f875b42f9885f513e0bcdd |
win64 |
optional |
SHA256: f49bb5c8f4d6e2cfbf7eeec21eb8ef190a57307778705bc689536ac13bde511c |