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 45 additionalProperties: false
46 description: list of power domains provide 46 description: list of power domains provided by this controller.
47 47
48 properties: 48 properties:
49 '#address-cells': 49 '#address-cells':
50 const: 1 50 const: 1
51 51
52 '#size-cells': 52 '#size-cells':
53 const: 0 53 const: 0
54 54
55 patternProperties: 55 patternProperties:
56 "power-domain@[0-9a-f]+$": 56 "power-domain@[0-9a-f]+$":
57 type: object 57 type: object
58 additionalProperties: false 58 additionalProperties: false
59 59
60 properties: 60 properties:
61 61
62 '#power-domain-cells': 62 '#power-domain-cells':
63 const: 0 63 const: 0
64 64
65 reg: 65 reg:
66 description: | 66 description: |
67 Power domain index. Valid values 67 Power domain index. Valid values are defined in
68 include/dt-bindings/power/imx7-p 68 include/dt-bindings/power/imx7-power.h for fsl,imx7d-gpc and
69 include/dt-bindings/power/imx8m- 69 include/dt-bindings/power/imx8m-power.h for fsl,imx8mq-gpc
70 include/dt-bindings/power/imx8mm 70 include/dt-bindings/power/imx8mm-power.h for fsl,imx8mm-gpc
71 include/dt-bindings/power/imx8mp 71 include/dt-bindings/power/imx8mp-power.h for fsl,imx8mp-gpc
72 maxItems: 1 72 maxItems: 1
73 73
74 clocks: 74 clocks:
75 description: | 75 description: |
76 A number of phandles to clocks t 76 A number of phandles to clocks that need to be enabled during domain
77 power-up sequencing to ensure re 77 power-up sequencing to ensure reset propagation into devices located
78 inside this power domain. 78 inside this power domain.
79 minItems: 1 79 minItems: 1
80 maxItems: 5 80 maxItems: 5
81 81
82 power-supply: true 82 power-supply: true
83 83
84 power-domains: 84 power-domains:
85 maxItems: 1 85 maxItems: 1
86 86
87 resets: 87 resets:
88 description: | 88 description: |
89 A number of phandles to resets t 89 A number of phandles to resets that need to be asserted during
90 power-up sequencing of the domai 90 power-up sequencing of the domain. The resets belong to devices
91 located inside the power domain, 91 located inside the power domain, which need to be held in reset
92 across the power-up sequence. So 92 across the power-up sequence. So no means to specify what each
93 reset is in a generic power-doma 93 reset is in a generic power-domain binding.
94 minItems: 1 94 minItems: 1
95 maxItems: 4 95 maxItems: 4
96 96
97 required: 97 required:
98 - '#power-domain-cells' 98 - '#power-domain-cells'
99 - reg 99 - reg
100 100
101 required: 101 required:
102 - '#address-cells' 102 - '#address-cells'
103 - '#size-cells' 103 - '#size-cells'
104 104
105 required: 105 required:
106 - compatible 106 - compatible
107 - reg 107 - reg
108 - interrupts 108 - interrupts
109 - pgc 109 - pgc
110 110
111 additionalProperties: false 111 additionalProperties: false
112 112
113 examples: 113 examples:
114 - | 114 - |
115 #include <dt-bindings/interrupt-controller 115 #include <dt-bindings/interrupt-controller/arm-gic.h>
116 116
117 gpc@303a0000 { 117 gpc@303a0000 {
118 compatible = "fsl,imx7d-gpc"; 118 compatible = "fsl,imx7d-gpc";
119 reg = <0x303a0000 0x1000>; 119 reg = <0x303a0000 0x1000>;
120 interrupts = <GIC_SPI 87 IRQ_TYPE_LEVE 120 interrupts = <GIC_SPI 87 IRQ_TYPE_LEVEL_HIGH>;
121 121
122 pgc { 122 pgc {
123 #address-cells = <1>; 123 #address-cells = <1>;
124 #size-cells = <0>; 124 #size-cells = <0>;
125 125
126 pgc_mipi_phy: power-domain@0 { 126 pgc_mipi_phy: power-domain@0 {
127 #power-domain-cells = <0>; 127 #power-domain-cells = <0>;
128 reg = <0>; 128 reg = <0>;
129 power-supply = <®_1p0d>; 129 power-supply = <®_1p0d>;
130 }; 130 };
131 131
132 pgc_pcie_phy: power-domain@1 { 132 pgc_pcie_phy: power-domain@1 {
133 #power-domain-cells = <0>; 133 #power-domain-cells = <0>;
134 reg = <1>; 134 reg = <1>;
135 power-supply = <®_1p0d>; 135 power-supply = <®_1p0d>;
136 }; 136 };
137 137
138 pgc_hsic_phy: power-domain@2 { 138 pgc_hsic_phy: power-domain@2 {
139 #power-domain-cells = <0>; 139 #power-domain-cells = <0>;
140 reg = <2>; 140 reg = <2>;
141 power-supply = <®_1p2>; 141 power-supply = <®_1p2>;
142 }; 142 };
143 }; 143 };
144 }; 144 };
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.