[Qemu-devel] paravirtual tablet v3

[Gerd Hoffmann <kraxel@redhat.com>]

[-- Attachment #1: Type: text/plain, Size: 56 bytes --]

   Hi,

Now v3 featuring multitouch ;)

cheers,
   Gerd

[-- Attachment #2: pvtablet.h --]
[-- Type: text/x-chdr, Size: 3820 bytes --]

#ifndef __QEMU_PVTABLET__
#define __QEMU_PVTABLET__ 1

/*
 * qemu patavirtual tablet interface
 */

#include <inttypes.h>

/*
 * our virtio-serial channel name(s)
 */
#define QEMU_PVTABLET_FORMAT "org.qemu.pvtablet.%d"

enum qemu_pvtablet_type {
    QEMU_PVTABLET_MSG_INIT,
    QEMU_PVTABLET_MSG_ACK,
    QEMU_PVTABLET_MSG_POSITION,
    QEMU_PVTABLET_MSG_BTN_DOWN,
    QEMU_PVTABLET_MSG_BTN_UP,
    QEMU_PVTABLET_MSG_SYNC,
};

typedef enum qemu_pvtablet_features {
    /* none yet */
};

typedef enum qemu_pvtablet_buttons {
    QEMU_PVTABLET_BTN_LEFT,
    QEMU_PVTABLET_BTN_RIGHT,
    QEMU_PVTABLET_BTN_MIDDLE,
    QEMU_PVTABLET_BTN_SCROLL_UP,
    QEMU_PVTABLET_BTN_SCROLL_DOWN,
    /*
     * we can handle up to 32 buttons although
     * not every has a individual name ;)
     */
};

#define  QEMU_PVTABLET_BTN_MASK_LEFT        (1<<QEMU_PVTABLET_BTN_LEFT)
#define  QEMU_PVTABLET_BTN_MASK_RIGHT       (1<<QEMU_PVTABLET_BTN_RIGHT)
#define  QEMU_PVTABLET_BTN_MASK_MIDDLE      (1<<QEMU_PVTABLET_BTN_MIDDLE)
#define  QEMU_PVTABLET_BTN_MASK_SCROLL_UP   (1<<QEMU_PVTABLET_BTN_SCROLL_UP)
#define  QEMU_PVTABLET_BTN_MASK_SCROLL_DOWN (1<<QEMU_PVTABLET_BTN_SCROLL_DOWN)

/*
 * QEMU_PVTABLET_MSG_INIT, host -> guest
 * First message.  Sent before any other event.
 */
typedef struct qemu_pvtablet_init {
    uint32_t features;        /* qemu_pvtablet_features */
    uint32_t res_x;           /* x axis resolution */
    uint32_t res_y;           /* y axis resolution */
    uint32_t buttons_mask;    /* mouse buttons available */
    uint32_t max_pressure;    /* 0 == no pressure supported */
    uint32_t max_points;      /* 1 == no multitouch */
    uint8_t  have_point_ids;
} qemu_pvtablet_init;

/*
 * QEMU_PVTABLET_MSG_ACK, guest -> host
 * Sent after pvtablet_init.  Host will not send
 * additional messages until this is received.
 */
typedef struct qemu_pvtablet_ack {
    uint32_t features; /* qemu_pvtable_features */
};

/*
 * QEMU_PVTABLET_MSG_BTN_{DOWN,UP}, host -> guest
 * Send button press+release events.
 */
typedef struct qemu_pvtablet_button {
    uint32_t button;    /* which button was pressed/released */
    uint32_t mask;      /* which buttons are currently pressed */
} qemu_pvtablet_button;

/*
 * QEMU_PVTABLET_MSG_POSITION, host -> guest
 * Send pointer/finger move events.
 *
 * Multitouch devices without point id support send one message per
 * touch point in each message group in unspecified order.
 *
 * Multitouch devices with point id support send messages only for
 * touch points which did change.  IDs are added by just using them
 * for the first time.  IDs are invalidated by using them in a "lift"
 * message (aka pressure == 0).
 */
typedef struct qemu_pvtablet_position {
    uint32_t pos_x;
    uint32_t pos_y;
    uint32_t pressure;
    uint32_t point_id;
} qemu_pvtablet_position;

/*
 * QEMU_PVTABLET_MSG_SYNC, host -> guest
 * Marks the end of a message group which belongs together
 * and carries the time stamp for all those events.
 *
 * The timestamp is specified in nanoseconds.  Timebase is undefined.
 * This is supposed to be used to figure how much time passed between
 * two events, to decide whenever two mouse clicks should be
 * interpreted as double click or not and simliar stuff.
 */
typedef struct qemu_pvtablet_sync {
    uint64_t timestamp;
};


typedef struct qemu_pvtablet_header {
    uint32_t size;            /* whole message size */
    uint32_t type;            /* qemu_pvtablet_type */
} qemu_pvtablet_header;

typedef union qemu_pvtablet_payload {
    qemu_pvtablet_init     init;
    qemu_pvtablet_ack      ack;
    qemu_pvtablet_position position;
    qemu_pvtablet_button   button;
};

typedef struct qemu_pvtablet_message {
    qemu_pvtablet_header  hdr;
    qemu_pvtablet_payload data;
} qemu_pvtablet_message;

#endif /* __QEMU_PVTABLET__ */