[nrf fromlist] dts: nordic: Add support for clock outputs

Add support for GRTC clock output pins.

Upstream PR #: 82788

Signed-off-by: Adam Kondraciuk <[email protected]>

Author: adamkondraciuk

boards/nordic/nrf54h20dk/nrf54h20dk_nrf54h20-pinctrl.dtsi

@@ -98,4 +98,22 @@
 			low-power-enable;
 		};
 	};
+
+	/omit-if-no-ref/ grtc_default: grtc_default {
+		group1 {
+			psels = <NRF_PSEL(GRTC_CLKOUT_FAST, 1, 8)>;
+		};
+		group2 {
+			psels = <NRF_PSEL(GRTC_CLKOUT_32K, 0, 1)>;
+		};
+	};
+
+	/omit-if-no-ref/ grtc_sleep: grtc_sleep {
+		group1 {
+			psels = <NRF_PSEL(GRTC_CLKOUT_FAST, 1, 8)>;
+		};
+		group2 {
+			psels = <NRF_PSEL(GRTC_CLKOUT_32K, 0, 1)>;
+		};
+	};
 };

boards/nordic/nrf54h20dk/nrf54h20dk_nrf54h20_cpuapp.dts

@@ -232,6 +232,7 @@ ipc0: &cpuapp_cpurad_ipc {
 	child-owned-channels = <5 6>;
 	nonsecure-channels = <5 6>;
 	owned-channels = <4 5 6>;
+	base-frequency = <DT_FREQ_M(16)>;
 };
 
 &uart120 {

boards/nordic/nrf54l15dk/nrf54l15dk_nrf54l_05_10_15-pinctrl.dtsi

@@ -77,4 +77,22 @@
 			low-power-enable;
 		};
 	};
+
+	/omit-if-no-ref/ grtc_default: grtc_default {
+		group1 {
+			psels = <NRF_PSEL(GRTC_CLKOUT_FAST, 1, 8)>;
+		};
+		group2 {
+			psels = <NRF_PSEL(GRTC_CLKOUT_32K, 0, 4)>;
+		};
+	};
+
+	/omit-if-no-ref/ grtc_sleep: grtc_sleep {
+		group1 {
+			psels = <NRF_PSEL(GRTC_CLKOUT_FAST, 1, 8)>;
+		};
+		group2 {
+			psels = <NRF_PSEL(GRTC_CLKOUT_32K, 0, 4)>;
+		};
+	};
 };

boards/nordic/nrf54l15dk/nrf54l_05_10_15_cpuapp_common.dtsi

@@ -49,6 +49,7 @@
 	/* Channels 7-11 reserved for Zero Latency IRQs, 3-4 for FLPR */
 	child-owned-channels = <3 4 7 8 9 10 11>;
 	status = "okay";
+	base-frequency = <DT_FREQ_M(16)>;
 };
 
 &uart20 {

dts/bindings/timer/nordic,nrf-grtc.yaml

@@ -4,18 +4,53 @@
 # SPDX-License-Identifier: Apache-2.0
 #
 
-description: Nordic GRTC (Global RTC)
+description: |
+  Nordic GRTC (Global RTC)
+
+      Example of using clock outputs:
+        &grtc {
+          pinctrl-0 = <&grtc_default>;
+          pinctrl-1 = <&grtc_sleep>;
+          pinctrl-names = "default", "sleep";
+          clkout-fast-frequency = <8000000>;
+          clkout-32k-frequency = <32768>;
+          /* In case of nRF54H20 devices: */
+          nordic,clockpin-enable = <NRF_FUN_GRTC_CLKOUT_FAST>;
+        };
 
 compatible: "nordic,nrf-grtc"
 
 include:
   - "base.yaml"
   - "nordic,split-channels.yaml"
+  - "pinctrl-device.yaml"
+  - "nordic-clockpin.yaml"
 
 properties:
   reg:
     required: true
 
+  pinctrl-0:
+    required: false
+
+  pinctrl-names:
+    required: false
+
+  base-frequency:
+    type: int
+    description: base clock frequency.
+    required: true
+
+  clkout-fast-frequency:
+    type: int
+    description: Fast output clock frequency.
+
+  clkout-32k-frequency:
+    type: int
+    description: Slow output clock frequency.
+    enum:
+      - 32768
+
   interrupts:
     required: true