ROBOTO_ORIGIN 复刻全流程
ROBOTO_ORIGIN 从采购、打印、组装到装软件、标定和训练的 72 个步骤,附物料表、购买链接与官方出处。
ROBOTO_ORIGIN 是一款全开源、可自行组装的 DIY 人形机器人。本仓库汇总其结构、电子、训练与部署资源,并提供 BOM 和各模块说明。
采购
- 确认硬件版本
根据硬件版本选择对应目录。V2.0 的机械结构和硬件接口与 V1.0 不兼容,因此组装或购买材料前必须确认版本。
打印与加工
- 查看 V2.0 机械图和 STL 文件
进入 V2.0 机械目录,查看装配图和 STL 文件。
- 获取 V2.0 PCB 文件
进入 V2.0 PCB 目录,获取 Gerber 文件和原理图。
- 查看 V1.0 机械图
旧版 V1.0 用户进入 V1.0 机械目录。
- 查看 V1.0 PCB 文件
旧版 V1.0 用户进入 V1.0 PCB 目录。
软件与固件
- 选择操作系统
选择你正在使用的操作系统,然后按照对应的说明更新系统。
- 更新 Ubuntu 系统
本指南涵盖 Ubuntu 24.04 LTS 及更高版本;运行更新和升级命令。
- 更新 Apple 系统
在系统设置中选择“通用”“软件更新”,然后安装所有可用更新。
- 更新 Windows 系统
在 Windows Update 中检查更新,并安装所有可用更新。
- 安装 Ubuntu 主机依赖
使用 Ubuntu 的推荐包管理器安装 Zephyr 配置和构建应用所需的工具,并检查 cmake、python3 和 dtc 版本。
- 安装 macOS 主机依赖
使用 Homebrew 安装 Zephyr 所需的主机工具,并在 shell 配置中设置 Homebrew 和 Python 的 PATH。
- 准备 Windows 终端
在 Windows 10 及更高版本上,从 Microsoft Store 安装 Windows Terminal;这些说明适用于 cmd.exe 或 PowerShell。
- 创建 Zephyr Python 虚拟环境
使用 Python 3 创建 ~/zephyrproject/.venv,或在 Windows 命令提示符和 PowerShell 中使用 Python 3.12 创建 zephyrproject\.venv。
- 激活 Python 虚拟环境
激活虚拟环境,使 Zephyr 的 Python 依赖与系统 Python 安装保持分离。Windows PowerShell 使用前将当前用户的执行策略设置为 RemoteSigned。
- 安装 west
在已激活的 Python 虚拟环境中安装 west。
- 初始化并更新工作区
使用 west 初始化 ~/zephyrproject 工作区,获取 Zephyr 及其模块,然后进入该目录并执行 west update。
- 初始化相对路径工作区
也可在当前目录中使用 zephyrproject 作为工作区名称;初始化后进入该目录并更新模块。
- 安装 Zephyr Python 包
使用 west packages pip --install 安装 Zephyr Python 包。Windows 可运行提供的辅助命令,或通过 python -m pip 安装 west 输出的包列表。
- 导出 Zephyr CMake 包
运行 west zephyr-export,导出 Zephyr CMake 包。
- 安装 Zephyr SDK
进入 Zephyr 仓库并运行 west sdk install。SDK 包含目标架构所需的编译器、汇编器、链接器、QEMU 和 OpenOCD 等工具。
- 查找 Zephyr 开发板名称
运行 west boards 列出 Zephyr 支持的所有开发板,并在 Board Catalog 中确认要传递给 west build 的准确开发板目标名称。
- 构建 Blinky 入门示例
将 <your-board-name> 替换为开发板名称,并使用 west build 构建 samples/basic/blinky。-p always 会强制执行全新构建并移除先前配置产生的构建输出;以后可以使用 -p auto。
- 为指定 CPU 集群构建示例
构建多 SoC 或多 CPU 集群板时,指定目标 SoC 或 CPU 集群。Blinky 在 nRF5340 DK 的 cpuapp 核心上构建时,板参数必须设为 nrf5340dk/nrf5340/cpuapp。
- 连接并启动开发板
Connect the board, usually through USB, and turn it on if it has a power switch. If unsure, check the board’s page in Supported Boards and Shields for any required setup or flashing procedure.
- 配置 Linux udev 规则
在 Linux 上首次使用调试探针烧录之前,可能需要配置 udev 规则。
- 将示例烧录到开发板
运行 west flash,把刚构建的应用程序写入已连接的开发板。
- 下载并刷写适配器固件
从 GitHub Releases 页面下载最新的 roboto_usb2can_xxx.bin,并使用首选工具将其刷写到设备。
- 构建 roboto_usb2can 固件
进入 roboto_usb2can 目录,并为 roboto_usb2can 板卡执行 west build。
- 使用调试器刷写固件
根据所使用的调试器选择 STM32CubeProgrammer、Probe-rs、J-Link、PyOCD 或 OpenOCD 命令;STM32CubeProgrammer 推荐用于 STLINK-V3MINIE。
- 在 Windows 中识别设备
Windows 上不需要安装其他驱动程序,系统会自动将该设备识别为 WinUSB 设备。
- 准备 Python 3.8 以上环境
准备 Python 3.8 或更高版本环境,并安装 pyusb 依赖。
- 在 Linux 安装 tkinter
Windows 通常自带 tkinter;Linux 上可能需要安装 python3-tk。
- 运行多设备管理工具
确保 libusb-1.0.dll 位于当前目录或系统路径中,然后进入 scripts 目录运行 roboto_usb2can_tool.py。
- 安装打包工具
安装 PyInstaller,以便在没有 Python 环境的计算机上运行该工具。
- 打包为 EXE 文件
进入 scripts 目录并运行 PyInstaller,生成 scripts/dist/roboto_usb2can.exe。
- 安装主机工具依赖
安装 python3-pip、python3-tk 和 pyusb。
- 快速安装 udev 规则
从工作区根目录复制规则文件,设置权限,重新加载规则并触发 udev。
- 复制 udev 规则文件
将 scripts/99-roboto-usb2can.rules 复制到 /etc/udev/rules.d/,并将其权限设为 644。
- 重新加载 udev 规则
重新加载 udev 规则并触发规则应用。
- 添加设备访问组权限
可选地将当前用户加入 plugdev 和 dialout 组;之后需要重新登录。
- 卸载 udev 规则
从 /etc/udev/rules.d/ 删除 99-roboto-usb2can.rules。
- 重新加载并触发 udev 规则
在 Linux 上重新加载 udev 规则并触发设备规则。
- 排查 Windows 无法识别设备
检查 USB 数据线是否支持数据传输,并在设备管理器中查找黄色感叹号;如果存在,手动更新驱动并选择 WinUSB。
- 排查 Python 工具找不到设备
确认 `libusb-1.0.dll` 存在。在 Linux 上检查 `/etc/udev/rules.d/` 中的 USB 权限,确保当前用户拥有 USB 设备访问权限。
- 编译 Orange Pi 固件
在 Ubuntu 22.04 上进入 orangepi-build 目录并运行构建脚本。
标定与测试
- 检查三个状态指示灯
设备板载三个状态指示灯,分别用于 USB 状态、CAN 状态和通信活动。
- 检查蓝色 USB 状态灯
使用板载蓝色 LED 检查 USB 状态。
- 检查黄色 CAN 状态灯
使用板载黄色 LED 检查 CAN 状态。
- 检查绿色通信活动灯
LED 熄灭表示总线空闲且没有数据传输;短暂闪烁表示检测到 CAN 总线数据接收或发送。
- 检查 USB-CAN 设备
运行 dmesg 并筛选 gs_usb;输出应显示“Configuring for 1 channels”。
- 启动 CAN 接口
以 1000000 的比特率启动 can0 接口。
- 测试 CAN 收发
使用 candump 监听 can0,并用 cansend 发送测试帧。
- 运行自动测试脚本
赋予 scripts/test_roboto_usb2can.sh 执行权限,然后运行该脚本以验证 CAN 接口。
- 验证设备与规则
插入设备后,检查 USB 设备、gs_usb、roboto_usb2can 符号链接和 CAN 接口。
- 验证 CAN 通信流量
使用 candump 和 cansend 测试 can0 上的 CAN 通信流量。
- 排查权限拒绝
确保用户属于 plugdev 或 dialout 组,或将设备权限设为 666。
- 排查缺少 can0
检查 gs_usb 是否已加载,并查看 dmesg。
- 排查规则未应用
确认文件名以 99- 开头、权限为 644,然后重新插入设备或重新加载 udev。
- 排查 LED 持续快速闪烁
这表示 CAN 总线错误。检查两端是否连接了 120Ω 终端电阻、CAN_H 和 CAN_L 是否正确连接且没有接反,以及设备之间的比特率是否匹配。
- 减少高比特率下的数据包丢失
尝试使用更短、质量更高的 USB 数据线,或降低总线负载或传输频率。
- 确认 Blinky LED 闪烁
如果运行的是 blinky,LED 将开始闪烁。图示为运行 blinky 的 Phytec reel_board。
用起来
- 查看多设备信息
该工具支持通过 USB Hub 同时连接和管理多个 CAN 适配器,底部列表显示实时设备总线地址和序列号。
- 连接全部在线设备
点击 Connect All 按钮,自动扫描并连接所有在线设备。
- 设置并启动 CAN
统一设置位速率,默认值为 1Mbps;点击 Start CAN 启用所有设备的 CAN 通道,点击 Stop CAN 禁用所有通道。
- 发送 CAN 数据
可向所有设备广播(Target: All)或指定单个设备,支持十六进制数据输入和周期性自动发送。
- 接收并过滤 CAN 数据
顶部日志区域显示实时总线数据,并自动添加设备编号 `[Dev X]`,同时支持按 ID 过滤。