xref: /linux/drivers/mfd/max8997.c (revision 17cfcb68af3bc7d5e8ae08779b1853310a2949f3)
1 // SPDX-License-Identifier: GPL-2.0+
2 //
3 // max8997.c - mfd core driver for the Maxim 8966 and 8997
4 //
5 // Copyright (C) 2011 Samsung Electronics
6 // MyungJoo Ham <myungjoo.ham@samsung.com>
7 //
8 // This driver is based on max8998.c
9 
10 #include <linux/err.h>
11 #include <linux/slab.h>
12 #include <linux/i2c.h>
13 #include <linux/of.h>
14 #include <linux/of_irq.h>
15 #include <linux/interrupt.h>
16 #include <linux/pm_runtime.h>
17 #include <linux/init.h>
18 #include <linux/mutex.h>
19 #include <linux/mfd/core.h>
20 #include <linux/mfd/max8997.h>
21 #include <linux/mfd/max8997-private.h>
22 
23 #define I2C_ADDR_PMIC	(0xCC >> 1)
24 #define I2C_ADDR_MUIC	(0x4A >> 1)
25 #define I2C_ADDR_BATTERY	(0x6C >> 1)
26 #define I2C_ADDR_RTC	(0x0C >> 1)
27 #define I2C_ADDR_HAPTIC	(0x90 >> 1)
28 
29 static const struct mfd_cell max8997_devs[] = {
30 	{ .name = "max8997-pmic", },
31 	{ .name = "max8997-rtc", },
32 	{ .name = "max8997-battery", },
33 	{ .name = "max8997-haptic", },
34 	{ .name = "max8997-muic", },
35 	{ .name = "max8997-led", .id = 1 },
36 	{ .name = "max8997-led", .id = 2 },
37 };
38 
39 #ifdef CONFIG_OF
40 static const struct of_device_id max8997_pmic_dt_match[] = {
41 	{ .compatible = "maxim,max8997-pmic", .data = (void *)TYPE_MAX8997 },
42 	{},
43 };
44 #endif
45 
46 int max8997_read_reg(struct i2c_client *i2c, u8 reg, u8 *dest)
47 {
48 	struct max8997_dev *max8997 = i2c_get_clientdata(i2c);
49 	int ret;
50 
51 	mutex_lock(&max8997->iolock);
52 	ret = i2c_smbus_read_byte_data(i2c, reg);
53 	mutex_unlock(&max8997->iolock);
54 	if (ret < 0)
55 		return ret;
56 
57 	ret &= 0xff;
58 	*dest = ret;
59 	return 0;
60 }
61 EXPORT_SYMBOL_GPL(max8997_read_reg);
62 
63 int max8997_bulk_read(struct i2c_client *i2c, u8 reg, int count, u8 *buf)
64 {
65 	struct max8997_dev *max8997 = i2c_get_clientdata(i2c);
66 	int ret;
67 
68 	mutex_lock(&max8997->iolock);
69 	ret = i2c_smbus_read_i2c_block_data(i2c, reg, count, buf);
70 	mutex_unlock(&max8997->iolock);
71 	if (ret < 0)
72 		return ret;
73 
74 	return 0;
75 }
76 EXPORT_SYMBOL_GPL(max8997_bulk_read);
77 
78 int max8997_write_reg(struct i2c_client *i2c, u8 reg, u8 value)
79 {
80 	struct max8997_dev *max8997 = i2c_get_clientdata(i2c);
81 	int ret;
82 
83 	mutex_lock(&max8997->iolock);
84 	ret = i2c_smbus_write_byte_data(i2c, reg, value);
85 	mutex_unlock(&max8997->iolock);
86 	return ret;
87 }
88 EXPORT_SYMBOL_GPL(max8997_write_reg);
89 
90 int max8997_bulk_write(struct i2c_client *i2c, u8 reg, int count, u8 *buf)
91 {
92 	struct max8997_dev *max8997 = i2c_get_clientdata(i2c);
93 	int ret;
94 
95 	mutex_lock(&max8997->iolock);
96 	ret = i2c_smbus_write_i2c_block_data(i2c, reg, count, buf);
97 	mutex_unlock(&max8997->iolock);
98 	if (ret < 0)
99 		return ret;
100 
101 	return 0;
102 }
103 EXPORT_SYMBOL_GPL(max8997_bulk_write);
104 
105 int max8997_update_reg(struct i2c_client *i2c, u8 reg, u8 val, u8 mask)
106 {
107 	struct max8997_dev *max8997 = i2c_get_clientdata(i2c);
108 	int ret;
109 
110 	mutex_lock(&max8997->iolock);
111 	ret = i2c_smbus_read_byte_data(i2c, reg);
112 	if (ret >= 0) {
113 		u8 old_val = ret & 0xff;
114 		u8 new_val = (val & mask) | (old_val & (~mask));
115 		ret = i2c_smbus_write_byte_data(i2c, reg, new_val);
116 	}
117 	mutex_unlock(&max8997->iolock);
118 	return ret;
119 }
120 EXPORT_SYMBOL_GPL(max8997_update_reg);
121 
122 /*
123  * Only the common platform data elements for max8997 are parsed here from the
124  * device tree. Other sub-modules of max8997 such as pmic, rtc and others have
125  * to parse their own platform data elements from device tree.
126  *
127  * The max8997 platform data structure is instantiated here and the drivers for
128  * the sub-modules need not instantiate another instance while parsing their
129  * platform data.
130  */
131 static struct max8997_platform_data *max8997_i2c_parse_dt_pdata(
132 					struct device *dev)
133 {
134 	struct max8997_platform_data *pd;
135 
136 	pd = devm_kzalloc(dev, sizeof(*pd), GFP_KERNEL);
137 	if (!pd)
138 		return ERR_PTR(-ENOMEM);
139 
140 	pd->ono = irq_of_parse_and_map(dev->of_node, 1);
141 
142 	return pd;
143 }
144 
145 static inline unsigned long max8997_i2c_get_driver_data(struct i2c_client *i2c,
146 						const struct i2c_device_id *id)
147 {
148 	if (IS_ENABLED(CONFIG_OF) && i2c->dev.of_node) {
149 		const struct of_device_id *match;
150 		match = of_match_node(max8997_pmic_dt_match, i2c->dev.of_node);
151 		return (unsigned long)match->data;
152 	}
153 	return id->driver_data;
154 }
155 
156 static int max8997_i2c_probe(struct i2c_client *i2c,
157 			    const struct i2c_device_id *id)
158 {
159 	struct max8997_dev *max8997;
160 	struct max8997_platform_data *pdata = dev_get_platdata(&i2c->dev);
161 	int ret = 0;
162 
163 	max8997 = devm_kzalloc(&i2c->dev, sizeof(struct max8997_dev),
164 				GFP_KERNEL);
165 	if (max8997 == NULL)
166 		return -ENOMEM;
167 
168 	i2c_set_clientdata(i2c, max8997);
169 	max8997->dev = &i2c->dev;
170 	max8997->i2c = i2c;
171 	max8997->type = max8997_i2c_get_driver_data(i2c, id);
172 	max8997->irq = i2c->irq;
173 
174 	if (IS_ENABLED(CONFIG_OF) && max8997->dev->of_node) {
175 		pdata = max8997_i2c_parse_dt_pdata(max8997->dev);
176 		if (IS_ERR(pdata))
177 			return PTR_ERR(pdata);
178 	}
179 
180 	if (!pdata)
181 		return ret;
182 
183 	max8997->pdata = pdata;
184 	max8997->ono = pdata->ono;
185 
186 	mutex_init(&max8997->iolock);
187 
188 	max8997->rtc = i2c_new_dummy_device(i2c->adapter, I2C_ADDR_RTC);
189 	if (IS_ERR(max8997->rtc)) {
190 		dev_err(max8997->dev, "Failed to allocate I2C device for RTC\n");
191 		return PTR_ERR(max8997->rtc);
192 	}
193 	i2c_set_clientdata(max8997->rtc, max8997);
194 
195 	max8997->haptic = i2c_new_dummy_device(i2c->adapter, I2C_ADDR_HAPTIC);
196 	if (IS_ERR(max8997->haptic)) {
197 		dev_err(max8997->dev, "Failed to allocate I2C device for Haptic\n");
198 		ret = PTR_ERR(max8997->haptic);
199 		goto err_i2c_haptic;
200 	}
201 	i2c_set_clientdata(max8997->haptic, max8997);
202 
203 	max8997->muic = i2c_new_dummy_device(i2c->adapter, I2C_ADDR_MUIC);
204 	if (IS_ERR(max8997->muic)) {
205 		dev_err(max8997->dev, "Failed to allocate I2C device for MUIC\n");
206 		ret = PTR_ERR(max8997->muic);
207 		goto err_i2c_muic;
208 	}
209 	i2c_set_clientdata(max8997->muic, max8997);
210 
211 	pm_runtime_set_active(max8997->dev);
212 
213 	max8997_irq_init(max8997);
214 
215 	ret = mfd_add_devices(max8997->dev, -1, max8997_devs,
216 			ARRAY_SIZE(max8997_devs),
217 			NULL, 0, NULL);
218 	if (ret < 0) {
219 		dev_err(max8997->dev, "failed to add MFD devices %d\n", ret);
220 		goto err_mfd;
221 	}
222 
223 	/*
224 	 * TODO: enable others (flash, muic, rtc, battery, ...) and
225 	 * check the return value
226 	 */
227 
228 	/* MAX8997 has a power button input. */
229 	device_init_wakeup(max8997->dev, true);
230 
231 	return ret;
232 
233 err_mfd:
234 	mfd_remove_devices(max8997->dev);
235 	i2c_unregister_device(max8997->muic);
236 err_i2c_muic:
237 	i2c_unregister_device(max8997->haptic);
238 err_i2c_haptic:
239 	i2c_unregister_device(max8997->rtc);
240 	return ret;
241 }
242 
243 static const struct i2c_device_id max8997_i2c_id[] = {
244 	{ "max8997", TYPE_MAX8997 },
245 	{ "max8966", TYPE_MAX8966 },
246 	{ }
247 };
248 
249 static u8 max8997_dumpaddr_pmic[] = {
250 	MAX8997_REG_INT1MSK,
251 	MAX8997_REG_INT2MSK,
252 	MAX8997_REG_INT3MSK,
253 	MAX8997_REG_INT4MSK,
254 	MAX8997_REG_MAINCON1,
255 	MAX8997_REG_MAINCON2,
256 	MAX8997_REG_BUCKRAMP,
257 	MAX8997_REG_BUCK1CTRL,
258 	MAX8997_REG_BUCK1DVS1,
259 	MAX8997_REG_BUCK1DVS2,
260 	MAX8997_REG_BUCK1DVS3,
261 	MAX8997_REG_BUCK1DVS4,
262 	MAX8997_REG_BUCK1DVS5,
263 	MAX8997_REG_BUCK1DVS6,
264 	MAX8997_REG_BUCK1DVS7,
265 	MAX8997_REG_BUCK1DVS8,
266 	MAX8997_REG_BUCK2CTRL,
267 	MAX8997_REG_BUCK2DVS1,
268 	MAX8997_REG_BUCK2DVS2,
269 	MAX8997_REG_BUCK2DVS3,
270 	MAX8997_REG_BUCK2DVS4,
271 	MAX8997_REG_BUCK2DVS5,
272 	MAX8997_REG_BUCK2DVS6,
273 	MAX8997_REG_BUCK2DVS7,
274 	MAX8997_REG_BUCK2DVS8,
275 	MAX8997_REG_BUCK3CTRL,
276 	MAX8997_REG_BUCK3DVS,
277 	MAX8997_REG_BUCK4CTRL,
278 	MAX8997_REG_BUCK4DVS,
279 	MAX8997_REG_BUCK5CTRL,
280 	MAX8997_REG_BUCK5DVS1,
281 	MAX8997_REG_BUCK5DVS2,
282 	MAX8997_REG_BUCK5DVS3,
283 	MAX8997_REG_BUCK5DVS4,
284 	MAX8997_REG_BUCK5DVS5,
285 	MAX8997_REG_BUCK5DVS6,
286 	MAX8997_REG_BUCK5DVS7,
287 	MAX8997_REG_BUCK5DVS8,
288 	MAX8997_REG_BUCK6CTRL,
289 	MAX8997_REG_BUCK6BPSKIPCTRL,
290 	MAX8997_REG_BUCK7CTRL,
291 	MAX8997_REG_BUCK7DVS,
292 	MAX8997_REG_LDO1CTRL,
293 	MAX8997_REG_LDO2CTRL,
294 	MAX8997_REG_LDO3CTRL,
295 	MAX8997_REG_LDO4CTRL,
296 	MAX8997_REG_LDO5CTRL,
297 	MAX8997_REG_LDO6CTRL,
298 	MAX8997_REG_LDO7CTRL,
299 	MAX8997_REG_LDO8CTRL,
300 	MAX8997_REG_LDO9CTRL,
301 	MAX8997_REG_LDO10CTRL,
302 	MAX8997_REG_LDO11CTRL,
303 	MAX8997_REG_LDO12CTRL,
304 	MAX8997_REG_LDO13CTRL,
305 	MAX8997_REG_LDO14CTRL,
306 	MAX8997_REG_LDO15CTRL,
307 	MAX8997_REG_LDO16CTRL,
308 	MAX8997_REG_LDO17CTRL,
309 	MAX8997_REG_LDO18CTRL,
310 	MAX8997_REG_LDO21CTRL,
311 	MAX8997_REG_MBCCTRL1,
312 	MAX8997_REG_MBCCTRL2,
313 	MAX8997_REG_MBCCTRL3,
314 	MAX8997_REG_MBCCTRL4,
315 	MAX8997_REG_MBCCTRL5,
316 	MAX8997_REG_MBCCTRL6,
317 	MAX8997_REG_OTPCGHCVS,
318 	MAX8997_REG_SAFEOUTCTRL,
319 	MAX8997_REG_LBCNFG1,
320 	MAX8997_REG_LBCNFG2,
321 	MAX8997_REG_BBCCTRL,
322 
323 	MAX8997_REG_FLASH1_CUR,
324 	MAX8997_REG_FLASH2_CUR,
325 	MAX8997_REG_MOVIE_CUR,
326 	MAX8997_REG_GSMB_CUR,
327 	MAX8997_REG_BOOST_CNTL,
328 	MAX8997_REG_LEN_CNTL,
329 	MAX8997_REG_FLASH_CNTL,
330 	MAX8997_REG_WDT_CNTL,
331 	MAX8997_REG_MAXFLASH1,
332 	MAX8997_REG_MAXFLASH2,
333 	MAX8997_REG_FLASHSTATUSMASK,
334 
335 	MAX8997_REG_GPIOCNTL1,
336 	MAX8997_REG_GPIOCNTL2,
337 	MAX8997_REG_GPIOCNTL3,
338 	MAX8997_REG_GPIOCNTL4,
339 	MAX8997_REG_GPIOCNTL5,
340 	MAX8997_REG_GPIOCNTL6,
341 	MAX8997_REG_GPIOCNTL7,
342 	MAX8997_REG_GPIOCNTL8,
343 	MAX8997_REG_GPIOCNTL9,
344 	MAX8997_REG_GPIOCNTL10,
345 	MAX8997_REG_GPIOCNTL11,
346 	MAX8997_REG_GPIOCNTL12,
347 
348 	MAX8997_REG_LDO1CONFIG,
349 	MAX8997_REG_LDO2CONFIG,
350 	MAX8997_REG_LDO3CONFIG,
351 	MAX8997_REG_LDO4CONFIG,
352 	MAX8997_REG_LDO5CONFIG,
353 	MAX8997_REG_LDO6CONFIG,
354 	MAX8997_REG_LDO7CONFIG,
355 	MAX8997_REG_LDO8CONFIG,
356 	MAX8997_REG_LDO9CONFIG,
357 	MAX8997_REG_LDO10CONFIG,
358 	MAX8997_REG_LDO11CONFIG,
359 	MAX8997_REG_LDO12CONFIG,
360 	MAX8997_REG_LDO13CONFIG,
361 	MAX8997_REG_LDO14CONFIG,
362 	MAX8997_REG_LDO15CONFIG,
363 	MAX8997_REG_LDO16CONFIG,
364 	MAX8997_REG_LDO17CONFIG,
365 	MAX8997_REG_LDO18CONFIG,
366 	MAX8997_REG_LDO21CONFIG,
367 
368 	MAX8997_REG_DVSOKTIMER1,
369 	MAX8997_REG_DVSOKTIMER2,
370 	MAX8997_REG_DVSOKTIMER4,
371 	MAX8997_REG_DVSOKTIMER5,
372 };
373 
374 static u8 max8997_dumpaddr_muic[] = {
375 	MAX8997_MUIC_REG_INTMASK1,
376 	MAX8997_MUIC_REG_INTMASK2,
377 	MAX8997_MUIC_REG_INTMASK3,
378 	MAX8997_MUIC_REG_CDETCTRL,
379 	MAX8997_MUIC_REG_CONTROL1,
380 	MAX8997_MUIC_REG_CONTROL2,
381 	MAX8997_MUIC_REG_CONTROL3,
382 };
383 
384 static u8 max8997_dumpaddr_haptic[] = {
385 	MAX8997_HAPTIC_REG_CONF1,
386 	MAX8997_HAPTIC_REG_CONF2,
387 	MAX8997_HAPTIC_REG_DRVCONF,
388 	MAX8997_HAPTIC_REG_CYCLECONF1,
389 	MAX8997_HAPTIC_REG_CYCLECONF2,
390 	MAX8997_HAPTIC_REG_SIGCONF1,
391 	MAX8997_HAPTIC_REG_SIGCONF2,
392 	MAX8997_HAPTIC_REG_SIGCONF3,
393 	MAX8997_HAPTIC_REG_SIGCONF4,
394 	MAX8997_HAPTIC_REG_SIGDC1,
395 	MAX8997_HAPTIC_REG_SIGDC2,
396 	MAX8997_HAPTIC_REG_SIGPWMDC1,
397 	MAX8997_HAPTIC_REG_SIGPWMDC2,
398 	MAX8997_HAPTIC_REG_SIGPWMDC3,
399 	MAX8997_HAPTIC_REG_SIGPWMDC4,
400 };
401 
402 static int max8997_freeze(struct device *dev)
403 {
404 	struct i2c_client *i2c = to_i2c_client(dev);
405 	struct max8997_dev *max8997 = i2c_get_clientdata(i2c);
406 	int i;
407 
408 	for (i = 0; i < ARRAY_SIZE(max8997_dumpaddr_pmic); i++)
409 		max8997_read_reg(i2c, max8997_dumpaddr_pmic[i],
410 				&max8997->reg_dump[i]);
411 
412 	for (i = 0; i < ARRAY_SIZE(max8997_dumpaddr_muic); i++)
413 		max8997_read_reg(i2c, max8997_dumpaddr_muic[i],
414 				&max8997->reg_dump[i + MAX8997_REG_PMIC_END]);
415 
416 	for (i = 0; i < ARRAY_SIZE(max8997_dumpaddr_haptic); i++)
417 		max8997_read_reg(i2c, max8997_dumpaddr_haptic[i],
418 				&max8997->reg_dump[i + MAX8997_REG_PMIC_END +
419 				MAX8997_MUIC_REG_END]);
420 
421 	return 0;
422 }
423 
424 static int max8997_restore(struct device *dev)
425 {
426 	struct i2c_client *i2c = to_i2c_client(dev);
427 	struct max8997_dev *max8997 = i2c_get_clientdata(i2c);
428 	int i;
429 
430 	for (i = 0; i < ARRAY_SIZE(max8997_dumpaddr_pmic); i++)
431 		max8997_write_reg(i2c, max8997_dumpaddr_pmic[i],
432 				max8997->reg_dump[i]);
433 
434 	for (i = 0; i < ARRAY_SIZE(max8997_dumpaddr_muic); i++)
435 		max8997_write_reg(i2c, max8997_dumpaddr_muic[i],
436 				max8997->reg_dump[i + MAX8997_REG_PMIC_END]);
437 
438 	for (i = 0; i < ARRAY_SIZE(max8997_dumpaddr_haptic); i++)
439 		max8997_write_reg(i2c, max8997_dumpaddr_haptic[i],
440 				max8997->reg_dump[i + MAX8997_REG_PMIC_END +
441 				MAX8997_MUIC_REG_END]);
442 
443 	return 0;
444 }
445 
446 static int max8997_suspend(struct device *dev)
447 {
448 	struct i2c_client *i2c = to_i2c_client(dev);
449 	struct max8997_dev *max8997 = i2c_get_clientdata(i2c);
450 
451 	disable_irq(max8997->irq);
452 	if (device_may_wakeup(dev))
453 		irq_set_irq_wake(max8997->irq, 1);
454 	return 0;
455 }
456 
457 static int max8997_resume(struct device *dev)
458 {
459 	struct i2c_client *i2c = to_i2c_client(dev);
460 	struct max8997_dev *max8997 = i2c_get_clientdata(i2c);
461 
462 	if (device_may_wakeup(dev))
463 		irq_set_irq_wake(max8997->irq, 0);
464 	enable_irq(max8997->irq);
465 	return max8997_irq_resume(max8997);
466 }
467 
468 static const struct dev_pm_ops max8997_pm = {
469 	.suspend = max8997_suspend,
470 	.resume = max8997_resume,
471 	.freeze = max8997_freeze,
472 	.restore = max8997_restore,
473 };
474 
475 static struct i2c_driver max8997_i2c_driver = {
476 	.driver = {
477 		   .name = "max8997",
478 		   .pm = &max8997_pm,
479 		   .suppress_bind_attrs = true,
480 		   .of_match_table = of_match_ptr(max8997_pmic_dt_match),
481 	},
482 	.probe = max8997_i2c_probe,
483 	.id_table = max8997_i2c_id,
484 };
485 
486 static int __init max8997_i2c_init(void)
487 {
488 	return i2c_add_driver(&max8997_i2c_driver);
489 }
490 /* init early so consumer devices can complete system boot */
491 subsys_initcall(max8997_i2c_init);
492