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/atomic.h>
12 #include <linux/bitmap.h>
13 #include <linux/cleanup.h>
14 #include <linux/device.h>
15 #include <linux/errno.h>
16 #include <linux/i2c.h>
17 #include <linux/init.h>
18 #include <linux/interrupt.h>
19 #include <linux/irq.h>
20 #include <linux/mod_devicetable.h>
21 #include <linux/module.h>
22 #include <linux/mutex.h>
24 #include <linux/regmap.h>
25 #include <linux/regulator/consumer.h>
26 #include <linux/seq_file.h>
27 #include <linux/slab.h>
29 #include <linux/gpio/consumer.h>
30 #include <linux/gpio/driver.h>
32 #include <linux/pinctrl/pinconf-generic.h>
34 #include <linux/platform_data/pca953x.h>
36 #define PCA953X_INPUT 0x00
37 #define PCA953X_OUTPUT 0x01
38 #define PCA953X_INVERT 0x02
39 #define PCA953X_DIRECTION 0x03
41 #define REG_ADDR_MASK GENMASK(5, 0)
42 #define REG_ADDR_EXT BIT(6)
43 #define REG_ADDR_AI BIT(7)
45 #define PCA957X_IN 0x00
46 #define PCA957X_INVRT 0x01
47 #define PCA957X_BKEN 0x02
48 #define PCA957X_PUPD 0x03
49 #define PCA957X_CFG 0x04
50 #define PCA957X_OUT 0x05
51 #define PCA957X_MSK 0x06
52 #define PCA957X_INTS 0x07
54 #define PCAL953X_OUT_STRENGTH 0x20
55 #define PCAL953X_IN_LATCH 0x22
56 #define PCAL953X_PULL_EN 0x23
57 #define PCAL953X_PULL_SEL 0x24
58 #define PCAL953X_INT_MASK 0x25
59 #define PCAL953X_INT_STAT 0x26
60 #define PCAL953X_OUT_CONF 0x27
62 #define PCAL6524_INT_EDGE 0x28
63 #define PCAL6524_INT_CLR 0x2a
64 #define PCAL6524_IN_STATUS 0x2b
65 #define PCAL6524_OUT_INDCONF 0x2c
66 #define PCAL6524_DEBOUNCE 0x2d
68 #define PCA_GPIO_MASK GENMASK(7, 0)
70 #define PCAL_GPIO_MASK GENMASK(4, 0)
71 #define PCAL_PINCTRL_MASK GENMASK(6, 5)
73 #define PCA_INT BIT(8)
74 #define PCA_PCAL BIT(9)
75 #define PCA_LATCH_INT (PCA_PCAL | PCA_INT)
76 #define PCA953X_TYPE BIT(12)
77 #define PCA957X_TYPE BIT(13)
78 #define PCAL653X_TYPE BIT(14)
79 #define PCA_TYPE_MASK GENMASK(15, 12)
81 #define PCA_CHIP_TYPE(x) ((x) & PCA_TYPE_MASK)
83 static const struct i2c_device_id pca953x_id[] = {
84 { "pca6408", 8 | PCA953X_TYPE | PCA_INT, },
85 { "pca6416", 16 | PCA953X_TYPE | PCA_INT, },
86 { "pca9505", 40 | PCA953X_TYPE | PCA_INT, },
87 { "pca9506", 40 | PCA953X_TYPE | PCA_INT, },
88 { "pca9534", 8 | PCA953X_TYPE | PCA_INT, },
89 { "pca9535", 16 | PCA953X_TYPE | PCA_INT, },
90 { "pca9536", 4 | PCA953X_TYPE, },
91 { "pca9537", 4 | PCA953X_TYPE | PCA_INT, },
92 { "pca9538", 8 | PCA953X_TYPE | PCA_INT, },
93 { "pca9539", 16 | PCA953X_TYPE | PCA_INT, },
94 { "pca9554", 8 | PCA953X_TYPE | PCA_INT, },
95 { "pca9555", 16 | PCA953X_TYPE | PCA_INT, },
96 { "pca9556", 8 | PCA953X_TYPE, },
97 { "pca9557", 8 | PCA953X_TYPE, },
98 { "pca9574", 8 | PCA957X_TYPE | PCA_INT, },
99 { "pca9575", 16 | PCA957X_TYPE | PCA_INT, },
100 { "pca9698", 40 | PCA953X_TYPE, },
102 { "pcal6408", 8 | PCA953X_TYPE | PCA_LATCH_INT, },
103 { "pcal6416", 16 | PCA953X_TYPE | PCA_LATCH_INT, },
104 { "pcal6524", 24 | PCA953X_TYPE | PCA_LATCH_INT, },
105 { "pcal6534", 34 | PCAL653X_TYPE | PCA_LATCH_INT, },
106 { "pcal9535", 16 | PCA953X_TYPE | PCA_LATCH_INT, },
107 { "pcal9554b", 8 | PCA953X_TYPE | PCA_LATCH_INT, },
108 { "pcal9555a", 16 | PCA953X_TYPE | PCA_LATCH_INT, },
110 { "max7310", 8 | PCA953X_TYPE, },
111 { "max7312", 16 | PCA953X_TYPE | PCA_INT, },
112 { "max7313", 16 | PCA953X_TYPE | PCA_INT, },
113 { "max7315", 8 | PCA953X_TYPE | PCA_INT, },
114 { "max7318", 16 | PCA953X_TYPE | PCA_INT, },
115 { "pca6107", 8 | PCA953X_TYPE | PCA_INT, },
116 { "tca6408", 8 | PCA953X_TYPE | PCA_INT, },
117 { "tca6416", 16 | PCA953X_TYPE | PCA_INT, },
118 { "tca6424", 24 | PCA953X_TYPE | PCA_INT, },
119 { "tca9538", 8 | PCA953X_TYPE | PCA_INT, },
120 { "tca9539", 16 | PCA953X_TYPE | PCA_INT, },
121 { "tca9554", 8 | PCA953X_TYPE | PCA_INT, },
122 { "xra1202", 8 | PCA953X_TYPE },
125 MODULE_DEVICE_TABLE(i2c, pca953x_id);
127 #ifdef CONFIG_GPIO_PCA953X_IRQ
129 #include <linux/acpi.h>
130 #include <linux/dmi.h>
132 static const struct acpi_gpio_params pca953x_irq_gpios = { 0, 0, true };
134 static const struct acpi_gpio_mapping pca953x_acpi_irq_gpios[] = {
135 { "irq-gpios", &pca953x_irq_gpios, 1, ACPI_GPIO_QUIRK_ABSOLUTE_NUMBER },
139 static int pca953x_acpi_get_irq(struct device *dev)
143 ret = devm_acpi_dev_add_driver_gpios(dev, pca953x_acpi_irq_gpios);
145 dev_warn(dev, "can't add GPIO ACPI mapping\n");
147 ret = acpi_dev_gpio_irq_get_by(ACPI_COMPANION(dev), "irq-gpios", 0);
151 dev_info(dev, "ACPI interrupt quirk (IRQ %d)\n", ret);
155 static const struct dmi_system_id pca953x_dmi_acpi_irq_info[] = {
158 * On Intel Galileo Gen 2 board the IRQ pin of one of
159 * the I²C GPIO expanders, which has GpioInt() resource,
160 * is provided as an absolute number instead of being
161 * relative. Since first controller (gpio-sch.c) and
162 * second (gpio-dwapb.c) are at the fixed bases, we may
163 * safely refer to the number in the global space to get
167 DMI_EXACT_MATCH(DMI_BOARD_NAME, "GalileoGen2"),
174 static const struct acpi_device_id pca953x_acpi_ids[] = {
175 { "INT3491", 16 | PCA953X_TYPE | PCA_LATCH_INT, },
178 MODULE_DEVICE_TABLE(acpi, pca953x_acpi_ids);
182 #define MAX_LINE (MAX_BANK * BANK_SZ)
184 #define NBANK(chip) DIV_ROUND_UP(chip->gpio_chip.ngpio, BANK_SZ)
186 struct pca953x_reg_config {
193 static const struct pca953x_reg_config pca953x_regs = {
194 .direction = PCA953X_DIRECTION,
195 .output = PCA953X_OUTPUT,
196 .input = PCA953X_INPUT,
197 .invert = PCA953X_INVERT,
200 static const struct pca953x_reg_config pca957x_regs = {
201 .direction = PCA957X_CFG,
202 .output = PCA957X_OUT,
204 .invert = PCA957X_INVRT,
207 struct pca953x_chip {
209 struct mutex i2c_lock;
210 struct regmap *regmap;
212 #ifdef CONFIG_GPIO_PCA953X_IRQ
213 struct mutex irq_lock;
214 DECLARE_BITMAP(irq_mask, MAX_LINE);
215 DECLARE_BITMAP(irq_stat, MAX_LINE);
216 DECLARE_BITMAP(irq_trig_raise, MAX_LINE);
217 DECLARE_BITMAP(irq_trig_fall, MAX_LINE);
219 atomic_t wakeup_path;
221 struct i2c_client *client;
222 struct gpio_chip gpio_chip;
223 unsigned long driver_data;
224 struct regulator *regulator;
226 const struct pca953x_reg_config *regs;
228 u8 (*recalc_addr)(struct pca953x_chip *chip, int reg, int off);
229 bool (*check_reg)(struct pca953x_chip *chip, unsigned int reg,
233 static int pca953x_bank_shift(struct pca953x_chip *chip)
235 return fls((chip->gpio_chip.ngpio - 1) / BANK_SZ);
238 #define PCA953x_BANK_INPUT BIT(0)
239 #define PCA953x_BANK_OUTPUT BIT(1)
240 #define PCA953x_BANK_POLARITY BIT(2)
241 #define PCA953x_BANK_CONFIG BIT(3)
243 #define PCA957x_BANK_INPUT BIT(0)
244 #define PCA957x_BANK_POLARITY BIT(1)
245 #define PCA957x_BANK_BUSHOLD BIT(2)
246 #define PCA957x_BANK_CONFIG BIT(4)
247 #define PCA957x_BANK_OUTPUT BIT(5)
249 #define PCAL9xxx_BANK_IN_LATCH BIT(8 + 2)
250 #define PCAL9xxx_BANK_PULL_EN BIT(8 + 3)
251 #define PCAL9xxx_BANK_PULL_SEL BIT(8 + 4)
252 #define PCAL9xxx_BANK_IRQ_MASK BIT(8 + 5)
253 #define PCAL9xxx_BANK_IRQ_STAT BIT(8 + 6)
256 * We care about the following registers:
257 * - Standard set, below 0x40, each port can be replicated up to 8 times
259 * Input port 0x00 + 0 * bank_size R
260 * Output port 0x00 + 1 * bank_size RW
261 * Polarity Inversion port 0x00 + 2 * bank_size RW
262 * Configuration port 0x00 + 3 * bank_size RW
263 * - PCA957x with mixed up registers
264 * Input port 0x00 + 0 * bank_size R
265 * Polarity Inversion port 0x00 + 1 * bank_size RW
266 * Bus hold port 0x00 + 2 * bank_size RW
267 * Configuration port 0x00 + 4 * bank_size RW
268 * Output port 0x00 + 5 * bank_size RW
270 * - Extended set, above 0x40, often chip specific.
271 * - PCAL6524/PCAL9555A with custom PCAL IRQ handling:
272 * Input latch register 0x40 + 2 * bank_size RW
273 * Pull-up/pull-down enable reg 0x40 + 3 * bank_size RW
274 * Pull-up/pull-down select reg 0x40 + 4 * bank_size RW
275 * Interrupt mask register 0x40 + 5 * bank_size RW
276 * Interrupt status register 0x40 + 6 * bank_size R
278 * - Registers with bit 0x80 set, the AI bit
279 * The bit is cleared and the registers fall into one of the
283 static bool pca953x_check_register(struct pca953x_chip *chip, unsigned int reg,
286 int bank_shift = pca953x_bank_shift(chip);
287 int bank = (reg & REG_ADDR_MASK) >> bank_shift;
288 int offset = reg & (BIT(bank_shift) - 1);
290 /* Special PCAL extended register check. */
291 if (reg & REG_ADDR_EXT) {
292 if (!(chip->driver_data & PCA_PCAL))
297 /* Register is not in the matching bank. */
298 if (!(BIT(bank) & checkbank))
301 /* Register is not within allowed range of bank. */
302 if (offset >= NBANK(chip))
309 * Unfortunately, whilst the PCAL6534 chip (and compatibles) broadly follow the
310 * same register layout as the PCAL6524, the spacing of the registers has been
311 * fundamentally altered by compacting them and thus does not obey the same
312 * rules, including being able to use bit shifting to determine bank. These
313 * chips hence need special handling here.
315 static bool pcal6534_check_register(struct pca953x_chip *chip, unsigned int reg,
324 * Handle lack of reserved registers after output port
325 * configuration register to form a bank.
329 } else if (reg >= 0x30) {
331 * Reserved block between 14h and 2Fh does not align on
332 * expected bank boundaries like other devices.
340 bank = bank_shift + reg / NBANK(chip);
341 offset = reg % NBANK(chip);
343 /* Register is not in the matching bank. */
344 if (!(BIT(bank) & checkbank))
347 /* Register is not within allowed range of bank. */
348 if (offset >= NBANK(chip))
354 static bool pca953x_readable_register(struct device *dev, unsigned int reg)
356 struct pca953x_chip *chip = dev_get_drvdata(dev);
359 if (PCA_CHIP_TYPE(chip->driver_data) == PCA957X_TYPE) {
360 bank = PCA957x_BANK_INPUT | PCA957x_BANK_OUTPUT |
361 PCA957x_BANK_POLARITY | PCA957x_BANK_CONFIG |
362 PCA957x_BANK_BUSHOLD;
364 bank = PCA953x_BANK_INPUT | PCA953x_BANK_OUTPUT |
365 PCA953x_BANK_POLARITY | PCA953x_BANK_CONFIG;
368 if (chip->driver_data & PCA_PCAL) {
369 bank |= PCAL9xxx_BANK_IN_LATCH | PCAL9xxx_BANK_PULL_EN |
370 PCAL9xxx_BANK_PULL_SEL | PCAL9xxx_BANK_IRQ_MASK |
371 PCAL9xxx_BANK_IRQ_STAT;
374 return chip->check_reg(chip, reg, bank);
377 static bool pca953x_writeable_register(struct device *dev, unsigned int reg)
379 struct pca953x_chip *chip = dev_get_drvdata(dev);
382 if (PCA_CHIP_TYPE(chip->driver_data) == PCA957X_TYPE) {
383 bank = PCA957x_BANK_OUTPUT | PCA957x_BANK_POLARITY |
384 PCA957x_BANK_CONFIG | PCA957x_BANK_BUSHOLD;
386 bank = PCA953x_BANK_OUTPUT | PCA953x_BANK_POLARITY |
390 if (chip->driver_data & PCA_PCAL)
391 bank |= PCAL9xxx_BANK_IN_LATCH | PCAL9xxx_BANK_PULL_EN |
392 PCAL9xxx_BANK_PULL_SEL | PCAL9xxx_BANK_IRQ_MASK;
394 return chip->check_reg(chip, reg, bank);
397 static bool pca953x_volatile_register(struct device *dev, unsigned int reg)
399 struct pca953x_chip *chip = dev_get_drvdata(dev);
402 if (PCA_CHIP_TYPE(chip->driver_data) == PCA957X_TYPE)
403 bank = PCA957x_BANK_INPUT;
405 bank = PCA953x_BANK_INPUT;
407 if (chip->driver_data & PCA_PCAL)
408 bank |= PCAL9xxx_BANK_IRQ_STAT;
410 return chip->check_reg(chip, reg, bank);
413 static const struct regmap_config pca953x_i2c_regmap = {
417 .use_single_read = true,
418 .use_single_write = true,
420 .readable_reg = pca953x_readable_register,
421 .writeable_reg = pca953x_writeable_register,
422 .volatile_reg = pca953x_volatile_register,
424 .disable_locking = true,
425 .cache_type = REGCACHE_MAPLE,
426 .max_register = 0x7f,
429 static const struct regmap_config pca953x_ai_i2c_regmap = {
433 .read_flag_mask = REG_ADDR_AI,
434 .write_flag_mask = REG_ADDR_AI,
436 .readable_reg = pca953x_readable_register,
437 .writeable_reg = pca953x_writeable_register,
438 .volatile_reg = pca953x_volatile_register,
440 .disable_locking = true,
441 .cache_type = REGCACHE_MAPLE,
442 .max_register = 0x7f,
445 static u8 pca953x_recalc_addr(struct pca953x_chip *chip, int reg, int off)
447 int bank_shift = pca953x_bank_shift(chip);
448 int addr = (reg & PCAL_GPIO_MASK) << bank_shift;
449 int pinctrl = (reg & PCAL_PINCTRL_MASK) << 1;
450 u8 regaddr = pinctrl | addr | (off / BANK_SZ);
456 * The PCAL6534 and compatible chips have altered bank alignment that doesn't
457 * fit within the bit shifting scheme used for other devices.
459 static u8 pcal6534_recalc_addr(struct pca953x_chip *chip, int reg, int off)
464 addr = (reg & PCAL_GPIO_MASK) * NBANK(chip);
467 case PCAL953X_OUT_STRENGTH:
468 case PCAL953X_IN_LATCH:
469 case PCAL953X_PULL_EN:
470 case PCAL953X_PULL_SEL:
471 case PCAL953X_INT_MASK:
472 case PCAL953X_INT_STAT:
473 pinctrl = ((reg & PCAL_PINCTRL_MASK) >> 1) + 0x20;
475 case PCAL6524_INT_EDGE:
476 case PCAL6524_INT_CLR:
477 case PCAL6524_IN_STATUS:
478 case PCAL6524_OUT_INDCONF:
479 case PCAL6524_DEBOUNCE:
480 pinctrl = ((reg & PCAL_PINCTRL_MASK) >> 1) + 0x1c;
487 return pinctrl + addr + (off / BANK_SZ);
490 static int pca953x_write_regs(struct pca953x_chip *chip, int reg, unsigned long *val)
492 u8 regaddr = chip->recalc_addr(chip, reg, 0);
496 for (i = 0; i < NBANK(chip); i++)
497 value[i] = bitmap_get_value8(val, i * BANK_SZ);
499 ret = regmap_bulk_write(chip->regmap, regaddr, value, NBANK(chip));
501 dev_err(&chip->client->dev, "failed writing register\n");
508 static int pca953x_read_regs(struct pca953x_chip *chip, int reg, unsigned long *val)
510 u8 regaddr = chip->recalc_addr(chip, reg, 0);
514 ret = regmap_bulk_read(chip->regmap, regaddr, value, NBANK(chip));
516 dev_err(&chip->client->dev, "failed reading register\n");
520 for (i = 0; i < NBANK(chip); i++)
521 bitmap_set_value8(val, value[i], i * BANK_SZ);
526 static int pca953x_gpio_direction_input(struct gpio_chip *gc, unsigned off)
528 struct pca953x_chip *chip = gpiochip_get_data(gc);
529 u8 dirreg = chip->recalc_addr(chip, chip->regs->direction, off);
530 u8 bit = BIT(off % BANK_SZ);
532 guard(mutex)(&chip->i2c_lock);
534 return regmap_write_bits(chip->regmap, dirreg, bit, bit);
537 static int pca953x_gpio_direction_output(struct gpio_chip *gc,
538 unsigned off, int val)
540 struct pca953x_chip *chip = gpiochip_get_data(gc);
541 u8 dirreg = chip->recalc_addr(chip, chip->regs->direction, off);
542 u8 outreg = chip->recalc_addr(chip, chip->regs->output, off);
543 u8 bit = BIT(off % BANK_SZ);
546 guard(mutex)(&chip->i2c_lock);
548 /* set output level */
549 ret = regmap_write_bits(chip->regmap, outreg, bit, val ? bit : 0);
554 return regmap_write_bits(chip->regmap, dirreg, bit, 0);
557 static int pca953x_gpio_get_value(struct gpio_chip *gc, unsigned off)
559 struct pca953x_chip *chip = gpiochip_get_data(gc);
560 u8 inreg = chip->recalc_addr(chip, chip->regs->input, off);
561 u8 bit = BIT(off % BANK_SZ);
565 scoped_guard(mutex, &chip->i2c_lock)
566 ret = regmap_read(chip->regmap, inreg, ®_val);
570 return !!(reg_val & bit);
573 static void pca953x_gpio_set_value(struct gpio_chip *gc, unsigned off, int val)
575 struct pca953x_chip *chip = gpiochip_get_data(gc);
576 u8 outreg = chip->recalc_addr(chip, chip->regs->output, off);
577 u8 bit = BIT(off % BANK_SZ);
579 guard(mutex)(&chip->i2c_lock);
581 regmap_write_bits(chip->regmap, outreg, bit, val ? bit : 0);
584 static int pca953x_gpio_get_direction(struct gpio_chip *gc, unsigned off)
586 struct pca953x_chip *chip = gpiochip_get_data(gc);
587 u8 dirreg = chip->recalc_addr(chip, chip->regs->direction, off);
588 u8 bit = BIT(off % BANK_SZ);
592 scoped_guard(mutex, &chip->i2c_lock)
593 ret = regmap_read(chip->regmap, dirreg, ®_val);
598 return GPIO_LINE_DIRECTION_IN;
600 return GPIO_LINE_DIRECTION_OUT;
603 static int pca953x_gpio_get_multiple(struct gpio_chip *gc,
604 unsigned long *mask, unsigned long *bits)
606 struct pca953x_chip *chip = gpiochip_get_data(gc);
607 DECLARE_BITMAP(reg_val, MAX_LINE);
610 scoped_guard(mutex, &chip->i2c_lock)
611 ret = pca953x_read_regs(chip, chip->regs->input, reg_val);
615 bitmap_replace(bits, bits, reg_val, mask, gc->ngpio);
619 static void pca953x_gpio_set_multiple(struct gpio_chip *gc,
620 unsigned long *mask, unsigned long *bits)
622 struct pca953x_chip *chip = gpiochip_get_data(gc);
623 DECLARE_BITMAP(reg_val, MAX_LINE);
626 guard(mutex)(&chip->i2c_lock);
628 ret = pca953x_read_regs(chip, chip->regs->output, reg_val);
632 bitmap_replace(reg_val, reg_val, bits, mask, gc->ngpio);
634 pca953x_write_regs(chip, chip->regs->output, reg_val);
637 static int pca953x_gpio_set_pull_up_down(struct pca953x_chip *chip,
639 unsigned long config)
641 enum pin_config_param param = pinconf_to_config_param(config);
642 u8 pull_en_reg = chip->recalc_addr(chip, PCAL953X_PULL_EN, offset);
643 u8 pull_sel_reg = chip->recalc_addr(chip, PCAL953X_PULL_SEL, offset);
644 u8 bit = BIT(offset % BANK_SZ);
648 * pull-up/pull-down configuration requires PCAL extended
651 if (!(chip->driver_data & PCA_PCAL))
654 guard(mutex)(&chip->i2c_lock);
656 /* Configure pull-up/pull-down */
657 if (param == PIN_CONFIG_BIAS_PULL_UP)
658 ret = regmap_write_bits(chip->regmap, pull_sel_reg, bit, bit);
659 else if (param == PIN_CONFIG_BIAS_PULL_DOWN)
660 ret = regmap_write_bits(chip->regmap, pull_sel_reg, bit, 0);
666 /* Disable/Enable pull-up/pull-down */
667 if (param == PIN_CONFIG_BIAS_DISABLE)
668 return regmap_write_bits(chip->regmap, pull_en_reg, bit, 0);
670 return regmap_write_bits(chip->regmap, pull_en_reg, bit, bit);
673 static int pca953x_gpio_set_config(struct gpio_chip *gc, unsigned int offset,
674 unsigned long config)
676 struct pca953x_chip *chip = gpiochip_get_data(gc);
678 switch (pinconf_to_config_param(config)) {
679 case PIN_CONFIG_BIAS_PULL_UP:
680 case PIN_CONFIG_BIAS_PULL_PIN_DEFAULT:
681 case PIN_CONFIG_BIAS_PULL_DOWN:
682 case PIN_CONFIG_BIAS_DISABLE:
683 return pca953x_gpio_set_pull_up_down(chip, offset, config);
689 static void pca953x_setup_gpio(struct pca953x_chip *chip, int gpios)
691 struct gpio_chip *gc = &chip->gpio_chip;
693 gc->direction_input = pca953x_gpio_direction_input;
694 gc->direction_output = pca953x_gpio_direction_output;
695 gc->get = pca953x_gpio_get_value;
696 gc->set = pca953x_gpio_set_value;
697 gc->get_direction = pca953x_gpio_get_direction;
698 gc->get_multiple = pca953x_gpio_get_multiple;
699 gc->set_multiple = pca953x_gpio_set_multiple;
700 gc->set_config = pca953x_gpio_set_config;
701 gc->can_sleep = true;
703 gc->base = chip->gpio_start;
705 gc->label = dev_name(&chip->client->dev);
706 gc->parent = &chip->client->dev;
707 gc->owner = THIS_MODULE;
710 #ifdef CONFIG_GPIO_PCA953X_IRQ
711 static void pca953x_irq_mask(struct irq_data *d)
713 struct gpio_chip *gc = irq_data_get_irq_chip_data(d);
714 struct pca953x_chip *chip = gpiochip_get_data(gc);
715 irq_hw_number_t hwirq = irqd_to_hwirq(d);
717 clear_bit(hwirq, chip->irq_mask);
718 gpiochip_disable_irq(gc, hwirq);
721 static void pca953x_irq_unmask(struct irq_data *d)
723 struct gpio_chip *gc = irq_data_get_irq_chip_data(d);
724 struct pca953x_chip *chip = gpiochip_get_data(gc);
725 irq_hw_number_t hwirq = irqd_to_hwirq(d);
727 gpiochip_enable_irq(gc, hwirq);
728 set_bit(hwirq, chip->irq_mask);
731 static int pca953x_irq_set_wake(struct irq_data *d, unsigned int on)
733 struct gpio_chip *gc = irq_data_get_irq_chip_data(d);
734 struct pca953x_chip *chip = gpiochip_get_data(gc);
737 atomic_inc(&chip->wakeup_path);
739 atomic_dec(&chip->wakeup_path);
741 return irq_set_irq_wake(chip->client->irq, on);
744 static void pca953x_irq_bus_lock(struct irq_data *d)
746 struct gpio_chip *gc = irq_data_get_irq_chip_data(d);
747 struct pca953x_chip *chip = gpiochip_get_data(gc);
749 mutex_lock(&chip->irq_lock);
752 static void pca953x_irq_bus_sync_unlock(struct irq_data *d)
754 struct gpio_chip *gc = irq_data_get_irq_chip_data(d);
755 struct pca953x_chip *chip = gpiochip_get_data(gc);
756 DECLARE_BITMAP(irq_mask, MAX_LINE);
757 DECLARE_BITMAP(reg_direction, MAX_LINE);
760 if (chip->driver_data & PCA_PCAL) {
761 /* Enable latch on interrupt-enabled inputs */
762 pca953x_write_regs(chip, PCAL953X_IN_LATCH, chip->irq_mask);
764 bitmap_complement(irq_mask, chip->irq_mask, gc->ngpio);
766 /* Unmask enabled interrupts */
767 pca953x_write_regs(chip, PCAL953X_INT_MASK, irq_mask);
770 /* Switch direction to input if needed */
771 pca953x_read_regs(chip, chip->regs->direction, reg_direction);
773 bitmap_or(irq_mask, chip->irq_trig_fall, chip->irq_trig_raise, gc->ngpio);
774 bitmap_complement(reg_direction, reg_direction, gc->ngpio);
775 bitmap_and(irq_mask, irq_mask, reg_direction, gc->ngpio);
777 /* Look for any newly setup interrupt */
778 for_each_set_bit(level, irq_mask, gc->ngpio)
779 pca953x_gpio_direction_input(&chip->gpio_chip, level);
781 mutex_unlock(&chip->irq_lock);
784 static int pca953x_irq_set_type(struct irq_data *d, unsigned int type)
786 struct gpio_chip *gc = irq_data_get_irq_chip_data(d);
787 struct pca953x_chip *chip = gpiochip_get_data(gc);
788 struct device *dev = &chip->client->dev;
789 irq_hw_number_t hwirq = irqd_to_hwirq(d);
791 if (!(type & IRQ_TYPE_EDGE_BOTH)) {
792 dev_err(dev, "irq %d: unsupported type %d\n", d->irq, type);
796 assign_bit(hwirq, chip->irq_trig_fall, type & IRQ_TYPE_EDGE_FALLING);
797 assign_bit(hwirq, chip->irq_trig_raise, type & IRQ_TYPE_EDGE_RISING);
802 static void pca953x_irq_shutdown(struct irq_data *d)
804 struct gpio_chip *gc = irq_data_get_irq_chip_data(d);
805 struct pca953x_chip *chip = gpiochip_get_data(gc);
806 irq_hw_number_t hwirq = irqd_to_hwirq(d);
808 clear_bit(hwirq, chip->irq_trig_raise);
809 clear_bit(hwirq, chip->irq_trig_fall);
812 static void pca953x_irq_print_chip(struct irq_data *data, struct seq_file *p)
814 struct gpio_chip *gc = irq_data_get_irq_chip_data(data);
816 seq_printf(p, dev_name(gc->parent));
819 static const struct irq_chip pca953x_irq_chip = {
820 .irq_mask = pca953x_irq_mask,
821 .irq_unmask = pca953x_irq_unmask,
822 .irq_set_wake = pca953x_irq_set_wake,
823 .irq_bus_lock = pca953x_irq_bus_lock,
824 .irq_bus_sync_unlock = pca953x_irq_bus_sync_unlock,
825 .irq_set_type = pca953x_irq_set_type,
826 .irq_shutdown = pca953x_irq_shutdown,
827 .irq_print_chip = pca953x_irq_print_chip,
828 .flags = IRQCHIP_IMMUTABLE,
829 GPIOCHIP_IRQ_RESOURCE_HELPERS,
832 static bool pca953x_irq_pending(struct pca953x_chip *chip, unsigned long *pending)
834 struct gpio_chip *gc = &chip->gpio_chip;
835 DECLARE_BITMAP(reg_direction, MAX_LINE);
836 DECLARE_BITMAP(old_stat, MAX_LINE);
837 DECLARE_BITMAP(cur_stat, MAX_LINE);
838 DECLARE_BITMAP(new_stat, MAX_LINE);
839 DECLARE_BITMAP(trigger, MAX_LINE);
842 if (chip->driver_data & PCA_PCAL) {
843 /* Read the current interrupt status from the device */
844 ret = pca953x_read_regs(chip, PCAL953X_INT_STAT, trigger);
848 /* Check latched inputs and clear interrupt status */
849 ret = pca953x_read_regs(chip, chip->regs->input, cur_stat);
853 /* Apply filter for rising/falling edge selection */
854 bitmap_replace(new_stat, chip->irq_trig_fall, chip->irq_trig_raise, cur_stat, gc->ngpio);
856 bitmap_and(pending, new_stat, trigger, gc->ngpio);
858 return !bitmap_empty(pending, gc->ngpio);
861 ret = pca953x_read_regs(chip, chip->regs->input, cur_stat);
865 /* Remove output pins from the equation */
866 pca953x_read_regs(chip, chip->regs->direction, reg_direction);
868 bitmap_copy(old_stat, chip->irq_stat, gc->ngpio);
870 bitmap_and(new_stat, cur_stat, reg_direction, gc->ngpio);
871 bitmap_xor(cur_stat, new_stat, old_stat, gc->ngpio);
872 bitmap_and(trigger, cur_stat, chip->irq_mask, gc->ngpio);
874 bitmap_copy(chip->irq_stat, new_stat, gc->ngpio);
876 if (bitmap_empty(trigger, gc->ngpio))
879 bitmap_and(cur_stat, chip->irq_trig_fall, old_stat, gc->ngpio);
880 bitmap_and(old_stat, chip->irq_trig_raise, new_stat, gc->ngpio);
881 bitmap_or(new_stat, old_stat, cur_stat, gc->ngpio);
882 bitmap_and(pending, new_stat, trigger, gc->ngpio);
884 return !bitmap_empty(pending, gc->ngpio);
887 static irqreturn_t pca953x_irq_handler(int irq, void *devid)
889 struct pca953x_chip *chip = devid;
890 struct gpio_chip *gc = &chip->gpio_chip;
891 DECLARE_BITMAP(pending, MAX_LINE);
895 bitmap_zero(pending, MAX_LINE);
897 scoped_guard(mutex, &chip->i2c_lock)
898 ret = pca953x_irq_pending(chip, pending);
902 for_each_set_bit(level, pending, gc->ngpio) {
903 int nested_irq = irq_find_mapping(gc->irq.domain, level);
905 if (unlikely(nested_irq <= 0)) {
906 dev_warn_ratelimited(gc->parent, "unmapped interrupt %d\n", level);
910 handle_nested_irq(nested_irq);
915 return IRQ_RETVAL(ret);
918 static int pca953x_irq_setup(struct pca953x_chip *chip, int irq_base)
920 struct i2c_client *client = chip->client;
921 struct device *dev = &client->dev;
922 DECLARE_BITMAP(reg_direction, MAX_LINE);
923 DECLARE_BITMAP(irq_stat, MAX_LINE);
924 struct gpio_chip *gc = &chip->gpio_chip;
925 struct gpio_irq_chip *girq;
928 if (dmi_first_match(pca953x_dmi_acpi_irq_info)) {
929 ret = pca953x_acpi_get_irq(dev);
940 if (!(chip->driver_data & PCA_INT))
943 ret = pca953x_read_regs(chip, chip->regs->input, irq_stat);
948 * There is no way to know which GPIO line generated the
949 * interrupt. We have to rely on the previous read for
952 pca953x_read_regs(chip, chip->regs->direction, reg_direction);
953 bitmap_and(chip->irq_stat, irq_stat, reg_direction, gc->ngpio);
954 mutex_init(&chip->irq_lock);
956 girq = &chip->gpio_chip.irq;
957 gpio_irq_chip_set_chip(girq, &pca953x_irq_chip);
958 /* This will let us handle the parent IRQ in the driver */
959 girq->parent_handler = NULL;
960 girq->num_parents = 0;
961 girq->parents = NULL;
962 girq->default_type = IRQ_TYPE_NONE;
963 girq->handler = handle_simple_irq;
964 girq->threaded = true;
965 girq->first = irq_base; /* FIXME: get rid of this */
967 ret = devm_request_threaded_irq(dev, client->irq, NULL, pca953x_irq_handler,
968 IRQF_ONESHOT | IRQF_SHARED, dev_name(dev),
971 return dev_err_probe(dev, client->irq, "failed to request irq\n");
976 #else /* CONFIG_GPIO_PCA953X_IRQ */
977 static int pca953x_irq_setup(struct pca953x_chip *chip, int irq_base)
979 struct i2c_client *client = chip->client;
980 struct device *dev = &client->dev;
982 if (client->irq && irq_base != -1 && (chip->driver_data & PCA_INT))
983 dev_warn(dev, "interrupt support not compiled in\n");
989 static int device_pca95xx_init(struct pca953x_chip *chip)
991 DECLARE_BITMAP(val, MAX_LINE);
995 regaddr = chip->recalc_addr(chip, chip->regs->output, 0);
996 ret = regcache_sync_region(chip->regmap, regaddr,
997 regaddr + NBANK(chip) - 1);
1001 regaddr = chip->recalc_addr(chip, chip->regs->direction, 0);
1002 ret = regcache_sync_region(chip->regmap, regaddr,
1003 regaddr + NBANK(chip) - 1);
1007 /* clear polarity inversion */
1008 bitmap_zero(val, MAX_LINE);
1010 return pca953x_write_regs(chip, chip->regs->invert, val);
1013 static int device_pca957x_init(struct pca953x_chip *chip)
1015 DECLARE_BITMAP(val, MAX_LINE);
1019 ret = device_pca95xx_init(chip);
1023 /* To enable register 6, 7 to control pull up and pull down */
1024 for (i = 0; i < NBANK(chip); i++)
1025 bitmap_set_value8(val, 0x02, i * BANK_SZ);
1027 return pca953x_write_regs(chip, PCA957X_BKEN, val);
1030 static void pca953x_disable_regulator(void *reg)
1032 regulator_disable(reg);
1035 static int pca953x_get_and_enable_regulator(struct pca953x_chip *chip)
1037 struct device *dev = &chip->client->dev;
1038 struct regulator *reg = chip->regulator;
1041 reg = devm_regulator_get(dev, "vcc");
1043 return dev_err_probe(dev, PTR_ERR(reg), "reg get err\n");
1045 ret = regulator_enable(reg);
1047 return dev_err_probe(dev, ret, "reg en err\n");
1049 ret = devm_add_action_or_reset(dev, pca953x_disable_regulator, reg);
1053 chip->regulator = reg;
1057 static int pca953x_probe(struct i2c_client *client)
1059 struct device *dev = &client->dev;
1060 struct pca953x_platform_data *pdata;
1061 struct pca953x_chip *chip;
1064 const struct regmap_config *regmap_config;
1066 chip = devm_kzalloc(dev, sizeof(*chip), GFP_KERNEL);
1070 pdata = dev_get_platdata(dev);
1072 irq_base = pdata->irq_base;
1073 chip->gpio_start = pdata->gpio_base;
1075 struct gpio_desc *reset_gpio;
1077 chip->gpio_start = -1;
1081 * See if we need to de-assert a reset pin.
1083 * There is no known ACPI-enabled platforms that are
1084 * using "reset" GPIO. Otherwise any of those platform
1085 * must use _DSD method with corresponding property.
1087 reset_gpio = devm_gpiod_get_optional(dev, "reset", GPIOD_OUT_LOW);
1088 if (IS_ERR(reset_gpio))
1089 return PTR_ERR(reset_gpio);
1092 chip->client = client;
1093 chip->driver_data = (uintptr_t)i2c_get_match_data(client);
1094 if (!chip->driver_data)
1097 ret = pca953x_get_and_enable_regulator(chip);
1101 i2c_set_clientdata(client, chip);
1103 pca953x_setup_gpio(chip, chip->driver_data & PCA_GPIO_MASK);
1105 if (NBANK(chip) > 2 || PCA_CHIP_TYPE(chip->driver_data) == PCA957X_TYPE) {
1106 dev_info(dev, "using AI\n");
1107 regmap_config = &pca953x_ai_i2c_regmap;
1109 dev_info(dev, "using no AI\n");
1110 regmap_config = &pca953x_i2c_regmap;
1113 if (PCA_CHIP_TYPE(chip->driver_data) == PCAL653X_TYPE) {
1114 chip->recalc_addr = pcal6534_recalc_addr;
1115 chip->check_reg = pcal6534_check_register;
1117 chip->recalc_addr = pca953x_recalc_addr;
1118 chip->check_reg = pca953x_check_register;
1121 chip->regmap = devm_regmap_init_i2c(client, regmap_config);
1122 if (IS_ERR(chip->regmap))
1123 return PTR_ERR(chip->regmap);
1125 regcache_mark_dirty(chip->regmap);
1127 mutex_init(&chip->i2c_lock);
1129 * In case we have an i2c-mux controlled by a GPIO provided by an
1130 * expander using the same driver higher on the device tree, read the
1131 * i2c adapter nesting depth and use the retrieved value as lockdep
1132 * subclass for chip->i2c_lock.
1134 * REVISIT: This solution is not complete. It protects us from lockdep
1135 * false positives when the expander controlling the i2c-mux is on
1136 * a different level on the device tree, but not when it's on the same
1137 * level on a different branch (in which case the subclass number
1138 * would be the same).
1140 * TODO: Once a correct solution is developed, a similar fix should be
1141 * applied to all other i2c-controlled GPIO expanders (and potentially
1144 lockdep_set_subclass(&chip->i2c_lock,
1145 i2c_adapter_depth(client->adapter));
1147 /* initialize cached registers from their original values.
1148 * we can't share this chip with another i2c master.
1150 if (PCA_CHIP_TYPE(chip->driver_data) == PCA957X_TYPE) {
1151 chip->regs = &pca957x_regs;
1152 ret = device_pca957x_init(chip);
1154 chip->regs = &pca953x_regs;
1155 ret = device_pca95xx_init(chip);
1160 ret = pca953x_irq_setup(chip, irq_base);
1164 return devm_gpiochip_add_data(dev, &chip->gpio_chip, chip);
1167 static int pca953x_regcache_sync(struct pca953x_chip *chip)
1169 struct device *dev = &chip->client->dev;
1174 * The ordering between direction and output is important,
1175 * sync these registers first and only then sync the rest.
1177 regaddr = chip->recalc_addr(chip, chip->regs->direction, 0);
1178 ret = regcache_sync_region(chip->regmap, regaddr, regaddr + NBANK(chip) - 1);
1180 dev_err(dev, "Failed to sync GPIO dir registers: %d\n", ret);
1184 regaddr = chip->recalc_addr(chip, chip->regs->output, 0);
1185 ret = regcache_sync_region(chip->regmap, regaddr, regaddr + NBANK(chip) - 1);
1187 dev_err(dev, "Failed to sync GPIO out registers: %d\n", ret);
1191 #ifdef CONFIG_GPIO_PCA953X_IRQ
1192 if (chip->driver_data & PCA_PCAL) {
1193 regaddr = chip->recalc_addr(chip, PCAL953X_IN_LATCH, 0);
1194 ret = regcache_sync_region(chip->regmap, regaddr,
1195 regaddr + NBANK(chip) - 1);
1197 dev_err(dev, "Failed to sync INT latch registers: %d\n",
1202 regaddr = chip->recalc_addr(chip, PCAL953X_INT_MASK, 0);
1203 ret = regcache_sync_region(chip->regmap, regaddr,
1204 regaddr + NBANK(chip) - 1);
1206 dev_err(dev, "Failed to sync INT mask registers: %d\n",
1216 static int pca953x_restore_context(struct pca953x_chip *chip)
1220 guard(mutex)(&chip->i2c_lock);
1222 regcache_cache_only(chip->regmap, false);
1223 regcache_mark_dirty(chip->regmap);
1224 ret = pca953x_regcache_sync(chip);
1228 return regcache_sync(chip->regmap);
1231 static void pca953x_save_context(struct pca953x_chip *chip)
1233 guard(mutex)(&chip->i2c_lock);
1234 regcache_cache_only(chip->regmap, true);
1237 static int pca953x_suspend(struct device *dev)
1239 struct pca953x_chip *chip = dev_get_drvdata(dev);
1241 pca953x_save_context(chip);
1243 if (atomic_read(&chip->wakeup_path))
1244 device_set_wakeup_path(dev);
1246 regulator_disable(chip->regulator);
1251 static int pca953x_resume(struct device *dev)
1253 struct pca953x_chip *chip = dev_get_drvdata(dev);
1256 if (!atomic_read(&chip->wakeup_path)) {
1257 ret = regulator_enable(chip->regulator);
1259 dev_err(dev, "Failed to enable regulator: %d\n", ret);
1264 ret = pca953x_restore_context(chip);
1266 dev_err(dev, "Failed to restore register map: %d\n", ret);
1271 static DEFINE_SIMPLE_DEV_PM_OPS(pca953x_pm_ops, pca953x_suspend, pca953x_resume);
1273 /* convenience to stop overlong match-table lines */
1274 #define OF_653X(__nrgpio, __int) ((void *)(__nrgpio | PCAL653X_TYPE | __int))
1275 #define OF_953X(__nrgpio, __int) (void *)(__nrgpio | PCA953X_TYPE | __int)
1276 #define OF_957X(__nrgpio, __int) (void *)(__nrgpio | PCA957X_TYPE | __int)
1278 static const struct of_device_id pca953x_dt_ids[] = {
1279 { .compatible = "nxp,pca6408", .data = OF_953X(8, PCA_INT), },
1280 { .compatible = "nxp,pca6416", .data = OF_953X(16, PCA_INT), },
1281 { .compatible = "nxp,pca9505", .data = OF_953X(40, PCA_INT), },
1282 { .compatible = "nxp,pca9506", .data = OF_953X(40, PCA_INT), },
1283 { .compatible = "nxp,pca9534", .data = OF_953X( 8, PCA_INT), },
1284 { .compatible = "nxp,pca9535", .data = OF_953X(16, PCA_INT), },
1285 { .compatible = "nxp,pca9536", .data = OF_953X( 4, 0), },
1286 { .compatible = "nxp,pca9537", .data = OF_953X( 4, PCA_INT), },
1287 { .compatible = "nxp,pca9538", .data = OF_953X( 8, PCA_INT), },
1288 { .compatible = "nxp,pca9539", .data = OF_953X(16, PCA_INT), },
1289 { .compatible = "nxp,pca9554", .data = OF_953X( 8, PCA_INT), },
1290 { .compatible = "nxp,pca9555", .data = OF_953X(16, PCA_INT), },
1291 { .compatible = "nxp,pca9556", .data = OF_953X( 8, 0), },
1292 { .compatible = "nxp,pca9557", .data = OF_953X( 8, 0), },
1293 { .compatible = "nxp,pca9574", .data = OF_957X( 8, PCA_INT), },
1294 { .compatible = "nxp,pca9575", .data = OF_957X(16, PCA_INT), },
1295 { .compatible = "nxp,pca9698", .data = OF_953X(40, 0), },
1297 { .compatible = "nxp,pcal6408", .data = OF_953X(8, PCA_LATCH_INT), },
1298 { .compatible = "nxp,pcal6416", .data = OF_953X(16, PCA_LATCH_INT), },
1299 { .compatible = "nxp,pcal6524", .data = OF_953X(24, PCA_LATCH_INT), },
1300 { .compatible = "nxp,pcal6534", .data = OF_653X(34, PCA_LATCH_INT), },
1301 { .compatible = "nxp,pcal9535", .data = OF_953X(16, PCA_LATCH_INT), },
1302 { .compatible = "nxp,pcal9554b", .data = OF_953X( 8, PCA_LATCH_INT), },
1303 { .compatible = "nxp,pcal9555a", .data = OF_953X(16, PCA_LATCH_INT), },
1305 { .compatible = "maxim,max7310", .data = OF_953X( 8, 0), },
1306 { .compatible = "maxim,max7312", .data = OF_953X(16, PCA_INT), },
1307 { .compatible = "maxim,max7313", .data = OF_953X(16, PCA_INT), },
1308 { .compatible = "maxim,max7315", .data = OF_953X( 8, PCA_INT), },
1309 { .compatible = "maxim,max7318", .data = OF_953X(16, PCA_INT), },
1311 { .compatible = "ti,pca6107", .data = OF_953X( 8, PCA_INT), },
1312 { .compatible = "ti,pca9536", .data = OF_953X( 4, 0), },
1313 { .compatible = "ti,tca6408", .data = OF_953X( 8, PCA_INT), },
1314 { .compatible = "ti,tca6416", .data = OF_953X(16, PCA_INT), },
1315 { .compatible = "ti,tca6424", .data = OF_953X(24, PCA_INT), },
1316 { .compatible = "ti,tca9538", .data = OF_953X( 8, PCA_INT), },
1317 { .compatible = "ti,tca9539", .data = OF_953X(16, PCA_INT), },
1319 { .compatible = "onnn,cat9554", .data = OF_953X( 8, PCA_INT), },
1320 { .compatible = "onnn,pca9654", .data = OF_953X( 8, PCA_INT), },
1321 { .compatible = "onnn,pca9655", .data = OF_953X(16, PCA_INT), },
1323 { .compatible = "exar,xra1202", .data = OF_953X( 8, 0), },
1327 MODULE_DEVICE_TABLE(of, pca953x_dt_ids);
1329 static struct i2c_driver pca953x_driver = {
1332 .pm = pm_sleep_ptr(&pca953x_pm_ops),
1333 .of_match_table = pca953x_dt_ids,
1334 .acpi_match_table = pca953x_acpi_ids,
1336 .probe = pca953x_probe,
1337 .id_table = pca953x_id,
1340 static int __init pca953x_init(void)
1342 return i2c_add_driver(&pca953x_driver);
1344 /* register after i2c postcore initcall and before
1345 * subsys initcalls that may rely on these GPIOs
1347 subsys_initcall(pca953x_init);
1349 static void __exit pca953x_exit(void)
1351 i2c_del_driver(&pca953x_driver);
1353 module_exit(pca953x_exit);
1356 MODULE_DESCRIPTION("GPIO expander driver for PCA953x");
1357 MODULE_LICENSE("GPL");