伯克利开源遥操作
来自 UC Berkeley 的开源机器人遥操作项目:用六关节微型控制臂与夹爪扳机示教真实机械臂。本页整理原版 UR5 控制器的论文、MIT 开源代码、八章图解、打印模型与原始采购链接;属于第三方资料整理,尚未完成实物复现。
alan000
arXiv:2309.13037 2023
本教程组装一套 UR5 版 GELLO:控制器的 6 个转轴对应 UR5 六个关节,手柄扳机对应夹爪输入。控制器位置经 Dynamixel 电机读取,软件再把关节位置发给仿真或机械臂。
*总装参考:UR5 专用底座和五节连杆,末端连接 gripper 手柄组件。*
先准备一台 UR5 目标机械臂(或先用仿真)、一台 Linux 电脑、打印件、Dynamixel 电机及 U2D2 控制器。论文网页演示包含双臂任务;本教程只配置一只控制器和一台机械臂。
*来源:[项目官网](https://wuphilipp.github.io/gello_site/);[机械仓库](https://github.com/wuphilipp/gello_mechanical)。*
按原作者 UR5 BOM 核对 8 类采购项:XL330-M288-T 电机 6 台、XL330-M077-T 电机 1 台、U2D2 1 个、U2D2 Power Hub Board Set 1 套、450 mm 三针线 2 根、电源 1 个、橡皮筋 1 包、扳机弹簧 1 包。历史合计 US$272.18;价格、库存和供电产品规格会变化,购买前重新核对厂商页面和现场供电要求。
UR5 版机械文件与共享夹爪文件分别在机械仓库的 `ur5/` 和 `gripper/` 目录。核对目标仓库版本:`8ea3f2e661b55d4a128683b09227f8e771cd729e`。不要用其它机器人目录的底座或连杆替代。
*型号对照照片:舵机标签显示 M288-T 与 M077-T;购买时以 BOM 型号为准。*
**检查**:清点到 7 台电机、U2D2 与电源板组件、两根 450 mm 线,并确认打印件目录是 UR5 与共享夹爪。
*来源:[原作者 BOM 与装配指南](https://docs.google.com/document/d/1bdvqPiW4jI5PJm6aIFizhcTuyVJZGEIgqbJe92IoyaM/edit)(UR5 表);[锁定版机械仓库](https://github.com/wuphilipp/gello_mechanical/tree/8ea3f2e661b55d4a128683b09227f8e771cd729e)。*
在切片软件中分别打开 UR5 目录的 `base.STL`、`L1.STL`–`L5.STL`,以及共享 `gripper/handle.STL`、`gripper/trigger.STL`。原作者指南展示各件建议摆放方向,并说明多数零件建议加支撑;按图中的朝向摆放,清除支撑后再逐件检查孔位。指南没有给出一套通用的层高、填充率或材料参数,需按所用打印机和耗材设置并验证尺寸。
*base*
*L1*
*L2*
*L3*
*L4*
*L5*
*handle*
*trigger*
**检查**:8 件均无裂纹,螺孔、舵机座和弹簧槽未被支撑残留堵塞;试装前对照原作者 UR5 总装图确认件名和位置。打印数量依总装配置各一件,打印前再次与装配图核对。
*来源:原作者 BOM 与装配指南(3D Printed Parts/UR5);[UR5 STL 文件](https://github.com/wuphilipp/gello_mechanical/tree/8ea3f2e661b55d4a128683b09227f8e771cd729e/ur5)。*
先在各电机上贴临时标签,按 BOM 区分 M288-T 关节电机与 M077-T 扳机电机;等第 05 步的供电/板卡资料核实后,再在 Dynamixel Wizard 中设置 ID。断电状态下参照 UR5 完整总装图逐节连接 base、L1–L5 和对应的 M288-T 电机。
1. 用小号十字螺丝刀;电机包装附的短螺丝用于电机舵盘/输出法兰与打印件连接,长螺丝用于电机底座与打印件连接。
2. 从 base 开始,每装一节对照总装图检查关节轴线、舵机壳体方向和连杆次序,再装下一节。
3. 螺丝应能顺畅咬合;Dynamixel 螺丝容易滑牙,遇到阻力或孔位不齐即停,不加力硬拧。
*以此 UR5 完整装配图核对底座、五节连杆和电机的相对位置。*
**检查**:连杆次序和舵机方向与总装图一致;手动缓慢转动时相邻件不碰撞、线缆不夹在接缝中。原讲义未列 UR5 每个孔位所需螺丝尺寸,也没有逐关节爆炸图;若图示仍无法确认某台电机朝向或螺丝长度,先停止该关节装配并核对原图/实物,不凭猜测选螺丝。
*来源:原作者装配指南(Assembly Instructions);锁定版软件 [README](https://github.com/wuphilipp/gello_software/blob/204f53a64bef89471a1e483b0f874f755fbd2d3a/README.md)。*
1. 将 `handle` 固定在 L5 末端,把弹簧放入 `trigger` 的槽内,再将扳机装到 M077-T 电机上,并把弹簧另一端落入手柄预留槽。
2. 在断电状态下,沿连杆运动链逐节连接三针 TTL 电机线;两根 450 mm 线按装配图路径布置。每个接头都插牢,缓慢活动关节时观察线缆,确保不被夹住或拉紧。
3. 按 ROBOTIS Power Hub Board 手册,在板四角装塑料支撑脚,用塑料铆钉固定 U2D2;用 3P 线连接 U2D2 与板,再用三针 TTL 线串接舵机。将控制器固定到底座,板底针脚不要接触金属或桌面。
4. 在 UR 版关节 2 和 4 装橡皮筋,逐步调整至控制臂能稳定停在多个姿势;比较安装前后关节下坠情况。
5. 手动按压并释放扳机,确认弹簧使其顺畅回位;再逐关节缓慢活动,确认没有卡滞。
*手柄*
*扳机与弹簧槽*
**供电检查**:原作者 UR5 BOM 链接电源型号 B078RT3ZPS(ALITOVE 5 V/5 A);XL330-M288-T 与 XL330-M077-T 的官方工作电压为 3.7–6.0 V、推荐 5.0 V。核对适配器铭牌确认为 5 V 后再接。Power Hub Board 的圆孔 DC 输入为中心正极;螺丝端子左负、右正。选择一种供电接口,不可同时接多个输入。供电开关关闭时完成全部接线;通电后禁止插拔电机线。该电源额定 5 A,装置在持续堵转或负载下的总电流需求未由原项目测定;一旦电源保护、异味、异常声响或发热,立即断电,勿继续操作。
*来源:原作者装配指南(Assembly Instructions,Steps 2–5;UR rubber bands)和 UR5 BOM;[ROBOTIS Power Hub Board 手册](https://emanual.robotis.com/docs/en/parts/interface/u2d2_power_hub/);[XL330-M288-T 手册](https://emanual.robotis.com/docs/en/dxl/x/xl330-m288/);[XL330-M077-T 手册](https://emanual.robotis.com/docs/en/dxl/x/xl330-m077/)。*
在 Linux 终端安装 uv 后,克隆软件仓库并切到本教程核对的版本。下列命令来自该版本 README;激活环境后每次新开终端都要再次执行激活命令。
```
git clone https://github.com/wuphilipp/gello_software.git
cd gello_software
git checkout 204f53a64bef89471a1e483b0f874f755fbd2d3a
git submodule update --init --recursive
uv venv --python 3.11
source .venv/bin/activate
uv pip install -r requirements.txt
uv pip install -e .
uv pip install -e third_party/DynamixelSDK/python
```
若子模块目录缺失,先运行 `git submodule update --init --recursive` 后再安装。UR 实机还需要 README 指向的 `ur_rtde` 依赖;先完成仿真验证。
**检查**:安装命令无报错,项目脚本可启动并显示参数帮助;不要在尚未解决上一步供电规格前连接电机。
*来源:[锁定版官方软件 README](https://github.com/wuphilipp/gello_software/blob/204f53a64bef89471a1e483b0f874f755fbd2d3a/README.md);[软件许可证](https://github.com/wuphilipp/gello_software/blob/204f53a64bef89471a1e483b0f874f755fbd2d3a/LICENSE)。*
通电前提:只有找到适配 U2D2 Power Hub Board 的供电/接线手册并核实输出电压、极性和端口对应后,才进行以下电机配置。一次只接一台电机,用 Dynamixel Wizard 扫描并分配唯一 ID,断电换接下一台;全部编号后再串接七台并复扫。从底座到末端给六台 M288-T 分配 ID 1–6,再给 M077-T 分配 ID 7。软件 README 的 UR 配置按此顺序读取关节;扫描列表应恰有 ID 1–7 且无重复。
将 GELLO 与 UR 都放在原作者用于校准的相同关节姿态,使用本机 U2D2 路径运行偏置脚本。此 UR 示例的关节起始角和符号来自锁定版 README;偏置输出属于你自己的设备,不能照抄仓库示例。
*GELLO 侧参考姿态。*
*目标 UR 的关节参考姿态;先核对与所用机型的实际关节位置。*
```
python scripts/gello_get_offset.py \
--start-joints 0 -1.57 1.57 -1.57 -1.57 0 \
--joint-signs 1 1 -1 1 1 1 \
--port /dev/serial/by-id/本机U2D2路径
```
记录脚本输出的 6 个 offset,以及扳机的 open/close 度数;将这些实测值填入 `gello/agents/gello_agent.py` 中你所用串口对应的 `PORT_CONFIG_MAP`,其中 ID 为 1–6,`gripper_config` 指向 ID 7。校准脚本使用 57,600 baud。端口、方向、offset 和扳机端点必须对应本机装配。
完成配置后,先在终端 A 启动仿真:`python experiments/launch_nodes.py --robot sim_ur`;终端 B 使用同一虚拟环境运行:`python experiments/run_env.py --agent gello --gello-port /dev/serial/by-id/本机U2D2路径`。仿真后端明确加载 UR5e 与 Robotiq 2F-85 模型。先单关节小幅移动,核对对应关节、方向和扳机;发现跳动、反向或错位即退出并重新检查校准。
**检查**:Wizard 扫描恰有 ID 1–7、无重复;仿真端每个输入关节对应正确轴,方向一致,扳机开闭正确且无明显跳变。未通过前不连接真实 UR。电源规格未核实时,停在本步骤开始处,不接电、不运行扫描或校准脚本。
*来源:锁定版软件 [README](https://github.com/wuphilipp/gello_software/blob/204f53a64bef89471a1e483b0f874f755fbd2d3a/README.md)、[offset 脚本](https://github.com/wuphilipp/gello_software/blob/204f53a64bef89471a1e483b0f874f755fbd2d3a/scripts/gello_get_offset.py)、[launch_nodes.py](https://github.com/wuphilipp/gello_software/blob/204f53a64bef89471a1e483b0f874f755fbd2d3a/experiments/launch_nodes.py)、[run_env.py](https://github.com/wuphilipp/gello_software/blob/204f53a64bef89471a1e483b0f874f755fbd2d3a/experiments/run_env.py);[Dynamixel Wizard 2 用户指南](https://emanual.robotis.com/docs/en/software/dynamixel/dynamixel_wizard2/)。*
实机前置条件:由接受过该 UR 机型培训的操作者设置现场安全限速、关节范围和工作区域,并验证急停;具体限值须按该机器人及工位风险评估确定。本页未给出可直接套用的安全配置,未完成这项配置时停留在第7步仿真。
只有前一步仿真通过、供电和 UR 控制器配置完成后才进入实机。UR 软件节点会连接真实机械臂:`python experiments/launch_nodes.py --robot ur --robot-ip 实际机器人IP`。另一终端运行录制界面:
```
python experiments/run_env.py --agent gello \
--gello-port /dev/serial/by-id/本机U2D2路径 \
--use-save-interface
```
1. 启动前清空工作空间,确认操作者能立即触及 UR 急停;先用机器人厂商控制台确认目标关节姿态与 GELLO 起始姿态相符。
2. 启动节点后先观察连接状态;如目标机器人位置与控制器位置不匹配,或程序打印较大关节差并退出,不要绕过检查继续运行。
3. 用小幅度、低速的单关节动作逐一确认方向,再测试扳机;任何反向、跳变、碰撞风险或通信中断都立即停止。
4. 通过方向检查后,用 `--use-save-interface` 保存一段短示教。源码默认数据目录是 `~/bc_data`,默认没有启用相机客户端;相机采集需另配置相机节点与同步。
5. 打开输出数据,确认文件已生成,包含关节状态与时间序列;记录机械臂型号、软件 commit、控制器串口、ID、offset 和 joint signs。
**完成检查**:机器人逐关节跟随控制器、扳机开合一致,短序列可读取。此教程尚未实物验证,任何电源规格、校准或现场安全项未确认时都应停在相应步骤。
*来源:锁定版软件 [launch_nodes.py](https://github.com/wuphilipp/gello_software/blob/204f53a64bef89471a1e483b0f874f755fbd2d3a/experiments/launch_nodes.py)、[run_env.py](https://github.com/wuphilipp/gello_software/blob/204f53a64bef89471a1e483b0f874f755fbd2d3a/experiments/run_env.py)、[control_utils.py](https://github.com/wuphilipp/gello_software/blob/204f53a64bef89471a1e483b0f874f755fbd2d3a/gello/utils/control_utils.py)。*