# esp32实验

**Repository Path**: sumayi/esp32

## Basic Information

- **Project Name**: esp32实验
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-23
- **Last Updated**: 2026-05-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 示例项目

本目录包含了一系列 ESP-IDF 示例项目。这些示例旨在演示 ESP-IDF 的各项功能，并提供可供您复制和修改以用于自己项目的代码。

## 示例布局

这些示例按类别分组到不同的子目录中。每个类别目录包含一个或多个示例项目：

- `bluetooth/bluedroid`: 使用默认 Bluedroid 主机协议栈的经典蓝牙、低功耗蓝牙（BLE）和共存示例。
- `bluetooth/nimble`: 使用 NimBLE 主机协议栈的 BLE 示例。
- `bluetooth/esp_ble_mesh`: ESP BLE Mesh 示例。
- `bluetooth/hci`: HCI 传输层（VHCI 和 HCI UART）示例。
- `build_system`: 构建系统特性相关的示例。
- `cxx`: C++ 语言使用示例和实验性组件。
- `ethernet`: 以太网网络示例。
- `get-started`: 功能最简化的小示例，是初学者的绝佳起点。
- `ieee802154`: IEEE 802.15.4 协议示例。
- `mesh`: Wi-Fi Mesh 网络示例。
- `network`: 与通用网络环境、测试和分析相关的示例。
- `openthread`: OpenThread 协议示例。
- `peripherals`: 展示 ESP32 各板载外设驱动功能的示例。
- `protocols`: 展示网络协议交互的示例。
- `provisioning`: Wi-Fi 配网示例。
- `security`: 关于安全特性的示例。
- `storage`: 展示使用 SPI Flash、SD/MMC 接口等外部存储和 Flash 分区的数据存储方案的示例。
- `system`: 演示一些芯片内部特性或调试与开发工具的示例。
- `wifi`: 高级 Wi-Fi 功能示例（网络协议相关的示例请参见 `protocols` 目录）。
- `Zigbee`: Zigbee 网络和设备示例。

除了这些示例，`commmon_components` 目录包含了被多个示例共享的代码。

## 使用示例

在构建示例之前，请遵循 [ESP-IDF 入门指南](https://idf.espressif.com/) 来确保您已搭建好所需的开发环境。

### 设置目标芯片

首先，您的目标芯片必须同时被以下两者支持：

- **您的 ESP-IDF 版本**：要查看支持的完整目标列表，请运行：
  ```
  idf.py --list-targets
  ```
- **本示例**：要查看支持的完整目标列表，请参阅本 README 文件顶部的支持目标表格。

在确认您的目标芯片被支持后，进入您的示例项目目录并[设置目标芯片](https://docs.espressif.com/projects/esp-idf/en/latest/api-guides/tools/idf-py.html#select-the-target-chip-set-target)：

```
idf.py set-target <target>
```

例如，要将 esp32 设置为目标芯片，请运行：

```
idf.py set-target esp32
```

### 配置项目

有关 Kconfig 选项的信息，请参阅[项目配置](https://docs.espressif.com/projects/esp-idf/en/latest/api-reference/kconfig.html)。

要方便地在项目配置菜单中检查或修改本示例的 Kconfig 选项，请运行：

```
idf.py menuconfig
```

### 构建和烧录

执行以下命令来构建项目、将其烧录到您的开发板，并运行监视器工具以查看串口输出：

```
idf.py build flash monitor
```

此命令可以缩写为 `idf.py flash monitor`。

如果上述命令失败，请检查串口监视器上的日志，通常它会提供问题可能原因的信息。

要退出串口监视器，请使用 `Ctrl` + `]`。

## 运行 Python 测试脚本 (pytest)

部分示例拥有 `pytest_....py` 脚本，这些脚本使用 `pytest` 作为测试框架。详细信息请参阅 [ESP-IDF tests in Pytest 文档](../docs/en/contribute/esp-idf-tests-with-pytest.rst)下的“在本地运行测试”部分。

我们推荐使用 `pytest` 来编写新的测试。我们很快会将所有示例测试脚本迁移到这个新框架。

## 复制示例

每个示例都是一个独立的项目。这些示例**不必存放在 esp-idf 目录内**。您可以将示例目录复制到您计算机上的任何位置，以便创建一个您可以修改和使用的副本。

`IDF_PATH` 环境变量是连接示例与 ESP-IDF 其余部分的唯一纽带。

如果您正在寻找一个更精简的项目作为起点，可以试试 [esp-idf-template](https://github.com/espressif/esp-idf-template)。

## 后续开发

关于如何进行项目开发的后续步骤，请参阅以下内容：

- 管理项目：
  - [IDF 前端](https://docs.espressif.com/projects/esp-idf/en/latest/api-guides/build-system.html#start-a-new-project) 文档
  - ESP-IDF 入门视频 ([YouTube](https://youtu.be/J8zc8mMNKtc?t=340), [bilibili](https://www.bilibili.com/video/BV1114y1r7du/?t=336))
  - 示例项目[概览](https://docs.espressif.com/projects/esp-idf/en/latest/esp32/api-guides/build-system.html#example-project)
  - [构建系统](https://docs.espressif.com/projects/esp-idf/en/stable/esp32/api-guides/build-system.html) 文档
- 编写代码：
  - 遵循 [API 参考](https://docs.espressif.com/projects/esp-idf/en/stable/api-reference/index.html) 来编写您自己的代码