如何全面部署Intel® RealSense™ SDK：Ubuntu 22.04环境配置指南

深度相机开发的核心挑战

在进行Intel RealSense深度相机开发时，开发者常面临以下关键问题：

• 官方文档分散导致安装流程碎片化，缺乏系统指引
• 内核版本与驱动模块兼容性冲突，编译过程频繁中断
• 依赖库版本不匹配引发的编译错误，错误提示难以解读
• 预编译包与源码编译两种方案的选择困境，不知如何适配具体场景

通过本文学习，您将获得： ✅ 两种部署方案的完整实施路线（预编译包/源码构建） ✅ 内核兼容性自动检测与补丁修复工具使用方法 ✅ 常见错误的诊断流程与解决方案速查表 ✅ 性能调优参数配置及功能验证步骤

部署方案对比分析

实施路径	内核支持范围	操作复杂度	完成耗时	典型应用场景
预编译DKMS包	5.15/5.19/6.5 LTS HWE	低（2级）	约10分钟	生产环境部署/快速验证
源码编译安装	全系列Ubuntu 22.04内核	中（4级）	约40分钟	功能定制/开发调试

⚠️ 重要提示：执行以下命令检查当前内核版本，确认兼容性：

uname -r  # 示例输出：5.15.0-78-generic

方案一：DKMS预编译包快速部署

环境准备流程

flowchart LR
    A[系统更新] --> B[安装HTTPS支持]
    B --> C[导入仓库密钥]
    C --> D[配置APT源]
    D --> E[安装DKMS组件]
    E --> F[验证安装状态]

首先更新系统并安装必要依赖：

# 更新系统包索引并升级已安装组件
sudo apt-get update && sudo apt-get upgrade -y

# 安装HTTPS传输支持和证书工具
sudo apt-get install apt-transport-https ca-certificates -y

软件源配置步骤

# 创建密钥存储目录（若不存在）
sudo mkdir -p /etc/apt/keyrings

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

# 添加官方APT仓库到软件源列表
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

核心组件安装

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

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

# （开发环境可选）安装C/C++开发库
sudo apt-get install librealsense2-dev -y

安装验证方法

# 检查uvcvideo内核模块版本（应包含realsense标识）
modinfo uvcvideo | grep "version:"

# 启动Realsense Viewer进行可视化验证
realsense-viewer

✅ 验证成功标准：Realsense Viewer界面能正确识别相机设备，并可预览深度数据流

方案二：源码编译定制安装

开发环境准备

# 安装基础编译工具链
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

源码获取与权限配置

# 克隆项目仓库
git clone https://gitcode.com/GitHub_Trending/li/librealsense.git
cd librealsense

# 设置设备访问权限
sudo ./scripts/setup_udev_rules.sh

内核补丁应用流程

sequenceDiagram
    participant 开发者
    participant 补丁脚本
    participant 系统内核
    
    开发者->>补丁脚本: 执行HWE内核补丁脚本
    补丁脚本->>系统内核: 查询当前内核版本
    系统内核-->>补丁脚本: 返回版本信息
    补丁脚本->>补丁脚本: 匹配对应补丁文件
    补丁脚本->>系统内核: 应用uvcvideo驱动补丁
    系统内核-->>补丁脚本: 返回补丁结果
    补丁脚本-->>开发者: 显示执行状态报告

针对Ubuntu 22.04 HWE内核执行以下命令：

# 适用于5.15/5.19/6.5等HWE内核版本
sudo ./scripts/patch-realsense-ubuntu-lts-hwe.sh

⚠️ 补丁执行日志存放路径：/var/log/librealsense-setup.log
若补丁失败，可通过dmesg | grep uvcvideo查看内核错误信息

编译配置与构建

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

# 基础Debug模式配置（含示例程序）
cmake .. -DBUILD_EXAMPLES=true -DBUILD_GRAPHICAL_EXAMPLES=true

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

# 多线程编译（根据CPU核心数调整-j参数）
make -j$(nproc)

# 系统级安装
sudo make install

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

功能验证示例

# 运行深度采集示例程序
cd examples/capture
./rs-capture

# 查看已安装SDK版本
pkg-config --modversion librealsense2  # 示例输出：2.54.1

常见问题诊断与解决

错误现象	根本原因	解决方案
modprobe: ERROR: could not insert 'uvcvideo'	内核模块版本不匹配	1. 重新安装DKMS包： sudo apt-get install --reinstall librealsense2-dkms 2. 检查/var/lib/dkms/librealsense2-dkms日志定位冲突
Realsense Viewer显示设备但无图像	USB端口带宽不足	1. 确保使用USB 3.0端口（蓝色接口） 2. 直接连接主板USB接口，避免使用集线器 3. 检查USB线缆是否支持USB 3.0标准
编译时提示openssl/opensslv.h: No such file or directory	缺少OpenSSL开发库	安装SSL开发包： sudo apt-get install libssl-dev
multiple realsense udev rules found警告	混合安装方式导致规则冲突	彻底清理旧安装： `dpkg -l

性能优化配置指南

USB带宽优化

# 查看RealSense设备的USB配置信息
lsusb -d 8086: -v | grep "wMaxPacketSize"

# 调整USBFS内存限制（临时生效）
echo 1000 > /sys/module/usbcore/parameters/usbfs_memory_mb

# 永久生效配置（推荐）
echo 'options usbcore usbfs_memory_mb=1000' | sudo tee /etc/modprobe.d/usbcore.conf

电源管理优化

# 创建udev规则禁止USB自动挂起
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

功能验证与测试工具

工具名称	主要功能	调用命令
realsense-viewer	设备可视化配置与数据流预览	realsense-viewer
rs-enumerate-devices	设备信息与支持模式查询	rs-enumerate-devices -S
rs-record	录制数据流到ROS bag文件	rs-record -o output.bag
rs-benchmark	设备性能基准测试	rs-benchmark

总结与后续步骤

本文详细阐述了Intel RealSense SDK在Ubuntu 22.04系统上的两种部署方案：

• 预编译DKMS方案：适合快速部署，通过包管理器自动处理内核兼容性，推荐用于生产环境
• 源码编译方案：适合开发调试，支持自定义功能与最新特性，需手动处理依赖关系

推荐后续操作：

1. 运行realsense-viewer验证设备基本功能，测试不同分辨率与帧率配置
2. 探索examples/目录下的示例程序，如align（数据对齐）、pointcloud（点云生成）等
3. 参考doc/post-processing-filters.md文档配置深度数据后处理参数，优化输出质量
4. 查看tools/目录下的辅助工具，如depth-quality用于深度精度评估

核心文档路径参考：

• 安装指南：doc/installation.md
• 帧生命周期管理：doc/frame_lifetime.md
• 元数据使用：doc/frame_metadata.md
• 后处理滤波器：doc/post-processing-filters.md

通过合理选择部署方案并遵循最佳实践，可有效降低Intel RealSense相机的集成难度，充分发挥其在三维视觉应用中的性能优势。