XGO-Duck 复刻全流程
XGO-Duck 从采购、打印、组装到装软件、标定和训练的 88 个步骤,附物料表、购买链接与官方出处。
XGO-Duck 是一款采用 Arduino UNO Q 和 15 个舵机的可打印双足机器人鸭。该仓库提供机械结构模型、扩展板设计、物料清单、打印指南和装配指南。
物料 · Parts list
| 零件 | 数量 | ANY | CN |
|---|---|---|---|
| Arduino UNO Q (2 GB / 4 GB) | 1 | ||
| Robot expansion board | 1 | ||
| AMP 3-pin cable | 15 | ||
| Feetech 1910 servo | 15 | ||
| 18650 battery pack, 8.4 V | 1 | ||
| 8.4 V Li-ion battery charger | 1 | ||
| M2 × 6 countersunk, flat-end self-tapping screw | 204 (200+4 for rolle | ||
| M2.3 × 8 flat-top round-head, flat-end self-tapping screw | 6 | ||
| M3 × 16 round-head machine screw | 4 | ||
| Bearing, 10 × 15 × 3 mm | 10 (2+8 for roller) | ||
| Bearing, 16 × 22 × 4 mm | 11 |
物料 · 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; re | 1 |
| XGO-Duck expansion board · Drawing envelope 68.55 × 53.38 mm; QMI8658A IMU; servo/power interfaces · Use the matching Luwu board revision; thickness and fabrica | 1 |
| 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 matc | 15 |
| 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 s | 15 |
| Battery pack · Original BOM: “18650 battery 8.4V”; capacity >2,500 mAh; discharge rating >3C; XH2.54 connector · Pack model, chemistry, nominal voltage, cell ar | 1 |
| 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 compa | 1 |
| 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 thread | 6 |
| 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 number | 10 (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 number | 11 |
采购
- 购买采购清单第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 的已验证打印配置。
采数据与训练
- 分阶段测试运动
先只运行推理,然后进行有支撑的默认姿态测试,最后在清晰平整的地面上进行低指令行走测试。
- 先测试断矩行为
在测试拾取或恢复之前,先检查关闭扭矩时的行为。
- 关闭扭矩时使用支撑
关闭扭矩后的机器人可能会倒下,因此要使用支撑。
- 异常时停止并诊断
出现意外方向、卡滞、发热或反馈不稳定时停止测试,先诊断再重试。
- 记录本次构建信息
记录打印机、材料和配置文件、板卡版本、舵机供应商与固件、电源包、三个仓库提交、策略哈希、校准日期以及运动测试观察结果。
- 测试行走和起身策略
运行内置的行走和起身策略,无需重新训练模型。
- 测试抓取和嘴部控制
运行内置的抓取策略,并测试独立的嘴部控制。
用起来
- 运行内置运动策略
组装和校准完成后使用内置的行走、起身和拾取策略。嘴部控制单独提供,这些策略无需训练新模型。
- 记录配套的版本
在构建记录中将硬件、运行时和策略版本保存在一起,以复现配置并诊断变化。
- 使用附带策略
使用附带策略,无需重新训练模型;实际表现取决于装配、校准和测试条件。