xgoduck_hardware README

项目的 README,来自 github.com/LuwuDynamics/xgoduck_hardware。合并为一个 markdown 文件:README.md。

Join our Discord

XGO-Duck

English · 简体中文

Board charging and troubleshooting: English · 简体中文.

Build a robot duck. Explore how it moves. Make it your own.

A 3D-printable biped robot built around Arduino UNO Q and 15 serial servos.

Assembly guide · Bill of materials · Runtime · Training

A duck-shaped biped robot performing a somersault in a looping animation

A clean somersault · CyberBionic Maker

Meet XGO-Duck

XGO-Duck is a duck-shaped biped robot adapted by Luwu Dynamics from Pollen Robotics' Microduck. It combines a printable structure, fifteen Feetech 1910 servos, an Arduino UNO Q, and a custom expansion board with an IMU and servo interfaces.

This repository is the hardware starting point: print the parts, prepare the electronics, and assemble the robot. Companion repositories provide the onboard runtime and reinforcement-learning tools, connecting a physical build with motion experiments.

Build Run Experiment
Print the body, legs, neck, head and soft parts. Assemble with the illustrated guide. Configure and calibrate the robot through the companion runtime's browser interface. Study the simulation, train policies and explore your own motions.
Hardware files Onboard runtime RL tools

A closer look

XGO-Duck standing on a workbench, with a white printed body, yellow beak and feet, and exposed leg joints

XGO-Duck prototype — printed parts, articulated legs, and a movable head and beak.

Front view of XGO-Duck with its beak open
A movable head and beak
Four neck/head joints and a separate mouth servo.
Rear prototype view showing the blue expansion board and servo wiring
Electronics you can inspect
Rear-mounted controller stack and accessible wiring.

The photos show project prototypes. Follow the assembly guide and matching board files for your build revision.

Hardware at a glance

Subsystem What it uses Role
Controller Arduino UNO Q Linux host for policy inference and web UI; STM32 MCU for servo and sensor communication
Actuation 15 Feetech 1910 serial servos 10 leg joints, 4 neck/head joints, and 1 mouth joint
Expansion board Luwu UNO Q expansion board Power distribution, servo connections and IMU integration
Motion sensing QMI8658A 6-axis IMU Acceleration and angular-velocity feedback
Structure STL parts Body, leg, neck and head components
Soft parts TPU-designated STL files Foot soles and mouth parts

The motion policy outputs targets for 14 joints; the mouth servo is controlled separately. Component details and purchasing checks are collected in the BOM notes.

How the system connects

flowchart TD
    UI[Browser: setup, calibration and control] <--> HOST[UNO Q Linux: ONNX policy and web UI]
    RL[Training computer: simulation and RL] -->|Export ONNX policy| HOST
    HOST <-->|Arduino Bridge| MCU[UNO Q STM32: servo and IMU loop]
    MCU <-->|Serial bus| SERVOS[15 Feetech 1910 servos]
    IMU[QMI8658A IMU] -->|Sensor feedback| MCU
    BOARD[Custom expansion board] --- SERVOS
    BOARD --- IMU

This is a functional overview; use the board design and assembly documentation for electrical connections.

Start your build

Current board version: V1.1 (2026-10-26). Use the V1.1 design and production files. Previous files and wiring instructions are archived separately.

1. Prepare parts and electronics

Open the bill of materials for the robot purchasing list, supplier links and battery requirements, and PCBA/ for the expansion-board files. The robot BOM and PCB manufacturing BOM serve different purposes: a finished expansion board already includes its board-level components.

Part Quantity
Arduino UNO Q (2 GB / 4 GB) 1
Robot expansion board — Luwu Dynamics Store 1
Feetech 1910 servo with AMP 3-pin cable 15
Battery pack, listed as “18650 battery 8.4V” 1
8.4 V Li-ion battery charger with 5.5 × 2.1 mm DC barrel plug (DC5521) 1
M2 × 6 countersunk, flat-end self-tapping screw 204 (200+4 for roller)
M2.3 × 8 flat-top round-head, flat-end self-tapping screw 6
M3 × 16 round-head machine screw 4
10 × 15 × 3 mm bearing 11 (3+8 for roller)
16 × 22 × 4 mm bearing 11

Quantities include the optional roller skates: 4 additional M2 × 6 screws and 8 additional 10 × 15 × 3 mm bearings. Confirm the pack, charger, connector polarity and power requirements using the component notes before sourcing or powering the build.

The expansion-board store page also offers a separate battery-and-charger option. Select Only Robot Driver Board for Arduino UNO Q for the board above; the bundle has not been verified against the battery and charger specifications in this list. See the purchasing notes.

For easier purchasing, Luwu Dynamics offers an official XGO-Duck electronics kit containing all components in the BOM except the Arduino UNO Q.

Identify the three fasteners before ordering. Items 7 and 8 are self-tapping screws with flat ends. Items 8 and 9 share the same rounded side profile; item 8 has a flat top, while item 9 has the gently domed top shown in the photo below and a machine thread. The following shape guide is illustrative. See the product photo and size references in the BOM.

Shape guide for the M2 by 6 countersunk flat-end self-tapping screw, M2.3 by 8 flat-top round-head flat-end self-tapping screw, and M3 by 16 domed round-head machine screw Reference photo of the intended shallow, gently domed round screw head for item 9 only

Item 9 has the domed top shown here. Item 8 has the same rounded sides but a flat top. The photo is a head-style reference, not a size or thread specification.

2. Print the structure

Complete 3MF print projects

Choose V5 for the audio/video design or V2 for the original design. Each project bundles the model parts, prepared plate layouts, and saved print settings, so you do not need to download and arrange individual STL files.

Robot version Complete print project
V5 — Audio/video design Download V5 3MF
V2 — Original design Download V2 3MF

Open the matching project in Bambu Studio, confirm your printer and PLA/TPU assignments, then slice and print. Both projects save a P1P / 0.4 mm nozzle profile and nine plates. Choose one V1/V1.1 board enclosure; roller-skate parts are optional. These are project files, not pre-sliced G-code.

Plate guide and instructions · 简体中文

Individual STL files

Choose the folder for your kit. Both sets were exported from the corresponding 3MF project, with each part positioned individually on the build plane. The filename prefix identifies the kit even when a file is downloaded separately.

Kit and folder STL files Filename prefix
V2 — Standard kit, without audio/video 47 V2_STANDARD_
V5 — Audio/video kit 50 V5_AUDIO_VIDEO_

Each folder includes English and Chinese instructions. Numbered files such as _01 and _02 already represent separate instances: print each selected file once, without multiplying it again by a retained 2x or 4x label. Parts marked TPU require flexible material. Keep the parts for your chosen version together and select one backpack enclosure for your board revision.

Use the print inventory to track parts. Test a servo mount and bearing fit before printing the full set; a complete validated print profile is still to be documented.

The optional roller-skate parts are already included in each version folder: two numbered tire supports, four tires and four tire axes. Print each of those files once when using that accessory. The structure/ directory contains only the V2_STANDARD_/ and V5_AUDIO_VIDEO_/ sets.

Print orientation reference: slicing preview on the left, recommended placement in the center, and incorrect placement marked with a red cross on the right

Print orientation matters: place the part as shown before slicing — lay it flat with the open channel facing up and the two end tabs resting firmly on the build plate. Use 4 walls and 13% Gyroid infill. Do not stand it upright, lay it on its side, or flip it over, and do not rely on the slicer's auto-arrange. Otherwise the holes may deform and the ends may break. After slicing, check the preview against the reference image before printing.

3. Configure servos and assemble

Prepare each servo's ID and center position using the runtime setup instructions, then follow Assembly_Guide.pdf.

Assembly reference Focus
Page 1 Servo ID placement
Pages 2–5 Shaft preparation, initial structure and cable routing
Pages 6–15 Legs, feet and soles
Pages 16–23 Head and neck mechanisms
Pages 24–25 Final assembly

The build guide adds preparation and inspection checkpoints. Configure one servo at a time, label its ID, and leave cable clearance through each joint's movement.

4. Calibrate and bring it to life

Install the onboard runtime, verify servo and IMU feedback, and complete calibration with the robot supported. Start with the default pose before motion trials.

The runtime includes walk, get-up and pick policies, plus separate mouth control. Their behavior depends on the assembled hardware, calibration and test conditions. Using the bundled policies does not require training a new model.

Hardware files

Path Contents
Assembly_Guide.pdf 25-page illustrated assembly reference
BOM.md Whole-robot purchasing list, supplier links and battery reference image
structure/V2_STANDARD_/ · structure/V5_AUDIO_VIDEO_/ Separate standard and audio/video STL sets, with bilingual guides
V1.1 schematic Altium schematic source
V1.1 BOM · Placement data Board materials and placement coordinates
V1.1 production files Fabrication notes, Gerber and drill files
V1.1 silkscreen layout PDF reference
V1.1 DWG · STEP model Drawing and 3D model
Previous version archive Complete previous files and historical instructions
docs/ Build, printing, BOM and troubleshooting notes

From hardware to your own behavior

Repository Purpose
xgoduck_hardware Mechanical parts, electronics, BOM and assembly
xgoduck_runtime_arduino UNO Q firmware, policy execution, browser setup and control
xgoduck_rl Simulation, reinforcement-learning training and policy export

Keep the hardware, runtime and policy revisions together in your build record. This makes it easier to reproduce a working configuration and diagnose changes.

Origins and contributions

XGO-Duck builds on Microduck and microduck_rl by Pollen Robotics. The duck form, 15-servo arrangement and policy joint order originate in that work. Luwu Dynamics' adaptation focuses on Arduino UNO Q, Feetech 1910 servos, the custom expansion board, and the matching software/model integration. See origins and adaptations.

Build reports, tested print settings, clearer assembly photos and reproducible fixes are welcome. Read CONTRIBUTING.md or open an issue.

For reuse terms, consult LICENSING.md and the applicable file-level notices. Contact: [email protected].

xgoduck_hardware (LuwuDynamics/xgoduck_hardware)

正在搜索数据库…

这是什么?XGO-Duck 是一只可以 3D 打印的双足机器人鸭。本仓库是硬件的起点,包含结构件的 STL 模型、定制扩展板的 PCB/Altium 文件、物料清单,以及带插图的组装指南。
这只鸭子到底该怎么组装?先采购 BOM 中的零件,按照 structure/ 中的文件名和摆放方向规则 3D 打印 STL 模型,然后参照 25 页的 AssemblyGuide.pdf 进行组装,最后通过配套的板载运行时设置舵机 ID 和中位,并进行校准。
我需要采购哪些零件和工具?一块 Arduino UNO Q、Luwu Dynamics 扩展板、15 个 Feetech 1910 串行舵机、一套 8.4V 锂离子电池组及充电器、各类螺丝和轴承,以及一台 3D 打印机。Luwu 销售一套电子元件套件,涵盖除 UNO Q 本身以外的所有电子部件。
组装过程中有哪些需要注意的坑?早期批次的扩展板 PCB 上,三个接口的 GND 和 SIGNAL 接反了,使用旧板的用户需要按照专门的旧板接线修正方法操作;零件的打印方向至关重要,否则孔位会变形;目前还没有经过完整验证的打印切片配置文档。
控制运动的软件在哪里?不在本仓库中。策略执行和基于浏览器的设置界面位于配套仓库 'xgoduckruntimearduino' 中,仿真和强化学习训练工具位于 'xgoduckrl' 中。本仓库只涵盖实体硬件。
Microduck 是什么?XGO-Duck 是 Luwu Dynamics 基于 Pollen Robotics 开源项目 Microduck 改编的版本,沿用了其鸭子外形、15 个舵机的布局和策略关节顺序,同时换用了 Arduino UNO Q 和 Feetech 1910 舵机。
要让它走路,我需要自己训练 AI 模型吗?不需要。配套运行时自带现成的行走、起身、抓取和嘴部控制策略,因此使用内置动作无需自己训练任何模型。
板子上的惯性测量单元(IMU)有什么用?扩展板上的 QMI8658A 6 轴 IMU 提供加速度和角速度反馈,用于平衡和运动控制。
大小
146.6 MB
星标
2K
更新
提交Nov 13
时长
1个月
提交 · 90 天