src/kbd.c

   1 // 16bit code to handle keyboard requests.
   2 //
   3 // Copyright (C) 2008  Kevin O'Connor <kevin@koconnor.net>
   4 // Copyright (C) 2002  MandrakeSoft S.A.
   5 //
   6 // This file may be distributed under the terms of the GNU GPLv3 license.
   7
   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
  14
  15 static void
  16 keyboard_init()
  17 {
  18     if (CONFIG_COREBOOT)
  19         // Coreboot already does low-level keyboard init.
  20         goto end;
  21
  22     /* flush incoming keys */
  23     int ret = i8042_flush();
  24     if (ret)
  25         return;
  26
  27     // Controller self-test.
  28     u8 param[2];
  29     ret = i8042_command(I8042_CMD_CTL_TEST, param);
  30     if (ret)
  31         return;
  32     if (param[0] != 0x55) {
  33         dprintf(1, "i8042 self test failed (got %x not 0x55\n", param[0]);
  34         return;
  35     }
  36
  37     // Controller keyboard test.
  38     ret = i8042_command(I8042_CMD_KBD_TEST, param);
  39     if (ret)
  40         return;
  41     if (param[0] != 0x00) {
  42         dprintf(1, "i8042 keyboard test failed (got %x not 0x00\n", param[0]);
  43         return;
  44     }
  45
  46     // Enable keyboard and mouse ports.
  47     ret = i8042_command(I8042_CMD_KBD_ENABLE, NULL);
  48     if (ret)
  49         return;
  50     ret = i8042_command(I8042_CMD_AUX_ENABLE, NULL);
  51     if (ret)
  52         return;
  53
  54
  55     /* ------------------- keyboard side ------------------------*/
  56     /* reset keyboard and self test  (keyboard side) */
  57     ret = kbd_command(ATKBD_CMD_RESET_BAT, param);
  58     if (ret)
  59         return;
  60     if (param[0] != 0xaa) {
  61         dprintf(1, "keyboard self test failed (got %x not 0xaa\n", param[0]);
  62         return;
  63     }
  64
  65     /* Disable keyboard */
  66     ret = kbd_command(ATKBD_CMD_RESET_DIS, NULL);
  67     if (ret)
  68         return;
  69
  70 end:
  71     // Keyboard Mode: scan code convert, disable mouse, enable IRQ 1
  72     SET_EBDA(ps2ctr, I8042_CTR_AUXDIS | I8042_CTR_XLATE | I8042_CTR_KBDINT);
  73
  74     /* Enable keyboard */
  75     ret = kbd_command(ATKBD_CMD_ENABLE, NULL);
  76     if (ret)
  77         return;
  78
  79     dprintf(1, "keyboard initialized\n");
  80 }
  81
  82 void
  83 kbd_setup()
  84 {
  85     dprintf(3, "init keyboard\n");
  86     u16 x = offsetof(struct bios_data_area_s, kbd_buf) - 0x400;
  87     SET_BDA(kbd_mode, 0x10);
  88     SET_BDA(kbd_buf_head, x);
  89     SET_BDA(kbd_buf_tail, x);
  90     SET_BDA(kbd_buf_start_offset, x);
  91
  92     SET_BDA(kbd_buf_end_offset
  93             , x + FIELD_SIZEOF(struct bios_data_area_s, kbd_buf));
  94
  95     keyboard_init();
  96
  97     // Enable IRQ1 (handle_09)
  98     unmask_pic1(PIC1_IRQ1);
  99 }
 100
 101 static u8
 102 enqueue_key(u8 scan_code, u8 ascii_code)
 103 {
 104     u16 buffer_start = GET_BDA(kbd_buf_start_offset);
 105     u16 buffer_end   = GET_BDA(kbd_buf_end_offset);
 106
 107     u16 buffer_head = GET_BDA(kbd_buf_head);
 108     u16 buffer_tail = GET_BDA(kbd_buf_tail);
 109
 110     u16 temp_tail = buffer_tail;
 111     buffer_tail += 2;
 112     if (buffer_tail >= buffer_end)
 113         buffer_tail = buffer_start;
 114
 115     if (buffer_tail == buffer_head)
 116         return 0;
 117
 118     SET_FARVAR(SEG_BDA, *(u8*)(temp_tail+0x400+0), ascii_code);
 119     SET_FARVAR(SEG_BDA, *(u8*)(temp_tail+0x400+1), scan_code);
 120     SET_BDA(kbd_buf_tail, buffer_tail);
 121     return 1;
 122 }
 123
 124 static u8
 125 dequeue_key(u8 *scan_code, u8 *ascii_code, u8 incr)
 126 {
 127     u16 buffer_head;
 128     u16 buffer_tail;
 129     for (;;) {
 130         buffer_head = GET_BDA(kbd_buf_head);
 131         buffer_tail = GET_BDA(kbd_buf_tail);
 132
 133         if (buffer_head != buffer_tail)
 134             break;
 135         if (!incr)
 136             return 0;
 137         cpu_relax();
 138     }
 139
 140     *ascii_code = GET_FARVAR(SEG_BDA, *(u8*)(buffer_head+0x400+0));
 141     *scan_code  = GET_FARVAR(SEG_BDA, *(u8*)(buffer_head+0x400+1));
 142
 143     if (incr) {
 144         u16 buffer_start = GET_BDA(kbd_buf_start_offset);
 145         u16 buffer_end   = GET_BDA(kbd_buf_end_offset);
 146
 147         buffer_head += 2;
 148         if (buffer_head >= buffer_end)
 149             buffer_head = buffer_start;
 150         SET_BDA(kbd_buf_head, buffer_head);
 151     }
 152     return 1;
 153 }
 154
 155 // read keyboard input
 156 static void
 157 handle_1600(struct bregs *regs)
 158 {
 159     u8 scan_code, ascii_code;
 160     dequeue_key(&scan_code, &ascii_code, 1);
 161     if (scan_code != 0 && ascii_code == 0xF0)
 162         ascii_code = 0;
 163     else if (ascii_code == 0xE0)
 164         ascii_code = 0;
 165     regs->ax = (scan_code << 8) | ascii_code;
 166 }
 167
 168 // check keyboard status
 169 static void
 170 handle_1601(struct bregs *regs)
 171 {
 172     u8 scan_code, ascii_code;
 173     if (!dequeue_key(&scan_code, &ascii_code, 0)) {
 174         regs->flags |= F_ZF;
 175         return;
 176     }
 177     if (scan_code != 0 && ascii_code == 0xF0)
 178         ascii_code = 0;
 179     else if (ascii_code == 0xE0)
 180         ascii_code = 0;
 181     regs->ax = (scan_code << 8) | ascii_code;
 182     regs->flags &= ~F_ZF;
 183 }
 184
 185 // get shift flag status
 186 static void
 187 handle_1602(struct bregs *regs)
 188 {
 189     regs->al = GET_BDA(kbd_flag0);
 190 }
 191
 192 // store key-stroke into buffer
 193 static void
 194 handle_1605(struct bregs *regs)
 195 {
 196     regs->al = !enqueue_key(regs->ch, regs->cl);
 197 }
 198
 199 // GET KEYBOARD FUNCTIONALITY
 200 static void
 201 handle_1609(struct bregs *regs)
 202 {
 203     // bit Bochs Description
 204     //  7    0   reserved
 205     //  6    0   INT 16/AH=20h-22h supported (122-key keyboard support)
 206     //  5    1   INT 16/AH=10h-12h supported (enhanced keyboard support)
 207     //  4    1   INT 16/AH=0Ah supported
 208     //  3    0   INT 16/AX=0306h supported
 209     //  2    0   INT 16/AX=0305h supported
 210     //  1    0   INT 16/AX=0304h supported
 211     //  0    0   INT 16/AX=0300h supported
 212     //
 213     regs->al = 0x30;
 214 }
 215
 216 // GET KEYBOARD ID
 217 static void
 218 handle_160a(struct bregs *regs)
 219 {
 220     u8 param[2];
 221     int ret = kbd_command(ATKBD_CMD_GETID, param);
 222     if (ret) {
 223         regs->bx = 0;
 224         return;
 225     }
 226     regs->bx = (param[1] << 8) | param[0];
 227 }
 228
 229 // read MF-II keyboard input
 230 static void
 231 handle_1610(struct bregs *regs)
 232 {
 233     u8 scan_code, ascii_code;
 234     dequeue_key(&scan_code, &ascii_code, 1);
 235     if (scan_code != 0 && ascii_code == 0xF0)
 236         ascii_code = 0;
 237     regs->ax = (scan_code << 8) | ascii_code;
 238 }
 239
 240 // check MF-II keyboard status
 241 static void
 242 handle_1611(struct bregs *regs)
 243 {
 244     u8 scan_code, ascii_code;
 245     if (!dequeue_key(&scan_code, &ascii_code, 0)) {
 246         regs->flags |= F_ZF;
 247         return;
 248     }
 249     if (scan_code != 0 && ascii_code == 0xF0)
 250         ascii_code = 0;
 251     regs->ax = (scan_code << 8) | ascii_code;
 252     regs->flags &= ~F_ZF;
 253 }
 254
 255 // get extended keyboard status
 256 static void
 257 handle_1612(struct bregs *regs)
 258 {
 259     regs->al = GET_BDA(kbd_flag0);
 260     regs->ah = (GET_BDA(kbd_flag1) & 0x73) | (GET_BDA(kbd_mode) & 0x0c);
 261     //BX_DEBUG_INT16("int16: func 12 sending %04x\n",AX);
 262 }
 263
 264 static void
 265 handle_166f(struct bregs *regs)
 266 {
 267     if (regs->al == 0x08)
 268         // unsupported, aka normal keyboard
 269         regs->ah = 2;
 270 }
 271
 272 // keyboard capability check called by DOS 5.0+ keyb
 273 static void
 274 handle_1692(struct bregs *regs)
 275 {
 276     // function int16 ah=0x10-0x12 supported
 277     regs->ah = 0x80;
 278 }
 279
 280 // 122 keys capability check called by DOS 5.0+ keyb
 281 static void
 282 handle_16a2(struct bregs *regs)
 283 {
 284     // don't change AH : function int16 ah=0x20-0x22 NOT supported
 285 }
 286
 287 static void
 288 set_leds()
 289 {
 290     u8 shift_flags = (GET_BDA(kbd_flag0) >> 4) & 0x07;
 291     u8 kbd_led = GET_BDA(kbd_led);
 292     u8 led_flags = kbd_led & 0x07;
 293     if (shift_flags == led_flags)
 294         return;
 295
 296     int ret = kbd_command(ATKBD_CMD_SETLEDS, &shift_flags);
 297     if (ret)
 298         // Error
 299         return;
 300     kbd_led = (kbd_led & ~0x07) | shift_flags;
 301     SET_BDA(kbd_led, kbd_led);
 302 }
 303
 304 // INT 16h Keyboard Service Entry Point
 305 void VISIBLE16
 306 handle_16(struct bregs *regs)
 307 {
 308     debug_enter(regs, DEBUG_HDL_16);
 309
 310     irq_enable();
 311
 312     set_leds();
 313
 314     switch (regs->ah) {
 315     case 0x00: handle_1600(regs); break;
 316     case 0x01: handle_1601(regs); break;
 317     case 0x02: handle_1602(regs); break;
 318     case 0x05: handle_1605(regs); break;
 319     case 0x09: handle_1609(regs); break;
 320     case 0x0a: handle_160a(regs); break;
 321     case 0x10: handle_1610(regs); break;
 322     case 0x11: handle_1611(regs); break;
 323     case 0x12: handle_1612(regs); break;
 324     case 0x92: handle_1692(regs); break;
 325     case 0xa2: handle_16a2(regs); break;
 326     case 0x6f: handle_166f(regs); break;
 327     }
 328 }
 329
 330 #define none 0
 331 #define MAX_SCAN_CODE 0x58
 332
 333 static struct scaninfo {
 334     u16 normal;
 335     u16 shift;
 336     u16 control;
 337     u16 alt;
 338     u8 lock_flags;
 339 } scan_to_scanascii[MAX_SCAN_CODE + 1] = {
 340     {   none,   none,   none,   none, none },
 341     { 0x011b, 0x011b, 0x011b, 0x0100, none }, /* escape */
 342     { 0x0231, 0x0221,   none, 0x7800, none }, /* 1! */
 343     { 0x0332, 0x0340, 0x0300, 0x7900, none }, /* 2@ */
 344     { 0x0433, 0x0423,   none, 0x7a00, none }, /* 3# */
 345     { 0x0534, 0x0524,   none, 0x7b00, none }, /* 4$ */
 346     { 0x0635, 0x0625,   none, 0x7c00, none }, /* 5% */
 347     { 0x0736, 0x075e, 0x071e, 0x7d00, none }, /* 6^ */
 348     { 0x0837, 0x0826,   none, 0x7e00, none }, /* 7& */
 349     { 0x0938, 0x092a,   none, 0x7f00, none }, /* 8* */
 350     { 0x0a39, 0x0a28,   none, 0x8000, none }, /* 9( */
 351     { 0x0b30, 0x0b29,   none, 0x8100, none }, /* 0) */
 352     { 0x0c2d, 0x0c5f, 0x0c1f, 0x8200, none }, /* -_ */
 353     { 0x0d3d, 0x0d2b,   none, 0x8300, none }, /* =+ */
 354     { 0x0e08, 0x0e08, 0x0e7f,   none, none }, /* backspace */
 355     { 0x0f09, 0x0f00,   none,   none, none }, /* tab */
 356     { 0x1071, 0x1051, 0x1011, 0x1000, 0x40 }, /* Q */
 357     { 0x1177, 0x1157, 0x1117, 0x1100, 0x40 }, /* W */
 358     { 0x1265, 0x1245, 0x1205, 0x1200, 0x40 }, /* E */
 359     { 0x1372, 0x1352, 0x1312, 0x1300, 0x40 }, /* R */
 360     { 0x1474, 0x1454, 0x1414, 0x1400, 0x40 }, /* T */
 361     { 0x1579, 0x1559, 0x1519, 0x1500, 0x40 }, /* Y */
 362     { 0x1675, 0x1655, 0x1615, 0x1600, 0x40 }, /* U */
 363     { 0x1769, 0x1749, 0x1709, 0x1700, 0x40 }, /* I */
 364     { 0x186f, 0x184f, 0x180f, 0x1800, 0x40 }, /* O */
 365     { 0x1970, 0x1950, 0x1910, 0x1900, 0x40 }, /* P */
 366     { 0x1a5b, 0x1a7b, 0x1a1b,   none, none }, /* [{ */
 367     { 0x1b5d, 0x1b7d, 0x1b1d,   none, none }, /* ]} */
 368     { 0x1c0d, 0x1c0d, 0x1c0a,   none, none }, /* Enter */
 369     {   none,   none,   none,   none, none }, /* L Ctrl */
 370     { 0x1e61, 0x1e41, 0x1e01, 0x1e00, 0x40 }, /* A */
 371     { 0x1f73, 0x1f53, 0x1f13, 0x1f00, 0x40 }, /* S */
 372     { 0x2064, 0x2044, 0x2004, 0x2000, 0x40 }, /* D */
 373     { 0x2166, 0x2146, 0x2106, 0x2100, 0x40 }, /* F */
 374     { 0x2267, 0x2247, 0x2207, 0x2200, 0x40 }, /* G */
 375     { 0x2368, 0x2348, 0x2308, 0x2300, 0x40 }, /* H */
 376     { 0x246a, 0x244a, 0x240a, 0x2400, 0x40 }, /* J */
 377     { 0x256b, 0x254b, 0x250b, 0x2500, 0x40 }, /* K */
 378     { 0x266c, 0x264c, 0x260c, 0x2600, 0x40 }, /* L */
 379     { 0x273b, 0x273a,   none,   none, none }, /* ;: */
 380     { 0x2827, 0x2822,   none,   none, none }, /* '" */
 381     { 0x2960, 0x297e,   none,   none, none }, /* `~ */
 382     {   none,   none,   none,   none, none }, /* L shift */
 383     { 0x2b5c, 0x2b7c, 0x2b1c,   none, none }, /* |\ */
 384     { 0x2c7a, 0x2c5a, 0x2c1a, 0x2c00, 0x40 }, /* Z */
 385     { 0x2d78, 0x2d58, 0x2d18, 0x2d00, 0x40 }, /* X */
 386     { 0x2e63, 0x2e43, 0x2e03, 0x2e00, 0x40 }, /* C */
 387     { 0x2f76, 0x2f56, 0x2f16, 0x2f00, 0x40 }, /* V */
 388     { 0x3062, 0x3042, 0x3002, 0x3000, 0x40 }, /* B */
 389     { 0x316e, 0x314e, 0x310e, 0x3100, 0x40 }, /* N */
 390     { 0x326d, 0x324d, 0x320d, 0x3200, 0x40 }, /* M */
 391     { 0x332c, 0x333c,   none,   none, none }, /* ,< */
 392     { 0x342e, 0x343e,   none,   none, none }, /* .> */
 393     { 0x352f, 0x353f,   none,   none, none }, /* /? */
 394     {   none,   none,   none,   none, none }, /* R Shift */
 395     { 0x372a, 0x372a,   none,   none, none }, /* * */
 396     {   none,   none,   none,   none, none }, /* L Alt */
 397     { 0x3920, 0x3920, 0x3920, 0x3920, none }, /* space */
 398     {   none,   none,   none,   none, none }, /* caps lock */
 399     { 0x3b00, 0x5400, 0x5e00, 0x6800, none }, /* F1 */
 400     { 0x3c00, 0x5500, 0x5f00, 0x6900, none }, /* F2 */
 401     { 0x3d00, 0x5600, 0x6000, 0x6a00, none }, /* F3 */
 402     { 0x3e00, 0x5700, 0x6100, 0x6b00, none }, /* F4 */
 403     { 0x3f00, 0x5800, 0x6200, 0x6c00, none }, /* F5 */
 404     { 0x4000, 0x5900, 0x6300, 0x6d00, none }, /* F6 */
 405     { 0x4100, 0x5a00, 0x6400, 0x6e00, none }, /* F7 */
 406     { 0x4200, 0x5b00, 0x6500, 0x6f00, none }, /* F8 */
 407     { 0x4300, 0x5c00, 0x6600, 0x7000, none }, /* F9 */
 408     { 0x4400, 0x5d00, 0x6700, 0x7100, none }, /* F10 */
 409     {   none,   none,   none,   none, none }, /* Num Lock */
 410     {   none,   none,   none,   none, none }, /* Scroll Lock */
 411     { 0x4700, 0x4737, 0x7700,   none, 0x20 }, /* 7 Home */
 412     { 0x4800, 0x4838,   none,   none, 0x20 }, /* 8 UP */
 413     { 0x4900, 0x4939, 0x8400,   none, 0x20 }, /* 9 PgUp */
 414     { 0x4a2d, 0x4a2d,   none,   none, none }, /* - */
 415     { 0x4b00, 0x4b34, 0x7300,   none, 0x20 }, /* 4 Left */
 416     { 0x4c00, 0x4c35,   none,   none, 0x20 }, /* 5 */
 417     { 0x4d00, 0x4d36, 0x7400,   none, 0x20 }, /* 6 Right */
 418     { 0x4e2b, 0x4e2b,   none,   none, none }, /* + */
 419     { 0x4f00, 0x4f31, 0x7500,   none, 0x20 }, /* 1 End */
 420     { 0x5000, 0x5032,   none,   none, 0x20 }, /* 2 Down */
 421     { 0x5100, 0x5133, 0x7600,   none, 0x20 }, /* 3 PgDn */
 422     { 0x5200, 0x5230,   none,   none, 0x20 }, /* 0 Ins */
 423     { 0x5300, 0x532e,   none,   none, 0x20 }, /* Del */
 424     {   none,   none,   none,   none, none },
 425     {   none,   none,   none,   none, none },
 426     { 0x565c, 0x567c,   none,   none, none }, /* \| */
 427     { 0x5700, 0x5700,   none,   none, none }, /* F11 */
 428     { 0x5800, 0x5800,   none,   none, none }  /* F12 */
 429 };
 430
 431 static void
 432 process_key(u8 scancode)
 433 {
 434     u8 shift_flags = GET_BDA(kbd_flag0);
 435     u8 mf2_flags = GET_BDA(kbd_flag1);
 436     u8 mf2_state = GET_BDA(kbd_mode);
 437
 438     switch (scancode) {
 439     case 0x00:
 440         dprintf(1, "KBD: int09 handler: AL=0\n");
 441         return;
 442
 443     case 0x3a: /* Caps Lock press */
 444         shift_flags ^= 0x40;
 445         SET_BDA(kbd_flag0, shift_flags);
 446         mf2_flags |= 0x40;
 447         SET_BDA(kbd_flag1, mf2_flags);
 448         break;
 449     case 0xba: /* Caps Lock release */
 450         mf2_flags &= ~0x40;
 451         SET_BDA(kbd_flag1, mf2_flags);
 452         break;
 453
 454     case 0x2a: /* L Shift press */
 455         shift_flags |= 0x02;
 456         SET_BDA(kbd_flag0, shift_flags);
 457         break;
 458     case 0xaa: /* L Shift release */
 459         shift_flags &= ~0x02;
 460         SET_BDA(kbd_flag0, shift_flags);
 461         break;
 462
 463     case 0x36: /* R Shift press */
 464         shift_flags |= 0x01;
 465         SET_BDA(kbd_flag0, shift_flags);
 466         break;
 467     case 0xb6: /* R Shift release */
 468         shift_flags &= ~0x01;
 469         SET_BDA(kbd_flag0, shift_flags);
 470         break;
 471
 472     case 0x1d: /* Ctrl press */
 473         if ((mf2_state & 0x01) == 0) {
 474             shift_flags |= 0x04;
 475             SET_BDA(kbd_flag0, shift_flags);
 476             if (mf2_state & 0x02) {
 477                 mf2_state |= 0x04;
 478                 SET_BDA(kbd_mode, mf2_state);
 479             } else {
 480                 mf2_flags |= 0x01;
 481                 SET_BDA(kbd_flag1, mf2_flags);
 482             }
 483         }
 484         break;
 485     case 0x9d: /* Ctrl release */
 486         if ((mf2_state & 0x01) == 0) {
 487             shift_flags &= ~0x04;
 488             SET_BDA(kbd_flag0, shift_flags);
 489             if (mf2_state & 0x02) {
 490                 mf2_state &= ~0x04;
 491                 SET_BDA(kbd_mode, mf2_state);
 492             } else {
 493                 mf2_flags &= ~0x01;
 494                 SET_BDA(kbd_flag1, mf2_flags);
 495             }
 496         }
 497         break;
 498
 499     case 0x38: /* Alt press */
 500         shift_flags |= 0x08;
 501         SET_BDA(kbd_flag0, shift_flags);
 502         if (mf2_state & 0x02) {
 503             mf2_state |= 0x08;
 504             SET_BDA(kbd_mode, mf2_state);
 505         } else {
 506             mf2_flags |= 0x02;
 507             SET_BDA(kbd_flag1, mf2_flags);
 508         }
 509         break;
 510     case 0xb8: /* Alt release */
 511         shift_flags &= ~0x08;
 512         SET_BDA(kbd_flag0, shift_flags);
 513         if (mf2_state & 0x02) {
 514             mf2_state &= ~0x08;
 515             SET_BDA(kbd_mode, mf2_state);
 516         } else {
 517             mf2_flags &= ~0x02;
 518             SET_BDA(kbd_flag1, mf2_flags);
 519         }
 520         break;
 521
 522     case 0x45: /* Num Lock press */
 523         if ((mf2_state & 0x03) == 0) {
 524             mf2_flags |= 0x20;
 525             SET_BDA(kbd_flag1, mf2_flags);
 526             shift_flags ^= 0x20;
 527             SET_BDA(kbd_flag0, shift_flags);
 528         }
 529         break;
 530     case 0xc5: /* Num Lock release */
 531         if ((mf2_state & 0x03) == 0) {
 532             mf2_flags &= ~0x20;
 533             SET_BDA(kbd_flag1, mf2_flags);
 534         }
 535         break;
 536
 537     case 0x46: /* Scroll Lock press */
 538         mf2_flags |= 0x10;
 539         SET_BDA(kbd_flag1, mf2_flags);
 540         shift_flags ^= 0x10;
 541         SET_BDA(kbd_flag0, shift_flags);
 542         break;
 543     case 0xc6: /* Scroll Lock release */
 544         mf2_flags &= ~0x10;
 545         SET_BDA(kbd_flag1, mf2_flags);
 546         break;
 547
 548     case 0xe0:
 549         // Extended key
 550         SETBITS_BDA(kbd_mode, 0x02);
 551         return;
 552     case 0xe1:
 553         // Pause key
 554         SETBITS_BDA(kbd_mode, 0x01);
 555         return;
 556
 557     default:
 558         if (scancode & 0x80) {
 559             break; /* toss key releases ... */
 560         }
 561         if (scancode > MAX_SCAN_CODE) {
 562             dprintf(1, "KBD: int09h_handler(): unknown scancode read: 0x%02x!\n"
 563                     , scancode);
 564             return;
 565         }
 566         u8 asciicode;
 567         struct scaninfo *info = &scan_to_scanascii[scancode];
 568         if (shift_flags & 0x08) { /* ALT */
 569             asciicode = GET_VAR(CS, info->alt);
 570             scancode = GET_VAR(CS, info->alt) >> 8;
 571         } else if (shift_flags & 0x04) { /* CONTROL */
 572             asciicode = GET_VAR(CS, info->control);
 573             scancode = GET_VAR(CS, info->control) >> 8;
 574         } else if ((mf2_state & 0x02) > 0
 575                    && scancode >= 0x47 && scancode <= 0x53) {
 576             /* extended keys handling */
 577             asciicode = 0xe0;
 578             scancode = GET_VAR(CS, info->normal) >> 8;
 579         } else if (shift_flags & 0x03) { /* LSHIFT + RSHIFT */
 580             /* check if lock state should be ignored
 581              * because a SHIFT key are pressed */
 582
 583             if (shift_flags & GET_VAR(CS, info->lock_flags)) {
 584                 asciicode = GET_VAR(CS, info->normal);
 585                 scancode = GET_VAR(CS, info->normal) >> 8;
 586             } else {
 587                 asciicode = GET_VAR(CS, info->shift);
 588                 scancode = GET_VAR(CS, info->shift) >> 8;
 589             }
 590         } else {
 591             /* check if lock is on */
 592             if (shift_flags & GET_VAR(CS, info->lock_flags)) {
 593                 asciicode = GET_VAR(CS, info->shift);
 594                 scancode = GET_VAR(CS, info->shift) >> 8;
 595             } else {
 596                 asciicode = GET_VAR(CS, info->normal);
 597                 scancode = GET_VAR(CS, info->normal) >> 8;
 598             }
 599         }
 600         if (scancode==0 && asciicode==0) {
 601             dprintf(1, "KBD: int09h_handler():"
 602                     " scancode & asciicode are zero?\n");
 603         }
 604         enqueue_key(scancode, asciicode);
 605         break;
 606     }
 607     if ((scancode & 0x7f) != 0x1d) {
 608         mf2_state &= ~0x01;
 609     }
 610     mf2_state &= ~0x02;
 611     SET_BDA(kbd_mode, mf2_state);
 612 }
 613
 614 // INT09h : Keyboard Hardware Service Entry Point
 615 void VISIBLE16
 616 handle_09()
 617 {
 618     debug_isr(DEBUG_ISR_09);
 619
 620     // read key from keyboard controller
 621     u8 v = inb(PORT_PS2_STATUS);
 622     if ((v & 0x21) != 0x01) {
 623         dprintf(1, "int09 but no keyboard data.\n");
 624         goto done;
 625     }
 626     u8 key = inb(PORT_PS2_DATA);
 627
 628     irq_enable();
 629     if (CONFIG_KBD_CALL_INT15_4F) {
 630         // allow for keyboard intercept
 631         struct bregs tr;
 632         memset(&tr, 0, sizeof(tr));
 633         tr.al = key;
 634         tr.ah = 0x4f;
 635         tr.flags = F_CF;
 636         call16_int(0x15, &tr);
 637         if (!(tr.flags & F_CF))
 638             goto done;
 639         key = tr.al;
 640     }
 641     process_key(key);
 642
 643     irq_disable();
 644
 645 done:
 646     eoi_pic1();
 647 }