正在连接信源…

萝博头原型机(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 指定已导出策略模型的完整路径。

常见问题

  • 文档图片缺失且现有图片位置错误 #6
  • 项目中的 rsl_rl 无法下载 #1
  • 五个模块均存在疑似软件缺陷 #8
  • GMR 动捕缺少 Atom01 专用 FBX 转换配置 #12

物料

  • 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 遥操作

文档