Fixed

• Crash when scanning with esp32c6/c5/c2/h2.
• Scan duplicate filter not resetting on scan restart.

Added

• NimBLEConnInfo::toString method to get a string representation of the connection information for logging/debugging purposes.

Fixed

• Crash on init with esp32 devices with Arduino core 3.3.7 and later.
• Crash on deinit with esp32c6/c5/c2/h2.
• Memory leak on init/deinit with esp32c6/c5/c2/h2 when NimBLE is enabled in the Arduino core.
• Multiple definition compilation errors with esp32c2 when using an Arduino core with NimBLE enabled.

Fixed

• Server created client instance will now receive notifications/indications from the peer.
• Improper HCI delay when ACL buffers are full (esp32)
• NimBLEClient disconnect event not triggered if the peer address doesn't match a connection.
• Attribute value sizes now correctly calculated for types larger than 8 bits.
• NimBLERemoteCharacteristic::retrieveDescriptors will now use the handle range of the characteristic.

Added

• NimBLECharacteristicCallbacks::onStatus overload that takes a NimBLEConnInfo& parameter to indicate which client the status is for.

Changed

• NimBLEDevice::setCustomGapHandler added a void pointer parameter to allow passing user data to the custom handler.

Fixed

• NimBLEAdvertisedDevice::isConnectable returning incorrect result.
• Extended advertisements not reporting full data.

Added

• Support up to 1650 bytes of advertisement with extended advertising.

Fixed

• esp32c3/s3 max connections not being properly applied.

Fixed

• NimBLEClientCallbacks::OnConnectFail not called when connection not established.
• Removed invalid reference to refactored original examples in README.md.
• Cleanup redefinition warnings for Arduino core 3.3+.

Fixed

• Multiple definition errors for some functions with esp32c6/h2/c2 with Arduino core 3.3+.

Fixed

• Max connections not being applied correctly above 4.
• Build errors with arduino cores using IDF v4.x
• onConnect callback not being called when the status is BLE_ERR_UNSUPP_REM_FEATURE, workaround for upstream issue.

Changed

• FreeRTOS port uses the old porting layer for all but the latest esp32 mcus.
• By default BLE secure connections is disabled now to reduce issues when it's enabled but not used by the application.
• BLE mesh files are now only compiled if mesh is enabled in the project configuration.

What's Changed

• Add iBeacon example by @lazd in #971
• Fix builds when excluding roles by @h2zero in #964
• [Bugfix] NimBLEScan delete. by @h2zero in #976
• Fix build with esp32c2 by @h2zero in #974
• Fix server client read/write not returning when encryption is used. by @h2zero in #973
• Fix build with esp32c2 and upcoming arduino core version by @h2zero in #978
• Update docs by @h2zero in #979

New Contributors

• @lazd made their first contribution in #971

Full Changelog: 2.3.0...2.3.1

Fixed

• Incorrect NimBLECharacteristic::onSubscribe value when indications are set.
• NimBLECharacteristic::onRead callback not called in some cases.
• Clear attribute value when zero length value is written.
• Notify/Indicate incorrectly returning success with custom value.
• Corrected NimBLEClient array initialization.
• Prevent potential exception when scan is restarted.
• Attribute getValue failing with some data types
• Incorrectly passing a pointer to a function taking const reference.

Added

• Support for esp32c2, esp32c5, esp32c6, esp32h2
• L2CAP infrastructure.
• Scan duplicate cache reset time.

Changed

• Cleaned up examples.
• Update nimble core to esp-nimble @70439dd.
• Disable flow control for all targets except original esp32.
• Allow PHY updates without enabling extended advertising.
• Reduced iram usage