1 // SPDX-License-Identifier: GPL-2.0 2 /* 3 * CS2000 -- CIRRUS LOGIC Fractional-N Clock Synthesizer & Clock Multiplier 4 * 5 * Copyright (C) 2015 Renesas Electronics Corporation 6 * Kuninori Morimoto <kuninori.morimoto.gx@renesas.com> 7 */ 8 #include <linux/clk-provider.h> 9 #include <linux/delay.h> 10 #include <linux/clk.h> 11 #include <linux/i2c.h> 12 #include <linux/of.h> 13 #include <linux/module.h> 14 #include <linux/regmap.h> 15 16 #define CH_MAX 4 17 #define RATIO_REG_SIZE 4 18 19 #define DEVICE_ID 0x1 20 #define DEVICE_CTRL 0x2 21 #define DEVICE_CFG1 0x3 22 #define DEVICE_CFG2 0x4 23 #define GLOBAL_CFG 0x5 24 #define Ratio_Add(x, nth) (6 + (x * 4) + (nth)) 25 #define Ratio_Val(x, nth) ((x >> (24 - (8 * nth))) & 0xFF) 26 #define Val_Ratio(x, nth) ((x & 0xFF) << (24 - (8 * nth))) 27 #define FUNC_CFG1 0x16 28 #define FUNC_CFG2 0x17 29 30 /* DEVICE_ID */ 31 #define REVISION_MASK (0x7) 32 #define REVISION_B2_B3 (0x4) 33 #define REVISION_C1 (0x6) 34 35 /* DEVICE_CTRL */ 36 #define PLL_UNLOCK (1 << 7) 37 #define AUXOUTDIS (1 << 1) 38 #define CLKOUTDIS (1 << 0) 39 40 /* DEVICE_CFG1 */ 41 #define RSEL(x) (((x) & 0x3) << 3) 42 #define RSEL_MASK RSEL(0x3) 43 #define AUXOUTSRC(x) (((x) & 0x3) << 1) 44 #define AUXOUTSRC_MASK AUXOUTSRC(0x3) 45 #define ENDEV1 (0x1) 46 47 /* DEVICE_CFG2 */ 48 #define AUTORMOD (1 << 3) 49 #define LOCKCLK(x) (((x) & 0x3) << 1) 50 #define LOCKCLK_MASK LOCKCLK(0x3) 51 #define FRACNSRC_MASK (1 << 0) 52 #define FRACNSRC_STATIC (0 << 0) 53 #define FRACNSRC_DYNAMIC (1 << 0) 54 55 /* GLOBAL_CFG */ 56 #define FREEZE (1 << 7) 57 #define ENDEV2 (0x1) 58 59 /* FUNC_CFG1 */ 60 #define CLKSKIPEN (1 << 7) 61 #define REFCLKDIV(x) (((x) & 0x3) << 3) 62 #define REFCLKDIV_MASK REFCLKDIV(0x3) 63 64 /* FUNC_CFG2 */ 65 #define LFRATIO_MASK (1 << 3) 66 #define LFRATIO_20_12 (0 << 3) 67 #define LFRATIO_12_20 (1 << 3) 68 69 #define CH_SIZE_ERR(ch) ((ch < 0) || (ch >= CH_MAX)) 70 #define hw_to_priv(_hw) container_of(_hw, struct cs2000_priv, hw) 71 #define priv_to_client(priv) (priv->client) 72 #define priv_to_dev(priv) (&(priv_to_client(priv)->dev)) 73 74 #define CLK_IN 0 75 #define REF_CLK 1 76 #define CLK_MAX 2 77 78 static bool cs2000_readable_reg(struct device *dev, unsigned int reg) 79 { 80 return reg > 0; 81 } 82 83 static bool cs2000_writeable_reg(struct device *dev, unsigned int reg) 84 { 85 return reg != DEVICE_ID; 86 } 87 88 static bool cs2000_volatile_reg(struct device *dev, unsigned int reg) 89 { 90 return reg == DEVICE_CTRL; 91 } 92 93 static const struct regmap_config cs2000_regmap_config = { 94 .reg_bits = 8, 95 .val_bits = 8, 96 .max_register = FUNC_CFG2, 97 .readable_reg = cs2000_readable_reg, 98 .writeable_reg = cs2000_writeable_reg, 99 .volatile_reg = cs2000_volatile_reg, 100 }; 101 102 struct cs2000_priv { 103 struct clk_hw hw; 104 struct i2c_client *client; 105 struct clk *clk_in; 106 struct clk *ref_clk; 107 struct regmap *regmap; 108 109 bool dynamic_mode; 110 bool lf_ratio; 111 bool clk_skip; 112 113 /* suspend/resume */ 114 unsigned long saved_rate; 115 unsigned long saved_parent_rate; 116 }; 117 118 static const struct of_device_id cs2000_of_match[] = { 119 { .compatible = "cirrus,cs2000-cp", }, 120 {}, 121 }; 122 MODULE_DEVICE_TABLE(of, cs2000_of_match); 123 124 static const struct i2c_device_id cs2000_id[] = { 125 { "cs2000-cp", }, 126 {} 127 }; 128 MODULE_DEVICE_TABLE(i2c, cs2000_id); 129 130 static int cs2000_enable_dev_config(struct cs2000_priv *priv, bool enable) 131 { 132 int ret; 133 134 ret = regmap_update_bits(priv->regmap, DEVICE_CFG1, ENDEV1, 135 enable ? ENDEV1 : 0); 136 if (ret < 0) 137 return ret; 138 139 ret = regmap_update_bits(priv->regmap, GLOBAL_CFG, ENDEV2, 140 enable ? ENDEV2 : 0); 141 if (ret < 0) 142 return ret; 143 144 ret = regmap_update_bits(priv->regmap, FUNC_CFG1, CLKSKIPEN, 145 (enable && priv->clk_skip) ? CLKSKIPEN : 0); 146 if (ret < 0) 147 return ret; 148 149 return 0; 150 } 151 152 static int cs2000_ref_clk_bound_rate(struct cs2000_priv *priv, 153 u32 rate_in) 154 { 155 u32 val; 156 157 if (rate_in >= 32000000 && rate_in < 56000000) 158 val = 0x0; 159 else if (rate_in >= 16000000 && rate_in < 28000000) 160 val = 0x1; 161 else if (rate_in >= 8000000 && rate_in < 14000000) 162 val = 0x2; 163 else 164 return -EINVAL; 165 166 return regmap_update_bits(priv->regmap, FUNC_CFG1, 167 REFCLKDIV_MASK, 168 REFCLKDIV(val)); 169 } 170 171 static int cs2000_wait_pll_lock(struct cs2000_priv *priv) 172 { 173 struct device *dev = priv_to_dev(priv); 174 unsigned int i, val; 175 int ret; 176 177 for (i = 0; i < 256; i++) { 178 ret = regmap_read(priv->regmap, DEVICE_CTRL, &val); 179 if (ret < 0) 180 return ret; 181 if (!(val & PLL_UNLOCK)) 182 return 0; 183 udelay(1); 184 } 185 186 dev_err(dev, "pll lock failed\n"); 187 188 return -ETIMEDOUT; 189 } 190 191 static int cs2000_clk_out_enable(struct cs2000_priv *priv, bool enable) 192 { 193 /* enable both AUX_OUT, CLK_OUT */ 194 return regmap_update_bits(priv->regmap, DEVICE_CTRL, 195 (AUXOUTDIS | CLKOUTDIS), 196 enable ? 0 : 197 (AUXOUTDIS | CLKOUTDIS)); 198 } 199 200 static u32 cs2000_rate_to_ratio(u32 rate_in, u32 rate_out, bool lf_ratio) 201 { 202 u64 ratio; 203 u32 multiplier = lf_ratio ? 12 : 20; 204 205 /* 206 * ratio = rate_out / rate_in * 2^multiplier 207 * 208 * To avoid over flow, rate_out is u64. 209 * The result should be u32. 210 */ 211 ratio = (u64)rate_out << multiplier; 212 do_div(ratio, rate_in); 213 214 return ratio; 215 } 216 217 static unsigned long cs2000_ratio_to_rate(u32 ratio, u32 rate_in, bool lf_ratio) 218 { 219 u64 rate_out; 220 u32 multiplier = lf_ratio ? 12 : 20; 221 222 /* 223 * ratio = rate_out / rate_in * 2^multiplier 224 * 225 * To avoid over flow, rate_out is u64. 226 * The result should be u32 or unsigned long. 227 */ 228 229 rate_out = (u64)ratio * rate_in; 230 return rate_out >> multiplier; 231 } 232 233 static int cs2000_ratio_set(struct cs2000_priv *priv, 234 int ch, u32 rate_in, u32 rate_out) 235 { 236 u32 val; 237 unsigned int i; 238 int ret; 239 240 if (CH_SIZE_ERR(ch)) 241 return -EINVAL; 242 243 val = cs2000_rate_to_ratio(rate_in, rate_out, priv->lf_ratio); 244 for (i = 0; i < RATIO_REG_SIZE; i++) { 245 ret = regmap_write(priv->regmap, 246 Ratio_Add(ch, i), 247 Ratio_Val(val, i)); 248 if (ret < 0) 249 return ret; 250 } 251 252 return 0; 253 } 254 255 static u32 cs2000_ratio_get(struct cs2000_priv *priv, int ch) 256 { 257 unsigned int tmp, i; 258 u32 val; 259 int ret; 260 261 val = 0; 262 for (i = 0; i < RATIO_REG_SIZE; i++) { 263 ret = regmap_read(priv->regmap, Ratio_Add(ch, i), &tmp); 264 if (ret < 0) 265 return 0; 266 267 val |= Val_Ratio(tmp, i); 268 } 269 270 return val; 271 } 272 273 static int cs2000_ratio_select(struct cs2000_priv *priv, int ch) 274 { 275 int ret; 276 u8 fracnsrc; 277 278 if (CH_SIZE_ERR(ch)) 279 return -EINVAL; 280 281 ret = regmap_update_bits(priv->regmap, DEVICE_CFG1, RSEL_MASK, RSEL(ch)); 282 if (ret < 0) 283 return ret; 284 285 fracnsrc = priv->dynamic_mode ? FRACNSRC_DYNAMIC : FRACNSRC_STATIC; 286 287 ret = regmap_update_bits(priv->regmap, DEVICE_CFG2, 288 AUTORMOD | LOCKCLK_MASK | FRACNSRC_MASK, 289 LOCKCLK(ch) | fracnsrc); 290 if (ret < 0) 291 return ret; 292 293 return 0; 294 } 295 296 static unsigned long cs2000_recalc_rate(struct clk_hw *hw, 297 unsigned long parent_rate) 298 { 299 struct cs2000_priv *priv = hw_to_priv(hw); 300 int ch = 0; /* it uses ch0 only at this point */ 301 u32 ratio; 302 303 ratio = cs2000_ratio_get(priv, ch); 304 305 return cs2000_ratio_to_rate(ratio, parent_rate, priv->lf_ratio); 306 } 307 308 static int cs2000_determine_rate(struct clk_hw *hw, 309 struct clk_rate_request *req) 310 { 311 struct cs2000_priv *priv = hw_to_priv(hw); 312 u32 ratio; 313 314 ratio = cs2000_rate_to_ratio(req->best_parent_rate, req->rate, 315 priv->lf_ratio); 316 317 req->rate = cs2000_ratio_to_rate(ratio, req->best_parent_rate, 318 priv->lf_ratio); 319 320 return 0; 321 } 322 323 static int cs2000_select_ratio_mode(struct cs2000_priv *priv, 324 unsigned long rate, 325 unsigned long parent_rate) 326 { 327 /* 328 * From the datasheet: 329 * 330 * | It is recommended that the 12.20 High-Resolution format be 331 * | utilized whenever the desired ratio is less than 4096 since 332 * | the output frequency accuracy of the PLL is directly proportional 333 * | to the accuracy of the timing reference clock and the resolution 334 * | of the R_UD. 335 * 336 * This mode is only available in dynamic mode. 337 */ 338 priv->lf_ratio = priv->dynamic_mode && ((rate / parent_rate) > 4096); 339 340 return regmap_update_bits(priv->regmap, FUNC_CFG2, LFRATIO_MASK, 341 priv->lf_ratio ? LFRATIO_20_12 : LFRATIO_12_20); 342 } 343 344 static int __cs2000_set_rate(struct cs2000_priv *priv, int ch, 345 unsigned long rate, unsigned long parent_rate) 346 347 { 348 int ret; 349 350 ret = regmap_update_bits(priv->regmap, GLOBAL_CFG, FREEZE, FREEZE); 351 if (ret < 0) 352 return ret; 353 354 ret = cs2000_select_ratio_mode(priv, rate, parent_rate); 355 if (ret < 0) 356 return ret; 357 358 ret = cs2000_ratio_set(priv, ch, parent_rate, rate); 359 if (ret < 0) 360 return ret; 361 362 ret = cs2000_ratio_select(priv, ch); 363 if (ret < 0) 364 return ret; 365 366 ret = regmap_update_bits(priv->regmap, GLOBAL_CFG, FREEZE, 0); 367 if (ret < 0) 368 return ret; 369 370 priv->saved_rate = rate; 371 priv->saved_parent_rate = parent_rate; 372 373 return 0; 374 } 375 376 static int cs2000_set_rate(struct clk_hw *hw, 377 unsigned long rate, unsigned long parent_rate) 378 { 379 struct cs2000_priv *priv = hw_to_priv(hw); 380 int ch = 0; /* it uses ch0 only at this point */ 381 382 return __cs2000_set_rate(priv, ch, rate, parent_rate); 383 } 384 385 static int cs2000_set_saved_rate(struct cs2000_priv *priv) 386 { 387 int ch = 0; /* it uses ch0 only at this point */ 388 389 return __cs2000_set_rate(priv, ch, 390 priv->saved_rate, 391 priv->saved_parent_rate); 392 } 393 394 static int cs2000_enable(struct clk_hw *hw) 395 { 396 struct cs2000_priv *priv = hw_to_priv(hw); 397 int ret; 398 399 ret = cs2000_enable_dev_config(priv, true); 400 if (ret < 0) 401 return ret; 402 403 ret = cs2000_clk_out_enable(priv, true); 404 if (ret < 0) 405 return ret; 406 407 ret = cs2000_wait_pll_lock(priv); 408 if (ret < 0) 409 return ret; 410 411 return ret; 412 } 413 414 static void cs2000_disable(struct clk_hw *hw) 415 { 416 struct cs2000_priv *priv = hw_to_priv(hw); 417 418 cs2000_enable_dev_config(priv, false); 419 420 cs2000_clk_out_enable(priv, false); 421 } 422 423 static u8 cs2000_get_parent(struct clk_hw *hw) 424 { 425 struct cs2000_priv *priv = hw_to_priv(hw); 426 427 /* 428 * In dynamic mode, output rates are derived from CLK_IN. 429 * In static mode, CLK_IN is ignored, so we return REF_CLK instead. 430 */ 431 return priv->dynamic_mode ? CLK_IN : REF_CLK; 432 } 433 434 static const struct clk_ops cs2000_ops = { 435 .get_parent = cs2000_get_parent, 436 .recalc_rate = cs2000_recalc_rate, 437 .determine_rate = cs2000_determine_rate, 438 .set_rate = cs2000_set_rate, 439 .prepare = cs2000_enable, 440 .unprepare = cs2000_disable, 441 }; 442 443 static int cs2000_clk_get(struct cs2000_priv *priv) 444 { 445 struct device *dev = priv_to_dev(priv); 446 struct clk *clk_in, *ref_clk; 447 448 clk_in = devm_clk_get(dev, "clk_in"); 449 /* not yet provided */ 450 if (IS_ERR(clk_in)) 451 return -EPROBE_DEFER; 452 453 ref_clk = devm_clk_get(dev, "ref_clk"); 454 /* not yet provided */ 455 if (IS_ERR(ref_clk)) 456 return -EPROBE_DEFER; 457 458 priv->clk_in = clk_in; 459 priv->ref_clk = ref_clk; 460 461 return 0; 462 } 463 464 static int cs2000_clk_register(struct cs2000_priv *priv) 465 { 466 struct device *dev = priv_to_dev(priv); 467 struct device_node *np = dev->of_node; 468 struct clk_init_data init; 469 const char *name = np->name; 470 static const char *parent_names[CLK_MAX]; 471 u32 aux_out = 0; 472 int ref_clk_rate; 473 int ch = 0; /* it uses ch0 only at this point */ 474 int ret; 475 476 of_property_read_string(np, "clock-output-names", &name); 477 478 priv->dynamic_mode = of_property_read_bool(np, "cirrus,dynamic-mode"); 479 dev_info(dev, "operating in %s mode\n", 480 priv->dynamic_mode ? "dynamic" : "static"); 481 482 of_property_read_u32(np, "cirrus,aux-output-source", &aux_out); 483 ret = regmap_update_bits(priv->regmap, DEVICE_CFG1, 484 AUXOUTSRC_MASK, AUXOUTSRC(aux_out)); 485 if (ret < 0) 486 return ret; 487 488 priv->clk_skip = of_property_read_bool(np, "cirrus,clock-skip"); 489 490 ref_clk_rate = clk_get_rate(priv->ref_clk); 491 ret = cs2000_ref_clk_bound_rate(priv, ref_clk_rate); 492 if (ret < 0) 493 return ret; 494 495 if (priv->dynamic_mode) { 496 /* Default to low-frequency mode to allow for large ratios */ 497 priv->lf_ratio = true; 498 } else { 499 /* 500 * set default rate as 1/1. 501 * otherwise .set_rate which setup ratio 502 * is never called if user requests 1/1 rate 503 */ 504 ret = __cs2000_set_rate(priv, ch, ref_clk_rate, ref_clk_rate); 505 if (ret < 0) 506 return ret; 507 } 508 509 parent_names[CLK_IN] = __clk_get_name(priv->clk_in); 510 parent_names[REF_CLK] = __clk_get_name(priv->ref_clk); 511 512 init.name = name; 513 init.ops = &cs2000_ops; 514 init.flags = CLK_SET_RATE_GATE; 515 init.parent_names = parent_names; 516 init.num_parents = ARRAY_SIZE(parent_names); 517 518 priv->hw.init = &init; 519 520 ret = clk_hw_register(dev, &priv->hw); 521 if (ret) 522 return ret; 523 524 ret = of_clk_add_hw_provider(np, of_clk_hw_simple_get, &priv->hw); 525 if (ret < 0) { 526 clk_hw_unregister(&priv->hw); 527 return ret; 528 } 529 530 return 0; 531 } 532 533 static int cs2000_version_print(struct cs2000_priv *priv) 534 { 535 struct device *dev = priv_to_dev(priv); 536 const char *revision; 537 unsigned int val; 538 int ret; 539 540 ret = regmap_read(priv->regmap, DEVICE_ID, &val); 541 if (ret < 0) 542 return ret; 543 544 /* CS2000 should be 0x0 */ 545 if (val >> 3) 546 return -EIO; 547 548 switch (val & REVISION_MASK) { 549 case REVISION_B2_B3: 550 revision = "B2 / B3"; 551 break; 552 case REVISION_C1: 553 revision = "C1"; 554 break; 555 default: 556 return -EIO; 557 } 558 559 dev_info(dev, "revision - %s\n", revision); 560 561 return 0; 562 } 563 564 static void cs2000_remove(struct i2c_client *client) 565 { 566 struct cs2000_priv *priv = i2c_get_clientdata(client); 567 struct device *dev = priv_to_dev(priv); 568 struct device_node *np = dev->of_node; 569 570 of_clk_del_provider(np); 571 572 clk_hw_unregister(&priv->hw); 573 } 574 575 static int cs2000_probe(struct i2c_client *client) 576 { 577 struct cs2000_priv *priv; 578 struct device *dev = &client->dev; 579 int ret; 580 581 priv = devm_kzalloc(dev, sizeof(*priv), GFP_KERNEL); 582 if (!priv) 583 return -ENOMEM; 584 585 priv->client = client; 586 i2c_set_clientdata(client, priv); 587 588 priv->regmap = devm_regmap_init_i2c(client, &cs2000_regmap_config); 589 if (IS_ERR(priv->regmap)) 590 return PTR_ERR(priv->regmap); 591 592 ret = cs2000_clk_get(priv); 593 if (ret < 0) 594 return ret; 595 596 ret = cs2000_clk_register(priv); 597 if (ret < 0) 598 return ret; 599 600 ret = cs2000_version_print(priv); 601 if (ret < 0) 602 goto probe_err; 603 604 return 0; 605 606 probe_err: 607 cs2000_remove(client); 608 609 return ret; 610 } 611 612 static int __maybe_unused cs2000_resume(struct device *dev) 613 { 614 struct cs2000_priv *priv = dev_get_drvdata(dev); 615 616 return cs2000_set_saved_rate(priv); 617 } 618 619 static const struct dev_pm_ops cs2000_pm_ops = { 620 SET_LATE_SYSTEM_SLEEP_PM_OPS(NULL, cs2000_resume) 621 }; 622 623 static struct i2c_driver cs2000_driver = { 624 .driver = { 625 .name = "cs2000-cp", 626 .pm = &cs2000_pm_ops, 627 .of_match_table = cs2000_of_match, 628 }, 629 .probe = cs2000_probe, 630 .remove = cs2000_remove, 631 .id_table = cs2000_id, 632 }; 633 634 module_i2c_driver(cs2000_driver); 635 636 MODULE_DESCRIPTION("CS2000-CP driver"); 637 MODULE_AUTHOR("Kuninori Morimoto <kuninori.morimoto.gx@renesas.com>"); 638 MODULE_LICENSE("GPL v2"); 639