资源获取地址

  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，选择需要放工程文件的文件夹

编译 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