xref: /linux/drivers/mfd/max8998.c (revision 04eeb606a8383b306f4bc6991da8231b5f3924b0)
1 /*
2  * max8998.c - mfd core driver for the Maxim 8998
3  *
4  *  Copyright (C) 2009-2010 Samsung Electronics
5  *  Kyungmin Park <kyungmin.park@samsung.com>
6  *  Marek Szyprowski <m.szyprowski@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 
23 #include <linux/err.h>
24 #include <linux/module.h>
25 #include <linux/moduleparam.h>
26 #include <linux/init.h>
27 #include <linux/slab.h>
28 #include <linux/i2c.h>
29 #include <linux/interrupt.h>
30 #include <linux/of.h>
31 #include <linux/of_irq.h>
32 #include <linux/pm_runtime.h>
33 #include <linux/mutex.h>
34 #include <linux/mfd/core.h>
35 #include <linux/mfd/max8998.h>
36 #include <linux/mfd/max8998-private.h>
37 
38 #define RTC_I2C_ADDR		(0x0c >> 1)
39 
40 static const struct mfd_cell max8998_devs[] = {
41 	{
42 		.name = "max8998-pmic",
43 	}, {
44 		.name = "max8998-rtc",
45 	}, {
46 		.name = "max8998-battery",
47 	},
48 };
49 
50 static const struct mfd_cell lp3974_devs[] = {
51 	{
52 		.name = "lp3974-pmic",
53 	}, {
54 		.name = "lp3974-rtc",
55 	},
56 };
57 
58 int max8998_read_reg(struct i2c_client *i2c, u8 reg, u8 *dest)
59 {
60 	struct max8998_dev *max8998 = i2c_get_clientdata(i2c);
61 	int ret;
62 
63 	mutex_lock(&max8998->iolock);
64 	ret = i2c_smbus_read_byte_data(i2c, reg);
65 	mutex_unlock(&max8998->iolock);
66 	if (ret < 0)
67 		return ret;
68 
69 	ret &= 0xff;
70 	*dest = ret;
71 	return 0;
72 }
73 EXPORT_SYMBOL(max8998_read_reg);
74 
75 int max8998_bulk_read(struct i2c_client *i2c, u8 reg, int count, u8 *buf)
76 {
77 	struct max8998_dev *max8998 = i2c_get_clientdata(i2c);
78 	int ret;
79 
80 	mutex_lock(&max8998->iolock);
81 	ret = i2c_smbus_read_i2c_block_data(i2c, reg, count, buf);
82 	mutex_unlock(&max8998->iolock);
83 	if (ret < 0)
84 		return ret;
85 
86 	return 0;
87 }
88 EXPORT_SYMBOL(max8998_bulk_read);
89 
90 int max8998_write_reg(struct i2c_client *i2c, u8 reg, u8 value)
91 {
92 	struct max8998_dev *max8998 = i2c_get_clientdata(i2c);
93 	int ret;
94 
95 	mutex_lock(&max8998->iolock);
96 	ret = i2c_smbus_write_byte_data(i2c, reg, value);
97 	mutex_unlock(&max8998->iolock);
98 	return ret;
99 }
100 EXPORT_SYMBOL(max8998_write_reg);
101 
102 int max8998_bulk_write(struct i2c_client *i2c, u8 reg, int count, u8 *buf)
103 {
104 	struct max8998_dev *max8998 = i2c_get_clientdata(i2c);
105 	int ret;
106 
107 	mutex_lock(&max8998->iolock);
108 	ret = i2c_smbus_write_i2c_block_data(i2c, reg, count, buf);
109 	mutex_unlock(&max8998->iolock);
110 	if (ret < 0)
111 		return ret;
112 
113 	return 0;
114 }
115 EXPORT_SYMBOL(max8998_bulk_write);
116 
117 int max8998_update_reg(struct i2c_client *i2c, u8 reg, u8 val, u8 mask)
118 {
119 	struct max8998_dev *max8998 = i2c_get_clientdata(i2c);
120 	int ret;
121 
122 	mutex_lock(&max8998->iolock);
123 	ret = i2c_smbus_read_byte_data(i2c, reg);
124 	if (ret >= 0) {
125 		u8 old_val = ret & 0xff;
126 		u8 new_val = (val & mask) | (old_val & (~mask));
127 		ret = i2c_smbus_write_byte_data(i2c, reg, new_val);
128 	}
129 	mutex_unlock(&max8998->iolock);
130 	return ret;
131 }
132 EXPORT_SYMBOL(max8998_update_reg);
133 
134 #ifdef CONFIG_OF
135 static const struct of_device_id max8998_dt_match[] = {
136 	{ .compatible = "maxim,max8998", .data = (void *)TYPE_MAX8998 },
137 	{ .compatible = "national,lp3974", .data = (void *)TYPE_LP3974 },
138 	{ .compatible = "ti,lp3974", .data = (void *)TYPE_LP3974 },
139 	{},
140 };
141 MODULE_DEVICE_TABLE(of, max8998_dt_match);
142 #endif
143 
144 /*
145  * Only the common platform data elements for max8998 are parsed here from the
146  * device tree. Other sub-modules of max8998 such as pmic, rtc and others have
147  * to parse their own platform data elements from device tree.
148  *
149  * The max8998 platform data structure is instantiated here and the drivers for
150  * the sub-modules need not instantiate another instance while parsing their
151  * platform data.
152  */
153 static struct max8998_platform_data *max8998_i2c_parse_dt_pdata(
154 							struct device *dev)
155 {
156 	struct max8998_platform_data *pd;
157 
158 	pd = devm_kzalloc(dev, sizeof(*pd), GFP_KERNEL);
159 	if (!pd)
160 		return ERR_PTR(-ENOMEM);
161 
162 	pd->ono = irq_of_parse_and_map(dev->of_node, 1);
163 
164 	/*
165 	 * ToDo: the 'wakeup' member in the platform data is more of a linux
166 	 * specfic information. Hence, there is no binding for that yet and
167 	 * not parsed here.
168 	 */
169 	return pd;
170 }
171 
172 static inline unsigned long max8998_i2c_get_driver_data(struct i2c_client *i2c,
173 						const struct i2c_device_id *id)
174 {
175 	if (IS_ENABLED(CONFIG_OF) && i2c->dev.of_node) {
176 		const struct of_device_id *match;
177 		match = of_match_node(max8998_dt_match, i2c->dev.of_node);
178 		return (unsigned long)match->data;
179 	}
180 
181 	return id->driver_data;
182 }
183 
184 static int max8998_i2c_probe(struct i2c_client *i2c,
185 			    const struct i2c_device_id *id)
186 {
187 	struct max8998_platform_data *pdata = dev_get_platdata(&i2c->dev);
188 	struct max8998_dev *max8998;
189 	int ret = 0;
190 
191 	max8998 = devm_kzalloc(&i2c->dev, sizeof(struct max8998_dev),
192 				GFP_KERNEL);
193 	if (max8998 == NULL)
194 		return -ENOMEM;
195 
196 	if (IS_ENABLED(CONFIG_OF) && i2c->dev.of_node) {
197 		pdata = max8998_i2c_parse_dt_pdata(&i2c->dev);
198 		if (IS_ERR(pdata)) {
199 			ret = PTR_ERR(pdata);
200 			goto err;
201 		}
202 	}
203 
204 	i2c_set_clientdata(i2c, max8998);
205 	max8998->dev = &i2c->dev;
206 	max8998->i2c = i2c;
207 	max8998->irq = i2c->irq;
208 	max8998->type = max8998_i2c_get_driver_data(i2c, id);
209 	max8998->pdata = pdata;
210 	if (pdata) {
211 		max8998->ono = pdata->ono;
212 		max8998->irq_base = pdata->irq_base;
213 		max8998->wakeup = pdata->wakeup;
214 	}
215 	mutex_init(&max8998->iolock);
216 
217 	max8998->rtc = i2c_new_dummy(i2c->adapter, RTC_I2C_ADDR);
218 	if (!max8998->rtc) {
219 		dev_err(&i2c->dev, "Failed to allocate I2C device for RTC\n");
220 		return -ENODEV;
221 	}
222 	i2c_set_clientdata(max8998->rtc, max8998);
223 
224 	max8998_irq_init(max8998);
225 
226 	pm_runtime_set_active(max8998->dev);
227 
228 	switch (max8998->type) {
229 	case TYPE_LP3974:
230 		ret = mfd_add_devices(max8998->dev, -1,
231 				      lp3974_devs, ARRAY_SIZE(lp3974_devs),
232 				      NULL, 0, NULL);
233 		break;
234 	case TYPE_MAX8998:
235 		ret = mfd_add_devices(max8998->dev, -1,
236 				      max8998_devs, ARRAY_SIZE(max8998_devs),
237 				      NULL, 0, NULL);
238 		break;
239 	default:
240 		ret = -EINVAL;
241 	}
242 
243 	if (ret < 0)
244 		goto err;
245 
246 	device_init_wakeup(max8998->dev, max8998->wakeup);
247 
248 	return ret;
249 
250 err:
251 	mfd_remove_devices(max8998->dev);
252 	max8998_irq_exit(max8998);
253 	i2c_unregister_device(max8998->rtc);
254 	return ret;
255 }
256 
257 static int max8998_i2c_remove(struct i2c_client *i2c)
258 {
259 	struct max8998_dev *max8998 = i2c_get_clientdata(i2c);
260 
261 	mfd_remove_devices(max8998->dev);
262 	max8998_irq_exit(max8998);
263 	i2c_unregister_device(max8998->rtc);
264 
265 	return 0;
266 }
267 
268 static const struct i2c_device_id max8998_i2c_id[] = {
269 	{ "max8998", TYPE_MAX8998 },
270 	{ "lp3974", TYPE_LP3974},
271 	{ }
272 };
273 MODULE_DEVICE_TABLE(i2c, max8998_i2c_id);
274 
275 static int max8998_suspend(struct device *dev)
276 {
277 	struct i2c_client *i2c = container_of(dev, struct i2c_client, dev);
278 	struct max8998_dev *max8998 = i2c_get_clientdata(i2c);
279 
280 	if (device_may_wakeup(dev))
281 		irq_set_irq_wake(max8998->irq, 1);
282 	return 0;
283 }
284 
285 static int max8998_resume(struct device *dev)
286 {
287 	struct i2c_client *i2c = container_of(dev, struct i2c_client, dev);
288 	struct max8998_dev *max8998 = i2c_get_clientdata(i2c);
289 
290 	if (device_may_wakeup(dev))
291 		irq_set_irq_wake(max8998->irq, 0);
292 	/*
293 	 * In LP3974, if IRQ registers are not "read & clear"
294 	 * when it's set during sleep, the interrupt becomes
295 	 * disabled.
296 	 */
297 	return max8998_irq_resume(i2c_get_clientdata(i2c));
298 }
299 
300 struct max8998_reg_dump {
301 	u8	addr;
302 	u8	val;
303 };
304 #define SAVE_ITEM(x)	{ .addr = (x), .val = 0x0, }
305 static struct max8998_reg_dump max8998_dump[] = {
306 	SAVE_ITEM(MAX8998_REG_IRQM1),
307 	SAVE_ITEM(MAX8998_REG_IRQM2),
308 	SAVE_ITEM(MAX8998_REG_IRQM3),
309 	SAVE_ITEM(MAX8998_REG_IRQM4),
310 	SAVE_ITEM(MAX8998_REG_STATUSM1),
311 	SAVE_ITEM(MAX8998_REG_STATUSM2),
312 	SAVE_ITEM(MAX8998_REG_CHGR1),
313 	SAVE_ITEM(MAX8998_REG_CHGR2),
314 	SAVE_ITEM(MAX8998_REG_LDO_ACTIVE_DISCHARGE1),
315 	SAVE_ITEM(MAX8998_REG_LDO_ACTIVE_DISCHARGE1),
316 	SAVE_ITEM(MAX8998_REG_BUCK_ACTIVE_DISCHARGE3),
317 	SAVE_ITEM(MAX8998_REG_ONOFF1),
318 	SAVE_ITEM(MAX8998_REG_ONOFF2),
319 	SAVE_ITEM(MAX8998_REG_ONOFF3),
320 	SAVE_ITEM(MAX8998_REG_ONOFF4),
321 	SAVE_ITEM(MAX8998_REG_BUCK1_VOLTAGE1),
322 	SAVE_ITEM(MAX8998_REG_BUCK1_VOLTAGE2),
323 	SAVE_ITEM(MAX8998_REG_BUCK1_VOLTAGE3),
324 	SAVE_ITEM(MAX8998_REG_BUCK1_VOLTAGE4),
325 	SAVE_ITEM(MAX8998_REG_BUCK2_VOLTAGE1),
326 	SAVE_ITEM(MAX8998_REG_BUCK2_VOLTAGE2),
327 	SAVE_ITEM(MAX8998_REG_LDO2_LDO3),
328 	SAVE_ITEM(MAX8998_REG_LDO4),
329 	SAVE_ITEM(MAX8998_REG_LDO5),
330 	SAVE_ITEM(MAX8998_REG_LDO6),
331 	SAVE_ITEM(MAX8998_REG_LDO7),
332 	SAVE_ITEM(MAX8998_REG_LDO8_LDO9),
333 	SAVE_ITEM(MAX8998_REG_LDO10_LDO11),
334 	SAVE_ITEM(MAX8998_REG_LDO12),
335 	SAVE_ITEM(MAX8998_REG_LDO13),
336 	SAVE_ITEM(MAX8998_REG_LDO14),
337 	SAVE_ITEM(MAX8998_REG_LDO15),
338 	SAVE_ITEM(MAX8998_REG_LDO16),
339 	SAVE_ITEM(MAX8998_REG_LDO17),
340 	SAVE_ITEM(MAX8998_REG_BKCHR),
341 	SAVE_ITEM(MAX8998_REG_LBCNFG1),
342 	SAVE_ITEM(MAX8998_REG_LBCNFG2),
343 };
344 /* Save registers before hibernation */
345 static int max8998_freeze(struct device *dev)
346 {
347 	struct i2c_client *i2c = container_of(dev, struct i2c_client, dev);
348 	int i;
349 
350 	for (i = 0; i < ARRAY_SIZE(max8998_dump); i++)
351 		max8998_read_reg(i2c, max8998_dump[i].addr,
352 				&max8998_dump[i].val);
353 
354 	return 0;
355 }
356 
357 /* Restore registers after hibernation */
358 static int max8998_restore(struct device *dev)
359 {
360 	struct i2c_client *i2c = container_of(dev, struct i2c_client, dev);
361 	int i;
362 
363 	for (i = 0; i < ARRAY_SIZE(max8998_dump); i++)
364 		max8998_write_reg(i2c, max8998_dump[i].addr,
365 				max8998_dump[i].val);
366 
367 	return 0;
368 }
369 
370 static const struct dev_pm_ops max8998_pm = {
371 	.suspend = max8998_suspend,
372 	.resume = max8998_resume,
373 	.freeze = max8998_freeze,
374 	.restore = max8998_restore,
375 };
376 
377 static struct i2c_driver max8998_i2c_driver = {
378 	.driver = {
379 		   .name = "max8998",
380 		   .owner = THIS_MODULE,
381 		   .pm = &max8998_pm,
382 		   .of_match_table = of_match_ptr(max8998_dt_match),
383 	},
384 	.probe = max8998_i2c_probe,
385 	.remove = max8998_i2c_remove,
386 	.id_table = max8998_i2c_id,
387 };
388 
389 static int __init max8998_i2c_init(void)
390 {
391 	return i2c_add_driver(&max8998_i2c_driver);
392 }
393 /* init early so consumer devices can complete system boot */
394 subsys_initcall(max8998_i2c_init);
395 
396 static void __exit max8998_i2c_exit(void)
397 {
398 	i2c_del_driver(&max8998_i2c_driver);
399 }
400 module_exit(max8998_i2c_exit);
401 
402 MODULE_DESCRIPTION("MAXIM 8998 multi-function core driver");
403 MODULE_AUTHOR("Kyungmin Park <kyungmin.park@samsung.com>");
404 MODULE_LICENSE("GPL");
405