ESP32- 开发笔记- 软件开发 1 -ESP32-C3 软件平台选择

1 开发方式选择

1.1 ESP-IDF 框架

ESP-IDF 是乐鑫官方的物联网开发框架，适用于 ESP32、ESP32-S 和 ESP32-C 系列 SoC。它基于 C/C++ 语言提供了一个自给自足的 SDK，方便用户在这些平台上开发通用应用程序。ESP-IDF 目前已服务支持数以亿计的物联网设备，并已开发构建了多种物联网产品，例如照明、消费电子大小家电、支付终端、工控等各类物联网设备。

1.2 Arduino 平台

Arduino 是一个集成了软硬件的开源电子原型平台，以其易用性和灵活性而著称。借助 Arduino，用户可以通过集成传感器、执行器等电子元件来构建交互式项目。Arduino 的简洁性和可扩展性使其成为原型开发、嵌入式系统开发以及创客教育等多个领域的优先选择。

2 ESP-IDF 框架

本笔记仅仅是介绍 仅包含针对 ESP32-C3 芯片的 ESP-IDF 使用。如需了解其他芯片，请在页面左上方的下拉菜单中选择你的目标芯片。

2.1 安装

1. 这里采用vscode 集成环境，安装VSCode Extension。

2. 打开 VS Code，点击左侧活动栏中的扩展图标，或使用查看：显示扩展命令（快捷键：⇧⌘X 或 Ctrl+Shift+X）
   

3. 安装上述扩展。安装成功后，Espressif 图标 会出现在 VS Code 左侧活动栏中。点击该图标，可以看到该扩展提供的基本命令列表。
   

4. 从命令列表中选择 配置 ESP-IDF 扩展，然后点击express 进行配置

5. 配置编译器环境。

下载服务器：Espressif：该服务器链接在中国的下载速度更快。 Github：使用 Github 发布链接。

选择要下载的 ESP-IDF 版本，或选择 Find ESP-IDF in your system 选项查找系统中已有的 ESP-IDF 目录

确保 IDF_TOOLS_PATH 中不包含空格，避免构建过程中出现问题，且 IDF_TOOLS_PATH 与 IDF_PATH 不能相同。

完成后，点击安装就好。

2。 安装后结果

2.2 在 VS Code 中使用 ESP-IDF 扩展

SP-IDF 扩展在 VS Code 底部蓝色窗口的状态栏中提供了一系列命令图标，将鼠标悬停在图标上时，会看到可执行的命令。：完成编译，配置，下载等操作。

以下步骤展示了这些图标的常见用例：

1. 按 F1 并输入 ESP-IDF：展示示例项目，可以基于 ESP-IDF 示例创建新项目。在命令面板中选择 ESP-IDF，搜索想使用的示例并创建新项目。

2. 创建好新项目并在 VS Code 中打开后，点击状态栏图标 串口 设置设备的串口。也可以按 F1 输入 ESP-IDF：选择要使用的端口，选择设备连接的串口。

3. 点击状态栏图标 IDF 目标 选择使用的芯片设备（如 esp32、esp32s2 等），或按 F1 输入 ESP-IDF：设置乐鑫设备目标 命令。

4. 接下来，通过点击状态栏图标 sdkconfig 编辑器 或按 F1 输入 ESP-IDF：SDK 配置编辑器 命令（快捷键：CTRL E G），修改 ESP-IDF 项目设置。完成所有更改后，点击 Save 并关闭此窗口。可以在菜单栏中的查看 -> 输出中选择下拉列表里的 ESP-IDF 来查看输出信息。

5. （可选）ESP-IDF：运行 idf.py reconfigure 任务 命令生成 compile_commands.json 文件，以便启用语言支持。也可以按照 C/C++ 配置 文档中的说明来配置 .vscode/c_cpp_properties.json。

6. 请自行对代码进行必要修改。完成项目后，点击状态栏图标 构建 或按 F1 输入 ESP-IDF：构建项目 来构建项目。

7. 点击状态栏图标 烧录 或按 F1 输入 ESP-IDF：烧录项目，依据使用的接口类型，在命令面板中选择 UART、DFU 或 JTAG，将应用程序烧录到设备上。

8. 点击状态栏图标 烧录方式 或按 F1 输入 ESP-IDF：选择烧录方式，从 UART、DFU 或 JTAG 中选择想要更改的烧录方式。也可以直接使用命令 ESP-IDF：通过 UART 接口烧录项目、通过 JTAG 接口烧录项目 或 ESP-IDF：通过 DFU 接口烧录项目。

9. 点击状态栏图标 监视器 或按 F1 输入 ESP-IDF：监视设备 启动监视器，在 VS Code 终端中记录设备活动。

10. 根据 ESP-IDF 文档中的要求来配置驱动程序，详情请参考配置 JTAG 接口。

11. 在调试设备之前，先按 F1 输入 ESP-IDF：选择 OpenOCD 开发板配置，选择设备的 OpenOCD 开发板配置文件。点击状态栏图标 openocd 或按 F1 输入 ESP-IDF：OpenOCD 管理器 命令来测试连接。可以在菜单栏中的查看 -> 输出里选择下拉列表中的 ESP-IDF 来查看输出信息。

注意： 可以使用 ESP-IDF：OpenOCD 管理器 命令或者点击 VS Code 状态栏中的 OpenOCD Server (Running | Stopped) 按钮来启动或停止 OpenOCD。

确保项目已经构建并烧录，OpenOCD 连接正常，调试器能正常工作。按 F5 启动调试会话。调试会话的输出可在菜单栏中选择查看 -> 调试控制台进行查看。

3 离线安装

如果在线下载慢，可以选择离线安装。我这里有一个5.4.1 ESP-IDF

通过网盘分享的文件：esp-idf-v5.4.1.zip
链接: https://pan.baidu.com/s/1OjYyWDh7GqFt7ySB9FXq0A?pwd=dtsw 提取码: dtsw
–来自百度网盘超级会员v7的分享

你下载后，可以选择本地查找来安装。