30 Jun 11:44

cbce221

ESP-IDF Release v5.1

Documentation for IDF v5.1 is available at https://docs.espressif.com/projects/esp-idf/en/v5.1/

ESP-IDF v5.1 is a minor update for ESP-IDF v5.0. Release v5.1 is mostly compatible with apps written for ESP-IDF v5.0.

Obtaining v5.1

For full installation instructions, see the ESP-IDF Programming Guide.

The source files attached to this release will not work due to our use of git submodules. Use one of the following methods instead:

Using git

To get this release, use the following commands:

git clone -b v5.1 --recursive https://github.com/espressif/esp-idf.git esp-idf-v5.1
cd esp-idf-v5.1/

This is the recommended way of obtaining v5.1 of ESP-IDF.

Download an archive with submodules included

Attached to this release is an esp-idf-v5.1.zip archive. It includes .git directory and all the submodules, so can be used out of the box. This archive is provided for users who have connectivity issues preventing them from cloning from GitHub.

This archive can also be downloaded from Espressif's download server:
https://dl.espressif.com/github_assets/espressif/esp-idf/releases/download/v5.1/esp-idf-v5.1.zip

Major changes

This is the list of changes since release v5.0:

Major Features

ESP32-C6 support status
ESP32-H2 support status
Bluetooth: Bluetooth support use main XTAL in light sleep mode on ESP32-C3/ESP32-S3 (33f1747)
Bluetooth: Supported Bluetooth to release .bss and .data segment memory on ESP32-C3 and ESP32-S3 (d530630)
Bluetooth: Supported Bluetooth to release .bss and .data segment memory on ESP32-C2 (8ea3865)
NimBLE: Added stack support for LE Power Control (8facf6f)
NimBLE: Migrated to nimble-1.5 (07d8862)
Wi-Fi: Added WPS registrar support in SoftAP mode. (f27a95c)
Wi-Fi: Added support for SAE-PK (Public Key) authentication for station. (e44c7fb)
Wi-Fi: Added support of WPA3 Personal (SAE) in SoftAP. (146a5c4)
Wi-Fi: Added Wi-Fi Aware (NAN) support(currently only ESP32/ESP32S2 support)(d5f53fb)
Wi-Fi: Added support for WPA2/WPA3, mixed mode for SoftAP. (146a5c4)
OpenThread: Added support of Ethernet interface for Openthread br (6ca5db1)
OpenThraed: Supported CSL feature (bb9200a)
OpenThread: Supported Link Metrics feature (bb9200a)
OpenThread: Added SPI support in Radio Co-Processor (c0097c1)
Coexistence: Added external coexistence(leader mode) support on ESP32-S3 and ESP32-C2 (895d97d)
Coexistence: Added external coexistence(follower mode) support on ESP32-C2 (895d97d)
Coexistence: Added force RX mode in external coexistence on ESP32-C2 (895d97d)
ULP: Added support for RTC I2C to ULP RISC-V on ESP32-S2 and ESP32-S3 (867745a)
WDT: Support Interrupt WDT and Task WDT on ESP32-C2 (4f1a9e4)
GDB Stub: Added support for GDB Stub on ESP32-C2 (6020bb0)
pthreads: Added POSIX semaphore implementation (6382fc3)
espcoredump: Added ESP32-C2 target support (47fa643)
espcoredump: Added support for stacks in external RAM for all targets (5eb8def)
Analog Comparator: Introduced the driver of the analog comparator on ESP32-H2 (2d14ba2)
DAC: Introduced new DAC driver, oneshot mode, continuous mode and cosine wave mode are supported on ESP32 and ESP32-S2. Legacy DAC driver in dac.h has been deprecated but still available. The legacy channel enums DAC_CHANNEL_1 and DAC_CHANNEL_2 are deprecated, please use DAC_CHAN_0 and DAC_CHAN_1 instead (9bc2d15)
esp_etm: Support allocating ETM channels dynamically and extensions for GPIO, GPTimer (fefe6f3)
GPTimer: New example to capture HC-SR04 sensor by GPTimer and ETM channel (fefe6f3)
I2S: Supported 4-line PDM RX on ESP32-S3 (48b23b7)
LEDC: Supported LEDC gamma curve fade new feature on ESP32-C6 and ESP32-H2, and added a new relevant ledc_gamma_curve_fade example (3ec287e)
MMU: Added new component esp_mm for memory management, added memory mapping APIs in esp_mmu_map.h (1c69929)
Cache: Added an API to synchronize data between Cache and external memory, on Cache writable chips (ESP32S2, ESP32S3) (a9ce760)
Parlio: Added parallel IO TX driver for ESP32-C6 and ESP32-H2 (14555a1)
Parlio: Added a simple RGB LED Matrix example based on the Parallel IO TX driver (14555a1)
RGB_LCD: Support RGB-YUV data format conversion (e2634b5)
spi_flash: Octal flash and Quad flash mode can be detected automatically in run time. Enabling this feature reduces available internal RAM size by about 900 bytes (cb28fcf)
USB Host: Added support for UVC Host Class (see the UVC Host Class Driver component for more details) and accompanying example (#6493, f161184)
USB: Added Mass Storage Device example (a9e40f6)
Added a new chip version logic (major * 100 + minor) (c546de8)
Semihosting: VFS semihost additional syscalls implemented (38acc3f)
VFS: VFS semihost additional syscalls implemented. (38acc3f)
ESP Partition/Linux: Added support for non default file emulating flash memory (6987526)
sysview: Added FreeRTOS SMP port (1a006cb)
Tools: Added QEMU with xtensa chip support to the Docker image (ccc7846)

Major Bug Fixes

Flash MMAP: Fixed issue that only only limited vaddr ranges can be mapped to instructions/rodata on Flash on ESP32-S2, C3, S3, C2 (#10373, 1c69929)
MSPI: Fixed timing tuning issue for 80MHz Octal PSRAM on ESP32S3, which would lead to system stall at early stage (34e5a80)
MSPI: Fixed timing turning issue on high frequency lead to crash when entering sleep on ESP32-S3 (3b62bf5)
Fixed POWER ON reset when using RTC IO as input in deepsleep on ESP32-S2/ESP32-C3/ESP32-C2 (cfcb573)
Fixed RTC memory lost in high temperature in deepsleep on ESP32-S2/ESP32-C3 (cfcb573)
Support 8MD256 as RTC slow clock work properly ESP32-S2/ESP32-C3/ESP32-C2/ESP32 (cfcb573)
Fixed dangerous power parameters in sleep modes on ESP32-S2 (cfcb573)
PHY: Fix the iPhone disconnects immediately after connecting when BLE and wifi coexist on ESP32-C3 and ESP32-S3 (e8dba71)

Breaking Changes

bootloader_support: The API bootloader_common_get_partition_description has now been made private, the alternative function esp_ota_get_partition_description should be used (a2f028a)
SDMMC/SDSPI: SD cards accept custom frequencies, not only fixed values 20 MHz or 40 MHz. See Storage migration guide for details (7d28aba)
ESSL: The esp_serial_slave_link is removed from the esp-idf components. Now user should use the component manager to pull it in. See example examples/peripherals/sdio/host/main/idf_component.yml for more details (03d8059)
Sleep: esp_light_sleep_start now returns two error num when sleep fails: ESP_ERR_SLEEP_REJECT and ESP_ERR_SLEEP_TOO_SHORT_SLEEP_DURATION (f191b2f)
Storage: All the partition handling APIs and data-type definitions have been moved from the 'spi_flash' to the new component 'esp_partition'. See Storage 5.x migration guide for more details (b14116f)
esp_chip_info() returns the chip version in the format = 100 * major eFuse version + minor eFuse version. (c546de8)
Wi-Fi: Modified maximum SoftAP connection number and ESPNOW encrypted connection number. (d89a512)
Wi-Fi: Changed ESP-NOW receive callback function type (esp_now_recv_cb_t). This change is made to fix potential security issues mentioned in #8574. (8223a59)
ADC: No longer support ADC2 continuous (DMA) mode on ESP32-S3 and ESP32-C3, search for errata on Espressif website to know more details. Users can force use it by enabling ADC_CONTINUOUS_FORCE_USE_ADC2_ON_C3_S3 (6569be4)
ADC: No longer support ADC2 oneshot mode on ESP32-C3, search for errata on Espressif website to know more details. Users can force use it by enabling ADC_ONESHOT_FORCE_USE_ADC2_ON_C3 (6569be4)
I2S STD: Enabled left_align in the default slot configuration. For the default and most used case, data_bit_width equals to slot_bit_width, which means left_align does not matter in this case
For the case that data_bit_width is shorter than slot_bit_width, enabling left_align is a quite typical usage for almost all the codecs. (190e9e7)
NimBLE: Updated return type for nimble_port_init / nimble_port_deinit functions. (9916eb6)
IDF: All dynamic memory allocated by FreeRTOS now defaults to internal memory. To allocate FreeRTOS objects in special memory (e.g., external memory), please use one of the CreateWithCaps() functions in #include "freertos/idf_additions.h" (daf4150)

Known Issues

In ESP32-C6, there is a small chance of core dump when it sends advertisement and scanning
In ESP32-C6, DUT might crash or disconnect with AP when light sleep is enabled
On ESP32-C6, sometimes chip can't wakeup under low temperature, RTC memory lost under high temperature, unexpected power on reset when GPIO wakeup enabled in Deep-sleep. Can't wakeup properly under high temperature from Light-sleep
When using the FPU from multiple tasks on the same core there is a change that the FPU state will be corrupted, causing invalid results. Issue affects ESP32 and ESP32-S3 (#11690)

Changelog

802.15.4

Added

Added support for ESP32-H2 MP chip (63d0494)
esp_phy: Added API esp_btbb_disable to be used by 802.15.4 and Bluetooth (e797a06)
Open source driver code (0be6802)

OpenThread

Added

Support NAT64 ICMP (5573d13)
Added some flash optimization options (45fb699)
Added support of Ethernet interface for Openthread BR (6ca5db1)
Added 802.15.4 and Thread support for ESP32-C6 (2ce330b)
Ad...

Assets 3

21 Jun 12:31

github-actions

v5.1-rc2

4bc7626

ESP-IDF Pre-release v5.1-rc2 Pre-release

Pre-release

Documentation for IDF v5.1-rc2 is available at https://docs.espressif.com/projects/esp-idf/en/v5.1-rc2/

ESP-IDF v5.1-rc2 is a minor update for ESP-IDF v5.0. Release v5.1 is mostly compatible with apps written for ESP-IDF v5.0.

Obtaining v5.1-rc2

For full installation instructions, see the ESP-IDF Programming Guide.

The source files attached to this release will not work due to our use of git submodules. Use one of the following methods instead:

Using git

To get this release, use the following commands:

git clone -b v5.1-rc2 --recursive https://github.com/espressif/esp-idf.git esp-idf-v5.1-rc2
cd esp-idf-v5.1-rc2/

This is the recommended way of obtaining v5.1-rc2 of ESP-IDF.

Download an archive with submodules included

Attached to this release is an esp-idf-v5.1-rc2.zip archive. It includes .git directory and all the submodules, so can be used out of the box. This archive is provided for users who have connectivity issues preventing them from cloning from GitHub.

This archive can also be downloaded from Espressif's download server:
https://dl.espressif.com/github_assets/espressif/esp-idf/releases/download/v5.1-rc2/esp-idf-v5.1-rc2.zip

Major changes

This is the list of changes since release v5.0:

Major Features

ESP32-C6 support status
ESP32-H2 support status
Bluetooth: Bluetooth support use main XTAL in light sleep mode on ESP32-C3/ESP32-S3 (33f1747)
Bluetooth: Supported Bluetooth to release .bss and .data segment memory on ESP32-C3 and ESP32-S3 (d530630)
Bluetooth: Supported Bluetooth to release .bss and .data segment memory on ESP32-C2 (8ea3865)
NimBLE: Added stack support for LE Power Control (8facf6f)
NimBLE: Migrated to nimble-1.5 (07d8862)
Wi-Fi: Added WPS registrar support in SoftAP mode. (f27a95c)
Wi-Fi: Added support for SAE-PK (Public Key) authentication for station. (e44c7fb)
Wi-Fi: Added support of WPA3 Personal (SAE) in SoftAP. (146a5c4)
Wi-Fi: Added Wi-Fi Aware (NAN) support(currently only ESP32/ESP32S2 support)(d5f53fb)
Wi-Fi: Added support for WPA2/WPA3, mixed mode for SoftAP. (146a5c4)
OpenThread: Added support of Ethernet interface for Openthread br (6ca5db1)
OpenThraed: Supported CSL feature (bb9200a)
OpenThread: Supported Link Metrics feature (bb9200a)
OpenThread: Added SPI support in Radio Co-Processor (c0097c1)
Coexistence: Added external coexistence(leader mode) support on ESP32-S3 and ESP32-C2 (895d97d)
Coexistence: Added external coexistence(follower mode) support on ESP32-C2 (895d97d)
Coexistence: Added force RX mode in external coexistence on ESP32-C2 (895d97d)
ULP: Added support for RTC I2C to ULP RISC-V on ESP32-S2 and ESP32-S3. (867745a)
WDT: Support Interrupt WDT and Task WDT on ESP32-C2 (4f1a9e4)
GDB Stub: Added support for GDB Stub on ESP32-C2 (6020bb0)
pthreads: Added POSIX semaphore implementation (6382fc3)
espcoredump: Added ESP32-C2 target support (47fa643)
espcoredump: Added support for stacks in external RAM for all targets. (5eb8def)
Analog Comparator: Introduced the driver of the analog comparator on ESP32-H2 (2d14ba2)
DAC: Introduced new DAC driver, oneshot mode, continuous mode and cosine wave mode are supported on ESP32 and ESP32-S2. Legacy DAC driver in dac.h has been deprecated but still available. The legacy channel enums DAC_CHANNEL_1 and DAC_CHANNEL_2 are deprecated, please use DAC_CHAN_0 and DAC_CHAN_1 instead. (9bc2d15)
esp_etm: Support allocating ETM channels dynamically and extensions for GPIO, GPTimer (fefe6f3)
GPTimer: New example to capture HC-SR04 sensor by GPTimer and ETM channel (fefe6f3)
I2S: Supported 4-line PDM RX on ESP32-S3. (48b23b7)
LEDC: Supported LEDC gamma curve fade new feature on ESP32-C6 and ESP32-H2, and added a new relevant ledc_gamma_curve_fade example (3ec287e)
MMU: Added new component esp_mm for memory management, added memory mapping APIs in esp_mmu_map.h (1c69929)
Cache: Added an API to synchronize data between Cache and external memory, on Cache writable chips (ESP32S2, ESP32S3) (a9ce760)
Parlio: Added parallel IO TX driver for ESP32-C6 and ESP32-H2 (14555a1)
Parlio: Added a simple RGB LED Matrix example based on the Parallel IO TX driver (14555a1)
RGB_LCD: Support RGB-YUV data format conversion (e2634b5)
spi_flash: Octal flash and Quad flash mode can be detected automatically in run time. Enabling this feature reduces available internal RAM size by about 900 bytes. (cb28fcf)
USB Host: Added support for UVC Host Class (see the UVC Host Class Driver component for more details) and accompanying example (#6493, f161184)
USB: Added Mass Storage Device example (a9e40f6)
Added a new chip version logic (major * 100 + minor) (c546de8)
Semihosting: VFS semihost additional syscalls implemented. (38acc3f)
VFS: VFS semihost additional syscalls implemented. (38acc3f)
ESP Partition/Linux: Added support for non default file emulating flash memory (6987526)
sysview: Added FreeRTOS SMP port (1a006cb)
Tools: Added QEMU with xtensa chip support to the Docker image (ccc7846)

Major Bug Fixes

Flash MMAP: Fixed issue that only only limited vaddr ranges can be mapped to instructions/rodata on Flash on ESP32-S2, C3, S3, C2 (#10373, 1c69929)
MSPI: Fixed timing tuning issue for 80MHz Octal PSRAM on ESP32S3, which would lead to system stall at early stage. (34e5a80)
MSPI: Fixed timing turning issue on high frequency lead to crash when entering sleep on ESP32-S3 (3b62bf5)
Fixed POWER ON reset when using RTC IO as input in deepsleep on ESP32-S2/ESP32-C3/ESP32-C2 (cfcb573)
Fixed RTC memory lost in high temperature in deepsleep on ESP32-S2/ESP32-C3 (cfcb573)
Support 8MD256 as RTC slow clock work properly ESP32-S2/ESP32-C3/ESP32-C2/ESP32 (cfcb573)
Fixed dangerous power parameters in sleep modes on ESP32-S2 (cfcb573)
PHY: Fix the iPhone disconnects immediately after connecting when BLE and wifi coexist on ESP32-C3 and ESP32-S3 (e8dba71)

Breaking Changes

bootloader_support: The API bootloader_common_get_partition_description has now been made private, the alternative function esp_ota_get_partition_description should be used. (a2f028a)
SDMMC/SDSPI: SD cards accept custom frequencies, not only fixed values 20 MHz or 40 MHz. See Storage migration guide for details (7d28aba)
ESSL: The esp_serial_slave_link is removed from the esp-idf components. Now user should use the component manager to pull it in. See example examples/peripherals/sdio/host/main/idf_component.yml for more details (03d8059)
Sleep: esp_light_sleep_start now returns two error num when sleep fails: ESP_ERR_SLEEP_REJECT and ESP_ERR_SLEEP_TOO_SHORT_SLEEP_DURATION (f191b2f)
Storage: All the partition handling APIs and data-type definitions have been moved from the 'spi_flash' to the new component 'esp_partition'. See Storage 5.x migration guide for more details (b14116f)
esp_chip_info() returns the chip version in the format = 100 * major eFuse version + minor eFuse version. (c546de8)
Wi-Fi: Modified maximum SoftAP connection number and ESPNOW encrypted connection number. (d89a512)
Wi-Fi: Changed ESP-NOW receive callback function type (esp_now_recv_cb_t). This change is made to fix potential security issues mentioned in #8574. (8223a59)
ADC: No longer support ADC2 continuous (DMA) mode on ESP32-S3 and ESP32-C3, search for errata on Espressif website to know more details. Users can force use it by enabling ADC_CONTINUOUS_FORCE_USE_ADC2_ON_C3_S3 (6569be4)
ADC: No longer support ADC2 oneshot mode on ESP32-C3, search for errata on Espressif website to know more details. Users can force use it by enabling ADC_ONESHOT_FORCE_USE_ADC2_ON_C3 (6569be4)
I2S STD: Enabled left_align in the default slot configuration. For the default and most used case, data_bit_width equals to slot_bit_width, which means left_align does not matter in this case.
For the case that data_bit_width is shorter than slot_bit_width, enabling left_align is a quite typical usage for almost all the codecs. (190e9e7)
NimBLE: Updated return type for nimble_port_init / nimble_port_deinit functions. (9916eb6)
IDF: All dynamic memory allocated by FreeRTOS now defaults to internal memory. To allocate FreeRTOS objects in special memory (e.g., external memory), please use one of the CreateWithCaps() functions in #include "freertos/idf_additions.h. (daf4150)

Known Issues

In ESP32-C6, there is a small chance of core dump when it sends advertisement and scanning.
In ESP32-C6, DUT might crash or disconnect with AP when light sleep is enabled.
On ESP32-C6, sometimes chip can't wakeup under low temperature, RTC memory lost under high temperature, unexpected power on reset when GPIO wakeup enabled in Deep-sleep. Can't wakeup properly under high temperature from Light-sleep.

Changelog

802.15.4

Added

Added support for ESP32-H2 MP chip (63d0494)
esp_phy: Added API esp_btbb_disable to be used by 802.15.4 and Bluetooth (e797a06)
Open source driver code. (0be6802)

OpenThread

Added

Support NAT64 ICMP (5573d13)
Added some flash optimization options (45fb699)
Added support of Ethernet interface for Openthread br. (6ca5db1)
Added 802.15.4 and Thread support for ESP32-C6 (2ce330b)
Added support for ESP32-C2 BR and ESP32-C6 BR (radio spinel uart). (46a1165)
Supported CSL feature (bb9200a)
Supported Link Metrics feature (bb9200a)
Add...

Assets 3

08 Jun 06:47

github-actions

v4.4.5

ac5d805

ESP-IDF Release v4.4.5

Documentation for IDF v4.4.5 is available at https://docs.espressif.com/projects/esp-idf/en/v4.4.5/

ESP-IDF v4.4.5 is a bugfix update for ESP-IDF v4.4.

Obtaining v4.4.5

For full installation instructions, see the ESP-IDF Programming Guide.

The source files attached to this release will not work due to our use of git submodules. Use one of the following methods instead:

Using git

To get this release, use the following commands:

git clone -b v4.4.5 --recursive https://github.com/espressif/esp-idf.git esp-idf-v4.4.5
cd esp-idf-v4.4.5/

This is the recommended way of obtaining v4.4.5 of ESP-IDF.

Download an archive with submodules included

Attached to this release is an esp-idf-v4.4.5.zip archive. It includes .git directory and all the submodules, so can be used out of the box. This archive is provided for users who have connectivity issues preventing them from cloning from GitHub.

This archive can also be downloaded from Espressif's download server:
https://dl.espressif.com/github_assets/espressif/esp-idf/releases/download/v4.4.5/esp-idf-v4.4.5.zip

Major changes

This is the list of changes since release v4.4.4:

Major Changes

Bootloader: Added chip revision check based on the configured REV_MIN_FULL and the REV_MAX_FULL associated with IDF version (8232f23)

Major Bugfix

efuse: Prevent burning XTS_AES and ECDSA keys into BLOCK9 (BLOCK_KEY5) because HW bug, (related to ESP32-C3, ESP32-S3 chips)(62a9966)
PHY: Fixed iPhone disconnects immediately after connecting when BLE and wifi coexist on ESP32-C3 and ESP32-S3 (1071b13)

Breaking Changes

esp_chip_info() returns the chip version in the format = 100 * major eFuse version + minor eFuse version. (8232f23)
ADC: ADC2 continuous (DMA) mode on ESP32-S3 and ESP32-C3 is not supported by default, Search for errata on espressif website to know more details. Users can force use it by enabling ADC_CONTINUOUS_FORCE_USE_ADC2_ON_C3_S3 (028f483)
ADC: ADC2 oneshot mode on ESP32-C3 is not supported by default. Search for errata on espressif website to know more details. Users can force use it by enabling ADC_ONESHOT_FORCE_USE_ADC2_ON_C3 (028f483)

Changelog

Bluetooth

Controller

Bluetooth Low Energy

Added

Added config to set duplicate scan list refresh period on ESP32, ESP32-C3 and ESP32-S3 (3208949)
Support ESP32C3 and ESP32-S3 new BLE lib (c0efc25)

Changed

Changed default TX power to 9 dBm on ESP32 (3208949)
Optimized the coexist under BLE initiation on ESP32 (7eba5f8)
Improved scan performance when scan and sync coexist on ESP32-C3 and ESP32-S3 (fd5e03b)

Fixed

Fixed duplicate scan refresh cycle is not accurate after restarting scan on ESP32 (7eba5f8)
Set default instance value to 6 on ESP32-C3 and ESP32-S3 (c0efc25)
Merge ESP32C3 and ESP32S3 BLE bt.c, esp_bt.h and kconfig files to one (c0efc25)
Disable controller 5.0 feature bits if host 5.0 feature is not enabled ESP32-C3 and ESP32-S3 (c0efc25)
Fixed extend ADV parameters check for ADV_DIRECT_HI ESP32-C3 and ESP32-S3 (c0efc25)
Fixed BLE disconnect due to channel map update instant passed on ESP32 (17a0cda)
Overwrite the oldest device infor if the list is full on ESP32, ESP32-C3 and ESP32-S3 (3208949)
Fixed duplicate scan period is not accurate on ESP32, ESP32-C3 and ESP32-S3 (3208949)
Fixed some memory was not released after Bluetooth controller initialization failed on ESP32, ESP32-C3 and ESP32-S3 (3208949)
Fixed privacy error for directed advertising on ESP32-C3 and ESP32-S3 (3208949)
Fixed multiple periodic advertising sync failed in air on ESP32-C3 and ESP32-S3 (3208949)
Fixed disconnect reason 0x1f (unspecified error) on ESP32 (3208949)
Fixed connection timeout due to LL_TERMINATE_IND has not been acknowledged on ESP32 (3208949)
Fixed BLE connection terminated due to MIC failure during encryption procedure on ESP32-C3 and ESP32-S3 (fd5e03b)
Fixed BLE connection failed to be established when disabled 5.0 feature on ESP32-C3 and ESP32-S3 (fd5e03b)
Fixed non-connectable and non-scannable directed adv can't be scanned on ESP32-C3 and ESP32-S3 (fd5e03b)
Disabled controller 5.0 feature bits if host 5.0 feature is not enabled (fd5e03b)

Classic Bluetooth

Added

Optimized the wireless coexistence in the conditions of Bluetooth sniff, inquiry scan or page scan on ESP32 (7eba5f8)

Fixed

Fixed that functions "coex_enable" and "coex_disable" are not used in pairs on ESP32-C3 and ESP32-S3 (a60b89b)
Fixed BR/EDR connection failure in case of wireless coexistence on ESP32 (7eba5f8)
Fixed disconnection due to unhandled LMP_UNSNIFF_REQ during the specific state LC_WAIT_SNIFF_SUB_RSP on ESP32 (7eba5f8)
Fixed the crash on ESP32 when link supervision timeout is less than sniff subrating interval (7eba5f8)
Fixed the crash caused by processing the HCI_Read_Remote_Extented_Features command in the non-connected state on ESP32 (7eba5f8)
Fixed the crash after controller disable and re-enable resulted from incorrect hardware settings on esp32 (7eba5f8)

Bluedroid

Fixed

Fixed Bluedroid compile errors after setting CONFIG_ESP_SYSTEM_USE_EH_FRAME=y on RISC-V SoCs (778b806)

Classic Bluetooth

Added

Added report of response code for AVRCP passthrough command (11e20bb)
Added report of ACL link connected and disconnected event to upper layer for GAP (202e1c1)

Changed

Updated the API documentation of esp_bt_gap_set_cod (df8c0f2)

Fixed

Fixed the issue for HID Host in handling the two consecutive connection request (9f8f60d)
Fixed build errors when sniff subrating is enabled. (23ec5e1)
Fixed the issue for A2DP in the use of invalid configuration when the peer device configures the stream, resulting in an incorrect error code (f46b03f)
Fixed out-of-bound array access in HFP-AG (7894f03)
Fixed missing documents for Bluetooth HID Device API reference and fixed the typos for HID device exmaple (7cfc1a7)
Fixed LoadProhibited issue caused by invalid operation on list node in handling hci_hardware_error event (8e55945)

Bluetooth Low Energy

Added

Support BLE privacy by controller (17a0cda)
Added parameters for GATT connect event (17a0cda)
Added API to get the name of Bluetooth device. (f31b5c3)

Fixed

Examples: support BLE notify and write throughput test at the same time (!23234)
Examples: Fixed BLE address type of advertising and scan parameters (17a0cda)
Examples: Fixed BLE HID LED output report (b818abb)
Fixed bluedroid host ATT Ignore wrong response error sometimes (c0efc25)
Enable BT_BLE_RPA_SUPPORTED If target is not ESP32 (c0efc25)
Correct the length of ATT_READ_BY_TYPE_REQ PDU (b818abb)
Fixed encrypt keysize of GATT characteristic permission (b818abb)
Fixed BLE connection update with the same parameters (b818abb)
Fixed saving GATTC cache with the same device address. (f31b5c3)
Fixed state conflict between advertising and scanning. (f31b5c3)
Report status when clearing the BLE whitelist is complete. (f31b5c3)
Fixed battery profile wrong condition in bluedroid host (fd5e03b)
Fixed no error report when own address type is rpa_random and no random address setting (fd5e03b)
PHY: Fixed the iPhone disconnects immediately after connecting when BLE and wifi coexist on ESP32-C3 and ESP32-S3 (1071b13)

NimBLE

Added

Added debug related code under debug flag to improve throughput (188bb8d)
Added configurable option for resolving peer address in bleprph example (f67cb1d)
Added Encryption support (4ceb928)
Added GATT notify and subscribe support (4ceb928)

Changed

Update Mesh example documentation (bd54673)
Updated functions related to adding and clearing peer_dec_rec table (5360833)

Fixed

Fixed README of SPP server (712f6cb)

Blufi

Fixed

Fixed hdr getting freed twice while using blufi (f89eedd)
Fixed vulnerability attacks that could cause heap overflow in fragmented Blufi packet processing (c0efc25)
Fixed Blufi document description errors (fd5e03b)

ESP-BLE-Mesh

Fixed

Fixed filtering error when Provisioner receives heartbeat messages (424ddb3)
Fixed not transmit Transaction ACK before closing provisioning link by Provisioner (3c25ecb)
Fixed not send Link Close message before resetting provisioning link by Provisioner (3c25ecb)

Wi-Fi

Added

Stored some missed station config parameters into NVS (b7ddd82)
Added APIs to get Associate ID and negotiated phymode. (8df9bbd)
Added validations during Suite B Enterprise connections. (f3fc6f7)

Changed

Added changes to use SHA256 size ciphers for WPA2 enterprise for cert size > 2048 (cdb87a5)
Changed abnormal beacon log level to debug (4a4227a)
Improved ESP32 connection success rate at some coexistence scene (0e9c393)
Updated TX rate when phymode change from LR to 11N (7534dac)
Updated Wi-Fi AMSDU docs (bf4a710)
Updated esp_wifi_wps_start() API documentation (#10407, fa3c3a8).
SA Query and assoc comeback related improvements in STA (#9428, 0c8ec2a)

Fixed

Added key reinstallation related security fixes from upstream wpa_supplicant (CVE-2017-13077, CVE-2017-13078, CVE-2017-13079, CVE-2017-13080, CVE-2017-13081, CVE-2017-13082, 0c8dd57)
Fixed beacon TX process when softAP interface is stopped (5999775)
Fixed the incorrect RTOS tick when XTAL PU during sleep on ESP32-C3 (0e9c393)
Fixed the issue that sometimes fail to enter modem sleep after scan (0e9c393)
Fixed typo in wifi_enterprise example README (htt...

Assets 3

05 Jun 08:39

github-actions

v5.1-rc1

56677da

ESP-IDF Pre-release v5.1-rc1 Pre-release

Pre-release

Documentation for IDF v5.1-rc1 is available at https://docs.espressif.com/projects/esp-idf/en/v5.1-rc1/

ESP-IDF v5.1-rc1 is a minor update for ESP-IDF v5.0. Release v5.1 is mostly compatible with apps written for ESP-IDF v5.0.

Obtaining v5.1-rc1

For full installation instructions, see the ESP-IDF Programming Guide.

The source files attached to this release will not work due to our use of git submodules. Use one of the following methods instead:

Using git

To get this release, use the following commands:

git clone -b v5.1-rc1 --recursive https://github.com/espressif/esp-idf.git esp-idf-v5.1-rc1
cd esp-idf-v5.1-rc1/

This is the recommended way of obtaining v5.1-rc1 of ESP-IDF.

Download an archive with submodules included

Attached to this release is an esp-idf-v5.1-rc1.zip archive. It includes .git directory and all the submodules, so can be used out of the box. This archive is provided for users who have connectivity issues preventing them from cloning from GitHub.

This archive can also be downloaded from Espressif's download server:
https://dl.espressif.com/github_assets/espressif/esp-idf/releases/download/v5.1-rc1/esp-idf-v5.1-rc1.zip

Major changes

This is the list of changes since release v5.0:

Major Features

ESP32-C6 support status
ESP32-H2 support status
Bluetooth: Bluetooth support use main XTAL in light sleep mode on ESP32-C3/ESP32-S3 (33f1747)
Bluetooth: Supported Bluetooth to release .bss and .data segment memory on ESP32-C3 and ESP32-S3 (d530630)
Bluetooth: Supported Bluetooth to release .bss and .data segment memory on ESP32-C2 (8ea3865)
NimBLE: Added stack support for LE Power Control (8facf6f)
NimBLE: Migrated to nimble-1.5 (07d8862)
Wi-Fi: Added WPS registrar support in SoftAP mode. (f27a95c)
Wi-Fi: Added support for SAE-PK (Public Key) authentication for station. (e44c7fb)
Wi-Fi: Added support of WPA3 Personal (SAE) in SoftAP. (146a5c4)
Wi-Fi: Added Wi-Fi Aware (NAN) support(currently only ESP32/ESP32S2 support)(d5f53fb)
Wi-Fi: Added support for WPA2/WPA3, mixed mode for SoftAP. (146a5c4)
OpenThread: Added support of Ethernet interface for Openthread br (6ca5db1)
OpenThraed: Supported CSL feature (bb9200a)
OpenThread: Supported Link Metrics feature (bb9200a)
OpenThread: Added SPI support in Radio Co-Processor (c0097c1)
Coexistence: Added external coexistence(leader mode) support on ESP32-S3 and ESP32-C2 (895d97d)
Coexistence: Added external coexistence(follower mode) support on ESP32-C2 (895d97d)
Coexistence: Added force RX mode in external coexistence on ESP32-C2 (895d97d)
ULP: Added support for RTC I2C to ULP RISC-V on ESP32-S2 and ESP32-S3. (867745a)
WDT: Support Interrupt WDT and Task WDT on ESP32-C2 (4f1a9e4)
GDB Stub: Added support for GDB Stub on ESP32-C2 (6020bb0)
pthreads: Added POSIX semaphore implementation (6382fc3)
espcoredump: Added ESP32-C2 target support (47fa643)
espcoredump: Added support for stacks in external RAM for all targets. (5eb8def)
Analog Comparator: Introduced the driver of the analog comparator on ESP32-H2 (2d14ba2)
DAC: Introduced new DAC driver, oneshot mode, continuous mode and cosine wave mode are supported on ESP32 and ESP32-S2. Legacy DAC driver in dac.h has been deprecated but still available. The legacy channel enums DAC_CHANNEL_1 and DAC_CHANNEL_2 are deprecated, please use DAC_CHAN_0 and DAC_CHAN_1 instead. (9bc2d15)
esp_etm: Support allocating ETM channels dynamically and extensions for GPIO, GPTimer (fefe6f3)
GPTimer: New example to capture HC-SR04 sensor by GPTimer and ETM channel (fefe6f3)
I2S: Supported 4-line PDM RX on ESP32-S3. (48b23b7)
LEDC: Supported LEDC gamma curve fade new feature on ESP32-C6 and ESP32-H2, and added a new relevant ledc_gamma_curve_fade example (3ec287e)
MMU: Added new component esp_mm for memory management, added memory mapping APIs in esp_mmu_map.h (1c69929)
Cache: Added an API to synchronize data between Cache and external memory, on Cache writable chips (ESP32S2, ESP32S3) (a9ce760)
Parlio: Added parallel IO TX driver for ESP32-C6 and ESP32-H2 (14555a1)
Parlio: Added a simple RGB LED Matrix example based on the Parallel IO TX driver (14555a1)
RGB_LCD: Support RGB-YUV data format conversion (e2634b5)
spi_flash: Octal flash and Quad flash mode can be detected automatically in run time. Enabling this feature reduces available internal RAM size by about 900 bytes. (cb28fcf)
USB Host: Added support for UVC Host Class (see the UVC Host Class Driver component for more details) and accompanying example (#6493, f161184)
USB: Added Mass Storage Device example (a9e40f6)
Added a new chip version logic (major * 100 + minor) (c546de8)
Semihosting: VFS semihost additional syscalls implemented. (38acc3f)
VFS: VFS semihost additional syscalls implemented. (38acc3f)
ESP Partition/Linux: Added support for non default file emulating flash memory (6987526)
sysview: Added FreeRTOS SMP port (1a006cb)
Tools: Added QEMU with xtensa chip support to the Docker image (ccc7846)

Major Bug Fixes

Flash MMAP: Fixed issue that only only limited vaddr ranges can be mapped to instructions/rodata on Flash on ESP32-S2, C3, S3, C2 (#10373, 1c69929)
MSPI: Fixed timing tuning issue for 80MHz Octal PSRAM on ESP32S3, which would lead to system stall at early stage. (34e5a80)
MSPI: Fixed timing turning issue on high frequency lead to crash when entering sleep on ESP32-S3 (3b62bf5)
Fixed POWER ON reset when using RTC IO as input in deepsleep on ESP32-S2/ESP32-C3/ESP32-C2 (cfcb573)
Fixed RTC memory lost in high temperature in deepsleep on ESP32-S2/ESP32-C3 (cfcb573)
Support 8MD256 as RTC slow clock work properly ESP32-S2/ESP32-C3/ESP32-C2/ESP32 (cfcb573)
Fixed dangerous power parameters in sleep modes on ESP32-S2 (cfcb573)
PHY: Fix the iPhone disconnects immediately after connecting when BLE and wifi coexist on ESP32-C3 and ESP32-S3 (e8dba71)

Breaking Changes

bootloader_support: The API bootloader_common_get_partition_description has now been made private, the alternative function esp_ota_get_partition_description should be used. (a2f028a)
SDMMC/SDSPI: SD cards accept custom frequencies, not only fixed values 20 MHz or 40 MHz. See Storage migration guide for details (7d28aba)
ESSL: The esp_serial_slave_link is removed from the esp-idf components. Now user should use the component manager to pull it in. See example examples/peripherals/sdio/host/main/idf_component.yml for more details (03d8059)
Sleep: esp_light_sleep_start now returns two error num when sleep fails: ESP_ERR_SLEEP_REJECT and ESP_ERR_SLEEP_TOO_SHORT_SLEEP_DURATION (f191b2f)
Storage: All the partition handling APIs and data-type definitions have been moved from the 'spi_flash' to the new component 'esp_partition'. See Storage 5.x migration guide for more details (b14116f)
esp_chip_info() returns the chip version in the format = 100 * major eFuse version + minor eFuse version. (c546de8)
Wi-Fi: Modified maximum SoftAP connection number and ESPNOW encrypted connection number. (d89a512)
Wi-Fi: Changed ESP-NOW receive callback function type (esp_now_recv_cb_t). This change is made to fix potential security issues mentioned in #8574. (8223a59)
ADC: No longer support ADC2 continuous (DMA) mode on ESP32-S3 and ESP32-C3, search for errata on Espressif website to know more details. Users can force use it by enabling ADC_CONTINUOUS_FORCE_USE_ADC2_ON_C3_S3 (6569be4)
ADC: No longer support ADC2 oneshot mode on ESP32-C3, search for errata on Espressif website to know more details. Users can force use it by enabling ADC_ONESHOT_FORCE_USE_ADC2_ON_C3 (6569be4)
I2S STD: Enabled left_align in the default slot configuration. For the default and most used case, data_bit_width equals to slot_bit_width, which means left_align does not matter in this case.
For the case that data_bit_width is shorter than slot_bit_width, enabling left_align is a quite typical usage for almost all the codecs. (190e9e7)
NimBLE: Updated return type for nimble_port_init / nimble_port_deinit functions. (9916eb6)
IDF: All dynamic memory allocated by FreeRTOS now defaults to internal memory. To allocate FreeRTOS objects in special memory (e.g., external memory), please use one of the CreateWithCaps() functions in #include "freertos/idf_additions.h. (daf4150)

Known Issues

In ESP32-H2, the low performance of Thread and BlueTooth are observed on some chips, and the fix is included in a later commit(b0e2f33).
In ESP32-C6, frequent start-stop wifi will make wifi unable to use.
In ESP32-C6, there is a small chance of core dump when it acts as SoftAP and transmits packets.
In ESP32-C6, there is a small chance of core dump when it sends advertisement and scanning.
In ESP32-C6, DUT might crash or disconnect with AP when light sleep enabled.
On all chips that support Bluetooth, there is a tiny chance of core dump when the BLE client accidentally disconnected from its server as the server is sending notifications.

Changelog

802.15.4

Added

Added support for ESP32-H2 MP chip (63d0494)
esp_phy: Added API esp_btbb_disable to be used by 802.15.4 and Bluetooth (e797a06)
Open source driver code. (0be6802)

OpenThread

Added

Support NAT64 ICMP (5573d13)
Added some flash optimization options (45fb699)
Added support of Ethernet interface for ...

Assets 3

11 May 01:55

github-actions

v5.0.2

5181de8

ESP-IDF Release v5.0.2

Documentation for IDF v5.0.2 is available at https://docs.espressif.com/projects/esp-idf/en/v5.0.2/

ESP-IDF v5.0.2 is a bugfix update for ESP-IDF v5.0.

Obtaining v5.0.2

For full installation instructions, see the ESP-IDF Programming Guide.

The source files attached to this release will not work due to our use of git submodules. Use one of the following methods instead:

Using git

To get this release, use the following commands:

git clone -b v5.0.2 --recursive https://github.com/espressif/esp-idf.git esp-idf-v5.0.2
cd esp-idf-v5.0.2/

This is the recommended way of obtaining v5.0.2 of ESP-IDF.

Download an archive with submodules included

Attached to this release is an esp-idf-v5.0.2.zip archive. It includes .git directory and all the submodules, so can be used out of the box. This archive is provided for users who have connectivity issues preventing them from cloning from GitHub.

This archive can also be downloaded from Espressif's download server:
https://dl.espressif.com/github_assets/espressif/esp-idf/releases/download/v5.0.2/esp-idf-v5.0.2.zip

Major changes

Breaking Changes

NimBLE: Updated return type for nimble_port_init / nimble_port_deinit functions. (358ed1a)
cxx: experimental components moved to a separate repository (834ca54)

Changelog

This is the list of changes since release v5.0.1:

Bluetooth

Controller

Fixed

Fixed that functions "coex_enable" and "coex_disable" are not used in pairs on ESP32-C3, ESP32-S3 and ESP32-C2 (f39c3b2)

Bluetooth Low Energy

Changed

Modified the default ACL buffer count to decrease the usage of mbuf used by the bluedroid on ESP32-C2. (7c20c37)
Used esp timer to implement npl callout by default on ESP32-C2. (7c20c37)

Fixed

Fixed BLE disconnect due to channel map update instant passed on ESP32 (4cc0364)
Fixed the issue that adv stops abnormally when the same device initiates two connections on ESP32-C2. (564b94f)
Fixed the issue of abnormal reporting of connection update complete event on ESP32-C2. (564b94f)
Fixed the occasional assertion when the controller is disabled on ESP32-C2. (564b94f)
Fixed flow control count error on ESP32-C2. (564b94f)
Fixed hci uart flow ctrl error on ESP32-C2, ESP32-H4 (2ab97d5)
Fixed task watchdog timeout issue when the hci uart is closed on ESP32-C2, ESP32-H4 (2ab97d5)

Bluedroid

Fixed

Fixed Bluedroid compile errors after setting CONFIG_ESP_SYSTEM_USE_EH_FRAME=y on RISC-V SoCs (9718c91)

Removed

Removed -Wno-format compile option for bluedroid classic bluetooth examples (15b160a)

Classic Bluetooth

Added

Added status parameter for AVRCP passthrough command response event to make user notified of the response code from AVRCP target. (fe743a0)

Fixed

Fixed memory leak in AVDT delay report. (f944418)
Fixed the error the module HFP-AG used an out-of-bounds array index. (cf7a01c)
Fixed HID Host bug when handling the two consecutive connection request (41e52fc)
Fixed status parameter for SDP_CREATE_RECORD_USER_EVT get overridden due to use of union.(#10607) (3d80d4b)
Fixed build errors when sniff subrating is enabled. (8439e61)
Fixed crash caused by accessing nullptr in btm_acl_disconnected (11c6594)

Bluetooth Low Energy

Added

Examples: Support BLE notify and write throughput test at the same time (e9092c2)
Support BLE privacy by controller (4cc0364)
Added parameters for GATT connect event (4cc0364)

Fixed

Examples: Fixed BLE address type of advertising and scan parameters (4cc0364)

NimBLE

Added

Added custom GATT server functionality and encryption(c35de0c)
Added ble_gap_ext_adv_active() to check if extended advertising instance is active or not. (273b1b3)
Added debug related code under debug flag to improve throughput (b837e91)
Added code to retry for memory allocation if previous allocation attempt fails for a Rx packet handling. (#10849, 10010b1)
Added pcl demo in blecent app (0c1e80f)
Added return value (success / failure ) to nimble_port_init (358ed1a)

Changed

Updated functions related to adding and clearing peer_dec_rec table. (008a4dc)
Updated example configuration setting for BLE ext advertising. (df0ec3f)
Changed the component path to relative in IDF examples ( #10797, 8ebb509)
Updated bleprph example to re-enable ext adv after adv is completed (8644754)
Update ble_l2cap_coc example to handle memory double free issue(d4eebd5)

Fixed

Fixed clearing of connection_handle array in spp_server example (8a83241)
Fixed advertising instance check api in bleprph example (63983fb)
Fixed README of SPP server (1ea59bd)
Fixed compilation issues for ESP32-C6 / ESP32-H4 chips ( a9af208 )
Fixed runtime assertion in bleprph due to two disconnect events ( b29c869)

Removed

Removed global min/max definition (5ca38da)

Blufi

Fixed

Fixed vulnerability attacks that could cause heap overflow in fragmented Blufi packet processing (e9092c2)
Fixed hdr getting freed twice while using blufi (b94db7a)

ESP-BLE-Mesh

Fixed

Transmit Transaction ACK before closing provisioning link by Provisioner (c86f48a)
Send Link Close message before resetting provisioning link by Provisioner (c86f48a)

Wi-Fi

Changed

Changed the log level of abnormal beacons to debug (6dc6b57)
Improved the handling of station SA query procedures (63994a2)

Fixed

Added fixes for potential null pointer dereference in wpa_supplicant (89bb920)(122dd1e)
Added validations for Suite B Enterprise connections (e3778fa)
Fixed the initialization of EAP methods during reassociation (e3778fa)
Stored some station config parameters in NVS (7cf3f99)
Fixed the default WPA2 cacheing PMK recalculation (faad05c)
Improved connection management in STA and SoftAP (89bb920)
Buffered deauth, disassoc, and action frames for stations in sleep mode (89bb920)
Fixed an issue with espnow unexpectedly entering modem sleep on ESP32-C2 (7d5c6b9)
Fixed a typo in the wifi_enterprise example README (#10042 3d3df29)
Fixed a bug where sending two M1 WPS EAP messages with different enrollee nonces in response to an expanded WPS request (1f73b5e)
Fixed processing of association response in OWE mode (04f04d6)

Removed

Removed -Wno-format compile option from Wi-Fi related examples. (fa4dccb)(3132e45)(224b320)

ESP-WIFI-MESH

Changed

Updated the discard context condition and the process disconnect condition (2048d1e)
Updated the mesh documentation (2048d1e)

Fixed

Fixed the bug where esp_mesh_is_root() returned an error when setting the root type (2048d1e)
Fixed the bug where users couldn't set inactive time on mesh root (2048d1e)
Fixed the bug in setting idle type (2048d1e)

Security

Added

Added new APIs to confirm that all eFuse security features are enabled correctly in bootloader. (8a6fb6d)

Changed

Updated documentation regarding input endianness required by esp_ds API (#10391)
examples: Enabled security/flash_encryption example for ESP32-C2 (30058e3)

Peripheral Drivers

Added

ADC: Supported calibration on ESP32-C2 (f58f811)
esp_hw_support: Reduced power consumption of some ESP32-S3 chips (763e369)
MCPWM: Support keeping the GPIO configuration when deleting the MCPWM capture channel ( #10327)
MCPWM: Support configure MCPWM generator actions one by one, without using variable length argument lists (#10449) (3f68b61)
USB Host: Added SetAddress() recovery time. Added possibility to configure Root Hub Configuration (delay values) via menuconfig. (5919c3f)

Changed

GDMA: Changed the UHCI GDMA trigger ID from SOC_GDMA_TRIG_PERIPH_UART0 to SOC_GDMA_TRIG_PERIPH_UHCI0 (27ca654)
LEDC: Moved the callback in ledc_fade example to IRAM (#10402 2b14b7d)
LCD: Changed RGB endian in LCD SPI example, when used with ILI9341 controller (#10242, d3b1ae1)
TinyUSB: Use latest compatible version of TinyUSB from IDF component manager (8ae1ed5)

Fixed

ADC: Fixed continuous mode PM lock release fail issue (#10853) (21b42ce)
ADC: Fixed ADCx_GPIOxx_CHANNEL macros not aligned with new ADC driver issue (#10508) (1990335)
GDMA: Fixed SPI2 DMA can't work with async memory copy (#10575) (27ca654)
GPIO: Fixed the issue that IOs, which are used for deep sleep wakeup, keep staying in holding state after waking up. These IOs can now be re-configured. (#10921) (55e040b)
GPTimer: Fixed potential race condition between timer start and stop (b7ca432)
GPTimer: Acquire ESP_PM_NO_LIGHT_SLEEP pm lock for XTAL clock source. (92b1f4f)
I2S: Fixed wrong interrupt allocation flag (#10997) (ef4b1b7)
I2S: Fixed PDM TX frequency 48kHz limitation (#10420) (3050ea6)
I2S: Fixed i2s tx/rx update failed issue (f603aa7)
I80_LCD: Fixed the issue that PLL240M clock source is not allowed to use by ESP32-S3 i80 LCD (4ec2823)
SPI: Fixed micro SPI_HOST_MAX error on target ...

Assets 3

25 May 13:54

github-actions

v5.1-beta1

a6b1ebc

ESP-IDF Pre-release v5.1-beta1 Pre-release

Pre-release

Documentation for IDF v5.1-beta1 is available at https://docs.espressif.com/projects/esp-idf/en/v5.1-beta1/

ESP-IDF v5.1-beta1 pre-release version is a minor update for ESP-IDF v5.0. Release v5.1 is expected to be mostly compatible with apps written for ESP-IDF v5.0.

Obtaining v5.1-beta1

For full installation instructions, see the ESP-IDF Programming Guide.

The source files attached to this release will not work due to our use of git submodules. Use one of the following methods instead:

Using git

To get this release, use the following commands:

git clone -b v5.1-beta1 --recursive https://github.com/espressif/esp-idf.git esp-idf-v5.1-beta1
cd esp-idf-v5.1-beta1/

This is the recommended way of obtaining v5.1-beta1 of ESP-IDF.

Download an archive with submodules included

Attached to this release is an esp-idf-v5.1-beta1.zip archive. It includes .git directory and all the submodules, so can be used out of the box. This archive is provided for users who have connectivity issues preventing them from cloning from GitHub.

This archive can also be downloaded from Espressif's download server:
https://dl.espressif.com/github_assets/espressif/esp-idf/releases/download/v5.1-beta1/esp-idf-v5.1-beta1.zip

Major changes

This is the list of changes since release v5.0:

Major Features

ESP32-C6 support status
ESP32-H2 support status
Bluetooth: Bluetooth support use main XTAL in light sleep mode on ESP32-C3/ESP32-S3 (33f1747)
Bluetooth: Support Bluetooth to release .bss and .data segment memory on ESP32-C3 and ESP32-S3 (d530630)
Bluetooth: Support Bluetooth to release .bss and .data segment memory on ESP32-C2 (8ea3865)
NimBLE: Added stack support for LE Power Control (8facf6f)
NimBLE: Migrated to nimble-1.5 (07d8862)
Wi-Fi: Added WPS registrar support in SoftAP mode. (f27a95c)
Wi-Fi: Added support for SAE-PK (Public Key) authentication for station. (e44c7fb)
Wi-Fi: Added support of WPA3 Personal (SAE) in SoftAP. (146a5c4)
Wi-Fi: Added Wi-Fi Aware (NAN) support(currently only ESP32/ESP32S2 support)(d5f53fb)
Wi-Fi: Added support for WPA2/WPA3, mixed mode for SoftAP. (146a5c4)
OpenThread: Added support of Ethernet interface for Openthread br (6ca5db1)
OpenThread: Supported CSL feature (bb9200a)
OpenThread: Supported Link Metrics feature (bb9200a)
OpenThread: Added SPI support in Radio Co-Processor (c0097c1)
Coexistence: Added external coexistence(leader mode) support on ESP32-S3 and ESP32-C2 (895d97d)
Coexistence: Added external coexistence(follower mode) support on ESP32-C2 (895d97d)
Coexistence: Added force RX mode in external coexistence on ESP32-C2 (895d97d)
ULP: Added support for RTC I2C to ULP RISC-V on ESP32-S2 and ESP32-S3. (867745a)
WDT: Support Interrupt WDT and Task WDT on ESP32-C2 (4f1a9e4)
GDB Stub: Added support for GDB Stub on ESP32-C2 (6020bb0)
pthreads: Added POSIX semaphore implementation (6382fc3)
espcoredump: Added ESP32-C2 target support (47fa643)
espcoredump: Added support for stacks in external RAM for all targets. (5eb8def)
USB Host: Added support for UVC Host Class (see the UVC Host Class Driver component for more details) and accompanying example (#6493, f161184)
I2S: Supported 4-line PDM RX on ESP32-S3. (48b23b7)
esp_etm: Support allocating ETM channels dynamically (fefe6f3)
GPTimer: GPTimer supports ETM events and tasks (fefe6f3)
GPIO: Support GPIO ETM extension (fefe6f3)
USB: Added Mass Storage Device example (a9e40f6)
all: Added a new chip version logic (major * 100 + minor) (c546de8)

Breaking Changes

bootloader_support: The API bootloader_common_get_partition_description has now been made private, the alternative function esp_ota_get_partition_description should be used. (a2f028a)
SDMMC/SDSPI: SD cards accept custom frequencies, not only fixed values 20 MHz or 40 MHz. See Storage migration guide for details (7d28aba)
ESSL: The esp_serial_slave_link is removed from the esp-idf components. Now user should use the component manager to pull it in. See example examples/peripherals/sdio/host/main/idf_component.yml for more details (03d8059)
Sleep: esp_light_sleep_start now returns two error num when sleep fails: ESP_ERR_SLEEP_REJECT and ESP_ERR_SLEEP_TOO_SHORT_SLEEP_DURATION (f191b2f)
Storage: All the partition handling APIs and data-type definitions have been moved from the 'spi_flash' to the new component 'esp_partition'. See Storage 5.x migration guide for more details (b14116f)
esp_chip_info() returns the chip version in the format = 100 * major eFuse version + minor eFuse version. (c546de8)
Wi-Fi: Modified maximum SoftAP connection number and ESPNOW encrypted connection number. (d89a512)
Wi-Fi: Changed ESP-NOW receive callback function type (esp_now_recv_cb_t). This change is made to fix potential security issues mentioned in #8574. (8223a59)
ADC: No longer support ADC2 continuous (DMA) mode on ESP32-S3 and ESP32-C3, search for errata on Espressif website to know more details. Users can force use it by enabling ADC_CONTINUOUS_FORCE_USE_ADC2_ON_C3_S3 (6569be4)
ADC: No longer support ADC2 oneshot mode on ESP32-C3, search for errata on Espressif website to know more details. Users can force use it by enabling ADC_ONESHOT_FORCE_USE_ADC2_ON_C3 (6569be4)
NimBLE: Updated return type for nimble_port_init / nimble_port_deinit functions. (9916eb6)
IDF: All dynamic memory allocated by FreeRTOS now defaults to internal memory. To allocate FreeRTOS objects in special memory (e.g., external memory), please use one of the CreateWithCaps() functions in #include "freertos/idf_additions.h. (daf4150)

Known Issues

In ESP32-H2, the active voltage of some chips is lower than the chip needed, these chips may misbehave when using BLE.
In ESP32-C6, Low Power BROWNOUT restart will be triggered when using Wi-Fi and Bluetooth.
In ESP32-C6, frequent start-stop wifi will make wifi unable to use.

Changelog

802.15.4

Added

Added support for ESP32-H2 MP chip (63d0494)
esp_phy: Added API esp_btbb_disable to be used by 802.15.4 and Bluetooth (e797a06)

OpenThread

Added

Support NAT64 ICMP (5573d13)
Added some flash optimization options (45fb699)
Added support of Ethernet interface for Openthread br. (6ca5db1)
Added 802.15.4 and Thread support for ESP32-C6 (2ce330b)
Added support for ESP32-C2 BR and ESP32-C6 BR (radio spinel uart). (46a1165)
Supported CSL feature (bb9200a)
Supported Link Metrics feature (bb9200a)
Added SPI support in Radio Co-Processor (c0097c1)

Zigbee

Added

Added Zigbee support for ESP32-C6 (83d1bed)
Supported esp32c6 single chip zigbee solution (d6767c2)
Added wifi example_connect for zigbee gateway (d6767c2)
Supported ESP32-H2 MP chip (cc3e709)

Changed

Updated Zigbee example based on new zboss library and esp-zigbee-sdk library (dc09f30)
Updated the example use ZDO API function. (a63a73a)

Bluetooth

Controller

Added

ESP32-C3/ESP32-S3: bluetooth support use main XTAL in light sleep mode (33f1747)

Changed

Updated phy lib for ESP32C2, ESP32C3 and ESP32S3 (cea6614)
Changed default TX power to 9 dBm on ESP32 (cd5ce86)
Set default instance value to 6 on ESP32-C3 and ESP32-S3 (b6fda97)
Optimized the coexist under sniff and iscan/pscan on ESP32 (51c682c)
Optimized the coexist under BLE initiation on ESP32 (51c682c)

Fixed

Fixed the issue of Bluetooth disconnection due to not backing up Bluetooth AGC related registers when light sleep is enabled and baseband power down on ESP32-C3 and ESP32-S3 (6f677de)
Fixed BR/EDR connection fail in coexistence on ESP32 (51c682c)

Bluetooth Low Energy

Added

Added Periodic Advertising ADI Feature on ESP32-C2 (74abb42)
Added APIs to set and get the ble tx power on ESP32-C2 (8d9c51f)
Support Bluetooth to release .bss and .data segment memory on ESP32-C3 and ESP32-S3 (d530630)
Support Bluetooth to release .bss and .data segment memory on ESP32-C2 (8ea3865)
Added config to disable scan backoff on ESP32-C3 and ESP32-S3 (4a3319d)
Enabled BLE PLL track to fix bluetooth disconnection caused by temperature rise or fall on ESP32C3 and ESP32-S3 (cea6614)
Support bluedroid host maximum number of connections to 9 on ESP32-C3 and ESP32-S3 (18e0cd6)
Added config to set duplicate scan list refresh period on ESP32 (af9dcc4)
Supported BLE for ESP32-C6 (bdf3001)
Supported BLE for ESP32-H2 (3ab20c1)
Support ESP32-C3 and ESP32-S3 new BLE lib (ad1999f)

Changed

Updated BLE TX power level mapping on ESP32-C3 and ESP32-S3 (4f4edef)
Updated coexist module for ESP32-C2 (8d9c51f)
Reduced the RAM size of npl_os_freertos.c file on ESP32-C2 (afeb7db)
Modified ESP32-C2's default BLE TX power (afeb7db)
Changed BLE default TX power from 3dBm to 9dBm on ESP32-C3 and ESP32-S3 (4a3319d)
Unified the controller internal error code on ESP32-C2 (f0fd0b7)
Merge ESP32-C3 and ESP32-S3 BLE bt.c, esp_bt.h and kconfig files to one (fe979e6)
Disabled controller 5.0 feature bits if host 5.0 feature is not enabled on ESP32-C3 and ESP32-S3 (ad1999f)

Fixed

Fixed the issue that the output power level wasn't correct on ESP32-C2 (74abb42)
Fixed the occasional issue that adv pdu won't tx at the secondary channel when multiple adv instances are enabled on ESP32-C2 (74abb42)
Fixed the occasional assert error when...

Assets 3

27 Mar 09:15

github-actions

v4.3.5

6d04316

ESP-IDF Release v4.3.5

Documentation for IDF v4.3.5 is available at https://docs.espressif.com/projects/esp-idf/en/v4.3.5/

ESP-IDF v4.3.5 is a bugfix update for ESP-IDF v4.3. ESP-IDF v5.0.1 is the latest stable release at the time of writing.

Obtaining v4.3.5

For full installation instructions, see the ESP-IDF Programming Guide.

The source files attached to this release will not work due to our use of git submodules. Use one of the following methods instead:

Using git

To get this release, use the following commands:

git clone -b v4.3.5 --recursive https://github.com/espressif/esp-idf.git esp-idf-v4.3.5
cd esp-idf-v4.3.5/

This is the recommended way of obtaining v4.3.5 of ESP-IDF.

Download an archive with submodules included

Attached to this release is an esp-idf-v4.3.5.zip archive. It includes .git directory and all the submodules, so can be used out of the box. This archive is provided for users who have connectivity issues preventing them from cloning from GitHub.

This archive can also be downloaded from Espressif's download server: https://dl.espressif.com/github_assets/espressif/esp-idf/releases/download/v4.3.5/esp-idf-v4.3.5.zip

Major changes

This is the list of changes since release v4.3.4:

Breaking Changes

sleep: esp_light_sleep_start function can now return two error codes when sleep fails: ESP_ERR_SLEEP_REJECT (if a wakeup trigger would cause the sleep to be exited instantly) and ESP_ERR_SLEEP_TOO_SHORT_SLEEP_DURATION (if the sleep duration is less than what the hardware can support). Previously the function would not return any error codes in such cases, and sleep would take longer than expected. (6225c71)
ADC: No longer support ADC2 continuous (DMA) mode on ESP32C3, search for errata on espressif website to know more details. Users can force use it by enabling CONFIG_ADC_CONTINUOUS_FORCE_USE_ADC2_ON_C3_S3 (#10135, 00746db)
ADC: No longer support ADC2 oneshot mode on ESP32C3, search for errata on espressif website to know more details. Users can force use it by enabling CONFIG_ADC_ONESHOT_FORCE_USE_ADC2_ON_C3 (#10135, 00746db)
esp_chip_info() now returns the chip version in the format = 100 * major eFuse version + minor eFuse version. (6b32335)

Changelog

This is the list of changes since release v4.3.4.

Bluetooth

Bluetooth Low Energy

Added

Added config to disable scan backoff (2e0da27)
Support Bluetooth to release .bss and .data segment memory on ESP32-C3(2e0da27)
Added config to set duplicate scan list refresh period on ESP32 and ESP32-C3 (8cd8ec0)

Changed

Changed BLE default TX power from 3dBm to 9dBm (2e0da27)
Changed default TX power to 9 dBm on ESP32 (8cd8ec0)

Fixed

Added ADV mode error check in ADV RX isr handler function on ESP32-C3 (9e863ec)
Fixed the performance issue of BLE sync scan in coexistence scenario when PLL track is enabled on ESP32-C3 (9e863ec)
Fixed connect failed due to error sync found signal on ESP32-C3 (9e863ec)
Fixed BLE disconnect failed due to LL_TERMINATE_IND have sent but no ACK is received on ESP32-C3 (9e863ec)
Fixed BLE RAL_UNDERRUN and TX_CRYPT_ERR assert on ESP32-C3 (9e863ec)
Fixed scan forever if scan continue is disable on ESP32-C3 (9e863ec)
Fixed BLE disconnection issue when channel map update failed due to bad channels on ESP32-C3(9e863ec)
Fixed BLE lld_per_adv.c line 401 assert on ESP32-C3 (a2086ca)
Fixed BLE ASSERT_PARAM(32 0) in rwble.c at line 384 on ESP32 (a2086ca)
Fixed llm_scan.c assert at line 1485 during controller deinit if extend duplicate scan is not stopped on ESP32C3(2e0da27)
Fixed BLE array access out of bounds on ESP32C3(2e0da27)
Overwrite the oldest device infor if the list is full on ESP32 and ESP32-C3 (8cd8ec0)
Fixed duplicate scan period is not accurate on ESP32 and ESP32-C3 (8cd8ec0)
Fixed some memory was not released after Bluetooth controller initialization failed on ESP32 and ESP32-C3 (8cd8ec0)
Fixed privacy error for directed advertising on ESP32-C3 (8cd8ec0)
Fixed multiple periodic advertising sync failed in air on ESP32-C3 (8cd8ec0)
Fixed disconnect reason 0x1f (unspecified error) on ESP32 (8cd8ec0)
Fixed connection timeout due to LL_TERMINATE_IND has not been acknowledged on ESP32 (8cd8ec0)
Fixed lld_con.c line 3048 assert on ESP32-C3 (8cd8ec0)
Fixed crash sometimes when connected as a slave by 8th device on ESP32-C3 (8cd8ec0)
Enabled BLE PLL track to fix bluetooth disconnection caused by temperature rise or fall on ESP32-C3 (c3d4741)
Fixed BLE disconnect due to channel map update instant passed on ESP32 (dfc8c67)

Classic Bluetooth

Fixed

Fixed the exhaustion of ACL buffer in case of connection-disconnection stress test(a5e5ab7)
Fixed the duplicated reports of HCI_Connection_Request event from the same Bluetooth device. (a5e5ab7)
Fixed the issue that Wi-Fi task can be blocked by Bluetooth Controller because of the use of blocking coexistence callback function on ESP32 (9e6d5dc)
Fixed that functions "coex_enable" and "coex_disable" are not used in pairs on ESP32-C3 (419d620)

Bluedroid

Classic Bluetooth

Added

Added report for ACL link related events to upper layer (4268238)

Changed

Changed the default SR mode to R2 for the paging device when it knows nothing about the paged device's SR mode.(a0967db)
Changed A2DP audio buffer management behaviour, removed audio cache in BTC layer and added flow control for audio data in application layer in A2DP sink example.(19310ee)

Fixed

Fixed authentication failure during legacy pairing by using variable PIN type instead of fixed PIN. (08ee8d7, #10005)
Fixed the issue Bluetooth Classic connection can not be created while there is a Bluetooth Low Energy connection is in active. (b52b357)
HID: Fixed compatibility issues with HID devices that do not support Secure Simple Paring in HID examples. (a69c540, #10069)
A2DP: fixed sink device not being able to accept and decode mono channel audio stream (07bffab)
SPP: Fixed esp_spp_write() crash when len is 0 (d96bb08)
HFP: Fixed HFP client parce CLCC command response bug (81d598b)
A2DP: Fixed failure of A2DP reconnection A2DP after disconnected (6298b8c)
Fixed memory leak due to not freeing memory if posting a message to a thread fails (df901e0)
SPP: Fixed repeated register of vfs_id causing memory leaks (7d61396)
SPP: Fixed memory leak when SPP initialization failed (7d61396)
Fixed the unexpected memory free when malloc failed. (067d5fb)
Fixed build errors when sniff subrating is enabled. (3a4755e)

Bluetooth Low Energy

Added

Added parameters for GATT connect event (dfc8c67)
Support bluedroid host maximum number of connections to 9 on ESP32-C3 (8cd8ec0)
Support BLE privacy by controller (dfc8c67)

Changed

Updated BLE tx power level mapping (a2086ca)
Reduced the stack consumption of BTU_TASK, saving 609 bytes (05c497e)

Fixed

Fixed extend advertising set remove failed (9e863ec)
Fixed extend ADV TX power range error (9e863ec)
Fixed repeatedly data length set error (9e863ec)
Fixed second bonding fail issue (9e863ec)
Fixed calling esp_ble_get_cur_sendable_packets_num() sometimes crashes when bluetooth is disconnecting (9e863ec)
Configurable max GATTC cache characteristic count on bluedroid (c482cf1)
Fixed BLE advertising TX power map on bluedroid (c482cf1)
Fixed BLE resolvable private address generate and update on bluedroid. (c482cf1)
Fixed ble generate RPA for ESP32 on bluedroid. (c482cf1)
Configurable option to modify max GATT service attributes count on bluedroid. (c482cf1)
HID: Fixed esp hid crash when authentication failed on bluedroid. (9040964)
Allow bluedroid host to report ADV_IND separately (a2086ca)
Fixed ble_compatibility_test example NVS init error (2e0da27)
Fixed sometimes BTU task overflow when doing read and write performance test (2e0da27)
Examples: Fixed BLE HID LED output report (0cf1971)
Fixed encrypt keysize of GATT characteristic permission (0cf1971)
Fixed BLE connection update with the same parameters (0cf1971)
Corrected the length of ATT_READ_BY_TYPE_REQ PDU (0cf1971)
Fixed BLE address type of advertising and scan parameters (dfc8c67)

NimBLE

Added

Support Nimble host maximum number of connections to 9 on ESP32-C3 and ESP32-S3 (0ee6433)
Added checks to disable stack cb registered with controller during stack deinit (ed8a4b14)

Changed

Changed debug level of print to avoid extra unwanted console print (93149d96)
Updated check for reattempt connection code (722291e)
Updated ESP-BLE-MESH example documentation (9248dcf)
Updated functions related to adding and clearing peer_dec_rec table. (c9068dc)

Fixed

Fixed memory corruption introduced in reconnection attempt code (f1bd2be)
Added check to deregister stack callback with controller during stack deinit (dd62e3b)

Blufi

Added

Added data subtype for more WiFi information (ec25f91)

Changed

BluFi example: Supported to query disconnected information, connecting information (ec25f91)
BluFi example: Returned error code if fail to wifi scan (ec25f91)

Fixed

Fixed a bug that memory freed twice(1f739d7)

ESP-BLE-Mesh

Added

Added an option for LPN to subscribe all-nodes-address automatically (894b1ad)
Added an option for initiating IV Index Recovery if missing one (1ec7a0c)

Fixed

Fixed regression introduced...

Assets 3

17 Feb 10:33

github-actions

v5.0.1

a4afa44

ESP-IDF Release v5.0.1

Documentation for IDF v5.0.1 is available at https://docs.espressif.com/projects/esp-idf/en/v5.0.1/

ESP-IDF v5.0.1 is a bugfix update for ESP-IDF v5.0.

Obtaining v5.0.1

For full installation instructions, see the ESP-IDF Programming Guide.

The source files attached to this release will not work due to our use of git submodules. Use one of the following methods instead:

Using git

To get this release, use the following commands:

git clone -b v5.0.1 --recursive https://github.com/espressif/esp-idf.git esp-idf-v5.0.1
cd esp-idf-v5.0.1/

This is the recommended way of obtaining v5.0.1 of ESP-IDF.

Download an archive with submodules included

Attached to this release is an esp-idf-v5.0.1.zip archive. It includes .git directory and all the submodules, so can be used out of the box. This archive is provided for users who have connectivity issues preventing them from cloning from GitHub.

This archive can also be downloaded from Espressif's download server:
https://dl.espressif.com/github_assets/espressif/esp-idf/releases/download/v5.0.1/esp-idf-v5.0.1.zip

Major changes

This is the list of changes since release v5.0:

Breaking Changes

System/sleep: esp_light_sleep_start now returns two error num when sleep fails: ESP_ERR_SLEEP_REJECT and ESP_ERR_SLEEP_TOO_SHORT_SLEEP_DURATION (f91cb28)
Wi-Fi: Changed espnow receive callback function type (esp_now_recv_cb_t) (6818b30)
Wi-Fi: added ESP_WIFI_ESPNOW_MAX_ENCRYPT_NUM to configure the maximum ESPNOW encrypted connection number which impact the maximum SoftAP connection number (175f0de, fe4efc0)
ADC: No longer support ADC2 continuous (DMA) mode on ESP32-S3 and ESP32-C3, search for errata on espressif website to know more details. Users can force use it by enabling ADC_CONTINUOUS_FORCE_USE_ADC2_ON_C3_S3 (1c373cf)
ADC: No longer support ADC2 oneshot mode on ESP32-C3, search for errata on espressif website to know more details. Users can force use it by enabling ADC_ONESHOT_FORCE_USE_ADC2_ON_C3 (bb07490)
esp_chip_info() returns the chip version in the format = 100 * major eFuse version + minor eFuse version.

Changelog

Bluetooth

Controller

Fixed

Fixed lld_con.c line 3048 assert on ESP32-C3 and ESP32-S3 (8b0ec09)
Fixed crash sometimes when connected as a slave by 8th device on ESP32-C3 and ESP32-S3 (8b0ec09)

Bluetooth Low Energy

Added

Added comments explaining how much memory will be used by each connection/advertiser for ESP32-C2 (dcc310f)
Added config to disable scan backoff on ESP32-C3 and ESP32-S3(6d11786)
Supported Bluetooth to release .bss and .data segment memory on ESP32-C2 (6c4292f), ESP32-C3 and ESP32-S3 (1b44990)
Added config to set duplicate scan list refresh period on ESP32, ESP32-C3 and ESP32-S3 (e7ee437, 0733694)

Changed

Changed BLE default TX power from 3dBm to 9dBm on ESP32-C3 and ESP32-S3(99cd534)
Updated phy lib for ESP32-C2, ESP32-C3 and ESP32-S3 (9cfffd2)
Enable BLE PLL track to fix bluetooth disconnection caused by temperature rise or fall on ESP32-C3 and ESP32-S3
Unified the controller internal error code on ESP32-C2 (de7e62f)
Changed default TX power to 9 dBm on ESP32 (0b8f0e5)

Fixed

Fixed a bug in the linker fragment file that made BSS part marked by bt_bss_start and bt_bss_end empty on all BLE chips (d4070f7)
Fixed llm_scan.c assert at line 1485 during controller deinit if extend duplicate scan is not stopped on ESP32-C3 and ESP32-S3(0af189b)
Fixed memory leak issue caused by insufficient heap on ESP32-C2 (90fa0e5)
Fixed interrupt latency when cache is disabled on ESP32-C2 (06290d4)
Fixed occasional assertion when periodic adv is stopped on ESP32-C2
Overwrite the oldest device infor if the list is full on ESP32, ESP32-C3 and ESP32-S3 (e7ee437, 0733694)
Fixed duplicate scan period is not accurate on ESP32, ESP32-C3 and ESP32-S3 (e7ee437, 0733694)
Fixed some memory was not released after Bluetooth controller initialization failed on ESP32, ESP32-C3 and ESP32-S3 (5fff471, c656e7e)
Fixed privacy error for directed advertising on ESP32-C3 and ESP32-S3 (e95d720)
Fixed multiple periodic advertising sync failed in air on ESP32-C3 and ESP32-S3 (e95d720)
Fixed disconnect reason 0x1f (unspecified error) on ESP32 (0b8f0e5)
Fixed connection timeout due to LL_TERMINATE_IND has not been acknowledged on ESP32 (0b8f0e5)

Removed

Removed redundant pm_lock on ESP32-C2 (5c481c5)

Classic Bluetooth

Bluedroid

Classic Bluetooth

Added

Added esp_spp_enhanced_init() API to indicate whether to enable Logical Link Control and Adaptation Layer Protocol enhanced retransmission mode (c2c9b09)
Added report for ACL link related events to upper layer (80da46e)
Added esp_spp_vfs_unregister() to free memory allocated by esp_spp_vfs_register() (3f5aaf1)

Changed

Changed the default SR mode to R2 for the paging device when it knows nothing about the paged device's SR mode. (a1de1bf)
Updated A2DP version to v1.4 (e579466)
Updated HFP version to v1.8 (71bd180)
Changed A2DP audio buffer management behaviour, removed audio cache in BTC layer and added flow control for audio data in application layer in A2DP sink example. (9ad1c7d, 75b2e63)

Fixed

Fixed compatibility issues with HID devices that do not support Secure Simple Paring in HID examples. (a69c540, #10069)
Fixed esp_spp_write() crash when data length is 0 (47232f5)
Fixed incorrect description in macro BT_CONTROLLER_INIT_CONFIG_DEFAULT(). (ffcabde, #9906)
Fixed the unexpected memory free when malloc failed. (11b6c25, #9972)
Fixed the issue Bluetooth Classic connection can not be created while this is a Bluetooth Low Energy connection is in active. (650b665, #6557)
Fixed HFP client parce CLCC command response bug (2539529)
Fixed authentication failure during legacy pairing by using variable PIN type instead of fixed PIN. (728e2c9, #10005)
Fixed HID Host improper handle of freeing resource in esp_hid component (de55b5d)
Fixed A2DP failing to connect again after disconnected (d47bf56)
Fixed HID Device can not remove virtually cabled device without a connection. (ad43b04)
Fixed memory leak due to not freeing memory if posting a message to a thread fails (f9732cb)
Fixed the use of invalid configuration when the peer device configures the stream, and returned an incorrect error code (9bd1484)
Fixed memory leak when SPP initialization failed (29b718b)

Bluetooth Low Energy

Added

Support bluedroid host maximum number of connections to 9 on ESP32-C3 and ESP32-S3 (2a76e35)

Changed

Reduce the stack consumption of BTU_TASK, saving 609 bytes(7884457)

Fixed

Fixed ble_compatibility_test example NVS init error (f258183)
Clean up BLE examples sdkconfig.defaults (fdd75ea)
Fixed sometimes BTU task overflow when doing read and write performance test(2e0a5b3)
Fixed BLE HID LED output report error (e8fef19)
Fixed encrypt key size error of GATT characteristic permission (c97df72)
Fixed no BLE connection update event with the same parameters (938d912)
Correct the length of ATT_READ_BY_TYPE_REQ PDU(4b7702c)

Removed

Remove -Wno-format compile option for bluedroid BLE examples (16f9add)

NimBLE

Added

Added init deinit of nimble stack in a loop. (ff29f5c)
Added stack support for Connection subrating feature (586a471)
Support to expose blufi handler for external BLE application (7a72210)
Added support for HCI Commands / Events for LE Power Control (e8e79e8)
Added an example support for ble periodic adv. (9d3e157)
Helper macro added to set perdiodic adv interval (1623ad0)
Support BLE memory release on ESP32C2 (6c4292f)
Support max number of connections to 9 on esp32c3 and esp32s3 (7d68a35)

Changed

Updated README file of BLE PHY prph example (5774ca1)
Changed GATT notify/indicate from gattc to gatts (b1d87a4)
Updated Mesh example documentation (71e1c0a)

Fixed

Fixed freeing up of same memory address twice in L2CAP COC example. (5c50cbc)
Fixed esprv_intc_int_set_type() usage (50b1a99)

Removed

Remove -Wno-format compile option for nimble examples (cbf8cf7)

Blufi

Added

Added API for stack and profile deinit (ab2dee9)
Added data subtype for more Wi-Fi information (39080a2)
Support to query disconnected information, connecting information (497b451)

Fixed

Examples: Return errcode if fail to scan (497b451)

ESP-BLE-Mesh

Added

Added an option for initiating IV Index Recovery if missing one (54f18a4)

Fixed

Fixed not using fast adv interval when PB-GATT and PB-ADV are both enabled (3d695ce)
Fixed not able to get optional fields from messages with a group address as DST (f825fcd)
Fixed typo in the directly erase settings event (1529613)

Removed

Removed -Wno-format compile option for BLE Mesh examples (fca1b1d)

Coexistence

Added

Added external coexistence (leader mode) support on ESP32-S3 and ESP32-C2 (9bbe6e7)
Added external coexistence (follower mode) support on ESP32-C2 (676a347)
Added force RX mode in external coexistence on ESP32-C2 (676a347)
Added support for output grant signal delay and validate pin level configuration on ESP32-C2 (676a347)

Fixed

Fixed part of modem module not reset when power up (18fef64)

Wi-Fi

Added

Added connectionless power save documentation (5cd3244)
...

Assets 3

03 Feb 04:46

github-actions

v4.4.4

e8bdaf9

ESP-IDF Release v4.4.4

Documentation for IDF v4.4.4 is available at https://docs.espressif.com/projects/esp-idf/en/v4.4.4/

ESP-IDF v4.4.4 is a bugfix update for ESP-IDF v4.4.

Obtaining v4.4.4

For full installation instructions, see the ESP-IDF Programming Guide.

The source files attached to this release will not work due to our use of git submodules. Use one of the following methods instead:

Using git

To get this release, use the following commands:

git clone -b v4.4.4 --recursive https://github.com/espressif/esp-idf.git esp-idf-v4.4.4
cd esp-idf-v4.4.4/

This is the recommended way of obtaining v4.4.4 of ESP-IDF.

Download an archive with submodules included

Attached to this release is an esp-idf-v4.4.4.zip archive. It includes .git directory and all the submodules, so can be used out of the box. This archive is provided for users who have connectivity issues preventing them from cloning from GitHub.

This archive can also be downloaded from Espressif's download server: https://dl.espressif.com/github_assets/espressif/esp-idf/releases/download/v4.4.4/esp-idf-v4.4.4.zip

Major changes

This is the list of changes since release v4.4.3:

Major Bug Fixes

Wi-Fi: Fixed multicast pkts drop issue for some AP when DTIM period > 1

Breaking Changes

Power management: esp_light_sleep_start now returns two error num when sleep fails: ESP_ERR_SLEEP_REJECT and ESP_ERR_SLEEP_TOO_SHORT_SLEEP_DURATION
Wi-Fi: Modified maximum Softap connection number and ESP-NOW encrypted connection number.
esp_flash_encrypt: In API to set flash encryption to release mode, if the target supports it then enable Secure ROM DL mode instead of disabling it completely.

Changelog

Bluetooth

Controller

Changed

Updated phy lib for ESP32-C2, ESP32-C3 and ESP32-S3

Bluetooth Low Energy

Added

Added config to disable scan backoff
Support Bluetooth to release .bss and .data segment memory on ESP32-C3 and ESP32-S3

Changed

Changed BLE default TX power from 3dBm to 9dBm on ESP32-C3 and ESP32-S3
Enabled BLE PLL track to fix bluetooth disconnection caused by temperature rise or fall on ESP32-C3 and ESP32-S3

Fixed

Fixed BLE lld_per_adv.c line 401 assert on ESP32-C3 and ESP32-S3
Fixed BLE ASSERT_PARAM(32 0) in rwble.c at line 384 on ESP32
Fixed llm_scan.c assert at line 1485 during controller deinit if extend duplicate scan is not stopped on ESP32-C3 and ESP32-S3
Fixed BLE array access out of bounds on ESP32-C3 and ESP32-S3
Fixed lld_con.c line 3048 assert on ESP32-C3 and ESP32-S3
Fixed crash sometimes when connected as a slave by 8th device on ESP32-C3 and ESP32-S3

Classic Bluetooth

Fixed

Fixed the issue that Wi-Fi task can be blocked by Bluetooth Controller because of the use of blocking coexistence callback function on ESP32

Bluedroid

Classic Bluetooth

Added

Added API esp_spp_vfs_unregister() to free memory allocated by esp_spp_vfs_register()

Changed

Changed pin_type of Legacy Paring from FIXED to VARIABLE to avoid authentication failure (#10005)
Changed the SR_mode selection when the pager knows nothing about the paged device's SR mode

Fixed

Fixed the unexpected memory free when malloc failed.
Fixed incorrect description in macro BT_CONTROLLER_INIT_CONFIG_DEFAULT()
SPP: Fixed esp_spp_write() crash when len is 0
Fixed the issue Bluetooth Classic connection can not be created while this is a Bluetooth Low Energy connection is in active
HFP: Fixed HFP client parce CLCC command response bug
HID: Fixed HID Host improper handle of freeing resource in esp_hid component
A2DP: Fixed a2dp failing to connect again after disconnected
HID: Fixed HID Device can not remove virtually cabled device without a connection
Fixed memory leak due to not freeing memory if posting a message to a thread fails
SPP: Fixed memory leak when SPP initialization failed
Fixed build errors for HID examples in the condition that Secure Simple Paring is disabled (#10069)

Removed

Removed audio cache in BTC layer of Bluedroid and added flow control for audio data in application layer.

Bluetooth Low Energy

Added

Support bluedroid host maximum number of connections to 9 on ESP32-C3 and ESP32-S3

Changed

Reduced the stack consumption of BTU_TASK, saving 609 bytes

Fixed

Allow bluedroid host to report ADV_IND separately
Configurable max GATTC cache characteristic count
Configurable option to modify max GATT service attributes count
Fixed BLE advertising TX power map
Fix BLE resolvable private address generate and update
Fixed BLE generate RPA for ESP32
Fixed ESP HID crash when authentication failed
Fixed a bug in the linker fragment file that made BSS part, marked by bt_bss_start and bt_bss_end, empty
Fixed ble_compatibility_test example NVS flash init error
Clean up BLE examples sdkconfig.defaults
Fixed sometimes BTU task overflow when doing read and write performance test

NimBLE

Added

Added init deinit of nimble stack in a loop
Support Nimble host maximum number of connections to 9 on ESP32-C3 and ESP32-S3

Changed

Updated check for reattempt connection code

Blufi

Added

Added data subtype for more WiFi information
Example: support to query disconnected information, connecting information
Example: return errcode if fail to scan

ESP-BLE-Mesh

Added

Added an option for initiating IV Index Recovery if missing one

Fixed

Fixed not able to get optional fields from messages with a group address as DST
Fixed not using fast adv interval when PB-GATT and PB-ADV are both enabled

Coexistence

Fixed

Fixed part of modem module not reset when power up

Wi-Fi

Added

Added check for ies in match security.
Added station connect retry count to make it easier to connect to the except AP
Provided RSSI info in disconnected event
Supported WiFi TX fragment in the crypto mode of GCMP.
Added clear ap list interface
Added configuration options for maximum number of ESP-NOW encrypted connections.
Added config option to mandate station authmode threshold to WPA3 if AP sends transition_disable bit.

Changed

Changed wifi scan return value.
Changed the log level of some logs to avoid misunderstanding.
Modified maximum Softap connection number.
Changed the max connection num on ESP32-C3 and ESP32-S3

Fixed

Added security fixes from upstream wpa_supplicant (CVE-2019-9496, CVE-2022-23304, CVE-2022-23303, CVE-2019-9494)
Fixed Wi-Fi getting stuck in Wi-Fi start when working with BT on ESP32-C3 and ESP32-S3
Fixed issue that sniffer mode can not capture control packet
Fixed a few memory leaks in the operation of a station in WPS pin mode, which led to crashes after a few executions of WPS Start with no attempt to connect it to it for the WPS timeout duration.
Fixed WPA2 Enterprise Re-authentication issue
Added changes to prevent security parameters overwritten in full scan
Fixed the bug that station connected to an AP already connected caused subsequent scan fail.
Prevented using WPA3 PMK caching for WPA2 connection.
Fixed high current issue after reconnected
Fixed potential Wi-Fi disconnection when BT deinit.
Cleared scan result info when wifi stop
Fixed connect fail return wrong error code issue.
Fixed WAPI issue on GTK compability and reference to broadcast ARP pkts.
Fixed TX fragment issue that PN code is less than MSDU after PN code add two for TX fragment.
Fixed some issues on Soft-AP power save.
Fixed SoftAP memory leak after wifi init and deinit
Fixed station get AP info does not return connected SSID issue.
Fixed SoftAP disconnection happened even when receive PS-Poll
Fixed SSID copy length during WPS scan
Prevented PMK caching if AP security has changed
Fixed multicast pkts drop issue for some AP when DTIM period > 1.
Added a check to avoid FTM initiator mode in SoftAP interface
Fixed home channel issue in FTM for STA+SoftAP mode
Fixed integer overflow in FTM which caused some invalid test
Clear current pmksa to fix WPA3 connect loop
Added a check to avoid initiator mode in ftm softap
Fixed home channel issue in ftm for apsta mode
Fixed int overflow for T1-T4 counter variable

ESP-WIFI-MESH

Fixed

Fixed memory leak issue when esp_mesh_start/stop
Fixed invalid child issue(#9773)
Fixed WIFI_EVENT_AP_STADISCONNECTED event error

Security

Fixed

esp_flash_encrypt: In API to set flash encryption to release mode, if the target supports it then enable Secure ROM DL mode instead of disabling it completely.

Peripheral Drivers

Added

ESP_LCD: Support register color-transfer-done callback at runtime
I2C_LCD: Added support of rotation for OLED SSD1306 screen
SPI_LCD: Support transmit color buffer without specifying a command (#10302)
MCPWM: BDC control example now supports USB serial jtag console
SPI Flash: Added flash high-performance mode (> 80MHz) support for ESP32-S3
SPI Flash: Added docs for optional features

Changed

esp_lcd: Added esp_lcd_panel_disp_on_off function and it's recommended to replace the esp_lcd_panel_disp_off function
freemodbus: Synced to upstream esp-modbus v1.0.7 via git-subrepo
freemodbus: Updated/removed default Kconfig options for the updated component
freemodbus: Updated docs to describe component usage, make links to component docume...

Assets 3

12 Dec 09:47

github-actions

v4.1.4

9173ec9

ESP-IDF Release v4.1.4

Documentation for IDF v4.1.4 is available at https://docs.espressif.com/projects/esp-idf/en/v4.1.4/

ESP-IDF v4.1.4 is a bugfix update for ESP-IDF v4.1.3.

Obtaining v4.1.4

For full installation instructions, see the ESP-IDF Programming Guide.

The source files attached to this release will not work due to our use of git submodules. Use one of the following methods instead:

Using git

To get this release, use the following commands:

git clone -b v4.1.4 --recursive https://github.com/espressif/esp-idf.git esp-idf-v4.1.4
cd esp-idf-v4.1.4/

This is the recommended way of obtaining v4.1.4 of ESP-IDF.

Download an archive with submodules included

Attached to this release is an esp-idf-v4.1.4.zip archive. It includes .git directory and all the submodules, so can be used out of the box. This archive is provided for users who have connectivity issues preventing them from cloning from GitHub.

This archive can also be downloaded from Espressif's download server:
https://dl.espressif.com/github_assets/espressif/esp-idf/releases/download/v4.1.4/esp-idf-v4.1.4.zip

Major changes

This is the list of changes since release v4.1.3:

Major Bug Fixes

Fixed deadlock due to wrong parameter when calling btc_transfer_context() after calling esp_bluedroid_disable(). (#9672)

Breaking Changes

Station Always connect to AP with PMF mode if possible, added a separate PMF disable API

Changelog

Bluetooth

Controller

Fixed

Fixed that FreeRTOS semaphores and queues used by Bluetooth Controller are created in SPIRAM, which causes software crash when handling ISRs
Fixed missing in processing VHCI interrupt caused by lack of protection against race conditions in accessing VHCI environment variables on ESP32
Fixed the issue that Wi-Fi task can be blocked by Bluetooth Controller because of the use of blocking coexistence callback function on ESP32

Bluetooth Low Energy

Fixed

Fixed BLE ke_mem.c assert on ESP32
Fixed BLE ASSERT_PARAM(32 0) in rwble.c at line 384 on ESP32

Classic Bluetooth

Allow max supported feature page lower than current feature page when handle with the respond of extend features to support for some devices which generate wrongly LMP respond on ESP32
Fixed the EDR mode wrongly cleared by after a successful role switch, which caused that the 2M/3M packet type can not be selected for use
Fixed the issue during legacy pairing procedure that controller does not report link key to Host on ESP32
Fixed the duplicated reports of HCI_Connection_Request event from the same Bluetooth device on ESP32
Fixed the exhaustion of ACL buffer in case of connection-disconnection stress test

Bluedroid

Classic Bluetooth

Added

Added parameter field Bluetooth device address to esp_bt_gap_cb_param_t::read_rmt_name_param. (#9033)

Changed

Updated HFP_HF version to 1.7.2

Fixed

Fixed the linker error of functions not defined when memory debugging functionality is enabled
Resolved type redefinitions in btc_spp.h and btc_hd.h/btc_hh.h
A2DP: Fixed the format error of AVDTP general reject message
A2DP: Fixed in A2DP sink example that audio playback is clogged due to higher priority of application task in case of heavy workload from the task
HFP: Fixed the failure of 'connect audio' operation in HFP examples with default SDK configuration
SPP: Fixed SPP initiator can not free resources when the connection fails
SPP: Fixed SPP crash after calling esp_spp_deinit
SPP: Fixed SPP resource leak due to missing of deleting the mutex upon failure of initialization
A2DP: fixed sink device not being able to accept and decode mono channel audio stream
Fixed the issue Bluetooth Classic connection can not be created while this is a Bluetooth Low Energy connection is in active
Fixed incorrect description in macro BT_CONTROLLER_INIT_CONFIG_DEFAULT()
Fixed the unexpected memory free when malloc failed (#9972)
HFP: Fixed the issue that HFP client makes error in parsing CLCC command response
A2DP: Fixed A2DP failing to connect again after disconnected

Bluetooth Low Energy

Fixed

Allow bluedroid host to report ADV_IND separately
Fixed bluedroid host memory overflow
Fixed calling esp_ble_get_cur_sendable_packets_num() sometimes crashes when bluetooth is disconnecting
Fixed the bug that no event is reported if the same data length is set repeatedly
Fixed second bonding failed issue

NimBLE

Fixed

Corrected stack initialization dependency function checks

ESP-BLE-Mesh

Added

Added an option for initiating IV Index Recovery if missing one
Added an option for filtering packets with old SeqAuth
Added an option for LPN to subscribe all-nodes-address automatically

Fixed

Fixed not checking the oversized SegN during provisioning
Fixed Friend not relay LPN message when relay feature is disabled
Fixed handling continuously received secure update in friend queue
Fixed using wrong range for Heartbeat Publication Period Log value
Fixed using wrong count_log for Heartbeat Subscription Status
Fixed not ignoring connectable PB-ADV PDU containing a Link Open message
Fixed ignoring KR flag within Secure Network Beacon from non-primary subnet
Fixed the sequence of checking invalid Provisioning PDU type
Fixed not using fast adv interval when PB-GATT and PB-ADV are both enabled
Fixed not checking invalid link flag during PB-GATT provisioning
Fixed wrongly overwritten the expect_ack_for flag after send_pub_key
Fixed not checking if AppKey is bound to model during model publication set
Fixed the regression introduced in the btc_transfer_context changes
Fixed not able to get optional fields from messages with a group address as DST

Wi-Fi

Changed

Compile WiFi library with -Os instead of -Og to reduce code size
Station Always connect to AP with PMF mode if possible, added a separate PMF disable API

Fixed

Fixed the bug that Wi-Fi stop stuck when sniffer not disabled
Fixed the bug that QoS null will update BA SSN which may leader packet drop by firmware
Fixed clearing default wifi netif procedure
Fixed station can't reconnect to ap when PMF enabled after deep sleep or reset
Fixed ESP-NOW can receive unencrypted packets from encrypted peer devices
Fixed some AP will ignore authentication after receiving deauthentication for a while
Fixed handling of key RSC
Fixed issue of STA does not connect to AP in mixed mode security if PMF is enabled
Fixed the QoS value of reply packets to peers
Fixed the wrong suggestion of method in NAK for all the methods (#7769)
Fixed write to null pointer if malloc failed
Fixed static analysis issues
Fixed an issue that station connected to an AP already connected caused subsequent scan fail
Fixed the bug that sniffer FCS error packets may cause crash
Fixed TKIP and PMF compability issue
Added changes for unicast key renew for TKIP MIC failure
Do not use pmkid caching when SSID is changed
Ignore unauthenticated encrypted EAPOL-Key data
Multiple bugfixes in SoftAP and Station PMF
Fixed memory leaks in WPS operation
Fixed the bug that stale PMF config in NVS
Fixed the bug that security parameters overwritten in full scan
Fixed unprotected SA Query issue

Peripheral Drivers

Added

SPI Flash: Support unlock for ISSI chips
SPI Flash: Added unlock function patch in bootloader to make GD flash more stable
SPI Flash: Support unlock for MXIC chips

Changed

SPI Flash: Decrease the IRAM usage of SPI Flash driver

Fixed

GPIO: Fixed the issue that config struct is not properly initialized in the example
freemodbus: Fixed slave destroy bug when master and slave init simultaneously
freemodbus: Fixed master and slave use the same timer group index (#4699)
freemodbus: Fixed uart_set_pin() check error in modbus master serial example
I2S: Fixed the issue that I2S DAC has no output (#6470)
SDIO Slave: Fixed crash caused by incorrect return value check in host example
SPI Master: Fixed the error log when using SPI_TRANS_USE_TXDATA or SPI_TRANS_USE_RXDATA with data longer than expected
SPI Slave: Fixed an issue with placing the interrupt handler into IRAM (#3870)
UART: Fixed uart_set_line_inverse cannot disable inverse issue
UART: Fixed RTS mis-reset before sending caused by context switch (#4178)
UART: Fixed unreliable uart_wait_tx_done caused by the wrong handling to legacy UART_INTR_TX_DONE event
SPI Flash: Fixed the issue mmap cannot be called with pointers to psram

Core System

Fixed

Fixed calibration failure on rtc8m clock after CPU/core reset as 8md256 clock is not enabled during calibration
Fixed xtal 32k not oscillate or oscillate too slowly issue for ESP32

FreeRTOS

Fixed

Fixed bug in Xtensa FreeRTOS port where extra threadptr CPU was not being saved on solicited context switches
Fixed bug in event group functions where blocked task list was being accessed without acquiring the task list spinlock

Power Management

Fixed

Fixed problem when idle task neither enters light sleep nor "waiti" state

LWIP

Fixed

Fixed esp_netif_set_dns_info() API to work correctly with IPv6 addresses

Bootloader

Added

Enable write protection to flash at end of bootloader to increase s...

Assets 3

Releases: espressif/esp-idf

ESP-IDF Release v5.1

Obtaining v5.1

Using git

Download an archive with submodules included

Major changes

Major Features

Major Bug Fixes

Breaking Changes

Known Issues

Changelog

802.15.4

OpenThread

ESP-IDF Pre-release v5.1-rc2

Obtaining v5.1-rc2

Using git

Download an archive with submodules included

Major changes

Major Features

Major Bug Fixes

Breaking Changes

Known Issues

Changelog

802.15.4

OpenThread

ESP-IDF Release v4.4.5

Obtaining v4.4.5

Using git

Download an archive with submodules included

Major changes

Major Changes

Major Bugfix

Breaking Changes

Changelog

Bluetooth

Controller

Bluetooth Low Energy

Classic Bluetooth

Bluedroid

Classic Bluetooth

Bluetooth Low Energy

NimBLE

Blufi

ESP-BLE-Mesh

Wi-Fi

ESP-IDF Pre-release v5.1-rc1

Obtaining v5.1-rc1

Using git

Download an archive with submodules included

Major changes

Major Features

Major Bug Fixes

Breaking Changes

Known Issues

Changelog

802.15.4

OpenThread

ESP-IDF Release v5.0.2

Obtaining v5.0.2

Using git

Download an archive with submodules included

Major changes

Breaking Changes

Changelog

Bluetooth

Controller

Bluetooth Low Energy

Bluedroid

Classic Bluetooth

Bluetooth Low Energy

NimBLE

Blufi

ESP-BLE-Mesh

Wi-Fi

ESP-WIFI-MESH

Security

Peripheral Drivers

ESP-IDF Pre-release v5.1-beta1

Obtaining v5.1-beta1

Using git