blob: 807922b49aa494afd09363d941e85dac2f7d6fe0 [file] [log] [blame]
Jiri Kosina4916b3a2006-12-08 18:41:03 +01001#ifndef __USBHID_H
2#define __USBHID_H
3
4/*
5 * Copyright (c) 1999 Andreas Gal
6 * Copyright (c) 2000-2001 Vojtech Pavlik
7 * Copyright (c) 2006 Jiri Kosina
8 */
9
10/*
11 * This program is free software; you can redistribute it and/or modify
12 * it under the terms of the GNU General Public License as published by
13 * the Free Software Foundation; either version 2 of the License, or
14 * (at your option) any later version.
15 *
16 * This program is distributed in the hope that it will be useful,
17 * but WITHOUT ANY WARRANTY; without even the implied warranty of
18 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
19 * GNU General Public License for more details.
20 *
21 * You should have received a copy of the GNU General Public License
22 * along with this program; if not, write to the Free Software
23 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
24 *
25 */
26
27#include <linux/types.h>
28#include <linux/slab.h>
29#include <linux/list.h>
Jiri Slaby3d5afd32008-10-27 12:16:15 +010030#include <linux/mutex.h>
Jiri Kosina4916b3a2006-12-08 18:41:03 +010031#include <linux/timer.h>
Jiri Slaby1d1bdd22008-03-19 21:55:04 +010032#include <linux/wait.h>
Jiri Kosina4916b3a2006-12-08 18:41:03 +010033#include <linux/workqueue.h>
34#include <linux/input.h>
35
36/* API provided by hid-core.c for USB HID drivers */
Jiri Kosina4916b3a2006-12-08 18:41:03 +010037void usbhid_close(struct hid_device *hid);
38int usbhid_open(struct hid_device *hid);
39void usbhid_init_reports(struct hid_device *hid);
Oliver Neukum0361a282008-12-17 15:38:03 +010040int usbhid_get_power(struct hid_device *hid);
41void usbhid_put_power(struct hid_device *hid);
Guillaume Chazarain8fe294c2010-09-12 21:32:35 +020042struct usb_interface *usbhid_find_interface(int minor);
Jiri Kosina4916b3a2006-12-08 18:41:03 +010043
Jiri Slaby0ed94b32008-11-24 16:20:07 +010044/* iofl flags */
45#define HID_CTRL_RUNNING 1
46#define HID_OUT_RUNNING 2
47#define HID_IN_RUNNING 3
48#define HID_RESET_PENDING 4
49#define HID_SUSPENDED 5
50#define HID_CLEAR_HALT 6
51#define HID_DISCONNECTED 7
52#define HID_STARTED 8
Oliver Neukum0361a282008-12-17 15:38:03 +010053#define HID_KEYS_PRESSED 10
Oliver Neukuma8c52b62012-03-28 13:16:19 +020054#define HID_NO_BANDWIDTH 11
Benjamin Tissoiresb9058112014-09-30 14:28:22 -040055#define HID_RESUME_RUNNING 12
Jiri Slaby0ed94b32008-11-24 16:20:07 +010056
Jiri Kosina4916b3a2006-12-08 18:41:03 +010057/*
58 * USB-specific HID struct, to be pointed to
59 * from struct hid_device->driver_data
60 */
61
62struct usbhid_device {
63 struct hid_device *hid; /* pointer to corresponding HID dev */
64
65 struct usb_interface *intf; /* USB interface */
66 int ifnum; /* USB interface number */
67
68 unsigned int bufsize; /* URB buffer size */
69
70 struct urb *urbin; /* Input URB */
71 char *inbuf; /* Input buffer */
72 dma_addr_t inbuf_dma; /* Input buffer dma */
Jiri Kosina4916b3a2006-12-08 18:41:03 +010073
74 struct urb *urbctrl; /* Control URB */
75 struct usb_ctrlrequest *cr; /* Control request struct */
Jiri Kosina4916b3a2006-12-08 18:41:03 +010076 struct hid_control_fifo ctrl[HID_CONTROL_FIFO_SIZE]; /* Control fifo */
77 unsigned char ctrlhead, ctrltail; /* Control fifo head & tail */
78 char *ctrlbuf; /* Control buffer */
79 dma_addr_t ctrlbuf_dma; /* Control buffer dma */
Oliver Neukum858155f2010-02-12 13:02:28 +010080 unsigned long last_ctrl; /* record of last output for timeouts */
Jiri Kosina4916b3a2006-12-08 18:41:03 +010081
82 struct urb *urbout; /* Output URB */
Anssi Hannulaf129ea62008-10-04 14:44:06 +020083 struct hid_output_fifo out[HID_CONTROL_FIFO_SIZE]; /* Output pipe fifo */
Jiri Kosina4916b3a2006-12-08 18:41:03 +010084 unsigned char outhead, outtail; /* Output pipe fifo head & tail */
85 char *outbuf; /* Output buffer */
86 dma_addr_t outbuf_dma; /* Output buffer dma */
Oliver Neukum858155f2010-02-12 13:02:28 +010087 unsigned long last_out; /* record of last output for timeouts */
Jiri Kosina4916b3a2006-12-08 18:41:03 +010088
Oliver Neukum0361a282008-12-17 15:38:03 +010089 spinlock_t lock; /* fifo spinlock */
Jiri Kosina4916b3a2006-12-08 18:41:03 +010090 unsigned long iofl; /* I/O flags (CTRL_RUNNING, OUT_RUNNING) */
91 struct timer_list io_retry; /* Retry timer */
92 unsigned long stop_retry; /* Time to give up, in jiffies */
93 unsigned int retry_delay; /* Delay length in ms */
94 struct work_struct reset_work; /* Task context for resets */
Jiri Slaby1d1bdd22008-03-19 21:55:04 +010095 wait_queue_head_t wait; /* For sleeping */
Jiri Kosina4916b3a2006-12-08 18:41:03 +010096};
97
Anssi Hannulabe820972007-01-19 19:28:17 +020098#define hid_to_usb_dev(hid_dev) \
Jiri Slaby85cdaf52008-05-16 11:49:15 +020099 container_of(hid_dev->dev.parent->parent, struct usb_device, dev)
Anssi Hannulabe820972007-01-19 19:28:17 +0200100
Jiri Kosina4916b3a2006-12-08 18:41:03 +0100101#endif
102