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