跳到主要内容

ESP-IDF 开发

本章节包含以下两部分，请按需阅读：

ESP-IDF 入门教程​

初次接触 ESP32 ESP-IDF 开发，想要快速上手？我们为您准备了一套通用的 入门教程。

请注意：该教程使用 ESP32-S3-Zero 作为教学示例，所有硬件代码均基于其引脚布局。在动手实践前，建议您对照手中的开发板引脚图，确认引脚配置无误。

配置开发环境​

备注

以下环境设置适用于 Windows 10/11 系统，Mac/Linux 用户请参考 官方说明

  1. 下载并安装 Visual Studio Code。

  2. 在 VS Code 中，通过点击 VS Code 侧边活动栏中的 扩展图标 或使用快捷键（Ctrl+Shift+X）来打开 扩展 视图。然后，搜索 ESP-IDF 扩展并安装。

    在 VS Code 中搜索并安装 ESP-IDF 扩展

  3. 安装扩展后，VS Code 左侧活动栏中会出现 Espressif 图标 图标，点击该图标可查看 ESP-IDF 扩展的基本命令列表，在 Advanced 中选择 配置 ESP-IDF 扩展。

    选择“配置 ESP-IDF 拓展”

  4. 选择 Express 进入快速配置模式：

    选择快速配置模式

  5. 根据需要修改以下选项。

    • 选择下载服务器：
      • Espressif：使用乐鑫中国服务器，下载速度更快。
      • Github：使用 GitHub 官方发布链接。
    • ESP-IDF 版本：通常根据开发板要求选择对应版本，如无特殊要求建议使用最新的正式版本。对于 ESP32-S3-Touch-LCD-1.69 ，建议 Espressif IDF 版本 ≥ v5.3.1。
    • ESP-IDF 容器安装地址：建议使用默认地址，或使用纯英文路径且路径中不包含空格。
    • ESP-IDF 所需的工具安装地址：建议使用默认地址，或使用纯英文路径且路径中不包含空格。

    ESP-IDF 拓展快速配置模式选项

  6. 点击 Install 开始安装。你将看到一个显示安装进度的页面，包括 ESP-IDF 下载、ESP-IDF 工具下载安装以及 Python 虚拟环境创建的进度状态。

    安装进度

  7. 如果安装正确，你会看到所有设置已配置完成的提示，即可开始使用该扩展程序。

    安装成功

注意

注意：如果 ESP-IDF 安装失败或需要重新安装，可以尝试删除 C:\Users\%Username%\esp 和 C:\Users\%Username%\.espressif 文件夹后重试。

示例程序​

ESP-IDF 示例程序位于 示例程序包 的 ESP-IDF 目录中。

01_Hello world​

本示例演示了在 TERMINAL 窗口以 10 秒间隔输出 Hello world!

01_Hello world 示例输出

02_RGB​

本示例演示了板载 RGB 灯珠以 1 秒间隔进行闪烁

02_RGB 示例输出

03_UART​

本示例演示了短接 GPIO4 与 GPIO5 情况下进行 UART 的数据自收发

03_UART 示例输出

硬件连接

  • 通过杜邦线（母对母）短接 GPIO4 和 GPIO5
ESP32-C5-N16R4ESP32-C5-N16R4（同一块）
GPIO5GPIO5

代码解释

  • 发送任务（tx_task）：
    每隔 2 秒向 UART 发送字符串 "Hello waveshare"

  • 接收任务（rx_task）：
    持续从 UART 读取数据，若读到数据则打印字符串

04_IIC​

本示例点亮 0.96inch OLED (B)，显示一段字符

04_IIC示例输出1
04_IIC示例输出2

硬件连接

  • 将开发板插入电脑，并通过杜邦线将下列屏幕和引脚连接
0.96inch OLED (B)ESP32-C5-N16R4
VCC3V3
GNDGND
DINGPIO3
CLKGPIO4
CSGND
D/CGND
RSTGPIO9

05_WIFI​

本示例实现 ESP32-C5 连接 WIFI 获取心知天气 API 数据的功能

05_WIFI 示例输出

06_WIFI_AP​

本示例实现开发板开启 WiFi 热点并支持手机端连接的功能

06_WIFI_AP 示例输出

07_BLE​

本示例实现手机端连接蓝牙 BLE 信标并接收广播数据的功能

07_BLE 示例输出

08_ZIGBEE​

本示例实现两块 ESP32-C5，使用其中一块（烧录 HA_on_off_switch 程序）的 BOOT 按键控制另一块的 RGB 灯珠的亮灭

  • 注：请先往一块烧录 HA_on_off_switch 程序，再往另一块烧录 HA_on_off_light 程序
08_ZIGBEE 示例输出

硬件连接

  • 1：准备两块 ESP32-C5-N16R4 开发板，确保它们供电正常且处于可烧录程序的状态。
  • 2：将第一块开发板与电脑连接，使用烧录工具往该开发板烧录 HA_on_off_light 程序（此程序用于控制 RGB 灯），烧录完成后保持开发板上电状态。
  • 3：将第二块开发板与电脑连接，使用烧录工具往该开发板烧录 HA_on_off_switch 程序（此程序用于通过 BOOT 按键实现控制功能），烧录完成后保持开发板上电状态。
最后由 Wulu 于 更新