xref: /linux/drivers/clk/imx/clk.h (revision 34f7c6e7d4396090692a09789db231e12cb4762b)
1 /* SPDX-License-Identifier: GPL-2.0 */
2 #ifndef __MACH_IMX_CLK_H
3 #define __MACH_IMX_CLK_H
4 
5 #include <linux/bits.h>
6 #include <linux/spinlock.h>
7 #include <linux/clk-provider.h>
8 
9 extern spinlock_t imx_ccm_lock;
10 
11 void imx_check_clocks(struct clk *clks[], unsigned int count);
12 void imx_check_clk_hws(struct clk_hw *clks[], unsigned int count);
13 #ifndef MODULE
14 void imx_register_uart_clocks(unsigned int clk_count);
15 #else
16 static inline void imx_register_uart_clocks(unsigned int clk_count)
17 {
18 }
19 #endif
20 void imx_mmdc_mask_handshake(void __iomem *ccm_base, unsigned int chn);
21 void imx_unregister_clocks(struct clk *clks[], unsigned int count);
22 void imx_unregister_hw_clocks(struct clk_hw *hws[], unsigned int count);
23 
24 extern void imx_cscmr1_fixup(u32 *val);
25 
26 enum imx_pllv1_type {
27 	IMX_PLLV1_IMX1,
28 	IMX_PLLV1_IMX21,
29 	IMX_PLLV1_IMX25,
30 	IMX_PLLV1_IMX27,
31 	IMX_PLLV1_IMX31,
32 	IMX_PLLV1_IMX35,
33 };
34 
35 enum imx_sscg_pll_type {
36 	SCCG_PLL1,
37 	SCCG_PLL2,
38 };
39 
40 enum imx_pll14xx_type {
41 	PLL_1416X,
42 	PLL_1443X,
43 };
44 
45 enum imx_pllv4_type {
46 	IMX_PLLV4_IMX7ULP,
47 	IMX_PLLV4_IMX8ULP,
48 };
49 
50 enum imx_pfdv2_type {
51 	IMX_PFDV2_IMX7ULP,
52 	IMX_PFDV2_IMX8ULP,
53 };
54 
55 /* NOTE: Rate table should be kept sorted in descending order. */
56 struct imx_pll14xx_rate_table {
57 	unsigned int rate;
58 	unsigned int pdiv;
59 	unsigned int mdiv;
60 	unsigned int sdiv;
61 	unsigned int kdiv;
62 };
63 
64 struct imx_pll14xx_clk {
65 	enum imx_pll14xx_type type;
66 	const struct imx_pll14xx_rate_table *rate_table;
67 	int rate_count;
68 	int flags;
69 };
70 
71 extern struct imx_pll14xx_clk imx_1416x_pll;
72 extern struct imx_pll14xx_clk imx_1443x_pll;
73 extern struct imx_pll14xx_clk imx_1443x_dram_pll;
74 
75 /* NOTE: Rate table should be kept sorted in descending order. */
76 struct imx_fracn_gppll_rate_table {
77 	unsigned int rate;
78 	unsigned int mfi;
79 	unsigned int mfn;
80 	unsigned int mfd;
81 	unsigned int rdiv;
82 	unsigned int odiv;
83 };
84 
85 struct imx_fracn_gppll_clk {
86 	const struct imx_fracn_gppll_rate_table *rate_table;
87 	int rate_count;
88 	int flags;
89 };
90 
91 struct clk_hw *imx_clk_fracn_gppll(const char *name, const char *parent_name, void __iomem *base,
92 				   const struct imx_fracn_gppll_clk *pll_clk);
93 
94 extern struct imx_fracn_gppll_clk imx_fracn_gppll;
95 
96 #define imx_clk_cpu(name, parent_name, div, mux, pll, step) \
97 	to_clk(imx_clk_hw_cpu(name, parent_name, div, mux, pll, step))
98 
99 #define clk_register_gate2(dev, name, parent_name, flags, reg, bit_idx, \
100 				cgr_val, cgr_mask, clk_gate_flags, lock, share_count) \
101 	to_clk(clk_hw_register_gate2(dev, name, parent_name, flags, reg, bit_idx, \
102 				cgr_val, cgr_mask, clk_gate_flags, lock, share_count))
103 
104 #define imx_clk_pllv3(type, name, parent_name, base, div_mask) \
105 	to_clk(imx_clk_hw_pllv3(type, name, parent_name, base, div_mask))
106 
107 #define imx_clk_pfd(name, parent_name, reg, idx) \
108 	to_clk(imx_clk_hw_pfd(name, parent_name, reg, idx))
109 
110 #define imx_clk_gate_exclusive(name, parent, reg, shift, exclusive_mask) \
111 	to_clk(imx_clk_hw_gate_exclusive(name, parent, reg, shift, exclusive_mask))
112 
113 #define imx_clk_fixed(name, rate) \
114 	to_clk(imx_clk_hw_fixed(name, rate))
115 
116 #define imx_clk_fixed_factor(name, parent, mult, div) \
117 	to_clk(imx_clk_hw_fixed_factor(name, parent, mult, div))
118 
119 #define imx_clk_divider(name, parent, reg, shift, width) \
120 	to_clk(imx_clk_hw_divider(name, parent, reg, shift, width))
121 
122 #define imx_clk_divider_flags(name, parent, reg, shift, width, flags) \
123 	to_clk(imx_clk_hw_divider_flags(name, parent, reg, shift, width, flags))
124 
125 #define imx_clk_gate(name, parent, reg, shift) \
126 	to_clk(imx_clk_hw_gate(name, parent, reg, shift))
127 
128 #define imx_clk_gate_dis(name, parent, reg, shift) \
129 	to_clk(imx_clk_hw_gate_dis(name, parent, reg, shift))
130 
131 #define imx_clk_gate2(name, parent, reg, shift) \
132 	to_clk(imx_clk_hw_gate2(name, parent, reg, shift))
133 
134 #define imx_clk_gate2_cgr(name, parent, reg, shift, cgr_val) \
135 	to_clk(__imx_clk_hw_gate2(name, parent, reg, shift, cgr_val, 0, NULL))
136 
137 #define imx_clk_gate2_flags(name, parent, reg, shift, flags) \
138 	to_clk(imx_clk_hw_gate2_flags(name, parent, reg, shift, flags))
139 
140 #define imx_clk_mux(name, reg, shift, width, parents, num_parents) \
141 	to_clk(imx_clk_hw_mux(name, reg, shift, width, parents, num_parents))
142 
143 #define imx_clk_mux_flags(name, reg, shift, width, parents, num_parents, flags) \
144 	to_clk(imx_clk_hw_mux_flags(name, reg, shift, width, parents, num_parents, flags))
145 
146 #define imx_clk_mux2_flags(name, reg, shift, width, parents, num_parents, flags) \
147 	to_clk(imx_clk_hw_mux2_flags(name, reg, shift, width, parents, num_parents, flags))
148 
149 #define imx_clk_pllv1(type, name, parent, base) \
150 	to_clk(imx_clk_hw_pllv1(type, name, parent, base))
151 
152 #define imx_clk_pllv2(name, parent, base) \
153 	to_clk(imx_clk_hw_pllv2(name, parent, base))
154 
155 #define imx_clk_mux_flags(name, reg, shift, width, parents, num_parents, flags) \
156 	to_clk(imx_clk_hw_mux_flags(name, reg, shift, width, parents, num_parents, flags))
157 
158 #define imx_clk_hw_gate(name, parent, reg, shift) \
159 	imx_clk_hw_gate_flags(name, parent, reg, shift, 0)
160 
161 #define imx_clk_hw_gate2(name, parent, reg, shift) \
162 	imx_clk_hw_gate2_flags(name, parent, reg, shift, 0)
163 
164 #define imx_clk_hw_gate_dis(name, parent, reg, shift) \
165 	imx_clk_hw_gate_dis_flags(name, parent, reg, shift, 0)
166 
167 #define imx_clk_hw_gate_dis_flags(name, parent, reg, shift, flags) \
168 	__imx_clk_hw_gate(name, parent, reg, shift, flags, CLK_GATE_SET_TO_DISABLE)
169 
170 #define imx_clk_hw_gate_flags(name, parent, reg, shift, flags) \
171 	__imx_clk_hw_gate(name, parent, reg, shift, flags, 0)
172 
173 #define imx_clk_hw_gate2_flags(name, parent, reg, shift, flags) \
174 	__imx_clk_hw_gate2(name, parent, reg, shift, 0x3, flags, NULL)
175 
176 #define imx_clk_hw_gate2_shared(name, parent, reg, shift, shared_count) \
177 	__imx_clk_hw_gate2(name, parent, reg, shift, 0x3, 0, shared_count)
178 
179 #define imx_clk_hw_gate2_shared2(name, parent, reg, shift, shared_count) \
180 	__imx_clk_hw_gate2(name, parent, reg, shift, 0x3, CLK_OPS_PARENT_ENABLE, shared_count)
181 
182 #define imx_clk_hw_gate3(name, parent, reg, shift) \
183 	imx_clk_hw_gate3_flags(name, parent, reg, shift, 0)
184 
185 #define imx_clk_hw_gate3_flags(name, parent, reg, shift, flags) \
186 	__imx_clk_hw_gate(name, parent, reg, shift, flags | CLK_OPS_PARENT_ENABLE, 0)
187 
188 #define imx_clk_hw_gate4(name, parent, reg, shift) \
189 	imx_clk_hw_gate4_flags(name, parent, reg, shift, 0)
190 
191 #define imx_clk_hw_gate4_flags(name, parent, reg, shift, flags) \
192 	imx_clk_hw_gate2_flags(name, parent, reg, shift, flags | CLK_OPS_PARENT_ENABLE)
193 
194 #define imx_clk_hw_mux2(name, reg, shift, width, parents, num_parents) \
195 	imx_clk_hw_mux2_flags(name, reg, shift, width, parents, num_parents, 0)
196 
197 #define imx_clk_hw_mux(name, reg, shift, width, parents, num_parents) \
198 	__imx_clk_hw_mux(name, reg, shift, width, parents, num_parents, 0, 0)
199 
200 #define imx_clk_hw_mux_flags(name, reg, shift, width, parents, num_parents, flags) \
201 	__imx_clk_hw_mux(name, reg, shift, width, parents, num_parents, flags, 0)
202 
203 #define imx_clk_hw_mux_ldb(name, reg, shift, width, parents, num_parents) \
204 	__imx_clk_hw_mux(name, reg, shift, width, parents, num_parents, CLK_SET_RATE_PARENT, CLK_MUX_READ_ONLY)
205 
206 #define imx_clk_hw_mux2_flags(name, reg, shift, width, parents, num_parents, flags) \
207 	__imx_clk_hw_mux(name, reg, shift, width, parents, num_parents, flags | CLK_OPS_PARENT_ENABLE, 0)
208 
209 #define imx_clk_hw_divider(name, parent, reg, shift, width) \
210 	__imx_clk_hw_divider(name, parent, reg, shift, width, CLK_SET_RATE_PARENT)
211 
212 #define imx_clk_hw_divider2(name, parent, reg, shift, width) \
213 	__imx_clk_hw_divider(name, parent, reg, shift, width, \
214 				CLK_SET_RATE_PARENT | CLK_OPS_PARENT_ENABLE)
215 
216 #define imx_clk_hw_divider_flags(name, parent, reg, shift, width, flags) \
217 	__imx_clk_hw_divider(name, parent, reg, shift, width, flags)
218 
219 #define imx_clk_hw_pll14xx(name, parent_name, base, pll_clk) \
220 	imx_dev_clk_hw_pll14xx(NULL, name, parent_name, base, pll_clk)
221 
222 struct clk_hw *imx_dev_clk_hw_pll14xx(struct device *dev, const char *name,
223 				const char *parent_name, void __iomem *base,
224 				const struct imx_pll14xx_clk *pll_clk);
225 
226 struct clk_hw *imx_clk_hw_pllv1(enum imx_pllv1_type type, const char *name,
227 		const char *parent, void __iomem *base);
228 
229 struct clk_hw *imx_clk_hw_pllv2(const char *name, const char *parent,
230 		void __iomem *base);
231 
232 struct clk_hw *imx_clk_hw_frac_pll(const char *name, const char *parent_name,
233 			     void __iomem *base);
234 
235 struct clk_hw *imx_clk_hw_sscg_pll(const char *name,
236 				const char * const *parent_names,
237 				u8 num_parents,
238 				u8 parent, u8 bypass1, u8 bypass2,
239 				void __iomem *base,
240 				unsigned long flags);
241 
242 enum imx_pllv3_type {
243 	IMX_PLLV3_GENERIC,
244 	IMX_PLLV3_SYS,
245 	IMX_PLLV3_USB,
246 	IMX_PLLV3_USB_VF610,
247 	IMX_PLLV3_AV,
248 	IMX_PLLV3_ENET,
249 	IMX_PLLV3_ENET_IMX7,
250 	IMX_PLLV3_SYS_VF610,
251 	IMX_PLLV3_DDR_IMX7,
252 	IMX_PLLV3_AV_IMX7,
253 };
254 
255 struct clk_hw *imx_clk_hw_pllv3(enum imx_pllv3_type type, const char *name,
256 		const char *parent_name, void __iomem *base, u32 div_mask);
257 
258 #define PLL_1416X_RATE(_rate, _m, _p, _s)		\
259 	{						\
260 		.rate	=	(_rate),		\
261 		.mdiv	=	(_m),			\
262 		.pdiv	=	(_p),			\
263 		.sdiv	=	(_s),			\
264 	}
265 
266 #define PLL_1443X_RATE(_rate, _m, _p, _s, _k)		\
267 	{						\
268 		.rate	=	(_rate),		\
269 		.mdiv	=	(_m),			\
270 		.pdiv	=	(_p),			\
271 		.sdiv	=	(_s),			\
272 		.kdiv	=	(_k),			\
273 	}
274 
275 struct clk_hw *imx_clk_hw_pllv4(enum imx_pllv4_type type, const char *name,
276 		const char *parent_name, void __iomem *base);
277 
278 struct clk_hw *clk_hw_register_gate2(struct device *dev, const char *name,
279 		const char *parent_name, unsigned long flags,
280 		void __iomem *reg, u8 bit_idx, u8 cgr_val, u8 cgr_mask,
281 		u8 clk_gate_flags, spinlock_t *lock,
282 		unsigned int *share_count);
283 
284 struct clk * imx_obtain_fixed_clock(
285 			const char *name, unsigned long rate);
286 
287 struct clk_hw *imx_obtain_fixed_clock_hw(
288 			const char *name, unsigned long rate);
289 
290 struct clk_hw *imx_obtain_fixed_clk_hw(struct device_node *np,
291 				       const char *name);
292 
293 struct clk_hw *imx_clk_hw_gate_exclusive(const char *name, const char *parent,
294 	 void __iomem *reg, u8 shift, u32 exclusive_mask);
295 
296 struct clk_hw *imx_clk_hw_pfd(const char *name, const char *parent_name,
297 		void __iomem *reg, u8 idx);
298 
299 struct clk_hw *imx_clk_hw_pfdv2(enum imx_pfdv2_type type, const char *name,
300 	 const char *parent_name, void __iomem *reg, u8 idx);
301 
302 struct clk_hw *imx_clk_hw_busy_divider(const char *name, const char *parent_name,
303 				 void __iomem *reg, u8 shift, u8 width,
304 				 void __iomem *busy_reg, u8 busy_shift);
305 
306 struct clk_hw *imx_clk_hw_busy_mux(const char *name, void __iomem *reg, u8 shift,
307 			     u8 width, void __iomem *busy_reg, u8 busy_shift,
308 			     const char * const *parent_names, int num_parents);
309 
310 struct clk_hw *imx7ulp_clk_hw_composite(const char *name,
311 				     const char * const *parent_names,
312 				     int num_parents, bool mux_present,
313 				     bool rate_present, bool gate_present,
314 				     void __iomem *reg);
315 
316 struct clk_hw *imx8ulp_clk_hw_composite(const char *name,
317 				     const char * const *parent_names,
318 				     int num_parents, bool mux_present,
319 				     bool rate_present, bool gate_present,
320 				     void __iomem *reg, bool has_swrst);
321 
322 struct clk_hw *imx_clk_hw_fixup_divider(const char *name, const char *parent,
323 				  void __iomem *reg, u8 shift, u8 width,
324 				  void (*fixup)(u32 *val));
325 
326 struct clk_hw *imx_clk_hw_fixup_mux(const char *name, void __iomem *reg,
327 			      u8 shift, u8 width, const char * const *parents,
328 			      int num_parents, void (*fixup)(u32 *val));
329 
330 static inline struct clk *to_clk(struct clk_hw *hw)
331 {
332 	if (IS_ERR_OR_NULL(hw))
333 		return ERR_CAST(hw);
334 	return hw->clk;
335 }
336 
337 static inline struct clk_hw *imx_clk_hw_fixed(const char *name, int rate)
338 {
339 	return clk_hw_register_fixed_rate(NULL, name, NULL, 0, rate);
340 }
341 
342 static inline struct clk_hw *imx_clk_hw_fixed_factor(const char *name,
343 		const char *parent, unsigned int mult, unsigned int div)
344 {
345 	return clk_hw_register_fixed_factor(NULL, name, parent,
346 			CLK_SET_RATE_PARENT, mult, div);
347 }
348 
349 static inline struct clk_hw *__imx_clk_hw_divider(const char *name,
350 						   const char *parent,
351 						   void __iomem *reg, u8 shift,
352 						   u8 width, unsigned long flags)
353 {
354 	return clk_hw_register_divider(NULL, name, parent, flags,
355 				       reg, shift, width, 0, &imx_ccm_lock);
356 }
357 
358 static inline struct clk_hw *__imx_clk_hw_gate(const char *name, const char *parent,
359 						void __iomem *reg, u8 shift,
360 						unsigned long flags,
361 						unsigned long clk_gate_flags)
362 {
363 	return clk_hw_register_gate(NULL, name, parent, flags | CLK_SET_RATE_PARENT, reg,
364 					shift, clk_gate_flags, &imx_ccm_lock);
365 }
366 
367 static inline struct clk_hw *__imx_clk_hw_gate2(const char *name, const char *parent,
368 						void __iomem *reg, u8 shift, u8 cgr_val,
369 						unsigned long flags,
370 						unsigned int *share_count)
371 {
372 	return clk_hw_register_gate2(NULL, name, parent, flags | CLK_SET_RATE_PARENT, reg,
373 					shift, cgr_val, 0x3, 0, &imx_ccm_lock, share_count);
374 }
375 
376 static inline struct clk_hw *__imx_clk_hw_mux(const char *name, void __iomem *reg,
377 			u8 shift, u8 width, const char * const *parents,
378 			int num_parents, unsigned long flags, unsigned long clk_mux_flags)
379 {
380 	return clk_hw_register_mux(NULL, name, parents, num_parents,
381 			flags | CLK_SET_RATE_NO_REPARENT, reg, shift,
382 			width, clk_mux_flags, &imx_ccm_lock);
383 }
384 
385 struct clk_hw *imx_clk_hw_cpu(const char *name, const char *parent_name,
386 		struct clk *div, struct clk *mux, struct clk *pll,
387 		struct clk *step);
388 
389 #define IMX_COMPOSITE_CORE		BIT(0)
390 #define IMX_COMPOSITE_BUS		BIT(1)
391 #define IMX_COMPOSITE_FW_MANAGED	BIT(2)
392 
393 #define IMX_COMPOSITE_CLK_FLAGS_DEFAULT \
394 	(CLK_SET_RATE_NO_REPARENT | CLK_OPS_PARENT_ENABLE)
395 #define IMX_COMPOSITE_CLK_FLAGS_CRITICAL \
396 	(IMX_COMPOSITE_CLK_FLAGS_DEFAULT | CLK_IS_CRITICAL)
397 #define IMX_COMPOSITE_CLK_FLAGS_GET_RATE_NO_CACHE \
398 	(IMX_COMPOSITE_CLK_FLAGS_DEFAULT | CLK_GET_RATE_NOCACHE)
399 #define IMX_COMPOSITE_CLK_FLAGS_CRITICAL_GET_RATE_NO_CACHE \
400 	(IMX_COMPOSITE_CLK_FLAGS_GET_RATE_NO_CACHE | CLK_IS_CRITICAL)
401 
402 struct clk_hw *__imx8m_clk_hw_composite(const char *name,
403 					    const char * const *parent_names,
404 					    int num_parents,
405 					    void __iomem *reg,
406 					    u32 composite_flags,
407 					    unsigned long flags);
408 
409 #define _imx8m_clk_hw_composite(name, parent_names, reg, composite_flags, flags) \
410 	__imx8m_clk_hw_composite(name, parent_names, \
411 		ARRAY_SIZE(parent_names), reg, composite_flags, flags)
412 
413 #define imx8m_clk_hw_composite(name, parent_names, reg) \
414 	_imx8m_clk_hw_composite(name, parent_names, reg, \
415 			0, IMX_COMPOSITE_CLK_FLAGS_DEFAULT)
416 
417 #define imx8m_clk_hw_composite_critical(name, parent_names, reg) \
418 	_imx8m_clk_hw_composite(name, parent_names, reg, \
419 			0, IMX_COMPOSITE_CLK_FLAGS_CRITICAL)
420 
421 #define imx8m_clk_hw_composite_bus(name, parent_names, reg)	\
422 	_imx8m_clk_hw_composite(name, parent_names, reg, \
423 			IMX_COMPOSITE_BUS, IMX_COMPOSITE_CLK_FLAGS_DEFAULT)
424 
425 #define imx8m_clk_hw_composite_bus_critical(name, parent_names, reg)	\
426 	_imx8m_clk_hw_composite(name, parent_names, reg, \
427 			IMX_COMPOSITE_BUS, IMX_COMPOSITE_CLK_FLAGS_CRITICAL)
428 
429 #define imx8m_clk_hw_composite_core(name, parent_names, reg)	\
430 	_imx8m_clk_hw_composite(name, parent_names, reg, \
431 			IMX_COMPOSITE_CORE, IMX_COMPOSITE_CLK_FLAGS_DEFAULT)
432 
433 #define imx8m_clk_hw_fw_managed_composite(name, parent_names, reg) \
434 	_imx8m_clk_hw_composite(name, parent_names, reg, \
435 			IMX_COMPOSITE_FW_MANAGED, \
436 			IMX_COMPOSITE_CLK_FLAGS_GET_RATE_NO_CACHE)
437 
438 #define imx8m_clk_hw_fw_managed_composite_critical(name, parent_names, reg) \
439 	_imx8m_clk_hw_composite(name, parent_names, reg, \
440 			IMX_COMPOSITE_FW_MANAGED, \
441 			IMX_COMPOSITE_CLK_FLAGS_CRITICAL_GET_RATE_NO_CACHE)
442 
443 struct clk_hw *imx93_clk_composite_flags(const char *name,
444 					 const char * const *parent_names,
445 					 int num_parents,
446 					 void __iomem *reg,
447 					 unsigned long flags);
448 #define imx93_clk_composite(name, parent_names, num_parents, reg) \
449 	imx93_clk_composite_flags(name, parent_names, num_parents, reg, \
450 				  CLK_SET_RATE_NO_REPARENT | CLK_OPS_PARENT_ENABLE)
451 
452 struct clk_hw *imx_clk_hw_divider_gate(const char *name, const char *parent_name,
453 		unsigned long flags, void __iomem *reg, u8 shift, u8 width,
454 		u8 clk_divider_flags, const struct clk_div_table *table,
455 		spinlock_t *lock);
456 #endif
457