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
46struct hsdk_pll_cfg {
47 u32 rate;
48 u32 idiv;
49 u32 fbdiv;
50 u32 odiv;
51 u32 band;
52 u32 bypass;
53};
54
55static 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
78static 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
87struct 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
95struct 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
101static int hsdk_pll_core_update_rate(struct hsdk_pll_clk *, unsigned long,
102 const struct hsdk_pll_cfg *);
103static int hsdk_pll_comm_update_rate(struct hsdk_pll_clk *, unsigned long,
104 const struct hsdk_pll_cfg *);
105
106static const struct hsdk_pll_devdata core_pll_devdata = {
107 .pll_cfg = asdt_pll_cfg,
108 .update_rate = hsdk_pll_core_update_rate,
109};
110
111static const struct hsdk_pll_devdata sdt_pll_devdata = {
112 .pll_cfg = asdt_pll_cfg,
113 .update_rate = hsdk_pll_comm_update_rate,
114};
115
116static const struct hsdk_pll_devdata hdmi_pll_devdata = {
117 .pll_cfg = hdmi_pll_cfg,
118 .update_rate = hsdk_pll_comm_update_rate,
119};
120
121static inline void hsdk_pll_write(struct hsdk_pll_clk *clk, u32 reg, u32 val)
122{
123 iowrite32(val, clk->regs + reg);
124}
125
126static inline u32 hsdk_pll_read(struct hsdk_pll_clk *clk, u32 reg)
127{
128 return ioread32(clk->regs + reg);
129}
130
131static 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
152static 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
157static 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
162static 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
167static 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
200static 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
225static 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
245static 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
279static 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
299static 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
305static 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, size: sizeof(*pll_clk), GFP_KERNEL);
315 if (!pll_clk)
316 return -ENOMEM;
317
318 pll_clk->regs = devm_platform_ioremap_resource(pdev, index: 0);
319 if (IS_ERR(ptr: pll_clk->regs))
320 return PTR_ERR(ptr: 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(np: dev->of_node, index: 0);
325 init.parent_names = &parent_name;
326 num_parents = of_clk_get_parent_count(np: 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, hw: &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, get: of_clk_hw_simple_get,
349 data: &pll_clk->hw);
350}
351
352static 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, index: 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, index: 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(np: node, index: 0);
379 init.parent_names = &parent_name;
380 num_parents = of_clk_get_parent_count(np: 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, hw: &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(np: node, get: of_clk_hw_simple_get, data: &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
404err_unmap_spec_regs:
405 iounmap(addr: pll_clk->spec_regs);
406err_unmap_comm_regs:
407 iounmap(addr: pll_clk->regs);
408err_free_pll_clk:
409 kfree(objp: pll_clk);
410}
411
412/* Core PLL needed early for ARC cpus timers */
413CLK_OF_DECLARE(hsdk_pll_clock, "snps,hsdk-core-pll-clock",
414of_hsdk_pll_clk_setup);
415
416static 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
422static 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};
429builtin_platform_driver(hsdk_pll_clk_driver);
430

source code of linux/drivers/clk/clk-hsdk-pll.c