Open Duck Mini v2(迷你 BDX 双足机器人) 复刻全流程
Open Duck Mini v2(迷你 BDX 双足机器人) 从采购、打印、组装到装软件、标定和训练的 122 个步骤,附物料表、购买链接与官方出处。
作者 BOM 表合计 398.10 欧元(最低估计 331.10 欧元,加表情套件 432.34 欧元),README 称整套 BOM 应低于 400 美元;作者估算,未含 3D 打印机、工具与运费,PLA 计 20 欧元。Tnkr 整套套件 600 美元(2026‑11‑01,运费另计,关税与增值税由买方承担)
采购
- 准备工具和材料
准备烙铁、基本电子工具和技能、X 颗 M3 螺丝、一些导线以及 Loctite 243 蓝色螺纹胶。
- 获取物料清单
打开 Google Sheets 表格形式的 BOM,以获取项目物料清单。文档还提供了飞书上的中文版 BOM。
打印与加工
- 查找 STL 文件
在仓库根目录的 `print/` 文件夹中查找这些 `.stl` 文件。
- 设置打印材料与填充
除 `foot_bottom_tpu.stl` 外,所有零件均使用标准 PLA 和 15% 填充打印。
- 打印两个脚部上件
使用标准 PLA 和 15% 填充打印 `foot_top.stl` 两个。
- 打印两个脚部侧件
使用标准 PLA 和 15% 填充打印 `foot_side.stl` 两个。
- 打印两个 PLA 脚底
使用标准 PLA 和 15% 填充打印 `foot_bottom_pla.stl` 两个。
- 打印两个 TPU 脚底
使用 TPU 和 40% 填充打印 `foot_bottom_tpu.stl` 两个。
- 打印左侧膝踝薄板
使用标准 PLA 和 15% 填充打印 `knee_to_ankle_left_sheet.stl` 四个。
- 打印右侧膝踝薄板
使用标准 PLA 和 15% 填充打印 `knee_to_ankle_right_sheet.stl` 四个。
- 打印四个腿部垫片
使用标准 PLA 和 15% 填充打印 `leg_spacer.stl` 四个。
- 打印左侧横滚俯仰件
使用标准 PLA 和 15% 填充打印 `left_roll_to_pitch.stl` 一个。
- 打印右侧横滚俯仰件
使用标准 PLA 和 15% 填充打印 `right_roll_to_pitch.stl` 一个。
- 打印两个横滚电机底座
使用标准 PLA 和 15% 填充打印 `roll_motor_bottom.stl` 两个。
- 打印两个横滚电机顶部
使用标准 PLA 和 15% 填充打印 `roll_motor_top.stl` 两个。
- 打印躯干底部
使用标准 PLA 和 15% 填充打印 `trunk_bottom.stl` 一个。
- 打印躯干顶部
使用标准 PLA 和 15% 填充打印 `trunk_top.stl` 一个。
- 打印左侧颈部薄板
使用标准 PLA 和 15% 填充打印 `neck_left_sheet.stl` 一个。
- 打印右侧颈部薄板
使用标准 PLA 和 15% 填充打印 `neck_right_sheet.stl` 一个。
- 打印头部俯仰偏航件
使用标准 PLA 和 15% 填充打印 `head_pitch_to_yaw.stl` 一个。
- 打印头部偏航横滚件
使用标准 PLA 和 15% 填充打印 `head_yaw_to_roll.stl` 一个。
- 打印头部横滚安装座
使用标准 PLA 和 15% 填充打印 `head_roll_mount.stl` 一个。
- 打印头部外壳
使用标准 PLA 和 15% 填充打印 `head.stl` 一个。
- 打印头部底部薄板
使用标准 PLA 和 15% 填充打印 `head_bot_sheet.stl` 一个。
- 打印左侧天线支架
使用标准 PLA 和 15% 填充打印 `left_antenna_holder.stl` 一个。
- 打印右侧天线支架
使用标准 PLA 和 15% 填充打印 `right_antenna_holder.stl` 一个。
- 打印左侧机盖
使用标准 PLA 和 15% 填充打印 `left_cache.stl` 一个。
- 打印右侧机盖
使用标准 PLA 和 15% 填充打印 `right_cache.stl` 一个。
- 打印机身前部
使用标准 PLA 和 15% 填充打印 `body_front.stl` 一个。
- 打印机身中部底板
使用标准 PLA 和 15% 填充打印 `body_middle_bottom.stl` 一个。
- 打印机身中部顶板
使用标准 PLA 和 15% 填充打印 `body_middle_top.stl` 一个。
- 打印机身后部
使用标准 PLA 和 15% 填充打印 `body_back.stl` 一个。
- 打印电池包盖
使用标准 PLA 和 15% 填充打印 `battery_pack_lid.stl` 一个。
- 打印灯泡部件
使用标准 PLA 和 15% 填充打印 `bulb.stl` 一个。
- 打印闪光灯模块
使用标准 PLA 和 15% 填充打印 `flash_light_module.stl` 一个。
- 打印闪光反射器接口
使用标准 PLA 和 15% 填充打印 `flash_reflector_interface.stl` 一个。
- 打印左眼部件
使用标准 PLA 和 15% 填充打印 `left_eye.stl` 一个。
- 打印右眼部件
使用标准 PLA 和 15% 填充打印 `right_eye.stl` 一个。
- 打印扬声器接口
使用标准 PLA 和 15% 填充打印 `speaker_interface.stl` 一个。
- 打印扬声器支架
使用标准 PLA 和 15% 填充打印 `speaker_stand.stl` 一个。
- 打开 Onshape CAD 设计
打开项目的 Onshape CAD 文档。也可参阅 prepare_robot 文档,将 Onshape 设计转换为 MuJoCo 中的仿真机器人,但该文档已过时且长期未更新。
- 遵循打印指南
打开 docs/print_guide.md,并按照其中的打印指南操作。
组装
- 正确使用螺纹胶
电机金属部件之间拧螺丝时,使用少量螺纹胶;不要在塑料螺丝上使用。
- 安装轴承和嵌件
将轴承放入 `trunk_bottom`,并在所示孔位插入 M3 嵌件。
- 安装底部嵌件
在该部件底部再插入 4 个 M3 嵌件,供之后安装机体部件。
- 连接机身上下壳
将 `trunk_bottom` 与 `trunk_top` 合并,并通过所示孔位用 2 颗 `M3x10` 螺丝固定。
- 安装中间电机
按图所示安装中间电机,并使用电机随附的塑料螺丝固定。
- 插入电机底部支架
按图所示插入 `roll_motor_bottom`。
- 组装脚底部件
先将 `foot_bottom_tpu` 与 `foot_bottom_pla` 组合,并在所示孔位插入 M3 嵌件。
- 固定脚底部件
用两颗 `M3x6` 螺丝将这两个脚底部件固定在一起。
- 安装脚背嵌件
在 `foot_top` 的所示孔位插入 M3 嵌件。
- 完成脚部组装
按图所示完成全部组装,并确保电机驱动侧位于 `foot_top` 一侧。
- 安装脚部开关
可以按图所示加入脚部开关,并将其压配到位,使脚接触地面时开关被触发。
- 在小腿垫片两侧插入 M3 螺母
在 `leg_spacer` 两侧的孔中插入 M3 螺母,总共插入 4 个。
- 连接足部电机并穿过右腿板
先将电机线插入足部电机,再让电缆穿过 `right_sheet`。
- 按图组装小腿
按照所示图片完成小腿组装。
- 组装大腿并安装髋俯仰电机
大腿的组装方式基本相同,但 `hip_pitch` 电机必须按图所示方向安装,这对零位很重要。
- 安装右侧髋滚转俯仰连接件
安装 `left_roll_to_pitch` 或 `right_roll_to_pitch`;由于这些部件左右对称,必须使用右侧的。
- 将顶部滚转件装到髋偏航舵机
用螺钉从底部将 `roll_motor_top` 安装到 `hip_yaw` 舵机上,此时不要把舵机安装到躯干。
- 安装髋滚转件
按照所示图片安装 `hip_roll`。
- 插入髋部子组件
按照所示图片插入该子组件。
- 拧紧可固定的螺钉
使用舵机随附的塑料螺钉,将所有能够固定的部分拧紧。
- 将腿部安装到髋部
现在可以按照所示图片将腿部安装到髋部。
- 为颈部钻孔
按照颈部部分的图片进行钻孔。
- 安装头部俯仰偏航连接件
首先按照所示图片安装 `head_pitch_to_yaw`。
- 安装头部偏航和滚转组件
分别将 `head_yaw_to_roll` 和 `head_roll_mount` 安装到 `head_roll dof` 上。
- 插入头部底板和躯干中上板
现在也可以插入 `head_bot_plate` 和 `body_middle_top`,以后就不必拆开头部。
- 检查组装完成的小鸭
此时鸭子应该呈现如图所示的组装状态。
- 安装舵机驱动板
将舵机驱动板安装到机器人上。
- 安装 IMU
最好按照自然方向安装 IMU;与下方图片相比,它需要沿 X 轴翻转。图片中 IMU 是倒装的,但之后可以配置安装方向。
- 查看全局电子原理图
使用全局电子原理图作为接线参考。
- 连接脚部电路
按照脚部接线图连接脚部电路。
- 查看 Pi Zero 引脚映射
使用 Pi Zero 排针的引脚映射表进行接线。
- 准备电池组
为确保安全,将电池放入电池架前,确保所有电池的电压充电至相同水平。
- 安装头部 M3 嵌件
先在图中所有孔位插入 M3 嵌件。
- 安装头部内部组件
然后插入轴承,安装耳朵电机和 Raspberry Pi Zero 2W。
- 组装颈部与头部
按照图示将颈部与头部组装在一起。
- 安装底部中间外壳
首先用螺钉安装 `body_middle_bottom`。
- 安装机身 M3 嵌件
然后在 `body_middle_bottom` 和 `body_middle_top` 中用于安装电池组与 `body_front` 的所有孔位插入 M3 嵌件。
- 安装其余机身与电池组
然后安装 `body_middle_top`、`body_front` 和电池组。
- 完成鸭子机体组装
鸭子机体已完全组装。
- 使用 Open Duck Mini 构建指南
Use the linked Tnkr Open Duck Mini v2 build guide. The document also provides a Chinese build guide.
软件与固件
- 使用 Open Duck Playground 框架
本文使用基于 mujoco playground 的自有框架 Open Duck Playground 进行策略训练。
- 在 joystick 环境中调整奖励与参数
在 joystick 环境中,可以启用/禁用不同的奖励、编写自己的奖励,并调整权重、噪声和随机化等设置。
- 使用 MuJoCo Playground
项目正在切换到 MuJoCo Playground。使用链接的 Open_Duck_Playground 仓库。
- 获取机载计算机运行时
使用 Open_Duck_Mini_Runtime 仓库中的代码,在 Raspberry Pi Zero 2 W 机载计算机上运行策略。
- 设置树莓派与运行时
完成鸭子组装后,按照所链接仓库设置 Raspberry Pi 和运行时软件。
- 安装运行时仓库
克隆并在 v2 分支使用 `pip install -e .` 安装 Open_Duck_Mini_Runtime。可以安装在自己的电脑或 Raspberry Pi 上。
标定与测试
- 配置左髋偏航电机
在构建小鸭之前,对每个电机独立执行配置。使用 ID 20 配置 `left_hip_yaw`;电机会移动到零位,然后安装喇叭并尽量按照照片对齐。
- 配置左髋横滚电机
在构建小鸭之前,对每个电机独立执行配置。使用 ID 21 配置 `left_hip_roll`;电机会移动到零位,然后安装喇叭并尽量按照照片对齐。
- 配置左髋俯仰电机
在构建小鸭之前,对每个电机独立执行配置。使用 ID 22 配置 `left_hip_pitch`;电机会移动到零位,然后安装喇叭并尽量按照照片对齐。
- 配置左膝电机
在构建小鸭之前,对每个电机独立执行配置。使用 ID 23 配置 `left_knee`;电机会移动到零位,然后安装喇叭并尽量按照照片对齐。
- 配置左踝电机
在构建小鸭之前,对每个电机独立执行配置。使用 ID 24 配置 `left_ankle`;电机会移动到零位,然后安装喇叭并尽量按照照片对齐。
- 配置颈部俯仰电机
在构建小鸭之前,对每个电机独立执行配置。使用 ID 30 配置 `neck_pitch`;电机会移动到零位,然后安装喇叭并尽量按照照片对齐。
- 配置头部俯仰电机
在构建小鸭之前,对每个电机独立执行配置。使用 ID 31 配置 `head_pitch`;电机会移动到零位,然后安装喇叭并尽量按照照片对齐。
- 配置头部偏航电机
在构建小鸭之前,对每个电机独立执行配置。使用 ID 32 配置 `head_yaw`;电机会移动到零位,然后安装喇叭并尽量按照照片对齐。
- 配置头部横滚电机
在构建小鸭之前,对每个电机独立执行配置。使用 ID 33 配置 `head_roll`;电机会移动到零位,然后安装喇叭并尽量按照照片对齐。
- 配置右髋偏航电机
在构建小鸭之前,对每个电机独立执行配置。使用 ID 10 配置 `right_hip_yaw`;电机会移动到零位,然后安装喇叭并尽量按照照片对齐。
- 配置右髋横滚电机
在构建小鸭之前,对每个电机独立执行配置。使用 ID 11 配置 `right_hip_roll`;电机会移动到零位,然后安装喇叭并尽量按照照片对齐。
- 配置右髋俯仰电机
在构建小鸭之前,对每个电机独立执行配置。使用 ID 12 配置 `right_hip_pitch`;电机会移动到零位,然后安装喇叭并尽量按照照片对齐。
- 配置右膝电机
在构建小鸭之前,对每个电机独立执行配置。使用 ID 13 配置 `right_knee`;电机会移动到零位,然后安装喇叭并尽量按照照片对齐。
- 配置右踝电机
在构建小鸭之前,对每个电机独立执行配置。使用 ID 14 配置 `right_ankle`;电机会移动到零位,然后安装喇叭并尽量按照照片对齐。
- 使用 BAM 建模电机行为
使用 BAM 对电机的行为进行建模,并直接采用文档提供的辨识结果,而不必重新执行辨识过程。
- 将辨识参数导出为 MuJoCo 单位
使用 bam.to_mujoco 将主要辨识参数导出为 MuJoCo 单位。
- 设置执行器和关节属性
将导出的数值设为 MJCF 模型中执行器和关节的属性:damping、kp、frictionloss、armature 和 forcerange。
- 运行前完成检查清单
运行真机脚本之前,必须先完成运行时仓库 checklist.md 中的所有步骤。
- 先配置电机
组装小鸭之前,先按照配置说明配置电机。
- 识别执行器参数
项目使用 Rhoban 的 BAM 进行执行器识别。使用链接的 BAM 仓库。
采数据与训练
- 查看每个零件的材料
打开链接的 Onshape 文档,查看为机器人每个零件指定的材料。
- 用切片软件估计值覆盖零件质量
由于零件采用填充打印,使用切片软件中相当准确的估计值覆盖各零件的质量。
- 导出 URDF 和 MJCF 描述
使用 onshape-to-robot 导出机器人的 URDF 或 MJCF 描述。
- 创建轻量级 MJX 模型
为 MJX 创建轻量级机器人模型,并使用文档链接的 config.json。
- 设置完整机器人的质量和惯性
在生成的 MJCF 描述中设置完整机器人的质量和转动惯量。
- 实现 Disney 的模仿奖励
按照 Disney 在 BDX 论文中描述的模仿奖励来实现,可以获得良好的训练结果,对应 playground 仓库中 joystick.py 的实现。
- 生成参考运动数据
使用作者制作的 Open_Duck_reference_motion_generator 仓库,通过参数化行走引擎生成参考运动。按该仓库的说明操作即可生成包含参考运动的 polynomial_coefficients.pkl 文件。
- 使用 data 目录中的现成文件
playground 仓库的 data/ 目录下已经提供了这样的 polynomial_coefficients.pkl 文件,可直接使用。
- 训练策略
在 Open Duck Playground 中完成策略训练,训练好的策略可用于真机。
- 运行训练好的步行策略
使用 BEST_WALK_ONNX.onnx 或 BEST_WALK_ONNX_2.onnx,并通过 v2_rl_walk_mujoco.py 运行示例策略。
- 生成模仿学习参考动作
使用 Open_Duck_reference_motion_generator 仓库生成模仿学习所需的参考动作。
用起来
- 在真机上运行训练好的策略
使用运行时仓库中的 v2_rl_walk_mujoco.py 脚本,在真实机器人上运行训练好的策略。
常见问题
物料
- 飞特 STS3215 串口舵机 ×14(须买 7.4V 版,即 19 kg·cm):每条腿髋 yaw/roll/pitch、膝、踝共 5 个,颈与头部 4 个
- 9g 舵机 ×2、Waveshare 总线舵机驱动板
- 树莓派 Zero 2W 与 SD 卡;BNO055 IMU;SS-10 足底触点开关 ×4
- 18650 电芯 ×2(作者用 3000 mAh、30A 放电)、2S BMS、5V 稳压模块、开关、USB‑C 充电器
- M3 热熔螺母、轴承 ×3、线缆护套与 USB 线;PLA 打印件(15% 填充)与 TPU 足底(40% 填充)
- 可选表情套件:扬声器与功放、眼部 LED 与扩散片、投影灯反光罩、麦克风、树莓派摄像头
工具
- 3D 打印机(PLA 与 TPU)
- 烙铁与基础电子工具
- M3 螺丝与乐泰 243 蓝色螺纹胶(金属对金属的舵机螺丝都要点胶)
技能
- 焊接与接线
- 装机前逐个设置舵机 ID 与零位(Python 脚本)
- 树莓派 Linux、SSH 与 Python 虚拟环境
- 进阶:在 MuJoCo Playground 训练策略、用 BAM 辨识舵机参数
软件
- Open_Duck_Mini_Runtime:树莓派上运行 ONNX 步态策略,Xbox 手柄遥控(V2 Classic 发布 2025‑08)
- Open_Duck_Playground:基于 MuJoCo Playground 的强化学习环境,含 MJCF 模型与模仿奖励
- Open_Duck_reference_motion_generator:参数化步态生成参考动作
- Rhoban BAM 辨识的 STS3215 舵机参数;onshape-to-robot 导出 URDF/MJCF