Merge tag 'iomap-4.21-merge-3' of git://git.kernel.org/pub/scm/fs/xfs/xfs-linux
[sfrench/cifs-2.6.git] / Documentation / devicetree / bindings / power / fsl,imx-gpcv2.txt
1 Freescale i.MX General Power Controller v2
2 ==========================================
3
4 The i.MX7S/D General Power Control (GPC) block contains Power Gating
5 Control (PGC) for various power domains.
6
7 Required properties:
8
9 - compatible: Should be one of:
10         - "fsl,imx7d-gpc"
11         - "fsl,imx8mq-gpc"
12
13 - reg: should be register base and length as documented in the
14   datasheet
15
16 - interrupts: Should contain GPC interrupt request 1
17
18 Power domains contained within GPC node are generic power domain
19 providers, documented in
20 Documentation/devicetree/bindings/power/power_domain.txt, which are
21 described as subnodes of the power gating controller 'pgc' node,
22 which, in turn, is expected to contain the following:
23
24 Required properties:
25
26 - reg: Power domain index. Valid values are defined in
27   include/dt-bindings/power/imx7-power.h for fsl,imx7d-gpc and
28   include/dt-bindings/power/imx8m-power.h for fsl,imx8mq-gpc
29
30 - #power-domain-cells: Should be 0
31
32 Optional properties:
33
34 - power-supply: Power supply used to power the domain
35
36 Example:
37
38         gpc: gpc@303a0000 {
39                 compatible = "fsl,imx7d-gpc";
40                 reg = <0x303a0000 0x1000>;
41                 interrupt-controller;
42                 interrupts = <GIC_SPI 87 IRQ_TYPE_LEVEL_HIGH>;
43                 #interrupt-cells = <3>;
44                 interrupt-parent = <&intc>;
45
46                 pgc {
47                         #address-cells = <1>;
48                         #size-cells = <0>;
49
50                         pgc_pcie_phy: power-domain@1 {
51                                 #power-domain-cells = <0>;
52
53                                 reg = <1>;
54                                 power-supply = <&reg_1p0d>;
55                         };
56                 };
57         };
58
59
60 Specifying power domain for IP modules
61 ======================================
62
63 IP cores belonging to a power domain should contain a 'power-domains'
64 property that is a phandle for PGC node representing the domain.
65
66 Example of a device that is part of the PCIE_PHY power domain:
67
68         pcie: pcie@33800000 {
69               reg = <0x33800000 0x4000>,
70                     <0x4ff00000 0x80000>;
71                 /* ... */
72                 power-domains = <&pgc_pcie_phy>;
73                 /* ... */
74         };