# 快速入门

[English]

本文档旨在指导用户搭建 ESP32 硬件开发的软件环境，通过一个简单的示例展示如何使用 ESP-IDF (Espressif IoT Development Framework) 配置菜单，并编译、下载固件至 ESP32 开发板等步骤。

备注

这是ESP-IDF tag `v5.5-rc1` 版本的文档，还有其他版本的文档 ESP-IDF 版本简介 供参考。

## 概述

ESP32 SoC 芯片支持以下功能：

- 2.4 GHz Wi-Fi

- 蓝牙

- 高性能 Xtensa® 32 位 LX6 双核处理器

- 超低功耗协处理器

- 多种外设

ESP32 采用 40 nm 工艺制成，具有最佳的功耗性能、射频性能、安全性和可靠性，适用于各种应用场景和不同功耗需求。

乐鑫为用户提供完整的软、硬件资源，进行 ESP32 硬件设备的开发。其中，乐鑫的软件开发环境 ESP-IDF 旨在协助用户快速开发物联网 (IoT) 应用，可满足用户对 Wi-Fi、蓝牙、低功耗等方面的要求。

## 准备工作

### 硬件：

- 一款 ESP32 开发板

- USB 数据线 （A 转 Micro-B）

- 电脑（Windows、Linux 或 macOS）

备注

目前一些开发板使用的是 USB Type C 接口。请确保使用合适的数据线来连接开发板！

以下是 ESP32 官方开发板，点击链接可了解更多硬件信息。

- ESP32-DevKitC
- ESP32-DevKitM-1
- ESP-WROVER-KIT
- ESP32-PICO-KIT
- ESP32-Ethernet-Kit
- ESP32-PICO-KIT-1
- ESP32-PICO-DevKitM-2

### 软件：

如需在 ESP32 上使用 ESP-IDF，请安装以下软件：

> - 设置 工具链，用于编译 ESP32 代码；

> - 编译构建工具 —— CMake 和 Ninja 编译构建工具，用于编译 ESP32 应用程序；

> - 获取 ESP-IDF 软件开发框架。该框架已经基本包含 ESP32 使用的 API（软件库和源代码）和运行 工具链 的脚本；

## 安装

为安装所需软件，乐鑫提供了以下方法，可根据需要选择其中之一。

### IDE

备注

建议通过自己喜欢的集成开发环境 (IDE) 安装 ESP-IDF。

- Eclipse Plugin

- VSCode Extension

### 手动安装

请根据操作系统，选择对应的手动安装流程。

- Windows Installer
- Linux and macOS

## 编译第一个工程

如果已经安装好 ESP-IDF，且没有使用集成开发环境 (IDE)，请在命令提示行中，按照 在 Windows 中开始创建工程 或 在 Linux 和 macOS 中开始创建工程 编译第一个工程。

## 卸载 ESP-IDF

如需卸载 ESP-IDF，请参考 卸载 ESP-IDF。

此文档对您有帮助吗？

- 反馈已收到，谢谢！
- 如果您有其他意见，欢迎填写乐鑫文档反馈表。

- 我们重视您的反馈。
- 您可以填写乐鑫文档反馈表告诉我们如何改进该文档。