Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
新 · 2026.10.12 · Python SDK、C SDK 与 Wuji CLI 的 Linux 产物支持 Ubuntu 20.04 LTS 及以上。查看详情
扫描设备、探测连通性与指定目标设备
wuji devices 扫描并列出 USB 和 UDP 总线上的全部设备：
wuji devices # 表格输出
wuji devices --json # JSON 输出，便于脚本解析
wuji ping 获取。
wuji ping 对设备执行完整握手，确认设备真正可用，并报告 SN、固件版本和 IP：
wuji ping # 逐台探测全部已发现设备
wuji ping --sn <SN> # 只探测指定设备
wuji ping --json # 结构化输出
--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 指定get、sub、resources、doctor 的采样）正常工作set）会被拒绝，释放直连占用方后重试| 提示 | 含义与处理 |
|---|---|
found N devices: ... | 未指定设备且总线上有多台，按提示用 --sn 指定 |
Session already exists (0x0013) | 设备被其他进程直连占用，CLI 自动回退为只读模式 |
connected to wrong device: requested sn=X, got sn=Y | 多设备共享同一地址或扫描条目过期，重新运行 wuji devices 核对 |