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

ESP-IDF v6.1-beta1 is a minor update for ESP-IDF v6.0. Release v6.1 is mostly compatible with apps written for ESP-IDF v6.0. Release v6.0.2 is the latest stable release at the time of writing.

We highly recommend referring to our migration guide while moving your apps from ESP-IDF v6.0 to v6.1 release.

Obtaining v6.1-beta1

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

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

Using git

To get this release, use the following commands:

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

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

Download an archive with submodules included

Attached to this release is an esp-idf-v6.1-beta1.zip archive. It includes .git directory and all the submodules, so can be used out of the box. This archive is provided for users who have connectivity issues preventing them from cloning from GitHub. To reduce the size of the archive, the .git directory doesn't include the history of commits older than one year. Users who need to use git checkout to access an older release of IDF will have to use git fetch first to download the remaining part of the history.

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

Major changes

Major New Features

• Added preview support for ESP32-S31, please help refer to ESP32-S31 support status for details
• System Hardware/PSRAM: Introduced CONFIG_SPIRAM_ENC_EXEMPT to enable the carving of a designated unencrypted PSRAM region, which is accessible through the new MALLOC_CAP_SPIRAM_NO_ENC to avoid encryption related alignment considerations (4811388)
• Wi-Fi: Added support for OWE-Only in SoftAP mode (f7a5ef7)
• Wi-Fi: Added support for DPP multi-configuration for the station (0b0c85c)
• Wi-Fi: Added support for privacy extension mechanisms for STA (6544496)
• Power Management: Added support for runtime attachment and detachment of sleep retention modules (d7a2e15)

Major Bugfix

• JPEG Decoder: Improved the jpeg_decoder by adding strict checks to prevent potential bad picture attacks. (GHSA-v6r2-f6p2-88cj) (9c6bc38)

Breaking Changes

• MQTT: The esp-mqtt component was moved to component manager. Add espressif/mqtt to dependencies to use it. (1da9860)
• Peripheral Drivers: Remove FreeRTOS header dependency in peripheral public headers. (986481f)
• Peripheral Drivers/GPIO: Rename gpio_deep_sleep_wakeup_enable/disable to gpio_wakeup_enable/disable_on_hp_periph_powerdown_sleep (1373011)
• Peripheral Drivers/GPIO: Add "rom_" prefix to all GPIO ROM functions in components/esp_rom/esp32xx/include/esp32xx/rom/gpio.h (5b97ebd)
• Peripheral Drivers/GPIO: MAX_PAD_GPIO_NUM, MAX_GPIO_NUM, and DIG_IO_HOLD_BIT_SHIFT macros have been removed. (5b97ebd)
• Peripheral Drivers/LCD: Unified color conversion API across RGB and DSI drivers (6b9427a)
• Peripheral Drivers/LCD: Replaced bits_per_pixel with FourCC-based color format configuration (6b9427a)
• 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. (b385b6e)
• Peripheral Drivers/SPI: The SPI master and slave no longer accepts ESP_INTR_FLAG_SHARED as interrupt flag during initialization. (70a0fb5)
• Peripheral Drivers/SPI Flash: New argument flags is added to esp_flash_os_functions_t::start. Caller and implementer should handle this argument properly. (32c31f6)
• Peripheral Drivers/SPI Flash: Changed the include path of headers to reflect their visibility. The #include statements of headers for customizing flash drivers and private use need to be updated. (5984b29)
• Peripheral Drivers/SPI Flash: Structures esp_flash_t and esp_flash_os_functions_t are moved to private headers. Users should call APIs instead of using the members directly. (5984b29)
• Peripheral Drivers/UART: Removed soc/uart_channel.h. All UART GPIO lookup equivalent macros can be found in soc/uart_pins.h (b5aae9a)
• Security/MbedTLS: Fixed the PSA persistent storage format for PSA ECDSA and HMAC opaque keys to use flat, serialization-safe storage structs, thus, PSA persistent opaque keys stored by prior ESP-IDF versions must be re-imported. (8f7984d)
• Security/Secure Boot: Removed support for 192-bit curve in secure boot as part of the upgrade to mbedTLS version 4.1.0. (cadda99)
• Security/Secure Boot: Disabled ECDSA Secure Boot V2 for ESP32-H2, ESP32-C5, ESP32-P4 which are in Mass Production stage. This was done due to a security vulnerability found in the ECDSA based Secure Boot flow, more details will be available in the Chip Errata. (3664bd2)
• System Hardware: Default revision of ESP32-P4 is changed to v3.0. Applications for < 3.0 chips whose sdkconfig has no CONFIG_ESP32P4_SELECTS_REV_LESS_V3=y will build an incompatible binary. Append CONFIG_ESP32P4_SELECTS_REV_LESS_V3=y to your sdkconfig file before running reconfigure or build. (7b3042e)

Known Issues

• For ESP32-C2 revision v2.0, Wi-Fi Packet transmission may fail when light sleep mode is enabled.

Changelog

This full changelog of v6.1-beta1 release is on The ESP Release Notes site now.