2 * BQ27xxx battery driver
4 * Copyright (C) 2008 Rodolfo Giometti <giometti@linux.it>
5 * Copyright (C) 2008 Eurotech S.p.A. <info@eurotech.it>
6 * Copyright (C) 2010-2011 Lars-Peter Clausen <lars@metafoo.de>
7 * Copyright (C) 2011 Pali Rohár <pali.rohar@gmail.com>
9 * Based on a previous work by Copyright (C) 2008 Texas Instruments, Inc.
11 * This package is free software; you can redistribute it and/or modify
12 * it under the terms of the GNU General Public License version 2 as
13 * published by the Free Software Foundation.
15 * THIS PACKAGE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR
16 * IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
17 * WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE.
20 * http://www.ti.com/product/bq27000
21 * http://www.ti.com/product/bq27200
22 * http://www.ti.com/product/bq27010
23 * http://www.ti.com/product/bq27210
24 * http://www.ti.com/product/bq27500
25 * http://www.ti.com/product/bq27510-g3
26 * http://www.ti.com/product/bq27520-g4
27 * http://www.ti.com/product/bq27530-g1
28 * http://www.ti.com/product/bq27531-g1
29 * http://www.ti.com/product/bq27541-g1
30 * http://www.ti.com/product/bq27542-g1
31 * http://www.ti.com/product/bq27546-g1
32 * http://www.ti.com/product/bq27742-g1
33 * http://www.ti.com/product/bq27545-g1
34 * http://www.ti.com/product/bq27421-g1
35 * http://www.ti.com/product/bq27425-g1
36 * http://www.ti.com/product/bq27411-g1
37 * http://www.ti.com/product/bq27621-g1
40 #include <linux/device.h>
41 #include <linux/module.h>
42 #include <linux/param.h>
43 #include <linux/jiffies.h>
44 #include <linux/workqueue.h>
45 #include <linux/delay.h>
46 #include <linux/platform_device.h>
47 #include <linux/power_supply.h>
48 #include <linux/idr.h>
49 #include <linux/i2c.h>
50 #include <linux/slab.h>
51 #include <asm/unaligned.h>
53 #include <linux/power/bq27xxx_battery.h>
55 #define DRIVER_VERSION "1.2.0"
57 #define BQ27XXX_MANUFACTURER "Texas Instruments"
60 #define BQ27XXX_FLAG_DSC BIT(0)
61 #define BQ27XXX_FLAG_SOCF BIT(1) /* State-of-Charge threshold final */
62 #define BQ27XXX_FLAG_SOC1 BIT(2) /* State-of-Charge threshold 1 */
63 #define BQ27XXX_FLAG_FC BIT(9)
64 #define BQ27XXX_FLAG_OTD BIT(14)
65 #define BQ27XXX_FLAG_OTC BIT(15)
66 #define BQ27XXX_FLAG_UT BIT(14)
67 #define BQ27XXX_FLAG_OT BIT(15)
69 /* BQ27000 has different layout for Flags register */
70 #define BQ27000_FLAG_EDVF BIT(0) /* Final End-of-Discharge-Voltage flag */
71 #define BQ27000_FLAG_EDV1 BIT(1) /* First End-of-Discharge-Voltage flag */
72 #define BQ27000_FLAG_CI BIT(4) /* Capacity Inaccurate flag */
73 #define BQ27000_FLAG_FC BIT(5)
74 #define BQ27000_FLAG_CHGS BIT(7) /* Charge state flag */
76 #define BQ27XXX_RS (20) /* Resistor sense mOhm */
77 #define BQ27XXX_POWER_CONSTANT (29200) /* 29.2 µV^2 * 1000 */
78 #define BQ27XXX_CURRENT_CONSTANT (3570) /* 3.57 µV * 1000 */
80 struct bq27xxx_device_info;
81 struct bq27xxx_access_methods {
82 int (*read)(struct bq27xxx_device_info *di, u8 reg, bool single);
85 #define INVALID_REG_ADDR 0xff
88 * bq27xxx_reg_index - Register names
90 * These are indexes into a device's register mapping array.
92 enum bq27xxx_reg_index {
93 BQ27XXX_REG_CTRL = 0, /* Control */
94 BQ27XXX_REG_TEMP, /* Temperature */
95 BQ27XXX_REG_INT_TEMP, /* Internal Temperature */
96 BQ27XXX_REG_VOLT, /* Voltage */
97 BQ27XXX_REG_AI, /* Average Current */
98 BQ27XXX_REG_FLAGS, /* Flags */
99 BQ27XXX_REG_TTE, /* Time-to-Empty */
100 BQ27XXX_REG_TTF, /* Time-to-Full */
101 BQ27XXX_REG_TTES, /* Time-to-Empty Standby */
102 BQ27XXX_REG_TTECP, /* Time-to-Empty at Constant Power */
103 BQ27XXX_REG_NAC, /* Nominal Available Capacity */
104 BQ27XXX_REG_FCC, /* Full Charge Capacity */
105 BQ27XXX_REG_CYCT, /* Cycle Count */
106 BQ27XXX_REG_AE, /* Available Energy */
107 BQ27XXX_REG_SOC, /* State-of-Charge */
108 BQ27XXX_REG_DCAP, /* Design Capacity */
109 BQ27XXX_REG_AP, /* Average Power */
112 struct bq27xxx_reg_cache {
115 int time_to_empty_avg;
126 struct bq27xxx_device_info {
129 enum bq27xxx_chip chip;
131 struct bq27xxx_reg_cache cache;
132 int charge_design_full;
134 unsigned long last_update;
135 struct delayed_work work;
137 struct power_supply *bat;
139 struct bq27xxx_access_methods bus;
146 /* Register mappings */
147 static u8 bq27000_regs[] = {
150 INVALID_REG_ADDR, /* INT TEMP - NA*/
162 0x0b, /* SOC(RSOC) */
163 0x76, /* DCAP(ILMD) */
167 static u8 bq27010_regs[] = {
170 INVALID_REG_ADDR, /* INT TEMP - NA*/
181 INVALID_REG_ADDR, /* AE - NA */
182 0x0b, /* SOC(RSOC) */
183 0x76, /* DCAP(ILMD) */
184 INVALID_REG_ADDR, /* AP - NA */
187 static u8 bq27500_regs[] = {
195 INVALID_REG_ADDR, /* TTF - NA */
197 INVALID_REG_ADDR, /* TTECP - NA */
201 INVALID_REG_ADDR, /* AE - NA */
202 0x20, /* SOC(RSOC) */
203 0x2e, /* DCAP(ILMD) */
204 INVALID_REG_ADDR, /* AP - NA */
207 static u8 bq27530_regs[] = {
215 INVALID_REG_ADDR, /* TTF - NA */
216 INVALID_REG_ADDR, /* TTES - NA */
217 INVALID_REG_ADDR, /* TTECP - NA */
221 INVALID_REG_ADDR, /* AE - NA */
222 0x2c, /* SOC(RSOC) */
223 INVALID_REG_ADDR, /* DCAP - NA */
227 static u8 bq27541_regs[] = {
235 INVALID_REG_ADDR, /* TTF - NA */
236 INVALID_REG_ADDR, /* TTES - NA */
237 INVALID_REG_ADDR, /* TTECP - NA */
241 INVALID_REG_ADDR, /* AE - NA */
242 0x2c, /* SOC(RSOC) */
247 static u8 bq27545_regs[] = {
255 INVALID_REG_ADDR, /* TTF - NA */
256 INVALID_REG_ADDR, /* TTES - NA */
257 INVALID_REG_ADDR, /* TTECP - NA */
261 INVALID_REG_ADDR, /* AE - NA */
262 0x2c, /* SOC(RSOC) */
263 INVALID_REG_ADDR, /* DCAP - NA */
267 static u8 bq27421_regs[] = {
274 INVALID_REG_ADDR, /* TTE - NA */
275 INVALID_REG_ADDR, /* TTF - NA */
276 INVALID_REG_ADDR, /* TTES - NA */
277 INVALID_REG_ADDR, /* TTECP - NA */
280 INVALID_REG_ADDR, /* CYCT - NA */
281 INVALID_REG_ADDR, /* AE - NA */
287 static u8 *bq27xxx_regs[] = {
288 [BQ27000] = bq27000_regs,
289 [BQ27010] = bq27010_regs,
290 [BQ27500] = bq27500_regs,
291 [BQ27530] = bq27530_regs,
292 [BQ27541] = bq27541_regs,
293 [BQ27545] = bq27545_regs,
294 [BQ27421] = bq27421_regs,
297 static enum power_supply_property bq27000_battery_props[] = {
298 POWER_SUPPLY_PROP_STATUS,
299 POWER_SUPPLY_PROP_PRESENT,
300 POWER_SUPPLY_PROP_VOLTAGE_NOW,
301 POWER_SUPPLY_PROP_CURRENT_NOW,
302 POWER_SUPPLY_PROP_CAPACITY,
303 POWER_SUPPLY_PROP_CAPACITY_LEVEL,
304 POWER_SUPPLY_PROP_TEMP,
305 POWER_SUPPLY_PROP_TIME_TO_EMPTY_NOW,
306 POWER_SUPPLY_PROP_TIME_TO_EMPTY_AVG,
307 POWER_SUPPLY_PROP_TIME_TO_FULL_NOW,
308 POWER_SUPPLY_PROP_TECHNOLOGY,
309 POWER_SUPPLY_PROP_CHARGE_FULL,
310 POWER_SUPPLY_PROP_CHARGE_NOW,
311 POWER_SUPPLY_PROP_CHARGE_FULL_DESIGN,
312 POWER_SUPPLY_PROP_CYCLE_COUNT,
313 POWER_SUPPLY_PROP_ENERGY_NOW,
314 POWER_SUPPLY_PROP_POWER_AVG,
315 POWER_SUPPLY_PROP_HEALTH,
316 POWER_SUPPLY_PROP_MANUFACTURER,
319 static enum power_supply_property bq27010_battery_props[] = {
320 POWER_SUPPLY_PROP_STATUS,
321 POWER_SUPPLY_PROP_PRESENT,
322 POWER_SUPPLY_PROP_VOLTAGE_NOW,
323 POWER_SUPPLY_PROP_CURRENT_NOW,
324 POWER_SUPPLY_PROP_CAPACITY,
325 POWER_SUPPLY_PROP_CAPACITY_LEVEL,
326 POWER_SUPPLY_PROP_TEMP,
327 POWER_SUPPLY_PROP_TIME_TO_EMPTY_NOW,
328 POWER_SUPPLY_PROP_TIME_TO_EMPTY_AVG,
329 POWER_SUPPLY_PROP_TIME_TO_FULL_NOW,
330 POWER_SUPPLY_PROP_TECHNOLOGY,
331 POWER_SUPPLY_PROP_CHARGE_FULL,
332 POWER_SUPPLY_PROP_CHARGE_NOW,
333 POWER_SUPPLY_PROP_CHARGE_FULL_DESIGN,
334 POWER_SUPPLY_PROP_CYCLE_COUNT,
335 POWER_SUPPLY_PROP_HEALTH,
336 POWER_SUPPLY_PROP_MANUFACTURER,
339 static enum power_supply_property bq27500_battery_props[] = {
340 POWER_SUPPLY_PROP_STATUS,
341 POWER_SUPPLY_PROP_PRESENT,
342 POWER_SUPPLY_PROP_VOLTAGE_NOW,
343 POWER_SUPPLY_PROP_CURRENT_NOW,
344 POWER_SUPPLY_PROP_CAPACITY,
345 POWER_SUPPLY_PROP_CAPACITY_LEVEL,
346 POWER_SUPPLY_PROP_TEMP,
347 POWER_SUPPLY_PROP_TIME_TO_EMPTY_NOW,
348 POWER_SUPPLY_PROP_TECHNOLOGY,
349 POWER_SUPPLY_PROP_CHARGE_FULL,
350 POWER_SUPPLY_PROP_CHARGE_NOW,
351 POWER_SUPPLY_PROP_CHARGE_FULL_DESIGN,
352 POWER_SUPPLY_PROP_CYCLE_COUNT,
353 POWER_SUPPLY_PROP_HEALTH,
354 POWER_SUPPLY_PROP_MANUFACTURER,
357 static enum power_supply_property bq27530_battery_props[] = {
358 POWER_SUPPLY_PROP_STATUS,
359 POWER_SUPPLY_PROP_PRESENT,
360 POWER_SUPPLY_PROP_VOLTAGE_NOW,
361 POWER_SUPPLY_PROP_CURRENT_NOW,
362 POWER_SUPPLY_PROP_CAPACITY,
363 POWER_SUPPLY_PROP_CAPACITY_LEVEL,
364 POWER_SUPPLY_PROP_TEMP,
365 POWER_SUPPLY_PROP_TIME_TO_EMPTY_NOW,
366 POWER_SUPPLY_PROP_TECHNOLOGY,
367 POWER_SUPPLY_PROP_CHARGE_FULL,
368 POWER_SUPPLY_PROP_CHARGE_NOW,
369 POWER_SUPPLY_PROP_POWER_AVG,
370 POWER_SUPPLY_PROP_HEALTH,
371 POWER_SUPPLY_PROP_CYCLE_COUNT,
372 POWER_SUPPLY_PROP_MANUFACTURER,
375 static enum power_supply_property bq27541_battery_props[] = {
376 POWER_SUPPLY_PROP_STATUS,
377 POWER_SUPPLY_PROP_PRESENT,
378 POWER_SUPPLY_PROP_VOLTAGE_NOW,
379 POWER_SUPPLY_PROP_CURRENT_NOW,
380 POWER_SUPPLY_PROP_CAPACITY,
381 POWER_SUPPLY_PROP_CAPACITY_LEVEL,
382 POWER_SUPPLY_PROP_TEMP,
383 POWER_SUPPLY_PROP_TIME_TO_EMPTY_NOW,
384 POWER_SUPPLY_PROP_TECHNOLOGY,
385 POWER_SUPPLY_PROP_CHARGE_FULL,
386 POWER_SUPPLY_PROP_CHARGE_NOW,
387 POWER_SUPPLY_PROP_CHARGE_FULL_DESIGN,
388 POWER_SUPPLY_PROP_CYCLE_COUNT,
389 POWER_SUPPLY_PROP_POWER_AVG,
390 POWER_SUPPLY_PROP_HEALTH,
391 POWER_SUPPLY_PROP_MANUFACTURER,
394 static enum power_supply_property bq27545_battery_props[] = {
395 POWER_SUPPLY_PROP_STATUS,
396 POWER_SUPPLY_PROP_PRESENT,
397 POWER_SUPPLY_PROP_VOLTAGE_NOW,
398 POWER_SUPPLY_PROP_CURRENT_NOW,
399 POWER_SUPPLY_PROP_CAPACITY,
400 POWER_SUPPLY_PROP_CAPACITY_LEVEL,
401 POWER_SUPPLY_PROP_TEMP,
402 POWER_SUPPLY_PROP_TIME_TO_EMPTY_NOW,
403 POWER_SUPPLY_PROP_TECHNOLOGY,
404 POWER_SUPPLY_PROP_CHARGE_FULL,
405 POWER_SUPPLY_PROP_CHARGE_NOW,
406 POWER_SUPPLY_PROP_HEALTH,
407 POWER_SUPPLY_PROP_CYCLE_COUNT,
408 POWER_SUPPLY_PROP_POWER_AVG,
409 POWER_SUPPLY_PROP_MANUFACTURER,
412 static enum power_supply_property bq27421_battery_props[] = {
413 POWER_SUPPLY_PROP_STATUS,
414 POWER_SUPPLY_PROP_PRESENT,
415 POWER_SUPPLY_PROP_VOLTAGE_NOW,
416 POWER_SUPPLY_PROP_CURRENT_NOW,
417 POWER_SUPPLY_PROP_CAPACITY,
418 POWER_SUPPLY_PROP_CAPACITY_LEVEL,
419 POWER_SUPPLY_PROP_TEMP,
420 POWER_SUPPLY_PROP_TECHNOLOGY,
421 POWER_SUPPLY_PROP_CHARGE_FULL,
422 POWER_SUPPLY_PROP_CHARGE_NOW,
423 POWER_SUPPLY_PROP_CHARGE_FULL_DESIGN,
424 POWER_SUPPLY_PROP_MANUFACTURER,
427 #define BQ27XXX_PROP(_id, _prop) \
430 .size = ARRAY_SIZE(_prop), \
434 enum power_supply_property *props;
436 } bq27xxx_battery_props[] = {
437 BQ27XXX_PROP(BQ27000, bq27000_battery_props),
438 BQ27XXX_PROP(BQ27010, bq27010_battery_props),
439 BQ27XXX_PROP(BQ27500, bq27500_battery_props),
440 BQ27XXX_PROP(BQ27530, bq27530_battery_props),
441 BQ27XXX_PROP(BQ27541, bq27541_battery_props),
442 BQ27XXX_PROP(BQ27545, bq27545_battery_props),
443 BQ27XXX_PROP(BQ27421, bq27421_battery_props),
446 static unsigned int poll_interval = 360;
447 module_param(poll_interval, uint, 0644);
448 MODULE_PARM_DESC(poll_interval,
449 "battery poll interval in seconds - 0 disables polling");
452 * Common code for BQ27xxx devices
455 static inline int bq27xxx_read(struct bq27xxx_device_info *di, int reg_index,
458 /* Reports EINVAL for invalid/missing registers */
459 if (!di || di->regs[reg_index] == INVALID_REG_ADDR)
462 return di->bus.read(di, di->regs[reg_index], single);
466 * Return the battery State-of-Charge
467 * Or < 0 if something fails.
469 static int bq27xxx_battery_read_soc(struct bq27xxx_device_info *di)
473 soc = bq27xxx_read(di, BQ27XXX_REG_SOC, false);
476 dev_dbg(di->dev, "error reading State-of-Charge\n");
482 * Return a battery charge value in µAh
483 * Or < 0 if something fails.
485 static int bq27xxx_battery_read_charge(struct bq27xxx_device_info *di, u8 reg)
489 charge = bq27xxx_read(di, reg, false);
491 dev_dbg(di->dev, "error reading charge register %02x: %d\n",
496 if (di->chip == BQ27000 || di->chip == BQ27010)
497 charge *= BQ27XXX_CURRENT_CONSTANT / BQ27XXX_RS;
505 * Return the battery Nominal available capacity in µAh
506 * Or < 0 if something fails.
508 static inline int bq27xxx_battery_read_nac(struct bq27xxx_device_info *di)
512 if (di->chip == BQ27000 || di->chip == BQ27010) {
513 flags = bq27xxx_read(di, BQ27XXX_REG_FLAGS, true);
514 if (flags >= 0 && (flags & BQ27000_FLAG_CI))
518 return bq27xxx_battery_read_charge(di, BQ27XXX_REG_NAC);
522 * Return the battery Full Charge Capacity in µAh
523 * Or < 0 if something fails.
525 static inline int bq27xxx_battery_read_fcc(struct bq27xxx_device_info *di)
527 return bq27xxx_battery_read_charge(di, BQ27XXX_REG_FCC);
531 * Return the Design Capacity in µAh
532 * Or < 0 if something fails.
534 static int bq27xxx_battery_read_dcap(struct bq27xxx_device_info *di)
538 dcap = bq27xxx_read(di, BQ27XXX_REG_DCAP, false);
541 dev_dbg(di->dev, "error reading initial last measured discharge\n");
545 if (di->chip == BQ27000 || di->chip == BQ27010)
546 dcap *= BQ27XXX_CURRENT_CONSTANT / BQ27XXX_RS;
554 * Return the battery Available energy in µWh
555 * Or < 0 if something fails.
557 static int bq27xxx_battery_read_energy(struct bq27xxx_device_info *di)
561 ae = bq27xxx_read(di, BQ27XXX_REG_AE, false);
563 dev_dbg(di->dev, "error reading available energy\n");
567 if (di->chip == BQ27000 || di->chip == BQ27010)
568 ae *= BQ27XXX_POWER_CONSTANT / BQ27XXX_RS;
576 * Return the battery temperature in tenths of degree Kelvin
577 * Or < 0 if something fails.
579 static int bq27xxx_battery_read_temperature(struct bq27xxx_device_info *di)
583 temp = bq27xxx_read(di, BQ27XXX_REG_TEMP, false);
585 dev_err(di->dev, "error reading temperature\n");
589 if (di->chip == BQ27000 || di->chip == BQ27010)
596 * Return the battery Cycle count total
597 * Or < 0 if something fails.
599 static int bq27xxx_battery_read_cyct(struct bq27xxx_device_info *di)
603 cyct = bq27xxx_read(di, BQ27XXX_REG_CYCT, false);
605 dev_err(di->dev, "error reading cycle count total\n");
611 * Read a time register.
612 * Return < 0 if something fails.
614 static int bq27xxx_battery_read_time(struct bq27xxx_device_info *di, u8 reg)
618 tval = bq27xxx_read(di, reg, false);
620 dev_dbg(di->dev, "error reading time register %02x: %d\n",
632 * Read an average power register.
633 * Return < 0 if something fails.
635 static int bq27xxx_battery_read_pwr_avg(struct bq27xxx_device_info *di)
639 tval = bq27xxx_read(di, BQ27XXX_REG_AP, false);
641 dev_err(di->dev, "error reading average power register %02x: %d\n",
642 BQ27XXX_REG_AP, tval);
646 if (di->chip == BQ27000 || di->chip == BQ27010)
647 return (tval * BQ27XXX_POWER_CONSTANT) / BQ27XXX_RS;
653 * Returns true if a battery over temperature condition is detected
655 static bool bq27xxx_battery_overtemp(struct bq27xxx_device_info *di, u16 flags)
657 if (di->chip == BQ27500 || di->chip == BQ27541 || di->chip == BQ27545)
658 return flags & (BQ27XXX_FLAG_OTC | BQ27XXX_FLAG_OTD);
659 if (di->chip == BQ27530 || di->chip == BQ27421)
660 return flags & BQ27XXX_FLAG_OT;
666 * Returns true if a battery under temperature condition is detected
668 static bool bq27xxx_battery_undertemp(struct bq27xxx_device_info *di, u16 flags)
670 if (di->chip == BQ27530 || di->chip == BQ27421)
671 return flags & BQ27XXX_FLAG_UT;
677 * Returns true if a low state of charge condition is detected
679 static bool bq27xxx_battery_dead(struct bq27xxx_device_info *di, u16 flags)
681 if (di->chip == BQ27000 || di->chip == BQ27010)
682 return flags & (BQ27000_FLAG_EDV1 | BQ27000_FLAG_EDVF);
684 return flags & (BQ27XXX_FLAG_SOC1 | BQ27XXX_FLAG_SOCF);
688 * Read flag register.
689 * Return < 0 if something fails.
691 static int bq27xxx_battery_read_health(struct bq27xxx_device_info *di)
695 flags = bq27xxx_read(di, BQ27XXX_REG_FLAGS, false);
697 dev_err(di->dev, "error reading flag register:%d\n", flags);
701 /* Unlikely but important to return first */
702 if (unlikely(bq27xxx_battery_overtemp(di, flags)))
703 return POWER_SUPPLY_HEALTH_OVERHEAT;
704 if (unlikely(bq27xxx_battery_undertemp(di, flags)))
705 return POWER_SUPPLY_HEALTH_COLD;
706 if (unlikely(bq27xxx_battery_dead(di, flags)))
707 return POWER_SUPPLY_HEALTH_DEAD;
709 return POWER_SUPPLY_HEALTH_GOOD;
712 static void bq27xxx_battery_update(struct bq27xxx_device_info *di)
714 struct bq27xxx_reg_cache cache = {0, };
715 bool has_ci_flag = di->chip == BQ27000 || di->chip == BQ27010;
716 bool has_singe_flag = di->chip == BQ27000 || di->chip == BQ27010;
718 cache.flags = bq27xxx_read(di, BQ27XXX_REG_FLAGS, has_singe_flag);
719 if ((cache.flags & 0xff) == 0xff)
720 cache.flags = -1; /* read error */
721 if (cache.flags >= 0) {
722 cache.temperature = bq27xxx_battery_read_temperature(di);
723 if (has_ci_flag && (cache.flags & BQ27000_FLAG_CI)) {
724 dev_info(di->dev, "battery is not calibrated! ignoring capacity values\n");
725 cache.capacity = -ENODATA;
726 cache.energy = -ENODATA;
727 cache.time_to_empty = -ENODATA;
728 cache.time_to_empty_avg = -ENODATA;
729 cache.time_to_full = -ENODATA;
730 cache.charge_full = -ENODATA;
731 cache.health = -ENODATA;
733 if (di->regs[BQ27XXX_REG_TTE] != INVALID_REG_ADDR)
734 cache.time_to_empty = bq27xxx_battery_read_time(di, BQ27XXX_REG_TTE);
735 if (di->regs[BQ27XXX_REG_TTECP] != INVALID_REG_ADDR)
736 cache.time_to_empty_avg = bq27xxx_battery_read_time(di, BQ27XXX_REG_TTECP);
737 if (di->regs[BQ27XXX_REG_TTF] != INVALID_REG_ADDR)
738 cache.time_to_full = bq27xxx_battery_read_time(di, BQ27XXX_REG_TTF);
739 cache.charge_full = bq27xxx_battery_read_fcc(di);
740 cache.capacity = bq27xxx_battery_read_soc(di);
741 if (di->regs[BQ27XXX_REG_AE] != INVALID_REG_ADDR)
742 cache.energy = bq27xxx_battery_read_energy(di);
743 cache.health = bq27xxx_battery_read_health(di);
745 if (di->regs[BQ27XXX_REG_CYCT] != INVALID_REG_ADDR)
746 cache.cycle_count = bq27xxx_battery_read_cyct(di);
747 if (di->regs[BQ27XXX_REG_AP] != INVALID_REG_ADDR)
748 cache.power_avg = bq27xxx_battery_read_pwr_avg(di);
750 /* We only have to read charge design full once */
751 if (di->charge_design_full <= 0)
752 di->charge_design_full = bq27xxx_battery_read_dcap(di);
755 if (di->cache.capacity != cache.capacity)
756 power_supply_changed(di->bat);
758 if (memcmp(&di->cache, &cache, sizeof(cache)) != 0)
761 di->last_update = jiffies;
764 static void bq27xxx_battery_poll(struct work_struct *work)
766 struct bq27xxx_device_info *di =
767 container_of(work, struct bq27xxx_device_info,
770 bq27xxx_battery_update(di);
772 if (poll_interval > 0) {
773 /* The timer does not have to be accurate. */
774 set_timer_slack(&di->work.timer, poll_interval * HZ / 4);
775 schedule_delayed_work(&di->work, poll_interval * HZ);
780 * Return the battery average current in µA
781 * Note that current can be negative signed as well
782 * Or 0 if something fails.
784 static int bq27xxx_battery_current(struct bq27xxx_device_info *di,
785 union power_supply_propval *val)
790 curr = bq27xxx_read(di, BQ27XXX_REG_AI, false);
792 dev_err(di->dev, "error reading current\n");
796 if (di->chip == BQ27000 || di->chip == BQ27010) {
797 flags = bq27xxx_read(di, BQ27XXX_REG_FLAGS, false);
798 if (flags & BQ27000_FLAG_CHGS) {
799 dev_dbg(di->dev, "negative current!\n");
803 val->intval = curr * BQ27XXX_CURRENT_CONSTANT / BQ27XXX_RS;
805 /* Other gauges return signed value */
806 val->intval = (int)((s16)curr) * 1000;
812 static int bq27xxx_battery_status(struct bq27xxx_device_info *di,
813 union power_supply_propval *val)
817 if (di->chip == BQ27000 || di->chip == BQ27010) {
818 if (di->cache.flags & BQ27000_FLAG_FC)
819 status = POWER_SUPPLY_STATUS_FULL;
820 else if (di->cache.flags & BQ27000_FLAG_CHGS)
821 status = POWER_SUPPLY_STATUS_CHARGING;
822 else if (power_supply_am_i_supplied(di->bat))
823 status = POWER_SUPPLY_STATUS_NOT_CHARGING;
825 status = POWER_SUPPLY_STATUS_DISCHARGING;
827 if (di->cache.flags & BQ27XXX_FLAG_FC)
828 status = POWER_SUPPLY_STATUS_FULL;
829 else if (di->cache.flags & BQ27XXX_FLAG_DSC)
830 status = POWER_SUPPLY_STATUS_DISCHARGING;
832 status = POWER_SUPPLY_STATUS_CHARGING;
835 val->intval = status;
840 static int bq27xxx_battery_capacity_level(struct bq27xxx_device_info *di,
841 union power_supply_propval *val)
845 if (di->chip == BQ27000 || di->chip == BQ27010) {
846 if (di->cache.flags & BQ27000_FLAG_FC)
847 level = POWER_SUPPLY_CAPACITY_LEVEL_FULL;
848 else if (di->cache.flags & BQ27000_FLAG_EDV1)
849 level = POWER_SUPPLY_CAPACITY_LEVEL_LOW;
850 else if (di->cache.flags & BQ27000_FLAG_EDVF)
851 level = POWER_SUPPLY_CAPACITY_LEVEL_CRITICAL;
853 level = POWER_SUPPLY_CAPACITY_LEVEL_NORMAL;
855 if (di->cache.flags & BQ27XXX_FLAG_FC)
856 level = POWER_SUPPLY_CAPACITY_LEVEL_FULL;
857 else if (di->cache.flags & BQ27XXX_FLAG_SOC1)
858 level = POWER_SUPPLY_CAPACITY_LEVEL_LOW;
859 else if (di->cache.flags & BQ27XXX_FLAG_SOCF)
860 level = POWER_SUPPLY_CAPACITY_LEVEL_CRITICAL;
862 level = POWER_SUPPLY_CAPACITY_LEVEL_NORMAL;
871 * Return the battery Voltage in millivolts
872 * Or < 0 if something fails.
874 static int bq27xxx_battery_voltage(struct bq27xxx_device_info *di,
875 union power_supply_propval *val)
879 volt = bq27xxx_read(di, BQ27XXX_REG_VOLT, false);
881 dev_err(di->dev, "error reading voltage\n");
885 val->intval = volt * 1000;
890 static int bq27xxx_simple_value(int value,
891 union power_supply_propval *val)
901 static int bq27xxx_battery_get_property(struct power_supply *psy,
902 enum power_supply_property psp,
903 union power_supply_propval *val)
906 struct bq27xxx_device_info *di = power_supply_get_drvdata(psy);
908 mutex_lock(&di->lock);
909 if (time_is_before_jiffies(di->last_update + 5 * HZ)) {
910 cancel_delayed_work_sync(&di->work);
911 bq27xxx_battery_poll(&di->work.work);
913 mutex_unlock(&di->lock);
915 if (psp != POWER_SUPPLY_PROP_PRESENT && di->cache.flags < 0)
919 case POWER_SUPPLY_PROP_STATUS:
920 ret = bq27xxx_battery_status(di, val);
922 case POWER_SUPPLY_PROP_VOLTAGE_NOW:
923 ret = bq27xxx_battery_voltage(di, val);
925 case POWER_SUPPLY_PROP_PRESENT:
926 val->intval = di->cache.flags < 0 ? 0 : 1;
928 case POWER_SUPPLY_PROP_CURRENT_NOW:
929 ret = bq27xxx_battery_current(di, val);
931 case POWER_SUPPLY_PROP_CAPACITY:
932 ret = bq27xxx_simple_value(di->cache.capacity, val);
934 case POWER_SUPPLY_PROP_CAPACITY_LEVEL:
935 ret = bq27xxx_battery_capacity_level(di, val);
937 case POWER_SUPPLY_PROP_TEMP:
938 ret = bq27xxx_simple_value(di->cache.temperature, val);
940 val->intval -= 2731; /* convert decidegree k to c */
942 case POWER_SUPPLY_PROP_TIME_TO_EMPTY_NOW:
943 ret = bq27xxx_simple_value(di->cache.time_to_empty, val);
945 case POWER_SUPPLY_PROP_TIME_TO_EMPTY_AVG:
946 ret = bq27xxx_simple_value(di->cache.time_to_empty_avg, val);
948 case POWER_SUPPLY_PROP_TIME_TO_FULL_NOW:
949 ret = bq27xxx_simple_value(di->cache.time_to_full, val);
951 case POWER_SUPPLY_PROP_TECHNOLOGY:
952 val->intval = POWER_SUPPLY_TECHNOLOGY_LION;
954 case POWER_SUPPLY_PROP_CHARGE_NOW:
955 ret = bq27xxx_simple_value(bq27xxx_battery_read_nac(di), val);
957 case POWER_SUPPLY_PROP_CHARGE_FULL:
958 ret = bq27xxx_simple_value(di->cache.charge_full, val);
960 case POWER_SUPPLY_PROP_CHARGE_FULL_DESIGN:
961 ret = bq27xxx_simple_value(di->charge_design_full, val);
963 case POWER_SUPPLY_PROP_CYCLE_COUNT:
964 ret = bq27xxx_simple_value(di->cache.cycle_count, val);
966 case POWER_SUPPLY_PROP_ENERGY_NOW:
967 ret = bq27xxx_simple_value(di->cache.energy, val);
969 case POWER_SUPPLY_PROP_POWER_AVG:
970 ret = bq27xxx_simple_value(di->cache.power_avg, val);
972 case POWER_SUPPLY_PROP_HEALTH:
973 ret = bq27xxx_simple_value(di->cache.health, val);
975 case POWER_SUPPLY_PROP_MANUFACTURER:
976 val->strval = BQ27XXX_MANUFACTURER;
985 static void bq27xxx_external_power_changed(struct power_supply *psy)
987 struct bq27xxx_device_info *di = power_supply_get_drvdata(psy);
989 cancel_delayed_work_sync(&di->work);
990 schedule_delayed_work(&di->work, 0);
993 static int bq27xxx_powersupply_init(struct bq27xxx_device_info *di,
997 struct power_supply_desc *psy_desc;
998 struct power_supply_config psy_cfg = { .drv_data = di, };
1000 psy_desc = devm_kzalloc(di->dev, sizeof(*psy_desc), GFP_KERNEL);
1004 psy_desc->name = name;
1005 psy_desc->type = POWER_SUPPLY_TYPE_BATTERY;
1006 psy_desc->properties = bq27xxx_battery_props[di->chip].props;
1007 psy_desc->num_properties = bq27xxx_battery_props[di->chip].size;
1008 psy_desc->get_property = bq27xxx_battery_get_property;
1009 psy_desc->external_power_changed = bq27xxx_external_power_changed;
1011 INIT_DELAYED_WORK(&di->work, bq27xxx_battery_poll);
1012 mutex_init(&di->lock);
1014 di->bat = power_supply_register_no_ws(di->dev, psy_desc, &psy_cfg);
1015 if (IS_ERR(di->bat)) {
1016 ret = PTR_ERR(di->bat);
1017 dev_err(di->dev, "failed to register battery: %d\n", ret);
1021 dev_info(di->dev, "support ver. %s enabled\n", DRIVER_VERSION);
1023 bq27xxx_battery_update(di);
1028 static void bq27xxx_powersupply_unregister(struct bq27xxx_device_info *di)
1031 * power_supply_unregister call bq27xxx_battery_get_property which
1032 * call bq27xxx_battery_poll.
1033 * Make sure that bq27xxx_battery_poll will not call
1034 * schedule_delayed_work again after unregister (which cause OOPS).
1038 cancel_delayed_work_sync(&di->work);
1040 power_supply_unregister(di->bat);
1042 mutex_destroy(&di->lock);
1045 /* i2c specific code */
1046 #ifdef CONFIG_BATTERY_BQ27XXX_I2C
1048 /* If the system has several batteries we need a different name for each
1051 static DEFINE_IDR(battery_id);
1052 static DEFINE_MUTEX(battery_mutex);
1054 static int bq27xxx_battery_i2c_read(struct bq27xxx_device_info *di, u8 reg,
1057 struct i2c_client *client = to_i2c_client(di->dev);
1058 struct i2c_msg msg[2];
1059 unsigned char data[2];
1062 if (!client->adapter)
1065 msg[0].addr = client->addr;
1068 msg[0].len = sizeof(reg);
1069 msg[1].addr = client->addr;
1070 msg[1].flags = I2C_M_RD;
1077 ret = i2c_transfer(client->adapter, msg, ARRAY_SIZE(msg));
1082 ret = get_unaligned_le16(data);
1089 static int bq27xxx_battery_i2c_probe(struct i2c_client *client,
1090 const struct i2c_device_id *id)
1093 struct bq27xxx_device_info *di;
1097 /* Get new ID for the new battery device */
1098 mutex_lock(&battery_mutex);
1099 num = idr_alloc(&battery_id, client, 0, 0, GFP_KERNEL);
1100 mutex_unlock(&battery_mutex);
1104 name = devm_kasprintf(&client->dev, GFP_KERNEL, "%s-%d", id->name, num);
1110 di = devm_kzalloc(&client->dev, sizeof(*di), GFP_KERNEL);
1117 di->dev = &client->dev;
1118 di->chip = id->driver_data;
1119 di->bus.read = &bq27xxx_battery_i2c_read;
1120 di->regs = bq27xxx_regs[di->chip];
1122 retval = bq27xxx_powersupply_init(di, name);
1126 /* Schedule a polling after about 1 min */
1127 schedule_delayed_work(&di->work, 60 * HZ);
1129 i2c_set_clientdata(client, di);
1134 mutex_lock(&battery_mutex);
1135 idr_remove(&battery_id, num);
1136 mutex_unlock(&battery_mutex);
1141 static int bq27xxx_battery_i2c_remove(struct i2c_client *client)
1143 struct bq27xxx_device_info *di = i2c_get_clientdata(client);
1145 bq27xxx_powersupply_unregister(di);
1147 mutex_lock(&battery_mutex);
1148 idr_remove(&battery_id, di->id);
1149 mutex_unlock(&battery_mutex);
1154 static const struct i2c_device_id bq27xxx_id[] = {
1155 { "bq27200", BQ27000 },
1156 { "bq27210", BQ27010 },
1157 { "bq27500", BQ27500 },
1158 { "bq27510", BQ27500 },
1159 { "bq27520", BQ27500 },
1160 { "bq27530", BQ27530 },
1161 { "bq27531", BQ27530 },
1162 { "bq27541", BQ27541 },
1163 { "bq27542", BQ27541 },
1164 { "bq27546", BQ27541 },
1165 { "bq27742", BQ27541 },
1166 { "bq27545", BQ27545 },
1167 { "bq27421", BQ27421 },
1168 { "bq27425", BQ27421 },
1169 { "bq27441", BQ27421 },
1170 { "bq27621", BQ27421 },
1173 MODULE_DEVICE_TABLE(i2c, bq27xxx_id);
1175 static struct i2c_driver bq27xxx_battery_i2c_driver = {
1177 .name = "bq27xxx-battery",
1179 .probe = bq27xxx_battery_i2c_probe,
1180 .remove = bq27xxx_battery_i2c_remove,
1181 .id_table = bq27xxx_id,
1184 static inline int bq27xxx_battery_i2c_init(void)
1186 int ret = i2c_add_driver(&bq27xxx_battery_i2c_driver);
1189 pr_err("Unable to register BQ27xxx i2c driver\n");
1194 static inline void bq27xxx_battery_i2c_exit(void)
1196 i2c_del_driver(&bq27xxx_battery_i2c_driver);
1201 static inline int bq27xxx_battery_i2c_init(void) { return 0; }
1202 static inline void bq27xxx_battery_i2c_exit(void) {};
1206 /* platform specific code */
1207 #ifdef CONFIG_BATTERY_BQ27XXX_PLATFORM
1209 static int bq27xxx_battery_platform_read(struct bq27xxx_device_info *di, u8 reg,
1212 struct device *dev = di->dev;
1213 struct bq27xxx_platform_data *pdata = dev->platform_data;
1214 unsigned int timeout = 3;
1219 /* Make sure the value has not changed in between reading the
1220 * lower and the upper part */
1221 upper = pdata->read(dev, reg + 1);
1227 lower = pdata->read(dev, reg);
1231 upper = pdata->read(dev, reg + 1);
1232 } while (temp != upper && --timeout);
1237 return (upper << 8) | lower;
1240 return pdata->read(dev, reg);
1243 static int bq27xxx_battery_platform_probe(struct platform_device *pdev)
1245 struct bq27xxx_device_info *di;
1246 struct bq27xxx_platform_data *pdata = pdev->dev.platform_data;
1250 dev_err(&pdev->dev, "no platform_data supplied\n");
1255 dev_err(&pdev->dev, "no hdq read callback supplied\n");
1260 dev_err(&pdev->dev, "no device supplied\n");
1264 di = devm_kzalloc(&pdev->dev, sizeof(*di), GFP_KERNEL);
1268 platform_set_drvdata(pdev, di);
1270 di->dev = &pdev->dev;
1271 di->chip = pdata->chip;
1273 name = pdata->name ?: dev_name(&pdev->dev);
1274 di->bus.read = &bq27xxx_battery_platform_read;
1276 return bq27xxx_powersupply_init(di, name);
1279 static int bq27xxx_battery_platform_remove(struct platform_device *pdev)
1281 struct bq27xxx_device_info *di = platform_get_drvdata(pdev);
1283 bq27xxx_powersupply_unregister(di);
1288 static struct platform_driver bq27xxx_battery_platform_driver = {
1289 .probe = bq27xxx_battery_platform_probe,
1290 .remove = bq27xxx_battery_platform_remove,
1292 .name = "bq27000-battery",
1296 static inline int bq27xxx_battery_platform_init(void)
1298 int ret = platform_driver_register(&bq27xxx_battery_platform_driver);
1301 pr_err("Unable to register BQ27xxx platform driver\n");
1306 static inline void bq27xxx_battery_platform_exit(void)
1308 platform_driver_unregister(&bq27xxx_battery_platform_driver);
1313 static inline int bq27xxx_battery_platform_init(void) { return 0; }
1314 static inline void bq27xxx_battery_platform_exit(void) {};
1322 static int __init bq27xxx_battery_init(void)
1326 ret = bq27xxx_battery_i2c_init();
1330 ret = bq27xxx_battery_platform_init();
1332 bq27xxx_battery_i2c_exit();
1336 module_init(bq27xxx_battery_init);
1338 static void __exit bq27xxx_battery_exit(void)
1340 bq27xxx_battery_platform_exit();
1341 bq27xxx_battery_i2c_exit();
1343 module_exit(bq27xxx_battery_exit);
1345 #ifdef CONFIG_BATTERY_BQ27XXX_PLATFORM
1346 MODULE_ALIAS("platform:bq27000-battery");
1349 MODULE_AUTHOR("Rodolfo Giometti <giometti@linux.it>");
1350 MODULE_DESCRIPTION("BQ27xxx battery monitor driver");
1351 MODULE_LICENSE("GPL");