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 98