xref: /openbmc/linux/drivers/clk/tegra/clk.h (revision 249592bf)
1 /* SPDX-License-Identifier: GPL-2.0-only */
2 	/*
3  * Copyright (c) 2012, NVIDIA CORPORATION.  All rights reserved.
4  */
5 
6 #ifndef __TEGRA_CLK_H
7 #define __TEGRA_CLK_H
8 
9 #include <linux/clk-provider.h>
10 #include <linux/clkdev.h>
11 #include <linux/delay.h>
12 
13 #define CLK_OUT_ENB_L			0x010
14 #define CLK_OUT_ENB_H			0x014
15 #define CLK_OUT_ENB_U			0x018
16 #define CLK_OUT_ENB_V			0x360
17 #define CLK_OUT_ENB_W			0x364
18 #define CLK_OUT_ENB_X			0x280
19 #define CLK_OUT_ENB_Y			0x298
20 #define CLK_ENB_PLLP_OUT_CPU		BIT(31)
21 #define CLK_OUT_ENB_SET_L		0x320
22 #define CLK_OUT_ENB_CLR_L		0x324
23 #define CLK_OUT_ENB_SET_H		0x328
24 #define CLK_OUT_ENB_CLR_H		0x32c
25 #define CLK_OUT_ENB_SET_U		0x330
26 #define CLK_OUT_ENB_CLR_U		0x334
27 #define CLK_OUT_ENB_SET_V		0x440
28 #define CLK_OUT_ENB_CLR_V		0x444
29 #define CLK_OUT_ENB_SET_W		0x448
30 #define CLK_OUT_ENB_CLR_W		0x44c
31 #define CLK_OUT_ENB_SET_X		0x284
32 #define CLK_OUT_ENB_CLR_X		0x288
33 #define CLK_OUT_ENB_SET_Y		0x29c
34 #define CLK_OUT_ENB_CLR_Y		0x2a0
35 
36 #define RST_DEVICES_L			0x004
37 #define RST_DEVICES_H			0x008
38 #define RST_DEVICES_U			0x00C
39 #define RST_DEVICES_V			0x358
40 #define RST_DEVICES_W			0x35C
41 #define RST_DEVICES_X			0x28C
42 #define RST_DEVICES_Y			0x2a4
43 #define RST_DEVICES_SET_L		0x300
44 #define RST_DEVICES_CLR_L		0x304
45 #define RST_DEVICES_SET_H		0x308
46 #define RST_DEVICES_CLR_H		0x30c
47 #define RST_DEVICES_SET_U		0x310
48 #define RST_DEVICES_CLR_U		0x314
49 #define RST_DEVICES_SET_V		0x430
50 #define RST_DEVICES_CLR_V		0x434
51 #define RST_DEVICES_SET_W		0x438
52 #define RST_DEVICES_CLR_W		0x43c
53 #define RST_DEVICES_SET_X		0x290
54 #define RST_DEVICES_CLR_X		0x294
55 #define RST_DEVICES_SET_Y		0x2a8
56 #define RST_DEVICES_CLR_Y		0x2ac
57 
58 /*
59  * Tegra CLK_OUT_ENB registers have some undefined bits which are not used and
60  * any accidental write of 1 to these bits can cause PSLVERR.
61  * So below are the valid mask defines for each CLK_OUT_ENB register used to
62  * turn ON only the valid clocks.
63  */
64 #define TEGRA210_CLK_ENB_VLD_MSK_L	0xdcd7dff9
65 #define TEGRA210_CLK_ENB_VLD_MSK_H	0x87d1f3e7
66 #define TEGRA210_CLK_ENB_VLD_MSK_U	0xf3fed3fa
67 #define TEGRA210_CLK_ENB_VLD_MSK_V	0xffc18cfb
68 #define TEGRA210_CLK_ENB_VLD_MSK_W	0x793fb7ff
69 #define TEGRA210_CLK_ENB_VLD_MSK_X	0x3fe66fff
70 #define TEGRA210_CLK_ENB_VLD_MSK_Y	0xfc1fc7ff
71 
72 /**
73  * struct tegra_clk_sync_source - external clock source from codec
74  *
75  * @hw: handle between common and hardware-specific interfaces
76  * @rate: input frequency from source
77  * @max_rate: max rate allowed
78  */
79 struct tegra_clk_sync_source {
80 	struct		clk_hw hw;
81 	unsigned long	rate;
82 	unsigned long	max_rate;
83 };
84 
85 #define to_clk_sync_source(_hw)					\
86 	container_of(_hw, struct tegra_clk_sync_source, hw)
87 
88 extern const struct clk_ops tegra_clk_sync_source_ops;
89 extern int *periph_clk_enb_refcnt;
90 
91 struct clk *tegra_clk_register_sync_source(const char *name,
92 					   unsigned long max_rate);
93 
94 /**
95  * struct tegra_clk_frac_div - fractional divider clock
96  *
97  * @hw:		handle between common and hardware-specific interfaces
98  * @reg:	register containing divider
99  * @flags:	hardware-specific flags
100  * @shift:	shift to the divider bit field
101  * @width:	width of the divider bit field
102  * @frac_width:	width of the fractional bit field
103  * @lock:	register lock
104  *
105  * Flags:
106  * TEGRA_DIVIDER_ROUND_UP - This flags indicates to round up the divider value.
107  * TEGRA_DIVIDER_FIXED - Fixed rate PLL dividers has addition override bit, this
108  *      flag indicates that this divider is for fixed rate PLL.
109  * TEGRA_DIVIDER_INT - Some modules can not cope with the duty cycle when
110  *      fraction bit is set. This flags indicates to calculate divider for which
111  *      fracton bit will be zero.
112  * TEGRA_DIVIDER_UART - UART module divider has additional enable bit which is
113  *      set when divider value is not 0. This flags indicates that the divider
114  *      is for UART module.
115  */
116 struct tegra_clk_frac_div {
117 	struct clk_hw	hw;
118 	void __iomem	*reg;
119 	u8		flags;
120 	u8		shift;
121 	u8		width;
122 	u8		frac_width;
123 	spinlock_t	*lock;
124 };
125 
126 #define to_clk_frac_div(_hw) container_of(_hw, struct tegra_clk_frac_div, hw)
127 
128 #define TEGRA_DIVIDER_ROUND_UP BIT(0)
129 #define TEGRA_DIVIDER_FIXED BIT(1)
130 #define TEGRA_DIVIDER_INT BIT(2)
131 #define TEGRA_DIVIDER_UART BIT(3)
132 
133 extern const struct clk_ops tegra_clk_frac_div_ops;
134 struct clk *tegra_clk_register_divider(const char *name,
135 		const char *parent_name, void __iomem *reg,
136 		unsigned long flags, u8 clk_divider_flags, u8 shift, u8 width,
137 		u8 frac_width, spinlock_t *lock);
138 struct clk *tegra_clk_register_mc(const char *name, const char *parent_name,
139 				  void __iomem *reg, spinlock_t *lock);
140 
141 /*
142  * Tegra PLL:
143  *
144  * In general, there are 3 requirements for each PLL
145  * that SW needs to be comply with.
146  * (1) Input frequency range (REF).
147  * (2) Comparison frequency range (CF). CF = REF/DIVM.
148  * (3) VCO frequency range (VCO).  VCO = CF * DIVN.
149  *
150  * The final PLL output frequency (FO) = VCO >> DIVP.
151  */
152 
153 /**
154  * struct tegra_clk_pll_freq_table - PLL frequecy table
155  *
156  * @input_rate:		input rate from source
157  * @output_rate:	output rate from PLL for the input rate
158  * @n:			feedback divider
159  * @m:			input divider
160  * @p:			post divider
161  * @cpcon:		charge pump current
162  * @sdm_data:		fraction divider setting (0 = disabled)
163  */
164 struct tegra_clk_pll_freq_table {
165 	unsigned long	input_rate;
166 	unsigned long	output_rate;
167 	u32		n;
168 	u32		m;
169 	u8		p;
170 	u8		cpcon;
171 	u16		sdm_data;
172 };
173 
174 /**
175  * struct pdiv_map - map post divider to hw value
176  *
177  * @pdiv:		post divider
178  * @hw_val:		value to be written to the PLL hw
179  */
180 struct pdiv_map {
181 	u8 pdiv;
182 	u8 hw_val;
183 };
184 
185 /**
186  * struct div_nmp - offset and width of m,n and p fields
187  *
188  * @divn_shift:	shift to the feedback divider bit field
189  * @divn_width:	width of the feedback divider bit field
190  * @divm_shift:	shift to the input divider bit field
191  * @divm_width:	width of the input divider bit field
192  * @divp_shift:	shift to the post divider bit field
193  * @divp_width:	width of the post divider bit field
194  * @override_divn_shift: shift to the feedback divider bitfield in override reg
195  * @override_divm_shift: shift to the input divider bitfield in override reg
196  * @override_divp_shift: shift to the post divider bitfield in override reg
197  */
198 struct div_nmp {
199 	u8		divn_shift;
200 	u8		divn_width;
201 	u8		divm_shift;
202 	u8		divm_width;
203 	u8		divp_shift;
204 	u8		divp_width;
205 	u8		override_divn_shift;
206 	u8		override_divm_shift;
207 	u8		override_divp_shift;
208 };
209 
210 #define MAX_PLL_MISC_REG_COUNT	6
211 
212 struct tegra_clk_pll;
213 
214 /**
215  * struct tegra_clk_pll_params - PLL parameters
216  *
217  * @input_min:			Minimum input frequency
218  * @input_max:			Maximum input frequency
219  * @cf_min:			Minimum comparison frequency
220  * @cf_max:			Maximum comparison frequency
221  * @vco_min:			Minimum VCO frequency
222  * @vco_max:			Maximum VCO frequency
223  * @base_reg:			PLL base reg offset
224  * @misc_reg:			PLL misc reg offset
225  * @lock_reg:			PLL lock reg offset
226  * @lock_mask:			Bitmask for PLL lock status
227  * @lock_enable_bit_idx:	Bit index to enable PLL lock
228  * @iddq_reg:			PLL IDDQ register offset
229  * @iddq_bit_idx:		Bit index to enable PLL IDDQ
230  * @reset_reg:			Register offset of where RESET bit is
231  * @reset_bit_idx:		Shift of reset bit in reset_reg
232  * @sdm_din_reg:		Register offset where SDM settings are
233  * @sdm_din_mask:		Mask of SDM divider bits
234  * @sdm_ctrl_reg:		Register offset where SDM enable is
235  * @sdm_ctrl_en_mask:		Mask of SDM enable bit
236  * @ssc_ctrl_reg:		Register offset where SSC settings are
237  * @ssc_ctrl_en_mask:		Mask of SSC enable bit
238  * @aux_reg:			AUX register offset
239  * @dyn_ramp_reg:		Dynamic ramp control register offset
240  * @ext_misc_reg:		Miscellaneous control register offsets
241  * @pmc_divnm_reg:		n, m divider PMC override register offset (PLLM)
242  * @pmc_divp_reg:		p divider PMC override register offset (PLLM)
243  * @flags:			PLL flags
244  * @stepa_shift:		Dynamic ramp step A field shift
245  * @stepb_shift:		Dynamic ramp step B field shift
246  * @lock_delay:			Delay in us if PLL lock is not used
247  * @max_p:			maximum value for the p divider
248  * @defaults_set:		Boolean signaling all reg defaults for PLL set.
249  * @pdiv_tohw:			mapping of p divider to register values
250  * @div_nmp:			offsets and widths on n, m and p fields
251  * @freq_table:			array of frequencies supported by PLL
252  * @fixed_rate:			PLL rate if it is fixed
253  * @mdiv_default:		Default value for fixed mdiv for this PLL
254  * @round_p_to_pdiv:		Callback used to round p to the closed pdiv
255  * @set_gain:			Callback to adjust N div for SDM enabled
256  *				PLL's based on fractional divider value.
257  * @calc_rate:			Callback used to change how out of table
258  *				rates (dividers and multipler) are calculated.
259  * @adjust_vco:			Callback to adjust the programming range of the
260  *				divider range (if SDM is present)
261  * @set_defaults:		Callback which will try to initialize PLL
262  *				registers to sane default values. This is first
263  *				tried during PLL registration, but if the PLL
264  *				is already enabled, it will be done the first
265  *				time the rate is changed while the PLL is
266  *				disabled.
267  * @dyn_ramp:			Callback which can be used to define a custom
268  *				dynamic ramp function for a given PLL.
269  * @pre_rate_change:		Callback which is invoked just before changing
270  *				PLL's rate.
271  * @post_rate_change:		Callback which is invoked right after changing
272  *				PLL's rate.
273  *
274  * Flags:
275  * TEGRA_PLL_USE_LOCK - This flag indicated to use lock bits for
276  *     PLL locking. If not set it will use lock_delay value to wait.
277  * TEGRA_PLL_HAS_CPCON - This flag indicates that CPCON value needs
278  *     to be programmed to change output frequency of the PLL.
279  * TEGRA_PLL_SET_LFCON - This flag indicates that LFCON value needs
280  *     to be programmed to change output frequency of the PLL.
281  * TEGRA_PLL_SET_DCCON - This flag indicates that DCCON value needs
282  *     to be programmed to change output frequency of the PLL.
283  * TEGRA_PLLU - PLLU has inverted post divider. This flags indicated
284  *     that it is PLLU and invert post divider value.
285  * TEGRA_PLLM - PLLM has additional override settings in PMC. This
286  *     flag indicates that it is PLLM and use override settings.
287  * TEGRA_PLL_FIXED - We are not supposed to change output frequency
288  *     of some plls.
289  * TEGRA_PLLE_CONFIGURE - Configure PLLE when enabling.
290  * TEGRA_PLL_LOCK_MISC - Lock bit is in the misc register instead of the
291  *     base register.
292  * TEGRA_PLL_BYPASS - PLL has bypass bit
293  * TEGRA_PLL_HAS_LOCK_ENABLE - PLL has bit to enable lock monitoring
294  * TEGRA_MDIV_NEW - Switch to new method for calculating fixed mdiv
295  *     it may be more accurate (especially if SDM present)
296  * TEGRA_PLLMB - PLLMB has should be treated similar to PLLM. This
297  *     flag indicated that it is PLLMB.
298  * TEGRA_PLL_VCO_OUT - Used to indicate that the PLL has a VCO output
299  */
300 struct tegra_clk_pll_params {
301 	unsigned long	input_min;
302 	unsigned long	input_max;
303 	unsigned long	cf_min;
304 	unsigned long	cf_max;
305 	unsigned long	vco_min;
306 	unsigned long	vco_max;
307 
308 	u32		base_reg;
309 	u32		misc_reg;
310 	u32		lock_reg;
311 	u32		lock_mask;
312 	u32		lock_enable_bit_idx;
313 	u32		iddq_reg;
314 	u32		iddq_bit_idx;
315 	u32		reset_reg;
316 	u32		reset_bit_idx;
317 	u32		sdm_din_reg;
318 	u32		sdm_din_mask;
319 	u32		sdm_ctrl_reg;
320 	u32		sdm_ctrl_en_mask;
321 	u32		ssc_ctrl_reg;
322 	u32		ssc_ctrl_en_mask;
323 	u32		aux_reg;
324 	u32		dyn_ramp_reg;
325 	u32		ext_misc_reg[MAX_PLL_MISC_REG_COUNT];
326 	u32		pmc_divnm_reg;
327 	u32		pmc_divp_reg;
328 	u32		flags;
329 	int		stepa_shift;
330 	int		stepb_shift;
331 	int		lock_delay;
332 	int		max_p;
333 	bool		defaults_set;
334 	const struct pdiv_map *pdiv_tohw;
335 	struct div_nmp	*div_nmp;
336 	struct tegra_clk_pll_freq_table	*freq_table;
337 	unsigned long	fixed_rate;
338 	u16		mdiv_default;
339 	u32	(*round_p_to_pdiv)(u32 p, u32 *pdiv);
340 	void	(*set_gain)(struct tegra_clk_pll_freq_table *cfg);
341 	int	(*calc_rate)(struct clk_hw *hw,
342 			struct tegra_clk_pll_freq_table *cfg,
343 			unsigned long rate, unsigned long parent_rate);
344 	unsigned long	(*adjust_vco)(struct tegra_clk_pll_params *pll_params,
345 				unsigned long parent_rate);
346 	void	(*set_defaults)(struct tegra_clk_pll *pll);
347 	int	(*dyn_ramp)(struct tegra_clk_pll *pll,
348 			struct tegra_clk_pll_freq_table *cfg);
349 	int	(*pre_rate_change)(void);
350 	void	(*post_rate_change)(void);
351 };
352 
353 #define TEGRA_PLL_USE_LOCK BIT(0)
354 #define TEGRA_PLL_HAS_CPCON BIT(1)
355 #define TEGRA_PLL_SET_LFCON BIT(2)
356 #define TEGRA_PLL_SET_DCCON BIT(3)
357 #define TEGRA_PLLU BIT(4)
358 #define TEGRA_PLLM BIT(5)
359 #define TEGRA_PLL_FIXED BIT(6)
360 #define TEGRA_PLLE_CONFIGURE BIT(7)
361 #define TEGRA_PLL_LOCK_MISC BIT(8)
362 #define TEGRA_PLL_BYPASS BIT(9)
363 #define TEGRA_PLL_HAS_LOCK_ENABLE BIT(10)
364 #define TEGRA_MDIV_NEW BIT(11)
365 #define TEGRA_PLLMB BIT(12)
366 #define TEGRA_PLL_VCO_OUT BIT(13)
367 
368 /**
369  * struct tegra_clk_pll - Tegra PLL clock
370  *
371  * @hw:		handle between common and hardware-specifix interfaces
372  * @clk_base:	address of CAR controller
373  * @pmc:	address of PMC, required to read override bits
374  * @lock:	register lock
375  * @params:	PLL parameters
376  */
377 struct tegra_clk_pll {
378 	struct clk_hw	hw;
379 	void __iomem	*clk_base;
380 	void __iomem	*pmc;
381 	spinlock_t	*lock;
382 	struct tegra_clk_pll_params	*params;
383 };
384 
385 #define to_clk_pll(_hw) container_of(_hw, struct tegra_clk_pll, hw)
386 
387 /**
388  * struct tegra_audio_clk_info - Tegra Audio Clk Information
389  *
390  * @name:	name for the audio pll
391  * @pll_params:	pll_params for audio pll
392  * @clk_id:	clk_ids for the audio pll
393  * @parent:	name of the parent of the audio pll
394  */
395 struct tegra_audio_clk_info {
396 	char *name;
397 	struct tegra_clk_pll_params *pll_params;
398 	int clk_id;
399 	char *parent;
400 };
401 
402 extern const struct clk_ops tegra_clk_pll_ops;
403 extern const struct clk_ops tegra_clk_plle_ops;
404 struct clk *tegra_clk_register_pll(const char *name, const char *parent_name,
405 		void __iomem *clk_base, void __iomem *pmc,
406 		unsigned long flags, struct tegra_clk_pll_params *pll_params,
407 		spinlock_t *lock);
408 
409 struct clk *tegra_clk_register_plle(const char *name, const char *parent_name,
410 		void __iomem *clk_base, void __iomem *pmc,
411 		unsigned long flags, struct tegra_clk_pll_params *pll_params,
412 		spinlock_t *lock);
413 
414 struct clk *tegra_clk_register_pllxc(const char *name, const char *parent_name,
415 			    void __iomem *clk_base, void __iomem *pmc,
416 			    unsigned long flags,
417 			    struct tegra_clk_pll_params *pll_params,
418 			    spinlock_t *lock);
419 
420 struct clk *tegra_clk_register_pllm(const char *name, const char *parent_name,
421 			   void __iomem *clk_base, void __iomem *pmc,
422 			   unsigned long flags,
423 			   struct tegra_clk_pll_params *pll_params,
424 			   spinlock_t *lock);
425 
426 struct clk *tegra_clk_register_pllc(const char *name, const char *parent_name,
427 			   void __iomem *clk_base, void __iomem *pmc,
428 			   unsigned long flags,
429 			   struct tegra_clk_pll_params *pll_params,
430 			   spinlock_t *lock);
431 
432 struct clk *tegra_clk_register_pllre(const char *name, const char *parent_name,
433 			   void __iomem *clk_base, void __iomem *pmc,
434 			   unsigned long flags,
435 			   struct tegra_clk_pll_params *pll_params,
436 			   spinlock_t *lock, unsigned long parent_rate);
437 
438 struct clk *tegra_clk_register_pllre_tegra210(const char *name,
439 			   const char *parent_name, void __iomem *clk_base,
440 			   void __iomem *pmc, unsigned long flags,
441 			   struct tegra_clk_pll_params *pll_params,
442 			   spinlock_t *lock, unsigned long parent_rate);
443 
444 struct clk *tegra_clk_register_plle_tegra114(const char *name,
445 				const char *parent_name,
446 				void __iomem *clk_base, unsigned long flags,
447 				struct tegra_clk_pll_params *pll_params,
448 				spinlock_t *lock);
449 
450 struct clk *tegra_clk_register_plle_tegra210(const char *name,
451 				const char *parent_name,
452 				void __iomem *clk_base, unsigned long flags,
453 				struct tegra_clk_pll_params *pll_params,
454 				spinlock_t *lock);
455 
456 struct clk *tegra_clk_register_pllc_tegra210(const char *name,
457 				const char *parent_name, void __iomem *clk_base,
458 				void __iomem *pmc, unsigned long flags,
459 				struct tegra_clk_pll_params *pll_params,
460 				spinlock_t *lock);
461 
462 struct clk *tegra_clk_register_pllss_tegra210(const char *name,
463 				const char *parent_name, void __iomem *clk_base,
464 				unsigned long flags,
465 				struct tegra_clk_pll_params *pll_params,
466 				spinlock_t *lock);
467 
468 struct clk *tegra_clk_register_pllss(const char *name, const char *parent_name,
469 			   void __iomem *clk_base, unsigned long flags,
470 			   struct tegra_clk_pll_params *pll_params,
471 			   spinlock_t *lock);
472 
473 struct clk *tegra_clk_register_pllmb(const char *name, const char *parent_name,
474 			   void __iomem *clk_base, void __iomem *pmc,
475 			   unsigned long flags,
476 			   struct tegra_clk_pll_params *pll_params,
477 			   spinlock_t *lock);
478 
479 struct clk *tegra_clk_register_pllu(const char *name, const char *parent_name,
480 				void __iomem *clk_base, unsigned long flags,
481 				struct tegra_clk_pll_params *pll_params,
482 				spinlock_t *lock);
483 
484 struct clk *tegra_clk_register_pllu_tegra114(const char *name,
485 				const char *parent_name,
486 				void __iomem *clk_base, unsigned long flags,
487 				struct tegra_clk_pll_params *pll_params,
488 				spinlock_t *lock);
489 
490 struct clk *tegra_clk_register_pllu_tegra210(const char *name,
491 				const char *parent_name,
492 				void __iomem *clk_base, unsigned long flags,
493 				struct tegra_clk_pll_params *pll_params,
494 				spinlock_t *lock);
495 
496 /**
497  * struct tegra_clk_pll_out - PLL divider down clock
498  *
499  * @hw:			handle between common and hardware-specific interfaces
500  * @reg:		register containing the PLL divider
501  * @enb_bit_idx:	bit to enable/disable PLL divider
502  * @rst_bit_idx:	bit to reset PLL divider
503  * @lock:		register lock
504  * @flags:		hardware-specific flags
505  */
506 struct tegra_clk_pll_out {
507 	struct clk_hw	hw;
508 	void __iomem	*reg;
509 	u8		enb_bit_idx;
510 	u8		rst_bit_idx;
511 	spinlock_t	*lock;
512 	u8		flags;
513 };
514 
515 #define to_clk_pll_out(_hw) container_of(_hw, struct tegra_clk_pll_out, hw)
516 
517 extern const struct clk_ops tegra_clk_pll_out_ops;
518 struct clk *tegra_clk_register_pll_out(const char *name,
519 		const char *parent_name, void __iomem *reg, u8 enb_bit_idx,
520 		u8 rst_bit_idx, unsigned long flags, u8 pll_div_flags,
521 		spinlock_t *lock);
522 
523 /**
524  * struct tegra_clk_periph_regs -  Registers controlling peripheral clock
525  *
526  * @enb_reg:		read the enable status
527  * @enb_set_reg:	write 1 to enable clock
528  * @enb_clr_reg:	write 1 to disable clock
529  * @rst_reg:		read the reset status
530  * @rst_set_reg:	write 1 to assert the reset of peripheral
531  * @rst_clr_reg:	write 1 to deassert the reset of peripheral
532  */
533 struct tegra_clk_periph_regs {
534 	u32 enb_reg;
535 	u32 enb_set_reg;
536 	u32 enb_clr_reg;
537 	u32 rst_reg;
538 	u32 rst_set_reg;
539 	u32 rst_clr_reg;
540 };
541 
542 /**
543  * struct tegra_clk_periph_gate - peripheral gate clock
544  *
545  * @magic:		magic number to validate type
546  * @hw:			handle between common and hardware-specific interfaces
547  * @clk_base:		address of CAR controller
548  * @regs:		Registers to control the peripheral
549  * @flags:		hardware-specific flags
550  * @clk_num:		Clock number
551  * @enable_refcnt:	array to maintain reference count of the clock
552  *
553  * Flags:
554  * TEGRA_PERIPH_NO_RESET - This flag indicates that reset is not allowed
555  *     for this module.
556  * TEGRA_PERIPH_MANUAL_RESET - This flag indicates not to reset module
557  *     after clock enable and driver for the module is responsible for
558  *     doing reset.
559  * TEGRA_PERIPH_ON_APB - If peripheral is in the APB bus then read the
560  *     bus to flush the write operation in apb bus. This flag indicates
561  *     that this peripheral is in apb bus.
562  * TEGRA_PERIPH_WAR_1005168 - Apply workaround for Tegra114 MSENC bug
563  */
564 struct tegra_clk_periph_gate {
565 	u32			magic;
566 	struct clk_hw		hw;
567 	void __iomem		*clk_base;
568 	u8			flags;
569 	int			clk_num;
570 	int			*enable_refcnt;
571 	const struct tegra_clk_periph_regs *regs;
572 };
573 
574 #define to_clk_periph_gate(_hw)					\
575 	container_of(_hw, struct tegra_clk_periph_gate, hw)
576 
577 #define TEGRA_CLK_PERIPH_GATE_MAGIC 0x17760309
578 
579 #define TEGRA_PERIPH_NO_RESET BIT(0)
580 #define TEGRA_PERIPH_MANUAL_RESET BIT(1)
581 #define TEGRA_PERIPH_ON_APB BIT(2)
582 #define TEGRA_PERIPH_WAR_1005168 BIT(3)
583 #define TEGRA_PERIPH_NO_DIV BIT(4)
584 #define TEGRA_PERIPH_NO_GATE BIT(5)
585 
586 extern const struct clk_ops tegra_clk_periph_gate_ops;
587 struct clk *tegra_clk_register_periph_gate(const char *name,
588 		const char *parent_name, u8 gate_flags, void __iomem *clk_base,
589 		unsigned long flags, int clk_num, int *enable_refcnt);
590 
591 struct tegra_clk_periph_fixed {
592 	struct clk_hw hw;
593 	void __iomem *base;
594 	const struct tegra_clk_periph_regs *regs;
595 	unsigned int mul;
596 	unsigned int div;
597 	unsigned int num;
598 };
599 
600 struct clk *tegra_clk_register_periph_fixed(const char *name,
601 					    const char *parent,
602 					    unsigned long flags,
603 					    void __iomem *base,
604 					    unsigned int mul,
605 					    unsigned int div,
606 					    unsigned int num);
607 
608 /**
609  * struct clk-periph - peripheral clock
610  *
611  * @magic:	magic number to validate type
612  * @hw:		handle between common and hardware-specific interfaces
613  * @mux:	mux clock
614  * @divider:	divider clock
615  * @gate:	gate clock
616  * @mux_ops:	mux clock ops
617  * @div_ops:	divider clock ops
618  * @gate_ops:	gate clock ops
619  */
620 struct tegra_clk_periph {
621 	u32			magic;
622 	struct clk_hw		hw;
623 	struct clk_mux		mux;
624 	struct tegra_clk_frac_div	divider;
625 	struct tegra_clk_periph_gate	gate;
626 
627 	const struct clk_ops	*mux_ops;
628 	const struct clk_ops	*div_ops;
629 	const struct clk_ops	*gate_ops;
630 };
631 
632 #define to_clk_periph(_hw) container_of(_hw, struct tegra_clk_periph, hw)
633 
634 #define TEGRA_CLK_PERIPH_MAGIC 0x18221223
635 
636 extern const struct clk_ops tegra_clk_periph_ops;
637 struct clk *tegra_clk_register_periph(const char *name,
638 		const char * const *parent_names, int num_parents,
639 		struct tegra_clk_periph *periph, void __iomem *clk_base,
640 		u32 offset, unsigned long flags);
641 struct clk *tegra_clk_register_periph_nodiv(const char *name,
642 		const char * const *parent_names, int num_parents,
643 		struct tegra_clk_periph *periph, void __iomem *clk_base,
644 		u32 offset);
645 
646 #define TEGRA_CLK_PERIPH(_mux_shift, _mux_mask, _mux_flags,		\
647 			 _div_shift, _div_width, _div_frac_width,	\
648 			 _div_flags, _clk_num,\
649 			 _gate_flags, _table, _lock)			\
650 	{								\
651 		.mux = {						\
652 			.flags = _mux_flags,				\
653 			.shift = _mux_shift,				\
654 			.mask = _mux_mask,				\
655 			.table = _table,				\
656 			.lock = _lock,					\
657 		},							\
658 		.divider = {						\
659 			.flags = _div_flags,				\
660 			.shift = _div_shift,				\
661 			.width = _div_width,				\
662 			.frac_width = _div_frac_width,			\
663 			.lock = _lock,					\
664 		},							\
665 		.gate = {						\
666 			.flags = _gate_flags,				\
667 			.clk_num = _clk_num,				\
668 		},							\
669 		.mux_ops = &clk_mux_ops,				\
670 		.div_ops = &tegra_clk_frac_div_ops,			\
671 		.gate_ops = &tegra_clk_periph_gate_ops,			\
672 	}
673 
674 struct tegra_periph_init_data {
675 	const char *name;
676 	int clk_id;
677 	union {
678 		const char *const *parent_names;
679 		const char *parent_name;
680 	} p;
681 	int num_parents;
682 	struct tegra_clk_periph periph;
683 	u32 offset;
684 	const char *con_id;
685 	const char *dev_id;
686 	unsigned long flags;
687 };
688 
689 #define TEGRA_INIT_DATA_TABLE(_name, _con_id, _dev_id, _parent_names, _offset,\
690 			_mux_shift, _mux_mask, _mux_flags, _div_shift,	\
691 			_div_width, _div_frac_width, _div_flags,	\
692 			_clk_num, _gate_flags, _clk_id, _table,		\
693 			_flags, _lock) \
694 	{								\
695 		.name = _name,						\
696 		.clk_id = _clk_id,					\
697 		.p.parent_names = _parent_names,			\
698 		.num_parents = ARRAY_SIZE(_parent_names),		\
699 		.periph = TEGRA_CLK_PERIPH(_mux_shift, _mux_mask,	\
700 					   _mux_flags, _div_shift,	\
701 					   _div_width, _div_frac_width,	\
702 					   _div_flags, _clk_num,	\
703 					   _gate_flags, _table, _lock),	\
704 		.offset = _offset,					\
705 		.con_id = _con_id,					\
706 		.dev_id = _dev_id,					\
707 		.flags = _flags						\
708 	}
709 
710 #define TEGRA_INIT_DATA(_name, _con_id, _dev_id, _parent_names, _offset,\
711 			_mux_shift, _mux_width, _mux_flags, _div_shift,	\
712 			_div_width, _div_frac_width, _div_flags, \
713 			_clk_num, _gate_flags, _clk_id)	\
714 	TEGRA_INIT_DATA_TABLE(_name, _con_id, _dev_id, _parent_names, _offset,\
715 			_mux_shift, BIT(_mux_width) - 1, _mux_flags,	\
716 			_div_shift, _div_width, _div_frac_width, _div_flags, \
717 			_clk_num, _gate_flags, _clk_id,\
718 			NULL, 0, NULL)
719 
720 struct clk *tegra_clk_register_periph_data(void __iomem *clk_base,
721 					   struct tegra_periph_init_data *init);
722 
723 /**
724  * struct clk_super_mux - super clock
725  *
726  * @hw:		handle between common and hardware-specific interfaces
727  * @reg:	register controlling multiplexer
728  * @width:	width of the multiplexer bit field
729  * @flags:	hardware-specific flags
730  * @div2_index:	bit controlling divide-by-2
731  * @pllx_index:	PLLX index in the parent list
732  * @lock:	register lock
733  *
734  * Flags:
735  * TEGRA_DIVIDER_2 - LP cluster has additional divider. This flag indicates
736  *     that this is LP cluster clock.
737  * TEGRA210_CPU_CLK - This flag is used to identify CPU cluster for gen5
738  *     super mux parent using PLLP branches. To use PLLP branches to CPU, need
739  *     to configure additional bit PLLP_OUT_CPU in the clock registers.
740  * TEGRA20_SUPER_CLK - Tegra20 doesn't have a dedicated divider for Super
741  *     clocks, it only has a clock-skipper.
742  */
743 struct tegra_clk_super_mux {
744 	struct clk_hw	hw;
745 	void __iomem	*reg;
746 	struct tegra_clk_frac_div frac_div;
747 	const struct clk_ops	*div_ops;
748 	u8		width;
749 	u8		flags;
750 	u8		div2_index;
751 	u8		pllx_index;
752 	spinlock_t	*lock;
753 };
754 
755 #define to_clk_super_mux(_hw) container_of(_hw, struct tegra_clk_super_mux, hw)
756 
757 #define TEGRA_DIVIDER_2 BIT(0)
758 #define TEGRA210_CPU_CLK BIT(1)
759 #define TEGRA20_SUPER_CLK BIT(2)
760 
761 extern const struct clk_ops tegra_clk_super_ops;
762 struct clk *tegra_clk_register_super_mux(const char *name,
763 		const char **parent_names, u8 num_parents,
764 		unsigned long flags, void __iomem *reg, u8 clk_super_flags,
765 		u8 width, u8 pllx_index, u8 div2_index, spinlock_t *lock);
766 struct clk *tegra_clk_register_super_clk(const char *name,
767 		const char * const *parent_names, u8 num_parents,
768 		unsigned long flags, void __iomem *reg, u8 clk_super_flags,
769 		spinlock_t *lock);
770 struct clk *tegra_clk_register_super_cclk(const char *name,
771 		const char * const *parent_names, u8 num_parents,
772 		unsigned long flags, void __iomem *reg, u8 clk_super_flags,
773 		spinlock_t *lock);
774 int tegra_cclk_pre_pllx_rate_change(void);
775 void tegra_cclk_post_pllx_rate_change(void);
776 
777 /**
778  * struct tegra_sdmmc_mux - switch divider with Low Jitter inputs for SDMMC
779  *
780  * @hw:		handle between common and hardware-specific interfaces
781  * @reg:	register controlling mux and divider
782  * @flags:	hardware-specific flags
783  * @lock:	optional register lock
784  * @gate:	gate clock
785  * @gate_ops:	gate clock ops
786  */
787 struct tegra_sdmmc_mux {
788 	struct clk_hw		hw;
789 	void __iomem		*reg;
790 	spinlock_t		*lock;
791 	const struct clk_ops	*gate_ops;
792 	struct tegra_clk_periph_gate	gate;
793 	u8			div_flags;
794 };
795 
796 #define to_clk_sdmmc_mux(_hw) container_of(_hw, struct tegra_sdmmc_mux, hw)
797 
798 struct clk *tegra_clk_register_sdmmc_mux_div(const char *name,
799 		void __iomem *clk_base, u32 offset, u32 clk_num, u8 div_flags,
800 		unsigned long flags, void *lock);
801 
802 /**
803  * struct clk_init_table - clock initialization table
804  * @clk_id:	clock id as mentioned in device tree bindings
805  * @parent_id:	parent clock id as mentioned in device tree bindings
806  * @rate:	rate to set
807  * @state:	enable/disable
808  */
809 struct tegra_clk_init_table {
810 	unsigned int	clk_id;
811 	unsigned int	parent_id;
812 	unsigned long	rate;
813 	int		state;
814 };
815 
816 /**
817  * struct clk_duplicate - duplicate clocks
818  * @clk_id:	clock id as mentioned in device tree bindings
819  * @lookup:	duplicate lookup entry for the clock
820  */
821 struct tegra_clk_duplicate {
822 	int			clk_id;
823 	struct clk_lookup	lookup;
824 };
825 
826 #define TEGRA_CLK_DUPLICATE(_clk_id, _dev, _con) \
827 	{					\
828 		.clk_id = _clk_id,		\
829 		.lookup = {			\
830 			.dev_id = _dev,		\
831 			.con_id = _con,		\
832 		},				\
833 	}
834 
835 struct tegra_clk {
836 	int			dt_id;
837 	bool			present;
838 };
839 
840 struct tegra_devclk {
841 	int		dt_id;
842 	char		*dev_id;
843 	char		*con_id;
844 };
845 
846 void tegra_init_special_resets(unsigned int num, int (*assert)(unsigned long),
847 			       int (*deassert)(unsigned long));
848 
849 void tegra_init_from_table(struct tegra_clk_init_table *tbl,
850 		struct clk *clks[], int clk_max);
851 
852 void tegra_init_dup_clks(struct tegra_clk_duplicate *dup_list,
853 		struct clk *clks[], int clk_max);
854 
855 const struct tegra_clk_periph_regs *get_reg_bank(int clkid);
856 struct clk **tegra_clk_init(void __iomem *clk_base, int num, int periph_banks);
857 
858 struct clk **tegra_lookup_dt_id(int clk_id, struct tegra_clk *tegra_clk);
859 
860 void tegra_add_of_provider(struct device_node *np, void *clk_src_onecell_get);
861 void tegra_register_devclks(struct tegra_devclk *dev_clks, int num);
862 
863 void tegra_audio_clk_init(void __iomem *clk_base,
864 			void __iomem *pmc_base, struct tegra_clk *tegra_clks,
865 			struct tegra_audio_clk_info *audio_info,
866 			unsigned int num_plls, unsigned long sync_max_rate);
867 
868 void tegra_periph_clk_init(void __iomem *clk_base, void __iomem *pmc_base,
869 			struct tegra_clk *tegra_clks,
870 			struct tegra_clk_pll_params *pll_params);
871 
872 void tegra_fixed_clk_init(struct tegra_clk *tegra_clks);
873 int tegra_osc_clk_init(void __iomem *clk_base, struct tegra_clk *clks,
874 		       unsigned long *input_freqs, unsigned int num,
875 		       unsigned int clk_m_div, unsigned long *osc_freq,
876 		       unsigned long *pll_ref_freq);
877 void tegra_super_clk_gen4_init(void __iomem *clk_base,
878 			void __iomem *pmc_base, struct tegra_clk *tegra_clks,
879 			struct tegra_clk_pll_params *pll_params);
880 void tegra_super_clk_gen5_init(void __iomem *clk_base,
881 			void __iomem *pmc_base, struct tegra_clk *tegra_clks,
882 			struct tegra_clk_pll_params *pll_params);
883 
884 #ifdef CONFIG_TEGRA124_CLK_EMC
885 struct clk *tegra124_clk_register_emc(void __iomem *base, struct device_node *np,
886 				      spinlock_t *lock);
887 bool tegra124_clk_emc_driver_available(struct clk_hw *emc_hw);
888 #else
889 static inline struct clk *
890 tegra124_clk_register_emc(void __iomem *base, struct device_node *np,
891 			  spinlock_t *lock)
892 {
893 	return NULL;
894 }
895 
896 static inline bool tegra124_clk_emc_driver_available(struct clk_hw *emc_hw)
897 {
898 	return false;
899 }
900 #endif
901 
902 void tegra114_clock_tune_cpu_trimmers_high(void);
903 void tegra114_clock_tune_cpu_trimmers_low(void);
904 void tegra114_clock_tune_cpu_trimmers_init(void);
905 void tegra114_clock_assert_dfll_dvco_reset(void);
906 void tegra114_clock_deassert_dfll_dvco_reset(void);
907 
908 typedef void (*tegra_clk_apply_init_table_func)(void);
909 extern tegra_clk_apply_init_table_func tegra_clk_apply_init_table;
910 int tegra_pll_wait_for_lock(struct tegra_clk_pll *pll);
911 u16 tegra_pll_get_fixed_mdiv(struct clk_hw *hw, unsigned long input_rate);
912 int tegra_pll_p_div_to_hw(struct tegra_clk_pll *pll, u8 p_div);
913 int div_frac_get(unsigned long rate, unsigned parent_rate, u8 width,
914 		 u8 frac_width, u8 flags);
915 void tegra_clk_osc_resume(void __iomem *clk_base);
916 void tegra_clk_set_pllp_out_cpu(bool enable);
917 void tegra_clk_periph_suspend(void);
918 void tegra_clk_periph_resume(void);
919 
920 
921 /* Combined read fence with delay */
922 #define fence_udelay(delay, reg)	\
923 	do {				\
924 		readl(reg);		\
925 		udelay(delay);		\
926 	} while (0)
927 
928 bool tegra20_clk_emc_driver_available(struct clk_hw *emc_hw);
929 struct clk *tegra20_clk_register_emc(void __iomem *ioaddr, bool low_jitter);
930 
931 struct clk *tegra210_clk_register_emc(struct device_node *np,
932 				      void __iomem *regs);
933 
934 #endif /* TEGRA_CLK_H */
935