From 37a154f0686e0350635e5e8001fa0e9ec9a51ffc Mon Sep 17 00:00:00 2001 From: Wei Yuhan Date: Mon, 10 Nov 2025 10:21:08 +0800 Subject: [PATCH 1/3] docs(ble): Added BLE Multi Connection Guide --- docs/conf_common.py | 1 + .../ble/ble-multiconnection-guide.rst | 63 +++++++++++++++++++ docs/en/api-guides/ble/index.rst | 1 + .../ble/ble-multiconnection-guide.rst | 63 +++++++++++++++++++ docs/zh_CN/api-guides/ble/index.rst | 1 + 5 files changed, 129 insertions(+) create mode 100644 docs/en/api-guides/ble/ble-multiconnection-guide.rst create mode 100644 docs/zh_CN/api-guides/ble/ble-multiconnection-guide.rst diff --git a/docs/conf_common.py b/docs/conf_common.py index 5f6a01081d4..3ccc17e4473 100644 --- a/docs/conf_common.py +++ b/docs/conf_common.py @@ -30,6 +30,7 @@ BLE_DOCS = ['api-guides/ble/index.rst', 'api-guides/ble/host-feature-support-status.rst', 'api-guides/ble/ble-qualification.rst', 'api-guides/ble/ble-low-power-mode.rst', + 'api-guides/ble/ble-multiconnection-guide.rst', 'api-guides/ble/get-started/ble-introduction.rst', 'api-guides/ble/get-started/ble-device-discovery.rst', 'api-guides/ble/get-started/ble-connection.rst', diff --git a/docs/en/api-guides/ble/ble-multiconnection-guide.rst b/docs/en/api-guides/ble/ble-multiconnection-guide.rst new file mode 100644 index 00000000000..e41d3b4b6bc --- /dev/null +++ b/docs/en/api-guides/ble/ble-multiconnection-guide.rst @@ -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 `__ for further assistance. + +.. |bluedroid_enable_config| replace:: :ref:`BT_MULTI_CONNECTION_ENBALE ` +.. |bluedroid_connection_num| replace:: :ref:`BT_ACL_CONNECTIONS ` +.. |bluedroid_example| replace:: :example:`multi_conn ` +.. |nimble_connection_num| replace:: :ref:`BT_NIMBLE_MAX_CONNECTIONS ` +.. |nimble_example| replace:: :example:`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 diff --git a/docs/en/api-guides/ble/index.rst b/docs/en/api-guides/ble/index.rst index 5598db3cbd2..584571c555b 100644 --- a/docs/en/api-guides/ble/index.rst +++ b/docs/en/api-guides/ble/index.rst @@ -14,6 +14,7 @@ Overview ble-feature-support-status ble-qualification Low Power Mode Introduction + ble-multiconnection-guide *************** Get Started diff --git a/docs/zh_CN/api-guides/ble/ble-multiconnection-guide.rst b/docs/zh_CN/api-guides/ble/ble-multiconnection-guide.rst new file mode 100644 index 00000000000..c7686624573 --- /dev/null +++ b/docs/zh_CN/api-guides/ble/ble-multiconnection-guide.rst @@ -0,0 +1,63 @@ +多连接指南 +============================= + +:link_to_translation:`en:[English]` + +介绍 +---- + +下表展示了每个 ESP 低功耗蓝牙主机所支持的最大多连接个数。在多连接场景下，需要对连接参数进行合理配置。通常情况下，随着连接数量的增加，连接间隔（Connection Interval）也应相应增大。具体的参数配置建议和 sdkconfig 详细信息，请参阅下表中的相应示例代码。 + +在本文档中，最大连接数指设备作为中心设备或外围设备时，能够同时维持的最大连接数量。 + +.. table:: ESP 低功耗蓝牙主机支持的最大连接数 + + +---------------+-----------------------------+------------------------------+---------------------+ + | 主机（Host） | 最大连接个数 | SDKconfig | 示例 | + +===============+=============================+==============================+=====================+ + | | | |bluedroid_enable_config| | | + | ESP-Bluedroid | |max_bluedroid_connections| | | |bluedroid_example| | + | | | |bluedroid_connection_num| | | + +---------------+-----------------------------+------------------------------+---------------------+ + | ESP-NimBLE | |max_nimble_connections| | |nimble_connection_num| | |nimble_example| | + +---------------+-----------------------------+------------------------------+---------------------+ + + +注意 +---- + +1. 应用能够支持的最大连接数在很大程度上取决于整体内存使用情况。建议禁用不必要的功能，以优化多连接性能。 + +2. 当设备处于外围角色时，连接稳定性和整体性能将受到中心设备和协商连接参数的影响。 + +.. only:: not esp32 and not esp32c3 and not esp32s3 and not esp32c2 + + 3. 由于 ESP-Bluedroid 的内存占用相对更高，其支持的最大连接数会少于 ESP-Nimble。 + + 4. 如果您的应用需要的同时连接数量超过上述数值，请联系 `乐鑫客户支持团队 `__ 以获取进一步的协助。 + +.. |bluedroid_enable_config| replace:: :ref:`BT_MULTI_CONNECTION_ENBALE ` +.. |bluedroid_connection_num| replace:: :ref:`BT_ACL_CONNECTIONS ` +.. |bluedroid_example| replace:: :example:`multi_conn ` +.. |nimble_connection_num| replace:: :ref:`BT_NIMBLE_MAX_CONNECTIONS ` +.. |nimble_example| replace:: :example:`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 diff --git a/docs/zh_CN/api-guides/ble/index.rst b/docs/zh_CN/api-guides/ble/index.rst index a3d14113ff1..16895d38cce 100644 --- a/docs/zh_CN/api-guides/ble/index.rst +++ b/docs/zh_CN/api-guides/ble/index.rst @@ -14,6 +14,7 @@ ble-feature-support-status ble-qualification 低功耗模式介绍 + ble-multiconnection-guide ********** 快速入门 From ccf869ea238c5654d5455346698d152ba63e4206 Mon Sep 17 00:00:00 2001 From: Wei Yu Han Date: Fri, 26 Sep 2025 09:21:34 +0800 Subject: [PATCH 2/3] docs(ble): Added BLE 6.0 features support status (cherry picked from commit 5e4c16410ba4fa20c908f56de0ba2a6363baba19) Co-authored-by: Wei Yuhan --- .../ble/feature_status/developing202603.svg | 1 + .../ble/feature_status/developing202606.svg | 1 + .../ble/ble-feature-support-status.rst | 110 ++++++++++++++---- .../ble/ble-multiconnection-guide.rst | 2 +- .../ble/host-feature-support-status.rst | 35 +++++- .../ble/ble-feature-support-status.rst | 110 ++++++++++++++---- .../ble/host-feature-support-status.rst | 35 +++++- 7 files changed, 239 insertions(+), 55 deletions(-) create mode 100644 docs/_static/ble/feature_status/developing202603.svg create mode 100644 docs/_static/ble/feature_status/developing202606.svg diff --git a/docs/_static/ble/feature_status/developing202603.svg b/docs/_static/ble/feature_status/developing202603.svg new file mode 100644 index 00000000000..ed5b6595330 --- /dev/null +++ b/docs/_static/ble/feature_status/developing202603.svg @@ -0,0 +1 @@ +In Progress: 2026/03In Progress2026/03 diff --git a/docs/_static/ble/feature_status/developing202606.svg b/docs/_static/ble/feature_status/developing202606.svg new file mode 100644 index 00000000000..c8c073d4843 --- /dev/null +++ b/docs/_static/ble/feature_status/developing202606.svg @@ -0,0 +1 @@ +In Progress: 2026/06In Progress2026/06 diff --git a/docs/en/api-guides/ble/ble-feature-support-status.rst b/docs/en/api-guides/ble/ble-feature-support-status.rst index 2f964b0579f..8adf2e14c27 100644 --- a/docs/en/api-guides/ble/ble-feature-support-status.rst +++ b/docs/en/api-guides/ble/ble-feature-support-status.rst @@ -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 @@ -233,17 +248,22 @@ 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 esp32c2 or esp32h2 |experimental| - - |unsupported| - - .. only:: esp32 or esp32c6 or esp32c2 or esp32h2 or esp32c5 + - .. only:: esp32 |unsupported| - .. only:: esp32c3 or esp32s3 + .. only:: esp32c3 or esp32s3 or esp32c6 or esp32c2 or esp32h2 + + |experimental| + - .. only:: esp32 + + |unsupported| + .. only:: esp32c3 or esp32s3 or esp32c6 or esp32c2 or esp32h |experimental| * - @@ -268,17 +288,22 @@ 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 esp32c2 or esp32h2 |experimental| - - |unsupported| - - .. only:: esp32 or esp32c6 or esp32c2 or esp32h2 or esp32c5 + - .. only:: esp32 |unsupported| - .. only:: esp32c3 or esp32s3 + .. only:: esp32c3 or esp32s3 or esp32c6 or esp32c2 or esp32h2 + + |experimental| + - .. only:: esp32 + + |unsupported| + .. only:: esp32c3 or esp32s3 or esp32c6 or esp32c2 or esp32h2 |experimental| * - @@ -290,9 +315,54 @@ If none of our chip series meet your needs, please contact `customer support tea - LE GATT Security Levels Characteristic - |NA| - |unsupported| - - |developing202412| + - |experimental| * - - Periodic Advertising with Responses + - .. only:: esp32 or esp32c3 or esp32s3 + + |unsupported| + .. only:: esp32c6 or esp32c2 or esp32h2 + + |experimental| + - .. only:: esp32 or esp32c3 or esp32s3 + + |unsupported| + .. only:: esp32c6 or esp32c2 or esp32h2 + + |experimental| + - .. only:: esp32 or esp32c3 or esp32s3 + + |unsupported| + .. only:: esp32c6 or esp32c2 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 +383,6 @@ You are encouraged to consult with our `customer support team `__ .. |5.3| replace:: `5.3 `__ .. |5.4| replace:: `5.4 `__ +.. |6.0| replace:: `6.0 `__ diff --git a/docs/en/api-guides/ble/ble-multiconnection-guide.rst b/docs/en/api-guides/ble/ble-multiconnection-guide.rst index e41d3b4b6bc..d7ad1deb81e 100644 --- a/docs/en/api-guides/ble/ble-multiconnection-guide.rst +++ b/docs/en/api-guides/ble/ble-multiconnection-guide.rst @@ -58,6 +58,6 @@ Note .. |max_nimble_connections| replace:: 70 .. only:: esp32c6 - + .. |max_bluedroid_connections| replace:: 50 .. |max_nimble_connections| replace:: 70 diff --git a/docs/en/api-guides/ble/host-feature-support-status.rst b/docs/en/api-guides/ble/host-feature-support-status.rst index 4c59d6ccdea..79fc9b45244 100644 --- a/docs/en/api-guides/ble/host-feature-support-status.rst +++ b/docs/en/api-guides/ble/host-feature-support-status.rst @@ -93,7 +93,7 @@ If none of our chip series meet your needs, please contact `customer support tea * - - Enhanced Attribute Protocol - |unsupported| - - |developing202412| + - |experimental| * - - LE Power Control - |unsupported| @@ -112,7 +112,7 @@ If none of our chip series meet your needs, please contact `customer support tea - |supported| * - .. centered:: |5.4| - Advertising Coding Selection - - |unsupported| + - |experimental| - |supported| * - - Encrypted Advertising Data @@ -120,10 +120,34 @@ If none of our chip series meet your needs, please contact `customer support tea - |experimental| * - - LE GATT Security Levels Characteristic - - |unsupported| - - |developing202412| + - |experimental| + - |experimental| * - - Periodic Advertising with Responses + - |experimental| + - |experimental| + * - .. centered:: |6.0| + - Channel Sounding + - |experimental| + - |unsupported| + * - + - LL Extended Feature Set + - |unsupported| + - |unsupported| + * - + - Decision-Based Advertising Filtering + - |unsupported| + - |unsupported| + * - + - Enhancements for ISOAL + - |unsupported| + - |unsupported| + * - + - Monitoring Advertisers + - |unsupported| + - |unsupported| + * - + - Frame Space Update - |unsupported| - |unsupported| @@ -138,8 +162,6 @@ You are encouraged to consult with our `customer support team `__ .. |5.3| replace:: `5.3 `__ .. |5.4| replace:: `5.4 `__ +.. |6.0| replace:: `6.0 `__ diff --git a/docs/zh_CN/api-guides/ble/ble-feature-support-status.rst b/docs/zh_CN/api-guides/ble/ble-feature-support-status.rst index 413d4b29094..4f44ecb5067 100644 --- a/docs/zh_CN/api-guides/ble/ble-feature-support-status.rst +++ b/docs/zh_CN/api-guides/ble/ble-feature-support-status.rst @@ -153,9 +153,24 @@ |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 @@ |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 @@ - Enhanced Attribute Protocol - |NA| - |unsupported| - - |developing202412| + - |experimental| * - - LE Power Control - .. only:: esp32 or esp32c2 @@ -233,17 +248,22 @@ |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 esp32c2 or esp32h2 |experimental| - - |unsupported| - - .. only:: esp32 or esp32c6 or esp32c2 or esp32h2 or esp32c5 + - .. only:: esp32 |unsupported| - .. only:: esp32c3 or esp32s3 + .. only:: esp32c3 or esp32s3 or esp32c6 or esp32c2 or esp32h2 + + |experimental| + - .. only:: esp32 + + |unsupported| + .. only:: esp32c3 or esp32s3 or esp32c6 or esp32c2 or esp32h2 |experimental| * - @@ -268,17 +288,22 @@ |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 esp32c2 or esp32h2 |experimental| - - |unsupported| - - .. only:: esp32 or esp32c6 or esp32c2 or esp32h2 or esp32c5 + - .. only:: esp32 |unsupported| - .. only:: esp32c3 or esp32s3 + .. only:: esp32c3 or esp32s3 or esp32c6 or esp32c2 or esp32h2 + + |experimental| + - .. only:: esp32 + + |unsupported| + .. only:: esp32c3 or esp32s3 or esp32c6 or esp32c2 or esp32h2 |experimental| * - @@ -290,9 +315,54 @@ - LE GATT Security Levels Characteristic - |NA| - |unsupported| - - |developing202412| + - |experimental| * - - Periodic Advertising with Responses + - .. only:: esp32 or esp32c3 or esp32s3 + + |unsupported| + .. only:: esp32c6 or esp32c2 or esp32h2 + + |experimental| + - .. only:: esp32 or esp32c3 or esp32s3 + + |unsupported| + .. only:: esp32c6 or esp32c2 or esp32h2 + + |experimental| + - .. only:: esp32 or esp32c3 or esp32s3 + + |unsupported| + .. only:: esp32c6 or esp32c2 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 +383,6 @@ .. |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 +403,4 @@ .. |5.2| replace:: `5.2 `__ .. |5.3| replace:: `5.3 `__ .. |5.4| replace:: `5.4 `__ +.. |6.0| replace:: `6.0 `__ diff --git a/docs/zh_CN/api-guides/ble/host-feature-support-status.rst b/docs/zh_CN/api-guides/ble/host-feature-support-status.rst index 2a549cbfe2b..90ad348a301 100644 --- a/docs/zh_CN/api-guides/ble/host-feature-support-status.rst +++ b/docs/zh_CN/api-guides/ble/host-feature-support-status.rst @@ -93,7 +93,7 @@ ESP 主机主要功能支持状态 * - - Enhanced Attribute Protocol - |unsupported| - - |developing202412| + - |experimental| * - - LE Power Control - |unsupported| @@ -112,7 +112,7 @@ ESP 主机主要功能支持状态 - |supported| * - .. centered:: |5.4| - Advertising Coding Selection - - |unsupported| + - |experimental| - |supported| * - - Encrypted Advertising Data @@ -120,10 +120,34 @@ ESP 主机主要功能支持状态 - |experimental| * - - LE GATT Security Levels Characteristic - - |unsupported| - - |developing202412| + - |experimental| + - |experimental| * - - Periodic Advertising with Responses + - |experimental| + - |experimental| + * - .. centered:: |6.0| + - Channel Sounding + - |experimental| + - |unsupported| + * - + - LL Extended Feature Set + - |unsupported| + - |unsupported| + * - + - Decision-Based Advertising Filtering + - |unsupported| + - |unsupported| + * - + - Enhancements for ISOAL + - |unsupported| + - |unsupported| + * - + - Monitoring Advertisers + - |unsupported| + - |unsupported| + * - + - Frame Space Update - |unsupported| - |unsupported| @@ -138,8 +162,6 @@ ESP 主机主要功能支持状态 .. |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 +179,4 @@ ESP 主机主要功能支持状态 .. |5.2| replace:: `5.2 `__ .. |5.3| replace:: `5.3 `__ .. |5.4| replace:: `5.4 `__ +.. |6.0| replace:: `6.0 `__ From e3a2c173c0406c0f38f692db638602050186647b Mon Sep 17 00:00:00 2001 From: Wei Yuhan Date: Tue, 21 Apr 2026 15:00:58 +0800 Subject: [PATCH 3/3] docs(ble): Updated BLE Host feature status --- .../ble/feature_status/developing202603.svg | 1 - .../ble/feature_status/developing202606.svg | 1 - .../ble/ble-feature-support-status.rst | 53 +++++++++++++------ .../ble/host-feature-support-status.rst | 53 ++++++++++++++----- .../ble/ble-feature-support-status.rst | 53 +++++++++++++------ .../ble/host-feature-support-status.rst | 53 ++++++++++++++----- 6 files changed, 154 insertions(+), 60 deletions(-) delete mode 100644 docs/_static/ble/feature_status/developing202603.svg delete mode 100644 docs/_static/ble/feature_status/developing202606.svg diff --git a/docs/_static/ble/feature_status/developing202603.svg b/docs/_static/ble/feature_status/developing202603.svg deleted file mode 100644 index ed5b6595330..00000000000 --- a/docs/_static/ble/feature_status/developing202603.svg +++ /dev/null @@ -1 +0,0 @@ -In Progress: 2026/03In Progress2026/03 diff --git a/docs/_static/ble/feature_status/developing202606.svg b/docs/_static/ble/feature_status/developing202606.svg deleted file mode 100644 index c8c073d4843..00000000000 --- a/docs/_static/ble/feature_status/developing202606.svg +++ /dev/null @@ -1 +0,0 @@ -In Progress: 2026/06In Progress2026/06 diff --git a/docs/en/api-guides/ble/ble-feature-support-status.rst b/docs/en/api-guides/ble/ble-feature-support-status.rst index 8adf2e14c27..a5ac3cec127 100644 --- a/docs/en/api-guides/ble/ble-feature-support-status.rst +++ b/docs/en/api-guides/ble/ble-feature-support-status.rst @@ -219,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| @@ -251,21 +256,30 @@ If none of our chip series meet your needs, please contact `customer support tea - .. only:: esp32 |unsupported| - .. only:: esp32c3 or esp32s3 or esp32c6 or esp32c2 or esp32h2 + .. only:: esp32c3 or esp32s3 or esp32c6 or esp32h2 |experimental| + .. only:: esp32c2 + + |unsupported| - .. only:: esp32 |unsupported| - .. only:: esp32c3 or esp32s3 or esp32c6 or esp32c2 or esp32h2 + .. only:: esp32c3 or esp32s3 or esp32c6 or esp32h2 |experimental| + .. only:: esp32c2 + + |unsupported| - .. only:: esp32 |unsupported| - .. only:: esp32c3 or esp32s3 or esp32c6 or esp32c2 or esp32h + .. only:: esp32c3 or esp32s3 or esp32c6 or esp32h2 |experimental| + .. only:: esp32c2 + + |unsupported| * - - LE Channel Classification - .. only:: esp32 or esp32c3 or esp32s3 or esp32c2 @@ -291,49 +305,58 @@ If none of our chip series meet your needs, please contact `customer support tea - .. only:: esp32 |unsupported| - .. only:: esp32c3 or esp32s3 or esp32c6 or esp32c2 or esp32h2 + .. only:: esp32c3 or esp32s3 or esp32c6 or esp32h2 |experimental| + .. only:: esp32c2 + + |unsupported| - .. only:: esp32 |unsupported| - .. only:: esp32c3 or esp32s3 or esp32c6 or esp32c2 or esp32h2 + .. only:: esp32c3 or esp32s3 or esp32c6 or esp32h2 |experimental| + .. only:: esp32c2 + + |unsupported| - .. only:: esp32 |unsupported| - .. only:: esp32c3 or esp32s3 or esp32c6 or esp32c2 or esp32h2 + .. 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| + - |experimental| - |experimental| * - - Periodic Advertising with Responses - - .. only:: esp32 or esp32c3 or esp32s3 + - .. only:: esp32 or esp32c3 or esp32s3 or esp32c2 |unsupported| - .. only:: esp32c6 or esp32c2 or esp32h2 + .. only:: esp32c6 or esp32h2 |experimental| - - .. only:: esp32 or esp32c3 or esp32s3 + - .. only:: esp32 or esp32c3 or esp32s3 or esp32c2 |unsupported| - .. only:: esp32c6 or esp32c2 or esp32h2 + .. only:: esp32c6 or esp32h2 |experimental| - - .. only:: esp32 or esp32c3 or esp32s3 + - .. only:: esp32 or esp32c3 or esp32s3 or esp32c2 |unsupported| - .. only:: esp32c6 or esp32c2 or esp32h2 + .. only:: esp32c6 or esp32h2 |experimental| * - .. centered:: |6.0| diff --git a/docs/en/api-guides/ble/host-feature-support-status.rst b/docs/en/api-guides/ble/host-feature-support-status.rst index 79fc9b45244..994d41355f5 100644 --- a/docs/en/api-guides/ble/host-feature-support-status.rst +++ b/docs/en/api-guides/ble/host-feature-support-status.rst @@ -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| @@ -96,8 +96,8 @@ If none of our chip series meet your needs, please contact `customer support tea - |experimental| * - - LE Power Control - - |unsupported| - - |supported| + - |experimental| + - |experimental| * - .. centered:: |5.3| - AdvDataInfo in Periodic Advertising - |supported| @@ -105,18 +105,33 @@ 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 - - |experimental| - - |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 @@ -124,12 +139,22 @@ If none of our chip series meet your needs, please contact `customer support tea - |experimental| * - - Periodic Advertising with Responses - - |experimental| - - |experimental| + - .. only:: esp32c2 + + |unsupported| + .. only:: not esp32c2 + + |experimental| + - .. only:: esp32c2 + + |unsupported| + .. only:: not esp32c2 + + |experimental| * - .. centered:: |6.0| - Channel Sounding - |experimental| - - |unsupported| + - |experimental| * - - LL Extended Feature Set - |unsupported| @@ -140,12 +165,12 @@ If none of our chip series meet your needs, please contact `customer support tea - |unsupported| * - - Enhancements for ISOAL - - |unsupported| - - |unsupported| + - |experimental| + - |experimental| * - - Monitoring Advertisers - |unsupported| - - |unsupported| + - |experimental| * - - Frame Space Update - |unsupported| diff --git a/docs/zh_CN/api-guides/ble/ble-feature-support-status.rst b/docs/zh_CN/api-guides/ble/ble-feature-support-status.rst index 4f44ecb5067..be5298df598 100644 --- a/docs/zh_CN/api-guides/ble/ble-feature-support-status.rst +++ b/docs/zh_CN/api-guides/ble/ble-feature-support-status.rst @@ -219,7 +219,12 @@ .. 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| @@ -251,21 +256,30 @@ - .. only:: esp32 |unsupported| - .. only:: esp32c3 or esp32s3 or esp32c6 or esp32c2 or esp32h2 + .. only:: esp32c3 or esp32s3 or esp32c6 or esp32h2 |experimental| + .. only:: esp32c2 + + |unsupported| - .. only:: esp32 |unsupported| - .. only:: esp32c3 or esp32s3 or esp32c6 or esp32c2 or esp32h2 + .. only:: esp32c3 or esp32s3 or esp32c6 or esp32h2 |experimental| + .. only:: esp32c2 + + |unsupported| - .. only:: esp32 |unsupported| - .. only:: esp32c3 or esp32s3 or esp32c6 or esp32c2 or esp32h2 + .. only:: esp32c3 or esp32s3 or esp32c6 or esp32h2 |experimental| + .. only:: esp32c2 + + |unsupported| * - - LE Channel Classification - .. only:: esp32 or esp32c3 or esp32s3 or esp32c2 @@ -291,49 +305,58 @@ - .. only:: esp32 |unsupported| - .. only:: esp32c3 or esp32s3 or esp32c6 or esp32c2 or esp32h2 + .. only:: esp32c3 or esp32s3 or esp32c6 or esp32h2 |experimental| + .. only:: esp32c2 + + |unsupported| - .. only:: esp32 |unsupported| - .. only:: esp32c3 or esp32s3 or esp32c6 or esp32c2 or esp32h2 + .. only:: esp32c3 or esp32s3 or esp32c6 or esp32h2 |experimental| + .. only:: esp32c2 + + |unsupported| - .. only:: esp32 |unsupported| - .. only:: esp32c3 or esp32s3 or esp32c6 or esp32c2 or esp32h2 + .. 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| + - |experimental| - |experimental| * - - Periodic Advertising with Responses - - .. only:: esp32 or esp32c3 or esp32s3 + - .. only:: esp32 or esp32c3 or esp32s3 or esp32c2 |unsupported| - .. only:: esp32c6 or esp32c2 or esp32h2 + .. only:: esp32c6 or esp32h2 |experimental| - - .. only:: esp32 or esp32c3 or esp32s3 + - .. only:: esp32 or esp32c3 or esp32s3 or esp32c2 |unsupported| - .. only:: esp32c6 or esp32c2 or esp32h2 + .. only:: esp32c6 or esp32h2 |experimental| - - .. only:: esp32 or esp32c3 or esp32s3 + - .. only:: esp32 or esp32c3 or esp32s3 or esp32c2 |unsupported| - .. only:: esp32c6 or esp32c2 or esp32h2 + .. only:: esp32c6 or esp32h2 |experimental| * - .. centered:: |6.0| diff --git a/docs/zh_CN/api-guides/ble/host-feature-support-status.rst b/docs/zh_CN/api-guides/ble/host-feature-support-status.rst index 90ad348a301..c25779ca3a3 100644 --- a/docs/zh_CN/api-guides/ble/host-feature-support-status.rst +++ b/docs/zh_CN/api-guides/ble/host-feature-support-status.rst @@ -72,8 +72,8 @@ ESP 主机主要功能支持状态 - |supported| * - .. centered:: |5.1| - Angle of Arrival (AoA)/Angle of Departure (AoD) - - |unsupported| - - |unsupported| + - |experimental| + - |experimental| * - - GATT Caching - |experimental| @@ -96,8 +96,8 @@ ESP 主机主要功能支持状态 - |experimental| * - - LE Power Control - - |unsupported| - - |supported| + - |experimental| + - |experimental| * - .. centered:: |5.3| - AdvDataInfo in Periodic Advertising - |supported| @@ -105,18 +105,33 @@ ESP 主机主要功能支持状态 * - - 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 - - |experimental| - - |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 @@ -124,12 +139,22 @@ ESP 主机主要功能支持状态 - |experimental| * - - Periodic Advertising with Responses - - |experimental| - - |experimental| + - .. only:: esp32c2 + + |unsupported| + .. only:: not esp32c2 + + |experimental| + - .. only:: esp32c2 + + |unsupported| + .. only:: not esp32c2 + + |experimental| * - .. centered:: |6.0| - Channel Sounding - |experimental| - - |unsupported| + - |experimental| * - - LL Extended Feature Set - |unsupported| @@ -140,12 +165,12 @@ ESP 主机主要功能支持状态 - |unsupported| * - - Enhancements for ISOAL - - |unsupported| - - |unsupported| + - |experimental| + - |experimental| * - - Monitoring Advertisers - |unsupported| - - |unsupported| + - |experimental| * - - Frame Space Update - |unsupported|