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>
39 #define unk KEY_UNKNOWN
41 static unsigned char hid_keyboard[256] = {
42 0, 0, 0, 0, 30, 48, 46, 32, 18, 33, 34, 35, 23, 36, 37, 38,
43 50, 49, 24, 25, 16, 19, 31, 20, 22, 47, 17, 45, 21, 44, 2, 3,
44 4, 5, 6, 7, 8, 9, 10, 11, 28, 1, 14, 15, 57, 12, 13, 26,
45 27, 43, 43, 39, 40, 41, 51, 52, 53, 58, 59, 60, 61, 62, 63, 64,
46 65, 66, 67, 68, 87, 88, 99, 70,119,110,102,104,111,107,109,106,
47 105,108,103, 69, 98, 55, 74, 78, 96, 79, 80, 81, 75, 76, 77, 71,
48 72, 73, 82, 83, 86,127,116,117,183,184,185,186,187,188,189,190,
49 191,192,193,194,134,138,130,132,128,129,131,137,133,135,136,113,
50 115,114,unk,unk,unk,121,unk, 89, 93,124, 92, 94, 95,unk,unk,unk,
51 122,123, 90, 91, 85,unk,unk,unk,unk,unk,unk,unk,unk,unk,unk,unk,
52 unk,unk,unk,unk,unk,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 29, 42, 56,125, 97, 54,100,126,164,166,165,163,161,115,114,113,
57 150,158,159,128,136,177,178,176,142,152,173,140,unk,unk,unk,unk
63 } hid_hat_to_axis[] = {{ 0, 0}, { 0,-1}, { 1,-1}, { 1, 0}, { 1, 1}, { 0, 1}, {-1, 1}, {-1, 0}, {-1,-1}};
65 #define map_abs(c) do { usage->code = c; usage->type = EV_ABS; bit = input->absbit; max = ABS_MAX; } while (0)
66 #define map_rel(c) do { usage->code = c; usage->type = EV_REL; bit = input->relbit; max = REL_MAX; } while (0)
67 #define map_key(c) do { usage->code = c; usage->type = EV_KEY; bit = input->keybit; max = KEY_MAX; } while (0)
68 #define map_led(c) do { usage->code = c; usage->type = EV_LED; bit = input->ledbit; max = LED_MAX; } while (0)
69 #define map_ff(c) do { usage->code = c; usage->type = EV_FF; bit = input->ffbit; max = FF_MAX; } while (0)
71 #define map_abs_clear(c) do { map_abs(c); clear_bit(c, bit); } while (0)
72 #define map_key_clear(c) do { map_key(c); clear_bit(c, bit); } while (0)
73 #define map_ff_effect(c) do { set_bit(c, input->ffbit); } while (0)
75 static void hidinput_configure_usage(struct hid_input *hidinput, struct hid_field *field,
76 struct hid_usage *usage)
78 struct input_dev *input = &hidinput->input;
79 struct hid_device *device = hidinput->input.private;
83 field->hidinput = hidinput;
86 printk(KERN_DEBUG "Mapping: ");
87 resolv_usage(usage->hid);
91 if (field->flags & HID_MAIN_ITEM_CONSTANT)
94 switch (usage->hid & HID_USAGE_PAGE) {
96 case HID_UP_UNDEFINED:
101 set_bit(EV_REP, input->evbit);
103 if ((usage->hid & HID_USAGE) < 256) {
104 if (!hid_keyboard[usage->hid & HID_USAGE]) goto ignore;
105 map_key_clear(hid_keyboard[usage->hid & HID_USAGE]);
107 map_key(KEY_UNKNOWN);
113 code = ((usage->hid - 1) & 0xf);
115 switch (field->application) {
117 case HID_GD_POINTER: code += 0x110; break;
118 case HID_GD_JOYSTICK: code += 0x120; break;
119 case HID_GD_GAMEPAD: code += 0x130; break;
121 switch (field->physical) {
123 case HID_GD_POINTER: code += 0x110; break;
124 case HID_GD_JOYSTICK: code += 0x120; break;
125 case HID_GD_GAMEPAD: code += 0x130; break;
126 default: code += 0x100;
135 if ((usage->hid & 0xf0) == 0x80) { /* SystemControl */
136 switch (usage->hid & 0xf) {
137 case 0x1: map_key_clear(KEY_POWER); break;
138 case 0x2: map_key_clear(KEY_SLEEP); break;
139 case 0x3: map_key_clear(KEY_WAKEUP); break;
140 default: goto unknown;
145 if ((usage->hid & 0xf0) == 0x90) { /* D-pad */
146 switch (usage->hid) {
147 case HID_GD_UP: usage->hat_dir = 1; break;
148 case HID_GD_DOWN: usage->hat_dir = 5; break;
149 case HID_GD_RIGHT: usage->hat_dir = 3; break;
150 case HID_GD_LEFT: usage->hat_dir = 7; break;
151 default: goto unknown;
154 map_abs(field->dpad);
161 switch (usage->hid) {
163 /* These usage IDs map directly to the usage codes. */
164 case HID_GD_X: case HID_GD_Y: case HID_GD_Z:
165 case HID_GD_RX: case HID_GD_RY: case HID_GD_RZ:
166 case HID_GD_SLIDER: case HID_GD_DIAL: case HID_GD_WHEEL:
167 if (field->flags & HID_MAIN_ITEM_RELATIVE)
168 map_rel(usage->hid & 0xf);
170 map_abs(usage->hid & 0xf);
173 case HID_GD_HATSWITCH:
174 usage->hat_min = field->logical_minimum;
175 usage->hat_max = field->logical_maximum;
179 case HID_GD_START: map_key_clear(BTN_START); break;
180 case HID_GD_SELECT: map_key_clear(BTN_SELECT); break;
182 default: goto unknown;
188 if (((usage->hid - 1) & 0xffff) >= LED_MAX)
190 map_led((usage->hid - 1) & 0xffff);
193 case HID_UP_DIGITIZER:
195 switch (usage->hid & 0xff) {
197 case 0x30: /* TipPressure */
198 if (!test_bit(BTN_TOUCH, input->keybit)) {
199 device->quirks |= HID_QUIRK_NOTOUCH;
200 set_bit(EV_KEY, input->evbit);
201 set_bit(BTN_TOUCH, input->keybit);
204 map_abs_clear(ABS_PRESSURE);
207 case 0x32: /* InRange */
208 switch (field->physical & 0xff) {
209 case 0x21: map_key(BTN_TOOL_MOUSE); break;
210 case 0x22: map_key(BTN_TOOL_FINGER); break;
211 default: map_key(BTN_TOOL_PEN); break;
215 case 0x3c: /* Invert */
216 map_key_clear(BTN_TOOL_RUBBER);
219 case 0x33: /* Touch */
220 case 0x42: /* TipSwitch */
221 case 0x43: /* TipSwitch2 */
222 device->quirks &= ~HID_QUIRK_NOTOUCH;
223 map_key_clear(BTN_TOUCH);
226 case 0x44: /* BarrelSwitch */
227 map_key_clear(BTN_STYLUS);
230 default: goto unknown;
234 case HID_UP_CONSUMER: /* USB HUT v1.1, pages 56-62 */
236 switch (usage->hid & HID_USAGE) {
237 case 0x000: goto ignore;
238 case 0x034: map_key_clear(KEY_SLEEP); break;
239 case 0x036: map_key_clear(BTN_MISC); break;
240 case 0x08a: map_key_clear(KEY_WWW); break;
241 case 0x095: map_key_clear(KEY_HELP); break;
242 case 0x0b0: map_key_clear(KEY_PLAY); break;
243 case 0x0b1: map_key_clear(KEY_PAUSE); break;
244 case 0x0b2: map_key_clear(KEY_RECORD); break;
245 case 0x0b3: map_key_clear(KEY_FASTFORWARD); break;
246 case 0x0b4: map_key_clear(KEY_REWIND); break;
247 case 0x0b5: map_key_clear(KEY_NEXTSONG); break;
248 case 0x0b6: map_key_clear(KEY_PREVIOUSSONG); break;
249 case 0x0b7: map_key_clear(KEY_STOPCD); break;
250 case 0x0b8: map_key_clear(KEY_EJECTCD); break;
251 case 0x0cd: map_key_clear(KEY_PLAYPAUSE); break;
252 case 0x0e0: map_abs_clear(ABS_VOLUME); break;
253 case 0x0e2: map_key_clear(KEY_MUTE); break;
254 case 0x0e5: map_key_clear(KEY_BASSBOOST); break;
255 case 0x0e9: map_key_clear(KEY_VOLUMEUP); break;
256 case 0x0ea: map_key_clear(KEY_VOLUMEDOWN); break;
257 case 0x183: map_key_clear(KEY_CONFIG); break;
258 case 0x18a: map_key_clear(KEY_MAIL); break;
259 case 0x192: map_key_clear(KEY_CALC); break;
260 case 0x194: map_key_clear(KEY_FILE); break;
261 case 0x21a: map_key_clear(KEY_UNDO); break;
262 case 0x21b: map_key_clear(KEY_COPY); break;
263 case 0x21c: map_key_clear(KEY_CUT); break;
264 case 0x21d: map_key_clear(KEY_PASTE); break;
265 case 0x221: map_key_clear(KEY_FIND); break;
266 case 0x223: map_key_clear(KEY_HOMEPAGE); break;
267 case 0x224: map_key_clear(KEY_BACK); break;
268 case 0x225: map_key_clear(KEY_FORWARD); break;
269 case 0x226: map_key_clear(KEY_STOP); break;
270 case 0x227: map_key_clear(KEY_REFRESH); break;
271 case 0x22a: map_key_clear(KEY_BOOKMARKS); break;
272 case 0x238: map_rel(REL_HWHEEL); break;
273 default: goto unknown;
277 case HID_UP_HPVENDOR: /* Reported on a Dutch layout HP5308 */
279 set_bit(EV_REP, input->evbit);
280 switch (usage->hid & HID_USAGE) {
281 case 0x021: map_key_clear(KEY_PRINT); break;
282 case 0x070: map_key_clear(KEY_HP); break;
283 case 0x071: map_key_clear(KEY_CAMERA); break;
284 case 0x072: map_key_clear(KEY_SOUND); break;
285 case 0x073: map_key_clear(KEY_QUESTION); break;
286 case 0x080: map_key_clear(KEY_EMAIL); break;
287 case 0x081: map_key_clear(KEY_CHAT); break;
288 case 0x082: map_key_clear(KEY_SEARCH); break;
289 case 0x083: map_key_clear(KEY_CONNECT); break;
290 case 0x084: map_key_clear(KEY_FINANCE); break;
291 case 0x085: map_key_clear(KEY_SPORT); break;
292 case 0x086: map_key_clear(KEY_SHOP); break;
293 default: goto ignore;
297 case HID_UP_MSVENDOR:
303 set_bit(EV_FF, input->evbit);
304 switch(usage->hid & HID_USAGE) {
305 case 0x26: map_ff_effect(FF_CONSTANT); goto ignore;
306 case 0x27: map_ff_effect(FF_RAMP); goto ignore;
307 case 0x28: map_ff_effect(FF_CUSTOM); goto ignore;
308 case 0x30: map_ff_effect(FF_SQUARE); map_ff_effect(FF_PERIODIC); goto ignore;
309 case 0x31: map_ff_effect(FF_SINE); map_ff_effect(FF_PERIODIC); goto ignore;
310 case 0x32: map_ff_effect(FF_TRIANGLE); map_ff_effect(FF_PERIODIC); goto ignore;
311 case 0x33: map_ff_effect(FF_SAW_UP); map_ff_effect(FF_PERIODIC); goto ignore;
312 case 0x34: map_ff_effect(FF_SAW_DOWN); map_ff_effect(FF_PERIODIC); goto ignore;
313 case 0x40: map_ff_effect(FF_SPRING); goto ignore;
314 case 0x41: map_ff_effect(FF_DAMPER); goto ignore;
315 case 0x42: map_ff_effect(FF_INERTIA); goto ignore;
316 case 0x43: map_ff_effect(FF_FRICTION); goto ignore;
317 case 0x7e: map_ff(FF_GAIN); break;
318 case 0x83: input->ff_effects_max = field->value[0]; goto ignore;
319 case 0x98: map_ff(FF_AUTOCENTER); break;
320 case 0xa4: map_key_clear(BTN_DEAD); break;
321 default: goto ignore;
327 if (field->report_size == 1) {
328 if (field->report->type == HID_OUTPUT_REPORT) {
335 if (field->flags & HID_MAIN_ITEM_RELATIVE) {
343 set_bit(usage->type, input->evbit);
345 while (usage->code <= max && test_and_set_bit(usage->code, bit))
346 usage->code = find_next_zero_bit(bit, max + 1, usage->code);
348 if (usage->code > max)
351 if ((device->quirks & (HID_QUIRK_2WHEEL_MOUSE_HACK_7 | HID_QUIRK_2WHEEL_MOUSE_HACK_5)) &&
352 (usage->type == EV_REL) && (usage->code == REL_WHEEL))
353 set_bit(REL_HWHEEL, bit);
355 if (((device->quirks & HID_QUIRK_2WHEEL_MOUSE_HACK_5) && (usage->hid == 0x00090005))
356 || ((device->quirks & HID_QUIRK_2WHEEL_MOUSE_HACK_7) && (usage->hid == 0x00090007)))
359 if (usage->type == EV_ABS) {
361 int a = field->logical_minimum;
362 int b = field->logical_maximum;
364 if ((device->quirks & HID_QUIRK_BADPAD) && (usage->code == ABS_X || usage->code == ABS_Y)) {
365 a = field->logical_minimum = 0;
366 b = field->logical_maximum = 255;
369 if (field->application == HID_GD_GAMEPAD || field->application == HID_GD_JOYSTICK)
370 input_set_abs_params(input, usage->code, a, b, (b - a) >> 8, (b - a) >> 4);
371 else input_set_abs_params(input, usage->code, a, b, 0, 0);
375 if (usage->hat_min < usage->hat_max || usage->hat_dir) {
377 for (i = usage->code; i < usage->code + 2 && i <= max; i++) {
378 input_set_abs_params(input, i, -1, 1, 0, 0);
379 set_bit(i, input->absbit);
381 if (usage->hat_dir && !field->dpad)
382 field->dpad = usage->code;
386 resolv_event(usage->type, usage->code);
398 void hidinput_hid_event(struct hid_device *hid, struct hid_field *field, struct hid_usage *usage, __s32 value, struct pt_regs *regs)
400 struct input_dev *input = &field->hidinput->input;
401 int *quirks = &hid->quirks;
406 input_regs(input, regs);
411 if (((hid->quirks & HID_QUIRK_2WHEEL_MOUSE_HACK_5) && (usage->hid == 0x00090005))
412 || ((hid->quirks & HID_QUIRK_2WHEEL_MOUSE_HACK_7) && (usage->hid == 0x00090007))) {
413 if (value) hid->quirks |= HID_QUIRK_2WHEEL_MOUSE_HACK_ON;
414 else hid->quirks &= ~HID_QUIRK_2WHEEL_MOUSE_HACK_ON;
418 if ((hid->quirks & HID_QUIRK_2WHEEL_MOUSE_HACK_ON) && (usage->code == REL_WHEEL)) {
419 input_event(input, usage->type, REL_HWHEEL, value);
423 if (usage->hat_min < usage->hat_max || usage->hat_dir) {
424 int hat_dir = usage->hat_dir;
426 hat_dir = (value - usage->hat_min) * 8 / (usage->hat_max - usage->hat_min + 1) + 1;
427 if (hat_dir < 0 || hat_dir > 8) hat_dir = 0;
428 input_event(input, usage->type, usage->code , hid_hat_to_axis[hat_dir].x);
429 input_event(input, usage->type, usage->code + 1, hid_hat_to_axis[hat_dir].y);
433 if (usage->hid == (HID_UP_DIGITIZER | 0x003c)) { /* Invert */
434 *quirks = value ? (*quirks | HID_QUIRK_INVERT) : (*quirks & ~HID_QUIRK_INVERT);
438 if (usage->hid == (HID_UP_DIGITIZER | 0x0032)) { /* InRange */
440 input_event(input, usage->type, (*quirks & HID_QUIRK_INVERT) ? BTN_TOOL_RUBBER : usage->code, 1);
443 input_event(input, usage->type, usage->code, 0);
444 input_event(input, usage->type, BTN_TOOL_RUBBER, 0);
448 if (usage->hid == (HID_UP_DIGITIZER | 0x0030) && (*quirks & HID_QUIRK_NOTOUCH)) { /* Pressure */
449 int a = field->logical_minimum;
450 int b = field->logical_maximum;
451 input_event(input, EV_KEY, BTN_TOUCH, value > a + ((b - a) >> 3));
454 if (usage->hid == (HID_UP_PID | 0x83UL)) { /* Simultaneous Effects Max */
455 input->ff_effects_max = value;
456 dbg("Maximum Effects - %d",input->ff_effects_max);
460 if (usage->hid == (HID_UP_PID | 0x7fUL)) {
461 dbg("PID Pool Report\n");
465 if((usage->type == EV_KEY) && (usage->code == 0)) /* Key 0 is "unassigned", not KEY_UNKNOWN */
468 input_event(input, usage->type, usage->code, value);
470 if ((field->flags & HID_MAIN_ITEM_RELATIVE) && (usage->type == EV_KEY))
471 input_event(input, usage->type, usage->code, 0);
474 void hidinput_report_event(struct hid_device *hid, struct hid_report *report)
476 struct list_head *lh;
477 struct hid_input *hidinput;
479 list_for_each (lh, &hid->inputs) {
480 hidinput = list_entry(lh, struct hid_input, list);
481 input_sync(&hidinput->input);
485 static int hidinput_find_field(struct hid_device *hid, unsigned int type, unsigned int code, struct hid_field **field)
487 struct hid_report *report;
490 list_for_each_entry(report, &hid->report_enum[HID_OUTPUT_REPORT].report_list, list) {
491 for (i = 0; i < report->maxfield; i++) {
492 *field = report->field[i];
493 for (j = 0; j < (*field)->maxusage; j++)
494 if ((*field)->usage[j].type == type && (*field)->usage[j].code == code)
501 static int hidinput_input_event(struct input_dev *dev, unsigned int type, unsigned int code, int value)
503 struct hid_device *hid = dev->private;
504 struct hid_field *field;
508 return hid_ff_event(hid, dev, type, code, value);
513 if ((offset = hidinput_find_field(hid, type, code, &field)) == -1) {
514 warn("event field not found");
518 hid_set_field(field, offset, value);
519 hid_submit_report(hid, field->report, USB_DIR_OUT);
524 static int hidinput_open(struct input_dev *dev)
526 struct hid_device *hid = dev->private;
527 return hid_open(hid);
530 static void hidinput_close(struct input_dev *dev)
532 struct hid_device *hid = dev->private;
537 * Register the input device; print a message.
538 * Configure the input layer interface
539 * Read all reports and initialize the absolute field values.
542 int hidinput_connect(struct hid_device *hid)
544 struct usb_device *dev = hid->dev;
545 struct hid_report *report;
546 struct hid_input *hidinput = NULL;
549 INIT_LIST_HEAD(&hid->inputs);
551 for (i = 0; i < hid->maxcollection; i++)
552 if (hid->collection[i].type == HID_COLLECTION_APPLICATION ||
553 hid->collection[i].type == HID_COLLECTION_PHYSICAL)
554 if (IS_INPUT_APPLICATION(hid->collection[i].usage))
557 if (i == hid->maxcollection)
560 for (k = HID_INPUT_REPORT; k <= HID_OUTPUT_REPORT; k++)
561 list_for_each_entry(report, &hid->report_enum[k].report_list, list) {
563 if (!report->maxfield)
567 hidinput = kmalloc(sizeof(*hidinput), GFP_KERNEL);
569 err("Out of memory during hid input probe");
572 memset(hidinput, 0, sizeof(*hidinput));
574 list_add_tail(&hidinput->list, &hid->inputs);
576 hidinput->input.private = hid;
577 hidinput->input.event = hidinput_input_event;
578 hidinput->input.open = hidinput_open;
579 hidinput->input.close = hidinput_close;
581 hidinput->input.name = hid->name;
582 hidinput->input.phys = hid->phys;
583 hidinput->input.uniq = hid->uniq;
584 hidinput->input.id.bustype = BUS_USB;
585 hidinput->input.id.vendor = le16_to_cpu(dev->descriptor.idVendor);
586 hidinput->input.id.product = le16_to_cpu(dev->descriptor.idProduct);
587 hidinput->input.id.version = le16_to_cpu(dev->descriptor.bcdDevice);
588 hidinput->input.dev = &hid->intf->dev;
591 for (i = 0; i < report->maxfield; i++)
592 for (j = 0; j < report->field[i]->maxusage; j++)
593 hidinput_configure_usage(hidinput, report->field[i],
594 report->field[i]->usage + j);
596 if (hid->quirks & HID_QUIRK_MULTI_INPUT) {
597 /* This will leave hidinput NULL, so that it
598 * allocates another one if we have more inputs on
599 * the same interface. Some devices (e.g. Happ's
600 * UGCI) cram a lot of unrelated inputs into the
602 hidinput->report = report;
603 input_register_device(&hidinput->input);
608 /* This only gets called when we are a single-input (most of the
609 * time). IOW, not a HID_QUIRK_MULTI_INPUT. The hid_ff_init() is
610 * only useful in this case, and not for multi-input quirks. */
613 input_register_device(&hidinput->input);
619 void hidinput_disconnect(struct hid_device *hid)
621 struct list_head *lh, *next;
622 struct hid_input *hidinput;
624 list_for_each_safe(lh, next, &hid->inputs) {
625 hidinput = list_entry(lh, struct hid_input, list);
626 input_unregister_device(&hidinput->input);
627 list_del(&hidinput->list);