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 <vojtech@ucw.cz>, 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…
421  * persistent for main-items. The global environment can be saved and
439  * This is the local environment. It is persistent up the next main-item.
461 	int parent_idx; /* device->collection */
480 	__s16	  wheel_accumulated;	/* hi-res wheel */
491 	unsigned  flags;		/* main-item flags (i.e. volatile,array,constant) */
499 					 * bits 8-16 are reserved for hid-input usage
509 	unsigned index;			/* index into report->field[] */
634 	 * battery is non-NULL.
687 	struct hid_bpf bpf;						/* hid-bpf data */
698 	return dev_get_drvdata(&hdev->dev);  in hid_get_drvdata()
703 	dev_set_drvdata(&hdev->dev, data);  in hid_set_drvdata()
754 #define HID_TERMINATOR		(HID_ANY_ID - 1)
767  * @name: driver name (e.g. "Footech_bar-wheel")
768  * @id_table: which devices is this driver for (must be non-NULL for probe
774  * @remove: device removed (NULL if not a hot-plug capable driver)
789  * probe should return -errno on error, or 0 on success. During probe,
798  * usage by generic code (no special handling needed) or positive to skip
852  * struct hid_ll_driver - low level driver callbacks
861  * @wait: wait for buffered io to complete (send/recv reports)
865  * @may_wakeup: return if device may act as a wakeup source during system-suspend
866  * @max_buffer_size: over-ride maximum data buffer size (default: HID_MAX_BUFFER_SIZE)
927  * module_hid_driver() - Helper macro for registering a HID driver
992  * hid_device_io_start - enable HID input during probe, remove
1001 	if (hid->io_started) {  in hid_device_io_start()
1002 		dev_warn(&hid->dev, "io already started\n");  in hid_device_io_start()
1005 	hid->io_started = true;  in hid_device_io_start()
1006 	up(&hid->driver_input_lock);  in hid_device_io_start()
1010  * hid_device_io_stop - disable HID input during probe, remove
1021 	if (!hid->io_started) {  in hid_device_io_stop()
1022 		dev_warn(&hid->dev, "io already stopped\n");  in hid_device_io_stop()
1025 	hid->io_started = false;  in hid_device_io_stop()
1026 	down(&hid->driver_input_lock);  in hid_device_io_stop()
1030  * hid_map_usage - map usage input bits
1034  * @bit: pointer to input->{}bit (out parameter)
1035  * @max: maximal valid usage->code to consider later (out parameter)
1047 	struct input_dev *input = hidinput->input;  in hid_map_usage()
1053 		bmap = input->absbit;  in hid_map_usage()
1057 		bmap = input->relbit;  in hid_map_usage()
1061 		bmap = input->keybit;  in hid_map_usage()
1065 		bmap = input->ledbit;  in hid_map_usage()
1069 		bmap = input->mscbit;  in hid_map_usage()
1076 				    input->name, c, type);  in hid_map_usage()
1081 	usage->type = type;  in hid_map_usage()
1082 	usage->code = c;  in hid_map_usage()
1088  * hid_map_usage_clear - map usage input bits and clear the input bit
1092  * @bit: pointer to input->{}bit (out parameter)
1093  * @max: maximal valid usage->code to consider later (out parameter)
1106 		clear_bit(usage->code, *bit);  in hid_map_usage_clear()
1110  * hid_parse - parse HW reports
1115  * report_fixup will be called (if non-NULL) after reading raw report from
1144  * hid_hw_power - requests underlying HW to go into given power mode
1155 	return hdev->ll_driver->power ? hdev->ll_driver->power(hdev, level) : 0;  in hid_hw_power()
1160  * hid_hw_idle - send idle request to device
1170 	if (hdev->ll_driver->idle)  in hid_hw_idle()
1171 		return hdev->ll_driver->idle(hdev, report, idle, reqtype);  in hid_hw_idle()
1177  * hid_hw_may_wakeup - return if the hid device may act as a wakeup source during system-suspend
1183 	if (hdev->ll_driver->may_wakeup)  in hid_hw_may_wakeup()
1184 		return hdev->ll_driver->may_wakeup(hdev);  in hid_hw_may_wakeup()
1186 	if (hdev->dev.parent)  in hid_hw_may_wakeup()
1187 		return device_may_wakeup(hdev->dev.parent);  in hid_hw_may_wakeup()
1193  * hid_hw_wait - wait for buffered io to complete
1199 	if (hdev->ll_driver->wait)  in hid_hw_wait()
1200 		hdev->ll_driver->wait(hdev);  in hid_hw_wait()
1204  * hid_report_len - calculate the report length
1210 	return DIV_ROUND_UP(report->size, 8) + (report->id > 0);  in hid_report_len()
1230 	dev_err(&(hid)->dev, fmt, ##__VA_ARGS__)
1232 	dev_notice(&(hid)->dev, fmt, ##__VA_ARGS__)
1234 	dev_warn(&(hid)->dev, fmt, ##__VA_ARGS__)
1236 	dev_info(&(hid)->dev, fmt, ##__VA_ARGS__)
1238 	dev_dbg(&(hid)->dev, fmt, ##__VA_ARGS__)
1241 	dev_err_once(&(hid)->dev, fmt, ##__VA_ARGS__)
1243 	dev_notice_once(&(hid)->dev, fmt, ##__VA_ARGS__)
1245 	dev_warn_once(&(hid)->dev, fmt, ##__VA_ARGS__)
1247 	dev_info_once(&(hid)->dev, fmt, ##__VA_ARGS__)
1249 	dev_dbg_once(&(hid)->dev, fmt, ##__VA_ARGS__)