1 // SPDX-License-Identifier: GPL-2.0-only
3 * PCA953x 4/8/16/24/40 bit I/O ports
6 * Copyright (C) 2007 Marvell International Ltd.
8 * Derived from drivers/i2c/chips/pca9539.c
11 #include <linux/acpi.h>
12 #include <linux/bits.h>
13 #include <linux/gpio/driver.h>
14 #include <linux/gpio/consumer.h>
15 #include <linux/i2c.h>
16 #include <linux/init.h>
17 #include <linux/interrupt.h>
18 #include <linux/module.h>
19 #include <linux/of_platform.h>
20 #include <linux/platform_data/pca953x.h>
21 #include <linux/regmap.h>
22 #include <linux/regulator/consumer.h>
23 #include <linux/slab.h>
25 #include <asm/unaligned.h>
27 #define PCA953X_INPUT 0x00
28 #define PCA953X_OUTPUT 0x01
29 #define PCA953X_INVERT 0x02
30 #define PCA953X_DIRECTION 0x03
32 #define REG_ADDR_MASK GENMASK(5, 0)
33 #define REG_ADDR_EXT BIT(6)
34 #define REG_ADDR_AI BIT(7)
36 #define PCA957X_IN 0x00
37 #define PCA957X_INVRT 0x01
38 #define PCA957X_BKEN 0x02
39 #define PCA957X_PUPD 0x03
40 #define PCA957X_CFG 0x04
41 #define PCA957X_OUT 0x05
42 #define PCA957X_MSK 0x06
43 #define PCA957X_INTS 0x07
45 #define PCAL953X_OUT_STRENGTH 0x20
46 #define PCAL953X_IN_LATCH 0x22
47 #define PCAL953X_PULL_EN 0x23
48 #define PCAL953X_PULL_SEL 0x24
49 #define PCAL953X_INT_MASK 0x25
50 #define PCAL953X_INT_STAT 0x26
51 #define PCAL953X_OUT_CONF 0x27
53 #define PCAL6524_INT_EDGE 0x28
54 #define PCAL6524_INT_CLR 0x2a
55 #define PCAL6524_IN_STATUS 0x2b
56 #define PCAL6524_OUT_INDCONF 0x2c
57 #define PCAL6524_DEBOUNCE 0x2d
59 #define PCA_GPIO_MASK GENMASK(7, 0)
61 #define PCAL_GPIO_MASK GENMASK(4, 0)
62 #define PCAL_PINCTRL_MASK GENMASK(6, 5)
64 #define PCA_INT BIT(8)
65 #define PCA_PCAL BIT(9)
66 #define PCA_LATCH_INT (PCA_PCAL | PCA_INT)
67 #define PCA953X_TYPE BIT(12)
68 #define PCA957X_TYPE BIT(13)
69 #define PCA_TYPE_MASK GENMASK(15, 12)
71 #define PCA_CHIP_TYPE(x) ((x) & PCA_TYPE_MASK)
73 static const struct i2c_device_id pca953x_id[] = {
74 { "pca6416", 16 | PCA953X_TYPE | PCA_INT, },
75 { "pca9505", 40 | PCA953X_TYPE | PCA_INT, },
76 { "pca9534", 8 | PCA953X_TYPE | PCA_INT, },
77 { "pca9535", 16 | PCA953X_TYPE | PCA_INT, },
78 { "pca9536", 4 | PCA953X_TYPE, },
79 { "pca9537", 4 | PCA953X_TYPE | PCA_INT, },
80 { "pca9538", 8 | PCA953X_TYPE | PCA_INT, },
81 { "pca9539", 16 | PCA953X_TYPE | PCA_INT, },
82 { "pca9554", 8 | PCA953X_TYPE | PCA_INT, },
83 { "pca9555", 16 | PCA953X_TYPE | PCA_INT, },
84 { "pca9556", 8 | PCA953X_TYPE, },
85 { "pca9557", 8 | PCA953X_TYPE, },
86 { "pca9574", 8 | PCA957X_TYPE | PCA_INT, },
87 { "pca9575", 16 | PCA957X_TYPE | PCA_INT, },
88 { "pca9698", 40 | PCA953X_TYPE, },
90 { "pcal6416", 16 | PCA953X_TYPE | PCA_LATCH_INT, },
91 { "pcal6524", 24 | PCA953X_TYPE | PCA_LATCH_INT, },
92 { "pcal9555a", 16 | PCA953X_TYPE | PCA_LATCH_INT, },
94 { "max7310", 8 | PCA953X_TYPE, },
95 { "max7312", 16 | PCA953X_TYPE | PCA_INT, },
96 { "max7313", 16 | PCA953X_TYPE | PCA_INT, },
97 { "max7315", 8 | PCA953X_TYPE | PCA_INT, },
98 { "max7318", 16 | PCA953X_TYPE | PCA_INT, },
99 { "pca6107", 8 | PCA953X_TYPE | PCA_INT, },
100 { "tca6408", 8 | PCA953X_TYPE | PCA_INT, },
101 { "tca6416", 16 | PCA953X_TYPE | PCA_INT, },
102 { "tca6424", 24 | PCA953X_TYPE | PCA_INT, },
103 { "tca9539", 16 | PCA953X_TYPE | PCA_INT, },
104 { "tca9554", 8 | PCA953X_TYPE | PCA_INT, },
105 { "xra1202", 8 | PCA953X_TYPE },
108 MODULE_DEVICE_TABLE(i2c, pca953x_id);
110 static const struct acpi_device_id pca953x_acpi_ids[] = {
111 { "INT3491", 16 | PCA953X_TYPE | PCA_LATCH_INT, },
114 MODULE_DEVICE_TABLE(acpi, pca953x_acpi_ids);
119 #define NBANK(chip) DIV_ROUND_UP(chip->gpio_chip.ngpio, BANK_SZ)
121 struct pca953x_reg_config {
128 static const struct pca953x_reg_config pca953x_regs = {
129 .direction = PCA953X_DIRECTION,
130 .output = PCA953X_OUTPUT,
131 .input = PCA953X_INPUT,
132 .invert = PCA953X_INVERT,
135 static const struct pca953x_reg_config pca957x_regs = {
136 .direction = PCA957X_CFG,
137 .output = PCA957X_OUT,
139 .invert = PCA957X_INVRT,
142 struct pca953x_chip {
144 struct mutex i2c_lock;
145 struct regmap *regmap;
147 #ifdef CONFIG_GPIO_PCA953X_IRQ
148 struct mutex irq_lock;
149 u8 irq_mask[MAX_BANK];
150 u8 irq_stat[MAX_BANK];
151 u8 irq_trig_raise[MAX_BANK];
152 u8 irq_trig_fall[MAX_BANK];
153 struct irq_chip irq_chip;
155 atomic_t wakeup_path;
157 struct i2c_client *client;
158 struct gpio_chip gpio_chip;
159 const char *const *names;
160 unsigned long driver_data;
161 struct regulator *regulator;
163 const struct pca953x_reg_config *regs;
166 static int pca953x_bank_shift(struct pca953x_chip *chip)
168 return fls((chip->gpio_chip.ngpio - 1) / BANK_SZ);
171 #define PCA953x_BANK_INPUT BIT(0)
172 #define PCA953x_BANK_OUTPUT BIT(1)
173 #define PCA953x_BANK_POLARITY BIT(2)
174 #define PCA953x_BANK_CONFIG BIT(3)
176 #define PCA957x_BANK_INPUT BIT(0)
177 #define PCA957x_BANK_POLARITY BIT(1)
178 #define PCA957x_BANK_BUSHOLD BIT(2)
179 #define PCA957x_BANK_CONFIG BIT(4)
180 #define PCA957x_BANK_OUTPUT BIT(5)
182 #define PCAL9xxx_BANK_IN_LATCH BIT(8 + 2)
183 #define PCAL9xxx_BANK_PULL_EN BIT(8 + 3)
184 #define PCAL9xxx_BANK_PULL_SEL BIT(8 + 4)
185 #define PCAL9xxx_BANK_IRQ_MASK BIT(8 + 5)
186 #define PCAL9xxx_BANK_IRQ_STAT BIT(8 + 6)
189 * We care about the following registers:
190 * - Standard set, below 0x40, each port can be replicated up to 8 times
192 * Input port 0x00 + 0 * bank_size R
193 * Output port 0x00 + 1 * bank_size RW
194 * Polarity Inversion port 0x00 + 2 * bank_size RW
195 * Configuration port 0x00 + 3 * bank_size RW
196 * - PCA957x with mixed up registers
197 * Input port 0x00 + 0 * bank_size R
198 * Polarity Inversion port 0x00 + 1 * bank_size RW
199 * Bus hold port 0x00 + 2 * bank_size RW
200 * Configuration port 0x00 + 4 * bank_size RW
201 * Output port 0x00 + 5 * bank_size RW
203 * - Extended set, above 0x40, often chip specific.
204 * - PCAL6524/PCAL9555A with custom PCAL IRQ handling:
205 * Input latch register 0x40 + 2 * bank_size RW
206 * Pull-up/pull-down enable reg 0x40 + 3 * bank_size RW
207 * Pull-up/pull-down select reg 0x40 + 4 * bank_size RW
208 * Interrupt mask register 0x40 + 5 * bank_size RW
209 * Interrupt status register 0x40 + 6 * bank_size R
211 * - Registers with bit 0x80 set, the AI bit
212 * The bit is cleared and the registers fall into one of the
216 static bool pca953x_check_register(struct pca953x_chip *chip, unsigned int reg,
219 int bank_shift = pca953x_bank_shift(chip);
220 int bank = (reg & REG_ADDR_MASK) >> bank_shift;
221 int offset = reg & (BIT(bank_shift) - 1);
223 /* Special PCAL extended register check. */
224 if (reg & REG_ADDR_EXT) {
225 if (!(chip->driver_data & PCA_PCAL))
230 /* Register is not in the matching bank. */
231 if (!(BIT(bank) & checkbank))
234 /* Register is not within allowed range of bank. */
235 if (offset >= NBANK(chip))
241 static bool pca953x_readable_register(struct device *dev, unsigned int reg)
243 struct pca953x_chip *chip = dev_get_drvdata(dev);
246 if (PCA_CHIP_TYPE(chip->driver_data) == PCA953X_TYPE) {
247 bank = PCA953x_BANK_INPUT | PCA953x_BANK_OUTPUT |
248 PCA953x_BANK_POLARITY | PCA953x_BANK_CONFIG;
250 bank = PCA957x_BANK_INPUT | PCA957x_BANK_OUTPUT |
251 PCA957x_BANK_POLARITY | PCA957x_BANK_CONFIG |
252 PCA957x_BANK_BUSHOLD;
255 if (chip->driver_data & PCA_PCAL) {
256 bank |= PCAL9xxx_BANK_IN_LATCH | PCAL9xxx_BANK_PULL_EN |
257 PCAL9xxx_BANK_PULL_SEL | PCAL9xxx_BANK_IRQ_MASK |
258 PCAL9xxx_BANK_IRQ_STAT;
261 return pca953x_check_register(chip, reg, bank);
264 static bool pca953x_writeable_register(struct device *dev, unsigned int reg)
266 struct pca953x_chip *chip = dev_get_drvdata(dev);
269 if (PCA_CHIP_TYPE(chip->driver_data) == PCA953X_TYPE) {
270 bank = PCA953x_BANK_OUTPUT | PCA953x_BANK_POLARITY |
273 bank = PCA957x_BANK_OUTPUT | PCA957x_BANK_POLARITY |
274 PCA957x_BANK_CONFIG | PCA957x_BANK_BUSHOLD;
277 if (chip->driver_data & PCA_PCAL)
278 bank |= PCAL9xxx_BANK_IN_LATCH | PCAL9xxx_BANK_PULL_EN |
279 PCAL9xxx_BANK_PULL_SEL | PCAL9xxx_BANK_IRQ_MASK;
281 return pca953x_check_register(chip, reg, bank);
284 static bool pca953x_volatile_register(struct device *dev, unsigned int reg)
286 struct pca953x_chip *chip = dev_get_drvdata(dev);
289 if (PCA_CHIP_TYPE(chip->driver_data) == PCA953X_TYPE)
290 bank = PCA953x_BANK_INPUT;
292 bank = PCA957x_BANK_INPUT;
294 if (chip->driver_data & PCA_PCAL)
295 bank |= PCAL9xxx_BANK_IRQ_STAT;
297 return pca953x_check_register(chip, reg, bank);
300 static const struct regmap_config pca953x_i2c_regmap = {
304 .readable_reg = pca953x_readable_register,
305 .writeable_reg = pca953x_writeable_register,
306 .volatile_reg = pca953x_volatile_register,
308 .cache_type = REGCACHE_RBTREE,
309 /* REVISIT: should be 0x7f but some 24 bit chips use REG_ADDR_AI */
310 .max_register = 0xff,
313 static u8 pca953x_recalc_addr(struct pca953x_chip *chip, int reg, int off,
314 bool write, bool addrinc)
316 int bank_shift = pca953x_bank_shift(chip);
317 int addr = (reg & PCAL_GPIO_MASK) << bank_shift;
318 int pinctrl = (reg & PCAL_PINCTRL_MASK) << 1;
319 u8 regaddr = pinctrl | addr | (off / BANK_SZ);
321 /* Single byte read doesn't need AI bit set. */
325 /* Chips with 24 and more GPIOs always support Auto Increment */
326 if (write && NBANK(chip) > 2)
327 regaddr |= REG_ADDR_AI;
329 /* PCA9575 needs address-increment on multi-byte writes */
330 if (PCA_CHIP_TYPE(chip->driver_data) == PCA957X_TYPE)
331 regaddr |= REG_ADDR_AI;
336 static int pca953x_write_regs(struct pca953x_chip *chip, int reg, u8 *val)
338 u8 regaddr = pca953x_recalc_addr(chip, reg, 0, true, true);
341 ret = regmap_bulk_write(chip->regmap, regaddr, val, NBANK(chip));
343 dev_err(&chip->client->dev, "failed writing register\n");
350 static int pca953x_read_regs(struct pca953x_chip *chip, int reg, u8 *val)
352 u8 regaddr = pca953x_recalc_addr(chip, reg, 0, false, true);
355 ret = regmap_bulk_read(chip->regmap, regaddr, val, NBANK(chip));
357 dev_err(&chip->client->dev, "failed reading register\n");
364 static int pca953x_gpio_direction_input(struct gpio_chip *gc, unsigned off)
366 struct pca953x_chip *chip = gpiochip_get_data(gc);
367 u8 dirreg = pca953x_recalc_addr(chip, chip->regs->direction, off,
369 u8 bit = BIT(off % BANK_SZ);
372 mutex_lock(&chip->i2c_lock);
373 ret = regmap_write_bits(chip->regmap, dirreg, bit, bit);
374 mutex_unlock(&chip->i2c_lock);
378 static int pca953x_gpio_direction_output(struct gpio_chip *gc,
379 unsigned off, int val)
381 struct pca953x_chip *chip = gpiochip_get_data(gc);
382 u8 dirreg = pca953x_recalc_addr(chip, chip->regs->direction, off,
384 u8 outreg = pca953x_recalc_addr(chip, chip->regs->output, off,
386 u8 bit = BIT(off % BANK_SZ);
389 mutex_lock(&chip->i2c_lock);
390 /* set output level */
391 ret = regmap_write_bits(chip->regmap, outreg, bit, val ? bit : 0);
396 ret = regmap_write_bits(chip->regmap, dirreg, bit, 0);
398 mutex_unlock(&chip->i2c_lock);
402 static int pca953x_gpio_get_value(struct gpio_chip *gc, unsigned off)
404 struct pca953x_chip *chip = gpiochip_get_data(gc);
405 u8 inreg = pca953x_recalc_addr(chip, chip->regs->input, off,
407 u8 bit = BIT(off % BANK_SZ);
411 mutex_lock(&chip->i2c_lock);
412 ret = regmap_read(chip->regmap, inreg, ®_val);
413 mutex_unlock(&chip->i2c_lock);
415 /* NOTE: diagnostic already emitted; that's all we should
416 * do unless gpio_*_value_cansleep() calls become different
417 * from their nonsleeping siblings (and report faults).
422 return !!(reg_val & bit);
425 static void pca953x_gpio_set_value(struct gpio_chip *gc, unsigned off, int val)
427 struct pca953x_chip *chip = gpiochip_get_data(gc);
428 u8 outreg = pca953x_recalc_addr(chip, chip->regs->output, off,
430 u8 bit = BIT(off % BANK_SZ);
432 mutex_lock(&chip->i2c_lock);
433 regmap_write_bits(chip->regmap, outreg, bit, val ? bit : 0);
434 mutex_unlock(&chip->i2c_lock);
437 static int pca953x_gpio_get_direction(struct gpio_chip *gc, unsigned off)
439 struct pca953x_chip *chip = gpiochip_get_data(gc);
440 u8 dirreg = pca953x_recalc_addr(chip, chip->regs->direction, off,
442 u8 bit = BIT(off % BANK_SZ);
446 mutex_lock(&chip->i2c_lock);
447 ret = regmap_read(chip->regmap, dirreg, ®_val);
448 mutex_unlock(&chip->i2c_lock);
452 return !!(reg_val & bit);
455 static void pca953x_gpio_set_multiple(struct gpio_chip *gc,
456 unsigned long *mask, unsigned long *bits)
458 struct pca953x_chip *chip = gpiochip_get_data(gc);
459 unsigned int bank_mask, bank_val;
461 u8 reg_val[MAX_BANK];
464 mutex_lock(&chip->i2c_lock);
465 ret = pca953x_read_regs(chip, chip->regs->output, reg_val);
469 for (bank = 0; bank < NBANK(chip); bank++) {
470 bank_mask = mask[bank / sizeof(*mask)] >>
471 ((bank % sizeof(*mask)) * 8);
473 bank_val = bits[bank / sizeof(*bits)] >>
474 ((bank % sizeof(*bits)) * 8);
475 bank_val &= bank_mask;
476 reg_val[bank] = (reg_val[bank] & ~bank_mask) | bank_val;
480 pca953x_write_regs(chip, chip->regs->output, reg_val);
482 mutex_unlock(&chip->i2c_lock);
485 static int pca953x_gpio_set_pull_up_down(struct pca953x_chip *chip,
487 unsigned long config)
489 u8 pull_en_reg = pca953x_recalc_addr(chip, PCAL953X_PULL_EN, offset,
491 u8 pull_sel_reg = pca953x_recalc_addr(chip, PCAL953X_PULL_SEL, offset,
493 u8 bit = BIT(offset % BANK_SZ);
497 * pull-up/pull-down configuration requires PCAL extended
500 if (!(chip->driver_data & PCA_PCAL))
503 mutex_lock(&chip->i2c_lock);
505 /* Disable pull-up/pull-down */
506 ret = regmap_write_bits(chip->regmap, pull_en_reg, bit, 0);
510 /* Configure pull-up/pull-down */
511 if (config == PIN_CONFIG_BIAS_PULL_UP)
512 ret = regmap_write_bits(chip->regmap, pull_sel_reg, bit, bit);
513 else if (config == PIN_CONFIG_BIAS_PULL_DOWN)
514 ret = regmap_write_bits(chip->regmap, pull_sel_reg, bit, 0);
518 /* Enable pull-up/pull-down */
519 ret = regmap_write_bits(chip->regmap, pull_en_reg, bit, bit);
522 mutex_unlock(&chip->i2c_lock);
526 static int pca953x_gpio_set_config(struct gpio_chip *gc, unsigned int offset,
527 unsigned long config)
529 struct pca953x_chip *chip = gpiochip_get_data(gc);
532 case PIN_CONFIG_BIAS_PULL_UP:
533 case PIN_CONFIG_BIAS_PULL_DOWN:
534 return pca953x_gpio_set_pull_up_down(chip, offset, config);
540 static void pca953x_setup_gpio(struct pca953x_chip *chip, int gpios)
542 struct gpio_chip *gc;
544 gc = &chip->gpio_chip;
546 gc->direction_input = pca953x_gpio_direction_input;
547 gc->direction_output = pca953x_gpio_direction_output;
548 gc->get = pca953x_gpio_get_value;
549 gc->set = pca953x_gpio_set_value;
550 gc->get_direction = pca953x_gpio_get_direction;
551 gc->set_multiple = pca953x_gpio_set_multiple;
552 gc->set_config = pca953x_gpio_set_config;
553 gc->can_sleep = true;
555 gc->base = chip->gpio_start;
557 gc->label = dev_name(&chip->client->dev);
558 gc->parent = &chip->client->dev;
559 gc->owner = THIS_MODULE;
560 gc->names = chip->names;
563 #ifdef CONFIG_GPIO_PCA953X_IRQ
564 static void pca953x_irq_mask(struct irq_data *d)
566 struct gpio_chip *gc = irq_data_get_irq_chip_data(d);
567 struct pca953x_chip *chip = gpiochip_get_data(gc);
569 chip->irq_mask[d->hwirq / BANK_SZ] &= ~BIT(d->hwirq % BANK_SZ);
572 static void pca953x_irq_unmask(struct irq_data *d)
574 struct gpio_chip *gc = irq_data_get_irq_chip_data(d);
575 struct pca953x_chip *chip = gpiochip_get_data(gc);
577 chip->irq_mask[d->hwirq / BANK_SZ] |= BIT(d->hwirq % BANK_SZ);
580 static int pca953x_irq_set_wake(struct irq_data *d, unsigned int on)
582 struct gpio_chip *gc = irq_data_get_irq_chip_data(d);
583 struct pca953x_chip *chip = gpiochip_get_data(gc);
586 atomic_inc(&chip->wakeup_path);
588 atomic_dec(&chip->wakeup_path);
590 return irq_set_irq_wake(chip->client->irq, on);
593 static void pca953x_irq_bus_lock(struct irq_data *d)
595 struct gpio_chip *gc = irq_data_get_irq_chip_data(d);
596 struct pca953x_chip *chip = gpiochip_get_data(gc);
598 mutex_lock(&chip->irq_lock);
601 static void pca953x_irq_bus_sync_unlock(struct irq_data *d)
603 struct gpio_chip *gc = irq_data_get_irq_chip_data(d);
604 struct pca953x_chip *chip = gpiochip_get_data(gc);
607 u8 invert_irq_mask[MAX_BANK];
608 u8 reg_direction[MAX_BANK];
610 pca953x_read_regs(chip, chip->regs->direction, reg_direction);
612 if (chip->driver_data & PCA_PCAL) {
613 /* Enable latch on interrupt-enabled inputs */
614 pca953x_write_regs(chip, PCAL953X_IN_LATCH, chip->irq_mask);
616 for (i = 0; i < NBANK(chip); i++)
617 invert_irq_mask[i] = ~chip->irq_mask[i];
619 /* Unmask enabled interrupts */
620 pca953x_write_regs(chip, PCAL953X_INT_MASK, invert_irq_mask);
623 /* Look for any newly setup interrupt */
624 for (i = 0; i < NBANK(chip); i++) {
625 new_irqs = chip->irq_trig_fall[i] | chip->irq_trig_raise[i];
626 new_irqs &= reg_direction[i];
629 level = __ffs(new_irqs);
630 pca953x_gpio_direction_input(&chip->gpio_chip,
631 level + (BANK_SZ * i));
632 new_irqs &= ~(1 << level);
636 mutex_unlock(&chip->irq_lock);
639 static int pca953x_irq_set_type(struct irq_data *d, unsigned int type)
641 struct gpio_chip *gc = irq_data_get_irq_chip_data(d);
642 struct pca953x_chip *chip = gpiochip_get_data(gc);
643 int bank_nb = d->hwirq / BANK_SZ;
644 u8 mask = BIT(d->hwirq % BANK_SZ);
646 if (!(type & IRQ_TYPE_EDGE_BOTH)) {
647 dev_err(&chip->client->dev, "irq %d: unsupported type %d\n",
652 if (type & IRQ_TYPE_EDGE_FALLING)
653 chip->irq_trig_fall[bank_nb] |= mask;
655 chip->irq_trig_fall[bank_nb] &= ~mask;
657 if (type & IRQ_TYPE_EDGE_RISING)
658 chip->irq_trig_raise[bank_nb] |= mask;
660 chip->irq_trig_raise[bank_nb] &= ~mask;
665 static void pca953x_irq_shutdown(struct irq_data *d)
667 struct gpio_chip *gc = irq_data_get_irq_chip_data(d);
668 struct pca953x_chip *chip = gpiochip_get_data(gc);
669 u8 mask = BIT(d->hwirq % BANK_SZ);
671 chip->irq_trig_raise[d->hwirq / BANK_SZ] &= ~mask;
672 chip->irq_trig_fall[d->hwirq / BANK_SZ] &= ~mask;
675 static bool pca953x_irq_pending(struct pca953x_chip *chip, u8 *pending)
677 u8 cur_stat[MAX_BANK];
678 u8 old_stat[MAX_BANK];
679 bool pending_seen = false;
680 bool trigger_seen = false;
681 u8 trigger[MAX_BANK];
682 u8 reg_direction[MAX_BANK];
685 if (chip->driver_data & PCA_PCAL) {
686 /* Read the current interrupt status from the device */
687 ret = pca953x_read_regs(chip, PCAL953X_INT_STAT, trigger);
691 /* Check latched inputs and clear interrupt status */
692 ret = pca953x_read_regs(chip, PCA953X_INPUT, cur_stat);
696 for (i = 0; i < NBANK(chip); i++) {
697 /* Apply filter for rising/falling edge selection */
698 pending[i] = (~cur_stat[i] & chip->irq_trig_fall[i]) |
699 (cur_stat[i] & chip->irq_trig_raise[i]);
700 pending[i] &= trigger[i];
708 ret = pca953x_read_regs(chip, chip->regs->input, cur_stat);
712 /* Remove output pins from the equation */
713 pca953x_read_regs(chip, chip->regs->direction, reg_direction);
714 for (i = 0; i < NBANK(chip); i++)
715 cur_stat[i] &= reg_direction[i];
717 memcpy(old_stat, chip->irq_stat, NBANK(chip));
719 for (i = 0; i < NBANK(chip); i++) {
720 trigger[i] = (cur_stat[i] ^ old_stat[i]) & chip->irq_mask[i];
728 memcpy(chip->irq_stat, cur_stat, NBANK(chip));
730 for (i = 0; i < NBANK(chip); i++) {
731 pending[i] = (old_stat[i] & chip->irq_trig_fall[i]) |
732 (cur_stat[i] & chip->irq_trig_raise[i]);
733 pending[i] &= trigger[i];
741 static irqreturn_t pca953x_irq_handler(int irq, void *devid)
743 struct pca953x_chip *chip = devid;
744 u8 pending[MAX_BANK];
746 unsigned nhandled = 0;
749 if (!pca953x_irq_pending(chip, pending))
752 for (i = 0; i < NBANK(chip); i++) {
754 level = __ffs(pending[i]);
755 handle_nested_irq(irq_find_mapping(chip->gpio_chip.irq.domain,
756 level + (BANK_SZ * i)));
757 pending[i] &= ~(1 << level);
762 return (nhandled > 0) ? IRQ_HANDLED : IRQ_NONE;
765 static int pca953x_irq_setup(struct pca953x_chip *chip,
768 struct i2c_client *client = chip->client;
769 struct irq_chip *irq_chip = &chip->irq_chip;
770 u8 reg_direction[MAX_BANK];
779 if (!(chip->driver_data & PCA_INT))
782 ret = pca953x_read_regs(chip, chip->regs->input, chip->irq_stat);
787 * There is no way to know which GPIO line generated the
788 * interrupt. We have to rely on the previous read for
791 pca953x_read_regs(chip, chip->regs->direction, reg_direction);
792 for (i = 0; i < NBANK(chip); i++)
793 chip->irq_stat[i] &= reg_direction[i];
794 mutex_init(&chip->irq_lock);
796 ret = devm_request_threaded_irq(&client->dev, client->irq,
797 NULL, pca953x_irq_handler,
798 IRQF_TRIGGER_LOW | IRQF_ONESHOT |
800 dev_name(&client->dev), chip);
802 dev_err(&client->dev, "failed to request irq %d\n",
807 irq_chip->name = dev_name(&chip->client->dev);
808 irq_chip->irq_mask = pca953x_irq_mask;
809 irq_chip->irq_unmask = pca953x_irq_unmask;
810 irq_chip->irq_set_wake = pca953x_irq_set_wake;
811 irq_chip->irq_bus_lock = pca953x_irq_bus_lock;
812 irq_chip->irq_bus_sync_unlock = pca953x_irq_bus_sync_unlock;
813 irq_chip->irq_set_type = pca953x_irq_set_type;
814 irq_chip->irq_shutdown = pca953x_irq_shutdown;
816 ret = gpiochip_irqchip_add_nested(&chip->gpio_chip, irq_chip,
817 irq_base, handle_simple_irq,
820 dev_err(&client->dev,
821 "could not connect irqchip to gpiochip\n");
825 gpiochip_set_nested_irqchip(&chip->gpio_chip, irq_chip, client->irq);
830 #else /* CONFIG_GPIO_PCA953X_IRQ */
831 static int pca953x_irq_setup(struct pca953x_chip *chip,
834 struct i2c_client *client = chip->client;
836 if (client->irq && irq_base != -1 && (chip->driver_data & PCA_INT))
837 dev_warn(&client->dev, "interrupt support not compiled in\n");
843 static int device_pca95xx_init(struct pca953x_chip *chip, u32 invert)
848 ret = regcache_sync_region(chip->regmap, chip->regs->output,
849 chip->regs->output + NBANK(chip));
853 ret = regcache_sync_region(chip->regmap, chip->regs->direction,
854 chip->regs->direction + NBANK(chip));
858 /* set platform specific polarity inversion */
860 memset(val, 0xFF, NBANK(chip));
862 memset(val, 0, NBANK(chip));
864 ret = pca953x_write_regs(chip, chip->regs->invert, val);
869 static int device_pca957x_init(struct pca953x_chip *chip, u32 invert)
874 ret = device_pca95xx_init(chip, invert);
878 /* To enable register 6, 7 to control pull up and pull down */
879 memset(val, 0x02, NBANK(chip));
880 ret = pca953x_write_regs(chip, PCA957X_BKEN, val);
889 static const struct of_device_id pca953x_dt_ids[];
891 static int pca953x_probe(struct i2c_client *client,
892 const struct i2c_device_id *i2c_id)
894 struct pca953x_platform_data *pdata;
895 struct pca953x_chip *chip;
899 struct regulator *reg;
901 chip = devm_kzalloc(&client->dev,
902 sizeof(struct pca953x_chip), GFP_KERNEL);
906 pdata = dev_get_platdata(&client->dev);
908 irq_base = pdata->irq_base;
909 chip->gpio_start = pdata->gpio_base;
910 invert = pdata->invert;
911 chip->names = pdata->names;
913 struct gpio_desc *reset_gpio;
915 chip->gpio_start = -1;
919 * See if we need to de-assert a reset pin.
921 * There is no known ACPI-enabled platforms that are
922 * using "reset" GPIO. Otherwise any of those platform
923 * must use _DSD method with corresponding property.
925 reset_gpio = devm_gpiod_get_optional(&client->dev, "reset",
927 if (IS_ERR(reset_gpio))
928 return PTR_ERR(reset_gpio);
931 chip->client = client;
933 reg = devm_regulator_get(&client->dev, "vcc");
936 if (ret != -EPROBE_DEFER)
937 dev_err(&client->dev, "reg get err: %d\n", ret);
940 ret = regulator_enable(reg);
942 dev_err(&client->dev, "reg en err: %d\n", ret);
945 chip->regulator = reg;
948 chip->driver_data = i2c_id->driver_data;
952 match = device_get_match_data(&client->dev);
958 chip->driver_data = (uintptr_t)match;
961 i2c_set_clientdata(client, chip);
963 chip->regmap = devm_regmap_init_i2c(client, &pca953x_i2c_regmap);
964 if (IS_ERR(chip->regmap)) {
965 ret = PTR_ERR(chip->regmap);
969 regcache_mark_dirty(chip->regmap);
971 mutex_init(&chip->i2c_lock);
973 * In case we have an i2c-mux controlled by a GPIO provided by an
974 * expander using the same driver higher on the device tree, read the
975 * i2c adapter nesting depth and use the retrieved value as lockdep
976 * subclass for chip->i2c_lock.
978 * REVISIT: This solution is not complete. It protects us from lockdep
979 * false positives when the expander controlling the i2c-mux is on
980 * a different level on the device tree, but not when it's on the same
981 * level on a different branch (in which case the subclass number
982 * would be the same).
984 * TODO: Once a correct solution is developed, a similar fix should be
985 * applied to all other i2c-controlled GPIO expanders (and potentially
988 lockdep_set_subclass(&chip->i2c_lock,
989 i2c_adapter_depth(client->adapter));
991 /* initialize cached registers from their original values.
992 * we can't share this chip with another i2c master.
994 pca953x_setup_gpio(chip, chip->driver_data & PCA_GPIO_MASK);
996 if (PCA_CHIP_TYPE(chip->driver_data) == PCA953X_TYPE) {
997 chip->regs = &pca953x_regs;
998 ret = device_pca95xx_init(chip, invert);
1000 chip->regs = &pca957x_regs;
1001 ret = device_pca957x_init(chip, invert);
1006 ret = devm_gpiochip_add_data(&client->dev, &chip->gpio_chip, chip);
1010 ret = pca953x_irq_setup(chip, irq_base);
1014 if (pdata && pdata->setup) {
1015 ret = pdata->setup(client, chip->gpio_chip.base,
1016 chip->gpio_chip.ngpio, pdata->context);
1018 dev_warn(&client->dev, "setup failed, %d\n", ret);
1024 regulator_disable(chip->regulator);
1028 static int pca953x_remove(struct i2c_client *client)
1030 struct pca953x_platform_data *pdata = dev_get_platdata(&client->dev);
1031 struct pca953x_chip *chip = i2c_get_clientdata(client);
1034 if (pdata && pdata->teardown) {
1035 ret = pdata->teardown(client, chip->gpio_chip.base,
1036 chip->gpio_chip.ngpio, pdata->context);
1038 dev_err(&client->dev, "teardown failed, %d\n", ret);
1043 regulator_disable(chip->regulator);
1048 #ifdef CONFIG_PM_SLEEP
1049 static int pca953x_regcache_sync(struct device *dev)
1051 struct pca953x_chip *chip = dev_get_drvdata(dev);
1055 * The ordering between direction and output is important,
1056 * sync these registers first and only then sync the rest.
1058 ret = regcache_sync_region(chip->regmap, chip->regs->direction,
1059 chip->regs->direction + NBANK(chip));
1061 dev_err(dev, "Failed to sync GPIO dir registers: %d\n", ret);
1065 ret = regcache_sync_region(chip->regmap, chip->regs->output,
1066 chip->regs->output + NBANK(chip));
1068 dev_err(dev, "Failed to sync GPIO out registers: %d\n", ret);
1072 #ifdef CONFIG_GPIO_PCA953X_IRQ
1073 if (chip->driver_data & PCA_PCAL) {
1074 ret = regcache_sync_region(chip->regmap, PCAL953X_IN_LATCH,
1075 PCAL953X_IN_LATCH + NBANK(chip));
1077 dev_err(dev, "Failed to sync INT latch registers: %d\n",
1082 ret = regcache_sync_region(chip->regmap, PCAL953X_INT_MASK,
1083 PCAL953X_INT_MASK + NBANK(chip));
1085 dev_err(dev, "Failed to sync INT mask registers: %d\n",
1095 static int pca953x_suspend(struct device *dev)
1097 struct pca953x_chip *chip = dev_get_drvdata(dev);
1099 regcache_cache_only(chip->regmap, true);
1101 if (atomic_read(&chip->wakeup_path))
1102 device_set_wakeup_path(dev);
1104 regulator_disable(chip->regulator);
1109 static int pca953x_resume(struct device *dev)
1111 struct pca953x_chip *chip = dev_get_drvdata(dev);
1114 if (!atomic_read(&chip->wakeup_path)) {
1115 ret = regulator_enable(chip->regulator);
1117 dev_err(dev, "Failed to enable regulator: %d\n", ret);
1122 regcache_cache_only(chip->regmap, false);
1123 regcache_mark_dirty(chip->regmap);
1124 ret = pca953x_regcache_sync(dev);
1128 ret = regcache_sync(chip->regmap);
1130 dev_err(dev, "Failed to restore register map: %d\n", ret);
1138 /* convenience to stop overlong match-table lines */
1139 #define OF_953X(__nrgpio, __int) (void *)(__nrgpio | PCA953X_TYPE | __int)
1140 #define OF_957X(__nrgpio, __int) (void *)(__nrgpio | PCA957X_TYPE | __int)
1142 static const struct of_device_id pca953x_dt_ids[] = {
1143 { .compatible = "nxp,pca6416", .data = OF_953X(16, PCA_INT), },
1144 { .compatible = "nxp,pca9505", .data = OF_953X(40, PCA_INT), },
1145 { .compatible = "nxp,pca9534", .data = OF_953X( 8, PCA_INT), },
1146 { .compatible = "nxp,pca9535", .data = OF_953X(16, PCA_INT), },
1147 { .compatible = "nxp,pca9536", .data = OF_953X( 4, 0), },
1148 { .compatible = "nxp,pca9537", .data = OF_953X( 4, PCA_INT), },
1149 { .compatible = "nxp,pca9538", .data = OF_953X( 8, PCA_INT), },
1150 { .compatible = "nxp,pca9539", .data = OF_953X(16, PCA_INT), },
1151 { .compatible = "nxp,pca9554", .data = OF_953X( 8, PCA_INT), },
1152 { .compatible = "nxp,pca9555", .data = OF_953X(16, PCA_INT), },
1153 { .compatible = "nxp,pca9556", .data = OF_953X( 8, 0), },
1154 { .compatible = "nxp,pca9557", .data = OF_953X( 8, 0), },
1155 { .compatible = "nxp,pca9574", .data = OF_957X( 8, PCA_INT), },
1156 { .compatible = "nxp,pca9575", .data = OF_957X(16, PCA_INT), },
1157 { .compatible = "nxp,pca9698", .data = OF_953X(40, 0), },
1159 { .compatible = "nxp,pcal6416", .data = OF_953X(16, PCA_LATCH_INT), },
1160 { .compatible = "nxp,pcal6524", .data = OF_953X(24, PCA_LATCH_INT), },
1161 { .compatible = "nxp,pcal9555a", .data = OF_953X(16, PCA_LATCH_INT), },
1163 { .compatible = "maxim,max7310", .data = OF_953X( 8, 0), },
1164 { .compatible = "maxim,max7312", .data = OF_953X(16, PCA_INT), },
1165 { .compatible = "maxim,max7313", .data = OF_953X(16, PCA_INT), },
1166 { .compatible = "maxim,max7315", .data = OF_953X( 8, PCA_INT), },
1167 { .compatible = "maxim,max7318", .data = OF_953X(16, PCA_INT), },
1169 { .compatible = "ti,pca6107", .data = OF_953X( 8, PCA_INT), },
1170 { .compatible = "ti,pca9536", .data = OF_953X( 4, 0), },
1171 { .compatible = "ti,tca6408", .data = OF_953X( 8, PCA_INT), },
1172 { .compatible = "ti,tca6416", .data = OF_953X(16, PCA_INT), },
1173 { .compatible = "ti,tca6424", .data = OF_953X(24, PCA_INT), },
1174 { .compatible = "ti,tca9539", .data = OF_953X(16, PCA_INT), },
1176 { .compatible = "onnn,cat9554", .data = OF_953X( 8, PCA_INT), },
1177 { .compatible = "onnn,pca9654", .data = OF_953X( 8, PCA_INT), },
1179 { .compatible = "exar,xra1202", .data = OF_953X( 8, 0), },
1183 MODULE_DEVICE_TABLE(of, pca953x_dt_ids);
1185 static SIMPLE_DEV_PM_OPS(pca953x_pm_ops, pca953x_suspend, pca953x_resume);
1187 static struct i2c_driver pca953x_driver = {
1190 .pm = &pca953x_pm_ops,
1191 .of_match_table = pca953x_dt_ids,
1192 .acpi_match_table = ACPI_PTR(pca953x_acpi_ids),
1194 .probe = pca953x_probe,
1195 .remove = pca953x_remove,
1196 .id_table = pca953x_id,
1199 static int __init pca953x_init(void)
1201 return i2c_add_driver(&pca953x_driver);
1203 /* register after i2c postcore initcall and before
1204 * subsys initcalls that may rely on these GPIOs
1206 subsys_initcall(pca953x_init);
1208 static void __exit pca953x_exit(void)
1210 i2c_del_driver(&pca953x_driver);
1212 module_exit(pca953x_exit);
1215 MODULE_DESCRIPTION("GPIO expander driver for PCA953x");
1216 MODULE_LICENSE("GPL");