4 * Copyright (c) 1999 Kazutaka YOKOTA <yokota@zodiac.mech.utsunomiya-u.ac.jp>
7 * Redistribution and use in source and binary forms, with or without
8 * modification, are permitted provided that the following conditions
10 * 1. Redistributions of source code must retain the above copyright
11 * notice, this list of conditions and the following disclaimer as
12 * the first lines of this file unmodified.
13 * 2. Redistributions in binary form must reproduce the above copyright
14 * notice, this list of conditions and the following disclaimer in the
15 * documentation and/or other materials provided with the distribution.
17 * THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``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 AUTHORS 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.
28 * $FreeBSD: src/sys/dev/kbd/atkbd.c,v 1.25.2.4 2002/04/08 19:21:38 asmodai Exp $
31 * NOTE: All locks are handled by the kbd wrappers.
35 #include "opt_atkbd.h"
36 #include "opt_evdev.h"
38 #include <sys/param.h>
39 #include <sys/systm.h>
40 #include <sys/kernel.h>
43 #include <sys/malloc.h>
44 #include <sys/sysctl.h>
45 #include <sys/thread2.h>
50 #include "atkbdcreg.h"
52 #include <bus/isa/isareg.h>
55 #include <dev/misc/evdev/evdev.h>
56 #include <dev/misc/evdev/input.h>
59 typedef struct atkbd_state {
60 KBDC kbdc; /* keyboard controller */
61 int ks_mode; /* input mode (K_XLATE,K_RAW,K_CODE) */
62 int ks_flags; /* flags */
63 #define COMPOSE (1 << 0)
65 int ks_state; /* shift/lock key state */
66 int ks_accents; /* accent key index (> 0) */
67 u_int ks_composed_char; /* composed char code (> 0) */
68 u_char ks_prefix; /* AT scan code prefix */
70 struct evdev_dev *ks_evdev;
75 static SYSCTL_NODE(_hw, OID_AUTO, atkbd, CTLFLAG_RD, 0, "AT keyboard");
77 static int atkbdhz = 0;
79 TUNABLE_INT("hw.atkbd.hz", &atkbdhz);
80 SYSCTL_INT(_hw_atkbd, OID_AUTO, hz, CTLFLAG_RW, &atkbdhz, 0,
81 "Polling frequency (in hz)");
84 static void atkbd_timeout(void *arg);
85 static int atkbd_reset(KBDC kbdc, int flags, int c);
87 #define HAS_QUIRK(p, q) (((atkbdc_softc_t *)(p))->quirks & q)
88 #define ALLOW_DISABLE_KBD(kbdc) !HAS_QUIRK(kbdc, KBDC_QUIRK_KEEP_ACTIVATED)
90 #define DEFAULT_DELAY 0x1 /* 500ms */
91 #define DEFAULT_RATE 0x10 /* 14Hz */
94 #define PS2_KEYBOARD_VENDOR 1
95 #define PS2_KEYBOARD_PRODUCT 1
99 atkbd_probe_unit(int unit, int ctlr, int irq, int flags)
101 keyboard_switch_t *sw;
105 sw = kbd_get_switch(ATKBD_DRIVER_NAME);
112 error = (*sw->probe)(unit, args, flags);
120 atkbd_attach_unit(int unit, keyboard_t **kbd, int ctlr, int irq, int flags)
122 keyboard_switch_t *sw;
126 sw = kbd_get_switch(ATKBD_DRIVER_NAME);
131 /* reset, initialize and enable the device */
135 error = (*sw->probe)(unit, args, flags);
139 error = (*sw->init)(unit, kbd, args, flags);
145 #ifdef KBD_INSTALL_CDEV
146 /* attach a virtual keyboard cdev */
147 error = kbd_attach(*kbd);
154 * This is a kludge to compensate for lost keyboard interrupts.
155 * A similar code used to be in syscons. See below. XXX
160 (*sw->diag)(*kbd, bootverbose);
166 atkbd_timeout(void *arg)
171 * The original text of the following comments are extracted
172 * from syscons.c (1.287)
174 * With release 2.1 of the Xaccel server, the keyboard is left
175 * hanging pretty often. Apparently an interrupt from the
176 * keyboard is lost, and I don't know why (yet).
177 * This ugly hack calls the low-level interrupt routine if input
178 * is ready for the keyboard and conveniently hides the problem. XXX
180 * Try removing anything stuck in the keyboard controller; whether
181 * it's a keyboard scan code or mouse data. The low-level
182 * interrupt routine doesn't read the mouse data directly,
183 * but the keyboard controller driver will, as a side effect.
186 * And here is bde's original comment about this:
188 * This is necessary to handle edge triggered interrupts - if we
189 * returned when our IRQ is high due to unserviced input, then there
190 * would be no more keyboard IRQs until the keyboard is reset by
193 * The keyboard apparently unwedges the irq in most cases.
196 kbd = (keyboard_t *)arg;
197 if (kbd_lock(kbd, TRUE)) {
199 * We have seen the lock flag is not set. Let's reset
200 * the flag early, otherwise the LED update routine fails
201 * which may want the lock during the interrupt routine.
203 kbd_lock(kbd, FALSE);
204 if (kbd_check_char(kbd))
208 callout_reset(&kbd->kb_atkbd_timeout_ch, hz / atkbdhz,
216 #include <machine/limits.h>
217 #include <machine/clock.h>
219 #define ATKBD_DEFAULT 0
222 /* keyboard driver declaration */
223 static int atkbd_configure(int flags);
224 static kbd_probe_t atkbd_probe;
225 static kbd_init_t atkbd_init;
226 static kbd_term_t atkbd_term;
227 static kbd_intr_t atkbd_intr;
228 static kbd_test_if_t atkbd_test_if;
229 static kbd_enable_t atkbd_enable;
230 static kbd_disable_t atkbd_disable;
231 static kbd_read_t atkbd_read;
232 static kbd_check_t atkbd_check;
233 static kbd_read_char_t atkbd_read_char;
234 static kbd_check_char_t atkbd_check_char;
235 static kbd_ioctl_t atkbd_ioctl;
236 static kbd_lock_t atkbd_lock;
237 static kbd_clear_state_t atkbd_clear_state;
238 static kbd_get_state_t atkbd_get_state;
239 static kbd_set_state_t atkbd_set_state;
240 static kbd_poll_mode_t atkbd_poll;
242 static keyboard_switch_t atkbdsw = {
243 .probe = atkbd_probe,
247 .test_if = atkbd_test_if,
248 .enable = atkbd_enable,
249 .disable = atkbd_disable,
251 .check = atkbd_check,
252 .read_char = atkbd_read_char,
253 .check_char = atkbd_check_char,
254 .ioctl = atkbd_ioctl,
256 .clear_state = atkbd_clear_state,
257 .get_state = atkbd_get_state,
258 .set_state = atkbd_set_state,
259 .get_fkeystr = genkbd_get_fkeystr,
264 KEYBOARD_DRIVER(atkbd, atkbdsw, atkbd_configure);
266 /* local functions */
267 static int set_typematic(keyboard_t *kbd);
268 static int setup_kbd_port(KBDC kbdc, int port, int intr);
269 static int get_kbd_echo(KBDC kbdc);
270 static int probe_keyboard(KBDC kbdc, int flags);
271 static int init_keyboard(KBDC kbdc, int *type, int flags);
272 static int write_kbd(KBDC kbdc, int command, int data);
273 static int get_kbd_id(KBDC kbdc);
274 static int typematic(int delay, int rate);
275 static int typematic_delay(int delay);
276 static int typematic_rate(int rate);
279 static evdev_event_t atkbd_ev_event;
281 static const struct evdev_methods atkbd_evdev_methods = {
282 .ev_event = atkbd_ev_event,
286 /* local variables */
288 /* the initial key map, accent map and fkey strings */
289 #ifdef ATKBD_DFLT_KEYMAP
290 #define KBD_DFLT_KEYMAP
291 #include "atkbdmap.h"
293 #include "kbdtables.h"
295 /* structures for the default keyboard */
296 static keyboard_t default_kbd;
297 static atkbd_state_t default_kbd_state;
298 static keymap_t default_keymap;
299 static accentmap_t default_accentmap;
300 static fkeytab_t default_fkeytab[NUM_FKEYS];
303 * The back door to the keyboard driver!
304 * This function is called by the console driver, via the kbdio module,
305 * to tickle keyboard drivers when the low-level console is being initialized.
306 * Almost nothing in the kernel has been initialied yet. Try to probe
307 * keyboards if possible.
308 * NOTE: because of the way the low-level console is initialized, this routine
309 * may be called more than once!!
312 atkbd_configure(int flags)
319 * Probe the keyboard controller, if not present or if the driver
320 * is disabled, unregister the keyboard if any.
322 if (atkbdc_configure() != 0 ||
323 resource_disabled("atkbd", ATKBD_DEFAULT)) {
324 i = kbd_find_keyboard(ATKBD_DRIVER_NAME, ATKBD_DEFAULT);
326 kbd = kbd_get_keyboard(i);
328 KBD_ALWAYS_LOCK(kbd);
330 kbd->kb_flags &= ~KB_REGISTERED;
335 /* XXX: a kludge to obtain the device configuration flags */
336 if (resource_int_value("atkbd", ATKBD_DEFAULT, "flags", &i) == 0)
339 /* probe the default keyboard */
343 if (atkbd_probe(ATKBD_DEFAULT, arg, flags)) {
346 if (atkbd_init(ATKBD_DEFAULT, &kbd, arg, flags)) {
350 /* return the number of found keyboards */
354 /* low-level functions */
356 /* detect a keyboard */
358 atkbd_probe(int unit, void *arg, int flags)
361 int *data = (int *)arg; /* data[0]: controller, data[1]: irq */
364 if (unit == ATKBD_DEFAULT) {
365 if (KBD_IS_PROBED(&default_kbd)) {
370 kbdc = atkbdc_open(data[0]);
374 if (probe_keyboard(kbdc, flags)) {
375 if (flags & KB_CONF_FAIL_IF_NO_KBD) {
384 #if defined(__FreeBSD__)
385 #define KBD_EVDEV_REGISTER(evdev) evdev_register_mtx(evdev, &Giant)
386 #elif defined(__DragonFly__)
387 #define KBD_EVDEV_REGISTER(evdev) evdev_register(evdev)
389 #error "FreeBSD or DragonFly expected"
391 #endif /* EVDEV_SUPPORT */
393 /* reset and initialize the device */
395 atkbd_init(int unit, keyboard_t **kbdp, void *arg, int flags)
398 atkbd_state_t *state;
404 int *data = (int *)arg; /* data[0]: controller, data[1]: irq */
407 struct evdev_dev *evdev;
412 if (unit == ATKBD_DEFAULT) {
413 *kbdp = kbd = &default_kbd;
414 if (KBD_IS_INITIALIZED(kbd) && KBD_IS_CONFIGURED(kbd)) {
417 state = &default_kbd_state;
418 keymap = &default_keymap;
419 accmap = &default_accentmap;
420 fkeymap = default_fkeytab;
421 fkeymap_size = nitems(default_fkeytab);
423 } else if (*kbdp == NULL) {
424 *kbdp = kbd = kmalloc(sizeof(*kbd), M_DEVBUF, M_WAITOK|M_ZERO);
425 state = kmalloc(sizeof(*state), M_DEVBUF, M_WAITOK|M_ZERO);
426 keymap = kmalloc(sizeof(key_map), M_DEVBUF, M_WAITOK);
427 accmap = kmalloc(sizeof(accent_map), M_DEVBUF, M_WAITOK);
428 fkeymap = kmalloc(sizeof(fkey_tab), M_DEVBUF, M_WAITOK);
429 fkeymap_size = nitems(fkey_tab);
431 if ((kbd == NULL) || (state == NULL) || (keymap == NULL)
432 || (accmap == NULL) || (fkeymap == NULL)) {
436 } else if (KBD_IS_INITIALIZED(*kbdp) && KBD_IS_CONFIGURED(*kbdp)) {
440 state = (atkbd_state_t *)kbd->kb_data;
441 bzero(state, sizeof(*state));
442 keymap = kbd->kb_keymap;
443 accmap = kbd->kb_accentmap;
444 fkeymap = kbd->kb_fkeytab;
445 fkeymap_size = kbd->kb_fkeytab_size;
449 if (!KBD_IS_PROBED(kbd)) {
450 state->kbdc = atkbdc_open(data[0]);
451 if (state->kbdc == NULL) {
455 kbd_init_struct(kbd, ATKBD_DRIVER_NAME, KB_OTHER, unit, flags,
457 bcopy(&key_map, keymap, sizeof(key_map));
458 bcopy(&accent_map, accmap, sizeof(accent_map));
459 bcopy(fkey_tab, fkeymap,
460 imin(fkeymap_size*sizeof(fkeymap[0]), sizeof(fkey_tab)));
461 kbd_set_maps(kbd, keymap, accmap, fkeymap, fkeymap_size);
462 kbd->kb_data = (void *)state;
464 if (probe_keyboard(state->kbdc, flags)) { /* shouldn't happen */
465 if (flags & KB_CONF_FAIL_IF_NO_KBD) {
470 KBD_FOUND_DEVICE(kbd);
472 atkbd_clear_state(kbd);
473 state->ks_mode = K_XLATE;
475 * FIXME: set the initial value for lock keys in ks_state
476 * according to the BIOS data?
480 if (!KBD_IS_INITIALIZED(kbd) && !(flags & KB_CONF_PROBE_ONLY)) {
481 kbd->kb_config = flags & ~KB_CONF_PROBE_ONLY;
482 if (KBD_HAS_DEVICE(kbd)
483 && init_keyboard(state->kbdc, &kbd->kb_type, kbd->kb_config)
484 && (kbd->kb_config & KB_CONF_FAIL_IF_NO_KBD)) {
489 atkbd_ioctl(kbd, KDSETLED, (caddr_t)&state->ks_state);
491 delay[0] = kbd->kb_delay1;
492 delay[1] = kbd->kb_delay2;
493 atkbd_ioctl(kbd, KDSETREPEAT, (caddr_t)delay);
496 /* register as evdev provider on first init */
497 if (state->ks_evdev == NULL) {
498 ksnprintf(phys_loc, sizeof(phys_loc), "atkbd%d", unit);
499 evdev = evdev_alloc();
500 evdev_set_name(evdev, "AT keyboard");
501 evdev_set_phys(evdev, phys_loc);
502 evdev_set_id(evdev, BUS_I8042, PS2_KEYBOARD_VENDOR,
503 PS2_KEYBOARD_PRODUCT, 0);
504 evdev_set_methods(evdev, kbd, &atkbd_evdev_methods);
505 evdev_support_event(evdev, EV_SYN);
506 evdev_support_event(evdev, EV_KEY);
507 evdev_support_event(evdev, EV_LED);
508 evdev_support_event(evdev, EV_REP);
509 evdev_support_all_known_keys(evdev);
510 evdev_support_led(evdev, LED_NUML);
511 evdev_support_led(evdev, LED_CAPSL);
512 evdev_support_led(evdev, LED_SCROLLL);
515 * NOTE: in freebsd, this depends on their Giant
516 * mutex lock, discuss with the others which
517 * locking would be best here
519 if (KBD_EVDEV_REGISTER(evdev))
522 state->ks_evdev = evdev;
523 state->ks_evdev_state = 0;
529 if (!KBD_IS_CONFIGURED(kbd)) {
530 if (kbd_register(kbd) < 0) {
534 KBD_CONFIG_DONE(kbd);
541 kfree(state, M_DEVBUF);
543 kfree(keymap, M_DEVBUF);
545 kfree(accmap, M_DEVBUF);
547 kfree(fkeymap, M_DEVBUF);
549 kfree(kbd, M_DEVBUF);
550 *kbdp = NULL; /* insure ref doesn't leak to caller */
557 /* finish using this keyboard */
559 atkbd_term(keyboard_t *kbd)
562 atkbd_state_t *state = (atkbd_state_t *)kbd->kb_data;
564 if(state->ks_evdev) {
565 evdev_free(state->ks_evdev);
566 state->ks_evdev = NULL;
567 state->ks_evdev_state = 0;
575 /* keyboard interrupt routine */
577 atkbd_intr(keyboard_t *kbd, void *arg)
579 atkbd_state_t *state = (atkbd_state_t *)kbd->kb_data;
583 if (!KBD_HAS_DEVICE(kbd)) {
585 * The keyboard was not detected before;
586 * it must have been reconnected!
588 init_keyboard(state->kbdc, &kbd->kb_type, kbd->kb_config);
589 KBD_FOUND_DEVICE(kbd);
590 atkbd_ioctl(kbd, KDSETLED, (caddr_t)&state->ks_state);
592 delay[0] = kbd->kb_delay1;
593 delay[1] = kbd->kb_delay2;
594 atkbd_ioctl(kbd, KDSETREPEAT, (caddr_t)delay);
597 if (state->ks_polling)
600 if (KBD_IS_ACTIVE(kbd) && KBD_IS_BUSY(kbd)) {
601 /* let the callback function to process the input */
602 (*kbd->kb_callback.kc_func)(kbd, KBDIO_KEYINPUT,
603 kbd->kb_callback.kc_arg);
605 /* read and discard the input; no one is waiting for input */
607 c = atkbd_read_char(kbd, FALSE);
608 } while (c != NOKEY);
614 /* test the interface to the device */
616 atkbd_test_if(keyboard_t *kbd)
621 empty_both_buffers(((atkbd_state_t *)kbd->kb_data)->kbdc, 10);
623 if (!test_controller(((atkbd_state_t *)kbd->kb_data)->kbdc))
625 else if (test_kbd_port(((atkbd_state_t *)kbd->kb_data)->kbdc) != 0)
633 * Enable the access to the device; until this function is called,
634 * the client cannot read from the keyboard.
637 atkbd_enable(keyboard_t *kbd)
645 /* disallow the access to the device */
647 atkbd_disable(keyboard_t *kbd)
655 /* read one byte from the keyboard if it's allowed */
657 atkbd_read(keyboard_t *kbd, int wait)
662 c = read_kbd_data(((atkbd_state_t *)kbd->kb_data)->kbdc);
664 c = read_kbd_data_no_wait(((atkbd_state_t *)kbd->kb_data)->kbdc);
668 ret = (KBD_IS_ACTIVE(kbd) ? c : -1);
673 /* check if data is waiting */
675 atkbd_check(keyboard_t *kbd)
679 if (!KBD_IS_ACTIVE(kbd)) {
682 ret = kbdc_data_ready(((atkbd_state_t *)kbd->kb_data)->kbdc);
687 /* read char from the keyboard */
689 atkbd_read_char(keyboard_t *kbd, int wait)
691 atkbd_state_t *state;
696 state = (atkbd_state_t *)kbd->kb_data;
698 /* do we have a composed char to return? */
699 if (!(state->ks_flags & COMPOSE) && (state->ks_composed_char > 0)) {
700 action = state->ks_composed_char;
701 state->ks_composed_char = 0;
702 if (action > UCHAR_MAX) {
708 /* see if there is something in the keyboard port */
711 scancode = read_kbd_data(state->kbdc);
712 } while (scancode == -1);
714 scancode = read_kbd_data_no_wait(state->kbdc);
715 if (scancode == -1) {
721 #if KBDIO_DEBUG >= 10
722 kprintf("atkbd_read_char(): scancode:0x%x\n", scancode);
725 /* push evdev event */
726 if (evdev_rcpt_mask & EVDEV_RCPT_HW_KBD && state->ks_evdev != NULL) {
727 /* "hancha" and "han/yong" korean keys handling */
728 if (state->ks_evdev_state == 0 &&
729 (scancode == 0xF1 || scancode == 0xF2)) {
730 keycode = evdev_scancode2key(&state->ks_evdev_state,
732 evdev_push_event(state->ks_evdev, EV_KEY,
733 (uint16_t)keycode, 1);
734 evdev_sync(state->ks_evdev);
737 keycode = evdev_scancode2key(&state->ks_evdev_state,
740 if (keycode != KEY_RESERVED) {
741 evdev_push_event(state->ks_evdev, EV_KEY,
742 (uint16_t)keycode, scancode & 0x80 ? 0 : 1);
743 evdev_sync(state->ks_evdev);
747 if (state->ks_evdev != NULL && evdev_is_grabbed(state->ks_evdev))
752 /* return the byte as is for the K_RAW mode */
753 if (state->ks_mode == K_RAW) {
757 /* translate the scan code into a keycode */
758 keycode = scancode & 0x7F;
759 switch (state->ks_prefix) {
760 case 0x00: /* normal scancode */
762 case 0xB8: /* left alt (compose key) released */
763 if (state->ks_flags & COMPOSE) {
764 state->ks_flags &= ~COMPOSE;
765 if (state->ks_composed_char > UCHAR_MAX)
766 state->ks_composed_char = 0;
769 case 0x38: /* left alt (compose key) pressed */
770 if (!(state->ks_flags & COMPOSE)) {
771 state->ks_flags |= COMPOSE;
772 state->ks_composed_char = 0;
777 state->ks_prefix = scancode;
781 case 0xE0: /* 0xE0 prefix */
782 state->ks_prefix = 0;
784 case 0x1C: /* right enter key */
787 case 0x1D: /* right ctrl key */
790 case 0x35: /* keypad divide key */
793 case 0x37: /* print scrn key */
796 case 0x38: /* right alt key (alt gr) */
799 case 0x46: /* ctrl-pause/break on AT 101 (see below) */
802 case 0x47: /* grey home key */
805 case 0x48: /* grey up arrow key */
808 case 0x49: /* grey page up key */
811 case 0x4B: /* grey left arrow key */
814 case 0x4D: /* grey right arrow key */
817 case 0x4F: /* grey end key */
820 case 0x50: /* grey down arrow key */
823 case 0x51: /* grey page down key */
826 case 0x52: /* grey insert key */
829 case 0x53: /* grey delete key */
832 /* the following 3 are only used on the MS "Natural" keyboard */
833 case 0x5b: /* left Window key */
836 case 0x5c: /* right Window key */
839 case 0x5d: /* menu key */
842 case 0x5e: /* power key */
845 case 0x5f: /* sleep key */
848 case 0x63: /* wake key */
851 default: /* ignore everything else */
855 case 0xE1: /* 0xE1 prefix */
857 * The pause/break key on the 101 keyboard produces:
859 * Ctrl-pause/break produces:
860 * E0-46 E0-C6 (See above.)
862 state->ks_prefix = 0;
864 state->ks_prefix = 0x1D;
867 case 0x1D: /* pause / break */
868 state->ks_prefix = 0;
875 if (kbd->kb_type == KB_84) {
877 case 0x37: /* *(numpad)/print screen */
878 if (state->ks_flags & SHIFTS)
879 keycode = 0x5c; /* print screen */
881 case 0x45: /* num lock/pause */
882 if (state->ks_flags & CTLS)
883 keycode = 0x68; /* pause */
885 case 0x46: /* scroll lock/break */
886 if (state->ks_flags & CTLS)
887 keycode = 0x6c; /* break */
890 } else if (kbd->kb_type == KB_101) {
892 case 0x5c: /* print screen */
893 if (state->ks_flags & ALTS)
894 keycode = 0x54; /* sysrq */
896 case 0x68: /* pause/break */
897 if (state->ks_flags & CTLS)
898 keycode = 0x6c; /* break */
903 /* return the key code in the K_CODE mode */
904 if (state->ks_mode == K_CODE) {
905 return (keycode | (scancode & 0x80));
908 /* compose a character code */
909 if (state->ks_flags & COMPOSE) {
910 switch (keycode | (scancode & 0x80)) {
911 /* key pressed, process it */
912 case 0x47: case 0x48: case 0x49: /* keypad 7,8,9 */
913 state->ks_composed_char *= 10;
914 state->ks_composed_char += keycode - 0x40;
915 if (state->ks_composed_char > UCHAR_MAX)
918 case 0x4B: case 0x4C: case 0x4D: /* keypad 4,5,6 */
919 state->ks_composed_char *= 10;
920 state->ks_composed_char += keycode - 0x47;
921 if (state->ks_composed_char > UCHAR_MAX)
924 case 0x4F: case 0x50: case 0x51: /* keypad 1,2,3 */
925 state->ks_composed_char *= 10;
926 state->ks_composed_char += keycode - 0x4E;
927 if (state->ks_composed_char > UCHAR_MAX)
930 case 0x52: /* keypad 0 */
931 state->ks_composed_char *= 10;
932 if (state->ks_composed_char > UCHAR_MAX)
936 /* key released, no interest here */
937 case 0xC7: case 0xC8: case 0xC9: /* keypad 7,8,9 */
938 case 0xCB: case 0xCC: case 0xCD: /* keypad 4,5,6 */
939 case 0xCF: case 0xD0: case 0xD1: /* keypad 1,2,3 */
940 case 0xD2: /* keypad 0 */
943 case 0x38: /* left alt key */
947 if (state->ks_composed_char > 0) {
948 state->ks_flags &= ~COMPOSE;
949 state->ks_composed_char = 0;
956 /* keycode to key action */
957 action = genkbd_keyaction(kbd, keycode, scancode & 0x80,
958 &state->ks_state, &state->ks_accents);
959 if (action == NOKEY) {
966 /* check if char is waiting */
968 atkbd_check_char(keyboard_t *kbd)
970 atkbd_state_t *state;
972 if (!KBD_IS_ACTIVE(kbd)) {
975 state = (atkbd_state_t *)kbd->kb_data;
976 if (!(state->ks_flags & COMPOSE) && (state->ks_composed_char > 0)) {
979 return kbdc_data_ready(state->kbdc);
982 /* some useful control functions */
984 atkbd_ioctl(keyboard_t *kbd, u_long cmd, caddr_t arg)
986 /* translate LED_XXX bits into the device specific bits */
987 static u_char ledmap[8] = {
988 0, 4, 2, 6, 1, 5, 3, 7,
990 atkbd_state_t *state = kbd->kb_data;
998 case KDGKBMODE: /* get keyboard mode */
999 *(int *)arg = state->ks_mode;
1001 case KDSKBMODE: /* set keyboard mode */
1002 switch (*(int *)arg) {
1004 if (state->ks_mode != K_XLATE) {
1005 /* make lock key state and LED state match */
1006 state->ks_state &= ~LOCK_MASK;
1007 state->ks_state |= KBD_LED_VAL(kbd);
1012 if (state->ks_mode != *(int *)arg) {
1013 atkbd_clear_state(kbd);
1014 state->ks_mode = *(int *)arg;
1023 case KDGETLED: /* get keyboard LED */
1024 *(int *)arg = KBD_LED_VAL(kbd);
1026 case KDSETLED: /* set keyboard LED */
1027 /* NOTE: lock key state in ks_state won't be changed */
1028 if (*(int *)arg & ~LOCK_MASK) {
1033 /* replace CAPS LED with ALTGR LED for ALTGR keyboards */
1034 if (state->ks_mode == K_XLATE &&
1035 kbd->kb_keymap->n_keys > ALTGR_OFFSET) {
1041 if (KBD_HAS_DEVICE(kbd)) {
1042 error = write_kbd(state->kbdc, KBDC_SET_LEDS,
1043 ledmap[i & LED_MASK]);
1049 #ifdef EVDEV_SUPPORT
1050 /* push LED states to evdev */
1051 if (state->ks_evdev != NULL &&
1052 evdev_rcpt_mask & EVDEV_RCPT_HW_KBD)
1053 evdev_push_leds(state->ks_evdev, *(int *)arg);
1055 KBD_LED_VAL(kbd) = *(int *)arg;
1058 case KDGKBSTATE: /* get lock key state */
1059 *(int *)arg = state->ks_state & LOCK_MASK;
1061 case KDSKBSTATE: /* set lock key state */
1062 if (*(int *)arg & ~LOCK_MASK) {
1066 state->ks_state &= ~LOCK_MASK;
1067 state->ks_state |= *(int *)arg;
1069 /* set LEDs and quit */
1070 return atkbd_ioctl(kbd, KDSETLED, arg);
1072 case KDSETREPEAT: /* set keyboard repeat rate (new interface) */
1074 if (!KBD_HAS_DEVICE(kbd)) {
1077 i = typematic(((int *)arg)[0], ((int *)arg)[1]);
1078 error = write_kbd(state->kbdc, KBDC_SET_TYPEMATIC, i);
1080 kbd->kb_delay1 = typematic_delay(i);
1081 kbd->kb_delay2 = typematic_rate(i);
1082 #ifdef EVDEV_SUPPORT
1083 if (state->ks_evdev != NULL &&
1084 evdev_rcpt_mask & EVDEV_RCPT_HW_KBD)
1085 evdev_push_repeats(state->ks_evdev, kbd);
1090 #if 0 /* obsolete */
1091 case KDSETRAD: /* set keyboard repeat rate (old interface) */
1093 if (!KBD_HAS_DEVICE(kbd))
1095 error = write_kbd(state->kbdc, KBDC_SET_TYPEMATIC, *(int *)arg);
1097 kbd->kb_delay1 = typematic_delay(*(int *)arg);
1098 kbd->kb_delay2 = typematic_rate(*(int *)arg);
1099 #ifdef EVDEV_SUPPORT
1100 if (state->ks_evdev != NULL &&
1101 evdev_rcpt_mask & EVDEV_RCPT_HW_KBD)
1102 evdev_push_repeats(state->ks_evdev, kbd);
1108 case PIO_KEYMAP: /* set keyboard translation table */
1109 case PIO_KEYMAPENT: /* set keyboard translation table entry */
1110 case PIO_DEADKEYMAP: /* set accent key translation table */
1111 state->ks_accents = 0;
1115 return genkbd_commonioctl(kbd, cmd, arg);
1122 /* lock the access to the keyboard */
1124 atkbd_lock(keyboard_t *kbd, int lock)
1126 return kbdc_lock(((atkbd_state_t *)kbd->kb_data)->kbdc, lock);
1129 /* clear the internal state of the keyboard */
1131 atkbd_clear_state(keyboard_t *kbd)
1133 atkbd_state_t *state;
1135 state = (atkbd_state_t *)kbd->kb_data;
1136 state->ks_flags = 0;
1137 state->ks_polling = 0;
1138 state->ks_state &= LOCK_MASK; /* preserve locking key state */
1139 state->ks_accents = 0;
1140 state->ks_composed_char = 0;
1142 state->ks_prefix = 0; /* XXX */
1146 /* save the internal state */
1148 atkbd_get_state(keyboard_t *kbd, void *buf, size_t len)
1151 return sizeof(atkbd_state_t);
1152 if (len < sizeof(atkbd_state_t))
1155 bcopy(kbd->kb_data, buf, sizeof(atkbd_state_t));
1159 /* set the internal state */
1161 atkbd_set_state(keyboard_t *kbd, void *buf, size_t len)
1163 if (len < sizeof(atkbd_state_t))
1165 if (((atkbd_state_t *)kbd->kb_data)->kbdc
1166 != ((atkbd_state_t *)buf)->kbdc)
1168 bcopy(buf, kbd->kb_data, sizeof(atkbd_state_t));
1173 atkbd_poll(keyboard_t *kbd, int on)
1175 atkbd_state_t *state;
1177 state = (atkbd_state_t *)kbd->kb_data;
1180 state->ks_polling = 1;
1182 state->ks_polling = 0;
1188 atkbd_reset(KBDC kbdc, int flags, int c)
1190 /* reset keyboard hardware */
1191 if (!(flags & KB_CONF_NO_RESET) && !reset_kbd(kbdc)) {
1194 * Keyboard reset may fail either because the keyboard
1195 * doen't exist, or because the keyboard doesn't pass
1196 * the self-test, or the keyboard controller on the
1197 * motherboard and the keyboard somehow fail to shake hands.
1198 * It is just possible, particularly in the last case,
1199 * that the keyboard controller may be left in a hung state.
1200 * test_controller() and test_kbd_port() appear to bring
1201 * the keyboard controller back (I don't know why and how,
1204 empty_both_buffers(kbdc, 10);
1205 test_controller(kbdc);
1206 test_kbd_port(kbdc);
1208 * We could disable the keyboard port and interrupt... but,
1209 * the keyboard may still exist (see above).
1211 set_controller_command_byte(kbdc,
1212 ALLOW_DISABLE_KBD(kbdc) ? 0xff : KBD_KBD_CONTROL_BITS, c);
1214 kprintf("atkbd: failed to reset the keyboard.\n");
1220 #ifdef EVDEV_SUPPORT
1222 atkbd_ev_event(struct evdev_dev *evdev, uint16_t type, uint16_t code,
1225 keyboard_t *kbd = evdev_get_softc(evdev);
1227 if (evdev_rcpt_mask & EVDEV_RCPT_HW_KBD &&
1228 (type == EV_LED || type == EV_REP)) {
1230 * NOTE: the current data writing part of kbd_ev_event() and its calls
1231 * kbd_ioctl() performs a lockmgr lock per the KBD_LOCK macro,
1232 * so unlike FreeBSD we don't lock here.
1234 * Should the data writes in kbd_ev_event(), which is a completely FreeBSD ported
1235 * function, ever change to encompass things outside of kbd_ioctl,
1236 * then this needs to be redesigned or rethought, possibly by:
1238 * setting a lockmgr(&kbd->kb_lock, LK_EXCLUSIVE)
1239 * saving the KB_POLLING flag of kbd->kb_flags
1241 * doing our stuff in kbd_ev_event()
1242 * and restoring the original KB_POLLING FLAG afterwards
1243 * releasing the lockmgr() held lock
1245 * KBD_LOCK defined at sys/dev/misc/kbd/kbdreg.h:137
1246 * and works by checking if KB_POLLING is not set.
1247 * This would obviously be quite a hack, if it were needed.
1248 * Note by htse (harald.brinkhof@gmail.com).
1250 #if defined(__FreeBSD__)
1253 #if defined(__DragonFly__) && 0
1254 if(!lockmgr(&kbd->kb_lock, LK_EXCLUSIVE)) {
1255 /* save original flag */
1256 int orig_is_polled = KBD_IS_POLLED(kbd);
1257 /* set state to polling */
1260 kbd_ev_event(kbd, type, code, value);
1261 #if defined(__FreeBSD__)
1264 #if defined(__DragonFly__) && 0
1265 /* restore original state if not polling */
1266 if(orig_is_polled == 0)
1269 lockmgr(&kbd->kb_lock, LK_RELEASE);
1276 /* local functions */
1279 set_typematic(keyboard_t *kbd)
1282 atkbd_state_t *state = kbd->kb_data;
1284 val = typematic(DEFAULT_DELAY, DEFAULT_RATE);
1285 error = write_kbd(state->kbdc, KBDC_SET_TYPEMATIC, val);
1287 kbd->kb_delay1 = typematic_delay(val);
1288 kbd->kb_delay2 = typematic_rate(val);
1295 setup_kbd_port(KBDC kbdc, int port, int intr)
1297 if (!set_controller_command_byte(kbdc,
1298 KBD_KBD_CONTROL_BITS,
1299 ((port) ? KBD_ENABLE_KBD_PORT : KBD_DISABLE_KBD_PORT)
1300 | ((intr) ? KBD_ENABLE_KBD_INT : KBD_DISABLE_KBD_INT)))
1306 get_kbd_echo(KBDC kbdc)
1308 /* enable the keyboard port, but disable the keyboard intr. */
1309 if (setup_kbd_port(kbdc, TRUE, FALSE))
1310 /* CONTROLLER ERROR: there is very little we can do... */
1313 /* see if something is present */
1314 write_kbd_command(kbdc, KBDC_ECHO);
1315 if (read_kbd_data(kbdc) != KBD_ECHO) {
1316 empty_both_buffers(kbdc, 10);
1317 test_controller(kbdc);
1318 test_kbd_port(kbdc);
1322 /* enable the keyboard port and intr. */
1323 if (setup_kbd_port(kbdc, TRUE, TRUE)) {
1326 * This is serious; the keyboard intr is left disabled!
1335 probe_keyboard(KBDC kbdc, int flags)
1338 * Don't try to print anything in this function. The low-level
1339 * console may not have been initialized yet...
1345 if (!kbdc_lock(kbdc, TRUE)) {
1351 * XXX block data transmission from the keyboard. This can cause
1352 * the keyboard to stop sending keystrokes even when re-enabled
1353 * under certain circumstances if not followed by a full reset.
1355 write_controller_command(kbdc, KBDC_DISABLE_KBD_PORT);
1357 /* flush any noise in the buffer */
1358 empty_both_buffers(kbdc, 100);
1360 /* save the current keyboard controller command byte */
1361 m = kbdc_get_device_mask(kbdc) & ~KBD_KBD_CONTROL_BITS;
1362 c = get_controller_command_byte(kbdc);
1364 /* CONTROLLER ERROR */
1365 kbdc_set_device_mask(kbdc, m);
1366 kbdc_lock(kbdc, FALSE);
1371 * The keyboard may have been screwed up by the boot block.
1372 * We may just be able to recover from error by testing the controller
1373 * and the keyboard port. The controller command byte needs to be
1374 * saved before this recovery operation, as some controllers seem
1375 * to set the command byte to particular values.
1377 test_controller(kbdc);
1378 if (!(flags & KB_CONF_NO_PROBE_TEST))
1379 test_kbd_port(kbdc);
1381 err = get_kbd_echo(kbdc);
1384 * Even if the keyboard doesn't seem to be present (err != 0),
1385 * we shall enable the keyboard port and interrupt so that
1386 * the driver will be operable when the keyboard is attached
1387 * to the system later. It is NOT recommended to hot-plug
1388 * the AT keyboard, but many people do so...
1390 kbdc_set_device_mask(kbdc, m | KBD_KBD_CONTROL_BITS);
1391 setup_kbd_port(kbdc, TRUE, TRUE);
1394 kbdc_set_device_mask(kbdc, m | KBD_KBD_CONTROL_BITS);
1396 /* try to restore the command byte as before */
1397 set_controller_command_byte(kbdc,
1398 ALLOW_DISABLE_KBD(kbdc) ? 0xff : KBD_KBD_CONTROL_BITS, c);
1399 kbdc_set_device_mask(kbdc, m);
1403 kbdc_lock(kbdc, FALSE);
1404 return (HAS_QUIRK(kbdc, KBDC_QUIRK_IGNORE_PROBE_RESULT) ? 0 : err);
1408 init_keyboard(KBDC kbdc, int *type, int flags)
1414 if (!kbdc_lock(kbdc, TRUE)) {
1420 * XXX block data transmission from the keyboard. This can cause
1421 * the keyboard to stop sending keystrokes even when re-enabled
1422 * under certain circumstances if not followed by a full reset.
1424 write_controller_command(kbdc, KBDC_DISABLE_KBD_PORT);
1427 /* save the current controller command byte */
1428 empty_both_buffers(kbdc, 200);
1429 c = get_controller_command_byte(kbdc);
1431 /* CONTROLLER ERROR */
1432 kbdc_lock(kbdc, FALSE);
1433 kprintf("atkbd: unable to get the current command byte value.\n");
1437 kprintf("atkbd: the current kbd controller command byte %04x\n",
1440 /* override the keyboard lock switch */
1441 c |= KBD_OVERRIDE_KBD_LOCK;
1444 /* enable the keyboard port, but disable the keyboard intr. */
1445 if (setup_kbd_port(kbdc, TRUE, FALSE)) {
1446 /* CONTROLLER ERROR: there is very little we can do... */
1447 kprintf("atkbd: unable to set the command byte.\n");
1448 kbdc_lock(kbdc, FALSE);
1452 if (HAS_QUIRK(kbdc, KBDC_QUIRK_RESET_AFTER_PROBE) &&
1453 atkbd_reset(kbdc, flags, c)) {
1454 kbdc_lock(kbdc, FALSE);
1459 * Check if we have an XT keyboard before we attempt to reset it.
1460 * The procedure assumes that the keyboard and the controller have
1461 * been set up properly by BIOS and have not been messed up
1462 * during the boot process.
1465 if (flags & KB_CONF_ALT_SCANCODESET)
1466 /* the user says there is a XT keyboard */
1468 #ifdef KBD_DETECT_XT_KEYBOARD
1469 else if ((c & KBD_TRANSLATION) == 0) {
1470 /* SET_SCANCODE_SET is not always supported; ignore error */
1471 if (send_kbd_command_and_data(kbdc, KBDC_SET_SCANCODE_SET, 0)
1473 codeset = read_kbd_data(kbdc);
1475 #endif /* KBD_DETECT_XT_KEYBOARD */
1477 kprintf("atkbd: scancode set %d\n", codeset);
1480 * Get the keyboard id.
1483 id = get_kbd_id(kbdc);
1485 case 0x41ab: /* 101/102/... Enhanced */
1486 case 0x83ab: /* ditto */
1487 case 0x54ab: /* SpaceSaver */
1488 case 0x84ab: /* ditto */
1490 case 0x90ab: /* 'G' */
1491 case 0x91ab: /* 'P' */
1492 case 0x92ab: /* 'A' */
1496 case -1: /* AT 84 keyboard doesn't return ID */
1503 kprintf("atkbd: keyboard ID 0x%x (%d)\n", id, *type);
1505 if (!HAS_QUIRK(kbdc, KBDC_QUIRK_RESET_AFTER_PROBE) &&
1506 atkbd_reset(kbdc, flags, c)) {
1507 kbdc_lock(kbdc, FALSE);
1512 * Allow us to set the XT_KEYBD flag so that keyboards
1513 * such as those on the IBM ThinkPad laptop computers can be used
1514 * with the standard console driver.
1517 if (send_kbd_command_and_data(kbdc,
1518 KBDC_SET_SCANCODE_SET, codeset) == KBD_ACK) {
1519 /* XT kbd doesn't need scan code translation */
1520 c &= ~KBD_TRANSLATION;
1524 * The XT kbd isn't usable unless the proper scan
1525 * code set is selected.
1527 set_controller_command_byte(kbdc, ALLOW_DISABLE_KBD(kbdc)
1528 ? 0xff : KBD_KBD_CONTROL_BITS, c);
1529 kbdc_lock(kbdc, FALSE);
1530 kprintf("atkbd: unable to set the XT keyboard mode.\n");
1536 * Some keyboards require a SETLEDS command to be sent after
1537 * the reset command before they will send keystrokes to us
1540 if (HAS_QUIRK(kbdc, KBDC_QUIRK_SETLEDS_ON_INIT) &&
1541 send_kbd_command_and_data(kbdc, KBDC_SET_LEDS, 0) != KBD_ACK) {
1542 kprintf("atkbd: setleds failed\n");
1550 kprintf("atkbd: waiting for keypress");
1551 for (retry = 0; retry < 10; ++retry) {
1552 c = read_kbd_data_no_wait(kbdc);
1554 tsleep(&c, 0, "wait", hz);
1559 if (!ALLOW_DISABLE_KBD(kbdc))
1560 send_kbd_command(kbdc, KBDC_ENABLE_KBD);
1562 /* enable the keyboard port and intr. */
1563 if (!set_controller_command_byte(kbdc,
1564 KBD_KBD_CONTROL_BITS | KBD_TRANSLATION | KBD_OVERRIDE_KBD_LOCK,
1565 (c & (KBD_TRANSLATION | KBD_OVERRIDE_KBD_LOCK))
1566 | KBD_ENABLE_KBD_PORT | KBD_ENABLE_KBD_INT)) {
1569 * This is serious; we are left with the disabled
1572 set_controller_command_byte(kbdc, ALLOW_DISABLE_KBD(kbdc)
1573 ? 0xff : (KBD_KBD_CONTROL_BITS | KBD_TRANSLATION |
1574 KBD_OVERRIDE_KBD_LOCK), c);
1575 kbdc_lock(kbdc, FALSE);
1576 kprintf("atkbd: unable to enable the keyboard port and intr.\n");
1580 kbdc_lock(kbdc, FALSE);
1585 write_kbd(KBDC kbdc, int command, int data)
1587 /* prevent the timeout routine from polling the keyboard */
1588 if (!kbdc_lock(kbdc, TRUE))
1591 /* disable the keyboard and mouse interrupt */
1596 * XXX NOTE: We can't just disable the KBD port any more, even
1597 * temporarily, without blowing up some BIOS emulations
1598 * if not followed by a full reset.
1600 c = get_controller_command_byte(kbdc);
1602 || !set_controller_command_byte(kbdc,
1603 kbdc_get_device_mask(kbdc),
1604 KBD_DISABLE_KBD_PORT | KBD_DISABLE_KBD_INT
1605 | KBD_DISABLE_AUX_PORT | KBD_DISABLE_AUX_INT)) {
1606 /* CONTROLLER ERROR */
1607 kbdc_lock(kbdc, FALSE);
1612 * Now that the keyboard controller is told not to generate
1613 * the keyboard and mouse interrupts, call `splx()' to allow
1614 * the other tty interrupts. The clock interrupt may also occur,
1615 * but the timeout routine (`scrn_timer()') will be blocked
1616 * by the lock flag set via `kbdc_lock()'
1621 if (send_kbd_command_and_data(kbdc, command, data) != KBD_ACK)
1622 send_kbd_command(kbdc, KBDC_ENABLE_KBD);
1625 /* restore the interrupts */
1626 if (!set_controller_command_byte(kbdc, kbdc_get_device_mask(kbdc),
1627 c & (KBD_KBD_CONTROL_BITS | KBD_AUX_CONTROL_BITS))) {
1628 /* CONTROLLER ERROR */
1633 kbdc_lock(kbdc, FALSE);
1639 get_kbd_id(KBDC kbdc)
1643 empty_both_buffers(kbdc, 10);
1645 if (send_kbd_command(kbdc, KBDC_SEND_DEV_ID) != KBD_ACK)
1648 DELAY(10000); /* 10 msec delay */
1649 id1 = read_kbd_data(kbdc);
1651 id2 = read_kbd_data(kbdc);
1653 if ((id1 == -1) || (id2 == -1)) {
1654 empty_both_buffers(kbdc, 10);
1655 test_controller(kbdc);
1656 test_kbd_port(kbdc);
1659 return ((id2 << 8) | id1);
1662 static int kbdelays[] = { 250, 500, 750, 1000 };
1663 static int kbrates[] = { 34, 38, 42, 46, 50, 55, 59, 63,
1664 68, 76, 84, 92, 100, 110, 118, 126,
1665 136, 152, 168, 184, 200, 220, 236, 252,
1666 272, 304, 336, 368, 400, 440, 472, 504 };
1669 typematic_delay(int i)
1671 return (kbdelays[(i >> 5) & 3]);
1675 typematic_rate(int i)
1677 return (kbrates[i & 0x1f]);
1681 typematic(int delay, int rate)
1686 for (i = nitems(kbdelays) - 1; i > 0; --i) {
1687 if (delay >= kbdelays[i])
1691 for (i = nitems(kbrates) - 1; i > 0; --i) {
1692 if (rate >= kbrates[i])