Tools for building ESP-IDF related apps.
Project description
idf-build-apps
idf-build-apps
is a tool that helps users find and build ESP-IDF projects faster.
What is an app
?
An ESP-IDF project would typically contain:
- Build recipe in CMake and the main component with app sources
- (Optional) One or more sdkconfig files
app
is the abbreviation for application. An application is the binary that is being built with the specified sdkconfig and the target chip. idf-build-apps
could build one project into a number of applications.
Installation
pip install idf-build-apps
Basic Usage
idf-build-apps
is a callable python package. It contains two sub-commands.
find
to find the buildable applicationsbuild
to build the found applications
For detailed explanation to all CLI options, you may run
python -m idf_build_apps -h
python -m idf_build_apps find -h
python -m idf_build_apps build -h
Quick Example
To build the applications for all targets of the ESP-IDF hello world example project under ESP-IDF v5.0:
python -m idf_build_apps build -p $IDF_PATH/examples/get-started/hello_world/ --target all --build-dir build_@t
It would get the default supported targets from your IDF version, build the hello world project with all targets and the default sdkconfig
file.
Partial build log:
2023-02-22 12:14:58 INFO Found 5 apps in total
2023-02-22 12:14:58 INFO Total 5 apps. running build for app 1-5
2023-02-22 12:14:58 INFO Building the following apps:
2023-02-22 12:14:58 INFO (cmake) App /tmp/test/esp/esp-idf/examples/get-started/hello_world/, target esp32, sdkconfig (default), build in /tmp/test/esp/esp-idf/examples/get-started/hello_world/build_esp32 (preserve: True)
2023-02-22 12:14:58 INFO (cmake) App /tmp/test/esp/esp-idf/examples/get-started/hello_world/, target esp32c2, sdkconfig (default), build in /tmp/test/esp/esp-idf/examples/get-started/hello_world/build_esp32c2 (preserve: True)
2023-02-22 12:14:58 INFO (cmake) App /tmp/test/esp/esp-idf/examples/get-started/hello_world/, target esp32c3, sdkconfig (default), build in /tmp/test/esp/esp-idf/examples/get-started/hello_world/build_esp32c3 (preserve: True)
2023-02-22 12:14:58 INFO (cmake) App /tmp/test/esp/esp-idf/examples/get-started/hello_world/, target esp32s2, sdkconfig (default), build in /tmp/test/esp/esp-idf/examples/get-started/hello_world/build_esp32s2 (preserve: True)
2023-02-22 12:14:58 INFO (cmake) App /tmp/test/esp/esp-idf/examples/get-started/hello_world/, target esp32s3, sdkconfig (default), build in /tmp/test/esp/esp-idf/examples/get-started/hello_world/build_esp32s3 (preserve: True)
For detailed information, please refer to our documentation site!
Contributing
Thanks for your contribution! Please refer to our Contributing Guide
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for idf_build_apps-0.3.2-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 4d7516dae652e88fda23995f41bbb06a5729e60321fed3d02663fdf40ef1d248 |
|
MD5 | 7b7844551dd65665488e6699d5e730da |
|
BLAKE2b-256 | fdcff10a35d9ea5d2f161e14bc911052467a77bbfff1c8332735cc7ad063ecca |