summaryrefslogtreecommitdiff
path: root/sys/dev/evdev/evdev.h
blob: d5aa58f0ccc43f30be400a4ebf4bee491589e553 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
/*-
 * Copyright (c) 2014 Jakub Wojciech Klama <jceel@FreeBSD.org>
 * All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions
 * are met:
 * 1. Redistributions of source code must retain the above copyright
 *    notice, this list of conditions and the following disclaimer.
 * 2. Redistributions in binary form must reproduce the above copyright
 *    notice, this list of conditions and the following disclaimer in the
 *    documentation and/or other materials provided with the distribution.
 *
 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
 * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 * SUCH DAMAGE.
 */

#ifndef	_DEV_EVDEV_EVDEV_H
#define	_DEV_EVDEV_EVDEV_H

#include <sys/types.h>
#include <sys/epoch.h>
#include <sys/kbio.h>
#include <dev/evdev/input.h>
#include <dev/kbd/kbdreg.h>

#define	NAMELEN		80

struct evdev_dev;

typedef int (evdev_open_t)(struct evdev_dev *);
typedef int (evdev_close_t)(struct evdev_dev *);
typedef void (evdev_event_t)(struct evdev_dev *, uint16_t, uint16_t, int32_t);
typedef void (evdev_keycode_t)(struct evdev_dev *,
    struct input_keymap_entry *);

/*
 * Keyboard and mouse events recipient mask.
 * evdev_rcpt_mask variable should be respected by keyboard and mouse drivers
 * that are able to send events through both evdev and sysmouse/kbdmux
 * interfaces so user can choose preferred one to not receive one event twice.
 */
#define	EVDEV_RCPT_SYSMOUSE	(1<<0)
#define	EVDEV_RCPT_KBDMUX	(1<<1)
#define	EVDEV_RCPT_HW_MOUSE	(1<<2)
#define	EVDEV_RCPT_HW_KBD	(1<<3)
extern int evdev_rcpt_mask;
/*
 * Sysmouse protocol does not support horizontal wheel movement reporting.
 * To overcome this limitation different drivers use different sysmouse proto
 * extensions. Set kern.evdev.sysmouse_t_axis to tell sysmouse evdev driver
 * which protocol extension is used.
 * 0 - do not extract horizontal wheel movement (default).
 * 1 - ums(4) horizontal wheel encoding. T-axis is mapped to buttons 6 and 7
 * 2 - psm(4) wheels encoding: z = 1,-1 - vert. wheel, z = 2,-2 - horiz. wheel
 * 3 - wsp(4) horizontal and vertical encoding. T-axis is mapped to button 5.
 */
enum
{
	EVDEV_SYSMOUSE_T_AXIS_NONE = 0,
	EVDEV_SYSMOUSE_T_AXIS_UMS = 1,
	EVDEV_SYSMOUSE_T_AXIS_PSM = 2,
	EVDEV_SYSMOUSE_T_AXIS_WSP = 3,
};
extern int evdev_sysmouse_t_axis;

#define	ABS_MT_FIRST	ABS_MT_TOUCH_MAJOR
#define	ABS_MT_LAST	ABS_MT_TOOL_Y
#define	ABS_IS_MT(x)	((x) >= ABS_MT_FIRST && (x) <= ABS_MT_LAST)
#define	ABS_MT_INDEX(x)	((x) - ABS_MT_FIRST)
#define	MT_CNT		(ABS_MT_INDEX(ABS_MT_LAST) + 1)
/* Multitouch protocol type A */
#define	MAX_MT_REPORTS	5
/* Multitouch protocol type B interface */
#define	MAX_MT_SLOTS	16

#define	EVDEV_FLAG_SOFTREPEAT	0x00	/* use evdev to repeat keys */
#define	EVDEV_FLAG_MT_STCOMPAT	0x01	/* autogenerate ST-compatible events
					 * for MT protocol type B reports */
#define	EVDEV_FLAG_MT_AUTOREL	0x02	/* Autorelease MT-slots not listed in
					 * current MT protocol type B report */
#define	EVDEV_FLAG_EXT_EPOCH	0x03	/* evdev_push_* is allways called with
					 * input (global) epoch entered */
#define	EVDEV_FLAG_MT_KEEPID	0x04	/* Do not reassign tracking ID */
#define	EVDEV_FLAG_MT_TRACK	0x05	/* Assign touch to slot by evdev */
#define	EVDEV_FLAG_MAX		0x1F
#define	EVDEV_FLAG_CNT		(EVDEV_FLAG_MAX + 1)

struct evdev_methods
{
	evdev_open_t		*ev_open;
	evdev_close_t		*ev_close;
	evdev_event_t		*ev_event;
	evdev_keycode_t		*ev_get_keycode;
	evdev_keycode_t		*ev_set_keycode;
};

union evdev_mt_slot {
	int32_t         val[MT_CNT];
	struct {
		int32_t maj;		/* ABS_MT_TOUCH_MAJOR */
		int32_t min;		/* ABS_MT_TOUCH_MINOR */
		int32_t w_maj;		/* ABS_MT_WIDTH_MAJOR */
		int32_t w_min;		/* ABS_MT_WIDTH_MINOR */
		int32_t ori;		/* ABS_MT_ORIENTATION */
		int32_t x;		/* ABS_MT_POSITION_X */
		int32_t y;		/* ABS_MT_POSITION_Y */
		int32_t type;		/* ABS_MT_TOOL_TYPE */
		int32_t blob_id;	/* ABS_MT_BLOB_ID */
		int32_t id;		/* ABS_MT_TRACKING_ID */
		int32_t p;		/* ABS_MT_PRESSURE */
		int32_t dist;		/* ABS_MT_DISTANCE */
		int32_t tool_x;		/* ABS_MT_TOOL_X */
		int32_t tool_y;		/* ABS_MT_TOOL_Y */
	};
};
_Static_assert(offsetof(union evdev_mt_slot, tool_y) ==
    offsetof(union evdev_mt_slot, val[ABS_MT_INDEX(ABS_MT_TOOL_Y)]),
    "evdev_mt_slot array members does not match their structure aliases");

/* Input device interface: */
struct evdev_dev *evdev_alloc(void);
void evdev_free(struct evdev_dev *);
void evdev_set_name(struct evdev_dev *, const char *);
void evdev_set_id(struct evdev_dev *, uint16_t, uint16_t, uint16_t, uint16_t);
void evdev_set_phys(struct evdev_dev *, const char *);
void evdev_set_serial(struct evdev_dev *, const char *);
void evdev_set_methods(struct evdev_dev *, void *,
    const struct evdev_methods *);
int evdev_register(struct evdev_dev *);
int evdev_register_mtx(struct evdev_dev *, struct mtx *);
int evdev_unregister(struct evdev_dev *);
int evdev_push_event(struct evdev_dev *, uint16_t, uint16_t, int32_t);
void evdev_support_prop(struct evdev_dev *, uint16_t);
void evdev_support_event(struct evdev_dev *, uint16_t);
void evdev_support_key(struct evdev_dev *, uint16_t);
void evdev_support_rel(struct evdev_dev *, uint16_t);
void evdev_support_abs(struct evdev_dev *, uint16_t, int32_t, int32_t, int32_t,
   int32_t, int32_t);
void evdev_support_msc(struct evdev_dev *, uint16_t);
void evdev_support_led(struct evdev_dev *, uint16_t);
void evdev_support_snd(struct evdev_dev *, uint16_t);
void evdev_support_sw(struct evdev_dev *, uint16_t);
void evdev_set_repeat_params(struct evdev_dev *, uint16_t, int);
int evdev_set_report_size(struct evdev_dev *, size_t);
void evdev_set_flag(struct evdev_dev *, uint16_t);
void evdev_set_cdev_mode(struct evdev_dev *, uid_t, gid_t, int);
void *evdev_get_softc(struct evdev_dev *);
bool evdev_is_grabbed(struct evdev_dev *);

/* Multitouch related functions: */
int evdev_mt_id_to_slot(struct evdev_dev *, int32_t);
int evdev_mt_push_slot(struct evdev_dev *, int, union evdev_mt_slot *);
int evdev_mt_push_frame(struct evdev_dev *, union evdev_mt_slot *, int);
void evdev_mt_match_frame(struct evdev_dev *, union evdev_mt_slot *, int);
union evdev_mt_slot *evdev_mt_get_match_slots(struct evdev_dev *);
void evdev_mt_push_autorel(struct evdev_dev *);

/* Utility functions: */
uint16_t evdev_hid2key(int);
void evdev_support_all_known_keys(struct evdev_dev *);
uint16_t evdev_scancode2key(int *, int);
void evdev_push_mouse_btn(struct evdev_dev *, int);
void evdev_push_leds(struct evdev_dev *, int);
void evdev_push_repeats(struct evdev_dev *, keyboard_t *);
void evdev_support_nfingers(struct evdev_dev *, int);
void evdev_push_nfingers(struct evdev_dev *, int);

/* Event reporting shortcuts: */
static __inline int
evdev_sync(struct evdev_dev *evdev)
{

	return (evdev_push_event(evdev, EV_SYN, SYN_REPORT, 1));
}

static __inline int
evdev_mt_sync(struct evdev_dev *evdev)
{

	return (evdev_push_event(evdev, EV_SYN, SYN_MT_REPORT, 1));
}

static __inline int
evdev_push_key(struct evdev_dev *evdev, uint16_t code, int32_t value)
{

	return (evdev_push_event(evdev, EV_KEY, code, value != 0));
}

static __inline int
evdev_push_rel(struct evdev_dev *evdev, uint16_t code, int32_t value)
{

	return (evdev_push_event(evdev, EV_REL, code, value));
}

static __inline int
evdev_push_abs(struct evdev_dev *evdev, uint16_t code, int32_t value)
{

	return (evdev_push_event(evdev, EV_ABS, code, value));
}

static __inline int
evdev_push_msc(struct evdev_dev *evdev, uint16_t code, int32_t value)
{

	return (evdev_push_event(evdev, EV_MSC, code, value));
}

static __inline int
evdev_push_led(struct evdev_dev *evdev, uint16_t code, int32_t value)
{

	return (evdev_push_event(evdev, EV_LED, code, value != 0));
}

static __inline int
evdev_push_snd(struct evdev_dev *evdev, uint16_t code, int32_t value)
{

	return (evdev_push_event(evdev, EV_SND, code, value));
}

static __inline int
evdev_push_sw(struct evdev_dev *evdev, uint16_t code, int32_t value)
{

	return (evdev_push_event(evdev, EV_SW, code, value != 0));
}

#endif	/* _DEV_EVDEV_EVDEV_H */