> ## 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.

# 标定与配置

> [!NOTE]
>
> 本页覆盖 2.1 设备侧的标定与参数配置：关节零位标定、设备参数的写入与持久化、用户与标定数据的归属。接口定义见 [SDK 接口](https://docs.wuji.tech/docs/zh/wuji-hand/beta1/sdk-reference.md)，命令行操作见 [Wuji CLI 文档](https://docs.wuji.tech/docs/zh/wuji-cli/latest/index.md)。

## 关节零位标定

关节零位决定位置命令与反馈的参考基准。把当前物理位置标定为关节侧零位：

```python theme={null}
hand.set_origin()                   # 整手：所有关节刷新用户零点
hand.clear_origin()                 # 整手：清除所有关节的用户零点
hand.set_origin(joints=mask)        # 可选：长度 20 的 0/1 掩码，只作用于掩码位为 1 的关节
```

关节正在运动时，标定延迟到下次 IDLE 才生效。标定前先失能并确认手指静止在目标姿态。

标定前请先阅读[用户须知的机械操作安全](https://docs.wuji.tech/docs/zh/wuji-hand/beta1/user-notice.md#机械操作安全)。

当前样机零位精度的能力边界见[使用约束的关节零位标定](https://docs.wuji.tech/docs/zh/wuji-hand/beta1/usage-constraints.md#关节零位标定)。

## 设备参数与持久化

设备参数分两类：写入 flash 的持久化参数，以及断电即失效的运行时参数。

| 参数 | 接口 | 持久化 | 生效时机 |
| - | - | - | - |
| 静态 IP | `hand.ip()` | 是 | 重启后 |
| 力矩上限 | `hand.effort_limit()` | 否 | 立即 |
| MIT 控制参数 | `hand.mit_params()` | 否 | 立即 |
| 用户零点 | `hand.set_origin()` | 是 | 下次 IDLE |

运行时参数在设备重启后恢复固件设定的默认值，写入校验规则见[参数安全边界](https://docs.wuji.tech/docs/zh/wuji-hand/beta1/control-guide#参数安全边界)。

### 修改设备 IP

`set` 把新 IP 写入 flash，固件不会热切换正在运行的以太网栈，新 IP 下次重启才生效。修改 IP 分四步：`set` 写入新地址、`reboot` 重启设备、按新 IP 重连、`get` 确认，示例见 [SDK 接口的 ip（SET/GET）](https://docs.wuji.tech/docs/zh/wuji-hand/beta1/sdk-reference/device-operations#ip（set/get）)。

## 用户与标定数据

Wuji SDK 按用户隔离标定产物与本地数据。默认用户之外需要先创建并切换到命名 Profile，标定结果保存到当前用户的 Profile 并立即生效。

用户管理接口与本地数据目录结构见 [Wuji SDK 的 SDK 用户管理](https://docs.wuji.tech/docs/zh/wuji-sdk/latest/device-params.md#sdk-用户管理)与[用户数据导入导出](https://docs.wuji.tech/docs/zh/wuji-sdk/latest/device-params.md#用户数据导入导出)。

## Wuji CLI 配置入口

不写代码时，Wuji CLI 在终端完成同样的参数读写与用户管理：

| 操作 | 命令 | 文档 |
| - | - | - |
| 读写设备参数 | `wuji param` | [参数管理](https://docs.wuji.tech/docs/zh/wuji-cli/latest/parameters.md) |
| 创建与切换用户 | `wuji user` | [用户管理](https://docs.wuji.tech/docs/zh/wuji-cli/latest/user.md) |
| 健康检查 | `wuji doctor` | [设备体检](https://docs.wuji.tech/docs/zh/wuji-cli/latest/doctor.md) |

## 固件与 SDK 版本要求

2.1 的固件停留在 v1.2.4，不再接收更新。SDK 可升级到最新版本，部分依赖 2.2 硬件的能力在 2.1 上不可用。版本对应关系与差异清单见[版本识别与兼容性](https://docs.wuji.tech/docs/zh/wuji-hand/beta1/version-identification-and-compatibility)。


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