2 * $Id: hid-input.c,v 1.2 2002/04/23 00:59:25 rdamazio Exp $
4 * Copyright (c) 2000-2001 Vojtech Pavlik
6 * USB HID to Linux Input mapping
10 * This program is free software; you can redistribute it and/or modify
11 * it under the terms of the GNU General Public License as published by
12 * the Free Software Foundation; either version 2 of the License, or
13 * (at your option) any later version.
15 * This program is distributed in the hope that it will be useful,
16 * but WITHOUT ANY WARRANTY; without even the implied warranty of
17 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
18 * GNU General Public License for more details.
20 * You should have received a copy of the GNU General Public License
21 * along with this program; if not, write to the Free Software
22 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
24 * Should you need to contact me, the author, you can do so either by
25 * e-mail - mail your message to <vojtech@ucw.cz>, or by paper mail:
26 * Vojtech Pavlik, Simunkova 1594, Prague 8, 182 00 Czech Republic
29 #include <linux/module.h>
30 #include <linux/slab.h>
31 #include <linux/kernel.h>
32 #include <linux/input.h>
33 #include <linux/usb.h>
34 #include <linux/usb_input.h>
40 #define unk KEY_UNKNOWN
42 static unsigned char hid_keyboard[256] = {
43 0, 0, 0, 0, 30, 48, 46, 32, 18, 33, 34, 35, 23, 36, 37, 38,
44 50, 49, 24, 25, 16, 19, 31, 20, 22, 47, 17, 45, 21, 44, 2, 3,
45 4, 5, 6, 7, 8, 9, 10, 11, 28, 1, 14, 15, 57, 12, 13, 26,
46 27, 43, 43, 39, 40, 41, 51, 52, 53, 58, 59, 60, 61, 62, 63, 64,
47 65, 66, 67, 68, 87, 88, 99, 70,119,110,102,104,111,107,109,106,
48 105,108,103, 69, 98, 55, 74, 78, 96, 79, 80, 81, 75, 76, 77, 71,
49 72, 73, 82, 83, 86,127,116,117,183,184,185,186,187,188,189,190,
50 191,192,193,194,134,138,130,132,128,129,131,137,133,135,136,113,
51 115,114,unk,unk,unk,121,unk, 89, 93,124, 92, 94, 95,unk,unk,unk,
52 122,123, 90, 91, 85,unk,unk,unk,unk,unk,unk,unk,unk,unk,unk,unk,
53 unk,unk,unk,unk,unk,unk,unk,unk,unk,unk,unk,unk,unk,unk,unk,unk,
54 unk,unk,unk,unk,unk,unk,unk,unk,unk,unk,unk,unk,unk,unk,unk,unk,
55 unk,unk,unk,unk,unk,unk,unk,unk,unk,unk,unk,unk,unk,unk,unk,unk,
56 unk,unk,unk,unk,unk,unk,unk,unk,unk,unk,unk,unk,unk,unk,unk,unk,
57 29, 42, 56,125, 97, 54,100,126,164,166,165,163,161,115,114,113,
58 150,158,159,128,136,177,178,176,142,152,173,140,unk,unk,unk,unk
64 } hid_hat_to_axis[] = {{ 0, 0}, { 0,-1}, { 1,-1}, { 1, 0}, { 1, 1}, { 0, 1}, {-1, 1}, {-1, 0}, {-1,-1}};
66 #define map_abs(c) do { usage->code = c; usage->type = EV_ABS; bit = input->absbit; max = ABS_MAX; } while (0)
67 #define map_rel(c) do { usage->code = c; usage->type = EV_REL; bit = input->relbit; max = REL_MAX; } while (0)
68 #define map_key(c) do { usage->code = c; usage->type = EV_KEY; bit = input->keybit; max = KEY_MAX; } while (0)
69 #define map_led(c) do { usage->code = c; usage->type = EV_LED; bit = input->ledbit; max = LED_MAX; } while (0)
70 #define map_ff(c) do { usage->code = c; usage->type = EV_FF; bit = input->ffbit; max = FF_MAX; } while (0)
72 #define map_abs_clear(c) do { map_abs(c); clear_bit(c, bit); } while (0)
73 #define map_key_clear(c) do { map_key(c); clear_bit(c, bit); } while (0)
74 #define map_ff_effect(c) do { set_bit(c, input->ffbit); } while (0)
76 static void hidinput_configure_usage(struct hid_input *hidinput, struct hid_field *field,
77 struct hid_usage *usage)
79 struct input_dev *input = &hidinput->input;
80 struct hid_device *device = hidinput->input.private;
84 field->hidinput = hidinput;
87 printk(KERN_DEBUG "Mapping: ");
88 resolv_usage(usage->hid);
92 if (field->flags & HID_MAIN_ITEM_CONSTANT)
95 switch (usage->hid & HID_USAGE_PAGE) {
97 case HID_UP_UNDEFINED:
100 case HID_UP_KEYBOARD:
102 set_bit(EV_REP, input->evbit);
104 if ((usage->hid & HID_USAGE) < 256) {
105 if (!hid_keyboard[usage->hid & HID_USAGE]) goto ignore;
106 map_key_clear(hid_keyboard[usage->hid & HID_USAGE]);
108 map_key(KEY_UNKNOWN);
114 code = ((usage->hid - 1) & 0xf);
116 switch (field->application) {
118 case HID_GD_POINTER: code += 0x110; break;
119 case HID_GD_JOYSTICK: code += 0x120; break;
120 case HID_GD_GAMEPAD: code += 0x130; break;
122 switch (field->physical) {
124 case HID_GD_POINTER: code += 0x110; break;
125 case HID_GD_JOYSTICK: code += 0x120; break;
126 case HID_GD_GAMEPAD: code += 0x130; break;
127 default: code += 0x100;
136 if ((usage->hid & 0xf0) == 0x80) { /* SystemControl */
137 switch (usage->hid & 0xf) {
138 case 0x1: map_key_clear(KEY_POWER); break;
139 case 0x2: map_key_clear(KEY_SLEEP); break;
140 case 0x3: map_key_clear(KEY_WAKEUP); break;
141 default: goto unknown;
146 if ((usage->hid & 0xf0) == 0x90) { /* D-pad */
147 switch (usage->hid) {
148 case HID_GD_UP: usage->hat_dir = 1; break;
149 case HID_GD_DOWN: usage->hat_dir = 5; break;
150 case HID_GD_RIGHT: usage->hat_dir = 3; break;
151 case HID_GD_LEFT: usage->hat_dir = 7; break;
152 default: goto unknown;
155 map_abs(field->dpad);
162 switch (usage->hid) {
164 /* These usage IDs map directly to the usage codes. */
165 case HID_GD_X: case HID_GD_Y: case HID_GD_Z:
166 case HID_GD_RX: case HID_GD_RY: case HID_GD_RZ:
167 case HID_GD_SLIDER: case HID_GD_DIAL: case HID_GD_WHEEL:
168 if (field->flags & HID_MAIN_ITEM_RELATIVE)
169 map_rel(usage->hid & 0xf);
171 map_abs(usage->hid & 0xf);
174 case HID_GD_HATSWITCH:
175 usage->hat_min = field->logical_minimum;
176 usage->hat_max = field->logical_maximum;
180 case HID_GD_START: map_key_clear(BTN_START); break;
181 case HID_GD_SELECT: map_key_clear(BTN_SELECT); break;
183 default: goto unknown;
189 if (((usage->hid - 1) & 0xffff) >= LED_MAX)
191 map_led((usage->hid - 1) & 0xffff);
194 case HID_UP_DIGITIZER:
196 switch (usage->hid & 0xff) {
198 case 0x30: /* TipPressure */
199 if (!test_bit(BTN_TOUCH, input->keybit)) {
200 device->quirks |= HID_QUIRK_NOTOUCH;
201 set_bit(EV_KEY, input->evbit);
202 set_bit(BTN_TOUCH, input->keybit);
205 map_abs_clear(ABS_PRESSURE);
208 case 0x32: /* InRange */
209 switch (field->physical & 0xff) {
210 case 0x21: map_key(BTN_TOOL_MOUSE); break;
211 case 0x22: map_key(BTN_TOOL_FINGER); break;
212 default: map_key(BTN_TOOL_PEN); break;
216 case 0x3c: /* Invert */
217 map_key_clear(BTN_TOOL_RUBBER);
220 case 0x33: /* Touch */
221 case 0x42: /* TipSwitch */
222 case 0x43: /* TipSwitch2 */
223 device->quirks &= ~HID_QUIRK_NOTOUCH;
224 map_key_clear(BTN_TOUCH);
227 case 0x44: /* BarrelSwitch */
228 map_key_clear(BTN_STYLUS);
231 default: goto unknown;
235 case HID_UP_CONSUMER: /* USB HUT v1.1, pages 56-62 */
237 switch (usage->hid & HID_USAGE) {
238 case 0x000: goto ignore;
239 case 0x034: map_key_clear(KEY_SLEEP); break;
240 case 0x036: map_key_clear(BTN_MISC); break;
241 case 0x08a: map_key_clear(KEY_WWW); break;
242 case 0x095: map_key_clear(KEY_HELP); break;
243 case 0x0b0: map_key_clear(KEY_PLAY); break;
244 case 0x0b1: map_key_clear(KEY_PAUSE); break;
245 case 0x0b2: map_key_clear(KEY_RECORD); break;
246 case 0x0b3: map_key_clear(KEY_FASTFORWARD); break;
247 case 0x0b4: map_key_clear(KEY_REWIND); break;
248 case 0x0b5: map_key_clear(KEY_NEXTSONG); break;
249 case 0x0b6: map_key_clear(KEY_PREVIOUSSONG); break;
250 case 0x0b7: map_key_clear(KEY_STOPCD); break;
251 case 0x0b8: map_key_clear(KEY_EJECTCD); break;
252 case 0x0cd: map_key_clear(KEY_PLAYPAUSE); break;
253 case 0x0e0: map_abs_clear(ABS_VOLUME); break;
254 case 0x0e2: map_key_clear(KEY_MUTE); break;
255 case 0x0e5: map_key_clear(KEY_BASSBOOST); break;
256 case 0x0e9: map_key_clear(KEY_VOLUMEUP); break;
257 case 0x0ea: map_key_clear(KEY_VOLUMEDOWN); break;
258 case 0x183: map_key_clear(KEY_CONFIG); break;
259 case 0x18a: map_key_clear(KEY_MAIL); break;
260 case 0x192: map_key_clear(KEY_CALC); break;
261 case 0x194: map_key_clear(KEY_FILE); break;
262 case 0x21a: map_key_clear(KEY_UNDO); break;
263 case 0x21b: map_key_clear(KEY_COPY); break;
264 case 0x21c: map_key_clear(KEY_CUT); break;
265 case 0x21d: map_key_clear(KEY_PASTE); break;
266 case 0x221: map_key_clear(KEY_FIND); break;
267 case 0x223: map_key_clear(KEY_HOMEPAGE); break;
268 case 0x224: map_key_clear(KEY_BACK); break;
269 case 0x225: map_key_clear(KEY_FORWARD); break;
270 case 0x226: map_key_clear(KEY_STOP); break;
271 case 0x227: map_key_clear(KEY_REFRESH); break;
272 case 0x22a: map_key_clear(KEY_BOOKMARKS); break;
273 case 0x238: map_rel(REL_HWHEEL); break;
274 default: goto unknown;
278 case HID_UP_HPVENDOR: /* Reported on a Dutch layout HP5308 */
280 set_bit(EV_REP, input->evbit);
281 switch (usage->hid & HID_USAGE) {
282 case 0x021: map_key_clear(KEY_PRINT); break;
283 case 0x070: map_key_clear(KEY_HP); break;
284 case 0x071: map_key_clear(KEY_CAMERA); break;
285 case 0x072: map_key_clear(KEY_SOUND); break;
286 case 0x073: map_key_clear(KEY_QUESTION); break;
287 case 0x080: map_key_clear(KEY_EMAIL); break;
288 case 0x081: map_key_clear(KEY_CHAT); break;
289 case 0x082: map_key_clear(KEY_SEARCH); break;
290 case 0x083: map_key_clear(KEY_CONNECT); break;
291 case 0x084: map_key_clear(KEY_FINANCE); break;
292 case 0x085: map_key_clear(KEY_SPORT); break;
293 case 0x086: map_key_clear(KEY_SHOP); break;
294 default: goto ignore;
298 case HID_UP_MSVENDOR:
304 set_bit(EV_FF, input->evbit);
305 switch(usage->hid & HID_USAGE) {
306 case 0x26: map_ff_effect(FF_CONSTANT); goto ignore;
307 case 0x27: map_ff_effect(FF_RAMP); goto ignore;
308 case 0x28: map_ff_effect(FF_CUSTOM); goto ignore;
309 case 0x30: map_ff_effect(FF_SQUARE); map_ff_effect(FF_PERIODIC); goto ignore;
310 case 0x31: map_ff_effect(FF_SINE); map_ff_effect(FF_PERIODIC); goto ignore;
311 case 0x32: map_ff_effect(FF_TRIANGLE); map_ff_effect(FF_PERIODIC); goto ignore;
312 case 0x33: map_ff_effect(FF_SAW_UP); map_ff_effect(FF_PERIODIC); goto ignore;
313 case 0x34: map_ff_effect(FF_SAW_DOWN); map_ff_effect(FF_PERIODIC); goto ignore;
314 case 0x40: map_ff_effect(FF_SPRING); goto ignore;
315 case 0x41: map_ff_effect(FF_DAMPER); goto ignore;
316 case 0x42: map_ff_effect(FF_INERTIA); goto ignore;
317 case 0x43: map_ff_effect(FF_FRICTION); goto ignore;
318 case 0x7e: map_ff(FF_GAIN); break;
319 case 0x83: input->ff_effects_max = field->value[0]; goto ignore;
320 case 0x98: map_ff(FF_AUTOCENTER); break;
321 case 0xa4: map_key_clear(BTN_DEAD); break;
322 default: goto ignore;
328 if (field->report_size == 1) {
329 if (field->report->type == HID_OUTPUT_REPORT) {
336 if (field->flags & HID_MAIN_ITEM_RELATIVE) {
344 set_bit(usage->type, input->evbit);
346 while (usage->code <= max && test_and_set_bit(usage->code, bit))
347 usage->code = find_next_zero_bit(bit, max + 1, usage->code);
349 if (usage->code > max)
352 if ((device->quirks & (HID_QUIRK_2WHEEL_MOUSE_HACK_7 | HID_QUIRK_2WHEEL_MOUSE_HACK_5)) &&
353 (usage->type == EV_REL) && (usage->code == REL_WHEEL))
354 set_bit(REL_HWHEEL, bit);
356 if (((device->quirks & HID_QUIRK_2WHEEL_MOUSE_HACK_5) && (usage->hid == 0x00090005))
357 || ((device->quirks & HID_QUIRK_2WHEEL_MOUSE_HACK_7) && (usage->hid == 0x00090007)))
360 if (usage->type == EV_ABS) {
362 int a = field->logical_minimum;
363 int b = field->logical_maximum;
365 if ((device->quirks & HID_QUIRK_BADPAD) && (usage->code == ABS_X || usage->code == ABS_Y)) {
366 a = field->logical_minimum = 0;
367 b = field->logical_maximum = 255;
370 if (field->application == HID_GD_GAMEPAD || field->application == HID_GD_JOYSTICK)
371 input_set_abs_params(input, usage->code, a, b, (b - a) >> 8, (b - a) >> 4);
372 else input_set_abs_params(input, usage->code, a, b, 0, 0);
376 if (usage->hat_min < usage->hat_max || usage->hat_dir) {
378 for (i = usage->code; i < usage->code + 2 && i <= max; i++) {
379 input_set_abs_params(input, i, -1, 1, 0, 0);
380 set_bit(i, input->absbit);
382 if (usage->hat_dir && !field->dpad)
383 field->dpad = usage->code;
387 resolv_event(usage->type, usage->code);
399 void hidinput_hid_event(struct hid_device *hid, struct hid_field *field, struct hid_usage *usage, __s32 value, struct pt_regs *regs)
401 struct input_dev *input;
402 int *quirks = &hid->quirks;
404 if (!field->hidinput)
406 input = &field->hidinput->input;
408 input_regs(input, regs);
413 if (((hid->quirks & HID_QUIRK_2WHEEL_MOUSE_HACK_5) && (usage->hid == 0x00090005))
414 || ((hid->quirks & HID_QUIRK_2WHEEL_MOUSE_HACK_7) && (usage->hid == 0x00090007))) {
415 if (value) hid->quirks |= HID_QUIRK_2WHEEL_MOUSE_HACK_ON;
416 else hid->quirks &= ~HID_QUIRK_2WHEEL_MOUSE_HACK_ON;
420 if ((hid->quirks & HID_QUIRK_2WHEEL_MOUSE_HACK_ON) && (usage->code == REL_WHEEL)) {
421 input_event(input, usage->type, REL_HWHEEL, value);
425 if (usage->hat_min < usage->hat_max || usage->hat_dir) {
426 int hat_dir = usage->hat_dir;
428 hat_dir = (value - usage->hat_min) * 8 / (usage->hat_max - usage->hat_min + 1) + 1;
429 if (hat_dir < 0 || hat_dir > 8) hat_dir = 0;
430 input_event(input, usage->type, usage->code , hid_hat_to_axis[hat_dir].x);
431 input_event(input, usage->type, usage->code + 1, hid_hat_to_axis[hat_dir].y);
435 if (usage->hid == (HID_UP_DIGITIZER | 0x003c)) { /* Invert */
436 *quirks = value ? (*quirks | HID_QUIRK_INVERT) : (*quirks & ~HID_QUIRK_INVERT);
440 if (usage->hid == (HID_UP_DIGITIZER | 0x0032)) { /* InRange */
442 input_event(input, usage->type, (*quirks & HID_QUIRK_INVERT) ? BTN_TOOL_RUBBER : usage->code, 1);
445 input_event(input, usage->type, usage->code, 0);
446 input_event(input, usage->type, BTN_TOOL_RUBBER, 0);
450 if (usage->hid == (HID_UP_DIGITIZER | 0x0030) && (*quirks & HID_QUIRK_NOTOUCH)) { /* Pressure */
451 int a = field->logical_minimum;
452 int b = field->logical_maximum;
453 input_event(input, EV_KEY, BTN_TOUCH, value > a + ((b - a) >> 3));
456 if (usage->hid == (HID_UP_PID | 0x83UL)) { /* Simultaneous Effects Max */
457 input->ff_effects_max = value;
458 dbg("Maximum Effects - %d",input->ff_effects_max);
462 if (usage->hid == (HID_UP_PID | 0x7fUL)) {
463 dbg("PID Pool Report\n");
467 if((usage->type == EV_KEY) && (usage->code == 0)) /* Key 0 is "unassigned", not KEY_UNKNOWN */
470 input_event(input, usage->type, usage->code, value);
472 if ((field->flags & HID_MAIN_ITEM_RELATIVE) && (usage->type == EV_KEY))
473 input_event(input, usage->type, usage->code, 0);
476 void hidinput_report_event(struct hid_device *hid, struct hid_report *report)
478 struct list_head *lh;
479 struct hid_input *hidinput;
481 list_for_each (lh, &hid->inputs) {
482 hidinput = list_entry(lh, struct hid_input, list);
483 input_sync(&hidinput->input);
487 static int hidinput_find_field(struct hid_device *hid, unsigned int type, unsigned int code, struct hid_field **field)
489 struct hid_report *report;
492 list_for_each_entry(report, &hid->report_enum[HID_OUTPUT_REPORT].report_list, list) {
493 for (i = 0; i < report->maxfield; i++) {
494 *field = report->field[i];
495 for (j = 0; j < (*field)->maxusage; j++)
496 if ((*field)->usage[j].type == type && (*field)->usage[j].code == code)
503 static int hidinput_input_event(struct input_dev *dev, unsigned int type, unsigned int code, int value)
505 struct hid_device *hid = dev->private;
506 struct hid_field *field;
510 return hid_ff_event(hid, dev, type, code, value);
515 if ((offset = hidinput_find_field(hid, type, code, &field)) == -1) {
516 warn("event field not found");
520 hid_set_field(field, offset, value);
521 hid_submit_report(hid, field->report, USB_DIR_OUT);
526 static int hidinput_open(struct input_dev *dev)
528 struct hid_device *hid = dev->private;
529 return hid_open(hid);
532 static void hidinput_close(struct input_dev *dev)
534 struct hid_device *hid = dev->private;
539 * Register the input device; print a message.
540 * Configure the input layer interface
541 * Read all reports and initialize the absolute field values.
544 int hidinput_connect(struct hid_device *hid)
546 struct usb_device *dev = hid->dev;
547 struct hid_report *report;
548 struct hid_input *hidinput = NULL;
551 INIT_LIST_HEAD(&hid->inputs);
553 for (i = 0; i < hid->maxcollection; i++)
554 if (hid->collection[i].type == HID_COLLECTION_APPLICATION ||
555 hid->collection[i].type == HID_COLLECTION_PHYSICAL)
556 if (IS_INPUT_APPLICATION(hid->collection[i].usage))
559 if (i == hid->maxcollection)
562 for (k = HID_INPUT_REPORT; k <= HID_OUTPUT_REPORT; k++)
563 list_for_each_entry(report, &hid->report_enum[k].report_list, list) {
565 if (!report->maxfield)
569 hidinput = kmalloc(sizeof(*hidinput), GFP_KERNEL);
571 err("Out of memory during hid input probe");
574 memset(hidinput, 0, sizeof(*hidinput));
576 list_add_tail(&hidinput->list, &hid->inputs);
578 hidinput->input.private = hid;
579 hidinput->input.event = hidinput_input_event;
580 hidinput->input.open = hidinput_open;
581 hidinput->input.close = hidinput_close;
583 hidinput->input.name = hid->name;
584 hidinput->input.phys = hid->phys;
585 hidinput->input.uniq = hid->uniq;
586 usb_to_input_id(dev, &hidinput->input.id);
587 hidinput->input.dev = &hid->intf->dev;
590 for (i = 0; i < report->maxfield; i++)
591 for (j = 0; j < report->field[i]->maxusage; j++)
592 hidinput_configure_usage(hidinput, report->field[i],
593 report->field[i]->usage + j);
595 if (hid->quirks & HID_QUIRK_MULTI_INPUT) {
596 /* This will leave hidinput NULL, so that it
597 * allocates another one if we have more inputs on
598 * the same interface. Some devices (e.g. Happ's
599 * UGCI) cram a lot of unrelated inputs into the
601 hidinput->report = report;
602 input_register_device(&hidinput->input);
607 /* This only gets called when we are a single-input (most of the
608 * time). IOW, not a HID_QUIRK_MULTI_INPUT. The hid_ff_init() is
609 * only useful in this case, and not for multi-input quirks. */
612 input_register_device(&hidinput->input);
618 void hidinput_disconnect(struct hid_device *hid)
620 struct list_head *lh, *next;
621 struct hid_input *hidinput;
623 list_for_each_safe(lh, next, &hid->inputs) {
624 hidinput = list_entry(lh, struct hid_input, list);
625 input_unregister_device(&hidinput->input);
626 list_del(&hidinput->list);