1 // SPDX-License-Identifier: GPL-2.0+
3 * GPIO interface for Winbond Super I/O chips
4 * Currently, only W83627UHG (Nuvoton NCT6627UD) is supported.
6 * Author: Maciej S. Szmigiero <mail@maciej.szmigiero.name>
9 #define pr_fmt(fmt) KBUILD_MODNAME ": " fmt
11 #include <linux/gpio/driver.h>
12 #include <linux/ioport.h>
13 #include <linux/isa.h>
14 #include <linux/module.h>
16 #define WB_GPIO_DRIVER_NAME KBUILD_MODNAME
18 #define WB_SIO_BASE 0x2e
19 #define WB_SIO_BASE_HIGH 0x4e
21 #define WB_SIO_EXT_ENTER_KEY 0x87
22 #define WB_SIO_EXT_EXIT_KEY 0xaa
24 /* global chip registers */
26 #define WB_SIO_REG_LOGICAL 0x07
28 #define WB_SIO_REG_CHIP_MSB 0x20
29 #define WB_SIO_REG_CHIP_LSB 0x21
31 #define WB_SIO_CHIP_ID_W83627UHG 0xa230
32 #define WB_SIO_CHIP_ID_W83627UHG_MASK GENMASK(15, 4)
34 #define WB_SIO_REG_DPD 0x22
35 #define WB_SIO_REG_DPD_UARTA 4
36 #define WB_SIO_REG_DPD_UARTB 5
38 #define WB_SIO_REG_IDPD 0x23
39 #define WB_SIO_REG_IDPD_UARTC 4
40 #define WB_SIO_REG_IDPD_UARTD 5
41 #define WB_SIO_REG_IDPD_UARTE 6
42 #define WB_SIO_REG_IDPD_UARTF 7
44 #define WB_SIO_REG_GLOBAL_OPT 0x24
45 #define WB_SIO_REG_GO_ENFDC 1
47 #define WB_SIO_REG_OVTGPIO3456 0x29
48 #define WB_SIO_REG_OG3456_G3PP 3
49 #define WB_SIO_REG_OG3456_G4PP 4
50 #define WB_SIO_REG_OG3456_G5PP 5
51 #define WB_SIO_REG_OG3456_G6PP 7
53 #define WB_SIO_REG_I2C_PS 0x2a
54 #define WB_SIO_REG_I2CPS_I2CFS 1
56 #define WB_SIO_REG_GPIO1_MF 0x2c
57 #define WB_SIO_REG_G1MF_G1PP 6
58 #define WB_SIO_REG_G1MF_G2PP 7
59 #define WB_SIO_REG_G1MF_FS_MASK GENMASK(1, 0)
60 #define WB_SIO_REG_G1MF_FS_IR_OFF 0
61 #define WB_SIO_REG_G1MF_FS_IR 1
62 #define WB_SIO_REG_G1MF_FS_GPIO1 2
63 #define WB_SIO_REG_G1MF_FS_UARTB 3
65 /* not an actual device number, just a value meaning 'no device' */
66 #define WB_SIO_DEV_NONE 0xff
68 /* registers with offsets >= 0x30 are specific for a particular device */
70 /* UART B logical device */
71 #define WB_SIO_DEV_UARTB 0x03
72 #define WB_SIO_UARTB_REG_ENABLE 0x30
73 #define WB_SIO_UARTB_ENABLE_ON 0
75 /* UART C logical device */
76 #define WB_SIO_DEV_UARTC 0x06
77 #define WB_SIO_UARTC_REG_ENABLE 0x30
78 #define WB_SIO_UARTC_ENABLE_ON 0
80 /* GPIO3, GPIO4 logical device */
81 #define WB_SIO_DEV_GPIO34 0x07
82 #define WB_SIO_GPIO34_REG_ENABLE 0x30
83 #define WB_SIO_GPIO34_ENABLE_3 0
84 #define WB_SIO_GPIO34_ENABLE_4 1
85 #define WB_SIO_GPIO34_REG_IO3 0xe0
86 #define WB_SIO_GPIO34_REG_DATA3 0xe1
87 #define WB_SIO_GPIO34_REG_INV3 0xe2
88 #define WB_SIO_GPIO34_REG_IO4 0xe4
89 #define WB_SIO_GPIO34_REG_DATA4 0xe5
90 #define WB_SIO_GPIO34_REG_INV4 0xe6
92 /* WDTO, PLED, GPIO5, GPIO6 logical device */
93 #define WB_SIO_DEV_WDGPIO56 0x08
94 #define WB_SIO_WDGPIO56_REG_ENABLE 0x30
95 #define WB_SIO_WDGPIO56_ENABLE_5 1
96 #define WB_SIO_WDGPIO56_ENABLE_6 2
97 #define WB_SIO_WDGPIO56_REG_IO5 0xe0
98 #define WB_SIO_WDGPIO56_REG_DATA5 0xe1
99 #define WB_SIO_WDGPIO56_REG_INV5 0xe2
100 #define WB_SIO_WDGPIO56_REG_IO6 0xe4
101 #define WB_SIO_WDGPIO56_REG_DATA6 0xe5
102 #define WB_SIO_WDGPIO56_REG_INV6 0xe6
104 /* GPIO1, GPIO2, SUSLED logical device */
105 #define WB_SIO_DEV_GPIO12 0x09
106 #define WB_SIO_GPIO12_REG_ENABLE 0x30
107 #define WB_SIO_GPIO12_ENABLE_1 0
108 #define WB_SIO_GPIO12_ENABLE_2 1
109 #define WB_SIO_GPIO12_REG_IO1 0xe0
110 #define WB_SIO_GPIO12_REG_DATA1 0xe1
111 #define WB_SIO_GPIO12_REG_INV1 0xe2
112 #define WB_SIO_GPIO12_REG_IO2 0xe4
113 #define WB_SIO_GPIO12_REG_DATA2 0xe5
114 #define WB_SIO_GPIO12_REG_INV2 0xe6
116 /* UART D logical device */
117 #define WB_SIO_DEV_UARTD 0x0d
118 #define WB_SIO_UARTD_REG_ENABLE 0x30
119 #define WB_SIO_UARTD_ENABLE_ON 0
121 /* UART E logical device */
122 #define WB_SIO_DEV_UARTE 0x0e
123 #define WB_SIO_UARTE_REG_ENABLE 0x30
124 #define WB_SIO_UARTE_ENABLE_ON 0
127 * for a description what a particular field of this struct means please see
128 * a description of the relevant module parameter at the bottom of this file
130 struct winbond_gpio_params {
133 unsigned long ppgpios;
134 unsigned long odgpios;
140 static struct winbond_gpio_params params;
142 static int winbond_sio_enter(unsigned long base)
144 if (!request_muxed_region(base, 2, WB_GPIO_DRIVER_NAME))
148 * datasheet says two successive writes of the "key" value are needed
149 * in order for chip to enter the "Extended Function Mode"
151 outb(WB_SIO_EXT_ENTER_KEY, base);
152 outb(WB_SIO_EXT_ENTER_KEY, base);
157 static void winbond_sio_select_logical(unsigned long base, u8 dev)
159 outb(WB_SIO_REG_LOGICAL, base);
163 static void winbond_sio_leave(unsigned long base)
165 outb(WB_SIO_EXT_EXIT_KEY, base);
167 release_region(base, 2);
170 static void winbond_sio_reg_write(unsigned long base, u8 reg, u8 data)
173 outb(data, base + 1);
176 static u8 winbond_sio_reg_read(unsigned long base, u8 reg)
179 return inb(base + 1);
182 static void winbond_sio_reg_bset(unsigned long base, u8 reg, u8 bit)
186 val = winbond_sio_reg_read(base, reg);
188 winbond_sio_reg_write(base, reg, val);
191 static void winbond_sio_reg_bclear(unsigned long base, u8 reg, u8 bit)
195 val = winbond_sio_reg_read(base, reg);
197 winbond_sio_reg_write(base, reg, val);
200 static bool winbond_sio_reg_btest(unsigned long base, u8 reg, u8 bit)
202 return winbond_sio_reg_read(base, reg) & BIT(bit);
206 * struct winbond_gpio_port_conflict - possibly conflicting device information
207 * @name: device name (NULL means no conflicting device defined)
208 * @dev: Super I/O logical device number where the testreg register
209 * is located (or WB_SIO_DEV_NONE - don't select any
211 * @testreg: register number where the testbit bit is located
212 * @testbit: index of a bit to check whether an actual conflict exists
213 * @warnonly: if set then a conflict isn't fatal (just warn about it),
214 * otherwise disable the particular GPIO port if a conflict
217 struct winbond_gpio_port_conflict {
226 * struct winbond_gpio_info - information about a particular GPIO port (device)
227 * @dev: Super I/O logical device number of the registers
229 * @enablereg: port enable bit register number
230 * @enablebit: index of a port enable bit
231 * @outputreg: output driver mode bit register number
232 * @outputppbit: index of a push-pull output driver mode bit
233 * @ioreg: data direction register number
234 * @invreg: pin data inversion register number
235 * @datareg: pin data register number
236 * @conflict: description of a device that possibly conflicts with
239 struct winbond_gpio_info {
248 struct winbond_gpio_port_conflict conflict;
251 static const struct winbond_gpio_info winbond_gpio_infos[6] = {
253 .dev = WB_SIO_DEV_GPIO12,
254 .enablereg = WB_SIO_GPIO12_REG_ENABLE,
255 .enablebit = WB_SIO_GPIO12_ENABLE_1,
256 .outputreg = WB_SIO_REG_GPIO1_MF,
257 .outputppbit = WB_SIO_REG_G1MF_G1PP,
258 .ioreg = WB_SIO_GPIO12_REG_IO1,
259 .invreg = WB_SIO_GPIO12_REG_INV1,
260 .datareg = WB_SIO_GPIO12_REG_DATA1,
263 .dev = WB_SIO_DEV_UARTB,
264 .testreg = WB_SIO_UARTB_REG_ENABLE,
265 .testbit = WB_SIO_UARTB_ENABLE_ON,
270 .dev = WB_SIO_DEV_GPIO12,
271 .enablereg = WB_SIO_GPIO12_REG_ENABLE,
272 .enablebit = WB_SIO_GPIO12_ENABLE_2,
273 .outputreg = WB_SIO_REG_GPIO1_MF,
274 .outputppbit = WB_SIO_REG_G1MF_G2PP,
275 .ioreg = WB_SIO_GPIO12_REG_IO2,
276 .invreg = WB_SIO_GPIO12_REG_INV2,
277 .datareg = WB_SIO_GPIO12_REG_DATA2
278 /* special conflict handling so doesn't use conflict data */
281 .dev = WB_SIO_DEV_GPIO34,
282 .enablereg = WB_SIO_GPIO34_REG_ENABLE,
283 .enablebit = WB_SIO_GPIO34_ENABLE_3,
284 .outputreg = WB_SIO_REG_OVTGPIO3456,
285 .outputppbit = WB_SIO_REG_OG3456_G3PP,
286 .ioreg = WB_SIO_GPIO34_REG_IO3,
287 .invreg = WB_SIO_GPIO34_REG_INV3,
288 .datareg = WB_SIO_GPIO34_REG_DATA3,
291 .dev = WB_SIO_DEV_UARTC,
292 .testreg = WB_SIO_UARTC_REG_ENABLE,
293 .testbit = WB_SIO_UARTC_ENABLE_ON,
298 .dev = WB_SIO_DEV_GPIO34,
299 .enablereg = WB_SIO_GPIO34_REG_ENABLE,
300 .enablebit = WB_SIO_GPIO34_ENABLE_4,
301 .outputreg = WB_SIO_REG_OVTGPIO3456,
302 .outputppbit = WB_SIO_REG_OG3456_G4PP,
303 .ioreg = WB_SIO_GPIO34_REG_IO4,
304 .invreg = WB_SIO_GPIO34_REG_INV4,
305 .datareg = WB_SIO_GPIO34_REG_DATA4,
308 .dev = WB_SIO_DEV_UARTD,
309 .testreg = WB_SIO_UARTD_REG_ENABLE,
310 .testbit = WB_SIO_UARTD_ENABLE_ON,
315 .dev = WB_SIO_DEV_WDGPIO56,
316 .enablereg = WB_SIO_WDGPIO56_REG_ENABLE,
317 .enablebit = WB_SIO_WDGPIO56_ENABLE_5,
318 .outputreg = WB_SIO_REG_OVTGPIO3456,
319 .outputppbit = WB_SIO_REG_OG3456_G5PP,
320 .ioreg = WB_SIO_WDGPIO56_REG_IO5,
321 .invreg = WB_SIO_WDGPIO56_REG_INV5,
322 .datareg = WB_SIO_WDGPIO56_REG_DATA5,
325 .dev = WB_SIO_DEV_UARTE,
326 .testreg = WB_SIO_UARTE_REG_ENABLE,
327 .testbit = WB_SIO_UARTE_ENABLE_ON,
332 .dev = WB_SIO_DEV_WDGPIO56,
333 .enablereg = WB_SIO_WDGPIO56_REG_ENABLE,
334 .enablebit = WB_SIO_WDGPIO56_ENABLE_6,
335 .outputreg = WB_SIO_REG_OVTGPIO3456,
336 .outputppbit = WB_SIO_REG_OG3456_G6PP,
337 .ioreg = WB_SIO_WDGPIO56_REG_IO6,
338 .invreg = WB_SIO_WDGPIO56_REG_INV6,
339 .datareg = WB_SIO_WDGPIO56_REG_DATA6,
342 .dev = WB_SIO_DEV_NONE,
343 .testreg = WB_SIO_REG_GLOBAL_OPT,
344 .testbit = WB_SIO_REG_GO_ENFDC,
350 /* returns whether changing a pin is allowed */
351 static bool winbond_gpio_get_info(unsigned int *gpio_num,
352 const struct winbond_gpio_info **info)
354 bool allow_changing = true;
357 for_each_set_bit(i, ¶ms.gpios, BITS_PER_LONG) {
364 *info = &winbond_gpio_infos[i];
367 * GPIO2 (the second port) shares some pins with a basic PC
368 * functionality, which is very likely controlled by the firmware.
369 * Don't allow changing these pins by default.
372 if (*gpio_num == 0 && !params.pledgpio)
373 allow_changing = false;
374 else if (*gpio_num == 1 && !params.beepgpio)
375 allow_changing = false;
376 else if ((*gpio_num == 5 || *gpio_num == 6) && !params.i2cgpio)
377 allow_changing = false;
380 return allow_changing;
383 static int winbond_gpio_get(struct gpio_chip *gc, unsigned int offset)
385 unsigned long *base = gpiochip_get_data(gc);
386 const struct winbond_gpio_info *info;
390 winbond_gpio_get_info(&offset, &info);
392 ret = winbond_sio_enter(*base);
396 winbond_sio_select_logical(*base, info->dev);
398 val = winbond_sio_reg_btest(*base, info->datareg, offset);
399 if (winbond_sio_reg_btest(*base, info->invreg, offset))
402 winbond_sio_leave(*base);
407 static int winbond_gpio_direction_in(struct gpio_chip *gc, unsigned int offset)
409 unsigned long *base = gpiochip_get_data(gc);
410 const struct winbond_gpio_info *info;
413 if (!winbond_gpio_get_info(&offset, &info))
416 ret = winbond_sio_enter(*base);
420 winbond_sio_select_logical(*base, info->dev);
422 winbond_sio_reg_bset(*base, info->ioreg, offset);
424 winbond_sio_leave(*base);
429 static int winbond_gpio_direction_out(struct gpio_chip *gc,
433 unsigned long *base = gpiochip_get_data(gc);
434 const struct winbond_gpio_info *info;
437 if (!winbond_gpio_get_info(&offset, &info))
440 ret = winbond_sio_enter(*base);
444 winbond_sio_select_logical(*base, info->dev);
446 winbond_sio_reg_bclear(*base, info->ioreg, offset);
448 if (winbond_sio_reg_btest(*base, info->invreg, offset))
452 winbond_sio_reg_bset(*base, info->datareg, offset);
454 winbond_sio_reg_bclear(*base, info->datareg, offset);
456 winbond_sio_leave(*base);
461 static void winbond_gpio_set(struct gpio_chip *gc, unsigned int offset,
464 unsigned long *base = gpiochip_get_data(gc);
465 const struct winbond_gpio_info *info;
467 if (!winbond_gpio_get_info(&offset, &info))
470 if (winbond_sio_enter(*base) != 0)
473 winbond_sio_select_logical(*base, info->dev);
475 if (winbond_sio_reg_btest(*base, info->invreg, offset))
479 winbond_sio_reg_bset(*base, info->datareg, offset);
481 winbond_sio_reg_bclear(*base, info->datareg, offset);
483 winbond_sio_leave(*base);
486 static struct gpio_chip winbond_gpio_chip = {
488 .label = WB_GPIO_DRIVER_NAME,
489 .owner = THIS_MODULE,
491 .get = winbond_gpio_get,
492 .direction_input = winbond_gpio_direction_in,
493 .set = winbond_gpio_set,
494 .direction_output = winbond_gpio_direction_out,
497 static void winbond_gpio_configure_port0_pins(unsigned long base)
501 val = winbond_sio_reg_read(base, WB_SIO_REG_GPIO1_MF);
502 if ((val & WB_SIO_REG_G1MF_FS_MASK) == WB_SIO_REG_G1MF_FS_GPIO1)
505 pr_warn("GPIO1 pins were connected to something else (%.2x), fixing\n",
508 val &= ~WB_SIO_REG_G1MF_FS_MASK;
509 val |= WB_SIO_REG_G1MF_FS_GPIO1;
511 winbond_sio_reg_write(base, WB_SIO_REG_GPIO1_MF, val);
514 static void winbond_gpio_configure_port1_check_i2c(unsigned long base)
516 params.i2cgpio = !winbond_sio_reg_btest(base, WB_SIO_REG_I2C_PS,
517 WB_SIO_REG_I2CPS_I2CFS);
519 pr_warn("disabling GPIO2.5 and GPIO2.6 as I2C is enabled\n");
522 static bool winbond_gpio_configure_port(unsigned long base, unsigned int idx)
524 const struct winbond_gpio_info *info = &winbond_gpio_infos[idx];
525 const struct winbond_gpio_port_conflict *conflict = &info->conflict;
527 /* is there a possible conflicting device defined? */
528 if (conflict->name != NULL) {
529 if (conflict->dev != WB_SIO_DEV_NONE)
530 winbond_sio_select_logical(base, conflict->dev);
532 if (winbond_sio_reg_btest(base, conflict->testreg,
533 conflict->testbit)) {
534 if (conflict->warnonly)
535 pr_warn("enabled GPIO%u share pins with active %s\n",
536 idx + 1, conflict->name);
538 pr_warn("disabling GPIO%u as %s is enabled\n",
539 idx + 1, conflict->name);
545 /* GPIO1 and GPIO2 need some (additional) special handling */
547 winbond_gpio_configure_port0_pins(base);
549 winbond_gpio_configure_port1_check_i2c(base);
551 winbond_sio_select_logical(base, info->dev);
553 winbond_sio_reg_bset(base, info->enablereg, info->enablebit);
555 if (params.ppgpios & BIT(idx))
556 winbond_sio_reg_bset(base, info->outputreg,
558 else if (params.odgpios & BIT(idx))
559 winbond_sio_reg_bclear(base, info->outputreg,
562 pr_notice("GPIO%u pins are %s\n", idx + 1,
563 winbond_sio_reg_btest(base, info->outputreg,
571 static int winbond_gpio_configure(unsigned long base)
575 for_each_set_bit(i, ¶ms.gpios, BITS_PER_LONG)
576 if (!winbond_gpio_configure_port(base, i))
577 __clear_bit(i, ¶ms.gpios);
580 pr_err("please use 'gpios' module parameter to select some active GPIO ports to enable\n");
587 static int winbond_gpio_check_chip(unsigned long base)
592 ret = winbond_sio_enter(base);
596 chip = winbond_sio_reg_read(base, WB_SIO_REG_CHIP_MSB) << 8;
597 chip |= winbond_sio_reg_read(base, WB_SIO_REG_CHIP_LSB);
599 pr_notice("chip ID at %lx is %.4x\n", base, chip);
601 if ((chip & WB_SIO_CHIP_ID_W83627UHG_MASK) !=
602 WB_SIO_CHIP_ID_W83627UHG) {
603 pr_err("not an our chip\n");
607 winbond_sio_leave(base);
612 static int winbond_gpio_imatch(struct device *dev, unsigned int id)
614 unsigned long gpios_rem;
617 gpios_rem = params.gpios & ~GENMASK(ARRAY_SIZE(winbond_gpio_infos) - 1,
620 pr_warn("unknown ports (%lx) enabled in GPIO ports bitmask\n",
622 params.gpios &= ~gpios_rem;
625 if (params.ppgpios & params.odgpios) {
626 pr_err("some GPIO ports are set both to push-pull and open drain mode at the same time\n");
630 if (params.base != 0)
631 return winbond_gpio_check_chip(params.base) == 0;
634 * if the 'base' module parameter is unset probe two chip default
637 params.base = WB_SIO_BASE;
638 ret = winbond_gpio_check_chip(params.base);
641 if (ret != -ENODEV && ret != -EBUSY)
644 params.base = WB_SIO_BASE_HIGH;
645 return winbond_gpio_check_chip(params.base) == 0;
648 static int winbond_gpio_iprobe(struct device *dev, unsigned int id)
652 if (params.base == 0)
655 ret = winbond_sio_enter(params.base);
659 ret = winbond_gpio_configure(params.base);
661 winbond_sio_leave(params.base);
667 * Add 8 gpios for every GPIO port that was enabled in gpios
668 * module parameter (that wasn't disabled earlier in
669 * winbond_gpio_configure() & co. due to, for example, a pin conflict).
671 winbond_gpio_chip.ngpio = hweight_long(params.gpios) * 8;
674 * GPIO6 port has only 5 pins, so if it is enabled we have to adjust
675 * the total count appropriately
677 if (params.gpios & BIT(5))
678 winbond_gpio_chip.ngpio -= (8 - 5);
680 winbond_gpio_chip.parent = dev;
682 return devm_gpiochip_add_data(dev, &winbond_gpio_chip, ¶ms.base);
685 static struct isa_driver winbond_gpio_idriver = {
687 .name = WB_GPIO_DRIVER_NAME,
689 .match = winbond_gpio_imatch,
690 .probe = winbond_gpio_iprobe,
693 module_isa_driver(winbond_gpio_idriver, 1);
695 module_param_named(base, params.base, ulong, 0444);
696 MODULE_PARM_DESC(base,
697 "I/O port base (when unset - probe chip default ones)");
699 /* This parameter sets which GPIO devices (ports) we enable */
700 module_param_named(gpios, params.gpios, ulong, 0444);
701 MODULE_PARM_DESC(gpios,
702 "bitmask of GPIO ports to enable (bit 0 - GPIO1, bit 1 - GPIO2, etc.");
705 * These two parameters below set how we configure GPIO ports output drivers.
706 * It can't be a one bitmask since we need three values per port: push-pull,
707 * open-drain and keep as-is (this is the default).
709 module_param_named(ppgpios, params.ppgpios, ulong, 0444);
710 MODULE_PARM_DESC(ppgpios,
711 "bitmask of GPIO ports to set to push-pull mode (bit 0 - GPIO1, bit 1 - GPIO2, etc.");
713 module_param_named(odgpios, params.odgpios, ulong, 0444);
714 MODULE_PARM_DESC(odgpios,
715 "bitmask of GPIO ports to set to open drain mode (bit 0 - GPIO1, bit 1 - GPIO2, etc.");
718 * GPIO2.0 and GPIO2.1 control a basic PC functionality that we
719 * don't allow tinkering with by default (it is very likely that the
720 * firmware owns these pins).
721 * These two parameters below allow overriding these prohibitions.
723 module_param_named(pledgpio, params.pledgpio, bool, 0644);
724 MODULE_PARM_DESC(pledgpio,
725 "enable changing value of GPIO2.0 bit (Power LED), default no.");
727 module_param_named(beepgpio, params.beepgpio, bool, 0644);
728 MODULE_PARM_DESC(beepgpio,
729 "enable changing value of GPIO2.1 bit (BEEP), default no.");
731 MODULE_AUTHOR("Maciej S. Szmigiero <mail@maciej.szmigiero.name>");
732 MODULE_DESCRIPTION("GPIO interface for Winbond Super I/O chips");
733 MODULE_LICENSE("GPL");