xref: /openbmc/linux/drivers/clk/mediatek/clk-mtk.h (revision ae213c44)
1 /*
2  * Copyright (c) 2014 MediaTek Inc.
3  * Author: James Liao <jamesjj.liao@mediatek.com>
4  *
5  * This program is free software; you can redistribute it and/or modify
6  * it under the terms of the GNU General Public License version 2 as
7  * published by the Free Software Foundation.
8  *
9  * This program is distributed in the hope that it will be useful,
10  * but WITHOUT ANY WARRANTY; without even the implied warranty of
11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
12  * GNU General Public License for more details.
13  */
14 
15 #ifndef __DRV_CLK_MTK_H
16 #define __DRV_CLK_MTK_H
17 
18 #include <linux/regmap.h>
19 #include <linux/bitops.h>
20 #include <linux/clk-provider.h>
21 
22 struct clk;
23 struct clk_onecell_data;
24 
25 #define MAX_MUX_GATE_BIT	31
26 #define INVALID_MUX_GATE_BIT	(MAX_MUX_GATE_BIT + 1)
27 
28 #define MHZ (1000 * 1000)
29 
30 struct mtk_fixed_clk {
31 	int id;
32 	const char *name;
33 	const char *parent;
34 	unsigned long rate;
35 };
36 
37 #define FIXED_CLK(_id, _name, _parent, _rate) {		\
38 		.id = _id,				\
39 		.name = _name,				\
40 		.parent = _parent,			\
41 		.rate = _rate,				\
42 	}
43 
44 void mtk_clk_register_fixed_clks(const struct mtk_fixed_clk *clks,
45 		int num, struct clk_onecell_data *clk_data);
46 
47 struct mtk_fixed_factor {
48 	int id;
49 	const char *name;
50 	const char *parent_name;
51 	int mult;
52 	int div;
53 };
54 
55 #define FACTOR(_id, _name, _parent, _mult, _div) {	\
56 		.id = _id,				\
57 		.name = _name,				\
58 		.parent_name = _parent,			\
59 		.mult = _mult,				\
60 		.div = _div,				\
61 	}
62 
63 void mtk_clk_register_factors(const struct mtk_fixed_factor *clks,
64 		int num, struct clk_onecell_data *clk_data);
65 
66 struct mtk_composite {
67 	int id;
68 	const char *name;
69 	const char * const *parent_names;
70 	const char *parent;
71 	unsigned flags;
72 
73 	uint32_t mux_reg;
74 	uint32_t divider_reg;
75 	uint32_t gate_reg;
76 
77 	signed char mux_shift;
78 	signed char mux_width;
79 	signed char gate_shift;
80 
81 	signed char divider_shift;
82 	signed char divider_width;
83 
84 	u8 mux_flags;
85 
86 	signed char num_parents;
87 };
88 
89 #define MUX_GATE_FLAGS_2(_id, _name, _parents, _reg, _shift,		\
90 				_width, _gate, _flags, _muxflags) {	\
91 		.id = _id,						\
92 		.name = _name,						\
93 		.mux_reg = _reg,					\
94 		.mux_shift = _shift,					\
95 		.mux_width = _width,					\
96 		.gate_reg = _reg,					\
97 		.gate_shift = _gate,					\
98 		.divider_shift = -1,					\
99 		.parent_names = _parents,				\
100 		.num_parents = ARRAY_SIZE(_parents),			\
101 		.flags = _flags,					\
102 		.mux_flags = _muxflags,					\
103 	}
104 
105 /*
106  * In case the rate change propagation to parent clocks is undesirable,
107  * this macro allows to specify the clock flags manually.
108  */
109 #define MUX_GATE_FLAGS(_id, _name, _parents, _reg, _shift, _width,	\
110 			_gate, _flags)					\
111 		MUX_GATE_FLAGS_2(_id, _name, _parents, _reg,		\
112 					_shift, _width, _gate, _flags, 0)
113 
114 /*
115  * Unless necessary, all MUX_GATE clocks propagate rate changes to their
116  * parent clock by default.
117  */
118 #define MUX_GATE(_id, _name, _parents, _reg, _shift, _width, _gate)	\
119 	MUX_GATE_FLAGS(_id, _name, _parents, _reg, _shift, _width,	\
120 		_gate, CLK_SET_RATE_PARENT)
121 
122 #define MUX(_id, _name, _parents, _reg, _shift, _width)			\
123 	MUX_FLAGS(_id, _name, _parents, _reg,				\
124 		  _shift, _width, CLK_SET_RATE_PARENT)
125 
126 #define MUX_FLAGS(_id, _name, _parents, _reg, _shift, _width, _flags) {	\
127 		.id = _id,						\
128 		.name = _name,						\
129 		.mux_reg = _reg,					\
130 		.mux_shift = _shift,					\
131 		.mux_width = _width,					\
132 		.gate_shift = -1,					\
133 		.divider_shift = -1,					\
134 		.parent_names = _parents,				\
135 		.num_parents = ARRAY_SIZE(_parents),			\
136 		.flags = _flags,				\
137 	}
138 
139 #define DIV_GATE(_id, _name, _parent, _gate_reg, _gate_shift, _div_reg,	\
140 					_div_width, _div_shift) {	\
141 		.id = _id,						\
142 		.parent = _parent,					\
143 		.name = _name,						\
144 		.divider_reg = _div_reg,				\
145 		.divider_shift = _div_shift,				\
146 		.divider_width = _div_width,				\
147 		.gate_reg = _gate_reg,					\
148 		.gate_shift = _gate_shift,				\
149 		.mux_shift = -1,					\
150 		.flags = 0,						\
151 	}
152 
153 struct clk *mtk_clk_register_composite(const struct mtk_composite *mc,
154 		void __iomem *base, spinlock_t *lock);
155 
156 void mtk_clk_register_composites(const struct mtk_composite *mcs,
157 		int num, void __iomem *base, spinlock_t *lock,
158 		struct clk_onecell_data *clk_data);
159 
160 struct mtk_gate_regs {
161 	u32 sta_ofs;
162 	u32 clr_ofs;
163 	u32 set_ofs;
164 };
165 
166 struct mtk_gate {
167 	int id;
168 	const char *name;
169 	const char *parent_name;
170 	const struct mtk_gate_regs *regs;
171 	int shift;
172 	const struct clk_ops *ops;
173 	unsigned long flags;
174 };
175 
176 int mtk_clk_register_gates(struct device_node *node,
177 			const struct mtk_gate *clks, int num,
178 			struct clk_onecell_data *clk_data);
179 
180 struct mtk_clk_divider {
181 	int id;
182 	const char *name;
183 	const char *parent_name;
184 	unsigned long flags;
185 
186 	u32 div_reg;
187 	unsigned char div_shift;
188 	unsigned char div_width;
189 	unsigned char clk_divider_flags;
190 	const struct clk_div_table *clk_div_table;
191 };
192 
193 #define DIV_ADJ(_id, _name, _parent, _reg, _shift, _width) {	\
194 		.id = _id,					\
195 		.name = _name,					\
196 		.parent_name = _parent,				\
197 		.div_reg = _reg,				\
198 		.div_shift = _shift,				\
199 		.div_width = _width,				\
200 }
201 
202 void mtk_clk_register_dividers(const struct mtk_clk_divider *mcds,
203 			int num, void __iomem *base, spinlock_t *lock,
204 				struct clk_onecell_data *clk_data);
205 
206 struct clk_onecell_data *mtk_alloc_clk_data(unsigned int clk_num);
207 
208 #define HAVE_RST_BAR	BIT(0)
209 #define PLL_AO		BIT(1)
210 
211 struct mtk_pll_div_table {
212 	u32 div;
213 	unsigned long freq;
214 };
215 
216 struct mtk_pll_data {
217 	int id;
218 	const char *name;
219 	uint32_t reg;
220 	uint32_t pwr_reg;
221 	uint32_t en_mask;
222 	uint32_t pd_reg;
223 	uint32_t tuner_reg;
224 	uint32_t tuner_en_reg;
225 	uint8_t tuner_en_bit;
226 	int pd_shift;
227 	unsigned int flags;
228 	const struct clk_ops *ops;
229 	u32 rst_bar_mask;
230 	unsigned long fmin;
231 	unsigned long fmax;
232 	int pcwbits;
233 	int pcwibits;
234 	uint32_t pcw_reg;
235 	int pcw_shift;
236 	uint32_t pcw_chg_reg;
237 	const struct mtk_pll_div_table *div_table;
238 	const char *parent_name;
239 };
240 
241 void mtk_clk_register_plls(struct device_node *node,
242 		const struct mtk_pll_data *plls, int num_plls,
243 		struct clk_onecell_data *clk_data);
244 
245 struct clk *mtk_clk_register_ref2usb_tx(const char *name,
246 			const char *parent_name, void __iomem *reg);
247 
248 void mtk_register_reset_controller(struct device_node *np,
249 			unsigned int num_regs, int regofs);
250 
251 #endif /* __DRV_CLK_MTK_H */
252