1 // 16bit code to handle keyboard requests.
3 // Copyright (C) 2008 Kevin O'Connor <kevin@koconnor.net>
4 // Copyright (C) 2002 MandrakeSoft S.A.
6 // This file may be distributed under the terms of the GNU LGPLv3 license.
8 #include "biosvar.h" // GET_BDA
9 #include "util.h" // debug_enter
10 #include "config.h" // CONFIG_*
11 #include "pic.h" // eoi_pic1
12 #include "bregs.h" // struct bregs
13 #include "ps2port.h" // i8042_flush
18 /* flush incoming keys */
19 int ret = i8042_flush();
23 // Controller self-test.
25 ret = i8042_command(I8042_CMD_CTL_TEST, param);
28 if (param[0] != 0x55) {
29 dprintf(1, "i8042 self test failed (got %x not 0x55)\n", param[0]);
33 // Controller keyboard test.
34 ret = i8042_command(I8042_CMD_KBD_TEST, param);
37 if (param[0] != 0x00) {
38 dprintf(1, "i8042 keyboard test failed (got %x not 0x00)\n", param[0]);
42 // Enable keyboard and mouse ports.
43 ret = i8042_command(I8042_CMD_KBD_ENABLE, NULL);
46 ret = i8042_command(I8042_CMD_AUX_ENABLE, NULL);
51 /* ------------------- keyboard side ------------------------*/
52 /* reset keyboard and self test (keyboard side) */
53 ret = kbd_command(ATKBD_CMD_RESET_BAT, param);
56 if (param[0] != 0xaa) {
57 dprintf(1, "keyboard self test failed (got %x not 0xaa)\n", param[0]);
61 /* Disable keyboard */
62 ret = kbd_command(ATKBD_CMD_RESET_DIS, NULL);
66 // Set scancode command (mode 2)
68 ret = kbd_command(ATKBD_CMD_SSCANSET, param);
72 // Keyboard Mode: scan code convert, disable mouse, enable IRQ 1
73 SET_EBDA(ps2ctr, I8042_CTR_AUXDIS | I8042_CTR_XLATE | I8042_CTR_KBDINT);
76 ret = kbd_command(ATKBD_CMD_ENABLE, NULL);
80 dprintf(1, "keyboard initialized\n");
86 dprintf(3, "init keyboard\n");
87 u16 x = offsetof(struct bios_data_area_s, kbd_buf);
88 SET_BDA(kbd_mode, 0x10);
89 SET_BDA(kbd_buf_head, x);
90 SET_BDA(kbd_buf_tail, x);
91 SET_BDA(kbd_buf_start_offset, x);
93 SET_BDA(kbd_buf_end_offset
94 , x + FIELD_SIZEOF(struct bios_data_area_s, kbd_buf));
96 if (! CONFIG_KEYBOARD)
101 enable_hwirq(1, entry_09);
105 enqueue_key(u8 scan_code, u8 ascii_code)
107 u16 buffer_start = GET_BDA(kbd_buf_start_offset);
108 u16 buffer_end = GET_BDA(kbd_buf_end_offset);
110 u16 buffer_head = GET_BDA(kbd_buf_head);
111 u16 buffer_tail = GET_BDA(kbd_buf_tail);
113 u16 temp_tail = buffer_tail;
115 if (buffer_tail >= buffer_end)
116 buffer_tail = buffer_start;
118 if (buffer_tail == buffer_head)
121 SET_FARVAR(SEG_BDA, *(u8*)(temp_tail+0), ascii_code);
122 SET_FARVAR(SEG_BDA, *(u8*)(temp_tail+1), scan_code);
123 SET_BDA(kbd_buf_tail, buffer_tail);
128 dequeue_key(struct bregs *regs, int incr, int extended)
133 buffer_head = GET_BDA(kbd_buf_head);
134 buffer_tail = GET_BDA(kbd_buf_tail);
136 if (buffer_head != buffer_tail)
145 u8 ascii_code = GET_FARVAR(SEG_BDA, *(u8*)(buffer_head+0));
146 u8 scan_code = GET_FARVAR(SEG_BDA, *(u8*)(buffer_head+1));
147 if ((ascii_code == 0xF0 && scan_code != 0)
148 || (ascii_code == 0xE0 && !extended))
150 regs->ax = (scan_code << 8) | ascii_code;
153 regs->flags &= ~F_ZF;
156 u16 buffer_start = GET_BDA(kbd_buf_start_offset);
157 u16 buffer_end = GET_BDA(kbd_buf_end_offset);
160 if (buffer_head >= buffer_end)
161 buffer_head = buffer_start;
162 SET_BDA(kbd_buf_head, buffer_head);
165 // read keyboard input
167 handle_1600(struct bregs *regs)
169 dequeue_key(regs, 1, 0);
172 // check keyboard status
174 handle_1601(struct bregs *regs)
176 dequeue_key(regs, 0, 0);
179 // get shift flag status
181 handle_1602(struct bregs *regs)
183 regs->al = GET_BDA(kbd_flag0);
186 // store key-stroke into buffer
188 handle_1605(struct bregs *regs)
190 regs->al = !enqueue_key(regs->ch, regs->cl);
193 // GET KEYBOARD FUNCTIONALITY
195 handle_1609(struct bregs *regs)
197 // bit Bochs Description
199 // 6 0 INT 16/AH=20h-22h supported (122-key keyboard support)
200 // 5 1 INT 16/AH=10h-12h supported (enhanced keyboard support)
201 // 4 1 INT 16/AH=0Ah supported
202 // 3 0 INT 16/AX=0306h supported
203 // 2 0 INT 16/AX=0305h supported
204 // 1 0 INT 16/AX=0304h supported
205 // 0 0 INT 16/AX=0300h supported
212 handle_160a(struct bregs *regs)
215 int ret = kbd_command(ATKBD_CMD_GETID, param);
220 regs->bx = (param[1] << 8) | param[0];
223 // read MF-II keyboard input
225 handle_1610(struct bregs *regs)
227 dequeue_key(regs, 1, 1);
230 // check MF-II keyboard status
232 handle_1611(struct bregs *regs)
234 dequeue_key(regs, 0, 1);
237 // get extended keyboard status
239 handle_1612(struct bregs *regs)
241 regs->al = GET_BDA(kbd_flag0);
242 regs->ah = (GET_BDA(kbd_flag1) & 0x73) | (GET_BDA(kbd_mode) & 0x0c);
243 //BX_DEBUG_INT16("int16: func 12 sending %04x\n",AX);
247 handle_166f(struct bregs *regs)
249 if (regs->al == 0x08)
250 // unsupported, aka normal keyboard
254 // keyboard capability check called by DOS 5.0+ keyb
256 handle_1692(struct bregs *regs)
258 // function int16 ah=0x10-0x12 supported
262 // 122 keys capability check called by DOS 5.0+ keyb
264 handle_16a2(struct bregs *regs)
266 // don't change AH : function int16 ah=0x20-0x22 NOT supported
270 handle_16XX(struct bregs *regs)
278 u8 shift_flags = (GET_BDA(kbd_flag0) >> 4) & 0x07;
279 u8 kbd_led = GET_BDA(kbd_led);
280 u8 led_flags = kbd_led & 0x07;
281 if (shift_flags == led_flags)
284 int ret = kbd_command(ATKBD_CMD_SETLEDS, &shift_flags);
288 kbd_led = (kbd_led & ~0x07) | shift_flags;
289 SET_BDA(kbd_led, kbd_led);
292 // INT 16h Keyboard Service Entry Point
294 handle_16(struct bregs *regs)
296 debug_enter(regs, DEBUG_HDL_16);
297 if (! CONFIG_KEYBOARD)
305 case 0x00: handle_1600(regs); break;
306 case 0x01: handle_1601(regs); break;
307 case 0x02: handle_1602(regs); break;
308 case 0x05: handle_1605(regs); break;
309 case 0x09: handle_1609(regs); break;
310 case 0x0a: handle_160a(regs); break;
311 case 0x10: handle_1610(regs); break;
312 case 0x11: handle_1611(regs); break;
313 case 0x12: handle_1612(regs); break;
314 case 0x92: handle_1692(regs); break;
315 case 0xa2: handle_16a2(regs); break;
316 case 0x6f: handle_166f(regs); break;
317 default: handle_16XX(regs); break;
322 #define MAX_SCAN_CODE 0x58
324 static struct scaninfo {
330 } scan_to_scanascii[MAX_SCAN_CODE + 1] VAR16 = {
331 { none, none, none, none, none },
332 { 0x011b, 0x011b, 0x011b, 0x0100, none }, /* escape */
333 { 0x0231, 0x0221, none, 0x7800, none }, /* 1! */
334 { 0x0332, 0x0340, 0x0300, 0x7900, none }, /* 2@ */
335 { 0x0433, 0x0423, none, 0x7a00, none }, /* 3# */
336 { 0x0534, 0x0524, none, 0x7b00, none }, /* 4$ */
337 { 0x0635, 0x0625, none, 0x7c00, none }, /* 5% */
338 { 0x0736, 0x075e, 0x071e, 0x7d00, none }, /* 6^ */
339 { 0x0837, 0x0826, none, 0x7e00, none }, /* 7& */
340 { 0x0938, 0x092a, none, 0x7f00, none }, /* 8* */
341 { 0x0a39, 0x0a28, none, 0x8000, none }, /* 9( */
342 { 0x0b30, 0x0b29, none, 0x8100, none }, /* 0) */
343 { 0x0c2d, 0x0c5f, 0x0c1f, 0x8200, none }, /* -_ */
344 { 0x0d3d, 0x0d2b, none, 0x8300, none }, /* =+ */
345 { 0x0e08, 0x0e08, 0x0e7f, none, none }, /* backspace */
346 { 0x0f09, 0x0f00, none, none, none }, /* tab */
347 { 0x1071, 0x1051, 0x1011, 0x1000, 0x40 }, /* Q */
348 { 0x1177, 0x1157, 0x1117, 0x1100, 0x40 }, /* W */
349 { 0x1265, 0x1245, 0x1205, 0x1200, 0x40 }, /* E */
350 { 0x1372, 0x1352, 0x1312, 0x1300, 0x40 }, /* R */
351 { 0x1474, 0x1454, 0x1414, 0x1400, 0x40 }, /* T */
352 { 0x1579, 0x1559, 0x1519, 0x1500, 0x40 }, /* Y */
353 { 0x1675, 0x1655, 0x1615, 0x1600, 0x40 }, /* U */
354 { 0x1769, 0x1749, 0x1709, 0x1700, 0x40 }, /* I */
355 { 0x186f, 0x184f, 0x180f, 0x1800, 0x40 }, /* O */
356 { 0x1970, 0x1950, 0x1910, 0x1900, 0x40 }, /* P */
357 { 0x1a5b, 0x1a7b, 0x1a1b, none, none }, /* [{ */
358 { 0x1b5d, 0x1b7d, 0x1b1d, none, none }, /* ]} */
359 { 0x1c0d, 0x1c0d, 0x1c0a, none, none }, /* Enter */
360 { none, none, none, none, none }, /* L Ctrl */
361 { 0x1e61, 0x1e41, 0x1e01, 0x1e00, 0x40 }, /* A */
362 { 0x1f73, 0x1f53, 0x1f13, 0x1f00, 0x40 }, /* S */
363 { 0x2064, 0x2044, 0x2004, 0x2000, 0x40 }, /* D */
364 { 0x2166, 0x2146, 0x2106, 0x2100, 0x40 }, /* F */
365 { 0x2267, 0x2247, 0x2207, 0x2200, 0x40 }, /* G */
366 { 0x2368, 0x2348, 0x2308, 0x2300, 0x40 }, /* H */
367 { 0x246a, 0x244a, 0x240a, 0x2400, 0x40 }, /* J */
368 { 0x256b, 0x254b, 0x250b, 0x2500, 0x40 }, /* K */
369 { 0x266c, 0x264c, 0x260c, 0x2600, 0x40 }, /* L */
370 { 0x273b, 0x273a, none, none, none }, /* ;: */
371 { 0x2827, 0x2822, none, none, none }, /* '" */
372 { 0x2960, 0x297e, none, none, none }, /* `~ */
373 { none, none, none, none, none }, /* L shift */
374 { 0x2b5c, 0x2b7c, 0x2b1c, none, none }, /* |\ */
375 { 0x2c7a, 0x2c5a, 0x2c1a, 0x2c00, 0x40 }, /* Z */
376 { 0x2d78, 0x2d58, 0x2d18, 0x2d00, 0x40 }, /* X */
377 { 0x2e63, 0x2e43, 0x2e03, 0x2e00, 0x40 }, /* C */
378 { 0x2f76, 0x2f56, 0x2f16, 0x2f00, 0x40 }, /* V */
379 { 0x3062, 0x3042, 0x3002, 0x3000, 0x40 }, /* B */
380 { 0x316e, 0x314e, 0x310e, 0x3100, 0x40 }, /* N */
381 { 0x326d, 0x324d, 0x320d, 0x3200, 0x40 }, /* M */
382 { 0x332c, 0x333c, none, none, none }, /* ,< */
383 { 0x342e, 0x343e, none, none, none }, /* .> */
384 { 0x352f, 0x353f, none, none, none }, /* /? */
385 { none, none, none, none, none }, /* R Shift */
386 { 0x372a, 0x372a, none, none, none }, /* * */
387 { none, none, none, none, none }, /* L Alt */
388 { 0x3920, 0x3920, 0x3920, 0x3920, none }, /* space */
389 { none, none, none, none, none }, /* caps lock */
390 { 0x3b00, 0x5400, 0x5e00, 0x6800, none }, /* F1 */
391 { 0x3c00, 0x5500, 0x5f00, 0x6900, none }, /* F2 */
392 { 0x3d00, 0x5600, 0x6000, 0x6a00, none }, /* F3 */
393 { 0x3e00, 0x5700, 0x6100, 0x6b00, none }, /* F4 */
394 { 0x3f00, 0x5800, 0x6200, 0x6c00, none }, /* F5 */
395 { 0x4000, 0x5900, 0x6300, 0x6d00, none }, /* F6 */
396 { 0x4100, 0x5a00, 0x6400, 0x6e00, none }, /* F7 */
397 { 0x4200, 0x5b00, 0x6500, 0x6f00, none }, /* F8 */
398 { 0x4300, 0x5c00, 0x6600, 0x7000, none }, /* F9 */
399 { 0x4400, 0x5d00, 0x6700, 0x7100, none }, /* F10 */
400 { none, none, none, none, none }, /* Num Lock */
401 { none, none, none, none, none }, /* Scroll Lock */
402 { 0x4700, 0x4737, 0x7700, none, 0x20 }, /* 7 Home */
403 { 0x4800, 0x4838, none, none, 0x20 }, /* 8 UP */
404 { 0x4900, 0x4939, 0x8400, none, 0x20 }, /* 9 PgUp */
405 { 0x4a2d, 0x4a2d, none, none, none }, /* - */
406 { 0x4b00, 0x4b34, 0x7300, none, 0x20 }, /* 4 Left */
407 { 0x4c00, 0x4c35, none, none, 0x20 }, /* 5 */
408 { 0x4d00, 0x4d36, 0x7400, none, 0x20 }, /* 6 Right */
409 { 0x4e2b, 0x4e2b, none, none, none }, /* + */
410 { 0x4f00, 0x4f31, 0x7500, none, 0x20 }, /* 1 End */
411 { 0x5000, 0x5032, none, none, 0x20 }, /* 2 Down */
412 { 0x5100, 0x5133, 0x7600, none, 0x20 }, /* 3 PgDn */
413 { 0x5200, 0x5230, none, none, 0x20 }, /* 0 Ins */
414 { 0x5300, 0x532e, none, none, 0x20 }, /* Del */
415 { none, none, none, none, none },
416 { none, none, none, none, none },
417 { 0x565c, 0x567c, none, none, none }, /* \| */
418 { 0x8500, 0x8700, 0x8900, 0x8b00, none }, /* F11 */
419 { 0x8600, 0x8800, 0x8a00, 0x8c00, none }, /* F12 */
422 // Handle a scancode read from the ps2 port. Note that "noinline" is
423 // used to make sure the call to call16_simpint in handle_09 doesn't
424 // have the overhead of this function's stack.
426 process_key(u8 scancode)
428 u8 shift_flags = GET_BDA(kbd_flag0);
429 u8 mf2_flags = GET_BDA(kbd_flag1);
430 u8 mf2_state = GET_BDA(kbd_mode);
434 dprintf(1, "KBD: int09 handler: AL=0\n");
437 case 0x3a: /* Caps Lock press */
439 SET_BDA(kbd_flag0, shift_flags);
441 SET_BDA(kbd_flag1, mf2_flags);
443 case 0xba: /* Caps Lock release */
445 SET_BDA(kbd_flag1, mf2_flags);
448 case 0x2a: /* L Shift press */
450 SET_BDA(kbd_flag0, shift_flags);
452 case 0xaa: /* L Shift release */
453 shift_flags &= ~0x02;
454 SET_BDA(kbd_flag0, shift_flags);
457 case 0x36: /* R Shift press */
459 SET_BDA(kbd_flag0, shift_flags);
461 case 0xb6: /* R Shift release */
462 shift_flags &= ~0x01;
463 SET_BDA(kbd_flag0, shift_flags);
466 case 0x1d: /* Ctrl press */
467 if ((mf2_state & 0x01) == 0) {
469 SET_BDA(kbd_flag0, shift_flags);
470 if (mf2_state & 0x02) {
472 SET_BDA(kbd_mode, mf2_state);
475 SET_BDA(kbd_flag1, mf2_flags);
479 case 0x9d: /* Ctrl release */
480 if ((mf2_state & 0x01) == 0) {
481 shift_flags &= ~0x04;
482 SET_BDA(kbd_flag0, shift_flags);
483 if (mf2_state & 0x02) {
485 SET_BDA(kbd_mode, mf2_state);
488 SET_BDA(kbd_flag1, mf2_flags);
493 case 0x38: /* Alt press */
495 SET_BDA(kbd_flag0, shift_flags);
496 if (mf2_state & 0x02) {
498 SET_BDA(kbd_mode, mf2_state);
501 SET_BDA(kbd_flag1, mf2_flags);
504 case 0xb8: /* Alt release */
505 shift_flags &= ~0x08;
506 SET_BDA(kbd_flag0, shift_flags);
507 if (mf2_state & 0x02) {
509 SET_BDA(kbd_mode, mf2_state);
512 SET_BDA(kbd_flag1, mf2_flags);
516 case 0x45: /* Num Lock press */
517 if ((mf2_state & 0x03) == 0) {
519 SET_BDA(kbd_flag1, mf2_flags);
521 SET_BDA(kbd_flag0, shift_flags);
524 case 0xc5: /* Num Lock release */
525 if ((mf2_state & 0x03) == 0) {
527 SET_BDA(kbd_flag1, mf2_flags);
531 case 0x46: /* Scroll Lock press */
533 SET_BDA(kbd_flag1, mf2_flags);
535 SET_BDA(kbd_flag0, shift_flags);
537 case 0xc6: /* Scroll Lock release */
539 SET_BDA(kbd_flag1, mf2_flags);
544 SETBITS_BDA(kbd_mode, 0x02);
548 SETBITS_BDA(kbd_mode, 0x01);
555 if (scancode == 0x53 && (shift_flags & 0x0c) == 0x0c)
556 // Ctrl+alt+del - reset machine.
558 if (scancode > MAX_SCAN_CODE) {
559 dprintf(1, "KBD: int09h_handler(): unknown scancode read: 0x%02x!\n"
564 struct scaninfo *info = &scan_to_scanascii[scancode];
565 if (shift_flags & 0x08) { /* ALT */
566 asciicode = GET_GLOBAL(info->alt);
567 scancode = GET_GLOBAL(info->alt) >> 8;
568 } else if (shift_flags & 0x04) { /* CONTROL */
569 asciicode = GET_GLOBAL(info->control);
570 scancode = GET_GLOBAL(info->control) >> 8;
571 } else if ((mf2_state & 0x02) > 0
572 && scancode >= 0x47 && scancode <= 0x53) {
573 /* extended keys handling */
575 scancode = GET_GLOBAL(info->normal) >> 8;
576 } else if (shift_flags & 0x03) { /* LSHIFT + RSHIFT */
577 /* check if lock state should be ignored
578 * because a SHIFT key are pressed */
580 if (shift_flags & GET_GLOBAL(info->lock_flags)) {
581 asciicode = GET_GLOBAL(info->normal);
582 scancode = GET_GLOBAL(info->normal) >> 8;
584 asciicode = GET_GLOBAL(info->shift);
585 scancode = GET_GLOBAL(info->shift) >> 8;
588 /* check if lock is on */
589 if (shift_flags & GET_GLOBAL(info->lock_flags)) {
590 asciicode = GET_GLOBAL(info->shift);
591 scancode = GET_GLOBAL(info->shift) >> 8;
593 asciicode = GET_GLOBAL(info->normal);
594 scancode = GET_GLOBAL(info->normal) >> 8;
597 if (scancode==0 && asciicode==0) {
598 dprintf(1, "KBD: int09h_handler():"
599 " scancode & asciicode are zero?\n");
601 enqueue_key(scancode, asciicode);
604 if ((scancode & 0x7f) != 0x1d) {
608 SET_BDA(kbd_mode, mf2_state);
611 // INT09h : Keyboard Hardware Service Entry Point
615 debug_isr(DEBUG_ISR_09);
616 if (! CONFIG_KEYBOARD)
619 // read key from keyboard controller
620 u8 v = inb(PORT_PS2_STATUS);
621 if ((v & (I8042_STR_OBF|I8042_STR_AUXDATA)) != I8042_STR_OBF) {
622 dprintf(1, "keyboard irq but no keyboard data.\n");
625 u8 key = inb(PORT_PS2_DATA);
627 if (CONFIG_KBD_CALL_INT15_4F) {
628 // allow for keyboard intercept
629 u32 eax = (0x4f << 8) | key;
631 call16_simpint(0x15, &eax, &flags);