个人技术分享

一、安装Visual Studio Code

下载地址:Download Visual Studio Code - Mac, Linux, Windows

打开上方链接,选择页面中的Windows版本,单击下载

将下载好的VSCodeUserSetup-x64-1.89.1.exe。单击右键,选择以管理员身份运行,开始安装

在安装界面中勾选 我同意此协议 然后单击 下一步 按钮。

在接下来的界面中,勾选 所有选项 ,然后单击 下一步 按钮

在接下来的界面中,直接单击 安装 按钮

接下来等待安装完成

安装完成,单击完成按钮

二、Visual Studio Code设置中文

同时按Ctrl + Shift + X 快捷键
在左侧“扩展”视图文本框中输入“Language Packs”,找到Chinese 中文插件,单击绿色的Install安装按钮,这里我们安装的是中文简体,安装完成右下角弹出一个重启按钮,点击重启,语言自动切换

三、安装C/C++扩展

同样的方式搜索C/C++,安装C/C++扩展来支持C语言代码高亮

四、打开ESP32工程

方式一

VSCode中打开ESP32的代码工程,可以直接打开代码所在的文件夹即可,文件菜单选择打开文件夹,选择一个源码目录打开

方式二

直接在工程文件夹下单击右键,选择 通过Code打开

打开后的文件结构

 五、安装Espressif IDF插件

在VSCode扩展插件中搜索 ESP,找到ESP-IDF,单击安装按钮

等待插件安装完成后,在VSCode中使用快捷键:Ctrl + Shift + P调出VSCode的命令面板,并输入“ESP Welcome”,单击ESP-IDF:Welcome。打开ESP配置页面

在页面中单击 Configure extension 配置扩展按钮

选择设置为全局 Global 然后选择 EXPRESS 开始配置

1、在此页面中选择ESP服务器为 Espressif

2、选择ESP-IDF版本为最新发行版  V5.2.1(release version) 

3、选择你的本地IDF库安装目录:F:\ESP32\Espressif 

4、选择你的本地IDF库工具安装目录:F:\ESP32\Espressif

F:\ESP32\Espressif 是我自己创建好的目录,第三个目录会自动在后面添加\esp-idf目录 ,所以3和4这里填写同一个目录即可。建议不要使用C盘,尽量挑大一点的磁盘。

确保目录正确且都存在,然后单击页面右下角的 Install 安装按钮

这里要安装非常久,耐心等待。

接出现如下界面,提示:Visual Studio代码的ESP-IDF扩展 所有设置都已配置。你可以关闭这个窗口。

四、Espressif IDF插件使用

依照上图Espressif IDF插件基本菜单一共12个,常用的只有两三个,依次为

1、选择串口(插头):即连接开发板的下载串口号,VS会列出当前连接电脑的所有串口让你选择,这个会记录,再新打开VSCode不用重新选择,开发过程中尽量不要更换USB线的电脑插口,否则串口号会变。

2、选择目标芯片:对应idf命令idf.py set-target xxxx。即你当前这个工程是要下载到什么芯片上面,如ESP32 S2,S3,C2,C3等等,工程要与芯片相匹配,这个选择是写入当前工程配置的,一般不用更改,工程下配置文件基本已经选择好的。

3、选择当前工程目录(文件夹):也不用修改,一般打开工程时会默认操作都在这个工程目录下

4、工程配置菜单(齿轮):对应idf命令idf.py menuconifg,用来配置当前工程的一些设置,配置项非常多,建议使用到再修改。一般代码工程都是配置好的,且不用修改

5、清除工程(垃圾桶):清除工程编译文件,一般用于压缩拷贝工程文件时用到,清除后工程目录占用空间会占用非常小,KB级,编译后为百MB级,还有一些编译过程中奇奇怪怪的问题也可以先清除编译后再编译

6、编译工程(圆柱体):编译当前工程,只是编译,没有下载功能

7、选择下载模式(五角星):一般都是选择串口UART方式下载

8、下载(闪电):下载编译好的固件到设备芯片上,这里只是下载,没有编译功能,修改代码后要先编译再点这个下载,所做的修改才有效。

9、串口监控(小电视):打开与设备连接的串口,打印设备串口信息

10、编译/下载/监控(一团火):最常用的一个,它将编译下载和打开串口监控做在了一起,点一次全部搞定

11、打开命令行:打开命令行窗口,且会定位在当前项目路径下,可以执行idf的一些命令

12、执行自定义任务:不使用

五、头文件包含、无法跳转、波浪线问题解决

打开ESP32工程头文件波浪线不能跳转,并且提示“在browse.path中未找到包含文件”等等引用错误提示。

1、按前面的四步安装配置好IDF插件后,删除源码目录中 <.vscode>文件夹。

2、在VSCode中使用快捷键: Ctrl + Shift + P 调出VSCode的命令面板,并输入查找“添加”,选择 添加 vscode配置文件夹

选择“ESP-IDF:添加 vscode 配置文件夹”,VSCode 会自动在源码目录下的<.vscode>文件夹中生成对应的配置文件,对应的红色波浪线也消失了,按住Ctrl 键用鼠标单击你想查看的头文件或函数,就可以跳转了。