4
* User level driver support for input subsystem
6
* Heavily based on evdev.c by Vojtech Pavlik
8
* This program is free software; you can redistribute it and/or modify
9
* it under the terms of the GNU General Public License as published by
10
* the Free Software Foundation; either version 2 of the License, or
11
* (at your option) any later version.
13
* This program is distributed in the hope that it will be useful,
14
* but WITHOUT ANY WARRANTY; without even the implied warranty of
15
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16
* GNU General Public License for more details.
18
* You should have received a copy of the GNU General Public License
19
* along with this program; if not, write to the Free Software
20
* Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
22
* Author: Aristeu Sergio Rozanski Filho <aris@cathedrallabs.org>
25
* 0.3 24/05/2006 (Anssi Hannula <anssi.hannulagmail.com>)
26
* - update ff support for the changes in kernel interface
27
* - add UINPUT_VERSION
28
* 0.2 16/10/2004 (Micah Dowty <micah@navi.cx>)
29
* - added force feedback support
32
* - first public version
35
#include <linux/input.h>
37
#define UINPUT_VERSION 3
40
#define UINPUT_NAME "uinput"
41
#define UINPUT_BUFFER_SIZE 16
42
#define UINPUT_NUM_REQUESTS 16
44
enum uinput_state { UIST_NEW_DEVICE, UIST_SETUP_COMPLETE, UIST_CREATED };
46
struct uinput_request {
48
int code; /* UI_FF_UPLOAD, UI_FF_ERASE */
51
struct completion done;
56
struct ff_effect *effect;
57
struct ff_effect *old;
62
struct uinput_device {
63
struct input_dev *dev;
65
enum uinput_state state;
66
wait_queue_head_t waitq;
70
struct input_event buff[UINPUT_BUFFER_SIZE];
71
unsigned int ff_effects_max;
73
struct uinput_request *requests[UINPUT_NUM_REQUESTS];
74
wait_queue_head_t requests_waitq;
75
spinlock_t requests_lock;
77
#endif /* __KERNEL__ */
79
struct uinput_ff_upload {
82
struct ff_effect effect;
86
struct uinput_ff_erase {
93
#define UINPUT_IOCTL_BASE 'U'
94
#define UI_DEV_CREATE _IO(UINPUT_IOCTL_BASE, 1)
95
#define UI_DEV_DESTROY _IO(UINPUT_IOCTL_BASE, 2)
97
#define UI_SET_EVBIT _IOW(UINPUT_IOCTL_BASE, 100, int)
98
#define UI_SET_KEYBIT _IOW(UINPUT_IOCTL_BASE, 101, int)
99
#define UI_SET_RELBIT _IOW(UINPUT_IOCTL_BASE, 102, int)
100
#define UI_SET_ABSBIT _IOW(UINPUT_IOCTL_BASE, 103, int)
101
#define UI_SET_MSCBIT _IOW(UINPUT_IOCTL_BASE, 104, int)
102
#define UI_SET_LEDBIT _IOW(UINPUT_IOCTL_BASE, 105, int)
103
#define UI_SET_SNDBIT _IOW(UINPUT_IOCTL_BASE, 106, int)
104
#define UI_SET_FFBIT _IOW(UINPUT_IOCTL_BASE, 107, int)
105
#define UI_SET_PHYS _IOW(UINPUT_IOCTL_BASE, 108, char*)
106
#define UI_SET_SWBIT _IOW(UINPUT_IOCTL_BASE, 109, int)
107
#define UI_SET_PROPBIT _IOW(UINPUT_IOCTL_BASE, 110, int)
109
#define UI_BEGIN_FF_UPLOAD _IOWR(UINPUT_IOCTL_BASE, 200, struct uinput_ff_upload)
110
#define UI_END_FF_UPLOAD _IOW(UINPUT_IOCTL_BASE, 201, struct uinput_ff_upload)
111
#define UI_BEGIN_FF_ERASE _IOWR(UINPUT_IOCTL_BASE, 202, struct uinput_ff_erase)
112
#define UI_END_FF_ERASE _IOW(UINPUT_IOCTL_BASE, 203, struct uinput_ff_erase)
115
* To write a force-feedback-capable driver, the upload_effect
116
* and erase_effect callbacks in input_dev must be implemented.
117
* The uinput driver will generate a fake input event when one of
118
* these callbacks are invoked. The userspace code then uses
119
* ioctls to retrieve additional parameters and send the return code.
120
* The callback blocks until this return code is sent.
122
* The described callback mechanism is only used if ff_effects_max
125
* To implement upload_effect():
126
* 1. Wait for an event with type == EV_UINPUT and code == UI_FF_UPLOAD.
127
* A request ID will be given in 'value'.
128
* 2. Allocate a uinput_ff_upload struct, fill in request_id with
129
* the 'value' from the EV_UINPUT event.
130
* 3. Issue a UI_BEGIN_FF_UPLOAD ioctl, giving it the
131
* uinput_ff_upload struct. It will be filled in with the
132
* ff_effects passed to upload_effect().
133
* 4. Perform the effect upload, and place a return code back into
134
the uinput_ff_upload struct.
135
* 5. Issue a UI_END_FF_UPLOAD ioctl, also giving it the
136
* uinput_ff_upload_effect struct. This will complete execution
137
* of our upload_effect() handler.
139
* To implement erase_effect():
140
* 1. Wait for an event with type == EV_UINPUT and code == UI_FF_ERASE.
141
* A request ID will be given in 'value'.
142
* 2. Allocate a uinput_ff_erase struct, fill in request_id with
143
* the 'value' from the EV_UINPUT event.
144
* 3. Issue a UI_BEGIN_FF_ERASE ioctl, giving it the
145
* uinput_ff_erase struct. It will be filled in with the
146
* effect ID passed to erase_effect().
147
* 4. Perform the effect erasure, and place a return code back
148
* into the uinput_ff_erase struct.
149
* 5. Issue a UI_END_FF_ERASE ioctl, also giving it the
150
* uinput_ff_erase_effect struct. This will complete execution
151
* of our erase_effect() handler.
155
* This is the new event type, used only by uinput.
156
* 'code' is UI_FF_UPLOAD or UI_FF_ERASE, and 'value'
157
* is the unique request ID. This number was picked
158
* arbitrarily, above EV_MAX (since the input system
159
* never sees it) but in the range of a 16-bit int.
161
#define EV_UINPUT 0x0101
162
#define UI_FF_UPLOAD 1
163
#define UI_FF_ERASE 2
165
#define UINPUT_MAX_NAME_SIZE 80
166
struct uinput_user_dev {
167
char name[UINPUT_MAX_NAME_SIZE];
172
int absfuzz[ABS_CNT];
173
int absflat[ABS_CNT];
175
#endif /* __UINPUT_H_ */