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/clock/samsu 4 $id: http://devicetree.org/schemas/clock/samsung,exynosautov9-clock.yaml#
5 $schema: http://devicetree.org/meta-schemas/co 5 $schema: http://devicetree.org/meta-schemas/core.yaml#
6 6
7 title: Samsung Exynos Auto v9 SoC clock contro 7 title: Samsung Exynos Auto v9 SoC clock controller
8 8
9 maintainers: 9 maintainers:
10 - Chanho Park <chanho61.park@samsung.com> 10 - Chanho Park <chanho61.park@samsung.com>
11 - Chanwoo Choi <cw00.choi@samsung.com> 11 - Chanwoo Choi <cw00.choi@samsung.com>
12 - Krzysztof Kozlowski <krzk@kernel.org> 12 - Krzysztof Kozlowski <krzk@kernel.org>
13 - Sylwester Nawrocki <s.nawrocki@samsung.com> 13 - Sylwester Nawrocki <s.nawrocki@samsung.com>
14 - Tomasz Figa <tomasz.figa@gmail.com> 14 - Tomasz Figa <tomasz.figa@gmail.com>
15 15
16 description: | 16 description: |
17 Exynos Auto v9 clock controller is comprised 17 Exynos Auto v9 clock controller is comprised of several CMU units, generating
18 clocks for different domains. Those CMU unit 18 clocks for different domains. Those CMU units are modeled as separate device
19 tree nodes, and might depend on each other. 19 tree nodes, and might depend on each other. Root clocks in that clock tree are
20 two external clocks:: OSCCLK/XTCXO (26 MHz) 20 two external clocks:: OSCCLK/XTCXO (26 MHz) and RTCCLK/XrtcXTI (32768 Hz).
21 The external OSCCLK must be defined as fixed 21 The external OSCCLK must be defined as fixed-rate clock in dts.
22 22
23 CMU_TOP is a top-level CMU, where all base c 23 CMU_TOP is a top-level CMU, where all base clocks are prepared using PLLs and
24 dividers; all other clocks of function block 24 dividers; all other clocks of function blocks (other CMUs) are usually
25 derived from CMU_TOP. 25 derived from CMU_TOP.
26 26
27 Each clock is assigned an identifier and cli 27 Each clock is assigned an identifier and client nodes can use this identifier
28 to specify the clock which they consume. All 28 to specify the clock which they consume. All clocks available for usage
29 in clock consumer nodes are defined as prepr 29 in clock consumer nodes are defined as preprocessor macros in
30 'include/dt-bindings/clock/samsung,exynosaut 30 'include/dt-bindings/clock/samsung,exynosautov9.h' header.
31 31
32 properties: 32 properties:
33 compatible: 33 compatible:
34 enum: 34 enum:
35 - samsung,exynosautov9-cmu-top 35 - samsung,exynosautov9-cmu-top
36 - samsung,exynosautov9-cmu-busmc 36 - samsung,exynosautov9-cmu-busmc
37 - samsung,exynosautov9-cmu-core 37 - samsung,exynosautov9-cmu-core
38 - samsung,exynosautov9-cmu-dpum 38 - samsung,exynosautov9-cmu-dpum
39 - samsung,exynosautov9-cmu-fsys0 39 - samsung,exynosautov9-cmu-fsys0
40 - samsung,exynosautov9-cmu-fsys1 40 - samsung,exynosautov9-cmu-fsys1
41 - samsung,exynosautov9-cmu-fsys2 41 - samsung,exynosautov9-cmu-fsys2
42 - samsung,exynosautov9-cmu-peric0 42 - samsung,exynosautov9-cmu-peric0
43 - samsung,exynosautov9-cmu-peric1 43 - samsung,exynosautov9-cmu-peric1
44 - samsung,exynosautov9-cmu-peris 44 - samsung,exynosautov9-cmu-peris
45 45
46 clocks: 46 clocks:
47 minItems: 1 47 minItems: 1
48 maxItems: 5 48 maxItems: 5
49 49
50 clock-names: 50 clock-names:
51 minItems: 1 51 minItems: 1
52 maxItems: 5 52 maxItems: 5
53 53
54 "#clock-cells": 54 "#clock-cells":
55 const: 1 55 const: 1
56 56
57 reg: 57 reg:
58 maxItems: 1 58 maxItems: 1
59 59
60 allOf: 60 allOf:
61 - if: 61 - if:
62 properties: 62 properties:
63 compatible: 63 compatible:
64 contains: 64 contains:
65 const: samsung,exynosautov9-cmu-to 65 const: samsung,exynosautov9-cmu-top
66 66
67 then: 67 then:
68 properties: 68 properties:
69 clocks: 69 clocks:
70 items: 70 items:
71 - description: External reference 71 - description: External reference clock (26 MHz)
72 72
73 clock-names: 73 clock-names:
74 items: 74 items:
75 - const: oscclk 75 - const: oscclk
76 76
77 - if: 77 - if:
78 properties: 78 properties:
79 compatible: 79 compatible:
80 contains: 80 contains:
81 const: samsung,exynosautov9-cmu-bu 81 const: samsung,exynosautov9-cmu-busmc
82 82
83 then: 83 then:
84 properties: 84 properties:
85 clocks: 85 clocks:
86 items: 86 items:
87 - description: External reference 87 - description: External reference clock (26 MHz)
88 - description: CMU_BUSMC bus clock 88 - description: CMU_BUSMC bus clock (from CMU_TOP)
89 89
90 clock-names: 90 clock-names:
91 items: 91 items:
92 - const: oscclk 92 - const: oscclk
93 - const: dout_clkcmu_busmc_bus 93 - const: dout_clkcmu_busmc_bus
94 94
95 - if: 95 - if:
96 properties: 96 properties:
97 compatible: 97 compatible:
98 contains: 98 contains:
99 const: samsung,exynosautov9-cmu-co 99 const: samsung,exynosautov9-cmu-core
100 100
101 then: 101 then:
102 properties: 102 properties:
103 clocks: 103 clocks:
104 items: 104 items:
105 - description: External reference 105 - description: External reference clock (26 MHz)
106 - description: CMU_CORE bus clock 106 - description: CMU_CORE bus clock (from CMU_TOP)
107 107
108 clock-names: 108 clock-names:
109 items: 109 items:
110 - const: oscclk 110 - const: oscclk
111 - const: dout_clkcmu_core_bus 111 - const: dout_clkcmu_core_bus
112 112
113 - if: 113 - if:
114 properties: 114 properties:
115 compatible: 115 compatible:
116 contains: 116 contains:
117 const: samsung,exynosautov9-cmu-dp 117 const: samsung,exynosautov9-cmu-dpum
118 118
119 then: 119 then:
120 properties: 120 properties:
121 clocks: 121 clocks:
122 items: 122 items:
123 - description: External reference 123 - description: External reference clock (26 MHz)
124 - description: DPU Main bus clock 124 - description: DPU Main bus clock (from CMU_TOP)
125 125
126 clock-names: 126 clock-names:
127 items: 127 items:
128 - const: oscclk 128 - const: oscclk
129 - const: bus 129 - const: bus
130 130
131 - if: 131 - if:
132 properties: 132 properties:
133 compatible: 133 compatible:
134 contains: 134 contains:
135 const: samsung,exynosautov9-cmu-fs 135 const: samsung,exynosautov9-cmu-fsys0
136 136
137 then: 137 then:
138 properties: 138 properties:
139 clocks: 139 clocks:
140 items: 140 items:
141 - description: External reference 141 - description: External reference clock (26 MHz)
142 - description: CMU_FSYS0 bus clock 142 - description: CMU_FSYS0 bus clock (from CMU_TOP)
143 - description: CMU_FSYS0 pcie cloc 143 - description: CMU_FSYS0 pcie clock (from CMU_TOP)
144 144
145 clock-names: 145 clock-names:
146 items: 146 items:
147 - const: oscclk 147 - const: oscclk
148 - const: dout_clkcmu_fsys0_bus 148 - const: dout_clkcmu_fsys0_bus
149 - const: dout_clkcmu_fsys0_pcie 149 - const: dout_clkcmu_fsys0_pcie
150 150
151 - if: 151 - if:
152 properties: 152 properties:
153 compatible: 153 compatible:
154 contains: 154 contains:
155 const: samsung,exynosautov9-cmu-fs 155 const: samsung,exynosautov9-cmu-fsys1
156 156
157 then: 157 then:
158 properties: 158 properties:
159 clocks: 159 clocks:
160 items: 160 items:
161 - description: External reference 161 - description: External reference clock (26 MHz)
162 - description: CMU_FSYS1 bus clock 162 - description: CMU_FSYS1 bus clock (from CMU_TOP)
163 - description: CMU_FSYS1 mmc card 163 - description: CMU_FSYS1 mmc card clock (from CMU_TOP)
164 - description: CMU_FSYS1 usb clock 164 - description: CMU_FSYS1 usb clock (from CMU_TOP)
165 165
166 clock-names: 166 clock-names:
167 items: 167 items:
168 - const: oscclk 168 - const: oscclk
169 - const: dout_clkcmu_fsys1_bus 169 - const: dout_clkcmu_fsys1_bus
170 - const: gout_clkcmu_fsys1_mmc_car 170 - const: gout_clkcmu_fsys1_mmc_card
171 - const: dout_clkcmu_fsys1_usbdrd 171 - const: dout_clkcmu_fsys1_usbdrd
172 172
173 - if: 173 - if:
174 properties: 174 properties:
175 compatible: 175 compatible:
176 contains: 176 contains:
177 const: samsung,exynosautov9-cmu-fs 177 const: samsung,exynosautov9-cmu-fsys2
178 178
179 then: 179 then:
180 properties: 180 properties:
181 clocks: 181 clocks:
182 items: 182 items:
183 - description: External reference 183 - description: External reference clock (26 MHz)
184 - description: CMU_FSYS2 bus clock 184 - description: CMU_FSYS2 bus clock (from CMU_TOP)
185 - description: UFS clock (from CMU 185 - description: UFS clock (from CMU_TOP)
186 - description: Ethernet clock (fro 186 - description: Ethernet clock (from CMU_TOP)
187 187
188 clock-names: 188 clock-names:
189 items: 189 items:
190 - const: oscclk 190 - const: oscclk
191 - const: dout_clkcmu_fsys2_bus 191 - const: dout_clkcmu_fsys2_bus
192 - const: dout_fsys2_clkcmu_ufs_emb 192 - const: dout_fsys2_clkcmu_ufs_embd
193 - const: dout_fsys2_clkcmu_etherne 193 - const: dout_fsys2_clkcmu_ethernet
194 194
195 - if: 195 - if:
196 properties: 196 properties:
197 compatible: 197 compatible:
198 contains: 198 contains:
199 const: samsung,exynosautov9-cmu-pe 199 const: samsung,exynosautov9-cmu-peric0
200 200
201 then: 201 then:
202 properties: 202 properties:
203 clocks: 203 clocks:
204 items: 204 items:
205 - description: External reference 205 - description: External reference clock (26 MHz)
206 - description: CMU_PERIC0 bus cloc 206 - description: CMU_PERIC0 bus clock (from CMU_TOP)
207 - description: PERIC0 IP clock (fr 207 - description: PERIC0 IP clock (from CMU_TOP)
208 208
209 clock-names: 209 clock-names:
210 items: 210 items:
211 - const: oscclk 211 - const: oscclk
212 - const: dout_clkcmu_peric0_bus 212 - const: dout_clkcmu_peric0_bus
213 - const: dout_clkcmu_peric0_ip 213 - const: dout_clkcmu_peric0_ip
214 214
215 - if: 215 - if:
216 properties: 216 properties:
217 compatible: 217 compatible:
218 contains: 218 contains:
219 const: samsung,exynosautov9-cmu-pe 219 const: samsung,exynosautov9-cmu-peric1
220 220
221 then: 221 then:
222 properties: 222 properties:
223 clocks: 223 clocks:
224 items: 224 items:
225 - description: External reference 225 - description: External reference clock (26 MHz)
226 - description: CMU_PERIC1 bus cloc 226 - description: CMU_PERIC1 bus clock (from CMU_TOP)
227 - description: PERIC1 IP clock (fr 227 - description: PERIC1 IP clock (from CMU_TOP)
228 228
229 clock-names: 229 clock-names:
230 items: 230 items:
231 - const: oscclk 231 - const: oscclk
232 - const: dout_clkcmu_peric1_bus 232 - const: dout_clkcmu_peric1_bus
233 - const: dout_clkcmu_peric1_ip 233 - const: dout_clkcmu_peric1_ip
234 234
235 - if: 235 - if:
236 properties: 236 properties:
237 compatible: 237 compatible:
238 contains: 238 contains:
239 const: samsung,exynosautov9-cmu-pe 239 const: samsung,exynosautov9-cmu-peris
240 240
241 then: 241 then:
242 properties: 242 properties:
243 clocks: 243 clocks:
244 items: 244 items:
245 - description: External reference 245 - description: External reference clock (26 MHz)
246 - description: CMU_PERIS bus clock 246 - description: CMU_PERIS bus clock (from CMU_TOP)
247 247
248 clock-names: 248 clock-names:
249 items: 249 items:
250 - const: oscclk 250 - const: oscclk
251 - const: dout_clkcmu_peris_bus 251 - const: dout_clkcmu_peris_bus
252 252
253 required: 253 required:
254 - compatible 254 - compatible
255 - "#clock-cells" 255 - "#clock-cells"
256 - clocks 256 - clocks
257 - clock-names 257 - clock-names
258 - reg 258 - reg
259 259
260 additionalProperties: false 260 additionalProperties: false
261 261
262 examples: 262 examples:
263 # Clock controller node for CMU_FSYS2 263 # Clock controller node for CMU_FSYS2
264 - | 264 - |
265 #include <dt-bindings/clock/samsung,exynos 265 #include <dt-bindings/clock/samsung,exynosautov9.h>
266 266
267 cmu_fsys2: clock-controller@17c00000 { 267 cmu_fsys2: clock-controller@17c00000 {
268 compatible = "samsung,exynosautov9-cmu 268 compatible = "samsung,exynosautov9-cmu-fsys2";
269 reg = <0x17c00000 0x8000>; 269 reg = <0x17c00000 0x8000>;
270 #clock-cells = <1>; 270 #clock-cells = <1>;
271 271
272 clocks = <&xtcxo>, 272 clocks = <&xtcxo>,
273 <&cmu_top DOUT_CLKCMU_FSYS2_B 273 <&cmu_top DOUT_CLKCMU_FSYS2_BUS>,
274 <&cmu_top DOUT_CLKCMU_FSYS2_U 274 <&cmu_top DOUT_CLKCMU_FSYS2_UFS_EMBD>,
275 <&cmu_top DOUT_CLKCMU_FSYS2_E 275 <&cmu_top DOUT_CLKCMU_FSYS2_ETHERNET>;
276 clock-names = "oscclk", 276 clock-names = "oscclk",
277 "dout_clkcmu_fsys2_bus", 277 "dout_clkcmu_fsys2_bus",
278 "dout_fsys2_clkcmu_ufs_e 278 "dout_fsys2_clkcmu_ufs_embd",
279 "dout_fsys2_clkcmu_ether 279 "dout_fsys2_clkcmu_ethernet";
280 }; 280 };
281 281
282 ... 282 ...
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.