GRMrGecko/midi-harbor
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
midi-harbor/specs/007-routing/quickstart.md
James Coleman 488e42b9c8 First commit
2026-09-28 13:59:10 -05:00

1.3 KiB
Raw Blame History

Quickstart: Routing

Prerequisites and the build are in 001's quickstart, with the automated equivalent of each scenario.

Scenario 3 — Physical device repeated over the network (US4 · SC-010a, SC-010b, SC-010c)

The repeater. Requires a physical MIDI device and the session from scenario 2.

# Plug the device in — no command needed.
midi-harbor device list                     # expect: appears within 2 seconds (SC-010a)
midi-harbor route create "<device>" "Studio"

On the remote machine, complete the repeater in the other direction:

midi-harbor route create "Studio" "<local hardware output>"

Expected: playing the device drives the sound module attached to the other machine.

Hot-plug check (SC-010c): unplug the device, wait, plug it back in — including into a different USB port.

midi-harbor route list                      # expect: route Valid again, not Broken

Pass criteria: the route resumes automatically without being recreated, and no note is left sounding on the remote machine (FR-015d, FR-015f). Repeat 100 times for SC-010c.

Loop check: create the reverse route on both machines so MIDI would circulate. Expect a warning naming the cycle and no unbounded message multiplication (FR-033).