正在连接信源…

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 脚本,在真实机器人上运行训练好的策略。

常见问题

  • 打印件与舵机安装孔错位或发生装配冲突。 #7 #17
  • 装配说明和物料清单遗漏或标错必需硬件。 #1 #3 #9 #14
  • 直接驱动一瓦LED会超出树莓派GPIO引脚的电流能力。 #34
  • 缺少必需的Python模块,导致脚本无法运行。 #12 #39
  • 找不到必需的Duck.iso系统镜像。 #57
  • 更换电机后需要重新调参,否则脚会持续抖动。 #21
  • 舵机总线CRC错误导致机器人无法行走。 #49
  • 提手无法承受抬起机器人的重量。 #30

物料

  • 飞特 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

文档