docs(piper): clarify leader/follower mode guidance for HIL flows

- document MasterSlaveConfig linkage_config semantics (0xFA/0xFC) in README

- update piper leader startup role command from 0xFA to 0xFC

- add inline note on commandability and power-cycle requirement after role switch

- align piper leader config comment with 0xFC startup role
这个提交包含在:
Elvin
2026-03-05 17:12:27 +08:00
父节点 b4482674ef
当前提交 df08db9005
共有 3 个文件被更改,包括 15 次插入 和 2 次删除

查看文件

@ -268,6 +268,14 @@ Recommendation: use **`fourcc: "MJPG"`** for OpenCV and **`warmup_s`** for RealS
#### AgileX PiPER
PiPER mode note (policy-sync / human-in-the-loop):
- Leader/follower linkage is configured via `MasterSlaveConfig(linkage_config, feedback_offset, ctrl_offset, linkage_offset)`.
- `linkage_config=0xFA`: teaching-input arm.
- `linkage_config=0xFC`: motion-output arm.
- `0xFA` is not suitable when the arm must accept external control commands. For policy execution + intervention switching, keep both teleop and robot arms in `0xFC`.
- After switching role mode (`0xFA` <-> `0xFC`), perform a full power-cycle before validation.
```bash
lerobot-human-inloop-record \
--robot.type=piper_follower \

查看文件

@ -32,7 +32,7 @@ class PiperLeaderConfigBase:
log_level: str = "WARNING"
startup_sleep_s: float = 0.1
# Optional role command on startup (0xFA = teaching input arm)
# Optional role command on startup (0xFC = motion output arm)
set_leader_mode_on_connect: bool = False
# Manual backdrivable mode for human teleop

查看文件

@ -79,7 +79,12 @@ class PiperLeader(Teleoperator):
self._is_connected = True
try:
if self.config.set_leader_mode_on_connect:
self.arm.MasterSlaveConfig(0xFA, 0x00, 0x00, 0x00)
# NOTE:
# - Piper teaching-input mode (0xFA) does not accept external JointCtrl/GripperCtrl commands.
# - For policy-sync and human-in-the-loop switching, the leader must remain commandable,
# so we configure it as motion-output mode (0xFC), same as the follower side.
# - Mode-role changes (e.g., 0xFA <-> 0xFC) may require a full power-cycle to take effect.
self.arm.MasterSlaveConfig(0xFC, 0x00, 0x00, 0x00)
time.sleep(0.05)
self.configure()
except Exception: