2 * drivers/regulator/ab3100.c
4 * Copyright (C) 2008-2009 ST-Ericsson AB
5 * License terms: GNU General Public License (GPL) version 2
6 * Low-level control of the AB3100 IC Low Dropout (LDO)
7 * regulators, external regulator and buck converter
8 * Author: Mattias Wallin <mattias.wallin@stericsson.com>
9 * Author: Linus Walleij <linus.walleij@stericsson.com>
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 {
51 struct regulator_dev *rdev;
53 struct ab3100_platform_data *plfdata;
57 /* The order in which registers are initialized */
58 static const u8 ab3100_reg_init_order[AB3100_NUM_REGULATORS+2] = {
73 /* Preset (hardware defined) voltages for these regulators */
74 #define LDO_A_VOLTAGE 2750000
75 #define LDO_C_VOLTAGE 2650000
76 #define LDO_D_VOLTAGE 2650000
78 static const unsigned int ldo_e_buck_typ_voltages[] = {
88 static const unsigned int ldo_f_typ_voltages[] = {
99 static const unsigned int ldo_g_typ_voltages[] = {
106 static const unsigned int ldo_h_typ_voltages[] = {
113 static const unsigned int ldo_k_typ_voltages[] = {
119 /* The regulator devices */
120 static struct ab3100_regulator
121 ab3100_regulators[AB3100_NUM_REGULATORS] = {
123 .regreg = AB3100_LDO_A,
126 .regreg = AB3100_LDO_C,
129 .regreg = AB3100_LDO_D,
132 .regreg = AB3100_LDO_E,
135 .regreg = AB3100_LDO_F,
138 .regreg = AB3100_LDO_G,
141 .regreg = AB3100_LDO_H,
144 .regreg = AB3100_LDO_K,
147 .regreg = AB3100_LDO_EXT,
148 /* No voltages for the external regulator */
151 .regreg = AB3100_BUCK,
156 * General functions for enable, disable and is_enabled used for
157 * LDO: A,C,E,F,G,H,K,EXT and BUCK
159 static int ab3100_enable_regulator(struct regulator_dev *reg)
161 struct ab3100_regulator *abreg = rdev_get_drvdata(reg);
165 err = abx500_get_register_interruptible(abreg->dev, 0, abreg->regreg,
168 dev_warn(®->dev, "failed to get regid %d value\n",
173 /* The regulator is already on, no reason to go further */
174 if (regval & AB3100_REG_ON_MASK)
177 regval |= AB3100_REG_ON_MASK;
179 err = abx500_set_register_interruptible(abreg->dev, 0, abreg->regreg,
182 dev_warn(®->dev, "failed to set regid %d value\n",
190 static int ab3100_disable_regulator(struct regulator_dev *reg)
192 struct ab3100_regulator *abreg = rdev_get_drvdata(reg);
197 * LDO D is a special regulator. When it is disabled, the entire
198 * system is shut down. So this is handled specially.
200 pr_info("Called ab3100_disable_regulator\n");
201 if (abreg->regreg == AB3100_LDO_D) {
202 dev_info(®->dev, "disabling LDO D - shut down system\n");
203 /* Setting LDO D to 0x00 cuts the power to the SoC */
204 return abx500_set_register_interruptible(abreg->dev, 0,
205 AB3100_LDO_D, 0x00U);
209 * All other regulators are handled here
211 err = abx500_get_register_interruptible(abreg->dev, 0, abreg->regreg,
214 dev_err(®->dev, "unable to get register 0x%x\n",
218 regval &= ~AB3100_REG_ON_MASK;
219 return abx500_set_register_interruptible(abreg->dev, 0, abreg->regreg,
223 static int ab3100_is_enabled_regulator(struct regulator_dev *reg)
225 struct ab3100_regulator *abreg = rdev_get_drvdata(reg);
229 err = abx500_get_register_interruptible(abreg->dev, 0, abreg->regreg,
232 dev_err(®->dev, "unable to get register 0x%x\n",
237 return regval & AB3100_REG_ON_MASK;
240 static int ab3100_get_voltage_regulator(struct regulator_dev *reg)
242 struct ab3100_regulator *abreg = rdev_get_drvdata(reg);
247 * For variable types, read out setting and index into
248 * supplied voltage list.
250 err = abx500_get_register_interruptible(abreg->dev, 0,
251 abreg->regreg, ®val);
254 "failed to get regulator value in register %02x\n",
259 /* The 3 highest bits index voltages */
263 if (regval >= reg->desc->n_voltages) {
265 "regulator register %02x contains an illegal voltage setting\n",
270 return reg->desc->volt_table[regval];
273 static int ab3100_set_voltage_regulator_sel(struct regulator_dev *reg,
276 struct ab3100_regulator *abreg = rdev_get_drvdata(reg);
280 err = abx500_get_register_interruptible(abreg->dev, 0,
281 abreg->regreg, ®val);
284 "failed to get regulator register %02x\n",
289 /* The highest three bits control the variable regulators */
291 regval |= (selector << 5);
293 err = abx500_set_register_interruptible(abreg->dev, 0,
294 abreg->regreg, regval);
296 dev_warn(®->dev, "failed to set regulator register %02x\n",
302 static int ab3100_set_suspend_voltage_regulator(struct regulator_dev *reg,
305 struct ab3100_regulator *abreg = rdev_get_drvdata(reg);
311 if (abreg->regreg == AB3100_LDO_E)
312 targetreg = AB3100_LDO_E_SLEEP;
313 else if (abreg->regreg == AB3100_BUCK)
314 targetreg = AB3100_BUCK_SLEEP;
318 /* LDO E and BUCK have special suspend voltages you can set */
319 bestindex = regulator_map_voltage_iterate(reg, uV, uV);
321 err = abx500_get_register_interruptible(abreg->dev, 0,
325 "failed to get regulator register %02x\n",
330 /* The highest three bits control the variable regulators */
332 regval |= (bestindex << 5);
334 err = abx500_set_register_interruptible(abreg->dev, 0,
337 dev_warn(®->dev, "failed to set regulator register %02x\n",
344 * The external regulator can just define a fixed voltage.
346 static int ab3100_get_voltage_regulator_external(struct regulator_dev *reg)
348 struct ab3100_regulator *abreg = rdev_get_drvdata(reg);
351 return abreg->plfdata->external_voltage;
353 /* TODO: encode external voltage into device tree */
357 static struct regulator_ops regulator_ops_fixed = {
358 .list_voltage = regulator_list_voltage_linear,
359 .enable = ab3100_enable_regulator,
360 .disable = ab3100_disable_regulator,
361 .is_enabled = ab3100_is_enabled_regulator,
364 static struct regulator_ops regulator_ops_variable = {
365 .enable = ab3100_enable_regulator,
366 .disable = ab3100_disable_regulator,
367 .is_enabled = ab3100_is_enabled_regulator,
368 .get_voltage = ab3100_get_voltage_regulator,
369 .set_voltage_sel = ab3100_set_voltage_regulator_sel,
370 .list_voltage = regulator_list_voltage_table,
373 static struct regulator_ops regulator_ops_variable_sleepable = {
374 .enable = ab3100_enable_regulator,
375 .disable = ab3100_disable_regulator,
376 .is_enabled = ab3100_is_enabled_regulator,
377 .get_voltage = ab3100_get_voltage_regulator,
378 .set_voltage_sel = ab3100_set_voltage_regulator_sel,
379 .set_suspend_voltage = ab3100_set_suspend_voltage_regulator,
380 .list_voltage = regulator_list_voltage_table,
384 * LDO EXT is an external regulator so it is really
385 * not possible to set any voltage locally here, AB3100
386 * is an on/off switch plain an simple. The external
387 * voltage is defined in the board set-up if any.
389 static struct regulator_ops regulator_ops_external = {
390 .enable = ab3100_enable_regulator,
391 .disable = ab3100_disable_regulator,
392 .is_enabled = ab3100_is_enabled_regulator,
393 .get_voltage = ab3100_get_voltage_regulator_external,
396 static struct regulator_desc
397 ab3100_regulator_desc[AB3100_NUM_REGULATORS] = {
401 .ops = ®ulator_ops_fixed,
403 .type = REGULATOR_VOLTAGE,
404 .owner = THIS_MODULE,
405 .min_uV = LDO_A_VOLTAGE,
411 .ops = ®ulator_ops_fixed,
413 .type = REGULATOR_VOLTAGE,
414 .owner = THIS_MODULE,
415 .min_uV = LDO_C_VOLTAGE,
421 .ops = ®ulator_ops_fixed,
423 .type = REGULATOR_VOLTAGE,
424 .owner = THIS_MODULE,
425 .min_uV = LDO_D_VOLTAGE,
431 .ops = ®ulator_ops_variable_sleepable,
432 .n_voltages = ARRAY_SIZE(ldo_e_buck_typ_voltages),
433 .volt_table = ldo_e_buck_typ_voltages,
434 .type = REGULATOR_VOLTAGE,
435 .owner = THIS_MODULE,
441 .ops = ®ulator_ops_variable,
442 .n_voltages = ARRAY_SIZE(ldo_f_typ_voltages),
443 .volt_table = ldo_f_typ_voltages,
444 .type = REGULATOR_VOLTAGE,
445 .owner = THIS_MODULE,
451 .ops = ®ulator_ops_variable,
452 .n_voltages = ARRAY_SIZE(ldo_g_typ_voltages),
453 .volt_table = ldo_g_typ_voltages,
454 .type = REGULATOR_VOLTAGE,
455 .owner = THIS_MODULE,
461 .ops = ®ulator_ops_variable,
462 .n_voltages = ARRAY_SIZE(ldo_h_typ_voltages),
463 .volt_table = ldo_h_typ_voltages,
464 .type = REGULATOR_VOLTAGE,
465 .owner = THIS_MODULE,
471 .ops = ®ulator_ops_variable,
472 .n_voltages = ARRAY_SIZE(ldo_k_typ_voltages),
473 .volt_table = ldo_k_typ_voltages,
474 .type = REGULATOR_VOLTAGE,
475 .owner = THIS_MODULE,
480 .id = AB3100_LDO_EXT,
481 .ops = ®ulator_ops_external,
482 .type = REGULATOR_VOLTAGE,
483 .owner = THIS_MODULE,
488 .ops = ®ulator_ops_variable_sleepable,
489 .n_voltages = ARRAY_SIZE(ldo_e_buck_typ_voltages),
490 .volt_table = ldo_e_buck_typ_voltages,
491 .type = REGULATOR_VOLTAGE,
492 .owner = THIS_MODULE,
497 static int ab3100_regulator_register(struct platform_device *pdev,
498 struct ab3100_platform_data *plfdata,
499 struct regulator_init_data *init_data,
500 struct device_node *np,
503 struct regulator_desc *desc;
504 struct ab3100_regulator *reg;
505 struct regulator_dev *rdev;
506 struct regulator_config config = { };
509 for (i = 0; i < AB3100_NUM_REGULATORS; i++) {
510 desc = &ab3100_regulator_desc[i];
517 /* Same index used for this array */
518 reg = &ab3100_regulators[i];
521 * Initialize per-regulator struct.
522 * Inherit platform data, this comes down from the
523 * i2c boarddata, from the machine. So if you want to
524 * see what it looks like for a certain machine, go
525 * into the machine I2C setup.
527 reg->dev = &pdev->dev;
529 reg->plfdata = plfdata;
530 config.init_data = &plfdata->reg_constraints[i];
533 config.init_data = init_data;
535 config.dev = &pdev->dev;
536 config.driver_data = reg;
538 rdev = devm_regulator_register(&pdev->dev, desc, &config);
542 "%s: failed to register regulator %s err %d\n",
543 __func__, desc->name,
548 /* Then set a pointer back to the registered regulator */
553 static struct of_regulator_match ab3100_regulator_matches[] = {
554 { .name = "ab3100_ldo_a", .driver_data = (void *) AB3100_LDO_A, },
555 { .name = "ab3100_ldo_c", .driver_data = (void *) AB3100_LDO_C, },
556 { .name = "ab3100_ldo_d", .driver_data = (void *) AB3100_LDO_D, },
557 { .name = "ab3100_ldo_e", .driver_data = (void *) AB3100_LDO_E, },
558 { .name = "ab3100_ldo_f", .driver_data = (void *) AB3100_LDO_F },
559 { .name = "ab3100_ldo_g", .driver_data = (void *) AB3100_LDO_G },
560 { .name = "ab3100_ldo_h", .driver_data = (void *) AB3100_LDO_H },
561 { .name = "ab3100_ldo_k", .driver_data = (void *) AB3100_LDO_K },
562 { .name = "ab3100_ext", .driver_data = (void *) AB3100_LDO_EXT },
563 { .name = "ab3100_buck", .driver_data = (void *) AB3100_BUCK },
567 * Initial settings of ab3100 registers.
568 * Common for below LDO regulator settings are that
569 * bit 7-5 controls voltage. Bit 4 turns regulator ON(1) or OFF(0).
570 * Bit 3-2 controls sleep enable and bit 1-0 controls sleep mode.
572 /* LDO_A 0x16: 2.75V, ON, SLEEP_A, SLEEP OFF GND */
573 #define LDO_A_SETTING 0x16
574 /* LDO_C 0x10: 2.65V, ON, SLEEP_A or B, SLEEP full power */
575 #define LDO_C_SETTING 0x10
576 /* LDO_D 0x10: 2.65V, ON, sleep mode not used */
577 #define LDO_D_SETTING 0x10
578 /* LDO_E 0x10: 1.8V, ON, SLEEP_A or B, SLEEP full power */
579 #define LDO_E_SETTING 0x10
580 /* LDO_E SLEEP 0x00: 1.8V, not used, SLEEP_A or B, not used */
581 #define LDO_E_SLEEP_SETTING 0x00
582 /* LDO_F 0xD0: 2.5V, ON, SLEEP_A or B, SLEEP full power */
583 #define LDO_F_SETTING 0xD0
584 /* LDO_G 0x00: 2.85V, OFF, SLEEP_A or B, SLEEP full power */
585 #define LDO_G_SETTING 0x00
586 /* LDO_H 0x18: 2.75V, ON, SLEEP_B, SLEEP full power */
587 #define LDO_H_SETTING 0x18
588 /* LDO_K 0x00: 2.75V, OFF, SLEEP_A or B, SLEEP full power */
589 #define LDO_K_SETTING 0x00
590 /* LDO_EXT 0x00: Voltage not set, OFF, not used, not used */
591 #define LDO_EXT_SETTING 0x00
592 /* BUCK 0x7D: 1.2V, ON, SLEEP_A and B, SLEEP low power */
593 #define BUCK_SETTING 0x7D
594 /* BUCK SLEEP 0xAC: 1.05V, Not used, SLEEP_A and B, Not used */
595 #define BUCK_SLEEP_SETTING 0xAC
597 static const u8 ab3100_reg_initvals[] = {
612 static int ab3100_regulators_remove(struct platform_device *pdev)
616 for (i = 0; i < AB3100_NUM_REGULATORS; i++) {
617 struct ab3100_regulator *reg = &ab3100_regulators[i];
625 ab3100_regulator_of_probe(struct platform_device *pdev, struct device_node *np)
630 * Set up the regulator registers, as was previously done with
633 /* Set up regulators */
634 for (i = 0; i < ARRAY_SIZE(ab3100_reg_init_order); i++) {
635 err = abx500_set_register_interruptible(&pdev->dev, 0,
636 ab3100_reg_init_order[i],
637 ab3100_reg_initvals[i]);
639 dev_err(&pdev->dev, "regulator initialization failed with error %d\n",
645 for (i = 0; i < ARRAY_SIZE(ab3100_regulator_matches); i++) {
646 err = ab3100_regulator_register(
647 pdev, NULL, ab3100_regulator_matches[i].init_data,
648 ab3100_regulator_matches[i].of_node,
649 (unsigned long)ab3100_regulator_matches[i].driver_data);
651 ab3100_regulators_remove(pdev);
660 static int ab3100_regulators_probe(struct platform_device *pdev)
662 struct ab3100_platform_data *plfdata = dev_get_platdata(&pdev->dev);
663 struct device_node *np = pdev->dev.of_node;
668 /* Check chip state */
669 err = abx500_get_register_interruptible(&pdev->dev, 0,
670 AB3100_LDO_D, &data);
672 dev_err(&pdev->dev, "could not read initial status of LDO_D\n");
676 dev_notice(&pdev->dev,
677 "chip is already in active mode (Warm start)\n");
679 dev_notice(&pdev->dev,
680 "chip is in inactive mode (Cold start)\n");
683 err = of_regulator_match(&pdev->dev, np,
684 ab3100_regulator_matches,
685 ARRAY_SIZE(ab3100_regulator_matches));
688 "Error parsing regulator init data: %d\n", err);
691 return ab3100_regulator_of_probe(pdev, np);
694 /* Set up regulators */
695 for (i = 0; i < ARRAY_SIZE(ab3100_reg_init_order); i++) {
696 err = abx500_set_register_interruptible(&pdev->dev, 0,
697 ab3100_reg_init_order[i],
698 plfdata->reg_initvals[i]);
700 dev_err(&pdev->dev, "regulator initialization failed with error %d\n",
706 /* Register the regulators */
707 for (i = 0; i < AB3100_NUM_REGULATORS; i++) {
708 struct regulator_desc *desc = &ab3100_regulator_desc[i];
710 err = ab3100_regulator_register(pdev, plfdata, NULL, NULL,
713 ab3100_regulators_remove(pdev);
721 static struct platform_driver ab3100_regulators_driver = {
723 .name = "ab3100-regulators",
725 .probe = ab3100_regulators_probe,
726 .remove = ab3100_regulators_remove,
729 static __init int ab3100_regulators_init(void)
731 return platform_driver_register(&ab3100_regulators_driver);
734 static __exit void ab3100_regulators_exit(void)
736 platform_driver_unregister(&ab3100_regulators_driver);
739 subsys_initcall(ab3100_regulators_init);
740 module_exit(ab3100_regulators_exit);
742 MODULE_AUTHOR("Mattias Wallin <mattias.wallin@stericsson.com>");
743 MODULE_DESCRIPTION("AB3100 Regulator driver");
744 MODULE_LICENSE("GPL");
745 MODULE_ALIAS("platform:ab3100-regulators");