x86/speculation/mds: Fix documentation typo
[linux/fpc-iii.git] / drivers / hid / hid-input.c
blob1aa7d268686b969b76b3712a5cc27ad92d1fffe8
1 /*
2 * Copyright (c) 2000-2001 Vojtech Pavlik
3 * Copyright (c) 2006-2010 Jiri Kosina
5 * HID to Linux Input mapping
6 */
8 /*
9 * This program is free software; you can redistribute it and/or modify
10 * it under the terms of the GNU General Public License as published by
11 * the Free Software Foundation; either version 2 of the License, or
12 * (at your option) any later version.
14 * This program is distributed in the hope that it will be useful,
15 * but WITHOUT ANY WARRANTY; without even the implied warranty of
16 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17 * GNU General Public License for more details.
19 * You should have received a copy of the GNU General Public License
20 * along with this program; if not, write to the Free Software
21 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
23 * Should you need to contact me, the author, you can do so either by
24 * e-mail - mail your message to <vojtech@ucw.cz>, or by paper mail:
25 * Vojtech Pavlik, Simunkova 1594, Prague 8, 182 00 Czech Republic
28 #include <linux/module.h>
29 #include <linux/slab.h>
30 #include <linux/kernel.h>
32 #include <linux/hid.h>
33 #include <linux/hid-debug.h>
35 #include "hid-ids.h"
37 #define unk KEY_UNKNOWN
39 static const unsigned char hid_keyboard[256] = {
40 0, 0, 0, 0, 30, 48, 46, 32, 18, 33, 34, 35, 23, 36, 37, 38,
41 50, 49, 24, 25, 16, 19, 31, 20, 22, 47, 17, 45, 21, 44, 2, 3,
42 4, 5, 6, 7, 8, 9, 10, 11, 28, 1, 14, 15, 57, 12, 13, 26,
43 27, 43, 43, 39, 40, 41, 51, 52, 53, 58, 59, 60, 61, 62, 63, 64,
44 65, 66, 67, 68, 87, 88, 99, 70,119,110,102,104,111,107,109,106,
45 105,108,103, 69, 98, 55, 74, 78, 96, 79, 80, 81, 75, 76, 77, 71,
46 72, 73, 82, 83, 86,127,116,117,183,184,185,186,187,188,189,190,
47 191,192,193,194,134,138,130,132,128,129,131,137,133,135,136,113,
48 115,114,unk,unk,unk,121,unk, 89, 93,124, 92, 94, 95,unk,unk,unk,
49 122,123, 90, 91, 85,unk,unk,unk,unk,unk,unk,unk,111,unk,unk,unk,
50 unk,unk,unk,unk,unk,unk,unk,unk,unk,unk,unk,unk,unk,unk,unk,unk,
51 unk,unk,unk,unk,unk,unk,179,180,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,111,unk,unk,unk,unk,unk,unk,unk,
54 29, 42, 56,125, 97, 54,100,126,164,166,165,163,161,115,114,113,
55 150,158,159,128,136,177,178,176,142,152,173,140,unk,unk,unk,unk
58 static const struct {
59 __s32 x;
60 __s32 y;
61 } hid_hat_to_axis[] = {{ 0, 0}, { 0,-1}, { 1,-1}, { 1, 0}, { 1, 1}, { 0, 1}, {-1, 1}, {-1, 0}, {-1,-1}};
63 #define map_abs(c) hid_map_usage(hidinput, usage, &bit, &max, EV_ABS, (c))
64 #define map_rel(c) hid_map_usage(hidinput, usage, &bit, &max, EV_REL, (c))
65 #define map_key(c) hid_map_usage(hidinput, usage, &bit, &max, EV_KEY, (c))
66 #define map_led(c) hid_map_usage(hidinput, usage, &bit, &max, EV_LED, (c))
68 #define map_abs_clear(c) hid_map_usage_clear(hidinput, usage, &bit, \
69 &max, EV_ABS, (c))
70 #define map_key_clear(c) hid_map_usage_clear(hidinput, usage, &bit, \
71 &max, EV_KEY, (c))
73 static bool match_scancode(struct hid_usage *usage,
74 unsigned int cur_idx, unsigned int scancode)
76 return (usage->hid & (HID_USAGE_PAGE | HID_USAGE)) == scancode;
79 static bool match_keycode(struct hid_usage *usage,
80 unsigned int cur_idx, unsigned int keycode)
83 * We should exclude unmapped usages when doing lookup by keycode.
85 return (usage->type == EV_KEY && usage->code == keycode);
88 static bool match_index(struct hid_usage *usage,
89 unsigned int cur_idx, unsigned int idx)
91 return cur_idx == idx;
94 typedef bool (*hid_usage_cmp_t)(struct hid_usage *usage,
95 unsigned int cur_idx, unsigned int val);
97 static struct hid_usage *hidinput_find_key(struct hid_device *hid,
98 hid_usage_cmp_t match,
99 unsigned int value,
100 unsigned int *usage_idx)
102 unsigned int i, j, k, cur_idx = 0;
103 struct hid_report *report;
104 struct hid_usage *usage;
106 for (k = HID_INPUT_REPORT; k <= HID_OUTPUT_REPORT; k++) {
107 list_for_each_entry(report, &hid->report_enum[k].report_list, list) {
108 for (i = 0; i < report->maxfield; i++) {
109 for (j = 0; j < report->field[i]->maxusage; j++) {
110 usage = report->field[i]->usage + j;
111 if (usage->type == EV_KEY || usage->type == 0) {
112 if (match(usage, cur_idx, value)) {
113 if (usage_idx)
114 *usage_idx = cur_idx;
115 return usage;
117 cur_idx++;
123 return NULL;
126 static struct hid_usage *hidinput_locate_usage(struct hid_device *hid,
127 const struct input_keymap_entry *ke,
128 unsigned int *index)
130 struct hid_usage *usage;
131 unsigned int scancode;
133 if (ke->flags & INPUT_KEYMAP_BY_INDEX)
134 usage = hidinput_find_key(hid, match_index, ke->index, index);
135 else if (input_scancode_to_scalar(ke, &scancode) == 0)
136 usage = hidinput_find_key(hid, match_scancode, scancode, index);
137 else
138 usage = NULL;
140 return usage;
143 static int hidinput_getkeycode(struct input_dev *dev,
144 struct input_keymap_entry *ke)
146 struct hid_device *hid = input_get_drvdata(dev);
147 struct hid_usage *usage;
148 unsigned int scancode, index;
150 usage = hidinput_locate_usage(hid, ke, &index);
151 if (usage) {
152 ke->keycode = usage->type == EV_KEY ?
153 usage->code : KEY_RESERVED;
154 ke->index = index;
155 scancode = usage->hid & (HID_USAGE_PAGE | HID_USAGE);
156 ke->len = sizeof(scancode);
157 memcpy(ke->scancode, &scancode, sizeof(scancode));
158 return 0;
161 return -EINVAL;
164 static int hidinput_setkeycode(struct input_dev *dev,
165 const struct input_keymap_entry *ke,
166 unsigned int *old_keycode)
168 struct hid_device *hid = input_get_drvdata(dev);
169 struct hid_usage *usage;
171 usage = hidinput_locate_usage(hid, ke, NULL);
172 if (usage) {
173 *old_keycode = usage->type == EV_KEY ?
174 usage->code : KEY_RESERVED;
175 usage->code = ke->keycode;
177 clear_bit(*old_keycode, dev->keybit);
178 set_bit(usage->code, dev->keybit);
179 dbg_hid("Assigned keycode %d to HID usage code %x\n",
180 usage->code, usage->hid);
183 * Set the keybit for the old keycode if the old keycode is used
184 * by another key
186 if (hidinput_find_key(hid, match_keycode, *old_keycode, NULL))
187 set_bit(*old_keycode, dev->keybit);
189 return 0;
192 return -EINVAL;
197 * hidinput_calc_abs_res - calculate an absolute axis resolution
198 * @field: the HID report field to calculate resolution for
199 * @code: axis code
201 * The formula is:
202 * (logical_maximum - logical_minimum)
203 * resolution = ----------------------------------------------------------
204 * (physical_maximum - physical_minimum) * 10 ^ unit_exponent
206 * as seen in the HID specification v1.11 6.2.2.7 Global Items.
208 * Only exponent 1 length units are processed. Centimeters and inches are
209 * converted to millimeters. Degrees are converted to radians.
211 __s32 hidinput_calc_abs_res(const struct hid_field *field, __u16 code)
213 __s32 unit_exponent = field->unit_exponent;
214 __s32 logical_extents = field->logical_maximum -
215 field->logical_minimum;
216 __s32 physical_extents = field->physical_maximum -
217 field->physical_minimum;
218 __s32 prev;
220 /* Check if the extents are sane */
221 if (logical_extents <= 0 || physical_extents <= 0)
222 return 0;
225 * Verify and convert units.
226 * See HID specification v1.11 6.2.2.7 Global Items for unit decoding
228 switch (code) {
229 case ABS_X:
230 case ABS_Y:
231 case ABS_Z:
232 case ABS_MT_POSITION_X:
233 case ABS_MT_POSITION_Y:
234 case ABS_MT_TOOL_X:
235 case ABS_MT_TOOL_Y:
236 case ABS_MT_TOUCH_MAJOR:
237 case ABS_MT_TOUCH_MINOR:
238 if (field->unit == 0x11) { /* If centimeters */
239 /* Convert to millimeters */
240 unit_exponent += 1;
241 } else if (field->unit == 0x13) { /* If inches */
242 /* Convert to millimeters */
243 prev = physical_extents;
244 physical_extents *= 254;
245 if (physical_extents < prev)
246 return 0;
247 unit_exponent -= 1;
248 } else {
249 return 0;
251 break;
253 case ABS_RX:
254 case ABS_RY:
255 case ABS_RZ:
256 case ABS_WHEEL:
257 case ABS_TILT_X:
258 case ABS_TILT_Y:
259 if (field->unit == 0x14) { /* If degrees */
260 /* Convert to radians */
261 prev = logical_extents;
262 logical_extents *= 573;
263 if (logical_extents < prev)
264 return 0;
265 unit_exponent += 1;
266 } else if (field->unit != 0x12) { /* If not radians */
267 return 0;
269 break;
271 default:
272 return 0;
275 /* Apply negative unit exponent */
276 for (; unit_exponent < 0; unit_exponent++) {
277 prev = logical_extents;
278 logical_extents *= 10;
279 if (logical_extents < prev)
280 return 0;
282 /* Apply positive unit exponent */
283 for (; unit_exponent > 0; unit_exponent--) {
284 prev = physical_extents;
285 physical_extents *= 10;
286 if (physical_extents < prev)
287 return 0;
290 /* Calculate resolution */
291 return DIV_ROUND_CLOSEST(logical_extents, physical_extents);
293 EXPORT_SYMBOL_GPL(hidinput_calc_abs_res);
295 #ifdef CONFIG_HID_BATTERY_STRENGTH
296 static enum power_supply_property hidinput_battery_props[] = {
297 POWER_SUPPLY_PROP_PRESENT,
298 POWER_SUPPLY_PROP_ONLINE,
299 POWER_SUPPLY_PROP_CAPACITY,
300 POWER_SUPPLY_PROP_MODEL_NAME,
301 POWER_SUPPLY_PROP_STATUS,
302 POWER_SUPPLY_PROP_SCOPE,
305 #define HID_BATTERY_QUIRK_PERCENT (1 << 0) /* always reports percent */
306 #define HID_BATTERY_QUIRK_FEATURE (1 << 1) /* ask for feature report */
307 #define HID_BATTERY_QUIRK_IGNORE (1 << 2) /* completely ignore the battery */
309 static const struct hid_device_id hid_battery_quirks[] = {
310 { HID_BLUETOOTH_DEVICE(USB_VENDOR_ID_APPLE,
311 USB_DEVICE_ID_APPLE_ALU_WIRELESS_2009_ISO),
312 HID_BATTERY_QUIRK_PERCENT | HID_BATTERY_QUIRK_FEATURE },
313 { HID_BLUETOOTH_DEVICE(USB_VENDOR_ID_APPLE,
314 USB_DEVICE_ID_APPLE_ALU_WIRELESS_2009_ANSI),
315 HID_BATTERY_QUIRK_PERCENT | HID_BATTERY_QUIRK_FEATURE },
316 { HID_BLUETOOTH_DEVICE(USB_VENDOR_ID_APPLE,
317 USB_DEVICE_ID_APPLE_ALU_WIRELESS_2011_ANSI),
318 HID_BATTERY_QUIRK_PERCENT | HID_BATTERY_QUIRK_FEATURE },
319 { HID_BLUETOOTH_DEVICE(USB_VENDOR_ID_APPLE,
320 USB_DEVICE_ID_APPLE_ALU_WIRELESS_2011_ISO),
321 HID_BATTERY_QUIRK_PERCENT | HID_BATTERY_QUIRK_FEATURE },
322 { HID_BLUETOOTH_DEVICE(USB_VENDOR_ID_APPLE,
323 USB_DEVICE_ID_APPLE_ALU_WIRELESS_ANSI),
324 HID_BATTERY_QUIRK_PERCENT | HID_BATTERY_QUIRK_FEATURE },
325 { HID_BLUETOOTH_DEVICE(USB_VENDOR_ID_ELECOM,
326 USB_DEVICE_ID_ELECOM_BM084),
327 HID_BATTERY_QUIRK_IGNORE },
328 { HID_USB_DEVICE(USB_VENDOR_ID_SYMBOL,
329 USB_DEVICE_ID_SYMBOL_SCANNER_3),
330 HID_BATTERY_QUIRK_IGNORE },
334 static unsigned find_battery_quirk(struct hid_device *hdev)
336 unsigned quirks = 0;
337 const struct hid_device_id *match;
339 match = hid_match_id(hdev, hid_battery_quirks);
340 if (match != NULL)
341 quirks = match->driver_data;
343 return quirks;
346 static int hidinput_scale_battery_capacity(struct hid_device *dev,
347 int value)
349 if (dev->battery_min < dev->battery_max &&
350 value >= dev->battery_min && value <= dev->battery_max)
351 value = ((value - dev->battery_min) * 100) /
352 (dev->battery_max - dev->battery_min);
354 return value;
357 static int hidinput_query_battery_capacity(struct hid_device *dev)
359 u8 *buf;
360 int ret;
362 buf = kmalloc(2, GFP_KERNEL);
363 if (!buf)
364 return -ENOMEM;
366 ret = hid_hw_raw_request(dev, dev->battery_report_id, buf, 2,
367 dev->battery_report_type, HID_REQ_GET_REPORT);
368 if (ret != 2) {
369 kfree(buf);
370 return -ENODATA;
373 ret = hidinput_scale_battery_capacity(dev, buf[1]);
374 kfree(buf);
375 return ret;
378 static int hidinput_get_battery_property(struct power_supply *psy,
379 enum power_supply_property prop,
380 union power_supply_propval *val)
382 struct hid_device *dev = power_supply_get_drvdata(psy);
383 int value;
384 int ret = 0;
386 switch (prop) {
387 case POWER_SUPPLY_PROP_PRESENT:
388 case POWER_SUPPLY_PROP_ONLINE:
389 val->intval = 1;
390 break;
392 case POWER_SUPPLY_PROP_CAPACITY:
393 if (dev->battery_status != HID_BATTERY_REPORTED &&
394 !dev->battery_avoid_query) {
395 value = hidinput_query_battery_capacity(dev);
396 if (value < 0)
397 return value;
398 } else {
399 value = dev->battery_capacity;
402 val->intval = value;
403 break;
405 case POWER_SUPPLY_PROP_MODEL_NAME:
406 val->strval = dev->name;
407 break;
409 case POWER_SUPPLY_PROP_STATUS:
410 if (dev->battery_status != HID_BATTERY_REPORTED &&
411 !dev->battery_avoid_query) {
412 value = hidinput_query_battery_capacity(dev);
413 if (value < 0)
414 return value;
416 dev->battery_capacity = value;
417 dev->battery_status = HID_BATTERY_QUERIED;
420 if (dev->battery_status == HID_BATTERY_UNKNOWN)
421 val->intval = POWER_SUPPLY_STATUS_UNKNOWN;
422 else if (dev->battery_capacity == 100)
423 val->intval = POWER_SUPPLY_STATUS_FULL;
424 else
425 val->intval = POWER_SUPPLY_STATUS_DISCHARGING;
426 break;
428 case POWER_SUPPLY_PROP_SCOPE:
429 val->intval = POWER_SUPPLY_SCOPE_DEVICE;
430 break;
432 default:
433 ret = -EINVAL;
434 break;
437 return ret;
440 static int hidinput_setup_battery(struct hid_device *dev, unsigned report_type, struct hid_field *field)
442 struct power_supply_desc *psy_desc;
443 struct power_supply_config psy_cfg = { .drv_data = dev, };
444 unsigned quirks;
445 s32 min, max;
446 int error;
448 if (dev->battery)
449 return 0; /* already initialized? */
451 quirks = find_battery_quirk(dev);
453 hid_dbg(dev, "device %x:%x:%x %d quirks %d\n",
454 dev->bus, dev->vendor, dev->product, dev->version, quirks);
456 if (quirks & HID_BATTERY_QUIRK_IGNORE)
457 return 0;
459 psy_desc = kzalloc(sizeof(*psy_desc), GFP_KERNEL);
460 if (!psy_desc)
461 return -ENOMEM;
463 psy_desc->name = kasprintf(GFP_KERNEL, "hid-%s-battery",
464 strlen(dev->uniq) ?
465 dev->uniq : dev_name(&dev->dev));
466 if (!psy_desc->name) {
467 error = -ENOMEM;
468 goto err_free_mem;
471 psy_desc->type = POWER_SUPPLY_TYPE_BATTERY;
472 psy_desc->properties = hidinput_battery_props;
473 psy_desc->num_properties = ARRAY_SIZE(hidinput_battery_props);
474 psy_desc->use_for_apm = 0;
475 psy_desc->get_property = hidinput_get_battery_property;
477 min = field->logical_minimum;
478 max = field->logical_maximum;
480 if (quirks & HID_BATTERY_QUIRK_PERCENT) {
481 min = 0;
482 max = 100;
485 if (quirks & HID_BATTERY_QUIRK_FEATURE)
486 report_type = HID_FEATURE_REPORT;
488 dev->battery_min = min;
489 dev->battery_max = max;
490 dev->battery_report_type = report_type;
491 dev->battery_report_id = field->report->id;
494 * Stylus is normally not connected to the device and thus we
495 * can't query the device and get meaningful battery strength.
496 * We have to wait for the device to report it on its own.
498 dev->battery_avoid_query = report_type == HID_INPUT_REPORT &&
499 field->physical == HID_DG_STYLUS;
501 dev->battery = power_supply_register(&dev->dev, psy_desc, &psy_cfg);
502 if (IS_ERR(dev->battery)) {
503 error = PTR_ERR(dev->battery);
504 hid_warn(dev, "can't register power supply: %d\n", error);
505 goto err_free_name;
508 power_supply_powers(dev->battery, &dev->dev);
509 return 0;
511 err_free_name:
512 kfree(psy_desc->name);
513 err_free_mem:
514 kfree(psy_desc);
515 dev->battery = NULL;
516 return error;
519 static void hidinput_cleanup_battery(struct hid_device *dev)
521 const struct power_supply_desc *psy_desc;
523 if (!dev->battery)
524 return;
526 psy_desc = dev->battery->desc;
527 power_supply_unregister(dev->battery);
528 kfree(psy_desc->name);
529 kfree(psy_desc);
530 dev->battery = NULL;
533 static void hidinput_update_battery(struct hid_device *dev, int value)
535 int capacity;
537 if (!dev->battery)
538 return;
540 if (value == 0 || value < dev->battery_min || value > dev->battery_max)
541 return;
543 capacity = hidinput_scale_battery_capacity(dev, value);
545 if (dev->battery_status != HID_BATTERY_REPORTED ||
546 capacity != dev->battery_capacity) {
547 dev->battery_capacity = capacity;
548 dev->battery_status = HID_BATTERY_REPORTED;
549 power_supply_changed(dev->battery);
552 #else /* !CONFIG_HID_BATTERY_STRENGTH */
553 static int hidinput_setup_battery(struct hid_device *dev, unsigned report_type,
554 struct hid_field *field)
556 return 0;
559 static void hidinput_cleanup_battery(struct hid_device *dev)
563 static void hidinput_update_battery(struct hid_device *dev, int value)
566 #endif /* CONFIG_HID_BATTERY_STRENGTH */
568 static void hidinput_configure_usage(struct hid_input *hidinput, struct hid_field *field,
569 struct hid_usage *usage)
571 struct input_dev *input = hidinput->input;
572 struct hid_device *device = input_get_drvdata(input);
573 int max = 0, code;
574 unsigned long *bit = NULL;
576 field->hidinput = hidinput;
578 if (field->flags & HID_MAIN_ITEM_CONSTANT)
579 goto ignore;
581 /* Ignore if report count is out of bounds. */
582 if (field->report_count < 1)
583 goto ignore;
585 /* only LED usages are supported in output fields */
586 if (field->report_type == HID_OUTPUT_REPORT &&
587 (usage->hid & HID_USAGE_PAGE) != HID_UP_LED) {
588 goto ignore;
591 if (device->driver->input_mapping) {
592 int ret = device->driver->input_mapping(device, hidinput, field,
593 usage, &bit, &max);
594 if (ret > 0)
595 goto mapped;
596 if (ret < 0)
597 goto ignore;
600 switch (usage->hid & HID_USAGE_PAGE) {
601 case HID_UP_UNDEFINED:
602 goto ignore;
604 case HID_UP_KEYBOARD:
605 set_bit(EV_REP, input->evbit);
607 if ((usage->hid & HID_USAGE) < 256) {
608 if (!hid_keyboard[usage->hid & HID_USAGE]) goto ignore;
609 map_key_clear(hid_keyboard[usage->hid & HID_USAGE]);
610 } else
611 map_key(KEY_UNKNOWN);
613 break;
615 case HID_UP_BUTTON:
616 code = ((usage->hid - 1) & HID_USAGE);
618 switch (field->application) {
619 case HID_GD_MOUSE:
620 case HID_GD_POINTER: code += BTN_MOUSE; break;
621 case HID_GD_JOYSTICK:
622 if (code <= 0xf)
623 code += BTN_JOYSTICK;
624 else
625 code += BTN_TRIGGER_HAPPY - 0x10;
626 break;
627 case HID_GD_GAMEPAD:
628 if (code <= 0xf)
629 code += BTN_GAMEPAD;
630 else
631 code += BTN_TRIGGER_HAPPY - 0x10;
632 break;
633 default:
634 switch (field->physical) {
635 case HID_GD_MOUSE:
636 case HID_GD_POINTER: code += BTN_MOUSE; break;
637 case HID_GD_JOYSTICK: code += BTN_JOYSTICK; break;
638 case HID_GD_GAMEPAD: code += BTN_GAMEPAD; break;
639 default: code += BTN_MISC;
643 map_key(code);
644 break;
646 case HID_UP_SIMULATION:
647 switch (usage->hid & 0xffff) {
648 case 0xba: map_abs(ABS_RUDDER); break;
649 case 0xbb: map_abs(ABS_THROTTLE); break;
650 case 0xc4: map_abs(ABS_GAS); break;
651 case 0xc5: map_abs(ABS_BRAKE); break;
652 case 0xc8: map_abs(ABS_WHEEL); break;
653 default: goto ignore;
655 break;
657 case HID_UP_GENDESK:
658 if ((usage->hid & 0xf0) == 0x80) { /* SystemControl */
659 switch (usage->hid & 0xf) {
660 case 0x1: map_key_clear(KEY_POWER); break;
661 case 0x2: map_key_clear(KEY_SLEEP); break;
662 case 0x3: map_key_clear(KEY_WAKEUP); break;
663 case 0x4: map_key_clear(KEY_CONTEXT_MENU); break;
664 case 0x5: map_key_clear(KEY_MENU); break;
665 case 0x6: map_key_clear(KEY_PROG1); break;
666 case 0x7: map_key_clear(KEY_HELP); break;
667 case 0x8: map_key_clear(KEY_EXIT); break;
668 case 0x9: map_key_clear(KEY_SELECT); break;
669 case 0xa: map_key_clear(KEY_RIGHT); break;
670 case 0xb: map_key_clear(KEY_LEFT); break;
671 case 0xc: map_key_clear(KEY_UP); break;
672 case 0xd: map_key_clear(KEY_DOWN); break;
673 case 0xe: map_key_clear(KEY_POWER2); break;
674 case 0xf: map_key_clear(KEY_RESTART); break;
675 default: goto unknown;
677 break;
681 * Some lazy vendors declare 255 usages for System Control,
682 * leading to the creation of ABS_X|Y axis and too many others.
683 * It wouldn't be a problem if joydev doesn't consider the
684 * device as a joystick then.
686 if (field->application == HID_GD_SYSTEM_CONTROL)
687 goto ignore;
689 if ((usage->hid & 0xf0) == 0x90) { /* D-pad */
690 switch (usage->hid) {
691 case HID_GD_UP: usage->hat_dir = 1; break;
692 case HID_GD_DOWN: usage->hat_dir = 5; break;
693 case HID_GD_RIGHT: usage->hat_dir = 3; break;
694 case HID_GD_LEFT: usage->hat_dir = 7; break;
695 default: goto unknown;
697 if (field->dpad) {
698 map_abs(field->dpad);
699 goto ignore;
701 map_abs(ABS_HAT0X);
702 break;
705 switch (usage->hid) {
706 /* These usage IDs map directly to the usage codes. */
707 case HID_GD_X: case HID_GD_Y: case HID_GD_Z:
708 case HID_GD_RX: case HID_GD_RY: case HID_GD_RZ:
709 if (field->flags & HID_MAIN_ITEM_RELATIVE)
710 map_rel(usage->hid & 0xf);
711 else
712 map_abs_clear(usage->hid & 0xf);
713 break;
715 case HID_GD_SLIDER: case HID_GD_DIAL: case HID_GD_WHEEL:
716 if (field->flags & HID_MAIN_ITEM_RELATIVE)
717 map_rel(usage->hid & 0xf);
718 else
719 map_abs(usage->hid & 0xf);
720 break;
722 case HID_GD_HATSWITCH:
723 usage->hat_min = field->logical_minimum;
724 usage->hat_max = field->logical_maximum;
725 map_abs(ABS_HAT0X);
726 break;
728 case HID_GD_START: map_key_clear(BTN_START); break;
729 case HID_GD_SELECT: map_key_clear(BTN_SELECT); break;
731 case HID_GD_RFKILL_BTN:
732 /* MS wireless radio ctl extension, also check CA */
733 if (field->application == HID_GD_WIRELESS_RADIO_CTLS) {
734 map_key_clear(KEY_RFKILL);
735 /* We need to simulate the btn release */
736 field->flags |= HID_MAIN_ITEM_RELATIVE;
737 break;
740 default: goto unknown;
743 break;
745 case HID_UP_LED:
746 switch (usage->hid & 0xffff) { /* HID-Value: */
747 case 0x01: map_led (LED_NUML); break; /* "Num Lock" */
748 case 0x02: map_led (LED_CAPSL); break; /* "Caps Lock" */
749 case 0x03: map_led (LED_SCROLLL); break; /* "Scroll Lock" */
750 case 0x04: map_led (LED_COMPOSE); break; /* "Compose" */
751 case 0x05: map_led (LED_KANA); break; /* "Kana" */
752 case 0x27: map_led (LED_SLEEP); break; /* "Stand-By" */
753 case 0x4c: map_led (LED_SUSPEND); break; /* "System Suspend" */
754 case 0x09: map_led (LED_MUTE); break; /* "Mute" */
755 case 0x4b: map_led (LED_MISC); break; /* "Generic Indicator" */
756 case 0x19: map_led (LED_MAIL); break; /* "Message Waiting" */
757 case 0x4d: map_led (LED_CHARGING); break; /* "External Power Connected" */
759 default: goto ignore;
761 break;
763 case HID_UP_DIGITIZER:
764 switch (usage->hid & 0xff) {
765 case 0x00: /* Undefined */
766 goto ignore;
768 case 0x30: /* TipPressure */
769 if (!test_bit(BTN_TOUCH, input->keybit)) {
770 device->quirks |= HID_QUIRK_NOTOUCH;
771 set_bit(EV_KEY, input->evbit);
772 set_bit(BTN_TOUCH, input->keybit);
774 map_abs_clear(ABS_PRESSURE);
775 break;
777 case 0x32: /* InRange */
778 switch (field->physical & 0xff) {
779 case 0x21: map_key(BTN_TOOL_MOUSE); break;
780 case 0x22: map_key(BTN_TOOL_FINGER); break;
781 default: map_key(BTN_TOOL_PEN); break;
783 break;
785 case 0x3b: /* Battery Strength */
786 hidinput_setup_battery(device, HID_INPUT_REPORT, field);
787 usage->type = EV_PWR;
788 goto ignore;
790 case 0x3c: /* Invert */
791 map_key_clear(BTN_TOOL_RUBBER);
792 break;
794 case 0x3d: /* X Tilt */
795 map_abs_clear(ABS_TILT_X);
796 break;
798 case 0x3e: /* Y Tilt */
799 map_abs_clear(ABS_TILT_Y);
800 break;
802 case 0x33: /* Touch */
803 case 0x42: /* TipSwitch */
804 case 0x43: /* TipSwitch2 */
805 device->quirks &= ~HID_QUIRK_NOTOUCH;
806 map_key_clear(BTN_TOUCH);
807 break;
809 case 0x44: /* BarrelSwitch */
810 map_key_clear(BTN_STYLUS);
811 break;
813 case 0x46: /* TabletPick */
814 case 0x5a: /* SecondaryBarrelSwitch */
815 map_key_clear(BTN_STYLUS2);
816 break;
818 case 0x5b: /* TransducerSerialNumber */
819 usage->type = EV_MSC;
820 usage->code = MSC_SERIAL;
821 bit = input->mscbit;
822 max = MSC_MAX;
823 break;
825 default: goto unknown;
827 break;
829 case HID_UP_TELEPHONY:
830 switch (usage->hid & HID_USAGE) {
831 case 0x2f: map_key_clear(KEY_MICMUTE); break;
832 case 0xb0: map_key_clear(KEY_NUMERIC_0); break;
833 case 0xb1: map_key_clear(KEY_NUMERIC_1); break;
834 case 0xb2: map_key_clear(KEY_NUMERIC_2); break;
835 case 0xb3: map_key_clear(KEY_NUMERIC_3); break;
836 case 0xb4: map_key_clear(KEY_NUMERIC_4); break;
837 case 0xb5: map_key_clear(KEY_NUMERIC_5); break;
838 case 0xb6: map_key_clear(KEY_NUMERIC_6); break;
839 case 0xb7: map_key_clear(KEY_NUMERIC_7); break;
840 case 0xb8: map_key_clear(KEY_NUMERIC_8); break;
841 case 0xb9: map_key_clear(KEY_NUMERIC_9); break;
842 case 0xba: map_key_clear(KEY_NUMERIC_STAR); break;
843 case 0xbb: map_key_clear(KEY_NUMERIC_POUND); break;
844 case 0xbc: map_key_clear(KEY_NUMERIC_A); break;
845 case 0xbd: map_key_clear(KEY_NUMERIC_B); break;
846 case 0xbe: map_key_clear(KEY_NUMERIC_C); break;
847 case 0xbf: map_key_clear(KEY_NUMERIC_D); break;
848 default: goto ignore;
850 break;
852 case HID_UP_CONSUMER: /* USB HUT v1.12, pages 75-84 */
853 switch (usage->hid & HID_USAGE) {
854 case 0x000: goto ignore;
855 case 0x030: map_key_clear(KEY_POWER); break;
856 case 0x031: map_key_clear(KEY_RESTART); break;
857 case 0x032: map_key_clear(KEY_SLEEP); break;
858 case 0x034: map_key_clear(KEY_SLEEP); break;
859 case 0x035: map_key_clear(KEY_KBDILLUMTOGGLE); break;
860 case 0x036: map_key_clear(BTN_MISC); break;
862 case 0x040: map_key_clear(KEY_MENU); break; /* Menu */
863 case 0x041: map_key_clear(KEY_SELECT); break; /* Menu Pick */
864 case 0x042: map_key_clear(KEY_UP); break; /* Menu Up */
865 case 0x043: map_key_clear(KEY_DOWN); break; /* Menu Down */
866 case 0x044: map_key_clear(KEY_LEFT); break; /* Menu Left */
867 case 0x045: map_key_clear(KEY_RIGHT); break; /* Menu Right */
868 case 0x046: map_key_clear(KEY_ESC); break; /* Menu Escape */
869 case 0x047: map_key_clear(KEY_KPPLUS); break; /* Menu Value Increase */
870 case 0x048: map_key_clear(KEY_KPMINUS); break; /* Menu Value Decrease */
872 case 0x060: map_key_clear(KEY_INFO); break; /* Data On Screen */
873 case 0x061: map_key_clear(KEY_SUBTITLE); break; /* Closed Caption */
874 case 0x063: map_key_clear(KEY_VCR); break; /* VCR/TV */
875 case 0x065: map_key_clear(KEY_CAMERA); break; /* Snapshot */
876 case 0x069: map_key_clear(KEY_RED); break;
877 case 0x06a: map_key_clear(KEY_GREEN); break;
878 case 0x06b: map_key_clear(KEY_BLUE); break;
879 case 0x06c: map_key_clear(KEY_YELLOW); break;
880 case 0x06d: map_key_clear(KEY_ZOOM); break;
882 case 0x06f: map_key_clear(KEY_BRIGHTNESSUP); break;
883 case 0x070: map_key_clear(KEY_BRIGHTNESSDOWN); break;
884 case 0x072: map_key_clear(KEY_BRIGHTNESS_TOGGLE); break;
885 case 0x073: map_key_clear(KEY_BRIGHTNESS_MIN); break;
886 case 0x074: map_key_clear(KEY_BRIGHTNESS_MAX); break;
887 case 0x075: map_key_clear(KEY_BRIGHTNESS_AUTO); break;
889 case 0x082: map_key_clear(KEY_VIDEO_NEXT); break;
890 case 0x083: map_key_clear(KEY_LAST); break;
891 case 0x084: map_key_clear(KEY_ENTER); break;
892 case 0x088: map_key_clear(KEY_PC); break;
893 case 0x089: map_key_clear(KEY_TV); break;
894 case 0x08a: map_key_clear(KEY_WWW); break;
895 case 0x08b: map_key_clear(KEY_DVD); break;
896 case 0x08c: map_key_clear(KEY_PHONE); break;
897 case 0x08d: map_key_clear(KEY_PROGRAM); break;
898 case 0x08e: map_key_clear(KEY_VIDEOPHONE); break;
899 case 0x08f: map_key_clear(KEY_GAMES); break;
900 case 0x090: map_key_clear(KEY_MEMO); break;
901 case 0x091: map_key_clear(KEY_CD); break;
902 case 0x092: map_key_clear(KEY_VCR); break;
903 case 0x093: map_key_clear(KEY_TUNER); break;
904 case 0x094: map_key_clear(KEY_EXIT); break;
905 case 0x095: map_key_clear(KEY_HELP); break;
906 case 0x096: map_key_clear(KEY_TAPE); break;
907 case 0x097: map_key_clear(KEY_TV2); break;
908 case 0x098: map_key_clear(KEY_SAT); break;
909 case 0x09a: map_key_clear(KEY_PVR); break;
911 case 0x09c: map_key_clear(KEY_CHANNELUP); break;
912 case 0x09d: map_key_clear(KEY_CHANNELDOWN); break;
913 case 0x0a0: map_key_clear(KEY_VCR2); break;
915 case 0x0b0: map_key_clear(KEY_PLAY); break;
916 case 0x0b1: map_key_clear(KEY_PAUSE); break;
917 case 0x0b2: map_key_clear(KEY_RECORD); break;
918 case 0x0b3: map_key_clear(KEY_FASTFORWARD); break;
919 case 0x0b4: map_key_clear(KEY_REWIND); break;
920 case 0x0b5: map_key_clear(KEY_NEXTSONG); break;
921 case 0x0b6: map_key_clear(KEY_PREVIOUSSONG); break;
922 case 0x0b7: map_key_clear(KEY_STOPCD); break;
923 case 0x0b8: map_key_clear(KEY_EJECTCD); break;
924 case 0x0bc: map_key_clear(KEY_MEDIA_REPEAT); break;
925 case 0x0b9: map_key_clear(KEY_SHUFFLE); break;
926 case 0x0bf: map_key_clear(KEY_SLOW); break;
928 case 0x0cd: map_key_clear(KEY_PLAYPAUSE); break;
929 case 0x0cf: map_key_clear(KEY_VOICECOMMAND); break;
930 case 0x0e0: map_abs_clear(ABS_VOLUME); break;
931 case 0x0e2: map_key_clear(KEY_MUTE); break;
932 case 0x0e5: map_key_clear(KEY_BASSBOOST); break;
933 case 0x0e9: map_key_clear(KEY_VOLUMEUP); break;
934 case 0x0ea: map_key_clear(KEY_VOLUMEDOWN); break;
935 case 0x0f5: map_key_clear(KEY_SLOW); break;
937 case 0x181: map_key_clear(KEY_BUTTONCONFIG); break;
938 case 0x182: map_key_clear(KEY_BOOKMARKS); break;
939 case 0x183: map_key_clear(KEY_CONFIG); break;
940 case 0x184: map_key_clear(KEY_WORDPROCESSOR); break;
941 case 0x185: map_key_clear(KEY_EDITOR); break;
942 case 0x186: map_key_clear(KEY_SPREADSHEET); break;
943 case 0x187: map_key_clear(KEY_GRAPHICSEDITOR); break;
944 case 0x188: map_key_clear(KEY_PRESENTATION); break;
945 case 0x189: map_key_clear(KEY_DATABASE); break;
946 case 0x18a: map_key_clear(KEY_MAIL); break;
947 case 0x18b: map_key_clear(KEY_NEWS); break;
948 case 0x18c: map_key_clear(KEY_VOICEMAIL); break;
949 case 0x18d: map_key_clear(KEY_ADDRESSBOOK); break;
950 case 0x18e: map_key_clear(KEY_CALENDAR); break;
951 case 0x18f: map_key_clear(KEY_TASKMANAGER); break;
952 case 0x190: map_key_clear(KEY_JOURNAL); break;
953 case 0x191: map_key_clear(KEY_FINANCE); break;
954 case 0x192: map_key_clear(KEY_CALC); break;
955 case 0x193: map_key_clear(KEY_PLAYER); break;
956 case 0x194: map_key_clear(KEY_FILE); break;
957 case 0x196: map_key_clear(KEY_WWW); break;
958 case 0x199: map_key_clear(KEY_CHAT); break;
959 case 0x19c: map_key_clear(KEY_LOGOFF); break;
960 case 0x19e: map_key_clear(KEY_COFFEE); break;
961 case 0x19f: map_key_clear(KEY_CONTROLPANEL); break;
962 case 0x1a2: map_key_clear(KEY_APPSELECT); break;
963 case 0x1a3: map_key_clear(KEY_NEXT); break;
964 case 0x1a4: map_key_clear(KEY_PREVIOUS); break;
965 case 0x1a6: map_key_clear(KEY_HELP); break;
966 case 0x1a7: map_key_clear(KEY_DOCUMENTS); break;
967 case 0x1ab: map_key_clear(KEY_SPELLCHECK); break;
968 case 0x1ae: map_key_clear(KEY_KEYBOARD); break;
969 case 0x1b1: map_key_clear(KEY_SCREENSAVER); break;
970 case 0x1b4: map_key_clear(KEY_FILE); break;
971 case 0x1b6: map_key_clear(KEY_IMAGES); break;
972 case 0x1b7: map_key_clear(KEY_AUDIO); break;
973 case 0x1b8: map_key_clear(KEY_VIDEO); break;
974 case 0x1bc: map_key_clear(KEY_MESSENGER); break;
975 case 0x1bd: map_key_clear(KEY_INFO); break;
976 case 0x1cb: map_key_clear(KEY_ASSISTANT); break;
977 case 0x201: map_key_clear(KEY_NEW); break;
978 case 0x202: map_key_clear(KEY_OPEN); break;
979 case 0x203: map_key_clear(KEY_CLOSE); break;
980 case 0x204: map_key_clear(KEY_EXIT); break;
981 case 0x207: map_key_clear(KEY_SAVE); break;
982 case 0x208: map_key_clear(KEY_PRINT); break;
983 case 0x209: map_key_clear(KEY_PROPS); break;
984 case 0x21a: map_key_clear(KEY_UNDO); break;
985 case 0x21b: map_key_clear(KEY_COPY); break;
986 case 0x21c: map_key_clear(KEY_CUT); break;
987 case 0x21d: map_key_clear(KEY_PASTE); break;
988 case 0x21f: map_key_clear(KEY_FIND); break;
989 case 0x221: map_key_clear(KEY_SEARCH); break;
990 case 0x222: map_key_clear(KEY_GOTO); break;
991 case 0x223: map_key_clear(KEY_HOMEPAGE); break;
992 case 0x224: map_key_clear(KEY_BACK); break;
993 case 0x225: map_key_clear(KEY_FORWARD); break;
994 case 0x226: map_key_clear(KEY_STOP); break;
995 case 0x227: map_key_clear(KEY_REFRESH); break;
996 case 0x22a: map_key_clear(KEY_BOOKMARKS); break;
997 case 0x22d: map_key_clear(KEY_ZOOMIN); break;
998 case 0x22e: map_key_clear(KEY_ZOOMOUT); break;
999 case 0x22f: map_key_clear(KEY_ZOOMRESET); break;
1000 case 0x233: map_key_clear(KEY_SCROLLUP); break;
1001 case 0x234: map_key_clear(KEY_SCROLLDOWN); break;
1002 case 0x238: map_rel(REL_HWHEEL); break;
1003 case 0x23d: map_key_clear(KEY_EDIT); break;
1004 case 0x25f: map_key_clear(KEY_CANCEL); break;
1005 case 0x269: map_key_clear(KEY_INSERT); break;
1006 case 0x26a: map_key_clear(KEY_DELETE); break;
1007 case 0x279: map_key_clear(KEY_REDO); break;
1009 case 0x289: map_key_clear(KEY_REPLY); break;
1010 case 0x28b: map_key_clear(KEY_FORWARDMAIL); break;
1011 case 0x28c: map_key_clear(KEY_SEND); break;
1013 case 0x2c7: map_key_clear(KEY_KBDINPUTASSIST_PREV); break;
1014 case 0x2c8: map_key_clear(KEY_KBDINPUTASSIST_NEXT); break;
1015 case 0x2c9: map_key_clear(KEY_KBDINPUTASSIST_PREVGROUP); break;
1016 case 0x2ca: map_key_clear(KEY_KBDINPUTASSIST_NEXTGROUP); break;
1017 case 0x2cb: map_key_clear(KEY_KBDINPUTASSIST_ACCEPT); break;
1018 case 0x2cc: map_key_clear(KEY_KBDINPUTASSIST_CANCEL); break;
1020 default: map_key_clear(KEY_UNKNOWN);
1022 break;
1024 case HID_UP_GENDEVCTRLS:
1025 switch (usage->hid) {
1026 case HID_DC_BATTERYSTRENGTH:
1027 hidinput_setup_battery(device, HID_INPUT_REPORT, field);
1028 usage->type = EV_PWR;
1029 goto ignore;
1031 goto unknown;
1033 case HID_UP_HPVENDOR: /* Reported on a Dutch layout HP5308 */
1034 set_bit(EV_REP, input->evbit);
1035 switch (usage->hid & HID_USAGE) {
1036 case 0x021: map_key_clear(KEY_PRINT); break;
1037 case 0x070: map_key_clear(KEY_HP); break;
1038 case 0x071: map_key_clear(KEY_CAMERA); break;
1039 case 0x072: map_key_clear(KEY_SOUND); break;
1040 case 0x073: map_key_clear(KEY_QUESTION); break;
1041 case 0x080: map_key_clear(KEY_EMAIL); break;
1042 case 0x081: map_key_clear(KEY_CHAT); break;
1043 case 0x082: map_key_clear(KEY_SEARCH); break;
1044 case 0x083: map_key_clear(KEY_CONNECT); break;
1045 case 0x084: map_key_clear(KEY_FINANCE); break;
1046 case 0x085: map_key_clear(KEY_SPORT); break;
1047 case 0x086: map_key_clear(KEY_SHOP); break;
1048 default: goto ignore;
1050 break;
1052 case HID_UP_HPVENDOR2:
1053 set_bit(EV_REP, input->evbit);
1054 switch (usage->hid & HID_USAGE) {
1055 case 0x001: map_key_clear(KEY_MICMUTE); break;
1056 case 0x003: map_key_clear(KEY_BRIGHTNESSDOWN); break;
1057 case 0x004: map_key_clear(KEY_BRIGHTNESSUP); break;
1058 default: goto ignore;
1060 break;
1062 case HID_UP_MSVENDOR:
1063 goto ignore;
1065 case HID_UP_CUSTOM: /* Reported on Logitech and Apple USB keyboards */
1066 set_bit(EV_REP, input->evbit);
1067 goto ignore;
1069 case HID_UP_LOGIVENDOR:
1070 /* intentional fallback */
1071 case HID_UP_LOGIVENDOR2:
1072 /* intentional fallback */
1073 case HID_UP_LOGIVENDOR3:
1074 goto ignore;
1076 case HID_UP_PID:
1077 switch (usage->hid & HID_USAGE) {
1078 case 0xa4: map_key_clear(BTN_DEAD); break;
1079 default: goto ignore;
1081 break;
1083 default:
1084 unknown:
1085 if (field->report_size == 1) {
1086 if (field->report->type == HID_OUTPUT_REPORT) {
1087 map_led(LED_MISC);
1088 break;
1090 map_key(BTN_MISC);
1091 break;
1093 if (field->flags & HID_MAIN_ITEM_RELATIVE) {
1094 map_rel(REL_MISC);
1095 break;
1097 map_abs(ABS_MISC);
1098 break;
1101 mapped:
1102 if (device->driver->input_mapped && device->driver->input_mapped(device,
1103 hidinput, field, usage, &bit, &max) < 0)
1104 goto ignore;
1106 set_bit(usage->type, input->evbit);
1108 while (usage->code <= max && test_and_set_bit(usage->code, bit))
1109 usage->code = find_next_zero_bit(bit, max + 1, usage->code);
1111 if (usage->code > max)
1112 goto ignore;
1114 if (usage->type == EV_ABS) {
1116 int a = field->logical_minimum;
1117 int b = field->logical_maximum;
1119 if ((device->quirks & HID_QUIRK_BADPAD) && (usage->code == ABS_X || usage->code == ABS_Y)) {
1120 a = field->logical_minimum = 0;
1121 b = field->logical_maximum = 255;
1124 if (field->application == HID_GD_GAMEPAD || field->application == HID_GD_JOYSTICK)
1125 input_set_abs_params(input, usage->code, a, b, (b - a) >> 8, (b - a) >> 4);
1126 else input_set_abs_params(input, usage->code, a, b, 0, 0);
1128 input_abs_set_res(input, usage->code,
1129 hidinput_calc_abs_res(field, usage->code));
1131 /* use a larger default input buffer for MT devices */
1132 if (usage->code == ABS_MT_POSITION_X && input->hint_events_per_packet == 0)
1133 input_set_events_per_packet(input, 60);
1136 if (usage->type == EV_ABS &&
1137 (usage->hat_min < usage->hat_max || usage->hat_dir)) {
1138 int i;
1139 for (i = usage->code; i < usage->code + 2 && i <= max; i++) {
1140 input_set_abs_params(input, i, -1, 1, 0, 0);
1141 set_bit(i, input->absbit);
1143 if (usage->hat_dir && !field->dpad)
1144 field->dpad = usage->code;
1147 /* for those devices which produce Consumer volume usage as relative,
1148 * we emulate pressing volumeup/volumedown appropriate number of times
1149 * in hidinput_hid_event()
1151 if ((usage->type == EV_ABS) && (field->flags & HID_MAIN_ITEM_RELATIVE) &&
1152 (usage->code == ABS_VOLUME)) {
1153 set_bit(KEY_VOLUMEUP, input->keybit);
1154 set_bit(KEY_VOLUMEDOWN, input->keybit);
1157 if (usage->type == EV_KEY) {
1158 set_bit(EV_MSC, input->evbit);
1159 set_bit(MSC_SCAN, input->mscbit);
1162 ignore:
1163 return;
1167 void hidinput_hid_event(struct hid_device *hid, struct hid_field *field, struct hid_usage *usage, __s32 value)
1169 struct input_dev *input;
1170 unsigned *quirks = &hid->quirks;
1172 if (!usage->type)
1173 return;
1175 if (usage->type == EV_PWR) {
1176 hidinput_update_battery(hid, value);
1177 return;
1180 if (!field->hidinput)
1181 return;
1183 input = field->hidinput->input;
1185 if (usage->hat_min < usage->hat_max || usage->hat_dir) {
1186 int hat_dir = usage->hat_dir;
1187 if (!hat_dir)
1188 hat_dir = (value - usage->hat_min) * 8 / (usage->hat_max - usage->hat_min + 1) + 1;
1189 if (hat_dir < 0 || hat_dir > 8) hat_dir = 0;
1190 input_event(input, usage->type, usage->code , hid_hat_to_axis[hat_dir].x);
1191 input_event(input, usage->type, usage->code + 1, hid_hat_to_axis[hat_dir].y);
1192 return;
1195 if (usage->hid == (HID_UP_DIGITIZER | 0x003c)) { /* Invert */
1196 *quirks = value ? (*quirks | HID_QUIRK_INVERT) : (*quirks & ~HID_QUIRK_INVERT);
1197 return;
1200 if (usage->hid == (HID_UP_DIGITIZER | 0x0032)) { /* InRange */
1201 if (value) {
1202 input_event(input, usage->type, (*quirks & HID_QUIRK_INVERT) ? BTN_TOOL_RUBBER : usage->code, 1);
1203 return;
1205 input_event(input, usage->type, usage->code, 0);
1206 input_event(input, usage->type, BTN_TOOL_RUBBER, 0);
1207 return;
1210 if (usage->hid == (HID_UP_DIGITIZER | 0x0030) && (*quirks & HID_QUIRK_NOTOUCH)) { /* Pressure */
1211 int a = field->logical_minimum;
1212 int b = field->logical_maximum;
1213 input_event(input, EV_KEY, BTN_TOUCH, value > a + ((b - a) >> 3));
1216 if (usage->hid == (HID_UP_PID | 0x83UL)) { /* Simultaneous Effects Max */
1217 dbg_hid("Maximum Effects - %d\n",value);
1218 return;
1221 if (usage->hid == (HID_UP_PID | 0x7fUL)) {
1222 dbg_hid("PID Pool Report\n");
1223 return;
1226 if ((usage->type == EV_KEY) && (usage->code == 0)) /* Key 0 is "unassigned", not KEY_UNKNOWN */
1227 return;
1229 if ((usage->type == EV_ABS) && (field->flags & HID_MAIN_ITEM_RELATIVE) &&
1230 (usage->code == ABS_VOLUME)) {
1231 int count = abs(value);
1232 int direction = value > 0 ? KEY_VOLUMEUP : KEY_VOLUMEDOWN;
1233 int i;
1235 for (i = 0; i < count; i++) {
1236 input_event(input, EV_KEY, direction, 1);
1237 input_sync(input);
1238 input_event(input, EV_KEY, direction, 0);
1239 input_sync(input);
1241 return;
1245 * Ignore out-of-range values as per HID specification,
1246 * section 5.10 and 6.2.25, when NULL state bit is present.
1247 * When it's not, clamp the value to match Microsoft's input
1248 * driver as mentioned in "Required HID usages for digitizers":
1249 * https://msdn.microsoft.com/en-us/library/windows/hardware/dn672278(v=vs.85).asp
1251 * The logical_minimum < logical_maximum check is done so that we
1252 * don't unintentionally discard values sent by devices which
1253 * don't specify logical min and max.
1255 if ((field->flags & HID_MAIN_ITEM_VARIABLE) &&
1256 (field->logical_minimum < field->logical_maximum)) {
1257 if (field->flags & HID_MAIN_ITEM_NULL_STATE &&
1258 (value < field->logical_minimum ||
1259 value > field->logical_maximum)) {
1260 dbg_hid("Ignoring out-of-range value %x\n", value);
1261 return;
1263 value = clamp(value,
1264 field->logical_minimum,
1265 field->logical_maximum);
1269 * Ignore reports for absolute data if the data didn't change. This is
1270 * not only an optimization but also fixes 'dead' key reports. Some
1271 * RollOver implementations for localized keys (like BACKSLASH/PIPE; HID
1272 * 0x31 and 0x32) report multiple keys, even though a localized keyboard
1273 * can only have one of them physically available. The 'dead' keys
1274 * report constant 0. As all map to the same keycode, they'd confuse
1275 * the input layer. If we filter the 'dead' keys on the HID level, we
1276 * skip the keycode translation and only forward real events.
1278 if (!(field->flags & (HID_MAIN_ITEM_RELATIVE |
1279 HID_MAIN_ITEM_BUFFERED_BYTE)) &&
1280 (field->flags & HID_MAIN_ITEM_VARIABLE) &&
1281 usage->usage_index < field->maxusage &&
1282 value == field->value[usage->usage_index])
1283 return;
1285 /* report the usage code as scancode if the key status has changed */
1286 if (usage->type == EV_KEY &&
1287 (!test_bit(usage->code, input->key)) == value)
1288 input_event(input, EV_MSC, MSC_SCAN, usage->hid);
1290 input_event(input, usage->type, usage->code, value);
1292 if ((field->flags & HID_MAIN_ITEM_RELATIVE) &&
1293 usage->type == EV_KEY && value) {
1294 input_sync(input);
1295 input_event(input, usage->type, usage->code, 0);
1299 void hidinput_report_event(struct hid_device *hid, struct hid_report *report)
1301 struct hid_input *hidinput;
1303 if (hid->quirks & HID_QUIRK_NO_INPUT_SYNC)
1304 return;
1306 list_for_each_entry(hidinput, &hid->inputs, list)
1307 input_sync(hidinput->input);
1309 EXPORT_SYMBOL_GPL(hidinput_report_event);
1311 int hidinput_find_field(struct hid_device *hid, unsigned int type, unsigned int code, struct hid_field **field)
1313 struct hid_report *report;
1314 int i, j;
1316 list_for_each_entry(report, &hid->report_enum[HID_OUTPUT_REPORT].report_list, list) {
1317 for (i = 0; i < report->maxfield; i++) {
1318 *field = report->field[i];
1319 for (j = 0; j < (*field)->maxusage; j++)
1320 if ((*field)->usage[j].type == type && (*field)->usage[j].code == code)
1321 return j;
1324 return -1;
1326 EXPORT_SYMBOL_GPL(hidinput_find_field);
1328 struct hid_field *hidinput_get_led_field(struct hid_device *hid)
1330 struct hid_report *report;
1331 struct hid_field *field;
1332 int i, j;
1334 list_for_each_entry(report,
1335 &hid->report_enum[HID_OUTPUT_REPORT].report_list,
1336 list) {
1337 for (i = 0; i < report->maxfield; i++) {
1338 field = report->field[i];
1339 for (j = 0; j < field->maxusage; j++)
1340 if (field->usage[j].type == EV_LED)
1341 return field;
1344 return NULL;
1346 EXPORT_SYMBOL_GPL(hidinput_get_led_field);
1348 unsigned int hidinput_count_leds(struct hid_device *hid)
1350 struct hid_report *report;
1351 struct hid_field *field;
1352 int i, j;
1353 unsigned int count = 0;
1355 list_for_each_entry(report,
1356 &hid->report_enum[HID_OUTPUT_REPORT].report_list,
1357 list) {
1358 for (i = 0; i < report->maxfield; i++) {
1359 field = report->field[i];
1360 for (j = 0; j < field->maxusage; j++)
1361 if (field->usage[j].type == EV_LED &&
1362 field->value[j])
1363 count += 1;
1366 return count;
1368 EXPORT_SYMBOL_GPL(hidinput_count_leds);
1370 static void hidinput_led_worker(struct work_struct *work)
1372 struct hid_device *hid = container_of(work, struct hid_device,
1373 led_work);
1374 struct hid_field *field;
1375 struct hid_report *report;
1376 int ret;
1377 u32 len;
1378 __u8 *buf;
1380 field = hidinput_get_led_field(hid);
1381 if (!field)
1382 return;
1385 * field->report is accessed unlocked regarding HID core. So there might
1386 * be another incoming SET-LED request from user-space, which changes
1387 * the LED state while we assemble our outgoing buffer. However, this
1388 * doesn't matter as hid_output_report() correctly converts it into a
1389 * boolean value no matter what information is currently set on the LED
1390 * field (even garbage). So the remote device will always get a valid
1391 * request.
1392 * And in case we send a wrong value, a next led worker is spawned
1393 * for every SET-LED request so the following worker will send the
1394 * correct value, guaranteed!
1397 report = field->report;
1399 /* use custom SET_REPORT request if possible (asynchronous) */
1400 if (hid->ll_driver->request)
1401 return hid->ll_driver->request(hid, report, HID_REQ_SET_REPORT);
1403 /* fall back to generic raw-output-report */
1404 len = hid_report_len(report);
1405 buf = hid_alloc_report_buf(report, GFP_KERNEL);
1406 if (!buf)
1407 return;
1409 hid_output_report(report, buf);
1410 /* synchronous output report */
1411 ret = hid_hw_output_report(hid, buf, len);
1412 if (ret == -ENOSYS)
1413 hid_hw_raw_request(hid, report->id, buf, len, HID_OUTPUT_REPORT,
1414 HID_REQ_SET_REPORT);
1415 kfree(buf);
1418 static int hidinput_input_event(struct input_dev *dev, unsigned int type,
1419 unsigned int code, int value)
1421 struct hid_device *hid = input_get_drvdata(dev);
1422 struct hid_field *field;
1423 int offset;
1425 if (type == EV_FF)
1426 return input_ff_event(dev, type, code, value);
1428 if (type != EV_LED)
1429 return -1;
1431 if ((offset = hidinput_find_field(hid, type, code, &field)) == -1) {
1432 hid_warn(dev, "event field not found\n");
1433 return -1;
1436 hid_set_field(field, offset, value);
1438 schedule_work(&hid->led_work);
1439 return 0;
1442 static int hidinput_open(struct input_dev *dev)
1444 struct hid_device *hid = input_get_drvdata(dev);
1446 return hid_hw_open(hid);
1449 static void hidinput_close(struct input_dev *dev)
1451 struct hid_device *hid = input_get_drvdata(dev);
1453 hid_hw_close(hid);
1456 static void report_features(struct hid_device *hid)
1458 struct hid_driver *drv = hid->driver;
1459 struct hid_report_enum *rep_enum;
1460 struct hid_report *rep;
1461 struct hid_usage *usage;
1462 int i, j;
1464 rep_enum = &hid->report_enum[HID_FEATURE_REPORT];
1465 list_for_each_entry(rep, &rep_enum->report_list, list)
1466 for (i = 0; i < rep->maxfield; i++) {
1467 /* Ignore if report count is out of bounds. */
1468 if (rep->field[i]->report_count < 1)
1469 continue;
1471 for (j = 0; j < rep->field[i]->maxusage; j++) {
1472 usage = &rep->field[i]->usage[j];
1474 /* Verify if Battery Strength feature is available */
1475 if (usage->hid == HID_DC_BATTERYSTRENGTH)
1476 hidinput_setup_battery(hid, HID_FEATURE_REPORT,
1477 rep->field[i]);
1479 if (drv->feature_mapping)
1480 drv->feature_mapping(hid, rep->field[i], usage);
1485 static struct hid_input *hidinput_allocate(struct hid_device *hid)
1487 struct hid_input *hidinput = kzalloc(sizeof(*hidinput), GFP_KERNEL);
1488 struct input_dev *input_dev = input_allocate_device();
1489 if (!hidinput || !input_dev) {
1490 kfree(hidinput);
1491 input_free_device(input_dev);
1492 hid_err(hid, "Out of memory during hid input probe\n");
1493 return NULL;
1496 input_set_drvdata(input_dev, hid);
1497 input_dev->event = hidinput_input_event;
1498 input_dev->open = hidinput_open;
1499 input_dev->close = hidinput_close;
1500 input_dev->setkeycode = hidinput_setkeycode;
1501 input_dev->getkeycode = hidinput_getkeycode;
1503 input_dev->name = hid->name;
1504 input_dev->phys = hid->phys;
1505 input_dev->uniq = hid->uniq;
1506 input_dev->id.bustype = hid->bus;
1507 input_dev->id.vendor = hid->vendor;
1508 input_dev->id.product = hid->product;
1509 input_dev->id.version = hid->version;
1510 input_dev->dev.parent = &hid->dev;
1511 hidinput->input = input_dev;
1512 list_add_tail(&hidinput->list, &hid->inputs);
1514 return hidinput;
1517 static bool hidinput_has_been_populated(struct hid_input *hidinput)
1519 int i;
1520 unsigned long r = 0;
1522 for (i = 0; i < BITS_TO_LONGS(EV_CNT); i++)
1523 r |= hidinput->input->evbit[i];
1525 for (i = 0; i < BITS_TO_LONGS(KEY_CNT); i++)
1526 r |= hidinput->input->keybit[i];
1528 for (i = 0; i < BITS_TO_LONGS(REL_CNT); i++)
1529 r |= hidinput->input->relbit[i];
1531 for (i = 0; i < BITS_TO_LONGS(ABS_CNT); i++)
1532 r |= hidinput->input->absbit[i];
1534 for (i = 0; i < BITS_TO_LONGS(MSC_CNT); i++)
1535 r |= hidinput->input->mscbit[i];
1537 for (i = 0; i < BITS_TO_LONGS(LED_CNT); i++)
1538 r |= hidinput->input->ledbit[i];
1540 for (i = 0; i < BITS_TO_LONGS(SND_CNT); i++)
1541 r |= hidinput->input->sndbit[i];
1543 for (i = 0; i < BITS_TO_LONGS(FF_CNT); i++)
1544 r |= hidinput->input->ffbit[i];
1546 for (i = 0; i < BITS_TO_LONGS(SW_CNT); i++)
1547 r |= hidinput->input->swbit[i];
1549 return !!r;
1552 static void hidinput_cleanup_hidinput(struct hid_device *hid,
1553 struct hid_input *hidinput)
1555 struct hid_report *report;
1556 int i, k;
1558 list_del(&hidinput->list);
1559 input_free_device(hidinput->input);
1561 for (k = HID_INPUT_REPORT; k <= HID_OUTPUT_REPORT; k++) {
1562 if (k == HID_OUTPUT_REPORT &&
1563 hid->quirks & HID_QUIRK_SKIP_OUTPUT_REPORTS)
1564 continue;
1566 list_for_each_entry(report, &hid->report_enum[k].report_list,
1567 list) {
1569 for (i = 0; i < report->maxfield; i++)
1570 if (report->field[i]->hidinput == hidinput)
1571 report->field[i]->hidinput = NULL;
1575 kfree(hidinput);
1578 static struct hid_input *hidinput_match(struct hid_report *report)
1580 struct hid_device *hid = report->device;
1581 struct hid_input *hidinput;
1583 list_for_each_entry(hidinput, &hid->inputs, list) {
1584 if (hidinput->report &&
1585 hidinput->report->id == report->id)
1586 return hidinput;
1589 return NULL;
1592 static inline void hidinput_configure_usages(struct hid_input *hidinput,
1593 struct hid_report *report)
1595 int i, j;
1597 for (i = 0; i < report->maxfield; i++)
1598 for (j = 0; j < report->field[i]->maxusage; j++)
1599 hidinput_configure_usage(hidinput, report->field[i],
1600 report->field[i]->usage + j);
1604 * Register the input device; print a message.
1605 * Configure the input layer interface
1606 * Read all reports and initialize the absolute field values.
1609 int hidinput_connect(struct hid_device *hid, unsigned int force)
1611 struct hid_driver *drv = hid->driver;
1612 struct hid_report *report;
1613 struct hid_input *next, *hidinput = NULL;
1614 int i, k;
1616 INIT_LIST_HEAD(&hid->inputs);
1617 INIT_WORK(&hid->led_work, hidinput_led_worker);
1619 if (!force) {
1620 for (i = 0; i < hid->maxcollection; i++) {
1621 struct hid_collection *col = &hid->collection[i];
1622 if (col->type == HID_COLLECTION_APPLICATION ||
1623 col->type == HID_COLLECTION_PHYSICAL)
1624 if (IS_INPUT_APPLICATION(col->usage))
1625 break;
1628 if (i == hid->maxcollection)
1629 return -1;
1632 report_features(hid);
1634 for (k = HID_INPUT_REPORT; k <= HID_OUTPUT_REPORT; k++) {
1635 if (k == HID_OUTPUT_REPORT &&
1636 hid->quirks & HID_QUIRK_SKIP_OUTPUT_REPORTS)
1637 continue;
1639 list_for_each_entry(report, &hid->report_enum[k].report_list, list) {
1641 if (!report->maxfield)
1642 continue;
1645 * Find the previous hidinput report attached
1646 * to this report id.
1648 if (hid->quirks & HID_QUIRK_MULTI_INPUT)
1649 hidinput = hidinput_match(report);
1651 if (!hidinput) {
1652 hidinput = hidinput_allocate(hid);
1653 if (!hidinput)
1654 goto out_unwind;
1657 hidinput_configure_usages(hidinput, report);
1659 if (hid->quirks & HID_QUIRK_MULTI_INPUT)
1660 hidinput->report = report;
1664 list_for_each_entry_safe(hidinput, next, &hid->inputs, list) {
1665 if ((hid->quirks & HID_QUIRK_NO_EMPTY_INPUT) &&
1666 !hidinput_has_been_populated(hidinput)) {
1667 /* no need to register an input device not populated */
1668 hidinput_cleanup_hidinput(hid, hidinput);
1669 continue;
1672 if (drv->input_configured &&
1673 drv->input_configured(hid, hidinput))
1674 goto out_unwind;
1675 if (input_register_device(hidinput->input))
1676 goto out_unwind;
1677 hidinput->registered = true;
1680 if (list_empty(&hid->inputs)) {
1681 hid_err(hid, "No inputs registered, leaving\n");
1682 goto out_unwind;
1685 return 0;
1687 out_unwind:
1688 /* unwind the ones we already registered */
1689 hidinput_disconnect(hid);
1691 return -1;
1693 EXPORT_SYMBOL_GPL(hidinput_connect);
1695 void hidinput_disconnect(struct hid_device *hid)
1697 struct hid_input *hidinput, *next;
1699 hidinput_cleanup_battery(hid);
1701 list_for_each_entry_safe(hidinput, next, &hid->inputs, list) {
1702 list_del(&hidinput->list);
1703 if (hidinput->registered)
1704 input_unregister_device(hidinput->input);
1705 else
1706 input_free_device(hidinput->input);
1707 kfree(hidinput);
1710 /* led_work is spawned by input_dev callbacks, but doesn't access the
1711 * parent input_dev at all. Once all input devices are removed, we
1712 * know that led_work will never get restarted, so we can cancel it
1713 * synchronously and are safe. */
1714 cancel_work_sync(&hid->led_work);
1716 EXPORT_SYMBOL_GPL(hidinput_disconnect);