xref: /linux/drivers/clk/clk-hsdk-pll.c (revision 522ba450b56fff29f868b1552bdc2965f55de7ed)
1 // SPDX-License-Identifier: GPL-2.0-only
2 /*
3  * Synopsys HSDK SDP Generic PLL clock driver
4  *
5  * Copyright (C) 2017 Synopsys
6  */
7 
8 #include <linux/clk-provider.h>
9 #include <linux/delay.h>
10 #include <linux/device.h>
11 #include <linux/err.h>
12 #include <linux/io.h>
13 #include <linux/of.h>
14 #include <linux/of_address.h>
15 #include <linux/platform_device.h>
16 #include <linux/slab.h>
17 
18 #define CGU_PLL_CTRL	0x000 /* ARC PLL control register */
19 #define CGU_PLL_STATUS	0x004 /* ARC PLL status register */
20 #define CGU_PLL_FMEAS	0x008 /* ARC PLL frequency measurement register */
21 #define CGU_PLL_MON	0x00C /* ARC PLL monitor register */
22 
23 #define CGU_PLL_CTRL_ODIV_SHIFT		2
24 #define CGU_PLL_CTRL_IDIV_SHIFT		4
25 #define CGU_PLL_CTRL_FBDIV_SHIFT	9
26 #define CGU_PLL_CTRL_BAND_SHIFT		20
27 
28 #define CGU_PLL_CTRL_ODIV_MASK		GENMASK(3, CGU_PLL_CTRL_ODIV_SHIFT)
29 #define CGU_PLL_CTRL_IDIV_MASK		GENMASK(8, CGU_PLL_CTRL_IDIV_SHIFT)
30 #define CGU_PLL_CTRL_FBDIV_MASK		GENMASK(15, CGU_PLL_CTRL_FBDIV_SHIFT)
31 
32 #define CGU_PLL_CTRL_PD			BIT(0)
33 #define CGU_PLL_CTRL_BYPASS		BIT(1)
34 
35 #define CGU_PLL_STATUS_LOCK		BIT(0)
36 #define CGU_PLL_STATUS_ERR		BIT(1)
37 
38 #define HSDK_PLL_MAX_LOCK_TIME		100 /* 100 us */
39 
40 #define CGU_PLL_SOURCE_MAX		1
41 
42 #define CORE_IF_CLK_THRESHOLD_HZ	500000000
43 #define CREG_CORE_IF_CLK_DIV_1		0x0
44 #define CREG_CORE_IF_CLK_DIV_2		0x1
45 
46 struct hsdk_pll_cfg {
47 	u32 rate;
48 	u32 idiv;
49 	u32 fbdiv;
50 	u32 odiv;
51 	u32 band;
52 	u32 bypass;
53 };
54 
55 static const struct hsdk_pll_cfg asdt_pll_cfg[] = {
56 	{ 100000000,  0, 11, 3, 0, 0 },
57 	{ 133000000,  0, 15, 3, 0, 0 },
58 	{ 200000000,  1, 47, 3, 0, 0 },
59 	{ 233000000,  1, 27, 2, 0, 0 },
60 	{ 300000000,  1, 35, 2, 0, 0 },
61 	{ 333000000,  1, 39, 2, 0, 0 },
62 	{ 400000000,  1, 47, 2, 0, 0 },
63 	{ 500000000,  0, 14, 1, 0, 0 },
64 	{ 600000000,  0, 17, 1, 0, 0 },
65 	{ 700000000,  0, 20, 1, 0, 0 },
66 	{ 800000000,  0, 23, 1, 0, 0 },
67 	{ 900000000,  1, 26, 0, 0, 0 },
68 	{ 1000000000, 1, 29, 0, 0, 0 },
69 	{ 1100000000, 1, 32, 0, 0, 0 },
70 	{ 1200000000, 1, 35, 0, 0, 0 },
71 	{ 1300000000, 1, 38, 0, 0, 0 },
72 	{ 1400000000, 1, 41, 0, 0, 0 },
73 	{ 1500000000, 1, 44, 0, 0, 0 },
74 	{ 1600000000, 1, 47, 0, 0, 0 },
75 	{}
76 };
77 
78 static const struct hsdk_pll_cfg hdmi_pll_cfg[] = {
79 	{ 27000000,   0, 0,  0, 0, 1 },
80 	{ 148500000,  0, 21, 3, 0, 0 },
81 	{ 297000000,  0, 21, 2, 0, 0 },
82 	{ 540000000,  0, 19, 1, 0, 0 },
83 	{ 594000000,  0, 21, 1, 0, 0 },
84 	{}
85 };
86 
87 struct hsdk_pll_clk {
88 	struct clk_hw hw;
89 	void __iomem *regs;
90 	void __iomem *spec_regs;
91 	const struct hsdk_pll_devdata *pll_devdata;
92 	struct device *dev;
93 };
94 
95 struct hsdk_pll_devdata {
96 	const struct hsdk_pll_cfg *pll_cfg;
97 	int (*update_rate)(struct hsdk_pll_clk *clk, unsigned long rate,
98 			   const struct hsdk_pll_cfg *cfg);
99 };
100 
101 static int hsdk_pll_core_update_rate(struct hsdk_pll_clk *, unsigned long,
102 				     const struct hsdk_pll_cfg *);
103 static int hsdk_pll_comm_update_rate(struct hsdk_pll_clk *, unsigned long,
104 				     const struct hsdk_pll_cfg *);
105 
106 static const struct hsdk_pll_devdata core_pll_devdata = {
107 	.pll_cfg = asdt_pll_cfg,
108 	.update_rate = hsdk_pll_core_update_rate,
109 };
110 
111 static const struct hsdk_pll_devdata sdt_pll_devdata = {
112 	.pll_cfg = asdt_pll_cfg,
113 	.update_rate = hsdk_pll_comm_update_rate,
114 };
115 
116 static const struct hsdk_pll_devdata hdmi_pll_devdata = {
117 	.pll_cfg = hdmi_pll_cfg,
118 	.update_rate = hsdk_pll_comm_update_rate,
119 };
120 
hsdk_pll_write(struct hsdk_pll_clk * clk,u32 reg,u32 val)121 static inline void hsdk_pll_write(struct hsdk_pll_clk *clk, u32 reg, u32 val)
122 {
123 	iowrite32(val, clk->regs + reg);
124 }
125 
hsdk_pll_read(struct hsdk_pll_clk * clk,u32 reg)126 static inline u32 hsdk_pll_read(struct hsdk_pll_clk *clk, u32 reg)
127 {
128 	return ioread32(clk->regs + reg);
129 }
130 
hsdk_pll_set_cfg(struct hsdk_pll_clk * clk,const struct hsdk_pll_cfg * cfg)131 static inline void hsdk_pll_set_cfg(struct hsdk_pll_clk *clk,
132 				    const struct hsdk_pll_cfg *cfg)
133 {
134 	u32 val = 0;
135 
136 	if (cfg->bypass) {
137 		val = hsdk_pll_read(clk, CGU_PLL_CTRL);
138 		val |= CGU_PLL_CTRL_BYPASS;
139 	} else {
140 		/* Powerdown and Bypass bits should be cleared */
141 		val |= cfg->idiv << CGU_PLL_CTRL_IDIV_SHIFT;
142 		val |= cfg->fbdiv << CGU_PLL_CTRL_FBDIV_SHIFT;
143 		val |= cfg->odiv << CGU_PLL_CTRL_ODIV_SHIFT;
144 		val |= cfg->band << CGU_PLL_CTRL_BAND_SHIFT;
145 	}
146 
147 	dev_dbg(clk->dev, "write configuration: %#x\n", val);
148 
149 	hsdk_pll_write(clk, CGU_PLL_CTRL, val);
150 }
151 
hsdk_pll_is_locked(struct hsdk_pll_clk * clk)152 static inline bool hsdk_pll_is_locked(struct hsdk_pll_clk *clk)
153 {
154 	return !!(hsdk_pll_read(clk, CGU_PLL_STATUS) & CGU_PLL_STATUS_LOCK);
155 }
156 
hsdk_pll_is_err(struct hsdk_pll_clk * clk)157 static inline bool hsdk_pll_is_err(struct hsdk_pll_clk *clk)
158 {
159 	return !!(hsdk_pll_read(clk, CGU_PLL_STATUS) & CGU_PLL_STATUS_ERR);
160 }
161 
to_hsdk_pll_clk(struct clk_hw * hw)162 static inline struct hsdk_pll_clk *to_hsdk_pll_clk(struct clk_hw *hw)
163 {
164 	return container_of(hw, struct hsdk_pll_clk, hw);
165 }
166 
hsdk_pll_recalc_rate(struct clk_hw * hw,unsigned long parent_rate)167 static unsigned long hsdk_pll_recalc_rate(struct clk_hw *hw,
168 					  unsigned long parent_rate)
169 {
170 	u32 val;
171 	u64 rate;
172 	u32 idiv, fbdiv, odiv;
173 	struct hsdk_pll_clk *clk = to_hsdk_pll_clk(hw);
174 
175 	val = hsdk_pll_read(clk, CGU_PLL_CTRL);
176 
177 	dev_dbg(clk->dev, "current configuration: %#x\n", val);
178 
179 	/* Check if PLL is bypassed */
180 	if (val & CGU_PLL_CTRL_BYPASS)
181 		return parent_rate;
182 
183 	/* Check if PLL is disabled */
184 	if (val & CGU_PLL_CTRL_PD)
185 		return 0;
186 
187 	/* input divider = reg.idiv + 1 */
188 	idiv = 1 + ((val & CGU_PLL_CTRL_IDIV_MASK) >> CGU_PLL_CTRL_IDIV_SHIFT);
189 	/* fb divider = 2*(reg.fbdiv + 1) */
190 	fbdiv = 2 * (1 + ((val & CGU_PLL_CTRL_FBDIV_MASK) >> CGU_PLL_CTRL_FBDIV_SHIFT));
191 	/* output divider = 2^(reg.odiv) */
192 	odiv = 1 << ((val & CGU_PLL_CTRL_ODIV_MASK) >> CGU_PLL_CTRL_ODIV_SHIFT);
193 
194 	rate = (u64)parent_rate * fbdiv;
195 	do_div(rate, idiv * odiv);
196 
197 	return rate;
198 }
199 
hsdk_pll_determine_rate(struct clk_hw * hw,struct clk_rate_request * req)200 static int hsdk_pll_determine_rate(struct clk_hw *hw,
201 				   struct clk_rate_request *req)
202 {
203 	int i;
204 	unsigned long best_rate;
205 	struct hsdk_pll_clk *clk = to_hsdk_pll_clk(hw);
206 	const struct hsdk_pll_cfg *pll_cfg = clk->pll_devdata->pll_cfg;
207 
208 	if (pll_cfg[0].rate == 0)
209 		return -EINVAL;
210 
211 	best_rate = pll_cfg[0].rate;
212 
213 	for (i = 1; pll_cfg[i].rate != 0; i++) {
214 		if (abs(req->rate - pll_cfg[i].rate) < abs(req->rate - best_rate))
215 			best_rate = pll_cfg[i].rate;
216 	}
217 
218 	dev_dbg(clk->dev, "chosen best rate: %lu\n", best_rate);
219 
220 	req->rate = best_rate;
221 
222 	return 0;
223 }
224 
hsdk_pll_comm_update_rate(struct hsdk_pll_clk * clk,unsigned long rate,const struct hsdk_pll_cfg * cfg)225 static int hsdk_pll_comm_update_rate(struct hsdk_pll_clk *clk,
226 				     unsigned long rate,
227 				     const struct hsdk_pll_cfg *cfg)
228 {
229 	hsdk_pll_set_cfg(clk, cfg);
230 
231 	/*
232 	 * Wait until CGU relocks and check error status.
233 	 * If after timeout CGU is unlocked yet return error.
234 	 */
235 	udelay(HSDK_PLL_MAX_LOCK_TIME);
236 	if (!hsdk_pll_is_locked(clk))
237 		return -ETIMEDOUT;
238 
239 	if (hsdk_pll_is_err(clk))
240 		return -EINVAL;
241 
242 	return 0;
243 }
244 
hsdk_pll_core_update_rate(struct hsdk_pll_clk * clk,unsigned long rate,const struct hsdk_pll_cfg * cfg)245 static int hsdk_pll_core_update_rate(struct hsdk_pll_clk *clk,
246 				     unsigned long rate,
247 				     const struct hsdk_pll_cfg *cfg)
248 {
249 	/*
250 	 * When core clock exceeds 500MHz, the divider for the interface
251 	 * clock must be programmed to div-by-2.
252 	 */
253 	if (rate > CORE_IF_CLK_THRESHOLD_HZ)
254 		iowrite32(CREG_CORE_IF_CLK_DIV_2, clk->spec_regs);
255 
256 	hsdk_pll_set_cfg(clk, cfg);
257 
258 	/*
259 	 * Wait until CGU relocks and check error status.
260 	 * If after timeout CGU is unlocked yet return error.
261 	 */
262 	udelay(HSDK_PLL_MAX_LOCK_TIME);
263 	if (!hsdk_pll_is_locked(clk))
264 		return -ETIMEDOUT;
265 
266 	if (hsdk_pll_is_err(clk))
267 		return -EINVAL;
268 
269 	/*
270 	 * Program divider to div-by-1 if we successfully set core clock below
271 	 * 500MHz threshold.
272 	 */
273 	if (rate <= CORE_IF_CLK_THRESHOLD_HZ)
274 		iowrite32(CREG_CORE_IF_CLK_DIV_1, clk->spec_regs);
275 
276 	return 0;
277 }
278 
hsdk_pll_set_rate(struct clk_hw * hw,unsigned long rate,unsigned long parent_rate)279 static int hsdk_pll_set_rate(struct clk_hw *hw, unsigned long rate,
280 			     unsigned long parent_rate)
281 {
282 	int i;
283 	struct hsdk_pll_clk *clk = to_hsdk_pll_clk(hw);
284 	const struct hsdk_pll_cfg *pll_cfg = clk->pll_devdata->pll_cfg;
285 
286 	for (i = 0; pll_cfg[i].rate != 0; i++) {
287 		if (pll_cfg[i].rate == rate) {
288 			return clk->pll_devdata->update_rate(clk, rate,
289 							     &pll_cfg[i]);
290 		}
291 	}
292 
293 	dev_err(clk->dev, "invalid rate=%ld, parent_rate=%ld\n", rate,
294 			parent_rate);
295 
296 	return -EINVAL;
297 }
298 
299 static const struct clk_ops hsdk_pll_ops = {
300 	.recalc_rate = hsdk_pll_recalc_rate,
301 	.determine_rate = hsdk_pll_determine_rate,
302 	.set_rate = hsdk_pll_set_rate,
303 };
304 
hsdk_pll_clk_probe(struct platform_device * pdev)305 static int hsdk_pll_clk_probe(struct platform_device *pdev)
306 {
307 	int ret;
308 	const char *parent_name;
309 	unsigned int num_parents;
310 	struct hsdk_pll_clk *pll_clk;
311 	struct clk_init_data init = { };
312 	struct device *dev = &pdev->dev;
313 
314 	pll_clk = devm_kzalloc(dev, sizeof(*pll_clk), GFP_KERNEL);
315 	if (!pll_clk)
316 		return -ENOMEM;
317 
318 	pll_clk->regs = devm_platform_ioremap_resource(pdev, 0);
319 	if (IS_ERR(pll_clk->regs))
320 		return PTR_ERR(pll_clk->regs);
321 
322 	init.name = dev->of_node->name;
323 	init.ops = &hsdk_pll_ops;
324 	parent_name = of_clk_get_parent_name(dev->of_node, 0);
325 	init.parent_names = &parent_name;
326 	num_parents = of_clk_get_parent_count(dev->of_node);
327 	if (num_parents == 0 || num_parents > CGU_PLL_SOURCE_MAX) {
328 		dev_err(dev, "wrong clock parents number: %u\n", num_parents);
329 		return -EINVAL;
330 	}
331 	init.num_parents = num_parents;
332 
333 	pll_clk->hw.init = &init;
334 	pll_clk->dev = dev;
335 	pll_clk->pll_devdata = of_device_get_match_data(dev);
336 
337 	if (!pll_clk->pll_devdata) {
338 		dev_err(dev, "No OF match data provided\n");
339 		return -EINVAL;
340 	}
341 
342 	ret = devm_clk_hw_register(dev, &pll_clk->hw);
343 	if (ret) {
344 		dev_err(dev, "failed to register %s clock\n", init.name);
345 		return ret;
346 	}
347 
348 	return devm_of_clk_add_hw_provider(dev, of_clk_hw_simple_get,
349 					   &pll_clk->hw);
350 }
351 
of_hsdk_pll_clk_setup(struct device_node * node)352 static void __init of_hsdk_pll_clk_setup(struct device_node *node)
353 {
354 	int ret;
355 	const char *parent_name;
356 	unsigned int num_parents;
357 	struct hsdk_pll_clk *pll_clk;
358 	struct clk_init_data init = { };
359 
360 	pll_clk = kzalloc(sizeof(*pll_clk), GFP_KERNEL);
361 	if (!pll_clk)
362 		return;
363 
364 	pll_clk->regs = of_iomap(node, 0);
365 	if (!pll_clk->regs) {
366 		pr_err("failed to map pll registers\n");
367 		goto err_free_pll_clk;
368 	}
369 
370 	pll_clk->spec_regs = of_iomap(node, 1);
371 	if (!pll_clk->spec_regs) {
372 		pr_err("failed to map pll registers\n");
373 		goto err_unmap_comm_regs;
374 	}
375 
376 	init.name = node->name;
377 	init.ops = &hsdk_pll_ops;
378 	parent_name = of_clk_get_parent_name(node, 0);
379 	init.parent_names = &parent_name;
380 	num_parents = of_clk_get_parent_count(node);
381 	if (num_parents > CGU_PLL_SOURCE_MAX) {
382 		pr_err("too much clock parents: %u\n", num_parents);
383 		goto err_unmap_spec_regs;
384 	}
385 	init.num_parents = num_parents;
386 
387 	pll_clk->hw.init = &init;
388 	pll_clk->pll_devdata = &core_pll_devdata;
389 
390 	ret = clk_hw_register(NULL, &pll_clk->hw);
391 	if (ret) {
392 		pr_err("failed to register %pOFn clock\n", node);
393 		goto err_unmap_spec_regs;
394 	}
395 
396 	ret = of_clk_add_hw_provider(node, of_clk_hw_simple_get, &pll_clk->hw);
397 	if (ret) {
398 		pr_err("failed to add hw provider for %pOFn clock\n", node);
399 		goto err_unmap_spec_regs;
400 	}
401 
402 	return;
403 
404 err_unmap_spec_regs:
405 	iounmap(pll_clk->spec_regs);
406 err_unmap_comm_regs:
407 	iounmap(pll_clk->regs);
408 err_free_pll_clk:
409 	kfree(pll_clk);
410 }
411 
412 /* Core PLL needed early for ARC cpus timers */
413 CLK_OF_DECLARE(hsdk_pll_clock, "snps,hsdk-core-pll-clock",
414 of_hsdk_pll_clk_setup);
415 
416 static const struct of_device_id hsdk_pll_clk_id[] = {
417 	{ .compatible = "snps,hsdk-gp-pll-clock", .data = &sdt_pll_devdata},
418 	{ .compatible = "snps,hsdk-hdmi-pll-clock", .data = &hdmi_pll_devdata},
419 	{ }
420 };
421 
422 static struct platform_driver hsdk_pll_clk_driver = {
423 	.driver = {
424 		.name = "hsdk-gp-pll-clock",
425 		.of_match_table = hsdk_pll_clk_id,
426 	},
427 	.probe = hsdk_pll_clk_probe,
428 };
429 builtin_platform_driver(hsdk_pll_clk_driver);
430