发现资源
wuji resources 列出设备的可读写参数(params)与可订阅 topic:
完整清单以命令实际输出为准。常用参数速查:
读取参数
wuji get <path> 读取参数,按资源类型自动解码为 JSON 值:
资源路径照 wuji resources 输出的形式原样使用。读取不存在的路径会报错并以退出码 1 退出,错误信息会提示用 wuji resources 查看有效路径。无法识别类型时,默认输出里值显示为 <unrecognized value>,--json 下省略 value 键。
写入参数
wuji set <path> <value> 写入参数,值使用 JSON 格式,也接受 0x 前缀的裸十六进制字节:
设备被上位机占用时 CLI 处于只读访问,set 会被拒绝。释放直连占用方后重试。
注意事项
ip_address、data_port 等网络参数写入后需设备重启才生效,wuji devices 输出中不会立即体现,属预期行为
- Wuji Hand 2 的
data_port 需要较新的固件才能写入,可设范围为 10000–65535,50000 除外,超出范围时 set 报错且端口保持原值。写入成功后 wuji get data_port 立即返回新端口,设备重启后改用新端口
- 提示
virtual parameter 'X' currently has no value 表示该虚拟参数无默认值,且无状态 CLI 不持久化写入,属预期行为