> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wuji.tech/llms.txt
> Use this file to discover all available pages before exploring further.

# 参数读写

> 用 resources、get 和 set 发现并读写设备参数

## 发现资源

`wuji resources` 列出设备的可读写参数（params）与可订阅 topic：

```bash theme={null}
wuji resources --sn <SN>
wuji resources --sn <SN> --json
```

完整清单以命令实际输出为准。常用参数速查：

| 参数 | 说明 |
| - | - |
| `hand_side` | 手性 |
| `firmware_version` | 固件版本 |
| `serial_number` | 序列号 |
| `ip_address` | 设备 IP 地址 |
| `data_port` | 数据端口 |

## 读取参数

`wuji get <path>` 读取参数，按资源类型自动解码为 JSON 值：

```bash theme={null}
$ wuji get firmware_version --sn <SN>
firmware_version = "x.y.z"

$ wuji get ip_address --sn <SN> --json
```

资源路径照 `wuji resources` 输出的形式原样使用。读取不存在的路径会报错并以退出码 1 退出，错误信息会提示用 `wuji resources` 查看有效路径。无法识别类型时，默认输出里值显示为 `<unrecognized value>`，`--json` 下省略 `value` 键。

## 写入参数

`wuji set <path> <value>` 写入参数，值使用 JSON 格式，也接受 `0x` 前缀的裸十六进制字节：

```bash theme={null}
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 字节
```

<Warning>
  设备被上位机占用时 CLI 处于只读访问，`set` 会被拒绝。释放直连占用方后重试。
</Warning>

## 注意事项

* `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 不持久化写入，属预期行为


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.