保姆级避坑指南：在Ubuntu 20.04上搞定AUBO i5机械臂的ROS Noetic驱动（含网络配置）

保姆级避坑指南：在Ubuntu 20.04上搞定AUBO i5机械臂的ROS Noetic驱动（含网络配置）

如果你正在Ubuntu 20.04上尝试为AUBO i5机械臂配置ROS Noetic驱动，却频频在依赖安装、环境变量配置或网络连接环节卡壳，这篇文章就是为你准备的。不同于常规教程的步骤罗列，我们将聚焦那些官方文档未曾提及的"坑点"，从eigen3软链接冲突到libprotobuf9安装失败，从rosdep报错到双网卡配置差异，手把手带你绕过每一个可能让你前功尽弃的陷阱。

1. 环境准备：避开依赖安装的深坑

在开始AUBO ROS驱动配置前，确保你的Ubuntu 20.04已安装ROS Noetic完整版。许多教程会直接让你安装ros-noetic-industrial-*，但这里有几个关键细节需要注意：

# 安装industrial核心包（避免通配符导致的冗余安装） sudo apt install ros-noetic-industrial-core ros-noetic-industrial-msgs

常见陷阱1：eigen3头文件冲突
ROS Noetic默认使用Eigen3，但系统可能存在多个版本。错误的软链接会导致编译失败。正确的处理方式是：

# 检查现有Eigen版本 ls -l /usr/include | grep Eigen # 建立精确软链接（注意路径差异） sudo ln -sf /usr/include/eigen3/Eigen/ /usr/include/Eigen sudo ln -sf /usr/include/eigen3/unsupported/ /usr/include/unsupported

关键验证步骤：
编译时若出现Eigen/Core: No such file错误，尝试：

sudo updatedb locate Eigen/Core | grep include

依赖项安装备忘表：

提示：安装libprotobuf9时，若遇到Hash Sum mismatch错误，可改用阿里云镜像源：

wget http://mirrors.aliyun.com/ubuntu/pool/main/p/protobuf/libprotobuf9v5_2.6.1-1.3_amd64.deb

2. 工作空间配置：源码编译的生存法则

创建aubo_ws工作空间时，90%的失败源于源码下载和rosdep初始化。以下是经过实战验证的最佳实践：

mkdir -p ~/aubo_ws/src cd ~/aubo_ws/src # 使用GitHub镜像加速克隆 git clone https://ghproxy.com/https://github.com/AuboRobot/aubo_robot.git -b Noetic

致命陷阱：rosdep初始化失败
当遇到rosdep update超时，可以：

1. 使用国内镜像源（需先备份原列表）：

   sudo cp /etc/ros/rosdep/sources.list.d/20-default.list /etc/ros/rosdep/sources.list.d/20-default.list.bak sudo sed -i 's/raw.githubusercontent.com/gitee.com\/ros\/rosdistro\/raw/g' /etc/ros/rosdep/sources.list.d/20-default.list

2. 或者使用rosdepc替代（如果你安装过鱼香ROS）：

   rosdepc install -y --from-paths . --ignore-src --rosdistro noetic -r

编译时的黄金检查点：

• 确保catkin_make前已执行：

  cd ~/aubo_ws source /opt/ros/noetic/setup.bash

• 若编译卡在aubo_driver，检查是否遗漏了SDK库：

  ls ~/aubo_ws/src/aubo_robot/aubo_driver/lib/lib64 | grep .so

3. 环境变量配置：那些手册没写的细节

动态链接库配置是连接ROS与机械臂硬件的关键桥梁，也是最容易出错的环节之一。

标准操作流程：

# 进入SDK库目录 roscd aubo_driver/lib/lib64 # 获取绝对路径（注意实际路径可能不同） AUBO_LIB_PATH=$(pwd) # 创建配置文件 sudo tee /etc/ld.so.conf.d/aubo_driver.conf <<EOF ${AUBO_LIB_PATH} ${AUBO_LIB_PATH}/aubocontroller ${AUBO_LIB_PATH}/config ${AUBO_LIB_PATH}/log4cplus EOF # 刷新配置 sudo ldconfig

避坑指南：

• 若出现libaubo_controller.so: cannot open shared object file错误：

  1. 检查路径是否包含中文字符
  2. 确认文件权限：

     sudo chmod 755 ${AUBO_LIB_PATH}/*.so

  3. 验证链接：

     ldd ${AUBO_LIB_PATH}/libaubo_controller.so | grep found

• 对于多用户系统，建议追加到.bashrc：

  echo "export LD_LIBRARY_PATH=${AUBO_LIB_PATH}:\$LD_LIBRARY_PATH" >> ~/.bashrc

4. 网络连接实战：直连vs路由模式

AUBO i5支持两种网络连接方式，每种都有特定的配置要点。

4.1 路由器模式（推荐）

配置步骤：

1. 将机械臂和主机分别接入路由器
2. 查询IP地址：

   # 主机IP ifconfig | grep -A 1 'enp' | grep 'inet' # 机械臂IP（通过示教器查看）

3. 测试连通性：

   ping 192.168.31.83 -c 4

典型问题排查：

• 若ping不通但物理连接正常：

  # 检查ARP缓存 arp -a # 强制刷新 sudo ip neigh flush dev enp3s0

4.2 直连模式（无路由器）

关键差异点：

1. 必须手动设置静态IP：

   # 临时设置（重启失效） sudo ifconfig enp3s0 192.168.31.100 netmask 255.255.255.0

2. 机械臂IP需与主机同网段但不同地址：

   主机：192.168.31.100 机械臂：192.168.31.101

高级技巧：
使用NetworkManager创建专用连接配置：

nmcli con add type ethernet ifname enp3s0 con-name aubo-static ip4 192.168.31.100/24 nmcli con up aubo-static

5. 驱动测试与故障树分析

当一切配置就绪，启动驱动时的常见错误及解决方案：

终极验证流程：

# 终端1：启动驱动 roslaunch aubo_i5_moveit_config moveit_planning_execution.launch robot_ip:=192.168.31.83 # 终端2：实时监控 rostopic echo /joint_states # 终端3：发送测试指令 rosrun aubo_driver aubo_test_node

记得在首次运行时逐步增加关节运动幅度，避免机械臂突然大幅度动作造成危险。