1 # SPDX-License-Identifier: (GPL-2.0-only OR BS 1 # SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2 %YAML 1.2 2 %YAML 1.2
3 --- 3 ---
4 $id: http://devicetree.org/schemas/power/fsl,i 4 $id: http://devicetree.org/schemas/power/fsl,imx-gpcv2.yaml#
5 $schema: http://devicetree.org/meta-schemas/co 5 $schema: http://devicetree.org/meta-schemas/core.yaml#
6 6
7 title: Freescale i.MX General Power Controller 7 title: Freescale i.MX General Power Controller v2
8 8
9 maintainers: 9 maintainers:
10 - Andrey Smirnov <andrew.smirnov@gmail.com> 10 - Andrey Smirnov <andrew.smirnov@gmail.com>
11 11
12 description: | 12 description: |
13 The i.MX7S/D General Power Control (GPC) blo 13 The i.MX7S/D General Power Control (GPC) block contains Power Gating
14 Control (PGC) for various power domains. 14 Control (PGC) for various power domains.
15 15
16 Power domains contained within GPC node are 16 Power domains contained within GPC node are generic power domain
17 providers, documented in 17 providers, documented in
18 Documentation/devicetree/bindings/power/powe 18 Documentation/devicetree/bindings/power/power-domain.yaml, which are
19 described as subnodes of the power gating co 19 described as subnodes of the power gating controller 'pgc' node.
20 20
21 IP cores belonging to a power domain should 21 IP cores belonging to a power domain should contain a 'power-domains'
22 property that is a phandle for PGC node repr 22 property that is a phandle for PGC node representing the domain.
23 23
24 properties: 24 properties:
25 compatible: 25 compatible:
26 enum: 26 enum:
27 - fsl,imx7d-gpc 27 - fsl,imx7d-gpc
28 - fsl,imx8mn-gpc 28 - fsl,imx8mn-gpc
29 - fsl,imx8mq-gpc 29 - fsl,imx8mq-gpc
30 - fsl,imx8mm-gpc 30 - fsl,imx8mm-gpc
31 - fsl,imx8mp-gpc 31 - fsl,imx8mp-gpc
32 32
33 reg: 33 reg:
34 maxItems: 1 34 maxItems: 1
35 35
36 interrupts: 36 interrupts:
37 maxItems: 1 37 maxItems: 1
38 38
39 interrupt-controller: true 39 interrupt-controller: true
40 '#interrupt-cells': 40 '#interrupt-cells':
41 const: 3 41 const: 3
42 42
43 pgc: 43 pgc:
44 type: object 44 type: object
45 additionalProperties: false <<
46 description: list of power domains provide 45 description: list of power domains provided by this controller.
47 46
48 properties: <<
49 '#address-cells': <<
50 const: 1 <<
51 <<
52 '#size-cells': <<
53 const: 0 <<
54 <<
55 patternProperties: 47 patternProperties:
56 "power-domain@[0-9a-f]+$": !! 48 "power-domain@[0-9]$":
57 type: object 49 type: object
58 additionalProperties: false <<
59 <<
60 properties: 50 properties:
61 51
62 '#power-domain-cells': 52 '#power-domain-cells':
63 const: 0 53 const: 0
64 54
65 reg: 55 reg:
66 description: | 56 description: |
67 Power domain index. Valid values 57 Power domain index. Valid values are defined in
68 include/dt-bindings/power/imx7-p 58 include/dt-bindings/power/imx7-power.h for fsl,imx7d-gpc and
69 include/dt-bindings/power/imx8m- 59 include/dt-bindings/power/imx8m-power.h for fsl,imx8mq-gpc
70 include/dt-bindings/power/imx8mm 60 include/dt-bindings/power/imx8mm-power.h for fsl,imx8mm-gpc
71 include/dt-bindings/power/imx8mp 61 include/dt-bindings/power/imx8mp-power.h for fsl,imx8mp-gpc
72 maxItems: 1 62 maxItems: 1
73 63
74 clocks: 64 clocks:
75 description: | 65 description: |
76 A number of phandles to clocks t 66 A number of phandles to clocks that need to be enabled during domain
77 power-up sequencing to ensure re 67 power-up sequencing to ensure reset propagation into devices located
78 inside this power domain. 68 inside this power domain.
79 minItems: 1 69 minItems: 1
80 maxItems: 5 70 maxItems: 5
81 71
82 power-supply: true 72 power-supply: true
83 73
84 power-domains: <<
85 maxItems: 1 <<
86 <<
87 resets: 74 resets:
88 description: | 75 description: |
89 A number of phandles to resets t 76 A number of phandles to resets that need to be asserted during
90 power-up sequencing of the domai 77 power-up sequencing of the domain. The resets belong to devices
91 located inside the power domain, 78 located inside the power domain, which need to be held in reset
92 across the power-up sequence. So 79 across the power-up sequence. So no means to specify what each
93 reset is in a generic power-doma 80 reset is in a generic power-domain binding.
94 minItems: 1 81 minItems: 1
95 maxItems: 4 82 maxItems: 4
96 83
97 required: 84 required:
98 - '#power-domain-cells' 85 - '#power-domain-cells'
99 - reg 86 - reg
100 <<
101 required: <<
102 - '#address-cells' <<
103 - '#size-cells' <<
104 87
105 required: 88 required:
106 - compatible 89 - compatible
107 - reg 90 - reg
108 - interrupts 91 - interrupts
109 - pgc 92 - pgc
110 93
111 additionalProperties: false 94 additionalProperties: false
112 95
113 examples: 96 examples:
114 - | 97 - |
115 #include <dt-bindings/interrupt-controller 98 #include <dt-bindings/interrupt-controller/arm-gic.h>
116 99
117 gpc@303a0000 { 100 gpc@303a0000 {
118 compatible = "fsl,imx7d-gpc"; 101 compatible = "fsl,imx7d-gpc";
119 reg = <0x303a0000 0x1000>; 102 reg = <0x303a0000 0x1000>;
120 interrupts = <GIC_SPI 87 IRQ_TYPE_LEVE 103 interrupts = <GIC_SPI 87 IRQ_TYPE_LEVEL_HIGH>;
121 104
122 pgc { 105 pgc {
123 #address-cells = <1>; 106 #address-cells = <1>;
124 #size-cells = <0>; 107 #size-cells = <0>;
125 108
126 pgc_mipi_phy: power-domain@0 { 109 pgc_mipi_phy: power-domain@0 {
127 #power-domain-cells = <0>; 110 #power-domain-cells = <0>;
128 reg = <0>; 111 reg = <0>;
129 power-supply = <®_1p0d>; 112 power-supply = <®_1p0d>;
130 }; 113 };
131 114
132 pgc_pcie_phy: power-domain@1 { 115 pgc_pcie_phy: power-domain@1 {
133 #power-domain-cells = <0>; 116 #power-domain-cells = <0>;
134 reg = <1>; 117 reg = <1>;
135 power-supply = <®_1p0d>; 118 power-supply = <®_1p0d>;
136 }; 119 };
137 120
138 pgc_hsic_phy: power-domain@2 { 121 pgc_hsic_phy: power-domain@2 {
139 #power-domain-cells = <0>; 122 #power-domain-cells = <0>;
140 reg = <2>; 123 reg = <2>;
141 power-supply = <®_1p2>; 124 power-supply = <®_1p2>;
142 }; 125 };
143 }; 126 };
144 }; 127 };
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.