Unclaimed project

Are you a maintainer of esp-idf? Claim this project to take control of your public changelog and roadmap.

Changelog

esp-idf

Espressif IoT Development Framework. Official development framework for Espressif SoCs.

ESP-IDF Pre-release v6.0-beta2 - esp-idf Release Notes | AnnounceHQ

git clone -b v6.0-beta2 --recursive https://github.com/espressif/esp-idf.git esp-idf-v6.0-beta2
cd esp-idf-v6.0-beta2/

Legacy drivers of ADC, DAC, I2S, Timer Group, PCNT, MCPWM, RMT, Temperature Sensor peripherals were removed
Application Utilities: The wifi_provisioning component is moved out of ESP-IDF and renamed to network_provisioning into external component https://github.com/espressif/idf-extra-components/tree/master/network_provisioning. The provisioning example and python provisioning tool are also moved to the new component directory. (105a64ab)
Application Utilities/CJSON: Moved cJSON from ESP-IDF to managed components (https://github.com/espressif/idf-extra-components/tree/master/cjson) (269acda5)
Application Utilities/ESP HTTP Client: Updating to mbedTLS 4.x with PSA migration increases the flash footprint. For esp_http_client, the flash impact increases about 37KB (~5.76%). (7da79a65)
Application Utilities/ESP HTTP Server: Updating to mbedTLS 4.x with PSA migration increases the flash footprint. For http_server/simple, the flash impact increases about 41KB (~4.97%). (7da79a65)
Application Utilities/ESP HTTPS OTA: Moved partial-download feature under a newly added config to reduce default flash footprint (b72e5325)
Application Utilities/ESP HTTPS Server: Updating to mbedTLS 4.x with PSA migration increases the flash footprint. For https_server, the flash impact increases about 27KB (~3.08%). (7da79a65)
Application Utilities/Provisioning: Disabled protocomm security version 0 and 1 by default. If required then security 0/1 configs should be explicitly enabled. (f0cc4528)
Application Utilities/Provisioning: Fixed wifi_prov_mgr_deinit api return type and handled error case in wifi_prov_mgr example (b9c22421)
BLE/BluFi: BLUFI protocol version has been updated (BTC_BLUFI_SUB_VER 0x03 → 0x04) and BLUFI security negotiation/crypto is updated. Existing BLUFI client/mobile apps may not interoperate with ESP-IDF v6.0 devices. (7da79a65)
Bootloader: Renamed linker file 'bootloader.ld' to 'bootloader.ld.in'. Custom bootloader build scripts update might be required. (0367cfea)
Bootloader: Removed option for compiling bootloader with no optimization level (-O0, CONFIG_BOOTLOADER_COMPILER_OPTIMIZATION_NONE). For debugging purposes, it is recommended to use the -Og (CONFIG_BOOTLOADER_COMPILER_OPTIMIZATION_DEBUG) optimization level instead. (dea84337)
Build & Config: Changed default libc from Newlib to Picolibc. This may introduce breaking changes in rare cases. Refer to the v6.0 Migration Guide ("System" chapter) for details. (effa1e42)
Build & Config: Default warnings are now considered as errors by default. This can be disabled by setting CONFIG_COMPILER_DISABLE_DEFAULT_ERRORS = y (6efd36f4)
Build & Config: Removed inclusion of <dirent.h> when <sys/dirent.h> is included. Include <dirent.h> for function declarations (0a7ace35)
Build & Config: Upgraded default C standard to gnu23. Code changes may be required to fix new warnings. (03855b90)
Build & Config: Upgraded default C++ standard to gnu++26. Code changes may be required to fix new warnings. (03855b90)
Build & Config: Changed the execution order of non-priority C++ constructors and functions marked with attribute((constructor)) from descending to ascending (44aeff13)
Build & Config The binary generation target gen_signed_project_binary is no longer available as the build system drops the need for this target. (c8f68c72)
Build & Config: The binary generation gen_project_binary is now created during the __idf_build_binary() function invocation by the build system. Components, declaring dependency on this target could have build errors. For post-elf processing, the new idf_build_add_post_elf_dependenciy() must be used. (c8f68c72)
Build & Config: Global Cmake variables presented by the esptool_py viz., ESPTOOLPY, ESPSECUREPY, ESPEFUSEPY and ESPMONITOR are no longer available. These must be accessed via the idf_component_get_property() function. (c8f68c72)
Build & Config: The internal target variable, ${elf} is removed. Custom targets that need to add dependencies on the project elf must fetch the executable by querying the EXECUTABLE build property like idf_build_get_property(elf EXECUTABLE). (c8f68c72)
Build & Config: Components adding target dependencies on the encrypted-flash target unconditionally is not allowed any more. Such dependencies can only be done if CONFIG_SECURE_FLASH_ENCRYPTION_MODE_DEVELOPMENT is enabled. (c8f68c72)
Build & Config: The build process may fail during linking if orphan sections are present. This can be resolved by removing custom section declarations or by explicitly placing orphan sections using linker fragment file. (a319aa90)
Classic Bluetooth/Bluedroid: Deprecate RSSI threshold related macros (7a2e19cc)
Classic Bluetooth/Bluedroid: esp_bt_dev_get_device_name has been deprecated and now it is replaced with esp_bt_gap_get_device_name (7cac735d)
Classic Bluetooth/Bluedroid: esp_bt_dev_set_device_name has been deprecated and now it is replaced with esp_bt_gap_set_device_name (7cac735d)
Classic Bluetooth/Bluedroid: esp_hf_ag_devices_status_indchange has been deprecated and now it is replaced with esp_hf_ag_ciev_report (7cac735d)
Classic Bluetooth/Bluedroid: esp_spp_init has been deprecated and now it is replaced with esp_spp_enhanced_init (7cac735d)
Core System: Removed deprecated STATUS enum from ets_sys.h, use ETS_STATUS instead. (166269fb)
Core System: The header esp_vfs_cdcacm.h has been moved to the new component esp_usb_cdc_rom_console, you will now have to add an explicit REQUIRES for esp_usb_cdc_rom_console if using any functions from this header. (1f0152dd)
Core System: Ring buffer functions are now placed in flash memory by default to save IRAM space. CONFIG_RINGBUF_PLACE_FUNCTIONS_INTO_FLASH Kconfig option has been removed. (11b80a7f)
Core System/ESP Event: Removed unnecessary freertos header includes, if your code relied on this implicit include from esp_event.h then please add the correct explicit includes, freertos/queue.h" and freertos/semphr.h to your files. (cb36cd3a)
Core System/Heap: MALLOC_CAP_EXEC capability only defined when no memory protection is enabled (see https://github.com/espressif/esp-idf/issues/14837) (75305c27)
Core System/Interrupts: Removed deprecated intr_types.h header, update to use esp_intr_types.h instead (365c8a3c)
Core System/Log: The following deprecated APIs have been removed: esp_log_buffer_hex(), esp_log_buffer_char(). (659ae57c)
Core System/Log: The following deprecated headers have been removed: esp_log_internal.h. (659ae57c)
Core System/Newlib: COMPILER_ASSERT_NDEBUG_EVALUATE default value changed to 'n'. Default behavior is now to not evaluate expressions inside assert(X) when NDEBUG is set, which confirms to the C standard. (https://github.com/espressif/esp-idf/issues/2758) (33f92c8f)
Debugging/Apptrace: Removed destination parameter from all apptrace APIs. (8ee473d0)
Debugging/Apptrace: Changed the way apptrace is configured. Applications must implement esp_apptrace_get_init_params to provide app_trace parameters to the components (8ee473d0)
Debugging/Apptrace: Changed SystemView trace data destination configuration. Now it is controlled by the same configuration as the apptrace destination. It will not have its own destination configuration. (8ee473d0)
Debugging/Apptrace: Refactored apptrace UART related menuconfig options. CONFIG_APPTRACE_DEST_UARTx options are removed and CONFIG_APPTRACE_DEST_UART is added to keep the port number. (9f38fa1b)
Debugging/Apptrace: Moved gcov component out of the IDF and is now available in the ESP Component Registry as esp-gcov (5ac81c17)
Debugging/Apptrace: Deprecated ESP_APPTRACE_DEST_TRAX. Now it is replaced with ESP_APPTRACE_DEST_JTAG (fb3e6167)
Debugging/Apptrace: Changed esp_apptrace_down_buffer_config(). Now it requires esp_apptrace_dest_t dest as first parameter for API consistency. (fb3e6167)
Debugging/Apptrace: Removed CONFIG_APPTRACE_PENDING_DATA_SIZE_MAX configuration option. (a0837666)
Debugging/Core Dump: Dropped CRC32 checksum support. Only SHA256 checksum is now used. (521f3e39)
Debugging/Core Dump: Dropped binary format support. Only ELF format is now supported. (521f3e39)
Debugging/Core Dump: Changed function esp_core_dump_partition_and_size_get(). Now it returns ESP_ERR_NOT_FOUND for blank partitions instead of ESP_ERR_INVALID_SIZE (https://github.com/espressif/esp-idf/issues/15153) (521f3e39)
Ethernet: Removed and migrated 3rd party Ethernet drivers outside of ESP-IDF. Add the related driver from component manager to use it. (61aaaf3a)
Ethernet: Removed RMII CLK Kconfig option for esp_eth component, use config structure to set this parameter. (bc421db4)
Ethernet: The esp_eth_phy_802_3_reset_hw API accepts only one parameter and resets the Ethernet PHY with internal timing configuration defined during initialization. (7a35466d)
FreeRTOS: Removed support for the user defined vPortCleanUpTCB() and the associated Kconfig option CONFIG_FREERTOS_ENABLE_STATIC_TASK_CLEAN_UP. (75619d8e)
FreeRTOS: FreeRTOS functions are now placed in flash memory by default to save IRAM space. CONFIG_FREERTOS_PLACE_FUNCTIONS_INTO_FLASH Kconfig option has been removed. (11b80a7f)
FreeRTOS: The compatibility function xQueueGenericReceive() has been removed. Use xQueueReceive(), xQueuePeek(), or xQueueSemaphoreTake() as per your usecase. (3ef41363)
FreeRTOS: The compatibility function vTaskDelayUntil() has been removed. Use the function xTaskDelayUntil() instead. (3ef41363)
FreeRTOS: The compatibility function ulTaskNotifyTake() has been removed. Use the macro ulTaskNotifyTake() instead. (3ef41363)
FreeRTOS: The compatibility function xTaskNotifyWait() has been removed. Use the macro xTaskNotifyWait() instead. (3ef41363)
FreeRTOS: The following deprecated APIs have been removed: xTaskGetAffinity(), xTaskGetIdleTaskHandleForCPU(), xTaskGetCurrentTaskHandleForCPU(). (46160b0f)
LWIP: Deprecated header sntp.h for lwip/app port layer has been removed. Users should include esp_sntp.h. (406c7f3e)
LWIP: Deprecated header ping.h and esp_ping.h for lwip/app port layer has been removed. Users should include ping_sock.h. (406c7f3e)
LWIP/DHCP Server: The LWIP_DHCPS_ADD_DNS macro was removed. Applications must now enable DNS option in DHCP offers with esp_netif_dhcps_option() and configure DNS servers explicitly using esp_netif_set_dns_info(). (57013ba4)
LWIP/ESP Netif Removes option to disable error return in esp netif receive function (3d5c2efb)
LWIP/ESP Netif: Deprecated API esp_netif_next() was removed. Users are suggested to iterate over interfaces using esp_netif_tcpip_exec(), or use esp_netif_find_if(). (ba0b61d9)
MQTT: The esp-mqtt component was moved to component manager. Add espressif/mqtt to dependencies to use it. (98a9e14d)
Peripheral Drivers: Remove FreeRTOS header dependency in peripheral public headers. (5c5d78b6)
Peripheral Drivers: The periph_module_t enum type is refactored into shared_periph_module_t and only the modules that have multiple independent functions are kept. (f348a101)
Peripheral Drivers: Removed unnecessary dependencies for the driver component (22a0f9ae)
Peripheral Drivers: The driver/periph_ctrl.h and driver/rtc_cntl.h header files are removed. Please use esp_private/periph_ctrl.h and esp_private/rtc_ctrl.h instead. (e3190c63)
Peripheral Drivers: The io_loop_back config option is removed for all drivers, different peripheral drivers can still share the same GPIO number without having it. (1fa420ef)
Peripheral Drivers/ADC: Legacy ADC driver and legacy ADC calibration driver have been removed (807cbbf2)
Peripheral Drivers/DAC: The legacy DAC driver is removed. (d4455368)
Peripheral Drivers/DMA: The esp_dma_capable_malloc and esp_dma_capable_calloc functions are removed. The GDMA_ISR_IRAM_SAFE Kconfig option is removed. (3e09d4f2)
Peripheral Drivers/GPIO: Add "rom_" prefix to all GPIO ROM functions in components/esp_rom/esp32xx/include/esp32xx/rom/gpio.h (7f0f043e)
Peripheral Drivers/GPIO: Added the esp_err_t return type to gpio_uninstall_isr_service (https://github.com/espressif/esp-idf/issues/14114) (7f0f043e)
Peripheral Drivers/GPIO: MAX_PAD_GPIO_NUM, MAX_GPIO_NUM, and DIG_IO_HOLD_BIT_SHIFT macros have been removed. (7f0f043e)
Peripheral Drivers/GPIO: Removed gpio_iomux_in, gpio_iomux_out public APIs. Please use gpio_iomux_input, gpio_iomux_output in esp_private/gpio.h if neccessary. (2fb938c7)
Peripheral Drivers/GPTimer: The legacy timer group driver is removed. (3b504812)
Peripheral Drivers/I2C: Legacy I2C driver (driver/i2c.h) is end-of-life and compile warning is added. (bb802914)
Peripheral Drivers/I2C: I2C slave version one driver is removed (456ae964)
Peripheral Drivers/I2C/I2C Master: I2C master transaction now will report ESP_ERR_INVALID_RESPONSE when NACK is detected. (6af87b62)
Peripheral Drivers/I2S: Removed 'i2s_port_t' type and use 'int' type instead. (726a4304)
Peripheral Drivers/I2S: The legacy I2S driver is removed. (e71e7552)
Peripheral Drivers/LCD: Unified color conversion API across RGB and DSI drivers (734e600d)
Peripheral Drivers/LCD: Replaced bits_per_pixel with FourCC-based color format configuration (734e600d)
Peripheral Drivers/LCD: The NT35510 LCD device driver has been moved out of ESP-IDF and is now hosted in the Component Registry. (4589f33c)
Peripheral Drivers/LCD: Dropped the support of the legacy I2C master driver in the esp_lcd component (9cee386a)
Peripheral Drivers/LCD: The GPIO number type in the LCD driver has been changed from int to the more type-safe gpio_num_t. (6ea0fa1a)
Peripheral Drivers/LCD: The color_space and rgb_endian configuration options in the esp_lcd_panel_dev_config_t structure is replaced by the rgb_ele_order member, which sets the RGB element order. (6ea0fa1a)
Peripheral Drivers/LCD/DSI_LCD: Replaced the original use_dma2d flag with a new hook function esp_lcd_dpi_panel_enable_dma2d(). If 2D-DMA is not used, your application binary size can be saved by around 10KB. (88716d04)
Peripheral Drivers/LEDC: Removed LEDC_USE_RTC8M_CLK macro (e94d9cee)
Peripheral Drivers/LEDC: Removed ledc_timer_set API, and LEDC_APB_CLK_HZ, LEDC_REF_CLK_HZ macros (3fdb4731)
Peripheral Drivers/LEDC: esp_driver_gpio no longer is the public required component for esp_driver_ledc (3fdb4731)
Peripheral Drivers/MCPWM: Removed variadic generator APIs mcpwm_generator_set_actions_on_xxx (4e62b0e4)
Peripheral Drivers/MCPWM: The legacy MCPWM driver is removed. (0972e9d2)
Peripheral Drivers/MCPWM: Changed the default MCPWM group clock prescaler to 1 so that we can achieve a higher resolution. (https://github.com/espressif/esp-idf/issues/14815) (904d9526)
Peripheral Drivers/MCPWM: The io_od_mode member in the mcpwm_generator_config_t configuration structure has been removed. (1fa420ef)
Peripheral Drivers/PCNT: The legacy PCNT driver is removed. (81bb6a05)
Peripheral Drivers/RMT: The legacy RMT driver is removed. (9dc9d7de)
Peripheral Drivers/RMT: The io_od_mode member in the rmt_tx_channel_config_t configuration structure has been removed. (1fa420ef)
Peripheral Drivers/SDM: The legacy SDM driver is removed. (d6894a17)
Peripheral Drivers/SD_HOST/SDMMC: Changed public requirement to esp_driver_gpio to private requirement (dfe8ee58)
Peripheral Drivers/SD_HOST/SDMMC: Removed deprecated API esp_vfs_fat_sdmmc_unmount (a4c03ceb)
Peripheral Drivers/SD_HOST/SDMMC: The get_dma_info member in the sdmmc_host_t structure, as well as the sdspi_host_get_dma_info and sdmmc_host_get_dma_info functions, are removed. (3e09d4f2)
Peripheral Drivers/SPI: The SPI master and slave no longer accepts ESP_INTR_FLAG_SHARED as interrupt flag during initialization. (28999c81)
Peripheral Drivers/SPI: Removed deprecated HSPI and VSPI related IOMUX pin macros on ESP32 and ESP32S2 (a4c03ceb)
Peripheral Drivers/SPI Flash: New argument flags is added to esp_flash_os_functions_t::start. Caller and implementer should handle this argument properly. (f409428b)
Peripheral Drivers/SPI Flash: Remove SPI_FLASH_ROM_DRIVER_PATCH option as this is not needed any more (19fef9f5)
Peripheral Drivers/SPI Flash: Removed deprecated enum esp_flash_speed_t (a4c03ceb)
Peripheral Drivers/SPI Flash: Removed deprecated API spi_flash_reset_counters, spi_flash_dump_counters and spi_flash_get_counters (a4c03ceb)
Peripheral Drivers/SPI Flash: Removed deprecated header file esp_spi_flash.h (a4c03ceb)
Peripheral Drivers/TWAI Deprecate the legacy twai driver API (74710439)
Peripheral Drivers/Temperature Sensor: The legacy temperature sensor driver is removed. (f4a45a30)
Peripheral Drivers/Touch Element: The component 'touch_element' in 'esp-idf' is moved to managed component (see https://components.espressif.com/components/espressif/touch_element/versions/1.0.0/readme). (be099ca8)
Peripheral Drivers/Touch Element: Touch Element Library is moved to managed component (https://components.espressif.com/components/espressif/touch_element/versions/1.0.0/readme). (be099ca8)
Peripheral Drivers/Touch Sensor: The dependencies of legacy touch sensor driver are removed from ULP touch driver, now you need to use int instead of touch_pad_t to express the touch channel ID. (30d0eded)
Peripheral Drivers/Touch Sensor: Removed touch_sensor_sample_config_t::bypass_shield_output on ESP32-P4, it is not supported any more. (ac24f96a)
Peripheral Drivers/Touch Sensor: Adjust touch channel number on P4 from 0-13 to 1-14. (c1666c80)
Peripheral Drivers/UART: Removed soc/uart_channel.h. All UART GPIO lookup equivalent macros can be found in soc/uart_pins.h (4fbcab88)
Peripheral Drivers/UART: The esp_rom_uart.h is deprecated and replaced by esp_rom_serial_output.h (ce92b0ab)
Peripheral Drivers/USB: Removed deprecated pin mappings for external USB PHY (1bbf04cb)
Peripheral Drivers/USB/USB Host: Removed usb component from esp-idf (4dc77d19)
Security: Updating to Mbed TLS 4.0 moves ESP-IDF toward PSA-first crypto. Applications relying on legacy Mbed TLS cryptography APIs (many mbedtls_* crypto primitives) may no longer compile or behave the same, because Mbed TLS 4.0 moves cryptography to TF-PSA-Crypto and mostly removes legacy crypto APIs. Migrate application crypto usage to PSA Crypto APIs where possible (and avoid relying on Mbed TLS internals/private headers). (7da79a65)
Security/ESP-TLS: [Security/MbedTLS] After updating to the PSA APIs, there is an additional ~800 bytes of stack usage increase for HTTPS connection. Ensure that the application allocates enough stack memory. (7da79a65)
Security/MbedTLS: With PSA-first behavior, psa_crypto_init() must be called before any cryptographic operation, including indirect ones like parsing keys/certs or starting a TLS handshake. ESP-IDF initializes PSA during system startup, but code that runs earlier than normal startup (very early init, custom startup flows, etc.) must call psa_crypto_init() explicitly. (7da79a65)
Security/MbedTLS: Code using APIs that previously accepted f_rng, p_rng will fail to compile. This includes (at least) X.509 write and cookie/ticket helper APIs. Users must update to new prototypes and rely on PSA RNG (7da79a65)
Security/MbedTLS: TLS/DTLS interoperability with peers requiring DHE key exchange or RSA key exchange (non-forward-secret) is removed in Mbed TLS 4.0. If a server only offers removed suites, ESP-IDF TLS clients will fail to connect (and vice-versa). Ensure servers/clients support modern suites (typically (EC)DHE and TLS 1.3 where available) and update configs accordingly. (7da79a65)
Security/MbedTLS: Certificates/peers using small curves (<250 bits; e.g., secp192r1/secp224r1) are no longer supported in certs/TLS. (7da79a65)
Security/MbedTLS: pk contexts initialised by esp_ecdsa_set_pk_context() must be freed by using esp_ecdsa_free_pk_context() (7da79a65)
Security/MbedTLS: The use_tee_sec_stg_key flag has been removed. ECDSA private key operations using ESP-TEE secure storage can now be performed by just specifying tee_key_id. (ee4be1af)
Security/MbedTLS: Starting from ESP-IDF v5.5, there is a change in how the SHA sub-function APIs, esp_sha_block() and esp_sha_dma(), are used. Previously, these APIs used to set the SHA mode internally, however, in the updated version, you must explicitly set the SHA mode before invoking them. For instance, if you intend to use the SHA-256 algorithm, you must first call esp_sha_set_mode() with the argument SHA2_256. (8d0527d7)
Security/MbedTLS: Starting with ESP-IDF v6.0, all deprecated CA certificates have been removed from the mbedTLS certificate bundle. As a result, any firmware built with ESP-IDF v6.0 may fail to connect to endpoints that rely on these removed certificates. Thus, before upgrading deployed devices to firmware built with v6.0, thoroughly test all connectivity endpoints to ensure compatibility and avoid connection failures. (e05390f3)
Security/NVS Encryption: If Flash encryption is enabled on SoCs with the HMAC peripheral (SOC_HMAC_SUPPORTED) and NVS encryption is also enabled, the HMAC-based scheme will be selected by default instead of the Flash encryption scheme. (649741fa)
Storage/FATFS: Enable dynamically allocated buffers and long filename support by default (734c1725)
Storage/FATFS: Functions esp_vfs_fat_sdmmc_mount and esp_vfs_fat_sdspi_mount now return ESP_ERR_INVALID_ARG if any of the arguments are missing. (94083867)
Storage/VFS: Make FS registration function used by LWIP private (4b919caa)
Storage/VFS: Deprecate old VFS API (4b919caa)
Storage/VFS: Disable TERMIOS support by default (06004072)
Storage/VFS: Removed deprecated UART and UART-JTAG-serial API from vfs component, these APIs can still be found in the respective driver components. (fb79d920)
System Hardware: Changed ESP32P4 REV3 as default option (45fa560e)
System Hardware: For ESP32-C6, the option to use RC32K clock as the RTC slow clock source has been completely removed (RTC_CLK_SRC_USE_DANGEROUS_RC32K_ALLOWED, RTC_CLK_SRC_INT_RC32K) (e94d9cee)
System Hardware: Removed deprecated headers: {IDF_TARGET}/rtc.h and soc_memory_types.h. from esp_hw_support component. These headers are replaced by esp_rtc_time.h and esp_memory_utils.h respectively. (39d22252)
System Hardware/Memory Layout: Removed RTC_ related memory attributes on chips which do not support RTC memory (ba7d2447)
System Hardware/PSRAM: Removed deprecated header file esp_spiram.h (a4c03ceb)
Toolchain: Updated MacOS-x86_64 toolchain minimum OS version from 10.8 to 10.12 (released on September 20, 2016) (0223bfe5)
Tools: Removed old copy of Catch2 (catch). Catch2 is still available as a ESP-IDF component at ESP component registry. (392226b3)
Tools: Removed the legacy unit-test-app. It can still be found at the Component Registry (ab2829d6)
Tools: The minimal supported CMake version was upgraded from 3.16 to 3.22 (c43d3111)
Tools: Updated the minimal supported Python version to 3.10 (138336b9)
Tools: Autodetection was removed from idf.py efuse* commands in order to prevent accidental use of the wrong port (adbec6ed)
Tools: ESP-IDF no longer automates installation of gdbgui. idf.py gdbgui command can still be used, provided that the gdbgui tool is installed manually. (5799f556)
WI-FI: Removed enum values WIFI_BW20 and WIFI_BW_HT40 (3f577994)
WI-FI: esp_wifi_init returns ERROR if wifi already initialized(https://github.com/espressif/esp-idf/issues/13643) (34b0344d)
WI-FI: The function esp_rrm_send_neighbor_rep_request has been removed. Use esp_rrm_send_neighbor_report_request instead. (bdd8d257)
WI-FI: The functions esp_wifi_set_ant_gpio, esp_wifi_get_ant_gpio, esp_wifi_set_ant, and esp_wifi_get_ant have been removed. Please use the equivalent functions from the esp_phy component: esp_phy_set_ant_gpio, esp_phy_get_ant_gpio, esp_phy_set_ant, and esp_phy_get_ant. (bdd8d257)
WI-FI: The authentication modes WIFI_AUTH_WPA3_EXT_PSK and WIFI_AUTH_WPA3_EXT_PSK_MIXED_MODE have been removed. Use WIFI_AUTH_WPA3_PSK instead. (bdd8d257)
WI-FI: In the wifi_event_neighbor_report_t structure, the report field has been removed. Please use the n_report field instead, which is a flexible array member. (bdd8d257)
WI-FI: The function esp_wifi_config_espnow_rate has been removed. Use esp_now_set_peer_rate_config instead. (bdd8d257)
WI-FI: The header file components/esp_wifi/include/esp_interface.h has been removed. The wifi_interface_t enum is now defined in components/esp_wifi/include/esp_wifi_types_generic.h. The enum values (e.g., WIFI_IF_STA, WIFI_IF_AP) are no longer defined based on ESP_IF_WIFI_STA, ESP_IF_WIFI_AP, etc. (bdd8d257)
WI-FI: Field svc_info from structures wifi_nan_publish_cfg_t, wifi_nan_subscribe_cfg_t, wifi_nan_followup_params_t, wifi_event_ndp_indication_t, wifi_event_ndp_confirm_t has been removed. Please use the equivalent fields ssi and ssi_len instead. (bdd8d257)
WI-FI: Field peer_svc_info from structure wifi_event_nan_receive_t has been removed. Please use the equivalent fields ssi and ssi_len instead. (bdd8d257)
WI-FI: The function argument ndp_resp_needed of esp_wifi_nan_publish_service has been moved to structure wifi_nan_publish_cfg_t. (bdd8d257)
WI-FI: Field use_get_report_api from structure wifi_ftm_initiator_cfg_t and field ftm_report_data from structure wifi_event_ftm_report_t has been removed. Please use esp_wifi_ftm_get_report to fetch raw FTM report data instead. (bdd8d257)
WI-FI: The function esp_wifi_wps_start no longer accepts a timeout_ms argument. It should now be called as esp_wifi_wps_start(void). (bdd8d257)
WI-FI: The DPP event callback esp_supp_dpp_event_cb_t and event enum esp_supp_dpp_event_t have been removed. Please use Wi-Fi events directly (e.g., WIFI_EVENT_DPP_URI_READY, WIFI_EVENT_DPP_CFG_RECVD, WIFI_EVENT_DPP_FAILED). The function esp_supp_dpp_init no longer accepts a callback and should be called as esp_supp_dpp_init(void). (bdd8d257)
WI-FI: Added second channel field in wifi_action_tx_req_t structure. (44a66c75)

Added bluedroid Connection Subrating examples (da2e3a3c)
Added bluedroid PAwR (Periodic Advertising with Responses) examples (da2e3a3c)
Added bluedroid Power Control examples (da2e3a3c)
Added bluedroid CTE examples (da2e3a3c)
Reduced bluedroid host bin size (83c48f35)
Fixed bluedroid host get white list size error (83c48f35)
Optimized bluedroid some code (fd333f9f)
Added bluedroid encrypted advertising data examples (385f6673)
Supported bluedroid encrypted advertising data (385f6673)
Supported bluedroid host encryption with mbedTLS (68bef4ff)
Supported bluedroid host encryption with TinyCrypt (68bef4ff)
Fixed the issue that extend advertising might not restart if the connection fails (14c6f738)
Fixed Bluetooth LE incorrect device record count issue (e38d58a7)
Fixed GATT response timeout setting. (e522c42b)
Supported bluedroid host PAwR feature (df80f1d9)
Supported bluedroid host Advertising Coding Selection feature (df80f1d9)
Supported bluedroid host channel sounding feature (df80f1d9)
Supported LE Security Levels Characteristic (df80f1d9)
Fixed a memory leak during deinitialization when the service table was created but not started (7a20f719)
Fixed crash when deinitializing or disabling host during scanning (d822e9bb)
Added an API to set channel map for scanning or initiating. (76b28d82)
Fixed the status setting in the HCI event. (3216dfa3)
Fixed potential out-of-bounds memory access when resolving advertising data (c6923d2a)
Added Bluetooth LE multiple connections examples. (fbea0c64)
Fixed the connection count limit in multi-connection. (fbea0c64)
Adjusted L2CAP round robin msg send strategy. (fbea0c64)
Supported multi-connection optimization vendor HCI command. (fbea0c64)
Set sec_conn only on successful pairing in ble_hid_device_demo to avoid unexpected behavior (a3146c7b)
Fixed issue that caused failure in "BTM_GetSecurityFlags" (a8d3b480)
Fixed incorrect update of resolving_list_avail_size (a8d3b480)
Fixed issue where resolving list was not updated after the oldest device was removed (a8d3b480)
Fixed failure to disconnect when device record is cleared (a8d3b480)
Fixed build failure when some BLE features are disabled (09046275)
Support BLE vendor hci event reporting with corresponding parameters. (85d74cdd)
Support anonymous address type for white list. (a4fcd067)
Fixed extended advertising restart failure during reconnection. (a172dac0)
Fixed BLE SMP state machine inconsistency on disconnection (7d257229)
Fixed null pointer assert in l2c_link_check_send_pkts (f51c769d)
Fixed issue with deleting link key when classic Bluetooth is not used. (c91a8976)
Fixed validation logic for BLE GAP appearance configuration. (617d215f)
Increased maximum attribute value length to 517 to prevent data loss. (617d215f)

Fix the assertion in controller_uart_hci example, caused by Rx size mismatch between that read from ring buffer and that is expected from HCI on ESP32-C3/ESP32-S3 (5a23c962)
Fixed an occasional Interrupt Watchdog Timeout issue in an edge case of Multi-ADV scenario for ESP32-C2. (1c23b86b)
Fixed an occasional disconnection issue caused by 0x3D on ESP32-C6， ESP32-H2，ESP32-C61 and ESP32-C5. (e41ecaab)
Fixed BLE assert lld_con.c 1479 on ESP32-C3 and ESP32-S3. (25814db7)
Add a feature to automatically initiate a data length update using the appropriate parameters when a PHY update or a connection interval update occurs for ESP32-C6 and ESP32-H2. (3e36bc9c)
Fixed an occasional disconnect issue caused by MIC errors on ESP32-C6, ESP32-H2 and ESP32-C5. (3e36bc9c)
Fixed a disconnection issue that occurred when using the Coded PHY to transmit data with a 7.5 ms connection interval and a Tx data length of 251 bytes for ESP32-C5, ESP32-C6, ESP32-C61 and ESP32-H2.. (3e36bc9c)
Changed the maximum number of concurrent connections to 70 on ESP32-H2 (57235cb1)
Fixed crash in btdm_controller_task on ESP32 (876b5eb7)
Fixed scan HCI command timeout issue on ESP32 (876b5eb7)
Added a feature that allows the Controller to continue receiving PDUs in the next connection event instead of entering latency after receiving a data packet on ESP32-C6/C61, ESP32-H2, and ESP32-C5. (d3055517)
Fixed an occasional interrupt watchdog timeout issue when stopping scanning for ESP32-C2. (d3055517)
Supported controller log compression on ESP32-C3 and ESP32-S3. (8b036aae)
Fixed the disconnection issue caused by a MIC error on ESP32-C61. (b65d10f0)
Fixed an occasional interrupt watchdog timeout issue when establishing connection for ESP32-C2. (94d2e8ef)
Fixed an occasional connection timeout issue when utilizing BLE Flash Only feature for ESP32-C2. (94d2e8ef)
Fixed an occasional connection establishment failure issue when utilizing BLE Flash Only feature for ESP32-C2. (94d2e8ef)
Add scheduling priority level configuration when internal scheduling conflicts on ESP32-H2，ESP32-C6 and ESP32-C5. (94d2e8ef)
Fixed occasional memory leaks in multi-connection scenarios on ESP32-H2 and ESP32-C6. (9fe51958)
Fixed an occasional MIC failure issue in Start Encryption procedure for ESP32-C2. (9fe51958)
Fixed occasional disconnection issue when sending Data Length Update too quickly on ESP32-C2. (a3b8073d)
Fixed occasional assertion in scan/connection coexistence scenario on ESP32-C6. (a3b8073d)
Fixed occasional assertion in adv/scan/connection coexistence scenario on ESP32-H2. (a3b8073d)
Supported the PAwR feature on ESP32-C6, ESP32-H2, ESP32-C61 and ESP32-C5. (e31611d6)
Improved security when receiving a connection request PDU with an invalid Access Address on ESP32n request PDU with an invalid Access Address on ESP32 (5540a8c8)
Fixed the issue where RSSI of connection is incorrect when latency is no zero on ESP32. (d26f2804)
Fixed priority setting for BLE events on ESP32. (d26f2804)
Fixed disconnection issue when coexisting with other BLE events on ESP32. (d26f2804)
Fixed crash due to bandwidth full when updating connection params on ESP32. (d26f2804)
Supported multiple connection optimization vendor HCI command on ESP32. (d26f2804)
Fixed BLE assert llc_llcp.c 487 on ESP32-C3 and ESP32-S3. (652fe76d)
Fixed BLE assert sch_prog.c 304 on ESP32-C3 and ESP32-S3. (652fe76d)
Fixed BLE anonymous extended advertising filtering on ESP32-C3 and ESP32-S3. (652fe76d)
Fixed BLE TX issue when the event is aborted on ESP32-C3 and ESP32-S3. (652fe76d)
Optimized check Access Address when receive connection request PDU on ESP32 (63f7d7ea)
Fixed an occasional sync lost issue on ESP32-C6, ESP32-H2 and ESP32-C5. (5b11d5b2)
Fixed an occasional assert issue in case of controller disable on ESP32-C2. (5b11d5b2)
Fixed an occasional assertion issue during sync on ESP32-C6, ESP32-H2 and ESP32-C5. (dad2c533)
Fixed occasional disconnection issue when sending Data Length Update too quickly on ESP32-C6, ESP32-H2 and ESP32-C5. (dad2c533)
Fixed double free exception during BLE init under low memory on ESP32-C3/S3 (f1dd6da8)
Fixed an APM panic issue when enabling TEE in the BLE scenario on ESP32-C6, ESP32-H2 and ESP32-C5. (71da5481)
Fixed an occasional abnormal scanning stop issue on ESP32-C6, ESP32-H2 and ESP32-C5. (71da5481)
Fixed an issue where the central role would disconnect abnormally when the peripheral did not support the Connection Parameters Request Procedure on ESP32-C6, ESP32-H2 and ESP32-C5. (71da5481)
Fixed an occasional assertion issue during scanning on ESP32-C6. (71da5481)
Reduced bin size and IRAM for BLE rom code on ESP32-C3 and ESP32-S3 (6897f906)
Fixed missing ADV reports after bonding and connection on ESP32-C3 and ESP32-S3 (https://github.com/espressif/esp-idf/issues/15789) (e178a09d)
Fixed an occasional assertion issue in scan and connection scenarios on ESP32-C6. (b452748e)
Supported creating connections during scanning process on ESP32-C6 and ESP32-H2. (b452748e)
Fixed occasional packet loss issue in multi-connection scenarios on ESP32-C6. (b452748e)
Fixed crash issue caused by using os_mbuf_dup on ESP32-C6 and ESP32-H2. (b452748e)

Add support for static passkey (e3ed88fe)
Fix tinycrypt related compilation issue (256f00fc)
Fixed PAwR Subevent Data Set error when data length set too large (07dc868b)
Handle sync cancel during reattempt operations (125dc7d1)
Added a check for periodic psync before processing (8e7ada52)
Fix compilation issues across different NimBLE examples (8e7ada52)
Support runtime memory alloc for mempool. (8e7ada52)
Fix typos in NimBLE examples (https://github.com/espressif/esp-idf/pull/17824) (c3f6d236)
Add Read all local / remote supported feature HCI command /event. (95b97dec)
Improve debugging by adding more logs and thread diagnostic tools. (6abb3981)
Fix array overflow caused by invalid connection handle indexing (7ae7dcd1)
Added support for Channel Sounding host functionality. (03dd5e31)
Use nimble platform mem malloc / free APIs (7c1700b0)
Added support to consider mbuf of different size during copying (448b5c08)
Update HCI log functions to use uint16_t for data length (f8935f87)
Rearrange NimBLE menuconfig options (7a876031)
Handled adv ext data setting in reattempt adv (9ba0b373)
Add indicate / notification code under correct flags [ Closes https://github.com/espressif/esp-idf/issues/16769 ] (b7226154)
Fixed incorrect HCI status in connect event (d84d8ab1)
Updated reattempt count handling for periodic adv (d1b3fd17)
Restructured table of README.md file of bleprph and blecent (7ef32150)
Add connection failure event when connection fails (4dd26947)
Added helper api's in nimble. (a3808c92)
ISO minor support for NimBLE Host (74bb9f65)
Update ble_gatts_show_local to show CPFDs and CAFDs. (92c125d1)
Fix include service definition handle being the same for all definitions. (92c125d1)
Added VSC for Set Scan Channel Bitmap (4f84ba0a)
Fix for attribute count mismatch between cached gatt db and actual db (6fbc17c9)
Update count parameter correctly by considering offset. (6fbc17c9)
Fixed compilation issue due to BLE_GATTS flag (aa1c21fa)
Clear GATT service entries counter upon GATT deinit (d1ea4520)
Add timestamp information to HCI logging. (635169fd)
Provide a way to make blufi advertising customizable. [ https://github.com/espressif/esp-idf/issues/16234 ] (2a1a76d6)
Add ble_ancs example to build-test-rules configuration file. (f03521b4)
Fix compilation issues when gatt caching is enabled in peripheral only mode (dffb03f0)
Add a missing instance of ble_hs_unlock() in a corner case. (90b88aff)
Added parameter in peer_init() to allocate memory for included services (304b561f)
Automatically initiate security and retry service request if service request fails due to insufficient security. (06995076)
Added option to require Encryption, Authentication, or Authorization to subscribe for Notifications or Indications. (06995076)
Wrap BLE service API with extern "C" (5beacd1a)
Fix compilation issue when CSFCS is set to 0. (5beacd1a)
fix(nimble): Fixed issue of Adv report not observed in PAwR example. (beb6d79f)
Added sdkconfig with options to showcase DRAM reduction for NimBLE examples. (52a6290c)
Handle memory leak due to missing mempool_deinit call (adcbdd7d)
Add Support for Apple Notification Center Service (ANCS) in NimBLE (2209a6c0)
Add chip dependancy flag for Flow control feature (ebd4caf3)
Added new Gattc + Gatts BLE coex example for nimble ( https://github.com/espressif/esp-idf/issues/12755) (925b5632)
Fixed incorrect comparison with gattc proc that can cause request-response mismatches (644e38fb)
Provide support for anonymous address type for whitelist (01520e84)
Added a configurable option to select ext adv v2 command (01520e84)
Added fix for an async race condition with HCI outstanding packets counter (01520e84)
Fixed UUID type error in GATT caching API to search for included services. (c9bab9e0)
Added api's to fetch gatt cache info (764d722b)

Added the source of the component into the project_description.json (2dc0f49c)
Changed default libc from Newlib to Picolibc. This may introduce breaking changes in rare cases. Refer to the v6.0 Migration Guide ("System" chapter) for details. (effa1e42)
Configuration related log information is aggregated into a configuration report which is printed every time configuration is re-built (2da93073)
The config-report build system target was added for producing a configuration report in JSON format (2da93073)
Fixed idf.py encrypted-flash to flash all the binaries (Bootloader, Partition Table and ESP-TEE) similar to idf.py flash (5ddfb043)
Added a technical preview of a new CMake-based build system (36d76182)
Updated the multi_config example to demonstrate usage of configuration presets (0c8566f2)
Added support for changing the destination of the generated sdkconfig file via CMake configuration presets (https://developer.espressif.com/blog/2025/12/cmake_presets/) (0c8566f2)
Fixed syntax errors in generated Graphviz dependency graphs by wrapping Node ID strings in double quotes (https://github.com/espressif/esp-idf/pull/17594) (d816c3fb)
Deprecated options are now correctly evaluated in linker fragment files (78329850)
Added zc* extensions build options for ESP32P4 (rev >= 3.0) (e0b69349)
Fixed build error for esp_ds peripheral with clang O2 optimisation (https://github.com/espressif/esp-idf/pull/17582) (5cf6b6d3)
Default warnings are now considered as errors by default. This can be disabled by setting CONFIG_COMPILER_DISABLE_DEFAULT_ERRORS = y (6efd36f4)
Added zc* extensions build options for ESP32C5, ESP32C61 and ESP32H4 (22cae61e)
Added COMPILER_CXX_GLIBCXX_CONSTEXPR choice option to reduce C++ applications binary size (https://github.com/espressif/crosstool-NG/issues/67) (f3dba4f7)
Produced Cmake warnings if a component includes or builds from another component (746acf46)
Changed name of component newlib to esp_libc (0d101580)
Removed inclusion of <dirent.h> when <sys/dirent.h> is included. Include <dirent.h> for function declarations (0a7ace35)
Added -mtune=esp-base option for RISC-V targets to improve size and performance for memcpy inlining (620d1cb5)
Created build system hooks for post-ELF file processing (https://github.com/espressif/esp-idf/issues/17251) (5eb8e746)
Fixed evaluation of dependencies based on Kconfig options in idf_component.yml files (b111672f)
Fixed an issue where optional Kconfig dependencies were not evaluated correctly unless idf.py reconfigure was run twice (de098b9a)
Reduced binary size for size-optimized xtensa builds by adding -mno-target-align compile option (https://github.com/espressif/esp-idf/pull/15677) (c433a763)
Enabled LIBC_OPTIMIZED_MISALIGNED_ACCESS by default (177dee61)
Upgraded default C standard to gnu23. Code changes may be required to fix new warnings. (03855b90)
Upgraded default C++ standard to gnu++26. Code changes may be required to fix new warnings. (03855b90)
Changed add_prebuilt_library function to create GLOBAL targets (a939f410)
Fixed the issue that linker fragments couldn't specify placements of symbols from prebuilt libraries (a939f410)
Switched to using __libc_init_array() instead of non-standard init_array() (44aeff13)
Changed the execution order of non-priority C++ constructors and functions marked with attribute((constructor)) from descending to ascending (44aeff13)
Added .preinit_array section to ELF to support C++ and sanitizer features (44aeff13)
The binary generation target gen_signed_project_binary is no longer available as the build system drops the need for this target. (c8f68c72)
The binary generation gen_project_binary is now created during the __idf_build_binary() function invocation by the build system. Components, declaring dependency on this target could have build errors. For post-elf processing, the new idf_build_add_post_elf_dependenciy() must be used. (c8f68c72)
Global Cmake variables presented by the esptool_py viz., ESPTOOLPY, ESPSECUREPY, ESPEFUSEPY and ESPMONITOR are no longer available. These must be accessed via the idf_component_get_property() function. (c8f68c72)
Updated esptool_py component to be an idempotent component in the build (c8f68c72)
The internal target variable, ${elf} is removed. Custom targets that need to add dependencies on the project elf must fetch the executable by querying the EXECUTABLE build property like idf_build_get_property(elf EXECUTABLE). (c8f68c72)
Components adding target dependencies on the encrypted-flash target unconditionally is not allowed any more. Such dependencies can only be done if CONFIG_SECURE_FLASH_ENCRYPTION_MODE_DEVELOPMENT is enabled. (c8f68c72)
Changed default linker orphan section handling from warning to error (a319aa90)
The build process may fail during linking if orphan sections are present. This can be resolved by removing custom section declarations or by explicitly placing orphan sections using linker fragment file. (a319aa90)
Added support for conditional dependencies in idf_component.yml which depend on Kconfig option values (efcb8a5a)
Misspelled Kconfig[.projbuild] files are now detected by the build system (https://github.com/espressif/esp-idf-kconfig/issues/14) (47d20da4)

Deprecate RSSI threshold related macros (7a2e19cc)
Fixed failure of buffer allocation in L2CAP throughput test by optimizing L2CAP memory footprint (d267cc71)
Fix bluetooth L2CAP data transmission stops after a failed write (d267cc71)
Fix index boundary check and function return values during A2DP SEP registration (e31ef6f8)
Add missing setting of A2DP sink delay for AVRCP cover art and absolute volume examples (8ff88e24)
Backported several security-related fixes to from Google Fluoride to esp-idf Bluedroid (7950fdde)
Split A2DP sink example to several simpler examples to demonstrate A2DP/AVRCP functions of different aspects (2829b78b)
Fixed missing NULL pointer check in l2c_fcr_clone_buf in Bluedroid (27f9cd6e)
Allows downgrading AVRCP version to 1.5 by disabling the Cover Art feature (bc646511)
Fixed crash caused by performing A2DP deinitialization when initating an A2DP connection (b4a0b89b)
Fix the status judgment in registration of A2DP source stream end point (0287fe90)
Added an API to create SPP server with a parameter that selects whether to create a corresponding SDP service record (99983a56)
Fixed potential stack buffer overflow in the processing SDP response in Bluedroid (70b12237)
Fixed memory leak in HID host and HID device (d3f6357c)
Update the class of device before enabling inquiry scan to make it effective in inquiry scan response (bd7cbe71)
Fixed potential buffer overflow in the composition of AVRCP vendor dependent command in Bluedroid (f95a5f52)
Fixed the issue that HFP AG not report audio data to application when using external codec (b9223522)
fix(bt/bluedroid): Fix the boundary conditions when checking EIR data (3e0545f2)
Removed the code relying on compiler-specific extension for FAM in union (bdda8300)
Fixed potential buffer overflow vulnerability in Bluedroid (bf695d08)
esp_bt_dev_get_device_name has been deprecated and now it is replaced with esp_bt_gap_get_device_name (7cac735d)
esp_bt_dev_set_device_name has been deprecated and now it is replaced with esp_bt_gap_set_device_name (7cac735d)
esp_hf_ag_devices_status_indchange has been deprecated and now it is replaced with esp_hf_ag_ciev_report (7cac735d)
esp_spp_init has been deprecated and now it is replaced with esp_spp_enhanced_init (7cac735d)
fix(bt/bluedroid): Prevent out-of-bounds access and add type check when resolving EIR data (892ec6a1)
Fixed a description error in the classic Bluetooth GAP header file (19796461)
Added record_handle parameter in ESP_SDP_REMOVE_RECORD_COMP_EVT (706b7c86)
Fixed AVRCP build issue when Cover Art feature is disabled (https://github.com/espressif/esp-idf/issues/16155) (4e8ad766)
Fixed HFP AG data callback gets mistakenly cleared after profile re-initialization, if Bluedroid dynamic memory allocation is enabled (cca744cd)
Added AVRCP callback event for notification of profile ON/OFF state (61771152)
Fixed the issue where an incorrect mask was used to exclude SCO packets during the establishment of eSCO link (fb6693c7)

Removed the exe flag from PSRAM memory for ESP32. ESP32 is not capable of running code from PSRAM. This is a link-time check, and actual CPU RWX permissions are controlled seperately so this has no practical implications, but it could mistakenly be remarked upon during security scansor checks by customers. (bffd1ac2)
The component esp_vfs_console has been renamed esp_stdio and will henceforth be responsible for all stdio related functionality. (19e09974)
Fixed "defalut" typos in esp_rom function names (https://github.com/espressif/esp-idf/issues/17668) (86b39c63)
Added functionality to reset a ringbuffer (https://github.com/espressif/esp-idf/pull/17524) (4c589d62)
Fixed an issue where the ESP32-P4 chip could encounter exceptions or hang when exiting the WFI (Wait For Interrupt) state. (3124e047)
Removed deprecated STATUS enum from ets_sys.h, use ETS_STATUS instead. (166269fb)
The header esp_vfs_cdcacm.h has been moved to the new component esp_usb_cdc_rom_console, you will now have to add an explicit REQUIRES for esp_usb_cdc_rom_console if using any functions from this header. (1f0152dd)
Added a Kconfig option CONFIG_RINGBUF_IN_IRAM to allow placement of esp_ringbuf functions in IRAM. Ring buffer functions are now placed in flash memory by default. (11b80a7f)
Ring buffer functions are now placed in flash memory by default to save IRAM space. CONFIG_RINGBUF_PLACE_FUNCTIONS_INTO_FLASH Kconfig option has been removed. (11b80a7f)
Added Kconfig options for placing system-related APIs into flash when using CONFIG_SPI_FLASH_AUTO_SUSPEND (ff53d5d3)
Added xt_specreg.h with Xtensa special register definitions with the XT_REG_ prefix and deprecated specreg.h (https://github.com/espressif/esp-idf/pull/16040, https://github.com/espressif/esp-idf/issues/12723) (7023f5bf)
Fixed esp_ptr_executable and esp_ptr_byte_accessible to consider TCM memory (https://github.com/espressif/esp-idf/pull/15998, https://github.com/espressif/esp-idf/issues/15996) (fd9b2fab)
fix an issue that prevented RTC reserved area to have a size multiple of 4 (https://github.com/espressif/esp-idf/issues/13082) (1e516f0f)

Fixed power leakage in the LP peripheral power domain during Light Sleep when the HP peripheral domain remained powered on esp32c6. (aea8fa8c)
Fixed a rare issue where ESP32-C6 could permanently hang on wake-up when Wi-Fi Power Save was enabled and the HP peripheral domain remained powered during light sleep. (aea8fa8c)
Optimized active power consumption of ESP32P4 rev3 chips in single-core mode. (3584d227)
Fixed HP LDO leakage during Lightsleep and optimized power consumption of ESP32P4 Lightsleep. (86d09a29)
Fixed an issue where the system would stop responding to interrupts after sleep was rejected in ESP32P4 PD_TOP lightsleep. (86d09a29)
Fixed an issue where the xtal32k was powered down during sleep when used as the slow clock source on ESP32C5 with Wi-Fi disabled. (e1b60067)
Supported lightsleep to power down the CPU power domain separately on ESP32P4 rev2.0. (dfeae969)
Fixed the issue where RTC_BOD may reset or get stuck when waking up from Deepsleep on ESP32P4. (7bd0eeff)
Removed the support for switching power from DCDC to LDO during ESP32P4 lightsleep. (7bd0eeff)
Fixed the approach for writing to reject enable registers to achieve the reject light or deep sleep feartures. (https://github.com/espressif/esp-idf/issues/16738](https://github.com/espressif/esp-idf/issues/16738) (28c4172a)
Revised the description of ESP32 reject sources: only GPIO and SDIO are valid as reject sources. (28c4172a)
Added USB-Serial-JTAG console usage warnings to sleep examples (https://github.com/espressif/esp-idf/issues/16129) (d85ad74c)
Fixed the issue where the sleep wakeup failed after reset when RTC_CLK_SRC_INT_8MD256 is enabled on esp32/esp32c2/esp32c3/esp32s3. (https://github.com/espressif/esp-idf/issues/16243) (feb1dc97)
Fixed the issue where entering mac_pd lightsleep may get stuck when Wi-Fi/BT coexist on ESP32C5. (e71760b7)
Added explicit handling for ESP_PD_OPTION_AUTO, allowing direct mode switching and reference count reset. (e6dfb603)
Warning instead of assert when disable a disabled power domain using esp_sleep_pd_config (https://github.com/espressif/esp-idf/issues/16872) (e6dfb603)
Fixed the problem that the modem would work abnormally after waking up from light sleep if ADC is initialized on esp32c6/esp32h2. (f1df2f3b)
Fixed a possible wakeup failure on esp32 if lightsleep/deepsleep was requested by Core1. (https://github.com/espressif/esp-idf/issues/16243) (dd980b73)
Added esp_sleep_get_wakeup_causes() to support multiple wakeup sources and deprecate esp_sleep_get_wakeup_cause() (60d9ca99)
Support user configurable low power analog mode by esp_sleep_enable_lowpower_analog_mode if analog-related peripherals(ADC,TSENS,TOUCH) is not used in monitor mode (https://github.com/espressif/esp-idf/issues/7882) (bac996a7)
Fixed esp_sleep_get_ext1_wakeup_status always return 0 on esp32p4. (a2257490)
Improved esp_timer timing accuracy for esp32 and esp32s2 when esp_pm DFS is enabled. (a42929a7)
Fixed the issue that esp32p4 may get stuck when entering deepsleep. (8931a8a7)
Fixed deepsleep leakage after USB HS phy is initialized on esp32p4 (d5441e65)

Improve new driver transmits API description (https://github.com/espressif/esp-idf/issues/17883) (30e864c1)
Supports get free queue size and improve logs and API docs (https://github.com/espressif/esp-idf/pull/17888)(https://github.com/espressif/esp-idf/issues/17884)(https://github.com/espressif/esp-idf/issues/17882) (30e864c1)
Removed the errata config option and apply workaround automatically (9245d8ee)
Deprecate the legacy twai driver API (74710439)
Fixed ESP32C5 can't receive frame in listen_only mode when multiple node on bus (https://github.com/espressif/esp-idf/issues/17461) (e8ec9546)
Fixed [tx|rx]_error_count empty from twai_node_get_info (https://github.com/espressif/esp-idf/issues/17434) (e8ec9546)
Fixed using twai_make_dual_filter() to config dual filter for 29-bits ext_id (https://github.com/espressif/esp-idf/issues/17504) (e8ec9546)
More accurate the sample_point calculation when using twai_timing_basic_config_t::sp_permill (https://github.com/espressif/esp-idf/issues/17522) (e8ec9546)
Fixed the issue that legacy twai driver can't send frame with dlc equals to zero (https://github.com/espressif/esp-idf/issues/17467) (fecbfdc8)
Added a new TWAI example to drive XiaoMi "CyberGear" servo with a console CLI. (c6d7d5d4)
Removed unsupported busoff and clkout signals on ESP32-C5 (6fdaf37e)
Added support for calling twai_node_transmit() from ISR contexts, enabling real-time CAN frame transmission from interrupt handlers with automatic context detection and ISR-safe queue operations. (5c97f962)
Fixed DLC larger than 255 in received frame from twai_node_receive_from_isr (4e5401ec)
Added API twai_node_transmit_wait_all_done() (54a9c2e1)
Improve the quanta_resolution_hz formula of twai_timing_config_t (https://github.com/espressif/esp-idf/pull/17002, https://github.com/espressif/esp-idf/issues/16996) (f5e9a24c)
Update twai examples with new driver API and simplified them (https://github.com/espressif/esp-idf/issues/8461) (675fe2d4)
Fixed build warnings in the cxx environment (https://github.com/espressif/esp-idf/issues/16999) (7d1e974f)

Update mbedTLS to v4.0.0 (7da79a65)
With PSA-first behavior, psa_crypto_init() must be called before any cryptographic operation, including indirect ones like parsing keys/certs or starting a TLS handshake. ESP-IDF initializes PSA during system startup, but code that runs earlier than normal startup (very early init, custom startup flows, etc.) must call psa_crypto_init() explicitly. (7da79a65)
Code using APIs that previously accepted f_rng, p_rng will fail to compile. This includes (at least) X.509 write and cookie/ticket helper APIs. Users must update to new prototypes and rely on PSA RNG (7da79a65)
TLS/DTLS interoperability with peers requiring DHE key exchange or RSA key exchange (non-forward-secret) is removed in Mbed TLS 4.0. If a server only offers removed suites, ESP-IDF TLS clients will fail to connect (and vice-versa). Ensure servers/clients support modern suites (typically (EC)DHE and TLS 1.3 where available) and update configs accordingly. (7da79a65)
Certificates/peers using small curves (<250 bits; e.g., secp192r1/secp224r1) are no longer supported in certs/TLS. (7da79a65)
pk contexts initialised by esp_ecdsa_set_pk_context() must be freed by using esp_ecdsa_free_pk_context() (7da79a65)
The use_tee_sec_stg_key flag has been removed. ECDSA private key operations using ESP-TEE secure storage can now be performed by just specifying tee_key_id. (ee4be1af)
Fixed alignment requirements when hardware AES and SHA operations access encrypted PSRAM buffers (145de947)
Updated mbedTLS version to 3.6.5 (b32cd28a)
Optimized dependent peripheral clock usage for the ESP32-H2's revision v1.2 whose ECDSA peripheral does not use the MPI peripheral. (286f7fe0)
This release restructures the mbedTLS configuration system and adds support for configuration presets. (4e036983)
Fix build failure when using non-AES ciphers GCM operation fallback with CONFIG_MBEDTLS_GCM_C being disabled. (d8a3ef51)
Adds in support for verifying cross signed certificates if the cross signed certificate is available in the trusted CA bundle. (1f4612ec)
When using the esp_sha_block() and esp_sha_dma() APIs, the SHA mode needs to be explicitly set using the esp_sha_set_mode() API. (8d0527d7)
Starting from ESP-IDF v5.5, there is a change in how the SHA sub-function APIs, esp_sha_block() and esp_sha_dma(), are used. Previously, these APIs used to set the SHA mode internally, however, in the updated version, you must explicitly set the SHA mode before invoking them. For instance, if you intend to use the SHA-256 algorithm, you must first call esp_sha_set_mode() with the argument SHA2_256. (8d0527d7)
Starting with ESP-IDF v6.0, all deprecated CA certificates have been removed from the mbedTLS certificate bundle. As a result, any firmware built with ESP-IDF v6.0 may fail to connect to endpoints that rely on these removed certificates. Thus, before upgrading deployed devices to firmware built with v6.0, thoroughly test all connectivity endpoints to ensure compatibility and avoid connection failures. (e05390f3)
Updated the deprecated root certificate bundle (cacrt_deprecated.pem - 21 May 2025) (e05390f3)
Fixes failing TLS handshake when running HTTPS Server with TLS1.3 (https://github.com/espressif/esp-idf/issues/15984) (619996f7)

Obtaining v6.0-beta2

Using git

Download an archive with submodules included

Major changes

Major New Features

Breaking Changes

Known Issues

Changelog

15.4

MAC

Thread

Application Utilities

App Update

CJSON

ESP HTTP Client

ESP HTTP Server

ESP HTTPS OTA

ESP HTTPS Server

Protocomm

Provisioning

BLE

BluFi

Bluedroid

Controller

Documentation

Mesh

NimBLE

Power Management

Bluetooth Common

Bluedroid

Controller

Bootloader

Build & Config

Classic Bluetooth

Bluedroid

Controller

Coexistence

Core System

Console

ESP Event

ESP Timer

Heap

IPC

Interrupts

Log

Newlib

Panic handling

Partition Table

Pthread

Watchdogs

Debugging

Apptrace

Core Dump

GDB Stub

Documentation

Ethernet

Examples

FreeRTOS

IDF Additions

LWIP

DHCP

DHCP Server

ESP Netif

IPv6

Low Power Features

ULP

LP Core

ULP-RISC-V

MQTT

Networking

Examples

PHY

Peripheral Drivers

ADC

oneshot

Camera

DVP

DAC

DMA

GDMA