设备管理

扫描设备

wuji devices 扫描并列出 USB 和 UDP 总线上的全部设备：

wuji devices          # 表格输出
wuji devices --json   # JSON 输出，便于脚本解析

输出列包括 SN、Transport、USB Port、IP 和 Address。设备类型与固件版本用 wuji ping 获取。

探测连通性

wuji ping 对设备执行完整握手，确认设备真正可用，并报告 SN、固件版本和 IP：

wuji ping                 # 逐台探测全部已发现设备
wuji ping --sn <SN>       # 只探测指定设备
wuji ping --json          # 结构化输出

任一设备探测失败时，命令返回退出码 1，可直接用于脚本判定。

指定目标设备

多数命令支持用以下参数指定设备，三者互斥：

--sn WG1KXXXXXXXXXXX             # 按序列号（推荐，最精确）
--address 192.168.1.100:50000    # 按地址：UDP 为 ip:port，USB 为 /dev/ttyACM0
--handedness left                # 按手性 left/right（双手设备）

不指定设备时的行为：

• ping 和 doctor 处理全部已发现设备
• get、set、sub 和 resources 在只有一台设备时自动连接，存在多台设备时报错并列出候选 SN，按提示用 --sn 指定

设备被占用时的行为

设备固件同一时刻只允许一个直连会话。设备已被上位机（如 Wuji Studio）直连占用时，CLI 自动回退为只读访问：

• 读操作（get、sub、resources、doctor 的采样）正常工作
• 写操作（set）会被拒绝，释放直连占用方后重试

常见提示与处理