一步步教你在windows下实现ESP32不同版本idf的搭建与共存

最新推荐文章于 2025-04-17 14:44:38 发布
最新推荐文章于 2025-04-17 14:44:38 发布
阅读量3.5k 收藏 54
点赞数 14
文章标签： 单片机 物联网 mcu iot
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/Nyyyb/article/details/132178138
版权

我们知道esp-idf新的版本对旧的版本的代码支持不是很好，但是我们有的时候可能就会用到不同版本的idf，这篇文章可以基于vscode的profile特性帮你实现：

  • windows下不同版本esp-idf的共存与快速切换

‍

1. esp-idf安装包的下载

exp-idf可以从以下官方网站下载

dl.espressif.com/dl/esp-idf/?idf=4.4

‍

打开后界面如图所示

​​

image

​​

第一个绿色的为在线安装包，虽然下载的时候体积很小但是安装的时候也要从服务器下载大量的文件，不推荐使用

下面的浅蓝色和深蓝色为离线版本的idf安装包，可以根据自己的版本需要自行选择，如果没有符合要求的版本可以在最下面其他发行版和镜像处选择下载，主要看idf后面的版本就好了，ESP-IDE是乐鑫自己的IDE，我们不使用。

笔者此处就下载了5.0.2，4.4.2，4.1.4几版本：

​

image

​

​

image

​

​

image

​

如果你在网上看到一个项目想要复刻，只需要关注版本号前面两个数字相同就可以。

2. ESP-IDF的安装

假设我们要把esp-idf安装到D盘，可以在D盘新建Espressif文件夹并在该文件夹内根据你要安装的版本号创建如下的文件夹

​

image

​

接下来就可以进行esp-idf的安装了

  1. 语言选择简体

    ​

    image

    ​

  2. 同意协议

    ​

    image

  3. 下一步

    ​​

    image

    ​​

  4. 浏览，选择刚才创建的文件夹

    ​

    image

  5. 选择后如图所示

    ​

    image

  6. 下一步直到安装完成

至此已经完成了esp-idf的安装，接下来可以进行vscode下espressif插件的安装和配置

3. vscode profile配置

profile是vscode在2023年推出的一个新特性，通过给不同的编程环境设置不同的profile即可实现快速切换的同时保持vscode的轻量化。

​

image

接下来我们可以创建适用于特定版本esp-idf的profile

  1. 创建配置文件

    ​

    image

    ​

  2. 设置profile文件名称并选择复制来源

    ​

    image

    ​

  3. 稍等片刻就可以选择我们刚才创建好的profile

    ​

    image

    ​

4. vscode上Espressif插件安装与配置

  1. vscode扩展中心搜索espressif并安装

    ​

    image

    ​

  2. 安装好后键盘快捷键ctrl+shift+p 输入esp并选择配置esp-idf插件

    ​

    image

    ​

  3. 稍等片刻就会进入esp-idf setup界面，选择红框中的use existing setup

    ​

    image

  4. 这时候就是大多数小伙伴安装失败的一个情况了，有的人在这里没有显示任何内容，有的显示的不是自己想要的信息或者是错误的信息，我这里是之前已经安装了一个版本，所以会有502版本的，但是我现在需要安装的是510版本，接下来我们就来解决这个问题

    ​​

    image

  5. ctrl+,进入vscode设置

    ​

    image

    ​

  6. 在搜索框输入espressif，会出现8个搜索结果，其中前面3个是https的链接地址，后面5个是在我们电脑中的地址，我们不要犹豫，把后面五个电脑中的地址全部删除

    ​

    image

  7. 删除后如图所示

    ​

    image

    ​

  8. 这时候把所有的vscode窗口都关闭后重新打开vscode，ctrl+shift+p输入esp后选择配置esp-idf插件，选择use existing setup后，正确的信息就会显示出来

    ​

    image

    ​

  9. 选择该设置后稍等片刻如果显示如下界面就说明了完成了该版本的esp-idf安装与vscode配置

    ​

    image

    ​

5. 多版本esp-idf共存与切换配置

以上内容，简单来说就是以下几步

  1. 下载所需版本的idf安装文件

  2. 安装到以版本号命名的文件夹中

  3. 创建适用于该版本的vscode profile文件

  4. 配置espressif idf插件

因此如果需要安装多个版本的并轻松切换只需要重复执行上述步骤，就可以轻松选择不同版本的idf

​

image

​

‍

任我行rwx
关注
ESP32之esp-idf版本的切换与更新方法
Justice Gao
06-24 1万+
很多新手开发者从github上clone了最新的esp-idf固件包，但是可能不是想使用最新的esp-idf版本，而是想要某个指定的版本。 下面，我介绍一下。 （1）下载esp-idf固件包 如果是第一次下载，可以选择全部的release版本，建议不要单独下载zip压缩包，用git命令直接获取 git clone --recursive https://github.com/espres...
ESP32 双IDF安装
HAUE.Yuyc
02-15 1389
最近在进行对ESP32的学习和开发，需要使用到不同版本的ESP-IDF。目前电脑为Win11解决办法为如果在Linux环境下理论可以安装两个版本的IDF，需要自己实践。可以参考其他问题可以看是不是我拆过的坑。
ESP-IDF教程1 开发环境
lc_guo的博客
04-17 1264
本文介绍了如何搭建 ESP-IDF 的开发环境、新建空模板工程、项目结构、操作和配置等相关内容
ESP-IDF多版本共存
weixin_52105661的博客
11-02 1367
ESP-IDF 是 Espressif 提供的官方开发框架，用于开发 ESP32 和 ESP32-S 系列芯片。ESP-IDF 支持多版本共存，可以在同一台机器上安装多个版本的 ESP-IDF，并使用不同的版本进行开发。有些例程只在某个大版本中可以编译，因此需要安装多个版本共存。
一台电脑下安装多个esp-idf
Cmy_894的博客
08-04 1479
esp-idf安装有两种方式，分别是手动安装和 esp-idf 安装工具安装。以前还没有 esp-idf 安装工具时，在Windows环境下安装就会异常困难，但是现在推荐使用 esp-idf 安装工具安装，将会异常简单。
ESP-IDF不同版本自由切换（基于Windows）
qq_40773212的博客
10-03 2148
这一步是将ESP-IDF 工具添加至 PATH 环境变量，但是有些情况运行的话会看到一个诊断信息，这时需要先到Python虚拟环境下运行activate.bat激活Python在运行export.bat命令。可以看到，在Windows下运行install.bat、export.bat命令 与 官方离线/在线安装完再打开CMD效果是一样的。因此，对于使用脚本的开发者，切换ESP-IDF版本只需要激活相应的Python虚拟环境 和 运行export.bat即可。set =：该命令用于设置环境变量的值。
ESP32编译环境多版本共存处理办法
wangyx1234的博客
08-12 4395
目前ESP32的官方开发框架ESP-IDF更新很快，每一个版本的SDK都需要配置编译工具所在的路径，以及配置工程路径的环境变量IDF_PATH。本文档给出了配置 esp-idf 环境变量的方法，可以实现一个开发环境中运行多个版本的esp-idf开发环境。...
Windows系统安装ESP32 ESP-IDF开发环境
晨之清风
10-19 1335
Windows系统安装ESP32 ESP-IDF开发环境。
ESP32 IDF 环境搭建 （windows10）
jiuzhang_9z的博客
08-07 900
ESP32 IDF 环境搭建 windows10esp32介绍ESP32 系列ESP32-S2 系列ESP-IDF下载安装 ESP-IDF 工具安装器测试环境编译hello_world工程 esp32介绍 官网链接:https://www.espressif.com/zh-hans/products/socs/esp32 ESP32 系列 32-bit MCU & 2.4 GHz Wi-Fi & Bluetooth/Bluetooth LE 两个或一个可以单独控制的 CPU 内核，时钟频率
vscode安装多版本esp-idf
qq_61585528的博客
05-23 3460
vscode安装多版本esp-idf
使用v5.3.1版本ESP-IDF+vscode构建ESP32文件框架
m0_73279193的博客
10-16 4202
主要教会小白构建ESP32项目文件框架
ESP32教程-Windows开发环境搭建
09-19
《ESP32 技术参考手册》 的目标读者群体是使用 ESP32 芯片的应用开发工程师。本手册提供了关于 ESP32 的具 体信息，包括各个功能模块的内部架构、功能描述和寄存器配置等。 芯片的管脚描述、电气特性和封装信息等可以从《ESP32 技术规格书》 获取。
ESP32系列--ESP32各个系列对比
热门推荐
coderma的博客
06-15 3万+
本篇主要展示ESP32各个系列的对比信息（搬运ESP-IDF开发文档），方便大家参考，更多详细信息请查阅官方芯片数据手册FeatureESP32 SeriesESP32-S2 SeriesESP32-C3 SeriesESP32-S3 SeriesLaunch year2016202020202020VariantsSee ESP32 Datasheet (PDF)See ESP32-S2 Datasheet (PDF)See ESP32-C3 Datasheet (PDF)See ESP32-S3 Dat
VS Code+espressif插件多个IDF版本配置方法
大道至简
03-04 832
VS Code+espressif插件多个IDF版本配置方法
ESP32（一）：Win10配置 IDF+VSCode
既有随处可栖的江湖，也有追风逐梦的骁勇！
05-04 1251
c.清华大学：https://pypi.tuna.tsinghua.edu.cn/simple。选择ADVANCED，进入下一步，按照提示和自己电脑的IDF安装位置进行选择，点击install；打开安装包，一直点击下一步即可，过程中跳出安装驱动点击允许，安装完成后，可以看到命令行正确打开；选择完成点击下方save settings，等待安装完成进入安装完成提示页面，至此环境配置完成。添加到 PATH：添加到系统环境变量中，勾选后，即可在命令行中使用 code。VSCode应用中，搜索IDF，安装；
ESP32开发环境搭建Windows VSCode集成Espressif IDF插件ESP32_IDF_V5.0开发编译环境搭建
cnicfhnui的博客
06-20 8708
打开上面的网页，选择单击页面中 ESP32-IDF v5.0.2 - Offine Installer，5.0.2是当前最新版本，如果没有ESP32-IDF v5.0.2 - Offine Installer，说明官方有更新最新版本，如果想要安装此教程版本可以把页面翻到最下面，会列出所有历史版本供用户下载。注意：ESP-IDF库各版本之间API函数各有差异，版本号差别越大，差异越大，如果是新手小白还是尽量遵循你的开发板卖家或你找的源码教程中的版本来。
ESP-IDF+PowerShell/Vscode windows ESP32开发环境搭建
爱出名的狗腿子
03-27 4454
在上一篇博客，我分享了如何在 linux 开发环境，搭建esp32的开发环境，虽然 windows 环境差异不是特别大，但是鉴于有部分同学缺乏这块经验，因此特针编写此博客，分享并记录在 windows 环境下如何搭建esp32的 IDF 开发环境
最新版ESP32 IDF环境搭建教程：基于CLION安装ESP32开发环境IDF（含同时安装多个IDF教程）
天城电子嵌入式的博客
09-14 4643
如果我们要安装多个不同版本的IDF，我们就需要把这个环境变量删掉，将其添加在我们新建的IDFV445.bat里面。新版本的IDF有时安装之后，目录下没有activate.bat文件，可以自己建一个该文件，内容如下：把其中的。多个版本的IDF难点是在环境变量的冲突，我们上面通过将环境变量删掉，添加在bat文件里，即可添加不同版本的IDF。配置好工具链之后，我们点击右边状态栏的cmake，选择到我们的ESP32V445工具链：如下配置。这里的v445标志着不同的版本，我们电脑上可以同时安装多个所需的版本。
esp32 esp-idf/esp-adf 环境搭建
u014162835的博客
10-22 1194
2. 安装完以后，桌面上会有三个软件：ESP-IDF 5.3 CMD，ESP-IDF 5.3 PowerShell，Espressif-IDE （如果少了就重新安装）5. git clone --recursive https://gitee.com/EspressifSystems/esp-adf.git （这个才是国内站点）。git clone --recursive https://github.com/espressif/esp-adf.git （国外才这个）。19. 用VS 编译例程，成功。
esp32s3 vscode esp-idf 怎麽把兩個獨立的項目合并成一個項目
最新发布
05-06
<think>好的，用户现在想将两个独立的ESP32-S3项目合并成一个，使用VSCode和ESP-IDF。我需要回顾之前的对话，确保理解用户的需求。用户之前询问如何集成tusb_hid示例到新项目，现在转向项目合并，可能需要处理组件、CMake配置、任务调度等问题。 首先，用户提到的引用内容中，有关于环境搭建、CMakeLists.txt配置和调试的信息。这可能涉及到项目结构、组件管理和依赖处理。合并项目时，需要确保组件正确导入，CMake文件正确配置，避免冲突。 用户的两个项目可能各自有不同的组件和主函数，合并时需要整合这些。可能需要将组件统一放在components目录下，处理可能的重名问题。主函数的入口也需要调整，因为ESP-IDF只允许一个app_main，所以需要将两个项目的主逻辑整合到一个函数中，可能通过任务创建来并行运行。 另外，用户的引用中提到NVS分区和USB配置，这可能影响分区表的设置，合并后需要检查分区表是否满足两个项目的需求。还需要注意Kconfig配置，比如sdkconfig中的设置是否冲突，是否需要通过menuconfig重新调整。 用户可能遇到的挑战包括组件依赖冲突、内存不足、任务优先级和堆栈大小的问题。需要指导用户如何排查这些，比如检查编译错误，使用idf.py size-files查看内存占用，调整FreeRTOS任务参数等。 最后，生成相关问题需要考虑用户可能的后续问题，比如处理依赖冲突、调试方法、优化内存等。确保回答清晰，步骤详细，帮助用户一步步完成项目合并。</think>以下是基于ESP32-S3和VSCode+ESP-IDF环境合并两个独立项目的详细技术方案： --- ### **一、项目结构重组** 1. **创建统一项目框架** ```bash idf.py create-project merged_project cd merged_project mkdir -p components/{projectA,projectB} # 保留原项目组件独立性 ``` 2. **迁移组件** ```bash # 将项目A的组件复制到components/projectA cp -r /path/to/projectA/components/* components/projectA/ # 将项目B的组件复制到components/projectB cp -r /path/to/projectB/components/* components/projectB/ ``` --- ### **二、CMake配置整合** 3. **修改顶层CMakeLists.txt**[^5] ```cmake cmake_minimum_required(VERSION 3.16) include($ENV{IDF_PATH}/tools/cmake/project.cmake) project(merged_project) # 声明组件搜索路径[^1] list(APPEND EXTRA_COMPONENT_DIRS components/projectA components/projectB $ENV{IDF_PATH}/examples/common_components/protocol_examples_common ) ``` 4. **组件级CMake配置** ```cmake # 在components/projectA/CMakeLists.txt示例 idf_component_register( SRCS "projectA_main.c" INCLUDE_DIRS "include" REQUIRES freertos driver ) ``` --- ### **三、代码融合** 5. **主函数合并（关键步骤）** ```c // main/main.c void app_main() { // 初始化公共模块 nvs_flash_init(); esp_netif_init(); // 启动项目A任务 xTaskCreate(projectA_task, "projA", 4096, NULL, 5, NULL); // 启动项目B任务 xTaskCreate(projectB_task, "projB", 4096, NULL, 5, NULL); } ``` 6. **解决符号冲突** ```bash # 使用objdump检查重复符号 xtensa-esp32s3-elf-objdump -t build/projectA/libprojectA.a | grep '\.text' xtensa-esp32s3-elf-objdump -t build/projectB/libprojectB.a | grep '\.text' ``` --- ### **四、资源配置优化** 7. **合并sdkconfig** - 手动对比两个项目的`sdkconfig`文件 - 重点关注： ```ini CONFIG_FREERTOS_UNICORE= # 单核/双核模式 CONFIG_ESP_TASK_WDT= # 看门狗配置 CONFIG_BT_ENABLED= # 蓝牙状态 ``` 8. **分区表调整**[^1] ```csv # partitions.csv合并策略 # 原始项目A分区 nvs, data, nvs, 0x9000, 0x4000 otadata, data, ota, 0xd000, 0x2000 phy_init, data, phy, 0xf000, 0x1000 # 新增项目B需求 storage, data, 0x40, 0x10000, 0x10000 ``` --- ### **五、编译调试** 9. **增量编译指令** ```bash idf.py set-target esp32s3 idf.py build --cmake-warn-uninitialized # 捕获未初始化变量 idf.py flash monitor -p /dev/ttyACM0 ``` 10. **调试配置融合** ```json // .vscode/launch.json { "configurations": [ { "name": "Debug ProjectA", "type": "espidf", "request": "launch", "debugPort": "/dev/ttyACM0" }, { "name": "Debug ProjectB", "type": "espidf", "request": "launch", "debugPort": "/dev/ttyUSB0" } ] } ``` --- ### **六、典型问题处理** - **内存不足**：通过`idf.py size-components`分析占用 - **任务优先级冲突**：使用`uxTaskPriorityGet()`动态调整 - **中断冲突**：检查`esp_intr_alloc()`的共享标志 - **WiFi/BT共存**：设置`CONFIG_ESP_COEX_SW_COEXIST_ENABLE` --- ### **验证流程** 1. 分阶段验证： ```bash idf.py menuconfig → Component config → Disable ProjectB → 单独测试ProjectA ``` 2. 使用`heap_caps_print_heap_info()`监控内存分配 3. 通过`esp_log_level_set("*", ESP_LOG_VERBOSE)`开启详细日志 --- ### **相关问题** 1. 如何解决合并后出现的组件依赖冲突？ 2. 合并项目后出现内存溢出该如何排查？ 3. 怎样优化合并项目的FreeRTOS任务调度？ 4. 如何保留两个项目的独立烧录能力？ 5. 合并后出现GPIO资源冲突如何解决？ [^1]: ESP-IDF编程指南要求合并项目时NVS分区至少保留16KB空间 [^5]: 根据官方CMake文档，组件路径声明顺序决定编译优先级
评论 3
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明：

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

余额充值