从 3D 打印到步态学习：宇树 Qmini 双足机器人开源实战

Qmini 一共用了 11 个宇树 8010 电机——10 个分布在腿部和上身，负责运动；1 个放在颈部，给自定义扩展留了口子。这种预留接口的好处是：你想加个头、装个传感器，直接做扩展就行，不用动主结构。

核心系统与电气连接

树莓派的 USB 3.0 经过 Type-A 转 Type-C 接到 485 转接板，转接板再分出四路 485 总线，每条总线上挂一串电机：

• 转接板 UART1 → 右腿 0 号电机 → 右腿 1 → 右腿 2
• 转接板 UART2 → 左腿 0 号电机 → 左腿 1 → 左腿 2
• 转接板 UART3 → 髋关节 0 号电机 → 髋关节 1
• 转接板 UART4 → 上身 2 号电机 → 上身 1 → 上身 0

两路风扇电源由 GPIO2（5V）和 GPIO14（GND）直接输出 5V 供电。

软件环境搭建

软件部分宇树已经备好了，照步骤配就行——有点像给电脑装系统，装好之后机器人就能动起来。

树莓派系统烧录：

# 下载 Raspberry Pi OS Lite
# 用 Raspberry Pi Imager 写入 SD 卡
# 启动前在 boot 分区新建 ssh 文件（开启 SSH）

基础环境配置：

sudo apt update && sudo apt upgrade -y
sudo apt install python3-pip python3-numpy python3-scipy -y
sudo apt install git cmake build-essential -y

拉取控制程序：

git clone https://github.com/vsislab/RoboTamer4Qmini.git
cd RoboTamer4Qmini
pip3 install -r requirements.txt

这套程序主要做三件事：运动学解算（计算每个关节该转多少度）、步态生成（规划走路序列）、平衡控制（让机器人别摔）。

URDF 模型加载：

# 从 GitHub 下载 urdf/Qmini.urdf，放到指定目录
cp urdf/Qmini.urdf ~/robot_ws/src/qmini_description/urdf/

联机调试与强化学习部署

控制部分的核心是 VSISLab 的 RoboTamer4Qmini 框架，基于 Isaac Gym 仿真环境，用 PPO 强化学习训练步态策略。比起传统手工编程调参数，这种方式让机器人自己'学'着走，最终出来的步态更自然。

每条腿的 5 个关节都做了精确建模，例如髋关节 yaw 轴的活动范围在 -0.349 到 0.525 弧度之间，既给了步态足够灵活性，又避免了机械磕碰。

部署环境稍微重一点，需要 Ubuntu、CUDA 11.4+ 和 Isaac Gym——配好的话，训练和导出很直观：

# 训练新策略
python train.py --config BIRL --name qmini_experiment
# 查看效果
python play.py --render --name qmini_experiment --time 10
# 导出部署模型
python export_pt2onnx.py --name qmini_experiment

实机调优

仿真跑得再溜，上真机总会有差距。项目还提供了一个 PID 参数调优工具，用来缩小仿真和实际行为之间的偏差：

python tune_pid.py --mode real

把底层控制参数对齐之后，机器人走起来会更稳。整个开源方案的完整度相当高，从打印零件到部署行走模型，一条龙走通，很适合双足入门。