使用 VS Code 快速搭建 ESP-IDF 开发环境 (Windows、Linux、MacOS)

ESP-IDF 是乐鑫官方的物联网开发框架,适用于 ESP32、ESP32-S、ESP32-C 和 ESP32-H 系列 SoC。它基于 C/C++ 语言提供了一个自给自足的 SDK,方便用户在这些平台上开发通用应用程序,并集成了大量的软件组件,包括 RTOS、外设驱动程序、网络栈、多种协议实现技术以及常见应用程序的使用助手。

若您此前没有接触过 ESP-IDF,可点击以下链接了解 ESP-IDF 的功能特性:

  • VS Code ESP-IDF IDE 快速入门
  • ESP-IDF 插件使用教程

目前 ESP-IDF 支持 Eclipse 和 VS Code 等 IDE,能够简化开发人员安装和使用过程。

您可以观看下面的教程视频,也可以阅读本篇的图文教程。本文详细介绍在 Windows 环境下,如何在 VS Code 中安装 ESP-IDF VS Code 插件,从而简单、便捷的完成 ESP-IDF 环境搭建。

【乐鑫教程】使用 VS Code 快速搭建 ESP-IDF 开发环境 (Windows、Linux、MacOS)


搭建步骤

1. 在安装 ESP-IDF VS Code 插件前,需要确保您的电脑上已经下载并安装了 VS Code

2. 在 VS Code 界面左侧的扩展(插件市场)中搜索“esp idf”,在列表中找到“Espressif IDF” 并点击安装。

使用 VS Code 快速搭建 ESP-IDF 开发环境 (Windows、Linux、MacOS)_第1张图片

3. 安装完成后,按下 F1 或 Ctrl+Shift+P 打开命令行,输入 esp-idf extension,并点击“配置 ESP-IDF 插件”。

使用 VS Code 快速搭建 ESP-IDF 开发环境 (Windows、Linux、MacOS)_第2张图片

4. 接下来,在配置界面选择全局的快速安装模式,此模式无需多余的配置,能够快速简洁的完成安装。设置完成后,点击 “EXPRESS”。

使用 VS Code 快速搭建 ESP-IDF 开发环境 (Windows、Linux、MacOS)_第3张图片

5. 为避免在安装过程中出现无法访问 Github 的情况导致安装失败,需要将服务器设置为 Espressif,并勾选下方的“ 所有 IDF tag 版本”,接着在“选择 ESP-IDF 版本”中选择以 v 开头的则为 TAG 版本。

使用 VS Code 快速搭建 ESP-IDF 开发环境 (Windows、Linux、MacOS)_第4张图片

6. 设置 ESP-IDF 源码文件夹的路径,需要注意此文件夹必须为空文件夹。

7. 随后选择 ESP-IDF 工具链的安装位置,此位置可以为任意位置。

8. 确认所有设置完毕后点击 Install,开始安装。安装过程会持续 15~20分钟。

使用案例库中的案例进行测试

  1. 安装成功后,在 VS Code 中调用出命令行,键入“ESP-IDF: Show Examples Projects”。

使用 VS Code 快速搭建 ESP-IDF 开发环境 (Windows、Linux、MacOS)_第5张图片

2. 点击“Use current ESP-IDF (d: work\esp\esp vscode esp-idf) ESP-IDF”在左侧边栏中选择 hello_world 工程,然后点击“Create project using example hello world”,接着在跳出的目录中选择路径。

使用 VS Code 快速搭建 ESP-IDF 开发环境 (Windows、Linux、MacOS)_第6张图片

3. 点击 VS Code 下方的图标进行 COM口 配置。

使用 VS Code 快速搭建 ESP-IDF 开发环境 (Windows、Linux、MacOS)_第7张图片

4. 接下来需要点击 VS Code 下方的图标,根据实际所用的芯片进行型号选择,本文示例中使用的芯片是 ESP32-S3,所以此处也配置成 ESP32-S3。

使用 VS Code 快速搭建 ESP-IDF 开发环境 (Windows、Linux、MacOS)_第8张图片

5. 此外还需设置连接方式,请根据实际情况进行选择,本文示例中使用的是串口转 USB,故选择第一个。

使用 VS Code 快速搭建 ESP-IDF 开发环境 (Windows、Linux、MacOS)_第9张图片

6. 点击 Build 开始编译,开始编译后在终端中能够看到编译正在进行,并输出编译过程中的 log。

7. 烧录成功后打开串口工具,查看设备输出的 log,如果能够成功打印,即表明我们的 ESP-IDF 环境已经搭建好了。

使用 VS Code 快速搭建 ESP-IDF 开发环境 (Windows、Linux、MacOS)_第10张图片

特殊情况

在编译过程中可能会出现如下图的乱码:

使用 VS Code 快速搭建 ESP-IDF 开发环境 (Windows、Linux、MacOS)_第11张图片

这是由于没有正确设置波特率导致的。需打开 VS Code 的设置面板,输入 esp-idf,将波特率改为 115200 后即可。

使用 VS Code 快速搭建 ESP-IDF 开发环境 (Windows、Linux、MacOS)_第12张图片


以上就是通过 VS Code 完成 ESP-IDF 的环境搭建及测试的全过程。此外,ESP-IDF 还支持 MacOS 及 Linux,并与在 Windows 环境下的搭建过程相同。如果您有任何问题,可以到乐鑫官网查看相关技术文档获取帮助,欢迎在评论区留言讨论,或随时联系我们

你可能感兴趣的:(乐鑫科技,ESP-IDF,VS,Code,开发环境搭建)