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/_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 a5ac3cec127..f395fb41271 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,127 @@ 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 - |experimental| - .. only:: esp32 or esp32c3 or esp32s3 or esp32c6 or esp32c2 + 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 + + |supported| + .. only:: not SOC_BLE_CTE_SUPPORTED |unsupported| - - .. only:: esp32h2 + - .. only:: SOC_BLE_CTE_SUPPORTED - |experimental| - .. only:: esp32 or esp32c3 or esp32s3 or esp32c6 or esp32c2 + |supported| + .. only:: not SOC_BLE_CTE_SUPPORTED |unsupported| - - .. only:: esp32h2 + - .. only:: SOC_BLE_CTE_SUPPORTED - |experimental| - .. only:: esp32 or esp32c3 or esp32s3 or esp32c6 or esp32c2 + |supported| + .. only:: not SOC_BLE_CTE_SUPPORTED |unsupported| * - @@ -178,34 +183,54 @@ If none of our chip series meet your needs, please contact `customer support tea - |experimental| * - - Randomized Advertising Channel Indexing - - |unsupported| + - .. only:: esp32c2 or not SOC_ESP_NIMBLE_CONTROLLER + + |unsupported| + .. only:: SOC_ESP_NIMBLE_CONTROLLER and not esp32c2 + + |experimental| - |NA| - |NA| * - - Periodic Advertising Sync Transfer - - .. only:: esp32 or esp32c3 or esp32s3 - - |unsupported| - .. only:: esp32c6 or esp32h2 or esp32c2 or esp32c5 + - .. only:: SOC_ESP_NIMBLE_CONTROLLER |supported| - - .. only:: esp32 or esp32c3 or esp32s3 + .. only:: not SOC_ESP_NIMBLE_CONTROLLER |unsupported| - .. only:: esp32c6 or esp32h2 or esp32c2 or esp32c5 + - .. only:: SOC_ESP_NIMBLE_CONTROLLER |supported| - - .. only:: esp32 or esp32c3 or esp32s3 + .. only:: not SOC_ESP_NIMBLE_CONTROLLER |unsupported| - .. only:: esp32c6 or esp32h2 or esp32c2 or esp32c5 + - .. only:: SOC_ESP_NIMBLE_CONTROLLER |supported| + .. only:: not SOC_ESP_NIMBLE_CONTROLLER + + |unsupported| * - .. centered:: |5.2| - LE Isochronous Channels (BIS/CIS) - - |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| * - - Enhanced Attribute Protocol - |NA| @@ -213,120 +238,102 @@ 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 esp32c3 or esp32s3 or esp32c5 + - .. only:: SOC_BLE_POWER_CONTROL_SUPPORTED |experimental| - - .. only:: esp32 or esp32c2 + .. only:: not SOC_BLE_POWER_CONTROL_SUPPORTED |unsupported| - .. only:: esp32c6 or esp32h2 or esp32c3 or esp32s3 or esp32c5 + - .. only:: SOC_BLE_POWER_CONTROL_SUPPORTED |experimental| - - .. only:: esp32 or esp32c2 + .. only:: not SOC_BLE_POWER_CONTROL_SUPPORTED |unsupported| - .. only:: esp32c6 or esp32h2 or esp32c3 or esp32s3 or esp32c5 + - .. 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 esp32c5 + - .. 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 esp32c5 - - |supported| - - .. only:: esp32 or esp32c3 or esp32s3 - - |unsupported| - .. only:: esp32c6 or esp32c2 or esp32h2 or esp32c5 + - .. 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 - - |unsupported| - .. only:: esp32c3 or esp32s3 or esp32c6 or esp32h2 + - .. only:: SOC_BLE_SUBRATE_SUPPORTED |experimental| - .. only:: esp32c2 + .. only:: not SOC_BLE_SUBRATE_SUPPORTED |unsupported| - - .. only:: esp32 - - |unsupported| - .. only:: esp32c3 or esp32s3 or esp32c6 or esp32h2 + - .. only:: SOC_BLE_SUBRATE_SUPPORTED |experimental| - .. only:: esp32c2 + .. only:: not SOC_BLE_SUBRATE_SUPPORTED |unsupported| - - .. only:: esp32 - - |unsupported| - .. only:: esp32c3 or esp32s3 or esp32c6 or esp32h2 + - .. only:: SOC_BLE_SUBRATE_SUPPORTED |experimental| - .. only:: esp32c2 + .. only:: not SOC_BLE_SUBRATE_SUPPORTED |unsupported| * - - LE Channel Classification - - .. only:: esp32 or esp32c3 or esp32s3 or esp32c2 - - |unsupported| - .. only:: esp32c6 or esp32h2 or esp32c5 + - .. 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 esp32c5 + - .. 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 esp32c5 + - .. 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 - - |unsupported| - .. only:: esp32c3 or esp32s3 or esp32c6 or esp32h2 + - .. only:: (SOC_ESP_NIMBLE_CONTROLLER or esp32c3 or esp32s3) and not esp32c2 |experimental| - .. only:: esp32c2 + .. only:: not ((SOC_ESP_NIMBLE_CONTROLLER or esp32c3 or esp32s3) and not esp32c2) |unsupported| - - .. only:: esp32 - - |unsupported| - .. only:: esp32c3 or esp32s3 or esp32c6 or esp32h2 + - .. only:: (SOC_ESP_NIMBLE_CONTROLLER or esp32c3 or esp32s3) and not esp32c2 |experimental| - .. only:: esp32c2 + .. only:: not ((SOC_ESP_NIMBLE_CONTROLLER or esp32c3 or esp32s3) and not esp32c2) |unsupported| - - .. only:: esp32 - - |unsupported| - .. only:: esp32c3 or esp32s3 or esp32c6 or esp32h2 + - .. only:: (SOC_ESP_NIMBLE_CONTROLLER or esp32c3 or esp32s3) and not esp32c2 |experimental| - .. only:: esp32c2 + .. only:: not ((SOC_ESP_NIMBLE_CONTROLLER or esp32c3 or esp32s3) and not esp32c2) |unsupported| * - @@ -337,28 +344,28 @@ If none of our chip series meet your needs, please contact `customer support tea * - - LE GATT Security Levels Characteristic - |NA| - - |experimental| + - |unsupported| - |experimental| * - - Periodic Advertising with Responses - - .. only:: esp32 or esp32c3 or esp32s3 or esp32c2 - - |unsupported| - .. only:: esp32c6 or esp32h2 + - .. 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 + - .. 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 + - .. only:: SOC_BLE_PERIODIC_ADV_WITH_RESPONSE |experimental| + .. only:: not SOC_BLE_PERIODIC_ADV_WITH_RESPONSE + + |unsupported| * - .. centered:: |6.0| - Channel Sounding - |unsupported| @@ -366,9 +373,24 @@ If none of our chip series meet your needs, please contact `customer support tea - |unsupported| * - - LL Extended Feature Set - - |unsupported| - - |unsupported| - - |unsupported| + - .. only:: SOC_ESP_NIMBLE_CONTROLLER and not esp32c2 + + |developing202612| + .. only:: not SOC_ESP_NIMBLE_CONTROLLER or esp32c2 + + |unsupported| + - .. only:: SOC_ESP_NIMBLE_CONTROLLER and not esp32c2 + + |developing202612| + .. only:: not SOC_ESP_NIMBLE_CONTROLLER or esp32c2 + + |unsupported| + - .. only:: SOC_ESP_NIMBLE_CONTROLLER and not esp32c2 + + |developing202612| + .. only:: not SOC_ESP_NIMBLE_CONTROLLER or esp32c2 + + |unsupported| * - - Decision-Based Advertising Filtering - |unsupported| @@ -376,16 +398,86 @@ 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 + + |developing202612| + .. only:: not SOC_ESP_NIMBLE_CONTROLLER or esp32c2 + + |unsupported| + - .. only:: SOC_ESP_NIMBLE_CONTROLLER and not esp32c2 + + |developing202612| + .. only:: not SOC_ESP_NIMBLE_CONTROLLER or esp32c2 + + |unsupported| + - .. only:: SOC_ESP_NIMBLE_CONTROLLER and not esp32c2 + + |developing202612| + .. only:: not SOC_ESP_NIMBLE_CONTROLLER or esp32c2 + + |unsupported| + * - + - Frame Space Update + - |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| * - - - Frame Space Update + - 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| @@ -394,6 +486,11 @@ If none of our chip series meet your needs, please contact `customer support tea 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 ` . @@ -406,6 +503,9 @@ 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 994d41355f5..573f8c7ffd4 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| @@ -157,8 +157,8 @@ If none of our chip series meet your needs, please contact `customer support tea - |experimental| * - - LL Extended Feature Set - - |unsupported| - - |unsupported| + - |experimental| + - |developing202612| * - - Decision-Based Advertising Filtering - |unsupported| @@ -169,12 +169,44 @@ If none of our chip series meet your needs, please contact `customer support tea - |experimental| * - - Monitoring Advertisers - - |unsupported| + - |experimental| - |experimental| * - - 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, @@ -187,6 +219,9 @@ 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 be5298df598..061d04529d1 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 @@ -53,122 +53,127 @@ - |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 - |experimental| - .. only:: esp32 or esp32c3 or esp32s3 or esp32c6 or esp32c2 + 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 + + |supported| + .. only:: not SOC_BLE_CTE_SUPPORTED |unsupported| - - .. only:: esp32h2 + - .. only:: SOC_BLE_CTE_SUPPORTED - |experimental| - .. only:: esp32 or esp32c3 or esp32s3 or esp32c6 or esp32c2 + |supported| + .. only:: not SOC_BLE_CTE_SUPPORTED |unsupported| - - .. only:: esp32h2 + - .. only:: SOC_BLE_CTE_SUPPORTED - |experimental| - .. only:: esp32 or esp32c3 or esp32s3 or esp32c6 or esp32c2 + |supported| + .. only:: not SOC_BLE_CTE_SUPPORTED |unsupported| * - @@ -178,34 +183,54 @@ - |experimental| * - - Randomized Advertising Channel Indexing - - |unsupported| + - .. only:: esp32c2 or not SOC_ESP_NIMBLE_CONTROLLER + + |unsupported| + .. only:: SOC_ESP_NIMBLE_CONTROLLER and not esp32c2 + + |experimental| - |NA| - |NA| * - - Periodic Advertising Sync Transfer - - .. only:: esp32 or esp32c3 or esp32s3 - - |unsupported| - .. only:: esp32c6 or esp32h2 or esp32c2 or esp32c5 + - .. only:: SOC_ESP_NIMBLE_CONTROLLER |supported| - - .. only:: esp32 or esp32c3 or esp32s3 + .. only:: not SOC_ESP_NIMBLE_CONTROLLER |unsupported| - .. only:: esp32c6 or esp32h2 or esp32c2 or esp32c5 + - .. only:: SOC_ESP_NIMBLE_CONTROLLER |supported| - - .. only:: esp32 or esp32c3 or esp32s3 + .. only:: not SOC_ESP_NIMBLE_CONTROLLER |unsupported| - .. only:: esp32c6 or esp32h2 or esp32c2 or esp32c5 + - .. only:: SOC_ESP_NIMBLE_CONTROLLER |supported| + .. only:: not SOC_ESP_NIMBLE_CONTROLLER + + |unsupported| * - .. centered:: |5.2| - LE Isochronous Channels (BIS/CIS) - - |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| * - - Enhanced Attribute Protocol - |NA| @@ -213,120 +238,102 @@ - |experimental| * - - LE Power Control - - .. only:: esp32 or esp32c2 - - |unsupported| - .. only:: esp32c6 or esp32h2 or esp32c3 or esp32s3 or esp32c5 + - .. only:: SOC_BLE_POWER_CONTROL_SUPPORTED |experimental| - - .. only:: esp32 or esp32c2 + .. only:: not SOC_BLE_POWER_CONTROL_SUPPORTED |unsupported| - .. only:: esp32c6 or esp32h2 or esp32c3 or esp32s3 or esp32c5 + - .. only:: SOC_BLE_POWER_CONTROL_SUPPORTED |experimental| - - .. only:: esp32 or esp32c2 + .. only:: not SOC_BLE_POWER_CONTROL_SUPPORTED |unsupported| - .. only:: esp32c6 or esp32h2 or esp32c3 or esp32s3 or esp32c5 + - .. 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 esp32c5 + - .. 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 esp32c5 - - |supported| - - .. only:: esp32 or esp32c3 or esp32s3 - - |unsupported| - .. only:: esp32c6 or esp32c2 or esp32h2 or esp32c5 + - .. 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 - - |unsupported| - .. only:: esp32c3 or esp32s3 or esp32c6 or esp32h2 + - .. only:: SOC_BLE_SUBRATE_SUPPORTED |experimental| - .. only:: esp32c2 + .. only:: not SOC_BLE_SUBRATE_SUPPORTED |unsupported| - - .. only:: esp32 - - |unsupported| - .. only:: esp32c3 or esp32s3 or esp32c6 or esp32h2 + - .. only:: SOC_BLE_SUBRATE_SUPPORTED |experimental| - .. only:: esp32c2 + .. only:: not SOC_BLE_SUBRATE_SUPPORTED |unsupported| - - .. only:: esp32 - - |unsupported| - .. only:: esp32c3 or esp32s3 or esp32c6 or esp32h2 + - .. only:: SOC_BLE_SUBRATE_SUPPORTED |experimental| - .. only:: esp32c2 + .. only:: not SOC_BLE_SUBRATE_SUPPORTED |unsupported| * - - LE Channel Classification - - .. only:: esp32 or esp32c3 or esp32s3 or esp32c2 - - |unsupported| - .. only:: esp32c6 or esp32h2 or esp32c5 + - .. 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 esp32c5 + - .. 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 esp32c5 + - .. 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 - - |unsupported| - .. only:: esp32c3 or esp32s3 or esp32c6 or esp32h2 + - .. only:: (SOC_ESP_NIMBLE_CONTROLLER or esp32c3 or esp32s3) and not esp32c2 |experimental| - .. only:: esp32c2 + .. only:: not ((SOC_ESP_NIMBLE_CONTROLLER or esp32c3 or esp32s3) and not esp32c2) |unsupported| - - .. only:: esp32 - - |unsupported| - .. only:: esp32c3 or esp32s3 or esp32c6 or esp32h2 + - .. only:: (SOC_ESP_NIMBLE_CONTROLLER or esp32c3 or esp32s3) and not esp32c2 |experimental| - .. only:: esp32c2 + .. only:: not ((SOC_ESP_NIMBLE_CONTROLLER or esp32c3 or esp32s3) and not esp32c2) |unsupported| - - .. only:: esp32 - - |unsupported| - .. only:: esp32c3 or esp32s3 or esp32c6 or esp32h2 + - .. only:: (SOC_ESP_NIMBLE_CONTROLLER or esp32c3 or esp32s3) and not esp32c2 |experimental| - .. only:: esp32c2 + .. only:: not ((SOC_ESP_NIMBLE_CONTROLLER or esp32c3 or esp32s3) and not esp32c2) |unsupported| * - @@ -337,28 +344,28 @@ * - - LE GATT Security Levels Characteristic - |NA| - - |experimental| + - |unsupported| - |experimental| * - - Periodic Advertising with Responses - - .. only:: esp32 or esp32c3 or esp32s3 or esp32c2 - - |unsupported| - .. only:: esp32c6 or esp32h2 + - .. 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 + - .. 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 + - .. only:: SOC_BLE_PERIODIC_ADV_WITH_RESPONSE |experimental| + .. only:: not SOC_BLE_PERIODIC_ADV_WITH_RESPONSE + + |unsupported| * - .. centered:: |6.0| - Channel Sounding - |unsupported| @@ -366,9 +373,24 @@ - |unsupported| * - - LL Extended Feature Set - - |unsupported| - - |unsupported| - - |unsupported| + - .. only:: SOC_ESP_NIMBLE_CONTROLLER and not esp32c2 + + |developing202612| + .. only:: not SOC_ESP_NIMBLE_CONTROLLER or esp32c2 + + |unsupported| + - .. only:: SOC_ESP_NIMBLE_CONTROLLER and not esp32c2 + + |developing202612| + .. only:: not SOC_ESP_NIMBLE_CONTROLLER or esp32c2 + + |unsupported| + - .. only:: SOC_ESP_NIMBLE_CONTROLLER and not esp32c2 + + |developing202612| + .. only:: not SOC_ESP_NIMBLE_CONTROLLER or esp32c2 + + |unsupported| * - - Decision-Based Advertising Filtering - |unsupported| @@ -376,16 +398,86 @@ - |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 + + |developing202612| + .. only:: not SOC_ESP_NIMBLE_CONTROLLER or esp32c2 + + |unsupported| + - .. only:: SOC_ESP_NIMBLE_CONTROLLER and not esp32c2 + + |developing202612| + .. only:: not SOC_ESP_NIMBLE_CONTROLLER or esp32c2 + + |unsupported| + - .. only:: SOC_ESP_NIMBLE_CONTROLLER and not esp32c2 + + |developing202612| + .. only:: not SOC_ESP_NIMBLE_CONTROLLER or esp32c2 + + |unsupported| + * - + - Frame Space Update + - |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| * - - - Frame Space Update + - 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| @@ -394,6 +486,11 @@ 如果想了解支持功能的 Bluetooth SIG 认证状态， 请查阅 `SIG 蓝牙产品数据库 `__ 。 +.. only:: esp32h2 + + .. [2] + 注意： 在 ESP32-H2 上，当低功耗蓝牙连接启用加密时，不支持面向连接的低功耗蓝牙测向（AoA/AoD）功能。 + 对于大部分开发需要在控制器 (Controller) 完成的功能，其主机层 (Host) 的支持状态将会受限于控制器层的支持状态。 如果你计划将乐鑫低功耗蓝牙控制器和主机跑在不同的乐鑫芯片上，则主机的功能将不再受限于这颗跑主机的芯片上的控制器的功能支持状态， 请参阅 :doc:`ESP 主机主要功能支持状态 ` 。 @@ -406,6 +503,9 @@ .. |supported| image:: ../../../_static/ble/feature_status/supported.svg :class: align-center :width: 65px +.. |developing202612| image:: ../../../_static/ble/feature_status/developing202612.svg + :class: align-center + :width: 125px .. |unsupported| image:: ../../../_static/ble/feature_status/unsupported.svg :class: align-center :width: 75px @@ -427,3 +527,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 c25779ca3a3..d2f5e8db314 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| @@ -157,8 +157,8 @@ ESP 主机主要功能支持状态 - |experimental| * - - LL Extended Feature Set - - |unsupported| - - |unsupported| + - |experimental| + - |developing202612| * - - Decision-Based Advertising Filtering - |unsupported| @@ -169,12 +169,44 @@ ESP 主机主要功能支持状态 - |experimental| * - - Monitoring Advertisers - - |unsupported| + - |experimental| - |experimental| * - - 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 认证状态， @@ -187,6 +219,9 @@ ESP 主机主要功能支持状态 .. |supported| image:: ../../../_static/ble/feature_status/supported.svg :class: align-center +.. |developing202612| image:: ../../../_static/ble/feature_status/developing202612.svg + :class: align-center + :width: 125px .. |unsupported| image:: ../../../_static/ble/feature_status/unsupported.svg :class: align-center .. |experimental| image:: ../../../_static/ble/feature_status/experimental.svg @@ -205,3 +240,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 `__