feat(piper): require calibration by default with opt-out mode

- set piper calibration_mode default to required and keep off as explicit opt-out

- remove auto pairing policy and simplify runtime calibration gating

- update README and add test for uncalibrated control when calibration_mode=off
这个提交包含在:
Elvin
2026-03-05 21:49:39 +08:00
父节点 7a9aeb3850
当前提交 294a370657
共有 7 个文件被更改,包括 85 次插入 和 10 次删除

查看文件

@ -17,6 +17,7 @@
from dataclasses import dataclass, field
from lerobot.cameras import CameraConfig
from lerobot.utils.piper_sdk import PIPER_CALIBRATION_MODES
from ..config import RobotConfig
@ -49,6 +50,10 @@ class PiperFollowerConfigBase:
# Calibration precision:
# homing_offset/range_min/range_max are stored as "degree * calibration_scale".
calibration_scale: int = 1000
# Calibration policy:
# - required: always require calibration
# - off: never require calibration
calibration_mode: str = "required"
# Gripper forwarding behavior
sync_gripper: bool = True
@ -75,6 +80,8 @@ class PiperFollowerConfig(RobotConfig, PiperFollowerConfigBase):
raise ValueError("`enable_timeout_s` must be >= 0.")
if self.calibration_scale <= 0:
raise ValueError("`calibration_scale` must be > 0.")
if self.calibration_mode not in PIPER_CALIBRATION_MODES:
raise ValueError("`calibration_mode` must be one of: required, off.")
if self.startup_sleep_s < 0:
raise ValueError("`startup_sleep_s` must be >= 0.")
if not (0 <= self.gripper_effort_default <= 5000):