警告

This document is not updated for ESP32C5 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.

# 快速入门

[English]

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

备注

这是ESP-IDF 稳定版本 v5.4 的文档，还有其他版本的文档 ESP-IDF 版本简介 供参考。

## 概述

ESP32-C5 SoC 芯片支持以下功能：

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

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

## 准备工作

### 硬件：

- 一款 ESP32-C5 开发板

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

- 电脑（Windows、Linux 或 macOS）

备注

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

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

### 软件：

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

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

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

> - 获取 ESP-IDF 软件开发框架。该框架已经基本包含 ESP32-C5 使用的 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。

此文档对您有帮助吗？

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

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