How it works
Connect the boxes, then pair them.
The USB device connects to one box. Your computer connects by USB to a second box. Ethernet carries the connection between them.
1. Connect the USB cables
Plug the USB device into the device-side box. Connect the computer-side box to your computer with another USB cable. Both Yoke boxes are separate from your computer.
2. Connect the boxes to Ethernet
Both boxes connect to your Ethernet switch. The prototype uses a Radxa ZERO 3E board in each box and targets USB 2 first.
3. Pair the boxes
Tell the computer-side box which device-side box to use. A command looks like this, using the names assigned to your boxes:
yoke pair usb-device-box desk-usb-box
The box saves that choice. Closing the setup tool does not clear it. After a restart or a lost network connection, it keeps the pairing and tries to reconnect. Use a new pair or unpair command to change it.
Try pairing a box
This example runs in your browser. It does not connect to any hardware.
Setup toolOpen
Device-side boxUSB controller box: online
Choose a device box, close the setup tool, or disconnect a box.
Disconnecting a box keeps its pairing saved. Pair or unpair changes it. Reloading this page resets the example.
4. Use the device from your computer
The computer sends and receives USB traffic through its USB cable. The two boxes carry that traffic over Ethernet. The boxes handle the connection; your computer uses its USB port.
This is the agreed hardware design. The complete USB bridge firmware and hardware tests are still unfinished. See the USB hardware page and development status.
Optional management and monitoring
Use the command line, Thermite, or another manager to change pairings. The boxes do not depend on a manager remaining connected.
yoke status
yoke snoop
yoke top
These tools show saved pairings, recent status, and errors. A status message cannot establish that a physical device is working; hardware tests check that separately.