参数读写

发现资源

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_addressdata_port 等网络参数写入后需设备重启才生效,wuji devices 里看不到即时变化属预期
  • 提示 virtual parameter 'X' currently has no value 表示该虚拟参数无默认值,且无状态 CLI 不持久化写入,属预期行为