开放手臂设置指南:从解盒到第一次电话操作
完整的OpenArm设置指南:解盒检查列表,组装步骤,校准,连接到RCSV平台,运行您的第一个远程操作会议,以及数据收集的提示.
部分: [电话操作指南]
开放手臂是RCSV的开源机器人手臂平台,旨在收集模仿学习数据.本指南将您从打开运输箱到完成您的第一次远程操作演示和记录您的第一集数据集事件的每一步.
解盒检查列表
在丢弃任何包装之前,请检查每种组件的包装列表. 标准的OpenArm套件包括:跟随器臂 (6个DOF机器人臂,具有伺服驱动关节和集成的抓住器),领导器臂 (操作员用于远程操作的被动动动体复制品),两个USB摄像头 (手腕安装和上机),控制板和USB枢纽,24V电源,所有所需的M3和M4硬件,扭矩螺旋驱动器以及USB-A到USB-C控制电缆. 包含计算选项的套件也配备了配置的迷你PC, Ubuntu 22.04 和预装的RCSV软件堆
检查两臂的伺服电缆,以确定在运输过程中可能发生的
在安装之前,在所有方向上,在机器人臂周围至少1米的空隙的清晰的工作空间中放置硬件.OpenArm的最大范围为850mm,因此,根据此规划桌面布局. 根据您喜欢的工作方式,领袖臂可以与追随者相邻或对应操作员;大多数操作员认为将领袖臂直接放在主导手边是最自然的安排.
集会步骤
如果您的OpenArm 部分拆卸为运输而抵达 (大多数套件都将上臂分离为保护),首先将上臂段连接到肩关节.将安装孔配对,并使用提供的M4螺丝,扭矩螺旋
通过在套件中包含的印花支架安装手腕相机.沿着抓住器伺服电缆沿着前臂
通过基头的第一台伺服器的JST连接器连接控制板到后手的伺服链.控制板通过
校准
校准确定每个关节的零位置
校准程序需要大约10分钟.您将被要求将每个关节移动到其定义的首位位置
摄像头校准是单独的.RCSV平台包括基于ChArUco板的摄像头校准工作流程,该流程计算了手腕摄像头,上头摄像头和机器人基架之间的内在参数和外在转变.在指定尺度 (A3纸,100%尺度) 打印校准板,在各种方向收集30
连接到RCSV平台
[RCSV平台]
经纪人连接后,设备将在平台仪表板中显示为"在线".您可以通过从平台的设备视图中直播现场联合状态和摄像头传输来验证连接.此次直播传输也很有用,可以远程监测数据收集会议,并在没有下载原始数据文件的情况下审查剧集质量. 平台的数据集探险器允许您直接在浏览器中标记,注释和管理事件.
你第一次手术
启用RCSV平台或通过命令行工具:
对于您的第一集录制,选择一个简单的重复任务:从固定位置中取出一个立方体,将其放置在标记的目标上.使用远程操作系统练习运动5
软件安装:ROS 2和OpenArm SDK
如果您已使用预先配置的小电脑,请跳到下面的"验证软件堆
**步骤 1 - 安装Ubuntu 22.04 LTS.**OpenArm的软件堆
**步骤 2 -- 安装ROS 2 Humble.**ROS 2 Humble Hawksbill是OpenArm包的目标LTS版本.使用官方Debian包安装:
sudo apt update && sudo apt install software-properties-common
sudo add-apt-repository universe
sudo curl -sSL https://raw.githubusercontent.com/ros/rosdistro/master/ros.key \
-o /usr/share/keyrings/ros-archive-keyring.gpg
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/ros-archive-keyring.gpg] \
http://packages.ros.org/ros2/ubuntu $(. /etc/os-release && echo $UBUNTU_CODENAME) main" \
| sudo tee /etc/apt/sources.list.d/ros2.list > /dev/null
sudo apt update && sudo apt install ros-humble-desktop python3-colcon-common-extensions
在您的
步骤 3 -- 安装OpenArm Python SDK. SDK提供低级伺服通信层,校准工具和远程操作控制器:
pip install openarm-sdk
# Or from source for development:
git clone https://github.com/svrc-robotics/openarm-sdk.git
cd openarm-sdk && pip install -e ".[dev]"
**步骤 4 -- 安装RCSV代理.**RCSV代理将您的OpenArm连接到 RCSV平台 进行远程监控,录制集段和数据集管理:
pip install svrc-agent
svrc-agent init # Creates ~/.svrc/config.yaml
** 验证软件堆
openarm diagnose --all
# Expected output:
# [OK] USB servo chain detected (6 servos on /dev/ttyUSB0)
# [OK] Leader arm detected (6 joints on /dev/ttyUSB1)
# [OK] Camera 0: /dev/video0 (640x480 @ 30fps)
# [OK] Camera 1: /dev/video2 (640x480 @ 30fps)
# [OK] ROS 2 Humble: active
# [OK] RCSV Agent: connected to platform
第一个提议:联合立场控制
在运行远程操作之前,请检查您是否可以编程控制单个关节. 这证实伺服链,校准对应和通信总线都正常运行.
from openarm import OpenArm
import time
arm = OpenArm(port="/dev/ttyUSB0")
arm.connect()
# Read current joint positions (radians)
print("Current positions:", arm.get_joint_positions())
# Move joint 1 (shoulder) to 0.5 rad at 30% speed
arm.move_joint(joint_id=1, position=0.5, speed=0.3)
time.sleep(2)
# Move to a named home pose
arm.move_to_home()
time.sleep(2)
# Move through a sequence of waypoints
waypoints = [
[0.0, -0.5, 1.0, 0.0, 0.5, 0.0], # approach
[0.0, -0.3, 0.8, 0.0, 0.3, 0.5], # pre-grasp
[0.0, -0.3, 0.8, 0.0, 0.3, 1.0], # close gripper
]
for wp in waypoints:
arm.move_joints(wp, speed=0.2)
time.sleep(1.5)
arm.disconnect()
如果任何关节没有响应或移到意想不到的位置,在继续之前再运行关节校准.最常见的问题是伺服ID冲突 - - 两个伺服器在公共汽车上分配相同的ID.使用
常见的问题和解决方案
| Symptom | Likely Cause | Fix |
|---|---|---|
| Servo LED amber on power-up | Communication bus error; bad JST connection | Reseat JST connector; check for bent pins |
| Servo LED red on power-up | Overcurrent fault (stalled motor or short) | Power off, check for mechanical binding; replace servo if persistent |
| Follower arm drifts during teleoperation | PID gains too low or calibration offset drift | Re-run calibration; increase P gain by 10-20% in servo config |
| Camera feed black or frozen | USB bandwidth conflict with servo chain | Move cameras to a separate USB controller (different physical port group) |
| openarm diagnose shows 5/6 servos | Servo ID conflict or broken daisy chain | Run openarm scan-servos; re-assign IDs with openarm set-id |
| High-pitched whine from servo | Servo fighting against hard limit or calibration offset wrong | Re-calibrate the joint; check that no wires are caught in joint mechanism |
| RCSV agent shows "Disconnected" | Device token expired or network issue | Regenerate token in platform dashboard; check firewall allows outbound HTTPS |
| Episodes not appearing in platform | Agent not running or config.yaml path wrong | Check systemctl status svrc-agent; verify ~/.svrc/config.yaml contains correct token |
设置后的下一步
一旦你的OpenArm组装,校准,连接到平台,并且你验证了关节控制和远程操作,以下是推
- 练习远程手术 (2-4小时). 用领袖手臂发展肌肉内存. 在尝试微妙操纵 (抓住小物体) 前,开始进行大运动 (移动到工作场所的位置).大多数操作员需要4-8小时才能进行示范.
- **收集校准数据集 (50集).**记录一个简单的选定任务的50个示范. 审查平台中的每一个集. 这一数据集验证了您的整个管道,从硬件到存储,并允许您在投资大型收集活动之前捕获任何剩余问题.
- **训练测试政策.**使用50集的数据集训练ACT或传播政策使用 LeRobot.如果该政策在简单任务中取得40-60%的成功,则您的硬件和数据管道正确运行.如果达到不到30%,则使用 [数据质量框架](
T23 来检查数据质量. - ** 从规模到生产收集.**一旦管道验证,就扩大到目标数据集尺寸.对于大多数单任务操纵政策,200-500次示范是典型的范围.对于多任务或基础模型的细节调整,计划为1,000-5000次示范.RCSV的 [管理收集服务]
T24 ) 可以通过训练有素的运营商和结构化的QA加速这一阶段.
开放手臂的规格
| Specification | Value |
|---|---|
| Degrees of freedom | 6 DOF + gripper |
| Maximum reach | 850 mm |
| 重复精度 | +/- 1 mm |
| 负载 | 500 g sustained |
| Control frequency | 50 Hz (configurable to 100 Hz) |
| Communication | USB serial (TTL half-duplex) |
| Power supply | 24V DC, 5A max |
| Weight (follower arm) | 2.8 kg |
| Price | $4,500 (leader + follower kit) |
收集数据的技巧
保持在演示过程中一致的速度. 突发的速度变化
操作员疲劳会导致示范质量微妙变化
相关阅读
- [机器人手臂购买指南2026年]
- [什么是好机器人训练数据?]
T28 ) -- 收集的数据应该满足6个质量尺寸 - [LeRobot指南]
T29 ) -- 培训 ACT和传播政策 - 机器人数据收集成本分类 -- 预算规划数据收集活动
- 最好的机器人手 2025 --
性质的终端效果器兼容OpenArm - RCSV数据服务 --经营的采集与训练有素的运营商和QA管道
- 机器人租
- 在购买前尝试OpenArm的短期租
相关: OpenArm in Store · [机器人手臂购买指南2026