1 /* SPDX-License-Identifier: GPL-2.0-or-later */
2 #ifndef __USBHID_H
3 #define __USBHID_H
4
5 /*
6 * Copyright (c) 1999 Andreas Gal
7 * Copyright (c) 2000-2001 Vojtech Pavlik
8 * Copyright (c) 2006 Jiri Kosina
9 */
10
11 /*
12 */
13
14 #include <linux/types.h>
15 #include <linux/slab.h>
16 #include <linux/list.h>
17 #include <linux/mutex.h>
18 #include <linux/timer.h>
19 #include <linux/wait.h>
20 #include <linux/workqueue.h>
21 #include <linux/input.h>
22
23 /* API provided by hid-core.c for USB HID drivers */
24 void usbhid_init_reports(struct hid_device *hid);
25 struct usb_interface *usbhid_find_interface(int minor);
26
27 /* iofl flags */
28 #define HID_CTRL_RUNNING 1
29 #define HID_OUT_RUNNING 2
30 #define HID_IN_RUNNING 3
31 #define HID_RESET_PENDING 4
32 #define HID_SUSPENDED 5
33 #define HID_CLEAR_HALT 6
34 #define HID_DISCONNECTED 7
35 #define HID_STARTED 8
36 #define HID_KEYS_PRESSED 10
37 #define HID_NO_BANDWIDTH 11
38 #define HID_RESUME_RUNNING 12
39 /*
40 * The device is opened, meaning there is a client that is interested
41 * in data coming from the device.
42 */
43 #define HID_OPENED 13
44 /*
45 * We are polling input endpoint by [re]submitting IN URB, because
46 * either HID device is opened or ALWAYS POLL quirk is set for the
47 * device.
48 */
49 #define HID_IN_POLLING 14
50
51 /*
52 * USB-specific HID struct, to be pointed to
53 * from struct hid_device->driver_data
54 */
55
56 struct usbhid_device {
57 struct hid_device *hid; /* pointer to corresponding HID dev */
58
59 struct usb_interface *intf; /* USB interface */
60 int ifnum; /* USB interface number */
61
62 unsigned int bufsize; /* URB buffer size */
63
64 struct urb *urbin; /* Input URB */
65 char *inbuf; /* Input buffer */
66 dma_addr_t inbuf_dma; /* Input buffer dma */
67
68 struct urb *urbctrl; /* Control URB */
69 struct usb_ctrlrequest *cr; /* Control request struct */
70 struct hid_control_fifo ctrl[HID_CONTROL_FIFO_SIZE]; /* Control fifo */
71 unsigned char ctrlhead, ctrltail; /* Control fifo head & tail */
72 char *ctrlbuf; /* Control buffer */
73 dma_addr_t ctrlbuf_dma; /* Control buffer dma */
74 unsigned long last_ctrl; /* record of last output for timeouts */
75
76 struct urb *urbout; /* Output URB */
77 struct hid_output_fifo out[HID_CONTROL_FIFO_SIZE]; /* Output pipe fifo */
78 unsigned char outhead, outtail; /* Output pipe fifo head & tail */
79 char *outbuf; /* Output buffer */
80 dma_addr_t outbuf_dma; /* Output buffer dma */
81 unsigned long last_out; /* record of last output for timeouts */
82
83 struct mutex mutex; /* start/stop/open/close */
84 spinlock_t lock; /* fifo spinlock */
85 unsigned long iofl; /* I/O flags (CTRL_RUNNING, OUT_RUNNING) */
86 struct timer_list io_retry; /* Retry timer */
87 unsigned long stop_retry; /* Time to give up, in jiffies */
88 unsigned int retry_delay; /* Delay length in ms */
89 struct work_struct reset_work; /* Task context for resets */
90 wait_queue_head_t wait; /* For sleeping */
91 };
92
93 #define hid_to_usb_dev(hid_dev) \
94 to_usb_device(hid_dev->dev.parent->parent)
95
96 #endif
97