1 // SPDX-License-Identifier: GPL-2.0-only 2 /* 3 * Texas Instruments SoC Adaptive Body Bias(ABB) Regulator 4 * 5 * Copyright (C) 2011 Texas Instruments, Inc. 6 * Mike Turquette <mturquette@ti.com> 7 * 8 * Copyright (C) 2012-2013 Texas Instruments, Inc. 9 * Andrii Tseglytskyi <andrii.tseglytskyi@ti.com> 10 * Nishanth Menon <nm@ti.com> 11 */ 12 #include <linux/clk.h> 13 #include <linux/delay.h> 14 #include <linux/err.h> 15 #include <linux/io.h> 16 #include <linux/module.h> 17 #include <linux/of.h> 18 #include <linux/platform_device.h> 19 #include <linux/regulator/driver.h> 20 #include <linux/regulator/machine.h> 21 #include <linux/regulator/of_regulator.h> 22 23 /* 24 * ABB LDO operating states: 25 * NOMINAL_OPP: bypasses the ABB LDO 26 * FAST_OPP: sets ABB LDO to Forward Body-Bias 27 * SLOW_OPP: sets ABB LDO to Reverse Body-Bias 28 */ 29 #define TI_ABB_NOMINAL_OPP 0 30 #define TI_ABB_FAST_OPP 1 31 #define TI_ABB_SLOW_OPP 3 32 33 /** 34 * struct ti_abb_info - ABB information per voltage setting 35 * @opp_sel: one of TI_ABB macro 36 * @vset: (optional) vset value that LDOVBB needs to be overridden with. 37 * 38 * Array of per voltage entries organized in the same order as regulator_desc's 39 * volt_table list. (selector is used to index from this array) 40 */ 41 struct ti_abb_info { 42 u32 opp_sel; 43 u32 vset; 44 }; 45 46 /** 47 * struct ti_abb_reg - Register description for ABB block 48 * @setup_off: setup register offset from base 49 * @control_off: control register offset from base 50 * @sr2_wtcnt_value_mask: setup register- sr2_wtcnt_value mask 51 * @fbb_sel_mask: setup register- FBB sel mask 52 * @rbb_sel_mask: setup register- RBB sel mask 53 * @sr2_en_mask: setup register- enable mask 54 * @opp_change_mask: control register - mask to trigger LDOVBB change 55 * @opp_sel_mask: control register - mask for mode to operate 56 */ 57 struct ti_abb_reg { 58 u32 setup_off; 59 u32 control_off; 60 61 /* Setup register fields */ 62 u32 sr2_wtcnt_value_mask; 63 u32 fbb_sel_mask; 64 u32 rbb_sel_mask; 65 u32 sr2_en_mask; 66 67 /* Control register fields */ 68 u32 opp_change_mask; 69 u32 opp_sel_mask; 70 }; 71 72 /** 73 * struct ti_abb - ABB instance data 74 * @rdesc: regulator descriptor 75 * @clk: clock(usually sysclk) supplying ABB block 76 * @base: base address of ABB block 77 * @setup_reg: setup register of ABB block 78 * @control_reg: control register of ABB block 79 * @int_base: interrupt register base address 80 * @efuse_base: (optional) efuse base address for ABB modes 81 * @ldo_base: (optional) LDOVBB vset override base address 82 * @regs: pointer to struct ti_abb_reg for ABB block 83 * @txdone_mask: mask on int_base for tranxdone interrupt 84 * @ldovbb_override_mask: mask to ldo_base for overriding default LDO VBB 85 * vset with value from efuse 86 * @ldovbb_vset_mask: mask to ldo_base for providing the VSET override 87 * @info: array to per voltage ABB configuration 88 * @current_info_idx: current index to info 89 * @settling_time: SoC specific settling time for LDO VBB 90 */ 91 struct ti_abb { 92 struct regulator_desc rdesc; 93 struct clk *clk; 94 void __iomem *base; 95 void __iomem *setup_reg; 96 void __iomem *control_reg; 97 void __iomem *int_base; 98 void __iomem *efuse_base; 99 void __iomem *ldo_base; 100 101 const struct ti_abb_reg *regs; 102 u32 txdone_mask; 103 u32 ldovbb_override_mask; 104 u32 ldovbb_vset_mask; 105 106 struct ti_abb_info *info; 107 int current_info_idx; 108 109 u32 settling_time; 110 }; 111 112 /** 113 * ti_abb_rmw() - handy wrapper to set specific register bits 114 * @mask: mask for register field 115 * @value: value shifted to mask location and written 116 * @reg: register address 117 * 118 * Return: final register value (may be unused) 119 */ 120 static inline u32 ti_abb_rmw(u32 mask, u32 value, void __iomem *reg) 121 { 122 u32 val; 123 124 val = readl(reg); 125 val &= ~mask; 126 val |= (value << __ffs(mask)) & mask; 127 writel(val, reg); 128 129 return val; 130 } 131 132 /** 133 * ti_abb_check_txdone() - handy wrapper to check ABB tranxdone status 134 * @abb: pointer to the abb instance 135 * 136 * Return: true or false 137 */ 138 static inline bool ti_abb_check_txdone(const struct ti_abb *abb) 139 { 140 return !!(readl(abb->int_base) & abb->txdone_mask); 141 } 142 143 /** 144 * ti_abb_clear_txdone() - handy wrapper to clear ABB tranxdone status 145 * @abb: pointer to the abb instance 146 */ 147 static inline void ti_abb_clear_txdone(const struct ti_abb *abb) 148 { 149 writel(abb->txdone_mask, abb->int_base); 150 }; 151 152 /** 153 * ti_abb_wait_txdone() - waits for ABB tranxdone event 154 * @dev: device 155 * @abb: pointer to the abb instance 156 * 157 * Return: 0 on success or -ETIMEDOUT if the event is not cleared on time. 158 */ 159 static int ti_abb_wait_txdone(struct device *dev, struct ti_abb *abb) 160 { 161 int timeout = 0; 162 bool status; 163 164 while (timeout++ <= abb->settling_time) { 165 status = ti_abb_check_txdone(abb); 166 if (status) 167 return 0; 168 169 udelay(1); 170 } 171 172 dev_warn_ratelimited(dev, "%s:TRANXDONE timeout(%duS) int=0x%08x\n", 173 __func__, timeout, readl(abb->int_base)); 174 return -ETIMEDOUT; 175 } 176 177 /** 178 * ti_abb_clear_all_txdone() - clears ABB tranxdone event 179 * @dev: device 180 * @abb: pointer to the abb instance 181 * 182 * Return: 0 on success or -ETIMEDOUT if the event is not cleared on time. 183 */ 184 static int ti_abb_clear_all_txdone(struct device *dev, const struct ti_abb *abb) 185 { 186 int timeout = 0; 187 bool status; 188 189 while (timeout++ <= abb->settling_time) { 190 ti_abb_clear_txdone(abb); 191 192 status = ti_abb_check_txdone(abb); 193 if (!status) 194 return 0; 195 196 udelay(1); 197 } 198 199 dev_warn_ratelimited(dev, "%s:TRANXDONE timeout(%duS) int=0x%08x\n", 200 __func__, timeout, readl(abb->int_base)); 201 return -ETIMEDOUT; 202 } 203 204 /** 205 * ti_abb_program_ldovbb() - program LDOVBB register for override value 206 * @dev: device 207 * @abb: pointer to the abb instance 208 * @info: ABB info to program 209 */ 210 static void ti_abb_program_ldovbb(struct device *dev, const struct ti_abb *abb, 211 struct ti_abb_info *info) 212 { 213 u32 val; 214 215 val = readl(abb->ldo_base); 216 /* clear up previous values */ 217 val &= ~(abb->ldovbb_override_mask | abb->ldovbb_vset_mask); 218 219 switch (info->opp_sel) { 220 case TI_ABB_SLOW_OPP: 221 case TI_ABB_FAST_OPP: 222 val |= abb->ldovbb_override_mask; 223 val |= info->vset << __ffs(abb->ldovbb_vset_mask); 224 break; 225 } 226 227 writel(val, abb->ldo_base); 228 } 229 230 /** 231 * ti_abb_set_opp() - Setup ABB and LDO VBB for required bias 232 * @rdev: regulator device 233 * @abb: pointer to the abb instance 234 * @info: ABB info to program 235 * 236 * Return: 0 on success or appropriate error value when fails 237 */ 238 static int ti_abb_set_opp(struct regulator_dev *rdev, struct ti_abb *abb, 239 struct ti_abb_info *info) 240 { 241 const struct ti_abb_reg *regs = abb->regs; 242 struct device *dev = &rdev->dev; 243 int ret; 244 245 ret = ti_abb_clear_all_txdone(dev, abb); 246 if (ret) 247 goto out; 248 249 ti_abb_rmw(regs->fbb_sel_mask | regs->rbb_sel_mask, 0, abb->setup_reg); 250 251 switch (info->opp_sel) { 252 case TI_ABB_SLOW_OPP: 253 ti_abb_rmw(regs->rbb_sel_mask, 1, abb->setup_reg); 254 break; 255 case TI_ABB_FAST_OPP: 256 ti_abb_rmw(regs->fbb_sel_mask, 1, abb->setup_reg); 257 break; 258 } 259 260 /* program next state of ABB ldo */ 261 ti_abb_rmw(regs->opp_sel_mask, info->opp_sel, abb->control_reg); 262 263 /* 264 * program LDO VBB vset override if needed for !bypass mode 265 * XXX: Do not switch sequence - for !bypass, LDO override reset *must* 266 * be performed *before* switch to bias mode else VBB glitches. 267 */ 268 if (abb->ldo_base && info->opp_sel != TI_ABB_NOMINAL_OPP) 269 ti_abb_program_ldovbb(dev, abb, info); 270 271 /* Initiate ABB ldo change */ 272 ti_abb_rmw(regs->opp_change_mask, 1, abb->control_reg); 273 274 /* Wait for ABB LDO to complete transition to new Bias setting */ 275 ret = ti_abb_wait_txdone(dev, abb); 276 if (ret) 277 goto out; 278 279 ret = ti_abb_clear_all_txdone(dev, abb); 280 if (ret) 281 goto out; 282 283 /* 284 * Reset LDO VBB vset override bypass mode 285 * XXX: Do not switch sequence - for bypass, LDO override reset *must* 286 * be performed *after* switch to bypass else VBB glitches. 287 */ 288 if (abb->ldo_base && info->opp_sel == TI_ABB_NOMINAL_OPP) 289 ti_abb_program_ldovbb(dev, abb, info); 290 291 out: 292 return ret; 293 } 294 295 /** 296 * ti_abb_set_voltage_sel() - regulator accessor function to set ABB LDO 297 * @rdev: regulator device 298 * @sel: selector to index into required ABB LDO settings (maps to 299 * regulator descriptor's volt_table) 300 * 301 * Return: 0 on success or appropriate error value when fails 302 */ 303 static int ti_abb_set_voltage_sel(struct regulator_dev *rdev, unsigned int sel) 304 { 305 const struct regulator_desc *desc = rdev->desc; 306 struct ti_abb *abb = rdev_get_drvdata(rdev); 307 struct device *dev = &rdev->dev; 308 struct ti_abb_info *info, *oinfo; 309 int ret = 0; 310 311 if (!abb) { 312 dev_err_ratelimited(dev, "%s: No regulator drvdata\n", 313 __func__); 314 return -ENODEV; 315 } 316 317 if (!desc->n_voltages || !abb->info) { 318 dev_err_ratelimited(dev, 319 "%s: No valid voltage table entries?\n", 320 __func__); 321 return -EINVAL; 322 } 323 324 if (sel >= desc->n_voltages) { 325 dev_err(dev, "%s: sel idx(%d) >= n_voltages(%d)\n", __func__, 326 sel, desc->n_voltages); 327 return -EINVAL; 328 } 329 330 /* If we are in the same index as we were, nothing to do here! */ 331 if (sel == abb->current_info_idx) { 332 dev_dbg(dev, "%s: Already at sel=%d\n", __func__, sel); 333 return ret; 334 } 335 336 info = &abb->info[sel]; 337 /* 338 * When Linux kernel is starting up, we aren't sure of the 339 * Bias configuration that bootloader has configured. 340 * So, we get to know the actual setting the first time 341 * we are asked to transition. 342 */ 343 if (abb->current_info_idx == -EINVAL) 344 goto just_set_abb; 345 346 /* If data is exactly the same, then just update index, no change */ 347 oinfo = &abb->info[abb->current_info_idx]; 348 if (!memcmp(info, oinfo, sizeof(*info))) { 349 dev_dbg(dev, "%s: Same data new idx=%d, old idx=%d\n", __func__, 350 sel, abb->current_info_idx); 351 goto out; 352 } 353 354 just_set_abb: 355 ret = ti_abb_set_opp(rdev, abb, info); 356 357 out: 358 if (!ret) 359 abb->current_info_idx = sel; 360 else 361 dev_err_ratelimited(dev, 362 "%s: Volt[%d] idx[%d] mode[%d] Fail(%d)\n", 363 __func__, desc->volt_table[sel], sel, 364 info->opp_sel, ret); 365 return ret; 366 } 367 368 /** 369 * ti_abb_get_voltage_sel() - Regulator accessor to get current ABB LDO setting 370 * @rdev: regulator device 371 * 372 * Return: 0 on success or appropriate error value when fails 373 */ 374 static int ti_abb_get_voltage_sel(struct regulator_dev *rdev) 375 { 376 const struct regulator_desc *desc = rdev->desc; 377 struct ti_abb *abb = rdev_get_drvdata(rdev); 378 struct device *dev = &rdev->dev; 379 380 if (!abb) { 381 dev_err_ratelimited(dev, "%s: No regulator drvdata\n", 382 __func__); 383 return -ENODEV; 384 } 385 386 if (!desc->n_voltages || !abb->info) { 387 dev_err_ratelimited(dev, 388 "%s: No valid voltage table entries?\n", 389 __func__); 390 return -EINVAL; 391 } 392 393 if (abb->current_info_idx >= (int)desc->n_voltages) { 394 dev_err(dev, "%s: Corrupted data? idx(%d) >= n_voltages(%d)\n", 395 __func__, abb->current_info_idx, desc->n_voltages); 396 return -EINVAL; 397 } 398 399 return abb->current_info_idx; 400 } 401 402 /** 403 * ti_abb_init_timings() - setup ABB clock timing for the current platform 404 * @dev: device 405 * @abb: pointer to the abb instance 406 * 407 * Return: 0 if timing is updated, else returns error result. 408 */ 409 static int ti_abb_init_timings(struct device *dev, struct ti_abb *abb) 410 { 411 u32 clock_cycles; 412 u32 clk_rate, sr2_wt_cnt_val, cycle_rate; 413 const struct ti_abb_reg *regs = abb->regs; 414 int ret; 415 char *pname = "ti,settling-time"; 416 417 /* read device tree properties */ 418 ret = of_property_read_u32(dev->of_node, pname, &abb->settling_time); 419 if (ret) { 420 dev_err(dev, "Unable to get property '%s'(%d)\n", pname, ret); 421 return ret; 422 } 423 424 /* ABB LDO cannot be settle in 0 time */ 425 if (!abb->settling_time) { 426 dev_err(dev, "Invalid property:'%s' set as 0!\n", pname); 427 return -EINVAL; 428 } 429 430 pname = "ti,clock-cycles"; 431 ret = of_property_read_u32(dev->of_node, pname, &clock_cycles); 432 if (ret) { 433 dev_err(dev, "Unable to get property '%s'(%d)\n", pname, ret); 434 return ret; 435 } 436 /* ABB LDO cannot be settle in 0 clock cycles */ 437 if (!clock_cycles) { 438 dev_err(dev, "Invalid property:'%s' set as 0!\n", pname); 439 return -EINVAL; 440 } 441 442 abb->clk = devm_clk_get(dev, NULL); 443 if (IS_ERR(abb->clk)) { 444 ret = PTR_ERR(abb->clk); 445 dev_err(dev, "%s: Unable to get clk(%d)\n", __func__, ret); 446 return ret; 447 } 448 449 /* 450 * SR2_WTCNT_VALUE is the settling time for the ABB ldo after a 451 * transition and must be programmed with the correct time at boot. 452 * The value programmed into the register is the number of SYS_CLK 453 * clock cycles that match a given wall time profiled for the ldo. 454 * This value depends on: 455 * settling time of ldo in micro-seconds (varies per OMAP family) 456 * # of clock cycles per SYS_CLK period (varies per OMAP family) 457 * the SYS_CLK frequency in MHz (varies per board) 458 * The formula is: 459 * 460 * ldo settling time (in micro-seconds) 461 * SR2_WTCNT_VALUE = ------------------------------------------ 462 * (# system clock cycles) * (sys_clk period) 463 * 464 * Put another way: 465 * 466 * SR2_WTCNT_VALUE = settling time / (# SYS_CLK cycles / SYS_CLK rate)) 467 * 468 * To avoid dividing by zero multiply both "# clock cycles" and 469 * "settling time" by 10 such that the final result is the one we want. 470 */ 471 472 /* Convert SYS_CLK rate to MHz & prevent divide by zero */ 473 clk_rate = DIV_ROUND_CLOSEST(clk_get_rate(abb->clk), 1000000); 474 475 /* Calculate cycle rate */ 476 cycle_rate = DIV_ROUND_CLOSEST(clock_cycles * 10, clk_rate); 477 478 /* Calculate SR2_WTCNT_VALUE */ 479 sr2_wt_cnt_val = DIV_ROUND_CLOSEST(abb->settling_time * 10, cycle_rate); 480 481 dev_dbg(dev, "%s: Clk_rate=%ld, sr2_cnt=0x%08x\n", __func__, 482 clk_get_rate(abb->clk), sr2_wt_cnt_val); 483 484 ti_abb_rmw(regs->sr2_wtcnt_value_mask, sr2_wt_cnt_val, abb->setup_reg); 485 486 return 0; 487 } 488 489 /** 490 * ti_abb_init_table() - Initialize ABB table from device tree 491 * @dev: device 492 * @abb: pointer to the abb instance 493 * @rinit_data: regulator initdata 494 * 495 * Return: 0 on success or appropriate error value when fails 496 */ 497 static int ti_abb_init_table(struct device *dev, struct ti_abb *abb, 498 struct regulator_init_data *rinit_data) 499 { 500 struct ti_abb_info *info; 501 const u32 num_values = 6; 502 char *pname = "ti,abb_info"; 503 u32 i; 504 unsigned int *volt_table; 505 int num_entries, min_uV = INT_MAX, max_uV = 0; 506 struct regulation_constraints *c = &rinit_data->constraints; 507 508 /* 509 * Each abb_info is a set of n-tuple, where n is num_values, consisting 510 * of voltage and a set of detection logic for ABB information for that 511 * voltage to apply. 512 */ 513 num_entries = of_property_count_u32_elems(dev->of_node, pname); 514 if (num_entries < 0) { 515 dev_err(dev, "No '%s' property?\n", pname); 516 return num_entries; 517 } 518 519 if (!num_entries || (num_entries % num_values)) { 520 dev_err(dev, "All '%s' list entries need %d vals\n", pname, 521 num_values); 522 return -EINVAL; 523 } 524 num_entries /= num_values; 525 526 info = devm_kzalloc_objs(dev, *info, num_entries); 527 if (!info) 528 return -ENOMEM; 529 530 abb->info = info; 531 532 volt_table = devm_kzalloc_objs(dev, unsigned int, num_entries); 533 if (!volt_table) 534 return -ENOMEM; 535 536 abb->rdesc.n_voltages = num_entries; 537 abb->rdesc.volt_table = volt_table; 538 /* We do not know where the OPP voltage is at the moment */ 539 abb->current_info_idx = -EINVAL; 540 541 for (i = 0; i < num_entries; i++, info++, volt_table++) { 542 u32 efuse_offset, rbb_mask, fbb_mask, vset_mask; 543 u32 efuse_val; 544 545 /* NOTE: num_values should equal to entries picked up here */ 546 of_property_read_u32_index(dev->of_node, pname, i * num_values, 547 volt_table); 548 of_property_read_u32_index(dev->of_node, pname, 549 i * num_values + 1, &info->opp_sel); 550 of_property_read_u32_index(dev->of_node, pname, 551 i * num_values + 2, &efuse_offset); 552 of_property_read_u32_index(dev->of_node, pname, 553 i * num_values + 3, &rbb_mask); 554 of_property_read_u32_index(dev->of_node, pname, 555 i * num_values + 4, &fbb_mask); 556 of_property_read_u32_index(dev->of_node, pname, 557 i * num_values + 5, &vset_mask); 558 559 dev_dbg(dev, 560 "[%d]v=%d ABB=%d ef=0x%x rbb=0x%x fbb=0x%x vset=0x%x\n", 561 i, *volt_table, info->opp_sel, efuse_offset, rbb_mask, 562 fbb_mask, vset_mask); 563 564 /* Find min/max for voltage set */ 565 if (min_uV > *volt_table) 566 min_uV = *volt_table; 567 if (max_uV < *volt_table) 568 max_uV = *volt_table; 569 570 if (!abb->efuse_base) { 571 /* Ignore invalid data, but warn to help cleanup */ 572 if (efuse_offset || rbb_mask || fbb_mask || vset_mask) 573 dev_err(dev, "prop '%s': v=%d,bad efuse/mask\n", 574 pname, *volt_table); 575 goto check_abb; 576 } 577 578 efuse_val = readl(abb->efuse_base + efuse_offset); 579 580 /* Use ABB recommendation from Efuse */ 581 if (efuse_val & rbb_mask) 582 info->opp_sel = TI_ABB_SLOW_OPP; 583 else if (efuse_val & fbb_mask) 584 info->opp_sel = TI_ABB_FAST_OPP; 585 else if (rbb_mask || fbb_mask) 586 info->opp_sel = TI_ABB_NOMINAL_OPP; 587 588 dev_dbg(dev, 589 "[%d]v=%d efusev=0x%x final ABB=%d\n", 590 i, *volt_table, efuse_val, info->opp_sel); 591 592 /* Use recommended Vset bits from Efuse */ 593 if (!abb->ldo_base) { 594 if (vset_mask) 595 dev_err(dev, "prop'%s':v=%d vst=%x LDO base?\n", 596 pname, *volt_table, vset_mask); 597 continue; 598 } 599 info->vset = (efuse_val & vset_mask) >> __ffs(vset_mask); 600 dev_dbg(dev, "[%d]v=%d vset=%x\n", i, *volt_table, info->vset); 601 check_abb: 602 switch (info->opp_sel) { 603 case TI_ABB_NOMINAL_OPP: 604 case TI_ABB_FAST_OPP: 605 case TI_ABB_SLOW_OPP: 606 /* Valid values */ 607 break; 608 default: 609 dev_err(dev, "%s:[%d]v=%d, ABB=%d is invalid! Abort!\n", 610 __func__, i, *volt_table, info->opp_sel); 611 return -EINVAL; 612 } 613 } 614 615 /* Setup the min/max voltage constraints from the supported list */ 616 c->min_uV = min_uV; 617 c->max_uV = max_uV; 618 619 return 0; 620 } 621 622 static const struct regulator_ops ti_abb_reg_ops = { 623 .list_voltage = regulator_list_voltage_table, 624 625 .set_voltage_sel = ti_abb_set_voltage_sel, 626 .get_voltage_sel = ti_abb_get_voltage_sel, 627 }; 628 629 /* Default ABB block offsets, IF this changes in future, create new one */ 630 static const struct ti_abb_reg abb_regs_v1 = { 631 /* WARNING: registers are wrongly documented in TRM */ 632 .setup_off = 0x04, 633 .control_off = 0x00, 634 635 .sr2_wtcnt_value_mask = (0xff << 8), 636 .fbb_sel_mask = (0x01 << 2), 637 .rbb_sel_mask = (0x01 << 1), 638 .sr2_en_mask = (0x01 << 0), 639 640 .opp_change_mask = (0x01 << 2), 641 .opp_sel_mask = (0x03 << 0), 642 }; 643 644 static const struct ti_abb_reg abb_regs_v2 = { 645 .setup_off = 0x00, 646 .control_off = 0x04, 647 648 .sr2_wtcnt_value_mask = (0xff << 8), 649 .fbb_sel_mask = (0x01 << 2), 650 .rbb_sel_mask = (0x01 << 1), 651 .sr2_en_mask = (0x01 << 0), 652 653 .opp_change_mask = (0x01 << 2), 654 .opp_sel_mask = (0x03 << 0), 655 }; 656 657 static const struct ti_abb_reg abb_regs_generic = { 658 .sr2_wtcnt_value_mask = (0xff << 8), 659 .fbb_sel_mask = (0x01 << 2), 660 .rbb_sel_mask = (0x01 << 1), 661 .sr2_en_mask = (0x01 << 0), 662 663 .opp_change_mask = (0x01 << 2), 664 .opp_sel_mask = (0x03 << 0), 665 }; 666 667 static const struct of_device_id ti_abb_of_match[] = { 668 {.compatible = "ti,abb-v1", .data = &abb_regs_v1}, 669 {.compatible = "ti,abb-v2", .data = &abb_regs_v2}, 670 {.compatible = "ti,abb-v3", .data = &abb_regs_generic}, 671 { }, 672 }; 673 674 MODULE_DEVICE_TABLE(of, ti_abb_of_match); 675 676 /** 677 * ti_abb_probe() - Initialize an ABB ldo instance 678 * @pdev: ABB platform device 679 * 680 * Initializes an individual ABB LDO for required Body-Bias. ABB is used to 681 * additional bias supply to SoC modules for power savings or mandatory stability 682 * configuration at certain Operating Performance Points(OPPs). 683 * 684 * Return: 0 on success or appropriate error value when fails 685 */ 686 static int ti_abb_probe(struct platform_device *pdev) 687 { 688 struct device *dev = &pdev->dev; 689 struct resource *res; 690 struct ti_abb *abb; 691 struct regulator_init_data *initdata = NULL; 692 struct regulator_dev *rdev = NULL; 693 struct regulator_desc *desc; 694 struct regulation_constraints *c; 695 struct regulator_config config = { }; 696 char *pname; 697 int ret = 0; 698 699 abb = devm_kzalloc_obj(dev, struct ti_abb); 700 if (!abb) 701 return -ENOMEM; 702 703 abb->regs = device_get_match_data(dev); 704 if (!abb->regs) { 705 dev_err(dev, "%s: Bad data in match\n", __func__); 706 return -EINVAL; 707 } 708 709 /* Map ABB resources */ 710 if (abb->regs->setup_off || abb->regs->control_off) { 711 abb->base = devm_platform_ioremap_resource_byname(pdev, "base-address"); 712 if (IS_ERR(abb->base)) 713 return PTR_ERR(abb->base); 714 715 abb->setup_reg = abb->base + abb->regs->setup_off; 716 abb->control_reg = abb->base + abb->regs->control_off; 717 718 } else { 719 abb->control_reg = devm_platform_ioremap_resource_byname(pdev, "control-address"); 720 if (IS_ERR(abb->control_reg)) 721 return PTR_ERR(abb->control_reg); 722 723 abb->setup_reg = devm_platform_ioremap_resource_byname(pdev, "setup-address"); 724 if (IS_ERR(abb->setup_reg)) 725 return PTR_ERR(abb->setup_reg); 726 } 727 728 pname = "int-address"; 729 res = platform_get_resource_byname(pdev, IORESOURCE_MEM, pname); 730 if (!res) { 731 dev_err(dev, "Missing '%s' IO resource\n", pname); 732 return -ENODEV; 733 } 734 /* 735 * The MPU interrupt status register (PRM_IRQSTATUS_MPU) is 736 * shared between regulator-abb-{ivahd,dspeve,gpu} driver 737 * instances. Therefore use devm_ioremap() rather than 738 * devm_platform_ioremap_resource_byname() to avoid busy 739 * resource region conflicts. 740 */ 741 abb->int_base = devm_ioremap(dev, res->start, 742 resource_size(res)); 743 if (!abb->int_base) { 744 dev_err(dev, "Unable to map '%s'\n", pname); 745 return -ENOMEM; 746 } 747 748 /* Map Optional resources */ 749 pname = "efuse-address"; 750 res = platform_get_resource_byname(pdev, IORESOURCE_MEM, pname); 751 if (!res) { 752 dev_dbg(dev, "Missing '%s' IO resource\n", pname); 753 ret = -ENODEV; 754 goto skip_opt; 755 } 756 757 /* 758 * We may have shared efuse register offsets which are read-only 759 * between domains 760 */ 761 abb->efuse_base = devm_ioremap(dev, res->start, 762 resource_size(res)); 763 if (!abb->efuse_base) { 764 dev_err(dev, "Unable to map '%s'\n", pname); 765 return -ENOMEM; 766 } 767 768 pname = "ldo-address"; 769 res = platform_get_resource_byname(pdev, IORESOURCE_MEM, pname); 770 if (!res) { 771 dev_dbg(dev, "Missing '%s' IO resource\n", pname); 772 ret = -ENODEV; 773 goto skip_opt; 774 } 775 abb->ldo_base = devm_ioremap_resource(dev, res); 776 if (IS_ERR(abb->ldo_base)) 777 return PTR_ERR(abb->ldo_base); 778 779 /* IF ldo_base is set, the following are mandatory */ 780 pname = "ti,ldovbb-override-mask"; 781 ret = 782 of_property_read_u32(pdev->dev.of_node, pname, 783 &abb->ldovbb_override_mask); 784 if (ret) { 785 dev_err(dev, "Missing '%s' (%d)\n", pname, ret); 786 return ret; 787 } 788 if (!abb->ldovbb_override_mask) { 789 dev_err(dev, "Invalid property:'%s' set as 0!\n", pname); 790 return -EINVAL; 791 } 792 793 pname = "ti,ldovbb-vset-mask"; 794 ret = 795 of_property_read_u32(pdev->dev.of_node, pname, 796 &abb->ldovbb_vset_mask); 797 if (ret) { 798 dev_err(dev, "Missing '%s' (%d)\n", pname, ret); 799 return ret; 800 } 801 if (!abb->ldovbb_vset_mask) { 802 dev_err(dev, "Invalid property:'%s' set as 0!\n", pname); 803 return -EINVAL; 804 } 805 806 skip_opt: 807 pname = "ti,tranxdone-status-mask"; 808 ret = 809 of_property_read_u32(pdev->dev.of_node, pname, 810 &abb->txdone_mask); 811 if (ret) { 812 dev_err(dev, "Missing '%s' (%d)\n", pname, ret); 813 return ret; 814 } 815 if (!abb->txdone_mask) { 816 dev_err(dev, "Invalid property:'%s' set as 0!\n", pname); 817 return -EINVAL; 818 } 819 820 initdata = of_get_regulator_init_data(dev, pdev->dev.of_node, 821 &abb->rdesc); 822 if (!initdata) { 823 dev_err(dev, "%s: Unable to alloc regulator init data\n", 824 __func__); 825 return -ENOMEM; 826 } 827 828 /* init ABB opp_sel table */ 829 ret = ti_abb_init_table(dev, abb, initdata); 830 if (ret) 831 return ret; 832 833 /* init ABB timing */ 834 ret = ti_abb_init_timings(dev, abb); 835 if (ret) 836 return ret; 837 838 desc = &abb->rdesc; 839 desc->name = dev_name(dev); 840 desc->owner = THIS_MODULE; 841 desc->type = REGULATOR_VOLTAGE; 842 desc->ops = &ti_abb_reg_ops; 843 844 c = &initdata->constraints; 845 if (desc->n_voltages > 1) 846 c->valid_ops_mask |= REGULATOR_CHANGE_VOLTAGE; 847 c->always_on = true; 848 849 config.dev = dev; 850 config.init_data = initdata; 851 config.driver_data = abb; 852 config.of_node = pdev->dev.of_node; 853 854 rdev = devm_regulator_register(dev, desc, &config); 855 if (IS_ERR(rdev)) { 856 ret = PTR_ERR(rdev); 857 dev_err(dev, "%s: failed to register regulator(%d)\n", 858 __func__, ret); 859 return ret; 860 } 861 platform_set_drvdata(pdev, rdev); 862 863 /* Enable the ldo if not already done by bootloader */ 864 ti_abb_rmw(abb->regs->sr2_en_mask, 1, abb->setup_reg); 865 866 return 0; 867 } 868 869 MODULE_ALIAS("platform:ti_abb"); 870 871 static struct platform_driver ti_abb_driver = { 872 .probe = ti_abb_probe, 873 .driver = { 874 .name = "ti_abb", 875 .probe_type = PROBE_PREFER_ASYNCHRONOUS, 876 .of_match_table = ti_abb_of_match, 877 }, 878 }; 879 module_platform_driver(ti_abb_driver); 880 881 MODULE_DESCRIPTION("Texas Instruments ABB LDO regulator driver"); 882 MODULE_AUTHOR("Texas Instruments Inc."); 883 MODULE_LICENSE("GPL v2"); 884