1 // SPDX-License-Identifier: GPL-2.0-or-later
3 * GPIO driver for Fintek Super-I/O F71869, F71869A, F71882, F71889 and F81866
5 * Copyright (C) 2010-2013 LaCie
7 * Author: Simon Guinot <simon.guinot@sequanux.org>
10 #include <linux/module.h>
11 #include <linux/init.h>
12 #include <linux/platform_device.h>
14 #include <linux/gpio/driver.h>
15 #include <linux/bitops.h>
17 #define DRVNAME "gpio-f7188x"
22 #define SIO_LDSEL 0x07 /* Logical device select */
23 #define SIO_DEVID 0x20 /* Device ID (2 bytes) */
24 #define SIO_DEVREV 0x22 /* Device revision */
25 #define SIO_MANID 0x23 /* Fintek ID (2 bytes) */
27 #define SIO_LD_GPIO 0x06 /* GPIO logical device */
28 #define SIO_UNLOCK_KEY 0x87 /* Key to enable Super-I/O */
29 #define SIO_LOCK_KEY 0xAA /* Key to disable Super-I/O */
31 #define SIO_FINTEK_ID 0x1934 /* Manufacturer ID */
32 #define SIO_F71869_ID 0x0814 /* F71869 chipset ID */
33 #define SIO_F71869A_ID 0x1007 /* F71869A chipset ID */
34 #define SIO_F71882_ID 0x0541 /* F71882 chipset ID */
35 #define SIO_F71889_ID 0x0909 /* F71889 chipset ID */
36 #define SIO_F71889A_ID 0x1005 /* F71889A chipset ID */
37 #define SIO_F81866_ID 0x1010 /* F81866 chipset ID */
38 #define SIO_F81804_ID 0x1502 /* F81804 chipset ID, same for f81966 */
41 enum chips
{ f71869
, f71869a
, f71882fg
, f71889a
, f71889f
, f81866
, f81804
};
43 static const char * const f7188x_names
[] = {
58 struct f7188x_gpio_bank
{
59 struct gpio_chip chip
;
61 struct f7188x_gpio_data
*data
;
64 struct f7188x_gpio_data
{
65 struct f7188x_sio
*sio
;
67 struct f7188x_gpio_bank
*bank
;
71 * Super-I/O functions.
74 static inline int superio_inb(int base
, int reg
)
80 static int superio_inw(int base
, int reg
)
85 val
= inb(base
+ 1) << 8;
92 static inline void superio_outb(int base
, int reg
, int val
)
98 static inline int superio_enter(int base
)
100 /* Don't step on other drivers' I/O space by accident. */
101 if (!request_muxed_region(base
, 2, DRVNAME
)) {
102 pr_err(DRVNAME
"I/O address 0x%04x already in use\n", base
);
106 /* According to the datasheet the key must be send twice. */
107 outb(SIO_UNLOCK_KEY
, base
);
108 outb(SIO_UNLOCK_KEY
, base
);
113 static inline void superio_select(int base
, int ld
)
115 outb(SIO_LDSEL
, base
);
119 static inline void superio_exit(int base
)
121 outb(SIO_LOCK_KEY
, base
);
122 release_region(base
, 2);
129 static int f7188x_gpio_get_direction(struct gpio_chip
*chip
, unsigned offset
);
130 static int f7188x_gpio_direction_in(struct gpio_chip
*chip
, unsigned offset
);
131 static int f7188x_gpio_get(struct gpio_chip
*chip
, unsigned offset
);
132 static int f7188x_gpio_direction_out(struct gpio_chip
*chip
,
133 unsigned offset
, int value
);
134 static void f7188x_gpio_set(struct gpio_chip
*chip
, unsigned offset
, int value
);
135 static int f7188x_gpio_set_config(struct gpio_chip
*chip
, unsigned offset
,
136 unsigned long config
);
138 #define F7188X_GPIO_BANK(_base, _ngpio, _regbase) \
142 .owner = THIS_MODULE, \
143 .get_direction = f7188x_gpio_get_direction, \
144 .direction_input = f7188x_gpio_direction_in, \
145 .get = f7188x_gpio_get, \
146 .direction_output = f7188x_gpio_direction_out, \
147 .set = f7188x_gpio_set, \
148 .set_config = f7188x_gpio_set_config, \
153 .regbase = _regbase, \
156 #define gpio_dir(base) (base + 0)
157 #define gpio_data_out(base) (base + 1)
158 #define gpio_data_in(base) (base + 2)
159 /* Output mode register (0:open drain 1:push-pull). */
160 #define gpio_out_mode(base) (base + 3)
162 static struct f7188x_gpio_bank f71869_gpio_bank
[] = {
163 F7188X_GPIO_BANK(0, 6, 0xF0),
164 F7188X_GPIO_BANK(10, 8, 0xE0),
165 F7188X_GPIO_BANK(20, 8, 0xD0),
166 F7188X_GPIO_BANK(30, 8, 0xC0),
167 F7188X_GPIO_BANK(40, 8, 0xB0),
168 F7188X_GPIO_BANK(50, 5, 0xA0),
169 F7188X_GPIO_BANK(60, 6, 0x90),
172 static struct f7188x_gpio_bank f71869a_gpio_bank
[] = {
173 F7188X_GPIO_BANK(0, 6, 0xF0),
174 F7188X_GPIO_BANK(10, 8, 0xE0),
175 F7188X_GPIO_BANK(20, 8, 0xD0),
176 F7188X_GPIO_BANK(30, 8, 0xC0),
177 F7188X_GPIO_BANK(40, 8, 0xB0),
178 F7188X_GPIO_BANK(50, 5, 0xA0),
179 F7188X_GPIO_BANK(60, 8, 0x90),
180 F7188X_GPIO_BANK(70, 8, 0x80),
183 static struct f7188x_gpio_bank f71882_gpio_bank
[] = {
184 F7188X_GPIO_BANK(0, 8, 0xF0),
185 F7188X_GPIO_BANK(10, 8, 0xE0),
186 F7188X_GPIO_BANK(20, 8, 0xD0),
187 F7188X_GPIO_BANK(30, 4, 0xC0),
188 F7188X_GPIO_BANK(40, 4, 0xB0),
191 static struct f7188x_gpio_bank f71889a_gpio_bank
[] = {
192 F7188X_GPIO_BANK(0, 7, 0xF0),
193 F7188X_GPIO_BANK(10, 7, 0xE0),
194 F7188X_GPIO_BANK(20, 8, 0xD0),
195 F7188X_GPIO_BANK(30, 8, 0xC0),
196 F7188X_GPIO_BANK(40, 8, 0xB0),
197 F7188X_GPIO_BANK(50, 5, 0xA0),
198 F7188X_GPIO_BANK(60, 8, 0x90),
199 F7188X_GPIO_BANK(70, 8, 0x80),
202 static struct f7188x_gpio_bank f71889_gpio_bank
[] = {
203 F7188X_GPIO_BANK(0, 7, 0xF0),
204 F7188X_GPIO_BANK(10, 7, 0xE0),
205 F7188X_GPIO_BANK(20, 8, 0xD0),
206 F7188X_GPIO_BANK(30, 8, 0xC0),
207 F7188X_GPIO_BANK(40, 8, 0xB0),
208 F7188X_GPIO_BANK(50, 5, 0xA0),
209 F7188X_GPIO_BANK(60, 8, 0x90),
210 F7188X_GPIO_BANK(70, 8, 0x80),
213 static struct f7188x_gpio_bank f81866_gpio_bank
[] = {
214 F7188X_GPIO_BANK(0, 8, 0xF0),
215 F7188X_GPIO_BANK(10, 8, 0xE0),
216 F7188X_GPIO_BANK(20, 8, 0xD0),
217 F7188X_GPIO_BANK(30, 8, 0xC0),
218 F7188X_GPIO_BANK(40, 8, 0xB0),
219 F7188X_GPIO_BANK(50, 8, 0xA0),
220 F7188X_GPIO_BANK(60, 8, 0x90),
221 F7188X_GPIO_BANK(70, 8, 0x80),
222 F7188X_GPIO_BANK(80, 8, 0x88),
226 static struct f7188x_gpio_bank f81804_gpio_bank
[] = {
227 F7188X_GPIO_BANK(0, 8, 0xF0),
228 F7188X_GPIO_BANK(10, 8, 0xE0),
229 F7188X_GPIO_BANK(20, 8, 0xD0),
230 F7188X_GPIO_BANK(50, 8, 0xA0),
231 F7188X_GPIO_BANK(60, 8, 0x90),
232 F7188X_GPIO_BANK(70, 8, 0x80),
233 F7188X_GPIO_BANK(90, 8, 0x98),
237 static int f7188x_gpio_get_direction(struct gpio_chip
*chip
, unsigned offset
)
240 struct f7188x_gpio_bank
*bank
= gpiochip_get_data(chip
);
241 struct f7188x_sio
*sio
= bank
->data
->sio
;
244 err
= superio_enter(sio
->addr
);
247 superio_select(sio
->addr
, SIO_LD_GPIO
);
249 dir
= superio_inb(sio
->addr
, gpio_dir(bank
->regbase
));
251 superio_exit(sio
->addr
);
253 if (dir
& 1 << offset
)
254 return GPIO_LINE_DIRECTION_OUT
;
256 return GPIO_LINE_DIRECTION_IN
;
259 static int f7188x_gpio_direction_in(struct gpio_chip
*chip
, unsigned offset
)
262 struct f7188x_gpio_bank
*bank
= gpiochip_get_data(chip
);
263 struct f7188x_sio
*sio
= bank
->data
->sio
;
266 err
= superio_enter(sio
->addr
);
269 superio_select(sio
->addr
, SIO_LD_GPIO
);
271 dir
= superio_inb(sio
->addr
, gpio_dir(bank
->regbase
));
273 superio_outb(sio
->addr
, gpio_dir(bank
->regbase
), dir
);
275 superio_exit(sio
->addr
);
280 static int f7188x_gpio_get(struct gpio_chip
*chip
, unsigned offset
)
283 struct f7188x_gpio_bank
*bank
= gpiochip_get_data(chip
);
284 struct f7188x_sio
*sio
= bank
->data
->sio
;
287 err
= superio_enter(sio
->addr
);
290 superio_select(sio
->addr
, SIO_LD_GPIO
);
292 dir
= superio_inb(sio
->addr
, gpio_dir(bank
->regbase
));
293 dir
= !!(dir
& BIT(offset
));
295 data
= superio_inb(sio
->addr
, gpio_data_out(bank
->regbase
));
297 data
= superio_inb(sio
->addr
, gpio_data_in(bank
->regbase
));
299 superio_exit(sio
->addr
);
301 return !!(data
& BIT(offset
));
304 static int f7188x_gpio_direction_out(struct gpio_chip
*chip
,
305 unsigned offset
, int value
)
308 struct f7188x_gpio_bank
*bank
= gpiochip_get_data(chip
);
309 struct f7188x_sio
*sio
= bank
->data
->sio
;
312 err
= superio_enter(sio
->addr
);
315 superio_select(sio
->addr
, SIO_LD_GPIO
);
317 data_out
= superio_inb(sio
->addr
, gpio_data_out(bank
->regbase
));
319 data_out
|= BIT(offset
);
321 data_out
&= ~BIT(offset
);
322 superio_outb(sio
->addr
, gpio_data_out(bank
->regbase
), data_out
);
324 dir
= superio_inb(sio
->addr
, gpio_dir(bank
->regbase
));
326 superio_outb(sio
->addr
, gpio_dir(bank
->regbase
), dir
);
328 superio_exit(sio
->addr
);
333 static void f7188x_gpio_set(struct gpio_chip
*chip
, unsigned offset
, int value
)
336 struct f7188x_gpio_bank
*bank
= gpiochip_get_data(chip
);
337 struct f7188x_sio
*sio
= bank
->data
->sio
;
340 err
= superio_enter(sio
->addr
);
343 superio_select(sio
->addr
, SIO_LD_GPIO
);
345 data_out
= superio_inb(sio
->addr
, gpio_data_out(bank
->regbase
));
347 data_out
|= BIT(offset
);
349 data_out
&= ~BIT(offset
);
350 superio_outb(sio
->addr
, gpio_data_out(bank
->regbase
), data_out
);
352 superio_exit(sio
->addr
);
355 static int f7188x_gpio_set_config(struct gpio_chip
*chip
, unsigned offset
,
356 unsigned long config
)
359 enum pin_config_param param
= pinconf_to_config_param(config
);
360 struct f7188x_gpio_bank
*bank
= gpiochip_get_data(chip
);
361 struct f7188x_sio
*sio
= bank
->data
->sio
;
364 if (param
!= PIN_CONFIG_DRIVE_OPEN_DRAIN
&&
365 param
!= PIN_CONFIG_DRIVE_PUSH_PULL
)
368 err
= superio_enter(sio
->addr
);
371 superio_select(sio
->addr
, SIO_LD_GPIO
);
373 data
= superio_inb(sio
->addr
, gpio_out_mode(bank
->regbase
));
374 if (param
== PIN_CONFIG_DRIVE_OPEN_DRAIN
)
375 data
&= ~BIT(offset
);
378 superio_outb(sio
->addr
, gpio_out_mode(bank
->regbase
), data
);
380 superio_exit(sio
->addr
);
385 * Platform device and driver.
388 static int f7188x_gpio_probe(struct platform_device
*pdev
)
392 struct f7188x_sio
*sio
= dev_get_platdata(&pdev
->dev
);
393 struct f7188x_gpio_data
*data
;
395 data
= devm_kzalloc(&pdev
->dev
, sizeof(*data
), GFP_KERNEL
);
401 data
->nr_bank
= ARRAY_SIZE(f71869_gpio_bank
);
402 data
->bank
= f71869_gpio_bank
;
405 data
->nr_bank
= ARRAY_SIZE(f71869a_gpio_bank
);
406 data
->bank
= f71869a_gpio_bank
;
409 data
->nr_bank
= ARRAY_SIZE(f71882_gpio_bank
);
410 data
->bank
= f71882_gpio_bank
;
413 data
->nr_bank
= ARRAY_SIZE(f71889a_gpio_bank
);
414 data
->bank
= f71889a_gpio_bank
;
417 data
->nr_bank
= ARRAY_SIZE(f71889_gpio_bank
);
418 data
->bank
= f71889_gpio_bank
;
421 data
->nr_bank
= ARRAY_SIZE(f81866_gpio_bank
);
422 data
->bank
= f81866_gpio_bank
;
425 data
->nr_bank
= ARRAY_SIZE(f81804_gpio_bank
);
426 data
->bank
= f81804_gpio_bank
;
433 platform_set_drvdata(pdev
, data
);
435 /* For each GPIO bank, register a GPIO chip. */
436 for (i
= 0; i
< data
->nr_bank
; i
++) {
437 struct f7188x_gpio_bank
*bank
= &data
->bank
[i
];
439 bank
->chip
.parent
= &pdev
->dev
;
442 err
= devm_gpiochip_add_data(&pdev
->dev
, &bank
->chip
, bank
);
445 "Failed to register gpiochip %d: %d\n",
454 static int __init
f7188x_find(int addr
, struct f7188x_sio
*sio
)
459 err
= superio_enter(addr
);
464 devid
= superio_inw(addr
, SIO_MANID
);
465 if (devid
!= SIO_FINTEK_ID
) {
466 pr_debug(DRVNAME
": Not a Fintek device at 0x%08x\n", addr
);
470 devid
= superio_inw(addr
, SIO_DEVID
);
479 sio
->type
= f71882fg
;
494 pr_info(DRVNAME
": Unsupported Fintek device 0x%04x\n", devid
);
500 pr_info(DRVNAME
": Found %s at %#x, revision %d\n",
501 f7188x_names
[sio
->type
],
503 (int) superio_inb(addr
, SIO_DEVREV
));
510 static struct platform_device
*f7188x_gpio_pdev
;
513 f7188x_gpio_device_add(const struct f7188x_sio
*sio
)
517 f7188x_gpio_pdev
= platform_device_alloc(DRVNAME
, -1);
518 if (!f7188x_gpio_pdev
)
521 err
= platform_device_add_data(f7188x_gpio_pdev
,
524 pr_err(DRVNAME
"Platform data allocation failed\n");
528 err
= platform_device_add(f7188x_gpio_pdev
);
530 pr_err(DRVNAME
"Device addition failed\n");
537 platform_device_put(f7188x_gpio_pdev
);
543 * Try to match a supported Fintek device by reading the (hard-wired)
544 * configuration I/O ports. If available, then register both the platform
545 * device and driver to support the GPIOs.
548 static struct platform_driver f7188x_gpio_driver
= {
552 .probe
= f7188x_gpio_probe
,
555 static int __init
f7188x_gpio_init(void)
558 struct f7188x_sio sio
;
560 if (f7188x_find(0x2e, &sio
) &&
561 f7188x_find(0x4e, &sio
))
564 err
= platform_driver_register(&f7188x_gpio_driver
);
566 err
= f7188x_gpio_device_add(&sio
);
568 platform_driver_unregister(&f7188x_gpio_driver
);
573 subsys_initcall(f7188x_gpio_init
);
575 static void __exit
f7188x_gpio_exit(void)
577 platform_device_unregister(f7188x_gpio_pdev
);
578 platform_driver_unregister(&f7188x_gpio_driver
);
580 module_exit(f7188x_gpio_exit
);
582 MODULE_DESCRIPTION("GPIO driver for Super-I/O chips F71869, F71869A, F71882FG, F71889A, F71889F and F81866");
583 MODULE_AUTHOR("Simon Guinot <simon.guinot@sequanux.org>");
584 MODULE_LICENSE("GPL");