Connecting to sources…

How to build XGO-Duck: the whole process

88 steps to build XGO-Duck, from buying parts, printing and assembly to software, calibration and training, with the bill of materials, shop links and the official sourc…

XGO-Duck is a printable duck-shaped biped robot using Arduino UNO Q and 15 servos. This hardware repository provides mechanical models, expansion-board files, a bill of materials, printing guidance, and an assembly guide.

Bill of materials · Parts list

PartQtyANYCN
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

Bill of materials · Robot purchasing list

PartQty
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

Buy parts

  • Purchase purchasing-list items 1–11

    Purchase robot purchasing-list items 1–11. Quantities are purchasing quantities rather than a verified installed-fastener count; the optional roller skates include 4 additional M2 × 6 screws and 8 additional 10 × 15 × 3 mm bearings.

  • Plan separately for tools and consumables

    Account separately for a USB data cable, assembly tools, filament, and adhesive when planning the build. These are not separate entries in the robot purchasing list.

  • Choose the expansion-board purchasing method

    Use the V1.1 PCBA BOM when manufacturing the expansion board. When buying a finished board, do not count the PCBA components again.

  • Select an official Arduino Uno Q

    Use an official Arduino Uno Q rather than treating another UNO-family board as interchangeable. The board uses a Qualcomm QRB2210 and STM32U585, and the project confirms both 2 GB and 4 GB RAM variants.

  • Purchase the specified servo

    Purchase or identify the Feetech HD-1910-C001, edition A/0; do not treat the HLS1910 simulation model name as another purchasing SKU.

  • Select a compatible servo supply

    Use a supply within the 4–8.4 V working range. Read torque and current values for each typical voltage separately, and do not size the whole-robot supply from one servo’s no-load current.

  • Source the V1.1 expansion board

    Use the current V1.1 expansion board together with its schematic, BOM, and production files.

  • Check archived board dimensions

    The archived pre-V1.1 PCB envelope is 68.55 × 53.38 mm; these dimensions and the component table have not been revalidated for V1.1.

  • Select fasteners and bearings

    Select parts using the purchasing-table dimensions; do not infer a bearing series from dimensions alone, and account for seals and flanges affecting fit and friction.

  • Distinguish screw items 8 and 9

    Items 8 and 9 share a rounded side profile, but item 8 has a flat top while item 9 has the gently domed top shown in the photo; the photo does not establish item 9's size or thread.

  • Source item 8 self-tapping screws

    Whole-robot BOM item 8 is six M2.3 × 8 flat-top round-head, flat-end self-tapping screws.

  • Check servo output-shaft screws

    The servo supplier sheet specifies an M2.5 × 6 output-shaft screw.

  • Confirm Battery Pack, Charger, and Polarity

    Use the battery specification notes to confirm the exact pack configuration, compatible charger, and polarity.

  • Obtain Printed Parts and Inventory

    Obtain the printed parts from structure/ and check them against the separate printing inventory in docs/PRINTING.md.

  • Obtain Expansion Board Components

    Use the components listed in PCBA/BOM/ArduinoUnoQV1.1.xlsx to make the expansion board.

  • Choose a Finished Expansion Board

    When using a finished expansion board, the components needed to make it are already included.

Print and make

  • Choose a Pre-Arranged 3MF Project

    Use the V5 audio/video or V2 original downloads and follow the plate guide. Choose the project that matches the robot version being built.

  • Confirm and Slice the Project

    Open the matching project in Bambu Studio. Confirm the printer and filaments, then slice the project before printing.

  • Select the Matching STL Set

    Use the STL set corresponding to the kit and the matching version folder and guide for the complete file inventory. Do not mix parts across robot versions.

  • Print Each Numbered STL Once

    Print each selected numbered file once because the numbered files already represent separate instances. Do not multiply the quantity again when a filename retains a `2x` or `4x` label.

  • Choose One Backpack Enclosure

    Select one alternative backpack enclosure for the V1 or V1.1 board using the plate guide. The selected enclosure must match the robot version being built.

  • Print the Optional Roller Skates

    If building the optional roller skates, print each numbered roller-skate file once from the chosen version. These files are already included in the version's STL count.

  • Add Skate Screws and Bearings

    The roller skates require 4 additional M2 × 6 countersunk, flat-end self-tapping screws and 8 additional 10 × 15 × 3 mm bearings. These quantities are already included in the BOM totals.

  • Confirm Roller Skate Print Profile

    Confirm the material and slicing profile for the optional roller-skate parts before printing them.

  • Test Print Critical Fits

    Before the full print, check one servo mount and one bearing seat. Inspect left/right orientation and verify cable clearance before continuing.

  • Choose a complete 3MF project

    Each project bundles the model parts, prepared plate layouts, and saved print settings, so individual STL files are not needed. Choose V5 for audio/video or V2 for the original design.

  • Open, slice, and print in Bambu Studio

    Open the matching project in Bambu Studio, confirm the printer and PLA/TPU assignments, then slice and print. Both projects save a P1P / 0.4 mm nozzle profile and nine plates; they are project files, not pre-sliced G-code.

  • Select the enclosure and optional parts

    Select one V1/V1.1 board enclosure. The roller-skate parts are optional.

  • Choose the kit STL folder

    Choose the folder for your kit; each folder includes English and Chinese instructions, and the filename prefix identifies the kit. Keep the parts for the selected version together and select one backpack enclosure for the board revision.

  • Print each selected STL once

    Print each selected numbered file once; prefixes such as `_01` and `_02` already represent separate instances, so do not multiply the count because of a retained `2x` or `4x` label. Parts marked TPU require flexible material.

  • Print optional roller-skate parts

    Each version folder already includes two numbered tire supports, four tires, and four tire axes. Print each of those files once when using the roller-skate accessory.

  • Set the correct print orientation

    Lay the part flat with the open channel facing up and both end tabs firmly on the build plate. Use 4 walls and 13% Gyroid infill; do not stand it upright, lay it on its side, flip it over, or rely on auto-arrange, and check the sliced preview against the reference before printing.

  • Choose and print the matching enclosure

    Use the V5 audio/video enclosure for the V5 structure or the V2 enclosure for the original V2 structure; enclosure labels V1 and V1.1 refer to PCB revisions. Consult the printing inventory for individual parts and the assembly guide for assembly.

  • Choose Settings After Fit Test

    Choose print settings only after validating fit on a representative bearing or servo interface.

Assemble

  • Use the Assembly PDF

    Use this guide with the 25-page assembly PDF. The PDF photographs determine orientations and cable routing.

  • Connect One Servo at a Time

    Connect only one servo at a time.

  • Label Every Servo

    Label each servo.

  • Follow the assembly drawings

    Before closing each section, check that the harness cannot be pinched and has slack through the intended movement. Compare mirrored parts to the photos; do not assume left and right mountings are identical. Do not force printed bearing seats or infer tightening torque from screw size.

  • Check harness clearance and slack

    Before closing each section, check that the harness cannot be pinched and has slack through the intended movement.

  • Compare mirrored parts

    Compare mirrored parts to the photos; do not assume left and right mountings are identical.

  • Avoid forcing bearing seats

    Do not force printed bearing seats or infer tightening torque from screw size.

  • Separate power and servo interfaces

    Treat the board power-input specifications and expansion-board battery path as separate interfaces. The servo’s 8.4 V maximum is not a recommended voltage for a logic or USB power pin.

  • Identify pins from connector view

    Identify all three pins using the supplier’s connector view. All three conductors are described as black, so do not determine polarity by wire color or infer left/right orientation from the table.

  • Inspect the servo kit before assembly

    Inspect the actual servo kit and assembly first; the available documents do not establish whether output-shaft screws are included or how many are installed.

  • Confirm Battery Connector and Polarity

    Check the white battery connector with red and black wires against the actual board, then confirm the mating connector and polarity before connecting. The image alone does not define a pinout.

  • Install Using the Assembly Guide

    Perform the mechanical and electrical installation by following Assembly_Guide.pdf.

  • Configure and inspect the servos

    Configure one servo at a time, label its ID, and leave enough cable clearance for movement through each joint.

Software

  • Apply XGO-Duck runtime settings

    Use the table values as XGO-Duck software settings rather than additional purchase specifications. Configure them using the linked runtime setup instructions.

  • Deploy Runtime on Uno Q

    Deploy the runtime on Uno Q before configuring the servos.

  • Install the onboard runtime

    Install the onboard runtime from the linked repository before calibrating the robot.

Calibrate and test

  • Record Build Revisions

    Record the hardware, runtime and RL revisions being used.

  • Inventory Parts and Actuator

    Inventory the BOM, identify every printed part and check the actuator model.

  • Confirm Power Details First

    Before powering the board, obtain the battery or power details from BOM.md.

  • Prepare Tools and Support

    Keep a multimeter, appropriate screwdrivers, cable labels and a stable robot support available.

  • Inspect the Expansion Board

    Inspect the assembled expansion board against the files for its revision, including component orientation and shorts.

  • Use Older Board Archive

    For older boards, use the pre-V1.1 archive.

  • Configure Servo IDs and Center

    In Servo setup, assign unique IDs 10–14, 20–24 and 30–34, center at raw 2047, then write the stored gains according to the runtime guide.

  • Allow Shared Writes for Duplicate IDs

    Servos with duplicate IDs can receive the same write.

  • Confirm all servo IDs

    Confirm that all 15 unique IDs answer; the mouth is ID 34.

  • Inspect mechanics and cables

    Verify that the mechanical assembly matches the PDF and that cables clear the joints.

  • Confirm polarity and supply limits

    Confirm polarity and supply limits using the matched hardware revision.

  • Support robot and clear joints

    Support the robot with joints clear of hands and obstructions.

  • Check MCU and IMU status

    Confirm that the runtime reports fresh MCU feedback and a working IMU.

  • Use runtime calibration

    Use the runtime calibration procedure.

  • Expect servo movement during calibration

    Starting calibration commands the servos to raw 2047 and can move them.

  • Do not substitute factory zeros

    Factory zero values are a reference from another assembly, not a substitute for calibrating your robot.

  • Obtain mechanical-zero photos

    A per-joint mechanical-zero photo set is still needed for unambiguous first-time reproduction; obtain it before completing zero calibration.

  • Privately back up zero file

    Privately back up `data/zero_pos.json`.

  • Track parts and test fits

    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.

  • Verify servo and IMU feedback

    Check that servo and IMU feedback is available before calibration.

  • Calibrate the supported robot

    Complete the calibration while the robot is supported.

  • Begin with the default pose

    Start the robot in its default pose before conducting motion trials.

  • Record RAM variant and board SKU

    Record the RAM variant and board SKU of the selected Uno Q in the build report. The document makes no claim about comparative performance between variants.

  • Keep the existing servo calibration

    Do not change the calibration solely because the supplier’s neutral label differs by one count.

  • Confirm expansion-board release validation

    Before installation, confirm that release documentation covers layer stack, thickness, trace/load limits, battery polarity, and a board bring-up record.

  • Check feedback and calibrate safely

    Check the servo and IMU feedback, and complete calibration while supporting the robot.

  • Test the default posture

    After calibration, test the robot's default posture before attempting motion.

  • Record Settings and Fit Results

    Record the print settings and report the fit results together with the relevant part filename. A slicer project from a different revision is not a verified profile for these STLs.

Data and training

  • Test motion in stages

    Start with inference only, then a supported default-pose test, then low-command walking on a clear level surface.

  • Test torque-off behavior first

    Check torque-off behavior before testing pick or recovery.

  • Use support with torque off

    A torque-off robot can collapse; use a support.

  • Stop and diagnose abnormalities

    Stop on unexpected direction, binding, heat or unstable feedback and diagnose before retrying.

  • Record your build details

    Record the printer, material and profile, board revision, servo supplier and firmware, power pack, three repository commits, policy hashes, calibration date and motion-test observations.

  • Test walking and standing strategies

    Run the built-in walking and standing-up strategies; no model retraining is needed.

  • Test grasping and mouth control

    Run the built-in grasping strategy and test the separate mouth control.

Use it

  • Run the bundled motion policies

    Use the bundled walk, get-up, and pick policies after assembly and calibration. Mouth control is provided separately, and the policies do not require training a new model.

  • Record the matched revisions

    Keep the hardware, runtime, and policy revisions together in the build record to reproduce the configuration and diagnose changes.

  • Use the included strategies

    Use the included strategies without retraining the models; actual performance depends on assembly, calibration, and test conditions.

Common problems

  • Scarce alternative servos require compatibility checks and possible retraining #17 #1 #13
  • Schematic and BOM reference parts absent from PCB layout #2
  • Required batteries are hard to source and may damage electronics #5
  • Fabricator lacks the specified infrared LED package #6
  • Print file omits the required two-copy filename prefix #8
  • Uno Q header arrangement complicates expansion-board compatibility #9
  • Servo setup fails with no MCU feedback #12
  • Default pose and servo-zero references are missing #11

Documents