Espressif Advanced Development Framework Guide Choose version... Get Started Multimedia Examples Solution Center Multimedia Basic Components Upper-layer Components Knowledge Center Multimedia Development Boards Extended Tools Resources Copyrights and Licenses Disclaimer and Copyright Notice English-Chinese Glossary About Espressif Advanced Development Framework Guide Espressif Advanced Development Framework Guide Edit on GitHub Espressif Advanced Development Framework Guide [中文] Get Started Multimedia Examples Solution Center Multimedia Basic Components Upper-layer Components Multimedia Development Boards Overview ESP-ADF(Espressif Advanced Development Framework) is Espressif’s official advanced application-layer development framework. Built on ESP-IDF and ESP-GMF, it targets multimedia application development for audio, video, and IoT products. ESP-ADF v3.0 aims at product-grade features, modular services, and low resource usage, and provides solution components for audio/video capture and playback, AI voice, Bluetooth audio, multimedia transmission, and more. Application components are published to the IDF Component Registry and can be fetched on demand after declaring dependencies in a project. Espressif Advanced Development Framework What’s New Based on ESP-GMF: The media processing chain is rebuilt with ESP-GMF, unifying audio, video, image, and general streaming data processing within a single framework Independent components: Functional components can be integrated and run independently without cloning the entire repository Product services: Provides modular services such as audio playback, video playback, and battery monitoring MCP support: Product services can be invoked through the Model Context Protocol (MCP) Multi-product coverage: Targets audio, video, and IoT product scenarios Resource usage optimization: Optimized for low memory and low CPU usage Multi-language applications: Supports MicroPython, Arduino, and C/C++ development Relationship with Previous ESP-ADF Versions ESP-ADF v3.0 is an architectural upgrade and is not compatible with ESP-ADF v2.x in API or behavior. Branch positioning is as follows: master: The main development line of ESP-ADF v3.0, providing components and product-level solution examples based on ESP-GMF release/v2.x: The maintenance branch of the previous ESP-ADF (v2), which receives only bug fixes and minor enhancements Provide feedback about this document Next © Copyright 2017 - 2026, Espressif Systems (Shanghai) Co., Ltd.. Built with Sphinx using a theme based on Read the Docs Sphinx Theme. Download HTML Espressif Advanced Development Framework Guide Choose version... Get Started Multimedia Examples Solution Center Multimedia Basic Components Upper-layer Components Knowledge Center Multimedia Development Boards Extended Tools ESP Board Manager Web Configuration Tool Links Key Features Applicable Scope Usage Boundaries ESP Audio Analyzer Resources Copyrights and Licenses Disclaimer and Copyright Notice English-Chinese Glossary About Espressif Advanced Development Framework Guide Extended Tools ESP Board Manager Web Configuration Tool Edit on GitHub ESP Board Manager Web Configuration Tool [中文] ESP Board Manager (BMGR) is a foundational component of the Espressif development board ecosystem, used to standardize hardware adaptation across boards. Boards adapted with BMGR can be used directly in any BMGR project, and board-level configurations and project templates can be shared and reused. To simplify the board adaptation process, BMGR provides a companion web configuration tool. The ESP Board Manager web configuration tool supports creating new board configurations, importing existing configurations, editing device and peripheral parameters, and exporting board-level files. Links Web configuration tool: ESP Board Manager Online documentation: ESP Board Manager Online Documentation Key Features Create new board configuration: Fill in the board name, manufacturer, description, target ESP-IDF version and main chip, then select the required devices and peripherals. Import existing configuration: Supports importing local board directories, official boards, and board components as a starting point for further edits. Edit configuration parameters: Fill in mode fields, pin parameters, parameters to be confirmed, peripheral dependencies, and component dependencies on each configuration card. Export board-level files: Exports board_info.yaml, board_devices.yaml and board_peripherals.yaml; setup_device.c is additionally generated when board-level initialization logic is required. Configuration validation: Checks for chip capability conflicts and flags IO pin reuse issues, helping to catch obvious errors before export. Applicable Scope The web tool targets device and peripheral types already supported by BMGR, and is suitable as the entry point for creating new board configurations. Once configuration is complete, the following files can be exported with one click: board_info.yaml board_devices.yaml board_peripherals.yaml setup_device.c setup_device.c is generated only when the selected device requires board-level initialization logic that pure YAML cannot describe (such as a display factory function). Usage Boundaries The tool only generates board-level configuration files; it does not replace the idf.py bmgr command. The exported YAML files still need to be placed into a project and processed with idf.py bmgr -b to generate board-level code. The tool does not generate sdkconfig.defaults.board; the target chip and project configuration still need to be set up in the ESP-IDF project in the usual way. The exported setup_device.c is only a code template generated from the factory function interface. It needs to be completed with real hardware initialization logic and verified on the board before use; it cannot be used as-is. Pin numbers, addresses, clocks, timing, and power relationships in the board-level parameters still need to be confirmed against the schematic and component datasheets. Provide feedback about this document Previous Next © Copyright 2017 - 2026, Espressif Systems (Shanghai) Co., Ltd.. Built with Sphinx using a theme based on Read the Docs Sphinx Theme. Download HTML Espressif Advanced Development Framework Guide Choose version... Get Started Multimedia Examples Solution Center Multimedia Basic Components Upper-layer Components Knowledge Center Multimedia Development Boards ESP32-S3-Korvo-2 V3.1 ESP32-S3-Korvo-2 V3.0 ESP32-S3-Korvo-2-LCD V1.0 ESP32-LyraT-Mini V1.2 Getting Started Guide ESP32-LyraT-Mini V1.2 Hardware Reference ESP32-LyraT V4.3 Getting Started Guide What You Need Overview Components Start Application Development Initial Setup Develop Applications Summary of Key Changes from LyraT V4.2 Other Versions of LyraT Other Boards from LyraT Family Related Documents Disclaimer and Copyright Notice ESP32-LyraT V4.3 Hardware Reference ESP32-LyraT V4.2 Getting Started Guide ESP32-LyraT V4 Getting Started Guide ESP32-LyraTD-MSC V2.2 Getting Started Guide ESP32-Korvo-DU1906 ESP32-C3-Lyra V2.0 Hardware Design Guidelines (PDF) Extended Tools Resources Copyrights and Licenses Disclaimer and Copyright Notice English-Chinese Glossary About Espressif Advanced Development Framework Guide Multimedia Development Boards ESP32-LyraT V4.3 Getting Started Guide Edit on GitHub ESP32-LyraT V4.3 Getting Started Guide [中文] This guide provides users with functional descriptions, configuration options for ESP32-LyraT V4.3 audio development board, as well as how to get started with the ESP32-LyraT board. Check section Other Versions of LyraT, if you have different version of this board. The ESP32-LyraT is a hardware platform designed for the dual-core ESP32 audio applications, e.g., Wi-Fi or Bluetooth audio speakers, speech-based remote controllers, connected smart-home appliances with one or more audio functionality, etc. The ESP32-LyraT is a stereo audio board. If you are looking for a mono audio board, intended for lower end applications, check ESP32-LyraT-Mini V1.2 Getting Started Guide. What You Need 1 × ESP32 LyraT V4.3 board 2 x Speaker or headphones with a 3.5 mm jack. If you use a speaker, it is recommended to choose one no more than 3 watts, and JST PH 2.0mm 2-Pin plugs are needed. In case you do not have this type of plug it is also fine to use Dupont female jumper wires during development. 2 x Micro-USB 2.0 cables, Type A to Micro B 1 × PC loaded with Windows, Linux or Mac OS If you like to start using this board right now, go directly to section Develop Applications. Overview The ESP32-LyraT V4.3 is an audio development board produced by Espressif built around ESP32. It is intended for audio applications, by providing hardware for audio processing and additional RAM on top of what is already onboard of the ESP32 chip. The specific hardware includes: ESP32-WROVER-E Module Audio Codec Chip Dual Microphones on board Headphone output 2 x 3-watt Speaker output Dual Auxiliary Input MicroSD Card slot (1 line or 4 lines) Six buttons (2 physical buttons and 4 touch buttons) JTAG header Integrated USB-UART Bridge Chip Li-ion Battery-Charge Management The block diagram below presents main components of the ESP32-LyraT and interconnections between components. ESP32-LyraT Block Diagram Components The following list and figure describe key components, interfaces and controls of the ESP32-LyraT used in this guide. This covers just what is needed now. Note For detailed technical documentation of this board, please refer to ESP32-LyraT V4.3 Hardware Reference and ESP32 LyraT V4.3 schematic (PDF). ESP32-WROVER-E Module The ESP32-WROVER-E module contains ESP32 chip to provide Wi-Fi / Bluetooth connectivity and data processing power as well as integrates 4 MB external SPI flash and an additional 8 MB PSRAM for flexible data storage. Headphone Output Output socket to connect headphones with a 3.5 mm stereo jack. Note The socket may be used with mobile phone headsets and is compatible with