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