# STS3215校准后保留单圈偏移致启动异常运动

> 原文链接：https://robotics.hellobike.com/pitfalls/2026-11-12-lerobot-5324
> 频道：pitfalls | 更新日期：2026-11-12 | 标签：auto, github-issue, lerobot
> 核心摘要：STS3215舵机校准后内部多圈计数器未清零，导致启用扭矩时电机失控冲向限位。需发送RESET指令或断电重启清除偏移。

# STS3215校准后保留单圈偏移致启动异常运动

::: v-pre
> 本文由 AI 根据公开内容整理，可能有误，请以原文为准：[Feetech STS3215 retains a one-turn position offset after calibration, causing unexpected initial movement](https://github.com/huggingface/lerobot/issues/5324)（GitHub huggingface/lerobot #5324）

**状态**：有绕过办法

## 问题

SO-101机械臂STS3215舵机在校准流程（写入Homing_Offset、记录行程）后，虽然Present_Position读数正常，但内部多圈位置计数仍保留4096 ticks偏移。此时若使能扭矩并写入Goal_Position，电机会以满载加速冲向机械限位，即使目标位置等于当前位置也会持续施力。修改Phase寄存器bit 4仅改变读数显示模式，无法清除底层圈数计数；重写Homing_Offset和位置限位亦无效。

## 环境

SO-101 follower机械臂，6个Feetech STS3215舵机（型号777，固件3.10，波特率1Mbps）；LeRobot 0.7.0/0.7.1，rustypot 1.13.1；Windows 11或macOS 15；Python 3.12/3.13。

## 解决办法

1. 在`calibrate()`流程结束后、首次使能扭矩前，向受影响舵机发送RESET指令（地址`0x0A`），注意此为非工厂重置的软复位命令。
2. 若软件复位无效，对舵机进行完全断电再上电循环，以强制清除内部多圈位置缓存。
3. 避免仅依赖修改`Phase`寄存器bit 4来修复该问题，该操作仅切换`Present_Position`的多圈/单圈显示模式，不影响控制器实际使用的圈数计数。
4. 排查时无需怀疑编码器硬件故障或控制表配置错误，该现象为校准逻辑与舵机固件交互导致的已知状态残留问题。

讨论原作者：@Sjeongheon 等，版权归原作者所有。
:::

## 原始参考来源 (Sources)

- [GitHub huggingface/lerobot #5324：Feetech STS3215 retains a one-turn position offset after calibration, causing unexpected initial movement](https://github.com/huggingface/lerobot/issues/5324)