blob: 178e75d6bb06e45738f83e92d73408350a0f81c5 [file] [log] [blame]
yuezonghe824eb0c2024-06-27 02:32:26 -07001/*
2 * i8042 keyboard and mouse controller driver for Linux
3 *
4 * Copyright (c) 1999-2004 Vojtech Pavlik
5 */
6
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.
11 */
12
13#define pr_fmt(fmt) KBUILD_MODNAME ": " fmt
14
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>
27
28#include <asm/io.h>
29
30MODULE_AUTHOR("Vojtech Pavlik <vojtech@suse.cz>");
31MODULE_DESCRIPTION("i8042 keyboard and mouse controller driver");
32MODULE_LICENSE("GPL");
33
34static bool i8042_nokbd;
35module_param_named(nokbd, i8042_nokbd, bool, 0);
36MODULE_PARM_DESC(nokbd, "Do not probe or use KBD port.");
37
38static bool i8042_noaux;
39module_param_named(noaux, i8042_noaux, bool, 0);
40MODULE_PARM_DESC(noaux, "Do not probe or use AUX (mouse) port.");
41
42static bool i8042_nomux;
43module_param_named(nomux, i8042_nomux, bool, 0);
44MODULE_PARM_DESC(nomux, "Do not check whether an active multiplexing controller is present.");
45
46static bool i8042_unlock;
47module_param_named(unlock, i8042_unlock, bool, 0);
48MODULE_PARM_DESC(unlock, "Ignore keyboard lock.");
49
50static bool i8042_reset;
51module_param_named(reset, i8042_reset, bool, 0);
52MODULE_PARM_DESC(reset, "Reset controller during init and cleanup.");
53
54static bool i8042_direct;
55module_param_named(direct, i8042_direct, bool, 0);
56MODULE_PARM_DESC(direct, "Put keyboard port into non-translated mode.");
57
58static bool i8042_dumbkbd;
59module_param_named(dumbkbd, i8042_dumbkbd, bool, 0);
60MODULE_PARM_DESC(dumbkbd, "Pretend that controller can only read data from keyboard");
61
62static bool i8042_noloop;
63module_param_named(noloop, i8042_noloop, bool, 0);
64MODULE_PARM_DESC(noloop, "Disable the AUX Loopback command while probing for the AUX port");
65
66static bool i8042_notimeout;
67module_param_named(notimeout, i8042_notimeout, bool, 0);
68MODULE_PARM_DESC(notimeout, "Ignore timeouts signalled by i8042");
69
70static bool i8042_kbdreset;
71module_param_named(kbdreset, i8042_kbdreset, bool, 0);
72MODULE_PARM_DESC(kbdreset, "Reset device connected to KBD port");
73
74#ifdef CONFIG_X86
75static bool i8042_dritek;
76module_param_named(dritek, i8042_dritek, bool, 0);
77MODULE_PARM_DESC(dritek, "Force enable the Dritek keyboard extension");
78#endif
79
80#ifdef CONFIG_PNP
81static bool i8042_nopnp;
82module_param_named(nopnp, i8042_nopnp, bool, 0);
83MODULE_PARM_DESC(nopnp, "Do not use PNP to detect controller settings");
84#endif
85
86#define DEBUG
87#ifdef DEBUG
88static bool i8042_debug;
89module_param_named(debug, i8042_debug, bool, 0600);
90MODULE_PARM_DESC(debug, "Turn i8042 debugging mode on and off");
91#endif
92
93static bool i8042_bypass_aux_irq_test;
94
95#include "i8042.h"
96
97/*
98 * i8042_lock protects serialization between i8042_command and
99 * the interrupt handler.
100 */
101static DEFINE_SPINLOCK(i8042_lock);
102
103/*
104 * Writers to AUX and KBD ports as well as users issuing i8042_command
105 * directly should acquire i8042_mutex (by means of calling
106 * i8042_lock_chip() and i8042_unlock_ship() helpers) to ensure that
107 * they do not disturb each other (unfortunately in many i8042
108 * implementations write to one of the ports will immediately abort
109 * command that is being processed by another port).
110 */
111static DEFINE_MUTEX(i8042_mutex);
112
113struct i8042_port {
114 struct serio *serio;
115 int irq;
116 bool exists;
117 signed char mux;
118};
119
120#define I8042_KBD_PORT_NO 0
121#define I8042_AUX_PORT_NO 1
122#define I8042_MUX_PORT_NO 2
123#define I8042_NUM_PORTS (I8042_NUM_MUX_PORTS + 2)
124
125static struct i8042_port i8042_ports[I8042_NUM_PORTS];
126
127static unsigned char i8042_initial_ctr;
128static unsigned char i8042_ctr;
129static bool i8042_mux_present;
130static bool i8042_kbd_irq_registered;
131static bool i8042_aux_irq_registered;
132static unsigned char i8042_suppress_kbd_ack;
133static struct platform_device *i8042_platform_device;
134
135static irqreturn_t i8042_interrupt(int irq, void *dev_id);
136static bool (*i8042_platform_filter)(unsigned char data, unsigned char str,
137 struct serio *serio);
138
139void i8042_lock_chip(void)
140{
141 mutex_lock(&i8042_mutex);
142}
143EXPORT_SYMBOL(i8042_lock_chip);
144
145void i8042_unlock_chip(void)
146{
147 mutex_unlock(&i8042_mutex);
148}
149EXPORT_SYMBOL(i8042_unlock_chip);
150
151int i8042_install_filter(bool (*filter)(unsigned char data, unsigned char str,
152 struct serio *serio))
153{
154 unsigned long flags;
155 int ret = 0;
156
157 spin_lock_irqsave(&i8042_lock, flags);
158
159 if (i8042_platform_filter) {
160 ret = -EBUSY;
161 goto out;
162 }
163
164 i8042_platform_filter = filter;
165
166out:
167 spin_unlock_irqrestore(&i8042_lock, flags);
168 return ret;
169}
170EXPORT_SYMBOL(i8042_install_filter);
171
172int i8042_remove_filter(bool (*filter)(unsigned char data, unsigned char str,
173 struct serio *port))
174{
175 unsigned long flags;
176 int ret = 0;
177
178 spin_lock_irqsave(&i8042_lock, flags);
179
180 if (i8042_platform_filter != filter) {
181 ret = -EINVAL;
182 goto out;
183 }
184
185 i8042_platform_filter = NULL;
186
187out:
188 spin_unlock_irqrestore(&i8042_lock, flags);
189 return ret;
190}
191EXPORT_SYMBOL(i8042_remove_filter);
192
193/*
194 * The i8042_wait_read() and i8042_wait_write functions wait for the i8042 to
195 * be ready for reading values from it / writing values to it.
196 * Called always with i8042_lock held.
197 */
198
199static int i8042_wait_read(void)
200{
201 int i = 0;
202
203 while ((~i8042_read_status() & I8042_STR_OBF) && (i < I8042_CTL_TIMEOUT)) {
204 udelay(50);
205 i++;
206 }
207 return -(i == I8042_CTL_TIMEOUT);
208}
209
210static int i8042_wait_write(void)
211{
212 int i = 0;
213
214 while ((i8042_read_status() & I8042_STR_IBF) && (i < I8042_CTL_TIMEOUT)) {
215 udelay(50);
216 i++;
217 }
218 return -(i == I8042_CTL_TIMEOUT);
219}
220
221/*
222 * i8042_flush() flushes all data that may be in the keyboard and mouse buffers
223 * of the i8042 down the toilet.
224 */
225
226static int i8042_flush(void)
227{
228 unsigned long flags;
229 unsigned char data, str;
230 int i = 0;
231
232 spin_lock_irqsave(&i8042_lock, flags);
233
234 while (((str = i8042_read_status()) & I8042_STR_OBF) && (i < I8042_BUFFER_SIZE)) {
235 udelay(50);
236 data = i8042_read_data();
237 i++;
238 dbg("%02x <- i8042 (flush, %s)\n",
239 data, str & I8042_STR_AUXDATA ? "aux" : "kbd");
240 }
241
242 spin_unlock_irqrestore(&i8042_lock, flags);
243
244 return i;
245}
246
247/*
248 * i8042_command() executes a command on the i8042. It also sends the input
249 * parameter(s) of the commands to it, and receives the output value(s). The
250 * parameters are to be stored in the param array, and the output is placed
251 * into the same array. The number of the parameters and output values is
252 * encoded in bits 8-11 of the command number.
253 */
254
255static int __i8042_command(unsigned char *param, int command)
256{
257 int i, error;
258
259 if (i8042_noloop && command == I8042_CMD_AUX_LOOP)
260 return -1;
261
262 error = i8042_wait_write();
263 if (error)
264 return error;
265
266 dbg("%02x -> i8042 (command)\n", command & 0xff);
267 i8042_write_command(command & 0xff);
268
269 for (i = 0; i < ((command >> 12) & 0xf); i++) {
270 error = i8042_wait_write();
271 if (error)
272 return error;
273 dbg("%02x -> i8042 (parameter)\n", param[i]);
274 i8042_write_data(param[i]);
275 }
276
277 for (i = 0; i < ((command >> 8) & 0xf); i++) {
278 error = i8042_wait_read();
279 if (error) {
280 dbg(" -- i8042 (timeout)\n");
281 return error;
282 }
283
284 if (command == I8042_CMD_AUX_LOOP &&
285 !(i8042_read_status() & I8042_STR_AUXDATA)) {
286 dbg(" -- i8042 (auxerr)\n");
287 return -1;
288 }
289
290 param[i] = i8042_read_data();
291 dbg("%02x <- i8042 (return)\n", param[i]);
292 }
293
294 return 0;
295}
296
297int i8042_command(unsigned char *param, int command)
298{
299 unsigned long flags;
300 int retval;
301
302 spin_lock_irqsave(&i8042_lock, flags);
303 retval = __i8042_command(param, command);
304 spin_unlock_irqrestore(&i8042_lock, flags);
305
306 return retval;
307}
308EXPORT_SYMBOL(i8042_command);
309
310/*
311 * i8042_kbd_write() sends a byte out through the keyboard interface.
312 */
313
314static int i8042_kbd_write(struct serio *port, unsigned char c)
315{
316 unsigned long flags;
317 int retval = 0;
318
319 spin_lock_irqsave(&i8042_lock, flags);
320
321 if (!(retval = i8042_wait_write())) {
322 dbg("%02x -> i8042 (kbd-data)\n", c);
323 i8042_write_data(c);
324 }
325
326 spin_unlock_irqrestore(&i8042_lock, flags);
327
328 return retval;
329}
330
331/*
332 * i8042_aux_write() sends a byte out through the aux interface.
333 */
334
335static int i8042_aux_write(struct serio *serio, unsigned char c)
336{
337 struct i8042_port *port = serio->port_data;
338
339 return i8042_command(&c, port->mux == -1 ?
340 I8042_CMD_AUX_SEND :
341 I8042_CMD_MUX_SEND + port->mux);
342}
343
344
345/*
346 * i8042_aux_close attempts to clear AUX or KBD port state by disabling
347 * and then re-enabling it.
348 */
349
350static void i8042_port_close(struct serio *serio)
351{
352 int irq_bit;
353 int disable_bit;
354 const char *port_name;
355
356 if (serio == i8042_ports[I8042_AUX_PORT_NO].serio) {
357 irq_bit = I8042_CTR_AUXINT;
358 disable_bit = I8042_CTR_AUXDIS;
359 port_name = "AUX";
360 } else {
361 irq_bit = I8042_CTR_KBDINT;
362 disable_bit = I8042_CTR_KBDDIS;
363 port_name = "KBD";
364 }
365
366 i8042_ctr &= ~irq_bit;
367 if (i8042_command(&i8042_ctr, I8042_CMD_CTL_WCTR))
368 pr_warn("Can't write CTR while closing %s port\n", port_name);
369
370 udelay(50);
371
372 i8042_ctr &= ~disable_bit;
373 i8042_ctr |= irq_bit;
374 if (i8042_command(&i8042_ctr, I8042_CMD_CTL_WCTR))
375 pr_err("Can't reactivate %s port\n", port_name);
376
377 /*
378 * See if there is any data appeared while we were messing with
379 * port state.
380 */
381 i8042_interrupt(0, NULL);
382}
383
384/*
385 * i8042_start() is called by serio core when port is about to finish
386 * registering. It will mark port as existing so i8042_interrupt can
387 * start sending data through it.
388 */
389static int i8042_start(struct serio *serio)
390{
391 struct i8042_port *port = serio->port_data;
392
393 port->exists = true;
394 mb();
395 return 0;
396}
397
398/*
399 * i8042_stop() marks serio port as non-existing so i8042_interrupt
400 * will not try to send data to the port that is about to go away.
401 * The function is called by serio core as part of unregister procedure.
402 */
403static void i8042_stop(struct serio *serio)
404{
405 struct i8042_port *port = serio->port_data;
406
407 port->exists = false;
408
409 /*
410 * We synchronize with both AUX and KBD IRQs because there is
411 * a (very unlikely) chance that AUX IRQ is raised for KBD port
412 * and vice versa.
413 */
414 synchronize_irq(I8042_AUX_IRQ);
415 synchronize_irq(I8042_KBD_IRQ);
416 port->serio = NULL;
417}
418
419/*
420 * i8042_filter() filters out unwanted bytes from the input data stream.
421 * It is called from i8042_interrupt and thus is running with interrupts
422 * off and i8042_lock held.
423 */
424static bool i8042_filter(unsigned char data, unsigned char str,
425 struct serio *serio)
426{
427 if (unlikely(i8042_suppress_kbd_ack)) {
428 if ((~str & I8042_STR_AUXDATA) &&
429 (data == 0xfa || data == 0xfe)) {
430 i8042_suppress_kbd_ack--;
431 dbg("Extra keyboard ACK - filtered out\n");
432 return true;
433 }
434 }
435
436 if (i8042_platform_filter && i8042_platform_filter(data, str, serio)) {
437 dbg("Filtered out by platform filter\n");
438 return true;
439 }
440
441 return false;
442}
443
444/*
445 * i8042_interrupt() is the most important function in this driver -
446 * it handles the interrupts from the i8042, and sends incoming bytes
447 * to the upper layers.
448 */
449
450static irqreturn_t i8042_interrupt(int irq, void *dev_id)
451{
452 struct i8042_port *port;
453 struct serio *serio;
454 unsigned long flags;
455 unsigned char str, data;
456 unsigned int dfl;
457 unsigned int port_no;
458 bool filtered;
459 int ret = 1;
460
461 spin_lock_irqsave(&i8042_lock, flags);
462
463 str = i8042_read_status();
464 if (unlikely(~str & I8042_STR_OBF)) {
465 spin_unlock_irqrestore(&i8042_lock, flags);
466 if (irq)
467 dbg("Interrupt %d, without any data\n", irq);
468 ret = 0;
469 goto out;
470 }
471
472 data = i8042_read_data();
473
474 if (i8042_mux_present && (str & I8042_STR_AUXDATA)) {
475 static unsigned long last_transmit;
476 static unsigned char last_str;
477
478 dfl = 0;
479 if (str & I8042_STR_MUXERR) {
480 dbg("MUX error, status is %02x, data is %02x\n",
481 str, data);
482/*
483 * When MUXERR condition is signalled the data register can only contain
484 * 0xfd, 0xfe or 0xff if implementation follows the spec. Unfortunately
485 * it is not always the case. Some KBCs also report 0xfc when there is
486 * nothing connected to the port while others sometimes get confused which
487 * port the data came from and signal error leaving the data intact. They
488 * _do not_ revert to legacy mode (actually I've never seen KBC reverting
489 * to legacy mode yet, when we see one we'll add proper handling).
490 * Anyway, we process 0xfc, 0xfd, 0xfe and 0xff as timeouts, and for the
491 * rest assume that the data came from the same serio last byte
492 * was transmitted (if transmission happened not too long ago).
493 */
494
495 switch (data) {
496 default:
497 if (time_before(jiffies, last_transmit + HZ/10)) {
498 str = last_str;
499 break;
500 }
501 /* fall through - report timeout */
502 case 0xfc:
503 case 0xfd:
504 case 0xfe: dfl = SERIO_TIMEOUT; data = 0xfe; break;
505 case 0xff: dfl = SERIO_PARITY; data = 0xfe; break;
506 }
507 }
508
509 port_no = I8042_MUX_PORT_NO + ((str >> 6) & 3);
510 last_str = str;
511 last_transmit = jiffies;
512 } else {
513
514 dfl = ((str & I8042_STR_PARITY) ? SERIO_PARITY : 0) |
515 ((str & I8042_STR_TIMEOUT && !i8042_notimeout) ? SERIO_TIMEOUT : 0);
516
517 port_no = (str & I8042_STR_AUXDATA) ?
518 I8042_AUX_PORT_NO : I8042_KBD_PORT_NO;
519 }
520
521 port = &i8042_ports[port_no];
522 serio = port->exists ? port->serio : NULL;
523
524 dbg("%02x <- i8042 (interrupt, %d, %d%s%s)\n",
525 data, port_no, irq,
526 dfl & SERIO_PARITY ? ", bad parity" : "",
527 dfl & SERIO_TIMEOUT ? ", timeout" : "");
528
529 filtered = i8042_filter(data, str, serio);
530
531 spin_unlock_irqrestore(&i8042_lock, flags);
532
533 if (likely(port->exists && !filtered))
534 serio_interrupt(serio, data, dfl);
535
536 out:
537 return IRQ_RETVAL(ret);
538}
539
540/*
541 * i8042_enable_kbd_port enables keyboard port on chip
542 */
543
544static int i8042_enable_kbd_port(void)
545{
546 i8042_ctr &= ~I8042_CTR_KBDDIS;
547 i8042_ctr |= I8042_CTR_KBDINT;
548
549 if (i8042_command(&i8042_ctr, I8042_CMD_CTL_WCTR)) {
550 i8042_ctr &= ~I8042_CTR_KBDINT;
551 i8042_ctr |= I8042_CTR_KBDDIS;
552 pr_err("Failed to enable KBD port\n");
553 return -EIO;
554 }
555
556 return 0;
557}
558
559/*
560 * i8042_enable_aux_port enables AUX (mouse) port on chip
561 */
562
563static int i8042_enable_aux_port(void)
564{
565 i8042_ctr &= ~I8042_CTR_AUXDIS;
566 i8042_ctr |= I8042_CTR_AUXINT;
567
568 if (i8042_command(&i8042_ctr, I8042_CMD_CTL_WCTR)) {
569 i8042_ctr &= ~I8042_CTR_AUXINT;
570 i8042_ctr |= I8042_CTR_AUXDIS;
571 pr_err("Failed to enable AUX port\n");
572 return -EIO;
573 }
574
575 return 0;
576}
577
578/*
579 * i8042_enable_mux_ports enables 4 individual AUX ports after
580 * the controller has been switched into Multiplexed mode
581 */
582
583static int i8042_enable_mux_ports(void)
584{
585 unsigned char param;
586 int i;
587
588 for (i = 0; i < I8042_NUM_MUX_PORTS; i++) {
589 i8042_command(&param, I8042_CMD_MUX_PFX + i);
590 i8042_command(&param, I8042_CMD_AUX_ENABLE);
591 }
592
593 return i8042_enable_aux_port();
594}
595
596/*
597 * i8042_set_mux_mode checks whether the controller has an
598 * active multiplexor and puts the chip into Multiplexed (true)
599 * or Legacy (false) mode.
600 */
601
602static int i8042_set_mux_mode(bool multiplex, unsigned char *mux_version)
603{
604
605 unsigned char param, val;
606/*
607 * Get rid of bytes in the queue.
608 */
609
610 i8042_flush();
611
612/*
613 * Internal loopback test - send three bytes, they should come back from the
614 * mouse interface, the last should be version.
615 */
616
617 param = val = 0xf0;
618 if (i8042_command(&param, I8042_CMD_AUX_LOOP) || param != val)
619 return -1;
620 param = val = multiplex ? 0x56 : 0xf6;
621 if (i8042_command(&param, I8042_CMD_AUX_LOOP) || param != val)
622 return -1;
623 param = val = multiplex ? 0xa4 : 0xa5;
624 if (i8042_command(&param, I8042_CMD_AUX_LOOP) || param == val)
625 return -1;
626
627/*
628 * Workaround for interference with USB Legacy emulation
629 * that causes a v10.12 MUX to be found.
630 */
631 if (param == 0xac)
632 return -1;
633
634 if (mux_version)
635 *mux_version = param;
636
637 return 0;
638}
639
640/*
641 * i8042_check_mux() checks whether the controller supports the PS/2 Active
642 * Multiplexing specification by Synaptics, Phoenix, Insyde and
643 * LCS/Telegraphics.
644 */
645
646static int __init i8042_check_mux(void)
647{
648 unsigned char mux_version;
649
650 if (i8042_set_mux_mode(true, &mux_version))
651 return -1;
652
653 pr_info("Detected active multiplexing controller, rev %d.%d\n",
654 (mux_version >> 4) & 0xf, mux_version & 0xf);
655
656/*
657 * Disable all muxed ports by disabling AUX.
658 */
659 i8042_ctr |= I8042_CTR_AUXDIS;
660 i8042_ctr &= ~I8042_CTR_AUXINT;
661
662 if (i8042_command(&i8042_ctr, I8042_CMD_CTL_WCTR)) {
663 pr_err("Failed to disable AUX port, can't use MUX\n");
664 return -EIO;
665 }
666
667 i8042_mux_present = true;
668
669 return 0;
670}
671
672/*
673 * The following is used to test AUX IRQ delivery.
674 */
675static struct completion i8042_aux_irq_delivered __initdata;
676static bool i8042_irq_being_tested __initdata;
677
678static irqreturn_t __init i8042_aux_test_irq(int irq, void *dev_id)
679{
680 unsigned long flags;
681 unsigned char str, data;
682 int ret = 0;
683
684 spin_lock_irqsave(&i8042_lock, flags);
685 str = i8042_read_status();
686 if (str & I8042_STR_OBF) {
687 data = i8042_read_data();
688 dbg("%02x <- i8042 (aux_test_irq, %s)\n",
689 data, str & I8042_STR_AUXDATA ? "aux" : "kbd");
690 if (i8042_irq_being_tested &&
691 data == 0xa5 && (str & I8042_STR_AUXDATA))
692 complete(&i8042_aux_irq_delivered);
693 ret = 1;
694 }
695 spin_unlock_irqrestore(&i8042_lock, flags);
696
697 return IRQ_RETVAL(ret);
698}
699
700/*
701 * i8042_toggle_aux - enables or disables AUX port on i8042 via command and
702 * verifies success by readinng CTR. Used when testing for presence of AUX
703 * port.
704 */
705static int __init i8042_toggle_aux(bool on)
706{
707 unsigned char param;
708 int i;
709
710 if (i8042_command(&param,
711 on ? I8042_CMD_AUX_ENABLE : I8042_CMD_AUX_DISABLE))
712 return -1;
713
714 /* some chips need some time to set the I8042_CTR_AUXDIS bit */
715 for (i = 0; i < 100; i++) {
716 udelay(50);
717
718 if (i8042_command(&param, I8042_CMD_CTL_RCTR))
719 return -1;
720
721 if (!(param & I8042_CTR_AUXDIS) == on)
722 return 0;
723 }
724
725 return -1;
726}
727
728/*
729 * i8042_check_aux() applies as much paranoia as it can at detecting
730 * the presence of an AUX interface.
731 */
732
733static int __init i8042_check_aux(void)
734{
735 int retval = -1;
736 bool irq_registered = false;
737 bool aux_loop_broken = false;
738 unsigned long flags;
739 unsigned char param;
740
741/*
742 * Get rid of bytes in the queue.
743 */
744
745 i8042_flush();
746
747/*
748 * Internal loopback test - filters out AT-type i8042's. Unfortunately
749 * SiS screwed up and their 5597 doesn't support the LOOP command even
750 * though it has an AUX port.
751 */
752
753 param = 0x5a;
754 retval = i8042_command(&param, I8042_CMD_AUX_LOOP);
755 if (retval || param != 0x5a) {
756
757/*
758 * External connection test - filters out AT-soldered PS/2 i8042's
759 * 0x00 - no error, 0x01-0x03 - clock/data stuck, 0xff - general error
760 * 0xfa - no error on some notebooks which ignore the spec
761 * Because it's common for chipsets to return error on perfectly functioning
762 * AUX ports, we test for this only when the LOOP command failed.
763 */
764
765 if (i8042_command(&param, I8042_CMD_AUX_TEST) ||
766 (param && param != 0xfa && param != 0xff))
767 return -1;
768
769/*
770 * If AUX_LOOP completed without error but returned unexpected data
771 * mark it as broken
772 */
773 if (!retval)
774 aux_loop_broken = true;
775 }
776
777/*
778 * Bit assignment test - filters out PS/2 i8042's in AT mode
779 */
780
781 if (i8042_toggle_aux(false)) {
782 pr_warn("Failed to disable AUX port, but continuing anyway... Is this a SiS?\n");
783 pr_warn("If AUX port is really absent please use the 'i8042.noaux' option\n");
784 }
785
786 if (i8042_toggle_aux(true))
787 return -1;
788
789/*
790 * Reset keyboard (needed on some laptops to successfully detect
791 * touchpad, e.g., some Gigabyte laptop models with Elantech
792 * touchpads).
793 */
794 if (i8042_kbdreset) {
795 pr_warn("Attempting to reset device connected to KBD port\n");
796 i8042_kbd_write(NULL, (unsigned char) 0xff);
797 }
798
799/*
800 * Test AUX IRQ delivery to make sure BIOS did not grab the IRQ and
801 * used it for a PCI card or somethig else.
802 */
803
804 if (i8042_noloop || i8042_bypass_aux_irq_test || aux_loop_broken) {
805/*
806 * Without LOOP command we can't test AUX IRQ delivery. Assume the port
807 * is working and hope we are right.
808 */
809 retval = 0;
810 goto out;
811 }
812
813 if (request_irq(I8042_AUX_IRQ, i8042_aux_test_irq, IRQF_SHARED,
814 "i8042", i8042_platform_device))
815 goto out;
816
817 irq_registered = true;
818
819 if (i8042_enable_aux_port())
820 goto out;
821
822 spin_lock_irqsave(&i8042_lock, flags);
823
824 init_completion(&i8042_aux_irq_delivered);
825 i8042_irq_being_tested = true;
826
827 param = 0xa5;
828 retval = __i8042_command(&param, I8042_CMD_AUX_LOOP & 0xf0ff);
829
830 spin_unlock_irqrestore(&i8042_lock, flags);
831
832 if (retval)
833 goto out;
834
835 if (wait_for_completion_timeout(&i8042_aux_irq_delivered,
836 msecs_to_jiffies(250)) == 0) {
837/*
838 * AUX IRQ was never delivered so we need to flush the controller to
839 * get rid of the byte we put there; otherwise keyboard may not work.
840 */
841 dbg(" -- i8042 (aux irq test timeout)\n");
842 i8042_flush();
843 retval = -1;
844 }
845
846 out:
847
848/*
849 * Disable the interface.
850 */
851
852 i8042_ctr |= I8042_CTR_AUXDIS;
853 i8042_ctr &= ~I8042_CTR_AUXINT;
854
855 if (i8042_command(&i8042_ctr, I8042_CMD_CTL_WCTR))
856 retval = -1;
857
858 if (irq_registered)
859 free_irq(I8042_AUX_IRQ, i8042_platform_device);
860
861 return retval;
862}
863
864static int i8042_controller_check(void)
865{
866 if (i8042_flush() == I8042_BUFFER_SIZE) {
867 pr_err("No controller found\n");
868 return -ENODEV;
869 }
870
871 return 0;
872}
873
874static int i8042_controller_selftest(void)
875{
876 unsigned char param;
877 int i = 0;
878
879 /*
880 * We try this 5 times; on some really fragile systems this does not
881 * take the first time...
882 */
883 do {
884
885 if (i8042_command(&param, I8042_CMD_CTL_TEST)) {
886 pr_err("i8042 controller selftest timeout\n");
887 return -ENODEV;
888 }
889
890 if (param == I8042_RET_CTL_TEST)
891 return 0;
892
893 dbg("i8042 controller selftest: %#x != %#x\n",
894 param, I8042_RET_CTL_TEST);
895 msleep(50);
896 } while (i++ < 5);
897
898#ifdef CONFIG_X86
899 /*
900 * On x86, we don't fail entire i8042 initialization if controller
901 * reset fails in hopes that keyboard port will still be functional
902 * and user will still get a working keyboard. This is especially
903 * important on netbooks. On other arches we trust hardware more.
904 */
905 pr_info("giving up on controller selftest, continuing anyway...\n");
906 return 0;
907#else
908 pr_err("i8042 controller selftest failed\n");
909 return -EIO;
910#endif
911}
912
913/*
914 * i8042_controller init initializes the i8042 controller, and,
915 * most importantly, sets it into non-xlated mode if that's
916 * desired.
917 */
918
919static int i8042_controller_init(void)
920{
921 unsigned long flags;
922 int n = 0;
923 unsigned char ctr[2];
924
925/*
926 * Save the CTR for restore on unload / reboot.
927 */
928
929 do {
930 if (n >= 10) {
931 pr_err("Unable to get stable CTR read\n");
932 return -EIO;
933 }
934
935 if (n != 0)
936 udelay(50);
937
938 if (i8042_command(&ctr[n++ % 2], I8042_CMD_CTL_RCTR)) {
939 pr_err("Can't read CTR while initializing i8042\n");
940 return -EIO;
941 }
942
943 } while (n < 2 || ctr[0] != ctr[1]);
944
945 i8042_initial_ctr = i8042_ctr = ctr[0];
946
947/*
948 * Disable the keyboard interface and interrupt.
949 */
950
951 i8042_ctr |= I8042_CTR_KBDDIS;
952 i8042_ctr &= ~I8042_CTR_KBDINT;
953
954/*
955 * Handle keylock.
956 */
957
958 spin_lock_irqsave(&i8042_lock, flags);
959 if (~i8042_read_status() & I8042_STR_KEYLOCK) {
960 if (i8042_unlock)
961 i8042_ctr |= I8042_CTR_IGNKEYLOCK;
962 else
963 pr_warn("Warning: Keylock active\n");
964 }
965 spin_unlock_irqrestore(&i8042_lock, flags);
966
967/*
968 * If the chip is configured into nontranslated mode by the BIOS, don't
969 * bother enabling translating and be happy.
970 */
971
972 if (~i8042_ctr & I8042_CTR_XLATE)
973 i8042_direct = true;
974
975/*
976 * Set nontranslated mode for the kbd interface if requested by an option.
977 * After this the kbd interface becomes a simple serial in/out, like the aux
978 * interface is. We don't do this by default, since it can confuse notebook
979 * BIOSes.
980 */
981
982 if (i8042_direct)
983 i8042_ctr &= ~I8042_CTR_XLATE;
984
985/*
986 * Write CTR back.
987 */
988
989 if (i8042_command(&i8042_ctr, I8042_CMD_CTL_WCTR)) {
990 pr_err("Can't write CTR while initializing i8042\n");
991 return -EIO;
992 }
993
994/*
995 * Flush whatever accumulated while we were disabling keyboard port.
996 */
997
998 i8042_flush();
999
1000 return 0;
1001}
1002
1003
1004/*
1005 * Reset the controller and reset CRT to the original value set by BIOS.
1006 */
1007
1008static void i8042_controller_reset(bool force_reset)
1009{
1010 i8042_flush();
1011
1012/*
1013 * Disable both KBD and AUX interfaces so they don't get in the way
1014 */
1015
1016 i8042_ctr |= I8042_CTR_KBDDIS | I8042_CTR_AUXDIS;
1017 i8042_ctr &= ~(I8042_CTR_KBDINT | I8042_CTR_AUXINT);
1018
1019 if (i8042_command(&i8042_ctr, I8042_CMD_CTL_WCTR))
1020 pr_warn("Can't write CTR while resetting\n");
1021
1022/*
1023 * Disable MUX mode if present.
1024 */
1025
1026 if (i8042_mux_present)
1027 i8042_set_mux_mode(false, NULL);
1028
1029/*
1030 * Reset the controller if requested.
1031 */
1032
1033 if (i8042_reset || force_reset)
1034 i8042_controller_selftest();
1035
1036/*
1037 * Restore the original control register setting.
1038 */
1039
1040 if (i8042_command(&i8042_initial_ctr, I8042_CMD_CTL_WCTR))
1041 pr_warn("Can't restore CTR\n");
1042}
1043
1044
1045/*
1046 * i8042_panic_blink() will turn the keyboard LEDs on or off and is called
1047 * when kernel panics. Flashing LEDs is useful for users running X who may
1048 * not see the console and will help distingushing panics from "real"
1049 * lockups.
1050 *
1051 * Note that DELAY has a limit of 10ms so we will not get stuck here
1052 * waiting for KBC to free up even if KBD interrupt is off
1053 */
1054
1055#define DELAY do { mdelay(1); if (++delay > 10) return delay; } while(0)
1056
1057static long i8042_panic_blink(int state)
1058{
1059 long delay = 0;
1060 char led;
1061
1062 led = (state) ? 0x01 | 0x04 : 0;
1063 while (i8042_read_status() & I8042_STR_IBF)
1064 DELAY;
1065 dbg("%02x -> i8042 (panic blink)\n", 0xed);
1066 i8042_suppress_kbd_ack = 2;
1067 i8042_write_data(0xed); /* set leds */
1068 DELAY;
1069 while (i8042_read_status() & I8042_STR_IBF)
1070 DELAY;
1071 DELAY;
1072 dbg("%02x -> i8042 (panic blink)\n", led);
1073 i8042_write_data(led);
1074 DELAY;
1075 return delay;
1076}
1077
1078#undef DELAY
1079
1080#ifdef CONFIG_X86
1081static void i8042_dritek_enable(void)
1082{
1083 unsigned char param = 0x90;
1084 int error;
1085
1086 error = i8042_command(&param, 0x1059);
1087 if (error)
1088 pr_warn("Failed to enable DRITEK extension: %d\n", error);
1089}
1090#endif
1091
1092#ifdef CONFIG_PM
1093
1094/*
1095 * Here we try to reset everything back to a state we had
1096 * before suspending.
1097 */
1098
1099static int i8042_controller_resume(bool force_reset)
1100{
1101 int error;
1102
1103 error = i8042_controller_check();
1104 if (error)
1105 return error;
1106
1107 if (i8042_reset || force_reset) {
1108 error = i8042_controller_selftest();
1109 if (error)
1110 return error;
1111 }
1112
1113/*
1114 * Restore original CTR value and disable all ports
1115 */
1116
1117 i8042_ctr = i8042_initial_ctr;
1118 if (i8042_direct)
1119 i8042_ctr &= ~I8042_CTR_XLATE;
1120 i8042_ctr |= I8042_CTR_AUXDIS | I8042_CTR_KBDDIS;
1121 i8042_ctr &= ~(I8042_CTR_AUXINT | I8042_CTR_KBDINT);
1122 if (i8042_command(&i8042_ctr, I8042_CMD_CTL_WCTR)) {
1123 pr_warn("Can't write CTR to resume, retrying...\n");
1124 msleep(50);
1125 if (i8042_command(&i8042_ctr, I8042_CMD_CTL_WCTR)) {
1126 pr_err("CTR write retry failed\n");
1127 return -EIO;
1128 }
1129 }
1130
1131
1132#ifdef CONFIG_X86
1133 if (i8042_dritek)
1134 i8042_dritek_enable();
1135#endif
1136
1137 if (i8042_mux_present) {
1138 if (i8042_set_mux_mode(true, NULL) || i8042_enable_mux_ports())
1139 pr_warn("failed to resume active multiplexor, mouse won't work\n");
1140 } else if (i8042_ports[I8042_AUX_PORT_NO].serio)
1141 i8042_enable_aux_port();
1142
1143 if (i8042_ports[I8042_KBD_PORT_NO].serio)
1144 i8042_enable_kbd_port();
1145
1146 i8042_interrupt(0, NULL);
1147
1148 return 0;
1149}
1150
1151/*
1152 * Here we try to restore the original BIOS settings to avoid
1153 * upsetting it.
1154 */
1155
1156static int i8042_pm_suspend(struct device *dev)
1157{
1158 i8042_controller_reset(true);
1159
1160 return 0;
1161}
1162
1163static int i8042_pm_resume(struct device *dev)
1164{
1165 /*
1166 * On resume from S2R we always try to reset the controller
1167 * to bring it in a sane state. (In case of S2D we expect
1168 * BIOS to reset the controller for us.)
1169 */
1170 return i8042_controller_resume(true);
1171}
1172
1173static int i8042_pm_thaw(struct device *dev)
1174{
1175 i8042_interrupt(0, NULL);
1176
1177 return 0;
1178}
1179
1180static int i8042_pm_reset(struct device *dev)
1181{
1182 i8042_controller_reset(false);
1183
1184 return 0;
1185}
1186
1187static int i8042_pm_restore(struct device *dev)
1188{
1189 return i8042_controller_resume(false);
1190}
1191
1192static const struct dev_pm_ops i8042_pm_ops = {
1193 .suspend = i8042_pm_suspend,
1194 .resume = i8042_pm_resume,
1195 .thaw = i8042_pm_thaw,
1196 .poweroff = i8042_pm_reset,
1197 .restore = i8042_pm_restore,
1198};
1199
1200#endif /* CONFIG_PM */
1201
1202/*
1203 * We need to reset the 8042 back to original mode on system shutdown,
1204 * because otherwise BIOSes will be confused.
1205 */
1206
1207static void i8042_shutdown(struct platform_device *dev)
1208{
1209 i8042_controller_reset(false);
1210}
1211
1212static int __init i8042_create_kbd_port(void)
1213{
1214 struct serio *serio;
1215 struct i8042_port *port = &i8042_ports[I8042_KBD_PORT_NO];
1216
1217 serio = kzalloc(sizeof(struct serio), GFP_KERNEL);
1218 if (!serio)
1219 return -ENOMEM;
1220
1221 serio->id.type = i8042_direct ? SERIO_8042 : SERIO_8042_XL;
1222 serio->write = i8042_dumbkbd ? NULL : i8042_kbd_write;
1223 serio->start = i8042_start;
1224 serio->stop = i8042_stop;
1225 serio->close = i8042_port_close;
1226 serio->port_data = port;
1227 serio->dev.parent = &i8042_platform_device->dev;
1228 strlcpy(serio->name, "i8042 KBD port", sizeof(serio->name));
1229 strlcpy(serio->phys, I8042_KBD_PHYS_DESC, sizeof(serio->phys));
1230
1231 port->serio = serio;
1232 port->irq = I8042_KBD_IRQ;
1233
1234 return 0;
1235}
1236
1237static int __init i8042_create_aux_port(int idx)
1238{
1239 struct serio *serio;
1240 int port_no = idx < 0 ? I8042_AUX_PORT_NO : I8042_MUX_PORT_NO + idx;
1241 struct i8042_port *port = &i8042_ports[port_no];
1242
1243 serio = kzalloc(sizeof(struct serio), GFP_KERNEL);
1244 if (!serio)
1245 return -ENOMEM;
1246
1247 serio->id.type = SERIO_8042;
1248 serio->write = i8042_aux_write;
1249 serio->start = i8042_start;
1250 serio->stop = i8042_stop;
1251 serio->port_data = port;
1252 serio->dev.parent = &i8042_platform_device->dev;
1253 if (idx < 0) {
1254 strlcpy(serio->name, "i8042 AUX port", sizeof(serio->name));
1255 strlcpy(serio->phys, I8042_AUX_PHYS_DESC, sizeof(serio->phys));
1256 serio->close = i8042_port_close;
1257 } else {
1258 snprintf(serio->name, sizeof(serio->name), "i8042 AUX%d port", idx);
1259 snprintf(serio->phys, sizeof(serio->phys), I8042_MUX_PHYS_DESC, idx + 1);
1260 }
1261
1262 port->serio = serio;
1263 port->mux = idx;
1264 port->irq = I8042_AUX_IRQ;
1265
1266 return 0;
1267}
1268
1269static void __init i8042_free_kbd_port(void)
1270{
1271 kfree(i8042_ports[I8042_KBD_PORT_NO].serio);
1272 i8042_ports[I8042_KBD_PORT_NO].serio = NULL;
1273}
1274
1275static void __init i8042_free_aux_ports(void)
1276{
1277 int i;
1278
1279 for (i = I8042_AUX_PORT_NO; i < I8042_NUM_PORTS; i++) {
1280 kfree(i8042_ports[i].serio);
1281 i8042_ports[i].serio = NULL;
1282 }
1283}
1284
1285static void __init i8042_register_ports(void)
1286{
1287 int i;
1288
1289 for (i = 0; i < I8042_NUM_PORTS; i++) {
1290 if (i8042_ports[i].serio) {
1291 printk(KERN_INFO "serio: %s at %#lx,%#lx irq %d\n",
1292 i8042_ports[i].serio->name,
1293 (unsigned long) I8042_DATA_REG,
1294 (unsigned long) I8042_COMMAND_REG,
1295 i8042_ports[i].irq);
1296 serio_register_port(i8042_ports[i].serio);
1297 }
1298 }
1299}
1300
1301static void __devexit i8042_unregister_ports(void)
1302{
1303 int i;
1304
1305 for (i = 0; i < I8042_NUM_PORTS; i++) {
1306 if (i8042_ports[i].serio) {
1307 serio_unregister_port(i8042_ports[i].serio);
1308 i8042_ports[i].serio = NULL;
1309 }
1310 }
1311}
1312
1313/*
1314 * Checks whether port belongs to i8042 controller.
1315 */
1316bool i8042_check_port_owner(const struct serio *port)
1317{
1318 int i;
1319
1320 for (i = 0; i < I8042_NUM_PORTS; i++)
1321 if (i8042_ports[i].serio == port)
1322 return true;
1323
1324 return false;
1325}
1326EXPORT_SYMBOL(i8042_check_port_owner);
1327
1328static void i8042_free_irqs(void)
1329{
1330 if (i8042_aux_irq_registered)
1331 free_irq(I8042_AUX_IRQ, i8042_platform_device);
1332 if (i8042_kbd_irq_registered)
1333 free_irq(I8042_KBD_IRQ, i8042_platform_device);
1334
1335 i8042_aux_irq_registered = i8042_kbd_irq_registered = false;
1336}
1337
1338static int __init i8042_setup_aux(void)
1339{
1340 int (*aux_enable)(void);
1341 int error;
1342 int i;
1343
1344 if (i8042_check_aux())
1345 return -ENODEV;
1346
1347 if (i8042_nomux || i8042_check_mux()) {
1348 error = i8042_create_aux_port(-1);
1349 if (error)
1350 goto err_free_ports;
1351 aux_enable = i8042_enable_aux_port;
1352 } else {
1353 for (i = 0; i < I8042_NUM_MUX_PORTS; i++) {
1354 error = i8042_create_aux_port(i);
1355 if (error)
1356 goto err_free_ports;
1357 }
1358 aux_enable = i8042_enable_mux_ports;
1359 }
1360
1361 error = request_irq(I8042_AUX_IRQ, i8042_interrupt, IRQF_SHARED,
1362 "i8042", i8042_platform_device);
1363 if (error)
1364 goto err_free_ports;
1365
1366 if (aux_enable())
1367 goto err_free_irq;
1368
1369 i8042_aux_irq_registered = true;
1370 return 0;
1371
1372 err_free_irq:
1373 free_irq(I8042_AUX_IRQ, i8042_platform_device);
1374 err_free_ports:
1375 i8042_free_aux_ports();
1376 return error;
1377}
1378
1379static int __init i8042_setup_kbd(void)
1380{
1381 int error;
1382
1383 error = i8042_create_kbd_port();
1384 if (error)
1385 return error;
1386
1387 error = request_irq(I8042_KBD_IRQ, i8042_interrupt, IRQF_SHARED,
1388 "i8042", i8042_platform_device);
1389 if (error)
1390 goto err_free_port;
1391
1392 error = i8042_enable_kbd_port();
1393 if (error)
1394 goto err_free_irq;
1395
1396 i8042_kbd_irq_registered = true;
1397 return 0;
1398
1399 err_free_irq:
1400 free_irq(I8042_KBD_IRQ, i8042_platform_device);
1401 err_free_port:
1402 i8042_free_kbd_port();
1403 return error;
1404}
1405
1406static int __init i8042_probe(struct platform_device *dev)
1407{
1408 int error;
1409
1410 i8042_platform_device = dev;
1411
1412 if (i8042_reset) {
1413 error = i8042_controller_selftest();
1414 if (error)
1415 return error;
1416 }
1417
1418 error = i8042_controller_init();
1419 if (error)
1420 return error;
1421
1422#ifdef CONFIG_X86
1423 if (i8042_dritek)
1424 i8042_dritek_enable();
1425#endif
1426
1427 if (!i8042_noaux) {
1428 error = i8042_setup_aux();
1429 if (error && error != -ENODEV && error != -EBUSY)
1430 goto out_fail;
1431 }
1432
1433 if (!i8042_nokbd) {
1434 error = i8042_setup_kbd();
1435 if (error)
1436 goto out_fail;
1437 }
1438/*
1439 * Ok, everything is ready, let's register all serio ports
1440 */
1441 i8042_register_ports();
1442
1443 return 0;
1444
1445 out_fail:
1446 i8042_free_aux_ports(); /* in case KBD failed but AUX not */
1447 i8042_free_irqs();
1448 i8042_controller_reset(false);
1449 i8042_platform_device = NULL;
1450
1451 return error;
1452}
1453
1454static int __devexit i8042_remove(struct platform_device *dev)
1455{
1456 i8042_unregister_ports();
1457 i8042_free_irqs();
1458 i8042_controller_reset(false);
1459 i8042_platform_device = NULL;
1460
1461 return 0;
1462}
1463
1464static struct platform_driver i8042_driver = {
1465 .driver = {
1466 .name = "i8042",
1467 .owner = THIS_MODULE,
1468#ifdef CONFIG_PM
1469 .pm = &i8042_pm_ops,
1470#endif
1471 },
1472 .remove = __devexit_p(i8042_remove),
1473 .shutdown = i8042_shutdown,
1474};
1475
1476static int __init i8042_init(void)
1477{
1478 struct platform_device *pdev;
1479 int err;
1480
1481 dbg_init();
1482
1483 err = i8042_platform_init();
1484 if (err)
1485 return err;
1486
1487 err = i8042_controller_check();
1488 if (err)
1489 goto err_platform_exit;
1490
1491 pdev = platform_create_bundle(&i8042_driver, i8042_probe, NULL, 0, NULL, 0);
1492 if (IS_ERR(pdev)) {
1493 err = PTR_ERR(pdev);
1494 goto err_platform_exit;
1495 }
1496
1497 panic_blink = i8042_panic_blink;
1498
1499 return 0;
1500
1501 err_platform_exit:
1502 i8042_platform_exit();
1503 return err;
1504}
1505
1506static void __exit i8042_exit(void)
1507{
1508 platform_device_unregister(i8042_platform_device);
1509 platform_driver_unregister(&i8042_driver);
1510 i8042_platform_exit();
1511
1512 panic_blink = NULL;
1513}
1514
1515module_init(i8042_init);
1516module_exit(i8042_exit);