Commit Graph
230 Commits
Author SHA1 Message Date
Vojtech Piroch 19676ffa46 fix(tools): Detect serial port matching the project target
Auto-detect used to pick the first Espressif device, even when it did
not match IDF_TARGET. With several boards attached, flash/monitor could
talk to the wrong chip.

Pass the project target into esptool so unmatched ports are skipped.
Resolve the port after ensure_build_directory() so the target is known.
For monitor on an unconfigured project, probe the connected chip and
pass it directly to idf_monitor without configuring the project.
2026-09-02 17:18:57 +08:00
Marius Vikhammer 4d332f710e docs(kconfig): update kconfig ref links to use menuitem 2026-08-11 11:19:45 +02:00
Roland Dobai 56fea7d784 Merge branch 'docs/idf_sbom_multi_format' into 'master'
docs: Update the SBOM guide for multiple output formats

See merge request espressif/esp-idf!50299
2026-08-03 11:56:44 +02:00
Ivan Grokhotkov (bot)andClaude Fable 5 b3a0e166fe feat: add compile_options support to idf.py build-file
Allow specifying extra compiler flags (warning flags, preprocessor
definitions, etc.) via a new 'compile_options' entry in the
idf-build-file frontmatter. The options are applied to the source
file via target_compile_options in the generated main component
CMakeLists, with CMake quoting so that flags like -DMSG="hello world"
reach the compiler exactly as written.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-21 22:04:41 +02:00
Ivan GrokhotkovandClaude Fable 5 16275df0a1 feat: add idf.py build-file command for standalone C files
Add a new idf.py extension that allows building standalone C files
without requiring full project boilerplate. Source files can include
optional YAML frontmatter in block comments to specify sdkconfig
options, component dependencies, and target configuration.

When the frontmatter configuration changes, the stale sdkconfig is
removed so the new defaults are applied, and a target change also
clears the build directory since IDF_TARGET is pinned in the CMake
cache.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-21 22:04:41 +02:00
Frantisek Hrbata eb5fd63965 docs: Update the SBOM guide for multiple output formats
Document the create --format option (SPDX 2.2 tag/value and JSON, SPDX 3.0.1
JSON-LD, and CycloneDX 1.6) and the new --file option on idf.py sbom-create and
sbom-check, and generalize the previously SPDX-only wording. Note the NVDAPIKEY
variable for faster online scans, document that sbom-check exits with a non-zero
status when vulnerabilities are found, drop an unused link target, and update the
SBOM reference link. Fix the section heading levels to follow the esp-docs
conventions.
2026-07-02 12:24:49 +02:00
Zhang Shuxian 320ea43509 docs: Update CN translation for idf-py.rst 2026-06-24 18:46:39 +08:00
Marek FialaandCursor 33924459ab docs(tools): update mcp-server docs for project_dir and create-project
- Server can now start from any directory, not just a valid project dir
- Document project_dir argument available on all tools
- Add create-project tool to the list of available tools

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-06-24 18:46:39 +08:00
Konstantin Kondrashov 885097762f feat(efuse): Support efuse token dump
- efuse token dump is compatible with espefuse tool
- EFSW dump can be burned on chip with esp_efuse_token_burn()
2026-06-03 13:19:59 +03:00
Jan Beran 9522af1d8f feat: introduce esp-idf-configdep as a build optimization
The esp-idf-configdep utility works as a compiler wrapper. It lets the
compiler compile the app and checks whether -MF option was used to
generate dependency files. If yes, it checks for sdkconfig.h dependency
in those files.

Target file depending on sdkconfig.h is then scanned for all CONFIG_*
occurrences and the dependency file is altered so that the given target
file is marked as "dirty" only if the config options it actually uses
are changed.

This ensures that after a configuration update, only affected files are
rebuilt, reducing incremental build times.

The compiler launcher mechanism is changed from RULE_LAUNCH_COMPILE
(Makefile-only) to CMAKE_*_COMPILER_LAUNCHER (generator-agnostic),
enabling launcher chaining (configdep -> ccache -> compiler).

Made-with: Cursor
2026-06-02 01:26:10 +08:00
Alexey Gerenkov edb75262a1 Merge branch 'feature/update-esp-clang-to-esp-21.1.3_20260304' into 'master'
feat(tools): update esp-clang version to esp-21.1.3_20260408

Closes IDF-14965, LLVM-501, and LLVM-531

See merge request espressif/esp-idf!46361
2026-05-13 22:54:10 +08:00
Shen Mengjing 1e71307770 docs: Sync CN and EN docs missing the translation label 2026-05-11 14:08:45 +08:00
Alexey Gerenkov 6b5a00d4eb feat(tools): add esp-clangd tool (version esp-21.1.3_20260304) 2026-05-07 17:42:38 +03:00
renpeiying 476bacf52a docs: Add CN translation 2026-04-28 09:32:59 +02:00
Jakub Kocka fb02854ad6 feat(tools): Added create-project argument to allow cpp project creation
Closes https://github.com/espressif/esp-idf/issues/16121
2026-04-28 09:24:20 +02:00
Zhang Shuxian 0092037019 docs: Update CN translation for idf-py 2026-04-15 16:30:57 +08:00
Marek Fiala 4d1612cd3c feat(tools): Restrict loading extension components to trusted sources 2026-04-15 16:30:57 +08:00
Radim Karniš 38d37e5e9f feat(idf_py): idf.py flash will reflash only changed data sectors by default
idf.py flash -a is introduced to trigger a flash of all data (not just changed sectors).
2026-04-02 10:59:30 +02:00
Marius Vikhammer 5c572e5a60 docs: refresh broken documentation links 2026-04-01 10:17:33 +08:00
Fu Hanxi c360d8be98 feat: support moving idf components to component registry
and mark it as root dependency
2026-03-17 21:02:49 +08:00
Marek Fiala d1bbfabb22 docs(tools): Adjusted mcp server documentation 2026-03-16 13:27:54 +08:00
Frantisek Hrbata b90098a9f2 feat(tools): esp-idf-sbom integration into idf.py
While the `esp-idf-sbom` `idf.py` extension is implemented within the
`esp-idf-sbom` python package, a few minor changes are also required on
the `idf.py` side.

1. Add `esp-idf-sbom` as a core requirement so it is automatically
   installed by the installation scripts.
2. Add the `sbom-create` action to the list of actions for which the
   flashing-related closing message is displayed.
3. Update the documentation in the api-guides for tools.

Signed-off-by: Frantisek Hrbata <frantisek.hrbata@espressif.com>
2026-02-16 09:03:17 +01:00
renpeiying 98d5785f86 docs: Update CN translation 2026-02-13 15:59:31 +08:00
Marek Fiala 75bf3bdb54 feat(tools): Extended hints.yml loading from components 2026-02-13 15:59:31 +08:00
Marek Fiala 9b0475de34 docs(tools): Made static link for config profile files
Made the reference link to v5.5 to reflect the correct example,
as in later version the example was changed.
2026-01-14 23:17:00 +08:00
Marek Fiala 3a23146518 docs(tools): Updated argument via file with quotations
Closes https://github.com/espressif/esp-idf/issues/18077
2026-01-14 23:17:00 +08:00
Wang Ning 9f10058395 Docs: Update Get Started for EIM 2025-12-23 22:29:08 +08:00
Zhang Shuxian 30832dcbc8 docs: Update CN translation 2025-10-29 11:47:40 +08:00
Marek Fiala 9155e04f06 docs(idf-py.rst): Added cmake preset paragraph 2025-10-29 11:47:40 +08:00
Zhang Shuxian 512a1d8028 docs: Update CN translation 2025-10-20 16:22:54 +02:00
Marek Fiala c4347a682d feat: Install mcp with initialization scripts 2025-10-20 16:22:54 +02:00
Mahavir Jain 7c517deb35 tools: add idf.py mcp-server support 2025-10-20 16:22:54 +02:00
Fu Hanxi b207b3320b ci: use merged result commit in build_docker job
also change to shanghai runners
2025-10-08 13:59:18 +02:00
Peter Dragun e3198fff3c feat: Update esptool to v5 2025-09-30 15:28:55 +02:00
Marek Fiala 56fa45c741 revert(tools): Removed --legacy option for esp-idf-size 2025-09-29 01:54:38 +08:00
renpeiying 6c6b8a5ee0 docs: Add CN translation to idf-py.rst 2025-09-23 15:26:33 +08:00
Marek Fiala 96ff174dac feat(tools): idf.py extension - added interface version 2025-09-23 15:26:33 +08:00
Marek Fiala 7ac1c541fd docs(tools): Updated documentation about extension options 2025-09-23 15:26:33 +08:00
luweike bfe6b51ac9 docs: Add --qemu-extra-args option to QEMU guide 2025-09-22 15:37:46 +08:00
luweike 7e669d3a71 docs: Add Related Documents to IDF Docker Image 2025-09-18 17:12:38 +08:00
renpeiying 5b7f668a35 docs: add qemu doc link 2025-09-08 11:42:27 +08:00
Peter Dragun 519042a1e2 feat: Deprecate Python 3.9
BREAKING CHANGE:
- Minimal supported Python version is now 3.10.
2025-08-01 08:05:10 +02:00
Jan Beran 19d370f594 docs: how to update ESP-IDF environment without updating ESP-IDF itself
Closes https://github.com/espressif/esp-idf/issues/16077
2025-06-23 12:47:59 +02:00
Frantisek Hrbata b9d7771a14 fix(docs/idf-size): update idf.py size summary output
The total flash size is no longer reported by esp-idf-size. Update the
output example in the documentation to reflect this change. Also,
include the note about total memory sizes as now printed by
esp-idf-size.

Signed-off-by: Frantisek Hrbata <frantisek.hrbata@espressif.com>
2025-05-26 23:04:10 +08:00
renpeiying f5a28000fa docs: Update CN for idf-monitor.rst 2025-05-12 22:07:50 +08:00
Peter Dragun 9859f5e690 docs(tools/idf-monitor): Add note about autocoloring limitation on multiline logs
Closes https://github.com/espressif/esp-idf/issues/15793
2025-05-12 22:07:50 +08:00
Alexey Gerenkov e7423ebbcc feat(tools): Add standalone Clang libraries to tools.json 2025-04-14 17:10:55 +03:00
renpeiying 0d3dcf396f docs: Update CN translation 2025-04-02 19:18:12 +08:00
Peter Dragun 6061a98b33 docs(tools/idf-monitor): add note about CH9102 USB-to-UART bridge issue on Windows
Closes https://github.com/espressif/esp-idf-monitor/issues/26
2025-04-02 08:56:57 +02:00
renpeiying 2aee9ac12c docs: Add translation for api-guides/tools/diag_tool 2025-03-04 16:44:35 +08:00