一、简介
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........_____....._____....._____....._____....._____....._____....._____
我用的是 ESP32-LyraT V4.3
开发板,出现Connecting的时候按住 Boot
键,再按一下 RST
键,进入烧录模式。
然后,出现了超时,一直烧录不成功:
然后我到 CP210x USB to UART Bridge VCP Drivers 上,下载安装驱动 CP210x Universal Windows Driver v10.1.10
之后就能下载了
- 下载完成
- 串口调试
idf.py -p PORT monitor
其中PORT
是连接开发板的端口。如COM22
,命令为idf.py -p COM22 monitor
。
5.2 烧录工具烧写
flash_download_tool_v3.8.5
链接:https://www.espressif.com/zh-hans/support/download/other-tools
然后按照 idf.py -p COM22 monitor
中提示的文件和烧录地址
• 由 Leung 写于 2021 年 7 月 22 日