lib/string_helpers.c:string_get_size(): use 32 bit arithmetic when possible
[linux-2.6/btrfs-unstable.git] / drivers / hid / hid-core.c
blobdb4fb6e1cc5b3ca83d14d3f1e0e52e66fe75979a
1 /*
2 * HID support for Linux
4 * Copyright (c) 1999 Andreas Gal
5 * Copyright (c) 2000-2005 Vojtech Pavlik <vojtech@suse.cz>
6 * Copyright (c) 2005 Michael Haboustak <mike-@cinci.rr.com> for Concept2, Inc
7 * Copyright (c) 2006-2012 Jiri Kosina
8 */
11 * This program is free software; you can redistribute it and/or modify it
12 * under the terms of the GNU General Public License as published by the Free
13 * Software Foundation; either version 2 of the License, or (at your option)
14 * any later version.
17 #define pr_fmt(fmt) KBUILD_MODNAME ": " fmt
19 #include <linux/module.h>
20 #include <linux/slab.h>
21 #include <linux/init.h>
22 #include <linux/kernel.h>
23 #include <linux/list.h>
24 #include <linux/mm.h>
25 #include <linux/spinlock.h>
26 #include <asm/unaligned.h>
27 #include <asm/byteorder.h>
28 #include <linux/input.h>
29 #include <linux/wait.h>
30 #include <linux/vmalloc.h>
31 #include <linux/sched.h>
32 #include <linux/semaphore.h>
34 #include <linux/hid.h>
35 #include <linux/hiddev.h>
36 #include <linux/hid-debug.h>
37 #include <linux/hidraw.h>
39 #include "hid-ids.h"
42 * Version Information
45 #define DRIVER_DESC "HID core driver"
46 #define DRIVER_LICENSE "GPL"
48 int hid_debug = 0;
49 module_param_named(debug, hid_debug, int, 0600);
50 MODULE_PARM_DESC(debug, "toggle HID debugging messages");
51 EXPORT_SYMBOL_GPL(hid_debug);
53 static int hid_ignore_special_drivers = 0;
54 module_param_named(ignore_special_drivers, hid_ignore_special_drivers, int, 0600);
55 MODULE_PARM_DESC(ignore_special_drivers, "Ignore any special drivers and handle all devices by generic driver");
58 * Register a new report for a device.
61 struct hid_report *hid_register_report(struct hid_device *device, unsigned type, unsigned id)
63 struct hid_report_enum *report_enum = device->report_enum + type;
64 struct hid_report *report;
66 if (id >= HID_MAX_IDS)
67 return NULL;
68 if (report_enum->report_id_hash[id])
69 return report_enum->report_id_hash[id];
71 report = kzalloc(sizeof(struct hid_report), GFP_KERNEL);
72 if (!report)
73 return NULL;
75 if (id != 0)
76 report_enum->numbered = 1;
78 report->id = id;
79 report->type = type;
80 report->size = 0;
81 report->device = device;
82 report_enum->report_id_hash[id] = report;
84 list_add_tail(&report->list, &report_enum->report_list);
86 return report;
88 EXPORT_SYMBOL_GPL(hid_register_report);
91 * Register a new field for this report.
94 static struct hid_field *hid_register_field(struct hid_report *report, unsigned usages, unsigned values)
96 struct hid_field *field;
98 if (report->maxfield == HID_MAX_FIELDS) {
99 hid_err(report->device, "too many fields in report\n");
100 return NULL;
103 field = kzalloc((sizeof(struct hid_field) +
104 usages * sizeof(struct hid_usage) +
105 values * sizeof(unsigned)), GFP_KERNEL);
106 if (!field)
107 return NULL;
109 field->index = report->maxfield++;
110 report->field[field->index] = field;
111 field->usage = (struct hid_usage *)(field + 1);
112 field->value = (s32 *)(field->usage + usages);
113 field->report = report;
115 return field;
119 * Open a collection. The type/usage is pushed on the stack.
122 static int open_collection(struct hid_parser *parser, unsigned type)
124 struct hid_collection *collection;
125 unsigned usage;
127 usage = parser->local.usage[0];
129 if (parser->collection_stack_ptr == HID_COLLECTION_STACK_SIZE) {
130 hid_err(parser->device, "collection stack overflow\n");
131 return -EINVAL;
134 if (parser->device->maxcollection == parser->device->collection_size) {
135 collection = kmalloc(sizeof(struct hid_collection) *
136 parser->device->collection_size * 2, GFP_KERNEL);
137 if (collection == NULL) {
138 hid_err(parser->device, "failed to reallocate collection array\n");
139 return -ENOMEM;
141 memcpy(collection, parser->device->collection,
142 sizeof(struct hid_collection) *
143 parser->device->collection_size);
144 memset(collection + parser->device->collection_size, 0,
145 sizeof(struct hid_collection) *
146 parser->device->collection_size);
147 kfree(parser->device->collection);
148 parser->device->collection = collection;
149 parser->device->collection_size *= 2;
152 parser->collection_stack[parser->collection_stack_ptr++] =
153 parser->device->maxcollection;
155 collection = parser->device->collection +
156 parser->device->maxcollection++;
157 collection->type = type;
158 collection->usage = usage;
159 collection->level = parser->collection_stack_ptr - 1;
161 if (type == HID_COLLECTION_APPLICATION)
162 parser->device->maxapplication++;
164 return 0;
168 * Close a collection.
171 static int close_collection(struct hid_parser *parser)
173 if (!parser->collection_stack_ptr) {
174 hid_err(parser->device, "collection stack underflow\n");
175 return -EINVAL;
177 parser->collection_stack_ptr--;
178 return 0;
182 * Climb up the stack, search for the specified collection type
183 * and return the usage.
186 static unsigned hid_lookup_collection(struct hid_parser *parser, unsigned type)
188 struct hid_collection *collection = parser->device->collection;
189 int n;
191 for (n = parser->collection_stack_ptr - 1; n >= 0; n--) {
192 unsigned index = parser->collection_stack[n];
193 if (collection[index].type == type)
194 return collection[index].usage;
196 return 0; /* we know nothing about this usage type */
200 * Add a usage to the temporary parser table.
203 static int hid_add_usage(struct hid_parser *parser, unsigned usage)
205 if (parser->local.usage_index >= HID_MAX_USAGES) {
206 hid_err(parser->device, "usage index exceeded\n");
207 return -1;
209 parser->local.usage[parser->local.usage_index] = usage;
210 parser->local.collection_index[parser->local.usage_index] =
211 parser->collection_stack_ptr ?
212 parser->collection_stack[parser->collection_stack_ptr - 1] : 0;
213 parser->local.usage_index++;
214 return 0;
218 * Register a new field for this report.
221 static int hid_add_field(struct hid_parser *parser, unsigned report_type, unsigned flags)
223 struct hid_report *report;
224 struct hid_field *field;
225 unsigned usages;
226 unsigned offset;
227 unsigned i;
229 report = hid_register_report(parser->device, report_type, parser->global.report_id);
230 if (!report) {
231 hid_err(parser->device, "hid_register_report failed\n");
232 return -1;
235 /* Handle both signed and unsigned cases properly */
236 if ((parser->global.logical_minimum < 0 &&
237 parser->global.logical_maximum <
238 parser->global.logical_minimum) ||
239 (parser->global.logical_minimum >= 0 &&
240 (__u32)parser->global.logical_maximum <
241 (__u32)parser->global.logical_minimum)) {
242 dbg_hid("logical range invalid 0x%x 0x%x\n",
243 parser->global.logical_minimum,
244 parser->global.logical_maximum);
245 return -1;
248 offset = report->size;
249 report->size += parser->global.report_size * parser->global.report_count;
251 if (!parser->local.usage_index) /* Ignore padding fields */
252 return 0;
254 usages = max_t(unsigned, parser->local.usage_index,
255 parser->global.report_count);
257 field = hid_register_field(report, usages, parser->global.report_count);
258 if (!field)
259 return 0;
261 field->physical = hid_lookup_collection(parser, HID_COLLECTION_PHYSICAL);
262 field->logical = hid_lookup_collection(parser, HID_COLLECTION_LOGICAL);
263 field->application = hid_lookup_collection(parser, HID_COLLECTION_APPLICATION);
265 for (i = 0; i < usages; i++) {
266 unsigned j = i;
267 /* Duplicate the last usage we parsed if we have excess values */
268 if (i >= parser->local.usage_index)
269 j = parser->local.usage_index - 1;
270 field->usage[i].hid = parser->local.usage[j];
271 field->usage[i].collection_index =
272 parser->local.collection_index[j];
273 field->usage[i].usage_index = i;
276 field->maxusage = usages;
277 field->flags = flags;
278 field->report_offset = offset;
279 field->report_type = report_type;
280 field->report_size = parser->global.report_size;
281 field->report_count = parser->global.report_count;
282 field->logical_minimum = parser->global.logical_minimum;
283 field->logical_maximum = parser->global.logical_maximum;
284 field->physical_minimum = parser->global.physical_minimum;
285 field->physical_maximum = parser->global.physical_maximum;
286 field->unit_exponent = parser->global.unit_exponent;
287 field->unit = parser->global.unit;
289 return 0;
293 * Read data value from item.
296 static u32 item_udata(struct hid_item *item)
298 switch (item->size) {
299 case 1: return item->data.u8;
300 case 2: return item->data.u16;
301 case 4: return item->data.u32;
303 return 0;
306 static s32 item_sdata(struct hid_item *item)
308 switch (item->size) {
309 case 1: return item->data.s8;
310 case 2: return item->data.s16;
311 case 4: return item->data.s32;
313 return 0;
317 * Process a global item.
320 static int hid_parser_global(struct hid_parser *parser, struct hid_item *item)
322 __s32 raw_value;
323 switch (item->tag) {
324 case HID_GLOBAL_ITEM_TAG_PUSH:
326 if (parser->global_stack_ptr == HID_GLOBAL_STACK_SIZE) {
327 hid_err(parser->device, "global environment stack overflow\n");
328 return -1;
331 memcpy(parser->global_stack + parser->global_stack_ptr++,
332 &parser->global, sizeof(struct hid_global));
333 return 0;
335 case HID_GLOBAL_ITEM_TAG_POP:
337 if (!parser->global_stack_ptr) {
338 hid_err(parser->device, "global environment stack underflow\n");
339 return -1;
342 memcpy(&parser->global, parser->global_stack +
343 --parser->global_stack_ptr, sizeof(struct hid_global));
344 return 0;
346 case HID_GLOBAL_ITEM_TAG_USAGE_PAGE:
347 parser->global.usage_page = item_udata(item);
348 return 0;
350 case HID_GLOBAL_ITEM_TAG_LOGICAL_MINIMUM:
351 parser->global.logical_minimum = item_sdata(item);
352 return 0;
354 case HID_GLOBAL_ITEM_TAG_LOGICAL_MAXIMUM:
355 if (parser->global.logical_minimum < 0)
356 parser->global.logical_maximum = item_sdata(item);
357 else
358 parser->global.logical_maximum = item_udata(item);
359 return 0;
361 case HID_GLOBAL_ITEM_TAG_PHYSICAL_MINIMUM:
362 parser->global.physical_minimum = item_sdata(item);
363 return 0;
365 case HID_GLOBAL_ITEM_TAG_PHYSICAL_MAXIMUM:
366 if (parser->global.physical_minimum < 0)
367 parser->global.physical_maximum = item_sdata(item);
368 else
369 parser->global.physical_maximum = item_udata(item);
370 return 0;
372 case HID_GLOBAL_ITEM_TAG_UNIT_EXPONENT:
373 /* Many devices provide unit exponent as a two's complement
374 * nibble due to the common misunderstanding of HID
375 * specification 1.11, 6.2.2.7 Global Items. Attempt to handle
376 * both this and the standard encoding. */
377 raw_value = item_sdata(item);
378 if (!(raw_value & 0xfffffff0))
379 parser->global.unit_exponent = hid_snto32(raw_value, 4);
380 else
381 parser->global.unit_exponent = raw_value;
382 return 0;
384 case HID_GLOBAL_ITEM_TAG_UNIT:
385 parser->global.unit = item_udata(item);
386 return 0;
388 case HID_GLOBAL_ITEM_TAG_REPORT_SIZE:
389 parser->global.report_size = item_udata(item);
390 if (parser->global.report_size > 128) {
391 hid_err(parser->device, "invalid report_size %d\n",
392 parser->global.report_size);
393 return -1;
395 return 0;
397 case HID_GLOBAL_ITEM_TAG_REPORT_COUNT:
398 parser->global.report_count = item_udata(item);
399 if (parser->global.report_count > HID_MAX_USAGES) {
400 hid_err(parser->device, "invalid report_count %d\n",
401 parser->global.report_count);
402 return -1;
404 return 0;
406 case HID_GLOBAL_ITEM_TAG_REPORT_ID:
407 parser->global.report_id = item_udata(item);
408 if (parser->global.report_id == 0 ||
409 parser->global.report_id >= HID_MAX_IDS) {
410 hid_err(parser->device, "report_id %u is invalid\n",
411 parser->global.report_id);
412 return -1;
414 return 0;
416 default:
417 hid_err(parser->device, "unknown global tag 0x%x\n", item->tag);
418 return -1;
423 * Process a local item.
426 static int hid_parser_local(struct hid_parser *parser, struct hid_item *item)
428 __u32 data;
429 unsigned n;
431 data = item_udata(item);
433 switch (item->tag) {
434 case HID_LOCAL_ITEM_TAG_DELIMITER:
436 if (data) {
438 * We treat items before the first delimiter
439 * as global to all usage sets (branch 0).
440 * In the moment we process only these global
441 * items and the first delimiter set.
443 if (parser->local.delimiter_depth != 0) {
444 hid_err(parser->device, "nested delimiters\n");
445 return -1;
447 parser->local.delimiter_depth++;
448 parser->local.delimiter_branch++;
449 } else {
450 if (parser->local.delimiter_depth < 1) {
451 hid_err(parser->device, "bogus close delimiter\n");
452 return -1;
454 parser->local.delimiter_depth--;
456 return 0;
458 case HID_LOCAL_ITEM_TAG_USAGE:
460 if (parser->local.delimiter_branch > 1) {
461 dbg_hid("alternative usage ignored\n");
462 return 0;
465 if (item->size <= 2)
466 data = (parser->global.usage_page << 16) + data;
468 return hid_add_usage(parser, data);
470 case HID_LOCAL_ITEM_TAG_USAGE_MINIMUM:
472 if (parser->local.delimiter_branch > 1) {
473 dbg_hid("alternative usage ignored\n");
474 return 0;
477 if (item->size <= 2)
478 data = (parser->global.usage_page << 16) + data;
480 parser->local.usage_minimum = data;
481 return 0;
483 case HID_LOCAL_ITEM_TAG_USAGE_MAXIMUM:
485 if (parser->local.delimiter_branch > 1) {
486 dbg_hid("alternative usage ignored\n");
487 return 0;
490 if (item->size <= 2)
491 data = (parser->global.usage_page << 16) + data;
493 for (n = parser->local.usage_minimum; n <= data; n++)
494 if (hid_add_usage(parser, n)) {
495 dbg_hid("hid_add_usage failed\n");
496 return -1;
498 return 0;
500 default:
502 dbg_hid("unknown local item tag 0x%x\n", item->tag);
503 return 0;
505 return 0;
509 * Process a main item.
512 static int hid_parser_main(struct hid_parser *parser, struct hid_item *item)
514 __u32 data;
515 int ret;
517 data = item_udata(item);
519 switch (item->tag) {
520 case HID_MAIN_ITEM_TAG_BEGIN_COLLECTION:
521 ret = open_collection(parser, data & 0xff);
522 break;
523 case HID_MAIN_ITEM_TAG_END_COLLECTION:
524 ret = close_collection(parser);
525 break;
526 case HID_MAIN_ITEM_TAG_INPUT:
527 ret = hid_add_field(parser, HID_INPUT_REPORT, data);
528 break;
529 case HID_MAIN_ITEM_TAG_OUTPUT:
530 ret = hid_add_field(parser, HID_OUTPUT_REPORT, data);
531 break;
532 case HID_MAIN_ITEM_TAG_FEATURE:
533 ret = hid_add_field(parser, HID_FEATURE_REPORT, data);
534 break;
535 default:
536 hid_err(parser->device, "unknown main item tag 0x%x\n", item->tag);
537 ret = 0;
540 memset(&parser->local, 0, sizeof(parser->local)); /* Reset the local parser environment */
542 return ret;
546 * Process a reserved item.
549 static int hid_parser_reserved(struct hid_parser *parser, struct hid_item *item)
551 dbg_hid("reserved item type, tag 0x%x\n", item->tag);
552 return 0;
556 * Free a report and all registered fields. The field->usage and
557 * field->value table's are allocated behind the field, so we need
558 * only to free(field) itself.
561 static void hid_free_report(struct hid_report *report)
563 unsigned n;
565 for (n = 0; n < report->maxfield; n++)
566 kfree(report->field[n]);
567 kfree(report);
571 * Close report. This function returns the device
572 * state to the point prior to hid_open_report().
574 static void hid_close_report(struct hid_device *device)
576 unsigned i, j;
578 for (i = 0; i < HID_REPORT_TYPES; i++) {
579 struct hid_report_enum *report_enum = device->report_enum + i;
581 for (j = 0; j < HID_MAX_IDS; j++) {
582 struct hid_report *report = report_enum->report_id_hash[j];
583 if (report)
584 hid_free_report(report);
586 memset(report_enum, 0, sizeof(*report_enum));
587 INIT_LIST_HEAD(&report_enum->report_list);
590 kfree(device->rdesc);
591 device->rdesc = NULL;
592 device->rsize = 0;
594 kfree(device->collection);
595 device->collection = NULL;
596 device->collection_size = 0;
597 device->maxcollection = 0;
598 device->maxapplication = 0;
600 device->status &= ~HID_STAT_PARSED;
604 * Free a device structure, all reports, and all fields.
607 static void hid_device_release(struct device *dev)
609 struct hid_device *hid = container_of(dev, struct hid_device, dev);
611 hid_close_report(hid);
612 kfree(hid->dev_rdesc);
613 kfree(hid);
617 * Fetch a report description item from the data stream. We support long
618 * items, though they are not used yet.
621 static u8 *fetch_item(__u8 *start, __u8 *end, struct hid_item *item)
623 u8 b;
625 if ((end - start) <= 0)
626 return NULL;
628 b = *start++;
630 item->type = (b >> 2) & 3;
631 item->tag = (b >> 4) & 15;
633 if (item->tag == HID_ITEM_TAG_LONG) {
635 item->format = HID_ITEM_FORMAT_LONG;
637 if ((end - start) < 2)
638 return NULL;
640 item->size = *start++;
641 item->tag = *start++;
643 if ((end - start) < item->size)
644 return NULL;
646 item->data.longdata = start;
647 start += item->size;
648 return start;
651 item->format = HID_ITEM_FORMAT_SHORT;
652 item->size = b & 3;
654 switch (item->size) {
655 case 0:
656 return start;
658 case 1:
659 if ((end - start) < 1)
660 return NULL;
661 item->data.u8 = *start++;
662 return start;
664 case 2:
665 if ((end - start) < 2)
666 return NULL;
667 item->data.u16 = get_unaligned_le16(start);
668 start = (__u8 *)((__le16 *)start + 1);
669 return start;
671 case 3:
672 item->size++;
673 if ((end - start) < 4)
674 return NULL;
675 item->data.u32 = get_unaligned_le32(start);
676 start = (__u8 *)((__le32 *)start + 1);
677 return start;
680 return NULL;
683 static void hid_scan_input_usage(struct hid_parser *parser, u32 usage)
685 struct hid_device *hid = parser->device;
687 if (usage == HID_DG_CONTACTID)
688 hid->group = HID_GROUP_MULTITOUCH;
691 static void hid_scan_feature_usage(struct hid_parser *parser, u32 usage)
693 if (usage == 0xff0000c5 && parser->global.report_count == 256 &&
694 parser->global.report_size == 8)
695 parser->scan_flags |= HID_SCAN_FLAG_MT_WIN_8;
698 static void hid_scan_collection(struct hid_parser *parser, unsigned type)
700 struct hid_device *hid = parser->device;
701 int i;
703 if (((parser->global.usage_page << 16) == HID_UP_SENSOR) &&
704 type == HID_COLLECTION_PHYSICAL)
705 hid->group = HID_GROUP_SENSOR_HUB;
707 if (hid->vendor == USB_VENDOR_ID_MICROSOFT &&
708 (hid->product == USB_DEVICE_ID_MS_TYPE_COVER_3 ||
709 hid->product == USB_DEVICE_ID_MS_TYPE_COVER_3_JP) &&
710 hid->group == HID_GROUP_MULTITOUCH)
711 hid->group = HID_GROUP_GENERIC;
713 if ((parser->global.usage_page << 16) == HID_UP_GENDESK)
714 for (i = 0; i < parser->local.usage_index; i++)
715 if (parser->local.usage[i] == HID_GD_POINTER)
716 parser->scan_flags |= HID_SCAN_FLAG_GD_POINTER;
718 if ((parser->global.usage_page << 16) >= HID_UP_MSVENDOR)
719 parser->scan_flags |= HID_SCAN_FLAG_VENDOR_SPECIFIC;
722 static int hid_scan_main(struct hid_parser *parser, struct hid_item *item)
724 __u32 data;
725 int i;
727 data = item_udata(item);
729 switch (item->tag) {
730 case HID_MAIN_ITEM_TAG_BEGIN_COLLECTION:
731 hid_scan_collection(parser, data & 0xff);
732 break;
733 case HID_MAIN_ITEM_TAG_END_COLLECTION:
734 break;
735 case HID_MAIN_ITEM_TAG_INPUT:
736 /* ignore constant inputs, they will be ignored by hid-input */
737 if (data & HID_MAIN_ITEM_CONSTANT)
738 break;
739 for (i = 0; i < parser->local.usage_index; i++)
740 hid_scan_input_usage(parser, parser->local.usage[i]);
741 break;
742 case HID_MAIN_ITEM_TAG_OUTPUT:
743 break;
744 case HID_MAIN_ITEM_TAG_FEATURE:
745 for (i = 0; i < parser->local.usage_index; i++)
746 hid_scan_feature_usage(parser, parser->local.usage[i]);
747 break;
750 /* Reset the local parser environment */
751 memset(&parser->local, 0, sizeof(parser->local));
753 return 0;
757 * Scan a report descriptor before the device is added to the bus.
758 * Sets device groups and other properties that determine what driver
759 * to load.
761 static int hid_scan_report(struct hid_device *hid)
763 struct hid_parser *parser;
764 struct hid_item item;
765 __u8 *start = hid->dev_rdesc;
766 __u8 *end = start + hid->dev_rsize;
767 static int (*dispatch_type[])(struct hid_parser *parser,
768 struct hid_item *item) = {
769 hid_scan_main,
770 hid_parser_global,
771 hid_parser_local,
772 hid_parser_reserved
775 parser = vzalloc(sizeof(struct hid_parser));
776 if (!parser)
777 return -ENOMEM;
779 parser->device = hid;
780 hid->group = HID_GROUP_GENERIC;
783 * The parsing is simpler than the one in hid_open_report() as we should
784 * be robust against hid errors. Those errors will be raised by
785 * hid_open_report() anyway.
787 while ((start = fetch_item(start, end, &item)) != NULL)
788 dispatch_type[item.type](parser, &item);
791 * Handle special flags set during scanning.
793 if ((parser->scan_flags & HID_SCAN_FLAG_MT_WIN_8) &&
794 (hid->group == HID_GROUP_MULTITOUCH))
795 hid->group = HID_GROUP_MULTITOUCH_WIN_8;
798 * Vendor specific handlings
800 switch (hid->vendor) {
801 case USB_VENDOR_ID_WACOM:
802 hid->group = HID_GROUP_WACOM;
803 break;
804 case USB_VENDOR_ID_SYNAPTICS:
805 if (hid->group == HID_GROUP_GENERIC)
806 if ((parser->scan_flags & HID_SCAN_FLAG_VENDOR_SPECIFIC)
807 && (parser->scan_flags & HID_SCAN_FLAG_GD_POINTER))
809 * hid-rmi should take care of them,
810 * not hid-generic
812 hid->group = HID_GROUP_RMI;
813 break;
816 vfree(parser);
817 return 0;
821 * hid_parse_report - parse device report
823 * @device: hid device
824 * @start: report start
825 * @size: report size
827 * Allocate the device report as read by the bus driver. This function should
828 * only be called from parse() in ll drivers.
830 int hid_parse_report(struct hid_device *hid, __u8 *start, unsigned size)
832 hid->dev_rdesc = kmemdup(start, size, GFP_KERNEL);
833 if (!hid->dev_rdesc)
834 return -ENOMEM;
835 hid->dev_rsize = size;
836 return 0;
838 EXPORT_SYMBOL_GPL(hid_parse_report);
840 static const char * const hid_report_names[] = {
841 "HID_INPUT_REPORT",
842 "HID_OUTPUT_REPORT",
843 "HID_FEATURE_REPORT",
846 * hid_validate_values - validate existing device report's value indexes
848 * @device: hid device
849 * @type: which report type to examine
850 * @id: which report ID to examine (0 for first)
851 * @field_index: which report field to examine
852 * @report_counts: expected number of values
854 * Validate the number of values in a given field of a given report, after
855 * parsing.
857 struct hid_report *hid_validate_values(struct hid_device *hid,
858 unsigned int type, unsigned int id,
859 unsigned int field_index,
860 unsigned int report_counts)
862 struct hid_report *report;
864 if (type > HID_FEATURE_REPORT) {
865 hid_err(hid, "invalid HID report type %u\n", type);
866 return NULL;
869 if (id >= HID_MAX_IDS) {
870 hid_err(hid, "invalid HID report id %u\n", id);
871 return NULL;
875 * Explicitly not using hid_get_report() here since it depends on
876 * ->numbered being checked, which may not always be the case when
877 * drivers go to access report values.
879 if (id == 0) {
881 * Validating on id 0 means we should examine the first
882 * report in the list.
884 report = list_entry(
885 hid->report_enum[type].report_list.next,
886 struct hid_report, list);
887 } else {
888 report = hid->report_enum[type].report_id_hash[id];
890 if (!report) {
891 hid_err(hid, "missing %s %u\n", hid_report_names[type], id);
892 return NULL;
894 if (report->maxfield <= field_index) {
895 hid_err(hid, "not enough fields in %s %u\n",
896 hid_report_names[type], id);
897 return NULL;
899 if (report->field[field_index]->report_count < report_counts) {
900 hid_err(hid, "not enough values in %s %u field %u\n",
901 hid_report_names[type], id, field_index);
902 return NULL;
904 return report;
906 EXPORT_SYMBOL_GPL(hid_validate_values);
909 * hid_open_report - open a driver-specific device report
911 * @device: hid device
913 * Parse a report description into a hid_device structure. Reports are
914 * enumerated, fields are attached to these reports.
915 * 0 returned on success, otherwise nonzero error value.
917 * This function (or the equivalent hid_parse() macro) should only be
918 * called from probe() in drivers, before starting the device.
920 int hid_open_report(struct hid_device *device)
922 struct hid_parser *parser;
923 struct hid_item item;
924 unsigned int size;
925 __u8 *start;
926 __u8 *buf;
927 __u8 *end;
928 int ret;
929 static int (*dispatch_type[])(struct hid_parser *parser,
930 struct hid_item *item) = {
931 hid_parser_main,
932 hid_parser_global,
933 hid_parser_local,
934 hid_parser_reserved
937 if (WARN_ON(device->status & HID_STAT_PARSED))
938 return -EBUSY;
940 start = device->dev_rdesc;
941 if (WARN_ON(!start))
942 return -ENODEV;
943 size = device->dev_rsize;
945 buf = kmemdup(start, size, GFP_KERNEL);
946 if (buf == NULL)
947 return -ENOMEM;
949 if (device->driver->report_fixup)
950 start = device->driver->report_fixup(device, buf, &size);
951 else
952 start = buf;
954 start = kmemdup(start, size, GFP_KERNEL);
955 kfree(buf);
956 if (start == NULL)
957 return -ENOMEM;
959 device->rdesc = start;
960 device->rsize = size;
962 parser = vzalloc(sizeof(struct hid_parser));
963 if (!parser) {
964 ret = -ENOMEM;
965 goto err;
968 parser->device = device;
970 end = start + size;
972 device->collection = kcalloc(HID_DEFAULT_NUM_COLLECTIONS,
973 sizeof(struct hid_collection), GFP_KERNEL);
974 if (!device->collection) {
975 ret = -ENOMEM;
976 goto err;
978 device->collection_size = HID_DEFAULT_NUM_COLLECTIONS;
980 ret = -EINVAL;
981 while ((start = fetch_item(start, end, &item)) != NULL) {
983 if (item.format != HID_ITEM_FORMAT_SHORT) {
984 hid_err(device, "unexpected long global item\n");
985 goto err;
988 if (dispatch_type[item.type](parser, &item)) {
989 hid_err(device, "item %u %u %u %u parsing failed\n",
990 item.format, (unsigned)item.size,
991 (unsigned)item.type, (unsigned)item.tag);
992 goto err;
995 if (start == end) {
996 if (parser->collection_stack_ptr) {
997 hid_err(device, "unbalanced collection at end of report description\n");
998 goto err;
1000 if (parser->local.delimiter_depth) {
1001 hid_err(device, "unbalanced delimiter at end of report description\n");
1002 goto err;
1004 vfree(parser);
1005 device->status |= HID_STAT_PARSED;
1006 return 0;
1010 hid_err(device, "item fetching failed at offset %d\n", (int)(end - start));
1011 err:
1012 vfree(parser);
1013 hid_close_report(device);
1014 return ret;
1016 EXPORT_SYMBOL_GPL(hid_open_report);
1019 * Convert a signed n-bit integer to signed 32-bit integer. Common
1020 * cases are done through the compiler, the screwed things has to be
1021 * done by hand.
1024 static s32 snto32(__u32 value, unsigned n)
1026 switch (n) {
1027 case 8: return ((__s8)value);
1028 case 16: return ((__s16)value);
1029 case 32: return ((__s32)value);
1031 return value & (1 << (n - 1)) ? value | (-1 << n) : value;
1034 s32 hid_snto32(__u32 value, unsigned n)
1036 return snto32(value, n);
1038 EXPORT_SYMBOL_GPL(hid_snto32);
1041 * Convert a signed 32-bit integer to a signed n-bit integer.
1044 static u32 s32ton(__s32 value, unsigned n)
1046 s32 a = value >> (n - 1);
1047 if (a && a != -1)
1048 return value < 0 ? 1 << (n - 1) : (1 << (n - 1)) - 1;
1049 return value & ((1 << n) - 1);
1053 * Extract/implement a data field from/to a little endian report (bit array).
1055 * Code sort-of follows HID spec:
1056 * http://www.usb.org/developers/devclass_docs/HID1_11.pdf
1058 * While the USB HID spec allows unlimited length bit fields in "report
1059 * descriptors", most devices never use more than 16 bits.
1060 * One model of UPS is claimed to report "LINEV" as a 32-bit field.
1061 * Search linux-kernel and linux-usb-devel archives for "hid-core extract".
1064 static __u32 extract(const struct hid_device *hid, __u8 *report,
1065 unsigned offset, unsigned n)
1067 u64 x;
1069 if (n > 32)
1070 hid_warn(hid, "extract() called with n (%d) > 32! (%s)\n",
1071 n, current->comm);
1073 report += offset >> 3; /* adjust byte index */
1074 offset &= 7; /* now only need bit offset into one byte */
1075 x = get_unaligned_le64(report);
1076 x = (x >> offset) & ((1ULL << n) - 1); /* extract bit field */
1077 return (u32) x;
1081 * "implement" : set bits in a little endian bit stream.
1082 * Same concepts as "extract" (see comments above).
1083 * The data mangled in the bit stream remains in little endian
1084 * order the whole time. It make more sense to talk about
1085 * endianness of register values by considering a register
1086 * a "cached" copy of the little endiad bit stream.
1088 static void implement(const struct hid_device *hid, __u8 *report,
1089 unsigned offset, unsigned n, __u32 value)
1091 u64 x;
1092 u64 m = (1ULL << n) - 1;
1094 if (n > 32)
1095 hid_warn(hid, "%s() called with n (%d) > 32! (%s)\n",
1096 __func__, n, current->comm);
1098 if (value > m)
1099 hid_warn(hid, "%s() called with too large value %d! (%s)\n",
1100 __func__, value, current->comm);
1101 WARN_ON(value > m);
1102 value &= m;
1104 report += offset >> 3;
1105 offset &= 7;
1107 x = get_unaligned_le64(report);
1108 x &= ~(m << offset);
1109 x |= ((u64)value) << offset;
1110 put_unaligned_le64(x, report);
1114 * Search an array for a value.
1117 static int search(__s32 *array, __s32 value, unsigned n)
1119 while (n--) {
1120 if (*array++ == value)
1121 return 0;
1123 return -1;
1127 * hid_match_report - check if driver's raw_event should be called
1129 * @hid: hid device
1130 * @report_type: type to match against
1132 * compare hid->driver->report_table->report_type to report->type
1134 static int hid_match_report(struct hid_device *hid, struct hid_report *report)
1136 const struct hid_report_id *id = hid->driver->report_table;
1138 if (!id) /* NULL means all */
1139 return 1;
1141 for (; id->report_type != HID_TERMINATOR; id++)
1142 if (id->report_type == HID_ANY_ID ||
1143 id->report_type == report->type)
1144 return 1;
1145 return 0;
1149 * hid_match_usage - check if driver's event should be called
1151 * @hid: hid device
1152 * @usage: usage to match against
1154 * compare hid->driver->usage_table->usage_{type,code} to
1155 * usage->usage_{type,code}
1157 static int hid_match_usage(struct hid_device *hid, struct hid_usage *usage)
1159 const struct hid_usage_id *id = hid->driver->usage_table;
1161 if (!id) /* NULL means all */
1162 return 1;
1164 for (; id->usage_type != HID_ANY_ID - 1; id++)
1165 if ((id->usage_hid == HID_ANY_ID ||
1166 id->usage_hid == usage->hid) &&
1167 (id->usage_type == HID_ANY_ID ||
1168 id->usage_type == usage->type) &&
1169 (id->usage_code == HID_ANY_ID ||
1170 id->usage_code == usage->code))
1171 return 1;
1172 return 0;
1175 static void hid_process_event(struct hid_device *hid, struct hid_field *field,
1176 struct hid_usage *usage, __s32 value, int interrupt)
1178 struct hid_driver *hdrv = hid->driver;
1179 int ret;
1181 if (!list_empty(&hid->debug_list))
1182 hid_dump_input(hid, usage, value);
1184 if (hdrv && hdrv->event && hid_match_usage(hid, usage)) {
1185 ret = hdrv->event(hid, field, usage, value);
1186 if (ret != 0) {
1187 if (ret < 0)
1188 hid_err(hid, "%s's event failed with %d\n",
1189 hdrv->name, ret);
1190 return;
1194 if (hid->claimed & HID_CLAIMED_INPUT)
1195 hidinput_hid_event(hid, field, usage, value);
1196 if (hid->claimed & HID_CLAIMED_HIDDEV && interrupt && hid->hiddev_hid_event)
1197 hid->hiddev_hid_event(hid, field, usage, value);
1201 * Analyse a received field, and fetch the data from it. The field
1202 * content is stored for next report processing (we do differential
1203 * reporting to the layer).
1206 static void hid_input_field(struct hid_device *hid, struct hid_field *field,
1207 __u8 *data, int interrupt)
1209 unsigned n;
1210 unsigned count = field->report_count;
1211 unsigned offset = field->report_offset;
1212 unsigned size = field->report_size;
1213 __s32 min = field->logical_minimum;
1214 __s32 max = field->logical_maximum;
1215 __s32 *value;
1217 value = kmalloc(sizeof(__s32) * count, GFP_ATOMIC);
1218 if (!value)
1219 return;
1221 for (n = 0; n < count; n++) {
1223 value[n] = min < 0 ?
1224 snto32(extract(hid, data, offset + n * size, size),
1225 size) :
1226 extract(hid, data, offset + n * size, size);
1228 /* Ignore report if ErrorRollOver */
1229 if (!(field->flags & HID_MAIN_ITEM_VARIABLE) &&
1230 value[n] >= min && value[n] <= max &&
1231 field->usage[value[n] - min].hid == HID_UP_KEYBOARD + 1)
1232 goto exit;
1235 for (n = 0; n < count; n++) {
1237 if (HID_MAIN_ITEM_VARIABLE & field->flags) {
1238 hid_process_event(hid, field, &field->usage[n], value[n], interrupt);
1239 continue;
1242 if (field->value[n] >= min && field->value[n] <= max
1243 && field->usage[field->value[n] - min].hid
1244 && search(value, field->value[n], count))
1245 hid_process_event(hid, field, &field->usage[field->value[n] - min], 0, interrupt);
1247 if (value[n] >= min && value[n] <= max
1248 && field->usage[value[n] - min].hid
1249 && search(field->value, value[n], count))
1250 hid_process_event(hid, field, &field->usage[value[n] - min], 1, interrupt);
1253 memcpy(field->value, value, count * sizeof(__s32));
1254 exit:
1255 kfree(value);
1259 * Output the field into the report.
1262 static void hid_output_field(const struct hid_device *hid,
1263 struct hid_field *field, __u8 *data)
1265 unsigned count = field->report_count;
1266 unsigned offset = field->report_offset;
1267 unsigned size = field->report_size;
1268 unsigned n;
1270 for (n = 0; n < count; n++) {
1271 if (field->logical_minimum < 0) /* signed values */
1272 implement(hid, data, offset + n * size, size,
1273 s32ton(field->value[n], size));
1274 else /* unsigned values */
1275 implement(hid, data, offset + n * size, size,
1276 field->value[n]);
1281 * Create a report. 'data' has to be allocated using
1282 * hid_alloc_report_buf() so that it has proper size.
1285 void hid_output_report(struct hid_report *report, __u8 *data)
1287 unsigned n;
1289 if (report->id > 0)
1290 *data++ = report->id;
1292 memset(data, 0, ((report->size - 1) >> 3) + 1);
1293 for (n = 0; n < report->maxfield; n++)
1294 hid_output_field(report->device, report->field[n], data);
1296 EXPORT_SYMBOL_GPL(hid_output_report);
1299 * Allocator for buffer that is going to be passed to hid_output_report()
1301 u8 *hid_alloc_report_buf(struct hid_report *report, gfp_t flags)
1304 * 7 extra bytes are necessary to achieve proper functionality
1305 * of implement() working on 8 byte chunks
1308 int len = hid_report_len(report) + 7;
1310 return kmalloc(len, flags);
1312 EXPORT_SYMBOL_GPL(hid_alloc_report_buf);
1315 * Set a field value. The report this field belongs to has to be
1316 * created and transferred to the device, to set this value in the
1317 * device.
1320 int hid_set_field(struct hid_field *field, unsigned offset, __s32 value)
1322 unsigned size;
1324 if (!field)
1325 return -1;
1327 size = field->report_size;
1329 hid_dump_input(field->report->device, field->usage + offset, value);
1331 if (offset >= field->report_count) {
1332 hid_err(field->report->device, "offset (%d) exceeds report_count (%d)\n",
1333 offset, field->report_count);
1334 return -1;
1336 if (field->logical_minimum < 0) {
1337 if (value != snto32(s32ton(value, size), size)) {
1338 hid_err(field->report->device, "value %d is out of range\n", value);
1339 return -1;
1342 field->value[offset] = value;
1343 return 0;
1345 EXPORT_SYMBOL_GPL(hid_set_field);
1347 static struct hid_report *hid_get_report(struct hid_report_enum *report_enum,
1348 const u8 *data)
1350 struct hid_report *report;
1351 unsigned int n = 0; /* Normally report number is 0 */
1353 /* Device uses numbered reports, data[0] is report number */
1354 if (report_enum->numbered)
1355 n = *data;
1357 report = report_enum->report_id_hash[n];
1358 if (report == NULL)
1359 dbg_hid("undefined report_id %u received\n", n);
1361 return report;
1365 * Implement a generic .request() callback, using .raw_request()
1366 * DO NOT USE in hid drivers directly, but through hid_hw_request instead.
1368 void __hid_request(struct hid_device *hid, struct hid_report *report,
1369 int reqtype)
1371 char *buf;
1372 int ret;
1373 int len;
1375 buf = hid_alloc_report_buf(report, GFP_KERNEL);
1376 if (!buf)
1377 return;
1379 len = hid_report_len(report);
1381 if (reqtype == HID_REQ_SET_REPORT)
1382 hid_output_report(report, buf);
1384 ret = hid->ll_driver->raw_request(hid, report->id, buf, len,
1385 report->type, reqtype);
1386 if (ret < 0) {
1387 dbg_hid("unable to complete request: %d\n", ret);
1388 goto out;
1391 if (reqtype == HID_REQ_GET_REPORT)
1392 hid_input_report(hid, report->type, buf, ret, 0);
1394 out:
1395 kfree(buf);
1397 EXPORT_SYMBOL_GPL(__hid_request);
1399 int hid_report_raw_event(struct hid_device *hid, int type, u8 *data, int size,
1400 int interrupt)
1402 struct hid_report_enum *report_enum = hid->report_enum + type;
1403 struct hid_report *report;
1404 struct hid_driver *hdrv;
1405 unsigned int a;
1406 int rsize, csize = size;
1407 u8 *cdata = data;
1408 int ret = 0;
1410 report = hid_get_report(report_enum, data);
1411 if (!report)
1412 goto out;
1414 if (report_enum->numbered) {
1415 cdata++;
1416 csize--;
1419 rsize = ((report->size - 1) >> 3) + 1;
1421 if (rsize > HID_MAX_BUFFER_SIZE)
1422 rsize = HID_MAX_BUFFER_SIZE;
1424 if (csize < rsize) {
1425 dbg_hid("report %d is too short, (%d < %d)\n", report->id,
1426 csize, rsize);
1427 memset(cdata + csize, 0, rsize - csize);
1430 if ((hid->claimed & HID_CLAIMED_HIDDEV) && hid->hiddev_report_event)
1431 hid->hiddev_report_event(hid, report);
1432 if (hid->claimed & HID_CLAIMED_HIDRAW) {
1433 ret = hidraw_report_event(hid, data, size);
1434 if (ret)
1435 goto out;
1438 if (hid->claimed != HID_CLAIMED_HIDRAW && report->maxfield) {
1439 for (a = 0; a < report->maxfield; a++)
1440 hid_input_field(hid, report->field[a], cdata, interrupt);
1441 hdrv = hid->driver;
1442 if (hdrv && hdrv->report)
1443 hdrv->report(hid, report);
1446 if (hid->claimed & HID_CLAIMED_INPUT)
1447 hidinput_report_event(hid, report);
1448 out:
1449 return ret;
1451 EXPORT_SYMBOL_GPL(hid_report_raw_event);
1454 * hid_input_report - report data from lower layer (usb, bt...)
1456 * @hid: hid device
1457 * @type: HID report type (HID_*_REPORT)
1458 * @data: report contents
1459 * @size: size of data parameter
1460 * @interrupt: distinguish between interrupt and control transfers
1462 * This is data entry for lower layers.
1464 int hid_input_report(struct hid_device *hid, int type, u8 *data, int size, int interrupt)
1466 struct hid_report_enum *report_enum;
1467 struct hid_driver *hdrv;
1468 struct hid_report *report;
1469 int ret = 0;
1471 if (!hid)
1472 return -ENODEV;
1474 if (down_trylock(&hid->driver_input_lock))
1475 return -EBUSY;
1477 if (!hid->driver) {
1478 ret = -ENODEV;
1479 goto unlock;
1481 report_enum = hid->report_enum + type;
1482 hdrv = hid->driver;
1484 if (!size) {
1485 dbg_hid("empty report\n");
1486 ret = -1;
1487 goto unlock;
1490 /* Avoid unnecessary overhead if debugfs is disabled */
1491 if (!list_empty(&hid->debug_list))
1492 hid_dump_report(hid, type, data, size);
1494 report = hid_get_report(report_enum, data);
1496 if (!report) {
1497 ret = -1;
1498 goto unlock;
1501 if (hdrv && hdrv->raw_event && hid_match_report(hid, report)) {
1502 ret = hdrv->raw_event(hid, report, data, size);
1503 if (ret < 0)
1504 goto unlock;
1507 ret = hid_report_raw_event(hid, type, data, size, interrupt);
1509 unlock:
1510 up(&hid->driver_input_lock);
1511 return ret;
1513 EXPORT_SYMBOL_GPL(hid_input_report);
1515 static bool hid_match_one_id(struct hid_device *hdev,
1516 const struct hid_device_id *id)
1518 return (id->bus == HID_BUS_ANY || id->bus == hdev->bus) &&
1519 (id->group == HID_GROUP_ANY || id->group == hdev->group) &&
1520 (id->vendor == HID_ANY_ID || id->vendor == hdev->vendor) &&
1521 (id->product == HID_ANY_ID || id->product == hdev->product);
1524 const struct hid_device_id *hid_match_id(struct hid_device *hdev,
1525 const struct hid_device_id *id)
1527 for (; id->bus; id++)
1528 if (hid_match_one_id(hdev, id))
1529 return id;
1531 return NULL;
1534 static const struct hid_device_id hid_hiddev_list[] = {
1535 { HID_USB_DEVICE(USB_VENDOR_ID_MGE, USB_DEVICE_ID_MGE_UPS) },
1536 { HID_USB_DEVICE(USB_VENDOR_ID_MGE, USB_DEVICE_ID_MGE_UPS1) },
1540 static bool hid_hiddev(struct hid_device *hdev)
1542 return !!hid_match_id(hdev, hid_hiddev_list);
1546 static ssize_t
1547 read_report_descriptor(struct file *filp, struct kobject *kobj,
1548 struct bin_attribute *attr,
1549 char *buf, loff_t off, size_t count)
1551 struct device *dev = container_of(kobj, struct device, kobj);
1552 struct hid_device *hdev = container_of(dev, struct hid_device, dev);
1554 if (off >= hdev->rsize)
1555 return 0;
1557 if (off + count > hdev->rsize)
1558 count = hdev->rsize - off;
1560 memcpy(buf, hdev->rdesc + off, count);
1562 return count;
1565 static struct bin_attribute dev_bin_attr_report_desc = {
1566 .attr = { .name = "report_descriptor", .mode = 0444 },
1567 .read = read_report_descriptor,
1568 .size = HID_MAX_DESCRIPTOR_SIZE,
1571 int hid_connect(struct hid_device *hdev, unsigned int connect_mask)
1573 static const char *types[] = { "Device", "Pointer", "Mouse", "Device",
1574 "Joystick", "Gamepad", "Keyboard", "Keypad",
1575 "Multi-Axis Controller"
1577 const char *type, *bus;
1578 char buf[64];
1579 unsigned int i;
1580 int len;
1581 int ret;
1583 if (hdev->quirks & HID_QUIRK_HIDDEV_FORCE)
1584 connect_mask |= (HID_CONNECT_HIDDEV_FORCE | HID_CONNECT_HIDDEV);
1585 if (hdev->quirks & HID_QUIRK_HIDINPUT_FORCE)
1586 connect_mask |= HID_CONNECT_HIDINPUT_FORCE;
1587 if (hdev->bus != BUS_USB)
1588 connect_mask &= ~HID_CONNECT_HIDDEV;
1589 if (hid_hiddev(hdev))
1590 connect_mask |= HID_CONNECT_HIDDEV_FORCE;
1592 if ((connect_mask & HID_CONNECT_HIDINPUT) && !hidinput_connect(hdev,
1593 connect_mask & HID_CONNECT_HIDINPUT_FORCE))
1594 hdev->claimed |= HID_CLAIMED_INPUT;
1596 if ((connect_mask & HID_CONNECT_HIDDEV) && hdev->hiddev_connect &&
1597 !hdev->hiddev_connect(hdev,
1598 connect_mask & HID_CONNECT_HIDDEV_FORCE))
1599 hdev->claimed |= HID_CLAIMED_HIDDEV;
1600 if ((connect_mask & HID_CONNECT_HIDRAW) && !hidraw_connect(hdev))
1601 hdev->claimed |= HID_CLAIMED_HIDRAW;
1603 if (connect_mask & HID_CONNECT_DRIVER)
1604 hdev->claimed |= HID_CLAIMED_DRIVER;
1606 /* Drivers with the ->raw_event callback set are not required to connect
1607 * to any other listener. */
1608 if (!hdev->claimed && !hdev->driver->raw_event) {
1609 hid_err(hdev, "device has no listeners, quitting\n");
1610 return -ENODEV;
1613 if ((hdev->claimed & HID_CLAIMED_INPUT) &&
1614 (connect_mask & HID_CONNECT_FF) && hdev->ff_init)
1615 hdev->ff_init(hdev);
1617 len = 0;
1618 if (hdev->claimed & HID_CLAIMED_INPUT)
1619 len += sprintf(buf + len, "input");
1620 if (hdev->claimed & HID_CLAIMED_HIDDEV)
1621 len += sprintf(buf + len, "%shiddev%d", len ? "," : "",
1622 hdev->minor);
1623 if (hdev->claimed & HID_CLAIMED_HIDRAW)
1624 len += sprintf(buf + len, "%shidraw%d", len ? "," : "",
1625 ((struct hidraw *)hdev->hidraw)->minor);
1627 type = "Device";
1628 for (i = 0; i < hdev->maxcollection; i++) {
1629 struct hid_collection *col = &hdev->collection[i];
1630 if (col->type == HID_COLLECTION_APPLICATION &&
1631 (col->usage & HID_USAGE_PAGE) == HID_UP_GENDESK &&
1632 (col->usage & 0xffff) < ARRAY_SIZE(types)) {
1633 type = types[col->usage & 0xffff];
1634 break;
1638 switch (hdev->bus) {
1639 case BUS_USB:
1640 bus = "USB";
1641 break;
1642 case BUS_BLUETOOTH:
1643 bus = "BLUETOOTH";
1644 break;
1645 default:
1646 bus = "<UNKNOWN>";
1649 ret = device_create_bin_file(&hdev->dev, &dev_bin_attr_report_desc);
1650 if (ret)
1651 hid_warn(hdev,
1652 "can't create sysfs report descriptor attribute err: %d\n", ret);
1654 hid_info(hdev, "%s: %s HID v%x.%02x %s [%s] on %s\n",
1655 buf, bus, hdev->version >> 8, hdev->version & 0xff,
1656 type, hdev->name, hdev->phys);
1658 return 0;
1660 EXPORT_SYMBOL_GPL(hid_connect);
1662 void hid_disconnect(struct hid_device *hdev)
1664 device_remove_bin_file(&hdev->dev, &dev_bin_attr_report_desc);
1665 if (hdev->claimed & HID_CLAIMED_INPUT)
1666 hidinput_disconnect(hdev);
1667 if (hdev->claimed & HID_CLAIMED_HIDDEV)
1668 hdev->hiddev_disconnect(hdev);
1669 if (hdev->claimed & HID_CLAIMED_HIDRAW)
1670 hidraw_disconnect(hdev);
1671 hdev->claimed = 0;
1673 EXPORT_SYMBOL_GPL(hid_disconnect);
1676 * A list of devices for which there is a specialized driver on HID bus.
1678 * Please note that for multitouch devices (driven by hid-multitouch driver),
1679 * there is a proper autodetection and autoloading in place (based on presence
1680 * of HID_DG_CONTACTID), so those devices don't need to be added to this list,
1681 * as we are doing the right thing in hid_scan_usage().
1683 * Autodetection for (USB) HID sensor hubs exists too. If a collection of type
1684 * physical is found inside a usage page of type sensor, hid-sensor-hub will be
1685 * used as a driver. See hid_scan_report().
1687 static const struct hid_device_id hid_have_special_driver[] = {
1688 { HID_USB_DEVICE(USB_VENDOR_ID_A4TECH, USB_DEVICE_ID_A4TECH_WCP32PU) },
1689 { HID_USB_DEVICE(USB_VENDOR_ID_A4TECH, USB_DEVICE_ID_A4TECH_X5_005D) },
1690 { HID_USB_DEVICE(USB_VENDOR_ID_A4TECH, USB_DEVICE_ID_A4TECH_RP_649) },
1691 { HID_USB_DEVICE(USB_VENDOR_ID_ACRUX, 0x0802) },
1692 { HID_USB_DEVICE(USB_VENDOR_ID_ACRUX, 0xf705) },
1693 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_MIGHTYMOUSE) },
1694 { HID_BLUETOOTH_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_MAGICMOUSE) },
1695 { HID_BLUETOOTH_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_MAGICTRACKPAD) },
1696 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_FOUNTAIN_ANSI) },
1697 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_FOUNTAIN_ISO) },
1698 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_GEYSER_ANSI) },
1699 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_GEYSER_ISO) },
1700 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_GEYSER_JIS) },
1701 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_GEYSER3_ANSI) },
1702 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_GEYSER3_ISO) },
1703 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_GEYSER3_JIS) },
1704 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_GEYSER4_ANSI) },
1705 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_GEYSER4_ISO) },
1706 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_GEYSER4_JIS) },
1707 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_ALU_MINI_ANSI) },
1708 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_ALU_MINI_ISO) },
1709 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_ALU_MINI_JIS) },
1710 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_ALU_ANSI) },
1711 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_ALU_ISO) },
1712 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_ALU_JIS) },
1713 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_GEYSER4_HF_ANSI) },
1714 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_GEYSER4_HF_ISO) },
1715 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_GEYSER4_HF_JIS) },
1716 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_IRCONTROL) },
1717 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_IRCONTROL2) },
1718 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_IRCONTROL3) },
1719 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_IRCONTROL4) },
1720 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_IRCONTROL5) },
1721 { HID_BLUETOOTH_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_ALU_WIRELESS_ANSI) },
1722 { HID_BLUETOOTH_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_ALU_WIRELESS_ISO) },
1723 { HID_BLUETOOTH_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_ALU_WIRELESS_JIS) },
1724 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING_ANSI) },
1725 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING_ISO) },
1726 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING_JIS) },
1727 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING2_ANSI) },
1728 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING2_ISO) },
1729 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING2_JIS) },
1730 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING3_ANSI) },
1731 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING3_ISO) },
1732 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING3_JIS) },
1733 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING4_ANSI) },
1734 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING4_ISO) },
1735 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING4_JIS) },
1736 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING4A_ANSI) },
1737 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING4A_ISO) },
1738 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING4A_JIS) },
1739 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING5_ANSI) },
1740 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING5_ISO) },
1741 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING5_JIS) },
1742 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING5A_ANSI) },
1743 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING5A_ISO) },
1744 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING5A_JIS) },
1745 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_ALU_REVB_ANSI) },
1746 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_ALU_REVB_ISO) },
1747 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_ALU_REVB_JIS) },
1748 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING6_ANSI) },
1749 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING6_ISO) },
1750 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING6_JIS) },
1751 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING6A_ANSI) },
1752 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING6A_ISO) },
1753 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING6A_JIS) },
1754 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING7_ANSI) },
1755 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING7_ISO) },
1756 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING7_JIS) },
1757 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING7A_ANSI) },
1758 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING7A_ISO) },
1759 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING7A_JIS) },
1760 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING8_ANSI) },
1761 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING8_ISO) },
1762 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING8_JIS) },
1763 { HID_BLUETOOTH_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_ALU_WIRELESS_2009_ANSI) },
1764 { HID_BLUETOOTH_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_ALU_WIRELESS_2009_ISO) },
1765 { HID_BLUETOOTH_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_ALU_WIRELESS_2009_JIS) },
1766 { HID_BLUETOOTH_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_ALU_WIRELESS_2011_ANSI) },
1767 { HID_BLUETOOTH_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_ALU_WIRELESS_2011_ISO) },
1768 { HID_BLUETOOTH_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_ALU_WIRELESS_2011_JIS) },
1769 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_FOUNTAIN_TP_ONLY) },
1770 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_GEYSER1_TP_ONLY) },
1771 { HID_USB_DEVICE(USB_VENDOR_ID_AUREAL, USB_DEVICE_ID_AUREAL_W01RN) },
1772 { HID_USB_DEVICE(USB_VENDOR_ID_BELKIN, USB_DEVICE_ID_FLIP_KVM) },
1773 { HID_USB_DEVICE(USB_VENDOR_ID_BETOP_2185BFM, 0x2208) },
1774 { HID_USB_DEVICE(USB_VENDOR_ID_BETOP_2185PC, 0x5506) },
1775 { HID_USB_DEVICE(USB_VENDOR_ID_BETOP_2185V2PC, 0x1850) },
1776 { HID_USB_DEVICE(USB_VENDOR_ID_BETOP_2185V2BFM, 0x5500) },
1777 { HID_USB_DEVICE(USB_VENDOR_ID_BTC, USB_DEVICE_ID_BTC_EMPREX_REMOTE) },
1778 { HID_USB_DEVICE(USB_VENDOR_ID_BTC, USB_DEVICE_ID_BTC_EMPREX_REMOTE_2) },
1779 { HID_USB_DEVICE(USB_VENDOR_ID_CHERRY, USB_DEVICE_ID_CHERRY_CYMOTION) },
1780 { HID_USB_DEVICE(USB_VENDOR_ID_CHERRY, USB_DEVICE_ID_CHERRY_CYMOTION_SOLAR) },
1781 { HID_USB_DEVICE(USB_VENDOR_ID_CHICONY, USB_DEVICE_ID_CHICONY_TACTICAL_PAD) },
1782 { HID_USB_DEVICE(USB_VENDOR_ID_CHICONY, USB_DEVICE_ID_CHICONY_WIRELESS) },
1783 { HID_USB_DEVICE(USB_VENDOR_ID_CHICONY, USB_DEVICE_ID_CHICONY_WIRELESS2) },
1784 { HID_USB_DEVICE(USB_VENDOR_ID_CHICONY, USB_DEVICE_ID_CHICONY_AK1D) },
1785 { HID_USB_DEVICE(USB_VENDOR_ID_CREATIVELABS, USB_DEVICE_ID_PRODIKEYS_PCMIDI) },
1786 { HID_USB_DEVICE(USB_VENDOR_ID_CYGNAL, USB_DEVICE_ID_CYGNAL_CP2112) },
1787 { HID_USB_DEVICE(USB_VENDOR_ID_CYPRESS, USB_DEVICE_ID_CYPRESS_BARCODE_1) },
1788 { HID_USB_DEVICE(USB_VENDOR_ID_CYPRESS, USB_DEVICE_ID_CYPRESS_BARCODE_2) },
1789 { HID_USB_DEVICE(USB_VENDOR_ID_CYPRESS, USB_DEVICE_ID_CYPRESS_BARCODE_3) },
1790 { HID_USB_DEVICE(USB_VENDOR_ID_CYPRESS, USB_DEVICE_ID_CYPRESS_BARCODE_4) },
1791 { HID_USB_DEVICE(USB_VENDOR_ID_CYPRESS, USB_DEVICE_ID_CYPRESS_MOUSE) },
1792 { HID_USB_DEVICE(USB_VENDOR_ID_DRAGONRISE, 0x0006) },
1793 { HID_USB_DEVICE(USB_VENDOR_ID_DRAGONRISE, 0x0011) },
1794 { HID_BLUETOOTH_DEVICE(USB_VENDOR_ID_ELECOM, USB_DEVICE_ID_ELECOM_BM084) },
1795 { HID_USB_DEVICE(USB_VENDOR_ID_ELO, 0x0009) },
1796 { HID_USB_DEVICE(USB_VENDOR_ID_ELO, 0x0030) },
1797 { HID_USB_DEVICE(USB_VENDOR_ID_EMS, USB_DEVICE_ID_EMS_TRIO_LINKER_PLUS_II) },
1798 { HID_USB_DEVICE(USB_VENDOR_ID_EZKEY, USB_DEVICE_ID_BTC_8193) },
1799 { HID_USB_DEVICE(USB_VENDOR_ID_GAMERON, USB_DEVICE_ID_GAMERON_DUAL_PSX_ADAPTOR) },
1800 { HID_USB_DEVICE(USB_VENDOR_ID_GAMERON, USB_DEVICE_ID_GAMERON_DUAL_PCS_ADAPTOR) },
1801 { HID_USB_DEVICE(USB_VENDOR_ID_GREENASIA, 0x0003) },
1802 { HID_USB_DEVICE(USB_VENDOR_ID_GREENASIA, 0x0012) },
1803 { HID_USB_DEVICE(USB_VENDOR_ID_GYRATION, USB_DEVICE_ID_GYRATION_REMOTE) },
1804 { HID_USB_DEVICE(USB_VENDOR_ID_GYRATION, USB_DEVICE_ID_GYRATION_REMOTE_2) },
1805 { HID_USB_DEVICE(USB_VENDOR_ID_GYRATION, USB_DEVICE_ID_GYRATION_REMOTE_3) },
1806 { HID_USB_DEVICE(USB_VENDOR_ID_HOLTEK, USB_DEVICE_ID_HOLTEK_ON_LINE_GRIP) },
1807 { HID_USB_DEVICE(USB_VENDOR_ID_HOLTEK_ALT, USB_DEVICE_ID_HOLTEK_ALT_KEYBOARD) },
1808 { HID_USB_DEVICE(USB_VENDOR_ID_HOLTEK_ALT, USB_DEVICE_ID_HOLTEK_ALT_MOUSE_A04A) },
1809 { HID_USB_DEVICE(USB_VENDOR_ID_HOLTEK_ALT, USB_DEVICE_ID_HOLTEK_ALT_MOUSE_A067) },
1810 { HID_USB_DEVICE(USB_VENDOR_ID_HOLTEK_ALT, USB_DEVICE_ID_HOLTEK_ALT_MOUSE_A070) },
1811 { HID_USB_DEVICE(USB_VENDOR_ID_HOLTEK_ALT, USB_DEVICE_ID_HOLTEK_ALT_MOUSE_A072) },
1812 { HID_USB_DEVICE(USB_VENDOR_ID_HOLTEK_ALT, USB_DEVICE_ID_HOLTEK_ALT_MOUSE_A081) },
1813 { HID_USB_DEVICE(USB_VENDOR_ID_HOLTEK_ALT, USB_DEVICE_ID_HOLTEK_ALT_MOUSE_A0C2) },
1814 { HID_USB_DEVICE(USB_VENDOR_ID_HUION, USB_DEVICE_ID_HUION_TABLET) },
1815 { HID_USB_DEVICE(USB_VENDOR_ID_JESS2, USB_DEVICE_ID_JESS2_COLOR_RUMBLE_PAD) },
1816 { HID_BLUETOOTH_DEVICE(USB_VENDOR_ID_ION, USB_DEVICE_ID_ICADE) },
1817 { HID_USB_DEVICE(USB_VENDOR_ID_KENSINGTON, USB_DEVICE_ID_KS_SLIMBLADE) },
1818 { HID_USB_DEVICE(USB_VENDOR_ID_KEYTOUCH, USB_DEVICE_ID_KEYTOUCH_IEC) },
1819 { HID_USB_DEVICE(USB_VENDOR_ID_KYE, USB_DEVICE_ID_GENIUS_GILA_GAMING_MOUSE) },
1820 { HID_USB_DEVICE(USB_VENDOR_ID_KYE, USB_DEVICE_ID_GENIUS_MANTICORE) },
1821 { HID_USB_DEVICE(USB_VENDOR_ID_KYE, USB_DEVICE_ID_GENIUS_GX_IMPERATOR) },
1822 { HID_USB_DEVICE(USB_VENDOR_ID_KYE, USB_DEVICE_ID_KYE_ERGO_525V) },
1823 { HID_USB_DEVICE(USB_VENDOR_ID_KYE, USB_DEVICE_ID_KYE_EASYPEN_I405X) },
1824 { HID_USB_DEVICE(USB_VENDOR_ID_KYE, USB_DEVICE_ID_KYE_MOUSEPEN_I608X) },
1825 { HID_USB_DEVICE(USB_VENDOR_ID_KYE, USB_DEVICE_ID_KYE_MOUSEPEN_I608X_2) },
1826 { HID_USB_DEVICE(USB_VENDOR_ID_KYE, USB_DEVICE_ID_KYE_EASYPEN_M610X) },
1827 { HID_USB_DEVICE(USB_VENDOR_ID_LABTEC, USB_DEVICE_ID_LABTEC_WIRELESS_KEYBOARD) },
1828 { HID_USB_DEVICE(USB_VENDOR_ID_LCPOWER, USB_DEVICE_ID_LCPOWER_LC1000 ) },
1829 #if IS_ENABLED(CONFIG_HID_LENOVO)
1830 { HID_USB_DEVICE(USB_VENDOR_ID_LENOVO, USB_DEVICE_ID_LENOVO_TPKBD) },
1831 { HID_USB_DEVICE(USB_VENDOR_ID_LENOVO, USB_DEVICE_ID_LENOVO_CUSBKBD) },
1832 { HID_BLUETOOTH_DEVICE(USB_VENDOR_ID_LENOVO, USB_DEVICE_ID_LENOVO_CBTKBD) },
1833 #endif
1834 { HID_USB_DEVICE(USB_VENDOR_ID_LOGITECH, USB_DEVICE_ID_MX3000_RECEIVER) },
1835 { HID_USB_DEVICE(USB_VENDOR_ID_LOGITECH, USB_DEVICE_ID_S510_RECEIVER) },
1836 { HID_USB_DEVICE(USB_VENDOR_ID_LOGITECH, USB_DEVICE_ID_S510_RECEIVER_2) },
1837 { HID_USB_DEVICE(USB_VENDOR_ID_LOGITECH, USB_DEVICE_ID_LOGITECH_RECEIVER) },
1838 { HID_BLUETOOTH_DEVICE(USB_VENDOR_ID_LOGITECH, USB_DEVICE_ID_LOGITECH_HARMONY_PS3) },
1839 { HID_BLUETOOTH_DEVICE(USB_VENDOR_ID_LOGITECH, USB_DEVICE_ID_LOGITECH_T651) },
1840 { HID_USB_DEVICE(USB_VENDOR_ID_LOGITECH, USB_DEVICE_ID_DINOVO_DESKTOP) },
1841 { HID_USB_DEVICE(USB_VENDOR_ID_LOGITECH, USB_DEVICE_ID_DINOVO_EDGE) },
1842 { HID_USB_DEVICE(USB_VENDOR_ID_LOGITECH, USB_DEVICE_ID_DINOVO_MINI) },
1843 { HID_USB_DEVICE(USB_VENDOR_ID_LOGITECH, USB_DEVICE_ID_LOGITECH_ELITE_KBD) },
1844 { HID_USB_DEVICE(USB_VENDOR_ID_LOGITECH, USB_DEVICE_ID_LOGITECH_CORDLESS_DESKTOP_LX500) },
1845 { HID_USB_DEVICE(USB_VENDOR_ID_LOGITECH, USB_DEVICE_ID_LOGITECH_EXTREME_3D) },
1846 { HID_USB_DEVICE(USB_VENDOR_ID_LOGITECH, USB_DEVICE_ID_LOGITECH_WHEEL) },
1847 { HID_USB_DEVICE(USB_VENDOR_ID_LOGITECH, USB_DEVICE_ID_LOGITECH_RUMBLEPAD_CORD) },
1848 { HID_USB_DEVICE(USB_VENDOR_ID_LOGITECH, USB_DEVICE_ID_LOGITECH_RUMBLEPAD) },
1849 { HID_USB_DEVICE(USB_VENDOR_ID_LOGITECH, USB_DEVICE_ID_LOGITECH_RUMBLEPAD2_2) },
1850 { HID_USB_DEVICE(USB_VENDOR_ID_LOGITECH, USB_DEVICE_ID_LOGITECH_WINGMAN_F3D) },
1851 { HID_USB_DEVICE(USB_VENDOR_ID_LOGITECH, USB_DEVICE_ID_LOGITECH_WINGMAN_FFG ) },
1852 { HID_USB_DEVICE(USB_VENDOR_ID_LOGITECH, USB_DEVICE_ID_LOGITECH_FORCE3D_PRO) },
1853 { HID_USB_DEVICE(USB_VENDOR_ID_LOGITECH, USB_DEVICE_ID_LOGITECH_FLIGHT_SYSTEM_G940) },
1854 { HID_USB_DEVICE(USB_VENDOR_ID_LOGITECH, USB_DEVICE_ID_LOGITECH_MOMO_WHEEL) },
1855 { HID_USB_DEVICE(USB_VENDOR_ID_LOGITECH, USB_DEVICE_ID_LOGITECH_MOMO_WHEEL2) },
1856 { HID_USB_DEVICE(USB_VENDOR_ID_LOGITECH, USB_DEVICE_ID_LOGITECH_VIBRATION_WHEEL) },
1857 { HID_USB_DEVICE(USB_VENDOR_ID_LOGITECH, USB_DEVICE_ID_LOGITECH_DFP_WHEEL) },
1858 { HID_USB_DEVICE(USB_VENDOR_ID_LOGITECH, USB_DEVICE_ID_LOGITECH_DFGT_WHEEL) },
1859 { HID_USB_DEVICE(USB_VENDOR_ID_LOGITECH, USB_DEVICE_ID_LOGITECH_G25_WHEEL) },
1860 { HID_USB_DEVICE(USB_VENDOR_ID_LOGITECH, USB_DEVICE_ID_LOGITECH_G27_WHEEL) },
1861 #if IS_ENABLED(CONFIG_HID_LOGITECH_DJ)
1862 { HID_USB_DEVICE(USB_VENDOR_ID_LOGITECH, USB_DEVICE_ID_LOGITECH_UNIFYING_RECEIVER) },
1863 { HID_USB_DEVICE(USB_VENDOR_ID_LOGITECH, USB_DEVICE_ID_LOGITECH_UNIFYING_RECEIVER_2) },
1864 #endif
1865 { HID_USB_DEVICE(USB_VENDOR_ID_LOGITECH, USB_DEVICE_ID_LOGITECH_WII_WHEEL) },
1866 { HID_USB_DEVICE(USB_VENDOR_ID_LOGITECH, USB_DEVICE_ID_LOGITECH_RUMBLEPAD2) },
1867 { HID_USB_DEVICE(USB_VENDOR_ID_LOGITECH, USB_DEVICE_ID_SPACETRAVELLER) },
1868 { HID_USB_DEVICE(USB_VENDOR_ID_LOGITECH, USB_DEVICE_ID_SPACENAVIGATOR) },
1869 { HID_USB_DEVICE(USB_VENDOR_ID_MICROCHIP, USB_DEVICE_ID_PICOLCD) },
1870 { HID_USB_DEVICE(USB_VENDOR_ID_MICROCHIP, USB_DEVICE_ID_PICOLCD_BOOTLOADER) },
1871 { HID_USB_DEVICE(USB_VENDOR_ID_MICROSOFT, USB_DEVICE_ID_MS_COMFORT_MOUSE_4500) },
1872 { HID_USB_DEVICE(USB_VENDOR_ID_MICROSOFT, USB_DEVICE_ID_SIDEWINDER_GV) },
1873 { HID_USB_DEVICE(USB_VENDOR_ID_MICROSOFT, USB_DEVICE_ID_MS_NE4K) },
1874 { HID_USB_DEVICE(USB_VENDOR_ID_MICROSOFT, USB_DEVICE_ID_MS_NE4K_JP) },
1875 { HID_USB_DEVICE(USB_VENDOR_ID_MICROSOFT, USB_DEVICE_ID_MS_LK6K) },
1876 { HID_USB_DEVICE(USB_VENDOR_ID_MICROSOFT, USB_DEVICE_ID_MS_PRESENTER_8K_USB) },
1877 { HID_USB_DEVICE(USB_VENDOR_ID_MICROSOFT, USB_DEVICE_ID_MS_DIGITAL_MEDIA_3K) },
1878 { HID_USB_DEVICE(USB_VENDOR_ID_MICROSOFT, USB_DEVICE_ID_WIRELESS_OPTICAL_DESKTOP_3_0) },
1879 { HID_USB_DEVICE(USB_VENDOR_ID_MICROSOFT, USB_DEVICE_ID_MS_OFFICE_KB) },
1880 { HID_USB_DEVICE(USB_VENDOR_ID_MICROSOFT, USB_DEVICE_ID_MS_TYPE_COVER_3) },
1881 { HID_USB_DEVICE(USB_VENDOR_ID_MICROSOFT, USB_DEVICE_ID_MS_TYPE_COVER_3_JP) },
1882 { HID_USB_DEVICE(USB_VENDOR_ID_MONTEREY, USB_DEVICE_ID_GENIUS_KB29E) },
1883 { HID_USB_DEVICE(USB_VENDOR_ID_MSI, USB_DEVICE_ID_MSI_GT683R_LED_PANEL) },
1884 { HID_USB_DEVICE(USB_VENDOR_ID_NTRIG, USB_DEVICE_ID_NTRIG_TOUCH_SCREEN) },
1885 { HID_USB_DEVICE(USB_VENDOR_ID_NTRIG, USB_DEVICE_ID_NTRIG_TOUCH_SCREEN_1) },
1886 { HID_USB_DEVICE(USB_VENDOR_ID_NTRIG, USB_DEVICE_ID_NTRIG_TOUCH_SCREEN_2) },
1887 { HID_USB_DEVICE(USB_VENDOR_ID_NTRIG, USB_DEVICE_ID_NTRIG_TOUCH_SCREEN_3) },
1888 { HID_USB_DEVICE(USB_VENDOR_ID_NTRIG, USB_DEVICE_ID_NTRIG_TOUCH_SCREEN_4) },
1889 { HID_USB_DEVICE(USB_VENDOR_ID_NTRIG, USB_DEVICE_ID_NTRIG_TOUCH_SCREEN_5) },
1890 { HID_USB_DEVICE(USB_VENDOR_ID_NTRIG, USB_DEVICE_ID_NTRIG_TOUCH_SCREEN_6) },
1891 { HID_USB_DEVICE(USB_VENDOR_ID_NTRIG, USB_DEVICE_ID_NTRIG_TOUCH_SCREEN_7) },
1892 { HID_USB_DEVICE(USB_VENDOR_ID_NTRIG, USB_DEVICE_ID_NTRIG_TOUCH_SCREEN_8) },
1893 { HID_USB_DEVICE(USB_VENDOR_ID_NTRIG, USB_DEVICE_ID_NTRIG_TOUCH_SCREEN_9) },
1894 { HID_USB_DEVICE(USB_VENDOR_ID_NTRIG, USB_DEVICE_ID_NTRIG_TOUCH_SCREEN_10) },
1895 { HID_USB_DEVICE(USB_VENDOR_ID_NTRIG, USB_DEVICE_ID_NTRIG_TOUCH_SCREEN_11) },
1896 { HID_USB_DEVICE(USB_VENDOR_ID_NTRIG, USB_DEVICE_ID_NTRIG_TOUCH_SCREEN_12) },
1897 { HID_USB_DEVICE(USB_VENDOR_ID_NTRIG, USB_DEVICE_ID_NTRIG_TOUCH_SCREEN_13) },
1898 { HID_USB_DEVICE(USB_VENDOR_ID_NTRIG, USB_DEVICE_ID_NTRIG_TOUCH_SCREEN_14) },
1899 { HID_USB_DEVICE(USB_VENDOR_ID_NTRIG, USB_DEVICE_ID_NTRIG_TOUCH_SCREEN_15) },
1900 { HID_USB_DEVICE(USB_VENDOR_ID_NTRIG, USB_DEVICE_ID_NTRIG_TOUCH_SCREEN_16) },
1901 { HID_USB_DEVICE(USB_VENDOR_ID_NTRIG, USB_DEVICE_ID_NTRIG_TOUCH_SCREEN_17) },
1902 { HID_USB_DEVICE(USB_VENDOR_ID_NTRIG, USB_DEVICE_ID_NTRIG_TOUCH_SCREEN_18) },
1903 { HID_USB_DEVICE(USB_VENDOR_ID_ORTEK, USB_DEVICE_ID_ORTEK_PKB1700) },
1904 { HID_USB_DEVICE(USB_VENDOR_ID_ORTEK, USB_DEVICE_ID_ORTEK_WKB2000) },
1905 { HID_USB_DEVICE(USB_VENDOR_ID_PENMOUNT, USB_DEVICE_ID_PENMOUNT_6000) },
1906 { HID_USB_DEVICE(USB_VENDOR_ID_PETALYNX, USB_DEVICE_ID_PETALYNX_MAXTER_REMOTE) },
1907 { HID_USB_DEVICE(USB_VENDOR_ID_PLANTRONICS, HID_ANY_ID) },
1908 { HID_USB_DEVICE(USB_VENDOR_ID_PRIMAX, USB_DEVICE_ID_PRIMAX_KEYBOARD) },
1909 #if IS_ENABLED(CONFIG_HID_ROCCAT)
1910 { HID_USB_DEVICE(USB_VENDOR_ID_ROCCAT, USB_DEVICE_ID_ROCCAT_ARVO) },
1911 { HID_USB_DEVICE(USB_VENDOR_ID_ROCCAT, USB_DEVICE_ID_ROCCAT_ISKU) },
1912 { HID_USB_DEVICE(USB_VENDOR_ID_ROCCAT, USB_DEVICE_ID_ROCCAT_ISKUFX) },
1913 { HID_USB_DEVICE(USB_VENDOR_ID_ROCCAT, USB_DEVICE_ID_ROCCAT_KONE) },
1914 { HID_USB_DEVICE(USB_VENDOR_ID_ROCCAT, USB_DEVICE_ID_ROCCAT_KONEPLUS) },
1915 { HID_USB_DEVICE(USB_VENDOR_ID_ROCCAT, USB_DEVICE_ID_ROCCAT_KONEPURE) },
1916 { HID_USB_DEVICE(USB_VENDOR_ID_ROCCAT, USB_DEVICE_ID_ROCCAT_KONEPURE_OPTICAL) },
1917 { HID_USB_DEVICE(USB_VENDOR_ID_ROCCAT, USB_DEVICE_ID_ROCCAT_KONEXTD) },
1918 { HID_USB_DEVICE(USB_VENDOR_ID_ROCCAT, USB_DEVICE_ID_ROCCAT_KOVAPLUS) },
1919 { HID_USB_DEVICE(USB_VENDOR_ID_ROCCAT, USB_DEVICE_ID_ROCCAT_LUA) },
1920 { HID_USB_DEVICE(USB_VENDOR_ID_ROCCAT, USB_DEVICE_ID_ROCCAT_PYRA_WIRED) },
1921 { HID_USB_DEVICE(USB_VENDOR_ID_ROCCAT, USB_DEVICE_ID_ROCCAT_PYRA_WIRELESS) },
1922 { HID_USB_DEVICE(USB_VENDOR_ID_ROCCAT, USB_DEVICE_ID_ROCCAT_RYOS_MK) },
1923 { HID_USB_DEVICE(USB_VENDOR_ID_ROCCAT, USB_DEVICE_ID_ROCCAT_RYOS_MK_GLOW) },
1924 { HID_USB_DEVICE(USB_VENDOR_ID_ROCCAT, USB_DEVICE_ID_ROCCAT_RYOS_MK_PRO) },
1925 { HID_USB_DEVICE(USB_VENDOR_ID_ROCCAT, USB_DEVICE_ID_ROCCAT_SAVU) },
1926 #endif
1927 #if IS_ENABLED(CONFIG_HID_SAITEK)
1928 { HID_USB_DEVICE(USB_VENDOR_ID_SAITEK, USB_DEVICE_ID_SAITEK_PS1000) },
1929 { HID_USB_DEVICE(USB_VENDOR_ID_SAITEK, USB_DEVICE_ID_SAITEK_RAT7) },
1930 { HID_USB_DEVICE(USB_VENDOR_ID_SAITEK, USB_DEVICE_ID_SAITEK_MMO7) },
1931 { HID_USB_DEVICE(USB_VENDOR_ID_MADCATZ, USB_DEVICE_ID_MADCATZ_RAT9) },
1932 #endif
1933 { HID_USB_DEVICE(USB_VENDOR_ID_SAMSUNG, USB_DEVICE_ID_SAMSUNG_IR_REMOTE) },
1934 { HID_USB_DEVICE(USB_VENDOR_ID_SAMSUNG, USB_DEVICE_ID_SAMSUNG_WIRELESS_KBD_MOUSE) },
1935 { HID_USB_DEVICE(USB_VENDOR_ID_SKYCABLE, USB_DEVICE_ID_SKYCABLE_WIRELESS_PRESENTER) },
1936 { HID_BLUETOOTH_DEVICE(USB_VENDOR_ID_SMK, USB_DEVICE_ID_SMK_PS3_BDREMOTE) },
1937 { HID_USB_DEVICE(USB_VENDOR_ID_SONY, USB_DEVICE_ID_SONY_BUZZ_CONTROLLER) },
1938 { HID_USB_DEVICE(USB_VENDOR_ID_SONY, USB_DEVICE_ID_SONY_WIRELESS_BUZZ_CONTROLLER) },
1939 { HID_BLUETOOTH_DEVICE(USB_VENDOR_ID_SONY, USB_DEVICE_ID_SONY_PS3_BDREMOTE) },
1940 { HID_USB_DEVICE(USB_VENDOR_ID_SONY, USB_DEVICE_ID_SONY_PS3_CONTROLLER) },
1941 { HID_USB_DEVICE(USB_VENDOR_ID_SONY, USB_DEVICE_ID_SONY_NAVIGATION_CONTROLLER) },
1942 { HID_BLUETOOTH_DEVICE(USB_VENDOR_ID_SONY, USB_DEVICE_ID_SONY_PS3_CONTROLLER) },
1943 { HID_USB_DEVICE(USB_VENDOR_ID_SONY, USB_DEVICE_ID_SONY_PS4_CONTROLLER) },
1944 { HID_BLUETOOTH_DEVICE(USB_VENDOR_ID_SONY, USB_DEVICE_ID_SONY_PS4_CONTROLLER) },
1945 { HID_USB_DEVICE(USB_VENDOR_ID_SONY, USB_DEVICE_ID_SONY_VAIO_VGX_MOUSE) },
1946 { HID_USB_DEVICE(USB_VENDOR_ID_SONY, USB_DEVICE_ID_SONY_VAIO_VGP_MOUSE) },
1947 { HID_USB_DEVICE(USB_VENDOR_ID_STEELSERIES, USB_DEVICE_ID_STEELSERIES_SRWS1) },
1948 { HID_USB_DEVICE(USB_VENDOR_ID_SUNPLUS, USB_DEVICE_ID_SUNPLUS_WDESKTOP) },
1949 { HID_USB_DEVICE(USB_VENDOR_ID_THINGM, USB_DEVICE_ID_BLINK1) },
1950 { HID_USB_DEVICE(USB_VENDOR_ID_THRUSTMASTER, 0xb300) },
1951 { HID_USB_DEVICE(USB_VENDOR_ID_THRUSTMASTER, 0xb304) },
1952 { HID_USB_DEVICE(USB_VENDOR_ID_THRUSTMASTER, 0xb323) },
1953 { HID_USB_DEVICE(USB_VENDOR_ID_THRUSTMASTER, 0xb324) },
1954 { HID_USB_DEVICE(USB_VENDOR_ID_THRUSTMASTER, 0xb651) },
1955 { HID_USB_DEVICE(USB_VENDOR_ID_THRUSTMASTER, 0xb653) },
1956 { HID_USB_DEVICE(USB_VENDOR_ID_THRUSTMASTER, 0xb654) },
1957 { HID_USB_DEVICE(USB_VENDOR_ID_THRUSTMASTER, 0xb65a) },
1958 { HID_BLUETOOTH_DEVICE(USB_VENDOR_ID_TIVO, USB_DEVICE_ID_TIVO_SLIDE_BT) },
1959 { HID_USB_DEVICE(USB_VENDOR_ID_TIVO, USB_DEVICE_ID_TIVO_SLIDE) },
1960 { HID_USB_DEVICE(USB_VENDOR_ID_TOPSEED, USB_DEVICE_ID_TOPSEED_CYBERLINK) },
1961 { HID_USB_DEVICE(USB_VENDOR_ID_TOPSEED2, USB_DEVICE_ID_TOPSEED2_RF_COMBO) },
1962 { HID_USB_DEVICE(USB_VENDOR_ID_TWINHAN, USB_DEVICE_ID_TWINHAN_IR_REMOTE) },
1963 { HID_USB_DEVICE(USB_VENDOR_ID_UCLOGIC, USB_DEVICE_ID_UCLOGIC_TABLET_PF1209) },
1964 { HID_USB_DEVICE(USB_VENDOR_ID_UCLOGIC, USB_DEVICE_ID_UCLOGIC_TABLET_WP4030U) },
1965 { HID_USB_DEVICE(USB_VENDOR_ID_UCLOGIC, USB_DEVICE_ID_UCLOGIC_TABLET_WP5540U) },
1966 { HID_USB_DEVICE(USB_VENDOR_ID_UCLOGIC, USB_DEVICE_ID_UCLOGIC_TABLET_WP8060U) },
1967 { HID_USB_DEVICE(USB_VENDOR_ID_UCLOGIC, USB_DEVICE_ID_UCLOGIC_TABLET_WP1062) },
1968 { HID_USB_DEVICE(USB_VENDOR_ID_UCLOGIC, USB_DEVICE_ID_UCLOGIC_WIRELESS_TABLET_TWHL850) },
1969 { HID_USB_DEVICE(USB_VENDOR_ID_UCLOGIC, USB_DEVICE_ID_UCLOGIC_TABLET_TWHA60) },
1970 { HID_USB_DEVICE(USB_VENDOR_ID_WISEGROUP, USB_DEVICE_ID_SMARTJOY_PLUS) },
1971 { HID_USB_DEVICE(USB_VENDOR_ID_WISEGROUP, USB_DEVICE_ID_SUPER_JOY_BOX_3) },
1972 { HID_USB_DEVICE(USB_VENDOR_ID_WISEGROUP, USB_DEVICE_ID_DUAL_USB_JOYPAD) },
1973 { HID_USB_DEVICE(USB_VENDOR_ID_WISEGROUP_LTD, USB_DEVICE_ID_SUPER_JOY_BOX_3_PRO) },
1974 { HID_USB_DEVICE(USB_VENDOR_ID_WISEGROUP_LTD, USB_DEVICE_ID_SUPER_DUAL_BOX_PRO) },
1975 { HID_USB_DEVICE(USB_VENDOR_ID_WISEGROUP_LTD, USB_DEVICE_ID_SUPER_JOY_BOX_5_PRO) },
1976 { HID_USB_DEVICE(USB_VENDOR_ID_WALTOP, USB_DEVICE_ID_WALTOP_SLIM_TABLET_5_8_INCH) },
1977 { HID_USB_DEVICE(USB_VENDOR_ID_WALTOP, USB_DEVICE_ID_WALTOP_SLIM_TABLET_12_1_INCH) },
1978 { HID_USB_DEVICE(USB_VENDOR_ID_WALTOP, USB_DEVICE_ID_WALTOP_Q_PAD) },
1979 { HID_USB_DEVICE(USB_VENDOR_ID_WALTOP, USB_DEVICE_ID_WALTOP_PID_0038) },
1980 { HID_USB_DEVICE(USB_VENDOR_ID_WALTOP, USB_DEVICE_ID_WALTOP_MEDIA_TABLET_10_6_INCH) },
1981 { HID_USB_DEVICE(USB_VENDOR_ID_WALTOP, USB_DEVICE_ID_WALTOP_MEDIA_TABLET_14_1_INCH) },
1982 { HID_USB_DEVICE(USB_VENDOR_ID_WALTOP, USB_DEVICE_ID_WALTOP_SIRIUS_BATTERY_FREE_TABLET) },
1983 { HID_USB_DEVICE(USB_VENDOR_ID_X_TENSIONS, USB_DEVICE_ID_SPEEDLINK_VAD_CEZANNE) },
1984 { HID_USB_DEVICE(USB_VENDOR_ID_XIN_MO, USB_DEVICE_ID_XIN_MO_DUAL_ARCADE) },
1985 { HID_USB_DEVICE(USB_VENDOR_ID_ZEROPLUS, 0x0005) },
1986 { HID_USB_DEVICE(USB_VENDOR_ID_ZEROPLUS, 0x0030) },
1987 { HID_USB_DEVICE(USB_VENDOR_ID_ZYDACRON, USB_DEVICE_ID_ZYDACRON_REMOTE_CONTROL) },
1989 { HID_BLUETOOTH_DEVICE(USB_VENDOR_ID_MICROSOFT, USB_DEVICE_ID_MS_PRESENTER_8K_BT) },
1990 { HID_BLUETOOTH_DEVICE(USB_VENDOR_ID_NINTENDO, USB_DEVICE_ID_NINTENDO_WIIMOTE) },
1991 { HID_BLUETOOTH_DEVICE(USB_VENDOR_ID_NINTENDO, USB_DEVICE_ID_NINTENDO_WIIMOTE2) },
1992 { HID_USB_DEVICE(USB_VENDOR_ID_RAZER, USB_DEVICE_ID_RAZER_BLADE_14) },
1996 struct hid_dynid {
1997 struct list_head list;
1998 struct hid_device_id id;
2002 * store_new_id - add a new HID device ID to this driver and re-probe devices
2003 * @driver: target device driver
2004 * @buf: buffer for scanning device ID data
2005 * @count: input size
2007 * Adds a new dynamic hid device ID to this driver,
2008 * and causes the driver to probe for all devices again.
2010 static ssize_t store_new_id(struct device_driver *drv, const char *buf,
2011 size_t count)
2013 struct hid_driver *hdrv = container_of(drv, struct hid_driver, driver);
2014 struct hid_dynid *dynid;
2015 __u32 bus, vendor, product;
2016 unsigned long driver_data = 0;
2017 int ret;
2019 ret = sscanf(buf, "%x %x %x %lx",
2020 &bus, &vendor, &product, &driver_data);
2021 if (ret < 3)
2022 return -EINVAL;
2024 dynid = kzalloc(sizeof(*dynid), GFP_KERNEL);
2025 if (!dynid)
2026 return -ENOMEM;
2028 dynid->id.bus = bus;
2029 dynid->id.group = HID_GROUP_ANY;
2030 dynid->id.vendor = vendor;
2031 dynid->id.product = product;
2032 dynid->id.driver_data = driver_data;
2034 spin_lock(&hdrv->dyn_lock);
2035 list_add_tail(&dynid->list, &hdrv->dyn_list);
2036 spin_unlock(&hdrv->dyn_lock);
2038 ret = driver_attach(&hdrv->driver);
2040 return ret ? : count;
2042 static DRIVER_ATTR(new_id, S_IWUSR, NULL, store_new_id);
2044 static void hid_free_dynids(struct hid_driver *hdrv)
2046 struct hid_dynid *dynid, *n;
2048 spin_lock(&hdrv->dyn_lock);
2049 list_for_each_entry_safe(dynid, n, &hdrv->dyn_list, list) {
2050 list_del(&dynid->list);
2051 kfree(dynid);
2053 spin_unlock(&hdrv->dyn_lock);
2056 static const struct hid_device_id *hid_match_device(struct hid_device *hdev,
2057 struct hid_driver *hdrv)
2059 struct hid_dynid *dynid;
2061 spin_lock(&hdrv->dyn_lock);
2062 list_for_each_entry(dynid, &hdrv->dyn_list, list) {
2063 if (hid_match_one_id(hdev, &dynid->id)) {
2064 spin_unlock(&hdrv->dyn_lock);
2065 return &dynid->id;
2068 spin_unlock(&hdrv->dyn_lock);
2070 return hid_match_id(hdev, hdrv->id_table);
2073 static int hid_bus_match(struct device *dev, struct device_driver *drv)
2075 struct hid_driver *hdrv = container_of(drv, struct hid_driver, driver);
2076 struct hid_device *hdev = container_of(dev, struct hid_device, dev);
2078 return hid_match_device(hdev, hdrv) != NULL;
2081 static int hid_device_probe(struct device *dev)
2083 struct hid_driver *hdrv = container_of(dev->driver,
2084 struct hid_driver, driver);
2085 struct hid_device *hdev = container_of(dev, struct hid_device, dev);
2086 const struct hid_device_id *id;
2087 int ret = 0;
2089 if (down_interruptible(&hdev->driver_lock))
2090 return -EINTR;
2091 if (down_interruptible(&hdev->driver_input_lock)) {
2092 ret = -EINTR;
2093 goto unlock_driver_lock;
2095 hdev->io_started = false;
2097 if (!hdev->driver) {
2098 id = hid_match_device(hdev, hdrv);
2099 if (id == NULL) {
2100 ret = -ENODEV;
2101 goto unlock;
2104 hdev->driver = hdrv;
2105 if (hdrv->probe) {
2106 ret = hdrv->probe(hdev, id);
2107 } else { /* default probe */
2108 ret = hid_open_report(hdev);
2109 if (!ret)
2110 ret = hid_hw_start(hdev, HID_CONNECT_DEFAULT);
2112 if (ret) {
2113 hid_close_report(hdev);
2114 hdev->driver = NULL;
2117 unlock:
2118 if (!hdev->io_started)
2119 up(&hdev->driver_input_lock);
2120 unlock_driver_lock:
2121 up(&hdev->driver_lock);
2122 return ret;
2125 static int hid_device_remove(struct device *dev)
2127 struct hid_device *hdev = container_of(dev, struct hid_device, dev);
2128 struct hid_driver *hdrv;
2129 int ret = 0;
2131 if (down_interruptible(&hdev->driver_lock))
2132 return -EINTR;
2133 if (down_interruptible(&hdev->driver_input_lock)) {
2134 ret = -EINTR;
2135 goto unlock_driver_lock;
2137 hdev->io_started = false;
2139 hdrv = hdev->driver;
2140 if (hdrv) {
2141 if (hdrv->remove)
2142 hdrv->remove(hdev);
2143 else /* default remove */
2144 hid_hw_stop(hdev);
2145 hid_close_report(hdev);
2146 hdev->driver = NULL;
2149 if (!hdev->io_started)
2150 up(&hdev->driver_input_lock);
2151 unlock_driver_lock:
2152 up(&hdev->driver_lock);
2153 return ret;
2156 static ssize_t modalias_show(struct device *dev, struct device_attribute *a,
2157 char *buf)
2159 struct hid_device *hdev = container_of(dev, struct hid_device, dev);
2160 int len;
2162 len = snprintf(buf, PAGE_SIZE, "hid:b%04Xg%04Xv%08Xp%08X\n",
2163 hdev->bus, hdev->group, hdev->vendor, hdev->product);
2165 return (len >= PAGE_SIZE) ? (PAGE_SIZE - 1) : len;
2167 static DEVICE_ATTR_RO(modalias);
2169 static struct attribute *hid_dev_attrs[] = {
2170 &dev_attr_modalias.attr,
2171 NULL,
2173 ATTRIBUTE_GROUPS(hid_dev);
2175 static int hid_uevent(struct device *dev, struct kobj_uevent_env *env)
2177 struct hid_device *hdev = container_of(dev, struct hid_device, dev);
2179 if (add_uevent_var(env, "HID_ID=%04X:%08X:%08X",
2180 hdev->bus, hdev->vendor, hdev->product))
2181 return -ENOMEM;
2183 if (add_uevent_var(env, "HID_NAME=%s", hdev->name))
2184 return -ENOMEM;
2186 if (add_uevent_var(env, "HID_PHYS=%s", hdev->phys))
2187 return -ENOMEM;
2189 if (add_uevent_var(env, "HID_UNIQ=%s", hdev->uniq))
2190 return -ENOMEM;
2192 if (add_uevent_var(env, "MODALIAS=hid:b%04Xg%04Xv%08Xp%08X",
2193 hdev->bus, hdev->group, hdev->vendor, hdev->product))
2194 return -ENOMEM;
2196 return 0;
2199 static struct bus_type hid_bus_type = {
2200 .name = "hid",
2201 .dev_groups = hid_dev_groups,
2202 .match = hid_bus_match,
2203 .probe = hid_device_probe,
2204 .remove = hid_device_remove,
2205 .uevent = hid_uevent,
2208 /* a list of devices that shouldn't be handled by HID core at all */
2209 static const struct hid_device_id hid_ignore_list[] = {
2210 { HID_USB_DEVICE(USB_VENDOR_ID_ACECAD, USB_DEVICE_ID_ACECAD_FLAIR) },
2211 { HID_USB_DEVICE(USB_VENDOR_ID_ACECAD, USB_DEVICE_ID_ACECAD_302) },
2212 { HID_USB_DEVICE(USB_VENDOR_ID_ADS_TECH, USB_DEVICE_ID_ADS_TECH_RADIO_SI470X) },
2213 { HID_USB_DEVICE(USB_VENDOR_ID_AIPTEK, USB_DEVICE_ID_AIPTEK_01) },
2214 { HID_USB_DEVICE(USB_VENDOR_ID_AIPTEK, USB_DEVICE_ID_AIPTEK_10) },
2215 { HID_USB_DEVICE(USB_VENDOR_ID_AIPTEK, USB_DEVICE_ID_AIPTEK_20) },
2216 { HID_USB_DEVICE(USB_VENDOR_ID_AIPTEK, USB_DEVICE_ID_AIPTEK_21) },
2217 { HID_USB_DEVICE(USB_VENDOR_ID_AIPTEK, USB_DEVICE_ID_AIPTEK_22) },
2218 { HID_USB_DEVICE(USB_VENDOR_ID_AIPTEK, USB_DEVICE_ID_AIPTEK_23) },
2219 { HID_USB_DEVICE(USB_VENDOR_ID_AIPTEK, USB_DEVICE_ID_AIPTEK_24) },
2220 { HID_USB_DEVICE(USB_VENDOR_ID_AIRCABLE, USB_DEVICE_ID_AIRCABLE1) },
2221 { HID_USB_DEVICE(USB_VENDOR_ID_ALCOR, USB_DEVICE_ID_ALCOR_USBRS232) },
2222 { HID_USB_DEVICE(USB_VENDOR_ID_ASUSTEK, USB_DEVICE_ID_ASUSTEK_LCM)},
2223 { HID_USB_DEVICE(USB_VENDOR_ID_ASUSTEK, USB_DEVICE_ID_ASUSTEK_LCM2)},
2224 { HID_USB_DEVICE(USB_VENDOR_ID_AVERMEDIA, USB_DEVICE_ID_AVER_FM_MR800) },
2225 { HID_USB_DEVICE(USB_VENDOR_ID_AXENTIA, USB_DEVICE_ID_AXENTIA_FM_RADIO) },
2226 { HID_USB_DEVICE(USB_VENDOR_ID_BERKSHIRE, USB_DEVICE_ID_BERKSHIRE_PCWD) },
2227 { HID_USB_DEVICE(USB_VENDOR_ID_CIDC, 0x0103) },
2228 { HID_USB_DEVICE(USB_VENDOR_ID_CYGNAL, USB_DEVICE_ID_CYGNAL_RADIO_SI470X) },
2229 { HID_USB_DEVICE(USB_VENDOR_ID_CYGNAL, USB_DEVICE_ID_CYGNAL_RADIO_SI4713) },
2230 { HID_USB_DEVICE(USB_VENDOR_ID_CMEDIA, USB_DEVICE_ID_CM109) },
2231 { HID_USB_DEVICE(USB_VENDOR_ID_CYPRESS, USB_DEVICE_ID_CYPRESS_HIDCOM) },
2232 { HID_USB_DEVICE(USB_VENDOR_ID_CYPRESS, USB_DEVICE_ID_CYPRESS_ULTRAMOUSE) },
2233 { HID_USB_DEVICE(USB_VENDOR_ID_DEALEXTREAME, USB_DEVICE_ID_DEALEXTREAME_RADIO_SI4701) },
2234 { HID_USB_DEVICE(USB_VENDOR_ID_DELORME, USB_DEVICE_ID_DELORME_EARTHMATE) },
2235 { HID_USB_DEVICE(USB_VENDOR_ID_DELORME, USB_DEVICE_ID_DELORME_EM_LT20) },
2236 { HID_USB_DEVICE(USB_VENDOR_ID_DREAM_CHEEKY, 0x0004) },
2237 { HID_USB_DEVICE(USB_VENDOR_ID_DREAM_CHEEKY, 0x000a) },
2238 { HID_USB_DEVICE(USB_VENDOR_ID_ESSENTIAL_REALITY, USB_DEVICE_ID_ESSENTIAL_REALITY_P5) },
2239 { HID_USB_DEVICE(USB_VENDOR_ID_ETT, USB_DEVICE_ID_TC5UH) },
2240 { HID_USB_DEVICE(USB_VENDOR_ID_ETT, USB_DEVICE_ID_TC4UM) },
2241 { HID_USB_DEVICE(USB_VENDOR_ID_GENERAL_TOUCH, 0x0001) },
2242 { HID_USB_DEVICE(USB_VENDOR_ID_GENERAL_TOUCH, 0x0002) },
2243 { HID_USB_DEVICE(USB_VENDOR_ID_GENERAL_TOUCH, 0x0004) },
2244 { HID_USB_DEVICE(USB_VENDOR_ID_GLAB, USB_DEVICE_ID_4_PHIDGETSERVO_30) },
2245 { HID_USB_DEVICE(USB_VENDOR_ID_GLAB, USB_DEVICE_ID_1_PHIDGETSERVO_30) },
2246 { HID_USB_DEVICE(USB_VENDOR_ID_GLAB, USB_DEVICE_ID_0_0_4_IF_KIT) },
2247 { HID_USB_DEVICE(USB_VENDOR_ID_GLAB, USB_DEVICE_ID_0_16_16_IF_KIT) },
2248 { HID_USB_DEVICE(USB_VENDOR_ID_GLAB, USB_DEVICE_ID_8_8_8_IF_KIT) },
2249 { HID_USB_DEVICE(USB_VENDOR_ID_GLAB, USB_DEVICE_ID_0_8_7_IF_KIT) },
2250 { HID_USB_DEVICE(USB_VENDOR_ID_GLAB, USB_DEVICE_ID_0_8_8_IF_KIT) },
2251 { HID_USB_DEVICE(USB_VENDOR_ID_GLAB, USB_DEVICE_ID_PHIDGET_MOTORCONTROL) },
2252 { HID_USB_DEVICE(USB_VENDOR_ID_GOTOP, USB_DEVICE_ID_SUPER_Q2) },
2253 { HID_USB_DEVICE(USB_VENDOR_ID_GOTOP, USB_DEVICE_ID_GOGOPEN) },
2254 { HID_USB_DEVICE(USB_VENDOR_ID_GOTOP, USB_DEVICE_ID_PENPOWER) },
2255 { HID_USB_DEVICE(USB_VENDOR_ID_GRETAGMACBETH, USB_DEVICE_ID_GRETAGMACBETH_HUEY) },
2256 { HID_USB_DEVICE(USB_VENDOR_ID_GRIFFIN, USB_DEVICE_ID_POWERMATE) },
2257 { HID_USB_DEVICE(USB_VENDOR_ID_GRIFFIN, USB_DEVICE_ID_SOUNDKNOB) },
2258 { HID_USB_DEVICE(USB_VENDOR_ID_GRIFFIN, USB_DEVICE_ID_RADIOSHARK) },
2259 { HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_90) },
2260 { HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_100) },
2261 { HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_101) },
2262 { HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_103) },
2263 { HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_104) },
2264 { HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_105) },
2265 { HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_106) },
2266 { HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_107) },
2267 { HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_108) },
2268 { HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_200) },
2269 { HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_201) },
2270 { HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_202) },
2271 { HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_203) },
2272 { HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_204) },
2273 { HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_205) },
2274 { HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_206) },
2275 { HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_207) },
2276 { HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_300) },
2277 { HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_301) },
2278 { HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_302) },
2279 { HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_303) },
2280 { HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_304) },
2281 { HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_305) },
2282 { HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_306) },
2283 { HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_307) },
2284 { HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_308) },
2285 { HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_309) },
2286 { HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_400) },
2287 { HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_401) },
2288 { HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_402) },
2289 { HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_403) },
2290 { HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_404) },
2291 { HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_405) },
2292 { HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_500) },
2293 { HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_501) },
2294 { HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_502) },
2295 { HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_503) },
2296 { HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_504) },
2297 { HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_1000) },
2298 { HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_1001) },
2299 { HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_1002) },
2300 { HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_1003) },
2301 { HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_1004) },
2302 { HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_1005) },
2303 { HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_1006) },
2304 { HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_1007) },
2305 { HID_USB_DEVICE(USB_VENDOR_ID_IMATION, USB_DEVICE_ID_DISC_STAKKA) },
2306 { HID_USB_DEVICE(USB_VENDOR_ID_JABRA, USB_DEVICE_ID_JABRA_SPEAK_410) },
2307 { HID_USB_DEVICE(USB_VENDOR_ID_JABRA, USB_DEVICE_ID_JABRA_SPEAK_510) },
2308 { HID_USB_DEVICE(USB_VENDOR_ID_JABRA, USB_DEVICE_ID_JABRA_GN9350E) },
2309 { HID_USB_DEVICE(USB_VENDOR_ID_KBGEAR, USB_DEVICE_ID_KBGEAR_JAMSTUDIO) },
2310 { HID_USB_DEVICE(USB_VENDOR_ID_KWORLD, USB_DEVICE_ID_KWORLD_RADIO_FM700) },
2311 { HID_USB_DEVICE(USB_VENDOR_ID_KYE, USB_DEVICE_ID_KYE_GPEN_560) },
2312 { HID_BLUETOOTH_DEVICE(USB_VENDOR_ID_KYE, 0x0058) },
2313 { HID_USB_DEVICE(USB_VENDOR_ID_LD, USB_DEVICE_ID_LD_CASSY) },
2314 { HID_USB_DEVICE(USB_VENDOR_ID_LD, USB_DEVICE_ID_LD_CASSY2) },
2315 { HID_USB_DEVICE(USB_VENDOR_ID_LD, USB_DEVICE_ID_LD_POCKETCASSY) },
2316 { HID_USB_DEVICE(USB_VENDOR_ID_LD, USB_DEVICE_ID_LD_POCKETCASSY2) },
2317 { HID_USB_DEVICE(USB_VENDOR_ID_LD, USB_DEVICE_ID_LD_MOBILECASSY) },
2318 { HID_USB_DEVICE(USB_VENDOR_ID_LD, USB_DEVICE_ID_LD_MOBILECASSY2) },
2319 { HID_USB_DEVICE(USB_VENDOR_ID_LD, USB_DEVICE_ID_LD_MICROCASSYVOLTAGE) },
2320 { HID_USB_DEVICE(USB_VENDOR_ID_LD, USB_DEVICE_ID_LD_MICROCASSYCURRENT) },
2321 { HID_USB_DEVICE(USB_VENDOR_ID_LD, USB_DEVICE_ID_LD_MICROCASSYTIME) },
2322 { HID_USB_DEVICE(USB_VENDOR_ID_LD, USB_DEVICE_ID_LD_MICROCASSYTEMPERATURE) },
2323 { HID_USB_DEVICE(USB_VENDOR_ID_LD, USB_DEVICE_ID_LD_MICROCASSYPH) },
2324 { HID_USB_DEVICE(USB_VENDOR_ID_LD, USB_DEVICE_ID_LD_JWM) },
2325 { HID_USB_DEVICE(USB_VENDOR_ID_LD, USB_DEVICE_ID_LD_DMMP) },
2326 { HID_USB_DEVICE(USB_VENDOR_ID_LD, USB_DEVICE_ID_LD_UMIP) },
2327 { HID_USB_DEVICE(USB_VENDOR_ID_LD, USB_DEVICE_ID_LD_UMIC) },
2328 { HID_USB_DEVICE(USB_VENDOR_ID_LD, USB_DEVICE_ID_LD_UMIB) },
2329 { HID_USB_DEVICE(USB_VENDOR_ID_LD, USB_DEVICE_ID_LD_XRAY) },
2330 { HID_USB_DEVICE(USB_VENDOR_ID_LD, USB_DEVICE_ID_LD_XRAY2) },
2331 { HID_USB_DEVICE(USB_VENDOR_ID_LD, USB_DEVICE_ID_LD_VIDEOCOM) },
2332 { HID_USB_DEVICE(USB_VENDOR_ID_LD, USB_DEVICE_ID_LD_MOTOR) },
2333 { HID_USB_DEVICE(USB_VENDOR_ID_LD, USB_DEVICE_ID_LD_COM3LAB) },
2334 { HID_USB_DEVICE(USB_VENDOR_ID_LD, USB_DEVICE_ID_LD_TELEPORT) },
2335 { HID_USB_DEVICE(USB_VENDOR_ID_LD, USB_DEVICE_ID_LD_NETWORKANALYSER) },
2336 { HID_USB_DEVICE(USB_VENDOR_ID_LD, USB_DEVICE_ID_LD_POWERCONTROL) },
2337 { HID_USB_DEVICE(USB_VENDOR_ID_LD, USB_DEVICE_ID_LD_MACHINETEST) },
2338 { HID_USB_DEVICE(USB_VENDOR_ID_LD, USB_DEVICE_ID_LD_MOSTANALYSER) },
2339 { HID_USB_DEVICE(USB_VENDOR_ID_LD, USB_DEVICE_ID_LD_MOSTANALYSER2) },
2340 { HID_USB_DEVICE(USB_VENDOR_ID_LD, USB_DEVICE_ID_LD_ABSESP) },
2341 { HID_USB_DEVICE(USB_VENDOR_ID_LD, USB_DEVICE_ID_LD_AUTODATABUS) },
2342 { HID_USB_DEVICE(USB_VENDOR_ID_LD, USB_DEVICE_ID_LD_MCT) },
2343 { HID_USB_DEVICE(USB_VENDOR_ID_LD, USB_DEVICE_ID_LD_HYBRID) },
2344 { HID_USB_DEVICE(USB_VENDOR_ID_LD, USB_DEVICE_ID_LD_HEATCONTROL) },
2345 { HID_USB_DEVICE(USB_VENDOR_ID_MADCATZ, USB_DEVICE_ID_MADCATZ_BEATPAD) },
2346 { HID_USB_DEVICE(USB_VENDOR_ID_MCC, USB_DEVICE_ID_MCC_PMD1024LS) },
2347 { HID_USB_DEVICE(USB_VENDOR_ID_MCC, USB_DEVICE_ID_MCC_PMD1208LS) },
2348 { HID_USB_DEVICE(USB_VENDOR_ID_MICROCHIP, USB_DEVICE_ID_PICKIT1) },
2349 { HID_USB_DEVICE(USB_VENDOR_ID_MICROCHIP, USB_DEVICE_ID_PICKIT2) },
2350 { HID_USB_DEVICE(USB_VENDOR_ID_MICROCHIP, USB_DEVICE_ID_PICK16F1454) },
2351 { HID_USB_DEVICE(USB_VENDOR_ID_NATIONAL_SEMICONDUCTOR, USB_DEVICE_ID_N_S_HARMONY) },
2352 { HID_USB_DEVICE(USB_VENDOR_ID_ONTRAK, USB_DEVICE_ID_ONTRAK_ADU100) },
2353 { HID_USB_DEVICE(USB_VENDOR_ID_ONTRAK, USB_DEVICE_ID_ONTRAK_ADU100 + 20) },
2354 { HID_USB_DEVICE(USB_VENDOR_ID_ONTRAK, USB_DEVICE_ID_ONTRAK_ADU100 + 30) },
2355 { HID_USB_DEVICE(USB_VENDOR_ID_ONTRAK, USB_DEVICE_ID_ONTRAK_ADU100 + 100) },
2356 { HID_USB_DEVICE(USB_VENDOR_ID_ONTRAK, USB_DEVICE_ID_ONTRAK_ADU100 + 108) },
2357 { HID_USB_DEVICE(USB_VENDOR_ID_ONTRAK, USB_DEVICE_ID_ONTRAK_ADU100 + 118) },
2358 { HID_USB_DEVICE(USB_VENDOR_ID_ONTRAK, USB_DEVICE_ID_ONTRAK_ADU100 + 200) },
2359 { HID_USB_DEVICE(USB_VENDOR_ID_ONTRAK, USB_DEVICE_ID_ONTRAK_ADU100 + 300) },
2360 { HID_USB_DEVICE(USB_VENDOR_ID_ONTRAK, USB_DEVICE_ID_ONTRAK_ADU100 + 400) },
2361 { HID_USB_DEVICE(USB_VENDOR_ID_ONTRAK, USB_DEVICE_ID_ONTRAK_ADU100 + 500) },
2362 { HID_USB_DEVICE(USB_VENDOR_ID_PANJIT, 0x0001) },
2363 { HID_USB_DEVICE(USB_VENDOR_ID_PANJIT, 0x0002) },
2364 { HID_USB_DEVICE(USB_VENDOR_ID_PANJIT, 0x0003) },
2365 { HID_USB_DEVICE(USB_VENDOR_ID_PANJIT, 0x0004) },
2366 { HID_USB_DEVICE(USB_VENDOR_ID_PHILIPS, USB_DEVICE_ID_PHILIPS_IEEE802154_DONGLE) },
2367 { HID_USB_DEVICE(USB_VENDOR_ID_POWERCOM, USB_DEVICE_ID_POWERCOM_UPS) },
2368 #if defined(CONFIG_MOUSE_SYNAPTICS_USB) || defined(CONFIG_MOUSE_SYNAPTICS_USB_MODULE)
2369 { HID_USB_DEVICE(USB_VENDOR_ID_SYNAPTICS, USB_DEVICE_ID_SYNAPTICS_TP) },
2370 { HID_USB_DEVICE(USB_VENDOR_ID_SYNAPTICS, USB_DEVICE_ID_SYNAPTICS_INT_TP) },
2371 { HID_USB_DEVICE(USB_VENDOR_ID_SYNAPTICS, USB_DEVICE_ID_SYNAPTICS_CPAD) },
2372 { HID_USB_DEVICE(USB_VENDOR_ID_SYNAPTICS, USB_DEVICE_ID_SYNAPTICS_STICK) },
2373 { HID_USB_DEVICE(USB_VENDOR_ID_SYNAPTICS, USB_DEVICE_ID_SYNAPTICS_WP) },
2374 { HID_USB_DEVICE(USB_VENDOR_ID_SYNAPTICS, USB_DEVICE_ID_SYNAPTICS_COMP_TP) },
2375 { HID_USB_DEVICE(USB_VENDOR_ID_SYNAPTICS, USB_DEVICE_ID_SYNAPTICS_WTP) },
2376 { HID_USB_DEVICE(USB_VENDOR_ID_SYNAPTICS, USB_DEVICE_ID_SYNAPTICS_DPAD) },
2377 #endif
2378 { HID_USB_DEVICE(USB_VENDOR_ID_VERNIER, USB_DEVICE_ID_VERNIER_LABPRO) },
2379 { HID_USB_DEVICE(USB_VENDOR_ID_VERNIER, USB_DEVICE_ID_VERNIER_GOTEMP) },
2380 { HID_USB_DEVICE(USB_VENDOR_ID_VERNIER, USB_DEVICE_ID_VERNIER_SKIP) },
2381 { HID_USB_DEVICE(USB_VENDOR_ID_VERNIER, USB_DEVICE_ID_VERNIER_CYCLOPS) },
2382 { HID_USB_DEVICE(USB_VENDOR_ID_VERNIER, USB_DEVICE_ID_VERNIER_LCSPEC) },
2383 { HID_USB_DEVICE(USB_VENDOR_ID_WISEGROUP, USB_DEVICE_ID_4_PHIDGETSERVO_20) },
2384 { HID_USB_DEVICE(USB_VENDOR_ID_WISEGROUP, USB_DEVICE_ID_1_PHIDGETSERVO_20) },
2385 { HID_USB_DEVICE(USB_VENDOR_ID_WISEGROUP, USB_DEVICE_ID_8_8_4_IF_KIT) },
2386 { HID_USB_DEVICE(USB_VENDOR_ID_YEALINK, USB_DEVICE_ID_YEALINK_P1K_P4K_B2K) },
2387 { HID_USB_DEVICE(USB_VENDOR_ID_RISO_KAGAKU, USB_DEVICE_ID_RI_KA_WEBMAIL) },
2392 * hid_mouse_ignore_list - mouse devices which should not be handled by the hid layer
2394 * There are composite devices for which we want to ignore only a certain
2395 * interface. This is a list of devices for which only the mouse interface will
2396 * be ignored. This allows a dedicated driver to take care of the interface.
2398 static const struct hid_device_id hid_mouse_ignore_list[] = {
2399 /* appletouch driver */
2400 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_FOUNTAIN_ANSI) },
2401 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_FOUNTAIN_ISO) },
2402 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_GEYSER_ANSI) },
2403 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_GEYSER_ISO) },
2404 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_GEYSER_JIS) },
2405 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_GEYSER3_ANSI) },
2406 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_GEYSER3_ISO) },
2407 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_GEYSER3_JIS) },
2408 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_GEYSER4_ANSI) },
2409 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_GEYSER4_ISO) },
2410 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_GEYSER4_JIS) },
2411 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_GEYSER4_HF_ANSI) },
2412 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_GEYSER4_HF_ISO) },
2413 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_GEYSER4_HF_JIS) },
2414 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING_ANSI) },
2415 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING_ISO) },
2416 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING_JIS) },
2417 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING2_ANSI) },
2418 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING2_ISO) },
2419 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING2_JIS) },
2420 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING3_ANSI) },
2421 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING3_ISO) },
2422 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING3_JIS) },
2423 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING4_ANSI) },
2424 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING4_ISO) },
2425 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING4_JIS) },
2426 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING4A_ANSI) },
2427 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING4A_ISO) },
2428 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING4A_JIS) },
2429 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING5_ANSI) },
2430 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING5_ISO) },
2431 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING5_JIS) },
2432 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING5A_ANSI) },
2433 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING5A_ISO) },
2434 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING5A_JIS) },
2435 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING6_ANSI) },
2436 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING6_ISO) },
2437 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING6_JIS) },
2438 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING6A_ANSI) },
2439 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING6A_ISO) },
2440 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING6A_JIS) },
2441 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING7_ANSI) },
2442 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING7_ISO) },
2443 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING7_JIS) },
2444 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING7A_ANSI) },
2445 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING7A_ISO) },
2446 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING7A_JIS) },
2447 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING8_ANSI) },
2448 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING8_ISO) },
2449 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING8_JIS) },
2450 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_FOUNTAIN_TP_ONLY) },
2451 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_GEYSER1_TP_ONLY) },
2455 bool hid_ignore(struct hid_device *hdev)
2457 if (hdev->quirks & HID_QUIRK_NO_IGNORE)
2458 return false;
2459 if (hdev->quirks & HID_QUIRK_IGNORE)
2460 return true;
2462 switch (hdev->vendor) {
2463 case USB_VENDOR_ID_CODEMERCS:
2464 /* ignore all Code Mercenaries IOWarrior devices */
2465 if (hdev->product >= USB_DEVICE_ID_CODEMERCS_IOW_FIRST &&
2466 hdev->product <= USB_DEVICE_ID_CODEMERCS_IOW_LAST)
2467 return true;
2468 break;
2469 case USB_VENDOR_ID_LOGITECH:
2470 if (hdev->product >= USB_DEVICE_ID_LOGITECH_HARMONY_FIRST &&
2471 hdev->product <= USB_DEVICE_ID_LOGITECH_HARMONY_LAST)
2472 return true;
2474 * The Keene FM transmitter USB device has the same USB ID as
2475 * the Logitech AudioHub Speaker, but it should ignore the hid.
2476 * Check if the name is that of the Keene device.
2477 * For reference: the name of the AudioHub is
2478 * "HOLTEK AudioHub Speaker".
2480 if (hdev->product == USB_DEVICE_ID_LOGITECH_AUDIOHUB &&
2481 !strcmp(hdev->name, "HOLTEK B-LINK USB Audio "))
2482 return true;
2483 break;
2484 case USB_VENDOR_ID_SOUNDGRAPH:
2485 if (hdev->product >= USB_DEVICE_ID_SOUNDGRAPH_IMON_FIRST &&
2486 hdev->product <= USB_DEVICE_ID_SOUNDGRAPH_IMON_LAST)
2487 return true;
2488 break;
2489 case USB_VENDOR_ID_HANWANG:
2490 if (hdev->product >= USB_DEVICE_ID_HANWANG_TABLET_FIRST &&
2491 hdev->product <= USB_DEVICE_ID_HANWANG_TABLET_LAST)
2492 return true;
2493 break;
2494 case USB_VENDOR_ID_JESS:
2495 if (hdev->product == USB_DEVICE_ID_JESS_YUREX &&
2496 hdev->type == HID_TYPE_USBNONE)
2497 return true;
2498 break;
2499 case USB_VENDOR_ID_VELLEMAN:
2500 /* These are not HID devices. They are handled by comedi. */
2501 if ((hdev->product >= USB_DEVICE_ID_VELLEMAN_K8055_FIRST &&
2502 hdev->product <= USB_DEVICE_ID_VELLEMAN_K8055_LAST) ||
2503 (hdev->product >= USB_DEVICE_ID_VELLEMAN_K8061_FIRST &&
2504 hdev->product <= USB_DEVICE_ID_VELLEMAN_K8061_LAST))
2505 return true;
2506 break;
2507 case USB_VENDOR_ID_ATMEL_V_USB:
2508 /* Masterkit MA901 usb radio based on Atmel tiny85 chip and
2509 * it has the same USB ID as many Atmel V-USB devices. This
2510 * usb radio is handled by radio-ma901.c driver so we want
2511 * ignore the hid. Check the name, bus, product and ignore
2512 * if we have MA901 usb radio.
2514 if (hdev->product == USB_DEVICE_ID_ATMEL_V_USB &&
2515 hdev->bus == BUS_USB &&
2516 strncmp(hdev->name, "www.masterkit.ru MA901", 22) == 0)
2517 return true;
2518 break;
2521 if (hdev->type == HID_TYPE_USBMOUSE &&
2522 hid_match_id(hdev, hid_mouse_ignore_list))
2523 return true;
2525 return !!hid_match_id(hdev, hid_ignore_list);
2527 EXPORT_SYMBOL_GPL(hid_ignore);
2529 int hid_add_device(struct hid_device *hdev)
2531 static atomic_t id = ATOMIC_INIT(0);
2532 int ret;
2534 if (WARN_ON(hdev->status & HID_STAT_ADDED))
2535 return -EBUSY;
2537 /* we need to kill them here, otherwise they will stay allocated to
2538 * wait for coming driver */
2539 if (hid_ignore(hdev))
2540 return -ENODEV;
2543 * Check for the mandatory transport channel.
2545 if (!hdev->ll_driver->raw_request) {
2546 hid_err(hdev, "transport driver missing .raw_request()\n");
2547 return -EINVAL;
2551 * Read the device report descriptor once and use as template
2552 * for the driver-specific modifications.
2554 ret = hdev->ll_driver->parse(hdev);
2555 if (ret)
2556 return ret;
2557 if (!hdev->dev_rdesc)
2558 return -ENODEV;
2561 * Scan generic devices for group information
2563 if (hid_ignore_special_drivers ||
2564 (!hdev->group &&
2565 !hid_match_id(hdev, hid_have_special_driver))) {
2566 ret = hid_scan_report(hdev);
2567 if (ret)
2568 hid_warn(hdev, "bad device descriptor (%d)\n", ret);
2571 /* XXX hack, any other cleaner solution after the driver core
2572 * is converted to allow more than 20 bytes as the device name? */
2573 dev_set_name(&hdev->dev, "%04X:%04X:%04X.%04X", hdev->bus,
2574 hdev->vendor, hdev->product, atomic_inc_return(&id));
2576 hid_debug_register(hdev, dev_name(&hdev->dev));
2577 ret = device_add(&hdev->dev);
2578 if (!ret)
2579 hdev->status |= HID_STAT_ADDED;
2580 else
2581 hid_debug_unregister(hdev);
2583 return ret;
2585 EXPORT_SYMBOL_GPL(hid_add_device);
2588 * hid_allocate_device - allocate new hid device descriptor
2590 * Allocate and initialize hid device, so that hid_destroy_device might be
2591 * used to free it.
2593 * New hid_device pointer is returned on success, otherwise ERR_PTR encoded
2594 * error value.
2596 struct hid_device *hid_allocate_device(void)
2598 struct hid_device *hdev;
2599 int ret = -ENOMEM;
2601 hdev = kzalloc(sizeof(*hdev), GFP_KERNEL);
2602 if (hdev == NULL)
2603 return ERR_PTR(ret);
2605 device_initialize(&hdev->dev);
2606 hdev->dev.release = hid_device_release;
2607 hdev->dev.bus = &hid_bus_type;
2609 hid_close_report(hdev);
2611 init_waitqueue_head(&hdev->debug_wait);
2612 INIT_LIST_HEAD(&hdev->debug_list);
2613 spin_lock_init(&hdev->debug_list_lock);
2614 sema_init(&hdev->driver_lock, 1);
2615 sema_init(&hdev->driver_input_lock, 1);
2617 return hdev;
2619 EXPORT_SYMBOL_GPL(hid_allocate_device);
2621 static void hid_remove_device(struct hid_device *hdev)
2623 if (hdev->status & HID_STAT_ADDED) {
2624 device_del(&hdev->dev);
2625 hid_debug_unregister(hdev);
2626 hdev->status &= ~HID_STAT_ADDED;
2628 kfree(hdev->dev_rdesc);
2629 hdev->dev_rdesc = NULL;
2630 hdev->dev_rsize = 0;
2634 * hid_destroy_device - free previously allocated device
2636 * @hdev: hid device
2638 * If you allocate hid_device through hid_allocate_device, you should ever
2639 * free by this function.
2641 void hid_destroy_device(struct hid_device *hdev)
2643 hid_remove_device(hdev);
2644 put_device(&hdev->dev);
2646 EXPORT_SYMBOL_GPL(hid_destroy_device);
2648 int __hid_register_driver(struct hid_driver *hdrv, struct module *owner,
2649 const char *mod_name)
2651 int ret;
2653 hdrv->driver.name = hdrv->name;
2654 hdrv->driver.bus = &hid_bus_type;
2655 hdrv->driver.owner = owner;
2656 hdrv->driver.mod_name = mod_name;
2658 INIT_LIST_HEAD(&hdrv->dyn_list);
2659 spin_lock_init(&hdrv->dyn_lock);
2661 ret = driver_register(&hdrv->driver);
2662 if (ret)
2663 return ret;
2665 ret = driver_create_file(&hdrv->driver, &driver_attr_new_id);
2666 if (ret)
2667 driver_unregister(&hdrv->driver);
2669 return ret;
2671 EXPORT_SYMBOL_GPL(__hid_register_driver);
2673 void hid_unregister_driver(struct hid_driver *hdrv)
2675 driver_remove_file(&hdrv->driver, &driver_attr_new_id);
2676 driver_unregister(&hdrv->driver);
2677 hid_free_dynids(hdrv);
2679 EXPORT_SYMBOL_GPL(hid_unregister_driver);
2681 int hid_check_keys_pressed(struct hid_device *hid)
2683 struct hid_input *hidinput;
2684 int i;
2686 if (!(hid->claimed & HID_CLAIMED_INPUT))
2687 return 0;
2689 list_for_each_entry(hidinput, &hid->inputs, list) {
2690 for (i = 0; i < BITS_TO_LONGS(KEY_MAX); i++)
2691 if (hidinput->input->key[i])
2692 return 1;
2695 return 0;
2698 EXPORT_SYMBOL_GPL(hid_check_keys_pressed);
2700 static int __init hid_init(void)
2702 int ret;
2704 if (hid_debug)
2705 pr_warn("hid_debug is now used solely for parser and driver debugging.\n"
2706 "debugfs is now used for inspecting the device (report descriptor, reports)\n");
2708 ret = bus_register(&hid_bus_type);
2709 if (ret) {
2710 pr_err("can't register hid bus\n");
2711 goto err;
2714 ret = hidraw_init();
2715 if (ret)
2716 goto err_bus;
2718 hid_debug_init();
2720 return 0;
2721 err_bus:
2722 bus_unregister(&hid_bus_type);
2723 err:
2724 return ret;
2727 static void __exit hid_exit(void)
2729 hid_debug_exit();
2730 hidraw_exit();
2731 bus_unregister(&hid_bus_type);
2734 module_init(hid_init);
2735 module_exit(hid_exit);
2737 MODULE_AUTHOR("Andreas Gal");
2738 MODULE_AUTHOR("Vojtech Pavlik");
2739 MODULE_AUTHOR("Jiri Kosina");
2740 MODULE_LICENSE(DRIVER_LICENSE);