xref: /netbsd/sys/dev/usb/ukbd.c (revision 326b918b)
1 /*      $NetBSD: ukbd.c,v 1.162 2023/01/10 18:20:10 mrg Exp $        */
2 
3 /*
4  * Copyright (c) 1998 The NetBSD Foundation, Inc.
5  * All rights reserved.
6  *
7  * This code is derived from software contributed to The NetBSD Foundation
8  * by Lennart Augustsson (lennart@augustsson.net) at
9  * Carlstedt Research & Technology.
10  *
11  * Redistribution and use in source and binary forms, with or without
12  * modification, are permitted provided that the following conditions
13  * are met:
14  * 1. Redistributions of source code must retain the above copyright
15  *    notice, this list of conditions and the following disclaimer.
16  * 2. Redistributions in binary form must reproduce the above copyright
17  *    notice, this list of conditions and the following disclaimer in the
18  *    documentation and/or other materials provided with the distribution.
19  *
20  * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
21  * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
22  * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
23  * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
24  * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
25  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
26  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
27  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
28  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
29  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
30  * POSSIBILITY OF SUCH DAMAGE.
31  */
32 
33 /*
34  * HID spec: http://www.usb.org/developers/devclass_docs/HID1_11.pdf
35  */
36 
37 #include <sys/cdefs.h>
38 __KERNEL_RCSID(0, "$NetBSD: ukbd.c,v 1.162 2023/01/10 18:20:10 mrg Exp $");
39 
40 #ifdef _KERNEL_OPT
41 #include "opt_ddb.h"
42 #include "opt_ukbd.h"
43 #include "opt_ukbd_layout.h"
44 #include "opt_usb.h"
45 #include "opt_usbverbose.h"
46 #include "opt_wsdisplay_compat.h"
47 #endif /* _KERNEL_OPT */
48 
49 #include <sys/param.h>
50 #include <sys/systm.h>
51 #include <sys/callout.h>
52 #include <sys/kernel.h>
53 #include <sys/device.h>
54 #include <sys/ioctl.h>
55 #include <sys/file.h>
56 #include <sys/select.h>
57 #include <sys/proc.h>
58 #include <sys/vnode.h>
59 #include <sys/poll.h>
60 
61 #include <dev/usb/usb.h>
62 #include <dev/usb/usbhid.h>
63 
64 #include <dev/usb/usbdi.h>
65 #include <dev/usb/usbdi_util.h>
66 #include <dev/usb/usbdivar.h>
67 #include <dev/usb/usbdevs.h>
68 #include <dev/usb/usb_quirks.h>
69 #include <dev/usb/uhidev.h>
70 #include <dev/usb/ukbdvar.h>
71 #include <dev/hid/hid.h>
72 
73 #include <dev/wscons/wsconsio.h>
74 #include <dev/wscons/wskbdvar.h>
75 #include <dev/wscons/wsksymdef.h>
76 #include <dev/wscons/wsksymvar.h>
77 
78 #ifdef UKBD_DEBUG
79 #define DPRINTF(x)	if (ukbddebug) printf x
80 #define DPRINTFN(n,x)	if (ukbddebug>(n)) printf x
81 int	ukbddebug = 0;
82 #else
83 #define DPRINTF(x)
84 #define DPRINTFN(n,x)
85 #endif
86 
87 #define MAXKEYCODE 32
88 #define MAXKEYS 256
89 
90 struct ukbd_data {
91 	uint8_t		keys[MAXKEYS/NBBY];
92 };
93 
94 #define PRESS    0x000
95 #define RELEASE  0x100
96 #define CODEMASK 0x0ff
97 
98 struct ukbd_keycodetrans {
99 	uint16_t	from;
100 	uint16_t	to;
101 };
102 
103 #define IS_PMF	0x8000
104 
105 Static const struct ukbd_keycodetrans trtab_apple_fn[] = {
106 	{ 0x0c, 0x5d },	/* i -> KP 5 */
107 	{ 0x0d, 0x59 },	/* j -> KP 1 */
108 	{ 0x0e, 0x5a },	/* k -> KP 2 */
109 	{ 0x0f, 0x5b },	/* l -> KP 3 */
110 	{ 0x10, 0x62 },	/* m -> KP 0 */
111 	{ 0x12, 0x5e },	/* o -> KP 6 */
112 	{ 0x13, 0x55 },	/* o -> KP * */
113 	{ 0x18, 0x5c },	/* u -> KP 4 */
114 	{ 0x0c, 0x5d },	/* i -> KP 5 */
115 	{ 0x2a, 0x4c },	/* Backspace -> Delete */
116 	{ 0x28, 0x49 },	/* Return -> Insert */
117 	{ 0x24, 0x5f }, /* 7 -> KP 7 */
118 	{ 0x25, 0x60 }, /* 8 -> KP 8 */
119 	{ 0x26, 0x61 }, /* 9 -> KP 9 */
120 	{ 0x27, 0x54 }, /* 0 -> KP / */
121 	{ 0x2d, 0x67 }, /* - -> KP = */
122 	{ 0x33, 0x56 },	/* ; -> KP - */
123 	{ 0x37, 0x63 },	/* . -> KP . */
124 	{ 0x38, 0x57 },	/* / -> KP + */
125 	{ 0x3a, IS_PMF | PMFE_DISPLAY_BRIGHTNESS_DOWN },
126 	{ 0x3b, IS_PMF | PMFE_DISPLAY_BRIGHTNESS_UP },
127 	{ 0x3c, IS_PMF | PMFE_AUDIO_VOLUME_TOGGLE },
128 	{ 0x3d, IS_PMF | PMFE_AUDIO_VOLUME_DOWN },
129 	{ 0x3e, IS_PMF | PMFE_AUDIO_VOLUME_UP },
130 	{ 0x3f, 0xd6 },	/* num lock */
131 	{ 0x40, 0xd7 },
132 	{ 0x41, IS_PMF | PMFE_KEYBOARD_BRIGHTNESS_TOGGLE },
133 	{ 0x42, IS_PMF | PMFE_KEYBOARD_BRIGHTNESS_DOWN },
134 	{ 0x43, IS_PMF | PMFE_KEYBOARD_BRIGHTNESS_UP },
135 	{ 0x44, 0xdb },
136 	{ 0x45, 0xdc },
137 	{ 0x4f, 0x4d },	/* Right -> End */
138 	{ 0x50, 0x4a },	/* Left -> Home */
139 	{ 0x51, 0x4e },	/* Down -> PageDown */
140 	{ 0x52, 0x4b },	/* Up -> PageUp */
141 	{ 0x00, 0x00 }
142 };
143 
144 Static const struct ukbd_keycodetrans trtab_apple_iso[] = {
145 	{ 0x35, 0x64 },	/* swap the key above tab with key right of shift */
146 	{ 0x64, 0x35 },
147 	{ 0x31, 0x32 },	/* key left of return is Europe1, not "\|" */
148 	{ 0x00, 0x00 }
149 };
150 
151 #ifdef GDIUM_KEYBOARD_HACK
152 Static const struct ukbd_keycodetrans trtab_gdium_fn[] = {
153 #ifdef notyet
154 	{ 58, 0 },	/* F1 -> toggle camera */
155 	{ 59, 0 },	/* F2 -> toggle wireless */
156 #endif
157 	{ 60, IS_PMF | PMFE_AUDIO_VOLUME_TOGGLE },
158 	{ 61, IS_PMF | PMFE_AUDIO_VOLUME_UP },
159 	{ 62, IS_PMF | PMFE_AUDIO_VOLUME_DOWN },
160 #ifdef notyet
161 	{ 63, 0 },	/* F6 -> toggle ext. video */
162 	{ 64, 0 },	/* F7 -> toggle mouse */
163 #endif
164 	{ 65, IS_PMF | PMFE_DISPLAY_BRIGHTNESS_UP },
165 	{ 66, IS_PMF | PMFE_DISPLAY_BRIGHTNESS_DOWN },
166 #ifdef notyet
167 	{ 67, 0 },	/* F10 -> suspend */
168 	{ 68, 0 },	/* F11 -> user1 */
169 	{ 69, 0 },	/* F12 -> user2 */
170 	{ 70, 0 },	/* print screen -> sysrq */
171 #endif
172 	{ 76, 71 },	/* delete -> scroll lock */
173 	{ 81, 78 },	/* down -> page down */
174 	{ 82, 75 },	/* up -> page up */
175 	{  0, 0 }
176 };
177 #endif
178 
179 Static const struct ukbd_keycodetrans trtab_generic[] = {
180 	{ 0x7f, IS_PMF | PMFE_AUDIO_VOLUME_TOGGLE },
181 	{ 0x80, IS_PMF | PMFE_AUDIO_VOLUME_UP },
182 	{ 0x81, IS_PMF | PMFE_AUDIO_VOLUME_DOWN },
183 	{ 0x00, 0x00 }
184 };
185 
186 #if defined(WSDISPLAY_COMPAT_RAWKBD)
187 #define NN 0			/* no translation */
188 /*
189  * Translate USB keycodes to US keyboard XT scancodes.
190  * Scancodes >= 0x80 represent EXTENDED keycodes.
191  *
192  * See http://www.microsoft.com/whdc/archive/scancode.mspx
193  *
194  * Note: a real pckbd(4) has more complexity in its
195  * protocol for some keys than this translation implements.
196  * For example, some keys generate Fake ShiftL events (e0 2a)
197  * before the actual key sequence.
198  */
199 Static const uint8_t ukbd_trtab[256] = {
200       NN,   NN,   NN,   NN, 0x1e, 0x30, 0x2e, 0x20, /* 00 - 07 */
201     0x12, 0x21, 0x22, 0x23, 0x17, 0x24, 0x25, 0x26, /* 08 - 0f */
202     0x32, 0x31, 0x18, 0x19, 0x10, 0x13, 0x1f, 0x14, /* 10 - 17 */
203     0x16, 0x2f, 0x11, 0x2d, 0x15, 0x2c, 0x02, 0x03, /* 18 - 1f */
204     0x04, 0x05, 0x06, 0x07, 0x08, 0x09, 0x0a, 0x0b, /* 20 - 27 */
205     0x1c, 0x01, 0x0e, 0x0f, 0x39, 0x0c, 0x0d, 0x1a, /* 28 - 2f */
206     0x1b, 0x2b, 0x2b, 0x27, 0x28, 0x29, 0x33, 0x34, /* 30 - 37 */
207     0x35, 0x3a, 0x3b, 0x3c, 0x3d, 0x3e, 0x3f, 0x40, /* 38 - 3f */
208     0x41, 0x42, 0x43, 0x44, 0x57, 0x58, 0xb7, 0x46, /* 40 - 47 */
209     0x7f, 0xd2, 0xc7, 0xc9, 0xd3, 0xcf, 0xd1, 0xcd, /* 48 - 4f */
210     0xcb, 0xd0, 0xc8, 0x45, 0xb5, 0x37, 0x4a, 0x4e, /* 50 - 57 */
211     0x9c, 0x4f, 0x50, 0x51, 0x4b, 0x4c, 0x4d, 0x47, /* 58 - 5f */
212     0x48, 0x49, 0x52, 0x53, 0x56, 0xdd, 0xdf, 0x59, /* 60 - 67 */
213     0x64, 0x65, 0x66, 0x67, 0x68, 0x69, 0x6a,   NN, /* 68 - 6f */
214       NN,   NN,   NN,   NN, 0x84, 0x85, 0x87, 0x88, /* 70 - 77 */
215     0x89, 0x8a, 0x8b, 0x8c, 0x8d, 0x8e, 0x8f,   NN, /* 78 - 7f */
216       NN,   NN,   NN,   NN,   NN, 0x7e,   NN, 0x73, /* 80 - 87 */
217     0x70, 0x7d, 0x79, 0x7b, 0x5c,   NN,   NN,   NN, /* 88 - 8f */
218       NN,   NN, 0x78, 0x77, 0x76,   NN,   NN,   NN, /* 90 - 97 */
219       NN,   NN,   NN,   NN,   NN,   NN,   NN,   NN, /* 98 - 9f */
220       NN,   NN,   NN,   NN,   NN,   NN,   NN,   NN, /* a0 - a7 */
221       NN,   NN,   NN,   NN,   NN,   NN,   NN,   NN, /* a8 - af */
222       NN,   NN,   NN,   NN,   NN,   NN,   NN,   NN, /* b0 - b7 */
223       NN,   NN,   NN,   NN,   NN,   NN,   NN,   NN, /* b8 - bf */
224       NN,   NN,   NN,   NN,   NN,   NN,   NN,   NN, /* c0 - c7 */
225       NN,   NN,   NN,   NN,   NN,   NN,   NN,   NN, /* c8 - cf */
226       NN,   NN,   NN,   NN,   NN,   NN,   NN,   NN, /* d0 - d7 */
227       NN,   NN,   NN,   NN,   NN,   NN,   NN,   NN, /* d8 - df */
228     0x1d, 0x2a, 0x38, 0xdb, 0x9d, 0x36, 0xb8, 0xdc, /* e0 - e7 */
229       NN,   NN,   NN,   NN,   NN,   NN,   NN,   NN, /* e8 - ef */
230       NN,   NN,   NN,   NN,   NN,   NN,   NN,   NN, /* f0 - f7 */
231       NN,   NN,   NN,   NN,   NN,   NN,   NN,   NN, /* f8 - ff */
232 };
233 #endif /* defined(WSDISPLAY_COMPAT_RAWKBD) */
234 
235 #define KEY_ERROR 0x01
236 
237 struct ukbd_softc {
238 	device_t sc_dev;
239 	struct uhidev *sc_hdev;
240 	struct usbd_device *sc_udev;
241 	struct usbd_interface *sc_iface;
242 	int sc_report_id;
243 
244 	struct ukbd_data sc_ndata;
245 	struct ukbd_data sc_odata;
246 	struct hid_location sc_keyloc[MAXKEYS];
247 	uint8_t sc_keyuse[MAXKEYS];
248 	u_int sc_nkeyloc;
249 
250 	struct hid_location sc_keycodeloc;
251 	u_int sc_nkeycode;
252 
253 	u_int sc_flags;			/* flags */
254 #define FLAG_ENABLED		0x0001
255 #define FLAG_POLLING		0x0002
256 #define FLAG_DEBOUNCE		0x0004	/* for quirk handling */
257 #define FLAG_APPLE_FIX_ISO	0x0008
258 #define FLAG_APPLE_FN		0x0010
259 #define FLAG_GDIUM_FN		0x0020
260 #define FLAG_FN_PRESSED		0x0100	/* FN key is held down */
261 #define FLAG_FN_ALT		0x0200	/* Last Alt key was FN-Alt = AltGr */
262 #define FLAG_NO_CONSOLE		0x0400	/* Don't attach as console */
263 
264 	int sc_console_keyboard;	/* we are the console keyboard */
265 
266 	struct callout sc_delay;	/* for quirk handling */
267 #define MAXPENDING 32
268 	struct ukbd_data sc_data[MAXPENDING];
269 	size_t sc_data_w, sc_data_r;
270 
271 	struct hid_location sc_apple_fn;
272 	struct hid_location sc_numloc;
273 	struct hid_location sc_capsloc;
274 	struct hid_location sc_scroloc;
275 	struct hid_location sc_compose;
276 	int sc_leds;
277 	struct usb_task sc_ledtask;
278 	struct callout sc_ledreset;
279 	int sc_leds_set;
280 	device_t sc_wskbddev;
281 
282 #if defined(WSDISPLAY_COMPAT_RAWKBD)
283 	int sc_rawkbd;
284 #if defined(UKBD_REPEAT)
285 	struct callout sc_rawrepeat_ch;
286 #define REP_DELAY1 400
287 #define REP_DELAYN 100
288 	int sc_nrep;
289 	char sc_rep[MAXKEYS];
290 #endif /* defined(UKBD_REPEAT) */
291 #endif /* defined(WSDISPLAY_COMPAT_RAWKBD) */
292 
293 	int sc_spl;
294 	int sc_npollchar;
295 	uint16_t sc_pollchars[MAXKEYS];
296 
297 	bool sc_dying;
298 	bool sc_attached;
299 };
300 
301 #ifdef UKBD_DEBUG
302 #define UKBDTRACESIZE 64
303 struct ukbdtraceinfo {
304 	int unit;
305 	struct timeval tv;
306 	struct ukbd_data ud;
307 };
308 struct ukbdtraceinfo ukbdtracedata[UKBDTRACESIZE];
309 int ukbdtraceindex = 0;
310 int ukbdtrace = 0;
311 void ukbdtracedump(void);
312 void
ukbdtracedump(void)313 ukbdtracedump(void)
314 {
315 	size_t i, j;
316 	for (i = 0; i < UKBDTRACESIZE; i++) {
317 		struct ukbdtraceinfo *p =
318 		    &ukbdtracedata[(i+ukbdtraceindex)%UKBDTRACESIZE];
319 		printf("%"PRIu64".%06"PRIu64":", p->tv.tv_sec,
320 		    (uint64_t)p->tv.tv_usec);
321 		for (j = 0; j < MAXKEYS; j++) {
322 			if (isset(p->ud.keys, j))
323 				printf(" %zu", j);
324 		}
325 		printf(".\n");
326 	}
327 }
328 #endif
329 
330 #define	UKBDUNIT(dev)	(minor(dev))
331 #define	UKBD_CHUNK	128	/* chunk size for read */
332 #define	UKBD_BSIZE	1020	/* buffer size */
333 
334 Static int	ukbd_is_console;
335 
336 Static void	ukbd_cngetc(void *, u_int *, int *);
337 Static void	ukbd_cnpollc(void *, int);
338 
339 const struct wskbd_consops ukbd_consops = {
340 	.getc =  ukbd_cngetc,
341 	.pollc = ukbd_cnpollc,
342 	.bell =  NULL,
343 };
344 
345 Static const char *ukbd_parse_desc(struct ukbd_softc *);
346 
347 Static void	ukbd_intr(void *, void *, u_int);
348 Static void	ukbd_decode(struct ukbd_softc *, struct ukbd_data *);
349 Static void	ukbd_delayed_decode(void *);
350 
351 Static int	ukbd_enable(void *, int);
352 Static void	ukbd_set_leds(void *, int);
353 Static void	ukbd_set_leds_task(void *);
354 Static void	ukbd_delayed_leds_off(void *);
355 
356 Static int	ukbd_ioctl(void *, u_long, void *, int, struct lwp *);
357 #if  defined(WSDISPLAY_COMPAT_RAWKBD) && defined(UKBD_REPEAT)
358 Static void	ukbd_rawrepeat(void *v);
359 #endif
360 
361 const struct wskbd_accessops ukbd_accessops = {
362 	ukbd_enable,
363 	ukbd_set_leds,
364 	ukbd_ioctl,
365 };
366 
367 extern const struct wscons_keydesc hidkbd_keydesctab[];
368 
369 const struct wskbd_mapdata ukbd_keymapdata = {
370 	hidkbd_keydesctab,
371 #if defined(UKBD_LAYOUT)
372 	UKBD_LAYOUT,
373 #elif defined(PCKBD_LAYOUT)
374 	PCKBD_LAYOUT,
375 #else
376 	KB_US,
377 #endif
378 };
379 
380 static const struct ukbd_type {
381 	struct usb_devno	dev;
382 	int			flags;
383 } ukbd_devs[] = {
384 #define UKBD_DEV(v, p, f) \
385 	{ { USB_VENDOR_##v, USB_PRODUCT_##v##_##p }, (f) }
386 #ifdef GDIUM_KEYBOARD_HACK
387 	UKBD_DEV(CYPRESS, LPRDK, FLAG_GDIUM_FN),
388 #endif
389 	UKBD_DEV(YUBICO, YUBIKEY4MODE1, FLAG_NO_CONSOLE),
390 	UKBD_DEV(YUBICO, YUBIKEY4MODE2, FLAG_NO_CONSOLE),
391 	UKBD_DEV(YUBICO, YUBIKEY4MODE6, FLAG_NO_CONSOLE)
392 };
393 #define ukbd_lookup(v, p) \
394 	((const struct ukbd_type *)usb_lookup(ukbd_devs, v, p))
395 
396 static int ukbd_match(device_t, cfdata_t, void *);
397 static void ukbd_attach(device_t, device_t, void *);
398 static int ukbd_detach(device_t, int);
399 static int ukbd_activate(device_t, enum devact);
400 static void ukbd_childdet(device_t, device_t);
401 
402 
403 
404 CFATTACH_DECL2_NEW(ukbd, sizeof(struct ukbd_softc), ukbd_match, ukbd_attach,
405     ukbd_detach, ukbd_activate, NULL, ukbd_childdet);
406 
407 int
ukbd_match(device_t parent,cfdata_t match,void * aux)408 ukbd_match(device_t parent, cfdata_t match, void *aux)
409 {
410 	struct uhidev_attach_arg *uha = aux;
411 	int size;
412 	void *desc;
413 
414 	uhidev_get_report_desc(uha->parent, &desc, &size);
415 	if (!hid_is_collection(desc, size, uha->reportid,
416 			       HID_USAGE2(HUP_GENERIC_DESKTOP, HUG_KEYBOARD)))
417 		return UMATCH_NONE;
418 
419 	return UMATCH_IFACECLASS;
420 }
421 
422 void
ukbd_attach(device_t parent,device_t self,void * aux)423 ukbd_attach(device_t parent, device_t self, void *aux)
424 {
425 	struct ukbd_softc *sc = device_private(self);
426 	struct uhidev_attach_arg *uha = aux;
427 	uint32_t qflags;
428 	const char *parseerr;
429 	struct wskbddev_attach_args a;
430 	const struct ukbd_type *ukt;
431 
432 	sc->sc_dev = self;
433 	sc->sc_hdev = uha->parent;
434 	sc->sc_udev = uha->uiaa->uiaa_device;
435 	sc->sc_iface = uha->uiaa->uiaa_iface;
436 	sc->sc_report_id = uha->reportid;
437 	sc->sc_flags = 0;
438 
439 	aprint_naive("\n");
440 
441 	if (!pmf_device_register(self, NULL, NULL)) {
442 		aprint_normal("\n");
443 		aprint_error_dev(self, "couldn't establish power handler\n");
444 	}
445 
446 	parseerr = ukbd_parse_desc(sc);
447 	if (parseerr != NULL) {
448 		aprint_normal("\n");
449 		aprint_error_dev(self, "attach failed, %s\n", parseerr);
450 		return;
451 	}
452 
453 	/* Quirks */
454 	qflags = usbd_get_quirks(sc->sc_udev)->uq_flags;
455 	if (qflags & UQ_SPUR_BUT_UP)
456 		sc->sc_flags |= FLAG_DEBOUNCE;
457 	if (qflags & UQ_APPLE_ISO)
458 		sc->sc_flags |= FLAG_APPLE_FIX_ISO;
459 
460 	/* Other Quirks */
461 	ukt = ukbd_lookup(uha->uiaa->uiaa_vendor, uha->uiaa->uiaa_product);
462 	if (ukt)
463 		sc->sc_flags |= ukt->flags;
464 
465 #ifdef USBVERBOSE
466 	aprint_normal(": %d Variable keys, %d Array codes", sc->sc_nkeyloc,
467 	       sc->sc_nkeycode);
468 	if (sc->sc_flags & FLAG_APPLE_FN)
469 		aprint_normal(", apple fn key");
470 	if (sc->sc_flags & FLAG_APPLE_FIX_ISO)
471 		aprint_normal(", fix apple iso");
472 	if (sc->sc_flags & FLAG_GDIUM_FN)
473 		aprint_normal(", Gdium fn key");
474 #endif
475 	aprint_normal("\n");
476 
477 	if ((sc->sc_flags & FLAG_NO_CONSOLE) == 0) {
478 		/*
479 		 * Remember if we're the console keyboard.
480 		 *
481 		 * XXX This always picks the first keyboard on the
482 		 * first USB bus, but what else can we really do?
483 		 */
484 		if ((sc->sc_console_keyboard = ukbd_is_console) != 0) {
485 			/* Don't let any other keyboard have it. */
486 			ukbd_is_console = 0;
487 		}
488 	}
489 
490 	if (sc->sc_console_keyboard) {
491 		DPRINTF(("%s: console keyboard sc=%p\n", __func__, sc));
492 		wskbd_cnattach(&ukbd_consops, sc, &ukbd_keymapdata);
493 		ukbd_enable(sc, 1);
494 	}
495 
496 	a.console = sc->sc_console_keyboard;
497 
498 	a.keymap = &ukbd_keymapdata;
499 
500 	a.accessops = &ukbd_accessops;
501 	a.accesscookie = sc;
502 
503 #ifdef UKBD_REPEAT
504 	callout_init(&sc->sc_rawrepeat_ch, 0);
505 #endif
506 
507 	callout_init(&sc->sc_delay, 0);
508 
509 	sc->sc_data_w = 0;
510 	sc->sc_data_r = 0;
511 
512 	usb_init_task(&sc->sc_ledtask, ukbd_set_leds_task, sc, 0);
513 	callout_init(&sc->sc_ledreset, 0);
514 
515 	/* Flash the leds; no real purpose, just shows we're alive. */
516 	ukbd_set_leds(sc, WSKBD_LED_SCROLL | WSKBD_LED_NUM | WSKBD_LED_CAPS
517 			| WSKBD_LED_COMPOSE);
518 	sc->sc_leds_set = 0;	/* not explicitly set by wskbd yet */
519 	callout_reset(&sc->sc_ledreset, mstohz(400), ukbd_delayed_leds_off,
520 	    sc);
521 
522 	sc->sc_wskbddev = config_found(self, &a, wskbddevprint, CFARGS_NONE);
523 
524 	sc->sc_attached = true;
525 
526 	return;
527 }
528 
529 int
ukbd_enable(void * v,int on)530 ukbd_enable(void *v, int on)
531 {
532 	struct ukbd_softc *sc = v;
533 
534 	if (on && sc->sc_dying)
535 		return EIO;
536 
537 	/* Should only be called to change state */
538 	if ((sc->sc_flags & FLAG_ENABLED) != 0 && on != 0) {
539 #ifdef DIAGNOSTIC
540 		aprint_error_dev(sc->sc_dev, "bad call on=%d\n", on);
541 #endif
542 		return EBUSY;
543 	}
544 
545 	DPRINTF(("%s: sc=%p on=%d\n", __func__, sc, on));
546 	if (on) {
547 		sc->sc_flags |= FLAG_ENABLED;
548 		return uhidev_open(sc->sc_hdev, &ukbd_intr, sc);
549 	} else {
550 		sc->sc_flags &= ~FLAG_ENABLED;
551 		uhidev_close(sc->sc_hdev);
552 		return 0;
553 	}
554 }
555 
556 
557 static void
ukbd_childdet(device_t self,device_t child)558 ukbd_childdet(device_t self, device_t child)
559 {
560 	struct ukbd_softc *sc = device_private(self);
561 
562 	KASSERT(sc->sc_wskbddev == child);
563 	sc->sc_wskbddev = NULL;
564 }
565 
566 int
ukbd_activate(device_t self,enum devact act)567 ukbd_activate(device_t self, enum devact act)
568 {
569 	struct ukbd_softc *sc = device_private(self);
570 
571 	switch (act) {
572 	case DVACT_DEACTIVATE:
573 		sc->sc_dying = true;
574 		return 0;
575 	default:
576 		return EOPNOTSUPP;
577 	}
578 }
579 
580 int
ukbd_detach(device_t self,int flags)581 ukbd_detach(device_t self, int flags)
582 {
583 	struct ukbd_softc *sc = device_private(self);
584 	int rv = 0;
585 
586 	DPRINTF(("%s: sc=%p flags=%d\n", __func__, sc, flags));
587 
588 	pmf_device_deregister(self);
589 
590 	if (!sc->sc_attached)
591 		return rv;
592 
593 	if (sc->sc_console_keyboard) {
594 		/*
595 		 * Disconnect our consops and set ukbd_is_console
596 		 * back to 1 so that the next USB keyboard attached
597 		 * to the system will get it.
598 		 * XXX Should notify some other keyboard that it can be
599 		 * XXX console, if there are any other keyboards.
600 		 */
601 		printf("%s: was console keyboard\n",
602 		       device_xname(sc->sc_dev));
603 		wskbd_cndetach();
604 		ukbd_is_console = 1;
605 	}
606 	/* No need to do reference counting of ukbd, wskbd has all the goo. */
607 	if (sc->sc_wskbddev != NULL)
608 		rv = config_detach(sc->sc_wskbddev, flags);
609 
610 	callout_halt(&sc->sc_delay, NULL);
611 	callout_halt(&sc->sc_ledreset, NULL);
612 	usb_rem_task_wait(sc->sc_udev, &sc->sc_ledtask,
613 	    USB_TASKQ_DRIVER, NULL);
614 
615 	/* The console keyboard does not get a disable call, so check pipe. */
616 	if (sc->sc_flags & FLAG_ENABLED)
617 		uhidev_close(sc->sc_hdev);
618 
619 	return rv;
620 }
621 
622 static void
ukbd_translate_keycodes(struct ukbd_softc * sc,struct ukbd_data * ud,const struct ukbd_keycodetrans * tab)623 ukbd_translate_keycodes(struct ukbd_softc *sc, struct ukbd_data *ud,
624     const struct ukbd_keycodetrans *tab)
625 {
626 	const struct ukbd_keycodetrans *tp;
627 	struct ukbd_data oud;
628 	int i;
629 
630 	oud = *ud;
631 
632 	for (i = 4; i < MAXKEYS; i++) {
633 		if (isset(oud.keys, i))
634 			for (tp = tab; tp->from; tp++)
635 				if (tp->from == i) {
636 					if (tp->to & IS_PMF) {
637 						pmf_event_inject(sc->sc_dev,
638 						    tp->to & 0xff);
639 					} else
640 						setbit(ud->keys, tp->to);
641 					clrbit(ud->keys, i);
642 					break;
643 				}
644 	}
645 }
646 
647 static uint16_t
ukbd_translate_modifier(struct ukbd_softc * sc,uint16_t key)648 ukbd_translate_modifier(struct ukbd_softc *sc, uint16_t key)
649 {
650 	if ((sc->sc_flags & FLAG_APPLE_FN) && (key & CODEMASK) == 0x00e2) {
651 		if ((key & ~CODEMASK) == PRESS) {
652 			if (sc->sc_flags & FLAG_FN_PRESSED) {
653 				/* pressed FN-Alt, translate to AltGr */
654 				key = 0x00e6 | PRESS;
655 				sc->sc_flags |= FLAG_FN_ALT;
656 			}
657 		} else {
658 			if (sc->sc_flags & FLAG_FN_ALT) {
659 				/* released Alt, which was treated as FN-Alt */
660 				key = 0x00e6 | RELEASE;
661 				sc->sc_flags &= ~FLAG_FN_ALT;
662 			}
663 		}
664 	}
665 	return key;
666 }
667 
668 void
ukbd_intr(void * cookie,void * ibuf,u_int len)669 ukbd_intr(void *cookie, void *ibuf, u_int len)
670 {
671 	struct ukbd_softc *sc = cookie;
672 	struct ukbd_data *ud = &sc->sc_ndata;
673 	int i;
674 
675 #ifdef UKBD_DEBUG
676 	if (ukbddebug > 5) {
677 		printf("ukbd_intr: data");
678 		for (i = 0; i < len; i++)
679 			printf(" 0x%02x", ((u_char *)ibuf)[i]);
680 		printf("\n");
681 	}
682 #endif
683 
684 	memset(ud->keys, 0, sizeof(ud->keys));
685 
686 	for (i = 0; i < sc->sc_nkeyloc; i++)
687 		if (hid_get_data(ibuf, &sc->sc_keyloc[i]))
688 			setbit(ud->keys, sc->sc_keyuse[i]);
689 
690 	const uint8_t * const scancode = (char *)ibuf + sc->sc_keycodeloc.pos / 8;
691 	const uint16_t Keyboard_NoEvent = 0x0000;
692 	for (i = 0; i < sc->sc_nkeycode; i++) {
693 		if (scancode[i] != Keyboard_NoEvent)
694 			setbit(ud->keys, scancode[i]);
695 	}
696 
697 	if (sc->sc_flags & FLAG_APPLE_FN) {
698 		if (hid_get_data(ibuf, &sc->sc_apple_fn)) {
699 			sc->sc_flags |= FLAG_FN_PRESSED;
700 			ukbd_translate_keycodes(sc, ud, trtab_apple_fn);
701 		}
702 		else
703 			sc->sc_flags &= ~FLAG_FN_PRESSED;
704 	}
705 
706 #ifdef GDIUM_KEYBOARD_HACK
707 	if (sc->sc_flags & FLAG_GDIUM_FN) {
708 		if (sc->sc_flags & FLAG_FN_PRESSED) {
709 			ukbd_translate_keycodes(sc, ud, trtab_gdium_fn);
710 		}
711 	}
712 #endif
713 
714 	ukbd_translate_keycodes(sc, ud, trtab_generic);
715 
716 	if ((sc->sc_flags & FLAG_DEBOUNCE) && !(sc->sc_flags & FLAG_POLLING)) {
717 		/*
718 		 * Some keyboards have a peculiar quirk.  They sometimes
719 		 * generate a key up followed by a key down for the same
720 		 * key after about 10 ms.
721 		 * We avoid this bug by holding off decoding for 20 ms.
722 		 * Note that this comes at a cost: we deliberately overwrite
723 		 * the data for any keyboard event that is followed by
724 		 * another one within this time window.
725 		 */
726 		if (sc->sc_data_w == sc->sc_data_r) {
727 			sc->sc_data_w = (sc->sc_data_w + 1) % MAXPENDING;
728 		}
729 		sc->sc_data[sc->sc_data_w] = *ud;
730 		callout_reset(&sc->sc_delay, hz / 50, ukbd_delayed_decode, sc);
731 #ifdef DDB
732 	} else if (sc->sc_console_keyboard && !(sc->sc_flags & FLAG_POLLING)) {
733 		/*
734 		 * For the console keyboard we can't deliver CTL-ALT-ESC
735 		 * from the interrupt routine.  Doing so would start
736 		 * polling from inside the interrupt routine and that
737 		 * loses bigtime.
738 		 */
739 		sc->sc_data_w = (sc->sc_data_w + 1) % MAXPENDING;
740 		sc->sc_data[sc->sc_data_w] = *ud;
741 		callout_reset(&sc->sc_delay, 0, ukbd_delayed_decode, sc);
742 #endif
743 	} else {
744 		ukbd_decode(sc, ud);
745 	}
746 }
747 
748 Static void
ukbd_delayed_leds_off(void * addr)749 ukbd_delayed_leds_off(void *addr)
750 {
751 	struct ukbd_softc *sc = addr;
752 
753 	/*
754 	 * If the LEDs have already been set after attach, other than
755 	 * by our initial flashing of them, leave them be.
756 	 */
757 	if (sc->sc_leds_set)
758 		return;
759 
760 	ukbd_set_leds(sc, 0);
761 }
762 
763 void
ukbd_delayed_decode(void * addr)764 ukbd_delayed_decode(void *addr)
765 {
766 	struct ukbd_softc *sc = addr;
767 
768 	while (sc->sc_data_r != sc->sc_data_w) {
769 		sc->sc_data_r = (sc->sc_data_r + 1) % MAXPENDING;
770 		ukbd_decode(sc, &sc->sc_data[sc->sc_data_r]);
771 	}
772 }
773 
774 void
ukbd_decode(struct ukbd_softc * sc,struct ukbd_data * ud)775 ukbd_decode(struct ukbd_softc *sc, struct ukbd_data *ud)
776 {
777 	uint16_t ibuf[MAXKEYS];	/* chars events */
778 	int s;
779 	int nkeys, i;
780 #ifdef WSDISPLAY_COMPAT_RAWKBD
781 	int j;
782 #endif
783 	int key;
784 #define ADDKEY(c) do { \
785     KASSERT(nkeys < MAXKEYS); \
786     ibuf[nkeys++] = (c); \
787 } while (0)
788 
789 #ifdef UKBD_DEBUG
790 	/*
791 	 * Keep a trace of the last events.  Using printf changes the
792 	 * timing, so this can be useful sometimes.
793 	 */
794 	if (ukbdtrace) {
795 		struct ukbdtraceinfo *p = &ukbdtracedata[ukbdtraceindex];
796 		p->unit = device_unit(sc->sc_dev);
797 		microtime(&p->tv);
798 		p->ud = *ud;
799 		if (++ukbdtraceindex >= UKBDTRACESIZE)
800 			ukbdtraceindex = 0;
801 	}
802 	if (ukbddebug > 5) {
803 		struct timeval tv;
804 		microtime(&tv);
805 		DPRINTF((" at %"PRIu64".%06"PRIu64":", tv.tv_sec,
806 		    (uint64_t)tv.tv_usec));
807 		for (size_t k = 0; k < MAXKEYS; k++) {
808 			if (isset(ud->keys, k))
809 				DPRINTF((" %zu", k));
810 		}
811 		DPRINTF((".\n"));
812 	}
813 #endif
814 
815 	if (isset(ud->keys, KEY_ERROR)) {
816 		DPRINTF(("%s: KEY_ERROR\n", __func__));
817 		return;		/* ignore  */
818 	}
819 
820 	if (sc->sc_flags & FLAG_APPLE_FIX_ISO)
821 		ukbd_translate_keycodes(sc, ud, trtab_apple_iso);
822 
823 	nkeys = 0;
824 	for (i = 0; i < MAXKEYS; i++) {
825 #ifdef GDIUM_KEYBOARD_HACK
826 			if (sc->sc_flags & FLAG_GDIUM_FN && i == 0x82) {
827 				if (isset(ud->keys, i))
828 					sc->sc_flags |= FLAG_FN_PRESSED;
829 				else
830 					sc->sc_flags &= ~FLAG_FN_PRESSED;
831 			}
832 #endif
833 			if (isset(ud->keys, i) != isset(sc->sc_odata.keys, i)) {
834 				key = i | ((isset(ud->keys, i) ? PRESS : RELEASE));
835 				ADDKEY(ukbd_translate_modifier(sc, key));
836 			}
837 	}
838 	sc->sc_odata = *ud;
839 
840 	if (nkeys == 0)
841 		return;
842 
843 	if (sc->sc_flags & FLAG_POLLING) {
844 		DPRINTFN(1,("%s: pollchar = 0x%03x\n", __func__, ibuf[0]));
845 		memcpy(sc->sc_pollchars, ibuf, nkeys * sizeof(uint16_t));
846 		sc->sc_npollchar = nkeys;
847 		return;
848 	}
849 #ifdef WSDISPLAY_COMPAT_RAWKBD
850 	if (sc->sc_rawkbd) {
851 		u_char cbuf[MAXKEYS * 2];
852 		int c;
853 #if defined(UKBD_REPEAT)
854 		int npress = 0;
855 #endif
856 
857 		for (i = j = 0; i < nkeys; i++) {
858 			key = ibuf[i];
859 			c = ukbd_trtab[key & CODEMASK];
860 			if (c == NN)
861 				continue;
862 			if (c == 0x7f) {
863 				/* pause key */
864 				cbuf[j++] = 0xe1;
865 				cbuf[j++] = 0x1d;
866 				cbuf[j-1] |= (key & RELEASE) ? 0x80 : 0;
867 				cbuf[j] = 0x45;
868 			} else {
869 				if (c & 0x80)
870 					cbuf[j++] = 0xe0;
871 				cbuf[j] = c & 0x7f;
872 			}
873 			if (key & RELEASE)
874 				cbuf[j] |= 0x80;
875 #if defined(UKBD_REPEAT)
876 			else {
877 				/* remember pressed keys for autorepeat */
878 				if (c & 0x80)
879 					sc->sc_rep[npress++] = 0xe0;
880 				sc->sc_rep[npress++] = c & 0x7f;
881 			}
882 #endif
883 			DPRINTFN(1,("%s: raw = %s0x%02x\n", __func__,
884 				    c & 0x80 ? "0xe0 " : "",
885 				    cbuf[j]));
886 			j++;
887 		}
888 		s = spltty();
889 		wskbd_rawinput(sc->sc_wskbddev, cbuf, j);
890 		splx(s);
891 #ifdef UKBD_REPEAT
892 		callout_stop(&sc->sc_rawrepeat_ch);
893 		if (npress != 0) {
894 			sc->sc_nrep = npress;
895 			callout_reset(&sc->sc_rawrepeat_ch,
896 			    hz * REP_DELAY1 / 1000, ukbd_rawrepeat, sc);
897 		}
898 #endif
899 		return;
900 	}
901 #endif
902 
903 	s = spltty();
904 	for (i = 0; i < nkeys; i++) {
905 		key = ibuf[i];
906 		wskbd_input(sc->sc_wskbddev,
907 		    key&RELEASE ? WSCONS_EVENT_KEY_UP : WSCONS_EVENT_KEY_DOWN,
908 		    key&CODEMASK);
909 	}
910 	splx(s);
911 }
912 
913 void
ukbd_set_leds(void * v,int leds)914 ukbd_set_leds(void *v, int leds)
915 {
916 	struct ukbd_softc *sc = v;
917 	struct usbd_device *udev = sc->sc_udev;
918 
919 	DPRINTF(("%s: sc=%p leds=%d, sc_leds=%d\n", __func__,
920 		 sc, leds, sc->sc_leds));
921 
922 	if (sc->sc_dying)
923 		return;
924 
925 	sc->sc_leds_set = 1;
926 
927 	if (sc->sc_leds == leds)
928 		return;
929 
930 	sc->sc_leds = leds;
931 	usb_add_task(udev, &sc->sc_ledtask, USB_TASKQ_DRIVER);
932 }
933 
934 void
ukbd_set_leds_task(void * v)935 ukbd_set_leds_task(void *v)
936 {
937 	struct ukbd_softc *sc = v;
938 	int leds = sc->sc_leds;
939 	uint8_t res = 0;
940 
941 	/* XXX not really right */
942 	if ((leds & WSKBD_LED_COMPOSE) && sc->sc_compose.size == 1)
943 		res |= 1 << sc->sc_compose.pos;
944 	if ((leds & WSKBD_LED_SCROLL) && sc->sc_scroloc.size == 1)
945 		res |= 1 << sc->sc_scroloc.pos;
946 	if ((leds & WSKBD_LED_NUM) && sc->sc_numloc.size == 1)
947 		res |= 1 << sc->sc_numloc.pos;
948 	if ((leds & WSKBD_LED_CAPS) && sc->sc_capsloc.size == 1)
949 		res |= 1 << sc->sc_capsloc.pos;
950 
951 	uhidev_set_report(sc->sc_hdev, UHID_OUTPUT_REPORT, &res, 1);
952 }
953 
954 #if defined(WSDISPLAY_COMPAT_RAWKBD) && defined(UKBD_REPEAT)
955 void
ukbd_rawrepeat(void * v)956 ukbd_rawrepeat(void *v)
957 {
958 	struct ukbd_softc *sc = v;
959 	int s;
960 
961 	s = spltty();
962 	wskbd_rawinput(sc->sc_wskbddev, sc->sc_rep, sc->sc_nrep);
963 	splx(s);
964 	callout_reset(&sc->sc_rawrepeat_ch, hz * REP_DELAYN / 1000,
965 	    ukbd_rawrepeat, sc);
966 }
967 #endif /* defined(WSDISPLAY_COMPAT_RAWKBD) && defined(UKBD_REPEAT) */
968 
969 int
ukbd_ioctl(void * v,u_long cmd,void * data,int flag,struct lwp * l)970 ukbd_ioctl(void *v, u_long cmd, void *data, int flag,
971     struct lwp *l)
972 {
973 	struct ukbd_softc *sc = v;
974 
975 	switch (cmd) {
976 	case WSKBDIO_GTYPE:
977 		*(int *)data = WSKBD_TYPE_USB;
978 		return 0;
979 	case WSKBDIO_SETLEDS:
980 		ukbd_set_leds(v, *(int *)data);
981 		return 0;
982 	case WSKBDIO_GETLEDS:
983 		*(int *)data = sc->sc_leds;
984 		return 0;
985 #if defined(WSDISPLAY_COMPAT_RAWKBD)
986 	case WSKBDIO_SETMODE:
987 		DPRINTF(("%s: set raw = %d\n", __func__, *(int *)data));
988 		sc->sc_rawkbd = *(int *)data == WSKBD_RAW;
989 #if defined(UKBD_REPEAT)
990 		callout_stop(&sc->sc_rawrepeat_ch);
991 #endif
992 		return 0;
993 #endif
994 	}
995 	return EPASSTHROUGH;
996 }
997 
998 /*
999  * This is a hack to work around some broken ports that don't call
1000  * cnpollc() before cngetc().
1001  */
1002 static int pollenter, warned;
1003 
1004 /* Console interface. */
1005 void
ukbd_cngetc(void * v,u_int * type,int * data)1006 ukbd_cngetc(void *v, u_int *type, int *data)
1007 {
1008 	struct ukbd_softc *sc = v;
1009 	int c;
1010 	int broken;
1011 
1012 	if (pollenter == 0) {
1013 		if (!warned) {
1014 			printf("\n"
1015 "This port is broken, it does not call cnpollc() before calling cngetc().\n"
1016 "This should be fixed, but it will work anyway (for now).\n");
1017 			warned = 1;
1018 		}
1019 		broken = 1;
1020 		ukbd_cnpollc(v, 1);
1021 	} else
1022 		broken = 0;
1023 
1024 	DPRINTFN(0,("%s: enter\n", __func__));
1025 	sc->sc_flags |= FLAG_POLLING;
1026 	if (sc->sc_npollchar <= 0)
1027 		usbd_dopoll(sc->sc_iface);
1028 	sc->sc_flags &= ~FLAG_POLLING;
1029 	if (sc->sc_npollchar > 0) {
1030 		c = sc->sc_pollchars[0];
1031 		sc->sc_npollchar--;
1032 		memmove(sc->sc_pollchars, sc->sc_pollchars+1,
1033 		       sc->sc_npollchar * sizeof(uint16_t));
1034 		*type = c & RELEASE ? WSCONS_EVENT_KEY_UP : WSCONS_EVENT_KEY_DOWN;
1035 		*data = c & CODEMASK;
1036 		DPRINTFN(0,("%s: return 0x%02x\n", __func__, c));
1037 	} else {
1038 		*type = 0;
1039 		*data = 0;
1040 	}
1041 	if (broken)
1042 		ukbd_cnpollc(v, 0);
1043 }
1044 
1045 void
ukbd_cnpollc(void * v,int on)1046 ukbd_cnpollc(void *v, int on)
1047 {
1048 	struct ukbd_softc *sc = v;
1049 	struct usbd_device *dev;
1050 
1051 	DPRINTFN(2,("%s: sc=%p on=%d\n", __func__, v, on));
1052 
1053 	/* XXX Can this just use sc->sc_udev, or am I mistaken?  */
1054 	usbd_interface2device_handle(sc->sc_iface, &dev);
1055 	if (on) {
1056 		sc->sc_spl = splusb();
1057 		pollenter++;
1058 	} else {
1059 		splx(sc->sc_spl);
1060 		pollenter--;
1061 	}
1062 	usbd_set_polling(dev, on);
1063 }
1064 
1065 int
ukbd_cnattach(void)1066 ukbd_cnattach(void)
1067 {
1068 
1069 	/*
1070 	 * XXX USB requires too many parts of the kernel to be running
1071 	 * XXX in order to work, so we can't do much for the console
1072 	 * XXX keyboard until autoconfiguration has run its course.
1073 	 */
1074 	ukbd_is_console = 1;
1075 	return 0;
1076 }
1077 
1078 const char *
ukbd_parse_desc(struct ukbd_softc * sc)1079 ukbd_parse_desc(struct ukbd_softc *sc)
1080 {
1081 	struct hid_data *d;
1082 	struct hid_item h;
1083 	int size;
1084 	void *desc;
1085 	int ikey;
1086 
1087 	uhidev_get_report_desc(sc->sc_hdev, &desc, &size);
1088 	ikey = 0;
1089 	sc->sc_nkeycode = 0;
1090 	d = hid_start_parse(desc, size, hid_input);
1091 	while (hid_get_item(d, &h)) {
1092 		/* Check for special Apple notebook FN key */
1093 		if (HID_GET_USAGE_PAGE(h.usage) == 0x00ff &&
1094 		    HID_GET_USAGE(h.usage) == 0x0003 &&
1095 		    h.kind == hid_input && (h.flags & HIO_VARIABLE)) {
1096 			sc->sc_flags |= FLAG_APPLE_FN;
1097 			sc->sc_apple_fn = h.loc;
1098 		}
1099 
1100 		if (h.kind != hid_input || (h.flags & HIO_CONST) ||
1101 		    HID_GET_USAGE_PAGE(h.usage) != HUP_KEYBOARD ||
1102 		    h.report_ID != sc->sc_report_id)
1103 			continue;
1104 		DPRINTF(("%s: ikey=%d usage=%#x flags=%#x pos=%d size=%d "
1105 		    "cnt=%d\n", __func__, ikey, h.usage, h.flags, h.loc.pos,
1106 		    h.loc.size, h.loc.count));
1107 		if (h.flags & HIO_VARIABLE) {
1108 			if (h.loc.size != 1) {
1109 				hid_end_parse(d);
1110 				return "bad modifier size";
1111 			}
1112 			/* Single item */
1113 			if (ikey < MAXKEYS) {
1114 				sc->sc_keyloc[ikey] = h.loc;
1115 				sc->sc_keyuse[ikey] = HID_GET_USAGE(h.usage);
1116 				ikey++;
1117 			} else {
1118 				hid_end_parse(d);
1119 				return "too many Variable keys";
1120 			}
1121 		} else {
1122 			/* Array */
1123 			if (h.loc.size != 8) {
1124 				hid_end_parse(d);
1125 				return "key code size != 8";
1126 			}
1127 			if (h.loc.count > MAXKEYCODE)
1128 				h.loc.count = MAXKEYCODE;
1129 			if (h.loc.pos % 8 != 0) {
1130 				hid_end_parse(d);
1131 				return "key codes not on byte boundary";
1132 			}
1133 			if (sc->sc_nkeycode != 0) {
1134 				hid_end_parse(d);
1135 				return "multiple key code arrays";
1136 			}
1137 			sc->sc_keycodeloc = h.loc;
1138 			sc->sc_nkeycode = h.loc.count;
1139 		}
1140 	}
1141 	sc->sc_nkeyloc = ikey;
1142 	hid_end_parse(d);
1143 
1144 	hid_locate(desc, size, HID_USAGE2(HUP_LEDS, HUD_LED_NUM_LOCK),
1145 	    sc->sc_report_id, hid_output, &sc->sc_numloc, NULL);
1146 	hid_locate(desc, size, HID_USAGE2(HUP_LEDS, HUD_LED_CAPS_LOCK),
1147 	    sc->sc_report_id, hid_output, &sc->sc_capsloc, NULL);
1148 	hid_locate(desc, size, HID_USAGE2(HUP_LEDS, HUD_LED_SCROLL_LOCK),
1149 	    sc->sc_report_id, hid_output, &sc->sc_scroloc, NULL);
1150 	hid_locate(desc, size, HID_USAGE2(HUP_LEDS, HUD_LED_COMPOSE),
1151 	    sc->sc_report_id, hid_output, &sc->sc_compose, NULL);
1152 
1153 	return NULL;
1154 }
1155