正在连接信源…

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 过滤。

常见问题

  • 文档图片缺失且排版错位 #6
  • 项目依赖无法下载 #1
  • 缺少Atom01动捕转换配置 #12
  • 多个模块存在待确认的软件缺陷 #8

文档