从仿真到真机走起来:Microduck复刻kissqy行走模型上机实测——软起步、电压塌陷与主板散热教训
从仿真到真机走起来:Microduck复刻kissqy行走模型上机实测——软起步、电压塌陷与主板散热教训
Microduck 复刻项目这次把社区成员 kissqy 训练的 kissqy 行走模型(policy.onnx,基于飞特 HD-1910 舵机重训)搬上了我们自己的鸭子。两天一夜、13 次上机记录,换来三条硬教训:软起步压住冲击电流、供电留足余量防电压塌陷、主板散热不解决一切免谈。本文把整条"仿真 → 真机"的排查路径和关键数据讲清楚,帮你少走弯路。
背景:这只鸭子和这个模型
这台鸭子是高 25 cm 的 Microduck 复刻机,换装了 15 颗飞特 HD-1910-C001 舵机(原版是 Dynamixel XL330,飞特版便宜一半、力矩大 2.5 倍)。机械与装配细节见 构建日志,舵机协议适配思路见 飞特适配架构。
kissqy 行走模型的关键参数:
| 项目 | 值 |
|---|---|
| 任务 | 行走 + 零速站立 + 倒地恢复联合策略 |
| 输入 / 输出 | 61 维观测 / 14 个关节动作 |
| 控制频率 | 50 Hz(20 ms 一帧) |
| 训练前进速度 | ±0.4 m/s |
| 训练时增益 | P5,供电 7.4–8.0 V |
模型在仿真里跑得漂亮,但仿真里从来不会掉电压、不会降频。下面三次上机实测,暴露的全是这类真机问题。
教训一:手托机身测不出行走策略,要放地上
第一次尝试用手托着鸭子跑模型:速度给到 0.15 m/s,鸭子只换了一个姿势就"定住"了。原因很反直觉——这个模型的观测里没有节拍信号,迈步靠身体晃动、重心转移,再经 IMU 和关节反馈带出来。机身被托住不晃,输出很快就收敛到静止。
放到地上松手后 0.4 秒内,两条腿就开始交替屈伸——行走策略本身是好的。但随之而来的就是第二次教训。
教训二:电压塌陷——起步那一下最要命
地上第 6 次运行,14 颗舵机电压在 0.4 秒内一起从 7.1 V 掉到 6.5–6.6 V,触发低压保护,全身卸力。逐次排查后的结论:
- 软起步(ramp)是刚需。给动作目标加 1 秒的斜坡,起步电流尖峰被压住,10 秒运行最低电压稳定在 7.5 V 以上;不加斜坡、按训练原样直接输出,电压会一起掉到 4.6 V。
- 增益 P 不能随便加。P5 时电流读数尚可;P10 时 14 颗电流相加约 26 A,可调电源直接扛不住,电压塌到 5.4 V。想加硬度,先试 6–8。
- 供电要留余量。可调电源从 7.2 V 调到约 8.0 V 后,全程最低 7.6 V。HD-1910 上限 8.4 V,kissqy 训练供电范围 7.4–8.0 V,正好是甜点区间。
这张电源分配图说明了为什么余量这么关键:舵机全程无降压直取电池轨,任何一个瞬间的大电流都会直接反映在舵机端电压上。
教训三:主板过热降频,50 Hz 变 40 Hz
最隐蔽的坑:主板 CPU 84–92°C,频率被锁死在最低档 408 MHz。主因是网页调试服务 server.py 常驻占满一个核,加上主板装在机身里没有任何散热。后果:
- 控制周期中位从 20 ms 拖到 25 ms(约 40 Hz),而模型是按 50 Hz 训练的,节奏错了动作就"做不足";
- 停掉网页服务后周期立刻回到 20.2 ms;
- 第二天换整套 Rust 运行程序后,网页摇杆按键也因为没有 1.7 秒的启动时间而全部作废。
每个控制周期要完成"同步读 16 个设备 → 组 61 维观测 → ONNX 推理 → 电压补偿 → 同步写 14 个目标",CPU 一慢,整条链路一起拖。官方给的散热思路是:机壳开孔 + 进/出风风道 + 主板旁贴散热片,风扇不一定非要贴着主板,风路经过就行(详见 10-12 上机记录第 8 节)。
换整套官方运行时:原地站稳 10 秒
排除方向、增益、节奏、供电后,剩下的变量是运行层。于是 10 月 12 日凌晨直接换用 kissqy 的整套部署(官方 0.15.1 + R17 运行程序),只补他缺的一块:IMU 用 BNO085 接主板 I²C 而不是挂舵机总线。结果:
- BNO085 真机读通,15 颗舵机 50 Hz 全应答,控制循环 49.99 Hz;
- 鸭子 HOME 到官方站姿,模型接管后原地保持 10 秒,机身倾斜从 6.6° 自动收到 3.3°,关节偏离 HOME 最多 6.2°,全程无报错;
- 连续行走留待散热解决后复测。
装机过程中的两个大坑值得提前知道:安装脚本会把作者样机的标定写成本机标定(零位、方向全是他机器的,照抄上力关节会转到错误角度);舵机已上力时 HOME 会被拒(程序会核对增益值,必须先 robot.relax 卸力再 robot.init)。
调试阶段可以借助仓库自带的网页调试台:拖滑块核对站姿、一键校准零位、读 14 颗舵机的位置/电压/温度,上机前把姿势对到 12° 以内再让策略接管。
给复刻者的检查清单
- [ ] 测行走模型:放地上、手只虚护,手托永远测不出步态
- [ ] 电源给足 8.0 V 左右的余量,别用 7.4 V 贴着训练下限跑
- [ ] 策略启动前加 1 秒软起步,防起步电流尖峰
- [ ] 增益从 P5 起步,往上调先试 6–8,别直接 P10
- [ ] 主板开孔做风道,跑控制循环时关掉用不到的服务(相机、ToF)
- [ ] 装别人整套时,第一时间替换成自己的标定文件
- [ ] HOME 之前先确认 IMU 方向:站立离竖直 ≤5°,前倾 15–30° 方向朝正前
两次实测的完整数据(13 次运行的电压、电流、周期记录,以及 10-12 全套安装日志)都在仓库里,每一条结论都能对着数字复核:
- 10-11 行走模型上机实测:软起步、电压塌陷、降频的全部原始数据
- 10-12 整套上机记录:安装顺序、标定替换、IMU 方向确认
- 踩坑记录:主板、HAT、摄像头相关的历史坑位
从"仿真里跑得飞起"到"真机上迈开腿",模型本身往往不是最难的部分——电源余量、启动冲击和散热这三件不起眼的事,才是决定你当晚能不能看到鸭子走动的关键。




