2 * TI LP8788 MFD - battery charger driver
4 * Copyright 2012 Texas Instruments
6 * Author: Milo(Woogyom) Kim <milo.kim@ti.com>
8 * This program is free software; you can redistribute it and/or modify
9 * it under the terms of the GNU General Public License version 2 as
10 * published by the Free Software Foundation.
14 #include <linux/err.h>
15 #include <linux/iio/consumer.h>
16 #include <linux/interrupt.h>
17 #include <linux/irqdomain.h>
18 #include <linux/mfd/lp8788.h>
19 #include <linux/module.h>
20 #include <linux/platform_device.h>
21 #include <linux/power_supply.h>
22 #include <linux/slab.h>
23 #include <linux/workqueue.h>
25 /* register address */
26 #define LP8788_CHG_STATUS 0x07
27 #define LP8788_CHG_IDCIN 0x13
28 #define LP8788_CHG_IBATT 0x14
29 #define LP8788_CHG_VTERM 0x15
30 #define LP8788_CHG_EOC 0x16
33 #define LP8788_CHG_INPUT_STATE_M 0x03 /* Addr 07h */
34 #define LP8788_CHG_STATE_M 0x3C
35 #define LP8788_CHG_STATE_S 2
36 #define LP8788_NO_BATT_M BIT(6)
37 #define LP8788_BAD_BATT_M BIT(7)
38 #define LP8788_CHG_IBATT_M 0x1F /* Addr 14h */
39 #define LP8788_CHG_VTERM_M 0x0F /* Addr 15h */
40 #define LP8788_CHG_EOC_LEVEL_M 0x30 /* Addr 16h */
41 #define LP8788_CHG_EOC_LEVEL_S 4
42 #define LP8788_CHG_EOC_TIME_M 0x0E
43 #define LP8788_CHG_EOC_TIME_S 1
44 #define LP8788_CHG_EOC_MODE_M BIT(0)
46 #define LP8788_CHARGER_NAME "charger"
47 #define LP8788_BATTERY_NAME "main_batt"
49 #define LP8788_CHG_START 0x11
50 #define LP8788_CHG_END 0x1C
52 #define LP8788_ISEL_MAX 23
53 #define LP8788_ISEL_STEP 50
54 #define LP8788_VTERM_MIN 4100
55 #define LP8788_VTERM_STEP 25
56 #define LP8788_MAX_BATT_CAPACITY 100
57 #define LP8788_MAX_CHG_IRQS 11
59 enum lp8788_charging_state
{
62 LP8788_LOW_INPUT
= 0x3,
68 LP8788_SYSTEM_SUPPORT
= 0xC,
69 LP8788_HIGH_CURRENT
= 0xF,
73 enum lp8788_charger_adc_sel
{
79 enum lp8788_charger_input_state
{
80 LP8788_SYSTEM_SUPPLY
= 1,
85 * struct lp8788_chg_irq
86 * @which : lp8788 interrupt id
87 * @virq : Linux IRQ number from irq_domain
89 struct lp8788_chg_irq
{
90 enum lp8788_int_id which
;
95 * struct lp8788_charger
96 * @lp : used for accessing the registers of mfd lp8788 device
97 * @charger : power supply driver for the battery charger
98 * @battery : power supply driver for the battery
99 * @charger_work : work queue for charger input interrupts
100 * @chan : iio channels for getting adc values
101 * eg) battery voltage, capacity and temperature
102 * @irqs : charger dedicated interrupts
103 * @num_irqs : total numbers of charger interrupts
104 * @pdata : charger platform specific data
106 struct lp8788_charger
{
108 struct power_supply
*charger
;
109 struct power_supply
*battery
;
110 struct work_struct charger_work
;
111 struct iio_channel
*chan
[LP8788_NUM_CHG_ADC
];
112 struct lp8788_chg_irq irqs
[LP8788_MAX_CHG_IRQS
];
114 struct lp8788_charger_platform_data
*pdata
;
117 static char *battery_supplied_to
[] = {
121 static enum power_supply_property lp8788_charger_prop
[] = {
122 POWER_SUPPLY_PROP_ONLINE
,
123 POWER_SUPPLY_PROP_CURRENT_MAX
,
126 static enum power_supply_property lp8788_battery_prop
[] = {
127 POWER_SUPPLY_PROP_STATUS
,
128 POWER_SUPPLY_PROP_HEALTH
,
129 POWER_SUPPLY_PROP_PRESENT
,
130 POWER_SUPPLY_PROP_VOLTAGE_NOW
,
131 POWER_SUPPLY_PROP_CAPACITY
,
132 POWER_SUPPLY_PROP_CONSTANT_CHARGE_CURRENT
,
133 POWER_SUPPLY_PROP_CONSTANT_CHARGE_VOLTAGE_MAX
,
134 POWER_SUPPLY_PROP_TEMP
,
137 static bool lp8788_is_charger_detected(struct lp8788_charger
*pchg
)
141 lp8788_read_byte(pchg
->lp
, LP8788_CHG_STATUS
, &data
);
142 data
&= LP8788_CHG_INPUT_STATE_M
;
144 return data
== LP8788_SYSTEM_SUPPLY
|| data
== LP8788_FULL_FUNCTION
;
147 static int lp8788_charger_get_property(struct power_supply
*psy
,
148 enum power_supply_property psp
,
149 union power_supply_propval
*val
)
151 struct lp8788_charger
*pchg
= dev_get_drvdata(psy
->dev
.parent
);
155 case POWER_SUPPLY_PROP_ONLINE
:
156 val
->intval
= lp8788_is_charger_detected(pchg
);
158 case POWER_SUPPLY_PROP_CURRENT_MAX
:
159 lp8788_read_byte(pchg
->lp
, LP8788_CHG_IDCIN
, &read
);
160 val
->intval
= LP8788_ISEL_STEP
*
161 (min_t(int, read
, LP8788_ISEL_MAX
) + 1);
170 static int lp8788_get_battery_status(struct lp8788_charger
*pchg
,
171 union power_supply_propval
*val
)
173 enum lp8788_charging_state state
;
177 ret
= lp8788_read_byte(pchg
->lp
, LP8788_CHG_STATUS
, &data
);
181 state
= (data
& LP8788_CHG_STATE_M
) >> LP8788_CHG_STATE_S
;
184 val
->intval
= POWER_SUPPLY_STATUS_DISCHARGING
;
186 case LP8788_PRECHARGE
:
189 case LP8788_HIGH_CURRENT
:
190 val
->intval
= POWER_SUPPLY_STATUS_CHARGING
;
192 case LP8788_MAINTENANCE
:
193 val
->intval
= POWER_SUPPLY_STATUS_FULL
;
196 val
->intval
= POWER_SUPPLY_STATUS_NOT_CHARGING
;
203 static int lp8788_get_battery_health(struct lp8788_charger
*pchg
,
204 union power_supply_propval
*val
)
209 ret
= lp8788_read_byte(pchg
->lp
, LP8788_CHG_STATUS
, &data
);
213 if (data
& LP8788_NO_BATT_M
)
214 val
->intval
= POWER_SUPPLY_HEALTH_UNSPEC_FAILURE
;
215 else if (data
& LP8788_BAD_BATT_M
)
216 val
->intval
= POWER_SUPPLY_HEALTH_DEAD
;
218 val
->intval
= POWER_SUPPLY_HEALTH_GOOD
;
223 static int lp8788_get_battery_present(struct lp8788_charger
*pchg
,
224 union power_supply_propval
*val
)
229 ret
= lp8788_read_byte(pchg
->lp
, LP8788_CHG_STATUS
, &data
);
233 val
->intval
= !(data
& LP8788_NO_BATT_M
);
237 static int lp8788_get_vbatt_adc(struct lp8788_charger
*pchg
, int *result
)
239 struct iio_channel
*channel
= pchg
->chan
[LP8788_VBATT
];
244 return iio_read_channel_processed(channel
, result
);
247 static int lp8788_get_battery_voltage(struct lp8788_charger
*pchg
,
248 union power_supply_propval
*val
)
250 return lp8788_get_vbatt_adc(pchg
, &val
->intval
);
253 static int lp8788_get_battery_capacity(struct lp8788_charger
*pchg
,
254 union power_supply_propval
*val
)
256 struct lp8788
*lp
= pchg
->lp
;
257 struct lp8788_charger_platform_data
*pdata
= pchg
->pdata
;
258 unsigned int max_vbatt
;
260 enum lp8788_charging_state state
;
267 max_vbatt
= pdata
->max_vbatt_mv
;
271 ret
= lp8788_read_byte(lp
, LP8788_CHG_STATUS
, &data
);
275 state
= (data
& LP8788_CHG_STATE_M
) >> LP8788_CHG_STATE_S
;
277 if (state
== LP8788_MAINTENANCE
) {
278 val
->intval
= LP8788_MAX_BATT_CAPACITY
;
280 ret
= lp8788_get_vbatt_adc(pchg
, &vbatt
);
284 val
->intval
= (vbatt
* LP8788_MAX_BATT_CAPACITY
) / max_vbatt
;
285 val
->intval
= min(val
->intval
, LP8788_MAX_BATT_CAPACITY
);
291 static int lp8788_get_battery_temperature(struct lp8788_charger
*pchg
,
292 union power_supply_propval
*val
)
294 struct iio_channel
*channel
= pchg
->chan
[LP8788_BATT_TEMP
];
301 ret
= iio_read_channel_processed(channel
, &result
);
306 val
->intval
= result
* 10;
311 static int lp8788_get_battery_charging_current(struct lp8788_charger
*pchg
,
312 union power_supply_propval
*val
)
316 lp8788_read_byte(pchg
->lp
, LP8788_CHG_IBATT
, &read
);
317 read
&= LP8788_CHG_IBATT_M
;
318 val
->intval
= LP8788_ISEL_STEP
*
319 (min_t(int, read
, LP8788_ISEL_MAX
) + 1);
324 static int lp8788_get_charging_termination_voltage(struct lp8788_charger
*pchg
,
325 union power_supply_propval
*val
)
329 lp8788_read_byte(pchg
->lp
, LP8788_CHG_VTERM
, &read
);
330 read
&= LP8788_CHG_VTERM_M
;
331 val
->intval
= LP8788_VTERM_MIN
+ LP8788_VTERM_STEP
* read
;
336 static int lp8788_battery_get_property(struct power_supply
*psy
,
337 enum power_supply_property psp
,
338 union power_supply_propval
*val
)
340 struct lp8788_charger
*pchg
= dev_get_drvdata(psy
->dev
.parent
);
343 case POWER_SUPPLY_PROP_STATUS
:
344 return lp8788_get_battery_status(pchg
, val
);
345 case POWER_SUPPLY_PROP_HEALTH
:
346 return lp8788_get_battery_health(pchg
, val
);
347 case POWER_SUPPLY_PROP_PRESENT
:
348 return lp8788_get_battery_present(pchg
, val
);
349 case POWER_SUPPLY_PROP_VOLTAGE_NOW
:
350 return lp8788_get_battery_voltage(pchg
, val
);
351 case POWER_SUPPLY_PROP_CAPACITY
:
352 return lp8788_get_battery_capacity(pchg
, val
);
353 case POWER_SUPPLY_PROP_TEMP
:
354 return lp8788_get_battery_temperature(pchg
, val
);
355 case POWER_SUPPLY_PROP_CONSTANT_CHARGE_CURRENT
:
356 return lp8788_get_battery_charging_current(pchg
, val
);
357 case POWER_SUPPLY_PROP_CONSTANT_CHARGE_VOLTAGE_MAX
:
358 return lp8788_get_charging_termination_voltage(pchg
, val
);
364 static inline bool lp8788_is_valid_charger_register(u8 addr
)
366 return addr
>= LP8788_CHG_START
&& addr
<= LP8788_CHG_END
;
369 static int lp8788_update_charger_params(struct platform_device
*pdev
,
370 struct lp8788_charger
*pchg
)
372 struct lp8788
*lp
= pchg
->lp
;
373 struct lp8788_charger_platform_data
*pdata
= pchg
->pdata
;
374 struct lp8788_chg_param
*param
;
378 if (!pdata
|| !pdata
->chg_params
) {
379 dev_info(&pdev
->dev
, "skip updating charger parameters\n");
383 /* settting charging parameters */
384 for (i
= 0; i
< pdata
->num_chg_params
; i
++) {
385 param
= pdata
->chg_params
+ i
;
387 if (lp8788_is_valid_charger_register(param
->addr
)) {
388 ret
= lp8788_write_byte(lp
, param
->addr
, param
->val
);
397 static const struct power_supply_desc lp8788_psy_charger_desc
= {
398 .name
= LP8788_CHARGER_NAME
,
399 .type
= POWER_SUPPLY_TYPE_MAINS
,
400 .properties
= lp8788_charger_prop
,
401 .num_properties
= ARRAY_SIZE(lp8788_charger_prop
),
402 .get_property
= lp8788_charger_get_property
,
405 static const struct power_supply_desc lp8788_psy_battery_desc
= {
406 .name
= LP8788_BATTERY_NAME
,
407 .type
= POWER_SUPPLY_TYPE_BATTERY
,
408 .properties
= lp8788_battery_prop
,
409 .num_properties
= ARRAY_SIZE(lp8788_battery_prop
),
410 .get_property
= lp8788_battery_get_property
,
413 static int lp8788_psy_register(struct platform_device
*pdev
,
414 struct lp8788_charger
*pchg
)
416 struct power_supply_config charger_cfg
= {};
418 charger_cfg
.supplied_to
= battery_supplied_to
;
419 charger_cfg
.num_supplicants
= ARRAY_SIZE(battery_supplied_to
);
421 pchg
->charger
= power_supply_register(&pdev
->dev
,
422 &lp8788_psy_charger_desc
,
424 if (IS_ERR(pchg
->charger
))
427 pchg
->battery
= power_supply_register(&pdev
->dev
,
428 &lp8788_psy_battery_desc
, NULL
);
429 if (IS_ERR(pchg
->battery
)) {
430 power_supply_unregister(pchg
->charger
);
437 static void lp8788_psy_unregister(struct lp8788_charger
*pchg
)
439 power_supply_unregister(pchg
->battery
);
440 power_supply_unregister(pchg
->charger
);
443 static void lp8788_charger_event(struct work_struct
*work
)
445 struct lp8788_charger
*pchg
=
446 container_of(work
, struct lp8788_charger
, charger_work
);
447 struct lp8788_charger_platform_data
*pdata
= pchg
->pdata
;
448 enum lp8788_charger_event event
= lp8788_is_charger_detected(pchg
);
450 pdata
->charger_event(pchg
->lp
, event
);
453 static bool lp8788_find_irq_id(struct lp8788_charger
*pchg
, int virq
, int *id
)
458 for (i
= 0; i
< pchg
->num_irqs
; i
++) {
459 if (pchg
->irqs
[i
].virq
== virq
) {
460 *id
= pchg
->irqs
[i
].which
;
469 static irqreturn_t
lp8788_charger_irq_thread(int virq
, void *ptr
)
471 struct lp8788_charger
*pchg
= ptr
;
472 struct lp8788_charger_platform_data
*pdata
= pchg
->pdata
;
475 if (!lp8788_find_irq_id(pchg
, virq
, &id
))
479 case LP8788_INT_CHG_INPUT_STATE
:
480 case LP8788_INT_CHG_STATE
:
482 case LP8788_INT_BATT_LOW
:
483 case LP8788_INT_NO_BATT
:
484 power_supply_changed(pchg
->charger
);
485 power_supply_changed(pchg
->battery
);
491 /* report charger dectection event if used */
495 if (pdata
->charger_event
&& id
== LP8788_INT_CHG_INPUT_STATE
)
496 schedule_work(&pchg
->charger_work
);
502 static int lp8788_set_irqs(struct platform_device
*pdev
,
503 struct lp8788_charger
*pchg
, const char *name
)
506 struct irq_domain
*irqdm
= pchg
->lp
->irqdm
;
514 /* no error even if no irq resource */
515 r
= platform_get_resource_byname(pdev
, IORESOURCE_IRQ
, name
);
519 irq_start
= r
->start
;
522 for (i
= irq_start
; i
<= irq_end
; i
++) {
523 nr_irq
= pchg
->num_irqs
;
525 virq
= irq_create_mapping(irqdm
, i
);
526 pchg
->irqs
[nr_irq
].virq
= virq
;
527 pchg
->irqs
[nr_irq
].which
= i
;
530 ret
= request_threaded_irq(virq
, NULL
,
531 lp8788_charger_irq_thread
,
543 for (i
= 0; i
< pchg
->num_irqs
; i
++)
544 free_irq(pchg
->irqs
[i
].virq
, pchg
);
548 static int lp8788_irq_register(struct platform_device
*pdev
,
549 struct lp8788_charger
*pchg
)
551 const char *name
[] = {
552 LP8788_CHG_IRQ
, LP8788_PRSW_IRQ
, LP8788_BATT_IRQ
557 INIT_WORK(&pchg
->charger_work
, lp8788_charger_event
);
560 for (i
= 0; i
< ARRAY_SIZE(name
); i
++) {
561 ret
= lp8788_set_irqs(pdev
, pchg
, name
[i
]);
563 dev_warn(&pdev
->dev
, "irq setup failed: %s\n", name
[i
]);
568 if (pchg
->num_irqs
> LP8788_MAX_CHG_IRQS
) {
569 dev_err(&pdev
->dev
, "invalid total number of irqs: %d\n",
578 static void lp8788_irq_unregister(struct platform_device
*pdev
,
579 struct lp8788_charger
*pchg
)
584 for (i
= 0; i
< pchg
->num_irqs
; i
++) {
585 irq
= pchg
->irqs
[i
].virq
;
593 static void lp8788_setup_adc_channel(struct device
*dev
,
594 struct lp8788_charger
*pchg
)
596 struct lp8788_charger_platform_data
*pdata
= pchg
->pdata
;
597 struct iio_channel
*chan
;
602 /* ADC channel for battery voltage */
603 chan
= iio_channel_get(dev
, pdata
->adc_vbatt
);
604 pchg
->chan
[LP8788_VBATT
] = IS_ERR(chan
) ? NULL
: chan
;
606 /* ADC channel for battery temperature */
607 chan
= iio_channel_get(dev
, pdata
->adc_batt_temp
);
608 pchg
->chan
[LP8788_BATT_TEMP
] = IS_ERR(chan
) ? NULL
: chan
;
611 static void lp8788_release_adc_channel(struct lp8788_charger
*pchg
)
615 for (i
= 0; i
< LP8788_NUM_CHG_ADC
; i
++) {
619 iio_channel_release(pchg
->chan
[i
]);
620 pchg
->chan
[i
] = NULL
;
624 static ssize_t
lp8788_show_charger_status(struct device
*dev
,
625 struct device_attribute
*attr
, char *buf
)
627 struct lp8788_charger
*pchg
= dev_get_drvdata(dev
);
628 enum lp8788_charging_state state
;
629 char *desc
[LP8788_MAX_CHG_STATE
] = {
630 [LP8788_OFF
] = "CHARGER OFF",
631 [LP8788_WARM_UP
] = "WARM UP",
632 [LP8788_LOW_INPUT
] = "LOW INPUT STATE",
633 [LP8788_PRECHARGE
] = "CHARGING - PRECHARGE",
634 [LP8788_CC
] = "CHARGING - CC",
635 [LP8788_CV
] = "CHARGING - CV",
636 [LP8788_MAINTENANCE
] = "NO CHARGING - MAINTENANCE",
637 [LP8788_BATTERY_FAULT
] = "BATTERY FAULT",
638 [LP8788_SYSTEM_SUPPORT
] = "SYSTEM SUPPORT",
639 [LP8788_HIGH_CURRENT
] = "HIGH CURRENT",
643 lp8788_read_byte(pchg
->lp
, LP8788_CHG_STATUS
, &data
);
644 state
= (data
& LP8788_CHG_STATE_M
) >> LP8788_CHG_STATE_S
;
646 return scnprintf(buf
, PAGE_SIZE
, "%s\n", desc
[state
]);
649 static ssize_t
lp8788_show_eoc_time(struct device
*dev
,
650 struct device_attribute
*attr
, char *buf
)
652 struct lp8788_charger
*pchg
= dev_get_drvdata(dev
);
653 char *stime
[] = { "400ms", "5min", "10min", "15min",
654 "20min", "25min", "30min", "No timeout" };
657 lp8788_read_byte(pchg
->lp
, LP8788_CHG_EOC
, &val
);
658 val
= (val
& LP8788_CHG_EOC_TIME_M
) >> LP8788_CHG_EOC_TIME_S
;
660 return scnprintf(buf
, PAGE_SIZE
, "End Of Charge Time: %s\n",
664 static ssize_t
lp8788_show_eoc_level(struct device
*dev
,
665 struct device_attribute
*attr
, char *buf
)
667 struct lp8788_charger
*pchg
= dev_get_drvdata(dev
);
668 char *abs_level
[] = { "25mA", "49mA", "75mA", "98mA" };
669 char *relative_level
[] = { "5%", "10%", "15%", "20%" };
674 lp8788_read_byte(pchg
->lp
, LP8788_CHG_EOC
, &val
);
676 mode
= val
& LP8788_CHG_EOC_MODE_M
;
677 val
= (val
& LP8788_CHG_EOC_LEVEL_M
) >> LP8788_CHG_EOC_LEVEL_S
;
678 level
= mode
? abs_level
[val
] : relative_level
[val
];
680 return scnprintf(buf
, PAGE_SIZE
, "End Of Charge Level: %s\n", level
);
683 static DEVICE_ATTR(charger_status
, S_IRUSR
, lp8788_show_charger_status
, NULL
);
684 static DEVICE_ATTR(eoc_time
, S_IRUSR
, lp8788_show_eoc_time
, NULL
);
685 static DEVICE_ATTR(eoc_level
, S_IRUSR
, lp8788_show_eoc_level
, NULL
);
687 static struct attribute
*lp8788_charger_attr
[] = {
688 &dev_attr_charger_status
.attr
,
689 &dev_attr_eoc_time
.attr
,
690 &dev_attr_eoc_level
.attr
,
694 static const struct attribute_group lp8788_attr_group
= {
695 .attrs
= lp8788_charger_attr
,
698 static int lp8788_charger_probe(struct platform_device
*pdev
)
700 struct lp8788
*lp
= dev_get_drvdata(pdev
->dev
.parent
);
701 struct lp8788_charger
*pchg
;
702 struct device
*dev
= &pdev
->dev
;
705 pchg
= devm_kzalloc(dev
, sizeof(struct lp8788_charger
), GFP_KERNEL
);
710 pchg
->pdata
= lp
->pdata
? lp
->pdata
->chg_pdata
: NULL
;
711 platform_set_drvdata(pdev
, pchg
);
713 ret
= lp8788_update_charger_params(pdev
, pchg
);
717 lp8788_setup_adc_channel(&pdev
->dev
, pchg
);
719 ret
= lp8788_psy_register(pdev
, pchg
);
723 ret
= sysfs_create_group(&pdev
->dev
.kobj
, &lp8788_attr_group
);
725 lp8788_psy_unregister(pchg
);
729 ret
= lp8788_irq_register(pdev
, pchg
);
731 dev_warn(dev
, "failed to register charger irq: %d\n", ret
);
736 static int lp8788_charger_remove(struct platform_device
*pdev
)
738 struct lp8788_charger
*pchg
= platform_get_drvdata(pdev
);
740 flush_work(&pchg
->charger_work
);
741 lp8788_irq_unregister(pdev
, pchg
);
742 sysfs_remove_group(&pdev
->dev
.kobj
, &lp8788_attr_group
);
743 lp8788_psy_unregister(pchg
);
744 lp8788_release_adc_channel(pchg
);
749 static struct platform_driver lp8788_charger_driver
= {
750 .probe
= lp8788_charger_probe
,
751 .remove
= lp8788_charger_remove
,
753 .name
= LP8788_DEV_CHARGER
,
756 module_platform_driver(lp8788_charger_driver
);
758 MODULE_DESCRIPTION("TI LP8788 Charger Driver");
759 MODULE_AUTHOR("Milo Kim");
760 MODULE_LICENSE("GPL");
761 MODULE_ALIAS("platform:lp8788-charger");