From cfd47ad13abb6db0d4105198633c77ff07dfef3d Mon Sep 17 00:00:00 2001 From: Wei Yuhan Date: Thu, 2 Jul 2026 10:45:31 +0800 Subject: [PATCH 1/3] feat(docs): Updated BLE support features status --- .../ble/feature_status/developing202612.svg | 1 + .../ble/ble-feature-support-status.rst | 263 +++++++++--------- .../ble/host-feature-support-status.rst | 15 +- .../ble/ble-feature-support-status.rst | 263 +++++++++--------- .../ble/host-feature-support-status.rst | 15 +- 5 files changed, 287 insertions(+), 270 deletions(-) create mode 100644 docs/_static/ble/feature_status/developing202612.svg diff --git a/docs/_static/ble/feature_status/developing202612.svg b/docs/_static/ble/feature_status/developing202612.svg new file mode 100644 index 00000000000..3f2d4343bcc --- /dev/null +++ b/docs/_static/ble/feature_status/developing202612.svg @@ -0,0 +1 @@ +In Progress: 2026/12In Progress2026/12 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 a78debbf674..8010e978cdc 100644 --- a/docs/en/api-guides/ble/ble-feature-support-status.rst +++ b/docs/en/api-guides/ble/ble-feature-support-status.rst @@ -53,122 +53,122 @@ If none of our chip series meet your needs, please contact `customer support tea - |supported| * - .. centered:: |5.0| - 2 Msym/s PHY for LE - - .. only:: esp32 - - |unsupported| - .. only:: not esp32 + - .. only:: SOC_BLE_50_SUPPORTED |supported| - - .. only:: esp32 + .. only:: not SOC_BLE_50_SUPPORTED |unsupported| - .. only:: not esp32 + - .. only:: SOC_BLE_50_SUPPORTED |supported| - - .. only:: esp32 + .. only:: not SOC_BLE_50_SUPPORTED |unsupported| - .. only:: not esp32 + - .. only:: SOC_BLE_50_SUPPORTED |supported| + .. only:: not SOC_BLE_50_SUPPORTED + + |unsupported| * - - LE Long Range (Coded PHY S=2/S=8) - - .. only:: esp32 - - |unsupported| - .. only:: not esp32 + - .. only:: SOC_BLE_50_SUPPORTED |supported| - - .. only:: esp32 + .. only:: not SOC_BLE_50_SUPPORTED |unsupported| - .. only:: not esp32 + - .. only:: SOC_BLE_50_SUPPORTED |supported| - - .. only:: esp32 + .. only:: not SOC_BLE_50_SUPPORTED |unsupported| - .. only:: not esp32 + - .. only:: SOC_BLE_50_SUPPORTED |supported| + .. only:: not SOC_BLE_50_SUPPORTED + + |unsupported| * - - High Duty Cycle Non-Connectable Advertising - - .. only:: esp32 - - |unsupported| - .. only:: not esp32 + - .. only:: SOC_BLE_50_SUPPORTED |supported| - - .. only:: esp32 + .. only:: not SOC_BLE_50_SUPPORTED |unsupported| - .. only:: not esp32 + - .. only:: SOC_BLE_50_SUPPORTED |supported| - - .. only:: esp32 + .. only:: not SOC_BLE_50_SUPPORTED |unsupported| - .. only:: not esp32 + - .. only:: SOC_BLE_50_SUPPORTED |supported| + .. only:: not SOC_BLE_50_SUPPORTED + + |unsupported| * - - LE Advertising Extensions - - .. only:: esp32 - - |unsupported| - .. only:: not esp32 + - .. only:: SOC_BLE_50_SUPPORTED |supported| - - .. only:: esp32 + .. only:: not SOC_BLE_50_SUPPORTED |unsupported| - .. only:: not esp32 + - .. only:: SOC_BLE_50_SUPPORTED |supported| - - .. only:: esp32 + .. only:: not SOC_BLE_50_SUPPORTED |unsupported| - .. only:: not esp32 + - .. only:: SOC_BLE_50_SUPPORTED |supported| + .. only:: not SOC_BLE_50_SUPPORTED + + |unsupported| * - - LE Channel Selection Algorithm #2 - - .. only:: esp32 - - |unsupported| - .. only:: not esp32 + - .. only:: SOC_BLE_50_SUPPORTED |supported| - - .. only:: esp32 + .. only:: not SOC_BLE_50_SUPPORTED |unsupported| - .. only:: not esp32 + - .. only:: SOC_BLE_50_SUPPORTED |supported| - - .. only:: esp32 + .. only:: not SOC_BLE_50_SUPPORTED |unsupported| - .. only:: not esp32 + - .. only:: SOC_BLE_50_SUPPORTED |supported| + .. only:: not SOC_BLE_50_SUPPORTED + + |unsupported| * - .. centered:: |5.1| - Angle of Arrival (AoA)/Angle of Departure (AoD) - - .. only:: esp32h2 or esp32h21 or esp32c5 or esp32c61 + - .. only:: SOC_BLE_CTE_SUPPORTED |experimental| - .. only:: esp32 or esp32c3 or esp32s3 or esp32c6 or esp32c2 + .. only:: not SOC_BLE_CTE_SUPPORTED |unsupported| - - .. only:: esp32h2 or esp32h21 or esp32c5 or esp32c61 + - .. only:: SOC_BLE_CTE_SUPPORTED |experimental| - .. only:: esp32 or esp32c3 or esp32s3 or esp32c6 or esp32c2 + .. only:: not SOC_BLE_CTE_SUPPORTED |unsupported| - - .. only:: esp32h2 or esp32h21 or esp32c5 or esp32c61 + - .. only:: SOC_BLE_CTE_SUPPORTED |experimental| - .. only:: esp32 or esp32c3 or esp32s3 or esp32c6 or esp32c2 + .. only:: not SOC_BLE_CTE_SUPPORTED |unsupported| * - @@ -183,7 +183,7 @@ If none of our chip series meet your needs, please contact `customer support tea |unsupported| .. only:: not esp32c2 - |developing202603| + |experimental| - .. only:: esp32c2 |unsupported| @@ -198,27 +198,32 @@ If none of our chip series meet your needs, please contact `customer support tea |NA| * - - Periodic Advertising Sync Transfer - - .. only:: esp32 or esp32c3 or esp32s3 - - |unsupported| - .. only:: esp32c6 or esp32h2 or esp32h21 or esp32c2 or esp32c5 or esp32c61 + - .. only:: SOC_BLE_PERIODIC_ADV_ENH_SUPPORTED |supported| - - .. only:: esp32 or esp32c3 or esp32s3 + .. only:: not SOC_BLE_PERIODIC_ADV_ENH_SUPPORTED |unsupported| - .. only:: esp32c6 or esp32h2 or esp32h21 or esp32c2 or esp32c5 or esp32c61 + - .. only:: SOC_BLE_PERIODIC_ADV_ENH_SUPPORTED |supported| - - .. only:: esp32 or esp32c3 or esp32s3 + .. only:: not SOC_BLE_PERIODIC_ADV_ENH_SUPPORTED |unsupported| - .. only:: esp32c6 or esp32h2 or esp32h21 or esp32c2 or esp32c5 or esp32c61 + - .. only:: SOC_BLE_PERIODIC_ADV_ENH_SUPPORTED |supported| + .. only:: not SOC_BLE_PERIODIC_ADV_ENH_SUPPORTED + + |unsupported| * - .. centered:: |5.2| - LE Isochronous Channels (BIS/CIS) - - |unsupported| + - .. only:: SOC_BLE_ISO_SUPPORTED + + |experimental| + .. only:: not SOC_BLE_ISO_SUPPORTED + + |unsupported| - |unsupported| - |unsupported| * - @@ -228,104 +233,104 @@ If none of our chip series meet your needs, please contact `customer support tea - |experimental| * - - LE Power Control - - .. only:: esp32 or esp32c2 - - |unsupported| - .. only:: esp32c6 or esp32h2 or esp32h21 or esp32c3 or esp32s3 or esp32c5 or esp32c61 + - .. only:: SOC_BLE_POWER_CONTROL_SUPPORTED |experimental| - - .. only:: esp32 or esp32c2 + .. only:: not SOC_BLE_POWER_CONTROL_SUPPORTED |unsupported| - .. only:: esp32c6 or esp32h2 or esp32h21 or esp32c3 or esp32s3 or esp32c5 or esp32c61 + - .. only:: SOC_BLE_POWER_CONTROL_SUPPORTED |experimental| - - .. only:: esp32 or esp32c2 + .. only:: not SOC_BLE_POWER_CONTROL_SUPPORTED |unsupported| - .. only:: esp32c6 or esp32h2 or esp32h21 or esp32c3 or esp32s3 or esp32c5 or esp32c61 + - .. only:: SOC_BLE_POWER_CONTROL_SUPPORTED |experimental| + .. only:: not SOC_BLE_POWER_CONTROL_SUPPORTED + + |unsupported| * - .. centered:: |5.3| - AdvDataInfo in Periodic Advertising - - .. only:: esp32 or esp32c3 or esp32s3 - - |unsupported| - .. only:: esp32c6 or esp32c2 or esp32h2 or esp32h21 or esp32c5 or esp32c61 + - .. only:: SOC_BLE_PERIODIC_ADV_ENH_SUPPORTED |supported| - - .. only:: esp32 or esp32c3 or esp32s3 + .. only:: not SOC_BLE_PERIODIC_ADV_ENH_SUPPORTED |unsupported| - .. only:: esp32c6 or esp32c2 or esp32h2 or esp32h21 or esp32c5 or esp32c61 - - |supported| - - .. only:: esp32 or esp32c3 or esp32s3 - - |unsupported| - .. only:: esp32c6 or esp32c2 or esp32h2 or esp32h21 or esp32c5 or esp32c61 + - .. only:: SOC_BLE_PERIODIC_ADV_ENH_SUPPORTED |supported| + .. only:: not SOC_BLE_PERIODIC_ADV_ENH_SUPPORTED + + |unsupported| + - .. only:: SOC_BLE_PERIODIC_ADV_ENH_SUPPORTED + + |supported| + .. only:: not SOC_BLE_PERIODIC_ADV_ENH_SUPPORTED + + |unsupported| * - - LE Enhanced Connection Update (Connection Subrating) - - .. only:: esp32 or esp32c2 - - |unsupported| - .. only:: esp32c3 or esp32s3 or esp32c6 or esp32h2 or esp32h21 or esp32c5 or esp32c61 + - .. only:: SOC_BLE_SUBRATE_SUPPORTED |experimental| - - .. only:: esp32 or esp32c2 + .. only:: not SOC_BLE_SUBRATE_SUPPORTED |unsupported| - .. only:: esp32c3 or esp32s3 or esp32c6 or esp32h2 or esp32h21 or esp32c5 or esp32c61 + - .. only:: SOC_BLE_SUBRATE_SUPPORTED |experimental| - - .. only:: esp32 or esp32c2 + .. only:: not SOC_BLE_SUBRATE_SUPPORTED |unsupported| - .. only:: esp32c3 or esp32s3 or esp32c6 or esp32h2 or esp32h21 or esp32c5 or esp32c61 + - .. only:: SOC_BLE_SUBRATE_SUPPORTED |experimental| + .. only:: not SOC_BLE_SUBRATE_SUPPORTED + + |unsupported| * - - LE Channel Classification - - .. only:: esp32 or esp32c3 or esp32s3 or esp32c2 - - |unsupported| - .. only:: esp32c6 or esp32h2 or esp32h21 or esp32c5 or esp32c61 + - .. only:: SOC_ESP_NIMBLE_CONTROLLER and not esp32c2 |experimental| - - .. only:: esp32 or esp32c3 or esp32s3 or esp32c2 + .. only:: not SOC_ESP_NIMBLE_CONTROLLER or esp32c2 |unsupported| - .. only:: esp32c6 or esp32h2 or esp32h21 or esp32c5 or esp32c61 + - .. only:: SOC_ESP_NIMBLE_CONTROLLER and not esp32c2 |experimental| - - .. only:: esp32 or esp32c3 or esp32s3 or esp32c2 + .. only:: not SOC_ESP_NIMBLE_CONTROLLER or esp32c2 |unsupported| - .. only:: esp32c6 or esp32h2 or esp32h21 or esp32c5 or esp32c61 + - .. only:: SOC_ESP_NIMBLE_CONTROLLER and not esp32c2 |experimental| + .. only:: not SOC_ESP_NIMBLE_CONTROLLER or esp32c2 + + |unsupported| * - .. centered:: |5.4| - Advertising Coding Selection - - .. only:: esp32 or esp32c2 - - |unsupported| - .. only:: esp32c3 or esp32s3 or esp32c6 or esp32h2 or esp32h21 or esp32c5 or esp32c61 + - .. only:: (SOC_ESP_NIMBLE_CONTROLLER or esp32c3 or esp32s3) and not esp32c2 |experimental| - - .. only:: esp32 or esp32c2 + .. only:: not ((SOC_ESP_NIMBLE_CONTROLLER or esp32c3 or esp32s3) and not esp32c2) |unsupported| - .. only:: esp32c3 or esp32s3 or esp32c6 or esp32h2 or esp32h21 or esp32c5 or esp32c61 + - .. only:: (SOC_ESP_NIMBLE_CONTROLLER or esp32c3 or esp32s3) and not esp32c2 |experimental| - - .. only:: esp32 or esp32c2 + .. only:: not ((SOC_ESP_NIMBLE_CONTROLLER or esp32c3 or esp32s3) and not esp32c2) |unsupported| - .. only:: esp32c3 or esp32s3 or esp32c6 or esp32h2 or esp32h21 or esp32c5 or esp32c61 + - .. only:: (SOC_ESP_NIMBLE_CONTROLLER or esp32c3 or esp32s3) and not esp32c2 |experimental| + .. only:: not ((SOC_ESP_NIMBLE_CONTROLLER or esp32c3 or esp32s3) and not esp32c2) + + |unsupported| * - - Encrypted Advertising Data - |NA| @@ -338,24 +343,24 @@ If none of our chip series meet your needs, please contact `customer support tea - |experimental| * - - Periodic Advertising with Responses - - .. only:: esp32 or esp32c3 or esp32s3 or esp32c2 - - |unsupported| - .. only:: esp32c6 or esp32h2 or esp32h21 or esp32c5 or esp32c61 + - .. only:: SOC_BLE_PERIODIC_ADV_WITH_RESPONSE |experimental| - - .. only:: esp32 or esp32c3 or esp32s3 or esp32c2 + .. only:: not SOC_BLE_PERIODIC_ADV_WITH_RESPONSE |unsupported| - .. only:: esp32c6 or esp32h2 or esp32h21 or esp32c5 or esp32c61 + - .. only:: SOC_BLE_PERIODIC_ADV_WITH_RESPONSE |experimental| - - .. only:: esp32 or esp32c3 or esp32s3 or esp32c2 + .. only:: not SOC_BLE_PERIODIC_ADV_WITH_RESPONSE |unsupported| - .. only:: esp32c6 or esp32h2 or esp32h21 or esp32c5 or esp32c61 + - .. only:: SOC_BLE_PERIODIC_ADV_WITH_RESPONSE |experimental| + .. only:: not SOC_BLE_PERIODIC_ADV_WITH_RESPONSE + + |unsupported| * - .. centered:: |6.0| - Channel Sounding - |unsupported| @@ -363,24 +368,24 @@ If none of our chip series meet your needs, please contact `customer support tea - |unsupported| * - - LL Extended Feature Set - - .. only:: esp32 or esp32c3 or esp32s3 or esp32c2 + - .. only:: SOC_ESP_NIMBLE_CONTROLLER and not esp32c2 + + |developing202612| + .. only:: not SOC_ESP_NIMBLE_CONTROLLER or esp32c2 |unsupported| - .. only:: esp32c6 or esp32h2 or esp32h21 or esp32c5 or esp32c61 + - .. only:: SOC_ESP_NIMBLE_CONTROLLER and not esp32c2 - |developing202606| - - .. only:: esp32 or esp32c3 or esp32s3 or esp32c2 + |developing202612| + .. only:: not SOC_ESP_NIMBLE_CONTROLLER or esp32c2 |unsupported| - .. only:: esp32c6 or esp32h2 or esp32h21 or esp32c5 or esp32c61 + - .. only:: SOC_ESP_NIMBLE_CONTROLLER and not esp32c2 - |developing202606| - - .. only:: esp32 or esp32c3 or esp32s3 or esp32c2 + |developing202612| + .. only:: not SOC_ESP_NIMBLE_CONTROLLER or esp32c2 |unsupported| - .. only:: esp32c6 or esp32h2 or esp32h21 or esp32c5 or esp32c61 - - |developing202606| * - - Decision-Based Advertising Filtering - |unsupported| @@ -393,24 +398,24 @@ If none of our chip series meet your needs, please contact `customer support tea - |unsupported| * - - Monitoring Advertisers - - .. only:: esp32 or esp32c3 or esp32s3 or esp32c2 + - .. only:: SOC_ESP_NIMBLE_CONTROLLER and not esp32c2 + + |developing202612| + .. only:: not SOC_ESP_NIMBLE_CONTROLLER or esp32c2 |unsupported| - .. only:: esp32c6 or esp32h2 or esp32h21 or esp32c5 or esp32c61 + - .. only:: SOC_ESP_NIMBLE_CONTROLLER and not esp32c2 - |developing202606| - - .. only:: esp32 or esp32c3 or esp32s3 or esp32c2 + |developing202612| + .. only:: not SOC_ESP_NIMBLE_CONTROLLER or esp32c2 |unsupported| - .. only:: esp32c6 or esp32h2 or esp32h21 or esp32c5 or esp32c61 + - .. only:: SOC_ESP_NIMBLE_CONTROLLER and not esp32c2 - |developing202606| - - .. only:: esp32 or esp32c3 or esp32s3 or esp32c2 + |developing202612| + .. only:: not SOC_ESP_NIMBLE_CONTROLLER or esp32c2 |unsupported| - .. only:: esp32c6 or esp32h2 or esp32h21 or esp32c5 or esp32c61 - - |developing202606| * - - Frame Space Update - |unsupported| @@ -439,7 +444,7 @@ You are encouraged to consult with our `customer support team Date: Thu, 6 Aug 2026 12:29:34 +0800 Subject: [PATCH 2/3] feat(docs): update BLE feature support status for ISO and Core 6.1-6.3 Mark ISOAL/ISO features as experimental when SOC_BLE_ISO_SUPPORTED, add unsupported Core Spec 6.1-6.3 features, and move NimBLE LL Extended Feature Set target to 2026/12. --- .../ble/ble-feature-support-status.rst | 96 +++++++++++++++++-- .../ble/host-feature-support-status.rst | 44 +++++++-- .../ble/ble-feature-support-status.rst | 96 +++++++++++++++++-- .../ble/host-feature-support-status.rst | 44 +++++++-- 4 files changed, 250 insertions(+), 30 deletions(-) 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 8010e978cdc..f9829e072b4 100644 --- a/docs/en/api-guides/ble/ble-feature-support-status.rst +++ b/docs/en/api-guides/ble/ble-feature-support-status.rst @@ -152,22 +152,27 @@ If none of our chip series meet your needs, please contact `customer support tea |unsupported| * - .. centered:: |5.1| - - Angle of Arrival (AoA)/Angle of Departure (AoD) + - .. only:: esp32h2 + + Angle of Arrival (AoA)/Angle of Departure (AoD) [2]_ + .. only:: not esp32h2 + + Angle of Arrival (AoA)/Angle of Departure (AoD) - .. only:: SOC_BLE_CTE_SUPPORTED - |experimental| + |supported| .. only:: not SOC_BLE_CTE_SUPPORTED |unsupported| - .. only:: SOC_BLE_CTE_SUPPORTED - |experimental| + |supported| .. only:: not SOC_BLE_CTE_SUPPORTED |unsupported| - .. only:: SOC_BLE_CTE_SUPPORTED - |experimental| + |supported| .. only:: not SOC_BLE_CTE_SUPPORTED |unsupported| @@ -224,8 +229,18 @@ If none of our chip series meet your needs, please contact `customer support tea .. only:: not SOC_BLE_ISO_SUPPORTED |unsupported| - - |unsupported| - - |unsupported| + - .. only:: SOC_BLE_ISO_SUPPORTED + + |experimental| + .. only:: not SOC_BLE_ISO_SUPPORTED + + |unsupported| + - .. only:: SOC_BLE_ISO_SUPPORTED + + |experimental| + .. only:: not SOC_BLE_ISO_SUPPORTED + + |unsupported| * - - Enhanced Attribute Protocol - |NA| @@ -393,9 +408,24 @@ If none of our chip series meet your needs, please contact `customer support tea - |unsupported| * - - Enhancements for ISOAL - - |unsupported| - - |unsupported| - - |unsupported| + - .. only:: SOC_BLE_ISO_SUPPORTED + + |experimental| + .. only:: not SOC_BLE_ISO_SUPPORTED + + |unsupported| + - .. only:: SOC_BLE_ISO_SUPPORTED + + |experimental| + .. only:: not SOC_BLE_ISO_SUPPORTED + + |unsupported| + - .. only:: SOC_BLE_ISO_SUPPORTED + + |experimental| + .. only:: not SOC_BLE_ISO_SUPPORTED + + |unsupported| * - - Monitoring Advertisers - .. only:: SOC_ESP_NIMBLE_CONTROLLER and not esp32c2 @@ -421,11 +451,56 @@ If none of our chip series meet your needs, please contact `customer support tea - |unsupported| - |unsupported| - |unsupported| + * - .. centered:: |6.1| + - Randomized Resolvable Private Address (RPA) Updates + - |unsupported| + - |unsupported| + - |unsupported| + * - .. centered:: |6.2| + - HCI USB LE Isochronous Support + - |unsupported| + - |unsupported| + - |unsupported| + * - + - LE Test Mode Enhancements + - |unsupported| + - |unsupported| + - |unsupported| + * - + - Shorter Connection Intervals + - |unsupported| + - |unsupported| + - |unsupported| + * - + - Channel Sounding Amplitude-based Attack Resilience + - |unsupported| + - |unsupported| + - |unsupported| + * - .. centered:: |6.3| + - Channel Sounding Inline Phase Correction Term Transfer + - |unsupported| + - |unsupported| + - |unsupported| + * - + - Channel Sounding PHY-specific RTT Accuracy + - |unsupported| + - |unsupported| + - |unsupported| + * - + - Running Out of Bits + - |unsupported| + - |unsupported| + - |unsupported| .. [1] If you would like to know the Bluetooth SIG certification information for supported features, please consult `SIG Bluetooth Product Database `__. +.. only:: esp32h2 + + .. [2] + Note: On ESP32-H2, connection-oriented Bluetooth LE Direction Finding (AoA/AoD) is not supported when the Bluetooth LE connection is encrypted. + For certain features, if the majority of the development is completed on the Controller, the Host's support status will be limited by the Controller's support status. If you want Bluetooth LE Controller and Host to run on different Espressif chips, the functionality of the Host will not be limited by the Controller's support status on the chip running the Host, please check the :doc:`ESP Host Feature Support Status Table ` . @@ -468,3 +543,6 @@ You are encouraged to consult with our `customer support team `__ .. |5.4| replace:: `5.4 `__ .. |6.0| replace:: `6.0 `__ +.. |6.1| replace:: `6.1 `__ +.. |6.2| replace:: `6.2 `__ +.. |6.3| replace:: `6.3 `__ 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 1a8ced8cbaf..94313a0d910 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) - - |experimental| - - |experimental| + - |supported| + - |supported| * - - GATT Caching - |experimental| @@ -133,7 +133,7 @@ If none of our chip series meet your needs, please contact `customer support tea * - - LL Extended Feature Set - |experimental| - - |developing202606| + - |developing202612| * - - Decision-Based Advertising Filtering - |unsupported| @@ -150,6 +150,38 @@ If none of our chip series meet your needs, please contact `customer support tea - Frame Space Update - |unsupported| - |unsupported| + * - .. centered:: |6.1| + - Randomized Resolvable Private Address (RPA) Updates + - |unsupported| + - |unsupported| + * - .. centered:: |6.2| + - HCI USB LE Isochronous Support + - |unsupported| + - |unsupported| + * - + - LE Test Mode Enhancements + - |unsupported| + - |unsupported| + * - + - Shorter Connection Intervals + - |unsupported| + - |unsupported| + * - + - Channel Sounding Amplitude-based Attack Resilience + - |unsupported| + - |unsupported| + * - .. centered:: |6.3| + - Channel Sounding Inline Phase Correction Term Transfer + - |unsupported| + - |unsupported| + * - + - Channel Sounding PHY-specific RTT Accuracy + - |unsupported| + - |unsupported| + * - + - Running Out of Bits + - |unsupported| + - |unsupported| .. [1] If you would like to know the Bluetooth SIG certification information for supported features, @@ -168,9 +200,6 @@ You are encouraged to consult with our `customer support team `__ .. |5.4| replace:: `5.4 `__ .. |6.0| replace:: `6.0 `__ +.. |6.1| replace:: `6.1 `__ +.. |6.2| replace:: `6.2 `__ +.. |6.3| replace:: `6.3 `__ 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 b08ca448fc6..a46c0855b1b 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 @@ -152,22 +152,27 @@ |unsupported| * - .. centered:: |5.1| - - Angle of Arrival (AoA)/Angle of Departure (AoD) + - .. only:: esp32h2 + + Angle of Arrival (AoA)/Angle of Departure (AoD) [2]_ + .. only:: not esp32h2 + + Angle of Arrival (AoA)/Angle of Departure (AoD) - .. only:: SOC_BLE_CTE_SUPPORTED - |experimental| + |supported| .. only:: not SOC_BLE_CTE_SUPPORTED |unsupported| - .. only:: SOC_BLE_CTE_SUPPORTED - |experimental| + |supported| .. only:: not SOC_BLE_CTE_SUPPORTED |unsupported| - .. only:: SOC_BLE_CTE_SUPPORTED - |experimental| + |supported| .. only:: not SOC_BLE_CTE_SUPPORTED |unsupported| @@ -224,8 +229,18 @@ .. only:: not SOC_BLE_ISO_SUPPORTED |unsupported| - - |unsupported| - - |unsupported| + - .. only:: SOC_BLE_ISO_SUPPORTED + + |experimental| + .. only:: not SOC_BLE_ISO_SUPPORTED + + |unsupported| + - .. only:: SOC_BLE_ISO_SUPPORTED + + |experimental| + .. only:: not SOC_BLE_ISO_SUPPORTED + + |unsupported| * - - Enhanced Attribute Protocol - |NA| @@ -393,9 +408,24 @@ - |unsupported| * - - Enhancements for ISOAL - - |unsupported| - - |unsupported| - - |unsupported| + - .. only:: SOC_BLE_ISO_SUPPORTED + + |experimental| + .. only:: not SOC_BLE_ISO_SUPPORTED + + |unsupported| + - .. only:: SOC_BLE_ISO_SUPPORTED + + |experimental| + .. only:: not SOC_BLE_ISO_SUPPORTED + + |unsupported| + - .. only:: SOC_BLE_ISO_SUPPORTED + + |experimental| + .. only:: not SOC_BLE_ISO_SUPPORTED + + |unsupported| * - - Monitoring Advertisers - .. only:: SOC_ESP_NIMBLE_CONTROLLER and not esp32c2 @@ -421,11 +451,56 @@ - |unsupported| - |unsupported| - |unsupported| + * - .. centered:: |6.1| + - Randomized Resolvable Private Address (RPA) Updates + - |unsupported| + - |unsupported| + - |unsupported| + * - .. centered:: |6.2| + - HCI USB LE Isochronous Support + - |unsupported| + - |unsupported| + - |unsupported| + * - + - LE Test Mode Enhancements + - |unsupported| + - |unsupported| + - |unsupported| + * - + - Shorter Connection Intervals + - |unsupported| + - |unsupported| + - |unsupported| + * - + - Channel Sounding Amplitude-based Attack Resilience + - |unsupported| + - |unsupported| + - |unsupported| + * - .. centered:: |6.3| + - Channel Sounding Inline Phase Correction Term Transfer + - |unsupported| + - |unsupported| + - |unsupported| + * - + - Channel Sounding PHY-specific RTT Accuracy + - |unsupported| + - |unsupported| + - |unsupported| + * - + - Running Out of Bits + - |unsupported| + - |unsupported| + - |unsupported| .. [1] 如果想了解支持功能的 Bluetooth SIG 认证状态， 请查阅 `SIG 蓝牙产品数据库 `__ 。 +.. only:: esp32h2 + + .. [2] + 注意： 在 ESP32-H2 上，当低功耗蓝牙连接启用加密时，不支持面向连接的低功耗蓝牙测向（AoA/AoD）功能。 + 对于大部分开发需要在控制器 (Controller) 完成的功能，其主机层 (Host) 的支持状态将会受限于控制器层的支持状态。 如果你计划将乐鑫低功耗蓝牙控制器和主机跑在不同的乐鑫芯片上，则主机的功能将不再受限于这颗跑主机的芯片上的控制器的功能支持状态， 请参阅 :doc:`ESP 主机主要功能支持状态 ` 。 @@ -468,3 +543,6 @@ .. |5.3| replace:: `5.3 `__ .. |5.4| replace:: `5.4 `__ .. |6.0| replace:: `6.0 `__ +.. |6.1| replace:: `6.1 `__ +.. |6.2| replace:: `6.2 `__ +.. |6.3| replace:: `6.3 `__ 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 21e1770c54a..d696bdc2cfe 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) - - |experimental| - - |experimental| + - |supported| + - |supported| * - - GATT Caching - |experimental| @@ -133,7 +133,7 @@ ESP 主机主要功能支持状态 * - - LL Extended Feature Set - |experimental| - - |developing202606| + - |developing202612| * - - Decision-Based Advertising Filtering - |unsupported| @@ -150,6 +150,38 @@ ESP 主机主要功能支持状态 - Frame Space Update - |unsupported| - |unsupported| + * - .. centered:: |6.1| + - Randomized Resolvable Private Address (RPA) Updates + - |unsupported| + - |unsupported| + * - .. centered:: |6.2| + - HCI USB LE Isochronous Support + - |unsupported| + - |unsupported| + * - + - LE Test Mode Enhancements + - |unsupported| + - |unsupported| + * - + - Shorter Connection Intervals + - |unsupported| + - |unsupported| + * - + - Channel Sounding Amplitude-based Attack Resilience + - |unsupported| + - |unsupported| + * - .. centered:: |6.3| + - Channel Sounding Inline Phase Correction Term Transfer + - |unsupported| + - |unsupported| + * - + - Channel Sounding PHY-specific RTT Accuracy + - |unsupported| + - |unsupported| + * - + - Running Out of Bits + - |unsupported| + - |unsupported| .. [1] 如果想了解支持功能的 Bluetooth SIG 认证状态， @@ -168,9 +200,6 @@ ESP 主机主要功能支持状态 .. |developing202603| image:: ../../../_static/ble/feature_status/developing202603.svg :class: align-center :width: 125px -.. |developing202606| image:: ../../../_static/ble/feature_status/developing202606.svg - :class: align-center - :width: 125px .. |developing202612| image:: ../../../_static/ble/feature_status/developing202612.svg :class: align-center :width: 125px @@ -192,3 +221,6 @@ ESP 主机主要功能支持状态 .. |5.3| replace:: `5.3 `__ .. |5.4| replace:: `5.4 `__ .. |6.0| replace:: `6.0 `__ +.. |6.1| replace:: `6.1 `__ +.. |6.2| replace:: `6.2 `__ +.. |6.3| replace:: `6.3 `__ From 7891e0d65a2871a02461b1cb6677c8163b5eb42f Mon Sep 17 00:00:00 2001 From: Wei Yuhan Date: Thu, 6 Aug 2026 14:34:24 +0800 Subject: [PATCH 3/3] feat(docs): fix PAST and randomized adv channel indexing status Gate PAST on SOC_ESP_NIMBLE_CONTROLLER, mark randomized advertising channel indexing host columns as NA, and limit controller experimental status to NimBLE controllers except ESP32-C2. --- .../ble/ble-feature-support-status.rst | 30 +++++++------------ .../ble/ble-feature-support-status.rst | 30 +++++++------------ 2 files changed, 20 insertions(+), 40 deletions(-) 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 f9829e072b4..9f4820e76b4 100644 --- a/docs/en/api-guides/ble/ble-feature-support-status.rst +++ b/docs/en/api-guides/ble/ble-feature-support-status.rst @@ -183,42 +183,32 @@ If none of our chip series meet your needs, please contact `customer support tea - |experimental| * - - Randomized Advertising Channel Indexing - - .. only:: esp32c2 + - .. only:: esp32c2 or not SOC_ESP_NIMBLE_CONTROLLER |unsupported| - .. only:: not esp32c2 + .. only:: SOC_ESP_NIMBLE_CONTROLLER and not esp32c2 |experimental| - - .. only:: esp32c2 - - |unsupported| - .. only:: not esp32c2 - - |NA| - - .. only:: esp32c2 - - |unsupported| - .. only:: not esp32c2 - - |NA| + - |NA| + - |NA| * - - Periodic Advertising Sync Transfer - - .. only:: SOC_BLE_PERIODIC_ADV_ENH_SUPPORTED + - .. only:: SOC_ESP_NIMBLE_CONTROLLER |supported| - .. only:: not SOC_BLE_PERIODIC_ADV_ENH_SUPPORTED + .. only:: not SOC_ESP_NIMBLE_CONTROLLER |unsupported| - - .. only:: SOC_BLE_PERIODIC_ADV_ENH_SUPPORTED + - .. only:: SOC_ESP_NIMBLE_CONTROLLER |supported| - .. only:: not SOC_BLE_PERIODIC_ADV_ENH_SUPPORTED + .. only:: not SOC_ESP_NIMBLE_CONTROLLER |unsupported| - - .. only:: SOC_BLE_PERIODIC_ADV_ENH_SUPPORTED + - .. only:: SOC_ESP_NIMBLE_CONTROLLER |supported| - .. only:: not SOC_BLE_PERIODIC_ADV_ENH_SUPPORTED + .. only:: not SOC_ESP_NIMBLE_CONTROLLER |unsupported| * - .. centered:: |5.2| 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 a46c0855b1b..2cf3ac92c53 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 @@ -183,42 +183,32 @@ - |experimental| * - - Randomized Advertising Channel Indexing - - .. only:: esp32c2 + - .. only:: esp32c2 or not SOC_ESP_NIMBLE_CONTROLLER |unsupported| - .. only:: not esp32c2 + .. only:: SOC_ESP_NIMBLE_CONTROLLER and not esp32c2 |experimental| - - .. only:: esp32c2 - - |unsupported| - .. only:: not esp32c2 - - |NA| - - .. only:: esp32c2 - - |unsupported| - .. only:: not esp32c2 - - |NA| + - |NA| + - |NA| * - - Periodic Advertising Sync Transfer - - .. only:: SOC_BLE_PERIODIC_ADV_ENH_SUPPORTED + - .. only:: SOC_ESP_NIMBLE_CONTROLLER |supported| - .. only:: not SOC_BLE_PERIODIC_ADV_ENH_SUPPORTED + .. only:: not SOC_ESP_NIMBLE_CONTROLLER |unsupported| - - .. only:: SOC_BLE_PERIODIC_ADV_ENH_SUPPORTED + - .. only:: SOC_ESP_NIMBLE_CONTROLLER |supported| - .. only:: not SOC_BLE_PERIODIC_ADV_ENH_SUPPORTED + .. only:: not SOC_ESP_NIMBLE_CONTROLLER |unsupported| - - .. only:: SOC_BLE_PERIODIC_ADV_ENH_SUPPORTED + - .. only:: SOC_ESP_NIMBLE_CONTROLLER |supported| - .. only:: not SOC_BLE_PERIODIC_ADV_ENH_SUPPORTED + .. only:: not SOC_ESP_NIMBLE_CONTROLLER |unsupported| * - .. centered:: |5.2|