Espressif Audio Development Framework
Espressif Systems Audio Development Framework (ESP-ADF) is the official audio development framework for the ESP32, ESP32-S2 and ESP32-S3 SoCs.
Overview
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:
Developing with the ESP-ADF
Quick Start
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, ESP32-S2, or ESP32-S3 SoCs.
Click on one of audio boards shown below to set up and start using ESP-ADF.
Hardware
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 | ESP32-S3-Korvo-2 Development Board |
|---|---|
 |
 |
| Getting Started with ESP32-Korvo-DU1906 | ESP32-S3-Korvo-2 User Guide |
ESP32-LyraT
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.
ESP32-LyraTD-MSC
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)
ESP32-LyraT-Mini
An open-source mono development board. Designed for connected smart speakers and smart-home audio applications.
ESP32-S2-Kaluga-1 Kit (ESP-LyraT-8311A)
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
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.
ESP32-S3-Korvo-2
ESP32-S3-Korvo-2 is a multimedia development board based on the ESP32-S3 chip. It is equipped with a two-microphone array which is suitable for voice recognition and near/far-field voice wake-up applications. The board integrates multiple peripherals such as LCD, camera, and microSD card. It also supports JPEG video stream processing.
Examples
Check folder examples that contains sample applications to demonstrate API features of the ESP-ADF.
Resources
- 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.