ESP-IDF、ESP-ADF安装与配置

最新推荐文章于 2025-03-05 10:50:46 发布
最新推荐文章于 2025-03-05 10:50:46 发布
阅读量2.7k 收藏 13
点赞数 2
分类专栏： ESP32-S3学习开发记录 文章标签： 物联网 mcu 单片机 学习
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/weixin_38499443/article/details/133635721
版权
本文详细指导ESP-IDF的安装过程，包括下载、安装步骤，以及在安装后遇到的如卸载、不同版本兼容性问题及编译错误的解决方法，涉及ESP32和ESP-ADF的环境配置。

摘要生成于 C知道 ，由 DeepSeek-R1 满血版支持， 前往体验 >

ESP-IDF安装

推荐使用esp-idf 安装工具安装。

  1. 下载esp-idf工具安装器dl.espressif.cn/dl/esp-idf/?idf=4.4
    在这里插入图片描述
  2. 根据需要选择安装包。下载第二个或者第三个。
  3. 双击安装包，选择语言。
  4. 同意协议，检查安装环境。
  5. 设置工具的安装路径。
  6. 选择需要安装的组件，安装。
  7. 安装完成。

参考：esp-idf 安装（Windows ） - 浇筑菜鸟 - 博客园 (cnblogs.com)

安装后遇到的问题

  • 之前下载过 IDF 与 IDE，如何卸载？

直接利用控制面板卸载即可。然后看下设置里环境变量里有没有删除，然后删除安装后的文件夹即可。

  • 安装不同版本的IDF，需要改变安装目录的名称，区别于之前安装的IDF，以防覆盖。

在这里插入图片描述

  • 因为之前安装的版本较低，现在编译之前的项目工程会出现问题
    在这里插入图片描述

解决方式：

  • ESP32 IDF5.0 已经移出很多组件。如果直接用5.0环境编译4.0的工程可能会报错。使用移除的组件（libsodium、cbor、jsmn、esp_modem、nghttp、mdns、esp_websocket_client、asio、freemodbus、sh2lib、expat、coap、tjpgd、tinyusb）

    解决此问题有两种方法。建议用第②种。

    ①将mdns服务组件作为托管组件。（存在目录混乱问题）

    调用指令即可在工程目录生成。idf.py add-dependency “espressif/mdns^1.1.0”

    ②下载mdns.gz 并解压到comments里。

参考：

①[ESP-ADF的某个模块（JSMN）无法下载，编译报错 - ESP32 Forum]

② ESP32-C3入门教程 ESP-IDF 5.x篇①——ESP-IDF V5.0.1编译报错：Failed to resolve component ‘jsmn‘._小康师兄的博客-CSDN博客、

③ESP32-解决“compoenent mdns could not be found“问题_learn_coder的博客-CSDN博客

ESP-ADF 的安装

  1. 获取ESP ADF

    打开要把ADF安装到那里的文件夹，在文件夹下输入命令

    git clone --recursive https://github.com/espressif/esp-adf.git

    在这里插入图片描述

  2. 安装过后，会出现几个文件的克隆失败，分别是esp-idf、esp-idf-libs（adf音频库）、esp-sr（adf语音识别库），因为这些库在esp-idf-master仓库下都是以分支branch链接形式存储的。需要单独安装。

    • 在esp-adf-libs目录下执行：

      git clone https://gitclone.com/github.com/espressif/esp-adf-libs

    • 在esp-sr目录下执行：

      git clone https://gitclone.com/github.com/espressif/esp-sr.git

    • 在esp-idf目录下执行：

      git clone https://gitclone.com/github.com/espressif/esp-idf

  3. 安装完成后 在esp-adf目录下执行命令git submodule update --init，将子模块完成同步。
    在这里插入图片描述

  4. 打开系统环境变量设置，添加ADF安装路径

    在这里插入图片描述

    设置成功后，在命令行中输入命令echo %ADF_PATH%,应该返回ESP-ADF 目录的路径。

  5. 编译DEMO测试。

参考：

① ESP32学习笔记（37）——搭建ESP-ADF(乐鑫音频开发框架)_esp32 opus-CSDN博客

②[004] [ESP32开发笔记] 音频开发框架ADF环境搭建——基于ESP-IDF_esp32 音频开发_柯西的彷徨的博客-CSDN博客

③ESP32S2 ES8388 ADF坑 esp-adf-libs 缺失问题解决 - 知乎 (zhihu.com)

安装后遇到的问题

  1. 编译DEMO时，编译不成功，缺少文件

    错误日志：fatal error: audio type_def.h: No such file or directory

    在这里插入图片描述

打补丁时遇到的错误

  1. error：can't open patch '$adf_path/idf_patches/idf_v4.4_freertos.patch':no such file or directory

​ 原因：没有找到这个文件或者打不开这个文件，可能是补丁路径错误

​ 解决：输入正确的路径

在这里插入图片描述

  1. 补丁不能使用，产生冲突

    在这里插入图片描述

    解决：查看冲突信息，将产生冲突的地方，手动修改需要打补丁的文件

    在这里插入图片描述

从零到一：ESP32与豆包大模型的RTC连续对话实现指南
静心编程，禅意生活。
03-28 1895
文本实现ESP32S3 SparkBot与豆包大模型的RTC连续对话
ESP32开发__ESP-IDF, ESP-ADF官网下载，安装及环境配置
深漂3年的精致小镁铝
10-24 4934
ESP32 是一款功能丰富的 SoC，集成Wi-Fi 4和蓝牙，适用于多样的物联网应用，具有高性能、高集成、低功耗和多种接口的特点，可作为独立系统或从设备提供 Wi-Fi和 …蓝牙高性能 Xtensa® 32 位 LX6 双核处理器超低功耗协处理器多种外设ESP32 采用 40 nm 工艺制成，具有最佳的功耗性能、射频性能、稳定性、通用性和可靠性，适用于各种应用场景和不同功耗需求。
ESP-ADF开发篇 （1） [ESP-ADF VSCODE环境搭建]
qq_38251859的博客
12-23 670
这样安装后需要把IDF路径添加到windows环境变量中，找到自己的ADF安装路径，然后添加就行了。然后执行这个，$adf_path这个写你自己的路径就行了，idf_v5.3看你的IDF版本。默认下载了IDF，点击install 选当前路径就行了。做完上面的操作就可以开始你的ADF音频开发之旅了。然后需要把补丁包加到ESP-IDF中。先进入命令行，CD到IDF目录。这里可以看到解释和怎么做。这样就有ADF例程了。
ESP32 esp-idf esp-adf环境安装及.a库创建与编译
zmlovelx(帅得不敢出门 程序员群31843264)
06-24 2252
ESP32功能丰富的 Wi-Fi & 蓝牙 MCU, 适用于多样的物联网应用。使用freertos操作系统。ESP-IDF 官方物联网开发框架。ESP-ADF 官方音频开发框架。这里介绍如何在windows下搭建esp-idf与esp-adf环境，并创建新工程编译出.a库。
esp32 esp-idf/esp-adf 环境搭建
u014162835的博客
10-22 1085
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 编译例程，成功。
4步15min完成ESP-ADF安装【亲测可用】
qq_45397180的博客
01-27 1007
切到刚才clone完成的espressif/esp-adf目录下，右键 Git Bash Here，输入。资源管理器切到/.espressif ，右键 Git Bash Here,输入。如果有，请先删除/.espressif 里之前的 esp-adf文件夹。切到esp-adf目录下，右键 Git Bash Here，输入。添加环境变量 ADF_PATH 指定到esp-adf目录。反复键入运行，直到键入后没有任何反应，关闭。)选定github加速服务 以。(windows10演示)克隆ESP-ADF到本地。
Windows下，ESP-IDF&ESP-ADF的安装
weixin_43915898的博客
11-07 2567
安装ESP-ADF过程比较曲折，这里记录一下安装过程
00-ESP-IDF 环境配置指南
宁子希的博客
03-09 3831
1.首先我们在浏览器搜索esp-idf，点击第一个选项2.点击右边栏的安装3.我们选择手动安装选择需要的系统版本4.点击链接5.这里我们选择一个版本，建议不要选择最新的，安装出现问题在网上不好找到解决办法6.下载完成之后点击运行，一直选择下一步安装完成后，在我们的桌面会多出两个图标7.我们点击第一个图标，这是CMD的命令行工具，在命令行中输入idf.py出现以下信息表示安装成功了。
ESP-IDF 下配置连接 AWS
ustccw
09-17 946
一. 前提准备 根据向导完成以下三步。将会获得 root-CA.crt ESP32_test001.cert.pem ESP32_test001.private.key ESP32_test001.public.key 1. 注册设备 选择 linux/OSX + Node.js 配置 注册事物，即为自己的设备起一个名字，如 ESP32_test001 ...
Windows下两个ESP-IDF版本切换
09-20
首先，当尝试使用ESP32C6芯片时，发现原本安装的ESP-IDF 4.4版本并不支持此芯片，因此安装了更新的ESP-IDF 5.1版本。但是，在使用ESP-IDF 5.1版本进行旧项目的编译时，遇到了编译错误的问题。由于旧项目依赖于ESP-...
使用ESP-IDF、ESP-ADF、LVGL等库，基于ESP32S2实现简单的网络收音
09-01
在具体开发过程中，首先需要设置ESP-IDF开发环境，确保所有的驱动程序和协议栈都能够正确安装和配置。随后，开发者需要编写相应的代码以实现与ESP-ADF的交互，从而利用ESP32S2的Wi-Fi能力来接收网络广播流，或者使用...
esp32-lin:关于esp32-idf esp32-adf音频板
04-27
ESP32-LIN是基于ESP32微控制器的音频开发板，主要针对使用Espressif Systems的ESP32-IDF（物联网开发框架）和ESP32-ADF（音频开发框架）进行音频应用设计的开发者。这个开发板由WhyEngineer公司制造，提供了丰富的...
Windows：ESP-IDF 开发环境配置【保姆级】
zsyf33078的专栏
10-15 4128
Windows：ESP-IDF 开发环境配置【保姆级】
Ubuntu18.04 上 ESP32-S2 的 ESP-ADF 编译环境搭建流程
ESP 技术分享，推动万物互联
08-05 1129
此篇博客用来阐述 Ubuntu18.04 上 ESP32-S2 的 ESP-ADF 编译环境搭建流程。 注：ESP-ADF 适配 ESP32-S2 的开发板需要使用 esp-idf release/v4.2 及以上版本的编译环境。 1 环境搭建前提 1.1 安装编译 ESP-IDF 需要的软件包： sudo apt-get install git wget flex bison gperf python3 python3-pip python3-setuptools cmake ninja-build
[004] [ESP32开发笔记] 音频开发框架ADF环境搭建——基于ESP-IDF
柯西的彷徨的博客
06-03 4418
ESP32开发笔记ADF环境搭建打补丁常见错误与配置 1 ADF环境搭建 安装成功后，会缺少几个库文件未安装，分别是内嵌的、（adf音频库）、（adf语音识别库），因为这些库在esp-idf-master仓库下都是以分支branch链接形式存储的。方法一： 分别将这些文件复制到、、文件夹中。方法二：用git命令克隆仓库： 在目录下执行： 在目录下执行： 以上仓库下载完成后，修改的内容如下： 当两个仓库下载完成后，在目录下cmd执行，这一步将两个子模块切换到当前ADF要求的版本。方法
【ESP-ADF】在 VSCode 安装 ESP-ADF 注意事项
椎名的博客
03-05 676
使用 VSCode 的 ESP-ADF 的安装注意事项。
VSCode + ESP-IDF 项目搭建及配置
热门推荐
weixin_51358957的博客
05-30 1万+
VSCode 搭建 ESP-IDF 开发环境
ESP32 如何安装ESP-ADF环境
hereiserlie的博客
09-14 1396
拉取完整的esp-adf后切换到esp-adf的目录下执行 install.bat 脚本，完成ESP-IDF的安装后 export.bat 才算完成。这个过程注意自电脑的 python版本 环境变量 还有 ESP-IDF 和 ESP-ADF的环境变量设置是否合理。
WIN10 企业版 下安装 ESP32 ADF
a38669454aa的博客
05-23 379
根据ESP32 ADF windows开发环境搭建 适配ADF到ESP32A1S_killer-p的博客-CSDN博客_esp32-a1s 这个文章安装的，安装好IDF,然后在Espressif下建立ESP文件夹， CD C:\Espressif\ESP 然后 git clone --recursive https://gitclone.com/github.com/espressif/esp-adf.git CD C:\Espressif\ESP\esp-adf\componen...
vscode esp-idf esp-adf
最新发布
03-08
<think>嗯，用户想了解VSCode、ESP-IDF和ESP-ADF这三个工具之间的关系和用途。我需要先确认每个部分的定义和功能，然后解释它们如何协同工作。 首先，VSCode是一个流行的代码编辑器，由微软开发。它支持扩展，可以用来开发各种项目。ESP-IDF是乐鑫官方的物联网开发框架，专为ESP32、ESP32-S等芯片设计，提供API和工具链。ESP-ADF则是基于ESP-IDF的音频开发框架，用于音频相关的应用，比如音乐播放器或语音助手。 接下来，要理清它们的关系。VSCode作为编辑器，通过插件支持ESP-IDF和ESP-ADF的开发。用户可能在物联网或音频项目中使用这些工具，所以需要说明各自的优势和协作方式。 用户可能的背景是开发者，想用ESP32系列芯片进行开发，尤其是音频项目。他们可能希望了解如何搭建开发环境，或者这些工具如何提升效率。需要分步骤介绍每个工具，再说明整合后的工作流程。 要确保回答结构清晰，先分别介绍每个工具，再说明它们如何结合使用。同时注意使用正确的中文术语，避免技术术语错误。比如，ESP-IDF的全称是Espressif IoT Development Framework，需要提到它支持FreeRTOS和连接协议。 可能用户的实际需求是搭建一个音频项目，所以需要强调ESP-ADF在音频处理上的功能，比如编解码、音频流处理等。同时，VSCode的插件如何简化开发流程，比如代码补全、调试工具。 最后，总结使用这三个工具的优势，比如高效开发、丰富的库支持，适合物联网和音频应用。确保回答真实可靠，参考官方文档的信息，避免错误。</think>以下分步骤介绍 VSCode、ESP-IDF 和 ESP-ADF 的关系及用途： ### 一、VSCode (Visual Studio Code) $$ \text{跨平台代码编辑器} $$ - **定位**：微软开发的轻量级开源编辑器 - **核心功能**： - 通过扩展支持多种编程语言（C/C++/Python等） - 集成终端、Git版本控制、调试工具 - 提供智能代码补全和语法高亮 - **物联网开发优势**： - 通过安装 `Espressif IDF` 扩展支持ESP芯片开发 - 可直接在编辑器内完成编译、烧录、调试全流程 ### 二、ESP-IDF (Espressif IoT Development Framework) $$ \text{乐鑫官方物联网开发框架} $$ - **硬件支持**：专为ESP32/ESP32-S系列芯片设计 - **核心组件**： - FreeRTOS实时操作系统 - Wi-Fi/BLE/以太网协议栈 - 安全加密库 - 文件系统驱动 - **开发流程**： ```c // 示例：创建FreeRTOS任务 void app_main() { xTaskCreate(&task_function, "task_name", 2048, NULL, 5, NULL); } ``` ### 三、ESP-ADF (Audio Development Framework) $$ \text{基于ESP-IDF的音频开发框架} $$ - **功能定位**： - 支持音频编解码（MP3/AAC/WAV等） - 提供音频流处理管道 - 集成网络流媒体协议（HTTP/RTSP等） - **典型应用场景**： - 智能音箱 - 网络收音机 - 语音助手 - 多房间音频系统 ### 四、整合开发流程 1. **环境搭建**： - 安装VSCode → 添加Espressif IDF扩展 - 通过扩展自动安装ESP-IDF工具链 - 在ESP-IDF基础上安装ESP-ADF组件 2. **项目开发**： ```bash # 创建ADF项目模板 idf.py create-project --path my_audio_project -t adf_template ``` - 使用VSCode编辑源码 - 通过内置终端执行编译命令： $$ idf.py build $$ - 一键烧录到开发板 3. **调试优化**： - 实时查看串口日志 - 使用JTAG调试器进行代码级调试 - 分析内存/性能指标 ### 五、技术优势对比 | 工具 | 处理延迟 | 内存占用 | 开发效率 | |------------|----------|----------|----------| | 原生ESP-IDF | ≤10ms | 优化最佳 | 中 | | ESP-ADF | 15-20ms | 较高 | 高 | ### 六、应用案例 开发智能语音设备时： 1. 用ESP-ADF实现音频采集/播放 2. 通过ESP-IDF控制Wi-Fi连接云端 3. 在VSCode中完成： - 语音算法优化（如降噪处理） - OTA固件更新测试 - 功耗分析 这三个工具形成完整的物联网音频开发闭环，建议从ESP-IDF基础教程入手，逐步结合ADF的音频案例进行实践。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明：

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

余额充值