1 /*
2  *  HID support for Linux
3  *
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-2010 Jiri Kosina
8  */
9 
10 /*
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.
15  */
16 
17 #define pr_fmt(fmt) KBUILD_MODNAME ": " fmt
18 
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 
33 #include <linux/hid.h>
34 #include <linux/hiddev.h>
35 #include <linux/hid-debug.h>
36 #include <linux/hidraw.h>
37 
38 #include "hid-ids.h"
39 
40 /*
41  * Version Information
42  */
43 
44 #define DRIVER_DESC "HID core driver"
45 #define DRIVER_LICENSE "GPL"
46 
47 int hid_debug = 0;
48 module_param_named(debug, hid_debug, int, 0600);
49 MODULE_PARM_DESC(debug, "toggle HID debugging messages");
50 EXPORT_SYMBOL_GPL(hid_debug);
51 
52 /*
53  * Register a new report for a device.
54  */
55 
hid_register_report(struct hid_device * device,unsigned type,unsigned id)56 struct hid_report *hid_register_report(struct hid_device *device, unsigned type, unsigned id)
57 {
58 	struct hid_report_enum *report_enum = device->report_enum + type;
59 	struct hid_report *report;
60 
61 	if (report_enum->report_id_hash[id])
62 		return report_enum->report_id_hash[id];
63 
64 	report = kzalloc(sizeof(struct hid_report), GFP_KERNEL);
65 	if (!report)
66 		return NULL;
67 
68 	if (id != 0)
69 		report_enum->numbered = 1;
70 
71 	report->id = id;
72 	report->type = type;
73 	report->size = 0;
74 	report->device = device;
75 	report_enum->report_id_hash[id] = report;
76 
77 	list_add_tail(&report->list, &report_enum->report_list);
78 
79 	return report;
80 }
81 EXPORT_SYMBOL_GPL(hid_register_report);
82 
83 /*
84  * Register a new field for this report.
85  */
86 
hid_register_field(struct hid_report * report,unsigned usages,unsigned values)87 static struct hid_field *hid_register_field(struct hid_report *report, unsigned usages, unsigned values)
88 {
89 	struct hid_field *field;
90 
91 	if (report->maxfield == HID_MAX_FIELDS) {
92 		dbg_hid("too many fields in report\n");
93 		return NULL;
94 	}
95 
96 	field = kzalloc((sizeof(struct hid_field) +
97 			 usages * sizeof(struct hid_usage) +
98 			 values * sizeof(unsigned)), GFP_KERNEL);
99 	if (!field)
100 		return NULL;
101 
102 	field->index = report->maxfield++;
103 	report->field[field->index] = field;
104 	field->usage = (struct hid_usage *)(field + 1);
105 	field->value = (s32 *)(field->usage + usages);
106 	field->report = report;
107 
108 	return field;
109 }
110 
111 /*
112  * Open a collection. The type/usage is pushed on the stack.
113  */
114 
open_collection(struct hid_parser * parser,unsigned type)115 static int open_collection(struct hid_parser *parser, unsigned type)
116 {
117 	struct hid_collection *collection;
118 	unsigned usage;
119 
120 	usage = parser->local.usage[0];
121 
122 	if (parser->collection_stack_ptr == HID_COLLECTION_STACK_SIZE) {
123 		dbg_hid("collection stack overflow\n");
124 		return -1;
125 	}
126 
127 	if (parser->device->maxcollection == parser->device->collection_size) {
128 		collection = kmalloc(sizeof(struct hid_collection) *
129 				parser->device->collection_size * 2, GFP_KERNEL);
130 		if (collection == NULL) {
131 			dbg_hid("failed to reallocate collection array\n");
132 			return -1;
133 		}
134 		memcpy(collection, parser->device->collection,
135 			sizeof(struct hid_collection) *
136 			parser->device->collection_size);
137 		memset(collection + parser->device->collection_size, 0,
138 			sizeof(struct hid_collection) *
139 			parser->device->collection_size);
140 		kfree(parser->device->collection);
141 		parser->device->collection = collection;
142 		parser->device->collection_size *= 2;
143 	}
144 
145 	parser->collection_stack[parser->collection_stack_ptr++] =
146 		parser->device->maxcollection;
147 
148 	collection = parser->device->collection +
149 		parser->device->maxcollection++;
150 	collection->type = type;
151 	collection->usage = usage;
152 	collection->level = parser->collection_stack_ptr - 1;
153 
154 	if (type == HID_COLLECTION_APPLICATION)
155 		parser->device->maxapplication++;
156 
157 	return 0;
158 }
159 
160 /*
161  * Close a collection.
162  */
163 
close_collection(struct hid_parser * parser)164 static int close_collection(struct hid_parser *parser)
165 {
166 	if (!parser->collection_stack_ptr) {
167 		dbg_hid("collection stack underflow\n");
168 		return -1;
169 	}
170 	parser->collection_stack_ptr--;
171 	return 0;
172 }
173 
174 /*
175  * Climb up the stack, search for the specified collection type
176  * and return the usage.
177  */
178 
hid_lookup_collection(struct hid_parser * parser,unsigned type)179 static unsigned hid_lookup_collection(struct hid_parser *parser, unsigned type)
180 {
181 	struct hid_collection *collection = parser->device->collection;
182 	int n;
183 
184 	for (n = parser->collection_stack_ptr - 1; n >= 0; n--) {
185 		unsigned index = parser->collection_stack[n];
186 		if (collection[index].type == type)
187 			return collection[index].usage;
188 	}
189 	return 0; /* we know nothing about this usage type */
190 }
191 
192 /*
193  * Add a usage to the temporary parser table.
194  */
195 
hid_add_usage(struct hid_parser * parser,unsigned usage)196 static int hid_add_usage(struct hid_parser *parser, unsigned usage)
197 {
198 	if (parser->local.usage_index >= HID_MAX_USAGES) {
199 		dbg_hid("usage index exceeded\n");
200 		return -1;
201 	}
202 	parser->local.usage[parser->local.usage_index] = usage;
203 	parser->local.collection_index[parser->local.usage_index] =
204 		parser->collection_stack_ptr ?
205 		parser->collection_stack[parser->collection_stack_ptr - 1] : 0;
206 	parser->local.usage_index++;
207 	return 0;
208 }
209 
210 /*
211  * Register a new field for this report.
212  */
213 
hid_add_field(struct hid_parser * parser,unsigned report_type,unsigned flags)214 static int hid_add_field(struct hid_parser *parser, unsigned report_type, unsigned flags)
215 {
216 	struct hid_report *report;
217 	struct hid_field *field;
218 	int usages;
219 	unsigned offset;
220 	int i;
221 
222 	report = hid_register_report(parser->device, report_type, parser->global.report_id);
223 	if (!report) {
224 		dbg_hid("hid_register_report failed\n");
225 		return -1;
226 	}
227 
228 	if (parser->global.logical_maximum < parser->global.logical_minimum) {
229 		dbg_hid("logical range invalid %d %d\n", parser->global.logical_minimum, parser->global.logical_maximum);
230 		return -1;
231 	}
232 
233 	offset = report->size;
234 	report->size += parser->global.report_size * parser->global.report_count;
235 
236 	if (!parser->local.usage_index) /* Ignore padding fields */
237 		return 0;
238 
239 	usages = max_t(int, parser->local.usage_index, parser->global.report_count);
240 
241 	field = hid_register_field(report, usages, parser->global.report_count);
242 	if (!field)
243 		return 0;
244 
245 	field->physical = hid_lookup_collection(parser, HID_COLLECTION_PHYSICAL);
246 	field->logical = hid_lookup_collection(parser, HID_COLLECTION_LOGICAL);
247 	field->application = hid_lookup_collection(parser, HID_COLLECTION_APPLICATION);
248 
249 	for (i = 0; i < usages; i++) {
250 		int j = i;
251 		/* Duplicate the last usage we parsed if we have excess values */
252 		if (i >= parser->local.usage_index)
253 			j = parser->local.usage_index - 1;
254 		field->usage[i].hid = parser->local.usage[j];
255 		field->usage[i].collection_index =
256 			parser->local.collection_index[j];
257 	}
258 
259 	field->maxusage = usages;
260 	field->flags = flags;
261 	field->report_offset = offset;
262 	field->report_type = report_type;
263 	field->report_size = parser->global.report_size;
264 	field->report_count = parser->global.report_count;
265 	field->logical_minimum = parser->global.logical_minimum;
266 	field->logical_maximum = parser->global.logical_maximum;
267 	field->physical_minimum = parser->global.physical_minimum;
268 	field->physical_maximum = parser->global.physical_maximum;
269 	field->unit_exponent = parser->global.unit_exponent;
270 	field->unit = parser->global.unit;
271 
272 	return 0;
273 }
274 
275 /*
276  * Read data value from item.
277  */
278 
item_udata(struct hid_item * item)279 static u32 item_udata(struct hid_item *item)
280 {
281 	switch (item->size) {
282 	case 1: return item->data.u8;
283 	case 2: return item->data.u16;
284 	case 4: return item->data.u32;
285 	}
286 	return 0;
287 }
288 
item_sdata(struct hid_item * item)289 static s32 item_sdata(struct hid_item *item)
290 {
291 	switch (item->size) {
292 	case 1: return item->data.s8;
293 	case 2: return item->data.s16;
294 	case 4: return item->data.s32;
295 	}
296 	return 0;
297 }
298 
299 /*
300  * Process a global item.
301  */
302 
hid_parser_global(struct hid_parser * parser,struct hid_item * item)303 static int hid_parser_global(struct hid_parser *parser, struct hid_item *item)
304 {
305 	switch (item->tag) {
306 	case HID_GLOBAL_ITEM_TAG_PUSH:
307 
308 		if (parser->global_stack_ptr == HID_GLOBAL_STACK_SIZE) {
309 			dbg_hid("global environment stack overflow\n");
310 			return -1;
311 		}
312 
313 		memcpy(parser->global_stack + parser->global_stack_ptr++,
314 			&parser->global, sizeof(struct hid_global));
315 		return 0;
316 
317 	case HID_GLOBAL_ITEM_TAG_POP:
318 
319 		if (!parser->global_stack_ptr) {
320 			dbg_hid("global environment stack underflow\n");
321 			return -1;
322 		}
323 
324 		memcpy(&parser->global, parser->global_stack +
325 			--parser->global_stack_ptr, sizeof(struct hid_global));
326 		return 0;
327 
328 	case HID_GLOBAL_ITEM_TAG_USAGE_PAGE:
329 		parser->global.usage_page = item_udata(item);
330 		return 0;
331 
332 	case HID_GLOBAL_ITEM_TAG_LOGICAL_MINIMUM:
333 		parser->global.logical_minimum = item_sdata(item);
334 		return 0;
335 
336 	case HID_GLOBAL_ITEM_TAG_LOGICAL_MAXIMUM:
337 		if (parser->global.logical_minimum < 0)
338 			parser->global.logical_maximum = item_sdata(item);
339 		else
340 			parser->global.logical_maximum = item_udata(item);
341 		return 0;
342 
343 	case HID_GLOBAL_ITEM_TAG_PHYSICAL_MINIMUM:
344 		parser->global.physical_minimum = item_sdata(item);
345 		return 0;
346 
347 	case HID_GLOBAL_ITEM_TAG_PHYSICAL_MAXIMUM:
348 		if (parser->global.physical_minimum < 0)
349 			parser->global.physical_maximum = item_sdata(item);
350 		else
351 			parser->global.physical_maximum = item_udata(item);
352 		return 0;
353 
354 	case HID_GLOBAL_ITEM_TAG_UNIT_EXPONENT:
355 		parser->global.unit_exponent = item_sdata(item);
356 		return 0;
357 
358 	case HID_GLOBAL_ITEM_TAG_UNIT:
359 		parser->global.unit = item_udata(item);
360 		return 0;
361 
362 	case HID_GLOBAL_ITEM_TAG_REPORT_SIZE:
363 		parser->global.report_size = item_udata(item);
364 		if (parser->global.report_size > 32) {
365 			dbg_hid("invalid report_size %d\n",
366 					parser->global.report_size);
367 			return -1;
368 		}
369 		return 0;
370 
371 	case HID_GLOBAL_ITEM_TAG_REPORT_COUNT:
372 		parser->global.report_count = item_udata(item);
373 		if (parser->global.report_count > HID_MAX_USAGES) {
374 			dbg_hid("invalid report_count %d\n",
375 					parser->global.report_count);
376 			return -1;
377 		}
378 		return 0;
379 
380 	case HID_GLOBAL_ITEM_TAG_REPORT_ID:
381 		parser->global.report_id = item_udata(item);
382 		if (parser->global.report_id == 0) {
383 			dbg_hid("report_id 0 is invalid\n");
384 			return -1;
385 		}
386 		return 0;
387 
388 	default:
389 		dbg_hid("unknown global tag 0x%x\n", item->tag);
390 		return -1;
391 	}
392 }
393 
394 /*
395  * Process a local item.
396  */
397 
hid_parser_local(struct hid_parser * parser,struct hid_item * item)398 static int hid_parser_local(struct hid_parser *parser, struct hid_item *item)
399 {
400 	__u32 data;
401 	unsigned n;
402 
403 	data = item_udata(item);
404 
405 	switch (item->tag) {
406 	case HID_LOCAL_ITEM_TAG_DELIMITER:
407 
408 		if (data) {
409 			/*
410 			 * We treat items before the first delimiter
411 			 * as global to all usage sets (branch 0).
412 			 * In the moment we process only these global
413 			 * items and the first delimiter set.
414 			 */
415 			if (parser->local.delimiter_depth != 0) {
416 				dbg_hid("nested delimiters\n");
417 				return -1;
418 			}
419 			parser->local.delimiter_depth++;
420 			parser->local.delimiter_branch++;
421 		} else {
422 			if (parser->local.delimiter_depth < 1) {
423 				dbg_hid("bogus close delimiter\n");
424 				return -1;
425 			}
426 			parser->local.delimiter_depth--;
427 		}
428 		return 1;
429 
430 	case HID_LOCAL_ITEM_TAG_USAGE:
431 
432 		if (parser->local.delimiter_branch > 1) {
433 			dbg_hid("alternative usage ignored\n");
434 			return 0;
435 		}
436 
437 		if (item->size <= 2)
438 			data = (parser->global.usage_page << 16) + data;
439 
440 		return hid_add_usage(parser, data);
441 
442 	case HID_LOCAL_ITEM_TAG_USAGE_MINIMUM:
443 
444 		if (parser->local.delimiter_branch > 1) {
445 			dbg_hid("alternative usage ignored\n");
446 			return 0;
447 		}
448 
449 		if (item->size <= 2)
450 			data = (parser->global.usage_page << 16) + data;
451 
452 		parser->local.usage_minimum = data;
453 		return 0;
454 
455 	case HID_LOCAL_ITEM_TAG_USAGE_MAXIMUM:
456 
457 		if (parser->local.delimiter_branch > 1) {
458 			dbg_hid("alternative usage ignored\n");
459 			return 0;
460 		}
461 
462 		if (item->size <= 2)
463 			data = (parser->global.usage_page << 16) + data;
464 
465 		for (n = parser->local.usage_minimum; n <= data; n++)
466 			if (hid_add_usage(parser, n)) {
467 				dbg_hid("hid_add_usage failed\n");
468 				return -1;
469 			}
470 		return 0;
471 
472 	default:
473 
474 		dbg_hid("unknown local item tag 0x%x\n", item->tag);
475 		return 0;
476 	}
477 	return 0;
478 }
479 
480 /*
481  * Process a main item.
482  */
483 
hid_parser_main(struct hid_parser * parser,struct hid_item * item)484 static int hid_parser_main(struct hid_parser *parser, struct hid_item *item)
485 {
486 	__u32 data;
487 	int ret;
488 
489 	data = item_udata(item);
490 
491 	switch (item->tag) {
492 	case HID_MAIN_ITEM_TAG_BEGIN_COLLECTION:
493 		ret = open_collection(parser, data & 0xff);
494 		break;
495 	case HID_MAIN_ITEM_TAG_END_COLLECTION:
496 		ret = close_collection(parser);
497 		break;
498 	case HID_MAIN_ITEM_TAG_INPUT:
499 		ret = hid_add_field(parser, HID_INPUT_REPORT, data);
500 		break;
501 	case HID_MAIN_ITEM_TAG_OUTPUT:
502 		ret = hid_add_field(parser, HID_OUTPUT_REPORT, data);
503 		break;
504 	case HID_MAIN_ITEM_TAG_FEATURE:
505 		ret = hid_add_field(parser, HID_FEATURE_REPORT, data);
506 		break;
507 	default:
508 		dbg_hid("unknown main item tag 0x%x\n", item->tag);
509 		ret = 0;
510 	}
511 
512 	memset(&parser->local, 0, sizeof(parser->local));	/* Reset the local parser environment */
513 
514 	return ret;
515 }
516 
517 /*
518  * Process a reserved item.
519  */
520 
hid_parser_reserved(struct hid_parser * parser,struct hid_item * item)521 static int hid_parser_reserved(struct hid_parser *parser, struct hid_item *item)
522 {
523 	dbg_hid("reserved item type, tag 0x%x\n", item->tag);
524 	return 0;
525 }
526 
527 /*
528  * Free a report and all registered fields. The field->usage and
529  * field->value table's are allocated behind the field, so we need
530  * only to free(field) itself.
531  */
532 
hid_free_report(struct hid_report * report)533 static void hid_free_report(struct hid_report *report)
534 {
535 	unsigned n;
536 
537 	for (n = 0; n < report->maxfield; n++)
538 		kfree(report->field[n]);
539 	kfree(report);
540 }
541 
542 /*
543  * Free a device structure, all reports, and all fields.
544  */
545 
hid_device_release(struct device * dev)546 static void hid_device_release(struct device *dev)
547 {
548 	struct hid_device *device = container_of(dev, struct hid_device, dev);
549 	unsigned i, j;
550 
551 	for (i = 0; i < HID_REPORT_TYPES; i++) {
552 		struct hid_report_enum *report_enum = device->report_enum + i;
553 
554 		for (j = 0; j < 256; j++) {
555 			struct hid_report *report = report_enum->report_id_hash[j];
556 			if (report)
557 				hid_free_report(report);
558 		}
559 	}
560 
561 	kfree(device->rdesc);
562 	kfree(device->collection);
563 	kfree(device);
564 }
565 
566 /*
567  * Fetch a report description item from the data stream. We support long
568  * items, though they are not used yet.
569  */
570 
fetch_item(__u8 * start,__u8 * end,struct hid_item * item)571 static u8 *fetch_item(__u8 *start, __u8 *end, struct hid_item *item)
572 {
573 	u8 b;
574 
575 	if ((end - start) <= 0)
576 		return NULL;
577 
578 	b = *start++;
579 
580 	item->type = (b >> 2) & 3;
581 	item->tag  = (b >> 4) & 15;
582 
583 	if (item->tag == HID_ITEM_TAG_LONG) {
584 
585 		item->format = HID_ITEM_FORMAT_LONG;
586 
587 		if ((end - start) < 2)
588 			return NULL;
589 
590 		item->size = *start++;
591 		item->tag  = *start++;
592 
593 		if ((end - start) < item->size)
594 			return NULL;
595 
596 		item->data.longdata = start;
597 		start += item->size;
598 		return start;
599 	}
600 
601 	item->format = HID_ITEM_FORMAT_SHORT;
602 	item->size = b & 3;
603 
604 	switch (item->size) {
605 	case 0:
606 		return start;
607 
608 	case 1:
609 		if ((end - start) < 1)
610 			return NULL;
611 		item->data.u8 = *start++;
612 		return start;
613 
614 	case 2:
615 		if ((end - start) < 2)
616 			return NULL;
617 		item->data.u16 = get_unaligned_le16(start);
618 		start = (__u8 *)((__le16 *)start + 1);
619 		return start;
620 
621 	case 3:
622 		item->size++;
623 		if ((end - start) < 4)
624 			return NULL;
625 		item->data.u32 = get_unaligned_le32(start);
626 		start = (__u8 *)((__le32 *)start + 1);
627 		return start;
628 	}
629 
630 	return NULL;
631 }
632 
633 /**
634  * hid_parse_report - parse device report
635  *
636  * @device: hid device
637  * @start: report start
638  * @size: report size
639  *
640  * Parse a report description into a hid_device structure. Reports are
641  * enumerated, fields are attached to these reports.
642  * 0 returned on success, otherwise nonzero error value.
643  */
hid_parse_report(struct hid_device * device,__u8 * start,unsigned size)644 int hid_parse_report(struct hid_device *device, __u8 *start,
645 		unsigned size)
646 {
647 	struct hid_parser *parser;
648 	struct hid_item item;
649 	__u8 *end;
650 	int ret;
651 	static int (*dispatch_type[])(struct hid_parser *parser,
652 				      struct hid_item *item) = {
653 		hid_parser_main,
654 		hid_parser_global,
655 		hid_parser_local,
656 		hid_parser_reserved
657 	};
658 
659 	if (device->driver->report_fixup)
660 		start = device->driver->report_fixup(device, start, &size);
661 
662 	device->rdesc = kmemdup(start, size, GFP_KERNEL);
663 	if (device->rdesc == NULL)
664 		return -ENOMEM;
665 	device->rsize = size;
666 
667 	parser = vzalloc(sizeof(struct hid_parser));
668 	if (!parser) {
669 		ret = -ENOMEM;
670 		goto err;
671 	}
672 
673 	parser->device = device;
674 
675 	end = start + size;
676 	ret = -EINVAL;
677 	while ((start = fetch_item(start, end, &item)) != NULL) {
678 
679 		if (item.format != HID_ITEM_FORMAT_SHORT) {
680 			dbg_hid("unexpected long global item\n");
681 			goto err;
682 		}
683 
684 		if (dispatch_type[item.type](parser, &item)) {
685 			dbg_hid("item %u %u %u %u parsing failed\n",
686 				item.format, (unsigned)item.size,
687 				(unsigned)item.type, (unsigned)item.tag);
688 			goto err;
689 		}
690 
691 		if (start == end) {
692 			if (parser->collection_stack_ptr) {
693 				dbg_hid("unbalanced collection at end of report description\n");
694 				goto err;
695 			}
696 			if (parser->local.delimiter_depth) {
697 				dbg_hid("unbalanced delimiter at end of report description\n");
698 				goto err;
699 			}
700 			vfree(parser);
701 			return 0;
702 		}
703 	}
704 
705 	dbg_hid("item fetching failed at offset %d\n", (int)(end - start));
706 err:
707 	vfree(parser);
708 	return ret;
709 }
710 EXPORT_SYMBOL_GPL(hid_parse_report);
711 
712 /*
713  * Convert a signed n-bit integer to signed 32-bit integer. Common
714  * cases are done through the compiler, the screwed things has to be
715  * done by hand.
716  */
717 
snto32(__u32 value,unsigned n)718 static s32 snto32(__u32 value, unsigned n)
719 {
720 	switch (n) {
721 	case 8:  return ((__s8)value);
722 	case 16: return ((__s16)value);
723 	case 32: return ((__s32)value);
724 	}
725 	return value & (1 << (n - 1)) ? value | (-1 << n) : value;
726 }
727 
728 /*
729  * Convert a signed 32-bit integer to a signed n-bit integer.
730  */
731 
s32ton(__s32 value,unsigned n)732 static u32 s32ton(__s32 value, unsigned n)
733 {
734 	s32 a = value >> (n - 1);
735 	if (a && a != -1)
736 		return value < 0 ? 1 << (n - 1) : (1 << (n - 1)) - 1;
737 	return value & ((1 << n) - 1);
738 }
739 
740 /*
741  * Extract/implement a data field from/to a little endian report (bit array).
742  *
743  * Code sort-of follows HID spec:
744  *     http://www.usb.org/developers/devclass_docs/HID1_11.pdf
745  *
746  * While the USB HID spec allows unlimited length bit fields in "report
747  * descriptors", most devices never use more than 16 bits.
748  * One model of UPS is claimed to report "LINEV" as a 32-bit field.
749  * Search linux-kernel and linux-usb-devel archives for "hid-core extract".
750  */
751 
extract(const struct hid_device * hid,__u8 * report,unsigned offset,unsigned n)752 static __u32 extract(const struct hid_device *hid, __u8 *report,
753 		     unsigned offset, unsigned n)
754 {
755 	u64 x;
756 
757 	if (n > 32)
758 		hid_warn(hid, "extract() called with n (%d) > 32! (%s)\n",
759 			 n, current->comm);
760 
761 	report += offset >> 3;  /* adjust byte index */
762 	offset &= 7;            /* now only need bit offset into one byte */
763 	x = get_unaligned_le64(report);
764 	x = (x >> offset) & ((1ULL << n) - 1);  /* extract bit field */
765 	return (u32) x;
766 }
767 
768 /*
769  * "implement" : set bits in a little endian bit stream.
770  * Same concepts as "extract" (see comments above).
771  * The data mangled in the bit stream remains in little endian
772  * order the whole time. It make more sense to talk about
773  * endianness of register values by considering a register
774  * a "cached" copy of the little endiad bit stream.
775  */
implement(const struct hid_device * hid,__u8 * report,unsigned offset,unsigned n,__u32 value)776 static void implement(const struct hid_device *hid, __u8 *report,
777 		      unsigned offset, unsigned n, __u32 value)
778 {
779 	u64 x;
780 	u64 m = (1ULL << n) - 1;
781 
782 	if (n > 32)
783 		hid_warn(hid, "%s() called with n (%d) > 32! (%s)\n",
784 			 __func__, n, current->comm);
785 
786 	if (value > m)
787 		hid_warn(hid, "%s() called with too large value %d! (%s)\n",
788 			 __func__, value, current->comm);
789 	WARN_ON(value > m);
790 	value &= m;
791 
792 	report += offset >> 3;
793 	offset &= 7;
794 
795 	x = get_unaligned_le64(report);
796 	x &= ~(m << offset);
797 	x |= ((u64)value) << offset;
798 	put_unaligned_le64(x, report);
799 }
800 
801 /*
802  * Search an array for a value.
803  */
804 
search(__s32 * array,__s32 value,unsigned n)805 static int search(__s32 *array, __s32 value, unsigned n)
806 {
807 	while (n--) {
808 		if (*array++ == value)
809 			return 0;
810 	}
811 	return -1;
812 }
813 
814 /**
815  * hid_match_report - check if driver's raw_event should be called
816  *
817  * @hid: hid device
818  * @report_type: type to match against
819  *
820  * compare hid->driver->report_table->report_type to report->type
821  */
hid_match_report(struct hid_device * hid,struct hid_report * report)822 static int hid_match_report(struct hid_device *hid, struct hid_report *report)
823 {
824 	const struct hid_report_id *id = hid->driver->report_table;
825 
826 	if (!id) /* NULL means all */
827 		return 1;
828 
829 	for (; id->report_type != HID_TERMINATOR; id++)
830 		if (id->report_type == HID_ANY_ID ||
831 				id->report_type == report->type)
832 			return 1;
833 	return 0;
834 }
835 
836 /**
837  * hid_match_usage - check if driver's event should be called
838  *
839  * @hid: hid device
840  * @usage: usage to match against
841  *
842  * compare hid->driver->usage_table->usage_{type,code} to
843  * usage->usage_{type,code}
844  */
hid_match_usage(struct hid_device * hid,struct hid_usage * usage)845 static int hid_match_usage(struct hid_device *hid, struct hid_usage *usage)
846 {
847 	const struct hid_usage_id *id = hid->driver->usage_table;
848 
849 	if (!id) /* NULL means all */
850 		return 1;
851 
852 	for (; id->usage_type != HID_ANY_ID - 1; id++)
853 		if ((id->usage_hid == HID_ANY_ID ||
854 				id->usage_hid == usage->hid) &&
855 				(id->usage_type == HID_ANY_ID ||
856 				id->usage_type == usage->type) &&
857 				(id->usage_code == HID_ANY_ID ||
858 				 id->usage_code == usage->code))
859 			return 1;
860 	return 0;
861 }
862 
hid_process_event(struct hid_device * hid,struct hid_field * field,struct hid_usage * usage,__s32 value,int interrupt)863 static void hid_process_event(struct hid_device *hid, struct hid_field *field,
864 		struct hid_usage *usage, __s32 value, int interrupt)
865 {
866 	struct hid_driver *hdrv = hid->driver;
867 	int ret;
868 
869 	hid_dump_input(hid, usage, value);
870 
871 	if (hdrv && hdrv->event && hid_match_usage(hid, usage)) {
872 		ret = hdrv->event(hid, field, usage, value);
873 		if (ret != 0) {
874 			if (ret < 0)
875 				dbg_hid("%s's event failed with %d\n",
876 						hdrv->name, ret);
877 			return;
878 		}
879 	}
880 
881 	if (hid->claimed & HID_CLAIMED_INPUT)
882 		hidinput_hid_event(hid, field, usage, value);
883 	if (hid->claimed & HID_CLAIMED_HIDDEV && interrupt && hid->hiddev_hid_event)
884 		hid->hiddev_hid_event(hid, field, usage, value);
885 }
886 
887 /*
888  * Analyse a received field, and fetch the data from it. The field
889  * content is stored for next report processing (we do differential
890  * reporting to the layer).
891  */
892 
hid_input_field(struct hid_device * hid,struct hid_field * field,__u8 * data,int interrupt)893 static void hid_input_field(struct hid_device *hid, struct hid_field *field,
894 			    __u8 *data, int interrupt)
895 {
896 	unsigned n;
897 	unsigned count = field->report_count;
898 	unsigned offset = field->report_offset;
899 	unsigned size = field->report_size;
900 	__s32 min = field->logical_minimum;
901 	__s32 max = field->logical_maximum;
902 	__s32 *value;
903 
904 	value = kmalloc(sizeof(__s32) * count, GFP_ATOMIC);
905 	if (!value)
906 		return;
907 
908 	for (n = 0; n < count; n++) {
909 
910 		value[n] = min < 0 ?
911 			snto32(extract(hid, data, offset + n * size, size),
912 			       size) :
913 			extract(hid, data, offset + n * size, size);
914 
915 		/* Ignore report if ErrorRollOver */
916 		if (!(field->flags & HID_MAIN_ITEM_VARIABLE) &&
917 		    value[n] >= min && value[n] <= max &&
918 		    field->usage[value[n] - min].hid == HID_UP_KEYBOARD + 1)
919 			goto exit;
920 	}
921 
922 	for (n = 0; n < count; n++) {
923 
924 		if (HID_MAIN_ITEM_VARIABLE & field->flags) {
925 			hid_process_event(hid, field, &field->usage[n], value[n], interrupt);
926 			continue;
927 		}
928 
929 		if (field->value[n] >= min && field->value[n] <= max
930 			&& field->usage[field->value[n] - min].hid
931 			&& search(value, field->value[n], count))
932 				hid_process_event(hid, field, &field->usage[field->value[n] - min], 0, interrupt);
933 
934 		if (value[n] >= min && value[n] <= max
935 			&& field->usage[value[n] - min].hid
936 			&& search(field->value, value[n], count))
937 				hid_process_event(hid, field, &field->usage[value[n] - min], 1, interrupt);
938 	}
939 
940 	memcpy(field->value, value, count * sizeof(__s32));
941 exit:
942 	kfree(value);
943 }
944 
945 /*
946  * Output the field into the report.
947  */
948 
hid_output_field(const struct hid_device * hid,struct hid_field * field,__u8 * data)949 static void hid_output_field(const struct hid_device *hid,
950 			     struct hid_field *field, __u8 *data)
951 {
952 	unsigned count = field->report_count;
953 	unsigned offset = field->report_offset;
954 	unsigned size = field->report_size;
955 	unsigned n;
956 
957 	for (n = 0; n < count; n++) {
958 		if (field->logical_minimum < 0)	/* signed values */
959 			implement(hid, data, offset + n * size, size,
960 				  s32ton(field->value[n], size));
961 		else				/* unsigned values */
962 			implement(hid, data, offset + n * size, size,
963 				  field->value[n]);
964 	}
965 }
966 
967 /*
968  * Create a report.
969  */
970 
hid_output_report(struct hid_report * report,__u8 * data)971 void hid_output_report(struct hid_report *report, __u8 *data)
972 {
973 	unsigned n;
974 
975 	if (report->id > 0)
976 		*data++ = report->id;
977 
978 	memset(data, 0, ((report->size - 1) >> 3) + 1);
979 	for (n = 0; n < report->maxfield; n++)
980 		hid_output_field(report->device, report->field[n], data);
981 }
982 EXPORT_SYMBOL_GPL(hid_output_report);
983 
984 /*
985  * Set a field value. The report this field belongs to has to be
986  * created and transferred to the device, to set this value in the
987  * device.
988  */
989 
hid_set_field(struct hid_field * field,unsigned offset,__s32 value)990 int hid_set_field(struct hid_field *field, unsigned offset, __s32 value)
991 {
992 	unsigned size = field->report_size;
993 
994 	hid_dump_input(field->report->device, field->usage + offset, value);
995 
996 	if (offset >= field->report_count) {
997 		dbg_hid("offset (%d) exceeds report_count (%d)\n", offset, field->report_count);
998 		return -1;
999 	}
1000 	if (field->logical_minimum < 0) {
1001 		if (value != snto32(s32ton(value, size), size)) {
1002 			dbg_hid("value %d is out of range\n", value);
1003 			return -1;
1004 		}
1005 	}
1006 	field->value[offset] = value;
1007 	return 0;
1008 }
1009 EXPORT_SYMBOL_GPL(hid_set_field);
1010 
hid_get_report(struct hid_report_enum * report_enum,const u8 * data)1011 static struct hid_report *hid_get_report(struct hid_report_enum *report_enum,
1012 		const u8 *data)
1013 {
1014 	struct hid_report *report;
1015 	unsigned int n = 0;	/* Normally report number is 0 */
1016 
1017 	/* Device uses numbered reports, data[0] is report number */
1018 	if (report_enum->numbered)
1019 		n = *data;
1020 
1021 	report = report_enum->report_id_hash[n];
1022 	if (report == NULL)
1023 		dbg_hid("undefined report_id %u received\n", n);
1024 
1025 	return report;
1026 }
1027 
hid_report_raw_event(struct hid_device * hid,int type,u8 * data,int size,int interrupt)1028 void hid_report_raw_event(struct hid_device *hid, int type, u8 *data, int size,
1029 		int interrupt)
1030 {
1031 	struct hid_report_enum *report_enum = hid->report_enum + type;
1032 	struct hid_report *report;
1033 	unsigned int a;
1034 	int rsize, csize = size;
1035 	u8 *cdata = data;
1036 
1037 	report = hid_get_report(report_enum, data);
1038 	if (!report)
1039 		return;
1040 
1041 	if (report_enum->numbered) {
1042 		cdata++;
1043 		csize--;
1044 	}
1045 
1046 	rsize = ((report->size - 1) >> 3) + 1;
1047 
1048 	if (csize < rsize) {
1049 		dbg_hid("report %d is too short, (%d < %d)\n", report->id,
1050 				csize, rsize);
1051 		memset(cdata + csize, 0, rsize - csize);
1052 	}
1053 
1054 	if ((hid->claimed & HID_CLAIMED_HIDDEV) && hid->hiddev_report_event)
1055 		hid->hiddev_report_event(hid, report);
1056 	if (hid->claimed & HID_CLAIMED_HIDRAW)
1057 		hidraw_report_event(hid, data, size);
1058 
1059 	for (a = 0; a < report->maxfield; a++)
1060 		hid_input_field(hid, report->field[a], cdata, interrupt);
1061 
1062 	if (hid->claimed & HID_CLAIMED_INPUT)
1063 		hidinput_report_event(hid, report);
1064 }
1065 EXPORT_SYMBOL_GPL(hid_report_raw_event);
1066 
1067 /**
1068  * hid_input_report - report data from lower layer (usb, bt...)
1069  *
1070  * @hid: hid device
1071  * @type: HID report type (HID_*_REPORT)
1072  * @data: report contents
1073  * @size: size of data parameter
1074  * @interrupt: distinguish between interrupt and control transfers
1075  *
1076  * This is data entry for lower layers.
1077  */
hid_input_report(struct hid_device * hid,int type,u8 * data,int size,int interrupt)1078 int hid_input_report(struct hid_device *hid, int type, u8 *data, int size, int interrupt)
1079 {
1080 	struct hid_report_enum *report_enum;
1081 	struct hid_driver *hdrv;
1082 	struct hid_report *report;
1083 	char *buf;
1084 	unsigned int i;
1085 	int ret;
1086 
1087 	if (!hid || !hid->driver)
1088 		return -ENODEV;
1089 	report_enum = hid->report_enum + type;
1090 	hdrv = hid->driver;
1091 
1092 	if (!size) {
1093 		dbg_hid("empty report\n");
1094 		return -1;
1095 	}
1096 
1097 	buf = kmalloc(sizeof(char) * HID_DEBUG_BUFSIZE, GFP_ATOMIC);
1098 
1099 	if (!buf)
1100 		goto nomem;
1101 
1102 	/* dump the report */
1103 	snprintf(buf, HID_DEBUG_BUFSIZE - 1,
1104 			"\nreport (size %u) (%snumbered) = ", size, report_enum->numbered ? "" : "un");
1105 	hid_debug_event(hid, buf);
1106 
1107 	for (i = 0; i < size; i++) {
1108 		snprintf(buf, HID_DEBUG_BUFSIZE - 1,
1109 				" %02x", data[i]);
1110 		hid_debug_event(hid, buf);
1111 	}
1112 	hid_debug_event(hid, "\n");
1113 	kfree(buf);
1114 
1115 nomem:
1116 	report = hid_get_report(report_enum, data);
1117 
1118 	if (!report)
1119 		return -1;
1120 
1121 	if (hdrv && hdrv->raw_event && hid_match_report(hid, report)) {
1122 		ret = hdrv->raw_event(hid, report, data, size);
1123 		if (ret != 0)
1124 			return ret < 0 ? ret : 0;
1125 	}
1126 
1127 	hid_report_raw_event(hid, type, data, size, interrupt);
1128 
1129 	return 0;
1130 }
1131 EXPORT_SYMBOL_GPL(hid_input_report);
1132 
hid_match_one_id(struct hid_device * hdev,const struct hid_device_id * id)1133 static bool hid_match_one_id(struct hid_device *hdev,
1134 		const struct hid_device_id *id)
1135 {
1136 	return id->bus == hdev->bus &&
1137 		(id->vendor == HID_ANY_ID || id->vendor == hdev->vendor) &&
1138 		(id->product == HID_ANY_ID || id->product == hdev->product);
1139 }
1140 
hid_match_id(struct hid_device * hdev,const struct hid_device_id * id)1141 static const struct hid_device_id *hid_match_id(struct hid_device *hdev,
1142 		const struct hid_device_id *id)
1143 {
1144 	for (; id->bus; id++)
1145 		if (hid_match_one_id(hdev, id))
1146 			return id;
1147 
1148 	return NULL;
1149 }
1150 
1151 static const struct hid_device_id hid_hiddev_list[] = {
1152 	{ HID_USB_DEVICE(USB_VENDOR_ID_MGE, USB_DEVICE_ID_MGE_UPS) },
1153 	{ HID_USB_DEVICE(USB_VENDOR_ID_MGE, USB_DEVICE_ID_MGE_UPS1) },
1154 	{ }
1155 };
1156 
hid_hiddev(struct hid_device * hdev)1157 static bool hid_hiddev(struct hid_device *hdev)
1158 {
1159 	return !!hid_match_id(hdev, hid_hiddev_list);
1160 }
1161 
1162 
1163 static ssize_t
read_report_descriptor(struct file * filp,struct kobject * kobj,struct bin_attribute * attr,char * buf,loff_t off,size_t count)1164 read_report_descriptor(struct file *filp, struct kobject *kobj,
1165 		struct bin_attribute *attr,
1166 		char *buf, loff_t off, size_t count)
1167 {
1168 	struct device *dev = container_of(kobj, struct device, kobj);
1169 	struct hid_device *hdev = container_of(dev, struct hid_device, dev);
1170 
1171 	if (off >= hdev->rsize)
1172 		return 0;
1173 
1174 	if (off + count > hdev->rsize)
1175 		count = hdev->rsize - off;
1176 
1177 	memcpy(buf, hdev->rdesc + off, count);
1178 
1179 	return count;
1180 }
1181 
1182 static struct bin_attribute dev_bin_attr_report_desc = {
1183 	.attr = { .name = "report_descriptor", .mode = 0444 },
1184 	.read = read_report_descriptor,
1185 	.size = HID_MAX_DESCRIPTOR_SIZE,
1186 };
1187 
hid_connect(struct hid_device * hdev,unsigned int connect_mask)1188 int hid_connect(struct hid_device *hdev, unsigned int connect_mask)
1189 {
1190 	static const char *types[] = { "Device", "Pointer", "Mouse", "Device",
1191 		"Joystick", "Gamepad", "Keyboard", "Keypad",
1192 		"Multi-Axis Controller"
1193 	};
1194 	const char *type, *bus;
1195 	char buf[64];
1196 	unsigned int i;
1197 	int len;
1198 	int ret;
1199 
1200 	if (hdev->quirks & HID_QUIRK_HIDDEV_FORCE)
1201 		connect_mask |= (HID_CONNECT_HIDDEV_FORCE | HID_CONNECT_HIDDEV);
1202 	if (hdev->quirks & HID_QUIRK_HIDINPUT_FORCE)
1203 		connect_mask |= HID_CONNECT_HIDINPUT_FORCE;
1204 	if (hdev->bus != BUS_USB)
1205 		connect_mask &= ~HID_CONNECT_HIDDEV;
1206 	if (hid_hiddev(hdev))
1207 		connect_mask |= HID_CONNECT_HIDDEV_FORCE;
1208 
1209 	if ((connect_mask & HID_CONNECT_HIDINPUT) && !hidinput_connect(hdev,
1210 				connect_mask & HID_CONNECT_HIDINPUT_FORCE))
1211 		hdev->claimed |= HID_CLAIMED_INPUT;
1212 	if ((connect_mask & HID_CONNECT_HIDDEV) && hdev->hiddev_connect &&
1213 			!hdev->hiddev_connect(hdev,
1214 				connect_mask & HID_CONNECT_HIDDEV_FORCE))
1215 		hdev->claimed |= HID_CLAIMED_HIDDEV;
1216 	if ((connect_mask & HID_CONNECT_HIDRAW) && !hidraw_connect(hdev))
1217 		hdev->claimed |= HID_CLAIMED_HIDRAW;
1218 
1219 	if (!hdev->claimed) {
1220 		hid_err(hdev, "claimed by neither input, hiddev nor hidraw\n");
1221 		return -ENODEV;
1222 	}
1223 
1224 	if ((hdev->claimed & HID_CLAIMED_INPUT) &&
1225 			(connect_mask & HID_CONNECT_FF) && hdev->ff_init)
1226 		hdev->ff_init(hdev);
1227 
1228 	len = 0;
1229 	if (hdev->claimed & HID_CLAIMED_INPUT)
1230 		len += sprintf(buf + len, "input");
1231 	if (hdev->claimed & HID_CLAIMED_HIDDEV)
1232 		len += sprintf(buf + len, "%shiddev%d", len ? "," : "",
1233 				hdev->minor);
1234 	if (hdev->claimed & HID_CLAIMED_HIDRAW)
1235 		len += sprintf(buf + len, "%shidraw%d", len ? "," : "",
1236 				((struct hidraw *)hdev->hidraw)->minor);
1237 
1238 	type = "Device";
1239 	for (i = 0; i < hdev->maxcollection; i++) {
1240 		struct hid_collection *col = &hdev->collection[i];
1241 		if (col->type == HID_COLLECTION_APPLICATION &&
1242 		   (col->usage & HID_USAGE_PAGE) == HID_UP_GENDESK &&
1243 		   (col->usage & 0xffff) < ARRAY_SIZE(types)) {
1244 			type = types[col->usage & 0xffff];
1245 			break;
1246 		}
1247 	}
1248 
1249 	switch (hdev->bus) {
1250 	case BUS_USB:
1251 		bus = "USB";
1252 		break;
1253 	case BUS_BLUETOOTH:
1254 		bus = "BLUETOOTH";
1255 		break;
1256 	default:
1257 		bus = "<UNKNOWN>";
1258 	}
1259 
1260 	ret = device_create_bin_file(&hdev->dev, &dev_bin_attr_report_desc);
1261 	if (ret)
1262 		hid_warn(hdev,
1263 			 "can't create sysfs report descriptor attribute err: %d\n", ret);
1264 
1265 	hid_info(hdev, "%s: %s HID v%x.%02x %s [%s] on %s\n",
1266 		 buf, bus, hdev->version >> 8, hdev->version & 0xff,
1267 		 type, hdev->name, hdev->phys);
1268 
1269 	return 0;
1270 }
1271 EXPORT_SYMBOL_GPL(hid_connect);
1272 
hid_disconnect(struct hid_device * hdev)1273 void hid_disconnect(struct hid_device *hdev)
1274 {
1275 	device_remove_bin_file(&hdev->dev, &dev_bin_attr_report_desc);
1276 	if (hdev->claimed & HID_CLAIMED_INPUT)
1277 		hidinput_disconnect(hdev);
1278 	if (hdev->claimed & HID_CLAIMED_HIDDEV)
1279 		hdev->hiddev_disconnect(hdev);
1280 	if (hdev->claimed & HID_CLAIMED_HIDRAW)
1281 		hidraw_disconnect(hdev);
1282 }
1283 EXPORT_SYMBOL_GPL(hid_disconnect);
1284 
1285 /* a list of devices for which there is a specialized driver on HID bus */
1286 static const struct hid_device_id hid_have_special_driver[] = {
1287 	{ HID_USB_DEVICE(USB_VENDOR_ID_3M, USB_DEVICE_ID_3M1968) },
1288 	{ HID_USB_DEVICE(USB_VENDOR_ID_3M, USB_DEVICE_ID_3M2256) },
1289 	{ HID_USB_DEVICE(USB_VENDOR_ID_A4TECH, USB_DEVICE_ID_A4TECH_WCP32PU) },
1290 	{ HID_USB_DEVICE(USB_VENDOR_ID_A4TECH, USB_DEVICE_ID_A4TECH_X5_005D) },
1291 	{ HID_USB_DEVICE(USB_VENDOR_ID_A4TECH, USB_DEVICE_ID_A4TECH_RP_649) },
1292 	{ HID_USB_DEVICE(USB_VENDOR_ID_ACRUX, 0x0802) },
1293 	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_ATV_IRCONTROL) },
1294 	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_IRCONTROL4) },
1295 	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_MIGHTYMOUSE) },
1296 	{ HID_BLUETOOTH_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_MAGICMOUSE) },
1297 	{ HID_BLUETOOTH_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_MAGICTRACKPAD) },
1298 	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_FOUNTAIN_ANSI) },
1299 	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_FOUNTAIN_ISO) },
1300 	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_GEYSER_ANSI) },
1301 	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_GEYSER_ISO) },
1302 	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_GEYSER_JIS) },
1303 	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_GEYSER3_ANSI) },
1304 	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_GEYSER3_ISO) },
1305 	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_GEYSER3_JIS) },
1306 	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_GEYSER4_ANSI) },
1307 	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_GEYSER4_ISO) },
1308 	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_GEYSER4_JIS) },
1309 	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_ALU_MINI_ANSI) },
1310 	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_ALU_MINI_ISO) },
1311 	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_ALU_MINI_JIS) },
1312 	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_ALU_ANSI) },
1313 	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_ALU_ISO) },
1314 	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_ALU_JIS) },
1315 	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_GEYSER4_HF_ANSI) },
1316 	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_GEYSER4_HF_ISO) },
1317 	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_GEYSER4_HF_JIS) },
1318 	{ HID_BLUETOOTH_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_ALU_WIRELESS_ANSI) },
1319 	{ HID_BLUETOOTH_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_ALU_WIRELESS_ISO) },
1320 	{ HID_BLUETOOTH_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_ALU_WIRELESS_JIS) },
1321 	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING_ANSI) },
1322 	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING_ISO) },
1323 	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING_JIS) },
1324 	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING2_ANSI) },
1325 	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING2_ISO) },
1326 	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING2_JIS) },
1327 	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING3_ANSI) },
1328 	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING3_ISO) },
1329 	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING3_JIS) },
1330 	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING4_ANSI) },
1331 	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING4_ISO) },
1332 	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING4_JIS) },
1333 	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING4A_ANSI) },
1334 	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING4A_ISO) },
1335 	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING4A_JIS) },
1336 	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING5_ANSI) },
1337 	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING5_ISO) },
1338 	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING5_JIS) },
1339 	{ HID_BLUETOOTH_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_ALU_WIRELESS_2009_ANSI) },
1340 	{ HID_BLUETOOTH_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_ALU_WIRELESS_2009_ISO) },
1341 	{ HID_BLUETOOTH_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_ALU_WIRELESS_2009_JIS) },
1342 	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_FOUNTAIN_TP_ONLY) },
1343 	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_GEYSER1_TP_ONLY) },
1344 	{ HID_USB_DEVICE(USB_VENDOR_ID_ASUS, USB_DEVICE_ID_ASUS_T91MT) },
1345 	{ HID_USB_DEVICE(USB_VENDOR_ID_ASUS, USB_DEVICE_ID_ASUSTEK_MULTITOUCH_YFO) },
1346 	{ HID_USB_DEVICE(USB_VENDOR_ID_BELKIN, USB_DEVICE_ID_FLIP_KVM) },
1347 	{ HID_USB_DEVICE(USB_VENDOR_ID_BTC, USB_DEVICE_ID_BTC_EMPREX_REMOTE) },
1348 	{ HID_USB_DEVICE(USB_VENDOR_ID_BTC, USB_DEVICE_ID_BTC_EMPREX_REMOTE_2) },
1349 	{ HID_USB_DEVICE(USB_VENDOR_ID_CANDO, USB_DEVICE_ID_CANDO_PIXCIR_MULTI_TOUCH) },
1350 	{ HID_USB_DEVICE(USB_VENDOR_ID_CANDO, USB_DEVICE_ID_CANDO_MULTI_TOUCH) },
1351 	{ HID_USB_DEVICE(USB_VENDOR_ID_CANDO, USB_DEVICE_ID_CANDO_MULTI_TOUCH_10_1) },
1352 	{ HID_USB_DEVICE(USB_VENDOR_ID_CANDO, USB_DEVICE_ID_CANDO_MULTI_TOUCH_11_6) },
1353 	{ HID_USB_DEVICE(USB_VENDOR_ID_CANDO, USB_DEVICE_ID_CANDO_MULTI_TOUCH_15_6) },
1354 	{ HID_USB_DEVICE(USB_VENDOR_ID_CHERRY, USB_DEVICE_ID_CHERRY_CYMOTION) },
1355 	{ HID_USB_DEVICE(USB_VENDOR_ID_CHERRY, USB_DEVICE_ID_CHERRY_CYMOTION_SOLAR) },
1356 	{ HID_USB_DEVICE(USB_VENDOR_ID_CHICONY, USB_DEVICE_ID_CHICONY_TACTICAL_PAD) },
1357 	{ HID_USB_DEVICE(USB_VENDOR_ID_CHICONY, USB_DEVICE_ID_CHICONY_WIRELESS) },
1358 	{ HID_USB_DEVICE(USB_VENDOR_ID_CREATIVELABS, USB_DEVICE_ID_PRODIKEYS_PCMIDI) },
1359 	{ HID_USB_DEVICE(USB_VENDOR_ID_CYPRESS, USB_DEVICE_ID_CYPRESS_BARCODE_1) },
1360 	{ HID_USB_DEVICE(USB_VENDOR_ID_CYPRESS, USB_DEVICE_ID_CYPRESS_BARCODE_2) },
1361 	{ HID_USB_DEVICE(USB_VENDOR_ID_CYPRESS, USB_DEVICE_ID_CYPRESS_BARCODE_3) },
1362 	{ HID_USB_DEVICE(USB_VENDOR_ID_CYPRESS, USB_DEVICE_ID_CYPRESS_MOUSE) },
1363 	{ HID_USB_DEVICE(USB_VENDOR_ID_CYPRESS, USB_DEVICE_ID_CYPRESS_TRUETOUCH) },
1364 	{ HID_USB_DEVICE(USB_VENDOR_ID_DRAGONRISE, 0x0006) },
1365 	{ HID_USB_DEVICE(USB_VENDOR_ID_DRAGONRISE, 0x0011) },
1366 	{ HID_USB_DEVICE(USB_VENDOR_ID_DWAV, USB_DEVICE_ID_DWAV_EGALAX_MULTITOUCH) },
1367 	{ HID_USB_DEVICE(USB_VENDOR_ID_DWAV, USB_DEVICE_ID_DWAV_EGALAX_MULTITOUCH1) },
1368 	{ HID_USB_DEVICE(USB_VENDOR_ID_DWAV, USB_DEVICE_ID_DWAV_EGALAX_MULTITOUCH2) },
1369 	{ HID_USB_DEVICE(USB_VENDOR_ID_DWAV, USB_DEVICE_ID_DWAV_EGALAX_MULTITOUCH3) },
1370 	{ HID_USB_DEVICE(USB_VENDOR_ID_DWAV, USB_DEVICE_ID_DWAV_EGALAX_MULTITOUCH4) },
1371 	{ HID_BLUETOOTH_DEVICE(USB_VENDOR_ID_ELECOM, USB_DEVICE_ID_ELECOM_BM084) },
1372 	{ HID_USB_DEVICE(USB_VENDOR_ID_EMS, USB_DEVICE_ID_EMS_TRIO_LINKER_PLUS_II) },
1373 	{ HID_USB_DEVICE(USB_VENDOR_ID_EZKEY, USB_DEVICE_ID_BTC_8193) },
1374 	{ HID_USB_DEVICE(USB_VENDOR_ID_GAMERON, USB_DEVICE_ID_GAMERON_DUAL_PSX_ADAPTOR) },
1375 	{ HID_USB_DEVICE(USB_VENDOR_ID_GAMERON, USB_DEVICE_ID_GAMERON_DUAL_PCS_ADAPTOR) },
1376 	{ HID_USB_DEVICE(USB_VENDOR_ID_GENERAL_TOUCH, USB_DEVICE_ID_GENERAL_TOUCH_WIN7_TWOFINGERS) },
1377 	{ HID_USB_DEVICE(USB_VENDOR_ID_GREENASIA, 0x0003) },
1378 	{ HID_USB_DEVICE(USB_VENDOR_ID_GREENASIA, 0x0012) },
1379 	{ HID_USB_DEVICE(USB_VENDOR_ID_GYRATION, USB_DEVICE_ID_GYRATION_REMOTE) },
1380 	{ HID_USB_DEVICE(USB_VENDOR_ID_GYRATION, USB_DEVICE_ID_GYRATION_REMOTE_2) },
1381 	{ HID_USB_DEVICE(USB_VENDOR_ID_GYRATION, USB_DEVICE_ID_GYRATION_REMOTE_3) },
1382 	{ HID_USB_DEVICE(USB_VENDOR_ID_HANVON, USB_DEVICE_ID_HANVON_MULTITOUCH) },
1383 	{ HID_USB_DEVICE(USB_VENDOR_ID_IRTOUCHSYSTEMS, USB_DEVICE_ID_IRTOUCH_INFRARED_USB) },
1384 	{ HID_USB_DEVICE(USB_VENDOR_ID_KENSINGTON, USB_DEVICE_ID_KS_SLIMBLADE) },
1385 	{ HID_USB_DEVICE(USB_VENDOR_ID_KEYTOUCH, USB_DEVICE_ID_KEYTOUCH_IEC) },
1386 	{ HID_USB_DEVICE(USB_VENDOR_ID_KYE, USB_DEVICE_ID_KYE_ERGO_525V) },
1387 	{ HID_USB_DEVICE(USB_VENDOR_ID_LABTEC, USB_DEVICE_ID_LABTEC_WIRELESS_KEYBOARD) },
1388 	{ HID_USB_DEVICE(USB_VENDOR_ID_LCPOWER, USB_DEVICE_ID_LCPOWER_LC1000 ) },
1389 	{ HID_USB_DEVICE(USB_VENDOR_ID_LOGITECH, USB_DEVICE_ID_MX3000_RECEIVER) },
1390 	{ HID_USB_DEVICE(USB_VENDOR_ID_LOGITECH, USB_DEVICE_ID_S510_RECEIVER) },
1391 	{ HID_USB_DEVICE(USB_VENDOR_ID_LOGITECH, USB_DEVICE_ID_S510_RECEIVER_2) },
1392 	{ HID_USB_DEVICE(USB_VENDOR_ID_LOGITECH, USB_DEVICE_ID_LOGITECH_RECEIVER) },
1393 	{ HID_USB_DEVICE(USB_VENDOR_ID_LOGITECH, USB_DEVICE_ID_DINOVO_DESKTOP) },
1394 	{ HID_USB_DEVICE(USB_VENDOR_ID_LOGITECH, USB_DEVICE_ID_DINOVO_EDGE) },
1395 	{ HID_USB_DEVICE(USB_VENDOR_ID_LOGITECH, USB_DEVICE_ID_DINOVO_MINI) },
1396 	{ HID_USB_DEVICE(USB_VENDOR_ID_LOGITECH, USB_DEVICE_ID_LOGITECH_ELITE_KBD) },
1397 	{ HID_USB_DEVICE(USB_VENDOR_ID_LOGITECH, USB_DEVICE_ID_LOGITECH_CORDLESS_DESKTOP_LX500) },
1398 	{ HID_USB_DEVICE(USB_VENDOR_ID_LOGITECH, USB_DEVICE_ID_LOGITECH_EXTREME_3D) },
1399 	{ HID_USB_DEVICE(USB_VENDOR_ID_LOGITECH, USB_DEVICE_ID_LOGITECH_WHEEL) },
1400 	{ HID_USB_DEVICE(USB_VENDOR_ID_LOGITECH, USB_DEVICE_ID_LOGITECH_RUMBLEPAD_CORD) },
1401 	{ HID_USB_DEVICE(USB_VENDOR_ID_LOGITECH, USB_DEVICE_ID_LOGITECH_RUMBLEPAD) },
1402 	{ HID_USB_DEVICE(USB_VENDOR_ID_LOGITECH, USB_DEVICE_ID_LOGITECH_RUMBLEPAD2_2) },
1403 	{ HID_USB_DEVICE(USB_VENDOR_ID_LOGITECH, USB_DEVICE_ID_LOGITECH_WINGMAN_F3D) },
1404 	{ HID_USB_DEVICE(USB_VENDOR_ID_LOGITECH, USB_DEVICE_ID_LOGITECH_WINGMAN_FFG ) },
1405 	{ HID_USB_DEVICE(USB_VENDOR_ID_LOGITECH, USB_DEVICE_ID_LOGITECH_FORCE3D_PRO) },
1406 	{ HID_USB_DEVICE(USB_VENDOR_ID_LOGITECH, USB_DEVICE_ID_LOGITECH_FLIGHT_SYSTEM_G940) },
1407 	{ HID_USB_DEVICE(USB_VENDOR_ID_LOGITECH, USB_DEVICE_ID_LOGITECH_MOMO_WHEEL) },
1408 	{ HID_USB_DEVICE(USB_VENDOR_ID_LOGITECH, USB_DEVICE_ID_LOGITECH_MOMO_WHEEL2) },
1409 	{ HID_USB_DEVICE(USB_VENDOR_ID_LOGITECH, USB_DEVICE_ID_LOGITECH_DFP_WHEEL) },
1410 	{ HID_USB_DEVICE(USB_VENDOR_ID_LOGITECH, USB_DEVICE_ID_LOGITECH_G25_WHEEL) },
1411 	{ HID_USB_DEVICE(USB_VENDOR_ID_LOGITECH, USB_DEVICE_ID_LOGITECH_WII_WHEEL) },
1412 	{ HID_USB_DEVICE(USB_VENDOR_ID_LOGITECH, USB_DEVICE_ID_LOGITECH_RUMBLEPAD2) },
1413 	{ HID_USB_DEVICE(USB_VENDOR_ID_LOGITECH, USB_DEVICE_ID_SPACETRAVELLER) },
1414 	{ HID_USB_DEVICE(USB_VENDOR_ID_LOGITECH, USB_DEVICE_ID_SPACENAVIGATOR) },
1415 	{ HID_USB_DEVICE(USB_VENDOR_ID_MICROCHIP, USB_DEVICE_ID_PICOLCD) },
1416 	{ HID_USB_DEVICE(USB_VENDOR_ID_MICROCHIP, USB_DEVICE_ID_PICOLCD_BOOTLOADER) },
1417 	{ HID_USB_DEVICE(USB_VENDOR_ID_MICROSOFT, USB_DEVICE_ID_SIDEWINDER_GV) },
1418 	{ HID_USB_DEVICE(USB_VENDOR_ID_MICROSOFT, USB_DEVICE_ID_MS_NE4K) },
1419 	{ HID_USB_DEVICE(USB_VENDOR_ID_MICROSOFT, USB_DEVICE_ID_MS_LK6K) },
1420 	{ HID_USB_DEVICE(USB_VENDOR_ID_MICROSOFT, USB_DEVICE_ID_MS_PRESENTER_8K_USB) },
1421 	{ HID_USB_DEVICE(USB_VENDOR_ID_MICROSOFT, USB_DEVICE_ID_WIRELESS_OPTICAL_DESKTOP_3_0) },
1422 	{ HID_USB_DEVICE(USB_VENDOR_ID_MONTEREY, USB_DEVICE_ID_GENIUS_KB29E) },
1423 	{ HID_USB_DEVICE(USB_VENDOR_ID_NTRIG, USB_DEVICE_ID_NTRIG_TOUCH_SCREEN) },
1424 	{ HID_USB_DEVICE(USB_VENDOR_ID_NTRIG, USB_DEVICE_ID_NTRIG_TOUCH_SCREEN_1) },
1425 	{ HID_USB_DEVICE(USB_VENDOR_ID_NTRIG, USB_DEVICE_ID_NTRIG_TOUCH_SCREEN_2) },
1426 	{ HID_USB_DEVICE(USB_VENDOR_ID_NTRIG, USB_DEVICE_ID_NTRIG_TOUCH_SCREEN_3) },
1427 	{ HID_USB_DEVICE(USB_VENDOR_ID_NTRIG, USB_DEVICE_ID_NTRIG_TOUCH_SCREEN_4) },
1428 	{ HID_USB_DEVICE(USB_VENDOR_ID_NTRIG, USB_DEVICE_ID_NTRIG_TOUCH_SCREEN_5) },
1429 	{ HID_USB_DEVICE(USB_VENDOR_ID_NTRIG, USB_DEVICE_ID_NTRIG_TOUCH_SCREEN_6) },
1430 	{ HID_USB_DEVICE(USB_VENDOR_ID_NTRIG, USB_DEVICE_ID_NTRIG_TOUCH_SCREEN_7) },
1431 	{ HID_USB_DEVICE(USB_VENDOR_ID_NTRIG, USB_DEVICE_ID_NTRIG_TOUCH_SCREEN_8) },
1432 	{ HID_USB_DEVICE(USB_VENDOR_ID_NTRIG, USB_DEVICE_ID_NTRIG_TOUCH_SCREEN_9) },
1433 	{ HID_USB_DEVICE(USB_VENDOR_ID_NTRIG, USB_DEVICE_ID_NTRIG_TOUCH_SCREEN_10) },
1434 	{ HID_USB_DEVICE(USB_VENDOR_ID_NTRIG, USB_DEVICE_ID_NTRIG_TOUCH_SCREEN_11) },
1435 	{ HID_USB_DEVICE(USB_VENDOR_ID_NTRIG, USB_DEVICE_ID_NTRIG_TOUCH_SCREEN_12) },
1436 	{ HID_USB_DEVICE(USB_VENDOR_ID_NTRIG, USB_DEVICE_ID_NTRIG_TOUCH_SCREEN_13) },
1437 	{ HID_USB_DEVICE(USB_VENDOR_ID_NTRIG, USB_DEVICE_ID_NTRIG_TOUCH_SCREEN_14) },
1438 	{ HID_USB_DEVICE(USB_VENDOR_ID_NTRIG, USB_DEVICE_ID_NTRIG_TOUCH_SCREEN_15) },
1439 	{ HID_USB_DEVICE(USB_VENDOR_ID_NTRIG, USB_DEVICE_ID_NTRIG_TOUCH_SCREEN_16) },
1440 	{ HID_USB_DEVICE(USB_VENDOR_ID_NTRIG, USB_DEVICE_ID_NTRIG_TOUCH_SCREEN_17) },
1441 	{ HID_USB_DEVICE(USB_VENDOR_ID_NTRIG, USB_DEVICE_ID_NTRIG_TOUCH_SCREEN_18) },
1442 	{ HID_USB_DEVICE(USB_VENDOR_ID_ORTEK, USB_DEVICE_ID_ORTEK_PKB1700) },
1443 	{ HID_USB_DEVICE(USB_VENDOR_ID_ORTEK, USB_DEVICE_ID_ORTEK_WKB2000) },
1444 	{ HID_USB_DEVICE(USB_VENDOR_ID_PETALYNX, USB_DEVICE_ID_PETALYNX_MAXTER_REMOTE) },
1445 	{ HID_USB_DEVICE(USB_VENDOR_ID_QUANTA, USB_DEVICE_ID_QUANTA_OPTICAL_TOUCH) },
1446 	{ HID_USB_DEVICE(USB_VENDOR_ID_QUANTA, USB_DEVICE_ID_PIXART_IMAGING_INC_OPTICAL_TOUCH_SCREEN) },
1447 	{ HID_USB_DEVICE(USB_VENDOR_ID_ROCCAT, USB_DEVICE_ID_ROCCAT_KONE) },
1448 	{ HID_USB_DEVICE(USB_VENDOR_ID_ROCCAT, USB_DEVICE_ID_ROCCAT_ARVO) },
1449 	{ HID_USB_DEVICE(USB_VENDOR_ID_ROCCAT, USB_DEVICE_ID_ROCCAT_KONEPLUS) },
1450 	{ HID_USB_DEVICE(USB_VENDOR_ID_ROCCAT, USB_DEVICE_ID_ROCCAT_KOVAPLUS) },
1451 	{ HID_USB_DEVICE(USB_VENDOR_ID_ROCCAT, USB_DEVICE_ID_ROCCAT_PYRA_WIRED) },
1452 	{ HID_USB_DEVICE(USB_VENDOR_ID_ROCCAT, USB_DEVICE_ID_ROCCAT_PYRA_WIRELESS) },
1453 	{ HID_USB_DEVICE(USB_VENDOR_ID_SAMSUNG, USB_DEVICE_ID_SAMSUNG_IR_REMOTE) },
1454 	{ HID_USB_DEVICE(USB_VENDOR_ID_SAMSUNG, USB_DEVICE_ID_SAMSUNG_WIRELESS_KBD_MOUSE) },
1455 	{ HID_USB_DEVICE(USB_VENDOR_ID_SKYCABLE, USB_DEVICE_ID_SKYCABLE_WIRELESS_PRESENTER) },
1456 	{ HID_USB_DEVICE(USB_VENDOR_ID_SONY, USB_DEVICE_ID_SONY_PS3_CONTROLLER) },
1457 	{ HID_BLUETOOTH_DEVICE(USB_VENDOR_ID_SONY, USB_DEVICE_ID_SONY_PS3_CONTROLLER) },
1458 	{ HID_USB_DEVICE(USB_VENDOR_ID_SONY, USB_DEVICE_ID_SONY_VAIO_VGX_MOUSE) },
1459 	{ HID_USB_DEVICE(USB_VENDOR_ID_STANTUM, USB_DEVICE_ID_MTP) },
1460 	{ HID_USB_DEVICE(USB_VENDOR_ID_STANTUM_STM, USB_DEVICE_ID_MTP_STM) },
1461 	{ HID_USB_DEVICE(USB_VENDOR_ID_STANTUM_SITRONIX, USB_DEVICE_ID_MTP_SITRONIX) },
1462 	{ HID_USB_DEVICE(USB_VENDOR_ID_SUNPLUS, USB_DEVICE_ID_SUNPLUS_WDESKTOP) },
1463 	{ HID_USB_DEVICE(USB_VENDOR_ID_THRUSTMASTER, 0xb300) },
1464 	{ HID_USB_DEVICE(USB_VENDOR_ID_THRUSTMASTER, 0xb304) },
1465 	{ HID_USB_DEVICE(USB_VENDOR_ID_THRUSTMASTER, 0xb323) },
1466 	{ HID_USB_DEVICE(USB_VENDOR_ID_THRUSTMASTER, 0xb324) },
1467 	{ HID_USB_DEVICE(USB_VENDOR_ID_THRUSTMASTER, 0xb651) },
1468 	{ HID_USB_DEVICE(USB_VENDOR_ID_THRUSTMASTER, 0xb653) },
1469 	{ HID_USB_DEVICE(USB_VENDOR_ID_THRUSTMASTER, 0xb654) },
1470 	{ HID_USB_DEVICE(USB_VENDOR_ID_THRUSTMASTER, 0xb65a) },
1471 	{ HID_USB_DEVICE(USB_VENDOR_ID_TOPSEED, USB_DEVICE_ID_TOPSEED_CYBERLINK) },
1472 	{ HID_USB_DEVICE(USB_VENDOR_ID_TOPSEED2, USB_DEVICE_ID_TOPSEED2_RF_COMBO) },
1473 	{ HID_USB_DEVICE(USB_VENDOR_ID_TWINHAN, USB_DEVICE_ID_TWINHAN_IR_REMOTE) },
1474 	{ HID_USB_DEVICE(USB_VENDOR_ID_TURBOX, USB_DEVICE_ID_TURBOX_TOUCHSCREEN_MOSART) },
1475 	{ HID_USB_DEVICE(USB_VENDOR_ID_UCLOGIC, USB_DEVICE_ID_UCLOGIC_TABLET_PF1209) },
1476 	{ HID_USB_DEVICE(USB_VENDOR_ID_UCLOGIC, USB_DEVICE_ID_UCLOGIC_TABLET_WP4030U) },
1477 	{ HID_USB_DEVICE(USB_VENDOR_ID_UCLOGIC, USB_DEVICE_ID_UCLOGIC_TABLET_WP5540U) },
1478 	{ HID_USB_DEVICE(USB_VENDOR_ID_UCLOGIC, USB_DEVICE_ID_UCLOGIC_TABLET_WP8060U) },
1479 	{ HID_USB_DEVICE(USB_VENDOR_ID_WISEGROUP, USB_DEVICE_ID_SMARTJOY_PLUS) },
1480 	{ HID_BLUETOOTH_DEVICE(USB_VENDOR_ID_WACOM, USB_DEVICE_ID_WACOM_GRAPHIRE_BLUETOOTH) },
1481 	{ HID_USB_DEVICE(USB_VENDOR_ID_WALTOP, USB_DEVICE_ID_WALTOP_SLIM_TABLET_5_8_INCH) },
1482 	{ HID_USB_DEVICE(USB_VENDOR_ID_WALTOP, USB_DEVICE_ID_WALTOP_SLIM_TABLET_12_1_INCH) },
1483 	{ HID_USB_DEVICE(USB_VENDOR_ID_WALTOP, USB_DEVICE_ID_WALTOP_MEDIA_TABLET_10_6_INCH) },
1484 	{ HID_USB_DEVICE(USB_VENDOR_ID_WALTOP, USB_DEVICE_ID_WALTOP_MEDIA_TABLET_14_1_INCH) },
1485 	{ HID_USB_DEVICE(USB_VENDOR_ID_ZEROPLUS, 0x0005) },
1486 	{ HID_USB_DEVICE(USB_VENDOR_ID_ZEROPLUS, 0x0030) },
1487 	{ HID_USB_DEVICE(USB_VENDOR_ID_ZYDACRON, USB_DEVICE_ID_ZYDACRON_REMOTE_CONTROL) },
1488 
1489 	{ HID_BLUETOOTH_DEVICE(USB_VENDOR_ID_MICROSOFT, USB_DEVICE_ID_MS_PRESENTER_8K_BT) },
1490 	{ }
1491 };
1492 
1493 struct hid_dynid {
1494 	struct list_head list;
1495 	struct hid_device_id id;
1496 };
1497 
1498 /**
1499  * store_new_id - add a new HID device ID to this driver and re-probe devices
1500  * @driver: target device driver
1501  * @buf: buffer for scanning device ID data
1502  * @count: input size
1503  *
1504  * Adds a new dynamic hid device ID to this driver,
1505  * and causes the driver to probe for all devices again.
1506  */
store_new_id(struct device_driver * drv,const char * buf,size_t count)1507 static ssize_t store_new_id(struct device_driver *drv, const char *buf,
1508 		size_t count)
1509 {
1510 	struct hid_driver *hdrv = container_of(drv, struct hid_driver, driver);
1511 	struct hid_dynid *dynid;
1512 	__u32 bus, vendor, product;
1513 	unsigned long driver_data = 0;
1514 	int ret;
1515 
1516 	ret = sscanf(buf, "%x %x %x %lx",
1517 			&bus, &vendor, &product, &driver_data);
1518 	if (ret < 3)
1519 		return -EINVAL;
1520 
1521 	dynid = kzalloc(sizeof(*dynid), GFP_KERNEL);
1522 	if (!dynid)
1523 		return -ENOMEM;
1524 
1525 	dynid->id.bus = bus;
1526 	dynid->id.vendor = vendor;
1527 	dynid->id.product = product;
1528 	dynid->id.driver_data = driver_data;
1529 
1530 	spin_lock(&hdrv->dyn_lock);
1531 	list_add_tail(&dynid->list, &hdrv->dyn_list);
1532 	spin_unlock(&hdrv->dyn_lock);
1533 
1534 	ret = 0;
1535 	if (get_driver(&hdrv->driver)) {
1536 		ret = driver_attach(&hdrv->driver);
1537 		put_driver(&hdrv->driver);
1538 	}
1539 
1540 	return ret ? : count;
1541 }
1542 static DRIVER_ATTR(new_id, S_IWUSR, NULL, store_new_id);
1543 
hid_free_dynids(struct hid_driver * hdrv)1544 static void hid_free_dynids(struct hid_driver *hdrv)
1545 {
1546 	struct hid_dynid *dynid, *n;
1547 
1548 	spin_lock(&hdrv->dyn_lock);
1549 	list_for_each_entry_safe(dynid, n, &hdrv->dyn_list, list) {
1550 		list_del(&dynid->list);
1551 		kfree(dynid);
1552 	}
1553 	spin_unlock(&hdrv->dyn_lock);
1554 }
1555 
hid_match_device(struct hid_device * hdev,struct hid_driver * hdrv)1556 static const struct hid_device_id *hid_match_device(struct hid_device *hdev,
1557 		struct hid_driver *hdrv)
1558 {
1559 	struct hid_dynid *dynid;
1560 
1561 	spin_lock(&hdrv->dyn_lock);
1562 	list_for_each_entry(dynid, &hdrv->dyn_list, list) {
1563 		if (hid_match_one_id(hdev, &dynid->id)) {
1564 			spin_unlock(&hdrv->dyn_lock);
1565 			return &dynid->id;
1566 		}
1567 	}
1568 	spin_unlock(&hdrv->dyn_lock);
1569 
1570 	return hid_match_id(hdev, hdrv->id_table);
1571 }
1572 
hid_bus_match(struct device * dev,struct device_driver * drv)1573 static int hid_bus_match(struct device *dev, struct device_driver *drv)
1574 {
1575 	struct hid_driver *hdrv = container_of(drv, struct hid_driver, driver);
1576 	struct hid_device *hdev = container_of(dev, struct hid_device, dev);
1577 
1578 	if (!hid_match_device(hdev, hdrv))
1579 		return 0;
1580 
1581 	/* generic wants all that don't have specialized driver */
1582 	if (!strncmp(hdrv->name, "generic-", 8))
1583 		return !hid_match_id(hdev, hid_have_special_driver);
1584 
1585 	return 1;
1586 }
1587 
hid_device_probe(struct device * dev)1588 static int hid_device_probe(struct device *dev)
1589 {
1590 	struct hid_driver *hdrv = container_of(dev->driver,
1591 			struct hid_driver, driver);
1592 	struct hid_device *hdev = container_of(dev, struct hid_device, dev);
1593 	const struct hid_device_id *id;
1594 	int ret = 0;
1595 
1596 	if (!hdev->driver) {
1597 		id = hid_match_device(hdev, hdrv);
1598 		if (id == NULL)
1599 			return -ENODEV;
1600 
1601 		hdev->driver = hdrv;
1602 		if (hdrv->probe) {
1603 			ret = hdrv->probe(hdev, id);
1604 		} else { /* default probe */
1605 			ret = hid_parse(hdev);
1606 			if (!ret)
1607 				ret = hid_hw_start(hdev, HID_CONNECT_DEFAULT);
1608 		}
1609 		if (ret)
1610 			hdev->driver = NULL;
1611 	}
1612 	return ret;
1613 }
1614 
hid_device_remove(struct device * dev)1615 static int hid_device_remove(struct device *dev)
1616 {
1617 	struct hid_device *hdev = container_of(dev, struct hid_device, dev);
1618 	struct hid_driver *hdrv = hdev->driver;
1619 
1620 	if (hdrv) {
1621 		if (hdrv->remove)
1622 			hdrv->remove(hdev);
1623 		else /* default remove */
1624 			hid_hw_stop(hdev);
1625 		hdev->driver = NULL;
1626 	}
1627 
1628 	return 0;
1629 }
1630 
hid_uevent(struct device * dev,struct kobj_uevent_env * env)1631 static int hid_uevent(struct device *dev, struct kobj_uevent_env *env)
1632 {
1633 	struct hid_device *hdev = container_of(dev, struct hid_device, dev);
1634 
1635 	if (add_uevent_var(env, "HID_ID=%04X:%08X:%08X",
1636 			hdev->bus, hdev->vendor, hdev->product))
1637 		return -ENOMEM;
1638 
1639 	if (add_uevent_var(env, "HID_NAME=%s", hdev->name))
1640 		return -ENOMEM;
1641 
1642 	if (add_uevent_var(env, "HID_PHYS=%s", hdev->phys))
1643 		return -ENOMEM;
1644 
1645 	if (add_uevent_var(env, "HID_UNIQ=%s", hdev->uniq))
1646 		return -ENOMEM;
1647 
1648 	if (add_uevent_var(env, "MODALIAS=hid:b%04Xv%08Xp%08X",
1649 			hdev->bus, hdev->vendor, hdev->product))
1650 		return -ENOMEM;
1651 
1652 	return 0;
1653 }
1654 
1655 static struct bus_type hid_bus_type = {
1656 	.name		= "hid",
1657 	.match		= hid_bus_match,
1658 	.probe		= hid_device_probe,
1659 	.remove		= hid_device_remove,
1660 	.uevent		= hid_uevent,
1661 };
1662 
1663 /* a list of devices that shouldn't be handled by HID core at all */
1664 static const struct hid_device_id hid_ignore_list[] = {
1665 	{ HID_USB_DEVICE(USB_VENDOR_ID_ACECAD, USB_DEVICE_ID_ACECAD_FLAIR) },
1666 	{ HID_USB_DEVICE(USB_VENDOR_ID_ACECAD, USB_DEVICE_ID_ACECAD_302) },
1667 	{ HID_USB_DEVICE(USB_VENDOR_ID_ADS_TECH, USB_DEVICE_ID_ADS_TECH_RADIO_SI470X) },
1668 	{ HID_USB_DEVICE(USB_VENDOR_ID_AIPTEK, USB_DEVICE_ID_AIPTEK_01) },
1669 	{ HID_USB_DEVICE(USB_VENDOR_ID_AIPTEK, USB_DEVICE_ID_AIPTEK_10) },
1670 	{ HID_USB_DEVICE(USB_VENDOR_ID_AIPTEK, USB_DEVICE_ID_AIPTEK_20) },
1671 	{ HID_USB_DEVICE(USB_VENDOR_ID_AIPTEK, USB_DEVICE_ID_AIPTEK_21) },
1672 	{ HID_USB_DEVICE(USB_VENDOR_ID_AIPTEK, USB_DEVICE_ID_AIPTEK_22) },
1673 	{ HID_USB_DEVICE(USB_VENDOR_ID_AIPTEK, USB_DEVICE_ID_AIPTEK_23) },
1674 	{ HID_USB_DEVICE(USB_VENDOR_ID_AIPTEK, USB_DEVICE_ID_AIPTEK_24) },
1675 	{ HID_USB_DEVICE(USB_VENDOR_ID_AIRCABLE, USB_DEVICE_ID_AIRCABLE1) },
1676 	{ HID_USB_DEVICE(USB_VENDOR_ID_ALCOR, USB_DEVICE_ID_ALCOR_USBRS232) },
1677 	{ HID_USB_DEVICE(USB_VENDOR_ID_ASUSTEK, USB_DEVICE_ID_ASUSTEK_LCM)},
1678 	{ HID_USB_DEVICE(USB_VENDOR_ID_ASUSTEK, USB_DEVICE_ID_ASUSTEK_LCM2)},
1679 	{ HID_USB_DEVICE(USB_VENDOR_ID_AVERMEDIA, USB_DEVICE_ID_AVER_FM_MR800) },
1680 	{ HID_USB_DEVICE(USB_VENDOR_ID_BERKSHIRE, USB_DEVICE_ID_BERKSHIRE_PCWD) },
1681 	{ HID_USB_DEVICE(USB_VENDOR_ID_CIDC, 0x0103) },
1682 	{ HID_USB_DEVICE(USB_VENDOR_ID_CYGNAL, USB_DEVICE_ID_CYGNAL_RADIO_SI470X) },
1683 	{ HID_USB_DEVICE(USB_VENDOR_ID_CMEDIA, USB_DEVICE_ID_CM109) },
1684 	{ HID_USB_DEVICE(USB_VENDOR_ID_CYPRESS, USB_DEVICE_ID_CYPRESS_HIDCOM) },
1685 	{ HID_USB_DEVICE(USB_VENDOR_ID_CYPRESS, USB_DEVICE_ID_CYPRESS_ULTRAMOUSE) },
1686 	{ HID_USB_DEVICE(USB_VENDOR_ID_DEALEXTREAME, USB_DEVICE_ID_DEALEXTREAME_RADIO_SI4701) },
1687 	{ HID_USB_DEVICE(USB_VENDOR_ID_DELORME, USB_DEVICE_ID_DELORME_EARTHMATE) },
1688 	{ HID_USB_DEVICE(USB_VENDOR_ID_DELORME, USB_DEVICE_ID_DELORME_EM_LT20) },
1689 	{ HID_USB_DEVICE(USB_VENDOR_ID_DREAM_CHEEKY, 0x0004) },
1690 	{ HID_USB_DEVICE(USB_VENDOR_ID_ESSENTIAL_REALITY, USB_DEVICE_ID_ESSENTIAL_REALITY_P5) },
1691 	{ HID_USB_DEVICE(USB_VENDOR_ID_ETT, USB_DEVICE_ID_TC5UH) },
1692 	{ HID_USB_DEVICE(USB_VENDOR_ID_ETT, USB_DEVICE_ID_TC4UM) },
1693 	{ HID_USB_DEVICE(USB_VENDOR_ID_GENERAL_TOUCH, 0x0002) },
1694 	{ HID_USB_DEVICE(USB_VENDOR_ID_GENERAL_TOUCH, 0x0003) },
1695 	{ HID_USB_DEVICE(USB_VENDOR_ID_GENERAL_TOUCH, 0x0004) },
1696 	{ HID_USB_DEVICE(USB_VENDOR_ID_GLAB, USB_DEVICE_ID_4_PHIDGETSERVO_30) },
1697 	{ HID_USB_DEVICE(USB_VENDOR_ID_GLAB, USB_DEVICE_ID_1_PHIDGETSERVO_30) },
1698 	{ HID_USB_DEVICE(USB_VENDOR_ID_GLAB, USB_DEVICE_ID_0_0_4_IF_KIT) },
1699 	{ HID_USB_DEVICE(USB_VENDOR_ID_GLAB, USB_DEVICE_ID_0_16_16_IF_KIT) },
1700 	{ HID_USB_DEVICE(USB_VENDOR_ID_GLAB, USB_DEVICE_ID_8_8_8_IF_KIT) },
1701 	{ HID_USB_DEVICE(USB_VENDOR_ID_GLAB, USB_DEVICE_ID_0_8_7_IF_KIT) },
1702 	{ HID_USB_DEVICE(USB_VENDOR_ID_GLAB, USB_DEVICE_ID_0_8_8_IF_KIT) },
1703 	{ HID_USB_DEVICE(USB_VENDOR_ID_GLAB, USB_DEVICE_ID_PHIDGET_MOTORCONTROL) },
1704 	{ HID_USB_DEVICE(USB_VENDOR_ID_GOTOP, USB_DEVICE_ID_SUPER_Q2) },
1705 	{ HID_USB_DEVICE(USB_VENDOR_ID_GOTOP, USB_DEVICE_ID_GOGOPEN) },
1706 	{ HID_USB_DEVICE(USB_VENDOR_ID_GOTOP, USB_DEVICE_ID_PENPOWER) },
1707 	{ HID_USB_DEVICE(USB_VENDOR_ID_GRETAGMACBETH, USB_DEVICE_ID_GRETAGMACBETH_HUEY) },
1708 	{ HID_USB_DEVICE(USB_VENDOR_ID_GRIFFIN, USB_DEVICE_ID_POWERMATE) },
1709 	{ HID_USB_DEVICE(USB_VENDOR_ID_GRIFFIN, USB_DEVICE_ID_SOUNDKNOB) },
1710 	{ HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_90) },
1711 	{ HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_100) },
1712 	{ HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_101) },
1713 	{ HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_103) },
1714 	{ HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_104) },
1715 	{ HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_105) },
1716 	{ HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_106) },
1717 	{ HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_107) },
1718 	{ HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_108) },
1719 	{ HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_200) },
1720 	{ HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_201) },
1721 	{ HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_202) },
1722 	{ HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_203) },
1723 	{ HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_204) },
1724 	{ HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_205) },
1725 	{ HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_206) },
1726 	{ HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_207) },
1727 	{ HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_300) },
1728 	{ HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_301) },
1729 	{ HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_302) },
1730 	{ HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_303) },
1731 	{ HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_304) },
1732 	{ HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_305) },
1733 	{ HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_306) },
1734 	{ HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_307) },
1735 	{ HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_308) },
1736 	{ HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_309) },
1737 	{ HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_400) },
1738 	{ HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_401) },
1739 	{ HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_402) },
1740 	{ HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_403) },
1741 	{ HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_404) },
1742 	{ HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_405) },
1743 	{ HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_500) },
1744 	{ HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_501) },
1745 	{ HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_502) },
1746 	{ HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_503) },
1747 	{ HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_504) },
1748 	{ HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_1000) },
1749 	{ HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_1001) },
1750 	{ HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_1002) },
1751 	{ HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_1003) },
1752 	{ HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_1004) },
1753 	{ HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_1005) },
1754 	{ HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_1006) },
1755 	{ HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_1007) },
1756 	{ HID_USB_DEVICE(USB_VENDOR_ID_IMATION, USB_DEVICE_ID_DISC_STAKKA) },
1757 	{ HID_USB_DEVICE(USB_VENDOR_ID_JESS, USB_DEVICE_ID_JESS_YUREX) },
1758 	{ HID_USB_DEVICE(USB_VENDOR_ID_KBGEAR, USB_DEVICE_ID_KBGEAR_JAMSTUDIO) },
1759 	{ HID_USB_DEVICE(USB_VENDOR_ID_KWORLD, USB_DEVICE_ID_KWORLD_RADIO_FM700) },
1760 	{ HID_USB_DEVICE(USB_VENDOR_ID_KYE, USB_DEVICE_ID_KYE_GPEN_560) },
1761 	{ HID_BLUETOOTH_DEVICE(USB_VENDOR_ID_KYE, 0x0058) },
1762 	{ HID_USB_DEVICE(USB_VENDOR_ID_LD, USB_DEVICE_ID_LD_CASSY) },
1763 	{ HID_USB_DEVICE(USB_VENDOR_ID_LD, USB_DEVICE_ID_LD_POCKETCASSY) },
1764 	{ HID_USB_DEVICE(USB_VENDOR_ID_LD, USB_DEVICE_ID_LD_MOBILECASSY) },
1765 	{ HID_USB_DEVICE(USB_VENDOR_ID_LD, USB_DEVICE_ID_LD_JWM) },
1766 	{ HID_USB_DEVICE(USB_VENDOR_ID_LD, USB_DEVICE_ID_LD_DMMP) },
1767 	{ HID_USB_DEVICE(USB_VENDOR_ID_LD, USB_DEVICE_ID_LD_UMIP) },
1768 	{ HID_USB_DEVICE(USB_VENDOR_ID_LD, USB_DEVICE_ID_LD_XRAY1) },
1769 	{ HID_USB_DEVICE(USB_VENDOR_ID_LD, USB_DEVICE_ID_LD_XRAY2) },
1770 	{ HID_USB_DEVICE(USB_VENDOR_ID_LD, USB_DEVICE_ID_LD_VIDEOCOM) },
1771 	{ HID_USB_DEVICE(USB_VENDOR_ID_LD, USB_DEVICE_ID_LD_COM3LAB) },
1772 	{ HID_USB_DEVICE(USB_VENDOR_ID_LD, USB_DEVICE_ID_LD_TELEPORT) },
1773 	{ HID_USB_DEVICE(USB_VENDOR_ID_LD, USB_DEVICE_ID_LD_NETWORKANALYSER) },
1774 	{ HID_USB_DEVICE(USB_VENDOR_ID_LD, USB_DEVICE_ID_LD_POWERCONTROL) },
1775 	{ HID_USB_DEVICE(USB_VENDOR_ID_LD, USB_DEVICE_ID_LD_MACHINETEST) },
1776 	{ HID_USB_DEVICE(USB_VENDOR_ID_MCC, USB_DEVICE_ID_MCC_PMD1024LS) },
1777 	{ HID_USB_DEVICE(USB_VENDOR_ID_MCC, USB_DEVICE_ID_MCC_PMD1208LS) },
1778 	{ HID_USB_DEVICE(USB_VENDOR_ID_MICROCHIP, USB_DEVICE_ID_PICKIT1) },
1779 	{ HID_USB_DEVICE(USB_VENDOR_ID_MICROCHIP, USB_DEVICE_ID_PICKIT2) },
1780 	{ HID_USB_DEVICE(USB_VENDOR_ID_NATIONAL_SEMICONDUCTOR, USB_DEVICE_ID_N_S_HARMONY) },
1781 	{ HID_USB_DEVICE(USB_VENDOR_ID_ONTRAK, USB_DEVICE_ID_ONTRAK_ADU100) },
1782 	{ HID_USB_DEVICE(USB_VENDOR_ID_ONTRAK, USB_DEVICE_ID_ONTRAK_ADU100 + 20) },
1783 	{ HID_USB_DEVICE(USB_VENDOR_ID_ONTRAK, USB_DEVICE_ID_ONTRAK_ADU100 + 30) },
1784 	{ HID_USB_DEVICE(USB_VENDOR_ID_ONTRAK, USB_DEVICE_ID_ONTRAK_ADU100 + 100) },
1785 	{ HID_USB_DEVICE(USB_VENDOR_ID_ONTRAK, USB_DEVICE_ID_ONTRAK_ADU100 + 108) },
1786 	{ HID_USB_DEVICE(USB_VENDOR_ID_ONTRAK, USB_DEVICE_ID_ONTRAK_ADU100 + 118) },
1787 	{ HID_USB_DEVICE(USB_VENDOR_ID_ONTRAK, USB_DEVICE_ID_ONTRAK_ADU100 + 200) },
1788 	{ HID_USB_DEVICE(USB_VENDOR_ID_ONTRAK, USB_DEVICE_ID_ONTRAK_ADU100 + 300) },
1789 	{ HID_USB_DEVICE(USB_VENDOR_ID_ONTRAK, USB_DEVICE_ID_ONTRAK_ADU100 + 400) },
1790 	{ HID_USB_DEVICE(USB_VENDOR_ID_ONTRAK, USB_DEVICE_ID_ONTRAK_ADU100 + 500) },
1791 	{ HID_USB_DEVICE(USB_VENDOR_ID_PANJIT, 0x0001) },
1792 	{ HID_USB_DEVICE(USB_VENDOR_ID_PANJIT, 0x0002) },
1793 	{ HID_USB_DEVICE(USB_VENDOR_ID_PANJIT, 0x0003) },
1794 	{ HID_USB_DEVICE(USB_VENDOR_ID_PANJIT, 0x0004) },
1795 	{ HID_USB_DEVICE(USB_VENDOR_ID_PHILIPS, USB_DEVICE_ID_PHILIPS_IEEE802154_DONGLE) },
1796 	{ HID_USB_DEVICE(USB_VENDOR_ID_POWERCOM, USB_DEVICE_ID_POWERCOM_UPS) },
1797 	{ HID_USB_DEVICE(USB_VENDOR_ID_VERNIER, USB_DEVICE_ID_VERNIER_LABPRO) },
1798 	{ HID_USB_DEVICE(USB_VENDOR_ID_VERNIER, USB_DEVICE_ID_VERNIER_GOTEMP) },
1799 	{ HID_USB_DEVICE(USB_VENDOR_ID_VERNIER, USB_DEVICE_ID_VERNIER_SKIP) },
1800 	{ HID_USB_DEVICE(USB_VENDOR_ID_VERNIER, USB_DEVICE_ID_VERNIER_CYCLOPS) },
1801 	{ HID_USB_DEVICE(USB_VENDOR_ID_VERNIER, USB_DEVICE_ID_VERNIER_LCSPEC) },
1802 	{ HID_USB_DEVICE(USB_VENDOR_ID_WACOM, HID_ANY_ID) },
1803 	{ HID_USB_DEVICE(USB_VENDOR_ID_WISEGROUP, USB_DEVICE_ID_4_PHIDGETSERVO_20) },
1804 	{ HID_USB_DEVICE(USB_VENDOR_ID_WISEGROUP, USB_DEVICE_ID_1_PHIDGETSERVO_20) },
1805 	{ HID_USB_DEVICE(USB_VENDOR_ID_WISEGROUP, USB_DEVICE_ID_8_8_4_IF_KIT) },
1806 	{ HID_USB_DEVICE(USB_VENDOR_ID_YEALINK, USB_DEVICE_ID_YEALINK_P1K_P4K_B2K) },
1807 	{ }
1808 };
1809 
1810 /**
1811  * hid_mouse_ignore_list - mouse devices which should not be handled by the hid layer
1812  *
1813  * There are composite devices for which we want to ignore only a certain
1814  * interface. This is a list of devices for which only the mouse interface will
1815  * be ignored. This allows a dedicated driver to take care of the interface.
1816  */
1817 static const struct hid_device_id hid_mouse_ignore_list[] = {
1818 	/* appletouch driver */
1819 	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_FOUNTAIN_ANSI) },
1820 	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_FOUNTAIN_ISO) },
1821 	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_GEYSER_ANSI) },
1822 	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_GEYSER_ISO) },
1823 	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_GEYSER_JIS) },
1824 	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_GEYSER3_ANSI) },
1825 	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_GEYSER3_ISO) },
1826 	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_GEYSER3_JIS) },
1827 	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_GEYSER4_ANSI) },
1828 	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_GEYSER4_ISO) },
1829 	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_GEYSER4_JIS) },
1830 	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_GEYSER4_HF_ANSI) },
1831 	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_GEYSER4_HF_ISO) },
1832 	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_GEYSER4_HF_JIS) },
1833 	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING_ANSI) },
1834 	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING_ISO) },
1835 	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING_JIS) },
1836 	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING2_ANSI) },
1837 	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING2_ISO) },
1838 	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING2_JIS) },
1839 	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING3_ANSI) },
1840 	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING3_ISO) },
1841 	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING3_JIS) },
1842 	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING4_ANSI) },
1843 	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING4_ISO) },
1844 	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING4_JIS) },
1845 	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING4A_ANSI) },
1846 	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING4A_ISO) },
1847 	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING4A_JIS) },
1848 	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING5_ANSI) },
1849 	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING5_ISO) },
1850 	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING5_JIS) },
1851 	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_FOUNTAIN_TP_ONLY) },
1852 	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_GEYSER1_TP_ONLY) },
1853 	{ }
1854 };
1855 
hid_ignore(struct hid_device * hdev)1856 static bool hid_ignore(struct hid_device *hdev)
1857 {
1858 	switch (hdev->vendor) {
1859 	case USB_VENDOR_ID_CODEMERCS:
1860 		/* ignore all Code Mercenaries IOWarrior devices */
1861 		if (hdev->product >= USB_DEVICE_ID_CODEMERCS_IOW_FIRST &&
1862 				hdev->product <= USB_DEVICE_ID_CODEMERCS_IOW_LAST)
1863 			return true;
1864 		break;
1865 	case USB_VENDOR_ID_LOGITECH:
1866 		if (hdev->product >= USB_DEVICE_ID_LOGITECH_HARMONY_FIRST &&
1867 				hdev->product <= USB_DEVICE_ID_LOGITECH_HARMONY_LAST)
1868 			return true;
1869 		break;
1870 	case USB_VENDOR_ID_SOUNDGRAPH:
1871 		if (hdev->product >= USB_DEVICE_ID_SOUNDGRAPH_IMON_FIRST &&
1872 		    hdev->product <= USB_DEVICE_ID_SOUNDGRAPH_IMON_LAST)
1873 			return true;
1874 		break;
1875 	case USB_VENDOR_ID_HANWANG:
1876 		if (hdev->product >= USB_DEVICE_ID_HANWANG_TABLET_FIRST &&
1877 		    hdev->product <= USB_DEVICE_ID_HANWANG_TABLET_LAST)
1878 			return true;
1879 		break;
1880 	}
1881 
1882 	if (hdev->type == HID_TYPE_USBMOUSE &&
1883 			hid_match_id(hdev, hid_mouse_ignore_list))
1884 		return true;
1885 
1886 	return !!hid_match_id(hdev, hid_ignore_list);
1887 }
1888 
hid_add_device(struct hid_device * hdev)1889 int hid_add_device(struct hid_device *hdev)
1890 {
1891 	static atomic_t id = ATOMIC_INIT(0);
1892 	int ret;
1893 
1894 	if (WARN_ON(hdev->status & HID_STAT_ADDED))
1895 		return -EBUSY;
1896 
1897 	/* we need to kill them here, otherwise they will stay allocated to
1898 	 * wait for coming driver */
1899 	if (!(hdev->quirks & HID_QUIRK_NO_IGNORE)
1900             && (hid_ignore(hdev) || (hdev->quirks & HID_QUIRK_IGNORE)))
1901 		return -ENODEV;
1902 
1903 	/* XXX hack, any other cleaner solution after the driver core
1904 	 * is converted to allow more than 20 bytes as the device name? */
1905 	dev_set_name(&hdev->dev, "%04X:%04X:%04X.%04X", hdev->bus,
1906 		     hdev->vendor, hdev->product, atomic_inc_return(&id));
1907 
1908 	hid_debug_register(hdev, dev_name(&hdev->dev));
1909 	ret = device_add(&hdev->dev);
1910 	if (!ret)
1911 		hdev->status |= HID_STAT_ADDED;
1912 	else
1913 		hid_debug_unregister(hdev);
1914 
1915 	return ret;
1916 }
1917 EXPORT_SYMBOL_GPL(hid_add_device);
1918 
1919 /**
1920  * hid_allocate_device - allocate new hid device descriptor
1921  *
1922  * Allocate and initialize hid device, so that hid_destroy_device might be
1923  * used to free it.
1924  *
1925  * New hid_device pointer is returned on success, otherwise ERR_PTR encoded
1926  * error value.
1927  */
hid_allocate_device(void)1928 struct hid_device *hid_allocate_device(void)
1929 {
1930 	struct hid_device *hdev;
1931 	unsigned int i;
1932 	int ret = -ENOMEM;
1933 
1934 	hdev = kzalloc(sizeof(*hdev), GFP_KERNEL);
1935 	if (hdev == NULL)
1936 		return ERR_PTR(ret);
1937 
1938 	device_initialize(&hdev->dev);
1939 	hdev->dev.release = hid_device_release;
1940 	hdev->dev.bus = &hid_bus_type;
1941 
1942 	hdev->collection = kcalloc(HID_DEFAULT_NUM_COLLECTIONS,
1943 			sizeof(struct hid_collection), GFP_KERNEL);
1944 	if (hdev->collection == NULL)
1945 		goto err;
1946 	hdev->collection_size = HID_DEFAULT_NUM_COLLECTIONS;
1947 
1948 	for (i = 0; i < HID_REPORT_TYPES; i++)
1949 		INIT_LIST_HEAD(&hdev->report_enum[i].report_list);
1950 
1951 	init_waitqueue_head(&hdev->debug_wait);
1952 	INIT_LIST_HEAD(&hdev->debug_list);
1953 
1954 	return hdev;
1955 err:
1956 	put_device(&hdev->dev);
1957 	return ERR_PTR(ret);
1958 }
1959 EXPORT_SYMBOL_GPL(hid_allocate_device);
1960 
hid_remove_device(struct hid_device * hdev)1961 static void hid_remove_device(struct hid_device *hdev)
1962 {
1963 	if (hdev->status & HID_STAT_ADDED) {
1964 		device_del(&hdev->dev);
1965 		hid_debug_unregister(hdev);
1966 		hdev->status &= ~HID_STAT_ADDED;
1967 	}
1968 }
1969 
1970 /**
1971  * hid_destroy_device - free previously allocated device
1972  *
1973  * @hdev: hid device
1974  *
1975  * If you allocate hid_device through hid_allocate_device, you should ever
1976  * free by this function.
1977  */
hid_destroy_device(struct hid_device * hdev)1978 void hid_destroy_device(struct hid_device *hdev)
1979 {
1980 	hid_remove_device(hdev);
1981 	put_device(&hdev->dev);
1982 }
1983 EXPORT_SYMBOL_GPL(hid_destroy_device);
1984 
__hid_register_driver(struct hid_driver * hdrv,struct module * owner,const char * mod_name)1985 int __hid_register_driver(struct hid_driver *hdrv, struct module *owner,
1986 		const char *mod_name)
1987 {
1988 	int ret;
1989 
1990 	hdrv->driver.name = hdrv->name;
1991 	hdrv->driver.bus = &hid_bus_type;
1992 	hdrv->driver.owner = owner;
1993 	hdrv->driver.mod_name = mod_name;
1994 
1995 	INIT_LIST_HEAD(&hdrv->dyn_list);
1996 	spin_lock_init(&hdrv->dyn_lock);
1997 
1998 	ret = driver_register(&hdrv->driver);
1999 	if (ret)
2000 		return ret;
2001 
2002 	ret = driver_create_file(&hdrv->driver, &driver_attr_new_id);
2003 	if (ret)
2004 		driver_unregister(&hdrv->driver);
2005 
2006 	return ret;
2007 }
2008 EXPORT_SYMBOL_GPL(__hid_register_driver);
2009 
hid_unregister_driver(struct hid_driver * hdrv)2010 void hid_unregister_driver(struct hid_driver *hdrv)
2011 {
2012 	driver_remove_file(&hdrv->driver, &driver_attr_new_id);
2013 	driver_unregister(&hdrv->driver);
2014 	hid_free_dynids(hdrv);
2015 }
2016 EXPORT_SYMBOL_GPL(hid_unregister_driver);
2017 
hid_check_keys_pressed(struct hid_device * hid)2018 int hid_check_keys_pressed(struct hid_device *hid)
2019 {
2020 	struct hid_input *hidinput;
2021 	int i;
2022 
2023 	if (!(hid->claimed & HID_CLAIMED_INPUT))
2024 		return 0;
2025 
2026 	list_for_each_entry(hidinput, &hid->inputs, list) {
2027 		for (i = 0; i < BITS_TO_LONGS(KEY_MAX); i++)
2028 			if (hidinput->input->key[i])
2029 				return 1;
2030 	}
2031 
2032 	return 0;
2033 }
2034 
2035 EXPORT_SYMBOL_GPL(hid_check_keys_pressed);
2036 
hid_init(void)2037 static int __init hid_init(void)
2038 {
2039 	int ret;
2040 
2041 	if (hid_debug)
2042 		pr_warn("hid_debug is now used solely for parser and driver debugging.\n"
2043 			"debugfs is now used for inspecting the device (report descriptor, reports)\n");
2044 
2045 	ret = bus_register(&hid_bus_type);
2046 	if (ret) {
2047 		pr_err("can't register hid bus\n");
2048 		goto err;
2049 	}
2050 
2051 	ret = hidraw_init();
2052 	if (ret)
2053 		goto err_bus;
2054 
2055 	hid_debug_init();
2056 
2057 	return 0;
2058 err_bus:
2059 	bus_unregister(&hid_bus_type);
2060 err:
2061 	return ret;
2062 }
2063 
hid_exit(void)2064 static void __exit hid_exit(void)
2065 {
2066 	hid_debug_exit();
2067 	hidraw_exit();
2068 	bus_unregister(&hid_bus_type);
2069 }
2070 
2071 module_init(hid_init);
2072 module_exit(hid_exit);
2073 
2074 MODULE_AUTHOR("Andreas Gal");
2075 MODULE_AUTHOR("Vojtech Pavlik");
2076 MODULE_AUTHOR("Jiri Kosina");
2077 MODULE_LICENSE(DRIVER_LICENSE);
2078 
2079