正在连接信源…

XGO-Duck 复刻全流程

XGO-Duck 从采购、打印、组装到装软件、标定和训练的 88 个步骤,附物料表、购买链接与官方出处。

XGO-Duck 是一款采用 Arduino UNO Q 和 15 个舵机的可打印双足机器人鸭。该仓库提供机械结构模型、扩展板设计、物料清单、打印指南和装配指南。

物料 · Parts list

零件数量ANYCN
Arduino UNO Q (2 GB / 4 GB)1
Robot expansion board1
AMP 3-pin cable15
Feetech 1910 servo15
18650 battery pack, 8.4 V1
8.4 V Li-ion battery charger1
M2 × 6 countersunk, flat-end self-tapping screw204 (200+4 for rolle
M2.3 × 8 flat-top round-head, flat-end self-tapping screw6
M3 × 16 round-head machine screw4
Bearing, 10 × 15 × 3 mm10 (2+8 for roller)
Bearing, 16 × 22 × 4 mm11

物料 · Robot purchasing list

零件数量
Arduino Uno Q (2 GB / 4 GB) · Qualcomm QRB2210 Linux host + STM32U585 MCU; Arduino App environment · 2 GB and 4 GB variants both confirmed by the maintainer; re1
XGO-Duck expansion board · Drawing envelope 68.55 × 53.38 mm; QMI8658A IMU; servo/power interfaces · Use the matching Luwu board revision; thickness and fabrica1
Feetech 1910 serial servo · Confirmed model: HD-1910-C001 / HD1910M; 34 × 20 × 23 mm; 21 ± 2 g; 4–8.4 V · Maintainer confirms this supplier model; preserve matc15
Servo cable · Supplier reference: AMP2.0-3P, 3 positions, 2.0 mm pitch; PVC; 150 ± 5 mm · Verify mating housing, pin orientation and wiring; wire gauge is not s15
Battery pack · Original BOM: “18650 battery 8.4V”; capacity >2,500 mAh; discharge rating >3C; XH2.54 connector · Pack model, chemistry, nominal voltage, cell ar1
8.4 V Li-ion battery charger · 5.5 × 2.1 mm DC barrel plug (DC5521), as listed in the robot BOM · Confirm charger model, charge current, plug polarity and compa1
M2 × 6 countersunk, flat-end self-tapping screws · 2 mm nominal diameter × 6 mm length; countersunk head; flat end; self-tapping thread · Maintainer correction;204 (200+4 for rolle
M2.3 × 8 flat-top round-head, flat-end self-tapping screws · 2.3 mm nominal diameter × 8 mm length; circular head with a flat top; flat end; self-tapping thread6
M3 × 16 round-head machine screws · 3 mm nominal thread diameter × 16 mm length; round head; machine thread · Maintainer correction; drive, pitch, material and 4
Bearing, 10 × 15 × 3 mm · 10 mm bore × 15 mm outside diameter × 3 mm width · Confirm shield/seal, flange, clearance and supplier part number10 (2+8 for roller)
Bearing, 16 × 22 × 4 mm · 16 mm bore × 22 mm outside diameter × 4 mm width · Confirm shield/seal, flange, clearance and supplier part number11

采购

  • 购买采购清单第1–11项

    按机器人采购清单第1–11项购买。数量是采购数量,不是已验证的安装紧固件数量;可选轮滑配置包括4个额外的M2 × 6螺钉和8个额外的10 × 15 × 3 mm轴承。

  • 另行规划工具和耗材

    在规划组装时另行考虑USB数据线、组装工具、打印耗材和胶粘剂。这些项目不是机器人采购清单中的独立条目。

  • 选择扩展板采购方式

    制造V1.1扩展板时,使用V1.1 PCBA BOM。购买成品扩展板时,不要再次计算这些元件。

  • 选用官方Arduino Uno Q

    使用官方Arduino Uno Q,不要把其他UNO系列开发板视为可互换替代品。该板采用Qualcomm QRB2210和STM32U585,项目确认支持2 GB与4 GB内存变体。

  • 采购指定的舵机型号

    采购或确认 Feetech HD-1910-C001(A/0 版),不要将仿真模型中的 HLS1910 名称当作其他购买 SKU。

  • 选择兼容的舵机电源

    使用工作电压范围为 4–8.4 V 的电源。典型电压下的扭矩和电流数据应分开查看,且不要根据单个舵机的空载电流确定整机电源规格。

  • 采购 V1.1 扩展板

    使用当前 V1.1 扩展板,并同时取得其原理图、BOM 和生产文件。

  • 核对归档板外形尺寸

    归档的 pre-V1.1 PCB 外形尺寸为 68.55 × 53.38 mm;这些尺寸及元件表未针对 V1.1 重新验证。

  • 按采购表选择紧固件和轴承

    按照采购表中的尺寸选择零件;不要仅凭尺寸推定轴承系列代码,并考虑密封件、凸缘对配合和摩擦的影响。

  • 区分八号和九号螺钉

    八号和九号螺钉侧面轮廓相同,但八号为平顶,九号为照片所显示的微弧顶。照片不能确定九号螺钉的尺寸或螺纹。

  • 采购八号自攻螺钉

    整机 BOM 八号件为六枚 M2.3 × 8 平顶圆头、平尾自攻螺钉。

  • 核对舵机输出轴螺钉

    舵机供应商资料指定使用 M2.5 × 6 输出轴螺钉。

  • 确认电池配置、充电器和极性

    根据电池规格说明,确认电池组的精确配置、兼容充电器和极性。

  • 获取打印件和打印清单

    从 structure/ 获取打印件,并使用 docs/PRINTING.md 中的独立打印清单核对打印件。

  • 获取扩展板制造元件

    使用 PCBA/BOM/ArduinoUnoQV1.1.xlsx 中列出的元件制造扩展板。

  • 选择已包含元件的成品板

    如果使用成品扩展板,其中已经包含制造扩展板所需的元件。

打印与加工

  • 选择预排版 3MF 项目

    使用 V5 音视频版或 V2 原版下载文件,并按照底板指南操作。选择与正在搭建的机器人版本匹配的项目。

  • 确认并切片项目

    在 Bambu Studio 中打开匹配的项目。确认打印机和耗材,然后在打印前完成切片。

  • 选择匹配的 STL 文件组

    使用与套件对应的 STL 文件组,并按照匹配的版本文件夹和指南查看完整文件清单。不要混用不同机器人版本的零件。

  • 每个编号 STL 只打印一次

    每个选定的编号文件只打印一次,因为编号文件已经代表独立实例。文件名中保留 `2x` 或 `4x` 标签时,不要再次增加打印数量。

  • 选择一个背包外壳

    按照底板指南,为 V1 或 V1.1 控制板选择一个备选背包外壳。所选外壳必须与正在搭建的机器人版本匹配。

  • 打印可选轮滑组件

    如果搭建可选轮滑组件,从所选版本中每个编号轮滑文件只打印一次。这些文件已经包含在该版本的 STL 数量中。

  • 添加轮滑螺钉和轴承

    轮滑组件需要额外使用 4 个 M2 × 6 沉头平端自攻螺钉和 8 个额外的 10 × 15 × 3 mm 轴承。这些数量已经计入 BOM 总数。

  • 确认轮滑零件打印配置

    打印可选轮滑零件前,确认其材料和切片配置。

  • 试打印关键配合部位

    完整打印前,先检查一个舵机安装座和一个轴承座。检查左右方向,并确认线缆间隙后再继续。

  • 选择完整的 3MF 项目

    每个项目都包含模型零件、已准备的打印板布局和保存的打印设置,因此无需单独下载 STL 文件。音视频设计选择 V5,原始设计选择 V2。

  • 在 Bambu Studio 中切片并打印

    在 Bambu Studio 中打开对应项目,确认打印机以及 PLA/TPU 材料分配,然后切片并打印。两个项目都保存了 P1P / 0.4 mm 喷嘴配置和九个打印板;它们是项目文件,不是已切片的 G-code。

  • 选择外壳和可选零件

    选择一个 V1/V1.1 板壳。轮滑鞋零件为可选件。

  • 选择套件 STL 文件夹

    选择套件对应的文件夹;每个文件夹都包含英文和中文说明,文件名前缀用于标识套件。将所选版本的零件放在一起,并为对应的板卡版本选择一个背包外壳。

  • 每个选中的 STL 只打印一次

    每个选中的编号文件只打印一次;`_01`、`_02` 等前缀已经代表独立实例,因此不要因保留的 `2x` 或 `4x` 标签而增加数量。标有 TPU 的零件需要使用柔性材料。

  • 打印可选轮滑鞋零件

    每个版本文件夹已经包含两个编号轮胎支架、四个轮胎和四个轮胎轴。使用轮滑鞋附件时,将这些文件各打印一次。

  • 设置正确的打印方向

    将零件平放,使开放通道朝上,并让两个端部标签稳固接触打印平台。使用 4 层壁和 13% Gyroid 填充;不要直立、侧放或翻转零件,也不要依赖自动排布,打印前应将切片预览与参考图进行比较。

  • 选择并打印匹配的底板

    音频/视频结构使用 V5 底板,原始 V2 结构使用 V2 底板;底板标签中的 V1 和 V1.1 表示 PCB 修订版本。查看打印清单以了解各个零件,并参阅装配指南进行装配。

  • 验证配合后选择打印参数

    只有在代表性的轴承或舵机接口上验证配合后,才选择打印设置。

组装

  • 配合装配 PDF 使用指南

    与25页装配PDF一起使用本指南。PDF中的照片用于确定方向和线缆走向。

  • 每次连接一个舵机

    每次只连接一个舵机。

  • 标记每个舵机

    为每个舵机贴上标签。

  • 按照装配图完成组装

    在关闭每个部分前,确认线束不会被夹压,并在预期运动范围内留有松弛余量。将镜像零件与照片对比,不要假设左右安装完全相同。

  • 检查线束与运动余量

    关闭每个部分前,检查线束不会被夹压,并在预期运动范围内保持松弛。

  • 核对镜像零件

    将镜像零件与照片进行比较,不要假设左右安装完全相同。

  • 避免损坏轴承座

    不要强行安装印刷的轴承座,也不要根据螺钉尺寸推断拧紧扭矩。

  • 区分电源与舵机供电接口

    将开发板电源输入规格与扩展板电池路径视为独立接口。舵机的8.4 V最大值不是对逻辑电源引脚或USB电源引脚的推荐电压。

  • 按连接器视图识别引脚

    根据供应商的连接器视图识别三个引脚。三根导线均描述为黑色,因此不要用线色判断极性,也不要从表格推断左右方向。

  • 安装前检查舵机套件

    先检查实际舵机套件和装配状态;现有资料无法确定输出轴螺钉是否随舵机附带或已安装数量。

  • 连接前核对电池插头与极性

    将白色、红线和黑线电池插头与实际电路板核对,确认配对插头和极性后再连接。图片本身未定义针脚排列。

  • 按照装配指南安装

    按照 Assembly_Guide.pdf 的说明进行机械和电气安装。

  • 配置并检查舵机

    一次配置一个舵机并标记其 ID,同时为每个关节的完整运动留出线缆间隙。

软件与固件

  • 应用 XGO-Duck 运行时设置

    将表格中的数值作为 XGO-Duck 软件设置使用,而不是额外的购买规格。按照文档链接的运行时设置说明进行配置。

  • 在Uno Q部署运行时

    配置舵机前,在Uno Q上部署运行时。

  • 安装机载运行时

    校准机器人前,先从链接的仓库安装机载运行时。

标定与测试

  • 记录硬件和软件版本

    记录所使用的硬件、运行时和强化学习版本。

  • 核对物料与执行器

    清点BOM,识别所有打印件并检查执行器型号。

  • 通电前确认供电信息

    给板卡通电前,从BOM.md获取电池或供电信息。

  • 准备检查工具与支撑

    准备万用表、合适的螺丝刀、线缆标签和稳定的机器人支撑。

  • 检查扩展板元件与短路

    根据对应版本的资料检查已装配的扩展板,包括元件方向和短路情况。

  • 使用旧版板卡归档资料

    对于较旧的板卡,使用pre-V1.1归档。

  • 设置舵机ID和中心值

    在Servo setup中分配唯一ID 10–14、20–24和30–34,将中心设为raw 2047,再按照运行时指南写入存储的增益。

  • 允许重复ID接收相同写入

    具有重复ID的舵机可以接收相同的写入。

  • 确认全部舵机 ID

    确认所有15个唯一 ID 都有响应,其中嘴部为 ID 34。

  • 检查机械装配与线缆

    确认机械装配与 PDF 一致,并且线缆避开关节。

  • 确认极性与供电限制

    根据匹配的硬件版本确认极性和供电限制。

  • 支撑机器人并清空关节

    支撑机器人,使关节避开手和障碍物。

  • 确认 MCU 与 IMU 状态

    确认运行时报告了最新的 MCU 反馈,并且 IMU 工作正常。

  • 执行运行时校准流程

    使用运行时校准流程。

  • 注意校准会移动舵机

    开始校准时,舵机会被命令移动到原始值 2047,因此可能产生运动。

  • 不要用出厂零点替代校准

    出厂零点值只是来自另一台装配机器的参考,不能替代对本机器人进行校准。

  • 获取关节机械零点照片

    首次复现仍需要每个关节的机械零点照片集;在完成零点校准前获取该照片集。

  • 私下备份零点文件

    私下备份 `data/zero_pos.json`。

  • 跟踪零件并测试配合

    使用打印清单跟踪零件。在打印整套零件之前测试舵机安装座和轴承的配合;完整的经验证打印配置仍待记录。

  • 验证舵机和 IMU 反馈

    在校准前检查舵机和 IMU 反馈是否正常。

  • 在支撑状态下校准机器人

    在机器人受到支撑的情况下完成校准。

  • 从默认姿态开始

    进行运动测试前,先让机器人处于默认姿态。

  • 记录内存变体和板卡SKU

    在构建报告中记录所选Uno Q的RAM变体和板卡SKU。文档未声称不同变体之间存在性能比较结果。

  • 保留现有舵机校准

    不要仅因供应商中性点标签相差一个计数而更改校准。

  • 确认扩展板发布验证资料

    安装前确认发布资料涵盖叠层、板厚、载流限制、电池极性和板上电检查记录。

  • 检查反馈并安全校准

    检查舵机和 IMU 反馈,并在支撑住机器人的状态下完成校准。

  • 测试默认姿态

    校准完成后,先测试机器人的默认姿态,再尝试运动。

  • 记录参数和配合结果

    记录打印参数,并结合相应零件文件名报告配合结果。不同修订版本的切片项目不能视为这些 STL 的已验证打印配置。

采数据与训练

  • 分阶段测试运动

    先只运行推理,然后进行有支撑的默认姿态测试,最后在清晰平整的地面上进行低指令行走测试。

  • 先测试断矩行为

    在测试拾取或恢复之前,先检查关闭扭矩时的行为。

  • 关闭扭矩时使用支撑

    关闭扭矩后的机器人可能会倒下,因此要使用支撑。

  • 异常时停止并诊断

    出现意外方向、卡滞、发热或反馈不稳定时停止测试,先诊断再重试。

  • 记录本次构建信息

    记录打印机、材料和配置文件、板卡版本、舵机供应商与固件、电源包、三个仓库提交、策略哈希、校准日期以及运动测试观察结果。

  • 测试行走和起身策略

    运行内置的行走和起身策略,无需重新训练模型。

  • 测试抓取和嘴部控制

    运行内置的抓取策略,并测试独立的嘴部控制。

用起来

  • 运行内置运动策略

    组装和校准完成后使用内置的行走、起身和拾取策略。嘴部控制单独提供,这些策略无需训练新模型。

  • 记录配套的版本

    在构建记录中将硬件、运行时和策略版本保存在一起,以复现配置并诊断变化。

  • 使用附带策略

    使用附带策略,无需重新训练模型;实际表现取决于装配、校准和测试条件。

常见问题

  • 替代舵机稀缺,可能需兼容性检查和重新训练 #17 #1 #13
  • 原理图和BOM中的元件未出现在PCB布局中 #2
  • 指定电池难采购,且可能损坏主板 #5
  • PCB厂商不提供指定的红外LED封装 #6
  • 打印文件缺少需打印两份文件名前缀 #8
  • Uno Q排针布局限制扩展板兼容性 #9
  • 舵机设置失败,提示无MCU反馈 #12
  • 缺少默认姿态和舵机零位参考 #11

文档