1 ADF环境搭建

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

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

• 需要单独安装的库

方法一：

分别将这些文件复制到..\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

2. 在esp-sr目录下执行：

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

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

3. 在esp-idf目录下执行：

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

4. 以上仓库下载完成后，修改adf目录下.gitmodules的内容如下：
   

[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 点击回车。

方法三：手动添加：

如果不添加环境变量，可以直接使用库所在路径：

include(D:/ESP-IDF/esp-iot-solution/component.cmake)	
include($ENV{IOT_SOLUTION_PATH}/component.cmake)

• 在ESP-IDF插件设置中添加ADF安装路径
  
• 选择对应芯片型号的开发板HAL库（我的是ESP32-S2）
  

编译demo测试：

---

参考：

• ESP32 ADF windows开发环境搭建 适配ADF到ESP32A1S

• ESP32_Lyrat开发环境搭建，安装IDF与ADF，烧入demo播放一段音频

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

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

• 没有选择ADF库对应的开发板

• 修改board_pins_config.c中的I2S引脚

2. esp-iot-solution代码框架：unknown type name ‘i2s_dac_mode_t’

• esp32-s2在调用iot solution后在编译时出现报错，提示没有’i2s_dac_mode_t’句柄该如何解决

• ESP-IoT-Solution 简介

3. https链接需要进行证书的认证
   
   
4. AAC解码失败，修改Menuconfig
   
   要运行 AAC 解码器，系统任务滴答时间CONFIG_FREERTOS_HZ 应设置为 1000 Hz：
   

END