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
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
{
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
);
721 MODULE_AUTHOR("Mattias Wallin <mattias.wallin@stericsson.com>");
722 MODULE_DESCRIPTION("AB3100 Regulator driver");
723 MODULE_LICENSE("GPL");
724 MODULE_ALIAS("platform:ab3100-regulators");