See Connection and Lifecycle.

Pick a box out of several by a stable identity (device MAC or CH343 serial), or by the kind of device it clones. See Discovery.

See Move. +x right, +y down. Build the axis struct with the motion helpers.

One verb set over a MediusUsage (button, key, or media). Build it with the input helpers; see Inject, the injection model, and the id spaces on Usage IDs.

See Lock. A MediusLockTarget picks an axis or usage, dir takes a MediusDirection constant and what a MediusBlanket one; anything else is MEDIUS_STATUS_ERR_INVALID_ARG and no frame goes out. Read the entries back with medius_locks_scale_of and medius_locks_is_locked.

See Requests. Each blocks for the box's reply, writes a struct documented on Types & errors, and returns MEDIUS_STATUS_ERR_QUERY_TIMEOUT if no reply arrives.

See Firmware update. Staging blocks for the whole transfer; a refusal returns MEDIUS_STATUS_ERR_UPDATE.

typedef void (*MediusUpdateProgress)(void *user, size_t sent, size_t total);

Consuming events is on Streams, the catch feature on Catch, and logs on Logs & counters.

medius_device_catch_events takes an array of MediusCatchFilter entries, built by the filter helpers. The box's table holds 32; asking for more, or for an entry it cannot honour, fails the call.

MediusStatus medius_device_catch_events(MediusDevice *dev,
                                        const MediusCatchFilter *filters,
                                        uintptr_t n_filters,
                                        MediusEventStream **out);

MediusStatus medius_device_input_events(MediusDevice *dev,
                                        const MediusCatchFilter *filters,
                                        uintptr_t n_filters,
                                        MediusInputStream **out);

Pure constructors for a MediusCatchFilter: a base names what to observe, a modifier returns a narrowed copy. No device, no wire traffic. See Catch.

/* the wheel, scrolled up only */
MediusCatchFilter up = medius_catch_filter_with_direction(
    medius_catch_filter_watch_axis(MEDIUS_AXIS_WHEEL), MEDIUS_DIRECTION_POSITIVE);

/* EP0, first 8 bytes: the setup packet and nothing after it */
MediusCatchFilter ep0 = medius_catch_filter_with_capture(
    medius_catch_filter_traffic(MEDIUS_CATCH_CLASS_CONTROL, 0), 8);

Build an entry stream with an opaque MediusClipBuilder, then drive playback through an opaque MediusClip handle from medius_device_clip. Each owns its allocation: free the builder with medius_clip_builder_free and the handle with medius_clip_free. Concept on Clip.

MediusClipBuilder *b = medius_clip_builder_new();

/* move (+10, -4) AND press Left on the same frame */
MediusUsage  inputs[1]  = { medius_usage_button(MEDIUS_BUTTON_LEFT) };
MediusAction actions[1] = { MEDIUS_ACTION_PRESS };
medius_clip_builder_frame(b, 10, -4, 0, inputs, actions, 1);

Pure constructors: no device, no wire traffic. See Inject, Move, and Lock.

Helpers that interpret a struct you already have. They take it by value (or pointer) and do no I/O. Each mirrors the matching method on the Rust type.

All of these are wrapped in #ifdef MEDIUS_FEATURE_MOCK (the mock cargo feature). The concept lives on Mock; turning the feature on is on Build & features.