资源获取地址

  1. ESP32-IDF
  2. Visual Studio Code
  3. ESP-IDF插件

安装ESP32-IDF库

下载ESP32—IDF库：下载地址

打开上述的网页，选择ESP32-IDF v5.1.2 - Offine Installer

v5.1.2是截稿的最新版本。

由于ESP-IDF库不同版本之间的API和函数有差异，建议遵循所使用的Demo的版本。

打开安装程序选择简体中文

image-20240204171129523.png

勾选我同意此协议

image-20240204171213834.png

打开长路径支持

如果你没有打开长路径支持，会出现如下提示。

由于GUN-GCC编译器会产生长而深的文件结构，如果不支持 长路径，可能会丢文件。

这里安装引导可以修复这个问题，点击应用修复，并同意UAC 即可。

image-20240204171845212.png

安装程序提示修复成功后，NEXT。

选择安装路径

为了防止出现玄学问题，这里选择默认路径

image-20240204171710368.png

选择安装组件

为了防止玄学问题，这里选择默认的”完全安装”，完全安装会 少安装ESP32-C2、ESP32-C6和ESP32-H2三个芯片包，如有需要请勾选。image-20240204171845212

准备安装

安装完成

一路NEXT后，会出现两个窗口，一个是PowerShell终端，一个是传统的CMD终端。

此时，依赖包(ESP32-IDF)安装完成

配置环境变量

打开电脑的用户环境变量设置，计算机属性 > 高级系统设置 > 环境变量 > [user]用户环境变量

image-20240204172230229

​ 检查是否出现分别为IDF_PATH和IDF_TOOLS_PATH两个环境 变量，检查值即路径是否正确。

​ 如果不存在则需自行添加。

IDF_PATH 安装目录\frframeworks\esp-idf-v5.1.2
IDF_TOOLS_PATH 安装目录\

配置VSCODE

安装ESP-IDF插件

image-20240204172658506

配置ESP-IDF插件

这里选择EXPRESS，典型安装方式

image-20240204172951041

  1. Select download server: 如果您在中国大陆或者处于网络环境较差的地区且无法正常使用Github，服务器请选择Espressif。
  2. Select ESP-IDF version: 由于刚刚已经安装ESP-IDF，直接选择Find ESP-IDF in your systm即可。
  3. Enter ESP-IDF directory (IDF_PATH)及Enter ESP-IDF Tools directory (IDF_TOOLS_PATH): 如果您的系统环境变量(即PATH)设置正确，那么保持默认即可。如果设置不正确，请查看第二章的内容。

测试Demo

创建Demo

​ 1. 点击Show Examlpes，选择默认USe current ESP-IDF

image-20240204174648881

​ 2. 选择hello_world，选择Create project using example hello_world，选择需要放工程文件的文件夹

image-20240204175009696

编译Demo

  1. 选择芯片，这里我用的是ESP32-C3，请根据你所用的芯片选择对应的芯片型号

    image-20240204180009506

  2. 点击VSCODE底栏的圆柱体（编译按钮）进行编译

ESP-IDF编译相对较慢，请耐心等待

出现Total sizes后，则说明编译成功

image-20240204180126056

烧录Demo

插入开发版，选择好对应的端口号、烧录模式，然后点击闪电图标开始烧录

串口：选择相对应的串口。

烧录模式：选择串口烧录UART。

image-20240204180430261

出现Hard resetting via RTS pin后，则表明烧录成功，请按下开发版山东各RST复位按键，重启单片机。

image-20240204180622911

此时，点击电脑图标，调出调试窗口，可以看到HelloWorld，则表明烧录成功

image-20240204180821609

已知问题和解决方案

Python版本问题

在配置ESP-IDF插件中出现"C:\Espressif\tools\idf-python\3.11.2\python.exe -m pip" is not valid. (ERROR_INVALID_PIP)

解决方法：打开CMD

1
2
cd C:\Espressif\tools\idf-python\3.11.2\
python.exe -m pip install --upgrade pip

如果出现ModuleNotFoundError: No module named 'pip'

1
2
3
cd C:\Espressif\tools\idf-python\3.11.2\
python -m ensurepip
python.exe -m pip install --upgrade pip

串口调试乱码问题

在打开调试窗口后，未出现预期的Hello World，而是出现乱码，这是波特率问题

解决方法：

  1. 点击VSCODE左下角齿轮，选择设置
  2. 在顶部搜索框中输入ESP-IDF:Monitor Baud Rate
  3. 把框中修改成115200