diff options
author | MyungJoo Ham <myungjoo.ham@samsung.com> | 2011-01-14 00:46:11 -0500 |
---|---|---|
committer | Anton Vorontsov <cbouatmailru@gmail.com> | 2011-01-14 10:11:59 -0500 |
commit | 359ab9f5b154cbd807a11e22792235f0f36b0cd5 (patch) | |
tree | 3500652809c242b75deb5139ded7052c389e0bb4 /drivers/power | |
parent | bf542a4e7b634c2adcba4241a29082f69b0f45dc (diff) |
power_supply: Add MAX17042 Fuel Gauge Driver
The MAX17042 is a fuel gauge with an I2C interface for lithium-ion
betteries. Unlike its predecessor MAX17040, MAX17042 uses 16bit
registers. Besides, MAX17042 has much more features than MAX17040; e.g.,
a thermistor, current and current accumulation measurement, battery
internal resistance estimate, average values of measurement, and others.
This patch implements a driver for MAX17042.
In this initial release, we have implemented the most basic features of
a fuel gauge: measure the battery capacity and voltage.
Signed-off-by: MyungJoo Ham <myungjoo.ham@samsung.com>
Signed-off-by: Kyungmin Park <kyungmin.park@samsung.com>
Signed-off-by: Anton Vorontsov <cbouatmailru@gmail.com>
Diffstat (limited to 'drivers/power')
-rw-r--r-- | drivers/power/Kconfig | 10 | ||||
-rw-r--r-- | drivers/power/Makefile | 1 | ||||
-rw-r--r-- | drivers/power/max17042_battery.c | 239 |
3 files changed, 250 insertions, 0 deletions
diff --git a/drivers/power/Kconfig b/drivers/power/Kconfig index 32165295cb1b..61bf5d724139 100644 --- a/drivers/power/Kconfig +++ b/drivers/power/Kconfig | |||
@@ -136,6 +136,16 @@ config BATTERY_MAX17040 | |||
136 | in handheld and portable equipment. The MAX17040 is configured | 136 | in handheld and portable equipment. The MAX17040 is configured |
137 | to operate with a single lithium cell | 137 | to operate with a single lithium cell |
138 | 138 | ||
139 | config BATTERY_MAX17042 | ||
140 | tristate "Maxim MAX17042/8997/8966 Fuel Gauge" | ||
141 | depends on I2C | ||
142 | help | ||
143 | MAX17042 is fuel-gauge systems for lithium-ion (Li+) batteries | ||
144 | in handheld and portable equipment. The MAX17042 is configured | ||
145 | to operate with a single lithium cell. MAX8997 and MAX8966 are | ||
146 | multi-function devices that include fuel gauages that are compatible | ||
147 | with MAX17042. | ||
148 | |||
139 | config BATTERY_Z2 | 149 | config BATTERY_Z2 |
140 | tristate "Z2 battery driver" | 150 | tristate "Z2 battery driver" |
141 | depends on I2C && MACH_ZIPIT2 | 151 | depends on I2C && MACH_ZIPIT2 |
diff --git a/drivers/power/Makefile b/drivers/power/Makefile index 545459f9f356..8385bfae8728 100644 --- a/drivers/power/Makefile +++ b/drivers/power/Makefile | |||
@@ -25,6 +25,7 @@ obj-$(CONFIG_BATTERY_BQ20Z75) += bq20z75.o | |||
25 | obj-$(CONFIG_BATTERY_BQ27x00) += bq27x00_battery.o | 25 | obj-$(CONFIG_BATTERY_BQ27x00) += bq27x00_battery.o |
26 | obj-$(CONFIG_BATTERY_DA9030) += da9030_battery.o | 26 | obj-$(CONFIG_BATTERY_DA9030) += da9030_battery.o |
27 | obj-$(CONFIG_BATTERY_MAX17040) += max17040_battery.o | 27 | obj-$(CONFIG_BATTERY_MAX17040) += max17040_battery.o |
28 | obj-$(CONFIG_BATTERY_MAX17042) += max17042_battery.o | ||
28 | obj-$(CONFIG_BATTERY_Z2) += z2_battery.o | 29 | obj-$(CONFIG_BATTERY_Z2) += z2_battery.o |
29 | obj-$(CONFIG_BATTERY_S3C_ADC) += s3c_adc_battery.o | 30 | obj-$(CONFIG_BATTERY_S3C_ADC) += s3c_adc_battery.o |
30 | obj-$(CONFIG_CHARGER_PCF50633) += pcf50633-charger.o | 31 | obj-$(CONFIG_CHARGER_PCF50633) += pcf50633-charger.o |
diff --git a/drivers/power/max17042_battery.c b/drivers/power/max17042_battery.c new file mode 100644 index 000000000000..c5c8805156cb --- /dev/null +++ b/drivers/power/max17042_battery.c | |||
@@ -0,0 +1,239 @@ | |||
1 | /* | ||
2 | * Fuel gauge driver for Maxim 17042 / 8966 / 8997 | ||
3 | * Note that Maxim 8966 and 8997 are mfd and this is its subdevice. | ||
4 | * | ||
5 | * Copyright (C) 2011 Samsung Electronics | ||
6 | * MyungJoo Ham <myungjoo.ham@samsung.com> | ||
7 | * | ||
8 | * This program is free software; you can redistribute it and/or modify | ||
9 | * it under the terms of the GNU General Public License as published by | ||
10 | * the Free Software Foundation; either version 2 of the License, or | ||
11 | * (at your option) any later version. | ||
12 | * | ||
13 | * This program is distributed in the hope that it will be useful, | ||
14 | * but WITHOUT ANY WARRANTY; without even the implied warranty of | ||
15 | * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | ||
16 | * GNU General Public License for more details. | ||
17 | * | ||
18 | * You should have received a copy of the GNU General Public License | ||
19 | * along with this program; if not, write to the Free Software | ||
20 | * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA | ||
21 | * | ||
22 | * This driver is based on max17040_battery.c | ||
23 | */ | ||
24 | |||
25 | #include <linux/init.h> | ||
26 | #include <linux/slab.h> | ||
27 | #include <linux/i2c.h> | ||
28 | #include <linux/mod_devicetable.h> | ||
29 | #include <linux/power_supply.h> | ||
30 | #include <linux/power/max17042_battery.h> | ||
31 | |||
32 | enum max17042_register { | ||
33 | MAX17042_STATUS = 0x00, | ||
34 | MAX17042_VALRT_Th = 0x01, | ||
35 | MAX17042_TALRT_Th = 0x02, | ||
36 | MAX17042_SALRT_Th = 0x03, | ||
37 | MAX17042_AtRate = 0x04, | ||
38 | MAX17042_RepCap = 0x05, | ||
39 | MAX17042_RepSOC = 0x06, | ||
40 | MAX17042_Age = 0x07, | ||
41 | MAX17042_TEMP = 0x08, | ||
42 | MAX17042_VCELL = 0x09, | ||
43 | MAX17042_Current = 0x0A, | ||
44 | MAX17042_AvgCurrent = 0x0B, | ||
45 | MAX17042_Qresidual = 0x0C, | ||
46 | MAX17042_SOC = 0x0D, | ||
47 | MAX17042_AvSOC = 0x0E, | ||
48 | MAX17042_RemCap = 0x0F, | ||
49 | MAX17402_FullCAP = 0x10, | ||
50 | MAX17042_TTE = 0x11, | ||
51 | MAX17042_V_empty = 0x12, | ||
52 | |||
53 | MAX17042_RSLOW = 0x14, | ||
54 | |||
55 | MAX17042_AvgTA = 0x16, | ||
56 | MAX17042_Cycles = 0x17, | ||
57 | MAX17042_DesignCap = 0x18, | ||
58 | MAX17042_AvgVCELL = 0x19, | ||
59 | MAX17042_MinMaxTemp = 0x1A, | ||
60 | MAX17042_MinMaxVolt = 0x1B, | ||
61 | MAX17042_MinMaxCurr = 0x1C, | ||
62 | MAX17042_CONFIG = 0x1D, | ||
63 | MAX17042_ICHGTerm = 0x1E, | ||
64 | MAX17042_AvCap = 0x1F, | ||
65 | MAX17042_ManName = 0x20, | ||
66 | MAX17042_DevName = 0x21, | ||
67 | MAX17042_DevChem = 0x22, | ||
68 | |||
69 | MAX17042_TempNom = 0x24, | ||
70 | MAX17042_TempCold = 0x25, | ||
71 | MAX17042_TempHot = 0x26, | ||
72 | MAX17042_AIN = 0x27, | ||
73 | MAX17042_LearnCFG = 0x28, | ||
74 | MAX17042_SHFTCFG = 0x29, | ||
75 | MAX17042_RelaxCFG = 0x2A, | ||
76 | MAX17042_MiscCFG = 0x2B, | ||
77 | MAX17042_TGAIN = 0x2C, | ||
78 | MAx17042_TOFF = 0x2D, | ||
79 | MAX17042_CGAIN = 0x2E, | ||
80 | MAX17042_COFF = 0x2F, | ||
81 | |||
82 | MAX17042_Q_empty = 0x33, | ||
83 | MAX17042_T_empty = 0x34, | ||
84 | |||
85 | MAX17042_RCOMP0 = 0x38, | ||
86 | MAX17042_TempCo = 0x39, | ||
87 | MAX17042_Rx = 0x3A, | ||
88 | MAX17042_T_empty0 = 0x3B, | ||
89 | MAX17042_TaskPeriod = 0x3C, | ||
90 | MAX17042_FSTAT = 0x3D, | ||
91 | |||
92 | MAX17042_SHDNTIMER = 0x3F, | ||
93 | |||
94 | MAX17042_VFRemCap = 0x4A, | ||
95 | |||
96 | MAX17042_QH = 0x4D, | ||
97 | MAX17042_QL = 0x4E, | ||
98 | }; | ||
99 | |||
100 | struct max17042_chip { | ||
101 | struct i2c_client *client; | ||
102 | struct power_supply battery; | ||
103 | struct max17042_platform_data *pdata; | ||
104 | }; | ||
105 | |||
106 | static int max17042_write_reg(struct i2c_client *client, u8 reg, u16 value) | ||
107 | { | ||
108 | int ret = i2c_smbus_write_word_data(client, reg, value); | ||
109 | |||
110 | if (ret < 0) | ||
111 | dev_err(&client->dev, "%s: err %d\n", __func__, ret); | ||
112 | |||
113 | return ret; | ||
114 | } | ||
115 | |||
116 | static int max17042_read_reg(struct i2c_client *client, u8 reg) | ||
117 | { | ||
118 | int ret = i2c_smbus_read_word_data(client, reg); | ||
119 | |||
120 | if (ret < 0) | ||
121 | dev_err(&client->dev, "%s: err %d\n", __func__, ret); | ||
122 | |||
123 | return ret; | ||
124 | } | ||
125 | |||
126 | static enum power_supply_property max17042_battery_props[] = { | ||
127 | POWER_SUPPLY_PROP_VOLTAGE_NOW, | ||
128 | POWER_SUPPLY_PROP_VOLTAGE_AVG, | ||
129 | POWER_SUPPLY_PROP_CAPACITY, | ||
130 | }; | ||
131 | |||
132 | static int max17042_get_property(struct power_supply *psy, | ||
133 | enum power_supply_property psp, | ||
134 | union power_supply_propval *val) | ||
135 | { | ||
136 | struct max17042_chip *chip = container_of(psy, | ||
137 | struct max17042_chip, battery); | ||
138 | |||
139 | switch (psp) { | ||
140 | case POWER_SUPPLY_PROP_VOLTAGE_NOW: | ||
141 | val->intval = max17042_read_reg(chip->client, | ||
142 | MAX17042_VCELL) * 83; /* 1000 / 12 = 83 */ | ||
143 | break; | ||
144 | case POWER_SUPPLY_PROP_VOLTAGE_AVG: | ||
145 | val->intval = max17042_read_reg(chip->client, | ||
146 | MAX17042_AvgVCELL) * 83; | ||
147 | break; | ||
148 | case POWER_SUPPLY_PROP_CAPACITY: | ||
149 | val->intval = max17042_read_reg(chip->client, | ||
150 | MAX17042_SOC) / 256; | ||
151 | break; | ||
152 | default: | ||
153 | return -EINVAL; | ||
154 | } | ||
155 | return 0; | ||
156 | } | ||
157 | |||
158 | static int __devinit max17042_probe(struct i2c_client *client, | ||
159 | const struct i2c_device_id *id) | ||
160 | { | ||
161 | struct i2c_adapter *adapter = to_i2c_adapter(client->dev.parent); | ||
162 | struct max17042_chip *chip; | ||
163 | int ret; | ||
164 | |||
165 | if (!i2c_check_functionality(adapter, I2C_FUNC_SMBUS_WORD_DATA)) | ||
166 | return -EIO; | ||
167 | |||
168 | chip = kzalloc(sizeof(*chip), GFP_KERNEL); | ||
169 | if (!chip) | ||
170 | return -ENOMEM; | ||
171 | |||
172 | chip->client = client; | ||
173 | chip->pdata = client->dev.platform_data; | ||
174 | |||
175 | i2c_set_clientdata(client, chip); | ||
176 | |||
177 | chip->battery.name = "max17042_battery"; | ||
178 | chip->battery.type = POWER_SUPPLY_TYPE_BATTERY; | ||
179 | chip->battery.get_property = max17042_get_property; | ||
180 | chip->battery.properties = max17042_battery_props; | ||
181 | chip->battery.num_properties = ARRAY_SIZE(max17042_battery_props); | ||
182 | |||
183 | ret = power_supply_register(&client->dev, &chip->battery); | ||
184 | if (ret) { | ||
185 | dev_err(&client->dev, "failed: power supply register\n"); | ||
186 | i2c_set_clientdata(client, NULL); | ||
187 | kfree(chip); | ||
188 | return ret; | ||
189 | } | ||
190 | |||
191 | if (!chip->pdata->enable_current_sense) { | ||
192 | max17042_write_reg(client, MAX17042_CGAIN, 0x0000); | ||
193 | max17042_write_reg(client, MAX17042_MiscCFG, 0x0003); | ||
194 | max17042_write_reg(client, MAX17042_LearnCFG, 0x0007); | ||
195 | } | ||
196 | |||
197 | return 0; | ||
198 | } | ||
199 | |||
200 | static int __devexit max17042_remove(struct i2c_client *client) | ||
201 | { | ||
202 | struct max17042_chip *chip = i2c_get_clientdata(client); | ||
203 | |||
204 | power_supply_unregister(&chip->battery); | ||
205 | i2c_set_clientdata(client, NULL); | ||
206 | kfree(chip); | ||
207 | return 0; | ||
208 | } | ||
209 | |||
210 | static const struct i2c_device_id max17042_id[] = { | ||
211 | { "max17042", 0 }, | ||
212 | { } | ||
213 | }; | ||
214 | MODULE_DEVICE_TABLE(i2c, max17042_id); | ||
215 | |||
216 | static struct i2c_driver max17042_i2c_driver = { | ||
217 | .driver = { | ||
218 | .name = "max17042", | ||
219 | }, | ||
220 | .probe = max17042_probe, | ||
221 | .remove = __devexit_p(max17042_remove), | ||
222 | .id_table = max17042_id, | ||
223 | }; | ||
224 | |||
225 | static int __init max17042_init(void) | ||
226 | { | ||
227 | return i2c_add_driver(&max17042_i2c_driver); | ||
228 | } | ||
229 | module_init(max17042_init); | ||
230 | |||
231 | static void __exit max17042_exit(void) | ||
232 | { | ||
233 | i2c_del_driver(&max17042_i2c_driver); | ||
234 | } | ||
235 | module_exit(max17042_exit); | ||
236 | |||
237 | MODULE_AUTHOR("MyungJoo Ham <myungjoo.ham@samsung.com>"); | ||
238 | MODULE_DESCRIPTION("MAX17042 Fuel Gauge"); | ||
239 | MODULE_LICENSE("GPL"); | ||