Ubuntu 22.04安装Realsense SDK及ROS2 Humble完全指南（从零开始配置Intel RealSense相机与点云数据获取）

一、准备工作：了解你的系统环境

在开始之前，我们需要确认一些基础信息，确保一切顺利进行。

• 操作系统: Ubuntu 22.04 LTS (Jammy Jellyfish)。这是ROS2 Humble官方支持的版本。
• ROS2版本: Humble Hawksbill。这是Ubuntu 22.04对应的长期支持(LTS)版本-5。
• 相机型号: 教程以最常见的 Intel RealSense D435 为例，但步骤也适用于D415、D455等其他型号-1。
• 检查内核: 打开终端，输入 uname -r 查看内核版本。Ubuntu 22.04初始内核通常为5.15，这对于通过包管理器安装（DKMS方式）兼容性最好-2。
• 重要提示: 建议先关闭BIOS中的Secure Boot，因为它可能会阻止驱动模块（DKMS）的正常加载-9。

二、安装Intel RealSense SDK（librealsense）

安装SDK主要有两种方式：一种是简单的包管理器安装（DKMS），另一种是灵活的源码编译安装。对于大多数新手用户，我们强烈推荐第一种方法。

方法一：通过DKMS预编译包安装（新手推荐）

这种方式最为简单快捷，系统会自动处理与内核的适配问题-2-3。

1. 添加Intel RealSense软件源首先，我们需要将官方的仓库添加到你的系统中。

   sudo mkdir -p /etc/apt/keyringscurl -sSf https://librealsense.intel.com/Debian/librealsense.pgp | sudo tee /etc/apt/keyrings/librealsense.pgp > /dev/nullsudo apt-get install apt-transport-https -yecho "deb [signed-by=/etc/apt/keyrings/librealsense.pgp] https://librealsense.intel.com/Debian/apt-repo jammy main" | sudo tee /etc/apt/sources.list.d/librealsense.listsudo apt-get update

2. 安装核心库和工具接下来，安装DKMS内核驱动、实用工具以及可选的开发库。

   sudo apt-get install librealsense2-dkms -ysudo apt-get install librealsense2-utils -ysudo apt-get install librealsense2-dev -y   # 如果你需要自己编写程序，这个包是必须的

3. 验证SDK安装安装完成后，在终端输入以下命令启动Realsense查看器：

   realsense-viewer

   如果一切正常，你会看到一个图形界面，并能看到相机的彩色和深度画面。这表示你的Ubuntu 22.04安装Realsense SDK成功了！注意：如果realsense-viewer无法打开或看不到图像，请检查相机是否连接到USB 3.0端口（通常是蓝色接口）-2。

方法二：源码编译安装（可选）

如果你遇到内核兼容性问题，或者想要体验最新特性，可以选择此方法-2-9。

1. 安装依赖项：sudo apt-get install git cmake build-essential libssl-dev libusb-1.0-0-dev libudev-dev pkg-config libgtk-3-dev -y
2. 克隆仓库：git clone https://github.com/IntelRealSense/librealsense.git
3. 进入目录并设置udev规则：cd librealsense && sudo ./scripts/setup_udev_rules.sh
4. 应用内核补丁（重要）：sudo ./scripts/patch-realsense-ubuntu-lts-hwe.sh-7
5. 编译安装：mkdir build && cd build && cmake .. && make -j$(nproc) && sudo make install
6. 最后运行 sudo ldconfig 更新库缓存，同样用 realsense-viewer 验证。

三、安装ROS2 Humble环境

这部分假设你已经安装了ROS2 Humble。如果没有，请先按照ROS2官方文档完成“桌面版（Desktop）”的安装。

四、在ROS2 Humble中安装Realsense ROS驱动

同样，这里有apt包管理器安装和源码编译两种方式。为了保持简单并减少依赖问题，我们依然首选包管理器安装-3。

4.1 使用apt安装ROS2驱动（最简单）

sudo apt-get install ros-humble-realsense2-camera -ysudo apt-get install ros-humble-realsense2-description -y # 可选，用于机器人模型描述

这个命令会自动安装所有依赖，包括与ROS2接口相关的包。安装完成后，ROS2环境下使用Realsense相机所需的核心驱动就已经就绪了。

4.2 从源码编译ROS2驱动（进阶）

如果apt安装失败，或者你需要使用最新的未发布分支，可以尝试源码编译-1-8。

1. 创建工作空间并克隆代码：

   mkdir -p ~/ros2_ws/srccd ~/ros2_ws/srcgit clone https://github.com/IntelRealSense/realsense-ros.gitcd realsense-rosgit checkout git tag | grep -E "^4\.[0-9]+\.[0-9]+$" | sort -V | tail -1 # 切换到最新的稳定版本标签

2. 安装依赖并编译：

   cd ~/ros2_wssudo apt-get install python3-rosdep -ysudo rosdep initrosdep updaterosdep install -i --from-path src --rosdistro humble -ycolcon build --symlink-install

3. 编译完成后，别忘了source工作空间：echo "source ~/ros2_ws/install/setup.bash" >> ~/.bashrc

五、启动相机并在ROS2中查看数据

现在，激动人心的时刻到了！让我们启动相机节点，看看我们的劳动成果。

5.1 启动Realsense节点

在终端中运行以下命令：

source /opt/ros/humble/setup.bashsource ~/.bashrc # 如果你把工作空间的source写入了bashrcros2 launch realsense2_camera rs_launch.py

你会看到终端开始输出日志信息，表示节点正在启动-1。

5.2 查看正在发布的Topic

打开另一个终端，输入：

ros2 topic list

你会看到类似下面的列表，这些都是相机发布的数据话题-5：

• /camera/camera/color/image_raw (彩色图像)
• /camera/camera/depth/image_rect_raw (深度图像)
• /camera/camera/depth/color/points (点云数据，这是最重要的！)
• /camera/camera/imu (如果相机支持IMU，如D435i)

5.3 可视化点云数据

为了直观地看到ROS2相机点云数据，我们可以使用ROS2的可视化工具RViz2。

1. 启动RViz2：rviz2
2. 在RViz2界面下方，点击“Add”按钮，选择“By topic”选项卡，然后找到 /camera/camera/depth/color/points 话题，选中它并点击“OK”。
3. 你可能会看到一个平面的点云，在RViz2左侧的Displays面板中，找到刚才添加的PointCloud2，将“Fixed Frame”选项设置为 camera_link 或 camera_color_optical_frame。

现在，你应该能看到相机视野内的三维点云世界了！这代表你的整个环境配置已经大功告成。

六、常见问题排查

• 找不到设备或权限问题: 确保你执行了 sudo ./scripts/setup_udev_rules.sh（源码安装时）并重新插拔相机。或者将你的用户加入 plugdev 组-9。
• DKMS安装失败: 这通常由内核版本不匹配引起。尝试运行 sudo apt-get install --reinstall librealsense2-dkms 并查看错误日志-2-3。如果问题依旧，可以考虑切换到源码编译安装SDK。
• ROS2驱动编译时报错找不到realsense2: 这表示系统找不到librealsense SDK。确认SDK已成功安装（pkg-config --modversion librealsense2），并检查是否因为自定义安装路径导致CMake找不到-8。
• RViz2中看不到图像或点云: 检查RViz2的“Fixed Frame”设置是否正确。另外，确认你的电脑性能是否足够，点云处理比较消耗资源-6。

总结

恭喜你！通过本教程，你已经成功在 Ubuntu 22.04 上安装了 Intel RealSense SDK，并配置好了 ROS2 Humble 下的相机驱动。你现在可以获取包括彩色、深度和 点云数据 在内的所有信息，为你的机器人视觉项目打下了坚实的基础。接下来的旅程，就可以尽情探索物体识别、SLAM等更高级的应用了！