2 __FBSDID("$FreeBSD: head/sys/dev/usb/input/ukbd.c 262972 2014-03-10 08:52:30Z hselasky $");
6 * Copyright (c) 1998 The NetBSD Foundation, Inc.
9 * This code is derived from software contributed to The NetBSD Foundation
10 * by Lennart Augustsson (lennart@augustsson.net) at
11 * Carlstedt Research & Technology.
13 * Redistribution and use in source and binary forms, with or without
14 * modification, are permitted provided that the following conditions
16 * 1. Redistributions of source code must retain the above copyright
17 * notice, this list of conditions and the following disclaimer.
18 * 2. Redistributions in binary form must reproduce the above copyright
19 * notice, this list of conditions and the following disclaimer in the
20 * documentation and/or other materials provided with the distribution.
22 * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
23 * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
24 * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
25 * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
26 * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
27 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
28 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
29 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
30 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
31 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
32 * POSSIBILITY OF SUCH DAMAGE.
37 * HID spec: http://www.usb.org/developers/devclass_docs/HID1_11.pdf
43 #include <sys/stdint.h>
44 #include <sys/param.h>
45 #include <sys/queue.h>
46 #include <sys/types.h>
47 #include <sys/systm.h>
48 #include <sys/kernel.h>
50 #include <sys/module.h>
52 #include <sys/condvar.h>
53 #include <sys/sysctl.h>
54 #include <sys/unistd.h>
55 #include <sys/callout.h>
56 #include <sys/malloc.h>
59 #include <sys/sched.h>
60 #include <sys/thread2.h>
62 #include <bus/u4b/usb.h>
63 #include <bus/u4b/usbdi.h>
64 #include <bus/u4b/usbdi_util.h>
65 #include <bus/u4b/usbhid.h>
67 #define USB_DEBUG_VAR ukbd_debug
68 #include <bus/u4b/usb_debug.h>
70 #include <bus/u4b/quirk/usb_quirk.h>
72 #include <sys/ioccom.h>
73 #include <sys/filio.h>
77 #include <dev/misc/kbd/kbdreg.h>
79 /* the initial key map, accent map and fkey strings */
80 #if defined(UKBD_DFLT_KEYMAP) && !defined(KLD_MODULE)
81 #define KBD_DFLT_KEYMAP
85 /* the following file must be included after "ukbdmap.h" */
86 #include <dev/misc/kbd/kbdtables.h>
89 static int ukbd_debug
= 0;
90 static int ukbd_no_leds
= 0;
91 static int ukbd_pollrate
= 0;
93 static SYSCTL_NODE(_hw_usb
, OID_AUTO
, ukbd
, CTLFLAG_RW
, 0, "USB keyboard");
94 SYSCTL_INT(_hw_usb_ukbd
, OID_AUTO
, debug
, CTLFLAG_RW
,
95 &ukbd_debug
, 0, "Debug level");
96 SYSCTL_INT(_hw_usb_ukbd
, OID_AUTO
, no_leds
, CTLFLAG_RW
,
97 &ukbd_no_leds
, 0, "Disables setting of keyboard leds");
98 SYSCTL_INT(_hw_usb_ukbd
, OID_AUTO
, pollrate
, CTLFLAG_RW
,
99 &ukbd_pollrate
, 0, "Force this polling rate, 1-1000Hz");
101 TUNABLE_INT("hw.usb.ukbd.debug", &ukbd_debug
);
102 TUNABLE_INT("hw.usb.ukbd.no_leds", &ukbd_no_leds
);
103 TUNABLE_INT("hw.usb.ukbd.pollrate", &ukbd_pollrate
);
106 #define UKBD_EMULATE_ATSCANCODE 1
107 #define UKBD_DRIVER_NAME "ukbd"
108 #define UKBD_NMOD 8 /* units */
109 #define UKBD_NKEYCODE 6 /* units */
110 #define UKBD_IN_BUF_SIZE (2*(UKBD_NMOD + (2*UKBD_NKEYCODE))) /* bytes */
111 #define UKBD_IN_BUF_FULL (UKBD_IN_BUF_SIZE / 2) /* bytes */
112 #define UKBD_NFKEY (sizeof(fkey_tab)/sizeof(fkey_tab[0])) /* units */
113 #define UKBD_BUFFER_SIZE 64 /* bytes */
117 #define MOD_CONTROL_L 0x01
118 #define MOD_CONTROL_R 0x10
119 #define MOD_SHIFT_L 0x02
120 #define MOD_SHIFT_R 0x20
121 #define MOD_ALT_L 0x04
122 #define MOD_ALT_R 0x40
123 #define MOD_WIN_L 0x08
124 #define MOD_WIN_R 0x80
126 #define MOD_EJECT 0x0100
127 #define MOD_FN 0x0200
128 uint8_t keycode
[UKBD_NKEYCODE
];
141 accentmap_t sc_accmap
;
142 fkeytab_t sc_fkeymap
[UKBD_NFKEY
];
143 struct hid_location sc_loc_apple_eject
;
144 struct hid_location sc_loc_apple_fn
;
145 struct hid_location sc_loc_ctrl_l
;
146 struct hid_location sc_loc_ctrl_r
;
147 struct hid_location sc_loc_shift_l
;
148 struct hid_location sc_loc_shift_r
;
149 struct hid_location sc_loc_alt_l
;
150 struct hid_location sc_loc_alt_r
;
151 struct hid_location sc_loc_win_l
;
152 struct hid_location sc_loc_win_r
;
153 struct hid_location sc_loc_events
;
154 struct hid_location sc_loc_numlock
;
155 struct hid_location sc_loc_capslock
;
156 struct hid_location sc_loc_scrolllock
;
157 struct usb_callout sc_callout
;
158 struct ukbd_data sc_ndata
;
159 struct ukbd_data sc_odata
;
161 struct thread
*sc_poll_thread
;
162 struct usb_device
*sc_udev
;
163 struct usb_interface
*sc_iface
;
164 struct usb_xfer
*sc_xfer
[UKBD_N_TRANSFER
];
166 uint32_t sc_ntime
[UKBD_NKEYCODE
];
167 uint32_t sc_otime
[UKBD_NKEYCODE
];
168 uint32_t sc_input
[UKBD_IN_BUF_SIZE
]; /* input buffer */
170 uint32_t sc_composed_char
; /* composed char code, if non-zero */
171 #ifdef UKBD_EMULATE_ATSCANCODE
172 uint32_t sc_buffered_char
[2];
174 uint32_t sc_flags
; /* flags */
175 #define UKBD_FLAG_COMPOSE 0x00000001
176 #define UKBD_FLAG_POLLING 0x00000002
177 #define UKBD_FLAG_SET_LEDS 0x00000004
178 #define UKBD_FLAG_ATTACHED 0x00000010
179 #define UKBD_FLAG_GONE 0x00000020
181 #define UKBD_FLAG_HID_MASK 0x003fffc0
182 #define UKBD_FLAG_APPLE_EJECT 0x00000040
183 #define UKBD_FLAG_APPLE_FN 0x00000080
184 #define UKBD_FLAG_APPLE_SWAP 0x00000100
185 #define UKBD_FLAG_TIMER_RUNNING 0x00000200
186 #define UKBD_FLAG_CTRL_L 0x00000400
187 #define UKBD_FLAG_CTRL_R 0x00000800
188 #define UKBD_FLAG_SHIFT_L 0x00001000
189 #define UKBD_FLAG_SHIFT_R 0x00002000
190 #define UKBD_FLAG_ALT_L 0x00004000
191 #define UKBD_FLAG_ALT_R 0x00008000
192 #define UKBD_FLAG_WIN_L 0x00010000
193 #define UKBD_FLAG_WIN_R 0x00020000
194 #define UKBD_FLAG_EVENTS 0x00040000
195 #define UKBD_FLAG_NUMLOCK 0x00080000
196 #define UKBD_FLAG_CAPSLOCK 0x00100000
197 #define UKBD_FLAG_SCROLLLOCK 0x00200000
199 int sc_mode
; /* input mode (K_XLATE,K_RAW,K_CODE) */
200 int sc_state
; /* shift/lock key state */
201 int sc_accents
; /* accent key index (> 0) */
206 uint16_t sc_inputhead
;
207 uint16_t sc_inputtail
;
208 uint16_t sc_modifiers
;
210 uint8_t sc_leds
; /* store for async led requests */
211 uint8_t sc_iface_index
;
213 uint8_t sc_id_apple_eject
;
214 uint8_t sc_id_apple_fn
;
215 uint8_t sc_id_ctrl_l
;
216 uint8_t sc_id_ctrl_r
;
217 uint8_t sc_id_shift_l
;
218 uint8_t sc_id_shift_r
;
224 uint8_t sc_id_numlock
;
225 uint8_t sc_id_capslock
;
226 uint8_t sc_id_scrolllock
;
227 uint8_t sc_id_events
;
230 uint8_t sc_buffer
[UKBD_BUFFER_SIZE
];
233 #define KEY_ERROR 0x01
236 #define KEY_RELEASE 0x400
237 #define KEY_INDEX(c) ((c) & 0xFF)
240 #define SCAN_RELEASE 0x80
241 #define SCAN_PREFIX_E0 0x100
242 #define SCAN_PREFIX_E1 0x200
243 #define SCAN_PREFIX_CTL 0x400
244 #define SCAN_PREFIX_SHIFT 0x800
245 #define SCAN_PREFIX (SCAN_PREFIX_E0 | SCAN_PREFIX_E1 | \
246 SCAN_PREFIX_CTL | SCAN_PREFIX_SHIFT)
247 #define SCAN_CHAR(c) ((c) & 0x7f)
249 #define UKBD_LOCK(sc) lockmgr(&(sc)->sc_kbd.kb_lock, LK_EXCLUSIVE)
250 #define UKBD_UNLOCK(sc) lockmgr(&(sc)->sc_kbd.kb_lock, LK_RELEASE)
255 * Assert that the lock is held in all contexts
256 * where the code can be executed.
258 #define UKBD_LOCK_ASSERT()
261 * Assert that the lock is held in the contexts
262 * where it really has to be so.
264 #define UKBD_CTX_LOCK_ASSERT()
267 #define UKBD_LOCK_ASSERT() (void)0
268 #define UKBD_CTX_LOCK_ASSERT() (void)0
276 static const struct ukbd_mods ukbd_mods
[UKBD_NMOD
] = {
277 {MOD_CONTROL_L
, 0xe0},
278 {MOD_CONTROL_R
, 0xe4},
287 #define NN 0 /* no translation */
289 * Translate USB keycodes to AT keyboard scancodes.
292 * FIXME: Mac USB keyboard generates:
293 * 0x53: keypad NumLock/Clear
300 static const uint8_t ukbd_trtab
[256] = {
301 0, 0, 0, 0, 30, 48, 46, 32, /* 00 - 07 */
302 18, 33, 34, 35, 23, 36, 37, 38, /* 08 - 0F */
303 50, 49, 24, 25, 16, 19, 31, 20, /* 10 - 17 */
304 22, 47, 17, 45, 21, 44, 2, 3, /* 18 - 1F */
305 4, 5, 6, 7, 8, 9, 10, 11, /* 20 - 27 */
306 28, 1, 14, 15, 57, 12, 13, 26, /* 28 - 2F */
307 27, 43, 43, 39, 40, 41, 51, 52, /* 30 - 37 */
308 53, 58, 59, 60, 61, 62, 63, 64, /* 38 - 3F */
309 65, 66, 67, 68, 87, 88, 92, 70, /* 40 - 47 */
310 104, 102, 94, 96, 103, 99, 101, 98, /* 48 - 4F */
311 97, 100, 95, 69, 91, 55, 74, 78,/* 50 - 57 */
312 89, 79, 80, 81, 75, 76, 77, 71, /* 58 - 5F */
313 72, 73, 82, 83, 86, 107, 122, NN
, /* 60 - 67 */
314 NN
, NN
, NN
, NN
, NN
, NN
, NN
, NN
, /* 68 - 6F */
315 NN
, NN
, NN
, NN
, 115, 108, 111, 113, /* 70 - 77 */
316 109, 110, 112, 118, 114, 116, 117, 119, /* 78 - 7F */
317 121, 120, NN
, NN
, NN
, NN
, NN
, 123, /* 80 - 87 */
318 124, 125, 126, 127, 128, NN
, NN
, NN
, /* 88 - 8F */
319 NN
, NN
, NN
, NN
, NN
, NN
, NN
, NN
, /* 90 - 97 */
320 NN
, NN
, NN
, NN
, NN
, NN
, NN
, NN
, /* 98 - 9F */
321 NN
, NN
, NN
, NN
, NN
, NN
, NN
, NN
, /* A0 - A7 */
322 NN
, NN
, NN
, NN
, NN
, NN
, NN
, NN
, /* A8 - AF */
323 NN
, NN
, NN
, NN
, NN
, NN
, NN
, NN
, /* B0 - B7 */
324 NN
, NN
, NN
, NN
, NN
, NN
, NN
, NN
, /* B8 - BF */
325 NN
, NN
, NN
, NN
, NN
, NN
, NN
, NN
, /* C0 - C7 */
326 NN
, NN
, NN
, NN
, NN
, NN
, NN
, NN
, /* C8 - CF */
327 NN
, NN
, NN
, NN
, NN
, NN
, NN
, NN
, /* D0 - D7 */
328 NN
, NN
, NN
, NN
, NN
, NN
, NN
, NN
, /* D8 - DF */
329 29, 42, 56, 105, 90, 54, 93, 106, /* E0 - E7 */
330 NN
, NN
, NN
, NN
, NN
, NN
, NN
, NN
, /* E8 - EF */
331 NN
, NN
, NN
, NN
, NN
, NN
, NN
, NN
, /* F0 - F7 */
332 NN
, NN
, NN
, NN
, NN
, NN
, NN
, NN
, /* F8 - FF */
335 static const uint8_t ukbd_boot_desc
[] = {
336 0x05, 0x01, 0x09, 0x06, 0xa1,
337 0x01, 0x05, 0x07, 0x19, 0xe0,
338 0x29, 0xe7, 0x15, 0x00, 0x25,
339 0x01, 0x75, 0x01, 0x95, 0x08,
340 0x81, 0x02, 0x95, 0x01, 0x75,
341 0x08, 0x81, 0x01, 0x95, 0x03,
342 0x75, 0x01, 0x05, 0x08, 0x19,
343 0x01, 0x29, 0x03, 0x91, 0x02,
344 0x95, 0x05, 0x75, 0x01, 0x91,
345 0x01, 0x95, 0x06, 0x75, 0x08,
346 0x15, 0x00, 0x26, 0xff, 0x00,
347 0x05, 0x07, 0x19, 0x00, 0x2a,
348 0xff, 0x00, 0x81, 0x00, 0xc0
352 static void ukbd_timeout(void *);
353 static void ukbd_set_leds(struct ukbd_softc
*, uint8_t);
354 #ifdef UKBD_EMULATE_ATSCANCODE
355 static int ukbd_key2scan(struct ukbd_softc
*, int, int, int);
357 static uint32_t ukbd_read_char(keyboard_t
*, int);
358 static void ukbd_clear_state(keyboard_t
*);
359 static int ukbd_ioctl(keyboard_t
*, u_long
, caddr_t
);
360 static int ukbd_enable(keyboard_t
*);
361 static int ukbd_disable(keyboard_t
*);
362 static void ukbd_interrupt(struct ukbd_softc
*);
363 static void ukbd_event_keyinput(struct ukbd_softc
*);
365 static device_probe_t ukbd_probe
;
366 static device_attach_t ukbd_attach
;
367 static device_detach_t ukbd_detach
;
368 static device_resume_t ukbd_resume
;
371 ukbd_any_key_pressed(struct ukbd_softc
*sc
)
376 for (j
= i
= 0; i
< UKBD_NKEYCODE
; i
++)
377 j
|= sc
->sc_odata
.keycode
[i
];
383 ukbd_start_timer(struct ukbd_softc
*sc
)
385 sc
->sc_flags
|= UKBD_FLAG_TIMER_RUNNING
;
386 usb_callout_reset(&sc
->sc_callout
, hz
/ 40, &ukbd_timeout
, sc
);
390 ukbd_put_key(struct ukbd_softc
*sc
, uint32_t key
)
393 UKBD_CTX_LOCK_ASSERT();
395 DPRINTF("0x%02x (%d) %s\n", key
, key
,
396 (key
& KEY_RELEASE
) ? "released" : "pressed");
398 if (sc
->sc_inputs
< UKBD_IN_BUF_SIZE
) {
399 sc
->sc_input
[sc
->sc_inputtail
] = key
;
401 ++(sc
->sc_inputtail
);
402 if (sc
->sc_inputtail
>= UKBD_IN_BUF_SIZE
) {
403 sc
->sc_inputtail
= 0;
406 DPRINTF("input buffer is full\n");
411 ukbd_do_poll(struct ukbd_softc
*sc
, uint8_t wait
)
414 UKBD_CTX_LOCK_ASSERT();
415 KASSERT((sc
->sc_flags
& UKBD_FLAG_POLLING
) != 0,
416 ("ukbd_do_poll called when not polling\n"));
417 DPRINTFN(2, "polling\n");
419 if (!kdb_active
&& !SCHEDULER_STOPPED()) {
421 * In this context the kernel is polling for input,
422 * but the USB subsystem works in normal interrupt-driven
423 * mode, so we just wait on the USB threads to do the job.
424 * Note that we currently hold the Giant, but it's also used
425 * as the transfer mtx, so we must release it while waiting.
427 while (sc
->sc_inputs
== 0) {
429 * Give USB threads a chance to run. Note that
430 * kern_yield performs DROP_GIANT + PICKUP_GIANT.
440 while (sc
->sc_inputs
== 0) {
442 usbd_transfer_poll(sc
->sc_xfer
, UKBD_N_TRANSFER
);
444 /* Delay-optimised support for repetition of keys */
445 if (ukbd_any_key_pressed(sc
)) {
446 /* a key is pressed - need timekeeping */
449 /* 1 millisecond has passed */
461 ukbd_get_key(struct ukbd_softc
*sc
, uint8_t wait
)
465 UKBD_CTX_LOCK_ASSERT();
467 KASSERT((!kdb_active
&& !SCHEDULER_STOPPED())
468 || (sc
->sc_flags
& UKBD_FLAG_POLLING
) != 0,
469 ("not polling in kdb or panic\n"));
472 if (sc
->sc_inputs
== 0 &&
473 (sc
->sc_flags
& UKBD_FLAG_GONE
) == 0) {
474 /* start transfer, if not already started */
475 usbd_transfer_start(sc
->sc_xfer
[UKBD_INTR_DT
]);
478 if (sc
->sc_flags
& UKBD_FLAG_POLLING
)
479 ukbd_do_poll(sc
, wait
);
481 if (sc
->sc_inputs
== 0) {
484 c
= sc
->sc_input
[sc
->sc_inputhead
];
486 ++(sc
->sc_inputhead
);
487 if (sc
->sc_inputhead
>= UKBD_IN_BUF_SIZE
) {
488 sc
->sc_inputhead
= 0;
495 ukbd_interrupt(struct ukbd_softc
*sc
)
499 uint32_t now
= sc
->sc_time_ms
;
505 UKBD_CTX_LOCK_ASSERT();
507 if (sc
->sc_ndata
.keycode
[0] == KEY_ERROR
)
510 n_mod
= sc
->sc_ndata
.modifiers
;
511 o_mod
= sc
->sc_odata
.modifiers
;
512 if (n_mod
!= o_mod
) {
513 for (i
= 0; i
< UKBD_NMOD
; i
++) {
514 if ((n_mod
& ukbd_mods
[i
].mask
) !=
515 (o_mod
& ukbd_mods
[i
].mask
)) {
516 ukbd_put_key(sc
, ukbd_mods
[i
].key
|
517 ((n_mod
& ukbd_mods
[i
].mask
) ?
518 KEY_PRESS
: KEY_RELEASE
));
522 /* Check for released keys. */
523 for (i
= 0; i
< UKBD_NKEYCODE
; i
++) {
524 key
= sc
->sc_odata
.keycode
[i
];
528 for (j
= 0; j
< UKBD_NKEYCODE
; j
++) {
529 if (sc
->sc_ndata
.keycode
[j
] == 0) {
532 if (key
== sc
->sc_ndata
.keycode
[j
]) {
536 ukbd_put_key(sc
, key
| KEY_RELEASE
);
540 /* Check for pressed keys. */
541 for (i
= 0; i
< UKBD_NKEYCODE
; i
++) {
542 key
= sc
->sc_ndata
.keycode
[i
];
546 sc
->sc_ntime
[i
] = now
+ sc
->sc_kbd
.kb_delay1
;
547 for (j
= 0; j
< UKBD_NKEYCODE
; j
++) {
548 if (sc
->sc_odata
.keycode
[j
] == 0) {
551 if (key
== sc
->sc_odata
.keycode
[j
]) {
553 /* key is still pressed */
555 sc
->sc_ntime
[i
] = sc
->sc_otime
[j
];
556 dtime
= (sc
->sc_otime
[j
] - now
);
558 if (!(dtime
& 0x80000000)) {
559 /* time has not elapsed */
562 sc
->sc_ntime
[i
] = now
+ sc
->sc_kbd
.kb_delay2
;
566 ukbd_put_key(sc
, key
| KEY_PRESS
);
569 * If any other key is presently down, force its repeat to be
570 * well in the future (100s). This makes the last key to be
571 * pressed do the autorepeat.
573 for (j
= 0; j
!= UKBD_NKEYCODE
; j
++) {
575 sc
->sc_ntime
[j
] = now
+ (100 * 1000);
580 sc
->sc_odata
= sc
->sc_ndata
;
582 memcpy(sc
->sc_otime
, sc
->sc_ntime
, sizeof(sc
->sc_otime
));
584 ukbd_event_keyinput(sc
);
588 ukbd_event_keyinput(struct ukbd_softc
*sc
)
592 UKBD_CTX_LOCK_ASSERT();
594 if ((sc
->sc_flags
& UKBD_FLAG_POLLING
) != 0)
597 if (sc
->sc_inputs
== 0)
600 if (KBD_IS_ACTIVE(&sc
->sc_kbd
) &&
601 KBD_IS_BUSY(&sc
->sc_kbd
)) {
602 /* let the callback function process the input */
603 (sc
->sc_kbd
.kb_callback
.kc_func
) (&sc
->sc_kbd
, KBDIO_KEYINPUT
,
604 sc
->sc_kbd
.kb_callback
.kc_arg
);
606 /* read and discard the input, no one is waiting for it */
608 c
= ukbd_read_char(&sc
->sc_kbd
, 0);
609 } while (c
!= NOKEY
);
614 ukbd_timeout(void *arg
)
616 struct ukbd_softc
*sc
= arg
;
620 sc
->sc_time_ms
+= 25; /* milliseconds */
624 /* Make sure any leftover key events gets read out */
625 ukbd_event_keyinput(sc
);
627 if (ukbd_any_key_pressed(sc
) || (sc
->sc_inputs
!= 0)) {
628 ukbd_start_timer(sc
);
630 sc
->sc_flags
&= ~UKBD_FLAG_TIMER_RUNNING
;
635 ukbd_apple_fn(uint8_t keycode
) {
637 case 0x28: return 0x49; /* RETURN -> INSERT */
638 case 0x2a: return 0x4c; /* BACKSPACE -> DEL */
639 case 0x50: return 0x4a; /* LEFT ARROW -> HOME */
640 case 0x4f: return 0x4d; /* RIGHT ARROW -> END */
641 case 0x52: return 0x4b; /* UP ARROW -> PGUP */
642 case 0x51: return 0x4e; /* DOWN ARROW -> PGDN */
643 default: return keycode
;
648 ukbd_apple_swap(uint8_t keycode
) {
650 case 0x35: return 0x64;
651 case 0x64: return 0x35;
652 default: return keycode
;
657 ukbd_intr_callback(struct usb_xfer
*xfer
, usb_error_t error
)
659 struct ukbd_softc
*sc
= usbd_xfer_softc(xfer
);
660 struct usb_page_cache
*pc
;
668 usbd_xfer_status(xfer
, &len
, NULL
, NULL
, NULL
);
669 pc
= usbd_xfer_get_frame(xfer
, 0);
671 switch (USB_GET_STATE(xfer
)) {
672 case USB_ST_TRANSFERRED
:
673 DPRINTF("actlen=%d bytes\n", len
);
676 DPRINTF("zero length data\n");
680 if (sc
->sc_kbd_id
!= 0) {
681 /* check and remove HID ID byte */
682 usbd_copy_out(pc
, 0, &id
, 1);
686 DPRINTF("zero length data\n");
694 if (len
> UKBD_BUFFER_SIZE
)
695 len
= UKBD_BUFFER_SIZE
;
698 usbd_copy_out(pc
, offset
, sc
->sc_buffer
, len
);
700 /* clear temporary storage */
701 memset(&sc
->sc_ndata
, 0, sizeof(sc
->sc_ndata
));
703 /* scan through HID data */
704 if ((sc
->sc_flags
& UKBD_FLAG_APPLE_EJECT
) &&
705 (id
== sc
->sc_id_apple_eject
)) {
706 if (hid_get_data(sc
->sc_buffer
, len
, &sc
->sc_loc_apple_eject
))
707 sc
->sc_modifiers
|= MOD_EJECT
;
709 sc
->sc_modifiers
&= ~MOD_EJECT
;
711 if ((sc
->sc_flags
& UKBD_FLAG_APPLE_FN
) &&
712 (id
== sc
->sc_id_apple_fn
)) {
713 if (hid_get_data(sc
->sc_buffer
, len
, &sc
->sc_loc_apple_fn
))
714 sc
->sc_modifiers
|= MOD_FN
;
716 sc
->sc_modifiers
&= ~MOD_FN
;
718 if ((sc
->sc_flags
& UKBD_FLAG_CTRL_L
) &&
719 (id
== sc
->sc_id_ctrl_l
)) {
720 if (hid_get_data(sc
->sc_buffer
, len
, &sc
->sc_loc_ctrl_l
))
721 sc
-> sc_modifiers
|= MOD_CONTROL_L
;
723 sc
-> sc_modifiers
&= ~MOD_CONTROL_L
;
725 if ((sc
->sc_flags
& UKBD_FLAG_CTRL_R
) &&
726 (id
== sc
->sc_id_ctrl_r
)) {
727 if (hid_get_data(sc
->sc_buffer
, len
, &sc
->sc_loc_ctrl_r
))
728 sc
->sc_modifiers
|= MOD_CONTROL_R
;
730 sc
->sc_modifiers
&= ~MOD_CONTROL_R
;
732 if ((sc
->sc_flags
& UKBD_FLAG_SHIFT_L
) &&
733 (id
== sc
->sc_id_shift_l
)) {
734 if (hid_get_data(sc
->sc_buffer
, len
, &sc
->sc_loc_shift_l
))
735 sc
->sc_modifiers
|= MOD_SHIFT_L
;
737 sc
->sc_modifiers
&= ~MOD_SHIFT_L
;
739 if ((sc
->sc_flags
& UKBD_FLAG_SHIFT_R
) &&
740 (id
== sc
->sc_id_shift_r
)) {
741 if (hid_get_data(sc
->sc_buffer
, len
, &sc
->sc_loc_shift_r
))
742 sc
->sc_modifiers
|= MOD_SHIFT_R
;
744 sc
->sc_modifiers
&= ~MOD_SHIFT_R
;
746 if ((sc
->sc_flags
& UKBD_FLAG_ALT_L
) &&
747 (id
== sc
->sc_id_alt_l
)) {
748 if (hid_get_data(sc
->sc_buffer
, len
, &sc
->sc_loc_alt_l
))
749 sc
->sc_modifiers
|= MOD_ALT_L
;
751 sc
->sc_modifiers
&= ~MOD_ALT_L
;
753 if ((sc
->sc_flags
& UKBD_FLAG_ALT_R
) &&
754 (id
== sc
->sc_id_alt_r
)) {
755 if (hid_get_data(sc
->sc_buffer
, len
, &sc
->sc_loc_alt_r
))
756 sc
->sc_modifiers
|= MOD_ALT_R
;
758 sc
->sc_modifiers
&= ~MOD_ALT_R
;
760 if ((sc
->sc_flags
& UKBD_FLAG_WIN_L
) &&
761 (id
== sc
->sc_id_win_l
)) {
762 if (hid_get_data(sc
->sc_buffer
, len
, &sc
->sc_loc_win_l
))
763 sc
->sc_modifiers
|= MOD_WIN_L
;
765 sc
->sc_modifiers
&= ~MOD_WIN_L
;
767 if ((sc
->sc_flags
& UKBD_FLAG_WIN_R
) &&
768 (id
== sc
->sc_id_win_r
)) {
769 if (hid_get_data(sc
->sc_buffer
, len
, &sc
->sc_loc_win_r
))
770 sc
->sc_modifiers
|= MOD_WIN_R
;
772 sc
->sc_modifiers
&= ~MOD_WIN_R
;
775 sc
->sc_ndata
.modifiers
= sc
->sc_modifiers
;
777 if ((sc
->sc_flags
& UKBD_FLAG_EVENTS
) &&
778 (id
== sc
->sc_id_events
)) {
779 i
= sc
->sc_loc_events
.count
;
780 if (i
> UKBD_NKEYCODE
)
785 sc
->sc_ndata
.keycode
[i
] =
786 hid_get_data(sc
->sc_buffer
+ i
, len
- i
,
792 DPRINTF("modifiers = 0x%04x\n", (int)sc
->sc_modifiers
);
793 for (i
= 0; i
< UKBD_NKEYCODE
; i
++) {
794 if (sc
->sc_ndata
.keycode
[i
]) {
795 DPRINTF("[%d] = 0x%02x\n",
796 (int)i
, (int)sc
->sc_ndata
.keycode
[i
]);
800 if (sc
->sc_modifiers
& MOD_FN
) {
801 for (i
= 0; i
< UKBD_NKEYCODE
; i
++) {
802 sc
->sc_ndata
.keycode
[i
] =
803 ukbd_apple_fn(sc
->sc_ndata
.keycode
[i
]);
807 if (sc
->sc_flags
& UKBD_FLAG_APPLE_SWAP
) {
808 for (i
= 0; i
< UKBD_NKEYCODE
; i
++) {
809 sc
->sc_ndata
.keycode
[i
] =
810 ukbd_apple_swap(sc
->sc_ndata
.keycode
[i
]);
816 if (!(sc
->sc_flags
& UKBD_FLAG_TIMER_RUNNING
)) {
817 if (ukbd_any_key_pressed(sc
)) {
818 ukbd_start_timer(sc
);
824 if (sc
->sc_inputs
< UKBD_IN_BUF_FULL
) {
825 usbd_xfer_set_frame_len(xfer
, 0, usbd_xfer_max_len(xfer
));
826 usbd_transfer_submit(xfer
);
828 DPRINTF("input queue is full!\n");
833 DPRINTF("error=%s\n", usbd_errstr(error
));
835 if (error
!= USB_ERR_CANCELLED
) {
836 /* try to clear stall first */
837 usbd_xfer_set_stall(xfer
);
845 ukbd_set_leds_callback(struct usb_xfer
*xfer
, usb_error_t error
)
847 struct ukbd_softc
*sc
= usbd_xfer_softc(xfer
);
848 struct usb_device_request req
;
849 struct usb_page_cache
*pc
;
861 switch (USB_GET_STATE(xfer
)) {
862 case USB_ST_TRANSFERRED
:
864 if (!(sc
->sc_flags
& UKBD_FLAG_SET_LEDS
))
866 sc
->sc_flags
&= ~UKBD_FLAG_SET_LEDS
;
868 req
.bmRequestType
= UT_WRITE_CLASS_INTERFACE
;
869 req
.bRequest
= UR_SET_REPORT
;
870 USETW2(req
.wValue
, UHID_OUTPUT_REPORT
, 0);
871 req
.wIndex
[0] = sc
->sc_iface_no
;
875 memset(sc
->sc_buffer
, 0, UKBD_BUFFER_SIZE
);
880 /* Assumption: All led bits must be in the same ID. */
882 if (sc
->sc_flags
& UKBD_FLAG_NUMLOCK
) {
883 if (sc
->sc_leds
& NLKED
) {
884 hid_put_data_unsigned(sc
->sc_buffer
+ 1, UKBD_BUFFER_SIZE
- 1,
885 &sc
->sc_loc_numlock
, 1);
887 id
= sc
->sc_id_numlock
;
891 if (sc
->sc_flags
& UKBD_FLAG_SCROLLLOCK
) {
892 if (sc
->sc_leds
& SLKED
) {
893 hid_put_data_unsigned(sc
->sc_buffer
+ 1, UKBD_BUFFER_SIZE
- 1,
894 &sc
->sc_loc_scrolllock
, 1);
896 id
= sc
->sc_id_scrolllock
;
900 if (sc
->sc_flags
& UKBD_FLAG_CAPSLOCK
) {
901 if (sc
->sc_leds
& CLKED
) {
902 hid_put_data_unsigned(sc
->sc_buffer
+ 1, UKBD_BUFFER_SIZE
- 1,
903 &sc
->sc_loc_capslock
, 1);
905 id
= sc
->sc_id_capslock
;
909 /* if no leds, nothing to do */
913 /* range check output report length */
914 len
= sc
->sc_led_size
;
915 if (len
> (UKBD_BUFFER_SIZE
- 1))
916 len
= (UKBD_BUFFER_SIZE
- 1);
918 /* check if we need to prefix an ID byte */
919 sc
->sc_buffer
[0] = id
;
921 pc
= usbd_xfer_get_frame(xfer
, 1);
924 usbd_copy_in(pc
, 0, sc
->sc_buffer
, len
);
926 usbd_copy_in(pc
, 0, sc
->sc_buffer
+ 1, len
);
928 req
.wLength
[0] = len
;
929 usbd_xfer_set_frame_len(xfer
, 1, len
);
931 DPRINTF("len=%d, id=%d\n", len
, id
);
933 /* setup control request last */
934 pc
= usbd_xfer_get_frame(xfer
, 0);
935 usbd_copy_in(pc
, 0, &req
, sizeof(req
));
936 usbd_xfer_set_frame_len(xfer
, 0, sizeof(req
));
938 /* start data transfer */
939 usbd_xfer_set_frames(xfer
, 2);
940 usbd_transfer_submit(xfer
);
944 DPRINTFN(1, "error=%s\n", usbd_errstr(error
));
949 static const struct usb_config ukbd_config
[UKBD_N_TRANSFER
] = {
952 .type
= UE_INTERRUPT
,
953 .endpoint
= UE_ADDR_ANY
,
954 .direction
= UE_DIR_IN
,
955 .flags
= {.pipe_bof
= 1,.short_xfer_ok
= 1,},
956 .bufsize
= 0, /* use wMaxPacketSize */
957 .callback
= &ukbd_intr_callback
,
962 .endpoint
= 0x00, /* Control pipe */
963 .direction
= UE_DIR_ANY
,
964 .bufsize
= sizeof(struct usb_device_request
) + UKBD_BUFFER_SIZE
,
965 .callback
= &ukbd_set_leds_callback
,
966 .timeout
= 1000, /* 1 second */
970 /* A match on these entries will load ukbd */
971 static const STRUCT_USB_HOST_ID __used ukbd_devs
[] = {
972 {USB_IFACE_CLASS(UICLASS_HID
),
973 USB_IFACE_SUBCLASS(UISUBCLASS_BOOT
),
974 USB_IFACE_PROTOCOL(UIPROTO_BOOT_KEYBOARD
),},
978 ukbd_probe(device_t dev
)
980 keyboard_switch_t
*sw
= kbd_get_switch(UKBD_DRIVER_NAME
);
981 struct usb_attach_arg
*uaa
= device_get_ivars(dev
);
992 if (uaa
->usb_mode
!= USB_MODE_HOST
) {
996 if (uaa
->info
.bInterfaceClass
!= UICLASS_HID
)
999 if (usb_test_quirk(uaa
, UQ_KBD_IGNORE
))
1002 if ((uaa
->info
.bInterfaceSubClass
== UISUBCLASS_BOOT
) &&
1003 (uaa
->info
.bInterfaceProtocol
== UIPROTO_BOOT_KEYBOARD
))
1004 return (BUS_PROBE_DEFAULT
);
1006 error
= usbd_req_get_hid_desc(uaa
->device
, NULL
,
1007 &d_ptr
, &d_len
, M_TEMP
, uaa
->info
.bIfaceIndex
);
1012 if (hid_is_keyboard(d_ptr
, d_len
)) {
1013 if (hid_is_mouse(d_ptr
, d_len
)) {
1015 * NOTE: We currently don't support USB mouse
1016 * and USB keyboard on the same USB endpoint.
1017 * Let "ums" driver win.
1021 error
= BUS_PROBE_DEFAULT
;
1026 kfree(d_ptr
, M_TEMP
);
1031 ukbd_parse_hid(struct ukbd_softc
*sc
, const uint8_t *ptr
, uint32_t len
)
1035 /* reset detected bits */
1036 sc
->sc_flags
&= ~UKBD_FLAG_HID_MASK
;
1038 /* check if there is an ID byte */
1039 sc
->sc_kbd_size
= hid_report_size(ptr
, len
,
1040 hid_input
, &sc
->sc_kbd_id
);
1042 /* investigate if this is an Apple Keyboard */
1043 if (hid_locate(ptr
, len
,
1044 HID_USAGE2(HUP_CONSUMER
, HUG_APPLE_EJECT
),
1045 hid_input
, 0, &sc
->sc_loc_apple_eject
, &flags
,
1046 &sc
->sc_id_apple_eject
)) {
1047 if (flags
& HIO_VARIABLE
)
1048 sc
->sc_flags
|= UKBD_FLAG_APPLE_EJECT
|
1049 UKBD_FLAG_APPLE_SWAP
;
1050 DPRINTFN(1, "Found Apple eject-key\n");
1052 if (hid_locate(ptr
, len
,
1053 HID_USAGE2(0xFFFF, 0x0003),
1054 hid_input
, 0, &sc
->sc_loc_apple_fn
, &flags
,
1055 &sc
->sc_id_apple_fn
)) {
1056 if (flags
& HIO_VARIABLE
)
1057 sc
->sc_flags
|= UKBD_FLAG_APPLE_FN
;
1058 DPRINTFN(1, "Found Apple FN-key\n");
1060 /* figure out some keys */
1061 if (hid_locate(ptr
, len
,
1062 HID_USAGE2(HUP_KEYBOARD
, 0xE0),
1063 hid_input
, 0, &sc
->sc_loc_ctrl_l
, &flags
,
1064 &sc
->sc_id_ctrl_l
)) {
1065 if (flags
& HIO_VARIABLE
)
1066 sc
->sc_flags
|= UKBD_FLAG_CTRL_L
;
1067 DPRINTFN(1, "Found left control\n");
1069 if (hid_locate(ptr
, len
,
1070 HID_USAGE2(HUP_KEYBOARD
, 0xE4),
1071 hid_input
, 0, &sc
->sc_loc_ctrl_r
, &flags
,
1072 &sc
->sc_id_ctrl_r
)) {
1073 if (flags
& HIO_VARIABLE
)
1074 sc
->sc_flags
|= UKBD_FLAG_CTRL_R
;
1075 DPRINTFN(1, "Found right control\n");
1077 if (hid_locate(ptr
, len
,
1078 HID_USAGE2(HUP_KEYBOARD
, 0xE1),
1079 hid_input
, 0, &sc
->sc_loc_shift_l
, &flags
,
1080 &sc
->sc_id_shift_l
)) {
1081 if (flags
& HIO_VARIABLE
)
1082 sc
->sc_flags
|= UKBD_FLAG_SHIFT_L
;
1083 DPRINTFN(1, "Found left shift\n");
1085 if (hid_locate(ptr
, len
,
1086 HID_USAGE2(HUP_KEYBOARD
, 0xE5),
1087 hid_input
, 0, &sc
->sc_loc_shift_r
, &flags
,
1088 &sc
->sc_id_shift_r
)) {
1089 if (flags
& HIO_VARIABLE
)
1090 sc
->sc_flags
|= UKBD_FLAG_SHIFT_R
;
1091 DPRINTFN(1, "Found right shift\n");
1093 if (hid_locate(ptr
, len
,
1094 HID_USAGE2(HUP_KEYBOARD
, 0xE2),
1095 hid_input
, 0, &sc
->sc_loc_alt_l
, &flags
,
1096 &sc
->sc_id_alt_l
)) {
1097 if (flags
& HIO_VARIABLE
)
1098 sc
->sc_flags
|= UKBD_FLAG_ALT_L
;
1099 DPRINTFN(1, "Found left alt\n");
1101 if (hid_locate(ptr
, len
,
1102 HID_USAGE2(HUP_KEYBOARD
, 0xE6),
1103 hid_input
, 0, &sc
->sc_loc_alt_r
, &flags
,
1104 &sc
->sc_id_alt_r
)) {
1105 if (flags
& HIO_VARIABLE
)
1106 sc
->sc_flags
|= UKBD_FLAG_ALT_R
;
1107 DPRINTFN(1, "Found right alt\n");
1109 if (hid_locate(ptr
, len
,
1110 HID_USAGE2(HUP_KEYBOARD
, 0xE3),
1111 hid_input
, 0, &sc
->sc_loc_win_l
, &flags
,
1112 &sc
->sc_id_win_l
)) {
1113 if (flags
& HIO_VARIABLE
)
1114 sc
->sc_flags
|= UKBD_FLAG_WIN_L
;
1115 DPRINTFN(1, "Found left GUI\n");
1117 if (hid_locate(ptr
, len
,
1118 HID_USAGE2(HUP_KEYBOARD
, 0xE7),
1119 hid_input
, 0, &sc
->sc_loc_win_r
, &flags
,
1120 &sc
->sc_id_win_r
)) {
1121 if (flags
& HIO_VARIABLE
)
1122 sc
->sc_flags
|= UKBD_FLAG_WIN_R
;
1123 DPRINTFN(1, "Found right GUI\n");
1125 /* figure out event buffer */
1126 if (hid_locate(ptr
, len
,
1127 HID_USAGE2(HUP_KEYBOARD
, 0x00),
1128 hid_input
, 0, &sc
->sc_loc_events
, &flags
,
1129 &sc
->sc_id_events
)) {
1130 if (flags
& HIO_VARIABLE
) {
1131 DPRINTFN(1, "Ignoring keyboard event control\n");
1133 sc
->sc_flags
|= UKBD_FLAG_EVENTS
;
1134 DPRINTFN(1, "Found keyboard event array\n");
1138 /* figure out leds on keyboard */
1139 sc
->sc_led_size
= hid_report_size(ptr
, len
,
1142 if (hid_locate(ptr
, len
,
1143 HID_USAGE2(HUP_LEDS
, 0x01),
1144 hid_output
, 0, &sc
->sc_loc_numlock
, &flags
,
1145 &sc
->sc_id_numlock
)) {
1146 if (flags
& HIO_VARIABLE
)
1147 sc
->sc_flags
|= UKBD_FLAG_NUMLOCK
;
1148 DPRINTFN(1, "Found keyboard numlock\n");
1150 if (hid_locate(ptr
, len
,
1151 HID_USAGE2(HUP_LEDS
, 0x02),
1152 hid_output
, 0, &sc
->sc_loc_capslock
, &flags
,
1153 &sc
->sc_id_capslock
)) {
1154 if (flags
& HIO_VARIABLE
)
1155 sc
->sc_flags
|= UKBD_FLAG_CAPSLOCK
;
1156 DPRINTFN(1, "Found keyboard capslock\n");
1158 if (hid_locate(ptr
, len
,
1159 HID_USAGE2(HUP_LEDS
, 0x03),
1160 hid_output
, 0, &sc
->sc_loc_scrolllock
, &flags
,
1161 &sc
->sc_id_scrolllock
)) {
1162 if (flags
& HIO_VARIABLE
)
1163 sc
->sc_flags
|= UKBD_FLAG_SCROLLLOCK
;
1164 DPRINTFN(1, "Found keyboard scrolllock\n");
1169 ukbd_attach(device_t dev
)
1171 struct ukbd_softc
*sc
= device_get_softc(dev
);
1172 struct usb_attach_arg
*uaa
= device_get_ivars(dev
);
1173 int32_t unit
= device_get_unit(dev
);
1174 keyboard_t
*kbd
= &sc
->sc_kbd
;
1175 void *hid_ptr
= NULL
;
1184 kbd_init_struct(kbd
, UKBD_DRIVER_NAME
, KB_OTHER
,
1185 unit
, 0, KB_PRI_USB
, 0, 0);
1187 kbd
->kb_data
= (void *)sc
;
1189 device_set_usb_desc(dev
);
1191 sc
->sc_udev
= uaa
->device
;
1192 sc
->sc_iface
= uaa
->iface
;
1193 sc
->sc_iface_index
= uaa
->info
.bIfaceIndex
;
1194 sc
->sc_iface_no
= uaa
->info
.bIfaceNum
;
1195 sc
->sc_mode
= K_XLATE
;
1197 usb_callout_init_mtx(&sc
->sc_callout
, &kbd
->kb_lock
, 0);
1199 err
= usbd_transfer_setup(uaa
->device
,
1200 &uaa
->info
.bIfaceIndex
, sc
->sc_xfer
, ukbd_config
,
1201 UKBD_N_TRANSFER
, sc
, &sc
->sc_kbd
.kb_lock
);
1204 DPRINTF("error=%s\n", usbd_errstr(err
));
1207 /* setup default keyboard maps */
1209 sc
->sc_keymap
= key_map
;
1210 sc
->sc_accmap
= accent_map
;
1211 for (n
= 0; n
< UKBD_NFKEY
; n
++) {
1212 sc
->sc_fkeymap
[n
] = fkey_tab
[n
];
1215 kbd_set_maps(kbd
, &sc
->sc_keymap
, &sc
->sc_accmap
,
1216 sc
->sc_fkeymap
, UKBD_NFKEY
);
1218 KBD_FOUND_DEVICE(kbd
);
1220 ukbd_clear_state(kbd
);
1223 * FIXME: set the initial value for lock keys in "sc_state"
1224 * according to the BIOS data?
1226 KBD_PROBE_DONE(kbd
);
1228 /* get HID descriptor */
1229 err
= usbd_req_get_hid_desc(uaa
->device
, NULL
, &hid_ptr
,
1230 &hid_len
, M_TEMP
, uaa
->info
.bIfaceIndex
);
1233 DPRINTF("Parsing HID descriptor of %d bytes\n",
1236 ukbd_parse_hid(sc
, hid_ptr
, hid_len
);
1238 kfree(hid_ptr
, M_TEMP
);
1241 /* check if we should use the boot protocol */
1242 if (usb_test_quirk(uaa
, UQ_KBD_BOOTPROTO
) ||
1243 (err
!= 0) || (!(sc
->sc_flags
& UKBD_FLAG_EVENTS
))) {
1245 DPRINTF("Forcing boot protocol\n");
1247 err
= usbd_req_set_protocol(sc
->sc_udev
, NULL
,
1248 sc
->sc_iface_index
, 0);
1251 DPRINTF("Set protocol error=%s (ignored)\n",
1255 ukbd_parse_hid(sc
, ukbd_boot_desc
, sizeof(ukbd_boot_desc
));
1258 /* ignore if SETIDLE fails, hence it is not crucial */
1259 usbd_req_set_idle(sc
->sc_udev
, NULL
, sc
->sc_iface_index
, 0, 0);
1261 ukbd_ioctl(kbd
, KDSETLED
, (caddr_t
)&sc
->sc_state
);
1265 if (kbd_register(kbd
) < 0) {
1268 KBD_CONFIG_DONE(kbd
);
1272 #ifdef KBD_INSTALL_CDEV
1273 if (kbd_attach(kbd
)) {
1277 sc
->sc_flags
|= UKBD_FLAG_ATTACHED
;
1280 genkbd_diag(kbd
, bootverbose
);
1284 /* check for polling rate override */
1285 rate
= ukbd_pollrate
;
1292 /* set new polling interval in ms */
1293 usbd_xfer_set_interval(sc
->sc_xfer
[UKBD_INTR_DT
], rate
);
1296 /* start the keyboard */
1297 /* XXX mp locking added */
1299 usbd_transfer_start(sc
->sc_xfer
[UKBD_INTR_DT
]);
1302 return (0); /* success */
1305 return (ENXIO
); /* error */
1309 ukbd_detach(device_t dev
)
1311 struct ukbd_softc
*sc
= device_get_softc(dev
);
1319 sc
->sc_flags
|= UKBD_FLAG_GONE
;
1321 usb_callout_stop(&sc
->sc_callout
);
1323 /* kill any stuck keys */
1324 if (sc
->sc_flags
& UKBD_FLAG_ATTACHED
) {
1325 /* stop receiving events from the USB keyboard */
1326 usbd_transfer_stop(sc
->sc_xfer
[UKBD_INTR_DT
]);
1328 /* release all leftover keys, if any */
1329 memset(&sc
->sc_ndata
, 0, sizeof(sc
->sc_ndata
));
1331 /* process releasing of all keys */
1335 ukbd_disable(&sc
->sc_kbd
);
1338 * XXX make sure this is in the correct place here,
1339 * it was taken from below the second if()
1341 usbd_transfer_unsetup(sc
->sc_xfer
, UKBD_N_TRANSFER
);
1342 usb_callout_drain(&sc
->sc_callout
);
1344 #ifdef KBD_INSTALL_CDEV
1345 if (sc
->sc_flags
& UKBD_FLAG_ATTACHED
) {
1346 error
= kbd_detach(&sc
->sc_kbd
);
1348 /* usb attach cannot return an error */
1349 device_printf(dev
, "WARNING: kbd_detach() "
1350 "returned non-zero! (ignored)\n");
1354 if (KBD_IS_CONFIGURED(&sc
->sc_kbd
)) {
1356 * kbd_unregister requires kb_lock to be held
1357 * but lockuninits it then
1360 error
= kbd_unregister(&sc
->sc_kbd
);
1362 /* usb attach cannot return an error */
1363 device_printf(dev
, "WARNING: kbd_unregister() "
1364 "returned non-zero! (ignored)\n");
1367 sc
->sc_kbd
.kb_flags
= 0;
1371 DPRINTF("%s: disconnected\n",
1372 device_get_nameunit(dev
));
1378 ukbd_resume(device_t dev
)
1380 struct ukbd_softc
*sc
= device_get_softc(dev
);
1384 ukbd_clear_state(&sc
->sc_kbd
);
1389 /* early keyboard probe, not supported */
1391 ukbd_configure(int flags
)
1396 /* detect a keyboard, not used */
1398 ukbd__probe(int unit
, void *arg
, int flags
)
1403 /* reset and initialize the device, not used */
1405 ukbd_init(int unit
, keyboard_t
**kbdp
, void *arg
, int flags
)
1410 /* test the interface to the device, not used */
1412 ukbd_test_if(keyboard_t
*kbd
)
1417 /* finish using this keyboard, not used */
1419 ukbd_term(keyboard_t
*kbd
)
1424 /* keyboard interrupt routine, not used */
1426 ukbd_intr(keyboard_t
*kbd
, void *arg
)
1431 /* lock the access to the keyboard, not used */
1433 ukbd_lock(keyboard_t
*kbd
, int lock
)
1439 * Enable the access to the device; until this function is called,
1440 * the client cannot read from the keyboard.
1443 ukbd_enable(keyboard_t
*kbd
)
1452 /* disallow the access to the device */
1454 ukbd_disable(keyboard_t
*kbd
)
1457 KBD_DEACTIVATE(kbd
);
1463 /* check if data is waiting */
1464 /* Currently unused. */
1466 ukbd_check(keyboard_t
*kbd
)
1468 struct ukbd_softc
*sc
= kbd
->kb_data
;
1470 UKBD_CTX_LOCK_ASSERT();
1472 if (!KBD_IS_ACTIVE(kbd
))
1475 if (sc
->sc_flags
& UKBD_FLAG_POLLING
)
1476 ukbd_do_poll(sc
, 0);
1478 #ifdef UKBD_EMULATE_ATSCANCODE
1479 if (sc
->sc_buffered_char
[0]) {
1483 if (sc
->sc_inputs
> 0) {
1489 /* check if char is waiting */
1491 ukbd_check_char_locked(keyboard_t
*kbd
)
1493 struct ukbd_softc
*sc
= kbd
->kb_data
;
1495 UKBD_CTX_LOCK_ASSERT();
1497 if (!KBD_IS_ACTIVE(kbd
))
1500 if ((sc
->sc_composed_char
> 0) &&
1501 (!(sc
->sc_flags
& UKBD_FLAG_COMPOSE
))) {
1504 return (ukbd_check(kbd
));
1508 ukbd_check_char(keyboard_t
*kbd
)
1512 struct ukbd_softc
*sc
= kbd
->kb_data
;
1516 result
= ukbd_check_char_locked(kbd
);
1524 /* read one byte from the keyboard if it's allowed */
1525 /* Currently unused. */
1527 ukbd_read(keyboard_t
*kbd
, int wait
)
1529 struct ukbd_softc
*sc
= kbd
->kb_data
;
1531 #ifdef UKBD_EMULATE_ATSCANCODE
1537 UKBD_CTX_LOCK_ASSERT();
1539 if (!KBD_IS_ACTIVE(kbd
))
1542 #ifdef UKBD_EMULATE_ATSCANCODE
1543 if (sc
->sc_buffered_char
[0]) {
1544 scancode
= sc
->sc_buffered_char
[0];
1545 if (scancode
& SCAN_PREFIX
) {
1546 sc
->sc_buffered_char
[0] &= ~SCAN_PREFIX
;
1547 return ((scancode
& SCAN_PREFIX_E0
) ? 0xe0 : 0xe1);
1549 sc
->sc_buffered_char
[0] = sc
->sc_buffered_char
[1];
1550 sc
->sc_buffered_char
[1] = 0;
1553 #endif /* UKBD_EMULATE_ATSCANCODE */
1556 usbcode
= ukbd_get_key(sc
, (wait
== FALSE
) ? 0 : 1);
1557 if (!KBD_IS_ACTIVE(kbd
) || (usbcode
== -1))
1562 #ifdef UKBD_EMULATE_ATSCANCODE
1563 keycode
= ukbd_trtab
[KEY_INDEX(usbcode
)];
1564 if (keycode
== NN
) {
1567 return (ukbd_key2scan(sc
, keycode
, sc
->sc_ndata
.modifiers
,
1568 (usbcode
& KEY_RELEASE
)));
1569 #else /* !UKBD_EMULATE_ATSCANCODE */
1571 #endif /* UKBD_EMULATE_ATSCANCODE */
1574 /* read char from the keyboard */
1576 ukbd_read_char_locked(keyboard_t
*kbd
, int wait
)
1578 struct ukbd_softc
*sc
= kbd
->kb_data
;
1582 #ifdef UKBD_EMULATE_ATSCANCODE
1586 UKBD_CTX_LOCK_ASSERT();
1588 if (!KBD_IS_ACTIVE(kbd
))
1593 /* do we have a composed char to return ? */
1595 if ((sc
->sc_composed_char
> 0) &&
1596 (!(sc
->sc_flags
& UKBD_FLAG_COMPOSE
))) {
1598 action
= sc
->sc_composed_char
;
1599 sc
->sc_composed_char
= 0;
1601 if (action
> 0xFF) {
1606 #ifdef UKBD_EMULATE_ATSCANCODE
1608 /* do we have a pending raw scan code? */
1610 if (sc
->sc_mode
== K_RAW
) {
1611 scancode
= sc
->sc_buffered_char
[0];
1613 if (scancode
& SCAN_PREFIX
) {
1614 sc
->sc_buffered_char
[0] = (scancode
& ~SCAN_PREFIX
);
1615 return ((scancode
& SCAN_PREFIX_E0
) ? 0xe0 : 0xe1);
1617 sc
->sc_buffered_char
[0] = sc
->sc_buffered_char
[1];
1618 sc
->sc_buffered_char
[1] = 0;
1622 #endif /* UKBD_EMULATE_ATSCANCODE */
1624 /* see if there is something in the keyboard port */
1626 usbcode
= ukbd_get_key(sc
, (wait
== FALSE
) ? 0 : 1);
1627 if (usbcode
== -1) {
1632 #ifdef UKBD_EMULATE_ATSCANCODE
1633 /* USB key index -> key code -> AT scan code */
1634 keycode
= ukbd_trtab
[KEY_INDEX(usbcode
)];
1635 if (keycode
== NN
) {
1638 /* return an AT scan code for the K_RAW mode */
1639 if (sc
->sc_mode
== K_RAW
) {
1640 return (ukbd_key2scan(sc
, keycode
, sc
->sc_ndata
.modifiers
,
1641 (usbcode
& KEY_RELEASE
)));
1643 #else /* !UKBD_EMULATE_ATSCANCODE */
1645 /* return the byte as is for the K_RAW mode */
1646 if (sc
->sc_mode
== K_RAW
) {
1649 /* USB key index -> key code */
1650 keycode
= ukbd_trtab
[KEY_INDEX(usbcode
)];
1651 if (keycode
== NN
) {
1654 #endif /* UKBD_EMULATE_ATSCANCODE */
1657 case 0x38: /* left alt (compose key) */
1658 if (usbcode
& KEY_RELEASE
) {
1659 if (sc
->sc_flags
& UKBD_FLAG_COMPOSE
) {
1660 sc
->sc_flags
&= ~UKBD_FLAG_COMPOSE
;
1662 if (sc
->sc_composed_char
> 0xFF) {
1663 sc
->sc_composed_char
= 0;
1667 if (!(sc
->sc_flags
& UKBD_FLAG_COMPOSE
)) {
1668 sc
->sc_flags
|= UKBD_FLAG_COMPOSE
;
1669 sc
->sc_composed_char
= 0;
1673 /* XXX: I don't like these... */
1674 case 0x5c: /* print screen */
1675 if (sc
->sc_flags
& ALTS
) {
1676 keycode
= 0x54; /* sysrq */
1679 case 0x68: /* pause/break */
1680 if (sc
->sc_flags
& CTLS
) {
1681 keycode
= 0x6c; /* break */
1686 /* return the key code in the K_CODE mode */
1687 if (usbcode
& KEY_RELEASE
) {
1688 keycode
|= SCAN_RELEASE
;
1690 if (sc
->sc_mode
== K_CODE
) {
1693 /* compose a character code */
1694 if (sc
->sc_flags
& UKBD_FLAG_COMPOSE
) {
1696 /* key pressed, process it */
1699 case 0x49: /* keypad 7,8,9 */
1700 sc
->sc_composed_char
*= 10;
1701 sc
->sc_composed_char
+= keycode
- 0x40;
1702 goto check_composed
;
1706 case 0x4D: /* keypad 4,5,6 */
1707 sc
->sc_composed_char
*= 10;
1708 sc
->sc_composed_char
+= keycode
- 0x47;
1709 goto check_composed
;
1713 case 0x51: /* keypad 1,2,3 */
1714 sc
->sc_composed_char
*= 10;
1715 sc
->sc_composed_char
+= keycode
- 0x4E;
1716 goto check_composed
;
1718 case 0x52: /* keypad 0 */
1719 sc
->sc_composed_char
*= 10;
1720 goto check_composed
;
1722 /* key released, no interest here */
1723 case SCAN_RELEASE
| 0x47:
1724 case SCAN_RELEASE
| 0x48:
1725 case SCAN_RELEASE
| 0x49: /* keypad 7,8,9 */
1726 case SCAN_RELEASE
| 0x4B:
1727 case SCAN_RELEASE
| 0x4C:
1728 case SCAN_RELEASE
| 0x4D: /* keypad 4,5,6 */
1729 case SCAN_RELEASE
| 0x4F:
1730 case SCAN_RELEASE
| 0x50:
1731 case SCAN_RELEASE
| 0x51: /* keypad 1,2,3 */
1732 case SCAN_RELEASE
| 0x52: /* keypad 0 */
1735 case 0x38: /* left alt key */
1739 if (sc
->sc_composed_char
> 0) {
1740 sc
->sc_flags
&= ~UKBD_FLAG_COMPOSE
;
1741 sc
->sc_composed_char
= 0;
1747 /* keycode to key action */
1748 action
= genkbd_keyaction(kbd
, SCAN_CHAR(keycode
),
1749 (keycode
& SCAN_RELEASE
),
1750 &sc
->sc_state
, &sc
->sc_accents
);
1751 if (action
== NOKEY
) {
1758 if (sc
->sc_composed_char
<= 0xFF) {
1765 /* Currently wait is always false. */
1767 ukbd_read_char(keyboard_t
*kbd
, int wait
)
1771 struct ukbd_softc
*sc
= kbd
->kb_data
;
1775 keycode
= ukbd_read_char_locked(kbd
, wait
);
1783 /* some useful control functions */
1785 ukbd_ioctl_locked(keyboard_t
*kbd
, u_long cmd
, caddr_t arg
)
1787 struct ukbd_softc
*sc
= kbd
->kb_data
;
1791 case KDGKBMODE
: /* get keyboard mode */
1792 *(int *)arg
= sc
->sc_mode
;
1794 case KDSKBMODE
: /* set keyboard mode */
1795 switch (*(int *)arg
) {
1797 if (sc
->sc_mode
!= K_XLATE
) {
1798 /* make lock key state and LED state match */
1799 sc
->sc_state
&= ~LOCK_MASK
;
1800 sc
->sc_state
|= KBD_LED_VAL(kbd
);
1805 if (sc
->sc_mode
!= *(int *)arg
) {
1806 if ((sc
->sc_flags
& UKBD_FLAG_POLLING
) == 0)
1807 ukbd_clear_state(kbd
);
1808 sc
->sc_mode
= *(int *)arg
;
1816 case KDGETLED
: /* get keyboard LED */
1817 *(int *)arg
= KBD_LED_VAL(kbd
);
1819 case KDSETLED
: /* set keyboard LED */
1820 /* NOTE: lock key state in "sc_state" won't be changed */
1821 if (*(int *)arg
& ~LOCK_MASK
)
1826 /* replace CAPS LED with ALTGR LED for ALTGR keyboards */
1827 if (sc
->sc_mode
== K_XLATE
&&
1828 kbd
->kb_keymap
->n_keys
> ALTGR_OFFSET
) {
1834 if (KBD_HAS_DEVICE(kbd
))
1835 ukbd_set_leds(sc
, i
);
1837 KBD_LED_VAL(kbd
) = *(int *)arg
;
1839 case KDGKBSTATE
: /* get lock key state */
1840 *(int *)arg
= sc
->sc_state
& LOCK_MASK
;
1842 case KDSKBSTATE
: /* set lock key state */
1843 if (*(int *)arg
& ~LOCK_MASK
) {
1846 sc
->sc_state
&= ~LOCK_MASK
;
1847 sc
->sc_state
|= *(int *)arg
;
1849 /* set LEDs and quit */
1850 return (ukbd_ioctl(kbd
, KDSETLED
, arg
));
1852 case KDSETREPEAT
: /* set keyboard repeat rate (new
1854 if (!KBD_HAS_DEVICE(kbd
)) {
1857 if (((int *)arg
)[1] < 0) {
1860 if (((int *)arg
)[0] < 0) {
1863 if (((int *)arg
)[0] < 200) /* fastest possible value */
1864 kbd
->kb_delay1
= 200;
1866 kbd
->kb_delay1
= ((int *)arg
)[0];
1867 kbd
->kb_delay2
= ((int *)arg
)[1];
1870 case PIO_KEYMAP
: /* set keyboard translation table */
1871 case PIO_KEYMAPENT
: /* set keyboard translation table
1873 case PIO_DEADKEYMAP
: /* set accent key translation table */
1877 return (genkbd_commonioctl(kbd
, cmd
, arg
));
1884 ukbd_ioctl(keyboard_t
*kbd
, u_long cmd
, caddr_t arg
)
1887 struct ukbd_softc
*sc
= kbd
->kb_data
;
1890 * XXX KDGKBSTATE, KDSKBSTATE and KDSETLED can be called from any
1891 * context where printf(9) can be called, which among other things
1892 * includes interrupt filters and threads with any kinds of locks
1893 * already held. For this reason it would be dangerous to acquire
1894 * the Giant here unconditionally. On the other hand we have to
1895 * have it to handle the ioctl.
1896 * So we make our best effort to auto-detect whether we can grab
1897 * the Giant or not. Blame syscons(4) for this.
1903 if(!lockowned(&kbd
->kb_lock
)) {
1904 return (EDEADLK
); /* best I could come up with */
1909 result
= ukbd_ioctl_locked(kbd
, cmd
, arg
);
1916 /* clear the internal state of the keyboard */
1918 ukbd_clear_state(keyboard_t
*kbd
)
1920 struct ukbd_softc
*sc
= kbd
->kb_data
;
1922 UKBD_CTX_LOCK_ASSERT();
1924 sc
->sc_flags
&= ~(UKBD_FLAG_COMPOSE
| UKBD_FLAG_POLLING
);
1925 sc
->sc_state
&= LOCK_MASK
; /* preserve locking key state */
1927 sc
->sc_composed_char
= 0;
1928 #ifdef UKBD_EMULATE_ATSCANCODE
1929 sc
->sc_buffered_char
[0] = 0;
1930 sc
->sc_buffered_char
[1] = 0;
1932 memset(&sc
->sc_ndata
, 0, sizeof(sc
->sc_ndata
));
1933 memset(&sc
->sc_odata
, 0, sizeof(sc
->sc_odata
));
1934 memset(&sc
->sc_ntime
, 0, sizeof(sc
->sc_ntime
));
1935 memset(&sc
->sc_otime
, 0, sizeof(sc
->sc_otime
));
1938 /* save the internal state, not used */
1940 ukbd_get_state(keyboard_t
*kbd
, void *buf
, size_t len
)
1942 return (len
== 0) ? 1 : -1;
1945 /* set the internal state, not used */
1947 ukbd_set_state(keyboard_t
*kbd
, void *buf
, size_t len
)
1953 ukbd_poll(keyboard_t
*kbd
, int on
)
1955 struct ukbd_softc
*sc
= kbd
->kb_data
;
1959 sc
->sc_flags
|= UKBD_FLAG_POLLING
;
1960 sc
->sc_poll_thread
= curthread
;
1962 sc
->sc_flags
&= ~UKBD_FLAG_POLLING
;
1963 ukbd_start_timer(sc
); /* start timer */
1970 /* local functions */
1973 ukbd_set_leds(struct ukbd_softc
*sc
, uint8_t leds
)
1976 DPRINTF("leds=0x%02x\n", leds
);
1979 sc
->sc_flags
|= UKBD_FLAG_SET_LEDS
;
1981 /* start transfer, if not already started */
1983 usbd_transfer_start(sc
->sc_xfer
[UKBD_CTRL_LED
]);
1986 #ifdef UKBD_EMULATE_ATSCANCODE
1988 ukbd_key2scan(struct ukbd_softc
*sc
, int code
, int shift
, int up
)
1990 static const int scan
[] = {
1996 0x137 | SCAN_PREFIX_SHIFT
, /* PrintScreen */
2006 0x151, /* PageDown */
2009 0x146, /* XXX Pause/Break */
2010 0x15b, /* Win_L(Super_L) */
2011 0x15c, /* Win_R(Super_R) */
2012 0x15d, /* Application(Menu) */
2014 /* SUN TYPE 6 USB KEYBOARD */
2015 0x168, /* Sun Type 6 Help */
2016 0x15e, /* Sun Type 6 Stop */
2018 0x15f, /* Sun Type 6 Again */
2019 0x160, /* Sun Type 6 Props */
2020 0x161, /* Sun Type 6 Undo */
2021 0x162, /* Sun Type 6 Front */
2022 0x163, /* Sun Type 6 Copy */
2023 0x164, /* Sun Type 6 Open */
2024 0x165, /* Sun Type 6 Paste */
2025 0x166, /* Sun Type 6 Find */
2026 0x167, /* Sun Type 6 Cut */
2027 0x125, /* Sun Type 6 Mute */
2029 0x11f, /* Sun Type 6 VolumeDown */
2030 0x11e, /* Sun Type 6 VolumeUp */
2031 0x120, /* Sun Type 6 PowerDown */
2033 /* Japanese 106/109 keyboard */
2034 0x73, /* Keyboard Intl' 1 (backslash / underscore) */
2035 0x70, /* Keyboard Intl' 2 (Katakana / Hiragana) */
2036 0x7d, /* Keyboard Intl' 3 (Yen sign) (Not using in jp106/109) */
2037 0x79, /* Keyboard Intl' 4 (Henkan) */
2038 0x7b, /* Keyboard Intl' 5 (Muhenkan) */
2039 0x5c, /* Keyboard Intl' 6 (Keypad ,) (For PC-9821 layout) */
2042 if ((code
>= 89) && (code
< (int)(89 + NELEM(scan
)))) {
2043 code
= scan
[code
- 89];
2046 if ((code
== 104) && (!(shift
& (MOD_CONTROL_L
| MOD_CONTROL_R
)))) {
2047 code
= (0x45 | SCAN_PREFIX_E1
| SCAN_PREFIX_CTL
);
2049 if (shift
& (MOD_SHIFT_L
| MOD_SHIFT_R
)) {
2050 code
&= ~SCAN_PREFIX_SHIFT
;
2052 code
|= (up
? SCAN_RELEASE
: SCAN_PRESS
);
2054 if (code
& SCAN_PREFIX
) {
2055 if (code
& SCAN_PREFIX_CTL
) {
2057 sc
->sc_buffered_char
[0] = (0x1d | (code
& SCAN_RELEASE
));
2058 sc
->sc_buffered_char
[1] = (code
& ~SCAN_PREFIX
);
2059 } else if (code
& SCAN_PREFIX_SHIFT
) {
2061 sc
->sc_buffered_char
[0] = (0x2a | (code
& SCAN_RELEASE
));
2062 sc
->sc_buffered_char
[1] = (code
& ~SCAN_PREFIX_SHIFT
);
2064 sc
->sc_buffered_char
[0] = (code
& ~SCAN_PREFIX
);
2065 sc
->sc_buffered_char
[1] = 0;
2067 return ((code
& SCAN_PREFIX_E0
) ? 0xe0 : 0xe1);
2073 #endif /* UKBD_EMULATE_ATSCANCODE */
2075 static keyboard_switch_t ukbdsw
= {
2076 .probe
= &ukbd__probe
,
2080 .test_if
= &ukbd_test_if
,
2081 .enable
= &ukbd_enable
,
2082 .disable
= &ukbd_disable
,
2084 .check
= &ukbd_check
,
2085 .read_char
= &ukbd_read_char
,
2086 .check_char
= &ukbd_check_char
,
2087 .ioctl
= &ukbd_ioctl
,
2089 .clear_state
= &ukbd_clear_state
,
2090 .get_state
= &ukbd_get_state
,
2091 .set_state
= &ukbd_set_state
,
2092 .get_fkeystr
= &genkbd_get_fkeystr
,
2094 .diag
= &genkbd_diag
,
2097 KEYBOARD_DRIVER(ukbd
, ukbdsw
, ukbd_configure
);
2100 ukbd_driver_load(module_t mod
, int what
, void *arg
)
2104 kbd_add_driver(&ukbd_kbd_driver
);
2107 kbd_delete_driver(&ukbd_kbd_driver
);
2113 static devclass_t ukbd_devclass
;
2115 static device_method_t ukbd_methods
[] = {
2116 DEVMETHOD(device_probe
, ukbd_probe
),
2117 DEVMETHOD(device_attach
, ukbd_attach
),
2118 DEVMETHOD(device_detach
, ukbd_detach
),
2119 DEVMETHOD(device_resume
, ukbd_resume
),
2123 static driver_t ukbd_driver
= {
2125 .methods
= ukbd_methods
,
2126 .size
= sizeof(struct ukbd_softc
),
2129 DRIVER_MODULE(ukbd
, uhub
, ukbd_driver
, ukbd_devclass
, ukbd_driver_load
, NULL
);
2130 MODULE_DEPEND(ukbd
, usb
, 1, 1, 1);
2131 MODULE_VERSION(ukbd
, 1);