Espressif Systems Audio Development Framework (ESP-ADF) is the official audio development framework for the ESP32 and ESP32-S2 SoCs.
ESP-ADF supports development of audio applications for the Espressif Systems SoCs in the most comprehensive way. With ESP-ADF, you can easily add features, develop audio applications from simple to complex:
- Music player or recorder supports audio formats such as MP3, AAC, FLAC, WAV, OGG, OPUS, AMR, TS, EQ, Downmixer, Sonic, ALC, G.711 and etc.
- Play music from sources: HTTP, HLS (HTTP Live Streaming), SPIFFS, SDCARD, A2DP-Source, A2DP-Sink, HFP and etc.
- Integrate Media services such as: DLNA, VoIP and etc.
- Internet Radio
- Voice recognition and integration with online services such as Alexa, DuerOS and etc.
As a general, the ESP-ADF features will be supported as shown below:
You need one of ESP-IDF versions described in ESP-ADF Releases, one of audio boards below and headphones.
Note: If this is your first exposure to ESP-IDF, proceed to Getting Started documentation specific for ESP32 or ESP32-S2 SoCs.
Click on one of audio boards shown below to set up and start using ESP-ADF.
Espressif Systems has released a number of boards for ESP-ADF to develop audio applications, including:
| ESP32-LyraT Development Board | ESP32-LyraTD-MSC Development Board |
|---|---|
 |
 |
| Getting Started with ESP32-LyraT | Getting Started with ESP32-LyraTD-MSC |
| ESP32-LyraT-Mini Development Board | ESP32-S2-Kaluga-1 Kit (ESP-LyraT-8311A) |
|---|---|
 |
 |
| Getting Started with ESP32-LyraT-Mini | Getting Started with ESP32-S2-Kaluga-1 Kit |
| ESP32-Korvo-DU1906 Development Board |
|---|
 |
| Getting Started with ESP32-Korvo-DU1906 |
An open-source development board, supporting Espressif Systems’ ADF and featuring voice wake-up, a wake-up button and an audio player. Designed for smart speakers and smart-home applications.
Designed for smart speakers and AI applications. Supports Acoustic Echo Cancellation (AEC), Automatic Speech Recognition (ASR), Wake-up Interrupt and Voice Interaction.
- Getting Started with ESP32-LyraTD-MSC
- ESP32-LyraTD-MSC Schematic Lower Board A (PDF) , Upper Board B (PDF)
An open-source mono development board. Designed for connected smart speakers and smart-home audio applications.
The ESP32-S2-Kaluga-1 multimedia kit is based on ESP32-S2 and features several extensions including ESP-LyraT-8311A audio board (below) as well as camera, LCD, and touch pad boards.
ESP32-Korvo-DU1906 is an Espressif audio development board with an ESP32-DU1906 module as its core, integrating Wi-Fi, Bluetooth, Bluetooth Low Energy RF and voice/speech signal processing functions.
Check folder examples that contains sample applications to demonstrate API features of the ESP-ADF.
- Documentation for the latest version of https://docs.espressif.com/projects/esp-adf/. This documentation is built from the docs directory of this repository.
- The esp32.com forum is a place to ask questions and find community resources. On the forum there is a section dedicated to ESP-ADF users.
- Check the Issues section on github if you find a bug or have a feature request. Please check existing Issues before opening a new one.
- If you're interested in contributing to ESP-ADF, please check the Contributions Guide.
