1 /* SPDX-License-Identifier: GPL-2.0-or-later */
4  *  Copyright (c) 2000-2001 Vojtech Pavlik
5  *  Copyright (c) 2006-2007 Jiri Kosina
10  * e-mail - mail your message to <[email protected]>, or by paper mail:
33  * values are expanded to 32-bit signed int, long items contain a pointer
187  * System Multi-Axis, see:
188 …* http://www.usb.org/developers/hidpage/HUTRR62_-_Generic_Desktop_CA_for_System_Multi-Axis_Control…
424  * persistent for main-items. The global environment can be saved and
442  * This is the local environment. It is persistent up the next main-item.
464 	int parent_idx; /* device->collection */
483 	__s16	  wheel_accumulated;	/* hi-res wheel */
494 	unsigned  flags;		/* main-item flags (i.e. volatile,array,constant) */
502 					 * bits 8-16 are reserved for hid-input usage
512 	unsigned index;			/* index into report->field[] */
639 	 * battery is non-NULL.
692 	struct hid_bpf bpf;						/* hid-bpf data */
703 	return dev_get_drvdata(&hdev->dev);  in hid_get_drvdata()
708 	dev_set_drvdata(&hdev->dev, data);  in hid_set_drvdata()
759 #define HID_TERMINATOR		(HID_ANY_ID - 1)
772  * @name: driver name (e.g. "Footech_bar-wheel")
773  * @id_table: which devices is this driver for (must be non-NULL for probe
779  * @remove: device removed (NULL if not a hot-plug capable driver)
794  * probe should return -errno on error, or 0 on success. During probe,
803  * usage by generic code (no special handling needed) or positive to skip
857  * struct hid_ll_driver - low level driver callbacks
866  * @wait: wait for buffered io to complete (send/recv reports)
870  * @may_wakeup: return if device may act as a wakeup source during system-suspend
871  * @max_buffer_size: over-ride maximum data buffer size (default: HID_MAX_BUFFER_SIZE)
932  * module_hid_driver() - Helper macro for registering a HID driver
996  * hid_device_io_start - enable HID input during probe, remove
1005 	if (hid->io_started) {  in hid_device_io_start()
1006 		dev_warn(&hid->dev, "io already started\n");  in hid_device_io_start()
1009 	hid->io_started = true;  in hid_device_io_start()
1010 	up(&hid->driver_input_lock);  in hid_device_io_start()
1014  * hid_device_io_stop - disable HID input during probe, remove
1025 	if (!hid->io_started) {  in hid_device_io_stop()
1026 		dev_warn(&hid->dev, "io already stopped\n");  in hid_device_io_stop()
1029 	hid->io_started = false;  in hid_device_io_stop()
1030 	down(&hid->driver_input_lock);  in hid_device_io_stop()
1034  * hid_map_usage - map usage input bits
1038  * @bit: pointer to input->{}bit (out parameter)
1039  * @max: maximal valid usage->code to consider later (out parameter)
1051 	struct input_dev *input = hidinput->input;  in hid_map_usage()
1057 		bmap = input->absbit;  in hid_map_usage()
1061 		bmap = input->relbit;  in hid_map_usage()
1065 		bmap = input->keybit;  in hid_map_usage()
1069 		bmap = input->ledbit;  in hid_map_usage()
1073 		bmap = input->mscbit;  in hid_map_usage()
1080 				    input->name, c, type);  in hid_map_usage()
1085 	usage->type = type;  in hid_map_usage()
1086 	usage->code = c;  in hid_map_usage()
1092  * hid_map_usage_clear - map usage input bits and clear the input bit
1096  * @bit: pointer to input->{}bit (out parameter)
1097  * @max: maximal valid usage->code to consider later (out parameter)
1110 		clear_bit(usage->code, *bit);  in hid_map_usage_clear()
1114  * hid_parse - parse HW reports
1119  * report_fixup will be called (if non-NULL) after reading raw report from
1148  * hid_hw_power - requests underlying HW to go into given power mode
1159 	return hdev->ll_driver->power ? hdev->ll_driver->power(hdev, level) : 0;  in hid_hw_power()
1164  * hid_hw_idle - send idle request to device
1174 	if (hdev->ll_driver->idle)  in hid_hw_idle()
1175 		return hdev->ll_driver->idle(hdev, report, idle, reqtype);  in hid_hw_idle()
1181  * hid_hw_may_wakeup - return if the hid device may act as a wakeup source during system-suspend
1187 	if (hdev->ll_driver->may_wakeup)  in hid_hw_may_wakeup()
1188 		return hdev->ll_driver->may_wakeup(hdev);  in hid_hw_may_wakeup()
1190 	if (hdev->dev.parent)  in hid_hw_may_wakeup()
1191 		return device_may_wakeup(hdev->dev.parent);  in hid_hw_may_wakeup()
1197  * hid_hw_wait - wait for buffered io to complete
1203 	if (hdev->ll_driver->wait)  in hid_hw_wait()
1204 		hdev->ll_driver->wait(hdev);  in hid_hw_wait()
1208  * hid_report_len - calculate the report length
1214 	return DIV_ROUND_UP(report->size, 8) + (report->id > 0);  in hid_report_len()
1228 	dev_err(&(hid)->dev, fmt, ##__VA_ARGS__)
1230 	dev_notice(&(hid)->dev, fmt, ##__VA_ARGS__)
1232 	dev_warn(&(hid)->dev, fmt, ##__VA_ARGS__)
1234 	dev_info(&(hid)->dev, fmt, ##__VA_ARGS__)
1236 	dev_dbg(&(hid)->dev, fmt, ##__VA_ARGS__)
1239 	dev_err_once(&(hid)->dev, fmt, ##__VA_ARGS__)
1241 	dev_notice_once(&(hid)->dev, fmt, ##__VA_ARGS__)
1243 	dev_warn_once(&(hid)->dev, fmt, ##__VA_ARGS__)
1245 	dev_info_once(&(hid)->dev, fmt, ##__VA_ARGS__)
1247 	dev_dbg_once(&(hid)->dev, fmt, ##__VA_ARGS__)