Mirrors/esp-idf
1
0
Fork 0
mirror of https://github.com/espressif/esp-idf.git synced 2026-10-02 11:10:54 +03:00
Code Issues Packages Projects Releases Wiki Activity

Merge branch 'docs/update_ble_documentation_v5.2' into 'release/v5.2'

Browse Source 
docs(ble): Added BLE 6.0 features support status

See merge request espressif/esp-idf!47503
This commit is contained in:
Jiang Jiang Jian
2026-04-27 17:28:30 +08:00
parent 5b72b65d61 e3a2c173c0
commit 6c4c48231c
9 changed files with 481 additions and 74 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/en/api-guides/ble/ble-feature-support-status.rst
+115 -24
View File
@@ -153,9 +153,24 @@ If none of our chip series meet your needs, please contact `customer support tea
|supported|
* - .. centered:: |5.1|
- Angle of Arrival (AoA)/Angle of Departure (AoD)
- |unsupported|
- |unsupported|
- |unsupported|
- .. only:: esp32h2
|experimental|
.. only:: esp32 or esp32c3 or esp32s3 or esp32c6 or esp32c2
|unsupported|
- .. only:: esp32h2
|experimental|
.. only:: esp32 or esp32c3 or esp32s3 or esp32c6 or esp32c2
|unsupported|
- .. only:: esp32h2
|experimental|
.. only:: esp32 or esp32c3 or esp32s3 or esp32c6 or esp32c2
|unsupported|
* -
- GATT Caching
- |NA|
@@ -173,19 +188,19 @@ If none of our chip series meet your needs, please contact `customer support tea
|unsupported|
.. only:: esp32c6 or esp32h2 or esp32c2 or esp32c5
|experimental|
|supported|
- .. only:: esp32 or esp32c3 or esp32s3
|unsupported|
.. only:: esp32c6 or esp32h2 or esp32c2 or esp32c5
|experimental|
|supported|
- .. only:: esp32 or esp32c3 or esp32s3
|unsupported|
.. only:: esp32c6 or esp32h2 or esp32c2 or esp32c5
|experimental|
|supported|
* - .. centered:: |5.2|
- LE Isochronous Channels (BIS/CIS)
- |unsupported|
@@ -195,7 +210,7 @@ If none of our chip series meet your needs, please contact `customer support tea
- Enhanced Attribute Protocol
- |NA|
- |unsupported|
- |developing202412|
- |experimental|
* -
- LE Power Control
- .. only:: esp32 or esp32c2
@@ -204,7 +219,12 @@ If none of our chip series meet your needs, please contact `customer support tea
.. only:: esp32c6 or esp32h2 or esp32c3 or esp32s3 or esp32c5
|experimental|
- |unsupported|
- .. only:: esp32 or esp32c2
|unsupported|
.. only:: esp32c6 or esp32h2 or esp32c3 or esp32s3 or esp32c5
|experimental|
- .. only:: esp32 or esp32c2
|unsupported|
@@ -233,19 +253,33 @@ If none of our chip series meet your needs, please contact `customer support tea
|supported|
* -
- LE Enhanced Connection Update (Connection Subrating)
- .. only:: esp32 or esp32c6 or esp32c2 or esp32h2 or esp32c5
- .. only:: esp32
|unsupported|
.. only:: esp32c3 or esp32s3
.. only:: esp32c3 or esp32s3 or esp32c6 or esp32h2
|experimental|
- |unsupported|
- .. only:: esp32 or esp32c6 or esp32c2 or esp32h2 or esp32c5
.. only:: esp32c2
|unsupported|
.. only:: esp32c3 or esp32s3
- .. only:: esp32
|unsupported|
.. only:: esp32c3 or esp32s3 or esp32c6 or esp32h2
|experimental|
.. only:: esp32c2
|unsupported|
- .. only:: esp32
|unsupported|
.. only:: esp32c3 or esp32s3 or esp32c6 or esp32h2
|experimental|
.. only:: esp32c2
|unsupported|
* -
- LE Channel Classification
- .. only:: esp32 or esp32c3 or esp32s3 or esp32c2
@@ -268,31 +302,90 @@ If none of our chip series meet your needs, please contact `customer support tea
|experimental|
* - .. centered:: |5.4|
- Advertising Coding Selection
- .. only:: esp32 or esp32c6 or esp32c2 or esp32h2 or esp32c5
- .. only:: esp32
|unsupported|
.. only:: esp32c3 or esp32s3
.. only:: esp32c3 or esp32s3 or esp32c6 or esp32h2
|experimental|
- |unsupported|
- .. only:: esp32 or esp32c6 or esp32c2 or esp32h2 or esp32c5
.. only:: esp32c2
|unsupported|
.. only:: esp32c3 or esp32s3
- .. only:: esp32
|unsupported|
.. only:: esp32c3 or esp32s3 or esp32c6 or esp32h2
|experimental|
.. only:: esp32c2
|unsupported|
- .. only:: esp32
|unsupported|
.. only:: esp32c3 or esp32s3 or esp32c6 or esp32h2
|experimental|
.. only:: esp32c2
|unsupported|
* -
- Encrypted Advertising Data
- |NA|
- |unsupported|
- |experimental|
- |experimental|
* -
- LE GATT Security Levels Characteristic
- |NA|
- |unsupported|
- |developing202412|
- |experimental|
- |experimental|
* -
- Periodic Advertising with Responses
- .. only:: esp32 or esp32c3 or esp32s3 or esp32c2
|unsupported|
.. only:: esp32c6 or esp32h2
|experimental|
- .. only:: esp32 or esp32c3 or esp32s3 or esp32c2
|unsupported|
.. only:: esp32c6 or esp32h2
|experimental|
- .. only:: esp32 or esp32c3 or esp32s3 or esp32c2
|unsupported|
.. only:: esp32c6 or esp32h2
|experimental|
* - .. centered:: |6.0|
- Channel Sounding
- |unsupported|
- |unsupported|
- |unsupported|
* -
- LL Extended Feature Set
- |unsupported|
- |unsupported|
- |unsupported|
* -
- Decision-Based Advertising Filtering
- |unsupported|
- |unsupported|
- |unsupported|
* -
- Enhancements for ISOAL
- |unsupported|
- |unsupported|
- |unsupported|
* -
- Monitoring Advertisers
- |unsupported|
- |unsupported|
- |unsupported|
* -
- Frame Space Update
- |unsupported|
- |unsupported|
- |unsupported|
@@ -313,9 +406,6 @@ You are encouraged to consult with our `customer support team <https://www.espre
.. |supported| image:: ../../../_static/ble/feature_status/supported.svg
:class: align-center
:width: 65px
.. |developing202412| image:: ../../../_static/ble/feature_status/developing202412.svg
:class: align-center
:width: 120px
.. |unsupported| image:: ../../../_static/ble/feature_status/unsupported.svg
:class: align-center
:width: 75px
@@ -336,3 +426,4 @@ You are encouraged to consult with our `customer support team <https://www.espre
.. |5.2| replace:: `5.2 <https://www.bluetooth.com/specifications/specs/core-specification-5-2/>`__
.. |5.3| replace:: `5.3 <https://www.bluetooth.com/specifications/specs/core-specification-5-3/>`__
.. |5.4| replace:: `5.4 <https://www.bluetooth.com/specifications/specs/core-specification-5-4/>`__
.. |6.0| replace:: `6.0 <https://www.bluetooth.com/specifications/specs/core-specification-6-0/>`__
docs/en/api-guides/ble/ble-multiconnection-guide.rst
+63
View File
@@ -0,0 +1,63 @@
Multi-Connection Guide
==========================================
:link_to_translation:`zh_CN:[中文]`
Introduction
--------------
The following table provides an overview of the maximum number of concurrent connections supported for each ESP Bluetooth LE Host. In multi-connection scenarios, connection parameters must be configured appropriately. In general, as the number of connections increases, the connection interval should be increased accordingly. For detailed parameter configuration recommendations and SDK configuration details, please refer to the corresponding example code in the following table.
In this document, the maximum number of connections refers to the maximum number of simultaneous active connections that the device can maintain, whether operating as a central or peripheral.
.. table:: Maximum Concurrent Connections by ESP Bluetooth LE Host
+---------------+-----------------------------+------------------------------+---------------------+
| Host | Max Connections | SDKconfig | Example |
+===============+=============================+==============================+=====================+
| | | |bluedroid_enable_config| | |
| ESP-Bluedroid | |max_bluedroid_connections| | | |bluedroid_example| |
| | | |bluedroid_connection_num| | |
+---------------+-----------------------------+------------------------------+---------------------+
| ESP-NimBLE | |max_nimble_connections| | |nimble_connection_num| | |nimble_example| |
+---------------+-----------------------------+------------------------------+---------------------+
Note
----
1. The ability to support multiple connections highly depends on the application’s overall memory usage. It is recommended to disable unnecessary features to optimize multi-connection performance.
2. When the device operates in the peripheral role, connection stability and overall performance will be influenced by the central device and the negotiated connection parameters.
.. only:: not esp32 and not esp32c3 and not esp32s3 and not esp32c2
3. Due to the relatively higher memory usage of ESP-Bluedroid, it supports fewer concurrent connections compared to ESP-Nimble.
4. If your application requires more simultaneous connections than the values listed above, please contact our `customer support team <https://www.espressif.com/en/contact-us/sales-questions>`__ for further assistance.
.. |bluedroid_enable_config| replace:: :ref:`BT_MULTI_CONNECTION_ENBALE <CONFIG_BT_MULTI_CONNECTION_ENBALE>`
.. |bluedroid_connection_num| replace:: :ref:`BT_ACL_CONNECTIONS <CONFIG_BT_ACL_CONNECTIONS>`
.. |bluedroid_example| replace:: :example:`multi_conn <bluetooth/bluedroid/ble/ble_multi_conn>`
.. |nimble_connection_num| replace:: :ref:`BT_NIMBLE_MAX_CONNECTIONS <CONFIG_BT_NIMBLE_MAX_CONNECTIONS>`
.. |nimble_example| replace:: :example:`multi_conn<bluetooth/nimble/ble_multi_conn>`
.. only:: esp32 or esp32c3 or esp32s3
.. |max_bluedroid_connections| replace:: 9
.. |max_nimble_connections| replace:: 9
.. only:: esp32c2
.. |max_bluedroid_connections| replace:: 2
.. |max_nimble_connections| replace:: 2
.. only:: esp32h2
.. |max_bluedroid_connections| replace:: 15
.. |max_nimble_connections| replace:: 70
.. only:: esp32c6
.. |max_bluedroid_connections| replace:: 50
.. |max_nimble_connections| replace:: 70
docs/en/api-guides/ble/host-feature-support-status.rst
+61 -13
View File
@@ -72,8 +72,8 @@ If none of our chip series meet your needs, please contact `customer support tea
- |supported|
* - .. centered:: |5.1|
- Angle of Arrival (AoA)/Angle of Departure (AoD)
- |unsupported|
- |unsupported|
- |experimental|
- |experimental|
* -
- GATT Caching
- |experimental|
@@ -93,11 +93,11 @@ If none of our chip series meet your needs, please contact `customer support tea
* -
- Enhanced Attribute Protocol
- |unsupported|
- |developing202412|
- |experimental|
* -
- LE Power Control
- |unsupported|
- |supported|
- |experimental|
- |experimental|
* - .. centered:: |5.3|
- AdvDataInfo in Periodic Advertising
- |supported|
@@ -105,25 +105,74 @@ If none of our chip series meet your needs, please contact `customer support tea
* -
- LE Enhanced Connection Update (Connection Subrating)
- |unsupported|
- |supported|
- .. only:: esp32c2
|unsupported|
.. only:: not esp32c2
|supported|
* -
- LE Channel Classification
- |supported|
- |supported|
* - .. centered:: |5.4|
- Advertising Coding Selection
- |unsupported|
- |supported|
- .. only:: esp32c2
|unsupported|
.. only:: not esp32c2
|experimental|
- .. only:: esp32c2
|unsupported|
.. only:: not esp32c2
|supported|
* -
- Encrypted Advertising Data
- |unsupported|
- |experimental|
- |experimental|
* -
- LE GATT Security Levels Characteristic
- |unsupported|
- |developing202412|
- |experimental|
- |experimental|
* -
- Periodic Advertising with Responses
- .. only:: esp32c2
|unsupported|
.. only:: not esp32c2
|experimental|
- .. only:: esp32c2
|unsupported|
.. only:: not esp32c2
|experimental|
* - .. centered:: |6.0|
- Channel Sounding
- |experimental|
- |experimental|
* -
- LL Extended Feature Set
- |unsupported|
- |unsupported|
* -
- Decision-Based Advertising Filtering
- |unsupported|
- |unsupported|
* -
- Enhancements for ISOAL
- |experimental|
- |experimental|
* -
- Monitoring Advertisers
- |unsupported|
- |experimental|
* -
- Frame Space Update
- |unsupported|
- |unsupported|
@@ -138,8 +187,6 @@ You are encouraged to consult with our `customer support team <https://www.espre
.. |supported| image:: ../../../_static/ble/feature_status/supported.svg
:class: align-center
.. |developing202412| image:: ../../../_static/ble/feature_status/developing202412.svg
:class: align-center
.. |unsupported| image:: ../../../_static/ble/feature_status/unsupported.svg
:class: align-center
.. |experimental| image:: ../../../_static/ble/feature_status/experimental.svg
@@ -157,3 +204,4 @@ You are encouraged to consult with our `customer support team <https://www.espre
.. |5.2| replace:: `5.2 <https://www.bluetooth.com/specifications/specs/core-specification-5-2/>`__
.. |5.3| replace:: `5.3 <https://www.bluetooth.com/specifications/specs/core-specification-5-3/>`__
.. |5.4| replace:: `5.4 <https://www.bluetooth.com/specifications/specs/core-specification-5-4/>`__
.. |6.0| replace:: `6.0 <https://www.bluetooth.com/specifications/specs/core-specification-6-0/>`__
docs/en/api-guides/ble/index.rst
+1
View File
@@ -14,6 +14,7 @@ Overview
ble-feature-support-status
ble-qualification
Low Power Mode Introduction <ble-low-power-mode>
ble-multiconnection-guide
***************
Get Started