Lines Matching +full:event +full:- +full:touch
1 /* SPDX-License-Identifier: MIT */
3 * kbdif.h -- Xen virtual keyboard/mouse
17 * The two halves of a para-virtual driver utilize nodes within
31 *---------------------------- Features supported ----------------------------
37 * feature-disable-keyboard
43 * feature-disable-pointer
49 * feature-abs-pointer
55 * feature-multi-touch
58 * Backends, which support reporting of multi-touch events
61 * feature-raw-pointer
68 *----------------------- Device Instance Parameters ------------------------
70 * unique-id
77 *------------------------- Pointer Device Parameters ------------------------
91 *----------------------- Multi-touch Device Parameters ----------------------
93 * multi-touch-num-contacts
98 * multi-touch-width
101 * Width of the touch area to be used by the frontend
104 * multi-touch-height
107 * Height of the touch area to be used by the frontend
114 *------------------------------ Feature request -----------------------------
120 * request-abs-pointer
126 * request-multi-touch
129 * Request backend to report multi-touch events.
131 * request-raw-pointer
135 * This option is only valid if request-abs-pointer is also set.
138 *----------------------- Request Transport Parameters -----------------------
140 * event-channel
143 * The identifier of the Xen event channel used to signal activity
146 * page-gref
150 * a sole page in a single page sized event ring buffer.
152 * page-ref
160 * EVENT CODES.
169 /* Multi-touch event sub-codes */
184 #define XENKBD_FIELD_FEAT_DSBL_KEYBRD "feature-disable-keyboard"
185 #define XENKBD_FIELD_FEAT_DSBL_POINTER "feature-disable-pointer"
186 #define XENKBD_FIELD_FEAT_ABS_POINTER "feature-abs-pointer"
187 #define XENKBD_FIELD_FEAT_RAW_POINTER "feature-raw-pointer"
188 #define XENKBD_FIELD_FEAT_MTOUCH "feature-multi-touch"
189 #define XENKBD_FIELD_REQ_ABS_POINTER "request-abs-pointer"
190 #define XENKBD_FIELD_REQ_RAW_POINTER "request-raw-pointer"
191 #define XENKBD_FIELD_REQ_MTOUCH "request-multi-touch"
192 #define XENKBD_FIELD_RING_GREF "page-gref"
193 #define XENKBD_FIELD_EVT_CHANNEL "event-channel"
196 #define XENKBD_FIELD_MT_WIDTH "multi-touch-width"
197 #define XENKBD_FIELD_MT_HEIGHT "multi-touch-height"
198 #define XENKBD_FIELD_MT_NUM_CONTACTS "multi-touch-num-contacts"
199 #define XENKBD_FIELD_UNIQUE_ID "unique-id"
202 #define XENKBD_FIELD_RING_REF "page-ref"
209 * The two halves of a Para-virtual driver communicate with
210 * each other using a shared page and an event channel.
211 * Shared page contains a ring with event structures.
220 * All event packets have the same length (40 octets)
221 * All event packets have common header:
224 * +-----------------+
226 * +-----------------+
227 * type - uint8_t, event code, XENKBD_TYPE_???
230 * Pointer relative movement event
232 * +----------------+----------------+----------------+----------------+
234 * +----------------+----------------+----------------+----------------+
236 * +----------------+----------------+----------------+----------------+
238 * +----------------+----------------+----------------+----------------+
240 * +----------------+----------------+----------------+----------------+
242 * +----------------+----------------+----------------+----------------+
244 * +----------------+----------------+----------------+----------------+
246 * +----------------+----------------+----------------+----------------+
248 * rel_x - int32_t, relative X motion
249 * rel_y - int32_t, relative Y motion
250 * rel_z - int32_t, relative Z motion (wheel)
261 * Key event (includes pointer buttons)
263 * +----------------+----------------+----------------+----------------+
265 * +----------------+----------------+----------------+----------------+
267 * +----------------+----------------+----------------+----------------+
269 * +----------------+----------------+----------------+----------------+
271 * +----------------+----------------+----------------+----------------+
273 * +----------------+----------------+----------------+----------------+
275 * pressed - uint8_t, 1 if pressed; 0 otherwise
276 * keycode - uint32_t, KEY_* from linux/input.h
286 * Pointer absolute position event
288 * +----------------+----------------+----------------+----------------+
290 * +----------------+----------------+----------------+----------------+
292 * +----------------+----------------+----------------+----------------+
294 * +----------------+----------------+----------------+----------------+
296 * +----------------+----------------+----------------+----------------+
298 * +----------------+----------------+----------------+----------------+
300 * +----------------+----------------+----------------+----------------+
302 * +----------------+----------------+----------------+----------------+
304 * abs_x - int32_t, absolute X position (in FB pixels)
305 * abs_y - int32_t, absolute Y position (in FB pixels)
306 * rel_z - int32_t, relative Z motion (wheel)
317 * Multi-touch event and its sub-types
319 * All multi-touch event packets have common header:
322 * +----------------+----------------+----------------+----------------+
324 * +----------------+----------------+----------------+----------------+
326 * +----------------+----------------+----------------+----------------+
328 * event_type - unt8_t, multi-touch event sub-type, XENKBD_MT_EV_???
329 * contact_id - unt8_t, ID of the contact
331 * Touch interactions can consist of one or more contacts.
333 * with a down event, followed by zero or more motion events,
334 * and ending with an up event. Events relating to the same
336 * Contact ID may be reused after XENKBD_MT_EV_UP event and
337 * is in the [0; XENKBD_FIELD_NUM_CONTACTS - 1] range.
340 * Linux [2] and Windows [3] multi-touch support.
343 * [2] https://www.kernel.org/doc/Documentation/input/multi-touch-protocol.rst
344 * [3] https://msdn.microsoft.com/en-us/library/jj151564(v=vs.85).aspx
347 * Multi-touch down event - sent when a new touch is made: touch is assigned
349 * to this touch.
351 * +----------------+----------------+----------------+----------------+
353 * +----------------+----------------+----------------+----------------+
355 * +----------------+----------------+----------------+----------------+
357 * +----------------+----------------+----------------+----------------+
359 * +----------------+----------------+----------------+----------------+
361 * +----------------+----------------+----------------+----------------+
363 * +----------------+----------------+----------------+----------------+
365 * +----------------+----------------+----------------+----------------+
367 * abs_x - int32_t, absolute X position, in pixels
368 * abs_y - int32_t, absolute Y position, in pixels
370 * Multi-touch contact release event
372 * +----------------+----------------+----------------+----------------+
374 * +----------------+----------------+----------------+----------------+
376 * +----------------+----------------+----------------+----------------+
378 * +----------------+----------------+----------------+----------------+
380 * +----------------+----------------+----------------+----------------+
382 * Multi-touch motion event
384 * +----------------+----------------+----------------+----------------+
386 * +----------------+----------------+----------------+----------------+
388 * +----------------+----------------+----------------+----------------+
390 * +----------------+----------------+----------------+----------------+
392 * +----------------+----------------+----------------+----------------+
394 * +----------------+----------------+----------------+----------------+
396 * +----------------+----------------+----------------+----------------+
398 * +----------------+----------------+----------------+----------------+
400 * abs_x - int32_t, absolute X position, in pixels,
401 * abs_y - int32_t, absolute Y position, in pixels,
403 * Multi-touch input synchronization event - shows end of a set of events
406 * +----------------+----------------+----------------+----------------+
408 * +----------------+----------------+----------------+----------------+
410 * +----------------+----------------+----------------+----------------+
412 * +----------------+----------------+----------------+----------------+
414 * +----------------+----------------+----------------+----------------+
416 * Multi-touch shape event - touch point's shape has changed its shape.
422 * +----------------+----------------+----------------+----------------+
424 * +----------------+----------------+----------------+----------------+
426 * +----------------+----------------+----------------+----------------+
428 * +----------------+----------------+----------------+----------------+
430 * +----------------+----------------+----------------+----------------+
432 * +----------------+----------------+----------------+----------------+
434 * +----------------+----------------+----------------+----------------+
436 * +----------------+----------------+----------------+----------------+
438 * major - unt32_t, length of the major axis, pixels
439 * minor - unt32_t, length of the minor axis, pixels
441 * Multi-touch orientation event - touch point's shape has changed
443 * of the ellipse and positive Y axis in degrees, [-180; +180].
445 * +----------------+----------------+----------------+----------------+
447 * +----------------+----------------+----------------+----------------+
449 * +----------------+----------------+----------------+----------------+
451 * +----------------+----------------+----------------+----------------+
453 * +----------------+----------------+----------------+----------------+
455 * +----------------+----------------+----------------+----------------+
457 * +----------------+----------------+----------------+----------------+
459 * orientation - int16_t, clockwise angle of the major axis
497 * of an unknown out event is an error.
500 * All event packets have the same length (40 octets)
501 * All event packets have common header:
503 * +-----------------+
505 * +-----------------+
506 * type - uint8_t, event code