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