当前位置：首页 > news >正文

LeRobot主从臂校准全流程：从端口号设置到远程操作实战

news 2026/4/19 7:13:29

LeRobot主从臂校准全流程：从端口号设置到远程操作实战

在机器人控制领域，主从臂系统因其直观的操作方式和精确的同步性能，正逐渐成为工业自动化、医疗手术和教育研究的热门选择。LeRobot作为一个开源的机器人控制项目，通过其简洁的API和模块化设计，让开发者能够快速搭建并调试主从臂系统。本文将深入解析LeRobot项目中主从臂校准的全流程，从硬件连接到远程操作，为初学者提供一份详实的操作指南。

1. 环境准备与硬件连接

在开始主从臂校准前，确保你的开发环境满足以下基本要求：

操作系统：推荐使用原生Linux系统（如Ubuntu 20.04+），避免使用虚拟机环境以减少潜在的硬件兼容性问题
Python版本：3.10及以上
硬件设备：SO-100主从臂套件、USB数据线、电源适配器

安装LeRobot项目依赖的步骤如下：

git clone https://github.com/huggingface/lerobot.git ~/lerobot conda create -y -n lerobot python=3.10 conda activate lerobot cd lerobot && pip install -e ".[feetech]"

注意：如果遇到OpenCV版本冲突问题，可先卸载现有版本再重新安装：
pip uninstall -y opencv-python conda install -y -c conda-forge "opencv>=4.10.0"

2. 端口号识别与配置

主从臂系统的稳定通信依赖于正确的端口号设置。LeRobot通过USB接口与机械臂控制器通信，在Linux系统中，这些设备通常被识别为/dev/ttyACM*。以下是确定和配置端口号的详细步骤：

同时连接主臂和从臂的USB接口到计算机

运行端口检测脚本：

python lerobot/scripts/find_motors_bus_port.py

依次拔插主从臂USB线，观察端口变化：
- 先拔掉主臂USB，按回车确认，记录显示的端口号
- 重新连接主臂USB
- 再拔掉从臂USB，按回车确认，记录显示的端口号

典型的端口分配结果如下：

设备类型	默认端口号	备注
主臂	/dev/ttyACM0	建议优先连接
从臂	/dev/ttyACM1	后连接

确认端口号后，需要修改LeRobot的配置文件so100.yaml，确保其中的端口设置与实际检测结果一致。同时，为方便后续操作，建议固定USB连接顺序：先连接主臂，再连接从臂。

3. 权限设置与校准准备

在Linux系统中，直接访问USB设备通常需要root权限。为了避免每次操作都使用sudo，可以临时修改设备文件的权限：

sudo chmod 777 /dev/ttyACM0 sudo chmod 777 /dev/ttyACM1

提示：这种权限设置方式在系统重启后会失效。如需永久生效，可以考虑将当前用户加入dialout组：
sudo usermod -a -G dialout $USER

校准前还需确保：

机械臂供电稳定
所有舵机连接线牢固（松动的连接线是校准失败的常见原因）
工作区域有足够的空间供机械臂移动

4. 从臂校准流程

从臂校准是确保主从系统同步精度的关键步骤。LeRobot采用三点校准法，通过让从臂移动到三个特定位置来建立坐标系映射。执行以下命令开始从臂校准：

python lerobot/scripts/control_robot.py calibrate \ --robot-path lerobot/configs/robot/so100.yaml \ --robot-overrides '~cameras' \ --arms main_follower

校准过程中，终端会显示详细的图文指引，要求你将从臂依次移动到：

初始位置：所有关节处于中间角度
最大伸展位置：机械臂完全展开
特定转角位置：测试各关节极限

每个位置确认后，系统会记录当前舵机角度值，用于构建运动学模型。如果遇到舵机无响应或报错，首先检查：

舵机电源指示灯是否亮起
数据线连接是否牢固
端口权限设置是否正确

5. 主臂校准操作

主臂校准过程与从臂类似，但目的不同：主臂校准主要是建立操作者手柄或主臂与从臂之间的运动映射关系。使用以下命令启动主臂校准：

python lerobot/scripts/control_robot.py calibrate \ --robot-path lerobot/configs/robot/so100.yaml \ --robot-overrides '~cameras' \ --arms main_leader

主臂校准同样需要三个关键位姿：

中立位：操作手柄或主臂的初始位置
最大位移位：测试各方向最大操作范围
旋转测试位：验证旋转运动的灵敏度

校准过程中，建议缓慢移动主臂，观察从臂的跟随情况。如果发现跟随延迟或偏差过大，可能需要重新检查主从臂的机械零点是否一致。

6. 远程操作实现

完成主从臂校准后，即可体验LeRobot的远程操作功能。以下命令启动不带相机反馈的基础远程操作系统：

python lerobot/scripts/control_robot.py teleoperate \ --robot-path lerobot/configs/robot/so100.yaml \ --robot-overrides '~cameras' \ --display-cameras 0

系统启动后，移动主臂，从臂应实时跟随。为获得最佳操作体验，建议：