Intel RealSense/librealsense Linux系统安装指南
【免费下载链接】librealsense Intel® RealSense™ SDK 项目地址: https://gitcode.com/GitHub_Trending/li/librealsense
前言
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内存
- 建议在物理机上安装,虚拟机支持有限
注意事项
- 某些厂商可能会锁定内核修改权限,需要在BIOS中调整相关设置
- 企业防火墙可能会阻止某些命令执行,需要配置系统代理
- 确保使用官方支持的内核版本
安装准备
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开发包
最佳实践建议
- 开发环境:建议使用Ubuntu 20.04 LTS,这是目前最稳定的支持版本
- 内核选择:推荐使用5.15 LTS内核,兼容性最佳
- 构建选项:生产环境使用
-DCMAKE_BUILD_TYPE=Release以获得最佳性能 - 资源分配:虚拟机环境下至少分配2GB内存,避免编译错误
- 后续开发:安装完成后,建议运行
realsense-viewer验证设备连接
通过以上步骤,您应该已经成功在Ubuntu系统上安装配置好了librealsense开发环境。接下来可以开始使用RealSense设备进行3D视觉应用开发了。
【免费下载链接】librealsense Intel® RealSense™ SDK 项目地址: https://gitcode.com/GitHub_Trending/li/librealsense
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考



