1 // SPDX-License-Identifier: GPL-2.0-only
3 * Copyright (C) 2007-2010 ST-Ericsson
4 * Low-level core for exclusive access to the AB3100 IC on the I2C bus
5 * and some basic chip-configuration.
6 * Author: Linus Walleij <linus.walleij@stericsson.com>
10 #include <linux/mutex.h>
11 #include <linux/list.h>
12 #include <linux/notifier.h>
13 #include <linux/slab.h>
14 #include <linux/err.h>
15 #include <linux/init.h>
16 #include <linux/platform_device.h>
17 #include <linux/device.h>
18 #include <linux/interrupt.h>
19 #include <linux/random.h>
20 #include <linux/debugfs.h>
21 #include <linux/seq_file.h>
22 #include <linux/uaccess.h>
23 #include <linux/mfd/core.h>
24 #include <linux/mfd/ab3100.h>
25 #include <linux/mfd/abx500.h>
27 /* These are the only registers inside AB3100 used in this main file */
29 /* Interrupt event registers */
30 #define AB3100_EVENTA1 0x21
31 #define AB3100_EVENTA2 0x22
32 #define AB3100_EVENTA3 0x23
34 /* AB3100 DAC converter registers */
35 #define AB3100_DIS 0x00
36 #define AB3100_D0C 0x01
37 #define AB3100_D1C 0x02
38 #define AB3100_D2C 0x03
39 #define AB3100_D3C 0x04
41 /* Chip ID register */
42 #define AB3100_CID 0x20
44 /* AB3100 interrupt registers */
45 #define AB3100_IMRA1 0x24
46 #define AB3100_IMRA2 0x25
47 #define AB3100_IMRA3 0x26
48 #define AB3100_IMRB1 0x2B
49 #define AB3100_IMRB2 0x2C
50 #define AB3100_IMRB3 0x2D
52 /* System Power Monitoring and control registers */
53 #define AB3100_MCA 0x2E
54 #define AB3100_MCB 0x2F
57 #define AB3100_SUP 0x50
62 * The AB3100 is usually assigned address 0x48 (7-bit)
63 * The chip is defined in the platform i2c_board_data section.
65 static int ab3100_get_chip_id(struct device *dev)
67 struct ab3100 *ab3100 = dev_get_drvdata(dev->parent);
69 return (int)ab3100->chip_id;
72 static int ab3100_set_register_interruptible(struct ab3100 *ab3100,
75 u8 regandval[2] = {reg, regval};
78 err = mutex_lock_interruptible(&ab3100->access_mutex);
83 * A two-byte write message with the first byte containing the register
84 * number and the second byte containing the value to be written
85 * effectively sets a register in the AB3100.
87 err = i2c_master_send(ab3100->i2c_client, regandval, 2);
90 "write error (write register): %d\n",
92 } else if (err != 2) {
94 "write error (write register)\n"
95 " %d bytes transferred (expected 2)\n",
102 mutex_unlock(&ab3100->access_mutex);
106 static int set_register_interruptible(struct device *dev,
107 u8 bank, u8 reg, u8 value)
109 struct ab3100 *ab3100 = dev_get_drvdata(dev->parent);
111 return ab3100_set_register_interruptible(ab3100, reg, value);
115 * The test registers exist at an I2C bus address up one
116 * from the ordinary base. They are not supposed to be used
117 * in production code, but sometimes you have to do that
118 * anyway. It's currently only used from this file so declare
119 * it static and do not export.
121 static int ab3100_set_test_register_interruptible(struct ab3100 *ab3100,
124 u8 regandval[2] = {reg, regval};
127 err = mutex_lock_interruptible(&ab3100->access_mutex);
131 err = i2c_master_send(ab3100->testreg_client, regandval, 2);
134 "write error (write test register): %d\n",
136 } else if (err != 2) {
138 "write error (write test register)\n"
139 " %d bytes transferred (expected 2)\n",
146 mutex_unlock(&ab3100->access_mutex);
151 static int ab3100_get_register_interruptible(struct ab3100 *ab3100,
156 err = mutex_lock_interruptible(&ab3100->access_mutex);
161 * AB3100 require an I2C "stop" command between each message, else
162 * it will not work. The only way of achieveing this with the
163 * message transport layer is to send the read and write messages
166 err = i2c_master_send(ab3100->i2c_client, ®, 1);
169 "write error (send register address): %d\n",
171 goto get_reg_out_unlock;
172 } else if (err != 1) {
174 "write error (send register address)\n"
175 " %d bytes transferred (expected 1)\n",
178 goto get_reg_out_unlock;
184 err = i2c_master_recv(ab3100->i2c_client, regval, 1);
187 "write error (read register): %d\n",
189 goto get_reg_out_unlock;
190 } else if (err != 1) {
192 "write error (read register)\n"
193 " %d bytes transferred (expected 1)\n",
196 goto get_reg_out_unlock;
203 mutex_unlock(&ab3100->access_mutex);
207 static int get_register_interruptible(struct device *dev, u8 bank, u8 reg,
210 struct ab3100 *ab3100 = dev_get_drvdata(dev->parent);
212 return ab3100_get_register_interruptible(ab3100, reg, value);
215 static int ab3100_get_register_page_interruptible(struct ab3100 *ab3100,
216 u8 first_reg, u8 *regvals, u8 numregs)
220 if (ab3100->chip_id == 0xa0 ||
221 ab3100->chip_id == 0xa1)
222 /* These don't support paged reads */
225 err = mutex_lock_interruptible(&ab3100->access_mutex);
230 * Paged read also require an I2C "stop" command.
232 err = i2c_master_send(ab3100->i2c_client, &first_reg, 1);
235 "write error (send first register address): %d\n",
237 goto get_reg_page_out_unlock;
238 } else if (err != 1) {
240 "write error (send first register address)\n"
241 " %d bytes transferred (expected 1)\n",
244 goto get_reg_page_out_unlock;
247 err = i2c_master_recv(ab3100->i2c_client, regvals, numregs);
250 "write error (read register page): %d\n",
252 goto get_reg_page_out_unlock;
253 } else if (err != numregs) {
255 "write error (read register page)\n"
256 " %d bytes transferred (expected %d)\n",
259 goto get_reg_page_out_unlock;
265 get_reg_page_out_unlock:
266 mutex_unlock(&ab3100->access_mutex);
270 static int get_register_page_interruptible(struct device *dev, u8 bank,
271 u8 first_reg, u8 *regvals, u8 numregs)
273 struct ab3100 *ab3100 = dev_get_drvdata(dev->parent);
275 return ab3100_get_register_page_interruptible(ab3100,
276 first_reg, regvals, numregs);
279 static int ab3100_mask_and_set_register_interruptible(struct ab3100 *ab3100,
280 u8 reg, u8 andmask, u8 ormask)
282 u8 regandval[2] = {reg, 0};
285 err = mutex_lock_interruptible(&ab3100->access_mutex);
289 /* First read out the target register */
290 err = i2c_master_send(ab3100->i2c_client, ®, 1);
293 "write error (maskset send address): %d\n",
295 goto get_maskset_unlock;
296 } else if (err != 1) {
298 "write error (maskset send address)\n"
299 " %d bytes transferred (expected 1)\n",
302 goto get_maskset_unlock;
305 err = i2c_master_recv(ab3100->i2c_client, ®andval[1], 1);
308 "write error (maskset read register): %d\n",
310 goto get_maskset_unlock;
311 } else if (err != 1) {
313 "write error (maskset read register)\n"
314 " %d bytes transferred (expected 1)\n",
317 goto get_maskset_unlock;
320 /* Modify the register */
321 regandval[1] &= andmask;
322 regandval[1] |= ormask;
324 /* Write the register */
325 err = i2c_master_send(ab3100->i2c_client, regandval, 2);
328 "write error (write register): %d\n",
330 goto get_maskset_unlock;
331 } else if (err != 2) {
333 "write error (write register)\n"
334 " %d bytes transferred (expected 2)\n",
337 goto get_maskset_unlock;
344 mutex_unlock(&ab3100->access_mutex);
348 static int mask_and_set_register_interruptible(struct device *dev, u8 bank,
349 u8 reg, u8 bitmask, u8 bitvalues)
351 struct ab3100 *ab3100 = dev_get_drvdata(dev->parent);
353 return ab3100_mask_and_set_register_interruptible(ab3100,
354 reg, bitmask, (bitmask & bitvalues));
358 * Register a simple callback for handling any AB3100 events.
360 int ab3100_event_register(struct ab3100 *ab3100,
361 struct notifier_block *nb)
363 return blocking_notifier_chain_register(&ab3100->event_subscribers,
366 EXPORT_SYMBOL(ab3100_event_register);
369 * Remove a previously registered callback.
371 int ab3100_event_unregister(struct ab3100 *ab3100,
372 struct notifier_block *nb)
374 return blocking_notifier_chain_unregister(&ab3100->event_subscribers,
377 EXPORT_SYMBOL(ab3100_event_unregister);
380 static int ab3100_event_registers_startup_state_get(struct device *dev,
383 struct ab3100 *ab3100 = dev_get_drvdata(dev->parent);
385 if (!ab3100->startup_events_read)
386 return -EAGAIN; /* Try again later */
387 memcpy(event, ab3100->startup_events, 3);
392 static struct abx500_ops ab3100_ops = {
393 .get_chip_id = ab3100_get_chip_id,
394 .set_register = set_register_interruptible,
395 .get_register = get_register_interruptible,
396 .get_register_page = get_register_page_interruptible,
397 .set_register_page = NULL,
398 .mask_and_set_register = mask_and_set_register_interruptible,
399 .event_registers_startup_state_get =
400 ab3100_event_registers_startup_state_get,
401 .startup_irq_enabled = NULL,
405 * This is a threaded interrupt handler so we can make some
408 static irqreturn_t ab3100_irq_handler(int irq, void *data)
410 struct ab3100 *ab3100 = data;
415 err = ab3100_get_register_page_interruptible(ab3100, AB3100_EVENTA1,
420 fatevent = (event_regs[0] << 16) |
421 (event_regs[1] << 8) |
424 if (!ab3100->startup_events_read) {
425 ab3100->startup_events[0] = event_regs[0];
426 ab3100->startup_events[1] = event_regs[1];
427 ab3100->startup_events[2] = event_regs[2];
428 ab3100->startup_events_read = true;
431 * The notified parties will have to mask out the events
432 * they're interested in and react to them. They will be
433 * notified on all events, then they use the fatevent value
434 * to determine if they're interested.
436 blocking_notifier_call_chain(&ab3100->event_subscribers,
440 "IRQ Event: 0x%08x\n", fatevent);
446 "error reading event status\n");
450 #ifdef CONFIG_DEBUG_FS
452 * Some debugfs entries only exposed if we're using debug
454 static int ab3100_registers_print(struct seq_file *s, void *p)
456 struct ab3100 *ab3100 = s->private;
460 seq_puts(s, "AB3100 registers:\n");
462 for (reg = 0; reg < 0xff; reg++) {
463 ab3100_get_register_interruptible(ab3100, reg, &value);
464 seq_printf(s, "[0x%x]: 0x%x\n", reg, value);
469 static int ab3100_registers_open(struct inode *inode, struct file *file)
471 return single_open(file, ab3100_registers_print, inode->i_private);
474 static const struct file_operations ab3100_registers_fops = {
475 .open = ab3100_registers_open,
478 .release = single_release,
479 .owner = THIS_MODULE,
482 struct ab3100_get_set_reg_priv {
483 struct ab3100 *ab3100;
487 static ssize_t ab3100_get_set_reg(struct file *file,
488 const char __user *user_buf,
489 size_t count, loff_t *ppos)
491 struct ab3100_get_set_reg_priv *priv = file->private_data;
492 struct ab3100 *ab3100 = priv->ab3100;
500 /* Get userspace string and assure termination */
501 buf_size = min(count, (sizeof(buf)-1));
502 if (copy_from_user(buf, user_buf, buf_size))
507 * The idea is here to parse a string which is either
508 * "0xnn" for reading a register, or "0xaa 0xbb" for
509 * writing 0xbb to the register 0xaa. First move past
510 * whitespace and then begin to parse the register.
512 while ((i < buf_size) && (buf[i] == ' '))
517 * Advance pointer to end of string then terminate
518 * the register string. This is needed to satisfy
519 * the kstrtou8() function.
521 while ((i < buf_size) && (buf[i] != ' '))
525 err = kstrtou8(&buf[regp], 16, &user_reg);
529 /* Either we read or we write a register here */
534 ab3100_get_register_interruptible(ab3100, user_reg, ®value);
536 dev_info(ab3100->dev,
537 "debug read AB3100 reg[0x%02x]: 0x%02x\n",
545 * Writing, we need some value to write to
546 * the register so keep parsing the string
550 while ((i < buf_size) && (buf[i] == ' '))
553 while ((i < buf_size) && (buf[i] != ' '))
557 err = kstrtou8(&buf[valp], 16, &user_value);
561 ab3100_set_register_interruptible(ab3100, user_reg, user_value);
562 ab3100_get_register_interruptible(ab3100, user_reg, ®value);
564 dev_info(ab3100->dev,
565 "debug write reg[0x%02x]\n"
566 " with 0x%02x, after readback: 0x%02x\n",
567 user_reg, user_value, regvalue);
572 static const struct file_operations ab3100_get_set_reg_fops = {
574 .write = ab3100_get_set_reg,
575 .llseek = noop_llseek,
578 static struct ab3100_get_set_reg_priv ab3100_get_priv;
579 static struct ab3100_get_set_reg_priv ab3100_set_priv;
581 static void ab3100_setup_debugfs(struct ab3100 *ab3100)
583 struct dentry *ab3100_dir;
585 ab3100_dir = debugfs_create_dir("ab3100", NULL);
587 debugfs_create_file("registers", S_IRUGO, ab3100_dir, ab3100,
588 &ab3100_registers_fops);
590 ab3100_get_priv.ab3100 = ab3100;
591 ab3100_get_priv.mode = false;
592 debugfs_create_file("get_reg", S_IWUSR, ab3100_dir, &ab3100_get_priv,
593 &ab3100_get_set_reg_fops);
595 ab3100_set_priv.ab3100 = ab3100;
596 ab3100_set_priv.mode = true;
597 debugfs_create_file("set_reg", S_IWUSR, ab3100_dir, &ab3100_set_priv,
598 &ab3100_get_set_reg_fops);
601 static inline void ab3100_setup_debugfs(struct ab3100 *ab3100)
607 * Basic set-up, datastructure creation/destruction and I2C interface.
608 * This sets up a default config in the AB3100 chip so that it
609 * will work as expected.
612 struct ab3100_init_setting {
617 static const struct ab3100_init_setting ab3100_init_settings[] = {
625 .abreg = AB3100_IMRA1,
628 .abreg = AB3100_IMRA2,
631 .abreg = AB3100_IMRA3,
634 .abreg = AB3100_IMRB1,
637 .abreg = AB3100_IMRB2,
640 .abreg = AB3100_IMRB3,
663 static int ab3100_setup(struct ab3100 *ab3100)
668 for (i = 0; i < ARRAY_SIZE(ab3100_init_settings); i++) {
669 err = ab3100_set_register_interruptible(ab3100,
670 ab3100_init_settings[i].abreg,
671 ab3100_init_settings[i].setting);
677 * Special trick to make the AB3100 use the 32kHz clock (RTC)
678 * bit 3 in test register 0x02 is a special, undocumented test
679 * register bit that only exist in AB3100 P1E
681 if (ab3100->chip_id == 0xc4) {
682 dev_warn(ab3100->dev,
683 "AB3100 P1E variant detected forcing chip to 32KHz\n");
684 err = ab3100_set_test_register_interruptible(ab3100,
692 /* The subdevices of the AB3100 */
693 static struct mfd_cell ab3100_devs[] = {
695 .name = "ab3100-dac",
699 .name = "ab3100-leds",
703 .name = "ab3100-power",
707 .name = "ab3100-regulators",
708 .of_compatible = "stericsson,ab3100-regulators",
712 .name = "ab3100-sim",
716 .name = "ab3100-uart",
720 .name = "ab3100-rtc",
724 .name = "ab3100-charger",
728 .name = "ab3100-boost",
732 .name = "ab3100-adc",
736 .name = "ab3100-fuelgauge",
740 .name = "ab3100-vibrator",
744 .name = "ab3100-otp",
748 .name = "ab3100-codec",
753 struct ab_family_id {
758 static const struct ab_family_id ids[] = {
788 /* AB3000 variants, not supported */
812 static int ab3100_probe(struct i2c_client *client,
813 const struct i2c_device_id *id)
815 struct ab3100 *ab3100;
816 struct ab3100_platform_data *ab3100_plf_data =
817 dev_get_platdata(&client->dev);
821 ab3100 = devm_kzalloc(&client->dev, sizeof(struct ab3100), GFP_KERNEL);
825 /* Initialize data structure */
826 mutex_init(&ab3100->access_mutex);
827 BLOCKING_INIT_NOTIFIER_HEAD(&ab3100->event_subscribers);
829 ab3100->i2c_client = client;
830 ab3100->dev = &ab3100->i2c_client->dev;
832 i2c_set_clientdata(client, ab3100);
834 /* Read chip ID register */
835 err = ab3100_get_register_interruptible(ab3100, AB3100_CID,
838 dev_err(&client->dev,
839 "failed to communicate with AB3100 chip\n");
843 for (i = 0; ids[i].id != 0x0; i++) {
844 if (ids[i].id == ab3100->chip_id) {
848 dev_err(&client->dev, "AB3000 is not supported\n");
853 snprintf(&ab3100->chip_name[0],
854 sizeof(ab3100->chip_name) - 1, "AB3100 %s", ids[i].name);
856 if (ids[i].id == 0x0) {
857 dev_err(&client->dev, "unknown analog baseband chip id: 0x%x\n",
859 dev_err(&client->dev,
860 "accepting it anyway. Please update the driver.\n");
864 dev_info(&client->dev, "Detected chip: %s\n",
865 &ab3100->chip_name[0]);
867 /* Attach a second dummy i2c_client to the test register address */
868 ab3100->testreg_client = i2c_new_dummy_device(client->adapter,
870 if (IS_ERR(ab3100->testreg_client)) {
871 err = PTR_ERR(ab3100->testreg_client);
872 goto exit_no_testreg_client;
875 err = ab3100_setup(ab3100);
879 err = devm_request_threaded_irq(&client->dev,
880 client->irq, NULL, ab3100_irq_handler,
881 IRQF_ONESHOT, "ab3100-core", ab3100);
885 err = abx500_register_ops(&client->dev, &ab3100_ops);
889 /* Set up and register the platform devices. */
890 for (i = 0; i < ARRAY_SIZE(ab3100_devs); i++) {
891 ab3100_devs[i].platform_data = ab3100_plf_data;
892 ab3100_devs[i].pdata_size = sizeof(struct ab3100_platform_data);
895 err = mfd_add_devices(&client->dev, 0, ab3100_devs,
896 ARRAY_SIZE(ab3100_devs), NULL, 0, NULL);
898 ab3100_setup_debugfs(ab3100);
905 i2c_unregister_device(ab3100->testreg_client);
906 exit_no_testreg_client:
911 static const struct i2c_device_id ab3100_id[] = {
916 static struct i2c_driver ab3100_driver = {
919 .suppress_bind_attrs = true,
921 .id_table = ab3100_id,
922 .probe = ab3100_probe,
925 static int __init ab3100_i2c_init(void)
927 return i2c_add_driver(&ab3100_driver);
929 subsys_initcall(ab3100_i2c_init);