dts: arm: silabs: Add rtcc and sysrtc bindings

asmellby · cfriedt · commit a8b5ab1c1d68 · 2025-10-22T18:07:07.000-04:00
Different Series 2 devices have different RTC IPs, despite sharing
a HAL driver. Introduce separate bindings for the different IPs, and
use a chosen node to select the node to use for timekeeping.

A chosen node was selected over a nodelabel since chosen nodes can
be overridden by board-level dts and devicetree overlays, while
nodelabels can't.

Signed-off-by: Aksel Skauge Mellbye &lt;aksel.mellbye@silabs.com&gt;
diff --git a/boards/sparkfun/thing_plus_matter_mgm240p/sparkfun_thing_plus_matter_mgm240p.dts b/boards/sparkfun/thing_plus_matter_mgm240p/sparkfun_thing_plus_matter_mgm240p.dts
@@ -183,7 +183,7 @@ zephyr_i2c: &i2c0 {
 	status = "okay";
 };
 
-&stimer0 {
+&sysrtc0 {
 	status = "okay";
 };
 
diff --git a/dts/arm/silabs/siwg917.dtsi b/dts/arm/silabs/siwg917.dtsi
@@ -11,6 +11,7 @@
 
 / {
 	chosen {
+		silabs,sleeptimer = &sysrtc0;
 		zephyr,sram = &sram0;
 		zephyr,entropy = &rng0;
 		zephyr,flash = &flash0;
@@ -363,8 +364,8 @@
 			status = "disabled";
 		};
 
-		sysrtc0: stimer0: sysrtc@24048c00 {
-			compatible = "silabs,gecko-stimer";
+		sysrtc0: sysrtc@24048c00 {
+			compatible = "silabs,sysrtc";
 			reg = <0x24048c00 0x78>;
 			interrupts = <22 0>;
 			interrupt-names = "sysrtc";
diff --git a/dts/arm/silabs/xg21/xg21.dtsi b/dts/arm/silabs/xg21/xg21.dtsi
@@ -16,6 +16,7 @@
 
 / {
 	chosen {
+		silabs,sleeptimer = &rtcc0;
 		zephyr,entropy = &se;
 		zephyr,flash-controller = &msc;
 	};
@@ -448,8 +449,8 @@
 			status = "disabled";
 		};
 
-		rtcc0: stimer0: rtcc@58000000 {
-			compatible = "silabs,gecko-stimer";
+		rtcc0: rtcc@58000000 {
+			compatible = "silabs,rtcc";
 			reg = <0x58000000 0x4000>;
 			clock-frequency = <32768>;
 			clocks = <&cmu CLOCK_AUTO CLOCK_BRANCH_RTCCCLK>;
diff --git a/dts/arm/silabs/xg22/xg22.dtsi b/dts/arm/silabs/xg22/xg22.dtsi
@@ -15,6 +15,7 @@
 
 / {
 	chosen {
+		silabs,sleeptimer = &rtcc0;
 		zephyr,entropy = &trng;
 		zephyr,flash-controller = &msc;
 	};
@@ -491,8 +492,8 @@
 			status = "disabled";
 		};
 
-		rtcc0: stimer0: rtcc@58000000 {
-			compatible = "silabs,gecko-stimer";
+		rtcc0: rtcc@58000000 {
+			compatible = "silabs,rtcc";
 			reg = <0x58000000 0x4000>;
 			clock-frequency = <32768>;
 			clocks = <&cmu CLOCK_RTCC CLOCK_BRANCH_RTCCCLK>;
diff --git a/dts/arm/silabs/xg23/xg23.dtsi b/dts/arm/silabs/xg23/xg23.dtsi
@@ -15,6 +15,7 @@
 
 / {
 	chosen {
+		silabs,sleeptimer = &sysrtc0;
 		zephyr,entropy = &se;
 		zephyr,flash-controller = &msc;
 	};
@@ -511,8 +512,8 @@
 			status = "disabled";
 		};
 
-		sysrtc0: stimer0: sysrtc@500a8000 {
-			compatible = "silabs,gecko-stimer";
+		sysrtc0: sysrtc@500a8000 {
+			compatible = "silabs,sysrtc";
 			reg = <0x500a8000 0x4000>;
 			clock-frequency = <32768>;
 			clocks = <&cmu CLOCK_SYSRTC0 CLOCK_BRANCH_SYSRTCCLK>;
diff --git a/dts/arm/silabs/xg24/xg24.dtsi b/dts/arm/silabs/xg24/xg24.dtsi
@@ -15,6 +15,7 @@
 
 / {
 	chosen {
+		silabs,sleeptimer = &sysrtc0;
 		zephyr,entropy = &se;
 		zephyr,flash-controller = &msc;
 	};
@@ -494,8 +495,8 @@
 			status = "disabled";
 		};
 
-		sysrtc0: stimer0: sysrtc@500a8000 {
-			compatible = "silabs,gecko-stimer";
+		sysrtc0: sysrtc@500a8000 {
+			compatible = "silabs,sysrtc";
 			reg = <0x500a8000 0x4000>;
 			clock-frequency = <32768>;
 			clocks = <&cmu CLOCK_SYSRTC0 CLOCK_BRANCH_SYSRTCCLK>;
diff --git a/dts/arm/silabs/xg27/xg27.dtsi b/dts/arm/silabs/xg27/xg27.dtsi
@@ -15,6 +15,7 @@
 
 / {
 	chosen {
+		silabs,sleeptimer = &rtcc0;
 		zephyr,entropy = &trng;
 		zephyr,flash-controller = &msc;
 	};
@@ -491,8 +492,8 @@
 			status = "disabled";
 		};
 
-		rtcc0: stimer0: rtcc@58000000 {
-			compatible = "silabs,gecko-stimer";
+		rtcc0: rtcc@58000000 {
+			compatible = "silabs,rtcc";
 			reg = <0x58000000 0x4000>;
 			clock-frequency = <32768>;
 			clocks = <&cmu CLOCK_RTCC CLOCK_BRANCH_RTCCCLK>;
diff --git a/dts/arm/silabs/xg28/xg28.dtsi b/dts/arm/silabs/xg28/xg28.dtsi
@@ -15,6 +15,7 @@
 
 / {
 	chosen {
+		silabs,sleeptimer = &sysrtc0;
 		zephyr,entropy = &se;
 		zephyr,flash-controller = &msc;
 	};
@@ -511,8 +512,8 @@
 			status = "disabled";
 		};
 
-		sysrtc0: stimer0: sysrtc@500a8000 {
-			compatible = "silabs,gecko-stimer";
+		sysrtc0: sysrtc@500a8000 {
+			compatible = "silabs,sysrtc";
 			reg = <0x500a8000 0x4000>;
 			clock-frequency = <32768>;
 			clocks = <&cmu CLOCK_SYSRTC0 CLOCK_BRANCH_SYSRTCCLK>;
diff --git a/dts/arm/silabs/xg29/xg29.dtsi b/dts/arm/silabs/xg29/xg29.dtsi
@@ -14,6 +14,7 @@
 
 / {
 	chosen {
+		silabs,sleeptimer = &rtcc0;
 		zephyr,entropy = &se;
 		zephyr,flash-controller = &msc;
 	};
@@ -505,8 +506,8 @@
 			status = "disabled";
 		};
 
-		rtcc0: stimer0: rtcc@58000000 {
-			compatible = "silabs,gecko-stimer";
+		rtcc0: rtcc@58000000 {
+			compatible = "silabs,rtcc";
 			reg = <0x58000000 0x4000>;
 			clock-frequency = <32768>;
 			clocks = <&cmu CLOCK_RTCC CLOCK_BRANCH_RTCCCLK>;
diff --git a/dts/bindings/rtc/silabs,rtcc.yaml b/dts/bindings/rtc/silabs,rtcc.yaml
@@ -0,0 +1,16 @@
+# Copyright (c) 2025 Silicon Laboratories Inc.
+# SPDX-License-Identifier: Apache-2.0
+
+title: Silicon Labs Series 2 RTCC (Real Time Clock with Capture)
+
+description: |
+  The Real Time Clock with Capture (RTCC) is a 32-bit counter kept running down to energy mode EM3.
+  It can be used as an EM2/3 wakeup source as well as a timekeeping counter during low energy mode.
+
+compatible: "silabs,rtcc"
+
+include: rtc.yaml
+
+properties:
+  reg:
+    required: true
diff --git a/dts/bindings/rtc/silabs,sysrtc.yaml b/dts/bindings/rtc/silabs,sysrtc.yaml
@@ -0,0 +1,18 @@
+# Copyright (c) 2025 Silicon Laboratories Inc.
+# SPDX-License-Identifier: Apache-2.0
+
+title: Silicon Labs Series 2 SYSRTC (System Real Time Clock)
+
+description: |
+  The SYSRTC (System Real Time Counter) is a 32-bit counter kept running down to energy mode EM3.
+  It can be used as a sleep timer / wakeup source as well as a timekeeping counter during low energy
+  modes. Multiple groups of capture / compare registers are available to different cores in the
+  system, allowing the peripheral and time base to be shared across cores and save energy.
+
+compatible: "silabs,sysrtc"
+
+include: rtc.yaml
+
+properties:
+  reg:
+    required: true
