Get Started
This document is intended to help you set up the software development environment for the hardware based on the ESP32 chip by Espressif. After thata simple example will show you how to use ESP-IDF (Espressif IoT Development Framework) for menu configurationthen for building and flashing firmware onto an ESP32 board.
Note
This is documentation for stable version v5.5.3 of ESP-IDF. Other ESP-IDF Versions are also available.
Introduction
ESP32 is a system on a chip that integrates the following features:
Wi-Fi (2.4 GHz band)
Bluetooth
Dual high performance Xtensa® 32-bit LX6 CPU cores
Ultra Low Power co-processor
Multiple peripherals
Powered by 40 nm technologyESP32 offers excellent power efficiencyRF performancesecurityand reliabilitymaking it suitable for a wide range of application scenarios and power consumption requirements.
Espressif provides basic hardware and software resources to help application developers realize their ideas using the ESP32 series hardware. The software development framework by Espressif is intended for development of Internet-of-Things (IoT) applications with Wi-FiBluetoothpower management and several other system features.
What You Need
Hardware
An ESP32 board.
USB cable - USB A / micro USB B.
Computer running WindowsLinuxor macOS.
Note
Currentlysome 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 official development boards listed belowyou can click on the link to learn more about the hardware.
Software
To start using ESP-IDF on ESP32install the following software:
Toolchain to compile code for ESP32
Build tools - CMake and Ninja to build a full Application for ESP32
ESP-IDF that essentially contains API (software libraries and source code) for ESP32 and scripts to operate the Toolchain
Installation
To install all the required softwarewe offer some different ways to facilitate this task. Choose from one of the available options.
IDE
Note
We highly recommend installing the ESP-IDF through your favorite IDE.
Manual Installation
For the manual procedureplease select according to your operating system.
Build Your First Project
If you already have the ESP-IDF installed and are not using an IDEyou can build your first project from the command line following the Start a Project on Windows or Start a Project on Linux and macOS.
Uninstall ESP-IDF
If you want to remove ESP-IDFplease follow Uninstall ESP-IDF.