Q8bot 迷你四足机器人 复刻全流程
Q8bot 迷你四足机器人 从采购、打印、组装到装软件、标定和训练的 84 个步骤,附物料表、购买链接与官方出处。
不出售整机或套件;作者 BOM 估算(美国采购,表中另列含税运估价):自备 3D 打印机并自己回流焊 311.55 美元(337.29 美元),改外包 MJF 打印 333.62 美元(365.88 美元),再外包 PCB 贴片 404.13 美元(435.68 美元,贴片费按 100 美元估);其中 8 个 DYNAMIXEL XL330 共 219.92 美元。不含工具、锂电充电器与可选的 U2D2。README 称 BOM 未优化,约 300–400 美元
采购
- 查看完整物料清单
打开完整的Q8bot物料清单;文中的链接和价格主要适用于美国境内购买。
- 准备所需工具
准备PH-0或JIS-1螺丝刀、焊笔及基本耗材、可运行VS Code的现代笔记本电脑、USB Type-A转Type-C或Type-C转Type-C数据线,以及美纹纸或类似物品。
- 购买八个电机
购买8个DYNAMIXEL XL330-M077-T电机;每个电机附带一组用于组装Q8bot的M2自攻螺丝。
- 购买十二个轴承
购买12个692ZZ轴承,尺寸为2mm × 6mm × 3mm;尺寸相同的其他轴承也可使用。
- 购买两块电池
购买2块14500 KeepPower 1000mAh P1450C2电池用于运行机器人,也可购买更多成对电池进行热插拔;普通AA电池不可用。
- 准备锂电池充电器
如果尚未拥有充电器,请购买锂离子电池充电器;BOM的“Recommended Tools”下提供了一个示例。
- 向在线供应商订购 MJF 零件
将 `hw-vx.x/CAD/Q8_VX.X_MJF` 下的 STL 文件上传到供应商网站,并配置材料和数量。
- 购买锂电池充电器
如果没有充电器,可以购买文档链接的 Li-ion 电池充电器。
- 制作可选的 ESPNow USB 加密狗
可按照链接的 ESPNowDongle 指令制作一个可选 USB 加密狗,用于 ESP32C3 与笔记本无线通信。
- 购买 U2D2 和电源集线器
DYNAMIXEL 电机需要正确配置;购买 U2D2 和 U2D2 Power Hub 可直接从笔记本配置单个电机,便于调试和故障排查。
- 获取或自行焊接 PCB
从 PCBWay 购买已组装完成的 Q8bot PCB,或按照 /PCBA 文件夹中的信息自行回流焊接 PCB。
- 收集全部组件
Gather 2 lithium-ion batteries, 3D-printed parts, 12 692ZZ ball bearings, battery clips, a separate Seeed Studio XIAO ESP32C3, the fully assembled Q8bot PCB, and 8 brand new DYNAMIXEL XL330-M077-T motors. Use only the 6mm screws supplied with the motors, and start charging the batteries so they are ready later.
- 订购已组装 PCB
通过 PCBWay 项目页面订购 Q8bot 的已组装 PCB;该页面包含 BOM、质心文件等装配相关文件。
打印与加工
- 下载硬件文件
从最新发行版下载压缩文件夹,以获取STL、Gerber、CAD等所有硬件相关文件。
- 打印 2 个 Q8bt_Frame
为 1 台 Q8bot 准备 2 个 Q8bt_Frame;也可以额外打印一些备用件。
- 打印 4 个 Q8bot_LL_Left
为 1 台 Q8bot 准备 4 个 Q8bot_LL_Left;建议额外打印一些备用件。
- 打印 4 个 Q8bot_LL_Right
为 1 台 Q8bot 准备 4 个 Q8bot_LL_Right;建议额外打印一些备用件。
- 打印 4 个 Q8bot_UL1
为 1 台 Q8bot 准备 4 个 Q8bot_UL1;建议额外打印一些备用件。
- 打印 4 个 Q8bot_UL2
为 1 台 Q8bot 准备 4 个 Q8bot_UL2;建议额外打印一些备用件。
- 使用 FDM 自行打印零件
下载 `hw-vx.x/CAD/Q8_VX.X_FDM` 下的文件并切片,然后用 Bambu Lab、Prusa 或类似 3D 打印机打印。文档使用 Bambu Lab A1 mini 和默认 0.12 mm 设置打印。
组装
- 安装电池夹
将电池夹安装到两个主框架上。电池几何形状位于左侧时,左侧应放带弹簧的负极夹,右侧应放扁平的正极夹,并让缺口朝内。
- 固定主框架与中央 PCB
使用 DYNAMIXEL 电机附带的 8 个 M2x6mm 自攻螺钉,将主框架固定到中央 PCB。
- 焊接电池夹
将电池夹焊接到 PCB 上,注意不要熔化 3D 打印框架部件。使用助焊剂可能会有帮助。
- 向腿连接件压入滚珠轴承
在 3D 打印的腿连接件中装入滚珠轴承,总共使用 12 个。必要时可用螺丝刀背面轻压轴承。
- 组装两对镜像腿
组装两对互为镜像的腿,每条腿使用 3 个 M2x6mm 螺钉。可先不装螺钉,对照图片辨认各部件的细微差别并确定方向。组装完成后将腿放在一旁,稍后再用。
- 组装每条腿
按照图示摆放腿部元件并插入底部螺钉。翻转组件后,再安装另外2颗螺钉。
- 拆下电机底壳
建议在每台电机的指定位置贴一条胶带,以方便后续操作。松开4颗螺钉,从全部8台 DYNAMIXEL 电机拆下底壳并露出电子元件。
- 安装电池
安装电池时,负极接到带弹簧的夹子,正极接到平头夹子。
- 对齐PCB排针并安装第一个电机
将PCB排针与电机引脚对齐,装上第一个电机,但暂时不要用螺丝固定。第一个新电机接上后,电脑的串口监视器应显示:New motor connected! DXL Params set. Changing ID to 11.
- 用长螺丝固定第一个电机
现在可以用拆卸外壳时取下的长螺丝固定第一个电机,注意只需要2颗而不是4颗。如果PCBWay的组装服务使用了过高(黑色)母排针,可用斜口钳或砂纸把排针修剪到合适高度。
- 重复安装其余电机ID12至ID18
对剩余的电机重复步骤15-17:ID12到ID18。务必按标签编号顺序进行,因为标定代码只会寻找下一个可用的电机。
- 全部电机连接后自动摆动准备装腿
所有电机连接完成后,程序应自动移动所有电机,为安装腿做准备。现在可以把机器人从电脑上断开,但要保持通电。
- 安装左右腿(镜像配对)
安装腿。确保左侧安装一对相同的腿,右侧安装其镜像的一对腿。若不清楚,请参照机器人的CAD模型。
- 组装完成:关机或进入软件设置
恭喜,你已完成Q8机器人的组装。现在可以关闭机器人电源,也可以直接进入Software Setup(软件设置)页面。
软件与固件
- 安装 Python 依赖
在项目目录中运行 requirements.txt 安装依赖。
- 安装 PyInstaller
安装 PyInstaller,用于构建单文件可执行程序。
- 运行 Windows 构建脚本
在 Windows 上运行 build_exe.bat。构建输出为 dist/q8bot.exe。
- 手动构建 Windows 可执行文件
也可以手动运行 PyInstaller 构建 q8bot_build.spec。输出为 dist/q8bot.exe。
- 运行 Linux 或 macOS 构建脚本
先使 build_exe.sh 可执行,再运行该脚本。构建输出为 dist/q8bot。
- 手动构建 Linux 或 macOS 可执行文件
也可以手动运行 PyInstaller 构建 q8bot_build.spec。输出为 dist/q8bot。
- 运行 Windows 可执行文件
在 Windows 上运行 dist\q8bot.exe。它可以自动检测 COM 端口,也可以指定 COM3,并可启用调试日志。
- 运行 Linux 或 macOS 可执行文件
在 Linux 或 macOS 上运行 ./dist/q8bot。它可以自动检测串口,或指定 /dev/ttyUSB0,并可启用调试日志。
- 检查构建配置
q8bot_build.spec 配置为单文件、控制台模式,并将 joystick 配置嵌入 Python 代码。依赖项包括 numpy、scipy、pygame 和 pyserial;排除 matplotlib、PIL 和 sympy,并启用 UPX 压缩。
- 安装所有 Python 依赖
运行 requirements.txt 中的依赖安装命令。
- 检查 spec 文件的 hiddenimports
确认 spec 文件的 hiddenimports 设置包含缺失的模块。
- 使用内嵌手柄配置
手柄配置直接嵌入 control_config.py,不需要或附带外部 JSON 文件。
- 安装 Windows 运行库
在 Windows 上运行可执行文件前,确保已安装 Visual C++ Redistributables。
- 设置 Linux 执行权限
在 Linux 上为 dist/q8bot 添加执行权限。
- 检查 UPX 压缩
UPX 压缩已启用,但还可以改进。
- 排除未使用的科学计算模块
如需减小文件大小,考虑排除未使用的 scipy 或 numpy 子模块。
- 分发 Windows 版本
Windows 用户需要 q8bot.exe,该文件必须在 Windows 上构建。
- 分发 Linux 版本
Linux 用户需要 q8bot,该文件必须在 Linux 上构建。
- 分发 macOS 版本
macOS 用户需要 q8bot,该文件必须在 macOS 上构建。
- 设置 PlatformIO 环境
按照 PlatformIO 官方文档和教程设置环境。
- 选择固件构建版本
在 PlatformIO 中选择所需的永久模式(perm)或自动模式(auto)构建。默认设置为 robot_permanent/controller_permanent。
- 上传机器人固件
使用 PlatformIO 将 `firmware/q8bot_robot` 上传到 Q8bot 机器人。
- 上传控制器固件
Use PlatformIO to upload `firmware/q8bot_controller` to the separate Seeed Studio XIAO ESP32C3 controller.
- 使用 esptool 写入机器人固件
高级用户可以使用 Espressif esptool 写入永久模式 ESP-NOW 机器人固件,并将 `COM9` 替换为设备实际显示的端口。
- 使用 esptool 写入控制器固件
高级用户可以使用 Espressif esptool 写入永久模式 ESP-NOW 控制器固件,并将 `COM9` 替换为设备实际显示的端口。
- 运行独立可执行文件
从最新版本下载 q8bot_operate.exe,连接控制器并开启机器人,然后双击该文件。等待名为“pygame”的空白窗口出现后,即可使用文档后面列出的同一组键盘命令控制机器人;此方法仅适用于 Windows。
- 安装 Python
如果尚未安装,请从 Python 官方网站下载并安装最新版本。安装时务必勾选“add python.exe to PATH”选项。
- 创建虚拟环境
使用任意终端进入 /python-tools 文件夹,然后为该项目创建虚拟环境。
- 激活虚拟环境
在同一个目录中激活刚创建的虚拟环境。文档注明,macOS/Linux 使用的激活命令不同。
- 安装项目依赖
在同一个目录中运行依赖安装命令,将必要的库强制重新安装到该虚拟环境中。如果系统无法使用此命令,也可以手动使用 pip 安装这些库。
- 查看软件安装指南
打开链接的 Software Setup 页面,查看从源代码运行 Q8bot 控制软件的详细信息。
- 克隆 q8bot 仓库
克隆 q8bot 仓库,然后进入 python-tools 目录。
- 创建虚拟环境
在 Windows 命令提示符或 PowerShell 中使用 python -m venv venv 创建环境并激活它;macOS/Linux 使用 python3 -m venv venv 创建环境并激活它。
- 安装依赖项
先使用 requirements.txt 安装运行时依赖项,再安装 PyInstaller 来构建可执行文件。--force-reinstall 确保所有软件包均已正确安装,即使它们已经存在。
- 构建可执行文件
运行适用于操作系统的构建脚本。构建过程会检查 PyInstaller、清理旧构建、打包应用及其依赖项、嵌入说明图片,并创建单文件可执行文件。
- 查找构建后的可执行文件
在 dist/ 目录中查找 q8bot.exe(Windows)或 q8bot(macOS/Linux)。
- 自动检测 COM 端口
运行 dist/q8bot,让程序自动检测 COM 端口。
- 指定 COM 端口
在 Windows 使用 COM3,在 Linux 使用 /dev/ttyUSB0 作为启动参数。
- 启用调试日志
使用 --debug 参数运行 q8bot,以启用调试日志。
- 组合端口与调试选项
可以同时指定 COM 端口并启用调试日志。
标定与测试
- 接通电源并检查指示灯
找到开关,将其朝 USB-C 端口方向滑动以打开电源。如果 PCB 组装正确,Seeed Studio XIAO 板载 LED 应亮起。
- 手动配置旧电机
后续电机设置说明仅适用于从未配置过的全新 DYNAMIXEL 电机。从旧项目复用的电机必须按照 DXL_config_manual.md 手动配置。
- 打开串口监视器
上传成功后,点击电缆插头形状的按钮打开串口监视器。
- 确认未发现电机消息
The serial monitor should print "No new Dynamixel motors found" approximately every 5 seconds.
用起来
- 分发独立可执行文件
dist/ 中的可执行文件无需安装 Python 即可复制到其他电脑、从 USB 闪存盘运行或分发给最终用户。
- 使用匹配操作系统的版本
可执行文件与操作系统平台绑定;Windows 的 .exe 不能在 macOS/Linux 上运行,反之亦然。
常见问题
物料
- 8 个 ROBOTIS DYNAMIXEL XL330‑M077‑T 智能舵机(自带的 M2 自攻螺丝用于全机组装)
- 中央 PCB(硬件 v2.5):Seeed XIAO ESP32C3、MAX17043 电量计、SN74LVC2G241 缓冲器;可在 PCBWay 整板贴片下单
- 第二块 XIAO ESP32C3,接电脑作 ESP‑NOW 无线 dongle
- 2 节 KeepPower 14500 1000 mAh 带保护锂电(普通 AA 电池不能用)与 Keystone 1087‑1/1087‑2 电池夹
- 12 个 692ZZ 轴承(2×6×3 mm)
- 3D 打印件:2 个主框架与 16 段腿部连杆,FDM 用 PLA 自打(耗材不到 1 美元)或外包 MJF
工具
- PH0 或 JIS‑1 螺丝刀
- 烙铁(焊电池夹)
- 能运行 VS Code 的电脑与 USB‑C 线;遮蔽胶带
- 自己焊 PCB 需迷你回流加热台与上下钢网;建议另备锂电充电器与 U2D2 调试舵机
技能
- 基础焊接(自己贴片则需回流焊)
- PlatformIO 烧录 ESP32 固件与 DYNAMIXEL 舵机配置
- Python:步态生成与运动学,可改参数探索新步态
软件
- 固件 2.0.1:Arduino 与 FreeRTOS 混合结构,ESP‑NOW 自动配对,分永久与自动两种配对模式
- python-tools:pygame 界面、步态管理与运动学求解,2025‑11 起支持 Xbox 手柄与 Joy‑Con
- q8bot.exe:免装 Python 的 Windows 版(实验性)
- q8bot_motor_config:新舵机逐个上板时自动设定 ID 11–18