new file mode 100644
@@ -0,0 +1,84 @@
+NXP i.MX Power Domain Based on SCFW
+--------------------------------------------------------------------
+
+Some i.MX SoCs contain a system controller that is responsible for
+controlling the state of the IPs that are present.
+Communication between the host processor running an OS and the system
+controller happens through a SCU protocol [1].
+
+[1] Documentation/devicetree/bindings/arm/freescale/fsl,scu.txt
+
+Required Properties:
+--------------------
+- compatible: should be "nxp,<soc>-pd".
+ Supported SoCs: imx8qxp and imx8qm.
+- #power-domain-cells: Must be 0
+- #address-cells: Should be 1.
+- #size-cells: Should be 0.
+
+Optional Properties:
+- reg: Resource ID of this power domain.
+ No exist means uncontrollable by user.
+ See detailed Resource ID list from:
+ include/dt-bindings/power/imx-rsrc.h
+
+Required properties for power domain sub nodes:
+- reg: Resource ID of this power domain.
+- #power-domain-cells: Must be 0
+- power-domains: phandle pointing to the parent power domain,
+ for more details see:
+ Documentation/devicetree/bindings/power/power_domain.txt
+
+Example:
+-------------
+ scu {
+ compatible = "nxp,imx8qxp-scu";
+ fsl,mu = <&lsio_mu0>;
+ status = "okay";
+
+ pd_lsio: lsio_power_domain {
+ compatible = "nxp,imx8qxp-pd";
+ #power-domain-cells = <0>;
+ #address-cells = <1>;
+ #size-cells = <0>;
+
+ pd_lsio_pwm0: lsio_pwm0@SC_R_PWM_0 {
+ reg = <SC_R_PWM_0>;
+ #power-domain-cells = <0>;
+ power-domains = <&pd_lsio>;
+ };
+ ...
+ }
+
+ pd_dma: dma_power_domain {
+ compatible = "nxp,imx8-pd";
+ #power-domain-cells = <0>;
+ #address-cells = <1>;
+ #size-cells = <0>;
+
+ pd_dma_lpuart0: dma_lpuart0@SC_R_UART_0 {
+ reg = <SC_R_UART_0>;
+ #power-domain-cells = <0>;
+ power-domains = <&pd_dma>;
+ };
+ ...
+ }
+ ...
+ };
+
+PM Domain Consumers
+===================
+Hardware blocks belonging to a PM domain should contain a "power-domains"
+property that is a phandle pointing to the corresponding PM domain node.
+
+Required Properties:
+--------------------
+- power-domains: phandle pointing to the corresponding PM domain node.
+
+Example:
+--------------------
+ lpuart0: serial@5a060000 {
+ compatible = "fsl,imx8qxp-lpuart";
+ ....
+ power-domains = <&pd_dma_lpuart0>;
+ };
Some i.MX SoCs contain a system controller that is responsible for controlling the state of the IPs that are present. Communication between the host processor running an OS and the system controller happens through a SCU protocol. Cc: Shawn Guo <shawnguo@kernel.org> Cc: Sascha Hauer <kernel@pengutronix.de> Cc: Fabio Estevam <fabio.estevam@nxp.com> Cc: Rob Herring <robh+dt@kernel.org> Cc: Mark Rutland <mark.rutland@arm.com> Cc: devicetree@vger.kernel.org Signed-off-by: Dong Aisheng <aisheng.dong@nxp.com> --- .../devicetree/bindings/power/nxp,imx-pd-scu.txt | 84 ++++++++++++++++++++++ 1 file changed, 84 insertions(+) create mode 100644 Documentation/devicetree/bindings/power/nxp,imx-pd-scu.txt