Intel® RealSense™ SDK Ubuntu 22.04 部署指南：从诊断到优化的完整路径

一、系统兼容性诊断：识别安装障碍

在开始部署Intel® RealSense™ SDK前，需要先对系统环境进行全面诊断，排除潜在的兼容性问题。这一阶段将帮助你确定最适合的安装方案，并提前解决可能导致失败的关键因素。

核心诊断指标

1. 内核版本检查

   uname -r  # 查看当前内核版本，例如：5.15.0-78-generic
   

   ⚠️ 注意：Ubuntu 22.04默认内核为5.15，但不同发行版可能包含5.19或6.5等HWE内核，需根据版本选择合适的安装策略。

2. USB端口检测

   lsusb | grep 8086  # 验证RealSense设备是否被识别
   

   若输出包含"Intel Corp."相关设备，则表示硬件连接正常。

3. 现有驱动冲突检查

   modinfo uvcvideo | grep "version:"  # 检查是否已存在RealSense驱动
   

   若输出包含"realsense"字样，表示系统中已安装相关驱动，可能需要先卸载旧版本。

诊断流程图

flowchart TD
    A[开始诊断] --> B{内核版本 >=5.15?}
    B -->|是| C{是否需要开发功能?}
    B -->|否| D[升级内核或选择源码编译]
    C -->|是| E[选择源码编译方案]
    C -->|否| F[选择DKMS预编译方案]
    D --> E
    E --> G[检查依赖项]
    F --> H[配置官方仓库]
    G --> I[应用内核补丁]
    H --> J[安装DKMS包]

二、安装方案深度对比：选择最佳路径

根据系统诊断结果，我们提供两种安装方案供选择。每种方案都有其适用场景和优缺点，需要根据实际需求进行决策。

方案对比卡片

维度	DKMS预编译包方案	源码编译方案
核心原理	通过DKMS机制动态管理内核模块，自动适配内核更新	从源代码构建所有组件，可自定义编译选项
适用场景	生产环境、快速部署、稳定性优先	开发调试、自定义功能、最新特性尝鲜
操作复杂度	⭐⭐（简单）	⭐⭐⭐⭐（复杂）
耗时	约5分钟	约30分钟
内核兼容性	仅支持5.15/5.19/6.5 LTS HWE	支持所有Ubuntu 22.04内核版本
空间占用	约200MB	约1.5GB（含编译文件）

技术原理阐释：DKMS工作机制

DKMS（Dynamic Kernel Module Support）是一种内核模块管理框架，它能够在每次内核更新时自动重新编译和安装指定的内核模块。对于RealSense SDK而言，DKMS会监控系统内核变化，当内核更新后，自动重新编译uvcvideo驱动模块，确保驱动与新内核保持兼容。这种机制避免了因内核升级导致的驱动失效问题，特别适合生产环境使用。

三、分步实施指南：从环境准备到功能验证

方案A：DKMS预编译包安装

1. 环境准备

# 更新系统并安装HTTPS支持
sudo apt-get update && sudo apt-get upgrade -y
sudo apt-get install apt-transport-https ca-certificates -y

2. 配置软件源

# 创建密钥存储目录
sudo mkdir -p /etc/apt/keyrings

# 导入仓库公钥
curl -sSf https://librealsense.intel.com/Debian/librealsense.pgp | \
sudo tee /etc/apt/keyrings/librealsense.pgp > /dev/null

# 添加官方仓库 - 注意：此处使用Intel官方仓库
echo "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.list

# 更新软件包索引
sudo apt-get update

3. 安装核心组件

# 安装DKMS内核驱动 - 核心驱动包
sudo apt-get install librealsense2-dkms -y

# 安装实用工具 - 包含Realsense Viewer
sudo apt-get install librealsense2-utils -y

# 安装开发库 - 如需开发应用程序
sudo apt-get install librealsense2-dev -y

验证 checkpoint 1

执行以下命令检查驱动是否正确加载：

modinfo uvcvideo | grep "version:"

预期结果：输出中应包含"realsense"字样，例如"version: 1.1.2-realsense"

方案B：源码编译安装

1. 依赖项安装

# 安装基础编译工具
sudo apt-get install git cmake build-essential -y

# 安装核心依赖库
sudo apt-get install libssl-dev libusb-1.0-0-dev libudev-dev \
pkg-config libgtk-3-dev libglfw3-dev libgl1-mesa-dev libglu1-mesa-dev -y

2. 源码获取与准备

# 克隆仓库 - 使用指定的国内镜像
git clone https://gitcode.com/GitHub_Trending/li/librealsense.git
cd librealsense

# 设置设备权限 - 配置udev规则
sudo ./scripts/setup_udev_rules.sh

3. 内核补丁应用

# 针对Ubuntu 22.04 HWE内核应用补丁
# 此脚本会自动检测内核版本并应用匹配的补丁
sudo ./scripts/patch-realsense-ubuntu-lts-hwe.sh

⚠️ 补丁执行日志位于/var/log/librealsense-setup.log，失败时可通过dmesg | grep uvcvideo查看内核消息

4. 编译配置

# 创建并进入构建目录
mkdir build && cd build

# 基础配置 - 启用示例程序
cmake .. -DBUILD_EXAMPLES=true -DBUILD_GRAPHICAL_EXAMPLES=true

# 如需Release模式优化（推荐生产环境）
cmake .. -DCMAKE_BUILD_TYPE=Release -DBUILD_EXAMPLES=true

技术原理阐释：编译优化原理

Release模式通过启用编译器优化标志（如-O3），对代码进行深度优化，包括循环展开、函数内联和死代码消除等。这些优化可以显著提升SDK的运行性能，特别是在处理深度流和点云数据时。对于开发调试场景，建议使用默认的Debug模式，它保留了完整的调试符号，便于问题定位。

5. 编译与安装

# 使用多线程编译 - $(nproc)自动获取CPU核心数
make -j$(nproc)

# 安装到系统目录
sudo make install

# 更新动态链接库缓存
sudo ldconfig

验证 checkpoint 2

运行示例程序验证安装结果：

# 进入示例程序目录
cd examples/capture

# 运行深度采集示例
./rs-capture

预期结果：程序启动后应显示深度图像和彩色图像预览窗口

四、深度优化配置：提升性能与稳定性

1. USB带宽优化

RealSense设备需要较高的USB带宽，特别是在同时传输深度和彩色流时。通过以下配置可以提升USB传输性能：

# 查看当前USB设备配置 - 确认wMaxPacketSize值
lsusb -d 8086: -v | grep "wMaxPacketSize"

# 设置USB3.0最大带宽（需root权限）
echo 1000 > /sys/module/usbcore/parameters/usbfs_memory_mb

2. 电源管理优化

USB自动挂起功能可能导致设备连接不稳定，建议禁用：

# 创建udev规则文件
sudo tee /etc/udev/rules.d/80-realsense-power.rules <<EOF
ACTION=="add", SUBSYSTEM=="usb", ATTR{idVendor}=="8086", ATTR{power/autosuspend}="-1"
EOF

# 重新加载udev规则
sudo udevadm control --reload-rules && sudo udevadm trigger

3. 高级模式配置

通过Realsense Viewer可以访问设备的高级模式，调整深度传感器参数以获得最佳性能：

高级模式配置界面提供了丰富的参数调整选项，如深度阈值、纹理过滤和曝光控制等。对于特定应用场景，可以通过调整这些参数优化深度数据质量。

验证 checkpoint 3

启动Realsense Viewer验证高级功能：

realsense-viewer

预期结果：能够成功打开设备，切换到高级模式，并调整各项参数

五、版本迁移指南：从旧版本平滑过渡

如果你正在从旧版本升级到当前版本，需要注意以下迁移要点：

1. 卸载旧版本

# 卸载DKMS包
sudo apt-get remove librealsense2-dkms -y

# 卸载源码安装的版本
sudo rm -rf /usr/local/include/librealsense2
sudo rm -rf /usr/local/lib/librealsense2*
sudo rm -rf /usr/local/bin/realsense-viewer

2. 配置文件迁移

# 备份旧版配置文件
mkdir ~/realsense_backup
cp ~/.config/Intel\ RealSense/ ~/realsense_backup/ -r

# 安装新版本后恢复配置
cp ~/realsense_backup/Intel\ RealSense/ ~/.config/ -r

3. API变更适配

如果你开发了基于旧版SDK的应用程序，需要注意以下API变更：

• rs2::frame_queue替代了旧的frame_queue接口
• 元数据访问方式变更为frame.get_metadata(RS2_FRAME_METADATA_TIMESTAMP)
• 设备枚举方法建议使用rs2::context().query_devices()

六、实用工具与故障排除

常用诊断工具

工具名称	功能描述	使用示例
realsense-viewer	可视化数据流与设备配置	realsense-viewer
rs-enumerate-devices	列出设备信息与支持模式	rs-enumerate-devices -S
rs-record	录制数据流到文件	rs-record -o output.bag
rs-benchmark	性能基准测试	rs-benchmark

常见问题解决

1. 驱动加载失败

   # 重新安装DKMS包
   sudo apt-get install --reinstall librealsense2-dkms
   # 查看详细日志
   cat /var/lib/dkms/librealsense2-dkms/*/make.log
   

2. 设备无法识别

   # 检查USB连接
   lsusb | grep 8086
   # 检查udev规则
   cat /etc/udev/rules.d/99-realsense-libusb.rules
   

3. 数据流卡顿

   # 检查USB带宽使用情况
   sudo apt-get install usbmon
   sudo cat /sys/kernel/debug/usb/usbmon/1u
   

数据录制与回放

RealSense SDK提供了强大的录制和回放功能，可用于离线分析和算法开发：

录制步骤：

1. 启动realsense-viewer
2. 右键点击设备选择"Record to File"
3. 设置保存路径和文件名
4. 点击开始录制按钮

回放步骤：

1. 启动realsense-viewer
2. 点击"Add Source"选择"Load Recording"
3. 选择录制的bag文件
4. 使用播放控制按钮控制回放

通过录制和回放功能，可以在没有硬件设备的情况下进行应用开发和测试，极大提高开发效率。