Espressif ESP32 ESP-IDF Programming Guide

Espressif ESP32 ESP-IDF Programming Guide (Release v4.2-beta1) covering setup, API reference, build system, storage, security and JTAG debugging.


Espressif ESP32 ESP-IDF Programming Guide - cover page
Brand
Espressif
Category
Programming
Document type
Programming Manual
Language
English
Pages
1890
File format
PDF
File size
16.4 MB
Published
07 November, 2026
Updated
07 November, 2026
Model
ESP32
MD5 checksum
1070C7E623B35E914A9219B5ED590DD0

About this manual

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.

What's inside

  • Get Started
  • API Reference
  • Bluetooth API
  • Networking APIs
  • Peripherals API
  • Application Protocols
  • Provisioning API
  • Storage API
  • System API
  • Project Configuration

Specifications

Documented ESP-IDF releasev4.2-beta1
Host platforms covered for toolchain setupWindows, Linux and macOS

Frequently asked questions

Which operating systems does the toolchain setup cover?

The guide gives standard toolchain setup instructions for Windows, Linux and macOS.

What are the steps in the Get Started section?

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.

Does the guide include Bluetooth APIs?

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.

Where is JTAG debugging described?

JTAG debugging is covered in the API Guides, including how it works, selecting a JTAG adapter, OpenOCD setup and launching the debugger.

Download PDF (16.4 MB)

More Espressif Manuals


View all Espressif manuals →