VS Code 配置ESP-IDF

ESP-IDF配置与VSCode集成
本文详细介绍了如何在VSCode中配置ESP-IDF环境,包括安装扩展、配置路径、下载工具链及解决常见错误的过程。通过遵循步骤,开发者可以顺利地在VSCode中进行ESP-IDF项目的创建、编译和烧录。

在扩展搜索idf,即可看到Espressif IDF,点击安装

按F1键,输入ESP-IDF:Configure ESP-IDF extension,打开配置页面,安装后似乎也会自动弹出配置页面

点击START

Python要求版本3.7及以上

继续Configure ESP-IDF

我下载了ESP-IDF包,所以这里选择Find ESP-IDF in your system

下载路径:

https://github.com/espressif/esp-idf/releases

对于github下载慢或者失败的,可以选择espressif的服务器下载

https://dl.espressif.com/dl/esp-idf/releases/esp-idf-v4.1-beta1.zip

下载后解压即可,似乎路径不能包含空格

校验后继续,Go to ESP-IDF Tools setup

对于windows,ESP-IDF Tools手动下载地址在

Windows 平台工具链的标准设置 - ESP32 - — ESP-IDF 编程指南 latest 文档

当前2.3版本:https://dl.espressif.com/dl/esp-idf-tools-setup-2.3.exe

我是已经安装了,选择Skip ESP-IDF Tools download

一般是自动填好的,点击校验就好了

校验完成继续下一步,然后就是查看examples并用example创建工程测试

可以使用VS code左下角的工具编译和烧写

也可以使用菜单的终端命令编译和烧写

模板工程在扩展目录的templates文件夹中

C:\Users\XXX\.vscode\extensions\espressif.esp-idf-extension-0.2.1\templates

Click F1 to show Visual studio code actions, then type ESP-IDF to see possible actions.

Command DescriptionKeyboard Shortcuts (Mac)Keyboard Shortcuts (Windows/ Linux)
Configure ESP-IDF extension
Create ESP-IDF project⌘ E CCtrl E C
Add vscode configuration folder
Configure Paths
Set Espressif device target
Device configuration
Launch gui configuration tool
Set default sdkconfig file in project
Select port to use⌘ E PCtrl E P
Build your project⌘ E BCtrl E B
Flash your project⌘ E FCtrl E F
Monitor your device⌘ E MCtrl E M
Build, Flash and start a monitor on your device⌘ E DCtrl E D
Pick a workspace folder
Size analysis of the binaries⌘ E SCtrl E S
Show ESP-IDF Examples Projects


Verify ESP-IDF Tools给出配置的部分路径做参考:

idf4.0配置
D:\XXX\esp\esp-idf-tools\python_env\idf4.0_py3.8_env\Scripts;D:\XXXX\Python38;D:\XXX\esp\esp-idf-tools\tools\xtensa-esp32-elf\esp-2019r2-8.2.0\xtensa-esp32-elf\bin;D:\XXX\esp\esp-idf-tools\tools\esp32ulp-elf\2.28.51.20170517\esp32ulp-elf-binutils\bin;D:\XXX\esp\esp-idf-tools\tools\cmake\3.13.4\bin;D:\XXX\esp\esp-idf-tools\tools\openocd-esp32\v0.10.0-esp32-20190313\openocd-esp32\bin;D:\XXX\esp\esp-idf-tools\tools\mconf\v4.6.0.0-idf-20190628;D:\XXX\esp\esp-idf-tools\tools\ninja\1.9.0;D:\XXX\esp\esp-idf-tools\tools\idf-exe\1.0.1;D:\XXX\esp\esp-idf-tools\tools\ccache\3.7


D:\XXX\esp\esp-idf-tools\tools\openocd-esp32\v0.10.0-esp32-20190313/openocd-esp32/share/openocd/scripts



idf4.1配置
D:\XXX\esp\esp-idf-tools\python_env\idf4.1_py3.8_env\Scripts;D:\XXXX\Python38;D:\XXX\esp\esp-idf-tools\tools\xtensa-esp32-elf\esp-2019r2-8.2.0\xtensa-esp32-elf\bin;D:\XXX\esp\esp-idf-tools\tools\xtensa-esp32s2-elf\esp-2019r2-8.2.0\xtensa-esp32s2-elf\bin;D:\XXX\esp\esp-idf-tools\tools\esp32ulp-elf\2.28.51-esp-20191205\esp32ulp-elf-binutils\bin;D:\XXX\esp\esp-idf-tools\tools\esp32s2ulp-elf\2.28.51-esp-20191205\esp32s2ulp-elf-binutils\bin;D:\XXX\esp\esp-idf-tools\tools\cmake\3.13.4\bin;D:\XXX\esp\esp-idf-tools\tools\openocd-esp32\v0.10.0-esp32-20191114\openocd-esp32\bin;D:\XXX\esp\esp-idf-tools\tools\mconf\v4.6.0.0-idf-20190628;D:\XXX\esp\esp-idf-tools\tools\ninja\1.9.0;D:\XXX\esp\esp-idf-tools\tools\idf-exe\1.0.1;D:\XXX\esp\esp-idf-tools\tools\ccache\3.7


D:\XXX\esp\esp-idf-tools\tools\openocd-esp32\v0.10.0-esp32-20191114/openocd-esp32/share/openocd/scripts


报错:python pip is not found in current environment

检查扩展工具里的idf:Python Bin Path Win路径配置配置,如下图

错误:

Verify Python packages requirements

Command failed: "D:\XXX\esp\esp-idf-tools\python_env\idf4.1_py3.8_env\Scripts\python.exe" "d:\XXX\esp\esp-idf-v4.1-beta1\tools\check_python_dependencies.py" -r "c:\Users\XXXXX\.vscode\extensions\espressif.esp-idf-extension-0.2.1\esp_debug_adapter\requirements.txt"

输出如下错误信息

The following Python requirements are not satisfied:

backports.functools-lru-cache>=1.5

graphviz

psutil>=5.5.1

pygdbmi>=0.9.0.0

pylint>=1.9.4

requests>=2.21.0

typing>=3.6.6

pywin32; platform_system == "Windows"

xmlrunner>=1.7.7

Please follow the instructions found in the "Set up the tools" section of ESP-IDF Getting Started Guide

Command failed: "D:\XXX\esp\esp-idf-tools\python_env\idf4.1_py3.8_env\Scripts\python.exe" "d:\XXX\esp\esp-idf-v4.1-beta1\tools\check_python_dependencies.py" -r "c:\Users\XXXXX\.vscode\extensions\espressif.esp-idf-extension-0.2.1\esp_debug_adapter\requirements.txt"

按照Please follow the instructions found in the "Set up the tools" section of ESP-IDF Getting Started Guide提示打开如下网址:

Get Started - ESP32 - — ESP-IDF Programming Guide latest documentation

按照Step 3. Set up the tools和Step 4. Set up the environment variables,打开CMD并进去esp-idf目录,比如我的是esp-idf-v4.1-beta1,执行install.bat和export.bat,然而其实没什么用,因为上面提示的错误实际是VS Code的Eepressif IDF扩展报的错误

执行如下命令下载依赖

D:\XXX\esp\esp-idf-tools\python_env\idf4.1_py3.8_env\Scripts\python.exe -m pip install -r c:\Users\XXXXX\.vscode\extensions\espressif.esp-idf-extension-0.2.1\esp_debug_adapter\requirements.txt

不要在CMD中直接使用pip install -r或者python -m pip去下载,因为你可能调用了系统中安装的python,下载后也还是继续报错的,esp-idf tools目录中有esp-idf tools自己的python.exe

如果还是失败,可以试下先按提示更新一下pip

0.6.0版本python环境配置命令记录:

D:\XXX\esp\esp-idf-tools\python_env\idf4.2_py3.8_env\Scripts\python.exe -m pip install --upgrade pip
D:\XXX\esp\esp-idf-tools\python_env\idf4.2_py3.8_env\Scripts\python.exe -m pip install -r c:\Users\XXX\.vscode\extensions\espressif.esp-idf-extension-0.6.0\requirements.txt
D:\XXX\esp\esp-idf-tools\python_env\idf4.2_py3.8_env\Scripts\python.exe -m pip install --no-warn-script-location -r c:\Users\XXX\.vscode\extensions\espressif.esp-idf-extension-0.6.0\esp_debug_adapter\requirements.txt

配置完成后的设置截图:

参考:

ESP-IDF 编程指南 - ESP32 - — ESP-IDF 编程指南 latest 文档

Espressif IDF for VSCode 爬坑之路一:ESP32 的 esp-idf 例子编译与烧录_Zombie's blog-优快云博客

ESP32概述与入门准备_Naisu的各种笔记-优快云博客_esp32

### 配置 ESP-IDF 开发环境以使用 VS Code 进行开发 #### 安装 ESP-IDF 扩展包 为了在 Visual Studio Code (VS Code) 中配置 ESP-IDF 开发环境,需先访问插件市场并搜索名为 "ESP-IDF" 的扩展进行安装[^5]。 #### 设置工具链和其他依赖项 按照官方指导文档中的说明,在目标操作系统上完成必要的工具链及其他依赖组件的部署。对于 Windows 用户来说,推荐采用 MSYS2 工具集;而对于 Linux 或 macOS,则建议通过各自平台的标准软件包管理器获取所需资源[^4]。 #### 初始化新项目或打开现有项目 创建一个新的 ESP32 应用程序可以借助命令行工具 `idf.py` 来实现,它会自动生成基础结构文件夹以及默认源码模板。如果要导入已有工程,则只需将其目录路径指定给 VS Code 即可加载整个解决方案[^2]。 #### 调整用户全局变量与构建选项 确保已正确定义了指向 IDF_PATH 环境变量的位置——即解压后的 SDK 根目录所在之处。此外,还可以利用 `.vscode/settings.json` 文件来自定义更多个性化的编辑体验参数,比如 C/C++ IntelliSense 模式下的头文件查找路径等[^1]。 ```json { "idf.espIdfPathWin": "<path_to_idf>", "idf.openOcdConfigs": [ "${workspaceFolder}/openocd_scripts/board/esp-wrover-kit.cfg" ] } ``` #### 测试编译链接流程 一切准备就绪之后,尝试执行一次完整的编译操作来检验当前设置是否成功生效。此时应该可以在终端窗口内看到由 idf.py 自动生成的日志输出信息,并最终得到可供烧录至设备的目标二进制映像文件。
评论 4
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值