1 // SPDX-License-Identifier: GPL-2.0-only 2 /* 3 * Regulator driver for tps65090 power management chip. 4 * 5 * Copyright (c) 2012, NVIDIA CORPORATION. All rights reserved. 6 7 */ 8 9 #include <linux/module.h> 10 #include <linux/delay.h> 11 #include <linux/init.h> 12 #include <linux/of.h> 13 #include <linux/gpio/consumer.h> 14 #include <linux/slab.h> 15 #include <linux/err.h> 16 #include <linux/platform_device.h> 17 #include <linux/regulator/driver.h> 18 #include <linux/regulator/machine.h> 19 #include <linux/regulator/of_regulator.h> 20 #include <linux/mfd/tps65090.h> 21 22 #define MAX_CTRL_READ_TRIES 5 23 #define MAX_FET_ENABLE_TRIES 1000 24 25 #define CTRL_EN_BIT 0 /* Regulator enable bit, active high */ 26 #define CTRL_WT_BIT 2 /* Regulator wait time 0 bit */ 27 #define CTRL_PG_BIT 4 /* Regulator power good bit, 1=good */ 28 #define CTRL_TO_BIT 7 /* Regulator timeout bit, 1=wait */ 29 30 #define MAX_OVERCURRENT_WAIT 3 /* Overcurrent wait must be <= this */ 31 32 /** 33 * struct tps65090_regulator - Per-regulator data for a tps65090 regulator 34 * 35 * @dev: Pointer to our device. 36 * @desc: The struct regulator_desc for the regulator. 37 * @rdev: The struct regulator_dev for the regulator. 38 * @overcurrent_wait_valid: True if overcurrent_wait is valid. 39 * @overcurrent_wait: For FETs, the value to put in the WTFET bitfield. 40 */ 41 42 struct tps65090_regulator { 43 struct device *dev; 44 struct regulator_desc *desc; 45 struct regulator_dev *rdev; 46 bool overcurrent_wait_valid; 47 int overcurrent_wait; 48 }; 49 50 static struct regulator_ops tps65090_ext_control_ops = { 51 }; 52 53 /** 54 * tps65090_reg_set_overcurrent_wait - Setup overcurrent wait 55 * 56 * This will set the overcurrent wait time based on what's in the regulator 57 * info. 58 * 59 * @ri: Overall regulator data 60 * @rdev: Regulator device 61 * 62 * Return: 0 if no error, non-zero if there was an error writing the register. 63 */ 64 static int tps65090_reg_set_overcurrent_wait(struct tps65090_regulator *ri, 65 struct regulator_dev *rdev) 66 { 67 int ret; 68 69 ret = regmap_update_bits(rdev->regmap, rdev->desc->enable_reg, 70 MAX_OVERCURRENT_WAIT << CTRL_WT_BIT, 71 ri->overcurrent_wait << CTRL_WT_BIT); 72 if (ret) { 73 dev_err(&rdev->dev, "Error updating overcurrent wait %#x\n", 74 rdev->desc->enable_reg); 75 } 76 77 return ret; 78 } 79 80 /** 81 * tps65090_try_enable_fet - Try to enable a FET 82 * 83 * @rdev: Regulator device 84 * 85 * Return: 0 if ok, -ENOTRECOVERABLE if the FET power good bit did not get 86 * set, or some other -ve value if another error occurred (e.g. i2c error) 87 */ 88 static int tps65090_try_enable_fet(struct regulator_dev *rdev) 89 { 90 unsigned int control; 91 int ret, i; 92 93 ret = regmap_update_bits(rdev->regmap, rdev->desc->enable_reg, 94 rdev->desc->enable_mask, 95 rdev->desc->enable_mask); 96 if (ret < 0) { 97 dev_err(&rdev->dev, "Error in updating reg %#x\n", 98 rdev->desc->enable_reg); 99 return ret; 100 } 101 102 for (i = 0; i < MAX_CTRL_READ_TRIES; i++) { 103 ret = regmap_read(rdev->regmap, rdev->desc->enable_reg, 104 &control); 105 if (ret < 0) 106 return ret; 107 108 if (!(control & BIT(CTRL_TO_BIT))) 109 break; 110 111 usleep_range(1000, 1500); 112 } 113 if (!(control & BIT(CTRL_PG_BIT))) 114 return -ENOTRECOVERABLE; 115 116 return 0; 117 } 118 119 /** 120 * tps65090_fet_enable - Enable a FET, trying a few times if it fails 121 * 122 * Some versions of the tps65090 have issues when turning on the FETs. 123 * This function goes through several steps to ensure the best chance of the 124 * FET going on. Specifically: 125 * - We'll make sure that we bump the "overcurrent wait" to the maximum, which 126 * increases the chances that we'll turn on properly. 127 * - We'll retry turning the FET on multiple times (turning off in between). 128 * 129 * @rdev: Regulator device 130 * 131 * Return: 0 if ok, non-zero if it fails. 132 */ 133 static int tps65090_fet_enable(struct regulator_dev *rdev) 134 { 135 int ret, tries; 136 137 /* 138 * Try enabling multiple times until we succeed since sometimes the 139 * first try times out. 140 */ 141 tries = 0; 142 while (true) { 143 ret = tps65090_try_enable_fet(rdev); 144 if (!ret) 145 break; 146 if (ret != -ENOTRECOVERABLE || tries == MAX_FET_ENABLE_TRIES) 147 goto err; 148 149 /* Try turning the FET off (and then on again) */ 150 ret = regmap_update_bits(rdev->regmap, rdev->desc->enable_reg, 151 rdev->desc->enable_mask, 0); 152 if (ret) 153 goto err; 154 155 tries++; 156 } 157 158 if (tries) 159 dev_warn(&rdev->dev, "reg %#x enable ok after %d tries\n", 160 rdev->desc->enable_reg, tries); 161 162 return 0; 163 err: 164 dev_warn(&rdev->dev, "reg %#x enable failed\n", rdev->desc->enable_reg); 165 WARN_ON(1); 166 167 return ret; 168 } 169 170 static struct regulator_ops tps65090_reg_control_ops = { 171 .enable = regulator_enable_regmap, 172 .disable = regulator_disable_regmap, 173 .is_enabled = regulator_is_enabled_regmap, 174 }; 175 176 static struct regulator_ops tps65090_fet_control_ops = { 177 .enable = tps65090_fet_enable, 178 .disable = regulator_disable_regmap, 179 .is_enabled = regulator_is_enabled_regmap, 180 }; 181 182 static struct regulator_ops tps65090_ldo_ops = { 183 }; 184 185 #define tps65090_REG_DESC(_id, _sname, _en_reg, _en_bits, _nvolt, _volt, _ops) \ 186 { \ 187 .name = "TPS65090_RAILS"#_id, \ 188 .supply_name = _sname, \ 189 .id = TPS65090_REGULATOR_##_id, \ 190 .n_voltages = _nvolt, \ 191 .ops = &_ops, \ 192 .fixed_uV = _volt, \ 193 .enable_reg = _en_reg, \ 194 .enable_val = _en_bits, \ 195 .enable_mask = _en_bits, \ 196 .type = REGULATOR_VOLTAGE, \ 197 .owner = THIS_MODULE, \ 198 } 199 200 #define tps65090_REG_FIXEDV(_id, _sname, en_reg, _en_bits, _volt, _ops) \ 201 tps65090_REG_DESC(_id, _sname, en_reg, _en_bits, 1, _volt, _ops) 202 203 #define tps65090_REG_SWITCH(_id, _sname, en_reg, _en_bits, _ops) \ 204 tps65090_REG_DESC(_id, _sname, en_reg, _en_bits, 0, 0, _ops) 205 206 static struct regulator_desc tps65090_regulator_desc[] = { 207 tps65090_REG_FIXEDV(DCDC1, "vsys1", 0x0C, BIT(CTRL_EN_BIT), 5000000, 208 tps65090_reg_control_ops), 209 tps65090_REG_FIXEDV(DCDC2, "vsys2", 0x0D, BIT(CTRL_EN_BIT), 3300000, 210 tps65090_reg_control_ops), 211 tps65090_REG_SWITCH(DCDC3, "vsys3", 0x0E, BIT(CTRL_EN_BIT), 212 tps65090_reg_control_ops), 213 214 tps65090_REG_SWITCH(FET1, "infet1", 0x0F, 215 BIT(CTRL_EN_BIT) | BIT(CTRL_PG_BIT), 216 tps65090_fet_control_ops), 217 tps65090_REG_SWITCH(FET2, "infet2", 0x10, 218 BIT(CTRL_EN_BIT) | BIT(CTRL_PG_BIT), 219 tps65090_fet_control_ops), 220 tps65090_REG_SWITCH(FET3, "infet3", 0x11, 221 BIT(CTRL_EN_BIT) | BIT(CTRL_PG_BIT), 222 tps65090_fet_control_ops), 223 tps65090_REG_SWITCH(FET4, "infet4", 0x12, 224 BIT(CTRL_EN_BIT) | BIT(CTRL_PG_BIT), 225 tps65090_fet_control_ops), 226 tps65090_REG_SWITCH(FET5, "infet5", 0x13, 227 BIT(CTRL_EN_BIT) | BIT(CTRL_PG_BIT), 228 tps65090_fet_control_ops), 229 tps65090_REG_SWITCH(FET6, "infet6", 0x14, 230 BIT(CTRL_EN_BIT) | BIT(CTRL_PG_BIT), 231 tps65090_fet_control_ops), 232 tps65090_REG_SWITCH(FET7, "infet7", 0x15, 233 BIT(CTRL_EN_BIT) | BIT(CTRL_PG_BIT), 234 tps65090_fet_control_ops), 235 236 tps65090_REG_FIXEDV(LDO1, "vsys-l1", 0, 0, 5000000, 237 tps65090_ldo_ops), 238 tps65090_REG_FIXEDV(LDO2, "vsys-l2", 0, 0, 3300000, 239 tps65090_ldo_ops), 240 }; 241 242 static inline bool is_dcdc(int id) 243 { 244 switch (id) { 245 case TPS65090_REGULATOR_DCDC1: 246 case TPS65090_REGULATOR_DCDC2: 247 case TPS65090_REGULATOR_DCDC3: 248 return true; 249 default: 250 return false; 251 } 252 } 253 254 static int tps65090_config_ext_control( 255 struct tps65090_regulator *ri, bool enable) 256 { 257 int ret; 258 struct device *parent = ri->dev->parent; 259 unsigned int reg_en_reg = ri->desc->enable_reg; 260 261 if (enable) 262 ret = tps65090_set_bits(parent, reg_en_reg, 1); 263 else 264 ret = tps65090_clr_bits(parent, reg_en_reg, 1); 265 if (ret < 0) 266 dev_err(ri->dev, "Error in updating reg 0x%x\n", reg_en_reg); 267 return ret; 268 } 269 270 static int tps65090_regulator_disable_ext_control( 271 struct tps65090_regulator *ri, 272 struct tps65090_regulator_plat_data *tps_pdata) 273 { 274 int ret = 0; 275 struct device *parent = ri->dev->parent; 276 unsigned int reg_en_reg = ri->desc->enable_reg; 277 278 /* 279 * First enable output for internal control if require. 280 * And then disable external control. 281 */ 282 if (tps_pdata->reg_init_data->constraints.always_on || 283 tps_pdata->reg_init_data->constraints.boot_on) { 284 ret = tps65090_set_bits(parent, reg_en_reg, 0); 285 if (ret < 0) { 286 dev_err(ri->dev, "Error in set reg 0x%x\n", reg_en_reg); 287 return ret; 288 } 289 } 290 return tps65090_config_ext_control(ri, false); 291 } 292 293 #ifdef CONFIG_OF 294 static struct of_regulator_match tps65090_matches[] = { 295 { .name = "dcdc1", }, 296 { .name = "dcdc2", }, 297 { .name = "dcdc3", }, 298 { .name = "fet1", }, 299 { .name = "fet2", }, 300 { .name = "fet3", }, 301 { .name = "fet4", }, 302 { .name = "fet5", }, 303 { .name = "fet6", }, 304 { .name = "fet7", }, 305 { .name = "ldo1", }, 306 { .name = "ldo2", }, 307 }; 308 309 static struct tps65090_platform_data *tps65090_parse_dt_reg_data( 310 struct platform_device *pdev, 311 struct of_regulator_match **tps65090_reg_matches) 312 { 313 struct tps65090_platform_data *tps65090_pdata; 314 struct device_node *np = pdev->dev.parent->of_node; 315 struct device_node *regulators; 316 int idx = 0, ret; 317 struct tps65090_regulator_plat_data *reg_pdata; 318 319 tps65090_pdata = devm_kzalloc(&pdev->dev, sizeof(*tps65090_pdata), 320 GFP_KERNEL); 321 if (!tps65090_pdata) 322 return ERR_PTR(-ENOMEM); 323 324 reg_pdata = devm_kcalloc(&pdev->dev, 325 TPS65090_REGULATOR_MAX, sizeof(*reg_pdata), 326 GFP_KERNEL); 327 if (!reg_pdata) 328 return ERR_PTR(-ENOMEM); 329 330 regulators = of_get_child_by_name(np, "regulators"); 331 if (!regulators) { 332 dev_err(&pdev->dev, "regulator node not found\n"); 333 return ERR_PTR(-ENODEV); 334 } 335 336 ret = of_regulator_match(&pdev->dev, regulators, tps65090_matches, 337 ARRAY_SIZE(tps65090_matches)); 338 of_node_put(regulators); 339 if (ret < 0) { 340 dev_err(&pdev->dev, 341 "Error parsing regulator init data: %d\n", ret); 342 return ERR_PTR(ret); 343 } 344 345 *tps65090_reg_matches = tps65090_matches; 346 for (idx = 0; idx < ARRAY_SIZE(tps65090_matches); idx++) { 347 struct regulator_init_data *ri_data; 348 struct tps65090_regulator_plat_data *rpdata; 349 350 rpdata = ®_pdata[idx]; 351 ri_data = tps65090_matches[idx].init_data; 352 if (!ri_data || !tps65090_matches[idx].of_node) 353 continue; 354 355 rpdata->reg_init_data = ri_data; 356 rpdata->enable_ext_control = of_property_read_bool( 357 tps65090_matches[idx].of_node, 358 "ti,enable-ext-control"); 359 if (rpdata->enable_ext_control) { 360 enum gpiod_flags gflags; 361 362 if (ri_data->constraints.always_on || 363 ri_data->constraints.boot_on) 364 gflags = GPIOD_OUT_HIGH; 365 else 366 gflags = GPIOD_OUT_LOW; 367 gflags |= GPIOD_FLAGS_BIT_NONEXCLUSIVE; 368 369 rpdata->gpiod = devm_gpiod_get_from_of_node(&pdev->dev, 370 tps65090_matches[idx].of_node, 371 "dcdc-ext-control-gpios", 0, 372 gflags, 373 "tps65090"); 374 if (PTR_ERR(rpdata->gpiod) == -ENOENT) { 375 dev_err(&pdev->dev, 376 "could not find DCDC external control GPIO\n"); 377 rpdata->gpiod = NULL; 378 } else if (IS_ERR(rpdata->gpiod)) 379 return ERR_CAST(rpdata->gpiod); 380 } 381 382 if (of_property_read_u32(tps65090_matches[idx].of_node, 383 "ti,overcurrent-wait", 384 &rpdata->overcurrent_wait) == 0) 385 rpdata->overcurrent_wait_valid = true; 386 387 tps65090_pdata->reg_pdata[idx] = rpdata; 388 } 389 return tps65090_pdata; 390 } 391 #else 392 static inline struct tps65090_platform_data *tps65090_parse_dt_reg_data( 393 struct platform_device *pdev, 394 struct of_regulator_match **tps65090_reg_matches) 395 { 396 *tps65090_reg_matches = NULL; 397 return NULL; 398 } 399 #endif 400 401 static int tps65090_regulator_probe(struct platform_device *pdev) 402 { 403 struct tps65090 *tps65090_mfd = dev_get_drvdata(pdev->dev.parent); 404 struct tps65090_regulator *ri = NULL; 405 struct regulator_config config = { }; 406 struct regulator_dev *rdev; 407 struct tps65090_regulator_plat_data *tps_pdata; 408 struct tps65090_regulator *pmic; 409 struct tps65090_platform_data *tps65090_pdata; 410 struct of_regulator_match *tps65090_reg_matches = NULL; 411 int num; 412 int ret; 413 414 dev_dbg(&pdev->dev, "Probing regulator\n"); 415 416 tps65090_pdata = dev_get_platdata(pdev->dev.parent); 417 if (!tps65090_pdata && tps65090_mfd->dev->of_node) 418 tps65090_pdata = tps65090_parse_dt_reg_data(pdev, 419 &tps65090_reg_matches); 420 if (IS_ERR_OR_NULL(tps65090_pdata)) { 421 dev_err(&pdev->dev, "Platform data missing\n"); 422 return tps65090_pdata ? PTR_ERR(tps65090_pdata) : -EINVAL; 423 } 424 425 pmic = devm_kcalloc(&pdev->dev, 426 TPS65090_REGULATOR_MAX, sizeof(*pmic), 427 GFP_KERNEL); 428 if (!pmic) 429 return -ENOMEM; 430 431 for (num = 0; num < TPS65090_REGULATOR_MAX; num++) { 432 tps_pdata = tps65090_pdata->reg_pdata[num]; 433 434 ri = &pmic[num]; 435 ri->dev = &pdev->dev; 436 ri->desc = &tps65090_regulator_desc[num]; 437 if (tps_pdata) { 438 ri->overcurrent_wait_valid = 439 tps_pdata->overcurrent_wait_valid; 440 ri->overcurrent_wait = tps_pdata->overcurrent_wait; 441 } 442 443 /* 444 * TPS5090 DCDC support the control from external digital input. 445 * Configure it as per platform data. 446 */ 447 if (tps_pdata && is_dcdc(num) && tps_pdata->reg_init_data) { 448 if (tps_pdata->enable_ext_control) { 449 config.ena_gpiod = tps_pdata->gpiod; 450 ri->desc->ops = &tps65090_ext_control_ops; 451 } else { 452 ret = tps65090_regulator_disable_ext_control( 453 ri, tps_pdata); 454 if (ret < 0) { 455 dev_err(&pdev->dev, 456 "failed disable ext control\n"); 457 return ret; 458 } 459 } 460 } 461 462 config.dev = pdev->dev.parent; 463 config.driver_data = ri; 464 config.regmap = tps65090_mfd->rmap; 465 if (tps_pdata) 466 config.init_data = tps_pdata->reg_init_data; 467 else 468 config.init_data = NULL; 469 if (tps65090_reg_matches) 470 config.of_node = tps65090_reg_matches[num].of_node; 471 else 472 config.of_node = NULL; 473 474 /* 475 * Hand the GPIO descriptor management over to the regulator 476 * core, remove it from devres management. 477 */ 478 if (config.ena_gpiod) 479 devm_gpiod_unhinge(&pdev->dev, config.ena_gpiod); 480 rdev = devm_regulator_register(&pdev->dev, ri->desc, &config); 481 if (IS_ERR(rdev)) { 482 dev_err(&pdev->dev, "failed to register regulator %s\n", 483 ri->desc->name); 484 return PTR_ERR(rdev); 485 } 486 ri->rdev = rdev; 487 488 if (ri->overcurrent_wait_valid) { 489 ret = tps65090_reg_set_overcurrent_wait(ri, rdev); 490 if (ret < 0) 491 return ret; 492 } 493 494 /* Enable external control if it is require */ 495 if (tps_pdata && is_dcdc(num) && tps_pdata->reg_init_data && 496 tps_pdata->enable_ext_control) { 497 ret = tps65090_config_ext_control(ri, true); 498 if (ret < 0) 499 return ret; 500 } 501 } 502 503 platform_set_drvdata(pdev, pmic); 504 return 0; 505 } 506 507 static struct platform_driver tps65090_regulator_driver = { 508 .driver = { 509 .name = "tps65090-pmic", 510 }, 511 .probe = tps65090_regulator_probe, 512 }; 513 514 static int __init tps65090_regulator_init(void) 515 { 516 return platform_driver_register(&tps65090_regulator_driver); 517 } 518 subsys_initcall(tps65090_regulator_init); 519 520 static void __exit tps65090_regulator_exit(void) 521 { 522 platform_driver_unregister(&tps65090_regulator_driver); 523 } 524 module_exit(tps65090_regulator_exit); 525 526 MODULE_DESCRIPTION("tps65090 regulator driver"); 527 MODULE_AUTHOR("Venu Byravarasu <vbyravarasu@nvidia.com>"); 528 MODULE_LICENSE("GPL v2"); 529 MODULE_ALIAS("platform:tps65090-pmic"); 530