Config / Calibration / Maintenance

能力说明

读取与设置配置、执行标定，以及管理重启和固件升级。

适用产品

适用于受支持的 21 DOF 产品，具体操作受硬件能力和固件限制；升级目标须匹配实际设备。

快速示例

以下片段在已连接的 hand 上执行。Python 位于 async 函数内；C++ 需包含 revo3/revo3.hpp、iostream、vector、chrono 和 stdexcept，并在应用边界处理 SdkError。

config = await hand.config.snapshot()
print(config.slave_id)
runtime = hand.config.runtime_options
print(runtime.servo_command_timeout_ms)

const auto config = hand.config().snapshot();
const auto runtime = hand.config().runtime_options();
std::cout << static_cast<int>(config.slave_id) << " "
          << runtime.servo_command_timeout.count() << "\n";

参数与返回值

操作	参数	返回值
Config.snapshot()	—	DeviceConfig
Maintenance.update_firmware(file_path, target, wait_secs)	固件路径；可选升级目标；等待参数（秒）	OperationHandle

按操作查阅完整签名、默认值、单位与 Python / C++ 差异：

错误与限制

设备配置由固件持久化；RuntimeOptions 仅影响当前进程。标定前必须保持 Motion 空闲，响应丢失时不能自动重发；写响应不证明设备内部标定已完成。

错误、超时与重试 · 语言绑定差异