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 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