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

最新推荐文章于 2025-03-05 10:50:46 发布

Leung_ManWah

最新推荐文章于 2025-03-05 10:50:46 发布

阅读量1.9w

点赞数 16

分类专栏： ESP32 文章标签： ESP32 ESP-ADF 音频编码解码乐鑫音频开发框架

本文链接：https://blog.csdn.net/qq_36347513/article/details/119002061

版权

ESP32 专栏收录该内容

52 篇文章

订阅专栏

一、简介

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、VoIP等。
网络收音机
语音识别和与在线服务的集成：如Alexa，DuerOS等。

ESP-ADF 提供一系列 API 组件，包括音频流、编解码器和以音频管道组织的服务，所有这些组件都通过媒体 HAL 与音频硬件集成，并与 ESP32 上的外围设备集成。

1.1 官方资料

乐鑫音频应用开发指南

二、安装ESP-IDF

查看 ESP32学习笔记（1）——搭建环境、编译烧写（Windows+VS Code）
如果已安装，可跳过

三、安装ESP-ADF

3.1 获取ESP-ADF

打开命令提示符并运行以下命令：

cd %userprofile%\esp
git clone --recursive https://github.com/espressif/esp-adf.git

等待clone完成后，再打开esp-adf目录下的.gitsubmodules文件,可以看到该目录下有三个子模块仓库：

idf模块
esp-adf-libs模块：adf音频库
esp-sr模块：识别语音库

[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

在 %userprofile%\esp\esp-adf\components 目录下执行：

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

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

3.2 设置ESP-ADF的路径

工具链程序使用 ADF_PATH 环境变量访问 ESP-ADF 。此变量应在您的 PC 上设置，否则项目将无法构建。

set ADF_PATH=%userprofile%\esp\esp-adf

需要注意的是，在每次打开cmd之后要设置ADF_PATH

还有一劳永逸的方法：
右键电脑属性→高级系统设置→环境变量→添加ADF_PATH

要确保 ADF_PATH 已正确设置，请运行：

echo %ADF_PATH%

应该返回 ESP-ADF 目录的路径：

四、编译

打开 ESP-IDF Command Prompt (cmd.exe)
进入例程目录：

cd esp\esp-adf\examples\get-started\play_mp3_control

进行编译

idf.py build

编译完成

五、烧写

5.1 编译环境中烧写

烧录前先配置模组的flash大小：
输入命令 idf.py menuconfig 打开配置界面

进入Serial flasher config，按需将 Flash size 改为自己的大小。比较常用的两个模组：安信可ESP-32S、乐鑫ESP32-WROOM-32，flash 都是 4MB。连续按 Esc 退出，按 s 保存。

查看端口号
开发板连接电脑。设备管理器查看开发板的端口号 COM22
烧录执行

idf.py -p PORT flash

其中PORT是连接开发板的端口。如COM22，命令为idf.py -p COM22 flash。

这将编译应用程序和所有 ESP_IDF 组件，生成引导加载程序，分区表和应用程序二进制文件，并将这些二进制文件闪存到 ESP32 板上。

esptool.py v3.0
Generated C:/Users/neldtv/esp/esp-idf/examples/get-started/hello_world/build/bootloader/bootloader.bin
[783/784] Generating binary image from built executable
esptool.py v3.0
Generated C:/Users/neldtv/esp/esp-idf/examples/get-started/hello_world/build/hello-world.bin
[783/784] cmd.exe /C "cd /D C:\Users\neldtv\esp\esp-idf\co...eldtv/esp/esp-idf/components/esptool_py/run_esptool.cmake"
esptool.py --chip esp32 -p COM22 -b 460800 --before=default_reset --after=hard_reset write_flash --flash_mode dio --flash_freq 40m --flash_size 4MB 0x8000 partition_table/partition-table.bin 0x1000 bootloader/bootloader.bin 0x10000 hello-world.bin
esptool.py v3.0
Serial port COM22
Connecting........_____....._____....._____....._____....._____....._____....._____