1 // SPDX-License-Identifier: GPL-2.0-only
3 * drivers/regulator/ab3100.c
5 * Copyright (C) 2008-2009 ST-Ericsson AB
6 * Low-level control of the AB3100 IC Low Dropout (LDO)
7 * regulators, external regulator and buck converter
12 #include <linux/module.h>
13 #include <linux/kernel.h>
14 #include <linux/init.h>
15 #include <linux/err.h>
16 #include <linux/platform_device.h>
17 #include <linux/regulator/driver.h>
18 #include <linux/mfd/ab3100.h>
19 #include <linux/mfd/abx500.h>
21 #include <linux/regulator/of_regulator.h>
23 /* LDO registers and some handy masking definitions for AB3100 */
24 #define AB3100_LDO_A 0x40
25 #define AB3100_LDO_C 0x41
26 #define AB3100_LDO_D 0x42
27 #define AB3100_LDO_E 0x43
28 #define AB3100_LDO_E_SLEEP 0x44
29 #define AB3100_LDO_F 0x45
30 #define AB3100_LDO_G 0x46
31 #define AB3100_LDO_H 0x47
32 #define AB3100_LDO_H_SLEEP_MODE 0
33 #define AB3100_LDO_H_SLEEP_EN 2
34 #define AB3100_LDO_ON 4
35 #define AB3100_LDO_H_VSEL_AC 5
36 #define AB3100_LDO_K 0x48
37 #define AB3100_LDO_EXT 0x49
38 #define AB3100_BUCK 0x4A
39 #define AB3100_BUCK_SLEEP 0x4B
40 #define AB3100_REG_ON_MASK 0x10
43 * struct ab3100_regulator
44 * A struct passed around the individual regulator functions
45 * @platform_device: platform device holding this regulator
46 * @dev: handle to the device
47 * @plfdata: AB3100 platform data passed in at probe time
48 * @regreg: regulator register number in the AB3100
50 struct ab3100_regulator {
52 struct ab3100_platform_data *plfdata;
56 /* The order in which registers are initialized */
57 static const u8 ab3100_reg_init_order[AB3100_NUM_REGULATORS+2] = {
72 /* Preset (hardware defined) voltages for these regulators */
73 #define LDO_A_VOLTAGE 2750000
74 #define LDO_C_VOLTAGE 2650000
75 #define LDO_D_VOLTAGE 2650000
77 static const unsigned int ldo_e_buck_typ_voltages[] = {
87 static const unsigned int ldo_f_typ_voltages[] = {
98 static const unsigned int ldo_g_typ_voltages[] = {
105 static const unsigned int ldo_h_typ_voltages[] = {
112 static const unsigned int ldo_k_typ_voltages[] = {
118 /* The regulator devices */
119 static struct ab3100_regulator
120 ab3100_regulators[AB3100_NUM_REGULATORS] = {
122 .regreg = AB3100_LDO_A,
125 .regreg = AB3100_LDO_C,
128 .regreg = AB3100_LDO_D,
131 .regreg = AB3100_LDO_E,
134 .regreg = AB3100_LDO_F,
137 .regreg = AB3100_LDO_G,
140 .regreg = AB3100_LDO_H,
143 .regreg = AB3100_LDO_K,
146 .regreg = AB3100_LDO_EXT,
147 /* No voltages for the external regulator */
150 .regreg = AB3100_BUCK,
155 * General functions for enable, disable and is_enabled used for
156 * LDO: A,C,E,F,G,H,K,EXT and BUCK
158 static int ab3100_enable_regulator(struct regulator_dev *reg)
160 struct ab3100_regulator *abreg = rdev_get_drvdata(reg);
164 err = abx500_get_register_interruptible(abreg->dev, 0, abreg->regreg,
167 dev_warn(®->dev, "failed to get regid %d value\n",
172 /* The regulator is already on, no reason to go further */
173 if (regval & AB3100_REG_ON_MASK)
176 regval |= AB3100_REG_ON_MASK;
178 err = abx500_set_register_interruptible(abreg->dev, 0, abreg->regreg,
181 dev_warn(®->dev, "failed to set regid %d value\n",
189 static int ab3100_disable_regulator(struct regulator_dev *reg)
191 struct ab3100_regulator *abreg = rdev_get_drvdata(reg);
196 * LDO D is a special regulator. When it is disabled, the entire
197 * system is shut down. So this is handled specially.
199 pr_info("Called ab3100_disable_regulator\n");
200 if (abreg->regreg == AB3100_LDO_D) {
201 dev_info(®->dev, "disabling LDO D - shut down system\n");
202 /* Setting LDO D to 0x00 cuts the power to the SoC */
203 return abx500_set_register_interruptible(abreg->dev, 0,
204 AB3100_LDO_D, 0x00U);
208 * All other regulators are handled here
210 err = abx500_get_register_interruptible(abreg->dev, 0, abreg->regreg,
213 dev_err(®->dev, "unable to get register 0x%x\n",
217 regval &= ~AB3100_REG_ON_MASK;
218 return abx500_set_register_interruptible(abreg->dev, 0, abreg->regreg,
222 static int ab3100_is_enabled_regulator(struct regulator_dev *reg)
224 struct ab3100_regulator *abreg = rdev_get_drvdata(reg);
228 err = abx500_get_register_interruptible(abreg->dev, 0, abreg->regreg,
231 dev_err(®->dev, "unable to get register 0x%x\n",
236 return regval & AB3100_REG_ON_MASK;
239 static int ab3100_get_voltage_regulator(struct regulator_dev *reg)
241 struct ab3100_regulator *abreg = rdev_get_drvdata(reg);
246 * For variable types, read out setting and index into
247 * supplied voltage list.
249 err = abx500_get_register_interruptible(abreg->dev, 0,
250 abreg->regreg, ®val);
253 "failed to get regulator value in register %02x\n",
258 /* The 3 highest bits index voltages */
262 if (regval >= reg->desc->n_voltages) {
264 "regulator register %02x contains an illegal voltage setting\n",
269 return reg->desc->volt_table[regval];
272 static int ab3100_set_voltage_regulator_sel(struct regulator_dev *reg,
275 struct ab3100_regulator *abreg = rdev_get_drvdata(reg);
279 err = abx500_get_register_interruptible(abreg->dev, 0,
280 abreg->regreg, ®val);
283 "failed to get regulator register %02x\n",
288 /* The highest three bits control the variable regulators */
290 regval |= (selector << 5);
292 err = abx500_set_register_interruptible(abreg->dev, 0,
293 abreg->regreg, regval);
295 dev_warn(®->dev, "failed to set regulator register %02x\n",
301 static int ab3100_set_suspend_voltage_regulator(struct regulator_dev *reg,
304 struct ab3100_regulator *abreg = rdev_get_drvdata(reg);
310 if (abreg->regreg == AB3100_LDO_E)
311 targetreg = AB3100_LDO_E_SLEEP;
312 else if (abreg->regreg == AB3100_BUCK)
313 targetreg = AB3100_BUCK_SLEEP;
317 /* LDO E and BUCK have special suspend voltages you can set */
318 bestindex = regulator_map_voltage_iterate(reg, uV, uV);
320 err = abx500_get_register_interruptible(abreg->dev, 0,
324 "failed to get regulator register %02x\n",
329 /* The highest three bits control the variable regulators */
331 regval |= (bestindex << 5);
333 err = abx500_set_register_interruptible(abreg->dev, 0,
336 dev_warn(®->dev, "failed to set regulator register %02x\n",
343 * The external regulator can just define a fixed voltage.
345 static int ab3100_get_voltage_regulator_external(struct regulator_dev *reg)
347 struct ab3100_regulator *abreg = rdev_get_drvdata(reg);
350 return abreg->plfdata->external_voltage;
352 /* TODO: encode external voltage into device tree */
356 static const struct regulator_ops regulator_ops_fixed = {
357 .enable = ab3100_enable_regulator,
358 .disable = ab3100_disable_regulator,
359 .is_enabled = ab3100_is_enabled_regulator,
362 static const struct regulator_ops regulator_ops_variable = {
363 .enable = ab3100_enable_regulator,
364 .disable = ab3100_disable_regulator,
365 .is_enabled = ab3100_is_enabled_regulator,
366 .get_voltage = ab3100_get_voltage_regulator,
367 .set_voltage_sel = ab3100_set_voltage_regulator_sel,
368 .list_voltage = regulator_list_voltage_table,
371 static const struct regulator_ops regulator_ops_variable_sleepable = {
372 .enable = ab3100_enable_regulator,
373 .disable = ab3100_disable_regulator,
374 .is_enabled = ab3100_is_enabled_regulator,
375 .get_voltage = ab3100_get_voltage_regulator,
376 .set_voltage_sel = ab3100_set_voltage_regulator_sel,
377 .set_suspend_voltage = ab3100_set_suspend_voltage_regulator,
378 .list_voltage = regulator_list_voltage_table,
382 * LDO EXT is an external regulator so it is really
383 * not possible to set any voltage locally here, AB3100
384 * is an on/off switch plain an simple. The external
385 * voltage is defined in the board set-up if any.
387 static const struct regulator_ops regulator_ops_external = {
388 .enable = ab3100_enable_regulator,
389 .disable = ab3100_disable_regulator,
390 .is_enabled = ab3100_is_enabled_regulator,
391 .get_voltage = ab3100_get_voltage_regulator_external,
394 static const struct regulator_desc
395 ab3100_regulator_desc[AB3100_NUM_REGULATORS] = {
399 .ops = ®ulator_ops_fixed,
401 .type = REGULATOR_VOLTAGE,
402 .owner = THIS_MODULE,
403 .fixed_uV = LDO_A_VOLTAGE,
409 .ops = ®ulator_ops_fixed,
411 .type = REGULATOR_VOLTAGE,
412 .owner = THIS_MODULE,
413 .fixed_uV = LDO_C_VOLTAGE,
419 .ops = ®ulator_ops_fixed,
421 .type = REGULATOR_VOLTAGE,
422 .owner = THIS_MODULE,
423 .fixed_uV = LDO_D_VOLTAGE,
429 .ops = ®ulator_ops_variable_sleepable,
430 .n_voltages = ARRAY_SIZE(ldo_e_buck_typ_voltages),
431 .volt_table = ldo_e_buck_typ_voltages,
432 .type = REGULATOR_VOLTAGE,
433 .owner = THIS_MODULE,
439 .ops = ®ulator_ops_variable,
440 .n_voltages = ARRAY_SIZE(ldo_f_typ_voltages),
441 .volt_table = ldo_f_typ_voltages,
442 .type = REGULATOR_VOLTAGE,
443 .owner = THIS_MODULE,
449 .ops = ®ulator_ops_variable,
450 .n_voltages = ARRAY_SIZE(ldo_g_typ_voltages),
451 .volt_table = ldo_g_typ_voltages,
452 .type = REGULATOR_VOLTAGE,
453 .owner = THIS_MODULE,
459 .ops = ®ulator_ops_variable,
460 .n_voltages = ARRAY_SIZE(ldo_h_typ_voltages),
461 .volt_table = ldo_h_typ_voltages,
462 .type = REGULATOR_VOLTAGE,
463 .owner = THIS_MODULE,
469 .ops = ®ulator_ops_variable,
470 .n_voltages = ARRAY_SIZE(ldo_k_typ_voltages),
471 .volt_table = ldo_k_typ_voltages,
472 .type = REGULATOR_VOLTAGE,
473 .owner = THIS_MODULE,
478 .id = AB3100_LDO_EXT,
479 .ops = ®ulator_ops_external,
480 .type = REGULATOR_VOLTAGE,
481 .owner = THIS_MODULE,
486 .ops = ®ulator_ops_variable_sleepable,
487 .n_voltages = ARRAY_SIZE(ldo_e_buck_typ_voltages),
488 .volt_table = ldo_e_buck_typ_voltages,
489 .type = REGULATOR_VOLTAGE,
490 .owner = THIS_MODULE,
495 static int ab3100_regulator_register(struct platform_device *pdev,
496 struct ab3100_platform_data *plfdata,
497 struct regulator_init_data *init_data,
498 struct device_node *np,
501 const struct regulator_desc *desc;
502 struct ab3100_regulator *reg;
503 struct regulator_dev *rdev;
504 struct regulator_config config = { };
507 for (i = 0; i < AB3100_NUM_REGULATORS; i++) {
508 desc = &ab3100_regulator_desc[i];
515 /* Same index used for this array */
516 reg = &ab3100_regulators[i];
519 * Initialize per-regulator struct.
520 * Inherit platform data, this comes down from the
521 * i2c boarddata, from the machine. So if you want to
522 * see what it looks like for a certain machine, go
523 * into the machine I2C setup.
525 reg->dev = &pdev->dev;
527 reg->plfdata = plfdata;
528 config.init_data = &plfdata->reg_constraints[i];
531 config.init_data = init_data;
533 config.dev = &pdev->dev;
534 config.driver_data = reg;
536 rdev = devm_regulator_register(&pdev->dev, desc, &config);
540 "%s: failed to register regulator %s err %d\n",
541 __func__, desc->name,
549 static struct of_regulator_match ab3100_regulator_matches[] = {
550 { .name = "ab3100_ldo_a", .driver_data = (void *) AB3100_LDO_A, },
551 { .name = "ab3100_ldo_c", .driver_data = (void *) AB3100_LDO_C, },
552 { .name = "ab3100_ldo_d", .driver_data = (void *) AB3100_LDO_D, },
553 { .name = "ab3100_ldo_e", .driver_data = (void *) AB3100_LDO_E, },
554 { .name = "ab3100_ldo_f", .driver_data = (void *) AB3100_LDO_F },
555 { .name = "ab3100_ldo_g", .driver_data = (void *) AB3100_LDO_G },
556 { .name = "ab3100_ldo_h", .driver_data = (void *) AB3100_LDO_H },
557 { .name = "ab3100_ldo_k", .driver_data = (void *) AB3100_LDO_K },
558 { .name = "ab3100_ext", .driver_data = (void *) AB3100_LDO_EXT },
559 { .name = "ab3100_buck", .driver_data = (void *) AB3100_BUCK },
563 * Initial settings of ab3100 registers.
564 * Common for below LDO regulator settings are that
565 * bit 7-5 controls voltage. Bit 4 turns regulator ON(1) or OFF(0).
566 * Bit 3-2 controls sleep enable and bit 1-0 controls sleep mode.
568 /* LDO_A 0x16: 2.75V, ON, SLEEP_A, SLEEP OFF GND */
569 #define LDO_A_SETTING 0x16
570 /* LDO_C 0x10: 2.65V, ON, SLEEP_A or B, SLEEP full power */
571 #define LDO_C_SETTING 0x10
572 /* LDO_D 0x10: 2.65V, ON, sleep mode not used */
573 #define LDO_D_SETTING 0x10
574 /* LDO_E 0x10: 1.8V, ON, SLEEP_A or B, SLEEP full power */
575 #define LDO_E_SETTING 0x10
576 /* LDO_E SLEEP 0x00: 1.8V, not used, SLEEP_A or B, not used */
577 #define LDO_E_SLEEP_SETTING 0x00
578 /* LDO_F 0xD0: 2.5V, ON, SLEEP_A or B, SLEEP full power */
579 #define LDO_F_SETTING 0xD0
580 /* LDO_G 0x00: 2.85V, OFF, SLEEP_A or B, SLEEP full power */
581 #define LDO_G_SETTING 0x00
582 /* LDO_H 0x18: 2.75V, ON, SLEEP_B, SLEEP full power */
583 #define LDO_H_SETTING 0x18
584 /* LDO_K 0x00: 2.75V, OFF, SLEEP_A or B, SLEEP full power */
585 #define LDO_K_SETTING 0x00
586 /* LDO_EXT 0x00: Voltage not set, OFF, not used, not used */
587 #define LDO_EXT_SETTING 0x00
588 /* BUCK 0x7D: 1.2V, ON, SLEEP_A and B, SLEEP low power */
589 #define BUCK_SETTING 0x7D
590 /* BUCK SLEEP 0xAC: 1.05V, Not used, SLEEP_A and B, Not used */
591 #define BUCK_SLEEP_SETTING 0xAC
593 static const u8 ab3100_reg_initvals[] = {
609 ab3100_regulator_of_probe(struct platform_device *pdev, struct device_node *np)
614 * Set up the regulator registers, as was previously done with
617 /* Set up regulators */
618 for (i = 0; i < ARRAY_SIZE(ab3100_reg_init_order); i++) {
619 err = abx500_set_register_interruptible(&pdev->dev, 0,
620 ab3100_reg_init_order[i],
621 ab3100_reg_initvals[i]);
623 dev_err(&pdev->dev, "regulator initialization failed with error %d\n",
629 for (i = 0; i < ARRAY_SIZE(ab3100_regulator_matches); i++) {
630 err = ab3100_regulator_register(
631 pdev, NULL, ab3100_regulator_matches[i].init_data,
632 ab3100_regulator_matches[i].of_node,
633 (unsigned long)ab3100_regulator_matches[i].driver_data);
642 static int ab3100_regulators_probe(struct platform_device *pdev)
644 struct ab3100_platform_data *plfdata = dev_get_platdata(&pdev->dev);
645 struct device_node *np = pdev->dev.of_node;
650 /* Check chip state */
651 err = abx500_get_register_interruptible(&pdev->dev, 0,
652 AB3100_LDO_D, &data);
654 dev_err(&pdev->dev, "could not read initial status of LDO_D\n");
658 dev_notice(&pdev->dev,
659 "chip is already in active mode (Warm start)\n");
661 dev_notice(&pdev->dev,
662 "chip is in inactive mode (Cold start)\n");
665 err = of_regulator_match(&pdev->dev, np,
666 ab3100_regulator_matches,
667 ARRAY_SIZE(ab3100_regulator_matches));
670 "Error parsing regulator init data: %d\n", err);
673 return ab3100_regulator_of_probe(pdev, np);
676 /* Set up regulators */
677 for (i = 0; i < ARRAY_SIZE(ab3100_reg_init_order); i++) {
678 err = abx500_set_register_interruptible(&pdev->dev, 0,
679 ab3100_reg_init_order[i],
680 plfdata->reg_initvals[i]);
682 dev_err(&pdev->dev, "regulator initialization failed with error %d\n",
688 /* Register the regulators */
689 for (i = 0; i < AB3100_NUM_REGULATORS; i++) {
690 const struct regulator_desc *desc = &ab3100_regulator_desc[i];
692 err = ab3100_regulator_register(pdev, plfdata, NULL, NULL,
701 static struct platform_driver ab3100_regulators_driver = {
703 .name = "ab3100-regulators",
705 .probe = ab3100_regulators_probe,
708 static __init int ab3100_regulators_init(void)
710 return platform_driver_register(&ab3100_regulators_driver);
713 static __exit void ab3100_regulators_exit(void)
715 platform_driver_unregister(&ab3100_regulators_driver);
718 subsys_initcall(ab3100_regulators_init);
719 module_exit(ab3100_regulators_exit);
722 MODULE_DESCRIPTION("AB3100 Regulator driver");
723 MODULE_LICENSE("GPL");
724 MODULE_ALIAS("platform:ab3100-regulators");