mirror of
https://dev.lirent.ru/Vatrog/vm-automation-signaling.git
synced 2026-06-25 20:36:36 +03:00
lirent
0f452fe37c
ABS was glued onto device A alongside the keyboard and never worked right; it is not needed in practice. Remove it entirely: device A is now keyboard-only, and device B is the relative mouse (motion + buttons incl. middle + wheel). Drops the ptr_mode model (one layout remains), VMCTL_EV_ABS/PTR_*, and the absolute axes. The public input-kind enum keeps its numeric values (MOVE_REL=1, BTN=2, KEY=3, SCROLL=4) so the wire stays compatible -- only MOVE_ABS (0) is removed and its slot reserved; an unknown/0 kind is a no-op. Bump 0.3.11.
108 lines
5.3 KiB
C
108 lines
5.3 KiB
C
#ifndef VMCTL_H
|
|
#define VMCTL_H
|
|
#include <stddef.h>
|
|
|
|
/* vmctl.h — public API for a QEMU VM Input layer (actuator): input injection +
|
|
* power/lifecycle actuation. One handle; the input driver is selected
|
|
* declaratively through vmctl_config. OS-agnostic surface. */
|
|
|
|
typedef struct vmctl vmctl_t; /* opaque handle */
|
|
|
|
/* ===== Input drivers + open ===== */
|
|
typedef enum {
|
|
VMCTL_DRIVER_QMP, /* QMP input-send-event (no guest driver required) */
|
|
VMCTL_DRIVER_UINPUT /* host uinput source; optional passthrough into guest */
|
|
/* via QEMU virtio-input-host-pci (Linux). uinput != virtio. */
|
|
} vmctl_driver;
|
|
|
|
typedef struct {
|
|
unsigned bustype; /* HID bus type, e.g. 0x0003 (USB) */
|
|
unsigned vendor; /* vendor id */
|
|
unsigned product; /* product id */
|
|
unsigned version; /* device version */
|
|
const char* name; /* device name; library copies it */
|
|
} vmctl_uinput_id;
|
|
|
|
typedef struct {
|
|
vmctl_driver driver;
|
|
const char* qmp_path; /* QMP unix socket; required for QMP, optional (passthrough) for UINPUT */
|
|
const char* input_bus; /* virtio-input-host-pci bus "pci.0" for passthrough; "" = none */
|
|
const vmctl_uinput_id* uinput_id; /* UINPUT only; NULL = built-in defaults */
|
|
} vmctl_config;
|
|
|
|
vmctl_t* vmctl_open (const vmctl_config* cfg); /* NULL on error */
|
|
void vmctl_close(vmctl_t* v); /* safe on NULL */
|
|
|
|
/* Copy the host evdev node paths of the created uinput devices (UINPUT driver only).
|
|
* a[] receives device A (keyboard), b[] receives device B (relative mouse); both are always
|
|
* created, so count==2 in the normal case. Each buffer must be >=64 bytes. Returns the count
|
|
* of non-empty paths filled (0/1/2), or -1 if the handle's driver is not UINPUT. Paths are
|
|
* valid while the handle is open. */
|
|
int vmctl_uinput_evdev(vmctl_t* v, char a[64], char b[64]);
|
|
|
|
/* ===== Input constants ===== */
|
|
#define VMCTL_AXIS_X 0
|
|
#define VMCTL_AXIS_Y 1
|
|
#define VMCTL_SCROLL_V 0 /* vertical */
|
|
#define VMCTL_SCROLL_H 1 /* horizontal */
|
|
#define VMCTL_BTN_LEFT 0
|
|
#define VMCTL_BTN_RIGHT 1
|
|
#define VMCTL_BTN_MIDDLE 2
|
|
#define VMCTL_BTN_SIDE 3
|
|
#define VMCTL_BTN_EXTRA 4
|
|
#define VMCTL_BTN_FORWARD 5
|
|
#define VMCTL_BTN_BACK 6
|
|
#define VMCTL_BTN_TASK 7
|
|
|
|
#define VMCTL_KEY_CODE_MAX 0x2ff /* highest supported evdev key code (inclusive) */
|
|
#define VMCTL_KEYS_SNAPSHOT_BYTES ((VMCTL_KEY_CODE_MAX + 1) / 8) /* bytes for vmctl_keys_snapshot */
|
|
|
|
/* ===== Event batch (value-type, stack; build ONLY via builders — ev[] is not API) ===== */
|
|
#define VMCTL_BATCH_MAX 64
|
|
typedef struct {
|
|
int kind; /* internal event-kind code; set by builders */
|
|
int code; /* axis / button / evdev-code (per kind) */
|
|
int value; /* rel-delta / down(0|1) */
|
|
double scroll; /* scroll magnitude (scroll only) */
|
|
} vmctl_event;
|
|
typedef struct { vmctl_event ev[VMCTL_BATCH_MAX]; int count; } vmctl_batch;
|
|
|
|
void vmctl_batch_init (vmctl_batch* b);
|
|
void vmctl_batch_rel (vmctl_batch* b, int axis, int delta);
|
|
void vmctl_batch_btn (vmctl_batch* b, int btn, int down);
|
|
void vmctl_batch_key (vmctl_batch* b, int evdev_code, int down);
|
|
void vmctl_batch_scroll(vmctl_batch* b, int axis, double value);
|
|
int vmctl_batch_send (vmctl_t* v, vmctl_batch* b); /* one round-trip; 0=ok, -1=err */
|
|
|
|
/* ===== Single events (wrappers over a 1-event batch) ===== */
|
|
int vmctl_rel (vmctl_t* v, int axis, int delta);
|
|
int vmctl_btn (vmctl_t* v, int btn, int down); /* VMCTL_BTN_* */
|
|
int vmctl_key (vmctl_t* v, int evdev_code, int down); /* Linux KEY_* */
|
|
int vmctl_scroll(vmctl_t* v, int axis, double value); /* VMCTL_SCROLL_* */
|
|
|
|
/* ===== Held-state receipt (read-only) =====
|
|
* "held" = key/button state as THIS handle last actuated it, not guest truth.
|
|
* It is the actuator's record of its own last output (sensing the guest belongs
|
|
* to the sensors layer, not here). Updated only after a successful send; the
|
|
* send path NEVER reads this map (no dedup, no auto-release, no autorepeat). */
|
|
|
|
int vmctl_key_held (vmctl_t* v, int evdev_code); /* Linux KEY_*; 1=down 0=up */
|
|
int vmctl_btn_held (vmctl_t* v, int btn); /* VMCTL_BTN_*; 1=down 0=up */
|
|
int vmctl_keys_snapshot(vmctl_t* v, unsigned char* bits, size_t nbytes);
|
|
/* copy key down-bits (EVIOCGKEY-style);
|
|
returns bytes written, -1 on bad args */
|
|
unsigned vmctl_btns_snapshot(vmctl_t* v); /* VMCTL_BTN_* down-bits as a mask (bits 0..7) */
|
|
|
|
/* ===== Power/lifecycle actuation (requires a QMP connection; -1 if there is none) ===== */
|
|
int vmctl_powerdown(vmctl_t* v); /* system_powerdown (ACPI soft-off) */
|
|
int vmctl_reset (vmctl_t* v); /* system_reset */
|
|
int vmctl_wakeup (vmctl_t* v); /* system_wakeup (from S3/S4) */
|
|
int vmctl_pause (vmctl_t* v); /* stop */
|
|
int vmctl_resume (vmctl_t* v); /* cont */
|
|
|
|
/* Transfer sequencing/context belongs to signaling; timing and decisions to
|
|
* control; reading VM state to sensors. Here, in the Input layer, only atomic
|
|
* actuation. */
|
|
|
|
#endif /* VMCTL_H */
|