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-beta1 - esp-idf Release Notes | AnnounceHQ

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

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: Move cJSON from ESP-IDF to managed components (https://github.com/espressif/idf-extra-components/tree/master/cjson) (269acda5)
Application Utilities/Provisioning: disable 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)
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: 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: 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/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)
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: 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: 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/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: Removed deprecated HSPI and VSPI related IOMUX pin macros on ESP32 and ESP32S2 (a4c03ceb)
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/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: 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: Remove usb component from esp-idf (4dc77d19)
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: 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: 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: 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: 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)

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)

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)

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 (0a7ace35)
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 (03855b90)
Upgraded default C++ standard to gnu++26 (03855b90)
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)

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)

Dependent peripheral clock usage optimization 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)
Update mbedTLS version to 3.6.4. (5301d39f)
Adds in support for verifying cross signed certificates if the cross signed certificate is available in the trusted CA bundle. (1f4612ec)
Updated the common cert authorities csv (cmn_crt_authorities.csv - 01 Jun 2025) (c85075dc)
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)
Updated the default root certificate bundle (cacrt_all.pem - 21 May 2025) (e05390f3)
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)
Updated the common cert authorities csv (cmn_crt_authorities.csv - 18 May 2025) (4d59537d)

Added a fix to prevent Windows from unsuccessfully building the ESP-IDF root directory (c4cabac5)
Fixed the idf.py confserver command failing because of small buffer size by increasing the default buffer size and adding the --buffer-size argument to further adjust the value if needed (eff16d49)
Updated to use esptool version v5+ and deprecated .py suffix from the esptool scripts (800f141f)
Removed the esp-idf-size --legacy option. Using --format json is no longer possible and setting the ESP_IDF_SIZE_LEGACY environment variable has no effect. (af1ceb32)
Removed old copy of Catch2 (catch). Catch2 is still available as a ESP-IDF component at ESP component registry. (392226b3)
Supported loading idf.py extensions from the project's component directories and from installed Python packages (34f658a2)
idf_tools.py: Fixed warning message to show correct allowed install options (https://github.com/espressif/esp-idf/pull/17586) (4e4378a7)
Removed the legacy unit-test-app. It can still be found at the Component Registry (ab2829d6)
Fixed click's deprecation warnings (__version__, click.MultiCommand) (117919d7)
Removed the legacy export scripts and setting the ESP_IDF_LEGACY_EXPORT environment variable no longer has any affect (86fc2e11)
Upgraded CMake to versions 4.0.3 and 3.22.1 (for the option of installing it with idf_tools.py instead of using the system-level version) (c43d3111)
The minimal supported CMake version was upgraded from 3.16 to 3.22 (c43d3111)
Python 3.9 has been deprecated and is not supported anymore (138336b9)
Updated the minimal supported Python version to 3.10 (138336b9)
The test_utils component has been moved from tools/unit-test-app/components/ to tools/test_apps/components (4065fb20)
Added requirements file for the new IDE feature of installing Python packages for IDE support (dba8cb3f)
idf_tools.py: Removed legacy virtualenv code because supported Python versions come with the venv module by default (ba08899b)
Normalized detected shell name to lowercase on Windows (https://github.com/espressif/esp-idf/issues/16868) (b1d19082)
Fixed serial port mapping in idf.py qemu if additional serial ports are added using --qemu-extra-args (https://github.com/espressif/esp-idf/pull/15974) (90518119)
Added Base64 encoding for temporary directory names when usernames contain special characters (https://github.com/espressif/esp-idf/issues/16229) (a71bd0d6)
Explicitly disabled pip "user" option when installing the ESP-IDF Python virtual environment (https://github.com/espressif/esp-idf/issues/16189) (fee72560)
Made the port argument mandatory for idf.py eFuse commands (adbec6ed)
Autodetection was removed from idf.py efuse* commands in order to prevent accidental use of the wrong port (adbec6ed)
Added information how to update Python packages in the ESP-IDF environment (https://github.com/espressif/esp-idf/issues/16077) (214f8680)
Passed the serial port from idf.py diag to the the underlying esp-idf-diag package (16e8efa3)
Fixed idf_tools.py install tools@version command to be able to install specific tool versions (8f570513)
Fixed the idf.py create-project command for working with a read-only ESP-IDF directory (https://github.com/espressif/esp-idf/pull/16021, https://github.com/espressif/esp-idf/issues/15964) (1b7cb438)
The official support for gdbgui was dropped but the tool can be invoked via manual installation (5799f556)
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)
Add support for KornShell compatible shells (https://github.com/espressif/esp-idf/issues/16043) (a2b7ce69)
Updated ccache version to 4.11.2 (https://github.com/espressif/idf-installer/issues/305) (f9765d03)
IDF Monitor: Added note about limitation of auto coloring feature with multiline messages (https://github.com/espressif/esp-idf/issues/15793) (4acf13dc)

Added support for NAN-USD (Unsynchronized Service Discovery), which depends on CONFIG_ESP_WIFI_NAN_USD_ENABLE (8e1ebcad)
Supported ESP32-C5 cert test example. (5f5f9638)
Fixed country code PK miss 2.4G permission (b2359412)
Added support for FT with SAE for station (b7deee95)
Added blacklisting logic in ROAM App. (e8f75f97)
Set NVS default value for SAE identifier to NULL (44736c8b)
The function esp_rrm_send_neighbor_rep_request has been removed. Use esp_rrm_send_neighbor_report_request instead. (bdd8d257)
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)
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)
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)
The function esp_wifi_config_espnow_rate has been removed. Use esp_now_set_peer_rate_config instead. (bdd8d257)
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)
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)
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)
The function argument ndp_resp_needed of esp_wifi_nan_publish_service has been moved to structure wifi_nan_publish_cfg_t. (bdd8d257)
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)
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)
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)
Added second channel field in wifi_action_tx_req_t structure. (44a66c75)
Added switch channel API and remain on channel API for ESPNOW (44a66c75)
Fixed perform active scan on DFS channel (9b0733ba)
Fixed beacon timeout when TWT setup (9b0733ba)
Fixed bandwidth check not correct (51ed23be)
improved iperf performance of esp32c61 (51ed23be)
Fixed ESP-Touch v2 fail on 5G router, update version to v3.0.3 (ee064300)
Removed support for the ESP32C61 revision v0.2. (54fe3373)
Added support for the ESP32C61 revision v1.0. (54fe3373)
Fixed assert when htinfo not included in beacon/assoc response (ac5fe121)
Fixed assert when country code of ap we do not support (ac5fe121)
Added supported channels element and enable spectrum management (ac5fe121)
Added limition when set bandwidths and protocols (ac5fe121)
Enabled IPv6 support via LWIP_IPV6 when WiFi Aware(NAN) is enabled (50365096)
Fixed scan trigger failure after roam event (f9317393)

Fixed PTK key memory leak on deinit. (65669733)
Fixed esp32 MAC deinit stuck issue (1d2147cb)
Fixed NAN API return status and NDP Peer inactivity detection (a44c3d44)
Fixed scan done event miss issue (2812a4e7)
Set dialog token of last FTM Response to Zero (https://github.com/espressif/esp-idf/issues/17235) (9fee9cc1)
Performed FTM in 40Mhz in disconnected State (9fee9cc1)
Corrected the 'wifi_auth_mode_t' type sent during 'WIFI_EVENT_STA_CONNECTED' event (e6a11ba8)
Fixed scan done event miss issue. (07db7c3c)
Added GCMP-128 cipher support for SoftAP mode. GCMP-256 SoftAP support was previously added as part of SAE Extended Key handling. (73e638ec)
Fixed TX error 0xa1 (4235058d)
Fixed cache access error after TWT setup (4235058d)
Add FTM Support for ESP32C61. (f50f6913)
Fixed inactive time reset when wifi disconnect (40eefe1d)
Fixed open mode receive fragment packet fail issue. (8448452e)
Fixed TWT cannot sleep on esp32c5 and esp32c61 (48b84ceb)
Fixed CPU cannot enter light sleep when TWT resume (48b84ceb)
Fixed rate index incorrect in 11a mode (48b84ceb)
Fixed the issue that wifi disconnect when sta scan in connected state (9ddef27e)
returned error if call esp_wifi_set_config() when STA is connecting (39a44b4a)
Fixed esp32 mac deinit stuck issue (39a44b4a)
Fixed the issue where the device fails to sleep if it gets disconnected during the transmission of probe requests after beacon timeout. (a3cf6468)
Prevented NON-PMF STA from retrying connection attempts if esp_wifi_disconnect() called before handshake, even if 'failure_retry_cnt' allows retries. (11ad7e05)
Fixed STA cannot send keep alive when receive UDP packets (03e6dda2)
Fixed sleep without sending sleep null when enable BSS max idle (03e6dda2)
Fixed STA BSS max idle period always use default value (03e6dda2)
Fixed channel TX power limitation does not take effect when connected AP switch channel (03e6dda2)
Fixed the issue that STA fail to RX beacon when off channel under modem state. (abd5be52)
Added FTM support for ESP32-C5 v1.0 (https://github.com/espressif/esp-idf/issues/15909) (fbfa32c3)
Fixed the issue when the PS state machine becomes invalid after enabling BSS max idle (f1da7a55)
Fixed TX power not update if country changes when enable multiple PHY init data bin (f1da7a55)
Fixed locking in incorrect state when stop_scan is called after wifi_connect (c4aaceb4)

Obtaining v6.0-beta1

Using git

Download an archive with submodules included

Major changes

Major New Features

Breaking Changes

Known Issues

Changelog

15.4

Thread

Application Utilities

App Update

CJSON

ESP HTTP Client

ESP HTTP Server

ESP HTTPS OTA

ESP HTTPS Server

Provisioning

BLE

BluFi

Bluedroid

Controller

Documentation

Mesh

NimBLE

Bluetooth Common

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

Networking

Examples

PHY

Peripheral Drivers

ADC

Camera

DVP

DAC

DMA

GPIO

GPTimer

H264

I2C

I2C Master

I2S

ISP