ukbd.c revision 1.135
1/*      $NetBSD: ukbd.c,v 1.135 2017/01/20 02:22:42 maya 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.135 2017/01/20 02:22:42 maya 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_wsdisplay_compat.h"
46#endif /* _KERNEL_OPT */
47
48#include <sys/param.h>
49#include <sys/systm.h>
50#include <sys/callout.h>
51#include <sys/kernel.h>
52#include <sys/device.h>
53#include <sys/ioctl.h>
54#include <sys/file.h>
55#include <sys/select.h>
56#include <sys/proc.h>
57#include <sys/vnode.h>
58#include <sys/poll.h>
59
60#include <dev/usb/usb.h>
61#include <dev/usb/usbhid.h>
62
63#include <dev/usb/usbdi.h>
64#include <dev/usb/usbdi_util.h>
65#include <dev/usb/usbdivar.h>
66#include <dev/usb/usbdevs.h>
67#include <dev/usb/usb_quirks.h>
68#include <dev/usb/uhidev.h>
69#include <dev/usb/hid.h>
70#include <dev/usb/ukbdvar.h>
71
72#include <dev/wscons/wsconsio.h>
73#include <dev/wscons/wskbdvar.h>
74#include <dev/wscons/wsksymdef.h>
75#include <dev/wscons/wsksymvar.h>
76
77#ifdef UKBD_DEBUG
78#define DPRINTF(x)	if (ukbddebug) printf x
79#define DPRINTFN(n,x)	if (ukbddebug>(n)) printf x
80int	ukbddebug = 0;
81#else
82#define DPRINTF(x)
83#define DPRINTFN(n,x)
84#endif
85
86#define MAXKEYCODE 6
87#define MAXMOD 8		/* max 32 */
88
89struct ukbd_data {
90	uint32_t	modifiers;
91	uint8_t		keycode[MAXKEYCODE];
92};
93
94#define PRESS    0x000
95#define RELEASE  0x100
96#define CODEMASK 0x0ff
97
98struct ukbd_keycodetrans {
99	uint16_t	from;
100	uint16_t	to;
101};
102
103#define IS_PMF	0x8000
104
105Static 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, 0xd1 },	/* F1..F12 mapped to reserved codes 0xd1..0xdc */
126	{ 0x3b, 0xd2 },
127	{ 0x3c, 0xd3 },
128	{ 0x3d, 0xd4 },
129	{ 0x3e, 0xd5 },
130	{ 0x3f, 0xd6 },
131	{ 0x40, 0xd7 },
132	{ 0x41, 0xd8 },
133	{ 0x42, 0xd9 },
134	{ 0x43, 0xda },
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
144Static 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
152Static 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
179Static 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 */
199Static 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#define MAXKEYS (MAXMOD+2*MAXKEYCODE)
238
239struct ukbd_softc {
240	struct uhidev sc_hdev;
241
242	struct ukbd_data sc_ndata;
243	struct ukbd_data sc_odata;
244	struct hid_location sc_modloc[MAXMOD];
245	u_int sc_nmod;
246	struct {
247		uint32_t mask;
248		uint8_t key;
249	} sc_mods[MAXMOD];
250
251	struct hid_location sc_keycodeloc;
252	u_int sc_nkeycode;
253
254	u_int sc_flags;			/* flags */
255#define FLAG_ENABLED		0x0001
256#define FLAG_POLLING		0x0002
257#define FLAG_DEBOUNCE		0x0004	/* for quirk handling */
258#define FLAG_APPLE_FIX_ISO	0x0008
259#define FLAG_APPLE_FN		0x0010
260#define FLAG_GDIUM_FN		0x0020
261#define FLAG_FN_PRESSED		0x0100	/* FN key is held down */
262#define FLAG_FN_ALT		0x0200	/* Last Alt key was FN-Alt = AltGr */
263
264	int sc_console_keyboard;	/* we are the console keyboard */
265
266	struct callout sc_delay;	/* for quirk handling */
267	struct ukbd_data sc_data;	/* for quirk handling */
268
269	struct hid_location sc_apple_fn;
270	struct hid_location sc_numloc;
271	struct hid_location sc_capsloc;
272	struct hid_location sc_scroloc;
273	struct hid_location sc_compose;
274	int sc_leds;
275	struct usb_task sc_ledtask;
276	device_t sc_wskbddev;
277
278#if defined(WSDISPLAY_COMPAT_RAWKBD)
279	int sc_rawkbd;
280#if defined(UKBD_REPEAT)
281	struct callout sc_rawrepeat_ch;
282#define REP_DELAY1 400
283#define REP_DELAYN 100
284	int sc_nrep;
285	char sc_rep[MAXKEYS];
286#endif /* defined(UKBD_REPEAT) */
287#endif /* defined(WSDISPLAY_COMPAT_RAWKBD) */
288
289	int sc_spl;
290	int sc_npollchar;
291	uint16_t sc_pollchars[MAXKEYS];
292
293	u_char sc_dying;
294};
295
296#ifdef UKBD_DEBUG
297#define UKBDTRACESIZE 64
298struct ukbdtraceinfo {
299	int unit;
300	struct timeval tv;
301	struct ukbd_data ud;
302};
303struct ukbdtraceinfo ukbdtracedata[UKBDTRACESIZE];
304int ukbdtraceindex = 0;
305int ukbdtrace = 0;
306void ukbdtracedump(void);
307void
308ukbdtracedump(void)
309{
310	int i;
311	for (i = 0; i < UKBDTRACESIZE; i++) {
312		struct ukbdtraceinfo *p =
313		    &ukbdtracedata[(i+ukbdtraceindex)%UKBDTRACESIZE];
314		printf("%"PRIu64".%06"PRIu64": mod=0x%02x key0=0x%02x key1=0x%02x "
315		       "key2=0x%02x key3=0x%02x\n",
316		       p->tv.tv_sec, (uint64_t)p->tv.tv_usec,
317		       p->ud.modifiers, p->ud.keycode[0], p->ud.keycode[1],
318		       p->ud.keycode[2], p->ud.keycode[3]);
319	}
320}
321#endif
322
323#define	UKBDUNIT(dev)	(minor(dev))
324#define	UKBD_CHUNK	128	/* chunk size for read */
325#define	UKBD_BSIZE	1020	/* buffer size */
326
327Static int	ukbd_is_console;
328
329Static void	ukbd_cngetc(void *, u_int *, int *);
330Static void	ukbd_cnpollc(void *, int);
331
332const struct wskbd_consops ukbd_consops = {
333	.getc =  ukbd_cngetc,
334	.pollc = ukbd_cnpollc,
335	.bell =  NULL,
336};
337
338Static const char *ukbd_parse_desc(struct ukbd_softc *);
339
340Static void	ukbd_intr(struct uhidev *, void *, u_int);
341Static void	ukbd_decode(struct ukbd_softc *, struct ukbd_data *);
342Static void	ukbd_delayed_decode(void *);
343
344Static int	ukbd_enable(void *, int);
345Static void	ukbd_set_leds(void *, int);
346Static void	ukbd_set_leds_task(void *);
347
348Static int	ukbd_ioctl(void *, u_long, void *, int, struct lwp *);
349#if  defined(WSDISPLAY_COMPAT_RAWKBD) && defined(UKBD_REPEAT)
350Static void	ukbd_rawrepeat(void *v);
351#endif
352
353const struct wskbd_accessops ukbd_accessops = {
354	ukbd_enable,
355	ukbd_set_leds,
356	ukbd_ioctl,
357};
358
359extern const struct wscons_keydesc ukbd_keydesctab[];
360
361const struct wskbd_mapdata ukbd_keymapdata = {
362	ukbd_keydesctab,
363#if defined(UKBD_LAYOUT)
364	UKBD_LAYOUT,
365#elif defined(PCKBD_LAYOUT)
366	PCKBD_LAYOUT,
367#else
368	KB_US,
369#endif
370};
371
372static int ukbd_match(device_t, cfdata_t, void *);
373static void ukbd_attach(device_t, device_t, void *);
374static int ukbd_detach(device_t, int);
375static int ukbd_activate(device_t, enum devact);
376static void ukbd_childdet(device_t, device_t);
377
378extern struct cfdriver ukbd_cd;
379
380CFATTACH_DECL2_NEW(ukbd, sizeof(struct ukbd_softc), ukbd_match, ukbd_attach,
381    ukbd_detach, ukbd_activate, NULL, ukbd_childdet);
382
383int
384ukbd_match(device_t parent, cfdata_t match, void *aux)
385{
386	struct uhidev_attach_arg *uha = aux;
387	int size;
388	void *desc;
389
390	uhidev_get_report_desc(uha->parent, &desc, &size);
391	if (!hid_is_collection(desc, size, uha->reportid,
392			       HID_USAGE2(HUP_GENERIC_DESKTOP, HUG_KEYBOARD)))
393		return UMATCH_NONE;
394
395	return UMATCH_IFACECLASS;
396}
397
398void
399ukbd_attach(device_t parent, device_t self, void *aux)
400{
401	struct ukbd_softc *sc = device_private(self);
402	struct uhidev_attach_arg *uha = aux;
403	uint32_t qflags;
404	const char *parseerr;
405	struct wskbddev_attach_args a;
406
407	sc->sc_hdev.sc_dev = self;
408	sc->sc_hdev.sc_intr = ukbd_intr;
409	sc->sc_hdev.sc_parent = uha->parent;
410	sc->sc_hdev.sc_report_id = uha->reportid;
411	sc->sc_flags = 0;
412
413	aprint_naive("\n");
414
415	if (!pmf_device_register(self, NULL, NULL)) {
416		aprint_normal("\n");
417		aprint_error_dev(self, "couldn't establish power handler\n");
418	}
419
420	parseerr = ukbd_parse_desc(sc);
421	if (parseerr != NULL) {
422		aprint_normal("\n");
423		aprint_error_dev(self, "attach failed, %s\n", parseerr);
424		return;
425	}
426
427	/* Quirks */
428	qflags = usbd_get_quirks(uha->parent->sc_udev)->uq_flags;
429	if (qflags & UQ_SPUR_BUT_UP)
430		sc->sc_flags |= FLAG_DEBOUNCE;
431	if (qflags & UQ_APPLE_ISO)
432		sc->sc_flags |= FLAG_APPLE_FIX_ISO;
433
434#ifdef GDIUM_KEYBOARD_HACK
435	if (uha->uiaa->uiaa_vendor == USB_VENDOR_CYPRESS &&
436	    uha->uiaa->uiaa_product == USB_PRODUCT_CYPRESS_LPRDK)
437		sc->sc_flags = FLAG_GDIUM_FN;
438#endif
439
440#ifdef DIAGNOSTIC
441	aprint_normal(": %d modifier keys, %d key codes", sc->sc_nmod,
442	       sc->sc_nkeycode);
443	if (sc->sc_flags & FLAG_APPLE_FN)
444		aprint_normal(", apple fn key");
445	if (sc->sc_flags & FLAG_APPLE_FIX_ISO)
446		aprint_normal(", fix apple iso");
447	if (sc->sc_flags & FLAG_GDIUM_FN)
448		aprint_normal(", Gdium fn key");
449#endif
450	aprint_normal("\n");
451
452	/*
453	 * Remember if we're the console keyboard.
454	 *
455	 * XXX This always picks the first keyboard on the
456	 * first USB bus, but what else can we really do?
457	 */
458	if ((sc->sc_console_keyboard = ukbd_is_console) != 0) {
459		/* Don't let any other keyboard have it. */
460		ukbd_is_console = 0;
461	}
462
463	if (sc->sc_console_keyboard) {
464		DPRINTF(("ukbd_attach: console keyboard sc=%p\n", sc));
465		wskbd_cnattach(&ukbd_consops, sc, &ukbd_keymapdata);
466		ukbd_enable(sc, 1);
467	}
468
469	a.console = sc->sc_console_keyboard;
470
471	a.keymap = &ukbd_keymapdata;
472
473	a.accessops = &ukbd_accessops;
474	a.accesscookie = sc;
475
476#ifdef UKBD_REPEAT
477	callout_init(&sc->sc_rawrepeat_ch, 0);
478#endif
479
480	callout_init(&sc->sc_delay, 0);
481
482	usb_init_task(&sc->sc_ledtask, ukbd_set_leds_task, sc, 0);
483
484	/* Flash the leds; no real purpose, just shows we're alive. */
485	ukbd_set_leds(sc, WSKBD_LED_SCROLL | WSKBD_LED_NUM | WSKBD_LED_CAPS
486			| WSKBD_LED_COMPOSE);
487	usbd_delay_ms(uha->parent->sc_udev, 400);
488	ukbd_set_leds(sc, 0);
489
490	sc->sc_wskbddev = config_found(self, &a, wskbddevprint);
491
492	return;
493}
494
495int
496ukbd_enable(void *v, int on)
497{
498	struct ukbd_softc *sc = v;
499
500	if (on && sc->sc_dying)
501		return EIO;
502
503	/* Should only be called to change state */
504	if ((sc->sc_flags & FLAG_ENABLED) != 0 && on != 0) {
505#ifdef DIAGNOSTIC
506		printf("ukbd_enable: %s: bad call on=%d\n",
507		       device_xname(sc->sc_hdev.sc_dev), on);
508#endif
509		return EBUSY;
510	}
511
512	DPRINTF(("ukbd_enable: sc=%p on=%d\n", sc, on));
513	if (on) {
514		sc->sc_flags |= FLAG_ENABLED;
515		return uhidev_open(&sc->sc_hdev);
516	} else {
517		sc->sc_flags &= ~FLAG_ENABLED;
518		uhidev_close(&sc->sc_hdev);
519		return 0;
520	}
521}
522
523
524static void
525ukbd_childdet(device_t self, device_t child)
526{
527	struct ukbd_softc *sc = device_private(self);
528
529	KASSERT(sc->sc_wskbddev == child);
530	sc->sc_wskbddev = NULL;
531}
532
533int
534ukbd_activate(device_t self, enum devact act)
535{
536	struct ukbd_softc *sc = device_private(self);
537
538	switch (act) {
539	case DVACT_DEACTIVATE:
540		sc->sc_dying = 1;
541		return 0;
542	default:
543		return EOPNOTSUPP;
544	}
545}
546
547int
548ukbd_detach(device_t self, int flags)
549{
550	struct ukbd_softc *sc = device_private(self);
551	int rv = 0;
552
553	DPRINTF(("ukbd_detach: sc=%p flags=%d\n", sc, flags));
554
555	pmf_device_deregister(self);
556
557	if (sc->sc_console_keyboard) {
558#if 0
559		/*
560		 * XXX Should probably disconnect our consops,
561		 * XXX and either notify some other keyboard that
562		 * XXX it can now be the console, or if there aren't
563		 * XXX any more USB keyboards, set ukbd_is_console
564		 * XXX back to 1 so that the next USB keyboard attached
565		 * XXX to the system will get it.
566		 */
567		panic("ukbd_detach: console keyboard");
568#else
569		/*
570		 * Disconnect our consops and set ukbd_is_console
571		 * back to 1 so that the next USB keyboard attached
572		 * to the system will get it.
573		 * XXX Should notify some other keyboard that it can be
574		 * XXX console, if there are any other keyboards.
575		 */
576		printf("%s: was console keyboard\n",
577		       device_xname(sc->sc_hdev.sc_dev));
578		wskbd_cndetach();
579		ukbd_is_console = 1;
580#endif
581	}
582	/* No need to do reference counting of ukbd, wskbd has all the goo. */
583	if (sc->sc_wskbddev != NULL)
584		rv = config_detach(sc->sc_wskbddev, flags);
585
586	/* The console keyboard does not get a disable call, so check pipe. */
587	if (sc->sc_hdev.sc_state & UHIDEV_OPEN)
588		uhidev_close(&sc->sc_hdev);
589
590	return rv;
591}
592
593static void
594ukbd_translate_keycodes(struct ukbd_softc *sc, struct ukbd_data *ud,
595    const struct ukbd_keycodetrans *tab)
596{
597	const struct ukbd_keycodetrans *tp;
598	int i;
599	uint8_t key;
600
601	for (i = 0; i < sc->sc_nkeycode; i++) {
602		key = ud->keycode[i];
603		if (key)
604			for (tp = tab; tp->from; tp++)
605				if (tp->from == key) {
606					if (tp->to & IS_PMF) {
607						pmf_event_inject(
608						    sc->sc_hdev.sc_dev,
609						    tp->to & 0xff);
610						ud->keycode[i] = 0;
611					} else
612						ud->keycode[i] = tp->to;
613					break;
614				}
615	}
616}
617
618static uint16_t
619ukbd_translate_modifier(struct ukbd_softc *sc, uint16_t key)
620{
621	if ((sc->sc_flags & FLAG_APPLE_FN) && (key & CODEMASK) == 0x00e2) {
622		if ((key & ~CODEMASK) == PRESS) {
623			if (sc->sc_flags & FLAG_FN_PRESSED) {
624				/* pressed FN-Alt, translate to AltGr */
625				key = 0x00e6 | PRESS;
626				sc->sc_flags |= FLAG_FN_ALT;
627			}
628		} else {
629			if (sc->sc_flags & FLAG_FN_ALT) {
630				/* released Alt, which was treated as FN-Alt */
631				key = 0x00e6 | RELEASE;
632				sc->sc_flags &= ~FLAG_FN_ALT;
633			}
634		}
635	}
636	return key;
637}
638
639void
640ukbd_intr(struct uhidev *addr, void *ibuf, u_int len)
641{
642	struct ukbd_softc *sc = (struct ukbd_softc *)addr;
643	struct ukbd_data *ud = &sc->sc_ndata;
644	int i;
645
646#ifdef UKBD_DEBUG
647	if (ukbddebug > 5) {
648		printf("ukbd_intr: data");
649		for (i = 0; i < len; i++)
650			printf(" 0x%02x", ((u_char *)ibuf)[i]);
651		printf("\n");
652	}
653#endif
654
655	ud->modifiers = 0;
656	for (i = 0; i < sc->sc_nmod; i++)
657		if (hid_get_data(ibuf, &sc->sc_modloc[i]))
658			ud->modifiers |= sc->sc_mods[i].mask;
659	memcpy(ud->keycode, (char *)ibuf + sc->sc_keycodeloc.pos / 8,
660	       sc->sc_nkeycode);
661
662	if (sc->sc_flags & FLAG_APPLE_FN) {
663		if (hid_get_data(ibuf, &sc->sc_apple_fn)) {
664			sc->sc_flags |= FLAG_FN_PRESSED;
665			ukbd_translate_keycodes(sc, ud, trtab_apple_fn);
666		}
667		else
668			sc->sc_flags &= ~FLAG_FN_PRESSED;
669	}
670
671#ifdef GDIUM_KEYBOARD_HACK
672	if (sc->sc_flags & FLAG_GDIUM_FN) {
673		if (sc->sc_flags & FLAG_FN_PRESSED) {
674			ukbd_translate_keycodes(sc, ud, trtab_gdium_fn);
675		}
676	}
677#endif
678
679	ukbd_translate_keycodes(sc, ud, trtab_generic);
680
681	if ((sc->sc_flags & FLAG_DEBOUNCE) && !(sc->sc_flags & FLAG_POLLING)) {
682		/*
683		 * Some keyboards have a peculiar quirk.  They sometimes
684		 * generate a key up followed by a key down for the same
685		 * key after about 10 ms.
686		 * We avoid this bug by holding off decoding for 20 ms.
687		 */
688		sc->sc_data = *ud;
689		callout_reset(&sc->sc_delay, hz / 50, ukbd_delayed_decode, sc);
690#ifdef DDB
691	} else if (sc->sc_console_keyboard && !(sc->sc_flags & FLAG_POLLING)) {
692		/*
693		 * For the console keyboard we can't deliver CTL-ALT-ESC
694		 * from the interrupt routine.  Doing so would start
695		 * polling from inside the interrupt routine and that
696		 * loses bigtime.
697		 */
698		sc->sc_data = *ud;
699		callout_reset(&sc->sc_delay, 1, ukbd_delayed_decode, sc);
700#endif
701	} else {
702		ukbd_decode(sc, ud);
703	}
704}
705
706void
707ukbd_delayed_decode(void *addr)
708{
709	struct ukbd_softc *sc = addr;
710
711	ukbd_decode(sc, &sc->sc_data);
712}
713
714void
715ukbd_decode(struct ukbd_softc *sc, struct ukbd_data *ud)
716{
717	int mod, omod;
718	uint16_t ibuf[MAXKEYS];	/* chars events */
719	int s;
720	int nkeys, i, j;
721	int key;
722#define ADDKEY(c) do { \
723    KASSERT(nkeys < MAXKEYS); \
724    ibuf[nkeys++] = (c); \
725} while (0)
726
727#ifdef UKBD_DEBUG
728	/*
729	 * Keep a trace of the last events.  Using printf changes the
730	 * timing, so this can be useful sometimes.
731	 */
732	if (ukbdtrace) {
733		struct ukbdtraceinfo *p = &ukbdtracedata[ukbdtraceindex];
734		p->unit = device_unit(sc->sc_hdev.sc_dev);
735		microtime(&p->tv);
736		p->ud = *ud;
737		if (++ukbdtraceindex >= UKBDTRACESIZE)
738			ukbdtraceindex = 0;
739	}
740	if (ukbddebug > 5) {
741		struct timeval tv;
742		microtime(&tv);
743		DPRINTF((" at %"PRIu64".%06"PRIu64"  mod=0x%02x key0=0x%02x key1=0x%02x "
744			 "key2=0x%02x key3=0x%02x\n",
745			 tv.tv_sec, (uint64_t)tv.tv_usec,
746			 ud->modifiers, ud->keycode[0], ud->keycode[1],
747			 ud->keycode[2], ud->keycode[3]));
748	}
749#endif
750
751	if (ud->keycode[0] == KEY_ERROR) {
752		DPRINTF(("ukbd_intr: KEY_ERROR\n"));
753		return;		/* ignore  */
754	}
755
756	if (sc->sc_flags & FLAG_APPLE_FIX_ISO)
757		ukbd_translate_keycodes(sc, ud, trtab_apple_iso);
758
759	nkeys = 0;
760	mod = ud->modifiers;
761	omod = sc->sc_odata.modifiers;
762	if (mod != omod)
763		for (i = 0; i < sc->sc_nmod; i++)
764			if (( mod & sc->sc_mods[i].mask) !=
765			    (omod & sc->sc_mods[i].mask)) {
766				key = sc->sc_mods[i].key |
767				    ((mod & sc->sc_mods[i].mask) ?
768				    PRESS : RELEASE);
769				ADDKEY(ukbd_translate_modifier(sc, key));
770			}
771	if (memcmp(ud->keycode, sc->sc_odata.keycode, sc->sc_nkeycode) != 0) {
772		/* Check for released keys. */
773		for (i = 0; i < sc->sc_nkeycode; i++) {
774			key = sc->sc_odata.keycode[i];
775			if (key == 0)
776				continue;
777			for (j = 0; j < sc->sc_nkeycode; j++)
778				if (key == ud->keycode[j])
779					goto rfound;
780			DPRINTFN(3,("ukbd_intr: relse key=0x%02x\n", key));
781#ifdef GDIUM_KEYBOARD_HACK
782			if (sc->sc_flags & FLAG_GDIUM_FN) {
783				if (key == 0x82) {
784					sc->sc_flags &= ~FLAG_FN_PRESSED;
785					goto rfound;
786				}
787			}
788#endif
789			ADDKEY(key | RELEASE);
790		rfound:
791			;
792		}
793
794		/* Check for pressed keys. */
795		for (i = 0; i < sc->sc_nkeycode; i++) {
796			key = ud->keycode[i];
797			if (key == 0)
798				continue;
799			for (j = 0; j < sc->sc_nkeycode; j++)
800				if (key == sc->sc_odata.keycode[j])
801					goto pfound;
802			DPRINTFN(2,("ukbd_intr: press key=0x%02x\n", key));
803#ifdef GDIUM_KEYBOARD_HACK
804			if (sc->sc_flags & FLAG_GDIUM_FN) {
805				if (key == 0x82) {
806					sc->sc_flags |= FLAG_FN_PRESSED;
807					goto pfound;
808				}
809			}
810#endif
811			ADDKEY(key | PRESS);
812		pfound:
813			;
814		}
815	}
816	sc->sc_odata = *ud;
817
818	if (nkeys == 0)
819		return;
820
821	if (sc->sc_flags & FLAG_POLLING) {
822		DPRINTFN(1,("ukbd_intr: pollchar = 0x%03x\n", ibuf[0]));
823		memcpy(sc->sc_pollchars, ibuf, nkeys * sizeof(uint16_t));
824		sc->sc_npollchar = nkeys;
825		return;
826	}
827#ifdef WSDISPLAY_COMPAT_RAWKBD
828	if (sc->sc_rawkbd) {
829		u_char cbuf[MAXKEYS * 2];
830		int c;
831#if defined(UKBD_REPEAT)
832		int npress = 0;
833#endif
834
835		for (i = j = 0; i < nkeys; i++) {
836			key = ibuf[i];
837			c = ukbd_trtab[key & CODEMASK];
838			if (c == NN)
839				continue;
840			if (c == 0x7f) {
841				/* pause key */
842				cbuf[j++] = 0xe1;
843				cbuf[j++] = 0x1d;
844				cbuf[j-1] |= (key & RELEASE) ? 0x80 : 0;
845				cbuf[j] = 0x45;
846			} else {
847				if (c & 0x80)
848					cbuf[j++] = 0xe0;
849				cbuf[j] = c & 0x7f;
850			}
851			if (key & RELEASE)
852				cbuf[j] |= 0x80;
853#if defined(UKBD_REPEAT)
854			else {
855				/* remember pressed keys for autorepeat */
856				if (c & 0x80)
857					sc->sc_rep[npress++] = 0xe0;
858				sc->sc_rep[npress++] = c & 0x7f;
859			}
860#endif
861			DPRINTFN(1,("ukbd_intr: raw = %s0x%02x\n",
862				    c & 0x80 ? "0xe0 " : "",
863				    cbuf[j]));
864			j++;
865		}
866		s = spltty();
867		wskbd_rawinput(sc->sc_wskbddev, cbuf, j);
868		splx(s);
869#ifdef UKBD_REPEAT
870		callout_stop(&sc->sc_rawrepeat_ch);
871		if (npress != 0) {
872			sc->sc_nrep = npress;
873			callout_reset(&sc->sc_rawrepeat_ch,
874			    hz * REP_DELAY1 / 1000, ukbd_rawrepeat, sc);
875		}
876#endif
877		return;
878	}
879#endif
880
881	s = spltty();
882	for (i = 0; i < nkeys; i++) {
883		key = ibuf[i];
884		wskbd_input(sc->sc_wskbddev,
885		    key&RELEASE ? WSCONS_EVENT_KEY_UP : WSCONS_EVENT_KEY_DOWN,
886		    key&CODEMASK);
887	}
888	splx(s);
889}
890
891void
892ukbd_set_leds(void *v, int leds)
893{
894	struct ukbd_softc *sc = v;
895	struct usbd_device *udev = sc->sc_hdev.sc_parent->sc_udev;
896
897	DPRINTF(("ukbd_set_leds: sc=%p leds=%d, sc_leds=%d\n",
898		 sc, leds, sc->sc_leds));
899
900	if (sc->sc_dying)
901		return;
902
903	if (sc->sc_leds == leds)
904		return;
905
906	sc->sc_leds = leds;
907	usb_add_task(udev, &sc->sc_ledtask, USB_TASKQ_DRIVER);
908}
909
910void
911ukbd_set_leds_task(void *v)
912{
913	struct ukbd_softc *sc = v;
914	int leds = sc->sc_leds;
915	uint8_t res = 0;
916
917	/* XXX not really right */
918	if ((leds & WSKBD_LED_COMPOSE) && sc->sc_compose.size == 1)
919		res |= 1 << sc->sc_compose.pos;
920	if ((leds & WSKBD_LED_SCROLL) && sc->sc_scroloc.size == 1)
921		res |= 1 << sc->sc_scroloc.pos;
922	if ((leds & WSKBD_LED_NUM) && sc->sc_numloc.size == 1)
923		res |= 1 << sc->sc_numloc.pos;
924	if ((leds & WSKBD_LED_CAPS) && sc->sc_capsloc.size == 1)
925		res |= 1 << sc->sc_capsloc.pos;
926
927	uhidev_set_report(&sc->sc_hdev, UHID_OUTPUT_REPORT, &res, 1);
928}
929
930#if defined(WSDISPLAY_COMPAT_RAWKBD) && defined(UKBD_REPEAT)
931void
932ukbd_rawrepeat(void *v)
933{
934	struct ukbd_softc *sc = v;
935	int s;
936
937	s = spltty();
938	wskbd_rawinput(sc->sc_wskbddev, sc->sc_rep, sc->sc_nrep);
939	splx(s);
940	callout_reset(&sc->sc_rawrepeat_ch, hz * REP_DELAYN / 1000,
941	    ukbd_rawrepeat, sc);
942}
943#endif /* defined(WSDISPLAY_COMPAT_RAWKBD) && defined(UKBD_REPEAT) */
944
945int
946ukbd_ioctl(void *v, u_long cmd, void *data, int flag,
947    struct lwp *l)
948{
949	struct ukbd_softc *sc = v;
950
951	switch (cmd) {
952	case WSKBDIO_GTYPE:
953		*(int *)data = WSKBD_TYPE_USB;
954		return 0;
955	case WSKBDIO_SETLEDS:
956		ukbd_set_leds(v, *(int *)data);
957		return 0;
958	case WSKBDIO_GETLEDS:
959		*(int *)data = sc->sc_leds;
960		return 0;
961#if defined(WSDISPLAY_COMPAT_RAWKBD)
962	case WSKBDIO_SETMODE:
963		DPRINTF(("ukbd_ioctl: set raw = %d\n", *(int *)data));
964		sc->sc_rawkbd = *(int *)data == WSKBD_RAW;
965#if defined(UKBD_REPEAT)
966		callout_stop(&sc->sc_rawrepeat_ch);
967#endif
968		return 0;
969#endif
970	}
971	return EPASSTHROUGH;
972}
973
974/*
975 * This is a hack to work around some broken ports that don't call
976 * cnpollc() before cngetc().
977 */
978static int pollenter, warned;
979
980/* Console interface. */
981void
982ukbd_cngetc(void *v, u_int *type, int *data)
983{
984	struct ukbd_softc *sc = v;
985	int c;
986	int broken;
987
988	if (pollenter == 0) {
989		if (!warned) {
990			printf("\n"
991"This port is broken, it does not call cnpollc() before calling cngetc().\n"
992"This should be fixed, but it will work anyway (for now).\n");
993			warned = 1;
994		}
995		broken = 1;
996		ukbd_cnpollc(v, 1);
997	} else
998		broken = 0;
999
1000	DPRINTFN(0,("ukbd_cngetc: enter\n"));
1001	sc->sc_flags |= FLAG_POLLING;
1002	while (sc->sc_npollchar <= 0)
1003		usbd_dopoll(sc->sc_hdev.sc_parent->sc_iface);
1004	sc->sc_flags &= ~FLAG_POLLING;
1005	c = sc->sc_pollchars[0];
1006	sc->sc_npollchar--;
1007	memcpy(sc->sc_pollchars, sc->sc_pollchars+1,
1008	       sc->sc_npollchar * sizeof(uint16_t));
1009	*type = c & RELEASE ? WSCONS_EVENT_KEY_UP : WSCONS_EVENT_KEY_DOWN;
1010	*data = c & CODEMASK;
1011	DPRINTFN(0,("ukbd_cngetc: return 0x%02x\n", c));
1012	if (broken)
1013		ukbd_cnpollc(v, 0);
1014}
1015
1016void
1017ukbd_cnpollc(void *v, int on)
1018{
1019	struct ukbd_softc *sc = v;
1020	struct usbd_device *dev;
1021
1022	DPRINTFN(2,("ukbd_cnpollc: sc=%p on=%d\n", v, on));
1023
1024	usbd_interface2device_handle(sc->sc_hdev.sc_parent->sc_iface, &dev);
1025	if (on) {
1026		sc->sc_spl = splusb();
1027		pollenter++;
1028	} else {
1029		splx(sc->sc_spl);
1030		pollenter--;
1031	}
1032	usbd_set_polling(dev, on);
1033}
1034
1035int
1036ukbd_cnattach(void)
1037{
1038
1039	/*
1040	 * XXX USB requires too many parts of the kernel to be running
1041	 * XXX in order to work, so we can't do much for the console
1042	 * XXX keyboard until autconfiguration has run its course.
1043	 */
1044	ukbd_is_console = 1;
1045	return 0;
1046}
1047
1048const char *
1049ukbd_parse_desc(struct ukbd_softc *sc)
1050{
1051	struct hid_data *d;
1052	struct hid_item h;
1053	int size;
1054	void *desc;
1055	int imod;
1056
1057	uhidev_get_report_desc(sc->sc_hdev.sc_parent, &desc, &size);
1058	imod = 0;
1059	sc->sc_nkeycode = 0;
1060	d = hid_start_parse(desc, size, hid_input);
1061	while (hid_get_item(d, &h)) {
1062		/*printf("ukbd: id=%d kind=%d usage=0x%x flags=0x%x pos=%d size=%d cnt=%d\n",
1063		  h.report_ID, h.kind, h.usage, h.flags, h.loc.pos, h.loc.size, h.loc.count);*/
1064
1065		/* Check for special Apple notebook FN key */
1066		if (HID_GET_USAGE_PAGE(h.usage) == 0x00ff &&
1067		    HID_GET_USAGE(h.usage) == 0x0003 &&
1068		    h.kind == hid_input && (h.flags & HIO_VARIABLE)) {
1069			sc->sc_flags |= FLAG_APPLE_FN;
1070			sc->sc_apple_fn = h.loc;
1071		}
1072
1073		if (h.kind != hid_input || (h.flags & HIO_CONST) ||
1074		    HID_GET_USAGE_PAGE(h.usage) != HUP_KEYBOARD ||
1075		    h.report_ID != sc->sc_hdev.sc_report_id)
1076			continue;
1077		DPRINTF(("ukbd: imod=%d usage=0x%x flags=0x%x pos=%d size=%d "
1078			 "cnt=%d\n", imod,
1079			 h.usage, h.flags, h.loc.pos, h.loc.size, h.loc.count));
1080		if (h.flags & HIO_VARIABLE) {
1081			if (h.loc.size != 1)
1082				return "bad modifier size";
1083			/* Single item */
1084			if (imod < MAXMOD) {
1085				sc->sc_modloc[imod] = h.loc;
1086				sc->sc_mods[imod].mask = 1 << imod;
1087				sc->sc_mods[imod].key = HID_GET_USAGE(h.usage);
1088				imod++;
1089			} else
1090				return "too many modifier keys";
1091		} else {
1092			/* Array */
1093			if (h.loc.size != 8)
1094				return "key code size != 8";
1095			if (h.loc.count > MAXKEYCODE)
1096				h.loc.count = MAXKEYCODE;
1097			if (h.loc.pos % 8 != 0)
1098				return "key codes not on byte boundary";
1099			if (sc->sc_nkeycode != 0)
1100				return "multiple key code arrays";
1101			sc->sc_keycodeloc = h.loc;
1102			sc->sc_nkeycode = h.loc.count;
1103		}
1104	}
1105	sc->sc_nmod = imod;
1106	hid_end_parse(d);
1107
1108	hid_locate(desc, size, HID_USAGE2(HUP_LEDS, HUD_LED_NUM_LOCK),
1109		   sc->sc_hdev.sc_report_id, hid_output, &sc->sc_numloc, NULL);
1110	hid_locate(desc, size, HID_USAGE2(HUP_LEDS, HUD_LED_CAPS_LOCK),
1111		   sc->sc_hdev.sc_report_id, hid_output, &sc->sc_capsloc, NULL);
1112	hid_locate(desc, size, HID_USAGE2(HUP_LEDS, HUD_LED_SCROLL_LOCK),
1113		   sc->sc_hdev.sc_report_id, hid_output, &sc->sc_scroloc, NULL);
1114	hid_locate(desc, size, HID_USAGE2(HUP_LEDS, HUD_LED_COMPOSE),
1115		   sc->sc_hdev.sc_report_id, hid_output, &sc->sc_compose, NULL);
1116
1117	return NULL;
1118}
1119