54  * Register a new report for a device.
62 	struct hid_report *report;  in hid_register_report()  local
69 	report = kzalloc(sizeof(struct hid_report), GFP_KERNEL);  in hid_register_report()
70 	if (!report)  in hid_register_report()
76 	report->id = id;  in hid_register_report()
77 	report->type = type;  in hid_register_report()
78 	report->size = 0;  in hid_register_report()
79 	report->device = device;  in hid_register_report()
80 	report->application = application;  in hid_register_report()
81 	report_enum->report_id_hash[id] = report;  in hid_register_report()
83 	list_add_tail(&report->list, &report_enum->report_list);  in hid_register_report()
85 	return report;  in hid_register_report()
90  * Register a new field for this report.
93 static struct hid_field *hid_register_field(struct hid_report *report, unsigned usages, unsigned va…  in hid_register_field()  argument
97 	if (report->maxfield == HID_MAX_FIELDS) {  in hid_register_field()
98 		hid_err(report->device, "too many fields in report\n");  in hid_register_field()
108 	field->index = report->maxfield++;  in hid_register_field()
109 	report->field[field->index] = field;  in hid_register_field()
112 	field->report = report;  in hid_register_field()
254  * Register a new field for this report.
259 	struct hid_report *report;  in hid_add_field()  local
268 	report = hid_register_report(parser->device, report_type,  in hid_add_field()
270 	if (!report) {  in hid_add_field()
288 	offset = report->size;  in hid_add_field()
289 	report->size += parser->global.report_size * parser->global.report_count;  in hid_add_field()
291 	/* Total size check: Allow for possible report index byte */  in hid_add_field()
292 	if (report->size > (HID_MAX_BUFFER_SIZE - 1) << 3) {  in hid_add_field()
293 		hid_err(parser->device, "report is too long\n");  in hid_add_field()
303 	field = hid_register_field(report, usages, parser->global.report_count);  in hid_add_field()
650  * Free a report and all registered fields. The field->usage and
655 static void hid_free_report(struct hid_report *report)  in hid_free_report()  argument
659 	for (n = 0; n < report->maxfield; n++)  in hid_free_report()
660 		kfree(report->field[n]);  in hid_free_report()
661 	kfree(report);  in hid_free_report()
665  * Close report. This function returns the device
676 			struct hid_report *report = report_enum->report_id_hash[j];  in hid_close_report()  local
677 			if (report)  in hid_close_report()
678 				hid_free_report(report);  in hid_close_report()
711  * Fetch a report description item from the data stream. We support long
863  * Scan a report descriptor before the device is added to the bus.
928  * hid_parse_report - parse device report
931  * @start: report start
932  * @size: report size
934  * Allocate the device report as read by the bus driver. This function should
953  * hid_validate_values - validate existing device report's value indexes
956  * @type: which report type to examine
957  * @id: which report ID to examine (0 for first)
958  * @field_index: which report field to examine
961  * Validate the number of values in a given field of a given report, after
969 	struct hid_report *report;  in hid_validate_values()  local
972 		hid_err(hid, "invalid HID report type %u\n", type);  in hid_validate_values()
977 		hid_err(hid, "invalid HID report id %u\n", id);  in hid_validate_values()
984 	 * drivers go to access report values.  in hid_validate_values()
989 		 * report in the list.  in hid_validate_values()
991 		report = list_entry(  in hid_validate_values()
995 		report = hid->report_enum[type].report_id_hash[id];  in hid_validate_values()
997 	if (!report) {  in hid_validate_values()
1001 	if (report->maxfield <= field_index) {  in hid_validate_values()
1006 	if (report->field[field_index]->report_count < report_counts) {  in hid_validate_values()
1011 	return report;  in hid_validate_values()
1065 	 * to all fields in the report.  in hid_apply_multiplier_to_field()
1102 	 * controls in the report."  in hid_apply_multiplier()
1163 			/* Ignore if report count is out of bounds. */  in hid_setup_resolution_multiplier()
1179  * hid_open_report - open a driver-specific device report
1183  * Parse a report description into a hid_device structure. Reports are
1269 				hid_err(device, "unbalanced collection at end of report description\n");  in hid_open_report()
1273 				hid_err(device, "unbalanced delimiter at end of report description\n");  in hid_open_report()
1337  * Extract/implement a data field from/to a little endian report (bit array).
1342  * While the USB HID spec allows unlimited length bit fields in "report
1344  * One model of UPS is claimed to report "LINEV" as a 32-bit field.
1348 static u32 __extract(u8 *report, unsigned offset, int n)  in __extract()  argument
1358 		value |= ((u32)report[idx] >> bit_shift) << bit_nr;  in __extract()
1369 u32 hid_field_extract(const struct hid_device *hid, u8 *report,  in hid_field_extract()  argument
1378 	return __extract(report, offset, n);  in hid_field_extract()
1391 static void __implement(u8 *report, unsigned offset, int n, u32 value)  in __implement()  argument
1398 		report[idx] &= ~(0xff << bit_shift);  in __implement()
1399 		report[idx] |= value << bit_shift;  in __implement()
1410 		report[idx] &= ~(bit_mask << bit_shift);  in __implement()
1411 		report[idx] |= value << bit_shift;  in __implement()
1415 static void implement(const struct hid_device *hid, u8 *report,  in implement()  argument
1434 	__implement(report, offset, n, value);  in implement()
1454  * @report: hid report to match against
1456  * compare hid->driver->report_table->report_type to report->type
1458 static int hid_match_report(struct hid_device *hid, struct hid_report *report)  in hid_match_report()  argument
1467 				id->report_type == report->type)  in hid_match_report()
1526  * content is stored for next report processing (we do differential
1552 		/* Ignore report if ErrorRollOver */  in hid_input_field()
1586  * Output the field into the report.
1608  * Compute the size of a report.
1610 static size_t hid_compute_report_size(struct hid_report *report)  in hid_compute_report_size()  argument
1612 	if (report->size)  in hid_compute_report_size()
1613 		return ((report->size - 1) >> 3) + 1;  in hid_compute_report_size()
1619  * Create a report. 'data' has to be allocated using
1623 void hid_output_report(struct hid_report *report, __u8 *data)  in hid_output_report()  argument
1627 	if (report->id > 0)  in hid_output_report()
1628 		*data++ = report->id;  in hid_output_report()
1630 	memset(data, 0, hid_compute_report_size(report));  in hid_output_report()
1631 	for (n = 0; n < report->maxfield; n++)  in hid_output_report()
1632 		hid_output_field(report->device, report->field[n], data);  in hid_output_report()
1639 u8 *hid_alloc_report_buf(struct hid_report *report, gfp_t flags)  in hid_alloc_report_buf()  argument
1646 	u32 len = hid_report_len(report) + 7;  in hid_alloc_report_buf()
1653  * Set a field value. The report this field belongs to has to be
1667 	hid_dump_input(field->report->device, field->usage + offset, value);  in hid_set_field()
1670 		hid_err(field->report->device, "offset (%d) exceeds report_count (%d)\n",  in hid_set_field()
1676 			hid_err(field->report->device, "value %d is out of range\n", value);  in hid_set_field()
1688 	struct hid_report *report;  in hid_get_report()  local
1689 	unsigned int n = 0;	/* Normally report number is 0 */  in hid_get_report()
1691 	/* Device uses numbered reports, data[0] is report number */  in hid_get_report()
1695 	report = report_enum->report_id_hash[n];  in hid_get_report()
1696 	if (report == NULL)  in hid_get_report()
1699 	return report;  in hid_get_report()
1706 int __hid_request(struct hid_device *hid, struct hid_report *report,  in __hid_request()  argument
1713 	buf = hid_alloc_report_buf(report, GFP_KERNEL);  in __hid_request()
1717 	len = hid_report_len(report);  in __hid_request()
1720 		hid_output_report(report, buf);  in __hid_request()
1722 	ret = hid->ll_driver->raw_request(hid, report->id, buf, len,  in __hid_request()
1723 					  report->type, reqtype);  in __hid_request()
1730 		hid_input_report(hid, report->type, buf, ret, 0);  in __hid_request()
1744 	struct hid_report *report;  in hid_report_raw_event()  local
1751 	report = hid_get_report(report_enum, data);  in hid_report_raw_event()
1752 	if (!report)  in hid_report_raw_event()
1760 	rsize = hid_compute_report_size(report);  in hid_report_raw_event()
1768 		dbg_hid("report %d is too short, (%d < %d)\n", report->id,  in hid_report_raw_event()
1774 		hid->hiddev_report_event(hid, report);  in hid_report_raw_event()
1781 	if (hid->claimed != HID_CLAIMED_HIDRAW && report->maxfield) {  in hid_report_raw_event()
1782 		for (a = 0; a < report->maxfield; a++)  in hid_report_raw_event()
1783 			hid_input_field(hid, report->field[a], cdata, interrupt);  in hid_report_raw_event()
1785 		if (hdrv && hdrv->report)  in hid_report_raw_event()
1786 			hdrv->report(hid, report);  in hid_report_raw_event()
1790 		hidinput_report_event(hid, report);  in hid_report_raw_event()
1797  * hid_input_report - report data from lower layer (usb, bt...)
1800  * @type: HID report type (HID_*_REPORT)
1801  * @data: report contents
1811 	struct hid_report *report;  in hid_input_report()  local
1828 		dbg_hid("empty report\n");  in hid_input_report()
1837 	report = hid_get_report(report_enum, data);  in hid_input_report()
1839 	if (!report) {  in hid_input_report()
1844 	if (hdrv && hdrv->raw_event && hid_match_report(hid, report)) {  in hid_input_report()
1845 		ret = hdrv->raw_event(hid, report, data, size);  in hid_input_report()
2410 	 * Read the device report descriptor once and use as template  in hid_add_device()
2597 			"debugfs is now used for inspecting the device (report descriptor, reports)\n");  in hid_init()