dts: bluetooth: add base binding for BLE radio hardware capabilities

ipankr · ipankr · commit 1b7b518942ba · 2025-10-22T10:34:06.000+03:00
Create a shared base binding (ble-radio.yaml) for common Bluetooth LE
radio hardware capabilities to avoid duplication between vendors and
ensure consistent property naming across the ecosystem.

Properties are prefixed with 'ble-' and ordered chronologically by
Bluetooth Core Specification version (5.0, 5.1, 6.0). Each property
indicates a hardware capability, not current enablement state.

Signed-off-by: Ivan Pankratov &lt;ivan.pankratov@silabs.com&gt;
diff --git a/drivers/bluetooth/hci/Kconfig.silabs b/drivers/bluetooth/hci/Kconfig.silabs
@@ -25,6 +25,8 @@ config BT_SILABS_EFR32
 	select PSA_CRYPTO
 	select SILABS_SISDK_PROTOCOL_CRYPTO
 	select HAS_BT_CTLR
+
+	# Features supported by all EFR32 devices
 	select BT_CTLR_PHY_UPDATE_SUPPORT
 	select BT_CTLR_PER_INIT_FEAT_XCHG_SUPPORT
 	select BT_CTLR_DATA_LEN_UPDATE_SUPPORT
@@ -33,10 +35,22 @@ config BT_SILABS_EFR32
 	select BT_CTLR_CONN_RSSI_SUPPORT
 	select BT_CTLR_ADV_EXT_SUPPORT
 	select BT_CTLR_PRIVACY_SUPPORT
-	select BT_CTLR_PHY_2M_SUPPORT
 	select BT_CTLR_SYNC_PERIODIC_SUPPORT
 	select BT_CTLR_SYNC_TRANSFER_RECEIVER_SUPPORT
 	select BT_CTLR_SYNC_TRANSFER_SENDER_SUPPORT
+
+	# Features supported by some EFR32 devices
+	select BT_CTLR_PHY_2M_SUPPORT if HAS_HW_EFR32_RADIO_BLE_2M
+	select BT_CTLR_PHY_CODED_SUPPORT if HAS_HW_EFR32_RADIO_BLE_CODED
+	select BT_CTLR_CHANNEL_SOUNDING_SUPPORT if HAS_HW_EFR32_RADIO_CS
+	select BT_CTLR_DF_SUPPORT if HAS_HW_EFR32_RADIO_CTE_TX
+	select BT_CTLR_DF_CTE_TX_SUPPORT if HAS_HW_EFR32_RADIO_CTE_TX
+	select BT_CTLR_DF_CTE_RX_SUPPORT if HAS_HW_EFR32_RADIO_CTE_RX
+	select BT_CTLR_DF_CTE_RX_SAMPLE_1US_SUPPORT if HAS_HW_EFR32_RADIO_CTE_RX
+	select BT_CTLR_DF_ANT_SWITCH_1US_SUPPORT if HAS_HW_EFR32_RADIO_CTE_TX
+	select BT_CTLR_DF_ANT_SWITCH_2US_SUPPORT if HAS_HW_EFR32_RADIO_CTE_TX
+	select BT_SILABS_EFR32_HIGH_POWER if HAS_HW_EFR32_RADIO_TX_HIGH_POWER
+
 	help
 	  Use Silicon Labs binary Bluetooth library to connect to the
 	  controller.
@@ -100,11 +114,11 @@ config BT_SILABS_EFR32_MAX_QUEUED_ADV_REPORTS
 	  Additional advertising reports are dropped.
 
 config BT_SILABS_EFR32_HIGH_POWER
-	bool "High power transmission"
+	bool
 	help
-	  Normally the transmit power is limited to 10 dBm. Enable this option
-	  to allow the controller to transmit at higher power levels. Note that
-	  this feature is not available on all devices.
+	  Normally the transmit power is limited to 10 dBm. This option
+	  is automatically enabled on devices with high power PA support
+	  and allows the controller to transmit at higher power levels.
 
 config BT_SILABS_EFR32_HIGH_POWER_AFH
 	bool "Adaptive frequency hopping for high power transmitters"
diff --git a/dts/arm/nordic/nrf52820.dtsi b/dts/arm/nordic/nrf52820.dtsi
@@ -116,7 +116,7 @@
 			ieee802154-supported;
 			ble-2mbps-supported;
 			ble-coded-phy-supported;
-			tx-high-power-supported;
+			ble-tx-high-power-supported;
 
 			ieee802154: ieee802154 {
 				compatible = "nordic,nrf-ieee802154";
diff --git a/dts/arm/nordic/nrf52833.dtsi b/dts/arm/nordic/nrf52833.dtsi
@@ -117,7 +117,7 @@
 			ieee802154-supported;
 			ble-2mbps-supported;
 			ble-coded-phy-supported;
-			tx-high-power-supported;
+			ble-tx-high-power-supported;
 
 			ieee802154: ieee802154 {
 				compatible = "nordic,nrf-ieee802154";
diff --git a/dts/arm/nordic/nrf52840.dtsi b/dts/arm/nordic/nrf52840.dtsi
@@ -105,7 +105,7 @@
 			ieee802154-supported;
 			ble-2mbps-supported;
 			ble-coded-phy-supported;
-			tx-high-power-supported;
+			ble-tx-high-power-supported;
 
 			ieee802154: ieee802154 {
 				compatible = "nordic,nrf-ieee802154";
diff --git a/dts/arm/silabs/xg21/efr32xg21.dtsi b/dts/arm/silabs/xg21/efr32xg21.dtsi
@@ -19,6 +19,9 @@
 			pa-initial-power-dbm = <10>;
 			pa-ramp-time-us = <10>;
 			pa-voltage-mv = <3300>;
+			ble-2mbps-supported;
+			ble-coded-phy-supported;
+			ble-tx-high-power-supported;
 
 			bt_hci_silabs: bt_hci_silabs {
 				compatible = "silabs,bt-hci-efr32";
diff --git a/dts/arm/silabs/xg22/efr32xg22.dtsi b/dts/arm/silabs/xg22/efr32xg22.dtsi
@@ -20,6 +20,11 @@
 			pa-initial-power-dbm = <10>;
 			pa-ramp-time-us = <2>;
 			pa-voltage-mv = <3300>;
+			ble-2mbps-supported;
+			ble-coded-phy-supported;
+			ble-cte-tx-supported;
+			ble-cte-rx-supported;
+			ble-tx-high-power-supported;
 
 			pti: pti {
 				compatible = "silabs,pti";
diff --git a/dts/arm/silabs/xg24/efr32xg24.dtsi b/dts/arm/silabs/xg24/efr32xg24.dtsi
@@ -20,6 +20,12 @@
 			pa-initial-power-dbm = <10>;
 			pa-ramp-time-us = <10>;
 			pa-voltage-mv = <3300>;
+			ble-2mbps-supported;
+			ble-coded-phy-supported;
+			ble-cte-tx-supported;
+			ble-cte-rx-supported;
+			ble-cs-supported;
+			ble-tx-high-power-supported;
 
 			bt_hci_silabs: bt_hci_silabs {
 				compatible = "silabs,bt-hci-efr32";
diff --git a/dts/arm/silabs/xg27/efr32xg27.dtsi b/dts/arm/silabs/xg27/efr32xg27.dtsi
@@ -20,6 +20,10 @@
 			pa-initial-power-dbm = <10>;
 			pa-ramp-time-us = <2>;
 			pa-voltage-mv = <3300>;
+			ble-2mbps-supported;
+			ble-coded-phy-supported;
+			ble-cte-tx-supported;
+			ble-tx-high-power-supported;
 
 			bt_hci_silabs: bt_hci_silabs {
 				compatible = "silabs,bt-hci-efr32";
diff --git a/dts/arm/silabs/xg29/efr32xg29.dtsi b/dts/arm/silabs/xg29/efr32xg29.dtsi
@@ -20,6 +20,10 @@
 			pa-initial-power-dbm = <10>;
 			pa-ramp-time-us = <2>;
 			pa-voltage-mv = <3300>;
+			ble-2mbps-supported;
+			ble-coded-phy-supported;
+			ble-cte-tx-supported;
+			ble-tx-high-power-supported;
 
 			bt_hci_silabs: bt_hci_silabs {
 				compatible = "silabs,bt-hci-efr32";
diff --git a/dts/bindings/bluetooth/ble-radio.yaml b/dts/bindings/bluetooth/ble-radio.yaml
@@ -0,0 +1,42 @@
+# Copyright (c) 2025 Nordic Semiconductor ASA
+# Copyright (c) 2025 Silicon Laboratories Inc.
+# SPDX-License-Identifier: Apache-2.0
+
+description: |
+  Base binding for Bluetooth LE radio hardware capabilities.
+
+  These properties describe hardware-supported Bluetooth features based on
+  the Bluetooth Core Specification. They are read-only and indicate what
+  the hardware is capable of, not what features are currently enabled.
+
+properties:
+  # Bluetooth 5.0
+  ble-2mbps-supported:
+    type: boolean
+    description: |
+      2 Mbps PHY support (Bluetooth 5.0 specification).
+
+  ble-coded-phy-supported:
+    type: boolean
+    description: |
+      Coded PHY support for Long Range (Bluetooth 5.0 specification).
+
+  # Bluetooth 5.1
+  ble-cte-tx-supported:
+    type: boolean
+    description: |
+      Constant Tone Extension transmission for Direction Finding in Angle
+      of Departure mode (Bluetooth 5.1 specification).
+
+  ble-cte-rx-supported:
+    type: boolean
+    description: |
+      Constant Tone Extension reception with IQ sampling for Direction Finding
+      in Angle of Arrival mode. Requires ble-cte-tx-supported capability
+      (Bluetooth 5.1 specification).
+
+  # Bluetooth 6.0
+  ble-cs-supported:
+    type: boolean
+    description: |
+      BLE Channel Sounding feature support (Bluetooth 6.0 specification).
diff --git a/dts/bindings/net/wireless/nordic,nrf-radio.yaml b/dts/bindings/net/wireless/nordic,nrf-radio.yaml
@@ -108,7 +108,7 @@ description: |
 
 compatible: "nordic,nrf-radio"
 
-include: [base.yaml]
+include: [base.yaml, ble-radio.yaml]
 
 properties:
   reg:
@@ -212,25 +212,8 @@ properties:
       If set, indicates that the radio hardware supports the IEEE 802.15.4
       mode.
 
-  ble-2mbps-supported:
-    type: boolean
-    description: |
-      If set, indicates that the radio hardware supports the 2 Mbps BLE mode.
-
-  ble-coded-phy-supported:
-    type: boolean
-    description: |
-      If set, indicates that the radio hardware supports coded BLE PHY.
-
-  tx-high-power-supported:
+  ble-tx-high-power-supported:
     type: boolean
     description: |
       If set, indicates that the radio hardware supports high TX power
       settings.
-
-  cs-supported:
-    type: boolean
-    description: |
-      If set, the radio hardware supports the BLE Channel Sounding feature.
-      This property should be treated as read-only and should not be overridden;
-      the correct value is provided for your target's SoC already.
diff --git a/dts/bindings/net/wireless/silabs,series2-radio.yaml b/dts/bindings/net/wireless/silabs,series2-radio.yaml
@@ -8,7 +8,7 @@ description: |
 
 compatible: "silabs,series2-radio"
 
-include: [base.yaml]
+include: [base.yaml, ble-radio.yaml]
 
 properties:
   reg:
@@ -56,3 +56,12 @@ properties:
       property is not set, no sub-GHz PA is enabled.
     enum:
       - highest
+
+  ble-tx-high-power-supported:
+    type: boolean
+    description: |
+      If set, indicates that the radio hardware supports high TX power settings.
+      This is a vendor-specific capability that enables transmission beyond
+      standard power levels (typically >10 dBm).
+      This property should be treated as read-only and should not be overridden;
+      the correct value is provided for your target's SoC already.
diff --git a/dts/vendor/nordic/nrf54h20.dtsi b/dts/vendor/nordic/nrf54h20.dtsi
@@ -488,7 +488,7 @@
 				status = "disabled";
 				ble-2mbps-supported;
 				ble-coded-phy-supported;
-				cs-supported;
+				ble-cs-supported;
 				dfe-supported;
 				ieee802154-supported;
 				interrupts = <44 NRF_DEFAULT_IRQ_PRIORITY>;
diff --git a/dts/vendor/nordic/nrf54l_05_10_15.dtsi b/dts/vendor/nordic/nrf54l_05_10_15.dtsi
@@ -247,7 +247,7 @@
 				ieee802154-supported;
 				ble-2mbps-supported;
 				ble-coded-phy-supported;
-				cs-supported;
+				ble-cs-supported;
 
 				ieee802154: ieee802154 {
 					compatible = "nordic,nrf-ieee802154";
diff --git a/dts/vendor/nordic/nrf54lm20a.dtsi b/dts/vendor/nordic/nrf54lm20a.dtsi
@@ -280,7 +280,7 @@
 				ieee802154-supported;
 				ble-2mbps-supported;
 				ble-coded-phy-supported;
-				cs-supported;
+				ble-cs-supported;
 
 				ieee802154: ieee802154 {
 					compatible = "nordic,nrf-ieee802154";
diff --git a/soc/nordic/common/Kconfig.peripherals b/soc/nordic/common/Kconfig.peripherals
@@ -206,7 +206,7 @@ config HAS_HW_NRF_RADIO_BLE_CODED
 	def_bool $(dt_nodelabel_bool_prop,radio,ble-coded-phy-supported)
 
 config HAS_HW_NRF_RADIO_CS
-	def_bool $(dt_nodelabel_bool_prop,radio,cs-supported)
+	def_bool $(dt_nodelabel_bool_prop,radio,ble-cs-supported)
 
 config HAS_HW_NRF_RADIO_DFE
 	def_bool $(dt_nodelabel_bool_prop,radio,dfe-supported)
@@ -215,7 +215,7 @@ config HAS_HW_NRF_RADIO_IEEE802154
 	def_bool $(dt_nodelabel_bool_prop,radio,ieee802154-supported)
 
 config HAS_HW_NRF_RADIO_TX_PWR_HIGH
-	def_bool $(dt_nodelabel_bool_prop,radio,tx-high-power-supported)
+	def_bool $(dt_nodelabel_bool_prop,radio,ble-tx-high-power-supported)
 
 config HAS_HW_NRF_REGULATORS
 	def_bool $(dt_compat_enabled,$(DT_COMPAT_NORDIC_NRF_REGULATORS))
diff --git a/soc/silabs/silabs_s2/Kconfig b/soc/silabs/silabs_s2/Kconfig
@@ -47,4 +47,27 @@ config SILABS_DEVICE_IS_MODULE
 	bool
 	default n
 
+# Hardware capability flags (auto-detected from Device Tree)
+# Bluetooth 5.0
+config HAS_HW_EFR32_RADIO_BLE_2M
+	def_bool $(dt_nodelabel_bool_prop,radio,ble-2mbps-supported)
+
+config HAS_HW_EFR32_RADIO_BLE_CODED
+	def_bool $(dt_nodelabel_bool_prop,radio,ble-coded-phy-supported)
+
+# Bluetooth 5.1
+config HAS_HW_EFR32_RADIO_CTE_TX
+	def_bool $(dt_nodelabel_bool_prop,radio,ble-cte-tx-supported)
+
+config HAS_HW_EFR32_RADIO_CTE_RX
+	def_bool $(dt_nodelabel_bool_prop,radio,ble-cte-rx-supported) && HAS_HW_EFR32_RADIO_CTE_TX
+
+# Bluetooth 6.0
+config HAS_HW_EFR32_RADIO_CS
+	def_bool $(dt_nodelabel_bool_prop,radio,ble-cs-supported)
+
+# Vendor-specific
+config HAS_HW_EFR32_RADIO_TX_HIGH_POWER
+	def_bool $(dt_nodelabel_bool_prop,radio,ble-tx-high-power-supported)
+
 endif
