MAKCU API

Enable rapid-fire mode for mouse buttons. When the button is held down, it automatically triggers rapid press/release cycles at the specified interval. Multiple buttons can have turbo enabled simultaneously, each with its own delay setting.

• button: 1-5 (mouse buttons: 1=left, 2=right, 3=middle, 4=side1, 5=side2), 0=disable all turbo
• delay_ms: 1-5000ms (0=disable). The delay is the time between each press/release toggle
• turbo() - Returns only active turbo settings as (m1=200, m2=400)
• turbo(button) - Sets turbo with random 35-75ms delay
• turbo(button, 0) - Disables turbo for that specific button
• turbo(0) - Disables all turbo

dx,dy: relative move distance; segments: segment count (optional, default 1, max 512); cx1,cy1,cx2,cy2: cubic Bézier control points (optional)

Move pointer to absolute position. Internally calculates the needed x,y movement to reach the requested position on the screen. Parameters align with km.move().

x,y: absolute coordinates; segments: segment count (optional, default 1, max 512); cx1,cy1,cx2,cy2: cubic Bézier control points (optional)

Windows does not allow multiple scroll steps in a single command. The delta value is clamped to ±1 step (positive for scroll up, negative for scroll down). Values greater than 1 are treated as 1, values less than -1 are treated as -1.

Send complete raw mouse frame (SET only, no GET). (0) clears all; x,y,wheel,pan,tilt are one-shots; button mask mirrors button states.

Lock button or axis. The target is part of the command name, not a parameter. state: 1=lock, 0=unlock. Call with `()` to read lock state.

Enable catch on a locked button. The target is part of the command name, not a parameter. Note: Catch only works for buttons, not axes. Requires corresponding km.lock_<target> to be set first.

Remap mouse buttons (physical only). Auto-clears conflicting mappings; both directions can be mapped (swap).

• () - Show only active mappings, e.g., (left:right,right:left)
• (0) - Reset all button remaps
• (src,dst) - Map button src→dst (1=left, 2=right, 3=middle, 4=side1, 5=side2)
• (src,0) - Clear remap for button src

Remap mouse axes (physical only). Set all three flags at once.

• () - Show current settings, e.g., (invert_x=0,invert_y=1,swap_xy=0)
• (0) - Reset all axis remaps
• (inv_x,inv_y,swap) - Set all three flags (0 or 1)

key: HID code or quoted string; hold_ms: hold duration (defaults to random 35-75ms, logged); rand_ms: optional randomization window

Stream keyboard keys with human-readable names. Mode 1=raw (physical input), 2=constructed frame (after remapping/masking); period clamped 1-1000 ms.

Output format: keys(raw,shift,'h') or keys(constructed,ctrl,shift,'a') - modifiers and keys shown as names (e.g., 'shift', 'ctrl', 'h', 'a') instead of HID numbers.

Output format: raw(x,y,w) or mut(x,y,w) where w is the wheel delta.

Returns stored parse fault information including ESP32 MAC address, failed endpoint address, interface number, failure reason, and raw HID descriptor bytes. Useful for debugging devices that fail to parse.

Used to change the serial number of an attached mouse or keyboard while connected to MAKCU. This change is persistent and remains even after future firmware changes. Note: MAKCU does not allow changing serial numbers for a device that does not contain one.

Auto-release monitoring system. Continuously monitors independent lock, button, and key states. When the timer expires, it releases only the corresponding values that remain active (not all at once). This setting is persistently saved to storage and automatically enabled on startup/boot. `()` get status (0=disabled, else time ms); `(timer_ms)` set timer 500-300000ms (5 min), (0) disables.