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,exynos850-clock.yaml#
5 $schema: http://devicetree.org/meta-schemas/co 5 $schema: http://devicetree.org/meta-schemas/core.yaml#
6 6
7 title: Samsung Exynos850 SoC clock controller 7 title: Samsung Exynos850 SoC clock controller
8 8
9 maintainers: 9 maintainers:
10 - Sam Protsenko <semen.protsenko@linaro.org> 10 - Sam Protsenko <semen.protsenko@linaro.org>
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 Exynos850 clock controller is comprised of s 17 Exynos850 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 (26 MHz) and RT 20 two external clocks:: OSCCLK (26 MHz) and RTCCLK (32768 Hz). Those external
21 clocks must be defined as fixed-rate clocks 21 clocks must be defined as fixed-rate clocks 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 leaf clocks (other CMUs) 24 dividers; all other leaf clocks (other CMUs) are usually derived from CMU_TOP.
25 25
26 Each clock is assigned an identifier and cli 26 Each clock is assigned an identifier and client nodes can use this identifier
27 to specify the clock which they consume. All 27 to specify the clock which they consume. All clocks available for usage
28 in clock consumer nodes are defined as prepr 28 in clock consumer nodes are defined as preprocessor macros in
29 'dt-bindings/clock/exynos850.h' header. 29 'dt-bindings/clock/exynos850.h' header.
30 30
31 properties: 31 properties:
32 compatible: 32 compatible:
33 enum: 33 enum:
34 - samsung,exynos850-cmu-top 34 - samsung,exynos850-cmu-top
35 - samsung,exynos850-cmu-apm 35 - samsung,exynos850-cmu-apm
36 - samsung,exynos850-cmu-aud 36 - samsung,exynos850-cmu-aud
37 - samsung,exynos850-cmu-cmgp 37 - samsung,exynos850-cmu-cmgp
38 - samsung,exynos850-cmu-core 38 - samsung,exynos850-cmu-core
39 - samsung,exynos850-cmu-cpucl0 39 - samsung,exynos850-cmu-cpucl0
40 - samsung,exynos850-cmu-cpucl1 40 - samsung,exynos850-cmu-cpucl1
41 - samsung,exynos850-cmu-dpu 41 - samsung,exynos850-cmu-dpu
42 - samsung,exynos850-cmu-g3d 42 - samsung,exynos850-cmu-g3d
43 - samsung,exynos850-cmu-hsi 43 - samsung,exynos850-cmu-hsi
44 - samsung,exynos850-cmu-is 44 - samsung,exynos850-cmu-is
45 - samsung,exynos850-cmu-mfcmscl 45 - samsung,exynos850-cmu-mfcmscl
46 - samsung,exynos850-cmu-peri 46 - samsung,exynos850-cmu-peri
47 47
48 clocks: 48 clocks:
49 minItems: 1 49 minItems: 1
50 maxItems: 5 50 maxItems: 5
51 51
52 clock-names: 52 clock-names:
53 minItems: 1 53 minItems: 1
54 maxItems: 5 54 maxItems: 5
55 55
56 "#clock-cells": 56 "#clock-cells":
57 const: 1 57 const: 1
58 58
59 reg: 59 reg:
60 maxItems: 1 60 maxItems: 1
61 61
62 allOf: 62 allOf:
63 - if: 63 - if:
64 properties: 64 properties:
65 compatible: 65 compatible:
66 contains: 66 contains:
67 const: samsung,exynos850-cmu-top 67 const: samsung,exynos850-cmu-top
68 68
69 then: 69 then:
70 properties: 70 properties:
71 clocks: 71 clocks:
72 items: 72 items:
73 - description: External reference 73 - description: External reference clock (26 MHz)
74 74
75 clock-names: 75 clock-names:
76 items: 76 items:
77 - const: oscclk 77 - const: oscclk
78 78
79 - if: 79 - if:
80 properties: 80 properties:
81 compatible: 81 compatible:
82 contains: 82 contains:
83 const: samsung,exynos850-cmu-apm 83 const: samsung,exynos850-cmu-apm
84 84
85 then: 85 then:
86 properties: 86 properties:
87 clocks: 87 clocks:
88 items: 88 items:
89 - description: External reference 89 - description: External reference clock (26 MHz)
90 - description: CMU_APM bus clock ( 90 - description: CMU_APM bus clock (from CMU_TOP)
91 91
92 clock-names: 92 clock-names:
93 items: 93 items:
94 - const: oscclk 94 - const: oscclk
95 - const: dout_clkcmu_apm_bus 95 - const: dout_clkcmu_apm_bus
96 96
97 - if: 97 - if:
98 properties: 98 properties:
99 compatible: 99 compatible:
100 contains: 100 contains:
101 const: samsung,exynos850-cmu-aud 101 const: samsung,exynos850-cmu-aud
102 102
103 then: 103 then:
104 properties: 104 properties:
105 clocks: 105 clocks:
106 items: 106 items:
107 - description: External reference 107 - description: External reference clock (26 MHz)
108 - description: AUD clock (from CMU 108 - description: AUD clock (from CMU_TOP)
109 109
110 clock-names: 110 clock-names:
111 items: 111 items:
112 - const: oscclk 112 - const: oscclk
113 - const: dout_aud 113 - const: dout_aud
114 114
115 - if: 115 - if:
116 properties: 116 properties:
117 compatible: 117 compatible:
118 contains: 118 contains:
119 const: samsung,exynos850-cmu-cmgp 119 const: samsung,exynos850-cmu-cmgp
120 120
121 then: 121 then:
122 properties: 122 properties:
123 clocks: 123 clocks:
124 items: 124 items:
125 - description: External reference 125 - description: External reference clock (26 MHz)
126 - description: CMU_CMGP bus clock 126 - description: CMU_CMGP bus clock (from CMU_APM)
127 127
128 clock-names: 128 clock-names:
129 items: 129 items:
130 - const: oscclk 130 - const: oscclk
131 - const: gout_clkcmu_cmgp_bus 131 - const: gout_clkcmu_cmgp_bus
132 132
133 - if: 133 - if:
134 properties: 134 properties:
135 compatible: 135 compatible:
136 contains: 136 contains:
137 const: samsung,exynos850-cmu-core 137 const: samsung,exynos850-cmu-core
138 138
139 then: 139 then:
140 properties: 140 properties:
141 clocks: 141 clocks:
142 items: 142 items:
143 - description: External reference 143 - description: External reference clock (26 MHz)
144 - description: CMU_CORE bus clock 144 - description: CMU_CORE bus clock (from CMU_TOP)
145 - description: CCI clock (from CMU 145 - description: CCI clock (from CMU_TOP)
146 - description: eMMC clock (from CM 146 - description: eMMC clock (from CMU_TOP)
147 - description: SSS clock (from CMU 147 - description: SSS clock (from CMU_TOP)
148 148
149 clock-names: 149 clock-names:
150 items: 150 items:
151 - const: oscclk 151 - const: oscclk
152 - const: dout_core_bus 152 - const: dout_core_bus
153 - const: dout_core_cci 153 - const: dout_core_cci
154 - const: dout_core_mmc_embd 154 - const: dout_core_mmc_embd
155 - const: dout_core_sss 155 - const: dout_core_sss
156 156
157 - if: 157 - if:
158 properties: 158 properties:
159 compatible: 159 compatible:
160 contains: 160 contains:
161 const: samsung,exynos850-cmu-cpucl 161 const: samsung,exynos850-cmu-cpucl0
162 162
163 then: 163 then:
164 properties: 164 properties:
165 clocks: 165 clocks:
166 items: 166 items:
167 - description: External reference 167 - description: External reference clock (26 MHz)
168 - description: CPUCL0 switch clock 168 - description: CPUCL0 switch clock (from CMU_TOP)
169 - description: CPUCL0 debug clock 169 - description: CPUCL0 debug clock (from CMU_TOP)
170 170
171 clock-names: 171 clock-names:
172 items: 172 items:
173 - const: oscclk 173 - const: oscclk
174 - const: dout_cpucl0_switch 174 - const: dout_cpucl0_switch
175 - const: dout_cpucl0_dbg 175 - const: dout_cpucl0_dbg
176 176
177 - if: 177 - if:
178 properties: 178 properties:
179 compatible: 179 compatible:
180 contains: 180 contains:
181 const: samsung,exynos850-cmu-cpucl 181 const: samsung,exynos850-cmu-cpucl1
182 182
183 then: 183 then:
184 properties: 184 properties:
185 clocks: 185 clocks:
186 items: 186 items:
187 - description: External reference 187 - description: External reference clock (26 MHz)
188 - description: CPUCL1 switch clock 188 - description: CPUCL1 switch clock (from CMU_TOP)
189 - description: CPUCL1 debug clock 189 - description: CPUCL1 debug clock (from CMU_TOP)
190 190
191 clock-names: 191 clock-names:
192 items: 192 items:
193 - const: oscclk 193 - const: oscclk
194 - const: dout_cpucl1_switch 194 - const: dout_cpucl1_switch
195 - const: dout_cpucl1_dbg 195 - const: dout_cpucl1_dbg
196 196
197 - if: 197 - if:
198 properties: 198 properties:
199 compatible: 199 compatible:
200 contains: 200 contains:
201 const: samsung,exynos850-cmu-dpu 201 const: samsung,exynos850-cmu-dpu
202 202
203 then: 203 then:
204 properties: 204 properties:
205 clocks: 205 clocks:
206 items: 206 items:
207 - description: External reference 207 - description: External reference clock (26 MHz)
208 - description: DPU clock (from CMU 208 - description: DPU clock (from CMU_TOP)
209 209
210 clock-names: 210 clock-names:
211 items: 211 items:
212 - const: oscclk 212 - const: oscclk
213 - const: dout_dpu 213 - const: dout_dpu
214 214
215 - if: 215 - if:
216 properties: 216 properties:
217 compatible: 217 compatible:
218 contains: 218 contains:
219 const: samsung,exynos850-cmu-g3d 219 const: samsung,exynos850-cmu-g3d
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: G3D clock (from CMU 226 - description: G3D clock (from CMU_TOP)
227 227
228 clock-names: 228 clock-names:
229 items: 229 items:
230 - const: oscclk 230 - const: oscclk
231 - const: dout_g3d_switch 231 - const: dout_g3d_switch
232 232
233 - if: 233 - if:
234 properties: 234 properties:
235 compatible: 235 compatible:
236 contains: 236 contains:
237 const: samsung,exynos850-cmu-hsi 237 const: samsung,exynos850-cmu-hsi
238 238
239 then: 239 then:
240 properties: 240 properties:
241 clocks: 241 clocks:
242 items: 242 items:
243 - description: External reference 243 - description: External reference clock (26 MHz)
244 - description: External RTC clock 244 - description: External RTC clock (32768 Hz)
245 - description: CMU_HSI bus clock ( 245 - description: CMU_HSI bus clock (from CMU_TOP)
246 - description: SD card clock (from 246 - description: SD card clock (from CMU_TOP)
247 - description: USB 2.0 DRD clock ( 247 - description: USB 2.0 DRD clock (from CMU_TOP)
248 248
249 clock-names: 249 clock-names:
250 items: 250 items:
251 - const: oscclk 251 - const: oscclk
252 - const: rtcclk 252 - const: rtcclk
253 - const: dout_hsi_bus 253 - const: dout_hsi_bus
254 - const: dout_hsi_mmc_card 254 - const: dout_hsi_mmc_card
255 - const: dout_hsi_usb20drd 255 - const: dout_hsi_usb20drd
256 256
257 - if: 257 - if:
258 properties: 258 properties:
259 compatible: 259 compatible:
260 contains: 260 contains:
261 const: samsung,exynos850-cmu-is 261 const: samsung,exynos850-cmu-is
262 262
263 then: 263 then:
264 properties: 264 properties:
265 clocks: 265 clocks:
266 items: 266 items:
267 - description: External reference 267 - description: External reference clock (26 MHz)
268 - description: CMU_IS bus clock (f 268 - description: CMU_IS bus clock (from CMU_TOP)
269 - description: Image Texture Proce 269 - description: Image Texture Processing core clock (from CMU_TOP)
270 - description: Visual Recognition 270 - description: Visual Recognition Accelerator clock (from CMU_TOP)
271 - description: Geometric Distortio 271 - description: Geometric Distortion Correction clock (from CMU_TOP)
272 272
273 clock-names: 273 clock-names:
274 items: 274 items:
275 - const: oscclk 275 - const: oscclk
276 - const: dout_is_bus 276 - const: dout_is_bus
277 - const: dout_is_itp 277 - const: dout_is_itp
278 - const: dout_is_vra 278 - const: dout_is_vra
279 - const: dout_is_gdc 279 - const: dout_is_gdc
280 280
281 - if: 281 - if:
282 properties: 282 properties:
283 compatible: 283 compatible:
284 contains: 284 contains:
285 const: samsung,exynos850-cmu-mfcms 285 const: samsung,exynos850-cmu-mfcmscl
286 286
287 then: 287 then:
288 properties: 288 properties:
289 clocks: 289 clocks:
290 items: 290 items:
291 - description: External reference 291 - description: External reference clock (26 MHz)
292 - description: Multi-Format Codec 292 - description: Multi-Format Codec clock (from CMU_TOP)
293 - description: Memory to Memory Sc 293 - description: Memory to Memory Scaler clock (from CMU_TOP)
294 - description: Multi-Channel Scale 294 - description: Multi-Channel Scaler clock (from CMU_TOP)
295 - description: JPEG codec clock (f 295 - description: JPEG codec clock (from CMU_TOP)
296 296
297 clock-names: 297 clock-names:
298 items: 298 items:
299 - const: oscclk 299 - const: oscclk
300 - const: dout_mfcmscl_mfc 300 - const: dout_mfcmscl_mfc
301 - const: dout_mfcmscl_m2m 301 - const: dout_mfcmscl_m2m
302 - const: dout_mfcmscl_mcsc 302 - const: dout_mfcmscl_mcsc
303 - const: dout_mfcmscl_jpeg 303 - const: dout_mfcmscl_jpeg
304 304
305 - if: 305 - if:
306 properties: 306 properties:
307 compatible: 307 compatible:
308 contains: 308 contains:
309 const: samsung,exynos850-cmu-peri 309 const: samsung,exynos850-cmu-peri
310 310
311 then: 311 then:
312 properties: 312 properties:
313 clocks: 313 clocks:
314 items: 314 items:
315 - description: External reference 315 - description: External reference clock (26 MHz)
316 - description: CMU_PERI bus clock 316 - description: CMU_PERI bus clock (from CMU_TOP)
317 - description: UART clock (from CM 317 - description: UART clock (from CMU_TOP)
318 - description: Parent clock for HS 318 - description: Parent clock for HSI2C and SPI (from CMU_TOP)
319 319
320 clock-names: 320 clock-names:
321 items: 321 items:
322 - const: oscclk 322 - const: oscclk
323 - const: dout_peri_bus 323 - const: dout_peri_bus
324 - const: dout_peri_uart 324 - const: dout_peri_uart
325 - const: dout_peri_ip 325 - const: dout_peri_ip
326 326
327 required: 327 required:
328 - compatible 328 - compatible
329 - "#clock-cells" 329 - "#clock-cells"
330 - clocks 330 - clocks
331 - clock-names 331 - clock-names
332 - reg 332 - reg
333 333
334 additionalProperties: false 334 additionalProperties: false
335 335
336 examples: 336 examples:
337 # Clock controller node for CMU_PERI 337 # Clock controller node for CMU_PERI
338 - | 338 - |
339 #include <dt-bindings/clock/exynos850.h> 339 #include <dt-bindings/clock/exynos850.h>
340 340
341 cmu_peri: clock-controller@10030000 { 341 cmu_peri: clock-controller@10030000 {
342 compatible = "samsung,exynos850-cmu-pe 342 compatible = "samsung,exynos850-cmu-peri";
343 reg = <0x10030000 0x8000>; 343 reg = <0x10030000 0x8000>;
344 #clock-cells = <1>; 344 #clock-cells = <1>;
345 345
346 clocks = <&oscclk>, <&cmu_top CLK_DOUT 346 clocks = <&oscclk>, <&cmu_top CLK_DOUT_PERI_BUS>,
347 <&cmu_top CLK_DOUT_PERI_UART> 347 <&cmu_top CLK_DOUT_PERI_UART>,
348 <&cmu_top CLK_DOUT_PERI_IP>; 348 <&cmu_top CLK_DOUT_PERI_IP>;
349 clock-names = "oscclk", "dout_peri_bus 349 clock-names = "oscclk", "dout_peri_bus",
350 "dout_peri_uart", "dout_ 350 "dout_peri_uart", "dout_peri_ip";
351 }; 351 };
352 352
353 ... 353 ...
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.