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

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

Obtaining v4.3.5

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

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

Using git

To get this release, use the following commands:

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

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

Download an archive with submodules included

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

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

Major changes

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

Breaking Changes

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

Changelog

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

Bluetooth

Bluetooth Low Energy

Added

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

Changed

• Changed BLE default TX power from 3dBm to 9dBm (2e0da277)
• Changed default TX power to 9 dBm on ESP32 (8cd8ec01)

Fixed

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

Classic Bluetooth

Fixed

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

Bluedroid

Classic Bluetooth

Added

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

Changed

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

Fixed

• Fixed authentication failure during legacy pairing by using variable PIN type instead of fixed PIN. (08ee8d71, https://github.com/espressif/esp-idf/issues/10005)
• Fixed the issue Bluetooth Classic connection can not be created while there is a Bluetooth Low Energy connection is in active. (b52b357b)
• HID: Fixed compatibility issues with HID devices that do not support Secure Simple Paring in HID examples. (a69c5408, https://github.com/espressif/esp-idf/issues/10069)
• A2DP: fixed sink device not being able to accept and decode mono channel audio stream (07bffab8)
• SPP: Fixed esp_spp_write() crash when len is 0 (d96bb082)
• HFP: Fixed HFP client parce CLCC command response bug (81d598b4)
• A2DP: Fixed failure of A2DP reconnection A2DP after disconnected (6298b8c8)
• Fixed memory leak due to not freeing memory if posting a message to a thread fails (df901e0f)
• SPP: Fixed repeated register of vfs_id causing memory leaks (7d61396a)
• SPP: Fixed memory leak when SPP initialization failed (7d61396a)
• Fixed the unexpected memory free when malloc failed. (067d5fb2)
• Fixed build errors when sniff subrating is enabled. (3a4755e5)

Bluetooth Low Energy

Added

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

Changed

• Updated BLE tx power level mapping (a2086ca3)
• Reduced the stack consumption of BTU_TASK, saving 609 bytes (05c497e9)

Fixed

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

NimBLE

Added

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

Changed

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

Fixed

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

Blufi

Added

• Added data subtype for more WiFi information (ec25f91a)

Changed

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

Fixed

• Fixed a bug that memory freed twice(1f739d71)

ESP-BLE-Mesh

Added

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

Fixed

• Fixed regression introduced in the btc_transfer_context changes (26369071)
• Fixed Friend not relay LPN messages if relay feature is disabled (eb922b57)
• Fixed not using fast adv interval when PB-GATT and PB-ADV are both enabled (f1beed49)
• Fixed not able to get optional fields from messages with a group address as DST (b08d2c86)

Coexistence

Fixed

• Fixed part of modem module not reset when power up (167a9896)

Wi-Fi

Added

• Added UTs for country code (aefd3db8)
• Added check for ies in match security (c0ba33a9)
• Added station connect retry count to make it easier to connect to the except AP (ca6553ad)
• Added a check to avoid FTM initiator mode in SoftAP (72a643e7)
• Added an API to clear scan AP list (aefd3db8)

Changed

• Optimized DTIM sleep when WiFi beacon loss(1adb0b6b)
• Updated wifi country code docs (aefd3db8)
• PHY: Optimized phy calibration for ESP32-C3 and ESP32-S3. (1adb0b6b)
• Updated wifi scan return values and docs. (3685ed28)
• Changed the log level of some logs to avoid misunderstanding. (3685ed28)
• Added changes to prevent security parameters overwritten in full scan (114ce9b7)
• Updated WiFi AMSDU docs. (25a74f85)

Fixed

• Install GTK before send group key handshake message 2 (5c3e7291)
• Fixed country policy issue (aefd3db8)
• Fixed connect failure when enable SPIRAM and send ESPNOW packets (bc4de7dc)
• Fixed ignore rx sub ampdu interrupt issue (8b8b69a4)
• Added security fixes from upstream wpa_supplicant (d2cc0f9f, CVE-2019-9496, CVE-2022-23304, CVE-2022-23303, CVE-2019-9494)
• Fixed deinit return wrong value. (1adb0b6b)
• Fixed get wrong channel value use esp_wifi_get_config. (1adb0b6b)
• Fixed bug of missing unlock when wifi stop. (1adb0b6b)
• Fixed annotation error of api esp_wifi_connect. (1adb0b6b)
• Fixed the bug that station connected to an AP already connected caused subsequent scan fail (1d5efadd)
• Fixed repeated scans causing bss overwrite in connect process (91c60b9c)
• For ESP32-C3 and ESP32-S3, fixed Wi-Fi getting stuck in Wi-Fi start when working with BT. (0dbc3400)
• Fixed WPA2 Enterprise Re-authentication issue (d732a84b)
• Fixed a few memory leaks in the operation of a station in WPS PIN mode, which led to crashes after a few executions of WPS Start with no attempt to connect it to it for the WPS timeout duration. (a74a732c)
• Fixed connect fail return wrong error code issue. (3685ed28)
• Fixed unprotected SA Query issue and scan regression (c0ba33a9)
• Fixed sniffer mode can not capture control packet when station is enabled (ca6553ad)
• Fixed WAPI issue on GTK compability and reference to broadcast ARP packets (ca6553ad)
• Fixed TX fragment issue that PN code is less than MSDU after PN code add two for TX fragment. (ca6553ad)
• Fixed some issues on SoftAP power save. (ca6553ad)
• Fixed SoftAP memory leak after wifi init and deinit (ca6553ad)
• Fixed STA get AP info does not return connected SSID issue. (ca6553ad)
• Fixed SoftAP disconnection happened even when receive PS-Poll. (ca6553ad)
• Provided RSSI info in disconnected event (ec25f91a)
• Fixed high current issue after reconnected (ec25f91a)
• Fixed potential Wi-Fi disconnection when BT deinit. (ec25f91a)
• Fixed SSID copy length during WPS scan (3bb9fb34)
• Prevented PMK caching if AP security has changed (3bb9fb34)
• Added key reinstallation related security fixes from upstream wpa_supplicant (76eb6725, CVE-2017-13077, CVE-2017-13078, CVE-2017-13079, CVE-2017-13080, CVE-2017-13081, CVE-2017-13082)
• Fixed home channel issue in FTM for AP+STA mode (72a643e7)
• Fixed integer overflow for T1-T4 counter variable (72a643e7)
• Cleared current PMKSA to fix WPA3 connect loop (81fb7b03)
• Fixed the bug that long associate comeback causes STA can't connect to the AP to long(aa8a00c4, https://github.com/espressif/esp-idf/issues/9428)
• Fixed multicast packets drop issue for some AP when DTIM period > 1 (1fb3e3e4)
• Fixed the bug that sending two M1 of WPS EAP with different enrollee nonce as a reply to request expanded WPS (30ee33c6)
• Sent wake up Null data to AP when STA associated to AP. (97454c01)
• Adjusted abnormal beacon log to debug. (97454c01)
• Verified RSNXE in scan and connect. (97454c01)
• Fixed FTM procedure with peer failed status 4 issue. (97454c01)
• Fixed the bug that failed to connect to the AP encrypted with WPA3 SAE (80dd246b)
• Fixed the bug that STA auth failed but SoftAP shows it connected issue. (2b04fa80)
• Fixed connection issue with specific WPA3 AP. (fcf33944)

ESP-WIFI-MESH

Fixed

• Fixed WIFI_EVENT_AP_STADISCONNECTED event error (3685ed28)

Peripheral Drivers

Fixed

• ADC: Fixed ADC Oneshot driver clock gating issue on ESP32-C3 (418d47a0)
• ESSL_SPI: Fixed Quad SPI wrong dummy cycle issue on ESP32-C3 (02c45b6e)
• freemodbus: Fixed RS485 RTS de-assert failure when tx delayed (bfbf1139, https://github.com/espressif/esp-idf/issues/6728)
• GPIO: Fixed the issue that digital GPIO can not disable hold during deep sleep on ESP32-C3/ESP32-S2/ESP32-S3 (ea57dd43)
• GPIO: Fixed the issue that digital gpio can not enable hold during deep sleep when force_unhold is set on ESP32/ESP32-S2/ESP32-S3 (ea57dd43)
• I2C: Fixed the issue that some functions are not placed in IRAM (8b7ae118, https://github.com/espressif/esp-idf/issues/10079)
• I2C: Correct I2C clock frequency on ESP32-C3, ESP32-S3 (164d9bb7)
• LEDC: Fixed PWM signal glitch when calling ledc_set_freq to change PWM frequency (179d12db)
• PSRAM: Fixed 40MHz PSRAM CS signal glitch issue on ESP32 (f425cd9d)
• SPI Bus Lock: Fixed a concurrency issue leading to spi_device_polling_end assertion fail (1ecf62bf, https://github.com/espressif/esp-idf/issues/8179)
• SDIO Slave: Fixed crash caused by incorrect return value check in host example (853ce78b)
• SPI Master: Fixed an issue on ESP32-S2, ESP32-C3 that more than 3 devices can't be added to the SPI2 Host (9a9f503c, https://github.com/espressif/esp-idf/issues/8876)
• SPI Slave: Fixed CS signal mapping issue when other bus signals are routed via IOMUX and CS is routed via GPOIO Matrix (81ee095b)
• SPI Slave: Fixed the issue caused by ccount in the sender example (4b6a6a26)
• TWAI: Fixed an HW errata where the TWAI controller could still send dominant bits under listen-only mode. The errata workaround can be enabled via the CONFIG_TWAI_ERRATA_FIX_LISTEN_ONLY_DOM option. (d8a21db3)
• TWAI: Fixed that issue that CONFIG_TWAI_ISR_IN_IRAM is not working on ESP32-C3 (2ee1a33e)
• UART: fix 2nd bootloader custom UART1 baudrate issue

Removed

• ADC: No longer support ADC2 continuous (DMA) mode on ESP32C3, search for errata on espressif website to know more details. Users can force use it by enabling CONFIG_ADC_CONTINUOUS_FORCE_USE_ADC2_ON_C3_S3 (https://github.com/espressif/esp-idf/issues/10135, 00746db0)
• ADC: No longer support ADC2 oneshot mode on ESP32C3, search for errata on espressif website to know more details. Users can force use it by enabling CONFIG_ADC_ONESHOT_FORCE_USE_ADC2_ON_C3 (https://github.com/espressif/esp-idf/issues/10135, 00746db0)
• PSRAM: Removed unused CS and CLK IO kconfig options on ESP32-S2 (3bbb109e)

Core System

Added

• eFuse: Added major and minor versions for wafer and eFuse block (ea8de4dd)
• Added a new chip version logic (major * 100 + minor) (6b323359)
• Bootloader: Added chip revision check based on the configured REV_MIN_FULL and the REV_MAX_FULL associated with IDF version (6b323359)

Changed

• RTC: Improved XTAL stability when sleep (ESP32) (6225c718)

Fixed

• Heap: Fixed abort on allocation failure regardless of SPIRAM (73509d93)
• Fixed xtal32k error detection when configured but doesn't actually exist (8ed3ec79)
• Fixed calibration failure on rtc8m clock after CPU/core reset as 8md256 clock is not enabled during calibration (83dc965b)
• Fixed 8MD256 couldn't be used as RTC slow src in deepsleep on ESP32 (af61c513, https://github.com/espressif/esp-idf/issues/8007, https://github.com/espressif/esp-idf/pull/8089)
• Suppress CPU crash and memory issues under extreme temperature on a small amount of ESP32-C3 Chips (ed9fb4db)
• spi_flash: Fixed clobbering RTOS base priority in spi_flash_disable_interrupts_caches_and_other_cpu (96ef8f42)
• Fixed time jump after reboot (ffe6f240, https://github.com/espressif/esp-idf/issues/9448)
• Heap: Fixed excessive heap allocator overhead introduced in release 4.3 that increased heap size by ~4KB (690b971f, https://github.com/espressif/esp-idf/issues/7906)
• Heap: Decreased utilization of the RAM section by the heap component binary by ~40%. (690b971f)
• Heap: Fixed heap_caps_get_allocated_size() return value when poisoning is active to not account for canary head and tail. (24aa00d9)

CI

Changed

• precommit: Changed repo URL to use official GitHub repo instead of the deprecated GitLab mirror. (9d3d7732)

FreeRTOS

Fixed

• Fixed eTaskConfirmSleepModeStatus() calling taskEXIT_CRITICAL instead of taskENTER_CRITICAL (error introduced in a3c90bf5) (05be2de5)

Power Management

Added

• Added the usage of wakeup source EXT0, and how to use internal pullups if necessary (19ebbf6f)

Fixed

• Fixed RTC8M domain power down issue when used as RTC source (714cf794, https://github.com/espressif/esp-idf/issues/8007, https://github.com/espressif/esp-idf/pull/8089)
• Fixed current leakage when hold digital io during deep sleep (ea57dd43)
• Fixed BT sleep flow hangs in btdm_sleep_clock_sync (31057113)
• Fixed sleep time inaccurate bug when select 8MD256 as RTC slow clock on ESP32 (3d366e19, https://github.com/espressif/esp-idf/issues/6687)
• Fixed GPIO wakeup not working properly in some cases (043958e3)
• Fixed the issue related to powering down CPU and RC_FAST at the same time during light sleep (714cf794)

newlib libc

Fixed

• Fixed wrong mutex types being used for env and tz (ab673515, https://github.com/espressif/esp-idf/pull/10649, https://github.com/espressif/esp-idf/issues/9441, https://github.com/espressif/esp-idf/issues/10626, https://github.com/espressif/esp-idf/issues/10686)

LWIP

Added

• Added DHCP client's configuration for coarse timer to improve power efficiency (3250b888)
• Added TCP Fin2 timeout configuration (6439222c)
• Added on demand timers for several modules to improve power efficiency (updated DNS timer, IPv4/IPv6 reassembly timer and DHCP fine timer) (6439222c)

Fixed

• Fixed long time to get IP (6439222c)
• Fixed DHCP server's bug allowing the assigned IP addresses to exceed the configured subnet range (#10024) (7d5a228f)

Provisioning

Changed

• Wifi Prov: Disabled by default the Forcing of BLE encryption requirement on provisioning characteristics. (1d000363)

mbedTLS

Added

• Added and refactored sanity checks and their return values (86686d16)

Fixed

• Fixed esp_aes_crypt_ctr writing to null stream block (86686d16)

ESP-TLS

Fixed

• Fixed socket leak in esp-tls (07251a99)
• Fixed memory leak in mbedtls ds peripheral when MBEDTLS_THREADING_C enabled. (d4789383)
• Fixed setting the default timeout of sockets before a connection when a timeout value was not given in the esp-tls config structure (58111664)

ESP-MQTT

Fixed

• Fixed esp_mqtt_client_enqueue() with len=0 (635a9c5e, https://github.com/espressif/esp-mqtt/pull/226)

Storage

Fixed

• FATFS: Fixed incorrect mtime reported for files created during daylight savings time (9ee1cda5, https://github.com/espressif/esp-idf/issues/9039)

Tools

Changed

• Use bitstring package compatible with supported Python versions (784019ee)
• partition_table: Allow 4K aligned app partition size for secure boot v2 case. This allows to use remaining space after signature block (worth 60K) for other data partitions. (3dc1ab53)

Fixed

• Fix "KeyError: 'idfSelectedId'" when running install scripts. (4c601e1d, https://github.com/espressif/esp-idf/issues/9837)
• Fixed installation on Ubuntu 22.04 (and probably later versions) (feeca500, https://github.com/espressif/esp-idf/issues/9931)

Removed

• gdbgui is not supported on Python 3.11 (2e1c1a32, https://github.com/espressif/esp-idf/issues/10116)

Build System

Fixed

• Fixed an issue where disassembly of ELF files built with ESP-IDF would sometimes be incorrect. The issue was related to .xt.prop sections missing from the final ELF file. (867c6221)

External Libraries

Changed

• expat: Upgraded expat to release v2.5.0 (ee7953dc)

Documentation

Fixed

• Provided information on how to use USB Serial JTAG in sleep modes (c9300466, https://github.com/espressif/esp-idf/issues/8507, https://github.com/espressif/esp-idf/issues/8884)