2 * Gas Gauge driver for TI's BQ20Z75
4 * Copyright (c) 2010, NVIDIA Corporation.
6 * This program is free software; you can redistribute it and/or modify
7 * it under the terms of the GNU General Public License as published by
8 * the Free Software Foundation; either version 2 of the License, or
9 * (at your option) any later version.
11 * This program is distributed in the hope that it will be useful, but WITHOUT
12 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
13 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
16 * You should have received a copy of the GNU General Public License along
17 * with this program; if not, write to the Free Software Foundation, Inc.,
18 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
21 #include <linux/init.h>
22 #include <linux/module.h>
23 #include <linux/kernel.h>
24 #include <linux/err.h>
25 #include <linux/power_supply.h>
26 #include <linux/i2c.h>
27 #include <linux/slab.h>
28 #include <linux/interrupt.h>
29 #include <linux/gpio.h>
31 #include <linux/power/bq20z75.h>
34 REG_MANUFACTURER_DATA,
44 REG_REMAINING_CAPACITY,
45 REG_REMAINING_CAPACITY_CHARGE,
46 REG_FULL_CHARGE_CAPACITY,
47 REG_FULL_CHARGE_CAPACITY_CHARGE,
49 REG_DESIGN_CAPACITY_CHARGE,
53 /* Battery Mode defines */
54 #define BATTERY_MODE_OFFSET 0x03
55 #define BATTERY_MODE_MASK 0x8000
56 enum bq20z75_battery_mode {
61 /* manufacturer access defines */
62 #define MANUFACTURER_ACCESS_STATUS 0x0006
63 #define MANUFACTURER_ACCESS_SLEEP 0x0011
65 /* battery status value bits */
66 #define BATTERY_DISCHARGING 0x40
67 #define BATTERY_FULL_CHARGED 0x20
68 #define BATTERY_FULL_DISCHARGED 0x10
70 #define BQ20Z75_DATA(_psp, _addr, _min_value, _max_value) { \
73 .min_value = _min_value, \
74 .max_value = _max_value, \
77 static const struct bq20z75_device_data {
78 enum power_supply_property psp;
83 [REG_MANUFACTURER_DATA] =
84 BQ20Z75_DATA(POWER_SUPPLY_PROP_PRESENT, 0x00, 0, 65535),
86 BQ20Z75_DATA(POWER_SUPPLY_PROP_TEMP, 0x08, 0, 65535),
88 BQ20Z75_DATA(POWER_SUPPLY_PROP_VOLTAGE_NOW, 0x09, 0, 20000),
90 BQ20Z75_DATA(POWER_SUPPLY_PROP_CURRENT_NOW, 0x0A, -32768,
93 BQ20Z75_DATA(POWER_SUPPLY_PROP_CAPACITY, 0x0E, 0, 100),
94 [REG_REMAINING_CAPACITY] =
95 BQ20Z75_DATA(POWER_SUPPLY_PROP_ENERGY_NOW, 0x0F, 0, 65535),
96 [REG_REMAINING_CAPACITY_CHARGE] =
97 BQ20Z75_DATA(POWER_SUPPLY_PROP_CHARGE_NOW, 0x0F, 0, 65535),
98 [REG_FULL_CHARGE_CAPACITY] =
99 BQ20Z75_DATA(POWER_SUPPLY_PROP_ENERGY_FULL, 0x10, 0, 65535),
100 [REG_FULL_CHARGE_CAPACITY_CHARGE] =
101 BQ20Z75_DATA(POWER_SUPPLY_PROP_CHARGE_FULL, 0x10, 0, 65535),
102 [REG_TIME_TO_EMPTY] =
103 BQ20Z75_DATA(POWER_SUPPLY_PROP_TIME_TO_EMPTY_AVG, 0x12, 0,
106 BQ20Z75_DATA(POWER_SUPPLY_PROP_TIME_TO_FULL_AVG, 0x13, 0,
109 BQ20Z75_DATA(POWER_SUPPLY_PROP_STATUS, 0x16, 0, 65535),
111 BQ20Z75_DATA(POWER_SUPPLY_PROP_CYCLE_COUNT, 0x17, 0, 65535),
112 [REG_DESIGN_CAPACITY] =
113 BQ20Z75_DATA(POWER_SUPPLY_PROP_ENERGY_FULL_DESIGN, 0x18, 0,
115 [REG_DESIGN_CAPACITY_CHARGE] =
116 BQ20Z75_DATA(POWER_SUPPLY_PROP_CHARGE_FULL_DESIGN, 0x18, 0,
118 [REG_DESIGN_VOLTAGE] =
119 BQ20Z75_DATA(POWER_SUPPLY_PROP_VOLTAGE_MAX_DESIGN, 0x19, 0,
121 [REG_SERIAL_NUMBER] =
122 BQ20Z75_DATA(POWER_SUPPLY_PROP_SERIAL_NUMBER, 0x1C, 0, 65535),
125 static enum power_supply_property bq20z75_properties[] = {
126 POWER_SUPPLY_PROP_STATUS,
127 POWER_SUPPLY_PROP_HEALTH,
128 POWER_SUPPLY_PROP_PRESENT,
129 POWER_SUPPLY_PROP_TECHNOLOGY,
130 POWER_SUPPLY_PROP_CYCLE_COUNT,
131 POWER_SUPPLY_PROP_VOLTAGE_NOW,
132 POWER_SUPPLY_PROP_CURRENT_NOW,
133 POWER_SUPPLY_PROP_CAPACITY,
134 POWER_SUPPLY_PROP_TEMP,
135 POWER_SUPPLY_PROP_TIME_TO_EMPTY_AVG,
136 POWER_SUPPLY_PROP_TIME_TO_FULL_AVG,
137 POWER_SUPPLY_PROP_SERIAL_NUMBER,
138 POWER_SUPPLY_PROP_VOLTAGE_MAX_DESIGN,
139 POWER_SUPPLY_PROP_ENERGY_NOW,
140 POWER_SUPPLY_PROP_ENERGY_FULL,
141 POWER_SUPPLY_PROP_ENERGY_FULL_DESIGN,
142 POWER_SUPPLY_PROP_CHARGE_NOW,
143 POWER_SUPPLY_PROP_CHARGE_FULL,
144 POWER_SUPPLY_PROP_CHARGE_FULL_DESIGN,
147 struct bq20z75_info {
148 struct i2c_client *client;
149 struct power_supply power_supply;
150 struct bq20z75_platform_data *pdata;
153 bool enable_detection;
157 static int bq20z75_read_word_data(struct i2c_client *client, u8 address)
161 ret = i2c_smbus_read_word_data(client, address);
163 dev_err(&client->dev,
164 "%s: i2c read at address 0x%x failed\n",
168 return le16_to_cpu(ret);
171 static int bq20z75_write_word_data(struct i2c_client *client, u8 address,
176 ret = i2c_smbus_write_word_data(client, address, le16_to_cpu(value));
178 dev_err(&client->dev,
179 "%s: i2c write to address 0x%x failed\n",
186 static int bq20z75_get_battery_presence_and_health(
187 struct i2c_client *client, enum power_supply_property psp,
188 union power_supply_propval *val)
191 struct bq20z75_info *bq20z75_device = i2c_get_clientdata(client);
193 if (psp == POWER_SUPPLY_PROP_PRESENT &&
194 bq20z75_device->gpio_detect) {
195 ret = gpio_get_value(
196 bq20z75_device->pdata->battery_detect);
197 if (ret == bq20z75_device->pdata->battery_detect_present)
204 /* Write to ManufacturerAccess with
205 * ManufacturerAccess command and then
207 ret = bq20z75_write_word_data(client,
208 bq20z75_data[REG_MANUFACTURER_DATA].addr,
209 MANUFACTURER_ACCESS_STATUS);
214 ret = bq20z75_read_word_data(client,
215 bq20z75_data[REG_MANUFACTURER_DATA].addr);
217 if (psp == POWER_SUPPLY_PROP_PRESENT)
218 val->intval = 0; /* battery removed */
222 if (ret < bq20z75_data[REG_MANUFACTURER_DATA].min_value ||
223 ret > bq20z75_data[REG_MANUFACTURER_DATA].max_value) {
228 /* Mask the upper nibble of 2nd byte and
229 * lower byte of response then
230 * shift the result by 8 to get status*/
233 if (psp == POWER_SUPPLY_PROP_PRESENT) {
235 /* battery removed */
239 } else if (psp == POWER_SUPPLY_PROP_HEALTH) {
241 val->intval = POWER_SUPPLY_HEALTH_UNSPEC_FAILURE;
242 else if (ret == 0x0B)
243 val->intval = POWER_SUPPLY_HEALTH_OVERHEAT;
244 else if (ret == 0x0C)
245 val->intval = POWER_SUPPLY_HEALTH_DEAD;
247 val->intval = POWER_SUPPLY_HEALTH_GOOD;
253 static int bq20z75_get_battery_property(struct i2c_client *client,
254 int reg_offset, enum power_supply_property psp,
255 union power_supply_propval *val)
259 ret = bq20z75_read_word_data(client,
260 bq20z75_data[reg_offset].addr);
264 /* returned values are 16 bit */
265 if (bq20z75_data[reg_offset].min_value < 0)
268 if (ret >= bq20z75_data[reg_offset].min_value &&
269 ret <= bq20z75_data[reg_offset].max_value) {
271 if (psp == POWER_SUPPLY_PROP_STATUS) {
272 if (ret & BATTERY_FULL_CHARGED)
273 val->intval = POWER_SUPPLY_STATUS_FULL;
274 else if (ret & BATTERY_FULL_DISCHARGED)
275 val->intval = POWER_SUPPLY_STATUS_NOT_CHARGING;
276 else if (ret & BATTERY_DISCHARGING)
277 val->intval = POWER_SUPPLY_STATUS_DISCHARGING;
279 val->intval = POWER_SUPPLY_STATUS_CHARGING;
282 if (psp == POWER_SUPPLY_PROP_STATUS)
283 val->intval = POWER_SUPPLY_STATUS_UNKNOWN;
291 static void bq20z75_unit_adjustment(struct i2c_client *client,
292 enum power_supply_property psp, union power_supply_propval *val)
294 #define BASE_UNIT_CONVERSION 1000
295 #define BATTERY_MODE_CAP_MULT_WATT (10 * BASE_UNIT_CONVERSION)
296 #define TIME_UNIT_CONVERSION 600
297 #define TEMP_KELVIN_TO_CELCIUS 2731
299 case POWER_SUPPLY_PROP_ENERGY_NOW:
300 case POWER_SUPPLY_PROP_ENERGY_FULL:
301 case POWER_SUPPLY_PROP_ENERGY_FULL_DESIGN:
302 val->intval *= BATTERY_MODE_CAP_MULT_WATT;
305 case POWER_SUPPLY_PROP_VOLTAGE_NOW:
306 case POWER_SUPPLY_PROP_VOLTAGE_MAX_DESIGN:
307 case POWER_SUPPLY_PROP_CURRENT_NOW:
308 case POWER_SUPPLY_PROP_CHARGE_NOW:
309 case POWER_SUPPLY_PROP_CHARGE_FULL:
310 case POWER_SUPPLY_PROP_CHARGE_FULL_DESIGN:
311 val->intval *= BASE_UNIT_CONVERSION;
314 case POWER_SUPPLY_PROP_TEMP:
315 /* bq20z75 provides battery tempreture in 0.1°K
316 * so convert it to 0.1°C */
317 val->intval -= TEMP_KELVIN_TO_CELCIUS;
321 case POWER_SUPPLY_PROP_TIME_TO_EMPTY_AVG:
322 case POWER_SUPPLY_PROP_TIME_TO_FULL_AVG:
323 val->intval *= TIME_UNIT_CONVERSION;
327 dev_dbg(&client->dev,
328 "%s: no need for unit conversion %d\n", __func__, psp);
332 static enum bq20z75_battery_mode
333 bq20z75_set_battery_mode(struct i2c_client *client,
334 enum bq20z75_battery_mode mode)
336 int ret, original_val;
338 original_val = bq20z75_read_word_data(client, BATTERY_MODE_OFFSET);
339 if (original_val < 0)
342 if ((original_val & BATTERY_MODE_MASK) == mode)
345 if (mode == BATTERY_MODE_AMPS)
346 ret = original_val & ~BATTERY_MODE_MASK;
348 ret = original_val | BATTERY_MODE_MASK;
350 ret = bq20z75_write_word_data(client, BATTERY_MODE_OFFSET, ret);
354 return original_val & BATTERY_MODE_MASK;
357 static int bq20z75_get_battery_capacity(struct i2c_client *client,
358 int reg_offset, enum power_supply_property psp,
359 union power_supply_propval *val)
362 enum bq20z75_battery_mode mode = BATTERY_MODE_WATTS;
364 if (power_supply_is_amp_property(psp))
365 mode = BATTERY_MODE_AMPS;
367 mode = bq20z75_set_battery_mode(client, mode);
371 ret = bq20z75_read_word_data(client, bq20z75_data[reg_offset].addr);
375 if (psp == POWER_SUPPLY_PROP_CAPACITY) {
376 /* bq20z75 spec says that this can be >100 %
377 * even if max value is 100 % */
378 val->intval = min(ret, 100);
382 ret = bq20z75_set_battery_mode(client, mode);
389 static char bq20z75_serial[5];
390 static int bq20z75_get_battery_serial_number(struct i2c_client *client,
391 union power_supply_propval *val)
395 ret = bq20z75_read_word_data(client,
396 bq20z75_data[REG_SERIAL_NUMBER].addr);
400 ret = sprintf(bq20z75_serial, "%04x", ret);
401 val->strval = bq20z75_serial;
406 static int bq20z75_get_property_index(struct i2c_client *client,
407 enum power_supply_property psp)
410 for (count = 0; count < ARRAY_SIZE(bq20z75_data); count++)
411 if (psp == bq20z75_data[count].psp)
414 dev_warn(&client->dev,
415 "%s: Invalid Property - %d\n", __func__, psp);
420 static int bq20z75_get_property(struct power_supply *psy,
421 enum power_supply_property psp,
422 union power_supply_propval *val)
425 struct bq20z75_info *bq20z75_device = container_of(psy,
426 struct bq20z75_info, power_supply);
427 struct i2c_client *client = bq20z75_device->client;
430 case POWER_SUPPLY_PROP_PRESENT:
431 case POWER_SUPPLY_PROP_HEALTH:
432 ret = bq20z75_get_battery_presence_and_health(client, psp, val);
435 case POWER_SUPPLY_PROP_TECHNOLOGY:
436 val->intval = POWER_SUPPLY_TECHNOLOGY_LION;
439 case POWER_SUPPLY_PROP_ENERGY_NOW:
440 case POWER_SUPPLY_PROP_ENERGY_FULL:
441 case POWER_SUPPLY_PROP_ENERGY_FULL_DESIGN:
442 case POWER_SUPPLY_PROP_CHARGE_NOW:
443 case POWER_SUPPLY_PROP_CHARGE_FULL:
444 case POWER_SUPPLY_PROP_CHARGE_FULL_DESIGN:
445 case POWER_SUPPLY_PROP_CAPACITY:
446 ret = bq20z75_get_property_index(client, psp);
450 ret = bq20z75_get_battery_capacity(client, ret, psp, val);
453 case POWER_SUPPLY_PROP_SERIAL_NUMBER:
454 ret = bq20z75_get_battery_serial_number(client, val);
457 case POWER_SUPPLY_PROP_STATUS:
458 case POWER_SUPPLY_PROP_CYCLE_COUNT:
459 case POWER_SUPPLY_PROP_VOLTAGE_NOW:
460 case POWER_SUPPLY_PROP_CURRENT_NOW:
461 case POWER_SUPPLY_PROP_TEMP:
462 case POWER_SUPPLY_PROP_TIME_TO_EMPTY_AVG:
463 case POWER_SUPPLY_PROP_TIME_TO_FULL_AVG:
464 case POWER_SUPPLY_PROP_VOLTAGE_MAX_DESIGN:
465 ret = bq20z75_get_property_index(client, psp);
469 ret = bq20z75_get_battery_property(client, ret, psp, val);
473 dev_err(&client->dev,
474 "%s: INVALID property\n", __func__);
478 if (!bq20z75_device->enable_detection)
481 if (!bq20z75_device->gpio_detect &&
482 bq20z75_device->is_present != (ret >= 0)) {
483 bq20z75_device->is_present = (ret >= 0);
484 power_supply_changed(&bq20z75_device->power_supply);
489 /* Convert units to match requirements for power supply class */
490 bq20z75_unit_adjustment(client, psp, val);
493 dev_dbg(&client->dev,
494 "%s: property = %d, value = %d\n", __func__, psp, val->intval);
499 static irqreturn_t bq20z75_irq(int irq, void *devid)
501 struct power_supply *battery = devid;
503 power_supply_changed(battery);
508 static int __devinit bq20z75_probe(struct i2c_client *client,
509 const struct i2c_device_id *id)
511 struct bq20z75_info *bq20z75_device;
512 struct bq20z75_platform_data *pdata = client->dev.platform_data;
516 bq20z75_device = kzalloc(sizeof(struct bq20z75_info), GFP_KERNEL);
520 bq20z75_device->client = client;
521 bq20z75_device->enable_detection = false;
522 bq20z75_device->gpio_detect = false;
523 bq20z75_device->power_supply.name = "battery";
524 bq20z75_device->power_supply.type = POWER_SUPPLY_TYPE_BATTERY;
525 bq20z75_device->power_supply.properties = bq20z75_properties;
526 bq20z75_device->power_supply.num_properties =
527 ARRAY_SIZE(bq20z75_properties);
528 bq20z75_device->power_supply.get_property = bq20z75_get_property;
531 bq20z75_device->gpio_detect =
532 gpio_is_valid(pdata->battery_detect);
533 bq20z75_device->pdata = pdata;
536 i2c_set_clientdata(client, bq20z75_device);
538 if (!bq20z75_device->gpio_detect)
541 rc = gpio_request(pdata->battery_detect, dev_name(&client->dev));
543 dev_warn(&client->dev, "Failed to request gpio: %d\n", rc);
544 bq20z75_device->gpio_detect = false;
548 rc = gpio_direction_input(pdata->battery_detect);
550 dev_warn(&client->dev, "Failed to get gpio as input: %d\n", rc);
551 gpio_free(pdata->battery_detect);
552 bq20z75_device->gpio_detect = false;
556 irq = gpio_to_irq(pdata->battery_detect);
558 dev_warn(&client->dev, "Failed to get gpio as irq: %d\n", irq);
559 gpio_free(pdata->battery_detect);
560 bq20z75_device->gpio_detect = false;
564 rc = request_irq(irq, bq20z75_irq,
565 IRQF_TRIGGER_RISING | IRQF_TRIGGER_FALLING,
566 dev_name(&client->dev), &bq20z75_device->power_supply);
568 dev_warn(&client->dev, "Failed to request irq: %d\n", rc);
569 gpio_free(pdata->battery_detect);
570 bq20z75_device->gpio_detect = false;
574 bq20z75_device->irq = irq;
578 rc = power_supply_register(&client->dev, &bq20z75_device->power_supply);
580 dev_err(&client->dev,
581 "%s: Failed to register power supply\n", __func__);
585 dev_info(&client->dev,
586 "%s: battery gas gauge device registered\n", client->name);
591 if (bq20z75_device->irq)
592 free_irq(bq20z75_device->irq, &bq20z75_device->power_supply);
593 if (bq20z75_device->gpio_detect)
594 gpio_free(pdata->battery_detect);
596 kfree(bq20z75_device);
601 static int __devexit bq20z75_remove(struct i2c_client *client)
603 struct bq20z75_info *bq20z75_device = i2c_get_clientdata(client);
605 if (bq20z75_device->irq)
606 free_irq(bq20z75_device->irq, &bq20z75_device->power_supply);
607 if (bq20z75_device->gpio_detect)
608 gpio_free(bq20z75_device->pdata->battery_detect);
610 power_supply_unregister(&bq20z75_device->power_supply);
611 kfree(bq20z75_device);
612 bq20z75_device = NULL;
617 #if defined CONFIG_PM
618 static int bq20z75_suspend(struct i2c_client *client,
623 /* write to manufacturer access with sleep command */
624 ret = bq20z75_write_word_data(client,
625 bq20z75_data[REG_MANUFACTURER_DATA].addr,
626 MANUFACTURER_ACCESS_SLEEP);
633 #define bq20z75_suspend NULL
635 /* any smbus transaction will wake up bq20z75 */
636 #define bq20z75_resume NULL
638 static const struct i2c_device_id bq20z75_id[] = {
643 static struct i2c_driver bq20z75_battery_driver = {
644 .probe = bq20z75_probe,
645 .remove = __devexit_p(bq20z75_remove),
646 .suspend = bq20z75_suspend,
647 .resume = bq20z75_resume,
648 .id_table = bq20z75_id,
650 .name = "bq20z75-battery",
654 static int __init bq20z75_battery_init(void)
656 return i2c_add_driver(&bq20z75_battery_driver);
658 module_init(bq20z75_battery_init);
660 static void __exit bq20z75_battery_exit(void)
662 i2c_del_driver(&bq20z75_battery_driver);
664 module_exit(bq20z75_battery_exit);
666 MODULE_DESCRIPTION("BQ20z75 battery monitor driver");
667 MODULE_LICENSE("GPL");