rc2fx-transport
RC2FX control over USB 1 from the desktop app. It runs inside the app process, starts no listener or external program, and uses no network.
Command::Connect opens the single RØDECaster Pro II on USB 1 through the installer crate's control client. The framing is described in USB control. One thread holds the HID handle and serves requests in order.
Request handling
- A request whose outcome is unknown is not resent. After a broken request, queued requests are refused without being sent, and the session reopens only after a fresh read. Changes are always based on state the app has re-read.
- Reopening keeps the session's nonce and request numbers, so the mixer treats it as the same client. A mixer with a different serial is refused.
- A lost reply is fetched again. If the final acknowledgement is lost, the reply the mixer cached is recovered.
- Events are polled with
GET api/v1/events. Polling backs off while it fails, and the backoff resets after a period of successful polls.
Engine restart, global processing and path selection are single writes. Each names the revision and engine generation it was based on and requires a 202 with a valid state. A 409 or an uncertain outcome is reported to the caller and not retried. Request bodies have size limits, and replies are parsed with the core crate's duplicate-key and depth checks.
Dropping Transport cancels its runtime without sending queued writes. A write the mixer has already received stays applied.
Running
cargo test -p rc2fx-transport
cargo test -p rc2fx-transport --features mock-mixer
cargo run -p rc2fx-transport --example usb_probe # needs a connected mixer