Ubuntu 20.04上D435i驱动安装踩坑实录：从SDK2.0到ROS包，我遇到的5个问题及解法

Ubuntu 20.04上D435i驱动安装实战：5个典型问题深度解析与解决方案

当你在Ubuntu 20.04上尝试为Intel RealSense D435i深度相机配置开发环境时，可能会遇到各种意想不到的问题。这篇文章不是又一篇按部就班的安装教程，而是聚焦于那些官方文档很少提及的"坑"，以及如何系统性地解决它们。无论你是第一次接触RealSense设备，还是已经在这个生态系统中工作了一段时间的开发人员，这些实战经验都能帮你节省大量调试时间。

1. 环境准备与基础配置检查

在开始安装之前，确保你的系统环境已经做好了充分准备。很多问题其实源于基础配置的不完整或冲突。

首先检查你的Ubuntu 20.04系统是否已经更新到最新状态：

sudo apt update && sudo apt upgrade -y sudo apt dist-upgrade -y

对于RealSense D435i这样的深度相机，内核模块的支持至关重要。运行以下命令检查当前内核版本：

uname -r

常见问题1：内核版本过旧可能导致设备无法被正确识别。建议使用5.4或更高版本的内核。

接下来，安装一些基础开发工具和依赖库：

sudo apt install -y build-essential git cmake libssl-dev libusb-1.0-0-dev pkg-config libgtk-3-dev

特别需要注意的是，RealSense设备需要特定的USB权限。创建以下udev规则文件：

echo 'SUBSYSTEM=="usb", ATTR{idVendor}=="8086", MODE="0666"' | sudo tee /etc/udev/rules.d/99-realsense.rules sudo udevadm control --reload-rules && sudo udevadm trigger

提示：如果后续遇到设备权限问题，可以尝试重新插拔设备或重启系统使新规则生效。

2. SDK安装过程中的常见问题

RealSense SDK提供了两种主要安装方式：通过APT仓库和源码编译。每种方式都有其特定的适用场景和潜在问题。

2.1 APT安装方式的问题排查

官方推荐的APT安装方式通常是最简单的，但也可能遇到以下问题：

sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-key F6E65AC044F831AC80A06380C8B3A55A6F3EFCDE sudo add-apt-repository "deb https://librealsense.intel.com/Debian/apt-repo $(lsb_release -cs) main" -u sudo apt install librealsense2-dkms librealsense2-utils librealsense2-dev

常见问题2：密钥服务器连接失败。如果遇到keyserver.ubuntu.com无法访问的情况，可以尝试以下替代方案：

sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-key F6E65AC044F831AC80A06380C8B3A55A6F3EFCDE

安装完成后，验证SDK是否正常工作：

realsense-viewer

如果启动后看不到设备，尝试以下诊断步骤：

1. 检查设备是否被系统识别：

   lsusb | grep 8086

2. 查看内核模块是否加载：

   lsmod | grep uvcvideo

2.2 源码编译安装的注意事项

对于需要自定义功能或调试的开发场景，源码编译可能是更好的选择。但这种方式也更容易遇到编译错误和环境问题。

首先克隆官方仓库：

git clone https://github.com/IntelRealSense/librealsense.git cd librealsense

编译前需要安装额外的依赖：

sudo apt install -y libglfw3-dev libgl1-mesa-dev libglu1-mesa-dev

常见问题3：OpenGL相关错误。如果遇到与GL相关的编译错误，确保安装了上述开发包，并检查你的显卡驱动是否正确安装。

编译和安装步骤：

mkdir build && cd build cmake .. -DBUILD_EXAMPLES=true -DCMAKE_BUILD_TYPE=Release make -j$(nproc) sudo make install

注意：在虚拟机环境中编译时，可能会因为缺少物理USB控制器而导致设备无法访问。建议在物理机上安装。

3. ROS集成中的疑难问题

将RealSense设备集成到ROS环境中时，会遇到一些特有的挑战。以下是几个最常见的问题及其解决方案。

3.1 ROS包安装方式选择

有两种主要方式安装RealSense ROS包：

1. 二进制安装（推荐大多数用户）：

   sudo apt install ros-$ROS_DISTRO-realsense2-camera ros-$ROS_DISTRO-realsense2-description

2. 源码编译（需要自定义功能时使用）：

   cd ~/catkin_ws/src git clone https://github.com/IntelRealSense/realsense-ros.git git clone https://github.com/pal-robotics/ddynamic_reconfigure.git cd ~/catkin_ws && catkin_make -DCMAKE_BUILD_TYPE=Release

常见问题4：ROS包版本与SDK版本不兼容。确保你安装的ROS包版本与你已安装的librealsense2 SDK版本兼容。可以通过以下命令检查SDK版本：

rs-enumerate-devices | grep "Firmware Version"

3.2 设备在ROS中不可见

如果在roslaunch realsense2_camera rs_camera.launch后看不到设备，尝试以下步骤：

1. 首先确认设备能被SDK识别：

   realsense-viewer

2. 检查ROS环境变量是否正确设置：

   echo $ROS_PACKAGE_PATH

3. 尝试以调试模式启动节点查看详细日志：

   ROS_LOG_DIR=~/.ros/log roslaunch realsense2_camera rs_camera.launch

4. 视频流与设备识别问题

RealSense D435i作为多功能传感器，可能遇到各种视频流和识别问题，特别是在多设备环境下。

4.1 V4L2相关问题的诊断

常见问题5：Cannot identify device '/dev/videoX'错误。这通常与V4L2子系统有关。

首先安装必要的工具：

sudo apt install v4l-utils

然后列出所有视频设备：

v4l2-ctl --list-devices

如果设备未被正确识别，尝试手动加载相关内核模块：

sudo modprobe uvcvideo sudo modprobe videobuf2-core sudo modprobe videobuf2-v4l2

对于更深入的诊断，可以检查内核日志：

dmesg | grep uvc

4.2 GStreamer警告的处理

RealSense SDK和ROS包底层使用GStreamer处理视频流，可能会遇到相关警告。虽然这些警告通常不影响功能，但了解其含义有助于排查真正的问题。

典型的GStreamer警告可能包括：

• GStreamer warning: Embedded video playback halted
• GStreamer warning: unable to start pipeline

要减少这些警告，可以尝试：

1. 安装完整的GStreamer插件集：

   sudo apt install gstreamer1.0-plugins-good gstreamer1.0-plugins-bad gstreamer1.0-plugins-ugly

2. 在启动ROS节点时指定不同的视频后端：

   roslaunch realsense2_camera rs_camera.launch gstreamer_enabled:=false

5. IMU数据同步与校准问题

D435i相比D435增加了IMU单元，这带来了额外的配置和校准需求。

5.1 IMU数据不同步

IMU和相机数据的时间同步是一个常见挑战。可以通过以下方式改善：

1. 在启动ROS节点时启用时间同步：

   roslaunch realsense2_camera rs_camera.launch enable_sync:=true

2. 检查IMU数据频率是否正常：

   rostopic hz /camera/accel/sample /camera/gyro/sample

5.2 设备校准的重要性

RealSense设备出厂时已经过校准，但在某些情况下可能需要重新校准：

1. 使用官方校准工具：

   realsense-viewer

   然后在菜单中选择"Calibration"选项。

2. 对于更高级的校准需求，可以使用动态校准：

   roslaunch realsense2_camera rs_camera.launch calibrate_imu:=true

重要提示：校准过程应在稳定的环境中进行，避免振动和强光干扰。

6. 性能优化与高级配置

为了获得最佳性能，特别是在资源受限的系统上，可以考虑以下优化措施。

6.1 流配置优化

根据应用需求选择合适的流配置可以显著提高性能。例如，对于不需要RGB图像的应用：

roslaunch realsense2_camera rs_camera.launch enable_color:=false

或者限制深度图分辨率：

roslaunch realsense2_camera rs_camera.launch depth_width:=640 depth_height:=480

6.2 内核参数调整

对于高帧率应用，可能需要调整USB相关内核参数：

echo 'options uvcvideo quirks=0x100' | sudo tee /etc/modprobe.d/uvcvideo.conf sudo modprobe -r uvcvideo && sudo modprobe uvcvideo

6.3 电源管理禁用

为防止USB自动挂起导致设备断开，禁用相关电源管理：

echo 'ACTION=="add", SUBSYSTEM=="usb", TEST=="power/control", ATTR{power/control}="on"' | sudo tee /etc/udev/rules.d/10-usb-power.rules