This document is not updated for ESP32H2 yet, so some of the content may not be correct.

This warning was automatically inserted due to the source file being in the add_warnings_pages list.

Get Started


This document is intended to help you set up the software development environment for the hardware based on the ESP32-H2 chip by Espressif. After that, a simple example will show you how to use ESP-IDF (Espressif IoT Development Framework) for menu configuration, then for building and flashing firmware onto an ESP32-H2 board.


This is documentation for stable version v5.1 of ESP-IDF. Other ESP-IDF Versions are also available.


ESP32-H2 is a system on a chip that integrates the following features:

Powered by 40 nm technology, ESP32-H2 provides a robust, highly integrated platform, which helps meet the continuous demands for efficient power usage, compact design, security, high performance, and reliability.

Espressif provides basic hardware and software resources to help application developers realize their ideas using the ESP32-H2 series hardware. The software development framework by Espressif is intended for development of Internet-of-Things (IoT) applications with Wi-Fi, Bluetooth, power management and several other system features.

What You Need


  • An ESP32-H2 board.

  • USB cable - USB A / micro USB B.

  • Computer running Windows, Linux, or macOS.


Currently, some of the development boards are using USB Type C connectors. Be sure you have the correct cable to connect your board!

If you have one of ESP32-H2 official development boards listed below, you can click on the link to learn more about the hardware.


To start using ESP-IDF on ESP32-H2, install the following software:

  • Toolchain to compile code for ESP32-H2

  • Build tools - CMake and Ninja to build a full Application for ESP32-H2

  • ESP-IDF that essentially contains API (software libraries and source code) for ESP32-H2 and scripts to operate the Toolchain

Development of applications for ESP32-H2


To install all the required software, we offer some different ways to facilitate this task. Choose from one of the available options.



We highly recommend installing the ESP-IDF through your favorite IDE.

Manual Installation

For the manual procedure, please select according to your operating system.

Build Your First Project

If you already have the ESP-IDF installed and not using IDE, you can build your first project from the command line following the Start a Project on Windows or Start a Project on Linux and macOS.