Merge tag 'for-linus-20190706' of git://git.kernel.dk/linux-block
[linux/fpc-iii.git] / drivers / input / serio / i8042.c
blobe4352741c467a8086a3e6f6a9799f7e8c10cefe6
1 // SPDX-License-Identifier: GPL-2.0-only
2 /*
3 * i8042 keyboard and mouse controller driver for Linux
5 * Copyright (c) 1999-2004 Vojtech Pavlik
6 */
9 #define pr_fmt(fmt) KBUILD_MODNAME ": " fmt
11 #include <linux/types.h>
12 #include <linux/delay.h>
13 #include <linux/module.h>
14 #include <linux/interrupt.h>
15 #include <linux/ioport.h>
16 #include <linux/init.h>
17 #include <linux/serio.h>
18 #include <linux/err.h>
19 #include <linux/rcupdate.h>
20 #include <linux/platform_device.h>
21 #include <linux/i8042.h>
22 #include <linux/slab.h>
23 #include <linux/suspend.h>
25 #include <asm/io.h>
27 MODULE_AUTHOR("Vojtech Pavlik <vojtech@suse.cz>");
28 MODULE_DESCRIPTION("i8042 keyboard and mouse controller driver");
29 MODULE_LICENSE("GPL");
31 static bool i8042_nokbd;
32 module_param_named(nokbd, i8042_nokbd, bool, 0);
33 MODULE_PARM_DESC(nokbd, "Do not probe or use KBD port.");
35 static bool i8042_noaux;
36 module_param_named(noaux, i8042_noaux, bool, 0);
37 MODULE_PARM_DESC(noaux, "Do not probe or use AUX (mouse) port.");
39 static bool i8042_nomux;
40 module_param_named(nomux, i8042_nomux, bool, 0);
41 MODULE_PARM_DESC(nomux, "Do not check whether an active multiplexing controller is present.");
43 static bool i8042_unlock;
44 module_param_named(unlock, i8042_unlock, bool, 0);
45 MODULE_PARM_DESC(unlock, "Ignore keyboard lock.");
47 enum i8042_controller_reset_mode {
48 I8042_RESET_NEVER,
49 I8042_RESET_ALWAYS,
50 I8042_RESET_ON_S2RAM,
51 #define I8042_RESET_DEFAULT I8042_RESET_ON_S2RAM
53 static enum i8042_controller_reset_mode i8042_reset = I8042_RESET_DEFAULT;
54 static int i8042_set_reset(const char *val, const struct kernel_param *kp)
56 enum i8042_controller_reset_mode *arg = kp->arg;
57 int error;
58 bool reset;
60 if (val) {
61 error = kstrtobool(val, &reset);
62 if (error)
63 return error;
64 } else {
65 reset = true;
68 *arg = reset ? I8042_RESET_ALWAYS : I8042_RESET_NEVER;
69 return 0;
72 static const struct kernel_param_ops param_ops_reset_param = {
73 .flags = KERNEL_PARAM_OPS_FL_NOARG,
74 .set = i8042_set_reset,
76 #define param_check_reset_param(name, p) \
77 __param_check(name, p, enum i8042_controller_reset_mode)
78 module_param_named(reset, i8042_reset, reset_param, 0);
79 MODULE_PARM_DESC(reset, "Reset controller on resume, cleanup or both");
81 static bool i8042_direct;
82 module_param_named(direct, i8042_direct, bool, 0);
83 MODULE_PARM_DESC(direct, "Put keyboard port into non-translated mode.");
85 static bool i8042_dumbkbd;
86 module_param_named(dumbkbd, i8042_dumbkbd, bool, 0);
87 MODULE_PARM_DESC(dumbkbd, "Pretend that controller can only read data from keyboard");
89 static bool i8042_noloop;
90 module_param_named(noloop, i8042_noloop, bool, 0);
91 MODULE_PARM_DESC(noloop, "Disable the AUX Loopback command while probing for the AUX port");
93 static bool i8042_notimeout;
94 module_param_named(notimeout, i8042_notimeout, bool, 0);
95 MODULE_PARM_DESC(notimeout, "Ignore timeouts signalled by i8042");
97 static bool i8042_kbdreset;
98 module_param_named(kbdreset, i8042_kbdreset, bool, 0);
99 MODULE_PARM_DESC(kbdreset, "Reset device connected to KBD port");
101 #ifdef CONFIG_X86
102 static bool i8042_dritek;
103 module_param_named(dritek, i8042_dritek, bool, 0);
104 MODULE_PARM_DESC(dritek, "Force enable the Dritek keyboard extension");
105 #endif
107 #ifdef CONFIG_PNP
108 static bool i8042_nopnp;
109 module_param_named(nopnp, i8042_nopnp, bool, 0);
110 MODULE_PARM_DESC(nopnp, "Do not use PNP to detect controller settings");
111 #endif
113 #define DEBUG
114 #ifdef DEBUG
115 static bool i8042_debug;
116 module_param_named(debug, i8042_debug, bool, 0600);
117 MODULE_PARM_DESC(debug, "Turn i8042 debugging mode on and off");
119 static bool i8042_unmask_kbd_data;
120 module_param_named(unmask_kbd_data, i8042_unmask_kbd_data, bool, 0600);
121 MODULE_PARM_DESC(unmask_kbd_data, "Unconditional enable (may reveal sensitive data) of normally sanitize-filtered kbd data traffic debug log [pre-condition: i8042.debug=1 enabled]");
122 #endif
124 static bool i8042_bypass_aux_irq_test;
125 static char i8042_kbd_firmware_id[128];
126 static char i8042_aux_firmware_id[128];
128 #include "i8042.h"
131 * i8042_lock protects serialization between i8042_command and
132 * the interrupt handler.
134 static DEFINE_SPINLOCK(i8042_lock);
137 * Writers to AUX and KBD ports as well as users issuing i8042_command
138 * directly should acquire i8042_mutex (by means of calling
139 * i8042_lock_chip() and i8042_unlock_ship() helpers) to ensure that
140 * they do not disturb each other (unfortunately in many i8042
141 * implementations write to one of the ports will immediately abort
142 * command that is being processed by another port).
144 static DEFINE_MUTEX(i8042_mutex);
146 struct i8042_port {
147 struct serio *serio;
148 int irq;
149 bool exists;
150 bool driver_bound;
151 signed char mux;
154 #define I8042_KBD_PORT_NO 0
155 #define I8042_AUX_PORT_NO 1
156 #define I8042_MUX_PORT_NO 2
157 #define I8042_NUM_PORTS (I8042_NUM_MUX_PORTS + 2)
159 static struct i8042_port i8042_ports[I8042_NUM_PORTS];
161 static unsigned char i8042_initial_ctr;
162 static unsigned char i8042_ctr;
163 static bool i8042_mux_present;
164 static bool i8042_kbd_irq_registered;
165 static bool i8042_aux_irq_registered;
166 static unsigned char i8042_suppress_kbd_ack;
167 static struct platform_device *i8042_platform_device;
168 static struct notifier_block i8042_kbd_bind_notifier_block;
170 static irqreturn_t i8042_interrupt(int irq, void *dev_id);
171 static bool (*i8042_platform_filter)(unsigned char data, unsigned char str,
172 struct serio *serio);
174 void i8042_lock_chip(void)
176 mutex_lock(&i8042_mutex);
178 EXPORT_SYMBOL(i8042_lock_chip);
180 void i8042_unlock_chip(void)
182 mutex_unlock(&i8042_mutex);
184 EXPORT_SYMBOL(i8042_unlock_chip);
186 int i8042_install_filter(bool (*filter)(unsigned char data, unsigned char str,
187 struct serio *serio))
189 unsigned long flags;
190 int ret = 0;
192 spin_lock_irqsave(&i8042_lock, flags);
194 if (i8042_platform_filter) {
195 ret = -EBUSY;
196 goto out;
199 i8042_platform_filter = filter;
201 out:
202 spin_unlock_irqrestore(&i8042_lock, flags);
203 return ret;
205 EXPORT_SYMBOL(i8042_install_filter);
207 int i8042_remove_filter(bool (*filter)(unsigned char data, unsigned char str,
208 struct serio *port))
210 unsigned long flags;
211 int ret = 0;
213 spin_lock_irqsave(&i8042_lock, flags);
215 if (i8042_platform_filter != filter) {
216 ret = -EINVAL;
217 goto out;
220 i8042_platform_filter = NULL;
222 out:
223 spin_unlock_irqrestore(&i8042_lock, flags);
224 return ret;
226 EXPORT_SYMBOL(i8042_remove_filter);
229 * The i8042_wait_read() and i8042_wait_write functions wait for the i8042 to
230 * be ready for reading values from it / writing values to it.
231 * Called always with i8042_lock held.
234 static int i8042_wait_read(void)
236 int i = 0;
238 while ((~i8042_read_status() & I8042_STR_OBF) && (i < I8042_CTL_TIMEOUT)) {
239 udelay(50);
240 i++;
242 return -(i == I8042_CTL_TIMEOUT);
245 static int i8042_wait_write(void)
247 int i = 0;
249 while ((i8042_read_status() & I8042_STR_IBF) && (i < I8042_CTL_TIMEOUT)) {
250 udelay(50);
251 i++;
253 return -(i == I8042_CTL_TIMEOUT);
257 * i8042_flush() flushes all data that may be in the keyboard and mouse buffers
258 * of the i8042 down the toilet.
261 static int i8042_flush(void)
263 unsigned long flags;
264 unsigned char data, str;
265 int count = 0;
266 int retval = 0;
268 spin_lock_irqsave(&i8042_lock, flags);
270 while ((str = i8042_read_status()) & I8042_STR_OBF) {
271 if (count++ < I8042_BUFFER_SIZE) {
272 udelay(50);
273 data = i8042_read_data();
274 dbg("%02x <- i8042 (flush, %s)\n",
275 data, str & I8042_STR_AUXDATA ? "aux" : "kbd");
276 } else {
277 retval = -EIO;
278 break;
282 spin_unlock_irqrestore(&i8042_lock, flags);
284 return retval;
288 * i8042_command() executes a command on the i8042. It also sends the input
289 * parameter(s) of the commands to it, and receives the output value(s). The
290 * parameters are to be stored in the param array, and the output is placed
291 * into the same array. The number of the parameters and output values is
292 * encoded in bits 8-11 of the command number.
295 static int __i8042_command(unsigned char *param, int command)
297 int i, error;
299 if (i8042_noloop && command == I8042_CMD_AUX_LOOP)
300 return -1;
302 error = i8042_wait_write();
303 if (error)
304 return error;
306 dbg("%02x -> i8042 (command)\n", command & 0xff);
307 i8042_write_command(command & 0xff);
309 for (i = 0; i < ((command >> 12) & 0xf); i++) {
310 error = i8042_wait_write();
311 if (error) {
312 dbg(" -- i8042 (wait write timeout)\n");
313 return error;
315 dbg("%02x -> i8042 (parameter)\n", param[i]);
316 i8042_write_data(param[i]);
319 for (i = 0; i < ((command >> 8) & 0xf); i++) {
320 error = i8042_wait_read();
321 if (error) {
322 dbg(" -- i8042 (wait read timeout)\n");
323 return error;
326 if (command == I8042_CMD_AUX_LOOP &&
327 !(i8042_read_status() & I8042_STR_AUXDATA)) {
328 dbg(" -- i8042 (auxerr)\n");
329 return -1;
332 param[i] = i8042_read_data();
333 dbg("%02x <- i8042 (return)\n", param[i]);
336 return 0;
339 int i8042_command(unsigned char *param, int command)
341 unsigned long flags;
342 int retval;
344 spin_lock_irqsave(&i8042_lock, flags);
345 retval = __i8042_command(param, command);
346 spin_unlock_irqrestore(&i8042_lock, flags);
348 return retval;
350 EXPORT_SYMBOL(i8042_command);
353 * i8042_kbd_write() sends a byte out through the keyboard interface.
356 static int i8042_kbd_write(struct serio *port, unsigned char c)
358 unsigned long flags;
359 int retval = 0;
361 spin_lock_irqsave(&i8042_lock, flags);
363 if (!(retval = i8042_wait_write())) {
364 dbg("%02x -> i8042 (kbd-data)\n", c);
365 i8042_write_data(c);
368 spin_unlock_irqrestore(&i8042_lock, flags);
370 return retval;
374 * i8042_aux_write() sends a byte out through the aux interface.
377 static int i8042_aux_write(struct serio *serio, unsigned char c)
379 struct i8042_port *port = serio->port_data;
381 return i8042_command(&c, port->mux == -1 ?
382 I8042_CMD_AUX_SEND :
383 I8042_CMD_MUX_SEND + port->mux);
388 * i8042_port_close attempts to clear AUX or KBD port state by disabling
389 * and then re-enabling it.
392 static void i8042_port_close(struct serio *serio)
394 int irq_bit;
395 int disable_bit;
396 const char *port_name;
398 if (serio == i8042_ports[I8042_AUX_PORT_NO].serio) {
399 irq_bit = I8042_CTR_AUXINT;
400 disable_bit = I8042_CTR_AUXDIS;
401 port_name = "AUX";
402 } else {
403 irq_bit = I8042_CTR_KBDINT;
404 disable_bit = I8042_CTR_KBDDIS;
405 port_name = "KBD";
408 i8042_ctr &= ~irq_bit;
409 if (i8042_command(&i8042_ctr, I8042_CMD_CTL_WCTR))
410 pr_warn("Can't write CTR while closing %s port\n", port_name);
412 udelay(50);
414 i8042_ctr &= ~disable_bit;
415 i8042_ctr |= irq_bit;
416 if (i8042_command(&i8042_ctr, I8042_CMD_CTL_WCTR))
417 pr_err("Can't reactivate %s port\n", port_name);
420 * See if there is any data appeared while we were messing with
421 * port state.
423 i8042_interrupt(0, NULL);
427 * i8042_start() is called by serio core when port is about to finish
428 * registering. It will mark port as existing so i8042_interrupt can
429 * start sending data through it.
431 static int i8042_start(struct serio *serio)
433 struct i8042_port *port = serio->port_data;
435 spin_lock_irq(&i8042_lock);
436 port->exists = true;
437 spin_unlock_irq(&i8042_lock);
439 return 0;
443 * i8042_stop() marks serio port as non-existing so i8042_interrupt
444 * will not try to send data to the port that is about to go away.
445 * The function is called by serio core as part of unregister procedure.
447 static void i8042_stop(struct serio *serio)
449 struct i8042_port *port = serio->port_data;
451 spin_lock_irq(&i8042_lock);
452 port->exists = false;
453 port->serio = NULL;
454 spin_unlock_irq(&i8042_lock);
457 * We need to make sure that interrupt handler finishes using
458 * our serio port before we return from this function.
459 * We synchronize with both AUX and KBD IRQs because there is
460 * a (very unlikely) chance that AUX IRQ is raised for KBD port
461 * and vice versa.
463 synchronize_irq(I8042_AUX_IRQ);
464 synchronize_irq(I8042_KBD_IRQ);
468 * i8042_filter() filters out unwanted bytes from the input data stream.
469 * It is called from i8042_interrupt and thus is running with interrupts
470 * off and i8042_lock held.
472 static bool i8042_filter(unsigned char data, unsigned char str,
473 struct serio *serio)
475 if (unlikely(i8042_suppress_kbd_ack)) {
476 if ((~str & I8042_STR_AUXDATA) &&
477 (data == 0xfa || data == 0xfe)) {
478 i8042_suppress_kbd_ack--;
479 dbg("Extra keyboard ACK - filtered out\n");
480 return true;
484 if (i8042_platform_filter && i8042_platform_filter(data, str, serio)) {
485 dbg("Filtered out by platform filter\n");
486 return true;
489 return false;
493 * i8042_interrupt() is the most important function in this driver -
494 * it handles the interrupts from the i8042, and sends incoming bytes
495 * to the upper layers.
498 static irqreturn_t i8042_interrupt(int irq, void *dev_id)
500 struct i8042_port *port;
501 struct serio *serio;
502 unsigned long flags;
503 unsigned char str, data;
504 unsigned int dfl;
505 unsigned int port_no;
506 bool filtered;
507 int ret = 1;
509 spin_lock_irqsave(&i8042_lock, flags);
511 str = i8042_read_status();
512 if (unlikely(~str & I8042_STR_OBF)) {
513 spin_unlock_irqrestore(&i8042_lock, flags);
514 if (irq)
515 dbg("Interrupt %d, without any data\n", irq);
516 ret = 0;
517 goto out;
520 data = i8042_read_data();
522 if (i8042_mux_present && (str & I8042_STR_AUXDATA)) {
523 static unsigned long last_transmit;
524 static unsigned char last_str;
526 dfl = 0;
527 if (str & I8042_STR_MUXERR) {
528 dbg("MUX error, status is %02x, data is %02x\n",
529 str, data);
531 * When MUXERR condition is signalled the data register can only contain
532 * 0xfd, 0xfe or 0xff if implementation follows the spec. Unfortunately
533 * it is not always the case. Some KBCs also report 0xfc when there is
534 * nothing connected to the port while others sometimes get confused which
535 * port the data came from and signal error leaving the data intact. They
536 * _do not_ revert to legacy mode (actually I've never seen KBC reverting
537 * to legacy mode yet, when we see one we'll add proper handling).
538 * Anyway, we process 0xfc, 0xfd, 0xfe and 0xff as timeouts, and for the
539 * rest assume that the data came from the same serio last byte
540 * was transmitted (if transmission happened not too long ago).
543 switch (data) {
544 default:
545 if (time_before(jiffies, last_transmit + HZ/10)) {
546 str = last_str;
547 break;
549 /* fall through - report timeout */
550 case 0xfc:
551 case 0xfd:
552 case 0xfe: dfl = SERIO_TIMEOUT; data = 0xfe; break;
553 case 0xff: dfl = SERIO_PARITY; data = 0xfe; break;
557 port_no = I8042_MUX_PORT_NO + ((str >> 6) & 3);
558 last_str = str;
559 last_transmit = jiffies;
560 } else {
562 dfl = ((str & I8042_STR_PARITY) ? SERIO_PARITY : 0) |
563 ((str & I8042_STR_TIMEOUT && !i8042_notimeout) ? SERIO_TIMEOUT : 0);
565 port_no = (str & I8042_STR_AUXDATA) ?
566 I8042_AUX_PORT_NO : I8042_KBD_PORT_NO;
569 port = &i8042_ports[port_no];
570 serio = port->exists ? port->serio : NULL;
572 filter_dbg(port->driver_bound, data, "<- i8042 (interrupt, %d, %d%s%s)\n",
573 port_no, irq,
574 dfl & SERIO_PARITY ? ", bad parity" : "",
575 dfl & SERIO_TIMEOUT ? ", timeout" : "");
577 filtered = i8042_filter(data, str, serio);
579 spin_unlock_irqrestore(&i8042_lock, flags);
581 if (likely(serio && !filtered))
582 serio_interrupt(serio, data, dfl);
584 out:
585 return IRQ_RETVAL(ret);
589 * i8042_enable_kbd_port enables keyboard port on chip
592 static int i8042_enable_kbd_port(void)
594 i8042_ctr &= ~I8042_CTR_KBDDIS;
595 i8042_ctr |= I8042_CTR_KBDINT;
597 if (i8042_command(&i8042_ctr, I8042_CMD_CTL_WCTR)) {
598 i8042_ctr &= ~I8042_CTR_KBDINT;
599 i8042_ctr |= I8042_CTR_KBDDIS;
600 pr_err("Failed to enable KBD port\n");
601 return -EIO;
604 return 0;
608 * i8042_enable_aux_port enables AUX (mouse) port on chip
611 static int i8042_enable_aux_port(void)
613 i8042_ctr &= ~I8042_CTR_AUXDIS;
614 i8042_ctr |= I8042_CTR_AUXINT;
616 if (i8042_command(&i8042_ctr, I8042_CMD_CTL_WCTR)) {
617 i8042_ctr &= ~I8042_CTR_AUXINT;
618 i8042_ctr |= I8042_CTR_AUXDIS;
619 pr_err("Failed to enable AUX port\n");
620 return -EIO;
623 return 0;
627 * i8042_enable_mux_ports enables 4 individual AUX ports after
628 * the controller has been switched into Multiplexed mode
631 static int i8042_enable_mux_ports(void)
633 unsigned char param;
634 int i;
636 for (i = 0; i < I8042_NUM_MUX_PORTS; i++) {
637 i8042_command(&param, I8042_CMD_MUX_PFX + i);
638 i8042_command(&param, I8042_CMD_AUX_ENABLE);
641 return i8042_enable_aux_port();
645 * i8042_set_mux_mode checks whether the controller has an
646 * active multiplexor and puts the chip into Multiplexed (true)
647 * or Legacy (false) mode.
650 static int i8042_set_mux_mode(bool multiplex, unsigned char *mux_version)
653 unsigned char param, val;
655 * Get rid of bytes in the queue.
658 i8042_flush();
661 * Internal loopback test - send three bytes, they should come back from the
662 * mouse interface, the last should be version.
665 param = val = 0xf0;
666 if (i8042_command(&param, I8042_CMD_AUX_LOOP) || param != val)
667 return -1;
668 param = val = multiplex ? 0x56 : 0xf6;
669 if (i8042_command(&param, I8042_CMD_AUX_LOOP) || param != val)
670 return -1;
671 param = val = multiplex ? 0xa4 : 0xa5;
672 if (i8042_command(&param, I8042_CMD_AUX_LOOP) || param == val)
673 return -1;
676 * Workaround for interference with USB Legacy emulation
677 * that causes a v10.12 MUX to be found.
679 if (param == 0xac)
680 return -1;
682 if (mux_version)
683 *mux_version = param;
685 return 0;
689 * i8042_check_mux() checks whether the controller supports the PS/2 Active
690 * Multiplexing specification by Synaptics, Phoenix, Insyde and
691 * LCS/Telegraphics.
694 static int __init i8042_check_mux(void)
696 unsigned char mux_version;
698 if (i8042_set_mux_mode(true, &mux_version))
699 return -1;
701 pr_info("Detected active multiplexing controller, rev %d.%d\n",
702 (mux_version >> 4) & 0xf, mux_version & 0xf);
705 * Disable all muxed ports by disabling AUX.
707 i8042_ctr |= I8042_CTR_AUXDIS;
708 i8042_ctr &= ~I8042_CTR_AUXINT;
710 if (i8042_command(&i8042_ctr, I8042_CMD_CTL_WCTR)) {
711 pr_err("Failed to disable AUX port, can't use MUX\n");
712 return -EIO;
715 i8042_mux_present = true;
717 return 0;
721 * The following is used to test AUX IRQ delivery.
723 static struct completion i8042_aux_irq_delivered __initdata;
724 static bool i8042_irq_being_tested __initdata;
726 static irqreturn_t __init i8042_aux_test_irq(int irq, void *dev_id)
728 unsigned long flags;
729 unsigned char str, data;
730 int ret = 0;
732 spin_lock_irqsave(&i8042_lock, flags);
733 str = i8042_read_status();
734 if (str & I8042_STR_OBF) {
735 data = i8042_read_data();
736 dbg("%02x <- i8042 (aux_test_irq, %s)\n",
737 data, str & I8042_STR_AUXDATA ? "aux" : "kbd");
738 if (i8042_irq_being_tested &&
739 data == 0xa5 && (str & I8042_STR_AUXDATA))
740 complete(&i8042_aux_irq_delivered);
741 ret = 1;
743 spin_unlock_irqrestore(&i8042_lock, flags);
745 return IRQ_RETVAL(ret);
749 * i8042_toggle_aux - enables or disables AUX port on i8042 via command and
750 * verifies success by readinng CTR. Used when testing for presence of AUX
751 * port.
753 static int __init i8042_toggle_aux(bool on)
755 unsigned char param;
756 int i;
758 if (i8042_command(&param,
759 on ? I8042_CMD_AUX_ENABLE : I8042_CMD_AUX_DISABLE))
760 return -1;
762 /* some chips need some time to set the I8042_CTR_AUXDIS bit */
763 for (i = 0; i < 100; i++) {
764 udelay(50);
766 if (i8042_command(&param, I8042_CMD_CTL_RCTR))
767 return -1;
769 if (!(param & I8042_CTR_AUXDIS) == on)
770 return 0;
773 return -1;
777 * i8042_check_aux() applies as much paranoia as it can at detecting
778 * the presence of an AUX interface.
781 static int __init i8042_check_aux(void)
783 int retval = -1;
784 bool irq_registered = false;
785 bool aux_loop_broken = false;
786 unsigned long flags;
787 unsigned char param;
790 * Get rid of bytes in the queue.
793 i8042_flush();
796 * Internal loopback test - filters out AT-type i8042's. Unfortunately
797 * SiS screwed up and their 5597 doesn't support the LOOP command even
798 * though it has an AUX port.
801 param = 0x5a;
802 retval = i8042_command(&param, I8042_CMD_AUX_LOOP);
803 if (retval || param != 0x5a) {
806 * External connection test - filters out AT-soldered PS/2 i8042's
807 * 0x00 - no error, 0x01-0x03 - clock/data stuck, 0xff - general error
808 * 0xfa - no error on some notebooks which ignore the spec
809 * Because it's common for chipsets to return error on perfectly functioning
810 * AUX ports, we test for this only when the LOOP command failed.
813 if (i8042_command(&param, I8042_CMD_AUX_TEST) ||
814 (param && param != 0xfa && param != 0xff))
815 return -1;
818 * If AUX_LOOP completed without error but returned unexpected data
819 * mark it as broken
821 if (!retval)
822 aux_loop_broken = true;
826 * Bit assignment test - filters out PS/2 i8042's in AT mode
829 if (i8042_toggle_aux(false)) {
830 pr_warn("Failed to disable AUX port, but continuing anyway... Is this a SiS?\n");
831 pr_warn("If AUX port is really absent please use the 'i8042.noaux' option\n");
834 if (i8042_toggle_aux(true))
835 return -1;
838 * Reset keyboard (needed on some laptops to successfully detect
839 * touchpad, e.g., some Gigabyte laptop models with Elantech
840 * touchpads).
842 if (i8042_kbdreset) {
843 pr_warn("Attempting to reset device connected to KBD port\n");
844 i8042_kbd_write(NULL, (unsigned char) 0xff);
848 * Test AUX IRQ delivery to make sure BIOS did not grab the IRQ and
849 * used it for a PCI card or somethig else.
852 if (i8042_noloop || i8042_bypass_aux_irq_test || aux_loop_broken) {
854 * Without LOOP command we can't test AUX IRQ delivery. Assume the port
855 * is working and hope we are right.
857 retval = 0;
858 goto out;
861 if (request_irq(I8042_AUX_IRQ, i8042_aux_test_irq, IRQF_SHARED,
862 "i8042", i8042_platform_device))
863 goto out;
865 irq_registered = true;
867 if (i8042_enable_aux_port())
868 goto out;
870 spin_lock_irqsave(&i8042_lock, flags);
872 init_completion(&i8042_aux_irq_delivered);
873 i8042_irq_being_tested = true;
875 param = 0xa5;
876 retval = __i8042_command(&param, I8042_CMD_AUX_LOOP & 0xf0ff);
878 spin_unlock_irqrestore(&i8042_lock, flags);
880 if (retval)
881 goto out;
883 if (wait_for_completion_timeout(&i8042_aux_irq_delivered,
884 msecs_to_jiffies(250)) == 0) {
886 * AUX IRQ was never delivered so we need to flush the controller to
887 * get rid of the byte we put there; otherwise keyboard may not work.
889 dbg(" -- i8042 (aux irq test timeout)\n");
890 i8042_flush();
891 retval = -1;
894 out:
897 * Disable the interface.
900 i8042_ctr |= I8042_CTR_AUXDIS;
901 i8042_ctr &= ~I8042_CTR_AUXINT;
903 if (i8042_command(&i8042_ctr, I8042_CMD_CTL_WCTR))
904 retval = -1;
906 if (irq_registered)
907 free_irq(I8042_AUX_IRQ, i8042_platform_device);
909 return retval;
912 static int i8042_controller_check(void)
914 if (i8042_flush()) {
915 pr_info("No controller found\n");
916 return -ENODEV;
919 return 0;
922 static int i8042_controller_selftest(void)
924 unsigned char param;
925 int i = 0;
928 * We try this 5 times; on some really fragile systems this does not
929 * take the first time...
931 do {
933 if (i8042_command(&param, I8042_CMD_CTL_TEST)) {
934 pr_err("i8042 controller selftest timeout\n");
935 return -ENODEV;
938 if (param == I8042_RET_CTL_TEST)
939 return 0;
941 dbg("i8042 controller selftest: %#x != %#x\n",
942 param, I8042_RET_CTL_TEST);
943 msleep(50);
944 } while (i++ < 5);
946 #ifdef CONFIG_X86
948 * On x86, we don't fail entire i8042 initialization if controller
949 * reset fails in hopes that keyboard port will still be functional
950 * and user will still get a working keyboard. This is especially
951 * important on netbooks. On other arches we trust hardware more.
953 pr_info("giving up on controller selftest, continuing anyway...\n");
954 return 0;
955 #else
956 pr_err("i8042 controller selftest failed\n");
957 return -EIO;
958 #endif
962 * i8042_controller init initializes the i8042 controller, and,
963 * most importantly, sets it into non-xlated mode if that's
964 * desired.
967 static int i8042_controller_init(void)
969 unsigned long flags;
970 int n = 0;
971 unsigned char ctr[2];
974 * Save the CTR for restore on unload / reboot.
977 do {
978 if (n >= 10) {
979 pr_err("Unable to get stable CTR read\n");
980 return -EIO;
983 if (n != 0)
984 udelay(50);
986 if (i8042_command(&ctr[n++ % 2], I8042_CMD_CTL_RCTR)) {
987 pr_err("Can't read CTR while initializing i8042\n");
988 return -EIO;
991 } while (n < 2 || ctr[0] != ctr[1]);
993 i8042_initial_ctr = i8042_ctr = ctr[0];
996 * Disable the keyboard interface and interrupt.
999 i8042_ctr |= I8042_CTR_KBDDIS;
1000 i8042_ctr &= ~I8042_CTR_KBDINT;
1003 * Handle keylock.
1006 spin_lock_irqsave(&i8042_lock, flags);
1007 if (~i8042_read_status() & I8042_STR_KEYLOCK) {
1008 if (i8042_unlock)
1009 i8042_ctr |= I8042_CTR_IGNKEYLOCK;
1010 else
1011 pr_warn("Warning: Keylock active\n");
1013 spin_unlock_irqrestore(&i8042_lock, flags);
1016 * If the chip is configured into nontranslated mode by the BIOS, don't
1017 * bother enabling translating and be happy.
1020 if (~i8042_ctr & I8042_CTR_XLATE)
1021 i8042_direct = true;
1024 * Set nontranslated mode for the kbd interface if requested by an option.
1025 * After this the kbd interface becomes a simple serial in/out, like the aux
1026 * interface is. We don't do this by default, since it can confuse notebook
1027 * BIOSes.
1030 if (i8042_direct)
1031 i8042_ctr &= ~I8042_CTR_XLATE;
1034 * Write CTR back.
1037 if (i8042_command(&i8042_ctr, I8042_CMD_CTL_WCTR)) {
1038 pr_err("Can't write CTR while initializing i8042\n");
1039 return -EIO;
1043 * Flush whatever accumulated while we were disabling keyboard port.
1046 i8042_flush();
1048 return 0;
1053 * Reset the controller and reset CRT to the original value set by BIOS.
1056 static void i8042_controller_reset(bool s2r_wants_reset)
1058 i8042_flush();
1061 * Disable both KBD and AUX interfaces so they don't get in the way
1064 i8042_ctr |= I8042_CTR_KBDDIS | I8042_CTR_AUXDIS;
1065 i8042_ctr &= ~(I8042_CTR_KBDINT | I8042_CTR_AUXINT);
1067 if (i8042_command(&i8042_ctr, I8042_CMD_CTL_WCTR))
1068 pr_warn("Can't write CTR while resetting\n");
1071 * Disable MUX mode if present.
1074 if (i8042_mux_present)
1075 i8042_set_mux_mode(false, NULL);
1078 * Reset the controller if requested.
1081 if (i8042_reset == I8042_RESET_ALWAYS ||
1082 (i8042_reset == I8042_RESET_ON_S2RAM && s2r_wants_reset)) {
1083 i8042_controller_selftest();
1087 * Restore the original control register setting.
1090 if (i8042_command(&i8042_initial_ctr, I8042_CMD_CTL_WCTR))
1091 pr_warn("Can't restore CTR\n");
1096 * i8042_panic_blink() will turn the keyboard LEDs on or off and is called
1097 * when kernel panics. Flashing LEDs is useful for users running X who may
1098 * not see the console and will help distinguishing panics from "real"
1099 * lockups.
1101 * Note that DELAY has a limit of 10ms so we will not get stuck here
1102 * waiting for KBC to free up even if KBD interrupt is off
1105 #define DELAY do { mdelay(1); if (++delay > 10) return delay; } while(0)
1107 static long i8042_panic_blink(int state)
1109 long delay = 0;
1110 char led;
1112 led = (state) ? 0x01 | 0x04 : 0;
1113 while (i8042_read_status() & I8042_STR_IBF)
1114 DELAY;
1115 dbg("%02x -> i8042 (panic blink)\n", 0xed);
1116 i8042_suppress_kbd_ack = 2;
1117 i8042_write_data(0xed); /* set leds */
1118 DELAY;
1119 while (i8042_read_status() & I8042_STR_IBF)
1120 DELAY;
1121 DELAY;
1122 dbg("%02x -> i8042 (panic blink)\n", led);
1123 i8042_write_data(led);
1124 DELAY;
1125 return delay;
1128 #undef DELAY
1130 #ifdef CONFIG_X86
1131 static void i8042_dritek_enable(void)
1133 unsigned char param = 0x90;
1134 int error;
1136 error = i8042_command(&param, 0x1059);
1137 if (error)
1138 pr_warn("Failed to enable DRITEK extension: %d\n", error);
1140 #endif
1142 #ifdef CONFIG_PM
1145 * Here we try to reset everything back to a state we had
1146 * before suspending.
1149 static int i8042_controller_resume(bool s2r_wants_reset)
1151 int error;
1153 error = i8042_controller_check();
1154 if (error)
1155 return error;
1157 if (i8042_reset == I8042_RESET_ALWAYS ||
1158 (i8042_reset == I8042_RESET_ON_S2RAM && s2r_wants_reset)) {
1159 error = i8042_controller_selftest();
1160 if (error)
1161 return error;
1165 * Restore original CTR value and disable all ports
1168 i8042_ctr = i8042_initial_ctr;
1169 if (i8042_direct)
1170 i8042_ctr &= ~I8042_CTR_XLATE;
1171 i8042_ctr |= I8042_CTR_AUXDIS | I8042_CTR_KBDDIS;
1172 i8042_ctr &= ~(I8042_CTR_AUXINT | I8042_CTR_KBDINT);
1173 if (i8042_command(&i8042_ctr, I8042_CMD_CTL_WCTR)) {
1174 pr_warn("Can't write CTR to resume, retrying...\n");
1175 msleep(50);
1176 if (i8042_command(&i8042_ctr, I8042_CMD_CTL_WCTR)) {
1177 pr_err("CTR write retry failed\n");
1178 return -EIO;
1183 #ifdef CONFIG_X86
1184 if (i8042_dritek)
1185 i8042_dritek_enable();
1186 #endif
1188 if (i8042_mux_present) {
1189 if (i8042_set_mux_mode(true, NULL) || i8042_enable_mux_ports())
1190 pr_warn("failed to resume active multiplexor, mouse won't work\n");
1191 } else if (i8042_ports[I8042_AUX_PORT_NO].serio)
1192 i8042_enable_aux_port();
1194 if (i8042_ports[I8042_KBD_PORT_NO].serio)
1195 i8042_enable_kbd_port();
1197 i8042_interrupt(0, NULL);
1199 return 0;
1203 * Here we try to restore the original BIOS settings to avoid
1204 * upsetting it.
1207 static int i8042_pm_suspend(struct device *dev)
1209 int i;
1211 if (pm_suspend_via_firmware())
1212 i8042_controller_reset(true);
1214 /* Set up serio interrupts for system wakeup. */
1215 for (i = 0; i < I8042_NUM_PORTS; i++) {
1216 struct serio *serio = i8042_ports[i].serio;
1218 if (serio && device_may_wakeup(&serio->dev))
1219 enable_irq_wake(i8042_ports[i].irq);
1222 return 0;
1225 static int i8042_pm_resume_noirq(struct device *dev)
1227 if (!pm_resume_via_firmware())
1228 i8042_interrupt(0, NULL);
1230 return 0;
1233 static int i8042_pm_resume(struct device *dev)
1235 bool want_reset;
1236 int i;
1238 for (i = 0; i < I8042_NUM_PORTS; i++) {
1239 struct serio *serio = i8042_ports[i].serio;
1241 if (serio && device_may_wakeup(&serio->dev))
1242 disable_irq_wake(i8042_ports[i].irq);
1246 * If platform firmware was not going to be involved in suspend, we did
1247 * not restore the controller state to whatever it had been at boot
1248 * time, so we do not need to do anything.
1250 if (!pm_suspend_via_firmware())
1251 return 0;
1254 * We only need to reset the controller if we are resuming after handing
1255 * off control to the platform firmware, otherwise we can simply restore
1256 * the mode.
1258 want_reset = pm_resume_via_firmware();
1260 return i8042_controller_resume(want_reset);
1263 static int i8042_pm_thaw(struct device *dev)
1265 i8042_interrupt(0, NULL);
1267 return 0;
1270 static int i8042_pm_reset(struct device *dev)
1272 i8042_controller_reset(false);
1274 return 0;
1277 static int i8042_pm_restore(struct device *dev)
1279 return i8042_controller_resume(false);
1282 static const struct dev_pm_ops i8042_pm_ops = {
1283 .suspend = i8042_pm_suspend,
1284 .resume_noirq = i8042_pm_resume_noirq,
1285 .resume = i8042_pm_resume,
1286 .thaw = i8042_pm_thaw,
1287 .poweroff = i8042_pm_reset,
1288 .restore = i8042_pm_restore,
1291 #endif /* CONFIG_PM */
1294 * We need to reset the 8042 back to original mode on system shutdown,
1295 * because otherwise BIOSes will be confused.
1298 static void i8042_shutdown(struct platform_device *dev)
1300 i8042_controller_reset(false);
1303 static int __init i8042_create_kbd_port(void)
1305 struct serio *serio;
1306 struct i8042_port *port = &i8042_ports[I8042_KBD_PORT_NO];
1308 serio = kzalloc(sizeof(struct serio), GFP_KERNEL);
1309 if (!serio)
1310 return -ENOMEM;
1312 serio->id.type = i8042_direct ? SERIO_8042 : SERIO_8042_XL;
1313 serio->write = i8042_dumbkbd ? NULL : i8042_kbd_write;
1314 serio->start = i8042_start;
1315 serio->stop = i8042_stop;
1316 serio->close = i8042_port_close;
1317 serio->ps2_cmd_mutex = &i8042_mutex;
1318 serio->port_data = port;
1319 serio->dev.parent = &i8042_platform_device->dev;
1320 strlcpy(serio->name, "i8042 KBD port", sizeof(serio->name));
1321 strlcpy(serio->phys, I8042_KBD_PHYS_DESC, sizeof(serio->phys));
1322 strlcpy(serio->firmware_id, i8042_kbd_firmware_id,
1323 sizeof(serio->firmware_id));
1325 port->serio = serio;
1326 port->irq = I8042_KBD_IRQ;
1328 return 0;
1331 static int __init i8042_create_aux_port(int idx)
1333 struct serio *serio;
1334 int port_no = idx < 0 ? I8042_AUX_PORT_NO : I8042_MUX_PORT_NO + idx;
1335 struct i8042_port *port = &i8042_ports[port_no];
1337 serio = kzalloc(sizeof(struct serio), GFP_KERNEL);
1338 if (!serio)
1339 return -ENOMEM;
1341 serio->id.type = SERIO_8042;
1342 serio->write = i8042_aux_write;
1343 serio->start = i8042_start;
1344 serio->stop = i8042_stop;
1345 serio->ps2_cmd_mutex = &i8042_mutex;
1346 serio->port_data = port;
1347 serio->dev.parent = &i8042_platform_device->dev;
1348 if (idx < 0) {
1349 strlcpy(serio->name, "i8042 AUX port", sizeof(serio->name));
1350 strlcpy(serio->phys, I8042_AUX_PHYS_DESC, sizeof(serio->phys));
1351 strlcpy(serio->firmware_id, i8042_aux_firmware_id,
1352 sizeof(serio->firmware_id));
1353 serio->close = i8042_port_close;
1354 } else {
1355 snprintf(serio->name, sizeof(serio->name), "i8042 AUX%d port", idx);
1356 snprintf(serio->phys, sizeof(serio->phys), I8042_MUX_PHYS_DESC, idx + 1);
1357 strlcpy(serio->firmware_id, i8042_aux_firmware_id,
1358 sizeof(serio->firmware_id));
1361 port->serio = serio;
1362 port->mux = idx;
1363 port->irq = I8042_AUX_IRQ;
1365 return 0;
1368 static void __init i8042_free_kbd_port(void)
1370 kfree(i8042_ports[I8042_KBD_PORT_NO].serio);
1371 i8042_ports[I8042_KBD_PORT_NO].serio = NULL;
1374 static void __init i8042_free_aux_ports(void)
1376 int i;
1378 for (i = I8042_AUX_PORT_NO; i < I8042_NUM_PORTS; i++) {
1379 kfree(i8042_ports[i].serio);
1380 i8042_ports[i].serio = NULL;
1384 static void __init i8042_register_ports(void)
1386 int i;
1388 for (i = 0; i < I8042_NUM_PORTS; i++) {
1389 struct serio *serio = i8042_ports[i].serio;
1391 if (!serio)
1392 continue;
1394 printk(KERN_INFO "serio: %s at %#lx,%#lx irq %d\n",
1395 serio->name,
1396 (unsigned long) I8042_DATA_REG,
1397 (unsigned long) I8042_COMMAND_REG,
1398 i8042_ports[i].irq);
1399 serio_register_port(serio);
1400 device_set_wakeup_capable(&serio->dev, true);
1403 * On platforms using suspend-to-idle, allow the keyboard to
1404 * wake up the system from sleep by enabling keyboard wakeups
1405 * by default. This is consistent with keyboard wakeup
1406 * behavior on many platforms using suspend-to-RAM (ACPI S3)
1407 * by default.
1409 if (pm_suspend_via_s2idle() && i == I8042_KBD_PORT_NO)
1410 device_set_wakeup_enable(&serio->dev, true);
1414 static void i8042_unregister_ports(void)
1416 int i;
1418 for (i = 0; i < I8042_NUM_PORTS; i++) {
1419 if (i8042_ports[i].serio) {
1420 serio_unregister_port(i8042_ports[i].serio);
1421 i8042_ports[i].serio = NULL;
1426 static void i8042_free_irqs(void)
1428 if (i8042_aux_irq_registered)
1429 free_irq(I8042_AUX_IRQ, i8042_platform_device);
1430 if (i8042_kbd_irq_registered)
1431 free_irq(I8042_KBD_IRQ, i8042_platform_device);
1433 i8042_aux_irq_registered = i8042_kbd_irq_registered = false;
1436 static int __init i8042_setup_aux(void)
1438 int (*aux_enable)(void);
1439 int error;
1440 int i;
1442 if (i8042_check_aux())
1443 return -ENODEV;
1445 if (i8042_nomux || i8042_check_mux()) {
1446 error = i8042_create_aux_port(-1);
1447 if (error)
1448 goto err_free_ports;
1449 aux_enable = i8042_enable_aux_port;
1450 } else {
1451 for (i = 0; i < I8042_NUM_MUX_PORTS; i++) {
1452 error = i8042_create_aux_port(i);
1453 if (error)
1454 goto err_free_ports;
1456 aux_enable = i8042_enable_mux_ports;
1459 error = request_irq(I8042_AUX_IRQ, i8042_interrupt, IRQF_SHARED,
1460 "i8042", i8042_platform_device);
1461 if (error)
1462 goto err_free_ports;
1464 if (aux_enable())
1465 goto err_free_irq;
1467 i8042_aux_irq_registered = true;
1468 return 0;
1470 err_free_irq:
1471 free_irq(I8042_AUX_IRQ, i8042_platform_device);
1472 err_free_ports:
1473 i8042_free_aux_ports();
1474 return error;
1477 static int __init i8042_setup_kbd(void)
1479 int error;
1481 error = i8042_create_kbd_port();
1482 if (error)
1483 return error;
1485 error = request_irq(I8042_KBD_IRQ, i8042_interrupt, IRQF_SHARED,
1486 "i8042", i8042_platform_device);
1487 if (error)
1488 goto err_free_port;
1490 error = i8042_enable_kbd_port();
1491 if (error)
1492 goto err_free_irq;
1494 i8042_kbd_irq_registered = true;
1495 return 0;
1497 err_free_irq:
1498 free_irq(I8042_KBD_IRQ, i8042_platform_device);
1499 err_free_port:
1500 i8042_free_kbd_port();
1501 return error;
1504 static int i8042_kbd_bind_notifier(struct notifier_block *nb,
1505 unsigned long action, void *data)
1507 struct device *dev = data;
1508 struct serio *serio = to_serio_port(dev);
1509 struct i8042_port *port = serio->port_data;
1511 if (serio != i8042_ports[I8042_KBD_PORT_NO].serio)
1512 return 0;
1514 switch (action) {
1515 case BUS_NOTIFY_BOUND_DRIVER:
1516 port->driver_bound = true;
1517 break;
1519 case BUS_NOTIFY_UNBIND_DRIVER:
1520 port->driver_bound = false;
1521 break;
1524 return 0;
1527 static int __init i8042_probe(struct platform_device *dev)
1529 int error;
1531 i8042_platform_device = dev;
1533 if (i8042_reset == I8042_RESET_ALWAYS) {
1534 error = i8042_controller_selftest();
1535 if (error)
1536 return error;
1539 error = i8042_controller_init();
1540 if (error)
1541 return error;
1543 #ifdef CONFIG_X86
1544 if (i8042_dritek)
1545 i8042_dritek_enable();
1546 #endif
1548 if (!i8042_noaux) {
1549 error = i8042_setup_aux();
1550 if (error && error != -ENODEV && error != -EBUSY)
1551 goto out_fail;
1554 if (!i8042_nokbd) {
1555 error = i8042_setup_kbd();
1556 if (error)
1557 goto out_fail;
1560 * Ok, everything is ready, let's register all serio ports
1562 i8042_register_ports();
1564 return 0;
1566 out_fail:
1567 i8042_free_aux_ports(); /* in case KBD failed but AUX not */
1568 i8042_free_irqs();
1569 i8042_controller_reset(false);
1570 i8042_platform_device = NULL;
1572 return error;
1575 static int i8042_remove(struct platform_device *dev)
1577 i8042_unregister_ports();
1578 i8042_free_irqs();
1579 i8042_controller_reset(false);
1580 i8042_platform_device = NULL;
1582 return 0;
1585 static struct platform_driver i8042_driver = {
1586 .driver = {
1587 .name = "i8042",
1588 #ifdef CONFIG_PM
1589 .pm = &i8042_pm_ops,
1590 #endif
1592 .remove = i8042_remove,
1593 .shutdown = i8042_shutdown,
1596 static struct notifier_block i8042_kbd_bind_notifier_block = {
1597 .notifier_call = i8042_kbd_bind_notifier,
1600 static int __init i8042_init(void)
1602 struct platform_device *pdev;
1603 int err;
1605 dbg_init();
1607 err = i8042_platform_init();
1608 if (err)
1609 return err;
1611 err = i8042_controller_check();
1612 if (err)
1613 goto err_platform_exit;
1615 pdev = platform_create_bundle(&i8042_driver, i8042_probe, NULL, 0, NULL, 0);
1616 if (IS_ERR(pdev)) {
1617 err = PTR_ERR(pdev);
1618 goto err_platform_exit;
1621 bus_register_notifier(&serio_bus, &i8042_kbd_bind_notifier_block);
1622 panic_blink = i8042_panic_blink;
1624 return 0;
1626 err_platform_exit:
1627 i8042_platform_exit();
1628 return err;
1631 static void __exit i8042_exit(void)
1633 platform_device_unregister(i8042_platform_device);
1634 platform_driver_unregister(&i8042_driver);
1635 i8042_platform_exit();
1637 bus_unregister_notifier(&serio_bus, &i8042_kbd_bind_notifier_block);
1638 panic_blink = NULL;
1641 module_init(i8042_init);
1642 module_exit(i8042_exit);