萝博头原型机(ROBOTO ORIGIN / RPO) 复刻全流程
萝博头原型机(ROBOTO ORIGIN / RPO) 从采购、打印、组装到装软件、标定和训练的 183 个步骤,附物料表、购买链接与官方出处。
创作者 BOM(Internal Roboto D-BOM,ATOM 01 v1.0.1,2026‑01‑05)表头合计 49,713 元、表尾合计 49,743.53 元(两处不一致),其中关节电机 31,187 元、CNC 结构件 15,670 元;3D 打印件、多数线束与螺丝未计价,不含运费、工具与选配相机雷达。官方散件套件经淘宝店销售,价格未读取
采购
- 初始化 main 分支
使用 x5-manifest 仓库初始化 main 分支的源代码清单。
- 同步源代码仓库
执行 repo sync,下载已初始化仓库清单中的源代码。
- 选择 develop 分支
也可以在初始化仓库清单时使用 `-b develop` 下载 develop 分支代码;开发分支会持续添加功能和修复问题,但稳定性低于 main 分支。
- 确认硬件版本
先确认硬件版本。V2.0 与 V1.0 的机械结构和硬件接口不兼容。
打印与加工
- 获取 V2.0 机械文件
进入 `V2.0/roboto_origin_mechanic/` 查看装配图和 STL 文件。
- 获取 V2.0 PCB 文件
进入 `V2.0/roboto_origin_pcb/` 获取 Gerber 文件和原理图。
- 获取 V1.0 机械文件
对于 V1.0 旧版硬件,进入 `V1.0/atom01_mechanic/` 查看机械图纸。
- 获取 V1.0 PCB 文件
对于 V1.0 旧版硬件,进入 `V1.0/atom01_pcb/` 获取 PCB 文件。
组装
- 检查 CAN_H 和 CAN_L 接线
检查 CAN_H 和 CAN_L 的接线是否正确,确保没有接反。
软件与固件
- 进入固件发布页面
进入 roboto_usb2can 的 GitHub Releases 页面。
- 下载最新固件文件
下载最新的 `roboto_usb2can_xxx.bin` 固件文件。
- 将固件刷入设备
Flash the downloaded firmware onto the device using the preferred tool, as described in the “Firmware Compilation and Flashing” section.
- 安装 Zephyr SDK
确保已正确安装 Zephyr SDK。
- 配置 CANnectivity 模块
创建 `zephyr/submanifests/cannectivity.yaml`,将项目名称设为 `cannectivity`,URL 设为 `https://github.com/CANnectivity/cannectivity.git`,修订版本设为 `main`,路径设为 `custom/cannectivity`。
- 更新工作区
更新 west 工作区。
- 获取项目源代码
将此仓库克隆到 `zephyr/samples` 目录。
- 构建 roboto_usb2can 固件
进入 roboto_usb2can 目录,并使用 west 构建 roboto_usb2can。
- 使用 STM32CubeProgrammer 刷写
针对 STLINK-V3MINIE 调试器,使用 STM32CubeProgrammer runner 刷写固件。
- 使用 Probe-rs 刷写
选择 Probe-rs runner 刷写固件。
- 使用 J-Link 刷写
选择 J-Link runner 刷写固件。
- 使用 PyOCD 刷写
选择 PyOCD runner 刷写固件。
- 使用 OpenOCD 刷写
选择 OpenOCD runner 刷写固件。
- 运行 Windows 主机管理工具
在 Windows 上无需安装额外驱动程序,系统会自动将其识别为 WinUSB 设备。使用 Python 3.8+ 环境安装 pyusb,并运行 scripts/roboto_usb2can_tool.py;确保 libusb-1.0.dll 位于目录中或系统路径中。
- 打包为 EXE
安装 PyInstaller,然后执行打包命令。生成的文件位于 `scripts/dist/roboto_usb2can.exe`。
- 安装 Linux 主机工具依赖
安装 Python 依赖 `python3-pip`、`python3-tk` 和 `pyusb`,用于主机工具。
- 安装 udev 规则
使用规则文件 `scripts/99-roboto-usb2can.rules` 安装 udev 规则。
- 快速安装 udev 规则
从工作区根目录复制规则文件,设置权限,重新加载规则并触发 udev。
- 复制并重新加载规则
先将规则文件复制到 `/etc/udev/rules.d/`,并将其权限设置为 644。然后重新加载 udev 规则并触发规则。
- 了解 udev 规则功能
该规则允许非 root 用户访问设备,并创建 `/dev/roboto_usb2can*` 符号链接。它支持 SocketCAN、libusb、gs_usb 以及 ttyUSB/ttyACM 访问路径。
- 确认系统兼容性
该规则适用于主流 Linux 发行版,包括 Ubuntu、Debian、Fedora 和 Arch,并要求内核 3.16 或更高版本提供 gs_usb 驱动。
- 卸载 udev 规则
删除 `/etc/udev/rules.d/99-roboto-usb2can.rules` 即可卸载规则。
- 重新加载并触发 udev 规则
重新加载 udev 规则,然后触发规则。
- 排查 Windows 设备识别问题
检查 USB 数据线是否支持数据传输。查看设备管理器中是否有黄色感叹号;如果有,手动更新驱动并选择 WinUSB。
- 排查 Python 工具找不到设备
确认 `libusb-1.0.dll` 存在。在 Linux 上检查 `/etc/udev/rules.d/` 中的 USB 权限,确保当前用户可以访问 USB 设备。
- 下载 RDK X5 系统镜像
从推荐的 GitHub Releases 页面下载预构建系统镜像;历史版本也可在该页面获取。Google Drive 和百度网盘镜像需从各个 Release 页面查看其链接。
- 准备系统镜像构建主机
使用 Ubuntu 22.04、x86_64 架构的主机,并准备 root 或 sudo 权限。确保至少有 50GB 可用空间,并可访问 GitHub 和 Ubuntu 软件包仓库。
- 一键完整构建
运行完整构建脚本,依次完成环境设置、内核构建、引导程序构建、根文件系统构建、deb 打包和镜像生成。
- 初始化构建环境
运行设置子命令,安装依赖和工具链并获取源代码。
- 构建引导程序
运行 bootloader 子命令,构建 miniboot、U-Boot 和 nand_disk.img。
- 构建标准内核和实时内核
运行 kernel 子命令,构建标准内核和实时内核。
- 构建 Ubuntu 根文件系统
运行 rootfs 子命令,构建 Ubuntu 根文件系统。
- 从源代码构建 deb 软件包
运行 debs 子命令,从源代码构建 deb 软件包。
- 生成最终系统镜像
运行 pack 子命令,生成最终系统镜像。
- 快速重新生成镜像
当 rootfs 已构建并放置在 rootfs/ 目录中时,运行 image 子命令重建内核、引导程序和 deb 软件包,并生成镜像。
- 指定构建配置文件
使用 -c 选项指定构建配置文件;默认配置为 ubuntu-22.04_desktop_rdk-x5_release.conf。
- 显示帮助信息
使用 -h 选项显示 build.sh 的帮助信息。
- 使用服务器配置打包镜像
使用 ubuntu-22.04_server_rdk-x5_release.conf 配置运行 pack,生成服务器配置的系统镜像。
- 使用 Beta 配置进行完整构建
使用 ubuntu-22.04_desktop_rdk-x5_beta.conf 配置运行 all,执行完整构建。
- 解包根文件系统
将 rootfs 中的 samplefs 压缩包解压到 deploy/rootfs/。
标定与测试
- 检查 ROS2 导入
确认终端已加载对应的 ROS2 环境,并检查 rclpy 与 sensor_msgs 是否能够正常导入。
- 配合底层平衡策略
本项目控制 VR 到上半身遥操作链路,真机的站立与平衡仍由底层 policy 负责。
- 配置机器人策略模型
在 roboparty_deploy 的 src/inference/launch/inference.launch.py 中修改加载的配置文件。可选文件包括 inference_amp.yaml、inference_attn_enc.yaml、inference_beyondmimic.yaml、inference_getup.yaml 和 inference_interrupt.yaml,当前建议使用 inference_interrupt.yaml。
- 启动机器人并加载策略
完成配置后运行 ./tools/start_robot.sh,使机器人启动时加载对应配置并使用相应底层 policy。
- 启动机器人部署程序
在机器人侧启动 roboparty_deploy,并确认 inference_interrupt.yaml 已经加载。
- 使能并复位机器人
使用机器人遥控器按 X 使能电机,然后按 A 让机器人复位。
- 进入推理与平衡模式
按遥控器 B 进入推理模式,确认机器人能够稳定站立、保持平衡并正常行走。
- 对齐仿真与真机姿态
暂不将真机暴露给 VR,观察仿真机器人和真机机器人的上半身姿态,并尽量使两者接近。
- 运行真机前性能检查
在真机联调前,先以 controller、headless 和 profile-loop 参数运行程序。
- 检查控制循环统计
终端统计包含 motion、ik、send、loop、rate 和 ipopt_iter_* 字段,分别表示 XR 数据读取与坐标转换、IK 求解、ROS 命令发布、整轮循环、实际频率及 Ipopt 迭代统计。
- 确认 PICO 已连接
查看终端;出现连接日志即表示 PICO 已成功接入。
- 对齐 Meshcat 与真机姿态
按下 a 之前,先让 Meshcat 中的机器人姿态尽量接近真机复位姿态。
- 对齐操作者与机器人姿态
开始发送控制命令前,先让操作者手臂接近机器人的真机姿态。
- 检查 USB 设备
运行 `dmesg | grep gs_usb` 检查设备,输出应显示 `Configuring for 1 channels`。
- 启动 CAN 接口
将 `can0` 接口设置为 1Mbps 并启动。
- 验证设备与规则
插入设备后检查 USB 设备、gs_usb 驱动、设备符号链接和 CAN 接口。
- 排查 Linux 使用问题
如果出现权限错误,确保用户属于 `plugdev` 或 `dialout` 组;如果没有 `can0`,检查 `gs_usb` 是否加载并查看 `dmesg`;如果规则未生效,确保文件名以 `99-` 开头、权限为 644,然后重新插拔设备或重新加载规则。
- 检查 CAN 总线终端电阻
确认终端电阻已连接。CAN 总线两端都需要 120Ω 终端电阻。
- 检查设备位速率是否匹配
确认设备之间的位速率一致。
- 更换更短的高质量 USB 线
尝试使用更短、质量更高的 USB 电缆。
- 降低总线负载或发送频率
降低总线负载或传输频率。
- 确认 Zephyr 开发板名称
运行 west boards 查看 Zephyr 支持的所有开发板。开发板目录也会显示传给 west build 的准确开发板目标名称。
- 确认 Blinky 的 LED 闪烁
如果运行的是 blinky,LED 将开始闪烁。
- 启动 apt-cacher-ng 服务
rootfs 构建使用 `apt-cacher-ng` 作为 apt 代理缓存;启动该服务并设置为开机启用。
- 检查 samplefs 压缩包
确认 `rootfs/` 目录中只有一个 `samplefs*.tar.gz` 文件,并检查该文件未损坏。
- 检查文件系统生成结果
desktop/ 中应包含 jammy-rdk-arm64、samplefs_desktop_jammy-v3.0.0.tar.gz 和记录已安装 apt 软件包的 .info 文件;解压归档后应得到含 23 个目录的 rootfs。
- 查找正确的任务 ID
若找不到 RPO 任务名,运行 list_envs.py 列出环境并复制准确的任务 id。
采数据与训练
- 训练 RSL-RL 策略
使用指定环境、无头模式、TensorBoard 日志记录器和 8192 个并行环境运行训练。
- 准备 AMP 与 BeyondMimic 动作数据集
AMP 和 BeyondMimic 所需的数据集按 GMR 项目(https://github.com/Roboparty/GMR)准备。
- 重排数据关节顺序
GMR 生成的数据集关节顺序遵循机器人 URDF/XML 顺序,与 Isaac Lab 不同;先准备关节映射文件如 robolab/scripts/tools/retarget/config/rpo.yaml,训练前重排关节序列。
用起来
- 熟悉机器人遥控按键
X 用于使能或失能电机,A 用于复位,B 用于进入推理模式,LB 用于将上半身控制接口暴露给 VR 遥操作。
- 连接 PICO 并启动仿真
在仓库中启动 VR 遥操作程序,按照文档后续流程完成 PICO 连接,使仿真机器人跟随操作者动作。
- 向 VR 开放上半身控制
仿真机器人与真机机器人姿态基本对齐后,按机器人遥控器 LB,将上半身控制接口暴露给 VR。
- 开始发送真机控制命令
在 VR 遥操作端继续操作,按下 VR controller 的 A,开始向真机发送上半身控制命令。
- 确认遥操作启用条件
机器人侧必须按遥控器 LB 允许 VR 接管上半身接口,同时遥操作侧必须按 VR controller 的 A 才开始发送控制命令。
- 用 r 启动主循环
终端按下 r 后,程序开始接收 VR 传输的数据,Meshcat 中的机器人跟随操作者动作,但真机不会运动。
- 用 a 允许机械臂命令
终端按下 a,允许发送机械臂命令;此后真机开始接收电脑发送的关节位置。
- 用 q 退出程序
终端按下 q,退出程序。
- 用右手 A 发送命令
按 VR 控制器右手 A,开始发送命令,效果与终端键盘 a 相同。
- 用右手 B 停止发送命令
按 VR 控制器右手 B,停止发送命令;停止后再次按 A 可恢复发送。
- 查看板载 LED 状态
设备有三个板载状态指示灯,分别用于 USB 状态、CAN 状态和通信活动。
- 查看绿色通信活动 LED
绿色 LED 关闭表示总线空闲、没有数据传输;短暂闪烁表示检测到 CAN 总线数据接收(RX)或发送(TX)。
- 使用多设备 CAN 管理功能
工具支持通过 USB Hub 同时连接和管理多个 CAN 适配器。点击 Connect All 扫描并连接所有在线设备,设置统一比特率(默认 1Mbps),然后使用 Start CAN 或 Stop CAN 启停所有设备的 CAN 通道。
- 测试 CAN 收发
使用 `candump` 接收 CAN 帧,并使用 `cansend` 发送测试帧 `123#DEADBEEF`。
- 运行自动化测试脚本
为 `scripts/test_roboto_usb2can.sh` 授予执行权限,然后运行该脚本进行快速 CAN 接口验证。
- 验证 CAN 通信
使用 `candump can0` 和 `cansend can0 123#DEADBEEF` 测试 CAN 通信。
- 播放训练策略
使用指定环境和一个并行环境运行 play.py。
- 运行 AMP 策略
用 AMP 任务 RPO-AMP-Play 运行训练好的动作马士克策略,环境数量设为 1。
- 运行 BeyondMimic 策略
用 RPO-BeyondMimic 任务运行 BeyondMimic 策略,环境数量设为 1。
- 运行跑酷策略
用 RPO-Parkour-Play 任务运行跑酷策略,环境数量设为 1。
- 导出 ONNX 模型
导出 ONNX 模型时将 num_envs 设为 1,并添加 --exportonnx 参数。
- 运行 Sim2Sim 仿真
在 MuJoCo 中运行 sim2sim_rpo.py,--load_model 指定已导出策略模型的完整路径。
常见问题
物料
- 23 个达妙关节电机:DM 4340P(48V)×14、DM 10010L ×9
- 主控 RDK X5 8G(文档另支持 Orange Pi 5 Plus),USB Hub、4 个 USB2CAN、电源中心板、CAN 转接板、48V 转 5V 模块
- 超核 HI13 M0‑USB IMU;手柄接收器
- 48V 15Ah 锂电池(140×140×115 mm)、急停开关、航空插头充电口
- 25 种 68 件 CNC 金属件(喷砂、黑色阳极氧化)与 2 只 3D 打印橡胶脚底;130×165×18 深沟球轴承、AXK6085 推力滚针轴承与 M3–M6 螺钉
工具
- CNC 加工与嘉立创打样(或购买官方散件);3D 打印机打印脚底与标定件
- 焊接工具:主控开关与急停接线需焊接
- 承重安全吊架(文档要求标零与步态测试时使用)
- DM_Motor_Tool 上位机设置电机 ID 与固件;V2.0 用 GB119 圆柱销标定
技能
- Linux 与 ROS 2(Humble/Jazzy);README 称有基础会有帮助,文档面向入门用户
- Isaac Lab 3.0 强化学习训练(RSL-RL、AMP、BeyondMimic)与 Sim2Sim 到 MuJoCo
- CAN 总线电机调试、零位标定与 C++/Python SDK 调用
软件
- roboparty_deploy:ROS 2 部署框架,IMU、电机、推理与相机模块 SDK(C++/Python)
- roboparty_train:基于 Isaac Lab 与 RSL-RL 的训练、评估与策略导出,含运动重定向
- roboparty_firmware:USB2CAN 固件与 RDK X5 / Orange Pi 镜像构建
- rpo_description(URDF/MJCF)、roboparty_navigation 导航定位与 roboparty_xr_teleop XR 遥操作