记录VScode和ESP-IDF开发环境如何搭建

最新推荐文章于 2024-05-30 15:48:57 发布

分～耳

最新推荐文章于 2024-05-30 15:48:57 发布

阅读量388

点赞数 2

文章标签： vscode ide 编辑器

第一章记录VScode和ESP-IDF开发环境如何在windows下搭建

前言

该文档制作内容全部参考：为CSDN博主「爱出名的狗腿子」的原创文章
原文链接：https://blog.csdn.net/qq_43332314/article/details/129776889

一、软件下载

ESP-IDF-V5.1.1 SDK

乐鑫官网：https://dl.espressif.cn/dl/esp-idf/?idf=4.4
下载第三个880MB的离线安装包

Visual Studio Code

下载VScode：https://code.visualstudio.com/
点击中间的下载视窗

二、软件安装

ESP-IDF安装

双击esp-idf-tools-setup-offline-5.1.1.exe打开；
一直点确定-同意-下一步-全选-安装，直到安装完成；

VScode安装

双击VSCodeUsersetup-x64-1.78.0.exe打开；
一直点下一步-全选-安装，直到安装完成(在这重启一下)；

在这里插入图片描述

接着打开VScode安装Espressif IDF插件（注意这里下载好就行了，不要去配置）;

三、VScode和ESP-IDF环境搭建

配置ESP-IDF环境

1.先找到安装目录下的 install.bal 文件；

2.打开 ESP-IDF 5.1 CMD 工具，并运行目录下的 install.bat 文件,为了完成交叉编译工具链之类的安装，配置 IDF 工具，为所有ESP32设备环境；

3.使用 ESP-IDF 5.1 CMD 工具运行目录下的 export.bat 文件,为了导入esp32 idf的环境变量；

4.至此，windows环境下的esp32 idf环境已经搭建完成；

创建自己工程

1.先跳转到examples目录下，再使用 ESP-IDF CMD 工具创建工程；

2.使用 ESP-IDF CMD 工具创建工程test文件夹;

3.设置目标设备，如开发esp32；

4.默认使用ESP-IDF CMD创建工程之后，可使用 idf.py build编译工程;

VSCode代码编辑器头文件报错

1.使用vscode打开编辑

2.解决vscode找不到头文件，波浪线警告
默认使用ESP-IDF CMD创建工程之后，可使用 idf.py build编译工程，但是使用vscode打开工程，添加头文件之后，vscode会提示找不到头文件，以及相应宏、函数无法跳转，这是由于vscode没有配置导致.

3.消除警告方法
•安装 Espressif IDF 插件;

•进入F:\edp-idf\Espressif\frameworks\esp-idf-v5.1.1目录，重新运行 install.bat 脚本，此脚本会配置 Espressif IDF 插件;

•使用vscode打开相应工程，注意vscode打开的是对应的工程路径，而不是包含多个工程的路径;

•按快捷键 ctrl+shift+p打开命令行，找到 ESP-IDF:Add vscodeconfiguration folder，点击一下即可自动生成对应的vscode配置文件;

•点击之后可以看到工程目录下多了一个 .vscode 目录，并产生了相应的文件，其中c_cpp_properties.json内描述的就是对应的头文件路径;

•之后可以看到波浪线警告消失了，对应的文件也可以通过 ctrl+鼠标左键打开

添加项目组件

1.创建 components目录和gpio项目组件，使用idf命令创建组件：idf.py -C components create-component gpio

2.接着VScode代码编辑器在项目组件内编写对应的程序即可；

3.先清除工程，使用idf.py clean；

4.再之后重新编译，使用idf.py build；

添加扩展组件

1.创建扩展组件集目录user；

2.在user目录下创建gpio驱动组件目录gpio;

3.复制其他组件main的CMakeLists.txt到gpio;

4.在gpio目录下创建drv_gpio.c和drv_gpio.h;

5.扩展组件文件夹最终效果；

6.接着VScode代码编辑器在扩展组件内编写对应的程序，再编译测试（先清除工程，之后重新编译使用idf.py clean，再使用idf.py build）；

7.扩展怎么删除drv_gpio.c和drv_gpio.h文件；

8.扩展怎么删除gpio文件夹；

扩展组件内部引用ESP-IDF内部组件函数、头文件报错

1.当我们创建好单独的组件后，将在单独的组件内编写各自的应用，如上，我们创建了 gpio 组件，那么相应将会在gpio组件中编写对应的gpio驱动，驱动中肯定会要应用ESP-IDF内的组件，但是当我们编译的时候会提示找不到相应文件

2.这是由于依赖问题没有解决导致，我们编写的drv_gpio.c文件没有指定依赖，那么编译器将不知道去哪里找这个driver/gpio.h文件，因此报错，所以我们需要给它加上依赖，修改对应组件的CMakeLists.txt文件，增加 REQUIRES driver 指定依赖driver组件：