1// SPDX-License-Identifier: GPL-2.0-only
2/*
3 * axp288_fuel_gauge.c - Xpower AXP288 PMIC Fuel Gauge Driver
4 *
5 * Copyright (C) 2020-2021 Andrejus Basovas <xxx@yyy.tld>
6 * Copyright (C) 2016-2021 Hans de Goede <hdegoede@redhat.com>
7 * Copyright (C) 2014 Intel Corporation
8 *
9 * ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
10 */
11
12#include <linux/acpi.h>
13#include <linux/dmi.h>
14#include <linux/module.h>
15#include <linux/kernel.h>
16#include <linux/device.h>
17#include <linux/regmap.h>
18#include <linux/jiffies.h>
19#include <linux/interrupt.h>
20#include <linux/mfd/axp20x.h>
21#include <linux/platform_device.h>
22#include <linux/power_supply.h>
23#include <linux/iio/consumer.h>
24#include <asm/unaligned.h>
25#include <asm/iosf_mbi.h>
26
27#define PS_STAT_VBUS_TRIGGER (1 << 0)
28#define PS_STAT_BAT_CHRG_DIR (1 << 2)
29#define PS_STAT_VBAT_ABOVE_VHOLD (1 << 3)
30#define PS_STAT_VBUS_VALID (1 << 4)
31#define PS_STAT_VBUS_PRESENT (1 << 5)
32
33#define CHRG_STAT_BAT_SAFE_MODE (1 << 3)
34#define CHRG_STAT_BAT_VALID (1 << 4)
35#define CHRG_STAT_BAT_PRESENT (1 << 5)
36#define CHRG_STAT_CHARGING (1 << 6)
37#define CHRG_STAT_PMIC_OTP (1 << 7)
38
39#define CHRG_CCCV_CC_MASK 0xf /* 4 bits */
40#define CHRG_CCCV_CC_BIT_POS 0
41#define CHRG_CCCV_CC_OFFSET 200 /* 200mA */
42#define CHRG_CCCV_CC_LSB_RES 200 /* 200mA */
43#define CHRG_CCCV_ITERM_20P (1 << 4) /* 20% of CC */
44#define CHRG_CCCV_CV_MASK 0x60 /* 2 bits */
45#define CHRG_CCCV_CV_BIT_POS 5
46#define CHRG_CCCV_CV_4100MV 0x0 /* 4.10V */
47#define CHRG_CCCV_CV_4150MV 0x1 /* 4.15V */
48#define CHRG_CCCV_CV_4200MV 0x2 /* 4.20V */
49#define CHRG_CCCV_CV_4350MV 0x3 /* 4.35V */
50#define CHRG_CCCV_CHG_EN (1 << 7)
51
52#define FG_CNTL_OCV_ADJ_STAT (1 << 2)
53#define FG_CNTL_OCV_ADJ_EN (1 << 3)
54#define FG_CNTL_CAP_ADJ_STAT (1 << 4)
55#define FG_CNTL_CAP_ADJ_EN (1 << 5)
56#define FG_CNTL_CC_EN (1 << 6)
57#define FG_CNTL_GAUGE_EN (1 << 7)
58
59#define FG_15BIT_WORD_VALID (1 << 15)
60#define FG_15BIT_VAL_MASK 0x7fff
61
62#define FG_REP_CAP_VALID (1 << 7)
63#define FG_REP_CAP_VAL_MASK 0x7F
64
65#define FG_DES_CAP1_VALID (1 << 7)
66#define FG_DES_CAP_RES_LSB 1456 /* 1.456mAhr */
67
68#define FG_DES_CC_RES_LSB 1456 /* 1.456mAhr */
69
70#define FG_OCV_CAP_VALID (1 << 7)
71#define FG_OCV_CAP_VAL_MASK 0x7F
72#define FG_CC_CAP_VALID (1 << 7)
73#define FG_CC_CAP_VAL_MASK 0x7F
74
75#define FG_LOW_CAP_THR1_MASK 0xf0 /* 5% tp 20% */
76#define FG_LOW_CAP_THR1_VAL 0xa0 /* 15 perc */
77#define FG_LOW_CAP_THR2_MASK 0x0f /* 0% to 15% */
78#define FG_LOW_CAP_WARN_THR 14 /* 14 perc */
79#define FG_LOW_CAP_CRIT_THR 4 /* 4 perc */
80#define FG_LOW_CAP_SHDN_THR 0 /* 0 perc */
81
82#define DEV_NAME "axp288_fuel_gauge"
83
84/* 1.1mV per LSB expressed in uV */
85#define VOLTAGE_FROM_ADC(a) ((a * 11) / 10)
86/* properties converted to uV, uA */
87#define PROP_VOLT(a) ((a) * 1000)
88#define PROP_CURR(a) ((a) * 1000)
89
90#define AXP288_REG_UPDATE_INTERVAL (60 * HZ)
91#define AXP288_FG_INTR_NUM 6
92
93#define AXP288_QUIRK_NO_BATTERY BIT(0)
94
95static bool no_current_sense_res;
96module_param(no_current_sense_res, bool, 0444);
97MODULE_PARM_DESC(no_current_sense_res, "No (or broken) current sense resistor");
98
99enum {
100 QWBTU_IRQ = 0,
101 WBTU_IRQ,
102 QWBTO_IRQ,
103 WBTO_IRQ,
104 WL2_IRQ,
105 WL1_IRQ,
106};
107
108enum {
109 BAT_CHRG_CURR,
110 BAT_D_CURR,
111 BAT_VOLT,
112 IIO_CHANNEL_NUM
113};
114
115struct axp288_fg_info {
116 struct device *dev;
117 struct regmap *regmap;
118 int irq[AXP288_FG_INTR_NUM];
119 struct iio_channel *iio_channel[IIO_CHANNEL_NUM];
120 struct power_supply *bat;
121 struct mutex lock;
122 int status;
123 int max_volt;
124 int pwr_op;
125 int low_cap;
126 struct dentry *debug_file;
127
128 char valid; /* zero until following fields are valid */
129 unsigned long last_updated; /* in jiffies */
130
131 int pwr_stat;
132 int fg_res;
133 int bat_volt;
134 int d_curr;
135 int c_curr;
136 int ocv;
137 int fg_cc_mtr1;
138 int fg_des_cap1;
139};
140
141static enum power_supply_property fuel_gauge_props[] = {
142 POWER_SUPPLY_PROP_STATUS,
143 POWER_SUPPLY_PROP_PRESENT,
144 POWER_SUPPLY_PROP_HEALTH,
145 POWER_SUPPLY_PROP_VOLTAGE_MAX_DESIGN,
146 POWER_SUPPLY_PROP_VOLTAGE_NOW,
147 POWER_SUPPLY_PROP_VOLTAGE_OCV,
148 POWER_SUPPLY_PROP_CAPACITY,
149 POWER_SUPPLY_PROP_CAPACITY_ALERT_MIN,
150 POWER_SUPPLY_PROP_TECHNOLOGY,
151 /* The 3 props below are not used when no_current_sense_res is set */
152 POWER_SUPPLY_PROP_CHARGE_FULL,
153 POWER_SUPPLY_PROP_CHARGE_NOW,
154 POWER_SUPPLY_PROP_CURRENT_NOW,
155};
156
157static int fuel_gauge_reg_readb(struct axp288_fg_info *info, int reg)
158{
159 unsigned int val;
160 int ret;
161
162 ret = regmap_read(map: info->regmap, reg, val: &val);
163 if (ret < 0) {
164 dev_err(info->dev, "Error reading reg 0x%02x err: %d\n", reg, ret);
165 return ret;
166 }
167
168 return val;
169}
170
171static int fuel_gauge_reg_writeb(struct axp288_fg_info *info, int reg, u8 val)
172{
173 int ret;
174
175 ret = regmap_write(map: info->regmap, reg, val: (unsigned int)val);
176
177 if (ret < 0)
178 dev_err(info->dev, "Error writing reg 0x%02x err: %d\n", reg, ret);
179
180 return ret;
181}
182
183static int fuel_gauge_read_15bit_word(struct axp288_fg_info *info, int reg)
184{
185 unsigned char buf[2];
186 int ret;
187
188 ret = regmap_bulk_read(map: info->regmap, reg, val: buf, val_count: 2);
189 if (ret < 0) {
190 dev_err(info->dev, "Error reading reg 0x%02x err: %d\n", reg, ret);
191 return ret;
192 }
193
194 ret = get_unaligned_be16(p: buf);
195 if (!(ret & FG_15BIT_WORD_VALID)) {
196 dev_err(info->dev, "Error reg 0x%02x contents not valid\n", reg);
197 return -ENXIO;
198 }
199
200 return ret & FG_15BIT_VAL_MASK;
201}
202
203static int fuel_gauge_read_12bit_word(struct axp288_fg_info *info, int reg)
204{
205 unsigned char buf[2];
206 int ret;
207
208 ret = regmap_bulk_read(map: info->regmap, reg, val: buf, val_count: 2);
209 if (ret < 0) {
210 dev_err(info->dev, "Error reading reg 0x%02x err: %d\n", reg, ret);
211 return ret;
212 }
213
214 /* 12-bit data values have upper 8 bits in buf[0], lower 4 in buf[1] */
215 return (buf[0] << 4) | ((buf[1] >> 4) & 0x0f);
216}
217
218static int fuel_gauge_update_registers(struct axp288_fg_info *info)
219{
220 int ret;
221
222 if (info->valid && time_before(jiffies, info->last_updated + AXP288_REG_UPDATE_INTERVAL))
223 return 0;
224
225 dev_dbg(info->dev, "Fuel Gauge updating register values...\n");
226
227 ret = iosf_mbi_block_punit_i2c_access();
228 if (ret < 0)
229 return ret;
230
231 ret = fuel_gauge_reg_readb(info, AXP20X_PWR_INPUT_STATUS);
232 if (ret < 0)
233 goto out;
234 info->pwr_stat = ret;
235
236 if (no_current_sense_res)
237 ret = fuel_gauge_reg_readb(info, AXP288_FG_OCV_CAP_REG);
238 else
239 ret = fuel_gauge_reg_readb(info, AXP20X_FG_RES);
240 if (ret < 0)
241 goto out;
242 info->fg_res = ret;
243
244 ret = iio_read_channel_raw(chan: info->iio_channel[BAT_VOLT], val: &info->bat_volt);
245 if (ret < 0)
246 goto out;
247
248 ret = fuel_gauge_read_12bit_word(info, AXP288_FG_OCVH_REG);
249 if (ret < 0)
250 goto out;
251 info->ocv = ret;
252
253 if (no_current_sense_res)
254 goto out_no_current_sense_res;
255
256 if (info->pwr_stat & PS_STAT_BAT_CHRG_DIR) {
257 info->d_curr = 0;
258 ret = iio_read_channel_raw(chan: info->iio_channel[BAT_CHRG_CURR], val: &info->c_curr);
259 if (ret < 0)
260 goto out;
261 } else {
262 info->c_curr = 0;
263 ret = iio_read_channel_raw(chan: info->iio_channel[BAT_D_CURR], val: &info->d_curr);
264 if (ret < 0)
265 goto out;
266 }
267
268 ret = fuel_gauge_read_15bit_word(info, AXP288_FG_CC_MTR1_REG);
269 if (ret < 0)
270 goto out;
271 info->fg_cc_mtr1 = ret;
272
273 ret = fuel_gauge_read_15bit_word(info, AXP288_FG_DES_CAP1_REG);
274 if (ret < 0)
275 goto out;
276 info->fg_des_cap1 = ret;
277
278out_no_current_sense_res:
279 info->last_updated = jiffies;
280 info->valid = 1;
281 ret = 0;
282out:
283 iosf_mbi_unblock_punit_i2c_access();
284 return ret;
285}
286
287static void fuel_gauge_get_status(struct axp288_fg_info *info)
288{
289 int pwr_stat = info->pwr_stat;
290 int fg_res = info->fg_res;
291 int curr = info->d_curr;
292
293 /* Report full if Vbus is valid and the reported capacity is 100% */
294 if (!(pwr_stat & PS_STAT_VBUS_VALID))
295 goto not_full;
296
297 if (!(fg_res & FG_REP_CAP_VALID))
298 goto not_full;
299
300 fg_res &= ~FG_REP_CAP_VALID;
301 if (fg_res == 100) {
302 info->status = POWER_SUPPLY_STATUS_FULL;
303 return;
304 }
305
306 /*
307 * Sometimes the charger turns itself off before fg-res reaches 100%.
308 * When this happens the AXP288 reports a not-charging status and
309 * 0 mA discharge current.
310 */
311 if (fg_res < 90 || (pwr_stat & PS_STAT_BAT_CHRG_DIR) || no_current_sense_res)
312 goto not_full;
313
314 if (curr == 0) {
315 info->status = POWER_SUPPLY_STATUS_FULL;
316 return;
317 }
318
319not_full:
320 if (pwr_stat & PS_STAT_BAT_CHRG_DIR)
321 info->status = POWER_SUPPLY_STATUS_CHARGING;
322 else
323 info->status = POWER_SUPPLY_STATUS_DISCHARGING;
324}
325
326static int fuel_gauge_battery_health(struct axp288_fg_info *info)
327{
328 int vocv = VOLTAGE_FROM_ADC(info->ocv);
329 int health = POWER_SUPPLY_HEALTH_UNKNOWN;
330
331 if (vocv > info->max_volt)
332 health = POWER_SUPPLY_HEALTH_OVERVOLTAGE;
333 else
334 health = POWER_SUPPLY_HEALTH_GOOD;
335
336 return health;
337}
338
339static int fuel_gauge_get_property(struct power_supply *ps,
340 enum power_supply_property prop,
341 union power_supply_propval *val)
342{
343 struct axp288_fg_info *info = power_supply_get_drvdata(psy: ps);
344 int ret, value;
345
346 mutex_lock(&info->lock);
347
348 ret = fuel_gauge_update_registers(info);
349 if (ret < 0)
350 goto out;
351
352 switch (prop) {
353 case POWER_SUPPLY_PROP_STATUS:
354 fuel_gauge_get_status(info);
355 val->intval = info->status;
356 break;
357 case POWER_SUPPLY_PROP_HEALTH:
358 val->intval = fuel_gauge_battery_health(info);
359 break;
360 case POWER_SUPPLY_PROP_VOLTAGE_NOW:
361 value = VOLTAGE_FROM_ADC(info->bat_volt);
362 val->intval = PROP_VOLT(value);
363 break;
364 case POWER_SUPPLY_PROP_VOLTAGE_OCV:
365 value = VOLTAGE_FROM_ADC(info->ocv);
366 val->intval = PROP_VOLT(value);
367 break;
368 case POWER_SUPPLY_PROP_CURRENT_NOW:
369 if (info->d_curr > 0)
370 value = -1 * info->d_curr;
371 else
372 value = info->c_curr;
373
374 val->intval = PROP_CURR(value);
375 break;
376 case POWER_SUPPLY_PROP_PRESENT:
377 if (info->pwr_op & CHRG_STAT_BAT_PRESENT)
378 val->intval = 1;
379 else
380 val->intval = 0;
381 break;
382 case POWER_SUPPLY_PROP_CAPACITY:
383 if (!(info->fg_res & FG_REP_CAP_VALID))
384 dev_err(info->dev, "capacity measurement not valid\n");
385 val->intval = (info->fg_res & FG_REP_CAP_VAL_MASK);
386 break;
387 case POWER_SUPPLY_PROP_CAPACITY_ALERT_MIN:
388 val->intval = (info->low_cap & 0x0f);
389 break;
390 case POWER_SUPPLY_PROP_TECHNOLOGY:
391 val->intval = POWER_SUPPLY_TECHNOLOGY_LION;
392 break;
393 case POWER_SUPPLY_PROP_CHARGE_NOW:
394 val->intval = info->fg_cc_mtr1 * FG_DES_CAP_RES_LSB;
395 break;
396 case POWER_SUPPLY_PROP_CHARGE_FULL:
397 val->intval = info->fg_des_cap1 * FG_DES_CAP_RES_LSB;
398 break;
399 case POWER_SUPPLY_PROP_VOLTAGE_MAX_DESIGN:
400 val->intval = PROP_VOLT(info->max_volt);
401 break;
402 default:
403 ret = -EINVAL;
404 }
405
406out:
407 mutex_unlock(lock: &info->lock);
408 return ret;
409}
410
411static int fuel_gauge_set_property(struct power_supply *ps,
412 enum power_supply_property prop,
413 const union power_supply_propval *val)
414{
415 struct axp288_fg_info *info = power_supply_get_drvdata(psy: ps);
416 int new_low_cap, ret = 0;
417
418 mutex_lock(&info->lock);
419 switch (prop) {
420 case POWER_SUPPLY_PROP_CAPACITY_ALERT_MIN:
421 if ((val->intval < 0) || (val->intval > 15)) {
422 ret = -EINVAL;
423 break;
424 }
425 new_low_cap = info->low_cap;
426 new_low_cap &= 0xf0;
427 new_low_cap |= (val->intval & 0xf);
428 ret = fuel_gauge_reg_writeb(info, AXP288_FG_LOW_CAP_REG, val: new_low_cap);
429 if (ret == 0)
430 info->low_cap = new_low_cap;
431 break;
432 default:
433 ret = -EINVAL;
434 break;
435 }
436
437 mutex_unlock(lock: &info->lock);
438 return ret;
439}
440
441static int fuel_gauge_property_is_writeable(struct power_supply *psy,
442 enum power_supply_property psp)
443{
444 int ret;
445
446 switch (psp) {
447 case POWER_SUPPLY_PROP_CAPACITY_ALERT_MIN:
448 ret = 1;
449 break;
450 default:
451 ret = 0;
452 }
453
454 return ret;
455}
456
457static irqreturn_t fuel_gauge_thread_handler(int irq, void *dev)
458{
459 struct axp288_fg_info *info = dev;
460 int i;
461
462 for (i = 0; i < AXP288_FG_INTR_NUM; i++) {
463 if (info->irq[i] == irq)
464 break;
465 }
466
467 if (i >= AXP288_FG_INTR_NUM) {
468 dev_warn(info->dev, "spurious interrupt!!\n");
469 return IRQ_NONE;
470 }
471
472 switch (i) {
473 case QWBTU_IRQ:
474 dev_info(info->dev, "Quit Battery under temperature in work mode IRQ (QWBTU)\n");
475 break;
476 case WBTU_IRQ:
477 dev_info(info->dev, "Battery under temperature in work mode IRQ (WBTU)\n");
478 break;
479 case QWBTO_IRQ:
480 dev_info(info->dev, "Quit Battery over temperature in work mode IRQ (QWBTO)\n");
481 break;
482 case WBTO_IRQ:
483 dev_info(info->dev, "Battery over temperature in work mode IRQ (WBTO)\n");
484 break;
485 case WL2_IRQ:
486 dev_info(info->dev, "Low Batt Warning(2) INTR\n");
487 break;
488 case WL1_IRQ:
489 dev_info(info->dev, "Low Batt Warning(1) INTR\n");
490 break;
491 default:
492 dev_warn(info->dev, "Spurious Interrupt!!!\n");
493 }
494
495 mutex_lock(&info->lock);
496 info->valid = 0; /* Force updating of the cached registers */
497 mutex_unlock(lock: &info->lock);
498
499 power_supply_changed(psy: info->bat);
500 return IRQ_HANDLED;
501}
502
503static void fuel_gauge_external_power_changed(struct power_supply *psy)
504{
505 struct axp288_fg_info *info = power_supply_get_drvdata(psy);
506
507 mutex_lock(&info->lock);
508 info->valid = 0; /* Force updating of the cached registers */
509 mutex_unlock(lock: &info->lock);
510 power_supply_changed(psy);
511}
512
513static struct power_supply_desc fuel_gauge_desc = {
514 .name = DEV_NAME,
515 .type = POWER_SUPPLY_TYPE_BATTERY,
516 .properties = fuel_gauge_props,
517 .num_properties = ARRAY_SIZE(fuel_gauge_props),
518 .get_property = fuel_gauge_get_property,
519 .set_property = fuel_gauge_set_property,
520 .property_is_writeable = fuel_gauge_property_is_writeable,
521 .external_power_changed = fuel_gauge_external_power_changed,
522};
523
524/*
525 * Some devices have no battery (HDMI sticks) and the axp288 battery's
526 * detection reports one despite it not being there.
527 * Please keep this listed sorted alphabetically.
528 */
529static const struct dmi_system_id axp288_quirks[] = {
530 {
531 /* ACEPC T8 Cherry Trail Z8350 mini PC */
532 .matches = {
533 DMI_EXACT_MATCH(DMI_BOARD_VENDOR, "To be filled by O.E.M."),
534 DMI_EXACT_MATCH(DMI_BOARD_NAME, "Cherry Trail CR"),
535 DMI_EXACT_MATCH(DMI_PRODUCT_SKU, "T8"),
536 /* also match on somewhat unique bios-version */
537 DMI_EXACT_MATCH(DMI_BIOS_VERSION, "1.000"),
538 },
539 .driver_data = (void *)AXP288_QUIRK_NO_BATTERY,
540 },
541 {
542 /* ACEPC T11 Cherry Trail Z8350 mini PC */
543 .matches = {
544 DMI_EXACT_MATCH(DMI_BOARD_VENDOR, "To be filled by O.E.M."),
545 DMI_EXACT_MATCH(DMI_BOARD_NAME, "Cherry Trail CR"),
546 DMI_EXACT_MATCH(DMI_PRODUCT_SKU, "T11"),
547 /* also match on somewhat unique bios-version */
548 DMI_EXACT_MATCH(DMI_BIOS_VERSION, "1.000"),
549 },
550 .driver_data = (void *)AXP288_QUIRK_NO_BATTERY,
551 },
552 {
553 /* Intel Bay Trail Compute Stick */
554 .matches = {
555 DMI_MATCH(DMI_SYS_VENDOR, "Intel"),
556 /* Partial match for STCK1A32WFC STCK1A32FC, STCK1A8LFC variants */
557 DMI_MATCH(DMI_PRODUCT_NAME, "STCK1A"),
558 },
559 .driver_data = (void *)AXP288_QUIRK_NO_BATTERY,
560 },
561 {
562 /* Intel Cherry Trail Compute Stick */
563 .matches = {
564 DMI_MATCH(DMI_SYS_VENDOR, "Intel"),
565 /* Partial match for STK1AW32SC and STK1A32SC variants */
566 DMI_MATCH(DMI_PRODUCT_NAME, "STK1A"),
567 },
568 .driver_data = (void *)AXP288_QUIRK_NO_BATTERY,
569 },
570 {
571 /* Meegopad T02 */
572 .matches = {
573 DMI_MATCH(DMI_PRODUCT_NAME, "MEEGOPAD T02"),
574 },
575 .driver_data = (void *)AXP288_QUIRK_NO_BATTERY,
576 },
577 { /* Mele PCG03 Mini PC */
578 .matches = {
579 DMI_EXACT_MATCH(DMI_BOARD_VENDOR, "Mini PC"),
580 DMI_EXACT_MATCH(DMI_BOARD_NAME, "Mini PC"),
581 },
582 .driver_data = (void *)AXP288_QUIRK_NO_BATTERY,
583 },
584 {
585 /* Minix Neo Z83-4 mini PC */
586 .matches = {
587 DMI_MATCH(DMI_SYS_VENDOR, "MINIX"),
588 DMI_MATCH(DMI_PRODUCT_NAME, "Z83-4"),
589 },
590 .driver_data = (void *)AXP288_QUIRK_NO_BATTERY,
591 },
592 {
593 /*
594 * One Mix 1, this uses the "T3 MRD" boardname used by
595 * generic mini PCs, but it is a mini laptop so it does
596 * actually have a battery!
597 */
598 .matches = {
599 DMI_MATCH(DMI_BOARD_NAME, "T3 MRD"),
600 DMI_MATCH(DMI_BIOS_DATE, "06/14/2018"),
601 },
602 .driver_data = NULL,
603 },
604 {
605 /* Radxa ROCK Pi X Single Board Computer */
606 .matches = {
607 DMI_MATCH(DMI_BOARD_NAME, "ROCK Pi X"),
608 DMI_MATCH(DMI_BOARD_VENDOR, "Radxa"),
609 },
610 .driver_data = (void *)AXP288_QUIRK_NO_BATTERY,
611 },
612 {
613 /*
614 * Various Ace PC/Meegopad/MinisForum/Wintel Mini-PCs/HDMI-sticks
615 * This entry must be last because it is generic, this allows
616 * adding more specifuc quirks overriding this generic entry.
617 */
618 .matches = {
619 DMI_MATCH(DMI_BOARD_NAME, "T3 MRD"),
620 DMI_MATCH(DMI_CHASSIS_TYPE, "3"),
621 DMI_MATCH(DMI_BIOS_VENDOR, "American Megatrends Inc."),
622 },
623 .driver_data = (void *)AXP288_QUIRK_NO_BATTERY,
624 },
625 {}
626};
627
628static int axp288_fuel_gauge_read_initial_regs(struct axp288_fg_info *info)
629{
630 unsigned int val;
631 int ret;
632
633 /*
634 * On some devices the fuelgauge and charger parts of the axp288 are
635 * not used, check that the fuelgauge is enabled (CC_CTRL != 0).
636 */
637 ret = regmap_read(map: info->regmap, AXP20X_CC_CTRL, val: &val);
638 if (ret < 0)
639 return ret;
640 if (val == 0)
641 return -ENODEV;
642
643 ret = fuel_gauge_reg_readb(info, AXP288_FG_DES_CAP1_REG);
644 if (ret < 0)
645 return ret;
646
647 if (!(ret & FG_DES_CAP1_VALID)) {
648 dev_err(info->dev, "axp288 not configured by firmware\n");
649 return -ENODEV;
650 }
651
652 ret = fuel_gauge_reg_readb(info, AXP20X_CHRG_CTRL1);
653 if (ret < 0)
654 return ret;
655 switch ((ret & CHRG_CCCV_CV_MASK) >> CHRG_CCCV_CV_BIT_POS) {
656 case CHRG_CCCV_CV_4100MV:
657 info->max_volt = 4100;
658 break;
659 case CHRG_CCCV_CV_4150MV:
660 info->max_volt = 4150;
661 break;
662 case CHRG_CCCV_CV_4200MV:
663 info->max_volt = 4200;
664 break;
665 case CHRG_CCCV_CV_4350MV:
666 info->max_volt = 4350;
667 break;
668 }
669
670 ret = fuel_gauge_reg_readb(info, AXP20X_PWR_OP_MODE);
671 if (ret < 0)
672 return ret;
673 info->pwr_op = ret;
674
675 ret = fuel_gauge_reg_readb(info, AXP288_FG_LOW_CAP_REG);
676 if (ret < 0)
677 return ret;
678 info->low_cap = ret;
679
680 return 0;
681}
682
683static void axp288_fuel_gauge_release_iio_chans(void *data)
684{
685 struct axp288_fg_info *info = data;
686 int i;
687
688 for (i = 0; i < IIO_CHANNEL_NUM; i++)
689 if (!IS_ERR_OR_NULL(ptr: info->iio_channel[i]))
690 iio_channel_release(chan: info->iio_channel[i]);
691}
692
693static int axp288_fuel_gauge_probe(struct platform_device *pdev)
694{
695 struct axp288_fg_info *info;
696 struct axp20x_dev *axp20x = dev_get_drvdata(dev: pdev->dev.parent);
697 struct power_supply_config psy_cfg = {};
698 static const char * const iio_chan_name[] = {
699 [BAT_CHRG_CURR] = "axp288-chrg-curr",
700 [BAT_D_CURR] = "axp288-chrg-d-curr",
701 [BAT_VOLT] = "axp288-batt-volt",
702 };
703 const struct dmi_system_id *dmi_id;
704 struct device *dev = &pdev->dev;
705 unsigned long quirks = 0;
706 int i, pirq, ret;
707
708 /*
709 * Normally the native AXP288 fg/charger drivers are preferred but
710 * on some devices the ACPI drivers should be used instead.
711 */
712 if (!acpi_quirk_skip_acpi_ac_and_battery())
713 return -ENODEV;
714
715 dmi_id = dmi_first_match(list: axp288_quirks);
716 if (dmi_id)
717 quirks = (unsigned long)dmi_id->driver_data;
718
719 if (quirks & AXP288_QUIRK_NO_BATTERY)
720 return -ENODEV;
721
722 info = devm_kzalloc(dev, size: sizeof(*info), GFP_KERNEL);
723 if (!info)
724 return -ENOMEM;
725
726 info->dev = dev;
727 info->regmap = axp20x->regmap;
728 info->status = POWER_SUPPLY_STATUS_UNKNOWN;
729 info->valid = 0;
730
731 platform_set_drvdata(pdev, data: info);
732
733 mutex_init(&info->lock);
734
735 for (i = 0; i < AXP288_FG_INTR_NUM; i++) {
736 pirq = platform_get_irq(pdev, i);
737 if (pirq < 0)
738 continue;
739 ret = regmap_irq_get_virq(data: axp20x->regmap_irqc, irq: pirq);
740 if (ret < 0)
741 return dev_err_probe(dev, err: ret, fmt: "getting vIRQ %d\n", pirq);
742
743 info->irq[i] = ret;
744 }
745
746 for (i = 0; i < IIO_CHANNEL_NUM; i++) {
747 /*
748 * Note cannot use devm_iio_channel_get because x86 systems
749 * lack the device<->channel maps which iio_channel_get will
750 * try to use when passed a non NULL device pointer.
751 */
752 info->iio_channel[i] =
753 iio_channel_get(NULL, consumer_channel: iio_chan_name[i]);
754 if (IS_ERR(ptr: info->iio_channel[i])) {
755 ret = PTR_ERR(ptr: info->iio_channel[i]);
756 dev_dbg(dev, "error getting iiochan %s: %d\n", iio_chan_name[i], ret);
757 /* Wait for axp288_adc to load */
758 if (ret == -ENODEV)
759 ret = -EPROBE_DEFER;
760
761 axp288_fuel_gauge_release_iio_chans(data: info);
762 return ret;
763 }
764 }
765
766 ret = devm_add_action_or_reset(dev, axp288_fuel_gauge_release_iio_chans, info);
767 if (ret)
768 return ret;
769
770 ret = iosf_mbi_block_punit_i2c_access();
771 if (ret < 0)
772 return ret;
773
774 ret = axp288_fuel_gauge_read_initial_regs(info);
775 iosf_mbi_unblock_punit_i2c_access();
776 if (ret < 0)
777 return ret;
778
779 psy_cfg.drv_data = info;
780 if (no_current_sense_res)
781 fuel_gauge_desc.num_properties = ARRAY_SIZE(fuel_gauge_props) - 3;
782 info->bat = devm_power_supply_register(parent: dev, desc: &fuel_gauge_desc, cfg: &psy_cfg);
783 if (IS_ERR(ptr: info->bat)) {
784 ret = PTR_ERR(ptr: info->bat);
785 dev_err(dev, "failed to register battery: %d\n", ret);
786 return ret;
787 }
788
789 for (i = 0; i < AXP288_FG_INTR_NUM; i++) {
790 ret = devm_request_threaded_irq(dev, irq: info->irq[i], NULL,
791 thread_fn: fuel_gauge_thread_handler,
792 IRQF_ONESHOT, DEV_NAME, dev_id: info);
793 if (ret)
794 return dev_err_probe(dev, err: ret, fmt: "requesting IRQ %d\n", info->irq[i]);
795 }
796
797 return 0;
798}
799
800static const struct platform_device_id axp288_fg_id_table[] = {
801 { .name = DEV_NAME },
802 {},
803};
804MODULE_DEVICE_TABLE(platform, axp288_fg_id_table);
805
806static struct platform_driver axp288_fuel_gauge_driver = {
807 .probe = axp288_fuel_gauge_probe,
808 .id_table = axp288_fg_id_table,
809 .driver = {
810 .name = DEV_NAME,
811 },
812};
813
814module_platform_driver(axp288_fuel_gauge_driver);
815
816MODULE_AUTHOR("Ramakrishna Pallala <ramakrishna.pallala@intel.com>");
817MODULE_AUTHOR("Todd Brandt <todd.e.brandt@linux.intel.com>");
818MODULE_DESCRIPTION("Xpower AXP288 Fuel Gauge Driver");
819MODULE_LICENSE("GPL");
820

source code of linux/drivers/power/supply/axp288_fuel_gauge.c