[004] [esp32 Development Notes] audio development framework ADF environment construction - based on esp-idf

1 ADF Environment building

stay ESP-IDF Environment ESP-ADF Environmental Science

After successful installation , Several library files are missing and not installed , They are embedded esp-idf、esp-idf-libs（adf Audio library ）、esp-sr（adf Speech recognition library ）, Because these libraries are esp-idf-master Warehouse The following are all branches branch Stored as a link .

• Libraries that need to be installed separately

Method 1 ：

Copy these files to respectively ..\esp-adf\esp-idf、..\esp-adf\components\esp-adf-libs、..\esp-adf\components\esp-sr In the folder .

Method 2 ： use git Command clone warehouse ：

1. stay esp-adf-libs Execute under directory ：

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

2. stay esp-sr Execute under directory ：

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

git Cloned esp-sr The library files , Some documents are missing after my test , Error will be reported in compilation , Later, it can be downloaded and copied directly in the official warehouse .

3. stay esp-idf Execute under directory ：

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

4. After downloading the above warehouse , modify adf Under the table of contents .gitmodules Is as follows ：
   

[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

When the two warehouses are downloaded , stay adf Under the table of contents cmd perform git submodule update --init, This step switches the two sub modules to the current mode ADF Required version .

• Add environment variables

Method 1 ： stay Command Promp Run the following command in ：

set ADF_PATH=D:\ESP-IDF\esp-adf

ADF_PATH by ADF Library installation path

Method 2 ： Get into git bash Of vim The editor enters the following command ：

export IDF_PATH="D:\ESP-IDF\esp-adf"

Press... When input is complete ESC key , Then input :wq Click enter .

Method 3 ： Manually add ：

If you don't add environment variables , You can directly use the path where the library is located ：

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

• stay ESP-IDF Add... To plug-in settings ADF The installation path
  
• Select the development board corresponding to the chip model HAL library （ My is ESP32-S2）
  

compile demo test ：

---

Reference resources ：

• ESP32 ADF windows Development environment construction adapter ADF To ESP32A1S

• ESP32_Lyrat Development environment construction , install IDF And ADF, Burn in demo Play an audio

• ESP32 Learning notes （37）—— build ESP-ADF( Lexin audio development framework )

2 patch up

Because we have chosen by default to psram Audio task stack running on , This means that you need to apply a patch $ADF_PATH/idf_patches/idf_v4.4_freertos.patch To support this feature .（4.4 And IDF Version guarantee consistency ）

stay esp-idf Right click under the path git-bash-here Input ：

git apply ./idf_v4.4_freertos.patch

3 Common errors and configurations

1. error：esp-adf/components/audio_board/lyrat_v4_3/board_pins_config.c

• no choice ADF The development board corresponding to the library

• modify board_pins_config.c Medium I2S Pin

2. esp-iot-solution The code framework ：unknown type name ‘i2s_dac_mode_t’

• esp32-s2 Calling iot solution An error is reported during compilation , Tip no ’i2s_dac_mode_t’ How to handle

• ESP-IoT-Solution brief introduction

3. https The link needs to be authenticated with a certificate
   
   
4. AAC Decoding failed , modify Menuconfig
   
   To run AAC decoder , System task tick time CONFIG_FREERTOS_HZ Should be set to 1000 Hz：
   

END