OpenArm 开源7自由度机械臂实战指南:从CAN-FD通信到6500美元双臂系统搭建

【免费下载链接】openarm A fully open-source humanoid arm for physical AI research and deployment in contact-rich environments. 【免费下载链接】openarm 项目地址: https://gitcode.com/GitHub_Trending/op/openarm

OpenArm 是一个完全开源的 7 自由度人形机械臂,面向 physical AI 研究和接触密集环境部署:CAD、PCB、固件、控制代码和仿真文件全部公开,双臂完整系统 6,500 美元,单臂自重 5.5 kg、峰值负载 6.0 kg、控制总线 1 kHz CAN-FD。如果你想在真机上做遥操作、模仿学习或数据采集,而不是只在仿真里跑算法,这篇指南会告诉你它值不值得投入时间、最快怎么跑起来,以及卡住时按什么顺序排查。

一、它凭什么值得做

OpenArm 与同类方案的差异在于:它不是"给一套机械臂图纸",而是给了一条从硬件到评测的完整可复现链路,你既可以自己加工组装,也可以直接采购已认证厂商的整机。

  • 全栈开源:从 CNC 零件、3D 打印外壳到 PCB(gerber/BOM 齐全)和 openarm_can 控制库都公开,任何一环出问题你都能改,不用等官方补丁。
  • QDD 高反驱关节:所有关节用可反驱的 Damiao 无框力矩电机加高柔顺结构,配合 MIT 控制模式做力矩级控制,这是双边力反馈遥操作的前提,也是它敢让人直接用手拖拽调试的原因。
  • 负载与尺寸:单臂 7 自由度、633 mm 工作半径,额定负载 4.1 kg(最不利姿态保持 1 分钟),峰值负载 6.0 kg(最不利姿态 3 秒内到位并保持 1 秒),负载口径包含末端执行器。
  • 可复现评测:配套的 OpenArm Cell 评测舱把背景、光照、相机位、臂的安装位全部固定(1100 × 926 × 1883 mm 的框架加 300 mm Z 轴升降),"模型 A 比模型 B 好"这类结论只有在同一环境下测试才成立,Cell 就是用来消除实验室间差异的。

OpenArm 2.0 机械臂结构与尺寸,展示关节机械限位配置 图1:OpenArm 2.0 尺寸与机械限位结构,每个关节都有物理行程限位兜底

二、最快上手路径

最短路径是:一台 Ubuntu 主机、一块 CAN-FD 适配器、一套已装好的单臂,从电机 ID 烧录到 demo 跑通,顺利的话半天内完成。

环境准备

目的:装好 SocketCAN 工具链和 openarm 的 CAN 工具包,后面所有命令都依赖它们。

sudo add-apt-repository -y ppa:openarm/main
sudo apt update
sudo apt install -y can-utils iproute2 libopenarm-can-dev openarm-can-utils

预期结果:which openarm-can-cli 有输出,说明 apt 仓库的 openarm 工具装上了。系统要求 Ubuntu 22.04/24.04(或任何支持 SocketCAN 的 Linux),CAN-FD 适配器建议用官方 BOM 里列过的型号,换杂牌适配器可能出通信异常。

最小可用配置

目的:明确最少需要哪些硬件,避免为"完整系统"一次性采购过多。

  • 8 台 Damiao 电机(单臂):J1–J7 关节加 J8 夹爪,型号分工见下表,全部 24 V 供电。
  • 1 块 USB-CAN-FD 适配器:每臂占 1 个 can 口(右臂 can0、左臂 can1),双臂才需要第二块。
  • 24 V 电源:测试阶段按官方推荐电流备(DM4310 约 0.3 A/台、DM8009P 约 0.75 A/台,串联时电流累加)。
  • 1 台 Ubuntu 主机:跑 SocketCAN;烧电机 ID 时另外需要一台 Windows 电脑和 Damiao USB 调试器。
关节电机型号关键参数
J1DM-J4310-2EC峰值 7 Nm,最高 200 rpm,肩部要转速
J2、J3DM4340 系列峰值 27 Nm,40:1 减速,肘部要扭矩
J4–J7DM-J4310-2EC峰值 7 Nm,轻量优先
J8 夹爪DM-J8009P-2EC峰值 40 Nm,支撑抓取力

所有电机都是 14-bit 双磁编码器、CAN 接口,控制统一走 MIT 模式(kp、kd、位置、速度、力矩参数)。为什么这么分:肩关节要快、肘关节要稳、腕部要轻,按关节工况选不同减速比而不是全臂同型号,才把 6 kg 峰值负载压在 5.5 kg 自重里。

第一次运行与验证

目的:三步验证通信链,每步都在检查上一环,出了问题能立刻定位在哪一层。

第 1 步:配置 CAN 口。

openarm-can-configure-socketcan-4-arms -fd -b 1000000 -d 5000000
ip link show can0

预期结果:can0 状态为 UP,仲裁段 1 Mbps、数据段 5 Mbps(CAN-FD 模式)。

第 2 步:手动发使能帧。 开两个终端,一个抓流量,一个发命令:

# 终端 1:抓流量
candump can0
# 终端 2:使能 1 号电机
cansend can0 001#FFFFFFFFFFFFFFFC

预期结果:1 号电机 GH1.25 口上方 LED 变绿;如果电机波特率与接口一致,candump 里会出现 can0 011 [8] ... 的回复帧(0x11 是 1 号电机的接收 ID)。收不到回复帧不用慌,先跳到第五节的排查。

第 3 步:跑官方 demo。 默认 demo 使用 can0 上 0x01、0x02、0x07 三台电机(CAN-FD),如果你的配置一致可以直接跑:

openarm-can-demo

预期结果:终端依次打印电机查询结果、使能、位置/力矩控制、夹爪开合,10 个周期后安全关闭。看到关节按顺序动作、夹爪开合,说明硬件链路全部打通。

安全前置:跑 demo 前先给所有电机设好安全零点、手边放急停按钮、臂的活动范围内清空障碍物——官方文档把这三条列为硬性要求,QDD 反驱结构意味着断电后夹着的负载会直接坠落(见 安全指南)。

三、核心组件拆解

OpenArm 2.0 由三个互相配合的硬件加一套软件栈组成,理解分工后再动手,比照抄命令更省事。

OpenArm 2.0 主臂

基座用 MiSUMi 铝型材立柱,尺寸可调、随手可挂相机和传感器,底板带均布 M6 螺纹孔可直接固定到桌面。每个关节都有机械限位,软件失控时物理行程是最后防线。

OpenArm 主臂与 OpenArm Cell 评测舱整体外观 图2:OpenArm 2.0 机械臂,7 自由度人形比例结构,铝型材基座便于加装相机

OpenArm Cell 评测舱

定位:让不同实验室的结果能直接对比。它固定四件会漂移的东西——背景、光照、相机位、臂位——并加了两项工程化设计:

  • Z 轴升降:300 mm 行程,适应不同高度的工件。
  • 进区急停:光区传感器检测到入侵直接断电,不用人工盯。
  • 零点校准工装:机械约束把夹爪固定到 CAD 定义角度,装配公差不会混进数据集。

OpenArm KER 主臂

KER(Kinematic Equivalent Replica)是 1.7 kg 的无电机主臂,靠 16 个 15-bit 绝对值磁编码器读关节角度。为什么做无电机的:关节结构与 2.0 完全相同、链长缩到 70%,你的动作 1:1 映射到从臂上不需要 retargeting,同时因为没有电机和配重,肩背式佩戴 30 秒即可就位,长时间遥操作不累。

OpenArm KER 无电机主臂,与从臂运动学完全一致 图3:OpenArm KER 主臂,无电机设计,链长为从臂 70%

夹爪与相机

2.0 的夹爪换成了更简单的驱动机构,整体包络更紧凑,能伸进狭窄空间;指形同时按"抓得稳"和"相机看得清"两个目标设计。内置一台 Arducam B0495 全局快门相机(1920×1200@50 fps,USB 3.0 直连、UVC 免驱),抓取时的手眼视角直接可用。指尖部件可 3D 打印替换,针对特定物体改指形不用动夹爪本体。

四、从演示到真实环境

demo 跑通只是通信验证,真实使用要走"零点 → ROS2 联调 → 真机切换 → 数据 loop"四步,顺序不要跳。

第 1 步:设零点。 把臂摆到校准工装规定的姿态,对两个 can 口分别执行:

openarm-can-cli -i can0 set_zero --arm
openarm-can-cli -i can1 set_zero --arm

预期结果:命令返回成功,之后所有位置指令都基于这个零位。参考 Cell 校准流程。

第 2 步:ROS2 接 fake hardware 联调。 先不碰真机,用 mock 硬件把 launch 链路跑顺:

git clone <openarm_ros2仓库地址> ~/ros2_ws/src/openarm_ros2
cd ~/ros2_ws && rosdep install --from-paths src --ignore-src -r -y
colcon build
source ~/ros2_ws/install/setup.bash
ros2 launch openarm_bringup openarm.bimanual.launch.py arm_type:=v2.0

预期结果:RViz 里出现双臂模型,/joint_states、左右臂 joint_trajectory_controller 话题正常发布。fake 模式下轨迹下发后模型会动,说明控制器配置没问题。

第 3 步:切真机。 同一 launch 文件加真机参数:

ros2 launch openarm_bringup openarm.bimanual.launch.py arm_type:=v2.0 \
  use_fake_hardware:=false right_can_interface:=can0 left_can_interface:=can1

预期结果:RViz 里模型动作与物理臂同步,/joint_states 的反馈值跟随真实关节。此时再用 MoveIt2 做规划、或接遥操作包(openarm_teleop,双边控制带力反馈,文档见 teleop/leader-follower)都建立在这条链路上。

第 4 步:进入数据 loop。 数据采集用 dora-openarm 数据流:250 Hz 执行器把模型输出的动作块做 Hermite 上采样并过 15 Hz 低通后下发真机,5 路相机(双臂腕部 + 顶部)+ 16 维关节状态组成观测。训练侧把采集数据转成 LeRobot v3.0 格式后直接 lerobot-train 训 ACT 策略,完整流程见 training 教程 与 inference 教程。

五、高频问题排查

以下按官方 setup 文档和 FAQ 的高频故障整理,按"现象 → 原因 → 解决"展开。

  1. ip link show 看不到 can 口 → 现象:装完适配器仍没有 can0/can1。原因:驱动没装、内核模块没加载,或串口类设备需要 slcand 包装。解决:dmesg 查设备日志,必要时 sudo modprobe slcan can can_raw,串口设备启动 slcand 后再配置。
  2. 使能后电机 LED 不变绿 → 现象:cansend 发帧无反应。原因:24 V 没接上、CANH/CANL 接反,或接头松动——肘部 J4 的线最容易松。解决:先断电检查供电和 J4 附近线缆,再核对接线方向,最后确认电机 ID 烧的就是 0x01。
  3. 有回复帧但 ID 不对 → 现象:candump 里的回复 ID 不是预期的 0x11。原因:电机的接收(Master)ID 没按官方表烧,或总线上有别的设备撞 ID。解决:回 Windows 用 Damiao 调试工具重烧 ID,对照 电机 ID 配置表(J1–J8 发送 ID 0x01–0x08、接收 ID 0x11–0x18)。
  4. 运行中整臂突然停摆 → 现象:控制还在发,电机全部无响应。原因:长线缆或走线不当引起信号反射,CAN 总线进入 bus-off 状态。解决:把接口 down 再 up 即可恢复通信;根治要检查 120 Ω 终端电阻是否都在位、缩短不必要的走线。
  5. 手臂晃动、动作不稳 → 现象:空载运行也有抖动或关节旷量。原因:振动导致腕部螺丝松脱、肘部螺丝松动产生间隙。解决:断电后按 FAQ 逐项复查腕部和肘部螺丝并重新锁紧。
  6. ROS2 里话题正常但真机不动 → 现象:fake 模式一切正常,切真机后无动作。原因:CAN 口名或电机 ID 与 launch 参数对不上(左右臂各占一个 can 口)。解决:核对 right_can_interface/left_can_interface 与实际接线,candump 确认总线上有帧在流动,再看 openarm_hardware 节点的日志。

六、扩展路径

跑通基础链路后,按你的目标挑方向,不用全做。

  • 硬件 · 换指尖:2.0 夹爪指尖支持 3D 打印定制,针对特定物体改指形最省成本。
  • 硬件 · 加传感器:MiSUMi 铝型材立柱可加挂外部相机、力传感器,M6 底板孔位可直接固装新工装。
  • 硬件 · 加 KER 主臂:约 2,599 美元(认证厂商起价),长时会话遥操作从"另一台有电主臂"换成肩背式无电机主臂,操作员负担从双臂对抗降到单臂跟随。
  • 软件 · MoveIt2:openarm_ros2 已带 MoveIt2 配置包,双臂规划可直接进 RViz 调试。
  • 软件 · 训练推理链:数据转 lerobot_v3.0 后接 LeRobot ACT 策略;推理端实现 policy server 的 socket 协议(Arrow IPC 进、JSON 动作块出)就能换成你自己的模型,接口契约写在 inference 文档。
  • 仿真 · MuJoCo / Isaac Lab:MuJoCo 文档 提供 MJCF 和扭矩控制示例,Isaac Lab 环境覆盖抓取、开门等任务,真机代码可以直接在仿真里先跑通。
  • 场景 · 接触密集操作:开抽屉、取物、双臂协同搬运,官方 demo 视频和 Cell 任务都围绕这类场景,是 physical AI 论文的常见实验对象。

七、成长路线与资源

按你的角色选一条主线,文档都在本仓库 website/docs/ 下,可直接阅读。

初学者(目标:硬件通电 + demo 跑通)

  1. 读 Setup 总览,按 1–5 步走完电机 ID、CAN 配置、通信测试、电机配置、demo(第 5 步)。
  2. 通读 安全指南,急停位置、佩戴 PPE、负载上限这三条是每次操作前的检查项。
  3. 硬件细节查 OpenArm 2.0 规格 和 电机参数,采购或排线时对照 BOM 图片 核对 PCB 与接线。

OpenArm 通信 PCB 电路板设计 图4:OpenArm 通信 PCB,CAN-FD 接口与电源分配电路

进阶(目标:ROS2 真机控制 + 遥操作)

  1. 走 ROS2 安装 → ROS2 Control,把 fake 到真机的切换参数记熟。
  2. 搭 openarm_teleop:单向控制(unilateral)起步,再上双边力反馈(bilateral),文档在 leader-follower 目录;VR/Quest 遥操作参考 vr.mdx。
  3. CAN 层深挖 CAN Library 的三层架构(OpenArm/ArmComponent → damiao_motor → CANSocket),改控制逻辑基本都在这层动手。

研究(目标:数据采集 → 训练 → 真机推理闭环)

  1. 按 tutorial 目录 配好零点和 5 路相机(每路 Arducam 要单独烧序列号,右腕、左腕、顶部各对应不同命名)。
  2. 用 openarm_dataset 工具转 LeRobot 格式、lerobot-train 训 ACT,再按 inference 数据流 部署 policy server 上真机验证。
  3. 评测统一放进 OpenArm Cell 跑,流程见 Cell 校准工作流;想改代码或硬件,从 贡献指南 进入。

结尾

下一步就两件事:按第二节的三步把 openarm-can-demo 跑通,验证你的 CAN 链路没问题;然后打开 setup 目录 对照你的硬件状态补齐剩下的配置,把臂真正动起来。遇到本文没覆盖的问题,先查 FAQ,再带着 candump 的抓包数据去社区提问。

【免费下载链接】openarm A fully open-source humanoid arm for physical AI research and deployment in contact-rich environments. 【免费下载链接】openarm 项目地址: https://gitcode.com/GitHub_Trending/op/openarm

Logo

聚焦RDK与具身智能,汇集机器人开发教程、开源案例和技术交流

更多推荐