Ubuntu 20.04深度相机配置实战：Realsense SDK与ROS避坑全攻略
深度相机在机器人、三维重建和增强现实等领域的应用越来越广泛，而Intel Realsense系列因其出色的性能和相对亲民的价格，成为许多开发者的首选。但在Ubuntu 20.04上配置Realsense环境时，不少开发者都会遇到各种"坑"。本文将分享我在多个项目中积累的实战经验，帮你避开那些常见的陷阱。
1. 内核模块签名冲突：安装过程中的第一道坎
当你兴致勃勃地开始安装Realsense SDK时，可能会在sudo apt-get install librealsense2-dkms这一步遇到内核模块签名验证失败的问题。Ubuntu 20.04默认启用了安全启动(Secure Boot)，这会导致第三方内核模块无法加载。
典型错误信息：
modprobe: ERROR: could not insert 'videodev': Required key not available解决方案有两种路径可选：
临时禁用安全启动（适合快速验证）：
sudo mokutil --disable-validation重启后，在BIOS界面选择"Disable Secure Boot"
永久解决方案（推荐生产环境使用）：
sudo apt-get install linux-headers-$(uname -r) sudo apt-get install librealsense2-dkms sudo /usr/lib/dkms/dkms_autoinstaller start
提示：如果使用NVIDIA显卡，可能需要先安装专有驱动，否则可能导致显示异常
2. T265相机兼容性问题：版本选择的艺术
Realsense T265追踪相机是许多SLAM项目的核心传感器，但如果你直接安装最新版SDK，可能会发现设备无法识别。这是因为从v2.54.1开始，Intel官方移除了对T265的支持。
版本选择策略：
| 相机型号 | 推荐SDK版本 | 备注 |
|---|---|---|
| D400系列 | 最新版 | 建议使用v2.50.0+ |
| T265 | v2.54.0或更早 | 最后一个支持版本 |
降级安装步骤：
# 先卸载现有版本 sudo apt-get remove librealsense2* # 安装特定版本 wget https://github.com/IntelRealSense/librealsense/releases/download/v2.54.0/librealsense2-utils_2.54.0-1~focal_amd64.deb sudo dpkg -i librealsense2-utils_2.54.0-1~focal_amd64.deb3. ROS包编译失败：ddynamic_reconfigure的陷阱
当你尝试从源码编译realsense-ros包时，可能会遇到如下编译错误：
CMake Error at /usr/share/cmake-3.16/Modules/FindPkgConfig.cmake:463 Could not find a package configuration file provided by "ddynamic_reconfigure"问题根源在于ddynamic_reconfigure包的安装方式冲突。以下是经过验证的解决方案：
方法一（简单直接）：
sudo apt-get install ros-noetic-ddynamic-reconfigure然后确保工作空间中没有ddynamic_reconfigure的源码副本
方法二（源码编译）：
cd ~/realsense_ws/src git clone https://github.com/pal-robotics/ddynamic_reconfigure.git但要确保系统没有通过apt安装过该包
注意：千万不要同时使用apt安装和源码编译两种方式，这必然会导致冲突
4. 设备识别异常：USB权限与内核模块加载
即使安装成功，运行realsense-viewer时设备列表仍可能为空。这种情况通常与USB权限或内核模块加载有关。
排查步骤：
检查设备是否被系统识别：
lsusb | grep Intel应该能看到类似"Intel Corp. RealSense..."的输出
确保udev规则已正确安装：
sudo cp ~/librealsense/config/99-realsense-libusb.rules /etc/udev/rules.d/ sudo udevadm control --reload-rules && sudo udevadm trigger验证内核模块加载：
dmesg | grep uvc正常应该看到"Found UVC"相关信息
常见问题处理表：
| 现象 | 可能原因 | 解决方案 |
|---|---|---|
| 设备列表为空 | 权限不足 | 将用户加入video组：sudo usermod -aG video $USER |
| 频繁断开连接 | USB供电不足 | 使用带外接供电的USB Hub |
| 深度数据异常 | 红外干扰 | 关闭环境中的其他红外光源 |
5. ROS话题无数据：launch文件配置秘籍
即使所有安装步骤都顺利完成，启动ROS节点后仍可能收不到任何数据。这通常是由于默认launch文件配置较为保守，许多传感器数据流默认是关闭的。
关键配置参数（编辑rs_camera.launch文件）：
<!-- 启用深度流 --> <arg name="enable_depth" default="true"/> <arg name="depth_width" default="640"/> <arg name="depth_height" default="480"/> <arg name="depth_fps" default="30"/> <!-- 启用IMU数据 --> <arg name="enable_gyro" default="true"/> <arg name="enable_accel" default="true"/> <arg name="gyro_fps" default="400"/> <arg name="accel_fps" default="400"/> <!-- 统一IMU话题 --> <arg name="unite_imu_method" default="linear_interpolation"/>优化后的启动命令：
roslaunch realsense2_camera rs_camera.launch \ enable_depth:=true \ enable_gyro:=true \ enable_accel:=true \ unite_imu_method:="linear_interpolation"6. 性能调优与高级技巧
当基本功能正常后，你可能还需要进一步优化相机性能。以下是几个实用技巧：
深度质量提升：
# 设置深度预设为高精度模式 rosrun dynamic_reconfigure dynparam set /camera/stereo_module preset 3降低CPU占用：
# 禁用点云生成（如需点云可在ROS中后期处理） roslaunch realsense2_camera rs_camera.launch enable_pointcloud:=false多相机同步（需要硬件同步模块）：
roslaunch realsense2_camera rs_camera.launch \ serial_no:="<相机1序列号>" \ enable_sync:=true & \ roslaunch realsense2_camera rs_camera.launch \ serial_no:="<相机2序列号>" \ enable_sync:=true在最近的一个服务机器人项目中，我们发现将深度图像分辨率设置为848x480、帧率设为15fps时，能在精度和性能间取得最佳平衡。同时，关闭发射器(emitter_enable:=false)可以显著降低功耗，适合电池供电场景。
