ukbd.c revision 1.6 1 /* $NetBSD: ukbd.c,v 1.6 1998/08/01 18:16:19 augustss Exp $ */
2
3 /*
4 * Copyright (c) 1998 The NetBSD Foundation, Inc.
5 * All rights reserved.
6 *
7 * Author: Lennart Augustsson <augustss (at) carlstedt.se>
8 * Carlstedt Research & Technology
9 *
10 * Redistribution and use in source and binary forms, with or without
11 * modification, are permitted provided that the following conditions
12 * are met:
13 * 1. Redistributions of source code must retain the above copyright
14 * notice, this list of conditions and the following disclaimer.
15 * 2. Redistributions in binary form must reproduce the above copyright
16 * notice, this list of conditions and the following disclaimer in the
17 * documentation and/or other materials provided with the distribution.
18 * 3. All advertising materials mentioning features or use of this software
19 * must display the following acknowledgement:
20 * This product includes software developed by the NetBSD
21 * Foundation, Inc. and its contributors.
22 * 4. Neither the name of The NetBSD Foundation nor the names of its
23 * contributors may be used to endorse or promote products derived
24 * from this software without specific prior written permission.
25 *
26 * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
27 * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
28 * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
29 * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
30 * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
31 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
32 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
33 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
34 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
35 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
36 * POSSIBILITY OF SUCH DAMAGE.
37 */
38
39
40 #include <sys/param.h>
41 #include <sys/systm.h>
42 #include <sys/kernel.h>
43 #include <sys/malloc.h>
44 #include <sys/device.h>
45 #include <sys/ioctl.h>
46 #include <sys/tty.h>
47 #include <sys/file.h>
48 #include <sys/select.h>
49 #include <sys/proc.h>
50 #include <sys/vnode.h>
51 #include <sys/device.h>
52 #include <sys/poll.h>
53
54 #include <dev/usb/usb.h>
55 #include <dev/usb/usbhid.h>
56 #include <dev/usb/usbdi.h>
57 #include <dev/usb/usbdi_util.h>
58 #include <dev/usb/usbdevs.h>
59 #include <dev/usb/usb_quirks.h>
60 #include <dev/usb/hid.h>
61
62 #include <dev/wscons/wsconsio.h>
63 #include <dev/wscons/wskbdvar.h>
64 #include <dev/wscons/wsksymdef.h>
65 #include <dev/wscons/wsksymvar.h>
66 #include <dev/wscons/wskbdmap_mfii.h>
67
68 #include "opt_pckbd_layout.h"
69 #include "opt_wsdisplay_compat.h"
70
71 #ifdef USB_DEBUG
72 #define DPRINTF(x) if (ukbddebug) printf x
73 #define DPRINTFN(n,x) if (ukbddebug>(n)) printf x
74 int ukbddebug = 0;
75 #else
76 #define DPRINTF(x)
77 #define DPRINTFN(n,x)
78 #endif
79
80 #define UPROTO_BOOT_KEYBOARD 1
81
82 #define NKEYCODE 6
83
84 #define NUM_LOCK 0x01
85 #define CAPS_LOCK 0x02
86 #define SCROLL_LOCK 0x04
87
88 struct ukbd_data {
89 u_int8_t modifiers;
90 #define MOD_CONTROL_L 0x01
91 #define MOD_CONTROL_R 0x10
92 #define MOD_SHIFT_L 0x02
93 #define MOD_SHIFT_R 0x20
94 #define MOD_ALT_L 0x04
95 #define MOD_ALT_R 0x40
96 #define MOD_WIN_L 0x08
97 #define MOD_WIN_R 0x80
98 u_int8_t reserved;
99 u_int8_t keycode[NKEYCODE];
100 };
101
102 #define PRESS 0
103 #define RELEASE 0x100
104
105 #define NMOD 6
106 static struct {
107 int mask, key;
108 } ukbd_mods[NMOD] = {
109 { MOD_CONTROL_L, 29 },
110 { MOD_CONTROL_R, 58 },
111 { MOD_SHIFT_L, 42 },
112 { MOD_SHIFT_R, 54 },
113 { MOD_ALT_L, 56 },
114 { MOD_ALT_R, 184 },
115 };
116
117 #define NN 0 /* no translation */
118 /* Translate USB keycodes to US keyboard AT scancodes. */
119 static u_int8_t ukbd_trtab[256] = {
120 0, 0, 0, 0, 30, 48, 46, 32, /* 00 - 07 */
121 18, 33, 34, 35, 23, 36, 37, 38, /* 08 - 0F */
122 50, 49, 24, 25, 16, 19, 31, 20, /* 10 - 17 */
123 22, 47, 17, 45, 21, 44, 2, 3, /* 18 - 1F */
124 4, 5, 6, 7, 8, 9, 10, 11, /* 20 - 27 */
125 28, 1, 14, 15, 57, 12, 13, 26, /* 28 - 2F */
126 27, 43, NN, 39, 40, 41, 51, 52, /* 30 - 37 */
127 53, 58, 59, 60, 61, 62, 63, 64, /* 38 - 3F */
128 65, 66, 67, 68, 87, 88, 170, 70, /* 40 - 47 */
129 127, 210, 199, 201, 211, 207, 209, 205, /* 48 - 4F */
130 203, 208, 200, 69, 181, 55, 74, 78, /* 50 - 57 */
131 156, 79, 80, 81, 75, 76, 77, 71, /* 58 - 5F */
132 72, 73, 82, 83, NN, NN, NN, NN, /* 60 - 67 */
133 NN, NN, NN, NN, NN, NN, NN, NN, /* 68 - 6F */
134 NN, NN, NN, NN, NN, NN, 221, NN, /* 70 - 77 */
135 NN, NN, NN, NN, NN, NN, NN, NN, /* 78 - 7F */
136 NN, NN, NN, NN, NN, NN, NN, NN, /* 80 - 87 */
137 NN, NN, NN, NN, NN, NN, NN, NN, /* 88 - 8F */
138 NN, NN, NN, NN, NN, NN, NN, NN, /* 90 - 97 */
139 NN, NN, NN, NN, NN, NN, NN, NN, /* 98 - 9F */
140 NN, NN, NN, NN, NN, NN, NN, NN, /* A0 - A7 */
141 NN, NN, NN, NN, NN, NN, NN, NN, /* A8 - AF */
142 NN, NN, NN, NN, NN, NN, NN, NN, /* B0 - B7 */
143 NN, NN, NN, NN, NN, NN, NN, NN, /* B8 - BF */
144 NN, NN, NN, NN, NN, NN, NN, NN, /* C0 - C7 */
145 NN, NN, NN, NN, NN, NN, NN, NN, /* C8 - CF */
146 NN, NN, NN, NN, NN, NN, NN, NN, /* D0 - D7 */
147 NN, NN, NN, NN, NN, NN, NN, NN, /* D8 - DF */
148 NN, NN, NN, NN, NN, NN, NN, NN, /* E0 - E7 */
149 NN, NN, NN, 219, NN, NN, NN, 220, /* E8 - EF */
150 NN, NN, NN, NN, NN, NN, NN, NN, /* F0 - F7 */
151 NN, NN, NN, NN, NN, NN, NN, NN, /* F8 - FF */
152 };
153
154 #define KEY_ERROR 0x01
155
156 struct ukbd_softc {
157 struct device sc_dev; /* base device */
158 usbd_interface_handle sc_iface; /* interface */
159 usbd_pipe_handle sc_intrpipe; /* interrupt pipe */
160 int sc_ep_addr;
161
162 struct ukbd_data sc_ndata;
163 struct ukbd_data sc_odata;
164
165 int sc_disconnected; /* device is gone */
166
167 int sc_leds;
168 struct device *sc_wskbddev;
169 #ifdef WSDISPLAY_COMPAT_RAWKBD
170 int sc_rawkbd;
171 #endif
172
173 int sc_polling;
174 int sc_pollchar;
175 };
176
177 #define UKBDUNIT(dev) (minor(dev))
178 #define UKBD_CHUNK 128 /* chunk size for read */
179 #define UKBD_BSIZE 1020 /* buffer size */
180
181 int ukbd_match __P((struct device *, struct cfdata *, void *));
182 void ukbd_attach __P((struct device *, struct device *, void *));
183
184 void ukbd_cngetc __P((void *, u_int *, int *));
185 void ukbd_cnpollc __P((void *, int));
186
187 void ukbd_intr __P((usbd_request_handle, usbd_private_handle, usbd_status));
188 void ukbd_disco __P((void *));
189
190 void ukbd_set_leds __P((void *, int));
191 int ukbd_ioctl __P((void *, u_long, caddr_t, int, struct proc *));
192
193 extern struct cfdriver ukbd_cd;
194
195 struct cfattach ukbd_ca = {
196 sizeof(struct ukbd_softc), ukbd_match, ukbd_attach
197 };
198
199 int
200 ukbd_match(parent, match, aux)
201 struct device *parent;
202 struct cfdata *match;
203 void *aux;
204 {
205 struct usb_attach_arg *uaa = (struct usb_attach_arg *)aux;
206 usb_interface_descriptor_t *id;
207
208 /* Check that this is a keyboard that speaks the boot protocol. */
209 if (!uaa->iface)
210 return (UMATCH_NONE);
211 id = usbd_get_interface_descriptor(uaa->iface);
212 if (id->bInterfaceClass != UCLASS_HID ||
213 id->bInterfaceSubClass != USUBCLASS_BOOT ||
214 id->bInterfaceProtocol != UPROTO_BOOT_KEYBOARD)
215 return (UMATCH_NONE);
216 return (UMATCH_IFACECLASS_IFACESUBCLASS_IFACEPROTO);
217 }
218
219 void
220 ukbd_attach(parent, self, aux)
221 struct device *parent;
222 struct device *self;
223 void *aux;
224 {
225 struct ukbd_softc *sc = (struct ukbd_softc *)self;
226 struct usb_attach_arg *uaa = aux;
227 usbd_interface_handle iface = uaa->iface;
228 usb_interface_descriptor_t *id;
229 usb_endpoint_descriptor_t *ed;
230 usbd_status r;
231 char devinfo[1024];
232 struct wskbddev_attach_args a;
233
234 sc->sc_disconnected = 1;
235 sc->sc_iface = iface;
236 id = usbd_get_interface_descriptor(iface);
237 usbd_devinfo(uaa->device, 0, devinfo);
238 printf(": %s (interface class %d/%d)\n", devinfo,
239 id->bInterfaceClass, id->bInterfaceSubClass);
240 ed = usbd_interface2endpoint_descriptor(iface, 0);
241 if (!ed) {
242 printf("%s: could not read endpoint descriptor\n",
243 sc->sc_dev.dv_xname);
244 return;
245 }
246
247 DPRINTFN(10,("ukbd_attach: \
248 bLength=%d bDescriptorType=%d bEndpointAddress=%d-%s bmAttributes=%d wMaxPacketSize=%d bInterval=%d\n",
249 ed->bLength, ed->bDescriptorType, ed->bEndpointAddress & UE_ADDR,
250 ed->bEndpointAddress & UE_IN ? "in" : "out",
251 ed->bmAttributes & UE_XFERTYPE,
252 UGETW(ed->wMaxPacketSize), ed->bInterval));
253
254 if ((ed->bEndpointAddress & UE_IN) != UE_IN ||
255 (ed->bmAttributes & UE_XFERTYPE) != UE_INTERRUPT) {
256 printf("%s: unexpected endpoint\n",
257 sc->sc_dev.dv_xname);
258 return;
259 }
260
261 if ((usbd_get_quirks(uaa->device)->uq_flags & UQ_NO_SET_PROTO) == 0) {
262 r = usbd_set_protocol(iface, 0);
263 DPRINTFN(5, ("ukbd_attach: protocol set\n"));
264 if (r != USBD_NORMAL_COMPLETION) {
265 printf("%s: set protocol failed\n",
266 sc->sc_dev.dv_xname);
267 return;
268 }
269 }
270 /* Ignore if SETIDLE fails since it is not crucial. */
271 usbd_set_idle(iface, 0, 0);
272
273 sc->sc_ep_addr = ed->bEndpointAddress;
274 sc->sc_disconnected = 0;
275
276 a.console = 0; /* XXX */
277 #ifdef PCKBD_LAYOUT
278 a.layout = PCKBD_LAYOUT;
279 #else
280 a.layout = KB_US;
281 #endif
282 a.keydesc = pckbd_keydesctab;
283 a.num_keydescs = sizeof(pckbd_keydesctab)/sizeof(pckbd_keydesctab[0]);
284 a.getc = ukbd_cngetc;
285 a.pollc = ukbd_cnpollc;
286 a.set_leds = ukbd_set_leds;
287 a.ioctl = ukbd_ioctl;
288 a.accesscookie = sc;
289 sc->sc_wskbddev = config_found(self, &a, wskbddevprint);
290
291 /* Set up interrupt pipe. */
292 r = usbd_open_pipe_intr(sc->sc_iface, sc->sc_ep_addr,
293 USBD_SHORT_XFER_OK,
294 &sc->sc_intrpipe, sc, &sc->sc_ndata,
295 sizeof(sc->sc_ndata), ukbd_intr);
296 if (r != USBD_NORMAL_COMPLETION) {
297 printf("%s: usbd_open_pipe_intr failed, error=%d\n",
298 sc->sc_dev.dv_xname, r);
299 return;
300 }
301 usbd_set_disco(sc->sc_intrpipe, ukbd_disco, sc);
302 }
303
304 void
305 ukbd_disco(p)
306 void *p;
307 {
308 struct ukbd_softc *sc = p;
309 sc->sc_disconnected = 1;
310 }
311
312 void
313 ukbd_intr(reqh, addr, status)
314 usbd_request_handle reqh;
315 usbd_private_handle addr;
316 usbd_status status;
317 {
318 struct ukbd_softc *sc = addr;
319 struct ukbd_data *ud = &sc->sc_ndata;
320 int mod, omod;
321 int ibuf[NMOD+2*NKEYCODE]; /* chars events */
322 int nkeys, i, j;
323 int key, c;
324 #define ADDKEY(c) ibuf[nkeys++] = (c)
325
326 DPRINTFN(5, ("ukbd_intr: status=%d\n", status));
327 if (status == USBD_CANCELLED)
328 return;
329
330 if (status != USBD_NORMAL_COMPLETION) {
331 DPRINTF(("ukbd_intr: status=%d\n", status));
332 usbd_clear_endpoint_stall_async(sc->sc_intrpipe);
333 return;
334 }
335
336 DPRINTFN(5, (" mod=0x%02x key0=0x%02x key1=0x%02x\n",
337 ud->modifiers, ud->keycode[0], ud->keycode[1]));
338
339 if (ud->keycode[0] == KEY_ERROR)
340 return; /* ignore */
341 nkeys = 0;
342 mod = ud->modifiers;
343 omod = sc->sc_odata.modifiers;
344 if (mod != omod)
345 for (i = 0; i < NMOD; i++)
346 if (( mod & ukbd_mods[i].mask) !=
347 (omod & ukbd_mods[i].mask))
348 ADDKEY(ukbd_mods[i].key |
349 (mod & ukbd_mods[i].mask
350 ? PRESS : RELEASE));
351 if (memcmp(ud->keycode, sc->sc_odata.keycode, NKEYCODE) != 0) {
352 /* Check for released keys. */
353 for (i = 0; i < NKEYCODE; i++) {
354 key = sc->sc_odata.keycode[i];
355 if (key == 0)
356 continue;
357 for (j = 0; j < NKEYCODE; j++)
358 if (key == ud->keycode[j])
359 goto rfound;
360 c = ukbd_trtab[key];
361 if (c)
362 ADDKEY(c | RELEASE);
363 rfound:
364 ;
365 }
366
367 /* Check for pressed keys. */
368 for (i = 0; i < NKEYCODE; i++) {
369 key = ud->keycode[i];
370 if (key == 0)
371 continue;
372 for (j = 0; j < NKEYCODE; j++)
373 if (key == sc->sc_odata.keycode[j])
374 goto pfound;
375 c = ukbd_trtab[key];
376 DPRINTFN(2,("ukbd_intr: press key=0x%02x -> 0x%02x\n",
377 key, c));
378 if (c)
379 ADDKEY(c | PRESS);
380 pfound:
381 ;
382 }
383 }
384 sc->sc_odata = *ud;
385
386 if (sc->sc_polling) {
387 if (nkeys > 0)
388 sc->sc_pollchar = ibuf[0]; /* XXX lost keys? */
389 return;
390 }
391 for (i = 0; i < nkeys; i++) {
392 c = ibuf[i];
393 wskbd_input(sc->sc_wskbddev,
394 c & RELEASE ? WSCONS_EVENT_KEY_UP : WSCONS_EVENT_KEY_DOWN,
395 c & 0xff);
396 }
397 }
398
399 void
400 ukbd_set_leds(v, leds)
401 void *v;
402 int leds;
403 {
404 struct ukbd_softc *sc = v;
405 u_int8_t res;
406
407 DPRINTF(("ukbd_set_leds: sc=%p leds=%d\n", sc, leds));
408
409 sc->sc_leds = leds;
410 res = 0;
411 if (leds & WSKBD_LED_SCROLL)
412 res |= SCROLL_LOCK;
413 if (leds & WSKBD_LED_NUM)
414 res |= NUM_LOCK;
415 if (leds & WSKBD_LED_CAPS)
416 res |= CAPS_LOCK;
417 usbd_set_report_async(sc->sc_iface, UHID_OUTPUT_REPORT, 0, &res, 1);
418 }
419
420 int
421 ukbd_ioctl(v, cmd, data, flag, p)
422 void *v;
423 u_long cmd;
424 caddr_t data;
425 int flag;
426 struct proc *p;
427 {
428 struct ukbd_softc *sc = v;
429
430 switch (cmd) {
431 case WSKBDIO_GTYPE:
432 *(int *)data = WSKBD_TYPE_PC_XT;
433 return 0;
434 case WSKBDIO_SETLEDS:
435 ukbd_set_leds(v, *(int *)data);
436 return 0;
437 case WSKBDIO_GETLEDS:
438 *(int *)data = sc->sc_leds;
439 return (0);
440 #ifdef WSDISPLAY_COMPAT_RAWKBD
441 case WSKBDIO_SETMODE:
442 sc->sc_rawkbd = *(int *)data == WSKBD_RAW;
443 return (0);
444 #endif
445 }
446 return -1;
447 }
448
449 void
450 ukbd_cngetc(v, type, data)
451 void *v;
452 u_int *type;
453 int *data;
454 {
455 struct ukbd_softc *sc = v;
456 usbd_lock_token s;
457 int c;
458
459 DPRINTFN(1,("ukbd_cngetc: enter\n"));
460 s = usbd_lock();
461 sc->sc_polling = 1;
462 sc->sc_pollchar = -1;
463 while(sc->sc_pollchar == -1)
464 usbd_dopoll(sc->sc_iface);
465 sc->sc_polling = 0;
466 c = sc->sc_pollchar;
467 *type = c & RELEASE ? WSCONS_EVENT_KEY_UP : WSCONS_EVENT_KEY_DOWN;
468 *data = c & 0xff;
469 usbd_unlock(s);
470 DPRINTFN(1,("ukbd_cngetc: return 0x%02x\n", c));
471 }
472
473 void
474 ukbd_cnpollc(v, on)
475 void *v;
476 int on;
477 {
478 struct ukbd_softc *sc = v;
479
480 DPRINTFN(1,("ukbd_cnpollc: sc=%p on=%d\n", v, on));
481
482 usbd_set_polling(sc->sc_iface, on);
483 }
484