hid-core.c revision 387142bb8fcb263771e1fa6b1a96e6a7ca36e820
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-2012 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#include <linux/semaphore.h>
33
34#include <linux/hid.h>
35#include <linux/hiddev.h>
36#include <linux/hid-debug.h>
37#include <linux/hidraw.h>
38
39#include "hid-ids.h"
40
41/*
42 * Version Information
43 */
44
45#define DRIVER_DESC "HID core driver"
46#define DRIVER_LICENSE "GPL"
47
48int hid_debug = 0;
49module_param_named(debug, hid_debug, int, 0600);
50MODULE_PARM_DESC(debug, "toggle HID debugging messages");
51EXPORT_SYMBOL_GPL(hid_debug);
52
53static int hid_ignore_special_drivers = 0;
54module_param_named(ignore_special_drivers, hid_ignore_special_drivers, int, 0600);
55MODULE_PARM_DESC(debug, "Ignore any special drivers and handle all devices by generic driver");
56
57/*
58 * Register a new report for a device.
59 */
60
61struct hid_report *hid_register_report(struct hid_device *device, unsigned type, unsigned id)
62{
63	struct hid_report_enum *report_enum = device->report_enum + type;
64	struct hid_report *report;
65
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];
70
71	report = kzalloc(sizeof(struct hid_report), GFP_KERNEL);
72	if (!report)
73		return NULL;
74
75	if (id != 0)
76		report_enum->numbered = 1;
77
78	report->id = id;
79	report->type = type;
80	report->size = 0;
81	report->device = device;
82	report_enum->report_id_hash[id] = report;
83
84	list_add_tail(&report->list, &report_enum->report_list);
85
86	return report;
87}
88EXPORT_SYMBOL_GPL(hid_register_report);
89
90/*
91 * Register a new field for this report.
92 */
93
94static struct hid_field *hid_register_field(struct hid_report *report, unsigned usages, unsigned values)
95{
96	struct hid_field *field;
97
98	if (report->maxfield == HID_MAX_FIELDS) {
99		hid_err(report->device, "too many fields in report\n");
100		return NULL;
101	}
102
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;
108
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;
114
115	return field;
116}
117
118/*
119 * Open a collection. The type/usage is pushed on the stack.
120 */
121
122static int open_collection(struct hid_parser *parser, unsigned type)
123{
124	struct hid_collection *collection;
125	unsigned usage;
126
127	usage = parser->local.usage[0];
128
129	if (parser->collection_stack_ptr == HID_COLLECTION_STACK_SIZE) {
130		hid_err(parser->device, "collection stack overflow\n");
131		return -EINVAL;
132	}
133
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;
140		}
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;
150	}
151
152	parser->collection_stack[parser->collection_stack_ptr++] =
153		parser->device->maxcollection;
154
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;
160
161	if (type == HID_COLLECTION_APPLICATION)
162		parser->device->maxapplication++;
163
164	return 0;
165}
166
167/*
168 * Close a collection.
169 */
170
171static int close_collection(struct hid_parser *parser)
172{
173	if (!parser->collection_stack_ptr) {
174		hid_err(parser->device, "collection stack underflow\n");
175		return -EINVAL;
176	}
177	parser->collection_stack_ptr--;
178	return 0;
179}
180
181/*
182 * Climb up the stack, search for the specified collection type
183 * and return the usage.
184 */
185
186static unsigned hid_lookup_collection(struct hid_parser *parser, unsigned type)
187{
188	struct hid_collection *collection = parser->device->collection;
189	int n;
190
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;
195	}
196	return 0; /* we know nothing about this usage type */
197}
198
199/*
200 * Add a usage to the temporary parser table.
201 */
202
203static int hid_add_usage(struct hid_parser *parser, unsigned usage)
204{
205	if (parser->local.usage_index >= HID_MAX_USAGES) {
206		hid_err(parser->device, "usage index exceeded\n");
207		return -1;
208	}
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;
215}
216
217/*
218 * Register a new field for this report.
219 */
220
221static int hid_add_field(struct hid_parser *parser, unsigned report_type, unsigned flags)
222{
223	struct hid_report *report;
224	struct hid_field *field;
225	unsigned usages;
226	unsigned offset;
227	unsigned i;
228
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;
233	}
234
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;
246	}
247
248	offset = report->size;
249	report->size += parser->global.report_size * parser->global.report_count;
250
251	if (!parser->local.usage_index) /* Ignore padding fields */
252		return 0;
253
254	usages = max_t(unsigned, parser->local.usage_index,
255				 parser->global.report_count);
256
257	field = hid_register_field(report, usages, parser->global.report_count);
258	if (!field)
259		return 0;
260
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);
264
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;
274	}
275
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;
288
289	return 0;
290}
291
292/*
293 * Read data value from item.
294 */
295
296static u32 item_udata(struct hid_item *item)
297{
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;
302	}
303	return 0;
304}
305
306static s32 item_sdata(struct hid_item *item)
307{
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;
312	}
313	return 0;
314}
315
316/*
317 * Process a global item.
318 */
319
320static int hid_parser_global(struct hid_parser *parser, struct hid_item *item)
321{
322	__s32 raw_value;
323	switch (item->tag) {
324	case HID_GLOBAL_ITEM_TAG_PUSH:
325
326		if (parser->global_stack_ptr == HID_GLOBAL_STACK_SIZE) {
327			hid_err(parser->device, "global environment stack overflow\n");
328			return -1;
329		}
330
331		memcpy(parser->global_stack + parser->global_stack_ptr++,
332			&parser->global, sizeof(struct hid_global));
333		return 0;
334
335	case HID_GLOBAL_ITEM_TAG_POP:
336
337		if (!parser->global_stack_ptr) {
338			hid_err(parser->device, "global environment stack underflow\n");
339			return -1;
340		}
341
342		memcpy(&parser->global, parser->global_stack +
343			--parser->global_stack_ptr, sizeof(struct hid_global));
344		return 0;
345
346	case HID_GLOBAL_ITEM_TAG_USAGE_PAGE:
347		parser->global.usage_page = item_udata(item);
348		return 0;
349
350	case HID_GLOBAL_ITEM_TAG_LOGICAL_MINIMUM:
351		parser->global.logical_minimum = item_sdata(item);
352		return 0;
353
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;
360
361	case HID_GLOBAL_ITEM_TAG_PHYSICAL_MINIMUM:
362		parser->global.physical_minimum = item_sdata(item);
363		return 0;
364
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;
371
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;
383
384	case HID_GLOBAL_ITEM_TAG_UNIT:
385		parser->global.unit = item_udata(item);
386		return 0;
387
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;
394		}
395		return 0;
396
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;
403		}
404		return 0;
405
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;
413		}
414		return 0;
415
416	default:
417		hid_err(parser->device, "unknown global tag 0x%x\n", item->tag);
418		return -1;
419	}
420}
421
422/*
423 * Process a local item.
424 */
425
426static int hid_parser_local(struct hid_parser *parser, struct hid_item *item)
427{
428	__u32 data;
429	unsigned n;
430
431	data = item_udata(item);
432
433	switch (item->tag) {
434	case HID_LOCAL_ITEM_TAG_DELIMITER:
435
436		if (data) {
437			/*
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.
442			 */
443			if (parser->local.delimiter_depth != 0) {
444				hid_err(parser->device, "nested delimiters\n");
445				return -1;
446			}
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;
453			}
454			parser->local.delimiter_depth--;
455		}
456		return 0;
457
458	case HID_LOCAL_ITEM_TAG_USAGE:
459
460		if (parser->local.delimiter_branch > 1) {
461			dbg_hid("alternative usage ignored\n");
462			return 0;
463		}
464
465		if (item->size <= 2)
466			data = (parser->global.usage_page << 16) + data;
467
468		return hid_add_usage(parser, data);
469
470	case HID_LOCAL_ITEM_TAG_USAGE_MINIMUM:
471
472		if (parser->local.delimiter_branch > 1) {
473			dbg_hid("alternative usage ignored\n");
474			return 0;
475		}
476
477		if (item->size <= 2)
478			data = (parser->global.usage_page << 16) + data;
479
480		parser->local.usage_minimum = data;
481		return 0;
482
483	case HID_LOCAL_ITEM_TAG_USAGE_MAXIMUM:
484
485		if (parser->local.delimiter_branch > 1) {
486			dbg_hid("alternative usage ignored\n");
487			return 0;
488		}
489
490		if (item->size <= 2)
491			data = (parser->global.usage_page << 16) + data;
492
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;
497			}
498		return 0;
499
500	default:
501
502		dbg_hid("unknown local item tag 0x%x\n", item->tag);
503		return 0;
504	}
505	return 0;
506}
507
508/*
509 * Process a main item.
510 */
511
512static int hid_parser_main(struct hid_parser *parser, struct hid_item *item)
513{
514	__u32 data;
515	int ret;
516
517	data = item_udata(item);
518
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;
538	}
539
540	memset(&parser->local, 0, sizeof(parser->local));	/* Reset the local parser environment */
541
542	return ret;
543}
544
545/*
546 * Process a reserved item.
547 */
548
549static int hid_parser_reserved(struct hid_parser *parser, struct hid_item *item)
550{
551	dbg_hid("reserved item type, tag 0x%x\n", item->tag);
552	return 0;
553}
554
555/*
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.
559 */
560
561static void hid_free_report(struct hid_report *report)
562{
563	unsigned n;
564
565	for (n = 0; n < report->maxfield; n++)
566		kfree(report->field[n]);
567	kfree(report);
568}
569
570/*
571 * Close report. This function returns the device
572 * state to the point prior to hid_open_report().
573 */
574static void hid_close_report(struct hid_device *device)
575{
576	unsigned i, j;
577
578	for (i = 0; i < HID_REPORT_TYPES; i++) {
579		struct hid_report_enum *report_enum = device->report_enum + i;
580
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);
585		}
586		memset(report_enum, 0, sizeof(*report_enum));
587		INIT_LIST_HEAD(&report_enum->report_list);
588	}
589
590	kfree(device->rdesc);
591	device->rdesc = NULL;
592	device->rsize = 0;
593
594	kfree(device->collection);
595	device->collection = NULL;
596	device->collection_size = 0;
597	device->maxcollection = 0;
598	device->maxapplication = 0;
599
600	device->status &= ~HID_STAT_PARSED;
601}
602
603/*
604 * Free a device structure, all reports, and all fields.
605 */
606
607static void hid_device_release(struct device *dev)
608{
609	struct hid_device *hid = container_of(dev, struct hid_device, dev);
610
611	hid_close_report(hid);
612	kfree(hid->dev_rdesc);
613	kfree(hid);
614}
615
616/*
617 * Fetch a report description item from the data stream. We support long
618 * items, though they are not used yet.
619 */
620
621static u8 *fetch_item(__u8 *start, __u8 *end, struct hid_item *item)
622{
623	u8 b;
624
625	if ((end - start) <= 0)
626		return NULL;
627
628	b = *start++;
629
630	item->type = (b >> 2) & 3;
631	item->tag  = (b >> 4) & 15;
632
633	if (item->tag == HID_ITEM_TAG_LONG) {
634
635		item->format = HID_ITEM_FORMAT_LONG;
636
637		if ((end - start) < 2)
638			return NULL;
639
640		item->size = *start++;
641		item->tag  = *start++;
642
643		if ((end - start) < item->size)
644			return NULL;
645
646		item->data.longdata = start;
647		start += item->size;
648		return start;
649	}
650
651	item->format = HID_ITEM_FORMAT_SHORT;
652	item->size = b & 3;
653
654	switch (item->size) {
655	case 0:
656		return start;
657
658	case 1:
659		if ((end - start) < 1)
660			return NULL;
661		item->data.u8 = *start++;
662		return start;
663
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;
670
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;
678	}
679
680	return NULL;
681}
682
683static void hid_scan_input_usage(struct hid_parser *parser, u32 usage)
684{
685	struct hid_device *hid = parser->device;
686
687	if (usage == HID_DG_CONTACTID)
688		hid->group = HID_GROUP_MULTITOUCH;
689}
690
691static void hid_scan_feature_usage(struct hid_parser *parser, u32 usage)
692{
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;
696}
697
698static void hid_scan_collection(struct hid_parser *parser, unsigned type)
699{
700	struct hid_device *hid = parser->device;
701
702	if (((parser->global.usage_page << 16) == HID_UP_SENSOR) &&
703	    type == HID_COLLECTION_PHYSICAL)
704		hid->group = HID_GROUP_SENSOR_HUB;
705}
706
707static int hid_scan_main(struct hid_parser *parser, struct hid_item *item)
708{
709	__u32 data;
710	int i;
711
712	data = item_udata(item);
713
714	switch (item->tag) {
715	case HID_MAIN_ITEM_TAG_BEGIN_COLLECTION:
716		hid_scan_collection(parser, data & 0xff);
717		break;
718	case HID_MAIN_ITEM_TAG_END_COLLECTION:
719		break;
720	case HID_MAIN_ITEM_TAG_INPUT:
721		/* ignore constant inputs, they will be ignored by hid-input */
722		if (data & HID_MAIN_ITEM_CONSTANT)
723			break;
724		for (i = 0; i < parser->local.usage_index; i++)
725			hid_scan_input_usage(parser, parser->local.usage[i]);
726		break;
727	case HID_MAIN_ITEM_TAG_OUTPUT:
728		break;
729	case HID_MAIN_ITEM_TAG_FEATURE:
730		for (i = 0; i < parser->local.usage_index; i++)
731			hid_scan_feature_usage(parser, parser->local.usage[i]);
732		break;
733	}
734
735	/* Reset the local parser environment */
736	memset(&parser->local, 0, sizeof(parser->local));
737
738	return 0;
739}
740
741/*
742 * Scan a report descriptor before the device is added to the bus.
743 * Sets device groups and other properties that determine what driver
744 * to load.
745 */
746static int hid_scan_report(struct hid_device *hid)
747{
748	struct hid_parser *parser;
749	struct hid_item item;
750	__u8 *start = hid->dev_rdesc;
751	__u8 *end = start + hid->dev_rsize;
752	static int (*dispatch_type[])(struct hid_parser *parser,
753				      struct hid_item *item) = {
754		hid_scan_main,
755		hid_parser_global,
756		hid_parser_local,
757		hid_parser_reserved
758	};
759
760	parser = vzalloc(sizeof(struct hid_parser));
761	if (!parser)
762		return -ENOMEM;
763
764	parser->device = hid;
765	hid->group = HID_GROUP_GENERIC;
766
767	/*
768	 * The parsing is simpler than the one in hid_open_report() as we should
769	 * be robust against hid errors. Those errors will be raised by
770	 * hid_open_report() anyway.
771	 */
772	while ((start = fetch_item(start, end, &item)) != NULL)
773		dispatch_type[item.type](parser, &item);
774
775	/*
776	 * Handle special flags set during scanning.
777	 */
778	if ((parser->scan_flags & HID_SCAN_FLAG_MT_WIN_8) &&
779	    (hid->group == HID_GROUP_MULTITOUCH))
780		hid->group = HID_GROUP_MULTITOUCH_WIN_8;
781
782	/*
783	* Vendor specific handlings
784	*/
785	if ((hid->vendor == USB_VENDOR_ID_SYNAPTICS) &&
786	    (hid->group == HID_GROUP_GENERIC))
787		/* hid-rmi should take care of them, not hid-generic */
788		hid->group = HID_GROUP_RMI;
789
790	/*
791	 * Vendor specific handlings
792	 */
793	switch (hid->vendor) {
794	case USB_VENDOR_ID_WACOM:
795		hid->group = HID_GROUP_WACOM;
796		break;
797	}
798
799	vfree(parser);
800	return 0;
801}
802
803/**
804 * hid_parse_report - parse device report
805 *
806 * @device: hid device
807 * @start: report start
808 * @size: report size
809 *
810 * Allocate the device report as read by the bus driver. This function should
811 * only be called from parse() in ll drivers.
812 */
813int hid_parse_report(struct hid_device *hid, __u8 *start, unsigned size)
814{
815	hid->dev_rdesc = kmemdup(start, size, GFP_KERNEL);
816	if (!hid->dev_rdesc)
817		return -ENOMEM;
818	hid->dev_rsize = size;
819	return 0;
820}
821EXPORT_SYMBOL_GPL(hid_parse_report);
822
823static const char * const hid_report_names[] = {
824	"HID_INPUT_REPORT",
825	"HID_OUTPUT_REPORT",
826	"HID_FEATURE_REPORT",
827};
828/**
829 * hid_validate_values - validate existing device report's value indexes
830 *
831 * @device: hid device
832 * @type: which report type to examine
833 * @id: which report ID to examine (0 for first)
834 * @field_index: which report field to examine
835 * @report_counts: expected number of values
836 *
837 * Validate the number of values in a given field of a given report, after
838 * parsing.
839 */
840struct hid_report *hid_validate_values(struct hid_device *hid,
841				       unsigned int type, unsigned int id,
842				       unsigned int field_index,
843				       unsigned int report_counts)
844{
845	struct hid_report *report;
846
847	if (type > HID_FEATURE_REPORT) {
848		hid_err(hid, "invalid HID report type %u\n", type);
849		return NULL;
850	}
851
852	if (id >= HID_MAX_IDS) {
853		hid_err(hid, "invalid HID report id %u\n", id);
854		return NULL;
855	}
856
857	/*
858	 * Explicitly not using hid_get_report() here since it depends on
859	 * ->numbered being checked, which may not always be the case when
860	 * drivers go to access report values.
861	 */
862	if (id == 0) {
863		/*
864		 * Validating on id 0 means we should examine the first
865		 * report in the list.
866		 */
867		report = list_entry(
868				hid->report_enum[type].report_list.next,
869				struct hid_report, list);
870	} else {
871		report = hid->report_enum[type].report_id_hash[id];
872	}
873	if (!report) {
874		hid_err(hid, "missing %s %u\n", hid_report_names[type], id);
875		return NULL;
876	}
877	if (report->maxfield <= field_index) {
878		hid_err(hid, "not enough fields in %s %u\n",
879			hid_report_names[type], id);
880		return NULL;
881	}
882	if (report->field[field_index]->report_count < report_counts) {
883		hid_err(hid, "not enough values in %s %u field %u\n",
884			hid_report_names[type], id, field_index);
885		return NULL;
886	}
887	return report;
888}
889EXPORT_SYMBOL_GPL(hid_validate_values);
890
891/**
892 * hid_open_report - open a driver-specific device report
893 *
894 * @device: hid device
895 *
896 * Parse a report description into a hid_device structure. Reports are
897 * enumerated, fields are attached to these reports.
898 * 0 returned on success, otherwise nonzero error value.
899 *
900 * This function (or the equivalent hid_parse() macro) should only be
901 * called from probe() in drivers, before starting the device.
902 */
903int hid_open_report(struct hid_device *device)
904{
905	struct hid_parser *parser;
906	struct hid_item item;
907	unsigned int size;
908	__u8 *start;
909	__u8 *buf;
910	__u8 *end;
911	int ret;
912	static int (*dispatch_type[])(struct hid_parser *parser,
913				      struct hid_item *item) = {
914		hid_parser_main,
915		hid_parser_global,
916		hid_parser_local,
917		hid_parser_reserved
918	};
919
920	if (WARN_ON(device->status & HID_STAT_PARSED))
921		return -EBUSY;
922
923	start = device->dev_rdesc;
924	if (WARN_ON(!start))
925		return -ENODEV;
926	size = device->dev_rsize;
927
928	buf = kmemdup(start, size, GFP_KERNEL);
929	if (buf == NULL)
930		return -ENOMEM;
931
932	if (device->driver->report_fixup)
933		start = device->driver->report_fixup(device, buf, &size);
934	else
935		start = buf;
936
937	start = kmemdup(start, size, GFP_KERNEL);
938	kfree(buf);
939	if (start == NULL)
940		return -ENOMEM;
941
942	device->rdesc = start;
943	device->rsize = size;
944
945	parser = vzalloc(sizeof(struct hid_parser));
946	if (!parser) {
947		ret = -ENOMEM;
948		goto err;
949	}
950
951	parser->device = device;
952
953	end = start + size;
954
955	device->collection = kcalloc(HID_DEFAULT_NUM_COLLECTIONS,
956				     sizeof(struct hid_collection), GFP_KERNEL);
957	if (!device->collection) {
958		ret = -ENOMEM;
959		goto err;
960	}
961	device->collection_size = HID_DEFAULT_NUM_COLLECTIONS;
962
963	ret = -EINVAL;
964	while ((start = fetch_item(start, end, &item)) != NULL) {
965
966		if (item.format != HID_ITEM_FORMAT_SHORT) {
967			hid_err(device, "unexpected long global item\n");
968			goto err;
969		}
970
971		if (dispatch_type[item.type](parser, &item)) {
972			hid_err(device, "item %u %u %u %u parsing failed\n",
973				item.format, (unsigned)item.size,
974				(unsigned)item.type, (unsigned)item.tag);
975			goto err;
976		}
977
978		if (start == end) {
979			if (parser->collection_stack_ptr) {
980				hid_err(device, "unbalanced collection at end of report description\n");
981				goto err;
982			}
983			if (parser->local.delimiter_depth) {
984				hid_err(device, "unbalanced delimiter at end of report description\n");
985				goto err;
986			}
987			vfree(parser);
988			device->status |= HID_STAT_PARSED;
989			return 0;
990		}
991	}
992
993	hid_err(device, "item fetching failed at offset %d\n", (int)(end - start));
994err:
995	vfree(parser);
996	hid_close_report(device);
997	return ret;
998}
999EXPORT_SYMBOL_GPL(hid_open_report);
1000
1001/*
1002 * Convert a signed n-bit integer to signed 32-bit integer. Common
1003 * cases are done through the compiler, the screwed things has to be
1004 * done by hand.
1005 */
1006
1007static s32 snto32(__u32 value, unsigned n)
1008{
1009	switch (n) {
1010	case 8:  return ((__s8)value);
1011	case 16: return ((__s16)value);
1012	case 32: return ((__s32)value);
1013	}
1014	return value & (1 << (n - 1)) ? value | (-1 << n) : value;
1015}
1016
1017s32 hid_snto32(__u32 value, unsigned n)
1018{
1019	return snto32(value, n);
1020}
1021EXPORT_SYMBOL_GPL(hid_snto32);
1022
1023/*
1024 * Convert a signed 32-bit integer to a signed n-bit integer.
1025 */
1026
1027static u32 s32ton(__s32 value, unsigned n)
1028{
1029	s32 a = value >> (n - 1);
1030	if (a && a != -1)
1031		return value < 0 ? 1 << (n - 1) : (1 << (n - 1)) - 1;
1032	return value & ((1 << n) - 1);
1033}
1034
1035/*
1036 * Extract/implement a data field from/to a little endian report (bit array).
1037 *
1038 * Code sort-of follows HID spec:
1039 *     http://www.usb.org/developers/devclass_docs/HID1_11.pdf
1040 *
1041 * While the USB HID spec allows unlimited length bit fields in "report
1042 * descriptors", most devices never use more than 16 bits.
1043 * One model of UPS is claimed to report "LINEV" as a 32-bit field.
1044 * Search linux-kernel and linux-usb-devel archives for "hid-core extract".
1045 */
1046
1047static __u32 extract(const struct hid_device *hid, __u8 *report,
1048		     unsigned offset, unsigned n)
1049{
1050	u64 x;
1051
1052	if (n > 32)
1053		hid_warn(hid, "extract() called with n (%d) > 32! (%s)\n",
1054			 n, current->comm);
1055
1056	report += offset >> 3;  /* adjust byte index */
1057	offset &= 7;            /* now only need bit offset into one byte */
1058	x = get_unaligned_le64(report);
1059	x = (x >> offset) & ((1ULL << n) - 1);  /* extract bit field */
1060	return (u32) x;
1061}
1062
1063/*
1064 * "implement" : set bits in a little endian bit stream.
1065 * Same concepts as "extract" (see comments above).
1066 * The data mangled in the bit stream remains in little endian
1067 * order the whole time. It make more sense to talk about
1068 * endianness of register values by considering a register
1069 * a "cached" copy of the little endiad bit stream.
1070 */
1071static void implement(const struct hid_device *hid, __u8 *report,
1072		      unsigned offset, unsigned n, __u32 value)
1073{
1074	u64 x;
1075	u64 m = (1ULL << n) - 1;
1076
1077	if (n > 32)
1078		hid_warn(hid, "%s() called with n (%d) > 32! (%s)\n",
1079			 __func__, n, current->comm);
1080
1081	if (value > m)
1082		hid_warn(hid, "%s() called with too large value %d! (%s)\n",
1083			 __func__, value, current->comm);
1084	WARN_ON(value > m);
1085	value &= m;
1086
1087	report += offset >> 3;
1088	offset &= 7;
1089
1090	x = get_unaligned_le64(report);
1091	x &= ~(m << offset);
1092	x |= ((u64)value) << offset;
1093	put_unaligned_le64(x, report);
1094}
1095
1096/*
1097 * Search an array for a value.
1098 */
1099
1100static int search(__s32 *array, __s32 value, unsigned n)
1101{
1102	while (n--) {
1103		if (*array++ == value)
1104			return 0;
1105	}
1106	return -1;
1107}
1108
1109/**
1110 * hid_match_report - check if driver's raw_event should be called
1111 *
1112 * @hid: hid device
1113 * @report_type: type to match against
1114 *
1115 * compare hid->driver->report_table->report_type to report->type
1116 */
1117static int hid_match_report(struct hid_device *hid, struct hid_report *report)
1118{
1119	const struct hid_report_id *id = hid->driver->report_table;
1120
1121	if (!id) /* NULL means all */
1122		return 1;
1123
1124	for (; id->report_type != HID_TERMINATOR; id++)
1125		if (id->report_type == HID_ANY_ID ||
1126				id->report_type == report->type)
1127			return 1;
1128	return 0;
1129}
1130
1131/**
1132 * hid_match_usage - check if driver's event should be called
1133 *
1134 * @hid: hid device
1135 * @usage: usage to match against
1136 *
1137 * compare hid->driver->usage_table->usage_{type,code} to
1138 * usage->usage_{type,code}
1139 */
1140static int hid_match_usage(struct hid_device *hid, struct hid_usage *usage)
1141{
1142	const struct hid_usage_id *id = hid->driver->usage_table;
1143
1144	if (!id) /* NULL means all */
1145		return 1;
1146
1147	for (; id->usage_type != HID_ANY_ID - 1; id++)
1148		if ((id->usage_hid == HID_ANY_ID ||
1149				id->usage_hid == usage->hid) &&
1150				(id->usage_type == HID_ANY_ID ||
1151				id->usage_type == usage->type) &&
1152				(id->usage_code == HID_ANY_ID ||
1153				 id->usage_code == usage->code))
1154			return 1;
1155	return 0;
1156}
1157
1158static void hid_process_event(struct hid_device *hid, struct hid_field *field,
1159		struct hid_usage *usage, __s32 value, int interrupt)
1160{
1161	struct hid_driver *hdrv = hid->driver;
1162	int ret;
1163
1164	if (!list_empty(&hid->debug_list))
1165		hid_dump_input(hid, usage, value);
1166
1167	if (hdrv && hdrv->event && hid_match_usage(hid, usage)) {
1168		ret = hdrv->event(hid, field, usage, value);
1169		if (ret != 0) {
1170			if (ret < 0)
1171				hid_err(hid, "%s's event failed with %d\n",
1172						hdrv->name, ret);
1173			return;
1174		}
1175	}
1176
1177	if (hid->claimed & HID_CLAIMED_INPUT)
1178		hidinput_hid_event(hid, field, usage, value);
1179	if (hid->claimed & HID_CLAIMED_HIDDEV && interrupt && hid->hiddev_hid_event)
1180		hid->hiddev_hid_event(hid, field, usage, value);
1181}
1182
1183/*
1184 * Analyse a received field, and fetch the data from it. The field
1185 * content is stored for next report processing (we do differential
1186 * reporting to the layer).
1187 */
1188
1189static void hid_input_field(struct hid_device *hid, struct hid_field *field,
1190			    __u8 *data, int interrupt)
1191{
1192	unsigned n;
1193	unsigned count = field->report_count;
1194	unsigned offset = field->report_offset;
1195	unsigned size = field->report_size;
1196	__s32 min = field->logical_minimum;
1197	__s32 max = field->logical_maximum;
1198	__s32 *value;
1199
1200	value = kmalloc(sizeof(__s32) * count, GFP_ATOMIC);
1201	if (!value)
1202		return;
1203
1204	for (n = 0; n < count; n++) {
1205
1206		value[n] = min < 0 ?
1207			snto32(extract(hid, data, offset + n * size, size),
1208			       size) :
1209			extract(hid, data, offset + n * size, size);
1210
1211		/* Ignore report if ErrorRollOver */
1212		if (!(field->flags & HID_MAIN_ITEM_VARIABLE) &&
1213		    value[n] >= min && value[n] <= max &&
1214		    field->usage[value[n] - min].hid == HID_UP_KEYBOARD + 1)
1215			goto exit;
1216	}
1217
1218	for (n = 0; n < count; n++) {
1219
1220		if (HID_MAIN_ITEM_VARIABLE & field->flags) {
1221			hid_process_event(hid, field, &field->usage[n], value[n], interrupt);
1222			continue;
1223		}
1224
1225		if (field->value[n] >= min && field->value[n] <= max
1226			&& field->usage[field->value[n] - min].hid
1227			&& search(value, field->value[n], count))
1228				hid_process_event(hid, field, &field->usage[field->value[n] - min], 0, interrupt);
1229
1230		if (value[n] >= min && value[n] <= max
1231			&& field->usage[value[n] - min].hid
1232			&& search(field->value, value[n], count))
1233				hid_process_event(hid, field, &field->usage[value[n] - min], 1, interrupt);
1234	}
1235
1236	memcpy(field->value, value, count * sizeof(__s32));
1237exit:
1238	kfree(value);
1239}
1240
1241/*
1242 * Output the field into the report.
1243 */
1244
1245static void hid_output_field(const struct hid_device *hid,
1246			     struct hid_field *field, __u8 *data)
1247{
1248	unsigned count = field->report_count;
1249	unsigned offset = field->report_offset;
1250	unsigned size = field->report_size;
1251	unsigned n;
1252
1253	for (n = 0; n < count; n++) {
1254		if (field->logical_minimum < 0)	/* signed values */
1255			implement(hid, data, offset + n * size, size,
1256				  s32ton(field->value[n], size));
1257		else				/* unsigned values */
1258			implement(hid, data, offset + n * size, size,
1259				  field->value[n]);
1260	}
1261}
1262
1263/*
1264 * Create a report. 'data' has to be allocated using
1265 * hid_alloc_report_buf() so that it has proper size.
1266 */
1267
1268void hid_output_report(struct hid_report *report, __u8 *data)
1269{
1270	unsigned n;
1271
1272	if (report->id > 0)
1273		*data++ = report->id;
1274
1275	memset(data, 0, ((report->size - 1) >> 3) + 1);
1276	for (n = 0; n < report->maxfield; n++)
1277		hid_output_field(report->device, report->field[n], data);
1278}
1279EXPORT_SYMBOL_GPL(hid_output_report);
1280
1281static int hid_report_len(struct hid_report *report)
1282{
1283	/* equivalent to DIV_ROUND_UP(report->size, 8) + !!(report->id > 0) */
1284	return ((report->size - 1) >> 3) + 1 + (report->id > 0);
1285}
1286
1287/*
1288 * Allocator for buffer that is going to be passed to hid_output_report()
1289 */
1290u8 *hid_alloc_report_buf(struct hid_report *report, gfp_t flags)
1291{
1292	/*
1293	 * 7 extra bytes are necessary to achieve proper functionality
1294	 * of implement() working on 8 byte chunks
1295	 */
1296
1297	int len = hid_report_len(report) + 7;
1298
1299	return kmalloc(len, flags);
1300}
1301EXPORT_SYMBOL_GPL(hid_alloc_report_buf);
1302
1303/*
1304 * Set a field value. The report this field belongs to has to be
1305 * created and transferred to the device, to set this value in the
1306 * device.
1307 */
1308
1309int hid_set_field(struct hid_field *field, unsigned offset, __s32 value)
1310{
1311	unsigned size;
1312
1313	if (!field)
1314		return -1;
1315
1316	size = field->report_size;
1317
1318	hid_dump_input(field->report->device, field->usage + offset, value);
1319
1320	if (offset >= field->report_count) {
1321		hid_err(field->report->device, "offset (%d) exceeds report_count (%d)\n",
1322				offset, field->report_count);
1323		return -1;
1324	}
1325	if (field->logical_minimum < 0) {
1326		if (value != snto32(s32ton(value, size), size)) {
1327			hid_err(field->report->device, "value %d is out of range\n", value);
1328			return -1;
1329		}
1330	}
1331	field->value[offset] = value;
1332	return 0;
1333}
1334EXPORT_SYMBOL_GPL(hid_set_field);
1335
1336static struct hid_report *hid_get_report(struct hid_report_enum *report_enum,
1337		const u8 *data)
1338{
1339	struct hid_report *report;
1340	unsigned int n = 0;	/* Normally report number is 0 */
1341
1342	/* Device uses numbered reports, data[0] is report number */
1343	if (report_enum->numbered)
1344		n = *data;
1345
1346	report = report_enum->report_id_hash[n];
1347	if (report == NULL)
1348		dbg_hid("undefined report_id %u received\n", n);
1349
1350	return report;
1351}
1352
1353/*
1354 * Implement a generic .request() callback, using .raw_request()
1355 * DO NOT USE in hid drivers directly, but through hid_hw_request instead.
1356 */
1357void __hid_request(struct hid_device *hid, struct hid_report *report,
1358		int reqtype)
1359{
1360	char *buf;
1361	int ret;
1362	int len;
1363
1364	buf = hid_alloc_report_buf(report, GFP_KERNEL);
1365	if (!buf)
1366		return;
1367
1368	len = hid_report_len(report);
1369
1370	if (reqtype == HID_REQ_SET_REPORT)
1371		hid_output_report(report, buf);
1372
1373	ret = hid->ll_driver->raw_request(hid, report->id, buf, len,
1374					  report->type, reqtype);
1375	if (ret < 0) {
1376		dbg_hid("unable to complete request: %d\n", ret);
1377		goto out;
1378	}
1379
1380	if (reqtype == HID_REQ_GET_REPORT)
1381		hid_input_report(hid, report->type, buf, ret, 0);
1382
1383out:
1384	kfree(buf);
1385}
1386EXPORT_SYMBOL_GPL(__hid_request);
1387
1388int hid_report_raw_event(struct hid_device *hid, int type, u8 *data, int size,
1389		int interrupt)
1390{
1391	struct hid_report_enum *report_enum = hid->report_enum + type;
1392	struct hid_report *report;
1393	struct hid_driver *hdrv;
1394	unsigned int a;
1395	int rsize, csize = size;
1396	u8 *cdata = data;
1397	int ret = 0;
1398
1399	report = hid_get_report(report_enum, data);
1400	if (!report)
1401		goto out;
1402
1403	if (report_enum->numbered) {
1404		cdata++;
1405		csize--;
1406	}
1407
1408	rsize = ((report->size - 1) >> 3) + 1;
1409
1410	if (rsize > HID_MAX_BUFFER_SIZE)
1411		rsize = HID_MAX_BUFFER_SIZE;
1412
1413	if (csize < rsize) {
1414		dbg_hid("report %d is too short, (%d < %d)\n", report->id,
1415				csize, rsize);
1416		memset(cdata + csize, 0, rsize - csize);
1417	}
1418
1419	if ((hid->claimed & HID_CLAIMED_HIDDEV) && hid->hiddev_report_event)
1420		hid->hiddev_report_event(hid, report);
1421	if (hid->claimed & HID_CLAIMED_HIDRAW) {
1422		ret = hidraw_report_event(hid, data, size);
1423		if (ret)
1424			goto out;
1425	}
1426
1427	if (hid->claimed != HID_CLAIMED_HIDRAW && report->maxfield) {
1428		for (a = 0; a < report->maxfield; a++)
1429			hid_input_field(hid, report->field[a], cdata, interrupt);
1430		hdrv = hid->driver;
1431		if (hdrv && hdrv->report)
1432			hdrv->report(hid, report);
1433	}
1434
1435	if (hid->claimed & HID_CLAIMED_INPUT)
1436		hidinput_report_event(hid, report);
1437out:
1438	return ret;
1439}
1440EXPORT_SYMBOL_GPL(hid_report_raw_event);
1441
1442/**
1443 * hid_input_report - report data from lower layer (usb, bt...)
1444 *
1445 * @hid: hid device
1446 * @type: HID report type (HID_*_REPORT)
1447 * @data: report contents
1448 * @size: size of data parameter
1449 * @interrupt: distinguish between interrupt and control transfers
1450 *
1451 * This is data entry for lower layers.
1452 */
1453int hid_input_report(struct hid_device *hid, int type, u8 *data, int size, int interrupt)
1454{
1455	struct hid_report_enum *report_enum;
1456	struct hid_driver *hdrv;
1457	struct hid_report *report;
1458	int ret = 0;
1459
1460	if (!hid)
1461		return -ENODEV;
1462
1463	if (down_trylock(&hid->driver_input_lock))
1464		return -EBUSY;
1465
1466	if (!hid->driver) {
1467		ret = -ENODEV;
1468		goto unlock;
1469	}
1470	report_enum = hid->report_enum + type;
1471	hdrv = hid->driver;
1472
1473	if (!size) {
1474		dbg_hid("empty report\n");
1475		ret = -1;
1476		goto unlock;
1477	}
1478
1479	/* Avoid unnecessary overhead if debugfs is disabled */
1480	if (!list_empty(&hid->debug_list))
1481		hid_dump_report(hid, type, data, size);
1482
1483	report = hid_get_report(report_enum, data);
1484
1485	if (!report) {
1486		ret = -1;
1487		goto unlock;
1488	}
1489
1490	if (hdrv && hdrv->raw_event && hid_match_report(hid, report)) {
1491		ret = hdrv->raw_event(hid, report, data, size);
1492		if (ret < 0)
1493			goto unlock;
1494	}
1495
1496	ret = hid_report_raw_event(hid, type, data, size, interrupt);
1497
1498unlock:
1499	up(&hid->driver_input_lock);
1500	return ret;
1501}
1502EXPORT_SYMBOL_GPL(hid_input_report);
1503
1504static bool hid_match_one_id(struct hid_device *hdev,
1505		const struct hid_device_id *id)
1506{
1507	return (id->bus == HID_BUS_ANY || id->bus == hdev->bus) &&
1508		(id->group == HID_GROUP_ANY || id->group == hdev->group) &&
1509		(id->vendor == HID_ANY_ID || id->vendor == hdev->vendor) &&
1510		(id->product == HID_ANY_ID || id->product == hdev->product);
1511}
1512
1513const struct hid_device_id *hid_match_id(struct hid_device *hdev,
1514		const struct hid_device_id *id)
1515{
1516	for (; id->bus; id++)
1517		if (hid_match_one_id(hdev, id))
1518			return id;
1519
1520	return NULL;
1521}
1522
1523static const struct hid_device_id hid_hiddev_list[] = {
1524	{ HID_USB_DEVICE(USB_VENDOR_ID_MGE, USB_DEVICE_ID_MGE_UPS) },
1525	{ HID_USB_DEVICE(USB_VENDOR_ID_MGE, USB_DEVICE_ID_MGE_UPS1) },
1526	{ }
1527};
1528
1529static bool hid_hiddev(struct hid_device *hdev)
1530{
1531	return !!hid_match_id(hdev, hid_hiddev_list);
1532}
1533
1534
1535static ssize_t
1536read_report_descriptor(struct file *filp, struct kobject *kobj,
1537		struct bin_attribute *attr,
1538		char *buf, loff_t off, size_t count)
1539{
1540	struct device *dev = container_of(kobj, struct device, kobj);
1541	struct hid_device *hdev = container_of(dev, struct hid_device, dev);
1542
1543	if (off >= hdev->rsize)
1544		return 0;
1545
1546	if (off + count > hdev->rsize)
1547		count = hdev->rsize - off;
1548
1549	memcpy(buf, hdev->rdesc + off, count);
1550
1551	return count;
1552}
1553
1554static struct bin_attribute dev_bin_attr_report_desc = {
1555	.attr = { .name = "report_descriptor", .mode = 0444 },
1556	.read = read_report_descriptor,
1557	.size = HID_MAX_DESCRIPTOR_SIZE,
1558};
1559
1560int hid_connect(struct hid_device *hdev, unsigned int connect_mask)
1561{
1562	static const char *types[] = { "Device", "Pointer", "Mouse", "Device",
1563		"Joystick", "Gamepad", "Keyboard", "Keypad",
1564		"Multi-Axis Controller"
1565	};
1566	const char *type, *bus;
1567	char buf[64];
1568	unsigned int i;
1569	int len;
1570	int ret;
1571
1572	if (hdev->quirks & HID_QUIRK_HIDDEV_FORCE)
1573		connect_mask |= (HID_CONNECT_HIDDEV_FORCE | HID_CONNECT_HIDDEV);
1574	if (hdev->quirks & HID_QUIRK_HIDINPUT_FORCE)
1575		connect_mask |= HID_CONNECT_HIDINPUT_FORCE;
1576	if (hdev->bus != BUS_USB)
1577		connect_mask &= ~HID_CONNECT_HIDDEV;
1578	if (hid_hiddev(hdev))
1579		connect_mask |= HID_CONNECT_HIDDEV_FORCE;
1580
1581	if ((connect_mask & HID_CONNECT_HIDINPUT) && !hidinput_connect(hdev,
1582				connect_mask & HID_CONNECT_HIDINPUT_FORCE))
1583		hdev->claimed |= HID_CLAIMED_INPUT;
1584
1585	if ((connect_mask & HID_CONNECT_HIDDEV) && hdev->hiddev_connect &&
1586			!hdev->hiddev_connect(hdev,
1587				connect_mask & HID_CONNECT_HIDDEV_FORCE))
1588		hdev->claimed |= HID_CLAIMED_HIDDEV;
1589	if ((connect_mask & HID_CONNECT_HIDRAW) && !hidraw_connect(hdev))
1590		hdev->claimed |= HID_CLAIMED_HIDRAW;
1591
1592	/* Drivers with the ->raw_event callback set are not required to connect
1593	 * to any other listener. */
1594	if (!hdev->claimed && !hdev->driver->raw_event) {
1595		hid_err(hdev, "device has no listeners, quitting\n");
1596		return -ENODEV;
1597	}
1598
1599	if ((hdev->claimed & HID_CLAIMED_INPUT) &&
1600			(connect_mask & HID_CONNECT_FF) && hdev->ff_init)
1601		hdev->ff_init(hdev);
1602
1603	len = 0;
1604	if (hdev->claimed & HID_CLAIMED_INPUT)
1605		len += sprintf(buf + len, "input");
1606	if (hdev->claimed & HID_CLAIMED_HIDDEV)
1607		len += sprintf(buf + len, "%shiddev%d", len ? "," : "",
1608				hdev->minor);
1609	if (hdev->claimed & HID_CLAIMED_HIDRAW)
1610		len += sprintf(buf + len, "%shidraw%d", len ? "," : "",
1611				((struct hidraw *)hdev->hidraw)->minor);
1612
1613	type = "Device";
1614	for (i = 0; i < hdev->maxcollection; i++) {
1615		struct hid_collection *col = &hdev->collection[i];
1616		if (col->type == HID_COLLECTION_APPLICATION &&
1617		   (col->usage & HID_USAGE_PAGE) == HID_UP_GENDESK &&
1618		   (col->usage & 0xffff) < ARRAY_SIZE(types)) {
1619			type = types[col->usage & 0xffff];
1620			break;
1621		}
1622	}
1623
1624	switch (hdev->bus) {
1625	case BUS_USB:
1626		bus = "USB";
1627		break;
1628	case BUS_BLUETOOTH:
1629		bus = "BLUETOOTH";
1630		break;
1631	default:
1632		bus = "<UNKNOWN>";
1633	}
1634
1635	ret = device_create_bin_file(&hdev->dev, &dev_bin_attr_report_desc);
1636	if (ret)
1637		hid_warn(hdev,
1638			 "can't create sysfs report descriptor attribute err: %d\n", ret);
1639
1640	hid_info(hdev, "%s: %s HID v%x.%02x %s [%s] on %s\n",
1641		 buf, bus, hdev->version >> 8, hdev->version & 0xff,
1642		 type, hdev->name, hdev->phys);
1643
1644	return 0;
1645}
1646EXPORT_SYMBOL_GPL(hid_connect);
1647
1648void hid_disconnect(struct hid_device *hdev)
1649{
1650	device_remove_bin_file(&hdev->dev, &dev_bin_attr_report_desc);
1651	if (hdev->claimed & HID_CLAIMED_INPUT)
1652		hidinput_disconnect(hdev);
1653	if (hdev->claimed & HID_CLAIMED_HIDDEV)
1654		hdev->hiddev_disconnect(hdev);
1655	if (hdev->claimed & HID_CLAIMED_HIDRAW)
1656		hidraw_disconnect(hdev);
1657}
1658EXPORT_SYMBOL_GPL(hid_disconnect);
1659
1660/*
1661 * A list of devices for which there is a specialized driver on HID bus.
1662 *
1663 * Please note that for multitouch devices (driven by hid-multitouch driver),
1664 * there is a proper autodetection and autoloading in place (based on presence
1665 * of HID_DG_CONTACTID), so those devices don't need to be added to this list,
1666 * as we are doing the right thing in hid_scan_usage().
1667 *
1668 * Autodetection for (USB) HID sensor hubs exists too. If a collection of type
1669 * physical is found inside a usage page of type sensor, hid-sensor-hub will be
1670 * used as a driver. See hid_scan_report().
1671 */
1672static const struct hid_device_id hid_have_special_driver[] = {
1673	{ HID_USB_DEVICE(USB_VENDOR_ID_A4TECH, USB_DEVICE_ID_A4TECH_WCP32PU) },
1674	{ HID_USB_DEVICE(USB_VENDOR_ID_A4TECH, USB_DEVICE_ID_A4TECH_X5_005D) },
1675	{ HID_USB_DEVICE(USB_VENDOR_ID_A4TECH, USB_DEVICE_ID_A4TECH_RP_649) },
1676	{ HID_USB_DEVICE(USB_VENDOR_ID_ACRUX, 0x0802) },
1677	{ HID_USB_DEVICE(USB_VENDOR_ID_ACRUX, 0xf705) },
1678	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_MIGHTYMOUSE) },
1679	{ HID_BLUETOOTH_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_MAGICMOUSE) },
1680	{ HID_BLUETOOTH_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_MAGICTRACKPAD) },
1681	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_FOUNTAIN_ANSI) },
1682	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_FOUNTAIN_ISO) },
1683	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_GEYSER_ANSI) },
1684	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_GEYSER_ISO) },
1685	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_GEYSER_JIS) },
1686	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_GEYSER3_ANSI) },
1687	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_GEYSER3_ISO) },
1688	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_GEYSER3_JIS) },
1689	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_GEYSER4_ANSI) },
1690	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_GEYSER4_ISO) },
1691	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_GEYSER4_JIS) },
1692	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_ALU_MINI_ANSI) },
1693	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_ALU_MINI_ISO) },
1694	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_ALU_MINI_JIS) },
1695	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_ALU_ANSI) },
1696	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_ALU_ISO) },
1697	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_ALU_JIS) },
1698	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_GEYSER4_HF_ANSI) },
1699	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_GEYSER4_HF_ISO) },
1700	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_GEYSER4_HF_JIS) },
1701	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_IRCONTROL) },
1702	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_IRCONTROL2) },
1703	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_IRCONTROL3) },
1704	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_IRCONTROL4) },
1705	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_IRCONTROL5) },
1706	{ HID_BLUETOOTH_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_ALU_WIRELESS_ANSI) },
1707	{ HID_BLUETOOTH_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_ALU_WIRELESS_ISO) },
1708	{ HID_BLUETOOTH_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_ALU_WIRELESS_JIS) },
1709	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING_ANSI) },
1710	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING_ISO) },
1711	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING_JIS) },
1712	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING2_ANSI) },
1713	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING2_ISO) },
1714	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING2_JIS) },
1715	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING3_ANSI) },
1716	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING3_ISO) },
1717	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING3_JIS) },
1718	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING4_ANSI) },
1719	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING4_ISO) },
1720	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING4_JIS) },
1721	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING4A_ANSI) },
1722	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING4A_ISO) },
1723	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING4A_JIS) },
1724	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING5_ANSI) },
1725	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING5_ISO) },
1726	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING5_JIS) },
1727	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING5A_ANSI) },
1728	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING5A_ISO) },
1729	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING5A_JIS) },
1730	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_ALU_REVB_ANSI) },
1731	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_ALU_REVB_ISO) },
1732	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_ALU_REVB_JIS) },
1733	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING6_ANSI) },
1734	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING6_ISO) },
1735	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING6_JIS) },
1736	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING6A_ANSI) },
1737	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING6A_ISO) },
1738	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING6A_JIS) },
1739	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING7_ANSI) },
1740	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING7_ISO) },
1741	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING7_JIS) },
1742	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING7A_ANSI) },
1743	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING7A_ISO) },
1744	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING7A_JIS) },
1745	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING8_ANSI) },
1746	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING8_ISO) },
1747	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING8_JIS) },
1748	{ HID_BLUETOOTH_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_ALU_WIRELESS_2009_ANSI) },
1749	{ HID_BLUETOOTH_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_ALU_WIRELESS_2009_ISO) },
1750	{ HID_BLUETOOTH_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_ALU_WIRELESS_2009_JIS) },
1751	{ HID_BLUETOOTH_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_ALU_WIRELESS_2011_ANSI) },
1752	{ HID_BLUETOOTH_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_ALU_WIRELESS_2011_ISO) },
1753	{ HID_BLUETOOTH_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_ALU_WIRELESS_2011_JIS) },
1754	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_FOUNTAIN_TP_ONLY) },
1755	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_GEYSER1_TP_ONLY) },
1756	{ HID_USB_DEVICE(USB_VENDOR_ID_AUREAL, USB_DEVICE_ID_AUREAL_W01RN) },
1757	{ HID_USB_DEVICE(USB_VENDOR_ID_BELKIN, USB_DEVICE_ID_FLIP_KVM) },
1758	{ HID_USB_DEVICE(USB_VENDOR_ID_BTC, USB_DEVICE_ID_BTC_EMPREX_REMOTE) },
1759	{ HID_USB_DEVICE(USB_VENDOR_ID_BTC, USB_DEVICE_ID_BTC_EMPREX_REMOTE_2) },
1760	{ HID_USB_DEVICE(USB_VENDOR_ID_CHERRY, USB_DEVICE_ID_CHERRY_CYMOTION) },
1761	{ HID_USB_DEVICE(USB_VENDOR_ID_CHERRY, USB_DEVICE_ID_CHERRY_CYMOTION_SOLAR) },
1762	{ HID_USB_DEVICE(USB_VENDOR_ID_CHICONY, USB_DEVICE_ID_CHICONY_TACTICAL_PAD) },
1763	{ HID_USB_DEVICE(USB_VENDOR_ID_CHICONY, USB_DEVICE_ID_CHICONY_WIRELESS) },
1764	{ HID_USB_DEVICE(USB_VENDOR_ID_CHICONY, USB_DEVICE_ID_CHICONY_WIRELESS2) },
1765	{ HID_USB_DEVICE(USB_VENDOR_ID_CHICONY, USB_DEVICE_ID_CHICONY_AK1D) },
1766	{ HID_USB_DEVICE(USB_VENDOR_ID_CREATIVELABS, USB_DEVICE_ID_PRODIKEYS_PCMIDI) },
1767	{ HID_USB_DEVICE(USB_VENDOR_ID_CYGNAL, USB_DEVICE_ID_CYGNAL_CP2112) },
1768	{ HID_USB_DEVICE(USB_VENDOR_ID_CYPRESS, USB_DEVICE_ID_CYPRESS_BARCODE_1) },
1769	{ HID_USB_DEVICE(USB_VENDOR_ID_CYPRESS, USB_DEVICE_ID_CYPRESS_BARCODE_2) },
1770	{ HID_USB_DEVICE(USB_VENDOR_ID_CYPRESS, USB_DEVICE_ID_CYPRESS_BARCODE_3) },
1771	{ HID_USB_DEVICE(USB_VENDOR_ID_CYPRESS, USB_DEVICE_ID_CYPRESS_BARCODE_4) },
1772	{ HID_USB_DEVICE(USB_VENDOR_ID_CYPRESS, USB_DEVICE_ID_CYPRESS_MOUSE) },
1773	{ HID_USB_DEVICE(USB_VENDOR_ID_DRAGONRISE, 0x0006) },
1774	{ HID_USB_DEVICE(USB_VENDOR_ID_DRAGONRISE, 0x0011) },
1775	{ HID_BLUETOOTH_DEVICE(USB_VENDOR_ID_ELECOM, USB_DEVICE_ID_ELECOM_BM084) },
1776	{ HID_USB_DEVICE(USB_VENDOR_ID_ELO, 0x0009) },
1777	{ HID_USB_DEVICE(USB_VENDOR_ID_ELO, 0x0030) },
1778	{ HID_USB_DEVICE(USB_VENDOR_ID_EMS, USB_DEVICE_ID_EMS_TRIO_LINKER_PLUS_II) },
1779	{ HID_USB_DEVICE(USB_VENDOR_ID_EZKEY, USB_DEVICE_ID_BTC_8193) },
1780	{ HID_USB_DEVICE(USB_VENDOR_ID_GAMERON, USB_DEVICE_ID_GAMERON_DUAL_PSX_ADAPTOR) },
1781	{ HID_USB_DEVICE(USB_VENDOR_ID_GAMERON, USB_DEVICE_ID_GAMERON_DUAL_PCS_ADAPTOR) },
1782	{ HID_USB_DEVICE(USB_VENDOR_ID_GREENASIA, 0x0003) },
1783	{ HID_USB_DEVICE(USB_VENDOR_ID_GREENASIA, 0x0012) },
1784	{ HID_USB_DEVICE(USB_VENDOR_ID_GYRATION, USB_DEVICE_ID_GYRATION_REMOTE) },
1785	{ HID_USB_DEVICE(USB_VENDOR_ID_GYRATION, USB_DEVICE_ID_GYRATION_REMOTE_2) },
1786	{ HID_USB_DEVICE(USB_VENDOR_ID_GYRATION, USB_DEVICE_ID_GYRATION_REMOTE_3) },
1787	{ HID_USB_DEVICE(USB_VENDOR_ID_HOLTEK, USB_DEVICE_ID_HOLTEK_ON_LINE_GRIP) },
1788	{ HID_USB_DEVICE(USB_VENDOR_ID_HOLTEK_ALT, USB_DEVICE_ID_HOLTEK_ALT_KEYBOARD) },
1789	{ HID_USB_DEVICE(USB_VENDOR_ID_HOLTEK_ALT, USB_DEVICE_ID_HOLTEK_ALT_MOUSE_A04A) },
1790	{ HID_USB_DEVICE(USB_VENDOR_ID_HOLTEK_ALT, USB_DEVICE_ID_HOLTEK_ALT_MOUSE_A067) },
1791	{ HID_USB_DEVICE(USB_VENDOR_ID_HOLTEK_ALT, USB_DEVICE_ID_HOLTEK_ALT_MOUSE_A070) },
1792	{ HID_USB_DEVICE(USB_VENDOR_ID_HOLTEK_ALT, USB_DEVICE_ID_HOLTEK_ALT_MOUSE_A072) },
1793	{ HID_USB_DEVICE(USB_VENDOR_ID_HOLTEK_ALT, USB_DEVICE_ID_HOLTEK_ALT_MOUSE_A081) },
1794	{ HID_USB_DEVICE(USB_VENDOR_ID_HUION, USB_DEVICE_ID_HUION_580) },
1795	{ HID_USB_DEVICE(USB_VENDOR_ID_JESS2, USB_DEVICE_ID_JESS2_COLOR_RUMBLE_PAD) },
1796	{ HID_BLUETOOTH_DEVICE(USB_VENDOR_ID_ION, USB_DEVICE_ID_ICADE) },
1797	{ HID_USB_DEVICE(USB_VENDOR_ID_KENSINGTON, USB_DEVICE_ID_KS_SLIMBLADE) },
1798	{ HID_USB_DEVICE(USB_VENDOR_ID_KEYTOUCH, USB_DEVICE_ID_KEYTOUCH_IEC) },
1799	{ HID_USB_DEVICE(USB_VENDOR_ID_KYE, USB_DEVICE_ID_GENIUS_GILA_GAMING_MOUSE) },
1800	{ HID_USB_DEVICE(USB_VENDOR_ID_KYE, USB_DEVICE_ID_GENIUS_MANTICORE) },
1801	{ HID_USB_DEVICE(USB_VENDOR_ID_KYE, USB_DEVICE_ID_GENIUS_GX_IMPERATOR) },
1802	{ HID_USB_DEVICE(USB_VENDOR_ID_KYE, USB_DEVICE_ID_KYE_ERGO_525V) },
1803	{ HID_USB_DEVICE(USB_VENDOR_ID_KYE, USB_DEVICE_ID_KYE_EASYPEN_I405X) },
1804	{ HID_USB_DEVICE(USB_VENDOR_ID_KYE, USB_DEVICE_ID_KYE_MOUSEPEN_I608X) },
1805	{ HID_USB_DEVICE(USB_VENDOR_ID_KYE, USB_DEVICE_ID_KYE_EASYPEN_M610X) },
1806	{ HID_USB_DEVICE(USB_VENDOR_ID_LABTEC, USB_DEVICE_ID_LABTEC_WIRELESS_KEYBOARD) },
1807	{ HID_USB_DEVICE(USB_VENDOR_ID_LCPOWER, USB_DEVICE_ID_LCPOWER_LC1000 ) },
1808#if IS_ENABLED(CONFIG_HID_LENOVO_TPKBD)
1809	{ HID_USB_DEVICE(USB_VENDOR_ID_LENOVO, USB_DEVICE_ID_LENOVO_TPKBD) },
1810#endif
1811	{ HID_USB_DEVICE(USB_VENDOR_ID_LOGITECH, USB_DEVICE_ID_MX3000_RECEIVER) },
1812	{ HID_USB_DEVICE(USB_VENDOR_ID_LOGITECH, USB_DEVICE_ID_S510_RECEIVER) },
1813	{ HID_USB_DEVICE(USB_VENDOR_ID_LOGITECH, USB_DEVICE_ID_S510_RECEIVER_2) },
1814	{ HID_USB_DEVICE(USB_VENDOR_ID_LOGITECH, USB_DEVICE_ID_LOGITECH_RECEIVER) },
1815	{ HID_BLUETOOTH_DEVICE(USB_VENDOR_ID_LOGITECH, USB_DEVICE_ID_LOGITECH_HARMONY_PS3) },
1816	{ HID_USB_DEVICE(USB_VENDOR_ID_LOGITECH, USB_DEVICE_ID_DINOVO_DESKTOP) },
1817	{ HID_USB_DEVICE(USB_VENDOR_ID_LOGITECH, USB_DEVICE_ID_DINOVO_EDGE) },
1818	{ HID_USB_DEVICE(USB_VENDOR_ID_LOGITECH, USB_DEVICE_ID_DINOVO_MINI) },
1819	{ HID_USB_DEVICE(USB_VENDOR_ID_LOGITECH, USB_DEVICE_ID_LOGITECH_ELITE_KBD) },
1820	{ HID_USB_DEVICE(USB_VENDOR_ID_LOGITECH, USB_DEVICE_ID_LOGITECH_CORDLESS_DESKTOP_LX500) },
1821	{ HID_USB_DEVICE(USB_VENDOR_ID_LOGITECH, USB_DEVICE_ID_LOGITECH_EXTREME_3D) },
1822	{ HID_USB_DEVICE(USB_VENDOR_ID_LOGITECH, USB_DEVICE_ID_LOGITECH_WHEEL) },
1823	{ HID_USB_DEVICE(USB_VENDOR_ID_LOGITECH, USB_DEVICE_ID_LOGITECH_RUMBLEPAD_CORD) },
1824	{ HID_USB_DEVICE(USB_VENDOR_ID_LOGITECH, USB_DEVICE_ID_LOGITECH_RUMBLEPAD) },
1825	{ HID_USB_DEVICE(USB_VENDOR_ID_LOGITECH, USB_DEVICE_ID_LOGITECH_RUMBLEPAD2_2) },
1826	{ HID_USB_DEVICE(USB_VENDOR_ID_LOGITECH, USB_DEVICE_ID_LOGITECH_WINGMAN_F3D) },
1827	{ HID_USB_DEVICE(USB_VENDOR_ID_LOGITECH, USB_DEVICE_ID_LOGITECH_WINGMAN_FFG ) },
1828	{ HID_USB_DEVICE(USB_VENDOR_ID_LOGITECH, USB_DEVICE_ID_LOGITECH_FORCE3D_PRO) },
1829	{ HID_USB_DEVICE(USB_VENDOR_ID_LOGITECH, USB_DEVICE_ID_LOGITECH_FLIGHT_SYSTEM_G940) },
1830	{ HID_USB_DEVICE(USB_VENDOR_ID_LOGITECH, USB_DEVICE_ID_LOGITECH_MOMO_WHEEL) },
1831	{ HID_USB_DEVICE(USB_VENDOR_ID_LOGITECH, USB_DEVICE_ID_LOGITECH_MOMO_WHEEL2) },
1832	{ HID_USB_DEVICE(USB_VENDOR_ID_LOGITECH, USB_DEVICE_ID_LOGITECH_VIBRATION_WHEEL) },
1833	{ HID_USB_DEVICE(USB_VENDOR_ID_LOGITECH, USB_DEVICE_ID_LOGITECH_DFP_WHEEL) },
1834	{ HID_USB_DEVICE(USB_VENDOR_ID_LOGITECH, USB_DEVICE_ID_LOGITECH_DFGT_WHEEL) },
1835	{ HID_USB_DEVICE(USB_VENDOR_ID_LOGITECH, USB_DEVICE_ID_LOGITECH_G25_WHEEL) },
1836	{ HID_USB_DEVICE(USB_VENDOR_ID_LOGITECH, USB_DEVICE_ID_LOGITECH_G27_WHEEL) },
1837#if IS_ENABLED(CONFIG_HID_LOGITECH_DJ)
1838	{ HID_USB_DEVICE(USB_VENDOR_ID_LOGITECH, USB_DEVICE_ID_LOGITECH_UNIFYING_RECEIVER) },
1839	{ HID_USB_DEVICE(USB_VENDOR_ID_LOGITECH, USB_DEVICE_ID_LOGITECH_UNIFYING_RECEIVER_2) },
1840#endif
1841	{ HID_USB_DEVICE(USB_VENDOR_ID_LOGITECH, USB_DEVICE_ID_LOGITECH_WII_WHEEL) },
1842	{ HID_USB_DEVICE(USB_VENDOR_ID_LOGITECH, USB_DEVICE_ID_LOGITECH_RUMBLEPAD2) },
1843	{ HID_USB_DEVICE(USB_VENDOR_ID_LOGITECH, USB_DEVICE_ID_SPACETRAVELLER) },
1844	{ HID_USB_DEVICE(USB_VENDOR_ID_LOGITECH, USB_DEVICE_ID_SPACENAVIGATOR) },
1845	{ HID_USB_DEVICE(USB_VENDOR_ID_MICROCHIP, USB_DEVICE_ID_PICOLCD) },
1846	{ HID_USB_DEVICE(USB_VENDOR_ID_MICROCHIP, USB_DEVICE_ID_PICOLCD_BOOTLOADER) },
1847	{ HID_USB_DEVICE(USB_VENDOR_ID_MICROSOFT, USB_DEVICE_ID_MS_COMFORT_MOUSE_4500) },
1848	{ HID_USB_DEVICE(USB_VENDOR_ID_MICROSOFT, USB_DEVICE_ID_SIDEWINDER_GV) },
1849	{ HID_USB_DEVICE(USB_VENDOR_ID_MICROSOFT, USB_DEVICE_ID_MS_NE4K) },
1850	{ HID_USB_DEVICE(USB_VENDOR_ID_MICROSOFT, USB_DEVICE_ID_MS_NE4K_JP) },
1851	{ HID_USB_DEVICE(USB_VENDOR_ID_MICROSOFT, USB_DEVICE_ID_MS_LK6K) },
1852	{ HID_USB_DEVICE(USB_VENDOR_ID_MICROSOFT, USB_DEVICE_ID_MS_PRESENTER_8K_USB) },
1853	{ HID_USB_DEVICE(USB_VENDOR_ID_MICROSOFT, USB_DEVICE_ID_MS_DIGITAL_MEDIA_3K) },
1854	{ HID_USB_DEVICE(USB_VENDOR_ID_MICROSOFT, USB_DEVICE_ID_WIRELESS_OPTICAL_DESKTOP_3_0) },
1855	{ HID_USB_DEVICE(USB_VENDOR_ID_MICROSOFT, USB_DEVICE_ID_MS_OFFICE_KB) },
1856	{ HID_USB_DEVICE(USB_VENDOR_ID_MONTEREY, USB_DEVICE_ID_GENIUS_KB29E) },
1857	{ HID_USB_DEVICE(USB_VENDOR_ID_NTRIG, USB_DEVICE_ID_NTRIG_TOUCH_SCREEN) },
1858	{ HID_USB_DEVICE(USB_VENDOR_ID_NTRIG, USB_DEVICE_ID_NTRIG_TOUCH_SCREEN_1) },
1859	{ HID_USB_DEVICE(USB_VENDOR_ID_NTRIG, USB_DEVICE_ID_NTRIG_TOUCH_SCREEN_2) },
1860	{ HID_USB_DEVICE(USB_VENDOR_ID_NTRIG, USB_DEVICE_ID_NTRIG_TOUCH_SCREEN_3) },
1861	{ HID_USB_DEVICE(USB_VENDOR_ID_NTRIG, USB_DEVICE_ID_NTRIG_TOUCH_SCREEN_4) },
1862	{ HID_USB_DEVICE(USB_VENDOR_ID_NTRIG, USB_DEVICE_ID_NTRIG_TOUCH_SCREEN_5) },
1863	{ HID_USB_DEVICE(USB_VENDOR_ID_NTRIG, USB_DEVICE_ID_NTRIG_TOUCH_SCREEN_6) },
1864	{ HID_USB_DEVICE(USB_VENDOR_ID_NTRIG, USB_DEVICE_ID_NTRIG_TOUCH_SCREEN_7) },
1865	{ HID_USB_DEVICE(USB_VENDOR_ID_NTRIG, USB_DEVICE_ID_NTRIG_TOUCH_SCREEN_8) },
1866	{ HID_USB_DEVICE(USB_VENDOR_ID_NTRIG, USB_DEVICE_ID_NTRIG_TOUCH_SCREEN_9) },
1867	{ HID_USB_DEVICE(USB_VENDOR_ID_NTRIG, USB_DEVICE_ID_NTRIG_TOUCH_SCREEN_10) },
1868	{ HID_USB_DEVICE(USB_VENDOR_ID_NTRIG, USB_DEVICE_ID_NTRIG_TOUCH_SCREEN_11) },
1869	{ HID_USB_DEVICE(USB_VENDOR_ID_NTRIG, USB_DEVICE_ID_NTRIG_TOUCH_SCREEN_12) },
1870	{ HID_USB_DEVICE(USB_VENDOR_ID_NTRIG, USB_DEVICE_ID_NTRIG_TOUCH_SCREEN_13) },
1871	{ HID_USB_DEVICE(USB_VENDOR_ID_NTRIG, USB_DEVICE_ID_NTRIG_TOUCH_SCREEN_14) },
1872	{ HID_USB_DEVICE(USB_VENDOR_ID_NTRIG, USB_DEVICE_ID_NTRIG_TOUCH_SCREEN_15) },
1873	{ HID_USB_DEVICE(USB_VENDOR_ID_NTRIG, USB_DEVICE_ID_NTRIG_TOUCH_SCREEN_16) },
1874	{ HID_USB_DEVICE(USB_VENDOR_ID_NTRIG, USB_DEVICE_ID_NTRIG_TOUCH_SCREEN_17) },
1875	{ HID_USB_DEVICE(USB_VENDOR_ID_NTRIG, USB_DEVICE_ID_NTRIG_TOUCH_SCREEN_18) },
1876	{ HID_USB_DEVICE(USB_VENDOR_ID_ORTEK, USB_DEVICE_ID_ORTEK_PKB1700) },
1877	{ HID_USB_DEVICE(USB_VENDOR_ID_ORTEK, USB_DEVICE_ID_ORTEK_WKB2000) },
1878	{ HID_USB_DEVICE(USB_VENDOR_ID_PETALYNX, USB_DEVICE_ID_PETALYNX_MAXTER_REMOTE) },
1879	{ HID_USB_DEVICE(USB_VENDOR_ID_PRIMAX, USB_DEVICE_ID_PRIMAX_KEYBOARD) },
1880#if IS_ENABLED(CONFIG_HID_ROCCAT)
1881	{ HID_USB_DEVICE(USB_VENDOR_ID_ROCCAT, USB_DEVICE_ID_ROCCAT_ARVO) },
1882	{ HID_USB_DEVICE(USB_VENDOR_ID_ROCCAT, USB_DEVICE_ID_ROCCAT_ISKU) },
1883	{ HID_USB_DEVICE(USB_VENDOR_ID_ROCCAT, USB_DEVICE_ID_ROCCAT_ISKUFX) },
1884	{ HID_USB_DEVICE(USB_VENDOR_ID_ROCCAT, USB_DEVICE_ID_ROCCAT_KONE) },
1885	{ HID_USB_DEVICE(USB_VENDOR_ID_ROCCAT, USB_DEVICE_ID_ROCCAT_KONEPLUS) },
1886	{ HID_USB_DEVICE(USB_VENDOR_ID_ROCCAT, USB_DEVICE_ID_ROCCAT_KONEPURE) },
1887	{ HID_USB_DEVICE(USB_VENDOR_ID_ROCCAT, USB_DEVICE_ID_ROCCAT_KONEPURE_OPTICAL) },
1888	{ HID_USB_DEVICE(USB_VENDOR_ID_ROCCAT, USB_DEVICE_ID_ROCCAT_KONEXTD) },
1889	{ HID_USB_DEVICE(USB_VENDOR_ID_ROCCAT, USB_DEVICE_ID_ROCCAT_KOVAPLUS) },
1890	{ HID_USB_DEVICE(USB_VENDOR_ID_ROCCAT, USB_DEVICE_ID_ROCCAT_LUA) },
1891	{ HID_USB_DEVICE(USB_VENDOR_ID_ROCCAT, USB_DEVICE_ID_ROCCAT_PYRA_WIRED) },
1892	{ HID_USB_DEVICE(USB_VENDOR_ID_ROCCAT, USB_DEVICE_ID_ROCCAT_PYRA_WIRELESS) },
1893	{ HID_USB_DEVICE(USB_VENDOR_ID_ROCCAT, USB_DEVICE_ID_ROCCAT_RYOS_MK) },
1894	{ HID_USB_DEVICE(USB_VENDOR_ID_ROCCAT, USB_DEVICE_ID_ROCCAT_RYOS_MK_GLOW) },
1895	{ HID_USB_DEVICE(USB_VENDOR_ID_ROCCAT, USB_DEVICE_ID_ROCCAT_RYOS_MK_PRO) },
1896	{ HID_USB_DEVICE(USB_VENDOR_ID_ROCCAT, USB_DEVICE_ID_ROCCAT_SAVU) },
1897#endif
1898#if IS_ENABLED(CONFIG_HID_SAITEK)
1899	{ HID_USB_DEVICE(USB_VENDOR_ID_SAITEK, USB_DEVICE_ID_SAITEK_PS1000) },
1900	{ HID_USB_DEVICE(USB_VENDOR_ID_SAITEK, USB_DEVICE_ID_SAITEK_RAT7) },
1901	{ HID_USB_DEVICE(USB_VENDOR_ID_SAITEK, USB_DEVICE_ID_SAITEK_MMO7) },
1902#endif
1903	{ HID_USB_DEVICE(USB_VENDOR_ID_SAMSUNG, USB_DEVICE_ID_SAMSUNG_IR_REMOTE) },
1904	{ HID_USB_DEVICE(USB_VENDOR_ID_SAMSUNG, USB_DEVICE_ID_SAMSUNG_WIRELESS_KBD_MOUSE) },
1905	{ HID_USB_DEVICE(USB_VENDOR_ID_SKYCABLE, USB_DEVICE_ID_SKYCABLE_WIRELESS_PRESENTER) },
1906	{ HID_USB_DEVICE(USB_VENDOR_ID_SONY, USB_DEVICE_ID_SONY_BUZZ_CONTROLLER) },
1907	{ HID_USB_DEVICE(USB_VENDOR_ID_SONY, USB_DEVICE_ID_SONY_WIRELESS_BUZZ_CONTROLLER) },
1908	{ HID_BLUETOOTH_DEVICE(USB_VENDOR_ID_SONY, USB_DEVICE_ID_SONY_PS3_BDREMOTE) },
1909	{ HID_USB_DEVICE(USB_VENDOR_ID_SONY, USB_DEVICE_ID_SONY_PS3_CONTROLLER) },
1910	{ HID_USB_DEVICE(USB_VENDOR_ID_SONY, USB_DEVICE_ID_SONY_NAVIGATION_CONTROLLER) },
1911	{ HID_BLUETOOTH_DEVICE(USB_VENDOR_ID_SONY, USB_DEVICE_ID_SONY_PS3_CONTROLLER) },
1912	{ HID_USB_DEVICE(USB_VENDOR_ID_SONY, USB_DEVICE_ID_SONY_PS4_CONTROLLER) },
1913	{ HID_BLUETOOTH_DEVICE(USB_VENDOR_ID_SONY, USB_DEVICE_ID_SONY_PS4_CONTROLLER) },
1914	{ HID_USB_DEVICE(USB_VENDOR_ID_SONY, USB_DEVICE_ID_SONY_VAIO_VGX_MOUSE) },
1915	{ HID_USB_DEVICE(USB_VENDOR_ID_SONY, USB_DEVICE_ID_SONY_VAIO_VGP_MOUSE) },
1916	{ HID_USB_DEVICE(USB_VENDOR_ID_STEELSERIES, USB_DEVICE_ID_STEELSERIES_SRWS1) },
1917	{ HID_USB_DEVICE(USB_VENDOR_ID_SUNPLUS, USB_DEVICE_ID_SUNPLUS_WDESKTOP) },
1918	{ HID_USB_DEVICE(USB_VENDOR_ID_THINGM, USB_DEVICE_ID_BLINK1) },
1919	{ HID_USB_DEVICE(USB_VENDOR_ID_THRUSTMASTER, 0xb300) },
1920	{ HID_USB_DEVICE(USB_VENDOR_ID_THRUSTMASTER, 0xb304) },
1921	{ HID_USB_DEVICE(USB_VENDOR_ID_THRUSTMASTER, 0xb323) },
1922	{ HID_USB_DEVICE(USB_VENDOR_ID_THRUSTMASTER, 0xb324) },
1923	{ HID_USB_DEVICE(USB_VENDOR_ID_THRUSTMASTER, 0xb651) },
1924	{ HID_USB_DEVICE(USB_VENDOR_ID_THRUSTMASTER, 0xb653) },
1925	{ HID_USB_DEVICE(USB_VENDOR_ID_THRUSTMASTER, 0xb654) },
1926	{ HID_USB_DEVICE(USB_VENDOR_ID_THRUSTMASTER, 0xb65a) },
1927	{ HID_BLUETOOTH_DEVICE(USB_VENDOR_ID_TIVO, USB_DEVICE_ID_TIVO_SLIDE_BT) },
1928	{ HID_USB_DEVICE(USB_VENDOR_ID_TIVO, USB_DEVICE_ID_TIVO_SLIDE) },
1929	{ HID_USB_DEVICE(USB_VENDOR_ID_TOPSEED, USB_DEVICE_ID_TOPSEED_CYBERLINK) },
1930	{ HID_USB_DEVICE(USB_VENDOR_ID_TOPSEED2, USB_DEVICE_ID_TOPSEED2_RF_COMBO) },
1931	{ HID_USB_DEVICE(USB_VENDOR_ID_TWINHAN, USB_DEVICE_ID_TWINHAN_IR_REMOTE) },
1932	{ HID_USB_DEVICE(USB_VENDOR_ID_UCLOGIC, USB_DEVICE_ID_UCLOGIC_TABLET_PF1209) },
1933	{ HID_USB_DEVICE(USB_VENDOR_ID_UCLOGIC, USB_DEVICE_ID_UCLOGIC_TABLET_WP4030U) },
1934	{ HID_USB_DEVICE(USB_VENDOR_ID_UCLOGIC, USB_DEVICE_ID_UCLOGIC_TABLET_WP5540U) },
1935	{ HID_USB_DEVICE(USB_VENDOR_ID_UCLOGIC, USB_DEVICE_ID_UCLOGIC_TABLET_WP8060U) },
1936	{ HID_USB_DEVICE(USB_VENDOR_ID_UCLOGIC, USB_DEVICE_ID_UCLOGIC_TABLET_WP1062) },
1937	{ HID_USB_DEVICE(USB_VENDOR_ID_UCLOGIC, USB_DEVICE_ID_UCLOGIC_WIRELESS_TABLET_TWHL850) },
1938	{ HID_USB_DEVICE(USB_VENDOR_ID_UCLOGIC, USB_DEVICE_ID_UCLOGIC_TABLET_TWHA60) },
1939	{ HID_USB_DEVICE(USB_VENDOR_ID_WISEGROUP, USB_DEVICE_ID_SMARTJOY_PLUS) },
1940	{ HID_USB_DEVICE(USB_VENDOR_ID_WISEGROUP, USB_DEVICE_ID_SUPER_JOY_BOX_3) },
1941	{ HID_USB_DEVICE(USB_VENDOR_ID_WISEGROUP, USB_DEVICE_ID_DUAL_USB_JOYPAD) },
1942	{ HID_USB_DEVICE(USB_VENDOR_ID_WISEGROUP_LTD, USB_DEVICE_ID_SUPER_JOY_BOX_3_PRO) },
1943	{ HID_USB_DEVICE(USB_VENDOR_ID_WISEGROUP_LTD, USB_DEVICE_ID_SUPER_DUAL_BOX_PRO) },
1944	{ HID_USB_DEVICE(USB_VENDOR_ID_WISEGROUP_LTD, USB_DEVICE_ID_SUPER_JOY_BOX_5_PRO) },
1945	{ HID_BLUETOOTH_DEVICE(USB_VENDOR_ID_WACOM, USB_DEVICE_ID_WACOM_INTUOS4_BLUETOOTH) },
1946	{ HID_USB_DEVICE(USB_VENDOR_ID_WALTOP, USB_DEVICE_ID_WALTOP_SLIM_TABLET_5_8_INCH) },
1947	{ HID_USB_DEVICE(USB_VENDOR_ID_WALTOP, USB_DEVICE_ID_WALTOP_SLIM_TABLET_12_1_INCH) },
1948	{ HID_USB_DEVICE(USB_VENDOR_ID_WALTOP, USB_DEVICE_ID_WALTOP_Q_PAD) },
1949	{ HID_USB_DEVICE(USB_VENDOR_ID_WALTOP, USB_DEVICE_ID_WALTOP_PID_0038) },
1950	{ HID_USB_DEVICE(USB_VENDOR_ID_WALTOP, USB_DEVICE_ID_WALTOP_MEDIA_TABLET_10_6_INCH) },
1951	{ HID_USB_DEVICE(USB_VENDOR_ID_WALTOP, USB_DEVICE_ID_WALTOP_MEDIA_TABLET_14_1_INCH) },
1952	{ HID_USB_DEVICE(USB_VENDOR_ID_WALTOP, USB_DEVICE_ID_WALTOP_SIRIUS_BATTERY_FREE_TABLET) },
1953	{ HID_USB_DEVICE(USB_VENDOR_ID_X_TENSIONS, USB_DEVICE_ID_SPEEDLINK_VAD_CEZANNE) },
1954	{ HID_USB_DEVICE(USB_VENDOR_ID_XIN_MO, USB_DEVICE_ID_XIN_MO_DUAL_ARCADE) },
1955	{ HID_USB_DEVICE(USB_VENDOR_ID_ZEROPLUS, 0x0005) },
1956	{ HID_USB_DEVICE(USB_VENDOR_ID_ZEROPLUS, 0x0030) },
1957	{ HID_USB_DEVICE(USB_VENDOR_ID_ZYDACRON, USB_DEVICE_ID_ZYDACRON_REMOTE_CONTROL) },
1958
1959	{ HID_BLUETOOTH_DEVICE(USB_VENDOR_ID_MICROSOFT, USB_DEVICE_ID_MS_PRESENTER_8K_BT) },
1960	{ HID_BLUETOOTH_DEVICE(USB_VENDOR_ID_NINTENDO, USB_DEVICE_ID_NINTENDO_WIIMOTE) },
1961	{ HID_BLUETOOTH_DEVICE(USB_VENDOR_ID_NINTENDO, USB_DEVICE_ID_NINTENDO_WIIMOTE2) },
1962	{ }
1963};
1964
1965struct hid_dynid {
1966	struct list_head list;
1967	struct hid_device_id id;
1968};
1969
1970/**
1971 * store_new_id - add a new HID device ID to this driver and re-probe devices
1972 * @driver: target device driver
1973 * @buf: buffer for scanning device ID data
1974 * @count: input size
1975 *
1976 * Adds a new dynamic hid device ID to this driver,
1977 * and causes the driver to probe for all devices again.
1978 */
1979static ssize_t store_new_id(struct device_driver *drv, const char *buf,
1980		size_t count)
1981{
1982	struct hid_driver *hdrv = container_of(drv, struct hid_driver, driver);
1983	struct hid_dynid *dynid;
1984	__u32 bus, vendor, product;
1985	unsigned long driver_data = 0;
1986	int ret;
1987
1988	ret = sscanf(buf, "%x %x %x %lx",
1989			&bus, &vendor, &product, &driver_data);
1990	if (ret < 3)
1991		return -EINVAL;
1992
1993	dynid = kzalloc(sizeof(*dynid), GFP_KERNEL);
1994	if (!dynid)
1995		return -ENOMEM;
1996
1997	dynid->id.bus = bus;
1998	dynid->id.group = HID_GROUP_ANY;
1999	dynid->id.vendor = vendor;
2000	dynid->id.product = product;
2001	dynid->id.driver_data = driver_data;
2002
2003	spin_lock(&hdrv->dyn_lock);
2004	list_add_tail(&dynid->list, &hdrv->dyn_list);
2005	spin_unlock(&hdrv->dyn_lock);
2006
2007	ret = driver_attach(&hdrv->driver);
2008
2009	return ret ? : count;
2010}
2011static DRIVER_ATTR(new_id, S_IWUSR, NULL, store_new_id);
2012
2013static void hid_free_dynids(struct hid_driver *hdrv)
2014{
2015	struct hid_dynid *dynid, *n;
2016
2017	spin_lock(&hdrv->dyn_lock);
2018	list_for_each_entry_safe(dynid, n, &hdrv->dyn_list, list) {
2019		list_del(&dynid->list);
2020		kfree(dynid);
2021	}
2022	spin_unlock(&hdrv->dyn_lock);
2023}
2024
2025static const struct hid_device_id *hid_match_device(struct hid_device *hdev,
2026		struct hid_driver *hdrv)
2027{
2028	struct hid_dynid *dynid;
2029
2030	spin_lock(&hdrv->dyn_lock);
2031	list_for_each_entry(dynid, &hdrv->dyn_list, list) {
2032		if (hid_match_one_id(hdev, &dynid->id)) {
2033			spin_unlock(&hdrv->dyn_lock);
2034			return &dynid->id;
2035		}
2036	}
2037	spin_unlock(&hdrv->dyn_lock);
2038
2039	return hid_match_id(hdev, hdrv->id_table);
2040}
2041
2042static int hid_bus_match(struct device *dev, struct device_driver *drv)
2043{
2044	struct hid_driver *hdrv = container_of(drv, struct hid_driver, driver);
2045	struct hid_device *hdev = container_of(dev, struct hid_device, dev);
2046
2047	return hid_match_device(hdev, hdrv) != NULL;
2048}
2049
2050static int hid_device_probe(struct device *dev)
2051{
2052	struct hid_driver *hdrv = container_of(dev->driver,
2053			struct hid_driver, driver);
2054	struct hid_device *hdev = container_of(dev, struct hid_device, dev);
2055	const struct hid_device_id *id;
2056	int ret = 0;
2057
2058	if (down_interruptible(&hdev->driver_lock))
2059		return -EINTR;
2060	if (down_interruptible(&hdev->driver_input_lock)) {
2061		ret = -EINTR;
2062		goto unlock_driver_lock;
2063	}
2064	hdev->io_started = false;
2065
2066	if (!hdev->driver) {
2067		id = hid_match_device(hdev, hdrv);
2068		if (id == NULL) {
2069			ret = -ENODEV;
2070			goto unlock;
2071		}
2072
2073		hdev->driver = hdrv;
2074		if (hdrv->probe) {
2075			ret = hdrv->probe(hdev, id);
2076		} else { /* default probe */
2077			ret = hid_open_report(hdev);
2078			if (!ret)
2079				ret = hid_hw_start(hdev, HID_CONNECT_DEFAULT);
2080		}
2081		if (ret) {
2082			hid_close_report(hdev);
2083			hdev->driver = NULL;
2084		}
2085	}
2086unlock:
2087	if (!hdev->io_started)
2088		up(&hdev->driver_input_lock);
2089unlock_driver_lock:
2090	up(&hdev->driver_lock);
2091	return ret;
2092}
2093
2094static int hid_device_remove(struct device *dev)
2095{
2096	struct hid_device *hdev = container_of(dev, struct hid_device, dev);
2097	struct hid_driver *hdrv;
2098	int ret = 0;
2099
2100	if (down_interruptible(&hdev->driver_lock))
2101		return -EINTR;
2102	if (down_interruptible(&hdev->driver_input_lock)) {
2103		ret = -EINTR;
2104		goto unlock_driver_lock;
2105	}
2106	hdev->io_started = false;
2107
2108	hdrv = hdev->driver;
2109	if (hdrv) {
2110		if (hdrv->remove)
2111			hdrv->remove(hdev);
2112		else /* default remove */
2113			hid_hw_stop(hdev);
2114		hid_close_report(hdev);
2115		hdev->driver = NULL;
2116	}
2117
2118	if (!hdev->io_started)
2119		up(&hdev->driver_input_lock);
2120unlock_driver_lock:
2121	up(&hdev->driver_lock);
2122	return ret;
2123}
2124
2125static ssize_t modalias_show(struct device *dev, struct device_attribute *a,
2126			     char *buf)
2127{
2128	struct hid_device *hdev = container_of(dev, struct hid_device, dev);
2129	int len;
2130
2131	len = snprintf(buf, PAGE_SIZE, "hid:b%04Xg%04Xv%08Xp%08X\n",
2132		       hdev->bus, hdev->group, hdev->vendor, hdev->product);
2133
2134	return (len >= PAGE_SIZE) ? (PAGE_SIZE - 1) : len;
2135}
2136static DEVICE_ATTR_RO(modalias);
2137
2138static struct attribute *hid_dev_attrs[] = {
2139	&dev_attr_modalias.attr,
2140	NULL,
2141};
2142ATTRIBUTE_GROUPS(hid_dev);
2143
2144static int hid_uevent(struct device *dev, struct kobj_uevent_env *env)
2145{
2146	struct hid_device *hdev = container_of(dev, struct hid_device, dev);
2147
2148	if (add_uevent_var(env, "HID_ID=%04X:%08X:%08X",
2149			hdev->bus, hdev->vendor, hdev->product))
2150		return -ENOMEM;
2151
2152	if (add_uevent_var(env, "HID_NAME=%s", hdev->name))
2153		return -ENOMEM;
2154
2155	if (add_uevent_var(env, "HID_PHYS=%s", hdev->phys))
2156		return -ENOMEM;
2157
2158	if (add_uevent_var(env, "HID_UNIQ=%s", hdev->uniq))
2159		return -ENOMEM;
2160
2161	if (add_uevent_var(env, "MODALIAS=hid:b%04Xg%04Xv%08Xp%08X",
2162			   hdev->bus, hdev->group, hdev->vendor, hdev->product))
2163		return -ENOMEM;
2164
2165	return 0;
2166}
2167
2168static struct bus_type hid_bus_type = {
2169	.name		= "hid",
2170	.dev_groups	= hid_dev_groups,
2171	.match		= hid_bus_match,
2172	.probe		= hid_device_probe,
2173	.remove		= hid_device_remove,
2174	.uevent		= hid_uevent,
2175};
2176
2177/* a list of devices that shouldn't be handled by HID core at all */
2178static const struct hid_device_id hid_ignore_list[] = {
2179	{ HID_USB_DEVICE(USB_VENDOR_ID_ACECAD, USB_DEVICE_ID_ACECAD_FLAIR) },
2180	{ HID_USB_DEVICE(USB_VENDOR_ID_ACECAD, USB_DEVICE_ID_ACECAD_302) },
2181	{ HID_USB_DEVICE(USB_VENDOR_ID_ADS_TECH, USB_DEVICE_ID_ADS_TECH_RADIO_SI470X) },
2182	{ HID_USB_DEVICE(USB_VENDOR_ID_AIPTEK, USB_DEVICE_ID_AIPTEK_01) },
2183	{ HID_USB_DEVICE(USB_VENDOR_ID_AIPTEK, USB_DEVICE_ID_AIPTEK_10) },
2184	{ HID_USB_DEVICE(USB_VENDOR_ID_AIPTEK, USB_DEVICE_ID_AIPTEK_20) },
2185	{ HID_USB_DEVICE(USB_VENDOR_ID_AIPTEK, USB_DEVICE_ID_AIPTEK_21) },
2186	{ HID_USB_DEVICE(USB_VENDOR_ID_AIPTEK, USB_DEVICE_ID_AIPTEK_22) },
2187	{ HID_USB_DEVICE(USB_VENDOR_ID_AIPTEK, USB_DEVICE_ID_AIPTEK_23) },
2188	{ HID_USB_DEVICE(USB_VENDOR_ID_AIPTEK, USB_DEVICE_ID_AIPTEK_24) },
2189	{ HID_USB_DEVICE(USB_VENDOR_ID_AIRCABLE, USB_DEVICE_ID_AIRCABLE1) },
2190	{ HID_USB_DEVICE(USB_VENDOR_ID_ALCOR, USB_DEVICE_ID_ALCOR_USBRS232) },
2191	{ HID_USB_DEVICE(USB_VENDOR_ID_ASUSTEK, USB_DEVICE_ID_ASUSTEK_LCM)},
2192	{ HID_USB_DEVICE(USB_VENDOR_ID_ASUSTEK, USB_DEVICE_ID_ASUSTEK_LCM2)},
2193	{ HID_USB_DEVICE(USB_VENDOR_ID_AVERMEDIA, USB_DEVICE_ID_AVER_FM_MR800) },
2194	{ HID_USB_DEVICE(USB_VENDOR_ID_AXENTIA, USB_DEVICE_ID_AXENTIA_FM_RADIO) },
2195	{ HID_USB_DEVICE(USB_VENDOR_ID_BERKSHIRE, USB_DEVICE_ID_BERKSHIRE_PCWD) },
2196	{ HID_USB_DEVICE(USB_VENDOR_ID_CIDC, 0x0103) },
2197	{ HID_USB_DEVICE(USB_VENDOR_ID_CYGNAL, USB_DEVICE_ID_CYGNAL_RADIO_SI470X) },
2198	{ HID_USB_DEVICE(USB_VENDOR_ID_CYGNAL, USB_DEVICE_ID_CYGNAL_RADIO_SI4713) },
2199	{ HID_USB_DEVICE(USB_VENDOR_ID_CMEDIA, USB_DEVICE_ID_CM109) },
2200	{ HID_USB_DEVICE(USB_VENDOR_ID_CYPRESS, USB_DEVICE_ID_CYPRESS_HIDCOM) },
2201	{ HID_USB_DEVICE(USB_VENDOR_ID_CYPRESS, USB_DEVICE_ID_CYPRESS_ULTRAMOUSE) },
2202	{ HID_USB_DEVICE(USB_VENDOR_ID_DEALEXTREAME, USB_DEVICE_ID_DEALEXTREAME_RADIO_SI4701) },
2203	{ HID_USB_DEVICE(USB_VENDOR_ID_DELORME, USB_DEVICE_ID_DELORME_EARTHMATE) },
2204	{ HID_USB_DEVICE(USB_VENDOR_ID_DELORME, USB_DEVICE_ID_DELORME_EM_LT20) },
2205	{ HID_USB_DEVICE(USB_VENDOR_ID_DREAM_CHEEKY, 0x0004) },
2206	{ HID_USB_DEVICE(USB_VENDOR_ID_DREAM_CHEEKY, 0x000a) },
2207	{ HID_USB_DEVICE(USB_VENDOR_ID_ESSENTIAL_REALITY, USB_DEVICE_ID_ESSENTIAL_REALITY_P5) },
2208	{ HID_USB_DEVICE(USB_VENDOR_ID_ETT, USB_DEVICE_ID_TC5UH) },
2209	{ HID_USB_DEVICE(USB_VENDOR_ID_ETT, USB_DEVICE_ID_TC4UM) },
2210	{ HID_USB_DEVICE(USB_VENDOR_ID_GENERAL_TOUCH, 0x0001) },
2211	{ HID_USB_DEVICE(USB_VENDOR_ID_GENERAL_TOUCH, 0x0002) },
2212	{ HID_USB_DEVICE(USB_VENDOR_ID_GENERAL_TOUCH, 0x0004) },
2213	{ HID_USB_DEVICE(USB_VENDOR_ID_GLAB, USB_DEVICE_ID_4_PHIDGETSERVO_30) },
2214	{ HID_USB_DEVICE(USB_VENDOR_ID_GLAB, USB_DEVICE_ID_1_PHIDGETSERVO_30) },
2215	{ HID_USB_DEVICE(USB_VENDOR_ID_GLAB, USB_DEVICE_ID_0_0_4_IF_KIT) },
2216	{ HID_USB_DEVICE(USB_VENDOR_ID_GLAB, USB_DEVICE_ID_0_16_16_IF_KIT) },
2217	{ HID_USB_DEVICE(USB_VENDOR_ID_GLAB, USB_DEVICE_ID_8_8_8_IF_KIT) },
2218	{ HID_USB_DEVICE(USB_VENDOR_ID_GLAB, USB_DEVICE_ID_0_8_7_IF_KIT) },
2219	{ HID_USB_DEVICE(USB_VENDOR_ID_GLAB, USB_DEVICE_ID_0_8_8_IF_KIT) },
2220	{ HID_USB_DEVICE(USB_VENDOR_ID_GLAB, USB_DEVICE_ID_PHIDGET_MOTORCONTROL) },
2221	{ HID_USB_DEVICE(USB_VENDOR_ID_GOTOP, USB_DEVICE_ID_SUPER_Q2) },
2222	{ HID_USB_DEVICE(USB_VENDOR_ID_GOTOP, USB_DEVICE_ID_GOGOPEN) },
2223	{ HID_USB_DEVICE(USB_VENDOR_ID_GOTOP, USB_DEVICE_ID_PENPOWER) },
2224	{ HID_USB_DEVICE(USB_VENDOR_ID_GRETAGMACBETH, USB_DEVICE_ID_GRETAGMACBETH_HUEY) },
2225	{ HID_USB_DEVICE(USB_VENDOR_ID_GRIFFIN, USB_DEVICE_ID_POWERMATE) },
2226	{ HID_USB_DEVICE(USB_VENDOR_ID_GRIFFIN, USB_DEVICE_ID_SOUNDKNOB) },
2227	{ HID_USB_DEVICE(USB_VENDOR_ID_GRIFFIN, USB_DEVICE_ID_RADIOSHARK) },
2228	{ HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_90) },
2229	{ HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_100) },
2230	{ HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_101) },
2231	{ HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_103) },
2232	{ HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_104) },
2233	{ HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_105) },
2234	{ HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_106) },
2235	{ HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_107) },
2236	{ HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_108) },
2237	{ HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_200) },
2238	{ HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_201) },
2239	{ HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_202) },
2240	{ HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_203) },
2241	{ HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_204) },
2242	{ HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_205) },
2243	{ HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_206) },
2244	{ HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_207) },
2245	{ HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_300) },
2246	{ HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_301) },
2247	{ HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_302) },
2248	{ HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_303) },
2249	{ HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_304) },
2250	{ HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_305) },
2251	{ HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_306) },
2252	{ HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_307) },
2253	{ HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_308) },
2254	{ HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_309) },
2255	{ HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_400) },
2256	{ HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_401) },
2257	{ HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_402) },
2258	{ HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_403) },
2259	{ HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_404) },
2260	{ HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_405) },
2261	{ HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_500) },
2262	{ HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_501) },
2263	{ HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_502) },
2264	{ HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_503) },
2265	{ HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_504) },
2266	{ HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_1000) },
2267	{ HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_1001) },
2268	{ HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_1002) },
2269	{ HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_1003) },
2270	{ HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_1004) },
2271	{ HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_1005) },
2272	{ HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_1006) },
2273	{ HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_1007) },
2274	{ HID_USB_DEVICE(USB_VENDOR_ID_IMATION, USB_DEVICE_ID_DISC_STAKKA) },
2275	{ HID_USB_DEVICE(USB_VENDOR_ID_JABRA, USB_DEVICE_ID_JABRA_SPEAK_410) },
2276	{ HID_USB_DEVICE(USB_VENDOR_ID_JABRA, USB_DEVICE_ID_JABRA_SPEAK_510) },
2277	{ HID_USB_DEVICE(USB_VENDOR_ID_KBGEAR, USB_DEVICE_ID_KBGEAR_JAMSTUDIO) },
2278	{ HID_USB_DEVICE(USB_VENDOR_ID_KWORLD, USB_DEVICE_ID_KWORLD_RADIO_FM700) },
2279	{ HID_USB_DEVICE(USB_VENDOR_ID_KYE, USB_DEVICE_ID_KYE_GPEN_560) },
2280	{ HID_BLUETOOTH_DEVICE(USB_VENDOR_ID_KYE, 0x0058) },
2281	{ HID_USB_DEVICE(USB_VENDOR_ID_LD, USB_DEVICE_ID_LD_CASSY) },
2282	{ HID_USB_DEVICE(USB_VENDOR_ID_LD, USB_DEVICE_ID_LD_CASSY2) },
2283	{ HID_USB_DEVICE(USB_VENDOR_ID_LD, USB_DEVICE_ID_LD_POCKETCASSY) },
2284	{ HID_USB_DEVICE(USB_VENDOR_ID_LD, USB_DEVICE_ID_LD_POCKETCASSY2) },
2285	{ HID_USB_DEVICE(USB_VENDOR_ID_LD, USB_DEVICE_ID_LD_MOBILECASSY) },
2286	{ HID_USB_DEVICE(USB_VENDOR_ID_LD, USB_DEVICE_ID_LD_MOBILECASSY2) },
2287	{ HID_USB_DEVICE(USB_VENDOR_ID_LD, USB_DEVICE_ID_LD_MICROCASSYVOLTAGE) },
2288	{ HID_USB_DEVICE(USB_VENDOR_ID_LD, USB_DEVICE_ID_LD_MICROCASSYCURRENT) },
2289	{ HID_USB_DEVICE(USB_VENDOR_ID_LD, USB_DEVICE_ID_LD_MICROCASSYTIME) },
2290	{ HID_USB_DEVICE(USB_VENDOR_ID_LD, USB_DEVICE_ID_LD_MICROCASSYTEMPERATURE) },
2291	{ HID_USB_DEVICE(USB_VENDOR_ID_LD, USB_DEVICE_ID_LD_MICROCASSYPH) },
2292	{ HID_USB_DEVICE(USB_VENDOR_ID_LD, USB_DEVICE_ID_LD_JWM) },
2293	{ HID_USB_DEVICE(USB_VENDOR_ID_LD, USB_DEVICE_ID_LD_DMMP) },
2294	{ HID_USB_DEVICE(USB_VENDOR_ID_LD, USB_DEVICE_ID_LD_UMIP) },
2295	{ HID_USB_DEVICE(USB_VENDOR_ID_LD, USB_DEVICE_ID_LD_UMIC) },
2296	{ HID_USB_DEVICE(USB_VENDOR_ID_LD, USB_DEVICE_ID_LD_UMIB) },
2297	{ HID_USB_DEVICE(USB_VENDOR_ID_LD, USB_DEVICE_ID_LD_XRAY) },
2298	{ HID_USB_DEVICE(USB_VENDOR_ID_LD, USB_DEVICE_ID_LD_XRAY2) },
2299	{ HID_USB_DEVICE(USB_VENDOR_ID_LD, USB_DEVICE_ID_LD_VIDEOCOM) },
2300	{ HID_USB_DEVICE(USB_VENDOR_ID_LD, USB_DEVICE_ID_LD_MOTOR) },
2301	{ HID_USB_DEVICE(USB_VENDOR_ID_LD, USB_DEVICE_ID_LD_COM3LAB) },
2302	{ HID_USB_DEVICE(USB_VENDOR_ID_LD, USB_DEVICE_ID_LD_TELEPORT) },
2303	{ HID_USB_DEVICE(USB_VENDOR_ID_LD, USB_DEVICE_ID_LD_NETWORKANALYSER) },
2304	{ HID_USB_DEVICE(USB_VENDOR_ID_LD, USB_DEVICE_ID_LD_POWERCONTROL) },
2305	{ HID_USB_DEVICE(USB_VENDOR_ID_LD, USB_DEVICE_ID_LD_MACHINETEST) },
2306	{ HID_USB_DEVICE(USB_VENDOR_ID_LD, USB_DEVICE_ID_LD_MOSTANALYSER) },
2307	{ HID_USB_DEVICE(USB_VENDOR_ID_LD, USB_DEVICE_ID_LD_MOSTANALYSER2) },
2308	{ HID_USB_DEVICE(USB_VENDOR_ID_LD, USB_DEVICE_ID_LD_ABSESP) },
2309	{ HID_USB_DEVICE(USB_VENDOR_ID_LD, USB_DEVICE_ID_LD_AUTODATABUS) },
2310	{ HID_USB_DEVICE(USB_VENDOR_ID_LD, USB_DEVICE_ID_LD_MCT) },
2311	{ HID_USB_DEVICE(USB_VENDOR_ID_LD, USB_DEVICE_ID_LD_HYBRID) },
2312	{ HID_USB_DEVICE(USB_VENDOR_ID_LD, USB_DEVICE_ID_LD_HEATCONTROL) },
2313	{ HID_USB_DEVICE(USB_VENDOR_ID_MADCATZ, USB_DEVICE_ID_MADCATZ_BEATPAD) },
2314	{ HID_USB_DEVICE(USB_VENDOR_ID_MCC, USB_DEVICE_ID_MCC_PMD1024LS) },
2315	{ HID_USB_DEVICE(USB_VENDOR_ID_MCC, USB_DEVICE_ID_MCC_PMD1208LS) },
2316	{ HID_USB_DEVICE(USB_VENDOR_ID_MICROCHIP, USB_DEVICE_ID_PICKIT1) },
2317	{ HID_USB_DEVICE(USB_VENDOR_ID_MICROCHIP, USB_DEVICE_ID_PICKIT2) },
2318	{ HID_USB_DEVICE(USB_VENDOR_ID_NATIONAL_SEMICONDUCTOR, USB_DEVICE_ID_N_S_HARMONY) },
2319	{ HID_USB_DEVICE(USB_VENDOR_ID_ONTRAK, USB_DEVICE_ID_ONTRAK_ADU100) },
2320	{ HID_USB_DEVICE(USB_VENDOR_ID_ONTRAK, USB_DEVICE_ID_ONTRAK_ADU100 + 20) },
2321	{ HID_USB_DEVICE(USB_VENDOR_ID_ONTRAK, USB_DEVICE_ID_ONTRAK_ADU100 + 30) },
2322	{ HID_USB_DEVICE(USB_VENDOR_ID_ONTRAK, USB_DEVICE_ID_ONTRAK_ADU100 + 100) },
2323	{ HID_USB_DEVICE(USB_VENDOR_ID_ONTRAK, USB_DEVICE_ID_ONTRAK_ADU100 + 108) },
2324	{ HID_USB_DEVICE(USB_VENDOR_ID_ONTRAK, USB_DEVICE_ID_ONTRAK_ADU100 + 118) },
2325	{ HID_USB_DEVICE(USB_VENDOR_ID_ONTRAK, USB_DEVICE_ID_ONTRAK_ADU100 + 200) },
2326	{ HID_USB_DEVICE(USB_VENDOR_ID_ONTRAK, USB_DEVICE_ID_ONTRAK_ADU100 + 300) },
2327	{ HID_USB_DEVICE(USB_VENDOR_ID_ONTRAK, USB_DEVICE_ID_ONTRAK_ADU100 + 400) },
2328	{ HID_USB_DEVICE(USB_VENDOR_ID_ONTRAK, USB_DEVICE_ID_ONTRAK_ADU100 + 500) },
2329	{ HID_USB_DEVICE(USB_VENDOR_ID_PANJIT, 0x0001) },
2330	{ HID_USB_DEVICE(USB_VENDOR_ID_PANJIT, 0x0002) },
2331	{ HID_USB_DEVICE(USB_VENDOR_ID_PANJIT, 0x0003) },
2332	{ HID_USB_DEVICE(USB_VENDOR_ID_PANJIT, 0x0004) },
2333	{ HID_USB_DEVICE(USB_VENDOR_ID_PHILIPS, USB_DEVICE_ID_PHILIPS_IEEE802154_DONGLE) },
2334	{ HID_USB_DEVICE(USB_VENDOR_ID_POWERCOM, USB_DEVICE_ID_POWERCOM_UPS) },
2335#if defined(CONFIG_MOUSE_SYNAPTICS_USB) || defined(CONFIG_MOUSE_SYNAPTICS_USB_MODULE)
2336	{ HID_USB_DEVICE(USB_VENDOR_ID_SYNAPTICS, USB_DEVICE_ID_SYNAPTICS_TP) },
2337	{ HID_USB_DEVICE(USB_VENDOR_ID_SYNAPTICS, USB_DEVICE_ID_SYNAPTICS_INT_TP) },
2338	{ HID_USB_DEVICE(USB_VENDOR_ID_SYNAPTICS, USB_DEVICE_ID_SYNAPTICS_CPAD) },
2339	{ HID_USB_DEVICE(USB_VENDOR_ID_SYNAPTICS, USB_DEVICE_ID_SYNAPTICS_STICK) },
2340	{ HID_USB_DEVICE(USB_VENDOR_ID_SYNAPTICS, USB_DEVICE_ID_SYNAPTICS_WP) },
2341	{ HID_USB_DEVICE(USB_VENDOR_ID_SYNAPTICS, USB_DEVICE_ID_SYNAPTICS_COMP_TP) },
2342	{ HID_USB_DEVICE(USB_VENDOR_ID_SYNAPTICS, USB_DEVICE_ID_SYNAPTICS_WTP) },
2343	{ HID_USB_DEVICE(USB_VENDOR_ID_SYNAPTICS, USB_DEVICE_ID_SYNAPTICS_DPAD) },
2344#endif
2345	{ HID_USB_DEVICE(USB_VENDOR_ID_VERNIER, USB_DEVICE_ID_VERNIER_LABPRO) },
2346	{ HID_USB_DEVICE(USB_VENDOR_ID_VERNIER, USB_DEVICE_ID_VERNIER_GOTEMP) },
2347	{ HID_USB_DEVICE(USB_VENDOR_ID_VERNIER, USB_DEVICE_ID_VERNIER_SKIP) },
2348	{ HID_USB_DEVICE(USB_VENDOR_ID_VERNIER, USB_DEVICE_ID_VERNIER_CYCLOPS) },
2349	{ HID_USB_DEVICE(USB_VENDOR_ID_VERNIER, USB_DEVICE_ID_VERNIER_LCSPEC) },
2350	{ HID_USB_DEVICE(USB_VENDOR_ID_WISEGROUP, USB_DEVICE_ID_4_PHIDGETSERVO_20) },
2351	{ HID_USB_DEVICE(USB_VENDOR_ID_WISEGROUP, USB_DEVICE_ID_1_PHIDGETSERVO_20) },
2352	{ HID_USB_DEVICE(USB_VENDOR_ID_WISEGROUP, USB_DEVICE_ID_8_8_4_IF_KIT) },
2353	{ HID_USB_DEVICE(USB_VENDOR_ID_YEALINK, USB_DEVICE_ID_YEALINK_P1K_P4K_B2K) },
2354	{ HID_USB_DEVICE(USB_VENDOR_ID_RISO_KAGAKU, USB_DEVICE_ID_RI_KA_WEBMAIL) },
2355	{ }
2356};
2357
2358/**
2359 * hid_mouse_ignore_list - mouse devices which should not be handled by the hid layer
2360 *
2361 * There are composite devices for which we want to ignore only a certain
2362 * interface. This is a list of devices for which only the mouse interface will
2363 * be ignored. This allows a dedicated driver to take care of the interface.
2364 */
2365static const struct hid_device_id hid_mouse_ignore_list[] = {
2366	/* appletouch driver */
2367	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_FOUNTAIN_ANSI) },
2368	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_FOUNTAIN_ISO) },
2369	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_GEYSER_ANSI) },
2370	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_GEYSER_ISO) },
2371	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_GEYSER_JIS) },
2372	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_GEYSER3_ANSI) },
2373	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_GEYSER3_ISO) },
2374	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_GEYSER3_JIS) },
2375	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_GEYSER4_ANSI) },
2376	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_GEYSER4_ISO) },
2377	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_GEYSER4_JIS) },
2378	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_GEYSER4_HF_ANSI) },
2379	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_GEYSER4_HF_ISO) },
2380	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_GEYSER4_HF_JIS) },
2381	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING_ANSI) },
2382	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING_ISO) },
2383	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING_JIS) },
2384	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING2_ANSI) },
2385	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING2_ISO) },
2386	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING2_JIS) },
2387	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING3_ANSI) },
2388	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING3_ISO) },
2389	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING3_JIS) },
2390	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING4_ANSI) },
2391	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING4_ISO) },
2392	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING4_JIS) },
2393	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING4A_ANSI) },
2394	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING4A_ISO) },
2395	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING4A_JIS) },
2396	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING5_ANSI) },
2397	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING5_ISO) },
2398	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING5_JIS) },
2399	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING5A_ANSI) },
2400	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING5A_ISO) },
2401	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING5A_JIS) },
2402	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING6_ANSI) },
2403	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING6_ISO) },
2404	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING6_JIS) },
2405	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING6A_ANSI) },
2406	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING6A_ISO) },
2407	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING6A_JIS) },
2408	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING7_ANSI) },
2409	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING7_ISO) },
2410	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING7_JIS) },
2411	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING7A_ANSI) },
2412	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING7A_ISO) },
2413	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING7A_JIS) },
2414	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING8_ANSI) },
2415	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING8_ISO) },
2416	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING8_JIS) },
2417	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_FOUNTAIN_TP_ONLY) },
2418	{ HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_GEYSER1_TP_ONLY) },
2419	{ }
2420};
2421
2422bool hid_ignore(struct hid_device *hdev)
2423{
2424	if (hdev->quirks & HID_QUIRK_NO_IGNORE)
2425		return false;
2426	if (hdev->quirks & HID_QUIRK_IGNORE)
2427		return true;
2428
2429	switch (hdev->vendor) {
2430	case USB_VENDOR_ID_CODEMERCS:
2431		/* ignore all Code Mercenaries IOWarrior devices */
2432		if (hdev->product >= USB_DEVICE_ID_CODEMERCS_IOW_FIRST &&
2433				hdev->product <= USB_DEVICE_ID_CODEMERCS_IOW_LAST)
2434			return true;
2435		break;
2436	case USB_VENDOR_ID_LOGITECH:
2437		if (hdev->product >= USB_DEVICE_ID_LOGITECH_HARMONY_FIRST &&
2438				hdev->product <= USB_DEVICE_ID_LOGITECH_HARMONY_LAST)
2439			return true;
2440		/*
2441		 * The Keene FM transmitter USB device has the same USB ID as
2442		 * the Logitech AudioHub Speaker, but it should ignore the hid.
2443		 * Check if the name is that of the Keene device.
2444		 * For reference: the name of the AudioHub is
2445		 * "HOLTEK  AudioHub Speaker".
2446		 */
2447		if (hdev->product == USB_DEVICE_ID_LOGITECH_AUDIOHUB &&
2448			!strcmp(hdev->name, "HOLTEK  B-LINK USB Audio  "))
2449				return true;
2450		break;
2451	case USB_VENDOR_ID_SOUNDGRAPH:
2452		if (hdev->product >= USB_DEVICE_ID_SOUNDGRAPH_IMON_FIRST &&
2453		    hdev->product <= USB_DEVICE_ID_SOUNDGRAPH_IMON_LAST)
2454			return true;
2455		break;
2456	case USB_VENDOR_ID_HANWANG:
2457		if (hdev->product >= USB_DEVICE_ID_HANWANG_TABLET_FIRST &&
2458		    hdev->product <= USB_DEVICE_ID_HANWANG_TABLET_LAST)
2459			return true;
2460		break;
2461	case USB_VENDOR_ID_JESS:
2462		if (hdev->product == USB_DEVICE_ID_JESS_YUREX &&
2463				hdev->type == HID_TYPE_USBNONE)
2464			return true;
2465		break;
2466	case USB_VENDOR_ID_VELLEMAN:
2467		/* These are not HID devices.  They are handled by comedi. */
2468		if ((hdev->product >= USB_DEVICE_ID_VELLEMAN_K8055_FIRST &&
2469		     hdev->product <= USB_DEVICE_ID_VELLEMAN_K8055_LAST) ||
2470		    (hdev->product >= USB_DEVICE_ID_VELLEMAN_K8061_FIRST &&
2471		     hdev->product <= USB_DEVICE_ID_VELLEMAN_K8061_LAST))
2472			return true;
2473		break;
2474	case USB_VENDOR_ID_ATMEL_V_USB:
2475		/* Masterkit MA901 usb radio based on Atmel tiny85 chip and
2476		 * it has the same USB ID as many Atmel V-USB devices. This
2477		 * usb radio is handled by radio-ma901.c driver so we want
2478		 * ignore the hid. Check the name, bus, product and ignore
2479		 * if we have MA901 usb radio.
2480		 */
2481		if (hdev->product == USB_DEVICE_ID_ATMEL_V_USB &&
2482			hdev->bus == BUS_USB &&
2483			strncmp(hdev->name, "www.masterkit.ru MA901", 22) == 0)
2484			return true;
2485		break;
2486	}
2487
2488	if (hdev->type == HID_TYPE_USBMOUSE &&
2489			hid_match_id(hdev, hid_mouse_ignore_list))
2490		return true;
2491
2492	return !!hid_match_id(hdev, hid_ignore_list);
2493}
2494EXPORT_SYMBOL_GPL(hid_ignore);
2495
2496int hid_add_device(struct hid_device *hdev)
2497{
2498	static atomic_t id = ATOMIC_INIT(0);
2499	int ret;
2500
2501	if (WARN_ON(hdev->status & HID_STAT_ADDED))
2502		return -EBUSY;
2503
2504	/* we need to kill them here, otherwise they will stay allocated to
2505	 * wait for coming driver */
2506	if (hid_ignore(hdev))
2507		return -ENODEV;
2508
2509	/*
2510	 * Check for the mandatory transport channel.
2511	 */
2512	 if (!hdev->ll_driver->raw_request) {
2513		hid_err(hdev, "transport driver missing .raw_request()\n");
2514		return -EINVAL;
2515	 }
2516
2517	/*
2518	 * Read the device report descriptor once and use as template
2519	 * for the driver-specific modifications.
2520	 */
2521	ret = hdev->ll_driver->parse(hdev);
2522	if (ret)
2523		return ret;
2524	if (!hdev->dev_rdesc)
2525		return -ENODEV;
2526
2527	/*
2528	 * Scan generic devices for group information
2529	 */
2530	if (hid_ignore_special_drivers ||
2531	    !hid_match_id(hdev, hid_have_special_driver)) {
2532		ret = hid_scan_report(hdev);
2533		if (ret)
2534			hid_warn(hdev, "bad device descriptor (%d)\n", ret);
2535	}
2536
2537	/* XXX hack, any other cleaner solution after the driver core
2538	 * is converted to allow more than 20 bytes as the device name? */
2539	dev_set_name(&hdev->dev, "%04X:%04X:%04X.%04X", hdev->bus,
2540		     hdev->vendor, hdev->product, atomic_inc_return(&id));
2541
2542	hid_debug_register(hdev, dev_name(&hdev->dev));
2543	ret = device_add(&hdev->dev);
2544	if (!ret)
2545		hdev->status |= HID_STAT_ADDED;
2546	else
2547		hid_debug_unregister(hdev);
2548
2549	return ret;
2550}
2551EXPORT_SYMBOL_GPL(hid_add_device);
2552
2553/**
2554 * hid_allocate_device - allocate new hid device descriptor
2555 *
2556 * Allocate and initialize hid device, so that hid_destroy_device might be
2557 * used to free it.
2558 *
2559 * New hid_device pointer is returned on success, otherwise ERR_PTR encoded
2560 * error value.
2561 */
2562struct hid_device *hid_allocate_device(void)
2563{
2564	struct hid_device *hdev;
2565	int ret = -ENOMEM;
2566
2567	hdev = kzalloc(sizeof(*hdev), GFP_KERNEL);
2568	if (hdev == NULL)
2569		return ERR_PTR(ret);
2570
2571	device_initialize(&hdev->dev);
2572	hdev->dev.release = hid_device_release;
2573	hdev->dev.bus = &hid_bus_type;
2574
2575	hid_close_report(hdev);
2576
2577	init_waitqueue_head(&hdev->debug_wait);
2578	INIT_LIST_HEAD(&hdev->debug_list);
2579	spin_lock_init(&hdev->debug_list_lock);
2580	sema_init(&hdev->driver_lock, 1);
2581	sema_init(&hdev->driver_input_lock, 1);
2582
2583	return hdev;
2584}
2585EXPORT_SYMBOL_GPL(hid_allocate_device);
2586
2587static void hid_remove_device(struct hid_device *hdev)
2588{
2589	if (hdev->status & HID_STAT_ADDED) {
2590		device_del(&hdev->dev);
2591		hid_debug_unregister(hdev);
2592		hdev->status &= ~HID_STAT_ADDED;
2593	}
2594	kfree(hdev->dev_rdesc);
2595	hdev->dev_rdesc = NULL;
2596	hdev->dev_rsize = 0;
2597}
2598
2599/**
2600 * hid_destroy_device - free previously allocated device
2601 *
2602 * @hdev: hid device
2603 *
2604 * If you allocate hid_device through hid_allocate_device, you should ever
2605 * free by this function.
2606 */
2607void hid_destroy_device(struct hid_device *hdev)
2608{
2609	hid_remove_device(hdev);
2610	put_device(&hdev->dev);
2611}
2612EXPORT_SYMBOL_GPL(hid_destroy_device);
2613
2614int __hid_register_driver(struct hid_driver *hdrv, struct module *owner,
2615		const char *mod_name)
2616{
2617	int ret;
2618
2619	hdrv->driver.name = hdrv->name;
2620	hdrv->driver.bus = &hid_bus_type;
2621	hdrv->driver.owner = owner;
2622	hdrv->driver.mod_name = mod_name;
2623
2624	INIT_LIST_HEAD(&hdrv->dyn_list);
2625	spin_lock_init(&hdrv->dyn_lock);
2626
2627	ret = driver_register(&hdrv->driver);
2628	if (ret)
2629		return ret;
2630
2631	ret = driver_create_file(&hdrv->driver, &driver_attr_new_id);
2632	if (ret)
2633		driver_unregister(&hdrv->driver);
2634
2635	return ret;
2636}
2637EXPORT_SYMBOL_GPL(__hid_register_driver);
2638
2639void hid_unregister_driver(struct hid_driver *hdrv)
2640{
2641	driver_remove_file(&hdrv->driver, &driver_attr_new_id);
2642	driver_unregister(&hdrv->driver);
2643	hid_free_dynids(hdrv);
2644}
2645EXPORT_SYMBOL_GPL(hid_unregister_driver);
2646
2647int hid_check_keys_pressed(struct hid_device *hid)
2648{
2649	struct hid_input *hidinput;
2650	int i;
2651
2652	if (!(hid->claimed & HID_CLAIMED_INPUT))
2653		return 0;
2654
2655	list_for_each_entry(hidinput, &hid->inputs, list) {
2656		for (i = 0; i < BITS_TO_LONGS(KEY_MAX); i++)
2657			if (hidinput->input->key[i])
2658				return 1;
2659	}
2660
2661	return 0;
2662}
2663
2664EXPORT_SYMBOL_GPL(hid_check_keys_pressed);
2665
2666static int __init hid_init(void)
2667{
2668	int ret;
2669
2670	if (hid_debug)
2671		pr_warn("hid_debug is now used solely for parser and driver debugging.\n"
2672			"debugfs is now used for inspecting the device (report descriptor, reports)\n");
2673
2674	ret = bus_register(&hid_bus_type);
2675	if (ret) {
2676		pr_err("can't register hid bus\n");
2677		goto err;
2678	}
2679
2680	ret = hidraw_init();
2681	if (ret)
2682		goto err_bus;
2683
2684	hid_debug_init();
2685
2686	return 0;
2687err_bus:
2688	bus_unregister(&hid_bus_type);
2689err:
2690	return ret;
2691}
2692
2693static void __exit hid_exit(void)
2694{
2695	hid_debug_exit();
2696	hidraw_exit();
2697	bus_unregister(&hid_bus_type);
2698}
2699
2700module_init(hid_init);
2701module_exit(hid_exit);
2702
2703MODULE_AUTHOR("Andreas Gal");
2704MODULE_AUTHOR("Vojtech Pavlik");
2705MODULE_AUTHOR("Jiri Kosina");
2706MODULE_LICENSE(DRIVER_LICENSE);
2707
2708