题记:坑是踩不完填不好的,填好也会有新的。
1、ESP-IDF在Windows环境下的配置
在一路CSDN、百度、乐鑫官方文档的检索、查阅之后,我决定不讲那些花里胡哨的东西,直接上流程。
1.1 准备内容
- 一台可以开机并可以正常使用的Win10操作系统的电脑(自己买不提供)
- ESP-IDF离线安装包(提取码:8066)
1.2 安装步骤
- 双击 esp-idf-tools-setup-offline-2.11.exe 这个文件
- 选择语言类型(中国人就选简体中文 想突破也不拦着)
- 同意协议(有逆骨不介意安装)
- 环境检测
如果有问题就按照安装程序显示的进行修复就好,如果没问题就是以下界面: - 选择安装版本(目前乐鑫官方给出的最新版本为5.0.1)
我提供的这个安装包是旧版本,但目前网上能找到的相关ESP32的教程视频或者博客几乎都是用的4.3版本(并且就连旧版本我都没整明白,不敢给你玩新的),所以选择4.3.1版本安装。(但凡ESP32大佬也不至于看我这个文章)
安装路径以自己的电脑情况为准,但一定要记住自己的路径在哪,后续在VSCode中可能会用到。 - 安装ESP-IDF Tools(同样,请记住自己的安装路径!)
- 选择组件
就按默认勾选的就行,如果你是用的是其他带后缀的ESP32芯片记得一定要看看有没有或者有没有勾选。 - 确认安装路径并开始安装进度条
注意:再次期间会有组件安装弹窗,记得允许安装。 - 安装就结束了
1.3 测试是否安装成功(不行就要全删重来!)
- 找到你ESP-IDF的安装路径,开始HelloWorld例程测试
这就是前面让你记住的原因,进入之后按照这个路径:\esp-idf\examples\get-started\hello_world 找到hello_world工程 - 复制路径
- 打开桌面上的这两个图标中的任意一个(我开CMD)
- 设置芯片信息 命令:idf.py set-target esp32
设置成功就会出现如下界面: - cd切换到刚刚的工程路径下
- 编译工程 命令:idf.py build
第一次编译的时间会比较长,而且会显示很多内容,在编译通过之后会跳出烧写命令提示,基本如下: - 按照ESP32接入的端口号开始烧写 命令:idf.py -p 端口号 flash
端口号查询:win标键 + x 进入设备管理器之后查看端口就能看到对应的端口号了。 - 烧录成功之后通过窗口输出查看显示效果 命令:idf.py -p 端口号 monitor
- 到这里,ESP-IDF在Windows环境下的安装就已经完成了。如果上述出现问题,请卸载干净后重新安装ESP-IDF。
2、VSCode以及所需插件安装
2.1 准备内容
- VSCode安装包(提取码:uroc)
2.2 安装和插件选择
- 安装
只需要双击安装包,选择路径即可,记得在完成后勾选“加入环境变量Path”。 - 插件安装
在安装完成VSCode之后,进入初始页面会让选择界面风格,选自己喜欢的即可。
- 中文插件(软件会根据系统语言自动推荐,安装完成需重启VSCode)
- Espressif插件
- C/C++插件
- Espressif插件设置
- 点击左下角齿轮按钮,进入设置
- 在“用户” - “扩展” - “ESP-IDF”中找到“idf:Flash Type”设置,将Flash设置为“UART”。
- 继续和ESP-IDF环境配置一样,进入HelloWorld工程目录下,右击选择“VSCode打开”,就可以通过VSCode直接打开工程文件。
- 在VSCode界面中通过Ctrl + Shift + P的快捷键打开命令面板进行Espressif的配置
- 输入:ESP-IDF:Configure ESP-IDF extension
- 选择最后一项:use existing setup 从已经存在的环境安装
接下来插件会自动识别你是否安装ESP-IDF和ESP-IDF Tools,然后自动判断是否欠缺工具。如果在这一步出现关于py的相关报错,先去你安装ESP-IDF Tools的目录中找到python_env\idf4.3_py3.8_env\Scripts路径,双击一下pip.exe,基本上就能解决,如果还不行,将错误信息粘贴到百度上就可以解决(百度大法好)。
- 安装完成
安装完成会出现一个界面,提示你已经完成关闭本页面即可,至此插件配置完成。 - 回到刚刚我们打开HelloWorld工程界面,使用VSCode进行编译、烧写和输出查看
在界面下方有关于ESP32的工具条,通过工具条就可以完成和使用ESP-IDF命令敲出来的编译 烧写一样的效果。
PS:如果打开 .c文件发现#include头文件爆红,将鼠标点击在有红色波浪线处会出现一个黄色小灯泡,选择编辑“includePath设置”,进入后找到包含路径,在后面输入自己ESP-IDF和ESP-IDF Tools的目录即可。
工具条如图所示:
编译完成后,点击“小电视 ”效果:
至此,ESP-IDF和VSCode的安装和配置就此结束。预祝各位ESP32开发少坑,代码无红!