<think>我们正在为PiPER机械臂在Ubuntu 22.04上使用ROS2 Humble进行手眼标定编写保姆级教程。教程需要包含完整命令和避坑点。我们将参考提供的引用内容，特别是引用[1]和引用[2]。 引用[1]提到，教程将涵盖“眼在手上”与“眼在手外”两种配置，但我们这里可能不区分，因为用户没有指定，我们以通用流程为主。 引用[2]强调了在Ubuntu 22.04上安装ROS2 Humble的注意事项，特别是使用纯净系统和避免依赖冲突。 根据之前的回答，我们已经有一个初步的步骤，但需要根据引用内容进行完善和调整。 步骤规划： 1. 系统与环境准备（强调纯净系统，安装ROS2 Humble，注意镜像源） 2. 安装依赖（包括标定所需的ROS包） 3. 标定板准备（说明标定板要求） 4. 创建工作空间并获取代码（从PiPER的代码仓库获取） 5. 编译工作空间 6. 启动机械臂和相机节点 7. 运行手眼标定程序 8. 数据采集与验证 9. 保存标定结果 10. 避坑点总结 注意：由于用户要求保姆级教程，我们需要详细说明每一步，特别是命令和可能出错的地方。 根据引用[2]，安装ROS2时，大陆用户可能需要替换镜像源，我们将提供替换镜像源的方法（例如使用清华源或中科大源）。 另外，在避坑点中，我们将强调网络问题、权限问题、数据采集注意事项等。 由于引用[3]提到也可以在Ubuntu 20.04上进行，但用户指定了22.04，所以我们只关注22.04。 开始编写教程： </think> ### 保姆级教程：在Ubuntu 22.04上用ROS2 Humble给PiPER机械臂做手眼标定 （附完整命令与避坑点） --- #### **1. 系统与环境准备** **避坑点**：90%的问题源于依赖冲突，**必须使用纯净Ubuntu 22.04系统**[^2]。 ```bash # 1.1 设置ROS2软件源（大陆用户替换镜像源加速） sudo apt update && sudo apt install curl gnupg lsb-release 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] https://mirrors.tuna.tsinghua.edu.cn/ros2/ubuntu jammy main" | sudo tee /etc/apt/sources.list.d/ros2.list > /dev/null # 清华源 # 1.2 安装ROS2 Humble完整版（含编译工具） sudo apt update && sudo apt install ros-humble-desktop python3-colcon-common-extensions # 1.3 永久生效环境变量 echo "source /opt/ros/humble/setup.bash" >> ~/.bashrc source ~/.bashrc ``` --- #### **2. 安装标定专用依赖** ```bash # 安装视觉标定核心组件 sudo apt install ros-humble-camera-calibration-parsers \ ros-humble-cv-bridge \ ros-humble-image-transport \ ros-humble-vision-msgs # 新增关键依赖 ``` --- #### **3. 标定板准备** - **规格要求**： - 推荐使用**棋盘格标定板**（如8×6网格） - 打印尺寸 ≥ A4纸，确保图案清晰无变形 - 固定标定板在机械臂工作区域内 - **避坑点**：环境光线需均匀，避免反光/阴影影响识别[^1]。 --- #### **4. 搭建PiPER工作空间** ```bash # 4.1 创建工作空间 mkdir -p ~/piper_ws/src && cd ~/piper_ws/src # 4.2 克隆官方代码库（替换<REPO_URL>为实际地址） git clone <REPO_URL> # 例：https://github.com/piper-robotics/piper_ros2.git # 4.3 安装缺失依赖 rosdep install --from-paths . --ignore-src -y # 4.4 编译工作空间 cd ~/piper_ws && colcon build --symlink-install source install/setup.bash ``` --- #### **5. 启动标定程序** ```bash # 5.1 启动机械臂与相机（眼在手上配置） ros2 launch piper_bringup hand_eye_calibration.launch.py # 5.2 启动标定节点（新终端） source ~/piper_ws/install/setup.bash ros2 run piper_hand_eye_calibration calibration_node \ --calibration_type eye_in_hand # 眼在手外用eye_to_hand ``` --- #### **6. 数据采集流程** 1. **终端按提示操作**： ``` [INFO] 移动机械臂至位置 1/20... [INFO] 检测到标定板，按Enter保存数据 ``` 2. **采集要求**： - 至少采集**15组不同位姿**数据（位姿差异需明显） - 确保标定板始终在相机视野内且占比>40% - 避免机械臂运动模糊（单次移动后暂停1秒） --- #### **7. 验证与保存结果** ```bash # 7.1 查看标定误差（需<0.5像素） ros2 topic echo /calibration_report # 7.2 保存结果到YAML文件 ros2 service call /save_calibration_result \ piper_interfaces/srv/SaveCalibrationResult \ "{file_path: '/home/$USER/calibration_result.yaml'}" ``` --- #### **8. 关键避坑点总结** 1. **依赖冲突**： - 禁止混装ROS1/ROS2版本，必须纯净系统[^2] - 安装失败时执行：`sudo apt install -f` 2. **标定数据问题**： - 误差过大 → 重新采集并检查标定板平整度 - 无法识别标定板 → 调整环境光线/相机焦距 3. **权限问题**： - USB设备权限：`sudo usermod -aG dialout $USER` - 重启后生效：`sudo reboot` 4. **网络超时**： - 替换`raw.githubusercontent.com`为`ghproxy.com`加速 - 示例：`https://ghproxy.com/https://raw.githubusercontent.com/...` ---