xref: /linux/drivers/clk/imx/clk.h (revision 97733180fafbeb7cc3fd1c8be60d05980615f5d6)
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 #define imx_clk_cpu(name, parent_name, div, mux, pll, step) \
76 	to_clk(imx_clk_hw_cpu(name, parent_name, div, mux, pll, step))
77 
78 #define clk_register_gate2(dev, name, parent_name, flags, reg, bit_idx, \
79 				cgr_val, cgr_mask, clk_gate_flags, lock, share_count) \
80 	to_clk(clk_hw_register_gate2(dev, name, parent_name, flags, reg, bit_idx, \
81 				cgr_val, cgr_mask, clk_gate_flags, lock, share_count))
82 
83 #define imx_clk_pllv3(type, name, parent_name, base, div_mask) \
84 	to_clk(imx_clk_hw_pllv3(type, name, parent_name, base, div_mask))
85 
86 #define imx_clk_pfd(name, parent_name, reg, idx) \
87 	to_clk(imx_clk_hw_pfd(name, parent_name, reg, idx))
88 
89 #define imx_clk_gate_exclusive(name, parent, reg, shift, exclusive_mask) \
90 	to_clk(imx_clk_hw_gate_exclusive(name, parent, reg, shift, exclusive_mask))
91 
92 #define imx_clk_fixed(name, rate) \
93 	to_clk(imx_clk_hw_fixed(name, rate))
94 
95 #define imx_clk_fixed_factor(name, parent, mult, div) \
96 	to_clk(imx_clk_hw_fixed_factor(name, parent, mult, div))
97 
98 #define imx_clk_divider(name, parent, reg, shift, width) \
99 	to_clk(imx_clk_hw_divider(name, parent, reg, shift, width))
100 
101 #define imx_clk_divider_flags(name, parent, reg, shift, width, flags) \
102 	to_clk(imx_clk_hw_divider_flags(name, parent, reg, shift, width, flags))
103 
104 #define imx_clk_gate(name, parent, reg, shift) \
105 	to_clk(imx_clk_hw_gate(name, parent, reg, shift))
106 
107 #define imx_clk_gate_dis(name, parent, reg, shift) \
108 	to_clk(imx_clk_hw_gate_dis(name, parent, reg, shift))
109 
110 #define imx_clk_gate2(name, parent, reg, shift) \
111 	to_clk(imx_clk_hw_gate2(name, parent, reg, shift))
112 
113 #define imx_clk_gate2_cgr(name, parent, reg, shift, cgr_val) \
114 	to_clk(__imx_clk_hw_gate2(name, parent, reg, shift, cgr_val, 0, NULL))
115 
116 #define imx_clk_gate2_flags(name, parent, reg, shift, flags) \
117 	to_clk(imx_clk_hw_gate2_flags(name, parent, reg, shift, flags))
118 
119 #define imx_clk_mux(name, reg, shift, width, parents, num_parents) \
120 	to_clk(imx_clk_hw_mux(name, reg, shift, width, parents, num_parents))
121 
122 #define imx_clk_mux_flags(name, reg, shift, width, parents, num_parents, flags) \
123 	to_clk(imx_clk_hw_mux_flags(name, reg, shift, width, parents, num_parents, flags))
124 
125 #define imx_clk_mux2_flags(name, reg, shift, width, parents, num_parents, flags) \
126 	to_clk(imx_clk_hw_mux2_flags(name, reg, shift, width, parents, num_parents, flags))
127 
128 #define imx_clk_pllv1(type, name, parent, base) \
129 	to_clk(imx_clk_hw_pllv1(type, name, parent, base))
130 
131 #define imx_clk_pllv2(name, parent, base) \
132 	to_clk(imx_clk_hw_pllv2(name, parent, base))
133 
134 #define imx_clk_mux_flags(name, reg, shift, width, parents, num_parents, flags) \
135 	to_clk(imx_clk_hw_mux_flags(name, reg, shift, width, parents, num_parents, flags))
136 
137 #define imx_clk_hw_gate(name, parent, reg, shift) \
138 	imx_clk_hw_gate_flags(name, parent, reg, shift, 0)
139 
140 #define imx_clk_hw_gate2(name, parent, reg, shift) \
141 	imx_clk_hw_gate2_flags(name, parent, reg, shift, 0)
142 
143 #define imx_clk_hw_gate_dis(name, parent, reg, shift) \
144 	imx_clk_hw_gate_dis_flags(name, parent, reg, shift, 0)
145 
146 #define imx_clk_hw_gate_dis_flags(name, parent, reg, shift, flags) \
147 	__imx_clk_hw_gate(name, parent, reg, shift, flags, CLK_GATE_SET_TO_DISABLE)
148 
149 #define imx_clk_hw_gate_flags(name, parent, reg, shift, flags) \
150 	__imx_clk_hw_gate(name, parent, reg, shift, flags, 0)
151 
152 #define imx_clk_hw_gate2_flags(name, parent, reg, shift, flags) \
153 	__imx_clk_hw_gate2(name, parent, reg, shift, 0x3, flags, NULL)
154 
155 #define imx_clk_hw_gate2_shared(name, parent, reg, shift, shared_count) \
156 	__imx_clk_hw_gate2(name, parent, reg, shift, 0x3, 0, shared_count)
157 
158 #define imx_clk_hw_gate2_shared2(name, parent, reg, shift, shared_count) \
159 	__imx_clk_hw_gate2(name, parent, reg, shift, 0x3, CLK_OPS_PARENT_ENABLE, shared_count)
160 
161 #define imx_clk_hw_gate3(name, parent, reg, shift) \
162 	imx_clk_hw_gate3_flags(name, parent, reg, shift, 0)
163 
164 #define imx_clk_hw_gate3_flags(name, parent, reg, shift, flags) \
165 	__imx_clk_hw_gate(name, parent, reg, shift, flags | CLK_OPS_PARENT_ENABLE, 0)
166 
167 #define imx_clk_hw_gate4(name, parent, reg, shift) \
168 	imx_clk_hw_gate4_flags(name, parent, reg, shift, 0)
169 
170 #define imx_clk_hw_gate4_flags(name, parent, reg, shift, flags) \
171 	imx_clk_hw_gate2_flags(name, parent, reg, shift, flags | CLK_OPS_PARENT_ENABLE)
172 
173 #define imx_clk_hw_mux2(name, reg, shift, width, parents, num_parents) \
174 	imx_clk_hw_mux2_flags(name, reg, shift, width, parents, num_parents, 0)
175 
176 #define imx_clk_hw_mux(name, reg, shift, width, parents, num_parents) \
177 	__imx_clk_hw_mux(name, reg, shift, width, parents, num_parents, 0, 0)
178 
179 #define imx_clk_hw_mux_flags(name, reg, shift, width, parents, num_parents, flags) \
180 	__imx_clk_hw_mux(name, reg, shift, width, parents, num_parents, flags, 0)
181 
182 #define imx_clk_hw_mux_ldb(name, reg, shift, width, parents, num_parents) \
183 	__imx_clk_hw_mux(name, reg, shift, width, parents, num_parents, CLK_SET_RATE_PARENT, CLK_MUX_READ_ONLY)
184 
185 #define imx_clk_hw_mux2_flags(name, reg, shift, width, parents, num_parents, flags) \
186 	__imx_clk_hw_mux(name, reg, shift, width, parents, num_parents, flags | CLK_OPS_PARENT_ENABLE, 0)
187 
188 #define imx_clk_hw_divider(name, parent, reg, shift, width) \
189 	__imx_clk_hw_divider(name, parent, reg, shift, width, CLK_SET_RATE_PARENT)
190 
191 #define imx_clk_hw_divider2(name, parent, reg, shift, width) \
192 	__imx_clk_hw_divider(name, parent, reg, shift, width, \
193 				CLK_SET_RATE_PARENT | CLK_OPS_PARENT_ENABLE)
194 
195 #define imx_clk_hw_divider_flags(name, parent, reg, shift, width, flags) \
196 	__imx_clk_hw_divider(name, parent, reg, shift, width, flags)
197 
198 #define imx_clk_hw_pll14xx(name, parent_name, base, pll_clk) \
199 	imx_dev_clk_hw_pll14xx(NULL, name, parent_name, base, pll_clk)
200 
201 struct clk_hw *imx_dev_clk_hw_pll14xx(struct device *dev, const char *name,
202 				const char *parent_name, void __iomem *base,
203 				const struct imx_pll14xx_clk *pll_clk);
204 
205 struct clk_hw *imx_clk_hw_pllv1(enum imx_pllv1_type type, const char *name,
206 		const char *parent, void __iomem *base);
207 
208 struct clk_hw *imx_clk_hw_pllv2(const char *name, const char *parent,
209 		void __iomem *base);
210 
211 struct clk_hw *imx_clk_hw_frac_pll(const char *name, const char *parent_name,
212 			     void __iomem *base);
213 
214 struct clk_hw *imx_clk_hw_sscg_pll(const char *name,
215 				const char * const *parent_names,
216 				u8 num_parents,
217 				u8 parent, u8 bypass1, u8 bypass2,
218 				void __iomem *base,
219 				unsigned long flags);
220 
221 enum imx_pllv3_type {
222 	IMX_PLLV3_GENERIC,
223 	IMX_PLLV3_SYS,
224 	IMX_PLLV3_USB,
225 	IMX_PLLV3_USB_VF610,
226 	IMX_PLLV3_AV,
227 	IMX_PLLV3_ENET,
228 	IMX_PLLV3_ENET_IMX7,
229 	IMX_PLLV3_SYS_VF610,
230 	IMX_PLLV3_DDR_IMX7,
231 	IMX_PLLV3_AV_IMX7,
232 };
233 
234 struct clk_hw *imx_clk_hw_pllv3(enum imx_pllv3_type type, const char *name,
235 		const char *parent_name, void __iomem *base, u32 div_mask);
236 
237 #define PLL_1416X_RATE(_rate, _m, _p, _s)		\
238 	{						\
239 		.rate	=	(_rate),		\
240 		.mdiv	=	(_m),			\
241 		.pdiv	=	(_p),			\
242 		.sdiv	=	(_s),			\
243 	}
244 
245 #define PLL_1443X_RATE(_rate, _m, _p, _s, _k)		\
246 	{						\
247 		.rate	=	(_rate),		\
248 		.mdiv	=	(_m),			\
249 		.pdiv	=	(_p),			\
250 		.sdiv	=	(_s),			\
251 		.kdiv	=	(_k),			\
252 	}
253 
254 struct clk_hw *imx_clk_hw_pllv4(enum imx_pllv4_type type, const char *name,
255 		const char *parent_name, void __iomem *base);
256 
257 struct clk_hw *clk_hw_register_gate2(struct device *dev, const char *name,
258 		const char *parent_name, unsigned long flags,
259 		void __iomem *reg, u8 bit_idx, u8 cgr_val, u8 cgr_mask,
260 		u8 clk_gate_flags, spinlock_t *lock,
261 		unsigned int *share_count);
262 
263 struct clk * imx_obtain_fixed_clock(
264 			const char *name, unsigned long rate);
265 
266 struct clk_hw *imx_obtain_fixed_clock_hw(
267 			const char *name, unsigned long rate);
268 
269 struct clk_hw *imx_obtain_fixed_clk_hw(struct device_node *np,
270 				       const char *name);
271 
272 struct clk_hw *imx_clk_hw_gate_exclusive(const char *name, const char *parent,
273 	 void __iomem *reg, u8 shift, u32 exclusive_mask);
274 
275 struct clk_hw *imx_clk_hw_pfd(const char *name, const char *parent_name,
276 		void __iomem *reg, u8 idx);
277 
278 struct clk_hw *imx_clk_hw_pfdv2(enum imx_pfdv2_type type, const char *name,
279 	 const char *parent_name, void __iomem *reg, u8 idx);
280 
281 struct clk_hw *imx_clk_hw_busy_divider(const char *name, const char *parent_name,
282 				 void __iomem *reg, u8 shift, u8 width,
283 				 void __iomem *busy_reg, u8 busy_shift);
284 
285 struct clk_hw *imx_clk_hw_busy_mux(const char *name, void __iomem *reg, u8 shift,
286 			     u8 width, void __iomem *busy_reg, u8 busy_shift,
287 			     const char * const *parent_names, int num_parents);
288 
289 struct clk_hw *imx7ulp_clk_hw_composite(const char *name,
290 				     const char * const *parent_names,
291 				     int num_parents, bool mux_present,
292 				     bool rate_present, bool gate_present,
293 				     void __iomem *reg);
294 
295 struct clk_hw *imx8ulp_clk_hw_composite(const char *name,
296 				     const char * const *parent_names,
297 				     int num_parents, bool mux_present,
298 				     bool rate_present, bool gate_present,
299 				     void __iomem *reg, bool has_swrst);
300 
301 struct clk_hw *imx_clk_hw_fixup_divider(const char *name, const char *parent,
302 				  void __iomem *reg, u8 shift, u8 width,
303 				  void (*fixup)(u32 *val));
304 
305 struct clk_hw *imx_clk_hw_fixup_mux(const char *name, void __iomem *reg,
306 			      u8 shift, u8 width, const char * const *parents,
307 			      int num_parents, void (*fixup)(u32 *val));
308 
309 static inline struct clk *to_clk(struct clk_hw *hw)
310 {
311 	if (IS_ERR_OR_NULL(hw))
312 		return ERR_CAST(hw);
313 	return hw->clk;
314 }
315 
316 static inline struct clk_hw *imx_clk_hw_fixed(const char *name, int rate)
317 {
318 	return clk_hw_register_fixed_rate(NULL, name, NULL, 0, rate);
319 }
320 
321 static inline struct clk_hw *imx_clk_hw_fixed_factor(const char *name,
322 		const char *parent, unsigned int mult, unsigned int div)
323 {
324 	return clk_hw_register_fixed_factor(NULL, name, parent,
325 			CLK_SET_RATE_PARENT, mult, div);
326 }
327 
328 static inline struct clk_hw *__imx_clk_hw_divider(const char *name,
329 						   const char *parent,
330 						   void __iomem *reg, u8 shift,
331 						   u8 width, unsigned long flags)
332 {
333 	return clk_hw_register_divider(NULL, name, parent, flags,
334 				       reg, shift, width, 0, &imx_ccm_lock);
335 }
336 
337 static inline struct clk_hw *__imx_clk_hw_gate(const char *name, const char *parent,
338 						void __iomem *reg, u8 shift,
339 						unsigned long flags,
340 						unsigned long clk_gate_flags)
341 {
342 	return clk_hw_register_gate(NULL, name, parent, flags | CLK_SET_RATE_PARENT, reg,
343 					shift, clk_gate_flags, &imx_ccm_lock);
344 }
345 
346 static inline struct clk_hw *__imx_clk_hw_gate2(const char *name, const char *parent,
347 						void __iomem *reg, u8 shift, u8 cgr_val,
348 						unsigned long flags,
349 						unsigned int *share_count)
350 {
351 	return clk_hw_register_gate2(NULL, name, parent, flags | CLK_SET_RATE_PARENT, reg,
352 					shift, cgr_val, 0x3, 0, &imx_ccm_lock, share_count);
353 }
354 
355 static inline struct clk_hw *__imx_clk_hw_mux(const char *name, void __iomem *reg,
356 			u8 shift, u8 width, const char * const *parents,
357 			int num_parents, unsigned long flags, unsigned long clk_mux_flags)
358 {
359 	return clk_hw_register_mux(NULL, name, parents, num_parents,
360 			flags | CLK_SET_RATE_NO_REPARENT, reg, shift,
361 			width, clk_mux_flags, &imx_ccm_lock);
362 }
363 
364 struct clk_hw *imx_clk_hw_cpu(const char *name, const char *parent_name,
365 		struct clk *div, struct clk *mux, struct clk *pll,
366 		struct clk *step);
367 
368 #define IMX_COMPOSITE_CORE		BIT(0)
369 #define IMX_COMPOSITE_BUS		BIT(1)
370 #define IMX_COMPOSITE_FW_MANAGED	BIT(2)
371 
372 #define IMX_COMPOSITE_CLK_FLAGS_DEFAULT \
373 	(CLK_SET_RATE_NO_REPARENT | CLK_OPS_PARENT_ENABLE)
374 #define IMX_COMPOSITE_CLK_FLAGS_CRITICAL \
375 	(IMX_COMPOSITE_CLK_FLAGS_DEFAULT | CLK_IS_CRITICAL)
376 #define IMX_COMPOSITE_CLK_FLAGS_GET_RATE_NO_CACHE \
377 	(IMX_COMPOSITE_CLK_FLAGS_DEFAULT | CLK_GET_RATE_NOCACHE)
378 #define IMX_COMPOSITE_CLK_FLAGS_CRITICAL_GET_RATE_NO_CACHE \
379 	(IMX_COMPOSITE_CLK_FLAGS_GET_RATE_NO_CACHE | CLK_IS_CRITICAL)
380 
381 struct clk_hw *__imx8m_clk_hw_composite(const char *name,
382 					    const char * const *parent_names,
383 					    int num_parents,
384 					    void __iomem *reg,
385 					    u32 composite_flags,
386 					    unsigned long flags);
387 
388 #define _imx8m_clk_hw_composite(name, parent_names, reg, composite_flags, flags) \
389 	__imx8m_clk_hw_composite(name, parent_names, \
390 		ARRAY_SIZE(parent_names), reg, composite_flags, flags)
391 
392 #define imx8m_clk_hw_composite(name, parent_names, reg) \
393 	_imx8m_clk_hw_composite(name, parent_names, reg, \
394 			0, IMX_COMPOSITE_CLK_FLAGS_DEFAULT)
395 
396 #define imx8m_clk_hw_composite_critical(name, parent_names, reg) \
397 	_imx8m_clk_hw_composite(name, parent_names, reg, \
398 			0, IMX_COMPOSITE_CLK_FLAGS_CRITICAL)
399 
400 #define imx8m_clk_hw_composite_bus(name, parent_names, reg)	\
401 	_imx8m_clk_hw_composite(name, parent_names, reg, \
402 			IMX_COMPOSITE_BUS, IMX_COMPOSITE_CLK_FLAGS_DEFAULT)
403 
404 #define imx8m_clk_hw_composite_bus_critical(name, parent_names, reg)	\
405 	_imx8m_clk_hw_composite(name, parent_names, reg, \
406 			IMX_COMPOSITE_BUS, IMX_COMPOSITE_CLK_FLAGS_CRITICAL)
407 
408 #define imx8m_clk_hw_composite_core(name, parent_names, reg)	\
409 	_imx8m_clk_hw_composite(name, parent_names, reg, \
410 			IMX_COMPOSITE_CORE, IMX_COMPOSITE_CLK_FLAGS_DEFAULT)
411 
412 #define imx8m_clk_hw_fw_managed_composite(name, parent_names, reg) \
413 	_imx8m_clk_hw_composite(name, parent_names, reg, \
414 			IMX_COMPOSITE_FW_MANAGED, \
415 			IMX_COMPOSITE_CLK_FLAGS_GET_RATE_NO_CACHE)
416 
417 #define imx8m_clk_hw_fw_managed_composite_critical(name, parent_names, reg) \
418 	_imx8m_clk_hw_composite(name, parent_names, reg, \
419 			IMX_COMPOSITE_FW_MANAGED, \
420 			IMX_COMPOSITE_CLK_FLAGS_CRITICAL_GET_RATE_NO_CACHE)
421 
422 struct clk_hw *imx_clk_hw_divider_gate(const char *name, const char *parent_name,
423 		unsigned long flags, void __iomem *reg, u8 shift, u8 width,
424 		u8 clk_divider_flags, const struct clk_div_table *table,
425 		spinlock_t *lock);
426 #endif
427