基于ESP-IDF+VSCODE的ESP32开发环境搭建
资源获取地址
安装ESP32-IDF库
下载ESP32—IDF库:下载地址
打开上述的网页,选择ESP32-IDF v5.1.2 - Offine Installer
v5.1.2是截稿的最新版本。
由于ESP-IDF库不同版本之间的API和函数有差异,建议遵循所使用的Demo的版本。
打开安装程序选择简体中文
勾选我同意此协议
打开长路径支持
如果你没有打开长路径支持,会出现如下提示。
由于GUN-GCC编译器会产生长而深的文件结构,如果不支持 长路径,可能会丢文件。
这里安装引导可以修复这个问题,点击应用修复,并同意UAC 即可。
安装程序提示修复成功后,NEXT。
选择安装路径
为了防止出现玄学问题,这里选择默认路径
选择安装组件
为了防止玄学问题,这里选择默认的”完全安装”,完全安装会 少安装ESP32-C2、ESP32-C6和ESP32-H2三个芯片包,如有需要请勾选。
准备安装
安装完成
一路NEXT后,会出现两个窗口,一个是PowerShell终端,一个是传统的CMD终端。
此时,依赖包(ESP32-IDF)安装完成
配置环境变量
打开电脑的用户环境变量设置,计算机属性 > 高级系统设置 > 环境变量 > [user]用户环境变量
检查是否出现分别为IDF_PATH和IDF_TOOLS_PATH两个环境 变量,检查值即路径是否正确。
如果不存在则需自行添加。
IDF_PATH | 安装目录\frframeworks\esp-idf-v5.1.2 |
---|---|
IDF_TOOLS_PATH | 安装目录\ |
配置VSCODE
安装ESP-IDF插件
配置ESP-IDF插件
这里选择EXPRESS,典型安装方式
- Select download server: 如果您在中国大陆或者处于网络环境较差的地区且无法正常使用Github,服务器请选择Espressif。
- Select ESP-IDF version: 由于刚刚已经安装ESP-IDF,直接选择Find ESP-IDF in your systm即可。
- Enter ESP-IDF directory (IDF_PATH)及Enter ESP-IDF Tools directory (IDF_TOOLS_PATH): 如果您的系统环境变量(即PATH)设置正确,那么保持默认即可。如果设置不正确,请查看第二章的内容。
测试Demo
创建Demo
1. 点击Show Examlpes,选择默认USe current ESP-IDF
2. 选择hello_world,选择Create project using example hello_world,选择需要放工程文件的文件夹
编译Demo
选择芯片,这里我用的是ESP32-C3,请根据你所用的芯片选择对应的芯片型号
点击VSCODE底栏的圆柱体(编译按钮)进行编译
ESP-IDF编译相对较慢,请耐心等待
出现Total sizes后,则说明编译成功
烧录Demo
插入开发版,选择好对应的端口号、烧录模式,然后点击闪电图标开始烧录
串口:选择相对应的串口。
烧录模式:选择串口烧录UART。
出现Hard resetting via RTS pin后,则表明烧录成功,请按下开发版山东各RST复位按键,重启单片机。
此时,点击电脑图标,调出调试窗口,可以看到HelloWorld,则表明烧录成功
已知问题和解决方案
Python版本问题
在配置ESP-IDF插件中出现"C:\Espressif\tools\idf-python\3.11.2\python.exe -m pip" is not valid. (ERROR_INVALID_PIP)
解决方法:打开CMD
1 | cd C:\Espressif\tools\idf-python\3.11.2\ |
如果出现ModuleNotFoundError: No module named 'pip'
1 | cd C:\Espressif\tools\idf-python\3.11.2\ |
串口调试乱码问题
在打开调试窗口后,未出现预期的Hello World,而是出现乱码,这是波特率问题
解决方法:
- 点击VSCODE左下角齿轮,选择设置
- 在顶部搜索框中输入ESP-IDF:Monitor Baud Rate
- 把框中修改成115200