module: Convert symbol namespace to string literal
[linux.git] / drivers / clk / clk-si5351.c
bloba4c92c5ef3ff749b5a07c8b86ee783307c73066d
1 // SPDX-License-Identifier: GPL-2.0-or-later
2 /*
3 * clk-si5351.c: Skyworks / Silicon Labs Si5351A/B/C I2C Clock Generator
5 * Sebastian Hesselbarth <sebastian.hesselbarth@gmail.com>
6 * Rabeeh Khoury <rabeeh@solid-run.com>
8 * References:
9 * [1] "Si5351A/B/C Data Sheet"
10 * https://www.skyworksinc.com/-/media/Skyworks/SL/documents/public/data-sheets/Si5351-B.pdf
11 * [2] "AN619: Manually Generating an Si5351 Register Map"
12 * https://www.skyworksinc.com/-/media/Skyworks/SL/documents/public/application-notes/AN619.pdf
15 #include <linux/module.h>
16 #include <linux/kernel.h>
17 #include <linux/clk.h>
18 #include <linux/clk-provider.h>
19 #include <linux/delay.h>
20 #include <linux/err.h>
21 #include <linux/errno.h>
22 #include <linux/rational.h>
23 #include <linux/i2c.h>
24 #include <linux/of.h>
25 #include <linux/platform_data/si5351.h>
26 #include <linux/regmap.h>
27 #include <linux/slab.h>
28 #include <linux/string.h>
29 #include <asm/div64.h>
31 #include "clk-si5351.h"
33 struct si5351_driver_data;
35 struct si5351_parameters {
36 unsigned long p1;
37 unsigned long p2;
38 unsigned long p3;
39 int valid;
42 struct si5351_hw_data {
43 struct clk_hw hw;
44 struct si5351_driver_data *drvdata;
45 struct si5351_parameters params;
46 unsigned char num;
49 struct si5351_driver_data {
50 enum si5351_variant variant;
51 struct i2c_client *client;
52 struct regmap *regmap;
54 struct clk *pxtal;
55 const char *pxtal_name;
56 struct clk_hw xtal;
57 struct clk *pclkin;
58 const char *pclkin_name;
59 struct clk_hw clkin;
61 struct si5351_hw_data pll[2];
62 struct si5351_hw_data *msynth;
63 struct si5351_hw_data *clkout;
64 size_t num_clkout;
67 static const char * const si5351_input_names[] = {
68 "xtal", "clkin"
70 static const char * const si5351_pll_names[] = {
71 "si5351_plla", "si5351_pllb", "si5351_vxco"
73 static const char * const si5351_msynth_names[] = {
74 "ms0", "ms1", "ms2", "ms3", "ms4", "ms5", "ms6", "ms7"
76 static const char * const si5351_clkout_names[] = {
77 "clk0", "clk1", "clk2", "clk3", "clk4", "clk5", "clk6", "clk7"
81 * Si5351 i2c regmap
83 static inline u8 si5351_reg_read(struct si5351_driver_data *drvdata, u8 reg)
85 u32 val;
86 int ret;
88 ret = regmap_read(drvdata->regmap, reg, &val);
89 if (ret) {
90 dev_err(&drvdata->client->dev,
91 "unable to read from reg%02x\n", reg);
92 return 0;
95 return (u8)val;
98 static inline int si5351_bulk_read(struct si5351_driver_data *drvdata,
99 u8 reg, u8 count, u8 *buf)
101 return regmap_bulk_read(drvdata->regmap, reg, buf, count);
104 static inline int si5351_reg_write(struct si5351_driver_data *drvdata,
105 u8 reg, u8 val)
107 return regmap_write(drvdata->regmap, reg, val);
110 static inline int si5351_bulk_write(struct si5351_driver_data *drvdata,
111 u8 reg, u8 count, const u8 *buf)
113 return regmap_raw_write(drvdata->regmap, reg, buf, count);
116 static inline int si5351_set_bits(struct si5351_driver_data *drvdata,
117 u8 reg, u8 mask, u8 val)
119 return regmap_update_bits(drvdata->regmap, reg, mask, val);
122 static inline u8 si5351_msynth_params_address(int num)
124 if (num > 5)
125 return SI5351_CLK6_PARAMETERS + (num - 6);
126 return SI5351_CLK0_PARAMETERS + (SI5351_PARAMETERS_LENGTH * num);
129 static void si5351_read_parameters(struct si5351_driver_data *drvdata,
130 u8 reg, struct si5351_parameters *params)
132 u8 buf[SI5351_PARAMETERS_LENGTH];
134 switch (reg) {
135 case SI5351_CLK6_PARAMETERS:
136 case SI5351_CLK7_PARAMETERS:
137 buf[0] = si5351_reg_read(drvdata, reg);
138 params->p1 = buf[0];
139 params->p2 = 0;
140 params->p3 = 1;
141 break;
142 default:
143 si5351_bulk_read(drvdata, reg, SI5351_PARAMETERS_LENGTH, buf);
144 params->p1 = ((buf[2] & 0x03) << 16) | (buf[3] << 8) | buf[4];
145 params->p2 = ((buf[5] & 0x0f) << 16) | (buf[6] << 8) | buf[7];
146 params->p3 = ((buf[5] & 0xf0) << 12) | (buf[0] << 8) | buf[1];
148 params->valid = 1;
151 static void si5351_write_parameters(struct si5351_driver_data *drvdata,
152 u8 reg, struct si5351_parameters *params)
154 u8 buf[SI5351_PARAMETERS_LENGTH];
156 switch (reg) {
157 case SI5351_CLK6_PARAMETERS:
158 case SI5351_CLK7_PARAMETERS:
159 buf[0] = params->p1 & 0xff;
160 si5351_reg_write(drvdata, reg, buf[0]);
161 break;
162 default:
163 buf[0] = ((params->p3 & 0x0ff00) >> 8) & 0xff;
164 buf[1] = params->p3 & 0xff;
165 /* save rdiv and divby4 */
166 buf[2] = si5351_reg_read(drvdata, reg + 2) & ~0x03;
167 buf[2] |= ((params->p1 & 0x30000) >> 16) & 0x03;
168 buf[3] = ((params->p1 & 0x0ff00) >> 8) & 0xff;
169 buf[4] = params->p1 & 0xff;
170 buf[5] = ((params->p3 & 0xf0000) >> 12) |
171 ((params->p2 & 0xf0000) >> 16);
172 buf[6] = ((params->p2 & 0x0ff00) >> 8) & 0xff;
173 buf[7] = params->p2 & 0xff;
174 si5351_bulk_write(drvdata, reg, SI5351_PARAMETERS_LENGTH, buf);
178 static bool si5351_regmap_is_volatile(struct device *dev, unsigned int reg)
180 switch (reg) {
181 case SI5351_DEVICE_STATUS:
182 case SI5351_INTERRUPT_STATUS:
183 case SI5351_PLL_RESET:
184 return true;
186 return false;
189 static bool si5351_regmap_is_writeable(struct device *dev, unsigned int reg)
191 /* reserved registers */
192 if (reg >= 4 && reg <= 8)
193 return false;
194 if (reg >= 10 && reg <= 14)
195 return false;
196 if (reg >= 173 && reg <= 176)
197 return false;
198 if (reg >= 178 && reg <= 182)
199 return false;
200 /* read-only */
201 if (reg == SI5351_DEVICE_STATUS)
202 return false;
203 return true;
206 static const struct regmap_config si5351_regmap_config = {
207 .reg_bits = 8,
208 .val_bits = 8,
209 .cache_type = REGCACHE_MAPLE,
210 .max_register = 187,
211 .writeable_reg = si5351_regmap_is_writeable,
212 .volatile_reg = si5351_regmap_is_volatile,
216 * Si5351 xtal clock input
218 static int si5351_xtal_prepare(struct clk_hw *hw)
220 struct si5351_driver_data *drvdata =
221 container_of(hw, struct si5351_driver_data, xtal);
222 si5351_set_bits(drvdata, SI5351_FANOUT_ENABLE,
223 SI5351_XTAL_ENABLE, SI5351_XTAL_ENABLE);
224 return 0;
227 static void si5351_xtal_unprepare(struct clk_hw *hw)
229 struct si5351_driver_data *drvdata =
230 container_of(hw, struct si5351_driver_data, xtal);
231 si5351_set_bits(drvdata, SI5351_FANOUT_ENABLE,
232 SI5351_XTAL_ENABLE, 0);
235 static const struct clk_ops si5351_xtal_ops = {
236 .prepare = si5351_xtal_prepare,
237 .unprepare = si5351_xtal_unprepare,
241 * Si5351 clkin clock input (Si5351C only)
243 static int si5351_clkin_prepare(struct clk_hw *hw)
245 struct si5351_driver_data *drvdata =
246 container_of(hw, struct si5351_driver_data, clkin);
247 si5351_set_bits(drvdata, SI5351_FANOUT_ENABLE,
248 SI5351_CLKIN_ENABLE, SI5351_CLKIN_ENABLE);
249 return 0;
252 static void si5351_clkin_unprepare(struct clk_hw *hw)
254 struct si5351_driver_data *drvdata =
255 container_of(hw, struct si5351_driver_data, clkin);
256 si5351_set_bits(drvdata, SI5351_FANOUT_ENABLE,
257 SI5351_CLKIN_ENABLE, 0);
261 * CMOS clock source constraints:
262 * The input frequency range of the PLL is 10Mhz to 40MHz.
263 * If CLKIN is >40MHz, the input divider must be used.
265 static unsigned long si5351_clkin_recalc_rate(struct clk_hw *hw,
266 unsigned long parent_rate)
268 struct si5351_driver_data *drvdata =
269 container_of(hw, struct si5351_driver_data, clkin);
270 unsigned long rate;
271 unsigned char idiv;
273 rate = parent_rate;
274 if (parent_rate > 160000000) {
275 idiv = SI5351_CLKIN_DIV_8;
276 rate /= 8;
277 } else if (parent_rate > 80000000) {
278 idiv = SI5351_CLKIN_DIV_4;
279 rate /= 4;
280 } else if (parent_rate > 40000000) {
281 idiv = SI5351_CLKIN_DIV_2;
282 rate /= 2;
283 } else {
284 idiv = SI5351_CLKIN_DIV_1;
287 si5351_set_bits(drvdata, SI5351_PLL_INPUT_SOURCE,
288 SI5351_CLKIN_DIV_MASK, idiv);
290 dev_dbg(&drvdata->client->dev, "%s - clkin div = %d, rate = %lu\n",
291 __func__, (1 << (idiv >> 6)), rate);
293 return rate;
296 static const struct clk_ops si5351_clkin_ops = {
297 .prepare = si5351_clkin_prepare,
298 .unprepare = si5351_clkin_unprepare,
299 .recalc_rate = si5351_clkin_recalc_rate,
303 * Si5351 vxco clock input (Si5351B only)
306 static int si5351_vxco_prepare(struct clk_hw *hw)
308 struct si5351_hw_data *hwdata =
309 container_of(hw, struct si5351_hw_data, hw);
311 dev_warn(&hwdata->drvdata->client->dev, "VXCO currently unsupported\n");
313 return 0;
316 static void si5351_vxco_unprepare(struct clk_hw *hw)
320 static unsigned long si5351_vxco_recalc_rate(struct clk_hw *hw,
321 unsigned long parent_rate)
323 return 0;
326 static int si5351_vxco_set_rate(struct clk_hw *hw, unsigned long rate,
327 unsigned long parent)
329 return 0;
332 static const struct clk_ops si5351_vxco_ops = {
333 .prepare = si5351_vxco_prepare,
334 .unprepare = si5351_vxco_unprepare,
335 .recalc_rate = si5351_vxco_recalc_rate,
336 .set_rate = si5351_vxco_set_rate,
340 * Si5351 pll a/b
342 * Feedback Multisynth Divider Equations [2]
344 * fVCO = fIN * (a + b/c)
346 * with 15 + 0/1048575 <= (a + b/c) <= 90 + 0/1048575 and
347 * fIN = fXTAL or fIN = fCLKIN/CLKIN_DIV
349 * Feedback Multisynth Register Equations
351 * (1) MSNx_P1[17:0] = 128 * a + floor(128 * b/c) - 512
352 * (2) MSNx_P2[19:0] = 128 * b - c * floor(128 * b/c) = (128*b) mod c
353 * (3) MSNx_P3[19:0] = c
355 * Transposing (2) yields: (4) floor(128 * b/c) = (128 * b / MSNx_P2)/c
357 * Using (4) on (1) yields:
358 * MSNx_P1 = 128 * a + (128 * b/MSNx_P2)/c - 512
359 * MSNx_P1 + 512 + MSNx_P2/c = 128 * a + 128 * b/c
361 * a + b/c = (MSNx_P1 + MSNx_P2/MSNx_P3 + 512)/128
362 * = (MSNx_P1*MSNx_P3 + MSNx_P2 + 512*MSNx_P3)/(128*MSNx_P3)
365 static int _si5351_pll_reparent(struct si5351_driver_data *drvdata,
366 int num, enum si5351_pll_src parent)
368 u8 mask = (num == 0) ? SI5351_PLLA_SOURCE : SI5351_PLLB_SOURCE;
370 if (parent == SI5351_PLL_SRC_DEFAULT)
371 return 0;
373 if (num > 2)
374 return -EINVAL;
376 if (drvdata->variant != SI5351_VARIANT_C &&
377 parent != SI5351_PLL_SRC_XTAL)
378 return -EINVAL;
380 si5351_set_bits(drvdata, SI5351_PLL_INPUT_SOURCE, mask,
381 (parent == SI5351_PLL_SRC_XTAL) ? 0 : mask);
382 return 0;
385 static unsigned char si5351_pll_get_parent(struct clk_hw *hw)
387 struct si5351_hw_data *hwdata =
388 container_of(hw, struct si5351_hw_data, hw);
389 u8 mask = (hwdata->num == 0) ? SI5351_PLLA_SOURCE : SI5351_PLLB_SOURCE;
390 u8 val;
392 val = si5351_reg_read(hwdata->drvdata, SI5351_PLL_INPUT_SOURCE);
394 return (val & mask) ? 1 : 0;
397 static int si5351_pll_set_parent(struct clk_hw *hw, u8 index)
399 struct si5351_hw_data *hwdata =
400 container_of(hw, struct si5351_hw_data, hw);
402 if (hwdata->drvdata->variant != SI5351_VARIANT_C &&
403 index > 0)
404 return -EPERM;
406 if (index > 1)
407 return -EINVAL;
409 return _si5351_pll_reparent(hwdata->drvdata, hwdata->num,
410 (index == 0) ? SI5351_PLL_SRC_XTAL :
411 SI5351_PLL_SRC_CLKIN);
414 static unsigned long si5351_pll_recalc_rate(struct clk_hw *hw,
415 unsigned long parent_rate)
417 struct si5351_hw_data *hwdata =
418 container_of(hw, struct si5351_hw_data, hw);
419 u8 reg = (hwdata->num == 0) ? SI5351_PLLA_PARAMETERS :
420 SI5351_PLLB_PARAMETERS;
421 unsigned long long rate;
423 if (!hwdata->params.valid)
424 si5351_read_parameters(hwdata->drvdata, reg, &hwdata->params);
426 if (hwdata->params.p3 == 0)
427 return parent_rate;
429 /* fVCO = fIN * (P1*P3 + 512*P3 + P2)/(128*P3) */
430 rate = hwdata->params.p1 * hwdata->params.p3;
431 rate += 512 * hwdata->params.p3;
432 rate += hwdata->params.p2;
433 rate *= parent_rate;
434 do_div(rate, 128 * hwdata->params.p3);
436 dev_dbg(&hwdata->drvdata->client->dev,
437 "%s - %s: p1 = %lu, p2 = %lu, p3 = %lu, parent_rate = %lu, rate = %lu\n",
438 __func__, clk_hw_get_name(hw),
439 hwdata->params.p1, hwdata->params.p2, hwdata->params.p3,
440 parent_rate, (unsigned long)rate);
442 return (unsigned long)rate;
445 static int si5351_pll_determine_rate(struct clk_hw *hw,
446 struct clk_rate_request *req)
448 struct si5351_hw_data *hwdata =
449 container_of(hw, struct si5351_hw_data, hw);
450 unsigned long rate = req->rate;
451 unsigned long rfrac, denom, a, b, c;
452 unsigned long long lltmp;
454 if (rate < SI5351_PLL_VCO_MIN)
455 rate = SI5351_PLL_VCO_MIN;
456 if (rate > SI5351_PLL_VCO_MAX)
457 rate = SI5351_PLL_VCO_MAX;
459 /* determine integer part of feedback equation */
460 a = rate / req->best_parent_rate;
462 if (a < SI5351_PLL_A_MIN)
463 rate = req->best_parent_rate * SI5351_PLL_A_MIN;
464 if (a > SI5351_PLL_A_MAX)
465 rate = req->best_parent_rate * SI5351_PLL_A_MAX;
467 /* find best approximation for b/c = fVCO mod fIN */
468 denom = 1000 * 1000;
469 lltmp = rate % (req->best_parent_rate);
470 lltmp *= denom;
471 do_div(lltmp, req->best_parent_rate);
472 rfrac = (unsigned long)lltmp;
474 b = 0;
475 c = 1;
476 if (rfrac)
477 rational_best_approximation(rfrac, denom,
478 SI5351_PLL_B_MAX, SI5351_PLL_C_MAX, &b, &c);
480 /* calculate parameters */
481 hwdata->params.p3 = c;
482 hwdata->params.p2 = (128 * b) % c;
483 hwdata->params.p1 = 128 * a;
484 hwdata->params.p1 += (128 * b / c);
485 hwdata->params.p1 -= 512;
487 /* recalculate rate by fIN * (a + b/c) */
488 lltmp = req->best_parent_rate;
489 lltmp *= b;
490 do_div(lltmp, c);
492 rate = (unsigned long)lltmp;
493 rate += req->best_parent_rate * a;
495 dev_dbg(&hwdata->drvdata->client->dev,
496 "%s - %s: a = %lu, b = %lu, c = %lu, parent_rate = %lu, rate = %lu\n",
497 __func__, clk_hw_get_name(hw), a, b, c,
498 req->best_parent_rate, rate);
500 req->rate = rate;
501 return 0;
504 static int si5351_pll_set_rate(struct clk_hw *hw, unsigned long rate,
505 unsigned long parent_rate)
507 struct si5351_hw_data *hwdata =
508 container_of(hw, struct si5351_hw_data, hw);
509 struct si5351_platform_data *pdata =
510 hwdata->drvdata->client->dev.platform_data;
511 u8 reg = (hwdata->num == 0) ? SI5351_PLLA_PARAMETERS :
512 SI5351_PLLB_PARAMETERS;
514 /* write multisynth parameters */
515 si5351_write_parameters(hwdata->drvdata, reg, &hwdata->params);
517 /* plla/pllb ctrl is in clk6/clk7 ctrl registers */
518 si5351_set_bits(hwdata->drvdata, SI5351_CLK6_CTRL + hwdata->num,
519 SI5351_CLK_INTEGER_MODE,
520 (hwdata->params.p2 == 0) ? SI5351_CLK_INTEGER_MODE : 0);
522 /* Do a pll soft reset on the affected pll */
523 if (pdata->pll_reset[hwdata->num])
524 si5351_reg_write(hwdata->drvdata, SI5351_PLL_RESET,
525 hwdata->num == 0 ? SI5351_PLL_RESET_A :
526 SI5351_PLL_RESET_B);
528 dev_dbg(&hwdata->drvdata->client->dev,
529 "%s - %s: p1 = %lu, p2 = %lu, p3 = %lu, parent_rate = %lu, rate = %lu\n",
530 __func__, clk_hw_get_name(hw),
531 hwdata->params.p1, hwdata->params.p2, hwdata->params.p3,
532 parent_rate, rate);
534 return 0;
537 static const struct clk_ops si5351_pll_ops = {
538 .set_parent = si5351_pll_set_parent,
539 .get_parent = si5351_pll_get_parent,
540 .recalc_rate = si5351_pll_recalc_rate,
541 .determine_rate = si5351_pll_determine_rate,
542 .set_rate = si5351_pll_set_rate,
546 * Si5351 multisync divider
548 * for fOUT <= 150 MHz:
550 * fOUT = (fIN * (a + b/c)) / CLKOUTDIV
552 * with 6 + 0/1048575 <= (a + b/c) <= 1800 + 0/1048575 and
553 * fIN = fVCO0, fVCO1
555 * Output Clock Multisynth Register Equations
557 * MSx_P1[17:0] = 128 * a + floor(128 * b/c) - 512
558 * MSx_P2[19:0] = 128 * b - c * floor(128 * b/c) = (128*b) mod c
559 * MSx_P3[19:0] = c
561 * MS[6,7] are integer (P1) divide only, P1 = divide value,
562 * P2 and P3 are not applicable
564 * for 150MHz < fOUT <= 160MHz:
566 * MSx_P1 = 0, MSx_P2 = 0, MSx_P3 = 1, MSx_INT = 1, MSx_DIVBY4 = 11b
568 static int _si5351_msynth_reparent(struct si5351_driver_data *drvdata,
569 int num, enum si5351_multisynth_src parent)
571 if (parent == SI5351_MULTISYNTH_SRC_DEFAULT)
572 return 0;
574 if (num > 8)
575 return -EINVAL;
577 si5351_set_bits(drvdata, SI5351_CLK0_CTRL + num, SI5351_CLK_PLL_SELECT,
578 (parent == SI5351_MULTISYNTH_SRC_VCO0) ? 0 :
579 SI5351_CLK_PLL_SELECT);
580 return 0;
583 static unsigned char si5351_msynth_get_parent(struct clk_hw *hw)
585 struct si5351_hw_data *hwdata =
586 container_of(hw, struct si5351_hw_data, hw);
587 u8 val;
589 val = si5351_reg_read(hwdata->drvdata, SI5351_CLK0_CTRL + hwdata->num);
591 return (val & SI5351_CLK_PLL_SELECT) ? 1 : 0;
594 static int si5351_msynth_set_parent(struct clk_hw *hw, u8 index)
596 struct si5351_hw_data *hwdata =
597 container_of(hw, struct si5351_hw_data, hw);
599 return _si5351_msynth_reparent(hwdata->drvdata, hwdata->num,
600 (index == 0) ? SI5351_MULTISYNTH_SRC_VCO0 :
601 SI5351_MULTISYNTH_SRC_VCO1);
604 static unsigned long si5351_msynth_recalc_rate(struct clk_hw *hw,
605 unsigned long parent_rate)
607 struct si5351_hw_data *hwdata =
608 container_of(hw, struct si5351_hw_data, hw);
609 u8 reg = si5351_msynth_params_address(hwdata->num);
610 unsigned long long rate;
611 unsigned long m;
613 if (!hwdata->params.valid)
614 si5351_read_parameters(hwdata->drvdata, reg, &hwdata->params);
617 * multisync0-5: fOUT = (128 * P3 * fIN) / (P1*P3 + P2 + 512*P3)
618 * multisync6-7: fOUT = fIN / P1
620 rate = parent_rate;
621 if (hwdata->num > 5) {
622 m = hwdata->params.p1;
623 } else if (hwdata->params.p3 == 0) {
624 return parent_rate;
625 } else if ((si5351_reg_read(hwdata->drvdata, reg + 2) &
626 SI5351_OUTPUT_CLK_DIVBY4) == SI5351_OUTPUT_CLK_DIVBY4) {
627 m = 4;
628 } else {
629 rate *= 128 * hwdata->params.p3;
630 m = hwdata->params.p1 * hwdata->params.p3;
631 m += hwdata->params.p2;
632 m += 512 * hwdata->params.p3;
635 if (m == 0)
636 return 0;
637 do_div(rate, m);
639 dev_dbg(&hwdata->drvdata->client->dev,
640 "%s - %s: p1 = %lu, p2 = %lu, p3 = %lu, m = %lu, parent_rate = %lu, rate = %lu\n",
641 __func__, clk_hw_get_name(hw),
642 hwdata->params.p1, hwdata->params.p2, hwdata->params.p3,
643 m, parent_rate, (unsigned long)rate);
645 return (unsigned long)rate;
648 static int si5351_msynth_determine_rate(struct clk_hw *hw,
649 struct clk_rate_request *req)
651 struct si5351_hw_data *hwdata =
652 container_of(hw, struct si5351_hw_data, hw);
653 unsigned long rate = req->rate;
654 unsigned long long lltmp;
655 unsigned long a, b, c;
656 int divby4;
658 /* multisync6-7 can only handle freqencies < 150MHz */
659 if (hwdata->num >= 6 && rate > SI5351_MULTISYNTH67_MAX_FREQ)
660 rate = SI5351_MULTISYNTH67_MAX_FREQ;
662 /* multisync frequency is 1MHz .. 160MHz */
663 if (rate > SI5351_MULTISYNTH_MAX_FREQ)
664 rate = SI5351_MULTISYNTH_MAX_FREQ;
665 if (rate < SI5351_MULTISYNTH_MIN_FREQ)
666 rate = SI5351_MULTISYNTH_MIN_FREQ;
668 divby4 = 0;
669 if (rate > SI5351_MULTISYNTH_DIVBY4_FREQ)
670 divby4 = 1;
672 /* multisync can set pll */
673 if (clk_hw_get_flags(hw) & CLK_SET_RATE_PARENT) {
675 * find largest integer divider for max
676 * vco frequency and given target rate
678 if (divby4 == 0) {
679 lltmp = SI5351_PLL_VCO_MAX;
680 do_div(lltmp, rate);
681 a = (unsigned long)lltmp;
682 } else
683 a = 4;
685 b = 0;
686 c = 1;
688 req->best_parent_rate = a * rate;
689 } else if (hwdata->num >= 6) {
690 /* determine the closest integer divider */
691 a = DIV_ROUND_CLOSEST(req->best_parent_rate, rate);
692 if (a < SI5351_MULTISYNTH_A_MIN)
693 a = SI5351_MULTISYNTH_A_MIN;
694 if (a > SI5351_MULTISYNTH67_A_MAX)
695 a = SI5351_MULTISYNTH67_A_MAX;
697 b = 0;
698 c = 1;
699 } else {
700 unsigned long rfrac, denom;
702 /* disable divby4 */
703 if (divby4) {
704 rate = SI5351_MULTISYNTH_DIVBY4_FREQ;
705 divby4 = 0;
708 /* determine integer part of divider equation */
709 a = req->best_parent_rate / rate;
710 if (a < SI5351_MULTISYNTH_A_MIN)
711 a = SI5351_MULTISYNTH_A_MIN;
712 if (a > SI5351_MULTISYNTH_A_MAX)
713 a = SI5351_MULTISYNTH_A_MAX;
715 /* find best approximation for b/c = fVCO mod fOUT */
716 denom = 1000 * 1000;
717 lltmp = req->best_parent_rate % rate;
718 lltmp *= denom;
719 do_div(lltmp, rate);
720 rfrac = (unsigned long)lltmp;
722 b = 0;
723 c = 1;
724 if (rfrac)
725 rational_best_approximation(rfrac, denom,
726 SI5351_MULTISYNTH_B_MAX, SI5351_MULTISYNTH_C_MAX,
727 &b, &c);
730 /* recalculate rate by fOUT = fIN / (a + b/c) */
731 lltmp = req->best_parent_rate;
732 lltmp *= c;
733 do_div(lltmp, a * c + b);
734 rate = (unsigned long)lltmp;
736 /* calculate parameters */
737 if (divby4) {
738 hwdata->params.p3 = 1;
739 hwdata->params.p2 = 0;
740 hwdata->params.p1 = 0;
741 } else if (hwdata->num >= 6) {
742 hwdata->params.p3 = 0;
743 hwdata->params.p2 = 0;
744 hwdata->params.p1 = a;
745 } else {
746 hwdata->params.p3 = c;
747 hwdata->params.p2 = (128 * b) % c;
748 hwdata->params.p1 = 128 * a;
749 hwdata->params.p1 += (128 * b / c);
750 hwdata->params.p1 -= 512;
753 dev_dbg(&hwdata->drvdata->client->dev,
754 "%s - %s: a = %lu, b = %lu, c = %lu, divby4 = %d, parent_rate = %lu, rate = %lu\n",
755 __func__, clk_hw_get_name(hw), a, b, c, divby4,
756 req->best_parent_rate, rate);
758 req->rate = rate;
760 return 0;
763 static int si5351_msynth_set_rate(struct clk_hw *hw, unsigned long rate,
764 unsigned long parent_rate)
766 struct si5351_hw_data *hwdata =
767 container_of(hw, struct si5351_hw_data, hw);
768 u8 reg = si5351_msynth_params_address(hwdata->num);
769 int divby4 = 0;
771 /* write multisynth parameters */
772 si5351_write_parameters(hwdata->drvdata, reg, &hwdata->params);
774 if (rate > SI5351_MULTISYNTH_DIVBY4_FREQ)
775 divby4 = 1;
777 /* enable/disable integer mode and divby4 on multisynth0-5 */
778 if (hwdata->num < 6) {
779 si5351_set_bits(hwdata->drvdata, reg + 2,
780 SI5351_OUTPUT_CLK_DIVBY4,
781 (divby4) ? SI5351_OUTPUT_CLK_DIVBY4 : 0);
782 si5351_set_bits(hwdata->drvdata, SI5351_CLK0_CTRL + hwdata->num,
783 SI5351_CLK_INTEGER_MODE,
784 (hwdata->params.p2 == 0) ? SI5351_CLK_INTEGER_MODE : 0);
787 dev_dbg(&hwdata->drvdata->client->dev,
788 "%s - %s: p1 = %lu, p2 = %lu, p3 = %lu, divby4 = %d, parent_rate = %lu, rate = %lu\n",
789 __func__, clk_hw_get_name(hw),
790 hwdata->params.p1, hwdata->params.p2, hwdata->params.p3,
791 divby4, parent_rate, rate);
793 return 0;
796 static const struct clk_ops si5351_msynth_ops = {
797 .set_parent = si5351_msynth_set_parent,
798 .get_parent = si5351_msynth_get_parent,
799 .recalc_rate = si5351_msynth_recalc_rate,
800 .determine_rate = si5351_msynth_determine_rate,
801 .set_rate = si5351_msynth_set_rate,
805 * Si5351 clkout divider
807 static int _si5351_clkout_reparent(struct si5351_driver_data *drvdata,
808 int num, enum si5351_clkout_src parent)
810 u8 val;
812 if (num > 8)
813 return -EINVAL;
815 switch (parent) {
816 case SI5351_CLKOUT_SRC_MSYNTH_N:
817 val = SI5351_CLK_INPUT_MULTISYNTH_N;
818 break;
819 case SI5351_CLKOUT_SRC_MSYNTH_0_4:
820 /* clk0/clk4 can only connect to its own multisync */
821 if (num == 0 || num == 4)
822 val = SI5351_CLK_INPUT_MULTISYNTH_N;
823 else
824 val = SI5351_CLK_INPUT_MULTISYNTH_0_4;
825 break;
826 case SI5351_CLKOUT_SRC_XTAL:
827 val = SI5351_CLK_INPUT_XTAL;
828 break;
829 case SI5351_CLKOUT_SRC_CLKIN:
830 if (drvdata->variant != SI5351_VARIANT_C)
831 return -EINVAL;
833 val = SI5351_CLK_INPUT_CLKIN;
834 break;
835 default:
836 return 0;
839 si5351_set_bits(drvdata, SI5351_CLK0_CTRL + num,
840 SI5351_CLK_INPUT_MASK, val);
841 return 0;
844 static int _si5351_clkout_set_drive_strength(
845 struct si5351_driver_data *drvdata, int num,
846 enum si5351_drive_strength drive)
848 u8 mask;
850 if (num > 8)
851 return -EINVAL;
853 switch (drive) {
854 case SI5351_DRIVE_2MA:
855 mask = SI5351_CLK_DRIVE_STRENGTH_2MA;
856 break;
857 case SI5351_DRIVE_4MA:
858 mask = SI5351_CLK_DRIVE_STRENGTH_4MA;
859 break;
860 case SI5351_DRIVE_6MA:
861 mask = SI5351_CLK_DRIVE_STRENGTH_6MA;
862 break;
863 case SI5351_DRIVE_8MA:
864 mask = SI5351_CLK_DRIVE_STRENGTH_8MA;
865 break;
866 default:
867 return 0;
870 si5351_set_bits(drvdata, SI5351_CLK0_CTRL + num,
871 SI5351_CLK_DRIVE_STRENGTH_MASK, mask);
872 return 0;
875 static int _si5351_clkout_set_disable_state(
876 struct si5351_driver_data *drvdata, int num,
877 enum si5351_disable_state state)
879 u8 reg = (num < 4) ? SI5351_CLK3_0_DISABLE_STATE :
880 SI5351_CLK7_4_DISABLE_STATE;
881 u8 shift = (num < 4) ? (2 * num) : (2 * (num-4));
882 u8 mask = SI5351_CLK_DISABLE_STATE_MASK << shift;
883 u8 val;
885 if (num > 8)
886 return -EINVAL;
888 switch (state) {
889 case SI5351_DISABLE_LOW:
890 val = SI5351_CLK_DISABLE_STATE_LOW;
891 break;
892 case SI5351_DISABLE_HIGH:
893 val = SI5351_CLK_DISABLE_STATE_HIGH;
894 break;
895 case SI5351_DISABLE_FLOATING:
896 val = SI5351_CLK_DISABLE_STATE_FLOAT;
897 break;
898 case SI5351_DISABLE_NEVER:
899 val = SI5351_CLK_DISABLE_STATE_NEVER;
900 break;
901 default:
902 return 0;
905 si5351_set_bits(drvdata, reg, mask, val << shift);
907 return 0;
910 static void _si5351_clkout_reset_pll(struct si5351_driver_data *drvdata, int num)
912 u8 val = si5351_reg_read(drvdata, SI5351_CLK0_CTRL + num);
913 u8 mask = val & SI5351_CLK_PLL_SELECT ? SI5351_PLL_RESET_B :
914 SI5351_PLL_RESET_A;
915 unsigned int v;
916 int err;
918 switch (val & SI5351_CLK_INPUT_MASK) {
919 case SI5351_CLK_INPUT_XTAL:
920 case SI5351_CLK_INPUT_CLKIN:
921 return; /* pll not used, no need to reset */
924 si5351_reg_write(drvdata, SI5351_PLL_RESET, mask);
926 err = regmap_read_poll_timeout(drvdata->regmap, SI5351_PLL_RESET, v,
927 !(v & mask), 0, 20000);
928 if (err < 0)
929 dev_err(&drvdata->client->dev, "Reset bit didn't clear\n");
931 dev_dbg(&drvdata->client->dev, "%s - %s: pll = %d\n",
932 __func__, clk_hw_get_name(&drvdata->clkout[num].hw),
933 (val & SI5351_CLK_PLL_SELECT) ? 1 : 0);
936 static int si5351_clkout_prepare(struct clk_hw *hw)
938 struct si5351_hw_data *hwdata =
939 container_of(hw, struct si5351_hw_data, hw);
940 struct si5351_platform_data *pdata =
941 hwdata->drvdata->client->dev.platform_data;
943 si5351_set_bits(hwdata->drvdata, SI5351_CLK0_CTRL + hwdata->num,
944 SI5351_CLK_POWERDOWN, 0);
947 * Do a pll soft reset on the parent pll -- needed to get a
948 * deterministic phase relationship between the output clocks.
950 if (pdata->clkout[hwdata->num].pll_reset)
951 _si5351_clkout_reset_pll(hwdata->drvdata, hwdata->num);
953 si5351_set_bits(hwdata->drvdata, SI5351_OUTPUT_ENABLE_CTRL,
954 (1 << hwdata->num), 0);
955 return 0;
958 static void si5351_clkout_unprepare(struct clk_hw *hw)
960 struct si5351_hw_data *hwdata =
961 container_of(hw, struct si5351_hw_data, hw);
963 si5351_set_bits(hwdata->drvdata, SI5351_CLK0_CTRL + hwdata->num,
964 SI5351_CLK_POWERDOWN, SI5351_CLK_POWERDOWN);
965 si5351_set_bits(hwdata->drvdata, SI5351_OUTPUT_ENABLE_CTRL,
966 (1 << hwdata->num), (1 << hwdata->num));
969 static u8 si5351_clkout_get_parent(struct clk_hw *hw)
971 struct si5351_hw_data *hwdata =
972 container_of(hw, struct si5351_hw_data, hw);
973 int index = 0;
974 unsigned char val;
976 val = si5351_reg_read(hwdata->drvdata, SI5351_CLK0_CTRL + hwdata->num);
977 switch (val & SI5351_CLK_INPUT_MASK) {
978 case SI5351_CLK_INPUT_MULTISYNTH_N:
979 index = 0;
980 break;
981 case SI5351_CLK_INPUT_MULTISYNTH_0_4:
982 index = 1;
983 break;
984 case SI5351_CLK_INPUT_XTAL:
985 index = 2;
986 break;
987 case SI5351_CLK_INPUT_CLKIN:
988 index = 3;
989 break;
992 return index;
995 static int si5351_clkout_set_parent(struct clk_hw *hw, u8 index)
997 struct si5351_hw_data *hwdata =
998 container_of(hw, struct si5351_hw_data, hw);
999 enum si5351_clkout_src parent = SI5351_CLKOUT_SRC_DEFAULT;
1001 switch (index) {
1002 case 0:
1003 parent = SI5351_CLKOUT_SRC_MSYNTH_N;
1004 break;
1005 case 1:
1006 parent = SI5351_CLKOUT_SRC_MSYNTH_0_4;
1007 break;
1008 case 2:
1009 parent = SI5351_CLKOUT_SRC_XTAL;
1010 break;
1011 case 3:
1012 parent = SI5351_CLKOUT_SRC_CLKIN;
1013 break;
1016 return _si5351_clkout_reparent(hwdata->drvdata, hwdata->num, parent);
1019 static unsigned long si5351_clkout_recalc_rate(struct clk_hw *hw,
1020 unsigned long parent_rate)
1022 struct si5351_hw_data *hwdata =
1023 container_of(hw, struct si5351_hw_data, hw);
1024 unsigned char reg;
1025 unsigned char rdiv;
1027 if (hwdata->num <= 5)
1028 reg = si5351_msynth_params_address(hwdata->num) + 2;
1029 else
1030 reg = SI5351_CLK6_7_OUTPUT_DIVIDER;
1032 rdiv = si5351_reg_read(hwdata->drvdata, reg);
1033 if (hwdata->num == 6) {
1034 rdiv &= SI5351_OUTPUT_CLK6_DIV_MASK;
1035 } else {
1036 rdiv &= SI5351_OUTPUT_CLK_DIV_MASK;
1037 rdiv >>= SI5351_OUTPUT_CLK_DIV_SHIFT;
1040 return parent_rate >> rdiv;
1043 static int si5351_clkout_determine_rate(struct clk_hw *hw,
1044 struct clk_rate_request *req)
1046 struct si5351_hw_data *hwdata =
1047 container_of(hw, struct si5351_hw_data, hw);
1048 unsigned long rate = req->rate;
1049 unsigned char rdiv;
1051 /* clkout6/7 can only handle output freqencies < 150MHz */
1052 if (hwdata->num >= 6 && rate > SI5351_CLKOUT67_MAX_FREQ)
1053 rate = SI5351_CLKOUT67_MAX_FREQ;
1055 /* clkout freqency is 8kHz - 160MHz */
1056 if (rate > SI5351_CLKOUT_MAX_FREQ)
1057 rate = SI5351_CLKOUT_MAX_FREQ;
1058 if (rate < SI5351_CLKOUT_MIN_FREQ)
1059 rate = SI5351_CLKOUT_MIN_FREQ;
1061 /* request frequency if multisync master */
1062 if (clk_hw_get_flags(hw) & CLK_SET_RATE_PARENT) {
1063 /* use r divider for frequencies below 1MHz */
1064 rdiv = SI5351_OUTPUT_CLK_DIV_1;
1065 while (rate < SI5351_MULTISYNTH_MIN_FREQ &&
1066 rdiv < SI5351_OUTPUT_CLK_DIV_128) {
1067 rdiv += 1;
1068 rate *= 2;
1070 req->best_parent_rate = rate;
1071 } else {
1072 unsigned long new_rate, new_err, err;
1074 /* round to closed rdiv */
1075 rdiv = SI5351_OUTPUT_CLK_DIV_1;
1076 new_rate = req->best_parent_rate;
1077 err = abs(new_rate - rate);
1078 do {
1079 new_rate >>= 1;
1080 new_err = abs(new_rate - rate);
1081 if (new_err > err || rdiv == SI5351_OUTPUT_CLK_DIV_128)
1082 break;
1083 rdiv++;
1084 err = new_err;
1085 } while (1);
1087 rate = req->best_parent_rate >> rdiv;
1089 dev_dbg(&hwdata->drvdata->client->dev,
1090 "%s - %s: rdiv = %u, parent_rate = %lu, rate = %lu\n",
1091 __func__, clk_hw_get_name(hw), (1 << rdiv),
1092 req->best_parent_rate, rate);
1094 req->rate = rate;
1095 return 0;
1098 static int si5351_clkout_set_rate(struct clk_hw *hw, unsigned long rate,
1099 unsigned long parent_rate)
1101 struct si5351_hw_data *hwdata =
1102 container_of(hw, struct si5351_hw_data, hw);
1103 unsigned long new_rate, new_err, err;
1104 unsigned char rdiv;
1106 /* round to closed rdiv */
1107 rdiv = SI5351_OUTPUT_CLK_DIV_1;
1108 new_rate = parent_rate;
1109 err = abs(new_rate - rate);
1110 do {
1111 new_rate >>= 1;
1112 new_err = abs(new_rate - rate);
1113 if (new_err > err || rdiv == SI5351_OUTPUT_CLK_DIV_128)
1114 break;
1115 rdiv++;
1116 err = new_err;
1117 } while (1);
1119 /* write output divider */
1120 switch (hwdata->num) {
1121 case 6:
1122 si5351_set_bits(hwdata->drvdata, SI5351_CLK6_7_OUTPUT_DIVIDER,
1123 SI5351_OUTPUT_CLK6_DIV_MASK, rdiv);
1124 break;
1125 case 7:
1126 si5351_set_bits(hwdata->drvdata, SI5351_CLK6_7_OUTPUT_DIVIDER,
1127 SI5351_OUTPUT_CLK_DIV_MASK,
1128 rdiv << SI5351_OUTPUT_CLK_DIV_SHIFT);
1129 break;
1130 default:
1131 si5351_set_bits(hwdata->drvdata,
1132 si5351_msynth_params_address(hwdata->num) + 2,
1133 SI5351_OUTPUT_CLK_DIV_MASK,
1134 rdiv << SI5351_OUTPUT_CLK_DIV_SHIFT);
1137 /* powerup clkout */
1138 si5351_set_bits(hwdata->drvdata, SI5351_CLK0_CTRL + hwdata->num,
1139 SI5351_CLK_POWERDOWN, 0);
1141 dev_dbg(&hwdata->drvdata->client->dev,
1142 "%s - %s: rdiv = %u, parent_rate = %lu, rate = %lu\n",
1143 __func__, clk_hw_get_name(hw), (1 << rdiv),
1144 parent_rate, rate);
1146 return 0;
1149 static const struct clk_ops si5351_clkout_ops = {
1150 .prepare = si5351_clkout_prepare,
1151 .unprepare = si5351_clkout_unprepare,
1152 .set_parent = si5351_clkout_set_parent,
1153 .get_parent = si5351_clkout_get_parent,
1154 .recalc_rate = si5351_clkout_recalc_rate,
1155 .determine_rate = si5351_clkout_determine_rate,
1156 .set_rate = si5351_clkout_set_rate,
1160 * Si5351 i2c probe and DT
1162 #ifdef CONFIG_OF
1163 static const struct of_device_id si5351_dt_ids[] = {
1164 { .compatible = "silabs,si5351a", .data = (void *)SI5351_VARIANT_A, },
1165 { .compatible = "silabs,si5351a-msop",
1166 .data = (void *)SI5351_VARIANT_A3, },
1167 { .compatible = "silabs,si5351b", .data = (void *)SI5351_VARIANT_B, },
1168 { .compatible = "silabs,si5351c", .data = (void *)SI5351_VARIANT_C, },
1171 MODULE_DEVICE_TABLE(of, si5351_dt_ids);
1173 static int si5351_dt_parse(struct i2c_client *client,
1174 enum si5351_variant variant)
1176 struct device_node *child, *np = client->dev.of_node;
1177 struct si5351_platform_data *pdata;
1178 u32 array[4];
1179 int sz, i;
1180 int num = 0;
1181 u32 val;
1183 if (np == NULL)
1184 return 0;
1186 pdata = devm_kzalloc(&client->dev, sizeof(*pdata), GFP_KERNEL);
1187 if (!pdata)
1188 return -ENOMEM;
1191 * property silabs,pll-source : <num src>, [<..>]
1192 * allow to selectively set pll source
1194 sz = of_property_read_variable_u32_array(np, "silabs,pll-source", array, 2, 4);
1195 sz = (sz == -EINVAL) ? 0 : sz; /* Missing property is OK */
1196 if (sz < 0)
1197 return dev_err_probe(&client->dev, sz, "invalid pll-source\n");
1198 if (sz % 2)
1199 return dev_err_probe(&client->dev, -EINVAL,
1200 "missing pll-source for pll %d\n", array[sz - 1]);
1202 for (i = 0; i < sz; i += 2) {
1203 num = array[i];
1204 val = array[i + 1];
1206 if (num >= 2) {
1207 dev_err(&client->dev,
1208 "invalid pll %d on pll-source prop\n", num);
1209 return -EINVAL;
1212 switch (val) {
1213 case 0:
1214 pdata->pll_src[num] = SI5351_PLL_SRC_XTAL;
1215 break;
1216 case 1:
1217 if (variant != SI5351_VARIANT_C) {
1218 dev_err(&client->dev,
1219 "invalid parent %d for pll %d\n",
1220 val, num);
1221 return -EINVAL;
1223 pdata->pll_src[num] = SI5351_PLL_SRC_CLKIN;
1224 break;
1225 default:
1226 dev_err(&client->dev,
1227 "invalid parent %d for pll %d\n", val, num);
1228 return -EINVAL;
1233 * Parse PLL reset mode. For compatibility with older device trees, the
1234 * default is to always reset a PLL after setting its rate.
1236 pdata->pll_reset[0] = true;
1237 pdata->pll_reset[1] = true;
1239 sz = of_property_read_variable_u32_array(np, "silabs,pll-reset-mode", array, 2, 4);
1240 sz = (sz == -EINVAL) ? 0 : sz; /* Missing property is OK */
1241 if (sz < 0)
1242 return dev_err_probe(&client->dev, sz, "invalid pll-reset-mode\n");
1243 if (sz % 2)
1244 return dev_err_probe(&client->dev, -EINVAL,
1245 "missing pll-reset-mode for pll %d\n", array[sz - 1]);
1247 for (i = 0; i < sz; i += 2) {
1248 num = array[i];
1249 val = array[i + 1];
1251 if (num >= 2) {
1252 dev_err(&client->dev,
1253 "invalid pll %d on pll-reset-mode prop\n", num);
1254 return -EINVAL;
1258 switch (val) {
1259 case 0:
1260 /* Reset PLL whenever its rate is adjusted */
1261 pdata->pll_reset[num] = true;
1262 break;
1263 case 1:
1264 /* Don't reset PLL whenever its rate is adjusted */
1265 pdata->pll_reset[num] = false;
1266 break;
1267 default:
1268 dev_err(&client->dev,
1269 "invalid pll-reset-mode %d for pll %d\n", val,
1270 num);
1271 return -EINVAL;
1275 /* per clkout properties */
1276 for_each_child_of_node(np, child) {
1277 if (of_property_read_u32(child, "reg", &num)) {
1278 dev_err(&client->dev, "missing reg property of %pOFn\n",
1279 child);
1280 goto put_child;
1283 if (num >= 8 ||
1284 (variant == SI5351_VARIANT_A3 && num >= 3)) {
1285 dev_err(&client->dev, "invalid clkout %d\n", num);
1286 goto put_child;
1289 if (!of_property_read_u32(child, "silabs,multisynth-source",
1290 &val)) {
1291 switch (val) {
1292 case 0:
1293 pdata->clkout[num].multisynth_src =
1294 SI5351_MULTISYNTH_SRC_VCO0;
1295 break;
1296 case 1:
1297 pdata->clkout[num].multisynth_src =
1298 SI5351_MULTISYNTH_SRC_VCO1;
1299 break;
1300 default:
1301 dev_err(&client->dev,
1302 "invalid parent %d for multisynth %d\n",
1303 val, num);
1304 goto put_child;
1308 if (!of_property_read_u32(child, "silabs,clock-source", &val)) {
1309 switch (val) {
1310 case 0:
1311 pdata->clkout[num].clkout_src =
1312 SI5351_CLKOUT_SRC_MSYNTH_N;
1313 break;
1314 case 1:
1315 pdata->clkout[num].clkout_src =
1316 SI5351_CLKOUT_SRC_MSYNTH_0_4;
1317 break;
1318 case 2:
1319 pdata->clkout[num].clkout_src =
1320 SI5351_CLKOUT_SRC_XTAL;
1321 break;
1322 case 3:
1323 if (variant != SI5351_VARIANT_C) {
1324 dev_err(&client->dev,
1325 "invalid parent %d for clkout %d\n",
1326 val, num);
1327 goto put_child;
1329 pdata->clkout[num].clkout_src =
1330 SI5351_CLKOUT_SRC_CLKIN;
1331 break;
1332 default:
1333 dev_err(&client->dev,
1334 "invalid parent %d for clkout %d\n",
1335 val, num);
1336 goto put_child;
1340 if (!of_property_read_u32(child, "silabs,drive-strength",
1341 &val)) {
1342 switch (val) {
1343 case SI5351_DRIVE_2MA:
1344 case SI5351_DRIVE_4MA:
1345 case SI5351_DRIVE_6MA:
1346 case SI5351_DRIVE_8MA:
1347 pdata->clkout[num].drive = val;
1348 break;
1349 default:
1350 dev_err(&client->dev,
1351 "invalid drive strength %d for clkout %d\n",
1352 val, num);
1353 goto put_child;
1357 if (!of_property_read_u32(child, "silabs,disable-state",
1358 &val)) {
1359 switch (val) {
1360 case 0:
1361 pdata->clkout[num].disable_state =
1362 SI5351_DISABLE_LOW;
1363 break;
1364 case 1:
1365 pdata->clkout[num].disable_state =
1366 SI5351_DISABLE_HIGH;
1367 break;
1368 case 2:
1369 pdata->clkout[num].disable_state =
1370 SI5351_DISABLE_FLOATING;
1371 break;
1372 case 3:
1373 pdata->clkout[num].disable_state =
1374 SI5351_DISABLE_NEVER;
1375 break;
1376 default:
1377 dev_err(&client->dev,
1378 "invalid disable state %d for clkout %d\n",
1379 val, num);
1380 goto put_child;
1384 if (!of_property_read_u32(child, "clock-frequency", &val))
1385 pdata->clkout[num].rate = val;
1387 pdata->clkout[num].pll_master =
1388 of_property_read_bool(child, "silabs,pll-master");
1390 pdata->clkout[num].pll_reset =
1391 of_property_read_bool(child, "silabs,pll-reset");
1393 client->dev.platform_data = pdata;
1395 return 0;
1396 put_child:
1397 of_node_put(child);
1398 return -EINVAL;
1401 static struct clk_hw *
1402 si53351_of_clk_get(struct of_phandle_args *clkspec, void *data)
1404 struct si5351_driver_data *drvdata = data;
1405 unsigned int idx = clkspec->args[0];
1407 if (idx >= drvdata->num_clkout) {
1408 pr_err("%s: invalid index %u\n", __func__, idx);
1409 return ERR_PTR(-EINVAL);
1412 return &drvdata->clkout[idx].hw;
1414 #else
1415 static int si5351_dt_parse(struct i2c_client *client, enum si5351_variant variant)
1417 return 0;
1420 static struct clk_hw *
1421 si53351_of_clk_get(struct of_phandle_args *clkspec, void *data)
1423 return NULL;
1425 #endif /* CONFIG_OF */
1427 static const struct i2c_device_id si5351_i2c_ids[] = {
1428 { "si5351a", SI5351_VARIANT_A },
1429 { "si5351a-msop", SI5351_VARIANT_A3 },
1430 { "si5351b", SI5351_VARIANT_B },
1431 { "si5351c", SI5351_VARIANT_C },
1434 MODULE_DEVICE_TABLE(i2c, si5351_i2c_ids);
1436 static int si5351_i2c_probe(struct i2c_client *client)
1438 enum si5351_variant variant;
1439 struct si5351_platform_data *pdata;
1440 struct si5351_driver_data *drvdata;
1441 struct clk_init_data init;
1442 const char *parent_names[4];
1443 u8 num_parents, num_clocks;
1444 int ret, n;
1446 variant = (enum si5351_variant)(uintptr_t)i2c_get_match_data(client);
1447 ret = si5351_dt_parse(client, variant);
1448 if (ret)
1449 return ret;
1451 pdata = client->dev.platform_data;
1452 if (!pdata)
1453 return -EINVAL;
1455 drvdata = devm_kzalloc(&client->dev, sizeof(*drvdata), GFP_KERNEL);
1456 if (!drvdata)
1457 return -ENOMEM;
1459 i2c_set_clientdata(client, drvdata);
1460 drvdata->client = client;
1461 drvdata->variant = variant;
1462 drvdata->pxtal = devm_clk_get(&client->dev, "xtal");
1463 drvdata->pclkin = devm_clk_get(&client->dev, "clkin");
1465 if (PTR_ERR(drvdata->pxtal) == -EPROBE_DEFER ||
1466 PTR_ERR(drvdata->pclkin) == -EPROBE_DEFER)
1467 return -EPROBE_DEFER;
1470 * Check for valid parent clock: VARIANT_A and VARIANT_B need XTAL,
1471 * VARIANT_C can have CLKIN instead.
1473 if (IS_ERR(drvdata->pxtal) &&
1474 (drvdata->variant != SI5351_VARIANT_C || IS_ERR(drvdata->pclkin))) {
1475 dev_err(&client->dev, "missing parent clock\n");
1476 return -EINVAL;
1479 drvdata->regmap = devm_regmap_init_i2c(client, &si5351_regmap_config);
1480 if (IS_ERR(drvdata->regmap)) {
1481 dev_err(&client->dev, "failed to allocate register map\n");
1482 return PTR_ERR(drvdata->regmap);
1485 /* Disable interrupts */
1486 si5351_reg_write(drvdata, SI5351_INTERRUPT_MASK, 0xf0);
1487 /* Ensure pll select is on XTAL for Si5351A/B */
1488 if (drvdata->variant != SI5351_VARIANT_C)
1489 si5351_set_bits(drvdata, SI5351_PLL_INPUT_SOURCE,
1490 SI5351_PLLA_SOURCE | SI5351_PLLB_SOURCE, 0);
1492 /* setup clock configuration */
1493 for (n = 0; n < 2; n++) {
1494 ret = _si5351_pll_reparent(drvdata, n, pdata->pll_src[n]);
1495 if (ret) {
1496 dev_err(&client->dev,
1497 "failed to reparent pll %d to %d\n",
1498 n, pdata->pll_src[n]);
1499 return ret;
1503 for (n = 0; n < 8; n++) {
1504 ret = _si5351_msynth_reparent(drvdata, n,
1505 pdata->clkout[n].multisynth_src);
1506 if (ret) {
1507 dev_err(&client->dev,
1508 "failed to reparent multisynth %d to %d\n",
1509 n, pdata->clkout[n].multisynth_src);
1510 return ret;
1513 ret = _si5351_clkout_reparent(drvdata, n,
1514 pdata->clkout[n].clkout_src);
1515 if (ret) {
1516 dev_err(&client->dev,
1517 "failed to reparent clkout %d to %d\n",
1518 n, pdata->clkout[n].clkout_src);
1519 return ret;
1522 ret = _si5351_clkout_set_drive_strength(drvdata, n,
1523 pdata->clkout[n].drive);
1524 if (ret) {
1525 dev_err(&client->dev,
1526 "failed set drive strength of clkout%d to %d\n",
1527 n, pdata->clkout[n].drive);
1528 return ret;
1531 ret = _si5351_clkout_set_disable_state(drvdata, n,
1532 pdata->clkout[n].disable_state);
1533 if (ret) {
1534 dev_err(&client->dev,
1535 "failed set disable state of clkout%d to %d\n",
1536 n, pdata->clkout[n].disable_state);
1537 return ret;
1541 /* register xtal input clock gate */
1542 memset(&init, 0, sizeof(init));
1543 init.name = si5351_input_names[0];
1544 init.ops = &si5351_xtal_ops;
1545 init.flags = 0;
1546 if (!IS_ERR(drvdata->pxtal)) {
1547 drvdata->pxtal_name = __clk_get_name(drvdata->pxtal);
1548 init.parent_names = &drvdata->pxtal_name;
1549 init.num_parents = 1;
1551 drvdata->xtal.init = &init;
1552 ret = devm_clk_hw_register(&client->dev, &drvdata->xtal);
1553 if (ret) {
1554 dev_err(&client->dev, "unable to register %s\n", init.name);
1555 return ret;
1558 /* register clkin input clock gate */
1559 if (drvdata->variant == SI5351_VARIANT_C) {
1560 memset(&init, 0, sizeof(init));
1561 init.name = si5351_input_names[1];
1562 init.ops = &si5351_clkin_ops;
1563 if (!IS_ERR(drvdata->pclkin)) {
1564 drvdata->pclkin_name = __clk_get_name(drvdata->pclkin);
1565 init.parent_names = &drvdata->pclkin_name;
1566 init.num_parents = 1;
1568 drvdata->clkin.init = &init;
1569 ret = devm_clk_hw_register(&client->dev, &drvdata->clkin);
1570 if (ret) {
1571 dev_err(&client->dev, "unable to register %s\n",
1572 init.name);
1573 return ret;
1577 /* Si5351C allows to mux either xtal or clkin to PLL input */
1578 num_parents = (drvdata->variant == SI5351_VARIANT_C) ? 2 : 1;
1579 parent_names[0] = si5351_input_names[0];
1580 parent_names[1] = si5351_input_names[1];
1582 /* register PLLA */
1583 drvdata->pll[0].num = 0;
1584 drvdata->pll[0].drvdata = drvdata;
1585 drvdata->pll[0].hw.init = &init;
1586 memset(&init, 0, sizeof(init));
1587 init.name = si5351_pll_names[0];
1588 init.ops = &si5351_pll_ops;
1589 init.flags = 0;
1590 init.parent_names = parent_names;
1591 init.num_parents = num_parents;
1592 ret = devm_clk_hw_register(&client->dev, &drvdata->pll[0].hw);
1593 if (ret) {
1594 dev_err(&client->dev, "unable to register %s\n", init.name);
1595 return ret;
1598 /* register PLLB or VXCO (Si5351B) */
1599 drvdata->pll[1].num = 1;
1600 drvdata->pll[1].drvdata = drvdata;
1601 drvdata->pll[1].hw.init = &init;
1602 memset(&init, 0, sizeof(init));
1603 if (drvdata->variant == SI5351_VARIANT_B) {
1604 init.name = si5351_pll_names[2];
1605 init.ops = &si5351_vxco_ops;
1606 init.flags = 0;
1607 init.parent_names = NULL;
1608 init.num_parents = 0;
1609 } else {
1610 init.name = si5351_pll_names[1];
1611 init.ops = &si5351_pll_ops;
1612 init.flags = 0;
1613 init.parent_names = parent_names;
1614 init.num_parents = num_parents;
1616 ret = devm_clk_hw_register(&client->dev, &drvdata->pll[1].hw);
1617 if (ret) {
1618 dev_err(&client->dev, "unable to register %s\n", init.name);
1619 return ret;
1622 /* register clk multisync and clk out divider */
1623 num_clocks = (drvdata->variant == SI5351_VARIANT_A3) ? 3 : 8;
1624 parent_names[0] = si5351_pll_names[0];
1625 if (drvdata->variant == SI5351_VARIANT_B)
1626 parent_names[1] = si5351_pll_names[2];
1627 else
1628 parent_names[1] = si5351_pll_names[1];
1630 drvdata->msynth = devm_kcalloc(&client->dev, num_clocks,
1631 sizeof(*drvdata->msynth), GFP_KERNEL);
1632 drvdata->clkout = devm_kcalloc(&client->dev, num_clocks,
1633 sizeof(*drvdata->clkout), GFP_KERNEL);
1634 drvdata->num_clkout = num_clocks;
1636 if (WARN_ON(!drvdata->msynth || !drvdata->clkout)) {
1637 ret = -ENOMEM;
1638 return ret;
1641 for (n = 0; n < num_clocks; n++) {
1642 drvdata->msynth[n].num = n;
1643 drvdata->msynth[n].drvdata = drvdata;
1644 drvdata->msynth[n].hw.init = &init;
1645 memset(&init, 0, sizeof(init));
1646 init.name = si5351_msynth_names[n];
1647 init.ops = &si5351_msynth_ops;
1648 init.flags = 0;
1649 if (pdata->clkout[n].pll_master)
1650 init.flags |= CLK_SET_RATE_PARENT;
1651 init.parent_names = parent_names;
1652 init.num_parents = 2;
1653 ret = devm_clk_hw_register(&client->dev,
1654 &drvdata->msynth[n].hw);
1655 if (ret) {
1656 dev_err(&client->dev, "unable to register %s\n",
1657 init.name);
1658 return ret;
1662 num_parents = (drvdata->variant == SI5351_VARIANT_C) ? 4 : 3;
1663 parent_names[2] = si5351_input_names[0];
1664 parent_names[3] = si5351_input_names[1];
1665 for (n = 0; n < num_clocks; n++) {
1666 parent_names[0] = si5351_msynth_names[n];
1667 parent_names[1] = (n < 4) ? si5351_msynth_names[0] :
1668 si5351_msynth_names[4];
1670 drvdata->clkout[n].num = n;
1671 drvdata->clkout[n].drvdata = drvdata;
1672 drvdata->clkout[n].hw.init = &init;
1673 memset(&init, 0, sizeof(init));
1674 init.name = si5351_clkout_names[n];
1675 init.ops = &si5351_clkout_ops;
1676 init.flags = 0;
1677 if (pdata->clkout[n].clkout_src == SI5351_CLKOUT_SRC_MSYNTH_N)
1678 init.flags |= CLK_SET_RATE_PARENT;
1679 init.parent_names = parent_names;
1680 init.num_parents = num_parents;
1681 ret = devm_clk_hw_register(&client->dev,
1682 &drvdata->clkout[n].hw);
1683 if (ret) {
1684 dev_err(&client->dev, "unable to register %s\n",
1685 init.name);
1686 return ret;
1689 /* set initial clkout rate */
1690 if (pdata->clkout[n].rate != 0) {
1691 int ret;
1692 ret = clk_set_rate(drvdata->clkout[n].hw.clk,
1693 pdata->clkout[n].rate);
1694 if (ret != 0) {
1695 dev_err(&client->dev, "Cannot set rate : %d\n",
1696 ret);
1701 ret = devm_of_clk_add_hw_provider(&client->dev, si53351_of_clk_get,
1702 drvdata);
1703 if (ret) {
1704 dev_err(&client->dev, "unable to add clk provider\n");
1705 return ret;
1708 return 0;
1711 static struct i2c_driver si5351_driver = {
1712 .driver = {
1713 .name = "si5351",
1714 .of_match_table = of_match_ptr(si5351_dt_ids),
1716 .probe = si5351_i2c_probe,
1717 .id_table = si5351_i2c_ids,
1719 module_i2c_driver(si5351_driver);
1721 MODULE_AUTHOR("Sebastian Hesselbarth <sebastian.hesselbarth@gmail.com");
1722 MODULE_DESCRIPTION("Silicon Labs Si5351A/B/C clock generator driver");
1723 MODULE_LICENSE("GPL");