Full support for Ginger Console
[linux-ginger.git] / drivers / input / serio / i8042.c
bloba31578170cccd301cb141e1fbbdde76d4783bceb
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 #include <linux/types.h>
14 #include <linux/delay.h>
15 #include <linux/module.h>
16 #include <linux/interrupt.h>
17 #include <linux/ioport.h>
18 #include <linux/init.h>
19 #include <linux/serio.h>
20 #include <linux/err.h>
21 #include <linux/rcupdate.h>
22 #include <linux/platform_device.h>
23 #include <linux/i8042.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 conrtoller 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 static bool i8042_reset;
48 module_param_named(reset, i8042_reset, bool, 0);
49 MODULE_PARM_DESC(reset, "Reset controller during init and cleanup.");
51 static bool i8042_direct;
52 module_param_named(direct, i8042_direct, bool, 0);
53 MODULE_PARM_DESC(direct, "Put keyboard port into non-translated mode.");
55 static bool i8042_dumbkbd;
56 module_param_named(dumbkbd, i8042_dumbkbd, bool, 0);
57 MODULE_PARM_DESC(dumbkbd, "Pretend that controller can only read data from keyboard");
59 static bool i8042_noloop;
60 module_param_named(noloop, i8042_noloop, bool, 0);
61 MODULE_PARM_DESC(noloop, "Disable the AUX Loopback command while probing for the AUX port");
63 static unsigned int i8042_blink_frequency = 500;
64 module_param_named(panicblink, i8042_blink_frequency, uint, 0600);
65 MODULE_PARM_DESC(panicblink, "Frequency with which keyboard LEDs should blink when kernel panics");
67 #ifdef CONFIG_X86
68 static bool i8042_dritek;
69 module_param_named(dritek, i8042_dritek, bool, 0);
70 MODULE_PARM_DESC(dritek, "Force enable the Dritek keyboard extension");
71 #endif
73 #ifdef CONFIG_PNP
74 static bool i8042_nopnp;
75 module_param_named(nopnp, i8042_nopnp, bool, 0);
76 MODULE_PARM_DESC(nopnp, "Do not use PNP to detect controller settings");
77 #endif
79 #define DEBUG
80 #ifdef DEBUG
81 static bool i8042_debug;
82 module_param_named(debug, i8042_debug, bool, 0600);
83 MODULE_PARM_DESC(debug, "Turn i8042 debugging mode on and off");
84 #endif
86 static bool i8042_bypass_aux_irq_test;
88 #include "i8042.h"
91 * i8042_lock protects serialization between i8042_command and
92 * the interrupt handler.
94 static DEFINE_SPINLOCK(i8042_lock);
97 * Writers to AUX and KBD ports as well as users issuing i8042_command
98 * directly should acquire i8042_mutex (by means of calling
99 * i8042_lock_chip() and i8042_unlock_ship() helpers) to ensure that
100 * they do not disturb each other (unfortunately in many i8042
101 * implementations write to one of the ports will immediately abort
102 * command that is being processed by another port).
104 static DEFINE_MUTEX(i8042_mutex);
106 struct i8042_port {
107 struct serio *serio;
108 int irq;
109 bool exists;
110 signed char mux;
113 #define I8042_KBD_PORT_NO 0
114 #define I8042_AUX_PORT_NO 1
115 #define I8042_MUX_PORT_NO 2
116 #define I8042_NUM_PORTS (I8042_NUM_MUX_PORTS + 2)
118 static struct i8042_port i8042_ports[I8042_NUM_PORTS];
120 static unsigned char i8042_initial_ctr;
121 static unsigned char i8042_ctr;
122 static bool i8042_mux_present;
123 static bool i8042_kbd_irq_registered;
124 static bool i8042_aux_irq_registered;
125 static unsigned char i8042_suppress_kbd_ack;
126 static struct platform_device *i8042_platform_device;
128 static irqreturn_t i8042_interrupt(int irq, void *dev_id);
130 void i8042_lock_chip(void)
132 mutex_lock(&i8042_mutex);
134 EXPORT_SYMBOL(i8042_lock_chip);
136 void i8042_unlock_chip(void)
138 mutex_unlock(&i8042_mutex);
140 EXPORT_SYMBOL(i8042_unlock_chip);
143 * The i8042_wait_read() and i8042_wait_write functions wait for the i8042 to
144 * be ready for reading values from it / writing values to it.
145 * Called always with i8042_lock held.
148 static int i8042_wait_read(void)
150 int i = 0;
152 while ((~i8042_read_status() & I8042_STR_OBF) && (i < I8042_CTL_TIMEOUT)) {
153 udelay(50);
154 i++;
156 return -(i == I8042_CTL_TIMEOUT);
159 static int i8042_wait_write(void)
161 int i = 0;
163 while ((i8042_read_status() & I8042_STR_IBF) && (i < I8042_CTL_TIMEOUT)) {
164 udelay(50);
165 i++;
167 return -(i == I8042_CTL_TIMEOUT);
171 * i8042_flush() flushes all data that may be in the keyboard and mouse buffers
172 * of the i8042 down the toilet.
175 static int i8042_flush(void)
177 unsigned long flags;
178 unsigned char data, str;
179 int i = 0;
181 spin_lock_irqsave(&i8042_lock, flags);
183 while (((str = i8042_read_status()) & I8042_STR_OBF) && (i < I8042_BUFFER_SIZE)) {
184 udelay(50);
185 data = i8042_read_data();
186 i++;
187 dbg("%02x <- i8042 (flush, %s)", data,
188 str & I8042_STR_AUXDATA ? "aux" : "kbd");
191 spin_unlock_irqrestore(&i8042_lock, flags);
193 return i;
197 * i8042_command() executes a command on the i8042. It also sends the input
198 * parameter(s) of the commands to it, and receives the output value(s). The
199 * parameters are to be stored in the param array, and the output is placed
200 * into the same array. The number of the parameters and output values is
201 * encoded in bits 8-11 of the command number.
204 static int __i8042_command(unsigned char *param, int command)
206 int i, error;
208 if (i8042_noloop && command == I8042_CMD_AUX_LOOP)
209 return -1;
211 error = i8042_wait_write();
212 if (error)
213 return error;
215 dbg("%02x -> i8042 (command)", command & 0xff);
216 i8042_write_command(command & 0xff);
218 for (i = 0; i < ((command >> 12) & 0xf); i++) {
219 error = i8042_wait_write();
220 if (error)
221 return error;
222 dbg("%02x -> i8042 (parameter)", param[i]);
223 i8042_write_data(param[i]);
226 for (i = 0; i < ((command >> 8) & 0xf); i++) {
227 error = i8042_wait_read();
228 if (error) {
229 dbg(" -- i8042 (timeout)");
230 return error;
233 if (command == I8042_CMD_AUX_LOOP &&
234 !(i8042_read_status() & I8042_STR_AUXDATA)) {
235 dbg(" -- i8042 (auxerr)");
236 return -1;
239 param[i] = i8042_read_data();
240 dbg("%02x <- i8042 (return)", param[i]);
243 return 0;
246 int i8042_command(unsigned char *param, int command)
248 unsigned long flags;
249 int retval;
251 spin_lock_irqsave(&i8042_lock, flags);
252 retval = __i8042_command(param, command);
253 spin_unlock_irqrestore(&i8042_lock, flags);
255 return retval;
257 EXPORT_SYMBOL(i8042_command);
260 * i8042_kbd_write() sends a byte out through the keyboard interface.
263 static int i8042_kbd_write(struct serio *port, unsigned char c)
265 unsigned long flags;
266 int retval = 0;
268 spin_lock_irqsave(&i8042_lock, flags);
270 if (!(retval = i8042_wait_write())) {
271 dbg("%02x -> i8042 (kbd-data)", c);
272 i8042_write_data(c);
275 spin_unlock_irqrestore(&i8042_lock, flags);
277 return retval;
281 * i8042_aux_write() sends a byte out through the aux interface.
284 static int i8042_aux_write(struct serio *serio, unsigned char c)
286 struct i8042_port *port = serio->port_data;
288 return i8042_command(&c, port->mux == -1 ?
289 I8042_CMD_AUX_SEND :
290 I8042_CMD_MUX_SEND + port->mux);
295 * i8042_aux_close attempts to clear AUX or KBD port state by disabling
296 * and then re-enabling it.
299 static void i8042_port_close(struct serio *serio)
301 int irq_bit;
302 int disable_bit;
303 const char *port_name;
305 if (serio == i8042_ports[I8042_AUX_PORT_NO].serio) {
306 irq_bit = I8042_CTR_AUXINT;
307 disable_bit = I8042_CTR_AUXDIS;
308 port_name = "AUX";
309 } else {
310 irq_bit = I8042_CTR_KBDINT;
311 disable_bit = I8042_CTR_KBDDIS;
312 port_name = "KBD";
315 i8042_ctr &= ~irq_bit;
316 if (i8042_command(&i8042_ctr, I8042_CMD_CTL_WCTR))
317 printk(KERN_WARNING
318 "i8042.c: Can't write CTR while closing %s port.\n",
319 port_name);
321 udelay(50);
323 i8042_ctr &= ~disable_bit;
324 i8042_ctr |= irq_bit;
325 if (i8042_command(&i8042_ctr, I8042_CMD_CTL_WCTR))
326 printk(KERN_ERR "i8042.c: Can't reactivate %s port.\n",
327 port_name);
330 * See if there is any data appeared while we were messing with
331 * port state.
333 i8042_interrupt(0, NULL);
337 * i8042_start() is called by serio core when port is about to finish
338 * registering. It will mark port as existing so i8042_interrupt can
339 * start sending data through it.
341 static int i8042_start(struct serio *serio)
343 struct i8042_port *port = serio->port_data;
345 port->exists = true;
346 mb();
347 return 0;
351 * i8042_stop() marks serio port as non-existing so i8042_interrupt
352 * will not try to send data to the port that is about to go away.
353 * The function is called by serio core as part of unregister procedure.
355 static void i8042_stop(struct serio *serio)
357 struct i8042_port *port = serio->port_data;
359 port->exists = false;
362 * We synchronize with both AUX and KBD IRQs because there is
363 * a (very unlikely) chance that AUX IRQ is raised for KBD port
364 * and vice versa.
366 synchronize_irq(I8042_AUX_IRQ);
367 synchronize_irq(I8042_KBD_IRQ);
368 port->serio = NULL;
372 * i8042_interrupt() is the most important function in this driver -
373 * it handles the interrupts from the i8042, and sends incoming bytes
374 * to the upper layers.
377 static irqreturn_t i8042_interrupt(int irq, void *dev_id)
379 struct i8042_port *port;
380 unsigned long flags;
381 unsigned char str, data;
382 unsigned int dfl;
383 unsigned int port_no;
384 int ret = 1;
386 spin_lock_irqsave(&i8042_lock, flags);
387 str = i8042_read_status();
388 if (unlikely(~str & I8042_STR_OBF)) {
389 spin_unlock_irqrestore(&i8042_lock, flags);
390 if (irq) dbg("Interrupt %d, without any data", irq);
391 ret = 0;
392 goto out;
394 data = i8042_read_data();
395 spin_unlock_irqrestore(&i8042_lock, flags);
397 if (i8042_mux_present && (str & I8042_STR_AUXDATA)) {
398 static unsigned long last_transmit;
399 static unsigned char last_str;
401 dfl = 0;
402 if (str & I8042_STR_MUXERR) {
403 dbg("MUX error, status is %02x, data is %02x", str, data);
405 * When MUXERR condition is signalled the data register can only contain
406 * 0xfd, 0xfe or 0xff if implementation follows the spec. Unfortunately
407 * it is not always the case. Some KBCs also report 0xfc when there is
408 * nothing connected to the port while others sometimes get confused which
409 * port the data came from and signal error leaving the data intact. They
410 * _do not_ revert to legacy mode (actually I've never seen KBC reverting
411 * to legacy mode yet, when we see one we'll add proper handling).
412 * Anyway, we process 0xfc, 0xfd, 0xfe and 0xff as timeouts, and for the
413 * rest assume that the data came from the same serio last byte
414 * was transmitted (if transmission happened not too long ago).
417 switch (data) {
418 default:
419 if (time_before(jiffies, last_transmit + HZ/10)) {
420 str = last_str;
421 break;
423 /* fall through - report timeout */
424 case 0xfc:
425 case 0xfd:
426 case 0xfe: dfl = SERIO_TIMEOUT; data = 0xfe; break;
427 case 0xff: dfl = SERIO_PARITY; data = 0xfe; break;
431 port_no = I8042_MUX_PORT_NO + ((str >> 6) & 3);
432 last_str = str;
433 last_transmit = jiffies;
434 } else {
436 dfl = ((str & I8042_STR_PARITY) ? SERIO_PARITY : 0) |
437 ((str & I8042_STR_TIMEOUT) ? SERIO_TIMEOUT : 0);
439 port_no = (str & I8042_STR_AUXDATA) ?
440 I8042_AUX_PORT_NO : I8042_KBD_PORT_NO;
443 port = &i8042_ports[port_no];
445 dbg("%02x <- i8042 (interrupt, %d, %d%s%s)",
446 data, port_no, irq,
447 dfl & SERIO_PARITY ? ", bad parity" : "",
448 dfl & SERIO_TIMEOUT ? ", timeout" : "");
450 if (unlikely(i8042_suppress_kbd_ack))
451 if (port_no == I8042_KBD_PORT_NO &&
452 (data == 0xfa || data == 0xfe)) {
453 i8042_suppress_kbd_ack--;
454 goto out;
457 if (likely(port->exists))
458 serio_interrupt(port->serio, data, dfl);
460 out:
461 return IRQ_RETVAL(ret);
465 * i8042_enable_kbd_port enables keyboard port on chip
468 static int i8042_enable_kbd_port(void)
470 i8042_ctr &= ~I8042_CTR_KBDDIS;
471 i8042_ctr |= I8042_CTR_KBDINT;
473 if (i8042_command(&i8042_ctr, I8042_CMD_CTL_WCTR)) {
474 i8042_ctr &= ~I8042_CTR_KBDINT;
475 i8042_ctr |= I8042_CTR_KBDDIS;
476 printk(KERN_ERR "i8042.c: Failed to enable KBD port.\n");
477 return -EIO;
480 return 0;
484 * i8042_enable_aux_port enables AUX (mouse) port on chip
487 static int i8042_enable_aux_port(void)
489 i8042_ctr &= ~I8042_CTR_AUXDIS;
490 i8042_ctr |= I8042_CTR_AUXINT;
492 if (i8042_command(&i8042_ctr, I8042_CMD_CTL_WCTR)) {
493 i8042_ctr &= ~I8042_CTR_AUXINT;
494 i8042_ctr |= I8042_CTR_AUXDIS;
495 printk(KERN_ERR "i8042.c: Failed to enable AUX port.\n");
496 return -EIO;
499 return 0;
503 * i8042_enable_mux_ports enables 4 individual AUX ports after
504 * the controller has been switched into Multiplexed mode
507 static int i8042_enable_mux_ports(void)
509 unsigned char param;
510 int i;
512 for (i = 0; i < I8042_NUM_MUX_PORTS; i++) {
513 i8042_command(&param, I8042_CMD_MUX_PFX + i);
514 i8042_command(&param, I8042_CMD_AUX_ENABLE);
517 return i8042_enable_aux_port();
521 * i8042_set_mux_mode checks whether the controller has an
522 * active multiplexor and puts the chip into Multiplexed (true)
523 * or Legacy (false) mode.
526 static int i8042_set_mux_mode(bool multiplex, unsigned char *mux_version)
529 unsigned char param, val;
531 * Get rid of bytes in the queue.
534 i8042_flush();
537 * Internal loopback test - send three bytes, they should come back from the
538 * mouse interface, the last should be version.
541 param = val = 0xf0;
542 if (i8042_command(&param, I8042_CMD_AUX_LOOP) || param != val)
543 return -1;
544 param = val = multiplex ? 0x56 : 0xf6;
545 if (i8042_command(&param, I8042_CMD_AUX_LOOP) || param != val)
546 return -1;
547 param = val = multiplex ? 0xa4 : 0xa5;
548 if (i8042_command(&param, I8042_CMD_AUX_LOOP) || param == val)
549 return -1;
552 * Workaround for interference with USB Legacy emulation
553 * that causes a v10.12 MUX to be found.
555 if (param == 0xac)
556 return -1;
558 if (mux_version)
559 *mux_version = param;
561 return 0;
565 * i8042_check_mux() checks whether the controller supports the PS/2 Active
566 * Multiplexing specification by Synaptics, Phoenix, Insyde and
567 * LCS/Telegraphics.
570 static int __init i8042_check_mux(void)
572 unsigned char mux_version;
574 if (i8042_set_mux_mode(true, &mux_version))
575 return -1;
577 printk(KERN_INFO "i8042.c: Detected active multiplexing controller, rev %d.%d.\n",
578 (mux_version >> 4) & 0xf, mux_version & 0xf);
581 * Disable all muxed ports by disabling AUX.
583 i8042_ctr |= I8042_CTR_AUXDIS;
584 i8042_ctr &= ~I8042_CTR_AUXINT;
586 if (i8042_command(&i8042_ctr, I8042_CMD_CTL_WCTR)) {
587 printk(KERN_ERR "i8042.c: Failed to disable AUX port, can't use MUX.\n");
588 return -EIO;
591 i8042_mux_present = true;
593 return 0;
597 * The following is used to test AUX IRQ delivery.
599 static struct completion i8042_aux_irq_delivered __initdata;
600 static bool i8042_irq_being_tested __initdata;
602 static irqreturn_t __init i8042_aux_test_irq(int irq, void *dev_id)
604 unsigned long flags;
605 unsigned char str, data;
606 int ret = 0;
608 spin_lock_irqsave(&i8042_lock, flags);
609 str = i8042_read_status();
610 if (str & I8042_STR_OBF) {
611 data = i8042_read_data();
612 dbg("%02x <- i8042 (aux_test_irq, %s)",
613 data, str & I8042_STR_AUXDATA ? "aux" : "kbd");
614 if (i8042_irq_being_tested &&
615 data == 0xa5 && (str & I8042_STR_AUXDATA))
616 complete(&i8042_aux_irq_delivered);
617 ret = 1;
619 spin_unlock_irqrestore(&i8042_lock, flags);
621 return IRQ_RETVAL(ret);
625 * i8042_toggle_aux - enables or disables AUX port on i8042 via command and
626 * verifies success by readinng CTR. Used when testing for presence of AUX
627 * port.
629 static int __init i8042_toggle_aux(bool on)
631 unsigned char param;
632 int i;
634 if (i8042_command(&param,
635 on ? I8042_CMD_AUX_ENABLE : I8042_CMD_AUX_DISABLE))
636 return -1;
638 /* some chips need some time to set the I8042_CTR_AUXDIS bit */
639 for (i = 0; i < 100; i++) {
640 udelay(50);
642 if (i8042_command(&param, I8042_CMD_CTL_RCTR))
643 return -1;
645 if (!(param & I8042_CTR_AUXDIS) == on)
646 return 0;
649 return -1;
653 * i8042_check_aux() applies as much paranoia as it can at detecting
654 * the presence of an AUX interface.
657 static int __init i8042_check_aux(void)
659 int retval = -1;
660 bool irq_registered = false;
661 bool aux_loop_broken = false;
662 unsigned long flags;
663 unsigned char param;
666 * Get rid of bytes in the queue.
669 i8042_flush();
672 * Internal loopback test - filters out AT-type i8042's. Unfortunately
673 * SiS screwed up and their 5597 doesn't support the LOOP command even
674 * though it has an AUX port.
677 param = 0x5a;
678 retval = i8042_command(&param, I8042_CMD_AUX_LOOP);
679 if (retval || param != 0x5a) {
682 * External connection test - filters out AT-soldered PS/2 i8042's
683 * 0x00 - no error, 0x01-0x03 - clock/data stuck, 0xff - general error
684 * 0xfa - no error on some notebooks which ignore the spec
685 * Because it's common for chipsets to return error on perfectly functioning
686 * AUX ports, we test for this only when the LOOP command failed.
689 if (i8042_command(&param, I8042_CMD_AUX_TEST) ||
690 (param && param != 0xfa && param != 0xff))
691 return -1;
694 * If AUX_LOOP completed without error but returned unexpected data
695 * mark it as broken
697 if (!retval)
698 aux_loop_broken = true;
702 * Bit assignment test - filters out PS/2 i8042's in AT mode
705 if (i8042_toggle_aux(false)) {
706 printk(KERN_WARNING "Failed to disable AUX port, but continuing anyway... Is this a SiS?\n");
707 printk(KERN_WARNING "If AUX port is really absent please use the 'i8042.noaux' option.\n");
710 if (i8042_toggle_aux(true))
711 return -1;
714 * Test AUX IRQ delivery to make sure BIOS did not grab the IRQ and
715 * used it for a PCI card or somethig else.
718 if (i8042_noloop || i8042_bypass_aux_irq_test || aux_loop_broken) {
720 * Without LOOP command we can't test AUX IRQ delivery. Assume the port
721 * is working and hope we are right.
723 retval = 0;
724 goto out;
727 if (request_irq(I8042_AUX_IRQ, i8042_aux_test_irq, IRQF_SHARED,
728 "i8042", i8042_platform_device))
729 goto out;
731 irq_registered = true;
733 if (i8042_enable_aux_port())
734 goto out;
736 spin_lock_irqsave(&i8042_lock, flags);
738 init_completion(&i8042_aux_irq_delivered);
739 i8042_irq_being_tested = true;
741 param = 0xa5;
742 retval = __i8042_command(&param, I8042_CMD_AUX_LOOP & 0xf0ff);
744 spin_unlock_irqrestore(&i8042_lock, flags);
746 if (retval)
747 goto out;
749 if (wait_for_completion_timeout(&i8042_aux_irq_delivered,
750 msecs_to_jiffies(250)) == 0) {
752 * AUX IRQ was never delivered so we need to flush the controller to
753 * get rid of the byte we put there; otherwise keyboard may not work.
755 dbg(" -- i8042 (aux irq test timeout)");
756 i8042_flush();
757 retval = -1;
760 out:
763 * Disable the interface.
766 i8042_ctr |= I8042_CTR_AUXDIS;
767 i8042_ctr &= ~I8042_CTR_AUXINT;
769 if (i8042_command(&i8042_ctr, I8042_CMD_CTL_WCTR))
770 retval = -1;
772 if (irq_registered)
773 free_irq(I8042_AUX_IRQ, i8042_platform_device);
775 return retval;
778 static int i8042_controller_check(void)
780 if (i8042_flush() == I8042_BUFFER_SIZE) {
781 printk(KERN_ERR "i8042.c: No controller found.\n");
782 return -ENODEV;
785 return 0;
788 static int i8042_controller_selftest(void)
790 unsigned char param;
791 int i = 0;
793 if (!i8042_reset)
794 return 0;
797 * We try this 5 times; on some really fragile systems this does not
798 * take the first time...
800 do {
802 if (i8042_command(&param, I8042_CMD_CTL_TEST)) {
803 printk(KERN_ERR "i8042.c: i8042 controller self test timeout.\n");
804 return -ENODEV;
807 if (param == I8042_RET_CTL_TEST)
808 return 0;
810 printk(KERN_ERR "i8042.c: i8042 controller selftest failed. (%#x != %#x)\n",
811 param, I8042_RET_CTL_TEST);
812 msleep(50);
813 } while (i++ < 5);
815 #ifdef CONFIG_X86
817 * On x86, we don't fail entire i8042 initialization if controller
818 * reset fails in hopes that keyboard port will still be functional
819 * and user will still get a working keyboard. This is especially
820 * important on netbooks. On other arches we trust hardware more.
822 printk(KERN_INFO
823 "i8042: giving up on controller selftest, continuing anyway...\n");
824 return 0;
825 #else
826 return -EIO;
827 #endif
831 * i8042_controller init initializes the i8042 controller, and,
832 * most importantly, sets it into non-xlated mode if that's
833 * desired.
836 static int i8042_controller_init(void)
838 unsigned long flags;
841 * Save the CTR for restoral on unload / reboot.
844 if (i8042_command(&i8042_ctr, I8042_CMD_CTL_RCTR)) {
845 printk(KERN_ERR "i8042.c: Can't read CTR while initializing i8042.\n");
846 return -EIO;
849 i8042_initial_ctr = i8042_ctr;
852 * Disable the keyboard interface and interrupt.
855 i8042_ctr |= I8042_CTR_KBDDIS;
856 i8042_ctr &= ~I8042_CTR_KBDINT;
859 * Handle keylock.
862 spin_lock_irqsave(&i8042_lock, flags);
863 if (~i8042_read_status() & I8042_STR_KEYLOCK) {
864 if (i8042_unlock)
865 i8042_ctr |= I8042_CTR_IGNKEYLOCK;
866 else
867 printk(KERN_WARNING "i8042.c: Warning: Keylock active.\n");
869 spin_unlock_irqrestore(&i8042_lock, flags);
872 * If the chip is configured into nontranslated mode by the BIOS, don't
873 * bother enabling translating and be happy.
876 if (~i8042_ctr & I8042_CTR_XLATE)
877 i8042_direct = true;
880 * Set nontranslated mode for the kbd interface if requested by an option.
881 * After this the kbd interface becomes a simple serial in/out, like the aux
882 * interface is. We don't do this by default, since it can confuse notebook
883 * BIOSes.
886 if (i8042_direct)
887 i8042_ctr &= ~I8042_CTR_XLATE;
890 * Write CTR back.
893 if (i8042_command(&i8042_ctr, I8042_CMD_CTL_WCTR)) {
894 printk(KERN_ERR "i8042.c: Can't write CTR while initializing i8042.\n");
895 return -EIO;
898 return 0;
903 * Reset the controller and reset CRT to the original value set by BIOS.
906 static void i8042_controller_reset(void)
908 i8042_flush();
911 * Disable both KBD and AUX interfaces so they don't get in the way
914 i8042_ctr |= I8042_CTR_KBDDIS | I8042_CTR_AUXDIS;
915 i8042_ctr &= ~(I8042_CTR_KBDINT | I8042_CTR_AUXINT);
917 if (i8042_command(&i8042_initial_ctr, I8042_CMD_CTL_WCTR))
918 printk(KERN_WARNING "i8042.c: Can't write CTR while resetting.\n");
921 * Disable MUX mode if present.
924 if (i8042_mux_present)
925 i8042_set_mux_mode(false, NULL);
928 * Reset the controller if requested.
931 i8042_controller_selftest();
934 * Restore the original control register setting.
937 if (i8042_command(&i8042_initial_ctr, I8042_CMD_CTL_WCTR))
938 printk(KERN_WARNING "i8042.c: Can't restore CTR.\n");
943 * i8042_panic_blink() will flash the keyboard LEDs and is called when
944 * kernel panics. Flashing LEDs is useful for users running X who may
945 * not see the console and will help distingushing panics from "real"
946 * lockups.
948 * Note that DELAY has a limit of 10ms so we will not get stuck here
949 * waiting for KBC to free up even if KBD interrupt is off
952 #define DELAY do { mdelay(1); if (++delay > 10) return delay; } while(0)
954 static long i8042_panic_blink(long count)
956 long delay = 0;
957 static long last_blink;
958 static char led;
961 * We expect frequency to be about 1/2s. KDB uses about 1s.
962 * Make sure they are different.
964 if (!i8042_blink_frequency)
965 return 0;
966 if (count - last_blink < i8042_blink_frequency)
967 return 0;
969 led ^= 0x01 | 0x04;
970 while (i8042_read_status() & I8042_STR_IBF)
971 DELAY;
972 dbg("%02x -> i8042 (panic blink)", 0xed);
973 i8042_suppress_kbd_ack = 2;
974 i8042_write_data(0xed); /* set leds */
975 DELAY;
976 while (i8042_read_status() & I8042_STR_IBF)
977 DELAY;
978 DELAY;
979 dbg("%02x -> i8042 (panic blink)", led);
980 i8042_write_data(led);
981 DELAY;
982 last_blink = count;
983 return delay;
986 #undef DELAY
988 #ifdef CONFIG_X86
989 static void i8042_dritek_enable(void)
991 char param = 0x90;
992 int error;
994 error = i8042_command(&param, 0x1059);
995 if (error)
996 printk(KERN_WARNING
997 "Failed to enable DRITEK extension: %d\n",
998 error);
1000 #endif
1002 #ifdef CONFIG_PM
1005 * Here we try to restore the original BIOS settings to avoid
1006 * upsetting it.
1009 static int i8042_pm_reset(struct device *dev)
1011 i8042_controller_reset();
1013 return 0;
1017 * Here we try to reset everything back to a state we had
1018 * before suspending.
1021 static int i8042_pm_restore(struct device *dev)
1023 int error;
1025 error = i8042_controller_check();
1026 if (error)
1027 return error;
1029 error = i8042_controller_selftest();
1030 if (error)
1031 return error;
1034 * Restore original CTR value and disable all ports
1037 i8042_ctr = i8042_initial_ctr;
1038 if (i8042_direct)
1039 i8042_ctr &= ~I8042_CTR_XLATE;
1040 i8042_ctr |= I8042_CTR_AUXDIS | I8042_CTR_KBDDIS;
1041 i8042_ctr &= ~(I8042_CTR_AUXINT | I8042_CTR_KBDINT);
1042 if (i8042_command(&i8042_ctr, I8042_CMD_CTL_WCTR)) {
1043 printk(KERN_WARNING "i8042: Can't write CTR to resume, retrying...\n");
1044 msleep(50);
1045 if (i8042_command(&i8042_ctr, I8042_CMD_CTL_WCTR)) {
1046 printk(KERN_ERR "i8042: CTR write retry failed\n");
1047 return -EIO;
1052 #ifdef CONFIG_X86
1053 if (i8042_dritek)
1054 i8042_dritek_enable();
1055 #endif
1057 if (i8042_mux_present) {
1058 if (i8042_set_mux_mode(true, NULL) || i8042_enable_mux_ports())
1059 printk(KERN_WARNING
1060 "i8042: failed to resume active multiplexor, "
1061 "mouse won't work.\n");
1062 } else if (i8042_ports[I8042_AUX_PORT_NO].serio)
1063 i8042_enable_aux_port();
1065 if (i8042_ports[I8042_KBD_PORT_NO].serio)
1066 i8042_enable_kbd_port();
1068 i8042_interrupt(0, NULL);
1070 return 0;
1073 static const struct dev_pm_ops i8042_pm_ops = {
1074 .suspend = i8042_pm_reset,
1075 .resume = i8042_pm_restore,
1076 .poweroff = i8042_pm_reset,
1077 .restore = i8042_pm_restore,
1080 #endif /* CONFIG_PM */
1083 * We need to reset the 8042 back to original mode on system shutdown,
1084 * because otherwise BIOSes will be confused.
1087 static void i8042_shutdown(struct platform_device *dev)
1089 i8042_controller_reset();
1092 static int __init i8042_create_kbd_port(void)
1094 struct serio *serio;
1095 struct i8042_port *port = &i8042_ports[I8042_KBD_PORT_NO];
1097 serio = kzalloc(sizeof(struct serio), GFP_KERNEL);
1098 if (!serio)
1099 return -ENOMEM;
1101 serio->id.type = i8042_direct ? SERIO_8042 : SERIO_8042_XL;
1102 serio->write = i8042_dumbkbd ? NULL : i8042_kbd_write;
1103 serio->start = i8042_start;
1104 serio->stop = i8042_stop;
1105 serio->close = i8042_port_close;
1106 serio->port_data = port;
1107 serio->dev.parent = &i8042_platform_device->dev;
1108 strlcpy(serio->name, "i8042 KBD port", sizeof(serio->name));
1109 strlcpy(serio->phys, I8042_KBD_PHYS_DESC, sizeof(serio->phys));
1111 port->serio = serio;
1112 port->irq = I8042_KBD_IRQ;
1114 return 0;
1117 static int __init i8042_create_aux_port(int idx)
1119 struct serio *serio;
1120 int port_no = idx < 0 ? I8042_AUX_PORT_NO : I8042_MUX_PORT_NO + idx;
1121 struct i8042_port *port = &i8042_ports[port_no];
1123 serio = kzalloc(sizeof(struct serio), GFP_KERNEL);
1124 if (!serio)
1125 return -ENOMEM;
1127 serio->id.type = SERIO_8042;
1128 serio->write = i8042_aux_write;
1129 serio->start = i8042_start;
1130 serio->stop = i8042_stop;
1131 serio->port_data = port;
1132 serio->dev.parent = &i8042_platform_device->dev;
1133 if (idx < 0) {
1134 strlcpy(serio->name, "i8042 AUX port", sizeof(serio->name));
1135 strlcpy(serio->phys, I8042_AUX_PHYS_DESC, sizeof(serio->phys));
1136 serio->close = i8042_port_close;
1137 } else {
1138 snprintf(serio->name, sizeof(serio->name), "i8042 AUX%d port", idx);
1139 snprintf(serio->phys, sizeof(serio->phys), I8042_MUX_PHYS_DESC, idx + 1);
1142 port->serio = serio;
1143 port->mux = idx;
1144 port->irq = I8042_AUX_IRQ;
1146 return 0;
1149 static void __init i8042_free_kbd_port(void)
1151 kfree(i8042_ports[I8042_KBD_PORT_NO].serio);
1152 i8042_ports[I8042_KBD_PORT_NO].serio = NULL;
1155 static void __init i8042_free_aux_ports(void)
1157 int i;
1159 for (i = I8042_AUX_PORT_NO; i < I8042_NUM_PORTS; i++) {
1160 kfree(i8042_ports[i].serio);
1161 i8042_ports[i].serio = NULL;
1165 static void __init i8042_register_ports(void)
1167 int i;
1169 for (i = 0; i < I8042_NUM_PORTS; i++) {
1170 if (i8042_ports[i].serio) {
1171 printk(KERN_INFO "serio: %s at %#lx,%#lx irq %d\n",
1172 i8042_ports[i].serio->name,
1173 (unsigned long) I8042_DATA_REG,
1174 (unsigned long) I8042_COMMAND_REG,
1175 i8042_ports[i].irq);
1176 serio_register_port(i8042_ports[i].serio);
1181 static void __devexit i8042_unregister_ports(void)
1183 int i;
1185 for (i = 0; i < I8042_NUM_PORTS; i++) {
1186 if (i8042_ports[i].serio) {
1187 serio_unregister_port(i8042_ports[i].serio);
1188 i8042_ports[i].serio = NULL;
1194 * Checks whether port belongs to i8042 controller.
1196 bool i8042_check_port_owner(const struct serio *port)
1198 int i;
1200 for (i = 0; i < I8042_NUM_PORTS; i++)
1201 if (i8042_ports[i].serio == port)
1202 return true;
1204 return false;
1206 EXPORT_SYMBOL(i8042_check_port_owner);
1208 static void i8042_free_irqs(void)
1210 if (i8042_aux_irq_registered)
1211 free_irq(I8042_AUX_IRQ, i8042_platform_device);
1212 if (i8042_kbd_irq_registered)
1213 free_irq(I8042_KBD_IRQ, i8042_platform_device);
1215 i8042_aux_irq_registered = i8042_kbd_irq_registered = false;
1218 static int __init i8042_setup_aux(void)
1220 int (*aux_enable)(void);
1221 int error;
1222 int i;
1224 if (i8042_check_aux())
1225 return -ENODEV;
1227 if (i8042_nomux || i8042_check_mux()) {
1228 error = i8042_create_aux_port(-1);
1229 if (error)
1230 goto err_free_ports;
1231 aux_enable = i8042_enable_aux_port;
1232 } else {
1233 for (i = 0; i < I8042_NUM_MUX_PORTS; i++) {
1234 error = i8042_create_aux_port(i);
1235 if (error)
1236 goto err_free_ports;
1238 aux_enable = i8042_enable_mux_ports;
1241 error = request_irq(I8042_AUX_IRQ, i8042_interrupt, IRQF_SHARED,
1242 "i8042", i8042_platform_device);
1243 if (error)
1244 goto err_free_ports;
1246 if (aux_enable())
1247 goto err_free_irq;
1249 i8042_aux_irq_registered = true;
1250 return 0;
1252 err_free_irq:
1253 free_irq(I8042_AUX_IRQ, i8042_platform_device);
1254 err_free_ports:
1255 i8042_free_aux_ports();
1256 return error;
1259 static int __init i8042_setup_kbd(void)
1261 int error;
1263 error = i8042_create_kbd_port();
1264 if (error)
1265 return error;
1267 error = request_irq(I8042_KBD_IRQ, i8042_interrupt, IRQF_SHARED,
1268 "i8042", i8042_platform_device);
1269 if (error)
1270 goto err_free_port;
1272 error = i8042_enable_kbd_port();
1273 if (error)
1274 goto err_free_irq;
1276 i8042_kbd_irq_registered = true;
1277 return 0;
1279 err_free_irq:
1280 free_irq(I8042_KBD_IRQ, i8042_platform_device);
1281 err_free_port:
1282 i8042_free_kbd_port();
1283 return error;
1286 static int __init i8042_probe(struct platform_device *dev)
1288 int error;
1290 error = i8042_controller_selftest();
1291 if (error)
1292 return error;
1294 error = i8042_controller_init();
1295 if (error)
1296 return error;
1298 #ifdef CONFIG_X86
1299 if (i8042_dritek)
1300 i8042_dritek_enable();
1301 #endif
1303 if (!i8042_noaux) {
1304 error = i8042_setup_aux();
1305 if (error && error != -ENODEV && error != -EBUSY)
1306 goto out_fail;
1309 if (!i8042_nokbd) {
1310 error = i8042_setup_kbd();
1311 if (error)
1312 goto out_fail;
1315 * Ok, everything is ready, let's register all serio ports
1317 i8042_register_ports();
1319 return 0;
1321 out_fail:
1322 i8042_free_aux_ports(); /* in case KBD failed but AUX not */
1323 i8042_free_irqs();
1324 i8042_controller_reset();
1326 return error;
1329 static int __devexit i8042_remove(struct platform_device *dev)
1331 i8042_unregister_ports();
1332 i8042_free_irqs();
1333 i8042_controller_reset();
1335 return 0;
1338 static struct platform_driver i8042_driver = {
1339 .driver = {
1340 .name = "i8042",
1341 .owner = THIS_MODULE,
1342 #ifdef CONFIG_PM
1343 .pm = &i8042_pm_ops,
1344 #endif
1346 .remove = __devexit_p(i8042_remove),
1347 .shutdown = i8042_shutdown,
1350 static int __init i8042_init(void)
1352 int err;
1354 dbg_init();
1356 err = i8042_platform_init();
1357 if (err)
1358 return err;
1360 err = i8042_controller_check();
1361 if (err)
1362 goto err_platform_exit;
1364 i8042_platform_device = platform_device_alloc("i8042", -1);
1365 if (!i8042_platform_device) {
1366 err = -ENOMEM;
1367 goto err_platform_exit;
1370 err = platform_device_add(i8042_platform_device);
1371 if (err)
1372 goto err_free_device;
1374 err = platform_driver_probe(&i8042_driver, i8042_probe);
1375 if (err)
1376 goto err_del_device;
1378 panic_blink = i8042_panic_blink;
1380 return 0;
1382 err_del_device:
1383 platform_device_del(i8042_platform_device);
1384 err_free_device:
1385 platform_device_put(i8042_platform_device);
1386 err_platform_exit:
1387 i8042_platform_exit();
1389 return err;
1392 static void __exit i8042_exit(void)
1394 platform_driver_unregister(&i8042_driver);
1395 platform_device_unregister(i8042_platform_device);
1396 i8042_platform_exit();
1398 panic_blink = NULL;
1401 module_init(i8042_init);
1402 module_exit(i8042_exit);