1 // SPDX-License-Identifier: GPL-2.0 2 // 3 // FAN53555 Fairchild Digitally Programmable TinyBuck Regulator Driver. 4 // 5 // Supported Part Numbers: 6 // FAN53555UC00X/01X/03X/04X/05X 7 // 8 // Copyright (c) 2012 Marvell Technology Ltd. 9 // Yunfan Zhang <yfzhang@marvell.com> 10 11 #include <linux/module.h> 12 #include <linux/param.h> 13 #include <linux/err.h> 14 #include <linux/platform_device.h> 15 #include <linux/regulator/driver.h> 16 #include <linux/regulator/machine.h> 17 #include <linux/regulator/of_regulator.h> 18 #include <linux/of_device.h> 19 #include <linux/i2c.h> 20 #include <linux/slab.h> 21 #include <linux/regmap.h> 22 #include <linux/regulator/fan53555.h> 23 24 /* Voltage setting */ 25 #define FAN53555_VSEL0 0x00 26 #define FAN53555_VSEL1 0x01 27 28 #define TCS4525_VSEL0 0x11 29 #define TCS4525_VSEL1 0x10 30 #define TCS4525_TIME 0x13 31 #define TCS4525_COMMAND 0x14 32 33 /* Control register */ 34 #define FAN53555_CONTROL 0x02 35 /* IC Type */ 36 #define FAN53555_ID1 0x03 37 /* IC mask version */ 38 #define FAN53555_ID2 0x04 39 /* Monitor register */ 40 #define FAN53555_MONITOR 0x05 41 42 /* VSEL bit definitions */ 43 #define VSEL_BUCK_EN (1 << 7) 44 #define VSEL_MODE (1 << 6) 45 /* Chip ID and Verison */ 46 #define DIE_ID 0x0F /* ID1 */ 47 #define DIE_REV 0x0F /* ID2 */ 48 /* Control bit definitions */ 49 #define CTL_OUTPUT_DISCHG (1 << 7) 50 #define CTL_SLEW_MASK (0x7 << 4) 51 #define CTL_SLEW_SHIFT 4 52 #define CTL_RESET (1 << 2) 53 #define CTL_MODE_VSEL0_MODE BIT(0) 54 #define CTL_MODE_VSEL1_MODE BIT(1) 55 56 #define FAN53555_NVOLTAGES 64 /* Numbers of voltages */ 57 #define FAN53526_NVOLTAGES 128 58 59 #define TCS_VSEL0_MODE (1 << 7) 60 #define TCS_VSEL1_MODE (1 << 6) 61 62 #define TCS_SLEW_SHIFT 3 63 #define TCS_SLEW_MASK (0x3 < 3) 64 65 enum fan53555_vendor { 66 FAN53526_VENDOR_FAIRCHILD = 0, 67 FAN53555_VENDOR_FAIRCHILD, 68 FAN53555_VENDOR_SILERGY, 69 FAN53526_VENDOR_TCS, 70 }; 71 72 enum { 73 FAN53526_CHIP_ID_01 = 1, 74 }; 75 76 enum { 77 FAN53526_CHIP_REV_08 = 8, 78 }; 79 80 /* IC Type */ 81 enum { 82 FAN53555_CHIP_ID_00 = 0, 83 FAN53555_CHIP_ID_01, 84 FAN53555_CHIP_ID_02, 85 FAN53555_CHIP_ID_03, 86 FAN53555_CHIP_ID_04, 87 FAN53555_CHIP_ID_05, 88 FAN53555_CHIP_ID_08 = 8, 89 }; 90 91 enum { 92 TCS4525_CHIP_ID_12 = 12, 93 }; 94 95 enum { 96 TCS4526_CHIP_ID_00 = 0, 97 }; 98 99 /* IC mask revision */ 100 enum { 101 FAN53555_CHIP_REV_00 = 0x3, 102 FAN53555_CHIP_REV_13 = 0xf, 103 }; 104 105 enum { 106 SILERGY_SYR82X = 8, 107 SILERGY_SYR83X = 9, 108 }; 109 110 struct fan53555_device_info { 111 enum fan53555_vendor vendor; 112 struct device *dev; 113 struct regulator_desc desc; 114 struct regulator_init_data *regulator; 115 /* IC Type and Rev */ 116 int chip_id; 117 int chip_rev; 118 /* Voltage setting register */ 119 unsigned int vol_reg; 120 unsigned int sleep_reg; 121 /* Voltage range and step(linear) */ 122 unsigned int vsel_min; 123 unsigned int vsel_step; 124 unsigned int vsel_count; 125 /* Mode */ 126 unsigned int mode_reg; 127 unsigned int mode_mask; 128 /* Sleep voltage cache */ 129 unsigned int sleep_vol_cache; 130 /* Slew rate */ 131 unsigned int slew_reg; 132 unsigned int slew_mask; 133 const unsigned int *ramp_delay_table; 134 unsigned int n_ramp_values; 135 unsigned int slew_rate; 136 }; 137 138 static int fan53555_set_suspend_voltage(struct regulator_dev *rdev, int uV) 139 { 140 struct fan53555_device_info *di = rdev_get_drvdata(rdev); 141 int ret; 142 143 if (di->sleep_vol_cache == uV) 144 return 0; 145 ret = regulator_map_voltage_linear(rdev, uV, uV); 146 if (ret < 0) 147 return ret; 148 ret = regmap_update_bits(rdev->regmap, di->sleep_reg, 149 di->desc.vsel_mask, ret); 150 if (ret < 0) 151 return ret; 152 /* Cache the sleep voltage setting. 153 * Might not be the real voltage which is rounded */ 154 di->sleep_vol_cache = uV; 155 156 return 0; 157 } 158 159 static int fan53555_set_suspend_enable(struct regulator_dev *rdev) 160 { 161 struct fan53555_device_info *di = rdev_get_drvdata(rdev); 162 163 return regmap_update_bits(rdev->regmap, di->sleep_reg, 164 VSEL_BUCK_EN, VSEL_BUCK_EN); 165 } 166 167 static int fan53555_set_suspend_disable(struct regulator_dev *rdev) 168 { 169 struct fan53555_device_info *di = rdev_get_drvdata(rdev); 170 171 return regmap_update_bits(rdev->regmap, di->sleep_reg, 172 VSEL_BUCK_EN, 0); 173 } 174 175 static int fan53555_set_mode(struct regulator_dev *rdev, unsigned int mode) 176 { 177 struct fan53555_device_info *di = rdev_get_drvdata(rdev); 178 179 switch (mode) { 180 case REGULATOR_MODE_FAST: 181 regmap_update_bits(rdev->regmap, di->mode_reg, 182 di->mode_mask, di->mode_mask); 183 break; 184 case REGULATOR_MODE_NORMAL: 185 regmap_update_bits(rdev->regmap, di->vol_reg, di->mode_mask, 0); 186 break; 187 default: 188 return -EINVAL; 189 } 190 return 0; 191 } 192 193 static unsigned int fan53555_get_mode(struct regulator_dev *rdev) 194 { 195 struct fan53555_device_info *di = rdev_get_drvdata(rdev); 196 unsigned int val; 197 int ret = 0; 198 199 ret = regmap_read(rdev->regmap, di->mode_reg, &val); 200 if (ret < 0) 201 return ret; 202 if (val & di->mode_mask) 203 return REGULATOR_MODE_FAST; 204 else 205 return REGULATOR_MODE_NORMAL; 206 } 207 208 static const unsigned int slew_rates[] = { 209 64000, 210 32000, 211 16000, 212 8000, 213 4000, 214 2000, 215 1000, 216 500, 217 }; 218 219 static const unsigned int tcs_slew_rates[] = { 220 18700, 221 9300, 222 4600, 223 2300, 224 }; 225 226 static const struct regulator_ops fan53555_regulator_ops = { 227 .set_voltage_sel = regulator_set_voltage_sel_regmap, 228 .get_voltage_sel = regulator_get_voltage_sel_regmap, 229 .set_voltage_time_sel = regulator_set_voltage_time_sel, 230 .map_voltage = regulator_map_voltage_linear, 231 .list_voltage = regulator_list_voltage_linear, 232 .set_suspend_voltage = fan53555_set_suspend_voltage, 233 .enable = regulator_enable_regmap, 234 .disable = regulator_disable_regmap, 235 .is_enabled = regulator_is_enabled_regmap, 236 .set_mode = fan53555_set_mode, 237 .get_mode = fan53555_get_mode, 238 .set_ramp_delay = regulator_set_ramp_delay_regmap, 239 .set_suspend_enable = fan53555_set_suspend_enable, 240 .set_suspend_disable = fan53555_set_suspend_disable, 241 }; 242 243 static int fan53526_voltages_setup_fairchild(struct fan53555_device_info *di) 244 { 245 /* Init voltage range and step */ 246 switch (di->chip_id) { 247 case FAN53526_CHIP_ID_01: 248 switch (di->chip_rev) { 249 case FAN53526_CHIP_REV_08: 250 di->vsel_min = 600000; 251 di->vsel_step = 6250; 252 break; 253 default: 254 dev_err(di->dev, 255 "Chip ID %d with rev %d not supported!\n", 256 di->chip_id, di->chip_rev); 257 return -EINVAL; 258 } 259 break; 260 default: 261 dev_err(di->dev, 262 "Chip ID %d not supported!\n", di->chip_id); 263 return -EINVAL; 264 } 265 266 di->slew_reg = FAN53555_CONTROL; 267 di->slew_mask = CTL_SLEW_MASK; 268 di->ramp_delay_table = slew_rates; 269 di->n_ramp_values = ARRAY_SIZE(slew_rates); 270 di->vsel_count = FAN53526_NVOLTAGES; 271 272 return 0; 273 } 274 275 static int fan53555_voltages_setup_fairchild(struct fan53555_device_info *di) 276 { 277 /* Init voltage range and step */ 278 switch (di->chip_id) { 279 case FAN53555_CHIP_ID_00: 280 switch (di->chip_rev) { 281 case FAN53555_CHIP_REV_00: 282 di->vsel_min = 600000; 283 di->vsel_step = 10000; 284 break; 285 case FAN53555_CHIP_REV_13: 286 di->vsel_min = 800000; 287 di->vsel_step = 10000; 288 break; 289 default: 290 dev_err(di->dev, 291 "Chip ID %d with rev %d not supported!\n", 292 di->chip_id, di->chip_rev); 293 return -EINVAL; 294 } 295 break; 296 case FAN53555_CHIP_ID_01: 297 case FAN53555_CHIP_ID_03: 298 case FAN53555_CHIP_ID_05: 299 case FAN53555_CHIP_ID_08: 300 di->vsel_min = 600000; 301 di->vsel_step = 10000; 302 break; 303 case FAN53555_CHIP_ID_04: 304 di->vsel_min = 603000; 305 di->vsel_step = 12826; 306 break; 307 default: 308 dev_err(di->dev, 309 "Chip ID %d not supported!\n", di->chip_id); 310 return -EINVAL; 311 } 312 di->slew_reg = FAN53555_CONTROL; 313 di->slew_mask = CTL_SLEW_MASK; 314 di->ramp_delay_table = slew_rates; 315 di->n_ramp_values = ARRAY_SIZE(slew_rates); 316 di->vsel_count = FAN53555_NVOLTAGES; 317 318 return 0; 319 } 320 321 static int fan53555_voltages_setup_silergy(struct fan53555_device_info *di) 322 { 323 /* Init voltage range and step */ 324 switch (di->chip_id) { 325 case SILERGY_SYR82X: 326 case SILERGY_SYR83X: 327 di->vsel_min = 712500; 328 di->vsel_step = 12500; 329 break; 330 default: 331 dev_err(di->dev, 332 "Chip ID %d not supported!\n", di->chip_id); 333 return -EINVAL; 334 } 335 di->slew_reg = FAN53555_CONTROL; 336 di->slew_mask = CTL_SLEW_MASK; 337 di->ramp_delay_table = slew_rates; 338 di->n_ramp_values = ARRAY_SIZE(slew_rates); 339 di->vsel_count = FAN53555_NVOLTAGES; 340 341 return 0; 342 } 343 344 static int fan53526_voltages_setup_tcs(struct fan53555_device_info *di) 345 { 346 switch (di->chip_id) { 347 case TCS4525_CHIP_ID_12: 348 case TCS4526_CHIP_ID_00: 349 di->slew_reg = TCS4525_TIME; 350 di->slew_mask = TCS_SLEW_MASK; 351 di->ramp_delay_table = tcs_slew_rates; 352 di->n_ramp_values = ARRAY_SIZE(tcs_slew_rates); 353 354 /* Init voltage range and step */ 355 di->vsel_min = 600000; 356 di->vsel_step = 6250; 357 di->vsel_count = FAN53526_NVOLTAGES; 358 break; 359 default: 360 dev_err(di->dev, "Chip ID %d not supported!\n", di->chip_id); 361 return -EINVAL; 362 } 363 364 return 0; 365 } 366 367 /* For 00,01,03,05 options: 368 * VOUT = 0.60V + NSELx * 10mV, from 0.60 to 1.23V. 369 * For 04 option: 370 * VOUT = 0.603V + NSELx * 12.826mV, from 0.603 to 1.411V. 371 * */ 372 static int fan53555_device_setup(struct fan53555_device_info *di, 373 struct fan53555_platform_data *pdata) 374 { 375 int ret = 0; 376 377 /* Setup voltage control register */ 378 switch (di->vendor) { 379 case FAN53526_VENDOR_FAIRCHILD: 380 case FAN53555_VENDOR_FAIRCHILD: 381 case FAN53555_VENDOR_SILERGY: 382 switch (pdata->sleep_vsel_id) { 383 case FAN53555_VSEL_ID_0: 384 di->sleep_reg = FAN53555_VSEL0; 385 di->vol_reg = FAN53555_VSEL1; 386 break; 387 case FAN53555_VSEL_ID_1: 388 di->sleep_reg = FAN53555_VSEL1; 389 di->vol_reg = FAN53555_VSEL0; 390 break; 391 default: 392 dev_err(di->dev, "Invalid VSEL ID!\n"); 393 return -EINVAL; 394 } 395 break; 396 case FAN53526_VENDOR_TCS: 397 switch (pdata->sleep_vsel_id) { 398 case FAN53555_VSEL_ID_0: 399 di->sleep_reg = TCS4525_VSEL0; 400 di->vol_reg = TCS4525_VSEL1; 401 break; 402 case FAN53555_VSEL_ID_1: 403 di->sleep_reg = TCS4525_VSEL1; 404 di->vol_reg = TCS4525_VSEL0; 405 break; 406 default: 407 dev_err(di->dev, "Invalid VSEL ID!\n"); 408 return -EINVAL; 409 } 410 break; 411 default: 412 dev_err(di->dev, "vendor %d not supported!\n", di->vendor); 413 return -EINVAL; 414 } 415 416 /* Setup mode control register */ 417 switch (di->vendor) { 418 case FAN53526_VENDOR_FAIRCHILD: 419 di->mode_reg = FAN53555_CONTROL; 420 421 switch (pdata->sleep_vsel_id) { 422 case FAN53555_VSEL_ID_0: 423 di->mode_mask = CTL_MODE_VSEL1_MODE; 424 break; 425 case FAN53555_VSEL_ID_1: 426 di->mode_mask = CTL_MODE_VSEL0_MODE; 427 break; 428 } 429 break; 430 case FAN53555_VENDOR_FAIRCHILD: 431 case FAN53555_VENDOR_SILERGY: 432 di->mode_reg = di->vol_reg; 433 di->mode_mask = VSEL_MODE; 434 break; 435 case FAN53526_VENDOR_TCS: 436 di->mode_reg = TCS4525_COMMAND; 437 438 switch (pdata->sleep_vsel_id) { 439 case FAN53555_VSEL_ID_0: 440 di->mode_mask = TCS_VSEL1_MODE; 441 break; 442 case FAN53555_VSEL_ID_1: 443 di->mode_mask = TCS_VSEL0_MODE; 444 break; 445 } 446 break; 447 default: 448 dev_err(di->dev, "vendor %d not supported!\n", di->vendor); 449 return -EINVAL; 450 } 451 452 /* Setup voltage range */ 453 switch (di->vendor) { 454 case FAN53526_VENDOR_FAIRCHILD: 455 ret = fan53526_voltages_setup_fairchild(di); 456 break; 457 case FAN53555_VENDOR_FAIRCHILD: 458 ret = fan53555_voltages_setup_fairchild(di); 459 break; 460 case FAN53555_VENDOR_SILERGY: 461 ret = fan53555_voltages_setup_silergy(di); 462 break; 463 case FAN53526_VENDOR_TCS: 464 ret = fan53526_voltages_setup_tcs(di); 465 break; 466 default: 467 dev_err(di->dev, "vendor %d not supported!\n", di->vendor); 468 return -EINVAL; 469 } 470 471 return ret; 472 } 473 474 static int fan53555_regulator_register(struct fan53555_device_info *di, 475 struct regulator_config *config) 476 { 477 struct regulator_desc *rdesc = &di->desc; 478 struct regulator_dev *rdev; 479 480 rdesc->name = "fan53555-reg"; 481 rdesc->supply_name = "vin"; 482 rdesc->ops = &fan53555_regulator_ops; 483 rdesc->type = REGULATOR_VOLTAGE; 484 rdesc->n_voltages = di->vsel_count; 485 rdesc->enable_reg = di->vol_reg; 486 rdesc->enable_mask = VSEL_BUCK_EN; 487 rdesc->min_uV = di->vsel_min; 488 rdesc->uV_step = di->vsel_step; 489 rdesc->vsel_reg = di->vol_reg; 490 rdesc->vsel_mask = di->vsel_count - 1; 491 rdesc->ramp_reg = di->slew_reg; 492 rdesc->ramp_mask = di->slew_mask; 493 rdesc->ramp_delay_table = di->ramp_delay_table; 494 rdesc->n_ramp_values = di->n_ramp_values; 495 rdesc->owner = THIS_MODULE; 496 497 rdev = devm_regulator_register(di->dev, &di->desc, config); 498 return PTR_ERR_OR_ZERO(rdev); 499 } 500 501 static const struct regmap_config fan53555_regmap_config = { 502 .reg_bits = 8, 503 .val_bits = 8, 504 }; 505 506 static struct fan53555_platform_data *fan53555_parse_dt(struct device *dev, 507 struct device_node *np, 508 const struct regulator_desc *desc) 509 { 510 struct fan53555_platform_data *pdata; 511 int ret; 512 u32 tmp; 513 514 pdata = devm_kzalloc(dev, sizeof(*pdata), GFP_KERNEL); 515 if (!pdata) 516 return NULL; 517 518 pdata->regulator = of_get_regulator_init_data(dev, np, desc); 519 520 ret = of_property_read_u32(np, "fcs,suspend-voltage-selector", 521 &tmp); 522 if (!ret) 523 pdata->sleep_vsel_id = tmp; 524 525 return pdata; 526 } 527 528 static const struct of_device_id __maybe_unused fan53555_dt_ids[] = { 529 { 530 .compatible = "fcs,fan53526", 531 .data = (void *)FAN53526_VENDOR_FAIRCHILD, 532 }, { 533 .compatible = "fcs,fan53555", 534 .data = (void *)FAN53555_VENDOR_FAIRCHILD 535 }, { 536 .compatible = "silergy,syr827", 537 .data = (void *)FAN53555_VENDOR_SILERGY, 538 }, { 539 .compatible = "silergy,syr828", 540 .data = (void *)FAN53555_VENDOR_SILERGY, 541 }, { 542 .compatible = "tcs,tcs4525", 543 .data = (void *)FAN53526_VENDOR_TCS 544 }, { 545 .compatible = "tcs,tcs4526", 546 .data = (void *)FAN53526_VENDOR_TCS 547 }, 548 { } 549 }; 550 MODULE_DEVICE_TABLE(of, fan53555_dt_ids); 551 552 static int fan53555_regulator_probe(struct i2c_client *client) 553 { 554 const struct i2c_device_id *id = i2c_client_get_device_id(client); 555 struct device_node *np = client->dev.of_node; 556 struct fan53555_device_info *di; 557 struct fan53555_platform_data *pdata; 558 struct regulator_config config = { }; 559 struct regmap *regmap; 560 unsigned int val; 561 int ret; 562 563 di = devm_kzalloc(&client->dev, sizeof(struct fan53555_device_info), 564 GFP_KERNEL); 565 if (!di) 566 return -ENOMEM; 567 568 pdata = dev_get_platdata(&client->dev); 569 if (!pdata) 570 pdata = fan53555_parse_dt(&client->dev, np, &di->desc); 571 572 if (!pdata || !pdata->regulator) { 573 dev_err(&client->dev, "Platform data not found!\n"); 574 return -ENODEV; 575 } 576 577 di->regulator = pdata->regulator; 578 if (client->dev.of_node) { 579 di->vendor = 580 (unsigned long)of_device_get_match_data(&client->dev); 581 } else { 582 /* if no ramp constraint set, get the pdata ramp_delay */ 583 if (!di->regulator->constraints.ramp_delay) { 584 if (pdata->slew_rate >= ARRAY_SIZE(slew_rates)) { 585 dev_err(&client->dev, "Invalid slew_rate\n"); 586 return -EINVAL; 587 } 588 589 di->regulator->constraints.ramp_delay 590 = slew_rates[pdata->slew_rate]; 591 } 592 593 di->vendor = id->driver_data; 594 } 595 596 regmap = devm_regmap_init_i2c(client, &fan53555_regmap_config); 597 if (IS_ERR(regmap)) { 598 dev_err(&client->dev, "Failed to allocate regmap!\n"); 599 return PTR_ERR(regmap); 600 } 601 di->dev = &client->dev; 602 i2c_set_clientdata(client, di); 603 /* Get chip ID */ 604 ret = regmap_read(regmap, FAN53555_ID1, &val); 605 if (ret < 0) { 606 dev_err(&client->dev, "Failed to get chip ID!\n"); 607 return ret; 608 } 609 di->chip_id = val & DIE_ID; 610 /* Get chip revision */ 611 ret = regmap_read(regmap, FAN53555_ID2, &val); 612 if (ret < 0) { 613 dev_err(&client->dev, "Failed to get chip Rev!\n"); 614 return ret; 615 } 616 di->chip_rev = val & DIE_REV; 617 dev_info(&client->dev, "FAN53555 Option[%d] Rev[%d] Detected!\n", 618 di->chip_id, di->chip_rev); 619 /* Device init */ 620 ret = fan53555_device_setup(di, pdata); 621 if (ret < 0) { 622 dev_err(&client->dev, "Failed to setup device!\n"); 623 return ret; 624 } 625 /* Register regulator */ 626 config.dev = di->dev; 627 config.init_data = di->regulator; 628 config.regmap = regmap; 629 config.driver_data = di; 630 config.of_node = np; 631 632 ret = fan53555_regulator_register(di, &config); 633 if (ret < 0) 634 dev_err(&client->dev, "Failed to register regulator!\n"); 635 return ret; 636 637 } 638 639 static const struct i2c_device_id fan53555_id[] = { 640 { 641 .name = "fan53526", 642 .driver_data = FAN53526_VENDOR_FAIRCHILD 643 }, { 644 .name = "fan53555", 645 .driver_data = FAN53555_VENDOR_FAIRCHILD 646 }, { 647 .name = "syr827", 648 .driver_data = FAN53555_VENDOR_SILERGY 649 }, { 650 .name = "syr828", 651 .driver_data = FAN53555_VENDOR_SILERGY 652 }, { 653 .name = "tcs4525", 654 .driver_data = FAN53526_VENDOR_TCS 655 }, { 656 .name = "tcs4526", 657 .driver_data = FAN53526_VENDOR_TCS 658 }, 659 { }, 660 }; 661 MODULE_DEVICE_TABLE(i2c, fan53555_id); 662 663 static struct i2c_driver fan53555_regulator_driver = { 664 .driver = { 665 .name = "fan53555-regulator", 666 .of_match_table = of_match_ptr(fan53555_dt_ids), 667 }, 668 .probe_new = fan53555_regulator_probe, 669 .id_table = fan53555_id, 670 }; 671 672 module_i2c_driver(fan53555_regulator_driver); 673 674 MODULE_AUTHOR("Yunfan Zhang <yfzhang@marvell.com>"); 675 MODULE_DESCRIPTION("FAN53555 regulator driver"); 676 MODULE_LICENSE("GPL v2"); 677