ESP32 开发笔记

ADF环境搭建

打补丁

常见错误与配置

1 ADF环境搭建

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

esp32 idf 多pipeline音频 esp32音频开发板_音视频

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

  • 需要单独安装的库

方法一:

esp32 idf 多pipeline音频 esp32音频开发板_git_02

esp32 idf 多pipeline音频 esp32音频开发板_音视频_03

分别将这些文件复制到..\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的内容如下:
[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 点击回车。

方法三:手动添加:

esp32 idf 多pipeline音频 esp32音频开发板_git_04

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

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

编译demo测试:

esp32 idf 多pipeline音频 esp32音频开发板_音视频_05


参考:

  • 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引脚
  1. esp-iot-solution代码框架:unknown type name ‘i2s_dac_mode_t’
  • esp32-s2在调用iot solution后在编译时出现报错,提示没有’i2s_dac_mode_t’句柄该如何解决
  • ESP-IoT-Solution 简介
  1. https链接需要进行证书的认证
  2. AAC解码失败,修改Menuconfig 要运行 AAC 解码器,系统任务滴答时间CONFIG_FREERTOS_HZ 应设置为 1000 Hz:

END