> ## Documentation Index
> Fetch the complete documentation index at: https://docs.prescaler.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Espressif ESP-IDF projects

> Use the correct IDF environment and target configuration.

Open the ESP-IDF application root and activate the matching SDK/tools environment. Prescaler recognizes the native CMake project declaration and reads configured target intent from SDK configuration.

Build invokes `idf.py build`. The SDK determines generated headers, compiler selection, partition layout and image production. A register description does not configure any of these.

To change ESP32 target, follow the SDK's `set-target` workflow and inspect the resulting configuration changes. It can clear the build directory and replace configuration. Rebuild before programming, and select the correct port/probe and image.

ESP32 variants use different architectures and debug arrangements. Do not reuse an Xtensa debugger or target script merely because another product shares the ESP32 family name.

[IDF command reference](https://docs.espressif.com/projects/esp-idf/en/stable/esp32/api-guides/tools/idf-py.html) · [Espressif extension workflows](https://docs.espressif.com/projects/vscode-esp-idf-extension/en/latest/)