伯克利开源低成本的示教神器GELLO-3.7.3.Rizon Duo 双臂(前侧安装版)
GELLO Rizon Duo 主手,控制同一个 MuJoCo 场景里的Rizon Duo 。
首次使用依次完成第 1~3步;校准成功后,日常使用直接看第 4 步。不要每次开机都重新校准。
1. 软件和硬件
打开终端:
cd ~/projects/gello_software/
source .venv/bin/activate

2. 搜索 USB 串口并确认左右
主手接好供电和 USB。
左边:

右边:

执行:
ls -l /dev/serial/by-id/
设备应出现:

2.1 左手校准“零位校准”
支撑好主手,输入以下指令:
python scripts/calibrate_rizon_duo_json.py \ --side left \ --config /home/robot/projects/gello_software/configs/rizon_duo.json \ --port /dev/serial/by-id/usb-FTDI_USB__-__Serial_Converter_FTBEIV48-if00-port0 \ --baudrate 57600 \ --ids 1 2 3 4 5 6 7 8 \ --signs 1 1 1 1 1 1 1
1.将左侧六关节摆到表中左侧参考姿态。
2.完全松开扳机,保持姿态,按 Enter 采样。
3.六关节继续保持不动,完全按下扳机,按 Enter 再采样。
4.等待保存成功和备份路径提示。


2.2 右手校准
python scripts/calibrate_rizon_duo_json.py \ --side right \ --config /home/robot/projects/gello_software/configs/rizon_duo.json \ --port /dev/serial/by-id/usb-FTDI_USB__-__Serial_Converter_FTC2OLT1-if00-port0 \ --baudrate 57600 \ --ids 1 2 3 4 5 6 7 8 \ --signs -1 -1 -1 -1 -1 -1 -1
同样先摆右侧参考姿态,再采样扳机松开和按下两端点。


出现 Arm moved during trigger sampling 表示采扳机时六关节移动过大
3. 参数说明
配置文件 configs/rizon_duo.json
参数 | 内容 |
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. 日常快速启动:两个终端
已完成设备绑定和校准的用户,每次执行以下流程即可。
终端 1:启动仿真服务
cd ~/projects/gello_software/
source .venv/bin/activate
python3 experiments/launch_nodes.py --robot sim_rizon_duo
窗口打开后应看到双臂模型,终端显示类似:
sim_ur_duo ready: tcp://127.0.0.1:6001; state/action=14, nq=28, nu=14

保持终端和 MuJoCo 窗口打开。
终端 2:接入真实双主手
先支撑好主手,让两侧处于自然、稳定的姿态,再执行:
cd ~/projects/gello_software/
source .venv/bin/activate

python experiments/run_env.py \ --agent gello \ --bimanual \ --duo-config configs/rizon_duo.json \ --master-pose-start
预期看到两个串口均初始化成功,然后:
Master-pose startup: 14 values, 6 arm joints per side. Hold still for one second.Simulation matched to masters; grippers follow trigger targets.

此时开始缓慢移动主手,仿真中的从手Rizon Duo开始随动。
