Documentation for release v3.3.4 is available at https://docs.espressif.com/projects/esp-idf/en/v3.3.4/

ESP-IDF v3.3.4 is a bugfix update for ESP-IDF v3.3. IDF v4.1 is the latest stable release of ESP-IDF at time of writing.

ESP-IDF v3.3.4 will be supported until February 2022, according to the ESP-IDF Support Policy. Since ESP-IDF v4.1, each ESP-IDF major and minor release (V4.1, V4.2, etc) is supported for 30 months after the initial stable release date.

Note: This release comes soon after v3.3.3 due to a process failure, these fixes were tested as part of the v3.3.3 release but incorrectly not included in the release. The internal release process has been revised to avoid this failure repeating again.

Known Issues

• The 1.22.0-96-g2852398 GCC 5.2.0 toolchain version added in this release includes an improved PSRAM fix. Extended stress testing of Wi-Fi & BT coexistence with heavy PSRAM use show there is a difficult to reproduce issue with the updated PSRAM fix. To avoid this problem it is possible to keep the toolchain supplied with ESP-IDF V3.3.2 (version 1.22.0-80-g6c4433a) and use this ESP-IDF version, despite the warning printed by the build system. This issue will be fixed in ESP-IDF V3.3.5.
• Watchdog timeout when using an RSA 4096-bit key to connect to WPA2-Enterprise (EAP-TLS) AP

WiFi

ESP-WIFI-MESH

• Remove coexist warnings in ESP_WIFI_MESH
• If the root is specified (FIXED-ROOT) by set type or set parent, it will change ie.mesh_type to MESH_ROOT before connect to router
• Release esp_mesh_recv_toDS when the root becomes non-root
• esp_mesh_set_type now supports MESH_IDLE and MESH_STA
• Fixed esp_mesh_deinit blocking issue

Bluetooth

Bluetooth Controller

• Fixed ASSERT(1024, 0) in rwble.c
• Fixed ASSERT(512, 0) in rwble.c
• Fixed controller tx default octets error
• Added invalid channel map parameters check (Invalid Channel Map bug fix)
• Added invalid connection parameters check
• Fixed channel map update failed when latency is greater than 0
• Fixed ASSERT(65535, 0) in lld_evt.c when update channel map

Bluedroid

• Added api to query the number of available buffers for the current connection

NimBLE

• NimBLE: Add Non-Resolvable private address support
• Added documentation for ble_hs_pvcy_rpa_config() API in its declaration
• Added header guards and closing bracket conditional for C++ in ble_hs_pvcy.h (espressif/esp-nimble#12)
• Fixed repeated pairing failure in RPA (#5530)
• Fixed potential issue with strncpy in os_mempool.c (apache/mynewt-nimble#843)

ESP-BLE-MESH

• Add two TTL related macros for mesh applications
• Callback send_ttl to the app layer when a message is received

LWIP

• Added option to make TCP/IP RTO time configurable
• Fixed bug with IPV6 fragmentation not correctly disabling according to the config
• Fixed IPV6 memory leak
• Fixed UDP TX packet loss issue when the ARP cache table is full

MSYS2

• Prebuilt MSYS2 environment now contains the same 1.22.0-96-g2852398 toolchain as the other platforms

Build System

• CMake Preview: Output partition table info for partition_table target
• CMake Preview: Fix build failure when git is initialized with no first commit (#3920)
• GNU Make: Fix build failure if build directory is a symlink (#3626)

Obtaining v3.3.4

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 v3.3.4 --recursive https://github.com/espressif/esp-idf.git esp-idf-v3.3.4
cd esp-idf-v3.3.4/

This is the recommended way of obtaining v3.3.4 of ESP-IDF.

Download an archive with submodules included

Attached to this release is an esp-idf-v3.3.4.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/dl/esp-idf/releases/esp-idf-v3.3.4.zip