source: mainline/genarch/src/i8042/i8042.c@ 30ab05f

lfn serial ticket/834-toolchain-update topic/msim-upgrade topic/simplify-dev-export
Last change on this file since 30ab05f was 30ab05f, checked in by Jakub Jermar <jakub@…>, 19 years ago

sparc64 work.
Very raw and fragile preliminary standalone keyboard support - polling mode only.
Because of a workaround in Simics, the scan codes are the same as on ia32.

  • Property mode set to 100644
File size: 13.1 KB
Line 
1/*
2 * Copyright (C) 2001-2004 Jakub Jermar
3 * All rights reserved.
4 *
5 * Redistribution and use in source and binary forms, with or without
6 * modification, are permitted provided that the following conditions
7 * are met:
8 *
9 * - Redistributions of source code must retain the above copyright
10 * notice, this list of conditions and the following disclaimer.
11 * - Redistributions in binary form must reproduce the above copyright
12 * notice, this list of conditions and the following disclaimer in the
13 * documentation and/or other materials provided with the distribution.
14 * - The name of the author may not be used to endorse or promote products
15 * derived from this software without specific prior written permission.
16 *
17 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
18 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
19 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
20 * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
21 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
22 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
23 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
24 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
25 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
26 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
27 */
28
29#include <genarch/i8042/i8042.h>
30#include <arch/drivers/i8042.h>
31#include <arch/interrupt.h>
32#include <cpu.h>
33#include <arch/asm.h>
34#include <arch.h>
35#include <print.h>
36#include <synch/spinlock.h>
37#include <typedefs.h>
38#include <console/chardev.h>
39#include <console/console.h>
40#include <macros.h>
41#include <interrupt.h>
42
43/**
44 * i8042 processor driver.
45 * It takes care of low-level keyboard functions.
46 */
47
48/** Keyboard commands. */
49#define KBD_ENABLE 0xf4
50#define KBD_DISABLE 0xf5
51#define KBD_ACK 0xfa
52
53/*
54 * 60 Write 8042 Command Byte: next data byte written to port 60h is
55 * placed in 8042 command register. Format:
56 *
57 * |7|6|5|4|3|2|1|0|8042 Command Byte
58 * | | | | | | | `---- 1=enable output register full interrupt
59 * | | | | | | `----- should be 0
60 * | | | | | `------ 1=set status register system, 0=clear
61 * | | | | `------- 1=override keyboard inhibit, 0=allow inhibit
62 * | | | `-------- disable keyboard I/O by driving clock line low
63 * | | `--------- disable auxiliary device, drives clock line low
64 * | `---------- IBM scancode translation 0=AT, 1=PC/XT
65 * `----------- reserved, should be 0
66 */
67
68#define i8042_SET_COMMAND 0x60
69#define i8042_COMMAND 0x49
70
71#define i8042_BUFFER_FULL_MASK 0x01
72#define i8042_WAIT_MASK 0x02
73
74#define SPECIAL '?'
75#define KEY_RELEASE 0x80
76
77/**
78 * These codes read from i8042 data register are silently ignored.
79 */
80#define IGNORE_CODE 0x7f
81
82static void key_released(__u8 sc);
83static void key_pressed(__u8 sc);
84static char key_read(chardev_t *d);
85
86#define PRESSED_SHIFT (1<<0)
87#define PRESSED_CAPSLOCK (1<<1)
88#define LOCKED_CAPSLOCK (1<<0)
89
90#define ACTIVE_READ_BUFF_SIZE 16 /* Must be power of 2 */
91
92static __u8 active_read_buff[ACTIVE_READ_BUFF_SIZE];
93
94SPINLOCK_INITIALIZE(keylock); /**< keylock protects keyflags and lockflags. */
95static volatile int keyflags; /**< Tracking of multiple keypresses. */
96static volatile int lockflags; /**< Tracking of multiple keys lockings. */
97
98static void i8042_suspend(chardev_t *);
99static void i8042_resume(chardev_t *);
100
101static chardev_t kbrd;
102static chardev_operations_t ops = {
103 .suspend = i8042_suspend,
104 .resume = i8042_resume,
105 .read = key_read
106};
107
108/** Primary meaning of scancodes. */
109static char sc_primary_map[] = {
110 SPECIAL, /* 0x00 */
111 SPECIAL, /* 0x01 - Esc */
112 '1', '2', '3', '4', '5', '6', '7', '8', '9', '0', '-', '=',
113 '\b', /* 0x0e - Backspace */
114 '\t', 'q', 'w', 'e', 'r', 't', 'y', 'u', 'i', 'o', 'p', '[', ']', '\n',
115 SPECIAL, /* 0x1d - LCtrl */
116 'a', 's', 'd', 'f', 'g', 'h', 'j', 'k', 'l', ';', '\'',
117 '`',
118 SPECIAL, /* 0x2a - LShift */
119 '\\',
120 'z', 'x', 'c', 'v', 'b', 'n', 'm', ',', '.', '/',
121 SPECIAL, /* 0x36 - RShift */
122 '*',
123 SPECIAL, /* 0x38 - LAlt */
124 ' ',
125 SPECIAL, /* 0x3a - CapsLock */
126 SPECIAL, /* 0x3b - F1 */
127 SPECIAL, /* 0x3c - F2 */
128 SPECIAL, /* 0x3d - F3 */
129 SPECIAL, /* 0x3e - F4 */
130 SPECIAL, /* 0x3f - F5 */
131 SPECIAL, /* 0x40 - F6 */
132 SPECIAL, /* 0x41 - F7 */
133 SPECIAL, /* 0x42 - F8 */
134 SPECIAL, /* 0x43 - F9 */
135 SPECIAL, /* 0x44 - F10 */
136 SPECIAL, /* 0x45 - NumLock */
137 SPECIAL, /* 0x46 - ScrollLock */
138 '7', '8', '9', '-',
139 '4', '5', '6', '+',
140 '1', '2', '3',
141 '0', '.',
142 SPECIAL, /* 0x54 - Alt-SysRq */
143 SPECIAL, /* 0x55 - F11/F12/PF1/FN */
144 SPECIAL, /* 0x56 - unlabelled key next to LAlt */
145 SPECIAL, /* 0x57 - F11 */
146 SPECIAL, /* 0x58 - F12 */
147 SPECIAL, /* 0x59 */
148 SPECIAL, /* 0x5a */
149 SPECIAL, /* 0x5b */
150 SPECIAL, /* 0x5c */
151 SPECIAL, /* 0x5d */
152 SPECIAL, /* 0x5e */
153 SPECIAL, /* 0x5f */
154 SPECIAL, /* 0x60 */
155 SPECIAL, /* 0x61 */
156 SPECIAL, /* 0x62 */
157 SPECIAL, /* 0x63 */
158 SPECIAL, /* 0x64 */
159 SPECIAL, /* 0x65 */
160 SPECIAL, /* 0x66 */
161 SPECIAL, /* 0x67 */
162 SPECIAL, /* 0x68 */
163 SPECIAL, /* 0x69 */
164 SPECIAL, /* 0x6a */
165 SPECIAL, /* 0x6b */
166 SPECIAL, /* 0x6c */
167 SPECIAL, /* 0x6d */
168 SPECIAL, /* 0x6e */
169 SPECIAL, /* 0x6f */
170 SPECIAL, /* 0x70 */
171 SPECIAL, /* 0x71 */
172 SPECIAL, /* 0x72 */
173 SPECIAL, /* 0x73 */
174 SPECIAL, /* 0x74 */
175 SPECIAL, /* 0x75 */
176 SPECIAL, /* 0x76 */
177 SPECIAL, /* 0x77 */
178 SPECIAL, /* 0x78 */
179 SPECIAL, /* 0x79 */
180 SPECIAL, /* 0x7a */
181 SPECIAL, /* 0x7b */
182 SPECIAL, /* 0x7c */
183 SPECIAL, /* 0x7d */
184 SPECIAL, /* 0x7e */
185 SPECIAL, /* 0x7f */
186};
187
188/** Secondary meaning of scancodes. */
189static char sc_secondary_map[] = {
190 SPECIAL, /* 0x00 */
191 SPECIAL, /* 0x01 - Esc */
192 '!', '@', '#', '$', '%', '^', '&', '*', '(', ')', '_', '+',
193 SPECIAL, /* 0x0e - Backspace */
194 '\t', 'Q', 'W', 'E', 'R', 'T', 'Y', 'U', 'I', 'O', 'P', '{', '}', '\n',
195 SPECIAL, /* 0x1d - LCtrl */
196 'A', 'S', 'D', 'F', 'G', 'H', 'J', 'K', 'L', ':', '"',
197 '~',
198 SPECIAL, /* 0x2a - LShift */
199 '|',
200 'Z', 'X', 'C', 'V', 'B', 'N', 'M', '<', '>', '?',
201 SPECIAL, /* 0x36 - RShift */
202 '*',
203 SPECIAL, /* 0x38 - LAlt */
204 ' ',
205 SPECIAL, /* 0x3a - CapsLock */
206 SPECIAL, /* 0x3b - F1 */
207 SPECIAL, /* 0x3c - F2 */
208 SPECIAL, /* 0x3d - F3 */
209 SPECIAL, /* 0x3e - F4 */
210 SPECIAL, /* 0x3f - F5 */
211 SPECIAL, /* 0x40 - F6 */
212 SPECIAL, /* 0x41 - F7 */
213 SPECIAL, /* 0x42 - F8 */
214 SPECIAL, /* 0x43 - F9 */
215 SPECIAL, /* 0x44 - F10 */
216 SPECIAL, /* 0x45 - NumLock */
217 SPECIAL, /* 0x46 - ScrollLock */
218 '7', '8', '9', '-',
219 '4', '5', '6', '+',
220 '1', '2', '3',
221 '0', '.',
222 SPECIAL, /* 0x54 - Alt-SysRq */
223 SPECIAL, /* 0x55 - F11/F12/PF1/FN */
224 SPECIAL, /* 0x56 - unlabelled key next to LAlt */
225 SPECIAL, /* 0x57 - F11 */
226 SPECIAL, /* 0x58 - F12 */
227 SPECIAL, /* 0x59 */
228 SPECIAL, /* 0x5a */
229 SPECIAL, /* 0x5b */
230 SPECIAL, /* 0x5c */
231 SPECIAL, /* 0x5d */
232 SPECIAL, /* 0x5e */
233 SPECIAL, /* 0x5f */
234 SPECIAL, /* 0x60 */
235 SPECIAL, /* 0x61 */
236 SPECIAL, /* 0x62 */
237 SPECIAL, /* 0x63 */
238 SPECIAL, /* 0x64 */
239 SPECIAL, /* 0x65 */
240 SPECIAL, /* 0x66 */
241 SPECIAL, /* 0x67 */
242 SPECIAL, /* 0x68 */
243 SPECIAL, /* 0x69 */
244 SPECIAL, /* 0x6a */
245 SPECIAL, /* 0x6b */
246 SPECIAL, /* 0x6c */
247 SPECIAL, /* 0x6d */
248 SPECIAL, /* 0x6e */
249 SPECIAL, /* 0x6f */
250 SPECIAL, /* 0x70 */
251 SPECIAL, /* 0x71 */
252 SPECIAL, /* 0x72 */
253 SPECIAL, /* 0x73 */
254 SPECIAL, /* 0x74 */
255 SPECIAL, /* 0x75 */
256 SPECIAL, /* 0x76 */
257 SPECIAL, /* 0x77 */
258 SPECIAL, /* 0x78 */
259 SPECIAL, /* 0x79 */
260 SPECIAL, /* 0x7a */
261 SPECIAL, /* 0x7b */
262 SPECIAL, /* 0x7c */
263 SPECIAL, /* 0x7d */
264 SPECIAL, /* 0x7e */
265 SPECIAL, /* 0x7f */
266};
267
268static void i8042_interrupt(int n, void *stack);
269static void i8042_wait(void);
270
271/** Initialize i8042. */
272void i8042_init(void)
273{
274 exc_register(VECTOR_KBD, "i8042_interrupt", i8042_interrupt);
275 i8042_wait();
276 i8042_command_write(i8042_SET_COMMAND);
277 i8042_wait();
278 i8042_data_write(i8042_COMMAND);
279 i8042_wait();
280
281 trap_virtual_enable_irqs(1<<IRQ_KBD);
282 chardev_initialize("i8042_kbd", &kbrd, &ops);
283 stdin = &kbrd;
284}
285
286/** Process i8042 interrupt.
287 *
288 * @param n Interrupt vector.
289 * @param stack Interrupted stack.
290 */
291void i8042_interrupt(int n, void *stack)
292{
293 __u8 x;
294
295 trap_virtual_eoi();
296 x = i8042_data_read();
297 if (x & KEY_RELEASE)
298 key_released(x ^ KEY_RELEASE);
299 else
300 key_pressed(x);
301}
302
303/** Wait until the controller reads its data. */
304void i8042_wait(void) {
305 while (i8042_status_read() & i8042_WAIT_MASK) {
306 /* wait */
307 }
308}
309
310/** Process release of key.
311 *
312 * @param sc Scancode of the key being released.
313 */
314void key_released(__u8 sc)
315{
316 spinlock_lock(&keylock);
317 switch (sc) {
318 case SC_LSHIFT:
319 case SC_RSHIFT:
320 keyflags &= ~PRESSED_SHIFT;
321 break;
322 case SC_CAPSLOCK:
323 keyflags &= ~PRESSED_CAPSLOCK;
324 if (lockflags & LOCKED_CAPSLOCK)
325 lockflags &= ~LOCKED_CAPSLOCK;
326 else
327 lockflags |= LOCKED_CAPSLOCK;
328 break;
329 default:
330 break;
331 }
332 spinlock_unlock(&keylock);
333}
334
335/** Process keypress.
336 *
337 * @param sc Scancode of the key being pressed.
338 */
339void key_pressed(__u8 sc)
340{
341 char *map = sc_primary_map;
342 char ascii = sc_primary_map[sc];
343 bool shift, capslock;
344 bool letter = false;
345
346 spinlock_lock(&keylock);
347 switch (sc) {
348 case SC_LSHIFT:
349 case SC_RSHIFT:
350 keyflags |= PRESSED_SHIFT;
351 break;
352 case SC_CAPSLOCK:
353 keyflags |= PRESSED_CAPSLOCK;
354 break;
355 case SC_SPEC_ESCAPE:
356 break;
357 case SC_LEFTARR:
358 chardev_push_character(&kbrd, 0x1b);
359 chardev_push_character(&kbrd, 0x5b);
360 chardev_push_character(&kbrd, 0x44);
361 break;
362 case SC_RIGHTARR:
363 chardev_push_character(&kbrd, 0x1b);
364 chardev_push_character(&kbrd, 0x5b);
365 chardev_push_character(&kbrd, 0x43);
366 break;
367 case SC_UPARR:
368 chardev_push_character(&kbrd, 0x1b);
369 chardev_push_character(&kbrd, 0x5b);
370 chardev_push_character(&kbrd, 0x41);
371 break;
372 case SC_DOWNARR:
373 chardev_push_character(&kbrd, 0x1b);
374 chardev_push_character(&kbrd, 0x5b);
375 chardev_push_character(&kbrd, 0x42);
376 break;
377 case SC_HOME:
378 chardev_push_character(&kbrd, 0x1b);
379 chardev_push_character(&kbrd, 0x4f);
380 chardev_push_character(&kbrd, 0x48);
381 break;
382 case SC_END:
383 chardev_push_character(&kbrd, 0x1b);
384 chardev_push_character(&kbrd, 0x4f);
385 chardev_push_character(&kbrd, 0x46);
386 break;
387 case SC_DELETE:
388 chardev_push_character(&kbrd, 0x1b);
389 chardev_push_character(&kbrd, 0x5b);
390 chardev_push_character(&kbrd, 0x33);
391 chardev_push_character(&kbrd, 0x7e);
392 break;
393 default:
394 letter = is_lower(ascii);
395 capslock = (keyflags & PRESSED_CAPSLOCK) || (lockflags & LOCKED_CAPSLOCK);
396 shift = keyflags & PRESSED_SHIFT;
397 if (letter && capslock)
398 shift = !shift;
399 if (shift)
400 map = sc_secondary_map;
401 chardev_push_character(&kbrd, map[sc]);
402 break;
403 }
404 spinlock_unlock(&keylock);
405}
406
407/* Called from getc(). */
408void i8042_resume(chardev_t *d)
409{
410}
411
412/* Called from getc(). */
413void i8042_suspend(chardev_t *d)
414{
415}
416
417static __u8 active_read_buff_read(void)
418{
419 static int i=0;
420 i &= (ACTIVE_READ_BUFF_SIZE-1);
421 if(!active_read_buff[i]) {
422 return 0;
423 }
424 return active_read_buff[i++];
425}
426
427static void active_read_buff_write(__u8 ch)
428{
429 static int i=0;
430 active_read_buff[i] = ch;
431 i++;
432 i &= (ACTIVE_READ_BUFF_SIZE-1);
433 active_read_buff[i]=0;
434}
435
436
437static void active_read_key_pressed(__u8 sc)
438{
439 char *map = sc_primary_map;
440 char ascii = sc_primary_map[sc];
441 bool shift, capslock;
442 bool letter = false;
443
444 /*spinlock_lock(&keylock);*/
445 switch (sc) {
446 case SC_LSHIFT:
447 case SC_RSHIFT:
448 keyflags |= PRESSED_SHIFT;
449 break;
450 case SC_CAPSLOCK:
451 keyflags |= PRESSED_CAPSLOCK;
452 break;
453 case SC_SPEC_ESCAPE:
454 break;
455 case SC_LEFTARR:
456 active_read_buff_write(0x1b);
457 active_read_buff_write(0x5b);
458 active_read_buff_write(0x44);
459 break;
460 case SC_RIGHTARR:
461 active_read_buff_write(0x1b);
462 active_read_buff_write(0x5b);
463 active_read_buff_write(0x43);
464 break;
465 case SC_UPARR:
466 active_read_buff_write(0x1b);
467 active_read_buff_write(0x5b);
468 active_read_buff_write(0x41);
469 break;
470 case SC_DOWNARR:
471 active_read_buff_write(0x1b);
472 active_read_buff_write(0x5b);
473 active_read_buff_write(0x42);
474 break;
475 case SC_HOME:
476 active_read_buff_write(0x1b);
477 active_read_buff_write(0x4f);
478 active_read_buff_write(0x48);
479 break;
480 case SC_END:
481 active_read_buff_write(0x1b);
482 active_read_buff_write(0x4f);
483 active_read_buff_write(0x46);
484 break;
485 case SC_DELETE:
486 active_read_buff_write(0x1b);
487 active_read_buff_write(0x5b);
488 active_read_buff_write(0x33);
489 active_read_buff_write(0x7e);
490 break;
491 default:
492 letter = is_lower(ascii);
493 capslock = (keyflags & PRESSED_CAPSLOCK) || (lockflags & LOCKED_CAPSLOCK);
494 shift = keyflags & PRESSED_SHIFT;
495 if (letter && capslock)
496 shift = !shift;
497 if (shift)
498 map = sc_secondary_map;
499 active_read_buff_write(map[sc]);
500 break;
501 }
502 /*spinlock_unlock(&keylock);*/
503
504}
505
506static char key_read(chardev_t *d)
507{
508 char ch;
509
510 while(!(ch = active_read_buff_read())) {
511 __u8 x;
512 while (!((x=i8042_status_read() & i8042_BUFFER_FULL_MASK)))
513 ;
514 x = i8042_data_read();
515 if (x != IGNORE_CODE) {
516 if (x & KEY_RELEASE)
517 key_released(x ^ KEY_RELEASE);
518 else
519 active_read_key_pressed(x);
520 }
521 }
522 return ch;
523}
524
525/** Poll for key press and release events.
526 *
527 * This function can be used to implement keyboard polling.
528 */
529void i8042_poll(void)
530{
531 __u8 x;
532
533 while (((x = i8042_status_read() & i8042_BUFFER_FULL_MASK))) {
534 x = i8042_data_read();
535 if (x != IGNORE_CODE) {
536 if (x & KEY_RELEASE)
537 key_released(x ^ KEY_RELEASE);
538 else
539 key_pressed(x);
540 }
541 }
542}
Note: See TracBrowser for help on using the repository browser.