espressif/esp-adf
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
No description
2,132 commits 4 branches 15 tags 206 MiB
  • C 92%
  • Python 5.8%
  • CMake 1.3%
  • Shell 0.5%
  • HTML 0.2%
  • Other 0.1%
Find a file
Exact
Jason-mao 12ea304254
Some checks failed
Push components to Espressif Component Service / upload_components (push) Has been cancelled
Details
Merge branch 'feature/ci_full_matrix' into 'master' 
feat(ci): Parallelize S3 and P4 jobs, enable UT ccache, and trim CI overhead

See merge request adf/esp-adf-internal!1611
2026-11-10 20:14:53 +08:00
.github feat(esp_compact_font): Added initial version of esp_compact_font 2026-11-05 10:35:49 +08:00
.gitlab/ci feat(ci): Parallelize S3 and P4 jobs, enable UT ccache, and trim CI overhead 2026-11-10 19:19:42 +08:00
adf_examples test(ci): Fix video false-green assertions and harden target test stability 2026-11-05 11:23:14 +08:00
components test(ci): Fix video false-green assertions and harden target test stability 2026-11-05 11:23:14 +08:00
docs docs(docs): Update ESP32-S3-Korvo-2 document links 2026-10-28 19:39:57 +08:00
tools feat(ci): Parallelize S3 and P4 jobs, enable UT ccache, and trim CI overhead 2026-11-10 19:19:42 +08:00
.codespellrc feat(esp_llm_service): Add esp llm service 2026-10-13 20:26:01 +08:00
.editorconfig Init public version 2018-04-03 17:44:04 +08:00
.gitignore feat(adf_service): Add ADF service platform and first-party capabilities 2026-04-30 18:37:55 +08:00
.gitlab-ci.yml docs(docs): Add esp-adf master docs 2026-09-01 21:19:07 +08:00
.gitmodules refactor(esp-adf): Delete the adf 2.x codes 2026-04-13 17:48:44 +08:00
.pre-commit-config.yaml feat(esp_coze): Update esp_coze version to v1.0 2026-05-12 21:34:28 +08:00
CMakeLists.txt refactor(esp-adf): Delete the adf 2.x codes 2026-04-13 17:48:44 +08:00
conftest.py test(ci): Retry flashing on esptool RAM checksum errors 2026-11-05 14:15:07 +08:00
LICENSE Update LICENSE 2018-04-04 23:40:09 +08:00
pytest.ini ci(.gitlab): Update conftest.py for support idf_parametrize 2026-04-30 14:18:52 +08:00
README.md docs(docs): Add esp-adf master docs 2026-09-01 21:19:07 +08:00
README_CN.md docs(docs): Add esp-adf master docs 2026-09-01 21:19:07 +08:00

README.md

Espressif Advanced Development Framework

中文版

⚠️ Important

The master branch contains the new features for ADF v3.0, which are actively developed and incompatible with previous versions. For the stable ADF v2.x version, please switch to the release/v2.x branch.

Overview

ESP-ADF (Espressif Advanced Development Framework) is Espressif’s official advanced application-layer development framework, designed to simplify the development of audio, video, and IoT products.

ADF v3.0 represents a major architectural upgrade, completely redesigned and incompatible with ADF v2.x. It focuses on product-oriented functionality, modular services, and low resource consumption.

ESP-ADF vs ESP-IDF

  • ESP-IDF is the base SDK for Espressif chips, offering low-level components such as OS, drivers, network stack, Bluetooth, etc.
  • ESP-ADF is built on top of ESP-IDF, providing high-level product-oriented services, such as audio/video playback, battery service, OTA, and more.

✅ ADF v3.0 Features

ADF v3.0 is a product-oriented development framework with significant architectural changes that are completely incompatible with previous ADF versions. Key features include:

  • ESP-GMF Integration: Core media pipeline restructured using ESP-GMF (General Multimedia Framework)
  • Standalone Components: Functional components such as playlist can run independently
  • Product Services: Modular services for audio playback, video playback, battery monitoring, and more
  • MCP Support: Product services are callable via Model Context Protocol (MCP)
  • Multi-Product Support: Designed for audio, video, and IoT products
  • Resource Efficient: Optimized for low memory and CPU usage
  • Multi-Language App Support: Supports development in MicroPython, Arduino, and C/C++

ADF v3.0 Block Diagram

ADF Block Diagram

Platform Requirements

  • ESP-IDF Version: v5.5.2 or later

Branch Strategy

  • release/v2.x: Legacy ADF implementation (v2). Receives only bug fixes and minor enhancements. See ADF v2.x Documentation for reference.

  • master: Development branch for ADF v3.0. Not compatible with v2.x APIs or behavior.

Documentation

Roadmap

  • Functional Modules: e.g., Playlist, Board Manager
  • Service Layer: e.g., Wi-Fi Service with MCP (Model Context Protocol) support
  • AI Service Integration: e.g., OpenAI, Coze, etc.
  • Expanded set of reusable product service plugins