Skip to content

IcomCommander

Serialized CI-V command executor with priority queuing (wfview-style). Most users should use the high-level Radio API (via create_radio), which manages an IcomCommander internally.

rigplane.commands.commander.IcomCommander

wfview-style serialized command executor with priorities.

Features: - strict in-order execution within priority levels - configurable pacing between commands - optional dedup for background polling keys - transaction helper (snapshot/restore)

send(payload, *, priority=Priority.NORMAL, key=None, dedupe=False, timeout=None, wait_response=True, wait_dispatch=True) async

Enqueue a CI-V command.

Parameters:

Name Type Description Default
wait_dispatch bool

When True (default), await the worker dispatching this item and return its result — the historical blocking contract for user commands. When False, return None immediately after enqueueing without awaiting the worker; the item is still paced, executed, and its future resolved by the worker, but the caller does not observe it. Used by the background poller so the poll burst does not park the poll loop (responses arrive via the RX path, not this future). For Priority.BACKGROUND fire-and-forget sends a defensive _MAX_BG_INFLIGHT cap bounds outstanding work (drop-newest).

True

Priority Levels

rigplane.commands.commander.Priority

Bases: IntEnum