[nrf fromtree] pm: s/power-domain/power-domains and add power-domain-names

Some devices may belong to >1 power domain, so with the current design
this is something not possible to describe. It's worth to note that
Linux also uses the `power-domains` naming scheme, not `power-domain`.
This patch also introduces `power-domain-names` so that each entry in
`power-domains` can be given a name if needed. `#power-domain-cells`
is now required as well.

Signed-off-by: Gerard Marull-Paretas <[email protected]>
(cherry picked from commit f989711)

Author: gmarull

doc/services/pm/device_runtime.rst

@@ -26,7 +26,7 @@ asynchronously, it will be put into the
 :c:enumerator:`PM_DEVICE_STATE_SUSPENDING` state first and then into the
 :c:enumerator:`PM_DEVICE_STATE_SUSPENDED` state when the action is run.
 
-For devices on a power domain (via the devicetree 'power-domain' property), device runtime
+For devices on a power domain (via the devicetree 'power-domains' property), device runtime
 power management automatically attempts to request and release the dependent domain
 in response to :c:func:`pm_device_runtime_get` and :c:func:`pm_device_runtime_put`
 calls on the child device.

doc/services/pm/power_domain.rst

@@ -131,13 +131,13 @@ Devices belonging to this device can be declared referring it in the
         &gpio0 {
                 compatible = "zephyr,gpio-emul";
                 gpio-controller;
-                power-domain = <&gpio_domain>;
+                power-domains = <&gpio_domain>;
         };
 
         &gpio1 {
                 compatible = "zephyr,gpio-emul";
                 gpio-controller;
-                power-domain = <&gpio_domain>;
+                power-domains = <&gpio_domain>;
         };
 
 All devices under a domain will be notified when the domain changes

dts/bindings/base/base.yaml

@@ -93,6 +93,18 @@ properties:
     type: string-array
     description: Provided names of mailbox / IPM channel specifiers
 
+  power-domains:
+    type: phandle-array
+    description: Power domain specifiers
+
+  power-domain-names:
+    type: string-array
+    description: Provided names of power domain specifiers
+
+  "#power-domain-cells":
+    type: int
+    description: Number of cells in power-domains property
+
   zephyr,deferred-init:
     type: boolean
     description: |

dts/bindings/base/pm.yaml

@@ -16,15 +16,6 @@ properties:
       Wake up capable devices are disabled (interruptions will not wake up
       the system) by default but they can be enabled at runtime if necessary.
 
-  power-domain:
-    type: phandle
-    description: |
-
-      Power domain the device belongs to.
-
-      The device will be notified when the power domain it belongs to is either
-      suspended or resumed.
-
   zephyr,pm-device-runtime-auto:
     type: boolean
     description: |

dts/bindings/power-domain/intel,adsp-power-domain.yaml

@@ -17,3 +17,6 @@ properties:
       read_address (PWRSTS) to set power active or confirm power active
       for a desired domain.
       Same for write and read addresses
+
+  "#power-domain-cells":
+    const: 0

dts/bindings/power-domain/nxp,scu-pd.yaml

@@ -15,3 +15,6 @@ properties:
       Number used by the firmware running on the SCU to identify
       the resource on which the PD-related operations are to be
       performed.
+
+  "#power-domain-cells":
+    const: 0

dts/bindings/power-domain/power-domain-gpio-monitor.yaml

@@ -20,3 +20,6 @@ properties:
     required: true
     description: |
       GPIO to use to sense if rail is powered on.
+
+  "#power-domain-cells":
+    const: 0

dts/bindings/power-domain/power-domain-gpio.yaml

@@ -28,3 +28,6 @@ properties:
     type: int
     default: 0
     description: Off delay time, in microseconds
+
+  "#power-domain-cells":
+    const: 0

dts/bindings/power-domain/power-domain.yaml

@@ -6,3 +6,7 @@ description: Properties for power domains
 compatible: "power-domain"
 
 include: base.yaml
+
+properties:
+  "#power-domain-cells":
+    const: 0

dts/xtensa/intel/intel_adsp_ace15_mtpm.dtsi

@@ -150,7 +150,7 @@
 			fifo = <0x0008>;
 			interrupts = <0x08 0 0>;
 			interrupt-parent = <&ace_intc>;
-			power-domain = <&hub_ulp_domain>;
+			power-domains = <&hub_ulp_domain>;
 		};
 
 		dmic1: dmic1@10000 {
@@ -160,7 +160,7 @@
 			fifo = <0x0108>;
 			interrupts = <0x09 0 0>;
 			interrupt-parent = <&ace_intc>;
-			power-domain = <&hub_ulp_domain>;
+			power-domains = <&hub_ulp_domain>;
 		};
 
 		/*
@@ -285,7 +285,7 @@
 			dmas = <&lpgpdma0 2
 					&lpgpdma0 3>;
 			dma-names = "tx", "rx";
-			power-domain = <&io0_domain>;
+			power-domains = <&io0_domain>;
 			ssp-index = <0>;
 			status = "okay";
 
@@ -307,7 +307,7 @@
 			dmas = <&lpgpdma0 4
 					&lpgpdma0 5>;
 			dma-names = "tx", "rx";
-			power-domain = <&io0_domain>;
+			power-domains = <&io0_domain>;
 			ssp-index = <1>;
 			status = "okay";
 
@@ -329,7 +329,7 @@
 			dmas = <&lpgpdma0 6
 					&lpgpdma0 7>;
 			dma-names = "tx", "rx";
-			power-domain = <&io0_domain>;
+			power-domains = <&io0_domain>;
 			ssp-index = <2>;
 			status = "okay";
 
@@ -387,38 +387,47 @@
 			hub_ulp_domain: hub_ulp_domain {
 				compatible = "intel,adsp-power-domain";
 				bit-position = <15>;
+				#power-domain-cells = <0>;
 			};
 			ml1_domain: ml1_domain {
 				compatible = "intel,adsp-power-domain";
 				bit-position = <13>;
+				#power-domain-cells = <0>;
 			};
 			ml0_domain: ml0_domain {
 				compatible = "intel,adsp-power-domain";
 				bit-position = <12>;
+				#power-domain-cells = <0>;
 			};
 			io3_domain: io3_domain {
 				compatible = "intel,adsp-power-domain";
 				bit-position = <11>;
+				#power-domain-cells = <0>;
 			};
 			io2_domain: io2_domain {
 				compatible = "intel,adsp-power-domain";
 				bit-position = <10>;
+				#power-domain-cells = <0>;
 			};
 			io1_domain: io1_domain {
 				compatible = "intel,adsp-power-domain";
 				bit-position = <9>;
+				#power-domain-cells = <0>;
 			};
 			io0_domain: io0_domain {
 				compatible = "intel,adsp-power-domain";
 				bit-position = <8>;
+				#power-domain-cells = <0>;
 			};
 			hub_hp_domain: hub_hp_domain {
 				compatible = "intel,adsp-power-domain";
 				bit-position = <6>;
+				#power-domain-cells = <0>;
 			};
 			hst_domain: hst_domain {
 				compatible = "intel,adsp-power-domain";
 				bit-position = <4>;
+				#power-domain-cells = <0>;
 			};
 		};
 
@@ -464,7 +473,7 @@
 			dma-buf-addr-alignment = <128>;
 			dma-buf-size-alignment = <32>;
 			dma-copy-alignment = <16>;
-			power-domain = <&io0_domain>;
+			power-domains = <&io0_domain>;
 			status = "okay";
 		};
 
@@ -476,7 +485,7 @@
 			dma-buf-addr-alignment = <128>;
 			dma-buf-size-alignment = <32>;
 			dma-copy-alignment = <16>;
-			power-domain = <&io0_domain>;
+			power-domains = <&io0_domain>;
 			status = "okay";
 		};
 
@@ -488,7 +497,7 @@
 			dma-buf-addr-alignment = <128>;
 			dma-buf-size-alignment = <32>;
 			dma-copy-alignment = <16>;
-			power-domain = <&hst_domain>;
+			power-domains = <&hst_domain>;
 			interrupts = <13 0 0>;
 			interrupt-parent = <&ace_intc>;
 			status = "okay";
@@ -502,7 +511,7 @@
 			dma-buf-addr-alignment = <128>;
 			dma-buf-size-alignment = <32>;
 			dma-copy-alignment = <16>;
-			power-domain = <&hst_domain>;
+			power-domains = <&hst_domain>;
 			interrupts = <12 0 0>;
 			interrupt-parent = <&ace_intc>;
 			status = "okay";
@@ -541,7 +550,7 @@
 			dma-buf-size-alignment = <4>;
 			dma-copy-alignment = <4>;
 			status = "okay";
-			power-domain = <&hub_ulp_domain>;
+			power-domains = <&hub_ulp_domain>;
 			zephyr,pm-device-runtime-auto;
 		};
 
@@ -555,7 +564,7 @@
 			dma-buf-size-alignment = <4>;
 			dma-copy-alignment = <4>;
 			status = "okay";
-			power-domain = <&io0_domain>;
+			power-domains = <&io0_domain>;
 			zephyr,pm-device-runtime-auto;
 		};
 
@@ -568,7 +577,7 @@
 			interrupt-parent = <&core_intc>;
 			dma-buf-size-alignment = <4>;
 			dma-copy-alignment = <4>;
-			power-domain = <&io0_domain>;
+			power-domains = <&io0_domain>;
 			status = "okay";
 			zephyr,pm-device-runtime-auto;
 		};