[004] [ESP32开发笔记] 音频开发框架ADF环境搭建——基于ESP-IDF

最新推荐文章于 2025-03-05 10:50:46 发布
最新推荐文章于 2025-03-05 10:50:46 发布
阅读量4.3k 收藏 29
点赞数 5
分类专栏： ESP32 文章标签： 音视频 git ADF
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.youkuaiyun.com/kouxi1/article/details/125117170
版权
本文详细介绍了如何在ESP32上搭建ESP-ADF环境，包括安装步骤、缺失库的处理以及环境变量的设置。在过程中可能会遇到的错误，如编译报错和缺少文件，作者提供了相应的解决方案。此外，还提到了针对ESP32-S2芯片选择正确HAL库的重要性，并分享了打补丁的步骤，以支持在PSRAM上运行的音频任务堆栈。最后，列举了一些常见的错误及配置注意事项。

摘要生成于 C知道 ，由 DeepSeek-R1 满血版支持， 前往体验 >
ESP32
开发笔记
ADF环境搭建
打补丁
常见错误与配置

1 ADF环境搭建

在ESP-IDF环境的基础上安装ESP-ADF环境

image-20220406212603129

安装成功后，会缺少几个库文件未安装，分别是内嵌的esp-idf、esp-idf-libs（adf音频库）、esp-sr（adf语音识别库），因为这些库在esp-idf-master仓库下都是以分支branch链接形式存储的。

  • 需要单独安装的库

方法一：

image-20220406213346244
image-20220406232619440

分别将这些文件复制到..\esp-adf\esp-idf、..\esp-adf\components\esp-adf-libs、..\esp-adf\components\esp-sr文件夹中。

方法二：用git命令克隆仓库：

  1. 在esp-adf-libs目录下执行：
git clone https://gitclone.com/github.com/espressif/esp-adf-libs
  1. 在esp-sr目录下执行：
git clone https://gitclone.com/github.com/espressif/esp-sr.git

git克隆的esp-sr库文件，经本人测试缺少一些文件，编译会报错，后面直接在官方仓库下载复制得以解决。

  1. 在esp-idf目录下执行：
git clone https://gitclone.com/github.com/espressif/esp-idf
  1. 以上仓库下载完成后，修改adf目录下.gitmodules的内容如下：
    image-20220406234259675
[submodule "esp-idf"]
	path = esp-idf
	url = https://gitclone.com/github.com/espressif/esp-idf
[submodule "components/esp-adf-libs"]
	path = components/esp-adf-libs
	url = https://gitclone.com/github.com/espressif/esp-adf-libs
[submodule "components/esp-sr"]
	path = components/esp-sr
	url = https://gitclone.com/github.com/espressif/esp-sr.git

当两个仓库下载完成后，在adf目录下cmd执行git submodule update --init，这一步将两个子模块切换到当前ADF要求的版本。

  • 添加环境变量

方法一：在 Command Promp中运行以下命令：

set ADF_PATH=D:\ESP-IDF\esp-adf

ADF_PATH为ADF库安装路径

方法二：进入git bash的vim编辑器输入以下命令：

export IDF_PATH="D:\ESP-IDF\esp-adf"

输入完成后按ESC键，然后输入 :wq 点击回车。

方法三：手动添加：
image-20220406234259675
如果不添加环境变量，可以直接使用库所在路径：

include(D:/ESP-IDF/esp-iot-solution/component.cmake)	
include($ENV{IOT_SOLUTION_PATH}/component.cmake)
  • 在ESP-IDF插件设置中添加ADF安装路径
    image-20220527015458010
  • 选择对应芯片型号的开发板HAL库（我的是ESP32-S2）
    image-20220407191505343

编译demo测试：
image-20220406234259675

参考：

2 打补丁

因为我们默认选择了在 psram 上运行的音频任务堆栈，这意味着您需要应用补丁 $ADF_PATH/idf_patches/idf_v4.4_freertos.patch 来支持此功能。（4.4与IDF版本保证一致）

在esp-idf路径下鼠标右键git-bash-here输入：

git apply ./idf_v4.4_freertos.patch

3 常见错误与配置

  1. error：esp-adf/components/audio_board/lyrat_v4_3/board_pins_config.c
  1. esp-iot-solution代码框架：unknown type name ‘i2s_dac_mode_t’
  1. https链接需要进行证书的认证
    在这里插入图片描述
    在这里插入图片描述
  2. AAC解码失败，修改Menuconfig
    在这里插入图片描述
    要运行 AAC 解码器，系统任务滴答时间CONFIG_FREERTOS_HZ 应设置为 1000 Hz：
    在这里插入图片描述

END

esp-adf windows 搭建环境 并 运行 play_mp3_control
嘉禾天成‘s Blog
07-07 829
windows下搭建esp-adf环境，并运行例程 play_mp3_control
ESP32开发__ESP-IDF, ESP-ADF官网下载，安装及环境配置
深漂3年的精致小镁铝
10-24 4494
ESP32 是一款功能丰富的 SoC，集成Wi-Fi 4和蓝牙，适用于多样的物联网应用，具有高性能、高集成、低功耗和多种接口的特点，可作为独立系统或从设备提供 Wi-Fi和 …蓝牙高性能 Xtensa® 32 位 LX6 双核处理器超低功耗协处理器多种外设ESP32 采用 40 nm 工艺制成，具有最佳的功耗性能、射频性能、稳定性、通用性和可靠性，适用于各种应用场景和不同功耗需求。
如何在vscode下配置esp-adf的开发环境_vscode esp adf
2401_84009130的博客
04-06 810
你的支持，我的动力；祝各位前程似锦，offer不断，步步高升！！！你的支持，我的动力；祝各位前程似锦，offer不断，步步高升！！！更多资料点击此处获qu！！
esp-adf环境搭建-基于vscode插件扩展
传播知识，分享快乐！
12-12 1781
esp-adf是一套基于esp-idf框架的音频库我们开发基于乐鑫芯片的音频播放以及语音识别功能需要使用此音频库。我们首先需要安装esp-idf，可以参考我之前教程。
【ESP-ADF】在 VSCode 安装 ESP-ADF 注意事项
椎名的博客
03-05 559
使用 VSCode 的 ESP-ADF 的安装注意事项。
ESP32_esp-adf环境搭建
叶子丶de花 博客
08-20 3852
下方使用的是缓存加速的镜像gitclone站，所以很有可能导致层序不是最新的。如果后续编译出错，则需要去github下载，不可以使用镜像网站。如果网速好，可以直接在github下载，以免出现不必要的错误。如下错误提示在不存在某文件，这就是因为上方使用镜像网站下载的原因，导致程序不是最新的，需要去github下载最新的才可以解决。设置ADF_PATH的路径，必须移动到esp-adf所在的文件夹再设置ADF_PATH的路径。直接在用户的环境里面添加ESP-ADF的路径，记得所有的确定都点一下。
ESP32 esp-idf esp-adf环境安装及.a库创建与编译
zmlovelx(帅得不敢出门 程序员群31843264)
06-24 2169
ESP32功能丰富的 Wi-Fi & 蓝牙 MCU, 适用于多样的物联网应用。使用freertos操作系统。ESP-IDF 官方物联网开发框架。ESP-ADF 官方音频开发框架。这里介绍如何在windows下搭建esp-idf与esp-adf环境，并创建新工程编译出.a库。
esp32 A1S 搭建esp-adf环境
chilian12321的博客
05-14 990
1.安装VMwareUbuntu 安装必要的工具 2.安装Pythonwget https://www.python.org/ftp/python/3.6.4/Python-3.6.4.tgz具体参考：linux安装和卸载python3 - 公元12956 - 博客园 (cnblogs.com) 3.拉取代码 ： git clone --recursive https://github.com/Ai-Thinker-Open/ESP32-A1S-AudioKit.git 到、ho...
搭建ADF开发环境
Love is smiling
05-13 669
step1 xiaz
ESP32 ADF音频框架环境搭建
qq_43940227的博客
07-21 1145
变量值D\Software_APP\Espressif\frameworks\esp-adf。完成以上步骤后，进入到esp-adf\components目录，并分别执行git克隆命令。等待仓库克隆完成后，进入esp-adf目录，并执行git克隆命令。双击ESP-IDF4.4PowerShell打开。设置电脑环境变量，这部分根据自己实际安装路径进行设置。变量名ADF_PATH。编译成功，提示消息。.........
esp32 esp-idf/esp-adf 环境搭建
u014162835的博客
10-22 901
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 编译例程，成功。
esp32-adf asr源码
03-26
代码实现了语音控制的蓝牙播放器，手机连接蓝牙后可以用语音控制“上一曲”，“下一曲”，“音量加”，“音量减”等操作
esp32-lin:关于esp32-idf esp32-adf音频板
04-27
ESP32-LIN是基于ESP32微控制器的音频开发板，主要针对使用Espressif Systems的ESP32-IDF（物联网开发框架）和ESP32-ADF（音频开发框架）进行音频应用设计的开发者。这个开发板由WhyEngineer公司制造，提供了丰富的...
Windows下两个ESP-IDF版本切换
09-20
ESP-IDF是乐鑫信息科技有限公司提供的一个开源物联网开发框架，用于开发ESP32系列芯片的应用程序。ESP-IDF 4.4和ESP-IDF 5.1是该框架的两个不同版本，它们在功能上存在差异，特定的芯片支持也有所不同。在本篇文章中...
ESP-ADF 开发环境搭建
MyLovelyJay的博客
08-16 738
ESP-ADF 开发环境搭建
ESP32 ADF windows开发环境搭建 适配ADF到ESP32A1S
杀手的博客
08-09 8431
搭建ESP32A1S的ADF开发环境 一，获取IDF和IDF-TOOL adf是乐鑫的音频开发框架，里面有许多乐鑫的音频开发API，同时ADF是基于IDF的。 这一部分可以按照官网的教程一步一步来。 官网教程地址：ADF安装指南 首先下载esp-idf，如果是第一次使用idf，可以在官网下载一个idf工具安装器，通过这个安装器直接安装idf，同时还可以安装编译工具链。下载的速度也还可以接受。大概三十分钟就可以搞定。 本安装器可为您安装所需的交叉编译器、OpenOCD、cmake 和 Ninja 编译工具，
esp32录音功能开发_ESP32 LyraT音频开发板试玩(一)：搭建开发环境
weixin_39618173的博客
12-20 737
我是卓波，很高兴你来看我的博客。系列文章：关于ESP32的开发环境搭建，官方有教程，链接如下：开发环境搭建本文搭建的开发环境为window下的开发环境：1：下载工具链从 espressif.com下载工具链和MSYS2压缩文件：将zip压缩文件解压到D:\ (或其它路径)，它会使用预先准备的环境创建一个msys32目录。2：创建工作目录运行 D:\msys32\mingw32.exe 打开一个...
ESP32学习笔记（37）——搭建ESP-ADF(乐鑫音频开发框架)
热门推荐
Leung的博客
07-22 1万+
一、简介 ESP-ADF 以最全面的方式支持 Espressif 系统 SoC 音频应用程序的开发。使用 ESP-ADF ，您可以轻松地添加功能，开发从简单到复杂的音频应用程序： 音乐播放器或录音机支持音频格式：如MP3、AAC、FLAC、WAV、OGG、OPUS、AMR、TS、EQ、Downmixer、Sonic、ALC、G.711等。 播放音乐来源：HTTP，HLS(HTTPLive流)，SPASS，SD Card，A2DP-Source，A2DP-Sink，HFP等等。 整合媒体服务：如DLNA、V
ESP-IDF、ESP-ADF安装与配置
weixin_38499443的博客
10-07 2643
ESP-IDF、ESP-ADF 安装下载与配置
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
发出的红包

打赏作者

柯西的彷徨

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

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

余额充值