Device Management

Scan Devices

wuji devices scans and lists all devices on the USB and UDP buses:

wuji devices          # table output
wuji devices --json   # JSON output for scripting

Output columns include SN, Transport, USB Port, IP, and Address. Use wuji ping to get the device type and firmware version.

Probe Connectivity

wuji ping performs a full handshake with the device to confirm it's actually reachable, reporting SN, firmware version, and IP:

wuji ping                 # probe all discovered devices one by one
wuji ping --sn <SN>       # probe a specific device only
wuji ping --json          # structured output

If any device fails the probe, the command returns exit code 1 — ready for script assertions.

Target a Specific Device

Most commands accept one of the following mutually exclusive flags to select a device:

--sn WG1KXXXXXXXXXXX             # by serial number (recommended, most precise)
--address 192.168.1.100:50000    # by address: ip:port for UDP, /dev/ttyACM0 for USB
--handedness left                # by handedness left/right (two-handed devices)

Behavior when no device is specified:

• ping and doctor process all discovered devices
• get, set, sub, and resources connect automatically when exactly one device is present. With multiple devices, they report an error listing candidate SNs — pick one with --sn

Behavior When the Device Is Occupied

Device firmware allows only one direct session at a time. When a host application such as Wuji Studio already occupies the device, the CLI falls back to read-only access:

• Read operations (get, sub, resources, and doctor sampling) keep working
• Write operations (set) are rejected — release the occupying direct connection and retry

Common Messages