参数读写
发现资源
wuji resources 列出设备的可读写参数(params)与可订阅 topic:
wuji resources --sn <SN>
wuji resources --sn <SN> --json完整清单以命令实际输出为准。常用参数速查:
| 参数 | 说明 |
|---|---|
hand_side | 手性 |
firmware_version | 固件版本 |
serial_number | 序列号 |
ip_address | 设备 IP 地址 |
data_port | 数据端口 |
读取参数
wuji get <path> 读取参数,按资源类型自动解码为 JSON 值:
$ wuji get firmware_version --sn <SN>
firmware_version = "x.y.z"
$ wuji get ip_address --sn <SN> --json资源路径同时接受 . 和 / 两种分隔风格。无法识别类型时输出原始十六进制字节。
写入参数
wuji set <path> <value> 写入参数,值使用 JSON 格式,也接受 0x 前缀的裸十六进制字节:
wuji set data_port 50002 --sn <SN> # JSON 数值
wuji set some_param '[1,2]' --sn <SN> # JSON 数组
wuji set some_param 0x01ff --sn <SN> # 裸 hex 字节设备被上位机占用时 CLI 处于只读访问,set 会被拒绝。释放直连占用方后重试。
注意事项
ip_address、data_port等网络参数写入后需设备重启才生效,wuji devices里看不到即时变化属预期- 提示
virtual parameter 'X' currently has no value表示该虚拟参数无默认值,且无状态 CLI 不持久化写入,属预期行为