ESP-ADF Pre-release v2.0-beta3

Below is the release information of ESP-ADF v2.0-beta3, and its documentation is available here.

Changes since v2.0-beta2

ADF Framework

New Features

• Added supported IDF version to v3.3.1 and v4.0
• Added unit test cases
• Added the playlist_choose API in playlist
• Added the audio_sys_get_time_ms and audio_sys_get_tick_by_time_ms APIs

Bugfix

• Fixed unclear description of audio_pipeline_stop
• Fixed the bug that head files are not compatible with the c++ environment
• Fixed bug that the stop cmd is not sent when element open failure occurs
• Fixed bug that element fails to send the stop cmd after two open errors

ESP Peripherals

New Features

• Added unit test cases
• Added support for customized sizes of the periph_console input buffer

Audio Hal

New Features

• Added support for customized audio boards
• Added unit test cases
• Modified codec i2c driver APIs to i2c_bus for improved thread safety

Bugfix

• Fixed the incorrect function name audio_hal_config_iface

Audio Stream

New Features

• Added support for customized i2s_stream io functions

ESP Codec and Filter Libraries

Bugfix

• Improved AAC performance
• Optimized the MP3 CPU loading
• Fixed resample mode and type descriptions

ESP Audio

New Features

• Added the esp_audio_prefer_type_get API
• Added the esp_audio_play_timeout_set API
• Added the esp_audio_seek API
• Modified esp_audio_sync_play do not post any events after called

Bugfix

• Fixed the bug that incorrect error message is prompted when calling esp_audio_sync_play after an esp_audio_play failure
• Fixed some bugs related to raw_stream
• Fixed a bug that music information is missing after resuming operation
• Fixed a bug that blocks on seek operation
• Fixed a bug that incorrect running time after seeking operation（Natasha：incorrect running time is logged?）
• Fixed a bug that the wrong message is prompted when playing music failure

ADF Micropython

New Features

• Added an audio module that includes player and recorder
• Added examples for micropython

Audio Protocol

New Features

• Added support for customized DLNA XMLs

Examples of ESP-ADF

• Added a new example examples/player/pipeline_hfp_stream
• Added a new example examples/player/pipeline_a2dp_source_stream
• Added a new example examples/player/pipeline_a2dp_sink_stream
• Added more commands in the CLI example
• Added wake tones in dueros example
• Fixed noise on LyraTD-MSC board with pipeline_bt_sink example
• Fixed a dueros bug that music resuming fails after two insert speech queries
• Fixed a play_mp3_control bug that pipeline does not restart when the play button is pressed

Get This Release

Using git commands below to obtain ESP-ADF v2.0-beta3 is highly recommended. Note that the submodules should also be updated (using git submodule update --init --recursive). Otherwise, the source files maybe not working correctly.

git clone https://github.com/espressif/esp-adf.git esp-adf-v2.0-beta3
cd esp-adf-v2.0-beta3/
git checkout v2.0-beta3
git submodule update --init --recursive

To get the programming guide for Audio Development Framework, please check here.