一、简介
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 日
