Lines Matching full:-
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
104 * multi-touch-height
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
146 * page-gref
152 * page-ref
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
224 * +-----------------+
226 * +-----------------+
227 * type - uint8_t, event code, XENKBD_TYPE_???
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)
264 * +----------------+----------------+----------------+----------------+
266 * +----------------+----------------+----------------+----------------+
268 * +----------------+----------------+----------------+----------------+
270 * +----------------+----------------+----------------+----------------+
272 * +----------------+----------------+----------------+----------------+
274 * +----------------+----------------+----------------+----------------+
276 * pressed - uint8_t, 1 if pressed; 0 otherwise
277 * keycode - uint32_t, KEY_* from linux/input.h
290 * +----------------+----------------+----------------+----------------+
292 * +----------------+----------------+----------------+----------------+
294 * +----------------+----------------+----------------+----------------+
296 * +----------------+----------------+----------------+----------------+
298 * +----------------+----------------+----------------+----------------+
300 * +----------------+----------------+----------------+----------------+
302 * +----------------+----------------+----------------+----------------+
304 * +----------------+----------------+----------------+----------------+
306 * abs_x - int32_t, absolute X position (in FB pixels)
307 * abs_y - int32_t, absolute Y position (in FB pixels)
308 * rel_z - int32_t, relative Z motion (wheel)
320 * Multi-touch event and its sub-types
322 * All multi-touch event packets have common header:
325 * +----------------+----------------+----------------+----------------+
327 * +----------------+----------------+----------------+----------------+
329 * +----------------+----------------+----------------+----------------+
331 * event_type - unt8_t, multi-touch event sub-type, XENKBD_MT_EV_???
332 * contact_id - unt8_t, ID of the contact
340 * is in the [0; XENKBD_FIELD_NUM_CONTACTS - 1] range.
343 * Linux [2] and Windows [3] multi-touch support.
346 * [2] https://www.kernel.org/doc/Documentation/input/multi-touch-protocol.txt
347 * [3] https://msdn.microsoft.com/en-us/library/jj151564(v=vs.85).aspx
350 * Multi-touch down event - sent when a new touch is made: touch is assigned
354 * +----------------+----------------+----------------+----------------+
356 * +----------------+----------------+----------------+----------------+
358 * +----------------+----------------+----------------+----------------+
360 * +----------------+----------------+----------------+----------------+
362 * +----------------+----------------+----------------+----------------+
364 * +----------------+----------------+----------------+----------------+
366 * +----------------+----------------+----------------+----------------+
368 * +----------------+----------------+----------------+----------------+
370 * abs_x - int32_t, absolute X position, in pixels
371 * abs_y - int32_t, absolute Y position, in pixels
373 * Multi-touch contact release event
375 * +----------------+----------------+----------------+----------------+
377 * +----------------+----------------+----------------+----------------+
379 * +----------------+----------------+----------------+----------------+
381 * +----------------+----------------+----------------+----------------+
383 * +----------------+----------------+----------------+----------------+
385 * Multi-touch motion event
387 * +----------------+----------------+----------------+----------------+
389 * +----------------+----------------+----------------+----------------+
391 * +----------------+----------------+----------------+----------------+
393 * +----------------+----------------+----------------+----------------+
395 * +----------------+----------------+----------------+----------------+
397 * +----------------+----------------+----------------+----------------+
399 * +----------------+----------------+----------------+----------------+
401 * +----------------+----------------+----------------+----------------+
403 * abs_x - int32_t, absolute X position, in pixels,
404 * abs_y - int32_t, absolute Y position, in pixels,
406 * Multi-touch input synchronization event - shows end of a set of events
409 * +----------------+----------------+----------------+----------------+
411 * +----------------+----------------+----------------+----------------+
413 * +----------------+----------------+----------------+----------------+
415 * +----------------+----------------+----------------+----------------+
417 * +----------------+----------------+----------------+----------------+
419 * Multi-touch shape event - touch point's shape has changed its shape.
425 * +----------------+----------------+----------------+----------------+
427 * +----------------+----------------+----------------+----------------+
429 * +----------------+----------------+----------------+----------------+
431 * +----------------+----------------+----------------+----------------+
433 * +----------------+----------------+----------------+----------------+
435 * +----------------+----------------+----------------+----------------+
437 * +----------------+----------------+----------------+----------------+
439 * +----------------+----------------+----------------+----------------+
441 * major - unt32_t, length of the major axis, pixels
442 * minor - unt32_t, length of the minor axis, pixels
444 * Multi-touch orientation event - touch point's shape has changed
446 * of the ellipse and positive Y axis in degrees, [-180; +180].
448 * +----------------+----------------+----------------+----------------+
450 * +----------------+----------------+----------------+----------------+
452 * +----------------+----------------+----------------+----------------+
454 * +----------------+----------------+----------------+----------------+
456 * +----------------+----------------+----------------+----------------+
458 * +----------------+----------------+----------------+----------------+
460 * +----------------+----------------+----------------+----------------+
462 * orientation - int16_t, clockwise angle of the major axis
507 * +-----------------+
509 * +-----------------+
510 * type - uint8_t, event code
554 * c-file-style: "BSD"
555 * c-basic-offset: 4
556 * tab-width: 4
557 * indent-tabs-mode: nil