include: replace linux/module.h with "struct module" wherever possible
[linux-2.6/next.git] / drivers / input / serio / i8042.c
blobd37a48e099d0d0c63441f28c6da2a77488797cfd
1 /*
2 * i8042 keyboard and mouse controller driver for Linux
4 * Copyright (c) 1999-2004 Vojtech Pavlik
5 */
7 /*
8 * This program is free software; you can redistribute it and/or modify it
9 * under the terms of the GNU General Public License version 2 as published by
10 * the Free Software Foundation.
13 #define pr_fmt(fmt) KBUILD_MODNAME ": " fmt
15 #include <linux/types.h>
16 #include <linux/delay.h>
17 #include <linux/module.h>
18 #include <linux/interrupt.h>
19 #include <linux/ioport.h>
20 #include <linux/init.h>
21 #include <linux/serio.h>
22 #include <linux/err.h>
23 #include <linux/rcupdate.h>
24 #include <linux/platform_device.h>
25 #include <linux/i8042.h>
26 #include <linux/slab.h>
28 #include <asm/io.h>
30 MODULE_AUTHOR("Vojtech Pavlik <vojtech@suse.cz>");
31 MODULE_DESCRIPTION("i8042 keyboard and mouse controller driver");
32 MODULE_LICENSE("GPL");
34 static bool i8042_nokbd;
35 module_param_named(nokbd, i8042_nokbd, bool, 0);
36 MODULE_PARM_DESC(nokbd, "Do not probe or use KBD port.");
38 static bool i8042_noaux;
39 module_param_named(noaux, i8042_noaux, bool, 0);
40 MODULE_PARM_DESC(noaux, "Do not probe or use AUX (mouse) port.");
42 static bool i8042_nomux;
43 module_param_named(nomux, i8042_nomux, bool, 0);
44 MODULE_PARM_DESC(nomux, "Do not check whether an active multiplexing controller is present.");
46 static bool i8042_unlock;
47 module_param_named(unlock, i8042_unlock, bool, 0);
48 MODULE_PARM_DESC(unlock, "Ignore keyboard lock.");
50 static bool i8042_reset;
51 module_param_named(reset, i8042_reset, bool, 0);
52 MODULE_PARM_DESC(reset, "Reset controller during init and cleanup.");
54 static bool i8042_direct;
55 module_param_named(direct, i8042_direct, bool, 0);
56 MODULE_PARM_DESC(direct, "Put keyboard port into non-translated mode.");
58 static bool i8042_dumbkbd;
59 module_param_named(dumbkbd, i8042_dumbkbd, bool, 0);
60 MODULE_PARM_DESC(dumbkbd, "Pretend that controller can only read data from keyboard");
62 static bool i8042_noloop;
63 module_param_named(noloop, i8042_noloop, bool, 0);
64 MODULE_PARM_DESC(noloop, "Disable the AUX Loopback command while probing for the AUX port");
66 static bool i8042_notimeout;
67 module_param_named(notimeout, i8042_notimeout, bool, 0);
68 MODULE_PARM_DESC(notimeout, "Ignore timeouts signalled by i8042");
70 #ifdef CONFIG_X86
71 static bool i8042_dritek;
72 module_param_named(dritek, i8042_dritek, bool, 0);
73 MODULE_PARM_DESC(dritek, "Force enable the Dritek keyboard extension");
74 #endif
76 #ifdef CONFIG_PNP
77 static bool i8042_nopnp;
78 module_param_named(nopnp, i8042_nopnp, bool, 0);
79 MODULE_PARM_DESC(nopnp, "Do not use PNP to detect controller settings");
80 #endif
82 #define DEBUG
83 #ifdef DEBUG
84 static bool i8042_debug;
85 module_param_named(debug, i8042_debug, bool, 0600);
86 MODULE_PARM_DESC(debug, "Turn i8042 debugging mode on and off");
87 #endif
89 static bool i8042_bypass_aux_irq_test;
91 #include "i8042.h"
94 * i8042_lock protects serialization between i8042_command and
95 * the interrupt handler.
97 static DEFINE_SPINLOCK(i8042_lock);
100 * Writers to AUX and KBD ports as well as users issuing i8042_command
101 * directly should acquire i8042_mutex (by means of calling
102 * i8042_lock_chip() and i8042_unlock_ship() helpers) to ensure that
103 * they do not disturb each other (unfortunately in many i8042
104 * implementations write to one of the ports will immediately abort
105 * command that is being processed by another port).
107 static DEFINE_MUTEX(i8042_mutex);
109 struct i8042_port {
110 struct serio *serio;
111 int irq;
112 bool exists;
113 signed char mux;
116 #define I8042_KBD_PORT_NO 0
117 #define I8042_AUX_PORT_NO 1
118 #define I8042_MUX_PORT_NO 2
119 #define I8042_NUM_PORTS (I8042_NUM_MUX_PORTS + 2)
121 static struct i8042_port i8042_ports[I8042_NUM_PORTS];
123 static unsigned char i8042_initial_ctr;
124 static unsigned char i8042_ctr;
125 static bool i8042_mux_present;
126 static bool i8042_kbd_irq_registered;
127 static bool i8042_aux_irq_registered;
128 static unsigned char i8042_suppress_kbd_ack;
129 static struct platform_device *i8042_platform_device;
131 static irqreturn_t i8042_interrupt(int irq, void *dev_id);
132 static bool (*i8042_platform_filter)(unsigned char data, unsigned char str,
133 struct serio *serio);
135 void i8042_lock_chip(void)
137 mutex_lock(&i8042_mutex);
139 EXPORT_SYMBOL(i8042_lock_chip);
141 void i8042_unlock_chip(void)
143 mutex_unlock(&i8042_mutex);
145 EXPORT_SYMBOL(i8042_unlock_chip);
147 int i8042_install_filter(bool (*filter)(unsigned char data, unsigned char str,
148 struct serio *serio))
150 unsigned long flags;
151 int ret = 0;
153 spin_lock_irqsave(&i8042_lock, flags);
155 if (i8042_platform_filter) {
156 ret = -EBUSY;
157 goto out;
160 i8042_platform_filter = filter;
162 out:
163 spin_unlock_irqrestore(&i8042_lock, flags);
164 return ret;
166 EXPORT_SYMBOL(i8042_install_filter);
168 int i8042_remove_filter(bool (*filter)(unsigned char data, unsigned char str,
169 struct serio *port))
171 unsigned long flags;
172 int ret = 0;
174 spin_lock_irqsave(&i8042_lock, flags);
176 if (i8042_platform_filter != filter) {
177 ret = -EINVAL;
178 goto out;
181 i8042_platform_filter = NULL;
183 out:
184 spin_unlock_irqrestore(&i8042_lock, flags);
185 return ret;
187 EXPORT_SYMBOL(i8042_remove_filter);
190 * The i8042_wait_read() and i8042_wait_write functions wait for the i8042 to
191 * be ready for reading values from it / writing values to it.
192 * Called always with i8042_lock held.
195 static int i8042_wait_read(void)
197 int i = 0;
199 while ((~i8042_read_status() & I8042_STR_OBF) && (i < I8042_CTL_TIMEOUT)) {
200 udelay(50);
201 i++;
203 return -(i == I8042_CTL_TIMEOUT);
206 static int i8042_wait_write(void)
208 int i = 0;
210 while ((i8042_read_status() & I8042_STR_IBF) && (i < I8042_CTL_TIMEOUT)) {
211 udelay(50);
212 i++;
214 return -(i == I8042_CTL_TIMEOUT);
218 * i8042_flush() flushes all data that may be in the keyboard and mouse buffers
219 * of the i8042 down the toilet.
222 static int i8042_flush(void)
224 unsigned long flags;
225 unsigned char data, str;
226 int i = 0;
228 spin_lock_irqsave(&i8042_lock, flags);
230 while (((str = i8042_read_status()) & I8042_STR_OBF) && (i < I8042_BUFFER_SIZE)) {
231 udelay(50);
232 data = i8042_read_data();
233 i++;
234 dbg("%02x <- i8042 (flush, %s)\n",
235 data, str & I8042_STR_AUXDATA ? "aux" : "kbd");
238 spin_unlock_irqrestore(&i8042_lock, flags);
240 return i;
244 * i8042_command() executes a command on the i8042. It also sends the input
245 * parameter(s) of the commands to it, and receives the output value(s). The
246 * parameters are to be stored in the param array, and the output is placed
247 * into the same array. The number of the parameters and output values is
248 * encoded in bits 8-11 of the command number.
251 static int __i8042_command(unsigned char *param, int command)
253 int i, error;
255 if (i8042_noloop && command == I8042_CMD_AUX_LOOP)
256 return -1;
258 error = i8042_wait_write();
259 if (error)
260 return error;
262 dbg("%02x -> i8042 (command)\n", command & 0xff);
263 i8042_write_command(command & 0xff);
265 for (i = 0; i < ((command >> 12) & 0xf); i++) {
266 error = i8042_wait_write();
267 if (error)
268 return error;
269 dbg("%02x -> i8042 (parameter)\n", param[i]);
270 i8042_write_data(param[i]);
273 for (i = 0; i < ((command >> 8) & 0xf); i++) {
274 error = i8042_wait_read();
275 if (error) {
276 dbg(" -- i8042 (timeout)\n");
277 return error;
280 if (command == I8042_CMD_AUX_LOOP &&
281 !(i8042_read_status() & I8042_STR_AUXDATA)) {
282 dbg(" -- i8042 (auxerr)\n");
283 return -1;
286 param[i] = i8042_read_data();
287 dbg("%02x <- i8042 (return)\n", param[i]);
290 return 0;
293 int i8042_command(unsigned char *param, int command)
295 unsigned long flags;
296 int retval;
298 spin_lock_irqsave(&i8042_lock, flags);
299 retval = __i8042_command(param, command);
300 spin_unlock_irqrestore(&i8042_lock, flags);
302 return retval;
304 EXPORT_SYMBOL(i8042_command);
307 * i8042_kbd_write() sends a byte out through the keyboard interface.
310 static int i8042_kbd_write(struct serio *port, unsigned char c)
312 unsigned long flags;
313 int retval = 0;
315 spin_lock_irqsave(&i8042_lock, flags);
317 if (!(retval = i8042_wait_write())) {
318 dbg("%02x -> i8042 (kbd-data)\n", c);
319 i8042_write_data(c);
322 spin_unlock_irqrestore(&i8042_lock, flags);
324 return retval;
328 * i8042_aux_write() sends a byte out through the aux interface.
331 static int i8042_aux_write(struct serio *serio, unsigned char c)
333 struct i8042_port *port = serio->port_data;
335 return i8042_command(&c, port->mux == -1 ?
336 I8042_CMD_AUX_SEND :
337 I8042_CMD_MUX_SEND + port->mux);
342 * i8042_aux_close attempts to clear AUX or KBD port state by disabling
343 * and then re-enabling it.
346 static void i8042_port_close(struct serio *serio)
348 int irq_bit;
349 int disable_bit;
350 const char *port_name;
352 if (serio == i8042_ports[I8042_AUX_PORT_NO].serio) {
353 irq_bit = I8042_CTR_AUXINT;
354 disable_bit = I8042_CTR_AUXDIS;
355 port_name = "AUX";
356 } else {
357 irq_bit = I8042_CTR_KBDINT;
358 disable_bit = I8042_CTR_KBDDIS;
359 port_name = "KBD";
362 i8042_ctr &= ~irq_bit;
363 if (i8042_command(&i8042_ctr, I8042_CMD_CTL_WCTR))
364 pr_warn("Can't write CTR while closing %s port\n", port_name);
366 udelay(50);
368 i8042_ctr &= ~disable_bit;
369 i8042_ctr |= irq_bit;
370 if (i8042_command(&i8042_ctr, I8042_CMD_CTL_WCTR))
371 pr_err("Can't reactivate %s port\n", port_name);
374 * See if there is any data appeared while we were messing with
375 * port state.
377 i8042_interrupt(0, NULL);
381 * i8042_start() is called by serio core when port is about to finish
382 * registering. It will mark port as existing so i8042_interrupt can
383 * start sending data through it.
385 static int i8042_start(struct serio *serio)
387 struct i8042_port *port = serio->port_data;
389 port->exists = true;
390 mb();
391 return 0;
395 * i8042_stop() marks serio port as non-existing so i8042_interrupt
396 * will not try to send data to the port that is about to go away.
397 * The function is called by serio core as part of unregister procedure.
399 static void i8042_stop(struct serio *serio)
401 struct i8042_port *port = serio->port_data;
403 port->exists = false;
406 * We synchronize with both AUX and KBD IRQs because there is
407 * a (very unlikely) chance that AUX IRQ is raised for KBD port
408 * and vice versa.
410 synchronize_irq(I8042_AUX_IRQ);
411 synchronize_irq(I8042_KBD_IRQ);
412 port->serio = NULL;
416 * i8042_filter() filters out unwanted bytes from the input data stream.
417 * It is called from i8042_interrupt and thus is running with interrupts
418 * off and i8042_lock held.
420 static bool i8042_filter(unsigned char data, unsigned char str,
421 struct serio *serio)
423 if (unlikely(i8042_suppress_kbd_ack)) {
424 if ((~str & I8042_STR_AUXDATA) &&
425 (data == 0xfa || data == 0xfe)) {
426 i8042_suppress_kbd_ack--;
427 dbg("Extra keyboard ACK - filtered out\n");
428 return true;
432 if (i8042_platform_filter && i8042_platform_filter(data, str, serio)) {
433 dbg("Filtered out by platform filter\n");
434 return true;
437 return false;
441 * i8042_interrupt() is the most important function in this driver -
442 * it handles the interrupts from the i8042, and sends incoming bytes
443 * to the upper layers.
446 static irqreturn_t i8042_interrupt(int irq, void *dev_id)
448 struct i8042_port *port;
449 struct serio *serio;
450 unsigned long flags;
451 unsigned char str, data;
452 unsigned int dfl;
453 unsigned int port_no;
454 bool filtered;
455 int ret = 1;
457 spin_lock_irqsave(&i8042_lock, flags);
459 str = i8042_read_status();
460 if (unlikely(~str & I8042_STR_OBF)) {
461 spin_unlock_irqrestore(&i8042_lock, flags);
462 if (irq)
463 dbg("Interrupt %d, without any data\n", irq);
464 ret = 0;
465 goto out;
468 data = i8042_read_data();
470 if (i8042_mux_present && (str & I8042_STR_AUXDATA)) {
471 static unsigned long last_transmit;
472 static unsigned char last_str;
474 dfl = 0;
475 if (str & I8042_STR_MUXERR) {
476 dbg("MUX error, status is %02x, data is %02x\n",
477 str, data);
479 * When MUXERR condition is signalled the data register can only contain
480 * 0xfd, 0xfe or 0xff if implementation follows the spec. Unfortunately
481 * it is not always the case. Some KBCs also report 0xfc when there is
482 * nothing connected to the port while others sometimes get confused which
483 * port the data came from and signal error leaving the data intact. They
484 * _do not_ revert to legacy mode (actually I've never seen KBC reverting
485 * to legacy mode yet, when we see one we'll add proper handling).
486 * Anyway, we process 0xfc, 0xfd, 0xfe and 0xff as timeouts, and for the
487 * rest assume that the data came from the same serio last byte
488 * was transmitted (if transmission happened not too long ago).
491 switch (data) {
492 default:
493 if (time_before(jiffies, last_transmit + HZ/10)) {
494 str = last_str;
495 break;
497 /* fall through - report timeout */
498 case 0xfc:
499 case 0xfd:
500 case 0xfe: dfl = SERIO_TIMEOUT; data = 0xfe; break;
501 case 0xff: dfl = SERIO_PARITY; data = 0xfe; break;
505 port_no = I8042_MUX_PORT_NO + ((str >> 6) & 3);
506 last_str = str;
507 last_transmit = jiffies;
508 } else {
510 dfl = ((str & I8042_STR_PARITY) ? SERIO_PARITY : 0) |
511 ((str & I8042_STR_TIMEOUT && !i8042_notimeout) ? SERIO_TIMEOUT : 0);
513 port_no = (str & I8042_STR_AUXDATA) ?
514 I8042_AUX_PORT_NO : I8042_KBD_PORT_NO;
517 port = &i8042_ports[port_no];
518 serio = port->exists ? port->serio : NULL;
520 dbg("%02x <- i8042 (interrupt, %d, %d%s%s)\n",
521 data, port_no, irq,
522 dfl & SERIO_PARITY ? ", bad parity" : "",
523 dfl & SERIO_TIMEOUT ? ", timeout" : "");
525 filtered = i8042_filter(data, str, serio);
527 spin_unlock_irqrestore(&i8042_lock, flags);
529 if (likely(port->exists && !filtered))
530 serio_interrupt(serio, data, dfl);
532 out:
533 return IRQ_RETVAL(ret);
537 * i8042_enable_kbd_port enables keyboard port on chip
540 static int i8042_enable_kbd_port(void)
542 i8042_ctr &= ~I8042_CTR_KBDDIS;
543 i8042_ctr |= I8042_CTR_KBDINT;
545 if (i8042_command(&i8042_ctr, I8042_CMD_CTL_WCTR)) {
546 i8042_ctr &= ~I8042_CTR_KBDINT;
547 i8042_ctr |= I8042_CTR_KBDDIS;
548 pr_err("Failed to enable KBD port\n");
549 return -EIO;
552 return 0;
556 * i8042_enable_aux_port enables AUX (mouse) port on chip
559 static int i8042_enable_aux_port(void)
561 i8042_ctr &= ~I8042_CTR_AUXDIS;
562 i8042_ctr |= I8042_CTR_AUXINT;
564 if (i8042_command(&i8042_ctr, I8042_CMD_CTL_WCTR)) {
565 i8042_ctr &= ~I8042_CTR_AUXINT;
566 i8042_ctr |= I8042_CTR_AUXDIS;
567 pr_err("Failed to enable AUX port\n");
568 return -EIO;
571 return 0;
575 * i8042_enable_mux_ports enables 4 individual AUX ports after
576 * the controller has been switched into Multiplexed mode
579 static int i8042_enable_mux_ports(void)
581 unsigned char param;
582 int i;
584 for (i = 0; i < I8042_NUM_MUX_PORTS; i++) {
585 i8042_command(&param, I8042_CMD_MUX_PFX + i);
586 i8042_command(&param, I8042_CMD_AUX_ENABLE);
589 return i8042_enable_aux_port();
593 * i8042_set_mux_mode checks whether the controller has an
594 * active multiplexor and puts the chip into Multiplexed (true)
595 * or Legacy (false) mode.
598 static int i8042_set_mux_mode(bool multiplex, unsigned char *mux_version)
601 unsigned char param, val;
603 * Get rid of bytes in the queue.
606 i8042_flush();
609 * Internal loopback test - send three bytes, they should come back from the
610 * mouse interface, the last should be version.
613 param = val = 0xf0;
614 if (i8042_command(&param, I8042_CMD_AUX_LOOP) || param != val)
615 return -1;
616 param = val = multiplex ? 0x56 : 0xf6;
617 if (i8042_command(&param, I8042_CMD_AUX_LOOP) || param != val)
618 return -1;
619 param = val = multiplex ? 0xa4 : 0xa5;
620 if (i8042_command(&param, I8042_CMD_AUX_LOOP) || param == val)
621 return -1;
624 * Workaround for interference with USB Legacy emulation
625 * that causes a v10.12 MUX to be found.
627 if (param == 0xac)
628 return -1;
630 if (mux_version)
631 *mux_version = param;
633 return 0;
637 * i8042_check_mux() checks whether the controller supports the PS/2 Active
638 * Multiplexing specification by Synaptics, Phoenix, Insyde and
639 * LCS/Telegraphics.
642 static int __init i8042_check_mux(void)
644 unsigned char mux_version;
646 if (i8042_set_mux_mode(true, &mux_version))
647 return -1;
649 pr_info("Detected active multiplexing controller, rev %d.%d\n",
650 (mux_version >> 4) & 0xf, mux_version & 0xf);
653 * Disable all muxed ports by disabling AUX.
655 i8042_ctr |= I8042_CTR_AUXDIS;
656 i8042_ctr &= ~I8042_CTR_AUXINT;
658 if (i8042_command(&i8042_ctr, I8042_CMD_CTL_WCTR)) {
659 pr_err("Failed to disable AUX port, can't use MUX\n");
660 return -EIO;
663 i8042_mux_present = true;
665 return 0;
669 * The following is used to test AUX IRQ delivery.
671 static struct completion i8042_aux_irq_delivered __initdata;
672 static bool i8042_irq_being_tested __initdata;
674 static irqreturn_t __init i8042_aux_test_irq(int irq, void *dev_id)
676 unsigned long flags;
677 unsigned char str, data;
678 int ret = 0;
680 spin_lock_irqsave(&i8042_lock, flags);
681 str = i8042_read_status();
682 if (str & I8042_STR_OBF) {
683 data = i8042_read_data();
684 dbg("%02x <- i8042 (aux_test_irq, %s)\n",
685 data, str & I8042_STR_AUXDATA ? "aux" : "kbd");
686 if (i8042_irq_being_tested &&
687 data == 0xa5 && (str & I8042_STR_AUXDATA))
688 complete(&i8042_aux_irq_delivered);
689 ret = 1;
691 spin_unlock_irqrestore(&i8042_lock, flags);
693 return IRQ_RETVAL(ret);
697 * i8042_toggle_aux - enables or disables AUX port on i8042 via command and
698 * verifies success by readinng CTR. Used when testing for presence of AUX
699 * port.
701 static int __init i8042_toggle_aux(bool on)
703 unsigned char param;
704 int i;
706 if (i8042_command(&param,
707 on ? I8042_CMD_AUX_ENABLE : I8042_CMD_AUX_DISABLE))
708 return -1;
710 /* some chips need some time to set the I8042_CTR_AUXDIS bit */
711 for (i = 0; i < 100; i++) {
712 udelay(50);
714 if (i8042_command(&param, I8042_CMD_CTL_RCTR))
715 return -1;
717 if (!(param & I8042_CTR_AUXDIS) == on)
718 return 0;
721 return -1;
725 * i8042_check_aux() applies as much paranoia as it can at detecting
726 * the presence of an AUX interface.
729 static int __init i8042_check_aux(void)
731 int retval = -1;
732 bool irq_registered = false;
733 bool aux_loop_broken = false;
734 unsigned long flags;
735 unsigned char param;
738 * Get rid of bytes in the queue.
741 i8042_flush();
744 * Internal loopback test - filters out AT-type i8042's. Unfortunately
745 * SiS screwed up and their 5597 doesn't support the LOOP command even
746 * though it has an AUX port.
749 param = 0x5a;
750 retval = i8042_command(&param, I8042_CMD_AUX_LOOP);
751 if (retval || param != 0x5a) {
754 * External connection test - filters out AT-soldered PS/2 i8042's
755 * 0x00 - no error, 0x01-0x03 - clock/data stuck, 0xff - general error
756 * 0xfa - no error on some notebooks which ignore the spec
757 * Because it's common for chipsets to return error on perfectly functioning
758 * AUX ports, we test for this only when the LOOP command failed.
761 if (i8042_command(&param, I8042_CMD_AUX_TEST) ||
762 (param && param != 0xfa && param != 0xff))
763 return -1;
766 * If AUX_LOOP completed without error but returned unexpected data
767 * mark it as broken
769 if (!retval)
770 aux_loop_broken = true;
774 * Bit assignment test - filters out PS/2 i8042's in AT mode
777 if (i8042_toggle_aux(false)) {
778 pr_warn("Failed to disable AUX port, but continuing anyway... Is this a SiS?\n");
779 pr_warn("If AUX port is really absent please use the 'i8042.noaux' option\n");
782 if (i8042_toggle_aux(true))
783 return -1;
786 * Test AUX IRQ delivery to make sure BIOS did not grab the IRQ and
787 * used it for a PCI card or somethig else.
790 if (i8042_noloop || i8042_bypass_aux_irq_test || aux_loop_broken) {
792 * Without LOOP command we can't test AUX IRQ delivery. Assume the port
793 * is working and hope we are right.
795 retval = 0;
796 goto out;
799 if (request_irq(I8042_AUX_IRQ, i8042_aux_test_irq, IRQF_SHARED,
800 "i8042", i8042_platform_device))
801 goto out;
803 irq_registered = true;
805 if (i8042_enable_aux_port())
806 goto out;
808 spin_lock_irqsave(&i8042_lock, flags);
810 init_completion(&i8042_aux_irq_delivered);
811 i8042_irq_being_tested = true;
813 param = 0xa5;
814 retval = __i8042_command(&param, I8042_CMD_AUX_LOOP & 0xf0ff);
816 spin_unlock_irqrestore(&i8042_lock, flags);
818 if (retval)
819 goto out;
821 if (wait_for_completion_timeout(&i8042_aux_irq_delivered,
822 msecs_to_jiffies(250)) == 0) {
824 * AUX IRQ was never delivered so we need to flush the controller to
825 * get rid of the byte we put there; otherwise keyboard may not work.
827 dbg(" -- i8042 (aux irq test timeout)\n");
828 i8042_flush();
829 retval = -1;
832 out:
835 * Disable the interface.
838 i8042_ctr |= I8042_CTR_AUXDIS;
839 i8042_ctr &= ~I8042_CTR_AUXINT;
841 if (i8042_command(&i8042_ctr, I8042_CMD_CTL_WCTR))
842 retval = -1;
844 if (irq_registered)
845 free_irq(I8042_AUX_IRQ, i8042_platform_device);
847 return retval;
850 static int i8042_controller_check(void)
852 if (i8042_flush() == I8042_BUFFER_SIZE) {
853 pr_err("No controller found\n");
854 return -ENODEV;
857 return 0;
860 static int i8042_controller_selftest(void)
862 unsigned char param;
863 int i = 0;
866 * We try this 5 times; on some really fragile systems this does not
867 * take the first time...
869 do {
871 if (i8042_command(&param, I8042_CMD_CTL_TEST)) {
872 pr_err("i8042 controller selftest timeout\n");
873 return -ENODEV;
876 if (param == I8042_RET_CTL_TEST)
877 return 0;
879 dbg("i8042 controller selftest: %#x != %#x\n",
880 param, I8042_RET_CTL_TEST);
881 msleep(50);
882 } while (i++ < 5);
884 #ifdef CONFIG_X86
886 * On x86, we don't fail entire i8042 initialization if controller
887 * reset fails in hopes that keyboard port will still be functional
888 * and user will still get a working keyboard. This is especially
889 * important on netbooks. On other arches we trust hardware more.
891 pr_info("giving up on controller selftest, continuing anyway...\n");
892 return 0;
893 #else
894 pr_err("i8042 controller selftest failed\n");
895 return -EIO;
896 #endif
900 * i8042_controller init initializes the i8042 controller, and,
901 * most importantly, sets it into non-xlated mode if that's
902 * desired.
905 static int i8042_controller_init(void)
907 unsigned long flags;
908 int n = 0;
909 unsigned char ctr[2];
912 * Save the CTR for restore on unload / reboot.
915 do {
916 if (n >= 10) {
917 pr_err("Unable to get stable CTR read\n");
918 return -EIO;
921 if (n != 0)
922 udelay(50);
924 if (i8042_command(&ctr[n++ % 2], I8042_CMD_CTL_RCTR)) {
925 pr_err("Can't read CTR while initializing i8042\n");
926 return -EIO;
929 } while (n < 2 || ctr[0] != ctr[1]);
931 i8042_initial_ctr = i8042_ctr = ctr[0];
934 * Disable the keyboard interface and interrupt.
937 i8042_ctr |= I8042_CTR_KBDDIS;
938 i8042_ctr &= ~I8042_CTR_KBDINT;
941 * Handle keylock.
944 spin_lock_irqsave(&i8042_lock, flags);
945 if (~i8042_read_status() & I8042_STR_KEYLOCK) {
946 if (i8042_unlock)
947 i8042_ctr |= I8042_CTR_IGNKEYLOCK;
948 else
949 pr_warn("Warning: Keylock active\n");
951 spin_unlock_irqrestore(&i8042_lock, flags);
954 * If the chip is configured into nontranslated mode by the BIOS, don't
955 * bother enabling translating and be happy.
958 if (~i8042_ctr & I8042_CTR_XLATE)
959 i8042_direct = true;
962 * Set nontranslated mode for the kbd interface if requested by an option.
963 * After this the kbd interface becomes a simple serial in/out, like the aux
964 * interface is. We don't do this by default, since it can confuse notebook
965 * BIOSes.
968 if (i8042_direct)
969 i8042_ctr &= ~I8042_CTR_XLATE;
972 * Write CTR back.
975 if (i8042_command(&i8042_ctr, I8042_CMD_CTL_WCTR)) {
976 pr_err("Can't write CTR while initializing i8042\n");
977 return -EIO;
981 * Flush whatever accumulated while we were disabling keyboard port.
984 i8042_flush();
986 return 0;
991 * Reset the controller and reset CRT to the original value set by BIOS.
994 static void i8042_controller_reset(void)
996 i8042_flush();
999 * Disable both KBD and AUX interfaces so they don't get in the way
1002 i8042_ctr |= I8042_CTR_KBDDIS | I8042_CTR_AUXDIS;
1003 i8042_ctr &= ~(I8042_CTR_KBDINT | I8042_CTR_AUXINT);
1005 if (i8042_command(&i8042_ctr, I8042_CMD_CTL_WCTR))
1006 pr_warn("Can't write CTR while resetting\n");
1009 * Disable MUX mode if present.
1012 if (i8042_mux_present)
1013 i8042_set_mux_mode(false, NULL);
1016 * Reset the controller if requested.
1019 if (i8042_reset)
1020 i8042_controller_selftest();
1023 * Restore the original control register setting.
1026 if (i8042_command(&i8042_initial_ctr, I8042_CMD_CTL_WCTR))
1027 pr_warn("Can't restore CTR\n");
1032 * i8042_panic_blink() will turn the keyboard LEDs on or off and is called
1033 * when kernel panics. Flashing LEDs is useful for users running X who may
1034 * not see the console and will help distingushing panics from "real"
1035 * lockups.
1037 * Note that DELAY has a limit of 10ms so we will not get stuck here
1038 * waiting for KBC to free up even if KBD interrupt is off
1041 #define DELAY do { mdelay(1); if (++delay > 10) return delay; } while(0)
1043 static long i8042_panic_blink(int state)
1045 long delay = 0;
1046 char led;
1048 led = (state) ? 0x01 | 0x04 : 0;
1049 while (i8042_read_status() & I8042_STR_IBF)
1050 DELAY;
1051 dbg("%02x -> i8042 (panic blink)\n", 0xed);
1052 i8042_suppress_kbd_ack = 2;
1053 i8042_write_data(0xed); /* set leds */
1054 DELAY;
1055 while (i8042_read_status() & I8042_STR_IBF)
1056 DELAY;
1057 DELAY;
1058 dbg("%02x -> i8042 (panic blink)\n", led);
1059 i8042_write_data(led);
1060 DELAY;
1061 return delay;
1064 #undef DELAY
1066 #ifdef CONFIG_X86
1067 static void i8042_dritek_enable(void)
1069 unsigned char param = 0x90;
1070 int error;
1072 error = i8042_command(&param, 0x1059);
1073 if (error)
1074 pr_warn("Failed to enable DRITEK extension: %d\n", error);
1076 #endif
1078 #ifdef CONFIG_PM
1081 * Here we try to reset everything back to a state we had
1082 * before suspending.
1085 static int i8042_controller_resume(bool force_reset)
1087 int error;
1089 error = i8042_controller_check();
1090 if (error)
1091 return error;
1093 if (i8042_reset || force_reset) {
1094 error = i8042_controller_selftest();
1095 if (error)
1096 return error;
1100 * Restore original CTR value and disable all ports
1103 i8042_ctr = i8042_initial_ctr;
1104 if (i8042_direct)
1105 i8042_ctr &= ~I8042_CTR_XLATE;
1106 i8042_ctr |= I8042_CTR_AUXDIS | I8042_CTR_KBDDIS;
1107 i8042_ctr &= ~(I8042_CTR_AUXINT | I8042_CTR_KBDINT);
1108 if (i8042_command(&i8042_ctr, I8042_CMD_CTL_WCTR)) {
1109 pr_warn("Can't write CTR to resume, retrying...\n");
1110 msleep(50);
1111 if (i8042_command(&i8042_ctr, I8042_CMD_CTL_WCTR)) {
1112 pr_err("CTR write retry failed\n");
1113 return -EIO;
1118 #ifdef CONFIG_X86
1119 if (i8042_dritek)
1120 i8042_dritek_enable();
1121 #endif
1123 if (i8042_mux_present) {
1124 if (i8042_set_mux_mode(true, NULL) || i8042_enable_mux_ports())
1125 pr_warn("failed to resume active multiplexor, mouse won't work\n");
1126 } else if (i8042_ports[I8042_AUX_PORT_NO].serio)
1127 i8042_enable_aux_port();
1129 if (i8042_ports[I8042_KBD_PORT_NO].serio)
1130 i8042_enable_kbd_port();
1132 i8042_interrupt(0, NULL);
1134 return 0;
1138 * Here we try to restore the original BIOS settings to avoid
1139 * upsetting it.
1142 static int i8042_pm_reset(struct device *dev)
1144 i8042_controller_reset();
1146 return 0;
1149 static int i8042_pm_resume(struct device *dev)
1152 * On resume from S2R we always try to reset the controller
1153 * to bring it in a sane state. (In case of S2D we expect
1154 * BIOS to reset the controller for us.)
1156 return i8042_controller_resume(true);
1159 static int i8042_pm_thaw(struct device *dev)
1161 i8042_interrupt(0, NULL);
1163 return 0;
1166 static int i8042_pm_restore(struct device *dev)
1168 return i8042_controller_resume(false);
1171 static const struct dev_pm_ops i8042_pm_ops = {
1172 .suspend = i8042_pm_reset,
1173 .resume = i8042_pm_resume,
1174 .thaw = i8042_pm_thaw,
1175 .poweroff = i8042_pm_reset,
1176 .restore = i8042_pm_restore,
1179 #endif /* CONFIG_PM */
1182 * We need to reset the 8042 back to original mode on system shutdown,
1183 * because otherwise BIOSes will be confused.
1186 static void i8042_shutdown(struct platform_device *dev)
1188 i8042_controller_reset();
1191 static int __init i8042_create_kbd_port(void)
1193 struct serio *serio;
1194 struct i8042_port *port = &i8042_ports[I8042_KBD_PORT_NO];
1196 serio = kzalloc(sizeof(struct serio), GFP_KERNEL);
1197 if (!serio)
1198 return -ENOMEM;
1200 serio->id.type = i8042_direct ? SERIO_8042 : SERIO_8042_XL;
1201 serio->write = i8042_dumbkbd ? NULL : i8042_kbd_write;
1202 serio->start = i8042_start;
1203 serio->stop = i8042_stop;
1204 serio->close = i8042_port_close;
1205 serio->port_data = port;
1206 serio->dev.parent = &i8042_platform_device->dev;
1207 strlcpy(serio->name, "i8042 KBD port", sizeof(serio->name));
1208 strlcpy(serio->phys, I8042_KBD_PHYS_DESC, sizeof(serio->phys));
1210 port->serio = serio;
1211 port->irq = I8042_KBD_IRQ;
1213 return 0;
1216 static int __init i8042_create_aux_port(int idx)
1218 struct serio *serio;
1219 int port_no = idx < 0 ? I8042_AUX_PORT_NO : I8042_MUX_PORT_NO + idx;
1220 struct i8042_port *port = &i8042_ports[port_no];
1222 serio = kzalloc(sizeof(struct serio), GFP_KERNEL);
1223 if (!serio)
1224 return -ENOMEM;
1226 serio->id.type = SERIO_8042;
1227 serio->write = i8042_aux_write;
1228 serio->start = i8042_start;
1229 serio->stop = i8042_stop;
1230 serio->port_data = port;
1231 serio->dev.parent = &i8042_platform_device->dev;
1232 if (idx < 0) {
1233 strlcpy(serio->name, "i8042 AUX port", sizeof(serio->name));
1234 strlcpy(serio->phys, I8042_AUX_PHYS_DESC, sizeof(serio->phys));
1235 serio->close = i8042_port_close;
1236 } else {
1237 snprintf(serio->name, sizeof(serio->name), "i8042 AUX%d port", idx);
1238 snprintf(serio->phys, sizeof(serio->phys), I8042_MUX_PHYS_DESC, idx + 1);
1241 port->serio = serio;
1242 port->mux = idx;
1243 port->irq = I8042_AUX_IRQ;
1245 return 0;
1248 static void __init i8042_free_kbd_port(void)
1250 kfree(i8042_ports[I8042_KBD_PORT_NO].serio);
1251 i8042_ports[I8042_KBD_PORT_NO].serio = NULL;
1254 static void __init i8042_free_aux_ports(void)
1256 int i;
1258 for (i = I8042_AUX_PORT_NO; i < I8042_NUM_PORTS; i++) {
1259 kfree(i8042_ports[i].serio);
1260 i8042_ports[i].serio = NULL;
1264 static void __init i8042_register_ports(void)
1266 int i;
1268 for (i = 0; i < I8042_NUM_PORTS; i++) {
1269 if (i8042_ports[i].serio) {
1270 printk(KERN_INFO "serio: %s at %#lx,%#lx irq %d\n",
1271 i8042_ports[i].serio->name,
1272 (unsigned long) I8042_DATA_REG,
1273 (unsigned long) I8042_COMMAND_REG,
1274 i8042_ports[i].irq);
1275 serio_register_port(i8042_ports[i].serio);
1280 static void __devexit i8042_unregister_ports(void)
1282 int i;
1284 for (i = 0; i < I8042_NUM_PORTS; i++) {
1285 if (i8042_ports[i].serio) {
1286 serio_unregister_port(i8042_ports[i].serio);
1287 i8042_ports[i].serio = NULL;
1293 * Checks whether port belongs to i8042 controller.
1295 bool i8042_check_port_owner(const struct serio *port)
1297 int i;
1299 for (i = 0; i < I8042_NUM_PORTS; i++)
1300 if (i8042_ports[i].serio == port)
1301 return true;
1303 return false;
1305 EXPORT_SYMBOL(i8042_check_port_owner);
1307 static void i8042_free_irqs(void)
1309 if (i8042_aux_irq_registered)
1310 free_irq(I8042_AUX_IRQ, i8042_platform_device);
1311 if (i8042_kbd_irq_registered)
1312 free_irq(I8042_KBD_IRQ, i8042_platform_device);
1314 i8042_aux_irq_registered = i8042_kbd_irq_registered = false;
1317 static int __init i8042_setup_aux(void)
1319 int (*aux_enable)(void);
1320 int error;
1321 int i;
1323 if (i8042_check_aux())
1324 return -ENODEV;
1326 if (i8042_nomux || i8042_check_mux()) {
1327 error = i8042_create_aux_port(-1);
1328 if (error)
1329 goto err_free_ports;
1330 aux_enable = i8042_enable_aux_port;
1331 } else {
1332 for (i = 0; i < I8042_NUM_MUX_PORTS; i++) {
1333 error = i8042_create_aux_port(i);
1334 if (error)
1335 goto err_free_ports;
1337 aux_enable = i8042_enable_mux_ports;
1340 error = request_irq(I8042_AUX_IRQ, i8042_interrupt, IRQF_SHARED,
1341 "i8042", i8042_platform_device);
1342 if (error)
1343 goto err_free_ports;
1345 if (aux_enable())
1346 goto err_free_irq;
1348 i8042_aux_irq_registered = true;
1349 return 0;
1351 err_free_irq:
1352 free_irq(I8042_AUX_IRQ, i8042_platform_device);
1353 err_free_ports:
1354 i8042_free_aux_ports();
1355 return error;
1358 static int __init i8042_setup_kbd(void)
1360 int error;
1362 error = i8042_create_kbd_port();
1363 if (error)
1364 return error;
1366 error = request_irq(I8042_KBD_IRQ, i8042_interrupt, IRQF_SHARED,
1367 "i8042", i8042_platform_device);
1368 if (error)
1369 goto err_free_port;
1371 error = i8042_enable_kbd_port();
1372 if (error)
1373 goto err_free_irq;
1375 i8042_kbd_irq_registered = true;
1376 return 0;
1378 err_free_irq:
1379 free_irq(I8042_KBD_IRQ, i8042_platform_device);
1380 err_free_port:
1381 i8042_free_kbd_port();
1382 return error;
1385 static int __init i8042_probe(struct platform_device *dev)
1387 int error;
1389 i8042_platform_device = dev;
1391 if (i8042_reset) {
1392 error = i8042_controller_selftest();
1393 if (error)
1394 return error;
1397 error = i8042_controller_init();
1398 if (error)
1399 return error;
1401 #ifdef CONFIG_X86
1402 if (i8042_dritek)
1403 i8042_dritek_enable();
1404 #endif
1406 if (!i8042_noaux) {
1407 error = i8042_setup_aux();
1408 if (error && error != -ENODEV && error != -EBUSY)
1409 goto out_fail;
1412 if (!i8042_nokbd) {
1413 error = i8042_setup_kbd();
1414 if (error)
1415 goto out_fail;
1418 * Ok, everything is ready, let's register all serio ports
1420 i8042_register_ports();
1422 return 0;
1424 out_fail:
1425 i8042_free_aux_ports(); /* in case KBD failed but AUX not */
1426 i8042_free_irqs();
1427 i8042_controller_reset();
1428 i8042_platform_device = NULL;
1430 return error;
1433 static int __devexit i8042_remove(struct platform_device *dev)
1435 i8042_unregister_ports();
1436 i8042_free_irqs();
1437 i8042_controller_reset();
1438 i8042_platform_device = NULL;
1440 return 0;
1443 static struct platform_driver i8042_driver = {
1444 .driver = {
1445 .name = "i8042",
1446 .owner = THIS_MODULE,
1447 #ifdef CONFIG_PM
1448 .pm = &i8042_pm_ops,
1449 #endif
1451 .remove = __devexit_p(i8042_remove),
1452 .shutdown = i8042_shutdown,
1455 static int __init i8042_init(void)
1457 struct platform_device *pdev;
1458 int err;
1460 dbg_init();
1462 err = i8042_platform_init();
1463 if (err)
1464 return err;
1466 err = i8042_controller_check();
1467 if (err)
1468 goto err_platform_exit;
1470 pdev = platform_create_bundle(&i8042_driver, i8042_probe, NULL, 0, NULL, 0);
1471 if (IS_ERR(pdev)) {
1472 err = PTR_ERR(pdev);
1473 goto err_platform_exit;
1476 panic_blink = i8042_panic_blink;
1478 return 0;
1480 err_platform_exit:
1481 i8042_platform_exit();
1482 return err;
1485 static void __exit i8042_exit(void)
1487 platform_device_unregister(i8042_platform_device);
1488 platform_driver_unregister(&i8042_driver);
1489 i8042_platform_exit();
1491 panic_blink = NULL;
1494 module_init(i8042_init);
1495 module_exit(i8042_exit);