1 // SPDX-License-Identifier: GPL-2.0+
3 // max8997.c - mfd core driver for the Maxim 8966 and 8997
5 // Copyright (C) 2011 Samsung Electronics
6 // MyungJoo Ham <myungjoo.ham@samsung.com>
8 // This driver is based on max8998.c
10 #include <linux/err.h>
11 #include <linux/slab.h>
12 #include <linux/i2c.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>
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)
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 },
40 static const struct of_device_id max8997_pmic_dt_match[] = {
41 { .compatible = "maxim,max8997-pmic", .data = (void *)TYPE_MAX8997 },
46 int max8997_read_reg(struct i2c_client *i2c, u8 reg, u8 *dest)
48 struct max8997_dev *max8997 = i2c_get_clientdata(i2c);
51 mutex_lock(&max8997->iolock);
52 ret = i2c_smbus_read_byte_data(i2c, reg);
53 mutex_unlock(&max8997->iolock);
61 EXPORT_SYMBOL_GPL(max8997_read_reg);
63 int max8997_bulk_read(struct i2c_client *i2c, u8 reg, int count, u8 *buf)
65 struct max8997_dev *max8997 = i2c_get_clientdata(i2c);
68 mutex_lock(&max8997->iolock);
69 ret = i2c_smbus_read_i2c_block_data(i2c, reg, count, buf);
70 mutex_unlock(&max8997->iolock);
76 EXPORT_SYMBOL_GPL(max8997_bulk_read);
78 int max8997_write_reg(struct i2c_client *i2c, u8 reg, u8 value)
80 struct max8997_dev *max8997 = i2c_get_clientdata(i2c);
83 mutex_lock(&max8997->iolock);
84 ret = i2c_smbus_write_byte_data(i2c, reg, value);
85 mutex_unlock(&max8997->iolock);
88 EXPORT_SYMBOL_GPL(max8997_write_reg);
90 int max8997_bulk_write(struct i2c_client *i2c, u8 reg, int count, u8 *buf)
92 struct max8997_dev *max8997 = i2c_get_clientdata(i2c);
95 mutex_lock(&max8997->iolock);
96 ret = i2c_smbus_write_i2c_block_data(i2c, reg, count, buf);
97 mutex_unlock(&max8997->iolock);
103 EXPORT_SYMBOL_GPL(max8997_bulk_write);
105 int max8997_update_reg(struct i2c_client *i2c, u8 reg, u8 val, u8 mask)
107 struct max8997_dev *max8997 = i2c_get_clientdata(i2c);
110 mutex_lock(&max8997->iolock);
111 ret = i2c_smbus_read_byte_data(i2c, reg);
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);
117 mutex_unlock(&max8997->iolock);
120 EXPORT_SYMBOL_GPL(max8997_update_reg);
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.
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
131 static struct max8997_platform_data *max8997_i2c_parse_dt_pdata(
134 struct max8997_platform_data *pd;
136 pd = devm_kzalloc(dev, sizeof(*pd), GFP_KERNEL);
138 return ERR_PTR(-ENOMEM);
140 pd->ono = irq_of_parse_and_map(dev->of_node, 1);
145 static inline unsigned long max8997_i2c_get_driver_data(struct i2c_client *i2c,
146 const struct i2c_device_id *id)
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;
153 return id->driver_data;
156 static int max8997_i2c_probe(struct i2c_client *i2c,
157 const struct i2c_device_id *id)
159 struct max8997_dev *max8997;
160 struct max8997_platform_data *pdata = dev_get_platdata(&i2c->dev);
163 max8997 = devm_kzalloc(&i2c->dev, sizeof(struct max8997_dev),
168 i2c_set_clientdata(i2c, max8997);
169 max8997->dev = &i2c->dev;
171 max8997->type = max8997_i2c_get_driver_data(i2c, id);
172 max8997->irq = i2c->irq;
174 if (IS_ENABLED(CONFIG_OF) && max8997->dev->of_node) {
175 pdata = max8997_i2c_parse_dt_pdata(max8997->dev);
177 return PTR_ERR(pdata);
183 max8997->pdata = pdata;
184 max8997->ono = pdata->ono;
186 mutex_init(&max8997->iolock);
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);
193 i2c_set_clientdata(max8997->rtc, max8997);
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);
201 i2c_set_clientdata(max8997->haptic, max8997);
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);
209 i2c_set_clientdata(max8997->muic, max8997);
211 pm_runtime_set_active(max8997->dev);
213 max8997_irq_init(max8997);
215 ret = mfd_add_devices(max8997->dev, -1, max8997_devs,
216 ARRAY_SIZE(max8997_devs),
219 dev_err(max8997->dev, "failed to add MFD devices %d\n", ret);
224 * TODO: enable others (flash, muic, rtc, battery, ...) and
225 * check the return value
228 /* MAX8997 has a power button input. */
229 device_init_wakeup(max8997->dev, true);
234 mfd_remove_devices(max8997->dev);
235 i2c_unregister_device(max8997->muic);
237 i2c_unregister_device(max8997->haptic);
239 i2c_unregister_device(max8997->rtc);
243 static const struct i2c_device_id max8997_i2c_id[] = {
244 { "max8997", TYPE_MAX8997 },
245 { "max8966", TYPE_MAX8966 },
249 static u8 max8997_dumpaddr_pmic[] = {
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,
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,
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,
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,
368 MAX8997_REG_DVSOKTIMER1,
369 MAX8997_REG_DVSOKTIMER2,
370 MAX8997_REG_DVSOKTIMER4,
371 MAX8997_REG_DVSOKTIMER5,
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,
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,
402 static int max8997_freeze(struct device *dev)
404 struct i2c_client *i2c = to_i2c_client(dev);
405 struct max8997_dev *max8997 = i2c_get_clientdata(i2c);
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]);
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]);
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]);
424 static int max8997_restore(struct device *dev)
426 struct i2c_client *i2c = to_i2c_client(dev);
427 struct max8997_dev *max8997 = i2c_get_clientdata(i2c);
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]);
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]);
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]);
446 static int max8997_suspend(struct device *dev)
448 struct i2c_client *i2c = to_i2c_client(dev);
449 struct max8997_dev *max8997 = i2c_get_clientdata(i2c);
451 disable_irq(max8997->irq);
452 if (device_may_wakeup(dev))
453 irq_set_irq_wake(max8997->irq, 1);
457 static int max8997_resume(struct device *dev)
459 struct i2c_client *i2c = to_i2c_client(dev);
460 struct max8997_dev *max8997 = i2c_get_clientdata(i2c);
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);
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,
475 static struct i2c_driver max8997_i2c_driver = {
479 .suppress_bind_attrs = true,
480 .of_match_table = of_match_ptr(max8997_pmic_dt_match),
482 .probe = max8997_i2c_probe,
483 .id_table = max8997_i2c_id,
486 static int __init max8997_i2c_init(void)
488 return i2c_add_driver(&max8997_i2c_driver);
490 /* init early so consumer devices can complete system boot */
491 subsys_initcall(max8997_i2c_init);