Intel RealSense/librealsense Linux系统安装指南

前言

Intel RealSense深度摄像头是一款广泛应用于计算机视觉、机器人、增强现实等领域的3D感知设备。librealsense是Intel官方提供的开源跨平台库，用于支持RealSense系列设备的开发和使用。本文将详细介绍在Linux Ubuntu系统上安装librealsense的完整流程。

系统要求

支持的操作系统版本

• Ubuntu 18.04 LTS
• Ubuntu 20.04 LTS
• Ubuntu 22.04 LTS

硬件要求

• 支持USB 3.0的主板接口
• 建议至少2GB内存
• 建议在物理机上安装，虚拟机支持有限

注意事项

1. 某些厂商可能会锁定内核修改权限，需要在BIOS中调整相关设置
2. 企业防火墙可能会阻止某些命令执行，需要配置系统代理
3. 确保使用官方支持的内核版本

安装准备

1. 更新系统

首先确保系统是最新状态，包括内核更新：

sudo apt-get update && sudo apt-get upgrade && sudo apt-get dist-upgrade

2. 安装核心依赖包

安装构建librealsense所需的依赖项：

sudo apt-get install libssl-dev libusb-1.0-0-dev libudev-dev pkg-config libgtk-3-dev

3. 安装构建工具

安装必要的开发工具：

sudo apt-get install git wget cmake build-essential

4. 安装图形相关依赖

如需使用OpenGL示例程序，需安装以下包：

sudo apt-get install libglfw3-dev libgl1-mesa-dev libglu1-mesa-dev at

可选组件

推荐安装QtCreator作为开发IDE：

sudo apt-get install qtcreator

安装librealsense2

1. 获取源代码

克隆最新稳定版本的librealsense2仓库：

git clone https://repo地址/librealsense.git

2. 设置设备权限

运行权限设置脚本：

cd librealsense
./scripts/setup_udev_rules.sh

如需移除权限，可执行：

./scripts/setup_udev_rules.sh --uninstall

3. 内核模块补丁

根据Ubuntu版本和内核版本选择对应的补丁脚本：

• Ubuntu 20/22 (内核5.13及以上)：

  ./scripts/patch-realsense-ubuntu-lts-hwe.sh
  

• Ubuntu 18/20 (内核5.13以下)：

  ./scripts/patch-realsense-ubuntu-lts.sh
  

补丁脚本会下载、修补并构建影响RealSense的内核模块。完成后可通过以下命令验证：

sudo dmesg | tail -n 50

构建SDK

1. 创建构建目录

mkdir build && cd build

2. 配置CMake

基本配置：

cmake ../

包含示例程序：

cmake ../ -DBUILD_EXAMPLES=true

无图形界面系统：

cmake ../ -DBUILD_EXAMPLES=true -DBUILD_GRAPHICAL_EXAMPLES=false

3. 编译安装

sudo make uninstall && make clean && make && sudo make install

多核并行编译（推荐）：

make -j$(($(nproc)-1)) && sudo make install

安装完成后：

• 共享库文件位于/usr/local/lib
• 头文件位于/usr/local/include
• 示例程序位于/usr/local/bin

常见问题排查

1. 多重udev规则冲突

现象：发现多个realsense udev规则
解决：移除不需要的安装方式（手动或deb包）

2. 网络连接超时

现象：git或wget命令超时
解决：检查防火墙设置，配置系统代理

3. 内核模块签名警告

现象：uvcvideo: module verification failed
说明：这是内核4.4-30+版本后的标准警告，不影响功能

4. 模块加载失败

现象：uvc kernel module is not loaded
解决：检查内核版本uname -r，确保与补丁版本匹配

5. OpenSSL头文件缺失

现象：fatal error: openssl/opensslv.h
解决：安装openssl开发包

最佳实践建议

1. 开发环境：建议使用Ubuntu 20.04 LTS，这是目前最稳定的支持版本
2. 内核选择：推荐使用5.15 LTS内核，兼容性最佳
3. 构建选项：生产环境使用-DCMAKE_BUILD_TYPE=Release以获得最佳性能
4. 资源分配：虚拟机环境下至少分配2GB内存，避免编译错误
5. 后续开发：安装完成后，建议运行realsense-viewer验证设备连接

通过以上步骤，您应该已经成功在Ubuntu系统上安装配置好了librealsense开发环境。接下来可以开始使用RealSense设备进行3D视觉应用开发了。