dts: bindings: clock: nrf54l-hfxo: add startup-time-us prop

bjarki-andreasen · kartben · commit bb8ef777fbf8 · 2025-05-28T17:49:41.000+02:00
Add the clock startup time property to the nrf54l series HFXO binding.

Note that the values added to the soc .dtsi files are worst case
defaults, which will be replaced with optimal values at board level
in the future, as they depend on the specific crystal in use.

Signed-off-by: Bjarki Arge Andreasen &lt;bjarki.andreasen@nordicsemi.no&gt;
diff --git a/dts/bindings/clock/nordic,nrf54l-hfxo.yaml b/dts/bindings/clock/nordic,nrf54l-hfxo.yaml
@@ -11,6 +11,20 @@ properties:
   clock-frequency:
     const: 32000000
 
+  startup-time-us:
+    type: int
+    required: true
+    description: |
+      Startup time in microseconds.
+
+      The value can be obtained by first measuring the time between
+      TASKS_XOSTART and EVENTS_XOTUNED. Then multiply the value by 2 to
+      account for temperature and supply variations.
+
+      Note that the startup time will be longer usual on the first
+      power-up and as such should not be used to determine
+      startup-time-us.
+
   load-capacitors:
     type: string
     enum:
diff --git a/dts/vendor/nordic/nrf54l09.dtsi b/dts/vendor/nordic/nrf54l09.dtsi
@@ -65,6 +65,7 @@
 			compatible = "nordic,nrf54l-hfxo";
 			#clock-cells = <0>;
 			clock-frequency = <DT_FREQ_M(32)>;
+			startup-time-us = <1650>;
 		};
 
 		hfpll: hfpll {
diff --git a/dts/vendor/nordic/nrf54l20.dtsi b/dts/vendor/nordic/nrf54l20.dtsi
@@ -64,6 +64,7 @@
 			compatible = "nordic,nrf54l-hfxo";
 			#clock-cells = <0>;
 			clock-frequency = <DT_FREQ_M(32)>;
+			startup-time-us = <1650>;
 		};
 
 		hfpll: hfpll {
diff --git a/dts/vendor/nordic/nrf54l_05_10_15.dtsi b/dts/vendor/nordic/nrf54l_05_10_15.dtsi
@@ -65,6 +65,7 @@
 			compatible = "nordic,nrf54l-hfxo";
 			#clock-cells = <0>;
 			clock-frequency = <DT_FREQ_M(32)>;
+			startup-time-us = <1650>;
 		};
 
 		hfpll: hfpll {
