2 * MAX732x I2C Port Expander with 8/16 I/O
4 * Copyright (C) 2007 Marvell International Ltd.
5 * Copyright (C) 2008 Jack Ren <jack.ren@marvell.com>
6 * Copyright (C) 2008 Eric Miao <eric.miao@marvell.com>
8 * Derived from drivers/gpio/pca953x.c
10 * This program is free software; you can redistribute it and/or modify
11 * it under the terms of the GNU General Public License as published by
12 * the Free Software Foundation; version 2 of the License.
15 #include <linux/module.h>
16 #include <linux/init.h>
17 #include <linux/slab.h>
18 #include <linux/string.h>
19 #include <linux/gpio.h>
20 #include <linux/interrupt.h>
21 #include <linux/irq.h>
22 #include <linux/irqdomain.h>
23 #include <linux/i2c.h>
24 #include <linux/i2c/max732x.h>
29 * Each port of MAX732x (including MAX7319) falls into one of the
30 * following three types:
36 * designated by 'O', 'I' and 'P' individually according to MAXIM's
37 * datasheets. 'I' and 'P' ports are interrupt capables, some with
38 * a dedicated interrupt mask.
40 * There are two groups of I/O ports, each group usually includes
41 * up to 8 I/O ports, and is accessed by a specific I2C address:
43 * - Group A : by I2C address 0b'110xxxx
44 * - Group B : by I2C address 0b'101xxxx
46 * where 'xxxx' is decided by the connections of pin AD2/AD0. The
47 * address used also affects the initial state of output signals.
49 * Within each group of ports, there are five known combinations of
50 * I/O ports: 4I4O, 4P4O, 8I, 8P, 8O, see the definitions below for
51 * the detailed organization of these ports. Only Goup A is interrupt
54 * GPIO numbers start from 'gpio_base + 0' to 'gpio_base + 8/16',
55 * and GPIOs from GROUP_A are numbered before those from GROUP_B
56 * (if there are two groups).
58 * NOTE: MAX7328/MAX7329 are drop-in replacements for PCF8574/a, so
59 * they are not supported by this driver.
62 #define PORT_NONE 0x0 /* '/' No Port */
63 #define PORT_OUTPUT 0x1 /* 'O' Push-Pull, Output Only */
64 #define PORT_INPUT 0x2 /* 'I' Input Only */
65 #define PORT_OPENDRAIN 0x3 /* 'P' Open-Drain, I/O */
67 #define IO_4I4O 0x5AA5 /* O7 O6 I5 I4 I3 I2 O1 O0 */
68 #define IO_4P4O 0x5FF5 /* O7 O6 P5 P4 P3 P2 O1 O0 */
69 #define IO_8I 0xAAAA /* I7 I6 I5 I4 I3 I2 I1 I0 */
70 #define IO_8P 0xFFFF /* P7 P6 P5 P4 P3 P2 P1 P0 */
71 #define IO_8O 0x5555 /* O7 O6 O5 O4 O3 O2 O1 O0 */
73 #define GROUP_A(x) ((x) & 0xffff) /* I2C Addr: 0b'110xxxx */
74 #define GROUP_B(x) ((x) << 16) /* I2C Addr: 0b'101xxxx */
76 #define INT_NONE 0x0 /* No interrupt capability */
77 #define INT_NO_MASK 0x1 /* Has interrupts, no mask */
78 #define INT_INDEP_MASK 0x2 /* Has interrupts, independent mask */
79 #define INT_MERGED_MASK 0x3 /* Has interrupts, merged mask */
81 #define INT_CAPS(x) (((uint64_t)(x)) << 32)
95 static uint64_t max732x_features
[] = {
96 [MAX7319
] = GROUP_A(IO_8I
) | INT_CAPS(INT_MERGED_MASK
),
97 [MAX7320
] = GROUP_B(IO_8O
),
98 [MAX7321
] = GROUP_A(IO_8P
) | INT_CAPS(INT_NO_MASK
),
99 [MAX7322
] = GROUP_A(IO_4I4O
) | INT_CAPS(INT_MERGED_MASK
),
100 [MAX7323
] = GROUP_A(IO_4P4O
) | INT_CAPS(INT_INDEP_MASK
),
101 [MAX7324
] = GROUP_A(IO_8I
) | GROUP_B(IO_8O
) | INT_CAPS(INT_MERGED_MASK
),
102 [MAX7325
] = GROUP_A(IO_8P
) | GROUP_B(IO_8O
) | INT_CAPS(INT_NO_MASK
),
103 [MAX7326
] = GROUP_A(IO_4I4O
) | GROUP_B(IO_8O
) | INT_CAPS(INT_MERGED_MASK
),
104 [MAX7327
] = GROUP_A(IO_4P4O
) | GROUP_B(IO_8O
) | INT_CAPS(INT_NO_MASK
),
107 static const struct i2c_device_id max732x_id
[] = {
108 { "max7319", MAX7319
},
109 { "max7320", MAX7320
},
110 { "max7321", MAX7321
},
111 { "max7322", MAX7322
},
112 { "max7323", MAX7323
},
113 { "max7324", MAX7324
},
114 { "max7325", MAX7325
},
115 { "max7326", MAX7326
},
116 { "max7327", MAX7327
},
119 MODULE_DEVICE_TABLE(i2c
, max732x_id
);
122 static const struct of_device_id max732x_of_table
[] = {
123 { .compatible
= "maxim,max7319" },
124 { .compatible
= "maxim,max7320" },
125 { .compatible
= "maxim,max7321" },
126 { .compatible
= "maxim,max7322" },
127 { .compatible
= "maxim,max7323" },
128 { .compatible
= "maxim,max7324" },
129 { .compatible
= "maxim,max7325" },
130 { .compatible
= "maxim,max7326" },
131 { .compatible
= "maxim,max7327" },
134 MODULE_DEVICE_TABLE(of
, max732x_of_table
);
137 struct max732x_chip
{
138 struct gpio_chip gpio_chip
;
140 struct i2c_client
*client
; /* "main" client */
141 struct i2c_client
*client_dummy
;
142 struct i2c_client
*client_group_a
;
143 struct i2c_client
*client_group_b
;
145 unsigned int mask_group_a
;
146 unsigned int dir_input
;
147 unsigned int dir_output
;
152 #ifdef CONFIG_GPIO_MAX732X_IRQ
153 struct irq_domain
*irq_domain
;
154 struct mutex irq_lock
;
157 uint8_t irq_mask_cur
;
158 uint8_t irq_trig_raise
;
159 uint8_t irq_trig_fall
;
160 uint8_t irq_features
;
164 static inline struct max732x_chip
*to_max732x(struct gpio_chip
*gc
)
166 return container_of(gc
, struct max732x_chip
, gpio_chip
);
169 static int max732x_writeb(struct max732x_chip
*chip
, int group_a
, uint8_t val
)
171 struct i2c_client
*client
;
174 client
= group_a
? chip
->client_group_a
: chip
->client_group_b
;
175 ret
= i2c_smbus_write_byte(client
, val
);
177 dev_err(&client
->dev
, "failed writing\n");
184 static int max732x_readb(struct max732x_chip
*chip
, int group_a
, uint8_t *val
)
186 struct i2c_client
*client
;
189 client
= group_a
? chip
->client_group_a
: chip
->client_group_b
;
190 ret
= i2c_smbus_read_byte(client
);
192 dev_err(&client
->dev
, "failed reading\n");
200 static inline int is_group_a(struct max732x_chip
*chip
, unsigned off
)
202 return (1u << off
) & chip
->mask_group_a
;
205 static int max732x_gpio_get_value(struct gpio_chip
*gc
, unsigned off
)
207 struct max732x_chip
*chip
= to_max732x(gc
);
211 ret
= max732x_readb(chip
, is_group_a(chip
, off
), ®_val
);
215 return reg_val
& (1u << (off
& 0x7));
218 static void max732x_gpio_set_mask(struct gpio_chip
*gc
, unsigned off
, int mask
,
221 struct max732x_chip
*chip
= to_max732x(gc
);
225 mutex_lock(&chip
->lock
);
227 reg_out
= (off
> 7) ? chip
->reg_out
[1] : chip
->reg_out
[0];
228 reg_out
= (reg_out
& ~mask
) | (val
& mask
);
230 ret
= max732x_writeb(chip
, is_group_a(chip
, off
), reg_out
);
234 /* update the shadow register then */
236 chip
->reg_out
[1] = reg_out
;
238 chip
->reg_out
[0] = reg_out
;
240 mutex_unlock(&chip
->lock
);
243 static void max732x_gpio_set_value(struct gpio_chip
*gc
, unsigned off
, int val
)
245 unsigned base
= off
& ~0x7;
246 uint8_t mask
= 1u << (off
& 0x7);
248 max732x_gpio_set_mask(gc
, base
, mask
, val
<< (off
& 0x7));
251 static void max732x_gpio_set_multiple(struct gpio_chip
*gc
,
252 unsigned long *mask
, unsigned long *bits
)
254 unsigned mask_lo
= mask
[0] & 0xff;
255 unsigned mask_hi
= (mask
[0] >> 8) & 0xff;
258 max732x_gpio_set_mask(gc
, 0, mask_lo
, bits
[0] & 0xff);
260 max732x_gpio_set_mask(gc
, 8, mask_hi
, (bits
[0] >> 8) & 0xff);
263 static int max732x_gpio_direction_input(struct gpio_chip
*gc
, unsigned off
)
265 struct max732x_chip
*chip
= to_max732x(gc
);
266 unsigned int mask
= 1u << off
;
268 if ((mask
& chip
->dir_input
) == 0) {
269 dev_dbg(&chip
->client
->dev
, "%s port %d is output only\n",
270 chip
->client
->name
, off
);
275 * Open-drain pins must be set to high impedance (which is
276 * equivalent to output-high) to be turned into an input.
278 if ((mask
& chip
->dir_output
))
279 max732x_gpio_set_value(gc
, off
, 1);
284 static int max732x_gpio_direction_output(struct gpio_chip
*gc
,
285 unsigned off
, int val
)
287 struct max732x_chip
*chip
= to_max732x(gc
);
288 unsigned int mask
= 1u << off
;
290 if ((mask
& chip
->dir_output
) == 0) {
291 dev_dbg(&chip
->client
->dev
, "%s port %d is input only\n",
292 chip
->client
->name
, off
);
296 max732x_gpio_set_value(gc
, off
, val
);
300 #ifdef CONFIG_GPIO_MAX732X_IRQ
301 static int max732x_writew(struct max732x_chip
*chip
, uint16_t val
)
305 val
= cpu_to_le16(val
);
307 ret
= i2c_master_send(chip
->client_group_a
, (char *)&val
, 2);
309 dev_err(&chip
->client_group_a
->dev
, "failed writing\n");
316 static int max732x_readw(struct max732x_chip
*chip
, uint16_t *val
)
320 ret
= i2c_master_recv(chip
->client_group_a
, (char *)val
, 2);
322 dev_err(&chip
->client_group_a
->dev
, "failed reading\n");
326 *val
= le16_to_cpu(*val
);
330 static void max732x_irq_update_mask(struct max732x_chip
*chip
)
334 if (chip
->irq_mask
== chip
->irq_mask_cur
)
337 chip
->irq_mask
= chip
->irq_mask_cur
;
339 if (chip
->irq_features
== INT_NO_MASK
)
342 mutex_lock(&chip
->lock
);
344 switch (chip
->irq_features
) {
346 msg
= (chip
->irq_mask
<< 8) | chip
->reg_out
[0];
347 max732x_writew(chip
, msg
);
350 case INT_MERGED_MASK
:
351 msg
= chip
->irq_mask
| chip
->reg_out
[0];
352 max732x_writeb(chip
, 1, (uint8_t)msg
);
356 mutex_unlock(&chip
->lock
);
359 static int max732x_gpio_to_irq(struct gpio_chip
*gc
, unsigned off
)
361 struct max732x_chip
*chip
= to_max732x(gc
);
363 if (chip
->irq_domain
) {
364 return irq_create_mapping(chip
->irq_domain
,
365 chip
->irq_base
+ off
);
371 static void max732x_irq_mask(struct irq_data
*d
)
373 struct max732x_chip
*chip
= irq_data_get_irq_chip_data(d
);
375 chip
->irq_mask_cur
&= ~(1 << d
->hwirq
);
378 static void max732x_irq_unmask(struct irq_data
*d
)
380 struct max732x_chip
*chip
= irq_data_get_irq_chip_data(d
);
382 chip
->irq_mask_cur
|= 1 << d
->hwirq
;
385 static void max732x_irq_bus_lock(struct irq_data
*d
)
387 struct max732x_chip
*chip
= irq_data_get_irq_chip_data(d
);
389 mutex_lock(&chip
->irq_lock
);
390 chip
->irq_mask_cur
= chip
->irq_mask
;
393 static void max732x_irq_bus_sync_unlock(struct irq_data
*d
)
395 struct max732x_chip
*chip
= irq_data_get_irq_chip_data(d
);
399 max732x_irq_update_mask(chip
);
401 new_irqs
= chip
->irq_trig_fall
| chip
->irq_trig_raise
;
403 level
= __ffs(new_irqs
);
404 max732x_gpio_direction_input(&chip
->gpio_chip
, level
);
405 new_irqs
&= ~(1 << level
);
408 mutex_unlock(&chip
->irq_lock
);
411 static int max732x_irq_set_type(struct irq_data
*d
, unsigned int type
)
413 struct max732x_chip
*chip
= irq_data_get_irq_chip_data(d
);
414 uint16_t off
= d
->hwirq
;
415 uint16_t mask
= 1 << off
;
417 if (!(mask
& chip
->dir_input
)) {
418 dev_dbg(&chip
->client
->dev
, "%s port %d is output only\n",
419 chip
->client
->name
, off
);
423 if (!(type
& IRQ_TYPE_EDGE_BOTH
)) {
424 dev_err(&chip
->client
->dev
, "irq %d: unsupported type %d\n",
429 if (type
& IRQ_TYPE_EDGE_FALLING
)
430 chip
->irq_trig_fall
|= mask
;
432 chip
->irq_trig_fall
&= ~mask
;
434 if (type
& IRQ_TYPE_EDGE_RISING
)
435 chip
->irq_trig_raise
|= mask
;
437 chip
->irq_trig_raise
&= ~mask
;
442 static struct irq_chip max732x_irq_chip
= {
444 .irq_mask
= max732x_irq_mask
,
445 .irq_unmask
= max732x_irq_unmask
,
446 .irq_bus_lock
= max732x_irq_bus_lock
,
447 .irq_bus_sync_unlock
= max732x_irq_bus_sync_unlock
,
448 .irq_set_type
= max732x_irq_set_type
,
451 static uint8_t max732x_irq_pending(struct max732x_chip
*chip
)
460 ret
= max732x_readw(chip
, &status
);
464 trigger
= status
>> 8;
465 trigger
&= chip
->irq_mask
;
470 cur_stat
= status
& 0xFF;
471 cur_stat
&= chip
->irq_mask
;
473 old_stat
= cur_stat
^ trigger
;
475 pending
= (old_stat
& chip
->irq_trig_fall
) |
476 (cur_stat
& chip
->irq_trig_raise
);
482 static irqreturn_t
max732x_irq_handler(int irq
, void *devid
)
484 struct max732x_chip
*chip
= devid
;
488 pending
= max732x_irq_pending(chip
);
494 level
= __ffs(pending
);
495 handle_nested_irq(irq_find_mapping(chip
->irq_domain
, level
));
497 pending
&= ~(1 << level
);
503 static int max732x_irq_map(struct irq_domain
*h
, unsigned int virq
,
506 struct max732x_chip
*chip
= h
->host_data
;
508 if (!(chip
->dir_input
& (1 << hw
))) {
509 dev_err(&chip
->client
->dev
,
510 "Attempt to map output line as IRQ line: %lu\n",
515 irq_set_chip_data(virq
, chip
);
516 irq_set_chip_and_handler(virq
, &max732x_irq_chip
,
518 irq_set_nested_thread(virq
, 1);
520 /* ARM needs us to explicitly flag the IRQ as valid
521 * and will set them noprobe when we do so. */
522 set_irq_flags(virq
, IRQF_VALID
);
524 irq_set_noprobe(virq
);
530 static struct irq_domain_ops max732x_irq_domain_ops
= {
531 .map
= max732x_irq_map
,
532 .xlate
= irq_domain_xlate_twocell
,
535 static void max732x_irq_teardown(struct max732x_chip
*chip
)
537 if (chip
->client
->irq
&& chip
->irq_domain
)
538 irq_domain_remove(chip
->irq_domain
);
541 static int max732x_irq_setup(struct max732x_chip
*chip
,
542 const struct i2c_device_id
*id
)
544 struct i2c_client
*client
= chip
->client
;
545 struct max732x_platform_data
*pdata
= dev_get_platdata(&client
->dev
);
546 int has_irq
= max732x_features
[id
->driver_data
] >> 32;
549 if (((pdata
&& pdata
->irq_base
) || client
->irq
)
550 && has_irq
!= INT_NONE
) {
552 chip
->irq_base
= pdata
->irq_base
;
553 chip
->irq_features
= has_irq
;
554 mutex_init(&chip
->irq_lock
);
556 chip
->irq_domain
= irq_domain_add_simple(client
->dev
.of_node
,
557 chip
->gpio_chip
.ngpio
, chip
->irq_base
,
558 &max732x_irq_domain_ops
, chip
);
559 if (!chip
->irq_domain
) {
560 dev_err(&client
->dev
, "Failed to create IRQ domain\n");
564 ret
= request_threaded_irq(client
->irq
,
567 IRQF_TRIGGER_FALLING
| IRQF_ONESHOT
,
568 dev_name(&client
->dev
), chip
);
570 dev_err(&client
->dev
, "failed to request irq %d\n",
575 chip
->gpio_chip
.to_irq
= max732x_gpio_to_irq
;
581 max732x_irq_teardown(chip
);
585 #else /* CONFIG_GPIO_MAX732X_IRQ */
586 static int max732x_irq_setup(struct max732x_chip
*chip
,
587 const struct i2c_device_id
*id
)
589 struct i2c_client
*client
= chip
->client
;
590 struct max732x_platform_data
*pdata
= dev_get_platdata(&client
->dev
);
591 int has_irq
= max732x_features
[id
->driver_data
] >> 32;
593 if (((pdata
&& pdata
->irq_base
) || client
->irq
) && has_irq
!= INT_NONE
)
594 dev_warn(&client
->dev
, "interrupt support not compiled in\n");
599 static void max732x_irq_teardown(struct max732x_chip
*chip
)
604 static int max732x_setup_gpio(struct max732x_chip
*chip
,
605 const struct i2c_device_id
*id
,
608 struct gpio_chip
*gc
= &chip
->gpio_chip
;
609 uint32_t id_data
= (uint32_t)max732x_features
[id
->driver_data
];
612 for (i
= 0; i
< 16; i
++, id_data
>>= 2) {
613 unsigned int mask
= 1 << port
;
615 switch (id_data
& 0x3) {
617 chip
->dir_output
|= mask
;
620 chip
->dir_input
|= mask
;
623 chip
->dir_output
|= mask
;
624 chip
->dir_input
|= mask
;
631 chip
->mask_group_a
|= mask
;
636 gc
->direction_input
= max732x_gpio_direction_input
;
637 if (chip
->dir_output
) {
638 gc
->direction_output
= max732x_gpio_direction_output
;
639 gc
->set
= max732x_gpio_set_value
;
640 gc
->set_multiple
= max732x_gpio_set_multiple
;
642 gc
->get
= max732x_gpio_get_value
;
643 gc
->can_sleep
= true;
645 gc
->base
= gpio_start
;
647 gc
->label
= chip
->client
->name
;
648 gc
->owner
= THIS_MODULE
;
653 static struct max732x_platform_data
*of_gpio_max732x(struct device
*dev
)
655 struct max732x_platform_data
*pdata
;
657 pdata
= devm_kzalloc(dev
, sizeof(*pdata
), GFP_KERNEL
);
661 pdata
->gpio_base
= -1;
666 static int max732x_probe(struct i2c_client
*client
,
667 const struct i2c_device_id
*id
)
669 struct max732x_platform_data
*pdata
;
670 struct device_node
*node
;
671 struct max732x_chip
*chip
;
672 struct i2c_client
*c
;
673 uint16_t addr_a
, addr_b
;
676 pdata
= dev_get_platdata(&client
->dev
);
677 node
= client
->dev
.of_node
;
680 pdata
= of_gpio_max732x(&client
->dev
);
683 dev_dbg(&client
->dev
, "no platform data\n");
687 chip
= devm_kzalloc(&client
->dev
, sizeof(*chip
), GFP_KERNEL
);
690 chip
->client
= client
;
692 nr_port
= max732x_setup_gpio(chip
, id
, pdata
->gpio_base
);
693 chip
->gpio_chip
.dev
= &client
->dev
;
695 addr_a
= (client
->addr
& 0x0f) | 0x60;
696 addr_b
= (client
->addr
& 0x0f) | 0x50;
698 switch (client
->addr
& 0x70) {
700 chip
->client_group_a
= client
;
702 c
= i2c_new_dummy(client
->adapter
, addr_b
);
703 chip
->client_group_b
= chip
->client_dummy
= c
;
707 chip
->client_group_b
= client
;
709 c
= i2c_new_dummy(client
->adapter
, addr_a
);
710 chip
->client_group_a
= chip
->client_dummy
= c
;
714 dev_err(&client
->dev
, "invalid I2C address specified %02x\n",
720 if (nr_port
> 8 && !chip
->client_dummy
) {
721 dev_err(&client
->dev
,
722 "Failed to allocate second group I2C device\n");
727 mutex_init(&chip
->lock
);
729 max732x_readb(chip
, is_group_a(chip
, 0), &chip
->reg_out
[0]);
731 max732x_readb(chip
, is_group_a(chip
, 8), &chip
->reg_out
[1]);
733 ret
= max732x_irq_setup(chip
, id
);
737 ret
= gpiochip_add(&chip
->gpio_chip
);
741 if (pdata
&& pdata
->setup
) {
742 ret
= pdata
->setup(client
, chip
->gpio_chip
.base
,
743 chip
->gpio_chip
.ngpio
, pdata
->context
);
745 dev_warn(&client
->dev
, "setup failed, %d\n", ret
);
748 i2c_set_clientdata(client
, chip
);
752 if (chip
->client_dummy
)
753 i2c_unregister_device(chip
->client_dummy
);
754 max732x_irq_teardown(chip
);
758 static int max732x_remove(struct i2c_client
*client
)
760 struct max732x_platform_data
*pdata
= dev_get_platdata(&client
->dev
);
761 struct max732x_chip
*chip
= i2c_get_clientdata(client
);
763 if (pdata
&& pdata
->teardown
) {
766 ret
= pdata
->teardown(client
, chip
->gpio_chip
.base
,
767 chip
->gpio_chip
.ngpio
, pdata
->context
);
769 dev_err(&client
->dev
, "%s failed, %d\n",
775 gpiochip_remove(&chip
->gpio_chip
);
777 max732x_irq_teardown(chip
);
779 /* unregister any dummy i2c_client */
780 if (chip
->client_dummy
)
781 i2c_unregister_device(chip
->client_dummy
);
786 static struct i2c_driver max732x_driver
= {
789 .owner
= THIS_MODULE
,
790 .of_match_table
= of_match_ptr(max732x_of_table
),
792 .probe
= max732x_probe
,
793 .remove
= max732x_remove
,
794 .id_table
= max732x_id
,
797 static int __init
max732x_init(void)
799 return i2c_add_driver(&max732x_driver
);
801 /* register after i2c postcore initcall and before
802 * subsys initcalls that may rely on these GPIOs
804 subsys_initcall(max732x_init
);
806 static void __exit
max732x_exit(void)
808 i2c_del_driver(&max732x_driver
);
810 module_exit(max732x_exit
);
812 MODULE_AUTHOR("Eric Miao <eric.miao@marvell.com>");
813 MODULE_DESCRIPTION("GPIO expander driver for MAX732X");
814 MODULE_LICENSE("GPL");