espressif/esp-idf
1
0
Fork 0
Code Issues Pull requests Projects Releases 31 Packages Wiki Activity Actions 3
31 releases 193 tags
  • v5.5.1 fcae32885b

    ESP-IDF Release v5.5.1
    Some checks failed
    docker / docker (push) Has been cancelled
    Details
    Create zip file with recursive source clone for release / Create release zip file (push) Has been cancelled
    Details
    Stable

    petr.gadorek released this 2025-08-30 13:42:33 +00:00 | 11636 commits to master since this release

    No known key found for this signature in database
    GPG key ID: 1AF25F3CD37D9114

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

    ESP-IDF v5.5.1 is a bugfix release for ESP-IDF v5.5.

    Obtaining v5.5.1

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

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

    Using git

    To get this release, use the following commands:

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

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

    Download an archive with submodules included

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

    Major changes

    Major New Features

    • Support for ESP32-C5 is initially added.
    • Support for ESP32-C61 is initially added.
    • System Hardware: Auto adjust core voltage for different chip and different environment on ESP32-P4 (0291ab0d)

    Known Issues

    • For ESP32-C5, the fine timing measurement is not functional.
    • For ESP32-C61, in complex coexistence scenarios, Power-on Reset and RTC BOD SYS reset may occur with low probability.

    Changelog

    15.4

    Thread

    • Fixed an issue with source address selection during network switching (e00fa1de)
    • Use the ML-EID address for self-hosted services if OMR address is not preferred (c4ac82fc)
    • Introduced a new API to register the console based openthread CLI command (97e07a01)
    • Improved TREL message reception (97e07a01)
    • Handled MeshCoP mDNS service in state change callback (97e07a01)
    • Updated openthread submodule (b945928) (97e07a01)
    • Supported RCP over USB Serial JTAG interface (3e94cf12)

    Application Utilities

    ESP HTTP Client

    ESP HTTP Server

    BLE

    • Added Bluetooth LE CTE connectionless AoA/AoD example. (3fa646e5)
    • Removed support for ESP32C61 revision v0.2 (589c8b82)
    • Added support for ESP32C61 revision v1.0 (589c8b82)

    Bluedroid

    • Fixed failure to disconnect when device record is cleared (032b6d80)
    • Fixed issue that caused failure in "BTM_GetSecurityFlags" (032b6d80)
    • Fixed incorrect update of resolving_list_avail_size (032b6d80)
    • Fixed issue where resolving list was not updated after the oldest device was removed (032b6d80)
    • Set sec_conn only on successful pairing in ble_hid_device_demo to avoid unexpected behavior (59af1425)
    • Fixed build failure when some BLE features are disabled (c168ca3f)

    Controller

    • Fixed the issue where RSSI of connection is incorrect when latency is no zero on ESP32. (731f1176)
    • Supported multiple connection optimization vendor HCI command on ESP32. (731f1176)
    • Fixed priority setting for BLE events on ESP32. (731f1176)
    • Fixed disconnection issue when coexisting with other BLE events on ESP32. (731f1176)
    • Fixed crash due to bandwidth full when updating connection params on ESP32. (731f1176)
    • Optimized check Access Address when receive connection request PDU on ESP32 (aa2c410b)
    • Fixed an occasional sync lost issue on ESP32-C6, ESP32-H2 and ESP32-C5. (f7d35622)
    • Fixed an occasional assert issue in case of controller disable on ESP32-C2. (f7d35622)
    • Fixed an occasional assertion issue during sync on ESP32-C6, ESP32-H2 and ESP32-C5. (da257a96)
    • Fixed occasional disconnection issue when sending Data Length Update too quickly on ESP32-C6, ESP32-H2 and ESP32-C5. (da257a96)
    • Fixed BLE assert llc_llcp.c 487 on ESP32-C3 and ESP32-S3. (4bb1ad72)
    • Fixed BLE assert sch_prog.c 304 on ESP32-C3 and ESP32-S3. (4bb1ad72)
    • Fixed BLE anonymous extended advertising filtering. (4bb1ad72)
    • Fixed BLE TX issue when the event is aborted on ESP32-C3 and ESP32-S3. (4bb1ad72)

    NimBLE

    • Update count parameter correctly by considering offset. (201b9178)
    • Fix for attribute count mismatch between cached gatt db and actual db. (201b9178)
    • Fixed compilation issue due to BLE_GATTS flag (160883a4)
    • Clear GATT service entries counter upon GATT deinit (d74a625d)
    • Add packet allocation retry for limited iteration (75e4f8db)
    • Provide a way to make blufi advertising customizable. [ https://github.com/espressif/esp-idf/issues/16234 ] (f9ce2bf5)
    • Add timestamp information to HCI logging. (9f523adf)
    • Add ble_ancs example to build-test-rules configuration file. (941d9871)
    • Automatically initiate security and retry service request if service request fails due to insufficient security. (76a7dd5a)
    • Added option to require Encryption, Authentication, or Authorization to subscribe for Notifications or Indications. (76a7dd5a)
    • Added parameter in peer_init() to allocate memory for included services (76a7dd5a)
    • Add a missing instance of ble_hs_unlock() in a corner case. (76a7dd5a)
    • Fix compilation issues when gatt caching is enabled in peripheral only mode (76a7dd5a)

    Bootloader

    • Supported SECONDARY Bootloader (589c8b82)

    Build & Config

    Classic Bluetooth

    Bluedroid

    • Cleanups and improvement of safety in string handling in Bluetooth examples (148c36d8)
    • Fixed HFP AG data callback cleared after profile re-initialization, if Bluedroid dynamic memory allocation is enabled (9c2e03ba)
    • Added record_handle parameter in ESP_SDP_REMOVE_RECORD_COMP_EVT (5e1cb0fc)
    • Fixed AVRCP build issue when Cover Art feature is disabled (https://github.com/espressif/esp-idf/issues/16155) (1d9e3dfa)

    Controller

    • Fixed the incorrect unit of clk in CPB rx event on ESP32 (1e8b07ec)
    • Fixed LMP legacy and secure authentication collision bugs on ESP32 (2045b120)

    Core System

    Console

    Debugging

    Apptrace

    • Updated SystemView trace processing to support SEGGER standard multicore format available in v3.60 or later. (aea3d880)

    LWIP

    DHCP

    • Fixed incorrect DHCP length calculation causes potential memory corruption for some longer options (ESP_NETIF_HOSTNAME_MAX_SIZE) (bcd56c74)

    ESP Netif

    Low Power Features

    MQTT

    PHY

    Peripheral Drivers

    ADC

    • Fixed inaccurate ADC readings at high input voltages on ESP32-C5 (589c8b82)

    Camera

    • Fixed DVP loss half frames error (4d19e6be)

    DMA

    • Disallow burst sizes larger than 32 bytes when using DMA to access PSRAM on ESP32-C5 and ESP32-C61. (7b478f3e)

    LCD

    • Reserved the GPIO used by RGB LCD in driver initialization and disconnect them from the LCD signals when deinitialize the driver (6fd9c541)

    PARL_IO

    • Supported to register buffer switched callback in loop transmission (589c8b82)

    PCNT

    • Fixed race condition causing accum_value loss on counter overflow (782ffe1a)

    RMT

    SD_HOST

    SDMMC

    • Fixed sdmmc initialization issue caused by CMD52 CRC error (79d842df)

    SPI

    • Change ESP32P4 spi master default clock source to PLL to support up to 80M by default (88400723)
    • Fixed slave mode with dma RX data error on ESP32C5 (c2c08767)

    SPI Flash

    • Added GD55D256 flash chip support (f997e42e)
    • Fixed issue of escaping boundary check (536a8076)
    • Updated 32-bit address (16MB or more) documentation to clarify experimental support for code execution and data access with CONFIG_BOOTLOADER_CACHE_32BIT_ADDR_QUAD_FLASH (cbf01d9e)
    • Added XM25QH256D flash support for new 32MB flash module (589c8b82)
    • Make GD flash driver linked by default (589c8b82)

    TWAI

    Touch Sensor

    USB

    • Changed USB CDC VFS read() to treat end-of-line characters as regular bytes, with no early return (73bdf0ac)
    • Changed USB CDC VFS read() to return with available data when in blocking mode (73bdf0ac)

    USB Host

    • Add USB Host support for Full Speed peripheral on ESP32-P4 (31fd483c)

    USB Serial JTAG

    • Changed USB Serial JTAG VFS read() to treat end-of-line characters as regular bytes, with no early return (73bdf0ac)

    Power Management

    • Optimized the power consumption of ESP32-C5 in active state (589c8b82)

    Security

    • Added support for RSA decryption using the DS peripheral. Users can now leverage the DS peripheral with secure cert manager to securely store and use private keys for hardware-accelerated RSA decryption. (570ecdc1)

    MbedTLS

    • Fix build failure when using non-AES ciphers GCM operation fallback with CONFIG_MBEDTLS_GCM_C being disabled. (96836ab1)
    • Update mbedTLS version to 3.6.4. (5c02c6fc)

    Storage

    LittleFS

    • Default LittleFS version in examples bumped to 1.20.0 (ec5d4c59)

    System Hardware

    • Fix assert when changing 8MD256 RTC slow clock source during OTA on esp32/esp32s2/esp32s3. (92a09ce7)
    • Auto adjust core voltage for different chip and different environment on ESP32-P4 (0291ab0d)

    PSRAM

    • Fixed PSRAM chip's lack of cross-page transaction support issue on ESP32C5 / C61 (0ef3fb49)
    • Supported using fallback driver pattern when PSRAM ID is not matched on ESP32-S3, P4, C5, C61 (031ed78a)

    TCP Transport

    • Added HTTP redirect (301 - Moved Permanently) to transport websocket. (8c21713e)

    Toolchain

    Tools

    WI-FI

    • fix bandwidth check not correct (6d012bbe)
    • improve iperf performance of esp32c61 (6d012bbe)
    • Fixed ESP-Touch v2 fail on 5G router, update version to v3.0.3 (250f2484)
    • fix inactive time reset when wifi disconnect (8f36e23c)
    • fix cache access error after twt setup (8f36e23c)
    • fix tx error 0xa1 (8f36e23c)
    • Enabled IPv6 support via LWIP_IPV6 when WiFi Aware(NAN) is enabled (9c4aa443)
    • Fixed scan trigger failure after roam event (307c3f0e)
    • Removed support for the ESP32C61 revision v0.2. (589c8b82)
    • Added support for the ESP32C61 revision v1.0. (589c8b82)

    MAC

    • Fixed scan done event miss issue. (6d012bbe)
    • Support 11ax rate for cert test. (ceb11cd5)
    • Added GCMP-128 cipher support for SoftAP mode. GCMP-256 SoftAP support was previously added as part of SAE Extended Key handling. (250f2484)
    • Fixed open mode receive fragment packet fail issue. (8f36e23c)
    • Add FTM Support for ESP32C61. (8f36e23c)

    Supplicant

    • Resolved WPS crash triggered by repeated EAPOL-Start during handshake. (14ae5166)
    • Fixed pmksa expiration caused by sntp time synchronization issue. (8f36e23c)
    • Ensured disconnection with previously connected AP when actually starting the WPS instead of initiating WPS. (4eb565de)
    • Added support to limit EAP method supported by device based on user configuration (95e3ea8f)