伯克利开源低成本的示教神器GELLO-3.5.2. 遥操AR5 Duo双臂

适用:Ubuntu、GELLO 左右主手(每侧 7 个关节舵机+1 个独立扳机舵机)、双 AR5 MuJoCo 仿真。工程目录为 /home/robot/projects/gello_software。

推荐日常流程:启动仿真 → 两侧主手自然停稳 → 读取主手当前姿态并初始化仿真 → 双臂遥操作。启动不用回车、无需把主手摆到全零;首次校准仍需按提示摆放参考姿态并按回车采样。

1. 软件部署

cd /home/robot/projects/gello_software

source .venv/bin/activate

Rizon Duo-1.png 

2.查找并确认左右设备

逐个插拔 USB 转串口,观察新增的设备名,确定左右。优先记录稳定的 by-id 路径,不依赖会变化的 ttyUSB0/1 顺序。

左边:

Rizon Duo-2.png 

 本次设备记录如下,其他设备必须重新确认:

ls -l /dev/serial/by-id/

ar5-duo-1.png

LEFT_PORT=/dev/serial/by-id/usb-FTDI_USB__-__Serial_Converter_FTBP005L-if00-port0

 右边:

Rizon Duo-3.png 

ls -l /dev/serial/by-id/

ar5-duo-2.png

RIGHT_PORT=/dev/serial/by-id/usb-FTDI_USB__-__Serial_Converter_FTBFA1BD-if00-port0

ls -l "$LEFT_PORT" "$RIGHT_PORT"

ar5-duo-4.png 

 校准前关闭正在占用串口的遥操作程序、串口监视器或 Wizard。

3. 配置文件

每侧参数含义:

参数

内容

port

对应侧串口,左右不可相同

baudrate

本设备为 57600

joint_ids

按 J1~J7 排列的 7 个 ID,不包含扳机

joint_offsets

7 个零点偏移,单位弧度

joint_signs

7 个方向符号,只能是 1 或 -1

gripper_config

[扳机ID, 松开端点角度, 按下端点角度],单位度

home

7 个关节参考角度+1 个归一化夹爪值,共 8 项

calibrated

校准保存后为 true;不代表跟随方向已实测通过

4. 首次校准:每侧单独进行

校准程序只读编码器,不负责关闭扭矩。先支撑主手、手动确认可自由摆动。

cd ~/projects/gello_software/

source .venv/bin/activate

Rizon Duo-6.png 

左侧校准

ar5-duo-5.png    ar5-duo-6.png

python scripts/calibrate_ar5_duo.py \
  --side left \
  --config configs/ar5_duo.json \
  --port /dev/serial/by-id/usb-FTDI_USB__-__Serial_Converter_FTBP005L-if00-port0 \
  --baudrate 57600 \
  --ids 1 2 3 4 5 6 7 8 \
  --signs 1 1 1 1 1 1 1 \
  --droop-reference

ar5-duo-13.png 

按提示完成:确认设备并回车 → 摆到 left.home 对应姿态、松开扳机并保持稳定,回车 → 手臂保持不动、完全按下扳机,回车。

采样有效后自动备份 JSON 并只更新 left,保留右侧及其他字段。

右侧校准

ar5-duo-7.png     ar5-duo-8.png

python scripts/calibrate_ar5_duo.py \
  --side right \
  --config configs/ar5_duo.json \
  --port /dev/serial/by-id/usb-FTDI_USB__-__Serial_Converter_FTBFA1BD-if00-port0 \
  --baudrate 57600 \
  --ids 1 2 3 4 5 6 7 8 \
  --signs 1 1 1 1 1 1 1 \
  --droop-reference

ar5-duo-14.png 

5. 日常启动与遥操作(两个终端)

终端一:仿真服务

cd ~/projects/gello_software/

source .venv/bin/activate

Rizon Duo-13.png 

确认窗口打开,加载的是 Rizon 场景,服务持续运行。

python experiments/launch_nodes.py --robot sim_T_ar5_duo

 ar5-duo-11.png

 

终端二:双臂主手客户端

cd /home/robot/projects/gello_software

source .venv/bin/activate

Rizon Duo-16.png 

python3 experiments/run_env.py \
  --agent gello \
  --bimanual \
  --duo-config configs/ar5_duo.json \
  --master-pose-start

 ar5-duo-12.png