Espressif ESP32 ESP-IDF Programming Guide (Release v4.2-beta1) covering setup, API reference, build system, storage, security and JTAG debugging.
This is the ESP-IDF Programming Guide for the Espressif ESP32, published by Espressif Systems as Release v4.2-beta1 (September 29, 2020). It opens with a Get Started section that walks through installing prerequisites for Windows, Linux and macOS, getting ESP-IDF, setting up the tools and environment variables, starting a project, connecting the device, configuring, building, flashing and monitoring.
The remainder is reference material: an API Reference covering Bluetooth, networking, peripherals, application protocols, provisioning, storage and system APIs, plus a project configuration reference and API guides on the build system, FreeRTOS SMP changes, JTAG debugging, partition tables, flash encryption, secure boot and related topics.
| Documented ESP-IDF release | v4.2-beta1 |
|---|---|
| Host platforms covered for toolchain setup | Windows, Linux and macOS |
The guide gives standard toolchain setup instructions for Windows, Linux and macOS.
The steps run from installing prerequisites and getting ESP-IDF through setting up tools and environment variables, starting a project, connecting the device, configuring, building, flashing and finally monitoring.
Yes, the API Reference has a Bluetooth API section covering the controller and VHCI, BT COMMON, BTLE, Classic BT, NimBLE-based host APIs and ESP-BLE-MESH.
JTAG debugging is covered in the API Guides, including how it works, selecting a JTAG adapter, OpenOCD setup and launching the debugger.