2 * Battery power supply driver for X-Powers AXP20X and AXP22X PMICs
4 * Copyright 2016 Free Electrons NextThing Co.
5 * Quentin Schulz <quentin.schulz@free-electrons.com>
7 * This driver is based on a previous upstreaming attempt by:
8 * Bruno Prémont <bonbons@linux-vserver.org>
10 * This file is subject to the terms and conditions of the GNU General
11 * Public License. See the file "COPYING" in the main directory of this
12 * archive for more details.
14 * This program is distributed in the hope that it will be useful,
15 * but WITHOUT ANY WARRANTY; without even the implied warranty of
16 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17 * GNU General Public License for more details.
20 #include <linux/err.h>
21 #include <linux/interrupt.h>
22 #include <linux/irq.h>
23 #include <linux/module.h>
25 #include <linux/of_device.h>
26 #include <linux/platform_device.h>
27 #include <linux/power_supply.h>
28 #include <linux/regmap.h>
29 #include <linux/slab.h>
30 #include <linux/time.h>
31 #include <linux/iio/iio.h>
32 #include <linux/iio/consumer.h>
33 #include <linux/mfd/axp20x.h>
35 #define AXP20X_PWR_STATUS_BAT_CHARGING BIT(2)
37 #define AXP20X_PWR_OP_BATT_PRESENT BIT(5)
38 #define AXP20X_PWR_OP_BATT_ACTIVATED BIT(3)
40 #define AXP209_FG_PERCENT GENMASK(6, 0)
41 #define AXP22X_FG_VALID BIT(7)
43 #define AXP20X_CHRG_CTRL1_ENABLE BIT(7)
44 #define AXP20X_CHRG_CTRL1_TGT_VOLT GENMASK(6, 5)
45 #define AXP20X_CHRG_CTRL1_TGT_4_1V (0 << 5)
46 #define AXP20X_CHRG_CTRL1_TGT_4_15V (1 << 5)
47 #define AXP20X_CHRG_CTRL1_TGT_4_2V (2 << 5)
48 #define AXP20X_CHRG_CTRL1_TGT_4_36V (3 << 5)
50 #define AXP22X_CHRG_CTRL1_TGT_4_22V (1 << 5)
51 #define AXP22X_CHRG_CTRL1_TGT_4_24V (3 << 5)
53 #define AXP813_CHRG_CTRL1_TGT_4_35V (3 << 5)
55 #define AXP20X_CHRG_CTRL1_TGT_CURR GENMASK(3, 0)
57 #define AXP20X_V_OFF_MASK GENMASK(2, 0)
59 struct axp20x_batt_ps;
65 int (*get_max_voltage)(struct axp20x_batt_ps *batt, int *val);
66 int (*set_max_voltage)(struct axp20x_batt_ps *batt, int val);
69 struct axp20x_batt_ps {
70 struct regmap *regmap;
71 struct power_supply *batt;
73 struct iio_channel *batt_chrg_i;
74 struct iio_channel *batt_dischrg_i;
75 struct iio_channel *batt_v;
76 /* Maximum constant charge current */
78 const struct axp_data *data;
81 static int axp20x_battery_get_max_voltage(struct axp20x_batt_ps *axp20x_batt,
86 ret = regmap_read(axp20x_batt->regmap, AXP20X_CHRG_CTRL1, ®);
90 switch (reg & AXP20X_CHRG_CTRL1_TGT_VOLT) {
91 case AXP20X_CHRG_CTRL1_TGT_4_1V:
94 case AXP20X_CHRG_CTRL1_TGT_4_15V:
97 case AXP20X_CHRG_CTRL1_TGT_4_2V:
100 case AXP20X_CHRG_CTRL1_TGT_4_36V:
110 static int axp22x_battery_get_max_voltage(struct axp20x_batt_ps *axp20x_batt,
115 ret = regmap_read(axp20x_batt->regmap, AXP20X_CHRG_CTRL1, ®);
119 switch (reg & AXP20X_CHRG_CTRL1_TGT_VOLT) {
120 case AXP20X_CHRG_CTRL1_TGT_4_1V:
123 case AXP20X_CHRG_CTRL1_TGT_4_2V:
126 case AXP22X_CHRG_CTRL1_TGT_4_22V:
129 case AXP22X_CHRG_CTRL1_TGT_4_24V:
139 static int axp813_battery_get_max_voltage(struct axp20x_batt_ps *axp20x_batt,
144 ret = regmap_read(axp20x_batt->regmap, AXP20X_CHRG_CTRL1, ®);
148 switch (reg & AXP20X_CHRG_CTRL1_TGT_VOLT) {
149 case AXP20X_CHRG_CTRL1_TGT_4_1V:
152 case AXP20X_CHRG_CTRL1_TGT_4_15V:
155 case AXP20X_CHRG_CTRL1_TGT_4_2V:
158 case AXP813_CHRG_CTRL1_TGT_4_35V:
168 static int axp20x_get_constant_charge_current(struct axp20x_batt_ps *axp,
173 ret = regmap_read(axp->regmap, AXP20X_CHRG_CTRL1, val);
177 *val &= AXP20X_CHRG_CTRL1_TGT_CURR;
179 *val = *val * axp->data->ccc_scale + axp->data->ccc_offset;
184 static int axp20x_battery_get_prop(struct power_supply *psy,
185 enum power_supply_property psp,
186 union power_supply_propval *val)
188 struct axp20x_batt_ps *axp20x_batt = power_supply_get_drvdata(psy);
189 struct iio_channel *chan;
190 int ret = 0, reg, val1;
193 case POWER_SUPPLY_PROP_PRESENT:
194 case POWER_SUPPLY_PROP_ONLINE:
195 ret = regmap_read(axp20x_batt->regmap, AXP20X_PWR_OP_MODE,
200 val->intval = !!(reg & AXP20X_PWR_OP_BATT_PRESENT);
203 case POWER_SUPPLY_PROP_STATUS:
204 ret = regmap_read(axp20x_batt->regmap, AXP20X_PWR_INPUT_STATUS,
209 if (reg & AXP20X_PWR_STATUS_BAT_CHARGING) {
210 val->intval = POWER_SUPPLY_STATUS_CHARGING;
214 ret = iio_read_channel_processed(axp20x_batt->batt_dischrg_i,
220 val->intval = POWER_SUPPLY_STATUS_DISCHARGING;
224 ret = regmap_read(axp20x_batt->regmap, AXP20X_FG_RES, &val1);
229 * Fuel Gauge data takes 7 bits but the stored value seems to be
230 * directly the raw percentage without any scaling to 7 bits.
232 if ((val1 & AXP209_FG_PERCENT) == 100)
233 val->intval = POWER_SUPPLY_STATUS_FULL;
235 val->intval = POWER_SUPPLY_STATUS_NOT_CHARGING;
238 case POWER_SUPPLY_PROP_HEALTH:
239 ret = regmap_read(axp20x_batt->regmap, AXP20X_PWR_OP_MODE,
244 if (val1 & AXP20X_PWR_OP_BATT_ACTIVATED) {
245 val->intval = POWER_SUPPLY_HEALTH_DEAD;
249 val->intval = POWER_SUPPLY_HEALTH_GOOD;
252 case POWER_SUPPLY_PROP_CONSTANT_CHARGE_CURRENT:
253 ret = axp20x_get_constant_charge_current(axp20x_batt,
259 case POWER_SUPPLY_PROP_CONSTANT_CHARGE_CURRENT_MAX:
260 val->intval = axp20x_batt->max_ccc;
263 case POWER_SUPPLY_PROP_CURRENT_NOW:
264 ret = regmap_read(axp20x_batt->regmap, AXP20X_PWR_INPUT_STATUS,
269 if (reg & AXP20X_PWR_STATUS_BAT_CHARGING)
270 chan = axp20x_batt->batt_chrg_i;
272 chan = axp20x_batt->batt_dischrg_i;
274 ret = iio_read_channel_processed(chan, &val->intval);
278 /* IIO framework gives mA but Power Supply framework gives uA */
282 case POWER_SUPPLY_PROP_CAPACITY:
283 /* When no battery is present, return capacity is 100% */
284 ret = regmap_read(axp20x_batt->regmap, AXP20X_PWR_OP_MODE,
289 if (!(reg & AXP20X_PWR_OP_BATT_PRESENT)) {
294 ret = regmap_read(axp20x_batt->regmap, AXP20X_FG_RES, ®);
298 if (axp20x_batt->data->has_fg_valid && !(reg & AXP22X_FG_VALID))
302 * Fuel Gauge data takes 7 bits but the stored value seems to be
303 * directly the raw percentage without any scaling to 7 bits.
305 val->intval = reg & AXP209_FG_PERCENT;
308 case POWER_SUPPLY_PROP_VOLTAGE_MAX_DESIGN:
309 return axp20x_batt->data->get_max_voltage(axp20x_batt,
312 case POWER_SUPPLY_PROP_VOLTAGE_MIN_DESIGN:
313 ret = regmap_read(axp20x_batt->regmap, AXP20X_V_OFF, ®);
317 val->intval = 2600000 + 100000 * (reg & AXP20X_V_OFF_MASK);
320 case POWER_SUPPLY_PROP_VOLTAGE_NOW:
321 ret = iio_read_channel_processed(axp20x_batt->batt_v,
326 /* IIO framework gives mV but Power Supply framework gives uV */
337 static int axp22x_battery_set_max_voltage(struct axp20x_batt_ps *axp20x_batt,
342 val = AXP20X_CHRG_CTRL1_TGT_4_1V;
346 val = AXP20X_CHRG_CTRL1_TGT_4_2V;
351 * AXP20x max voltage can be set to 4.36V and AXP22X max voltage
352 * can be set to 4.22V and 4.24V, but these voltages are too
353 * high for Lithium based batteries (AXP PMICs are supposed to
354 * be used with these kinds of battery).
359 return regmap_update_bits(axp20x_batt->regmap, AXP20X_CHRG_CTRL1,
360 AXP20X_CHRG_CTRL1_TGT_VOLT, val);
363 static int axp20x_battery_set_max_voltage(struct axp20x_batt_ps *axp20x_batt,
368 val = AXP20X_CHRG_CTRL1_TGT_4_1V;
372 val = AXP20X_CHRG_CTRL1_TGT_4_15V;
376 val = AXP20X_CHRG_CTRL1_TGT_4_2V;
381 * AXP20x max voltage can be set to 4.36V and AXP22X max voltage
382 * can be set to 4.22V and 4.24V, but these voltages are too
383 * high for Lithium based batteries (AXP PMICs are supposed to
384 * be used with these kinds of battery).
389 return regmap_update_bits(axp20x_batt->regmap, AXP20X_CHRG_CTRL1,
390 AXP20X_CHRG_CTRL1_TGT_VOLT, val);
393 static int axp20x_set_constant_charge_current(struct axp20x_batt_ps *axp_batt,
396 if (charge_current > axp_batt->max_ccc)
399 charge_current = (charge_current - axp_batt->data->ccc_offset) /
400 axp_batt->data->ccc_scale;
402 if (charge_current > AXP20X_CHRG_CTRL1_TGT_CURR || charge_current < 0)
405 return regmap_update_bits(axp_batt->regmap, AXP20X_CHRG_CTRL1,
406 AXP20X_CHRG_CTRL1_TGT_CURR, charge_current);
409 static int axp20x_set_max_constant_charge_current(struct axp20x_batt_ps *axp,
412 bool lower_max = false;
414 charge_current = (charge_current - axp->data->ccc_offset) /
415 axp->data->ccc_scale;
417 if (charge_current > AXP20X_CHRG_CTRL1_TGT_CURR || charge_current < 0)
420 charge_current = charge_current * axp->data->ccc_scale +
421 axp->data->ccc_offset;
423 if (charge_current > axp->max_ccc)
425 "Setting max constant charge current higher than previously defined. Note that increasing the constant charge current may damage your battery.\n");
429 axp->max_ccc = charge_current;
434 axp20x_get_constant_charge_current(axp, ¤t_cc);
435 if (current_cc > charge_current)
436 axp20x_set_constant_charge_current(axp, charge_current);
441 static int axp20x_set_voltage_min_design(struct axp20x_batt_ps *axp_batt,
444 int val1 = (min_voltage - 2600000) / 100000;
446 if (val1 < 0 || val1 > AXP20X_V_OFF_MASK)
449 return regmap_update_bits(axp_batt->regmap, AXP20X_V_OFF,
450 AXP20X_V_OFF_MASK, val1);
453 static int axp20x_battery_set_prop(struct power_supply *psy,
454 enum power_supply_property psp,
455 const union power_supply_propval *val)
457 struct axp20x_batt_ps *axp20x_batt = power_supply_get_drvdata(psy);
460 case POWER_SUPPLY_PROP_VOLTAGE_MIN_DESIGN:
461 return axp20x_set_voltage_min_design(axp20x_batt, val->intval);
463 case POWER_SUPPLY_PROP_VOLTAGE_MAX_DESIGN:
464 return axp20x_batt->data->set_max_voltage(axp20x_batt, val->intval);
466 case POWER_SUPPLY_PROP_CONSTANT_CHARGE_CURRENT:
467 return axp20x_set_constant_charge_current(axp20x_batt,
469 case POWER_SUPPLY_PROP_CONSTANT_CHARGE_CURRENT_MAX:
470 return axp20x_set_max_constant_charge_current(axp20x_batt,
472 case POWER_SUPPLY_PROP_STATUS:
473 switch (val->intval) {
474 case POWER_SUPPLY_STATUS_CHARGING:
475 return regmap_update_bits(axp20x_batt->regmap, AXP20X_CHRG_CTRL1,
476 AXP20X_CHRG_CTRL1_ENABLE, AXP20X_CHRG_CTRL1_ENABLE);
478 case POWER_SUPPLY_STATUS_DISCHARGING:
479 case POWER_SUPPLY_STATUS_NOT_CHARGING:
480 return regmap_update_bits(axp20x_batt->regmap, AXP20X_CHRG_CTRL1,
481 AXP20X_CHRG_CTRL1_ENABLE, 0);
489 static enum power_supply_property axp20x_battery_props[] = {
490 POWER_SUPPLY_PROP_PRESENT,
491 POWER_SUPPLY_PROP_ONLINE,
492 POWER_SUPPLY_PROP_STATUS,
493 POWER_SUPPLY_PROP_VOLTAGE_NOW,
494 POWER_SUPPLY_PROP_CURRENT_NOW,
495 POWER_SUPPLY_PROP_CONSTANT_CHARGE_CURRENT,
496 POWER_SUPPLY_PROP_CONSTANT_CHARGE_CURRENT_MAX,
497 POWER_SUPPLY_PROP_HEALTH,
498 POWER_SUPPLY_PROP_VOLTAGE_MAX_DESIGN,
499 POWER_SUPPLY_PROP_VOLTAGE_MIN_DESIGN,
500 POWER_SUPPLY_PROP_CAPACITY,
503 static int axp20x_battery_prop_writeable(struct power_supply *psy,
504 enum power_supply_property psp)
506 return psp == POWER_SUPPLY_PROP_STATUS ||
507 psp == POWER_SUPPLY_PROP_VOLTAGE_MIN_DESIGN ||
508 psp == POWER_SUPPLY_PROP_VOLTAGE_MAX_DESIGN ||
509 psp == POWER_SUPPLY_PROP_CONSTANT_CHARGE_CURRENT ||
510 psp == POWER_SUPPLY_PROP_CONSTANT_CHARGE_CURRENT_MAX;
513 static const struct power_supply_desc axp20x_batt_ps_desc = {
514 .name = "axp20x-battery",
515 .type = POWER_SUPPLY_TYPE_BATTERY,
516 .properties = axp20x_battery_props,
517 .num_properties = ARRAY_SIZE(axp20x_battery_props),
518 .property_is_writeable = axp20x_battery_prop_writeable,
519 .get_property = axp20x_battery_get_prop,
520 .set_property = axp20x_battery_set_prop,
523 static const struct axp_data axp209_data = {
525 .ccc_offset = 300000,
526 .get_max_voltage = axp20x_battery_get_max_voltage,
527 .set_max_voltage = axp20x_battery_set_max_voltage,
530 static const struct axp_data axp221_data = {
532 .ccc_offset = 300000,
533 .has_fg_valid = true,
534 .get_max_voltage = axp22x_battery_get_max_voltage,
535 .set_max_voltage = axp22x_battery_set_max_voltage,
538 static const struct axp_data axp813_data = {
540 .ccc_offset = 200000,
541 .has_fg_valid = true,
542 .get_max_voltage = axp813_battery_get_max_voltage,
543 .set_max_voltage = axp20x_battery_set_max_voltage,
546 static const struct of_device_id axp20x_battery_ps_id[] = {
548 .compatible = "x-powers,axp209-battery-power-supply",
549 .data = (void *)&axp209_data,
551 .compatible = "x-powers,axp221-battery-power-supply",
552 .data = (void *)&axp221_data,
554 .compatible = "x-powers,axp813-battery-power-supply",
555 .data = (void *)&axp813_data,
556 }, { /* sentinel */ },
558 MODULE_DEVICE_TABLE(of, axp20x_battery_ps_id);
560 static int axp20x_power_probe(struct platform_device *pdev)
562 struct axp20x_batt_ps *axp20x_batt;
563 struct power_supply_config psy_cfg = {};
564 struct power_supply_battery_info info;
565 struct device *dev = &pdev->dev;
567 if (!of_device_is_available(pdev->dev.of_node))
570 axp20x_batt = devm_kzalloc(&pdev->dev, sizeof(*axp20x_batt),
575 axp20x_batt->dev = &pdev->dev;
577 axp20x_batt->batt_v = devm_iio_channel_get(&pdev->dev, "batt_v");
578 if (IS_ERR(axp20x_batt->batt_v)) {
579 if (PTR_ERR(axp20x_batt->batt_v) == -ENODEV)
580 return -EPROBE_DEFER;
581 return PTR_ERR(axp20x_batt->batt_v);
584 axp20x_batt->batt_chrg_i = devm_iio_channel_get(&pdev->dev,
586 if (IS_ERR(axp20x_batt->batt_chrg_i)) {
587 if (PTR_ERR(axp20x_batt->batt_chrg_i) == -ENODEV)
588 return -EPROBE_DEFER;
589 return PTR_ERR(axp20x_batt->batt_chrg_i);
592 axp20x_batt->batt_dischrg_i = devm_iio_channel_get(&pdev->dev,
594 if (IS_ERR(axp20x_batt->batt_dischrg_i)) {
595 if (PTR_ERR(axp20x_batt->batt_dischrg_i) == -ENODEV)
596 return -EPROBE_DEFER;
597 return PTR_ERR(axp20x_batt->batt_dischrg_i);
600 axp20x_batt->regmap = dev_get_regmap(pdev->dev.parent, NULL);
601 platform_set_drvdata(pdev, axp20x_batt);
603 psy_cfg.drv_data = axp20x_batt;
604 psy_cfg.of_node = pdev->dev.of_node;
606 axp20x_batt->data = (struct axp_data *)of_device_get_match_data(dev);
608 axp20x_batt->batt = devm_power_supply_register(&pdev->dev,
609 &axp20x_batt_ps_desc,
611 if (IS_ERR(axp20x_batt->batt)) {
612 dev_err(&pdev->dev, "failed to register power supply: %ld\n",
613 PTR_ERR(axp20x_batt->batt));
614 return PTR_ERR(axp20x_batt->batt);
617 if (!power_supply_get_battery_info(axp20x_batt->batt, &info)) {
618 int vmin = info.voltage_min_design_uv;
619 int ccc = info.constant_charge_current_max_ua;
621 if (vmin > 0 && axp20x_set_voltage_min_design(axp20x_batt,
624 "couldn't set voltage_min_design\n");
626 /* Set max to unverified value to be able to set CCC */
627 axp20x_batt->max_ccc = ccc;
629 if (ccc <= 0 || axp20x_set_constant_charge_current(axp20x_batt,
632 "couldn't set constant charge current from DT: fallback to minimum value\n");
634 axp20x_batt->max_ccc = ccc;
635 axp20x_set_constant_charge_current(axp20x_batt, ccc);
640 * Update max CCC to a valid value if battery info is present or set it
641 * to current register value by default.
643 axp20x_get_constant_charge_current(axp20x_batt,
644 &axp20x_batt->max_ccc);
649 static struct platform_driver axp20x_batt_driver = {
650 .probe = axp20x_power_probe,
652 .name = "axp20x-battery-power-supply",
653 .of_match_table = axp20x_battery_ps_id,
657 module_platform_driver(axp20x_batt_driver);
659 MODULE_DESCRIPTION("Battery power supply driver for AXP20X and AXP22X PMICs");
660 MODULE_AUTHOR("Quentin Schulz <quentin.schulz@free-electrons.com>");
661 MODULE_LICENSE("GPL");