题记:坑是踩不完填不好的,填好也会有新的。

1、ESP-IDF在Windows环境下的配置

在一路CSDN、百度、乐鑫官方文档的检索、查阅之后,我决定不讲那些花里胡哨的东西,直接上流程。

1.1 准备内容

  • 一台可以开机并可以正常使用的Win10操作系统的电脑(自己买不提供)
  • ESP-IDF离线安装包(提取码:8066)

1.2 安装步骤

  1. 双击 esp-idf-tools-setup-offline-2.11.exe 这个文件
  2. 选择语言类型(中国人就选简体中文 想突破也不拦着)
  3. ESP32 BLE密码 esp32-idf_vscode

  4. 同意协议(有逆骨不介意安装)
  5. ESP32 BLE密码 esp32-idf_端口号_02

  6. 环境检测
    如果有问题就按照安装程序显示的进行修复就好,如果没问题就是以下界面:
  7. ESP32 BLE密码 esp32-idf_ESP32 BLE密码_03

  8. 选择安装版本(目前乐鑫官方给出的最新版本为5.0.1)
    我提供的这个安装包是旧版本,但目前网上能找到的相关ESP32的教程视频或者博客几乎都是用的4.3版本(并且就连旧版本我都没整明白,不敢给你玩新的),所以选择4.3.1版本安装。(但凡ESP32大佬也不至于看我这个文章)
    安装路径以自己的电脑情况为准,但一定要记住自己的路径在哪,后续在VSCode中可能会用到。
  9. ESP32 BLE密码 esp32-idf_端口号_04

  10. 安装ESP-IDF Tools(同样,请记住自己的安装路径!)
  11. ESP32 BLE密码 esp32-idf_端口号_05

  12. 选择组件
    就按默认勾选的就行,如果你是用的是其他带后缀的ESP32芯片记得一定要看看有没有或者有没有勾选。
  13. ESP32 BLE密码 esp32-idf_vscode_06

  14. 确认安装路径并开始安装进度条
    注意:再次期间会有组件安装弹窗,记得允许安装。
  15. ESP32 BLE密码 esp32-idf_windows_07

  16. 安装就结束了
  17. ESP32 BLE密码 esp32-idf_ESP32 BLE密码_08

1.3 测试是否安装成功(不行就要全删重来!)

  1. 找到你ESP-IDF的安装路径,开始HelloWorld例程测试
    这就是前面让你记住的原因,进入之后按照这个路径:\esp-idf\examples\get-started\hello_world 找到hello_world工程
  2. 复制路径
  3. ESP32 BLE密码 esp32-idf_ESP32 BLE密码_09

  4. 打开桌面上的这两个图标中的任意一个(我开CMD)
  5. ESP32 BLE密码 esp32-idf_windows_10

  6. 设置芯片信息 命令:idf.py set-target esp32
    设置成功就会出现如下界面:
  7. ESP32 BLE密码 esp32-idf_学习_11

  8. cd切换到刚刚的工程路径下
  9. ESP32 BLE密码 esp32-idf_vscode_12

  10. 编译工程 命令:idf.py build
    第一次编译的时间会比较长,而且会显示很多内容,在编译通过之后会跳出烧写命令提示,基本如下:
  11. ESP32 BLE密码 esp32-idf_学习_13

  12. 按照ESP32接入的端口号开始烧写 命令:idf.py -p 端口号 flash
    端口号查询:win标键 + x 进入设备管理器之后查看端口就能看到对应的端口号了。
  13. ESP32 BLE密码 esp32-idf_学习_14

  14. 烧录成功之后通过窗口输出查看显示效果 命令:idf.py -p 端口号 monitor
  15. ESP32 BLE密码 esp32-idf_vscode_15

  16. 到这里,ESP-IDF在Windows环境下的安装就已经完成了。如果上述出现问题,请卸载干净后重新安装ESP-IDF。

2、VSCode以及所需插件安装

2.1 准备内容

2.2 安装和插件选择

  1. 安装
    只需要双击安装包,选择路径即可,记得在完成后勾选“加入环境变量Path”。
  2. 插件安装
    在安装完成VSCode之后,进入初始页面会让选择界面风格,选自己喜欢的即可。
  • 中文插件(软件会根据系统语言自动推荐,安装完成需重启VSCode)
  • Espressif插件
  • C/C++插件
  1. Espressif插件设置
  1. 点击左下角齿轮按钮,进入设置
  2. ESP32 BLE密码 esp32-idf_学习_16

  3. 在“用户” - “扩展” - “ESP-IDF”中找到“idf:Flash Type”设置,将Flash设置为“UART”。
  4. ESP32 BLE密码 esp32-idf_ESP32 BLE密码_17

  5. 继续和ESP-IDF环境配置一样,进入HelloWorld工程目录下,右击选择“VSCode打开”,就可以通过VSCode直接打开工程文件。
  6. 在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,基本上就能解决,如果还不行,将错误信息粘贴到百度上就可以解决(百度大法好)。
  1. 安装完成
    安装完成会出现一个界面,提示你已经完成关闭本页面即可,至此插件配置完成。
  2. 回到刚刚我们打开HelloWorld工程界面,使用VSCode进行编译、烧写和输出查看
    在界面下方有关于ESP32的工具条,通过工具条就可以完成和使用ESP-IDF命令敲出来的编译 烧写一样的效果。
    PS:如果打开 .c文件发现#include头文件爆红,将鼠标点击在有红色波浪线处会出现一个黄色小灯泡,选择编辑“includePath设置”,进入后找到包含路径,在后面输入自己ESP-IDF和ESP-IDF Tools的目录即可。

工具条如图所示:

ESP32 BLE密码 esp32-idf_windows_18


编译完成后,点击“小电视 ”效果:

ESP32 BLE密码 esp32-idf_端口号_19

至此,ESP-IDF和VSCode的安装和配置就此结束。预祝各位ESP32开发少坑,代码无红!