终极指南:如何在Ubuntu系统上编译Intel RealSense内核模块
【免费下载链接】librealsense Intel® RealSense™ SDK 项目地址: https://gitcode.com/GitHub_Trending/li/librealsense
Intel® RealSense™ SDK 是一个功能强大的深度摄像头开发工具包,支持多种RealSense设备。在Linux系统上使用RealSense深度摄像头需要正确编译和安装内核模块,这是确保设备功能完整性的关键步骤。本指南将为您提供详细的Linux内核模块编译方法,让您轻松搭建开发环境。
🛠️ 准备工作与依赖安装
在开始编译之前,需要确保系统环境准备就绪。首先更新系统到最新版本:
sudo apt-get update && sudo apt-get upgrade && sudo apt-get dist-upgrade
安装必要的开发依赖包:
sudo apt-get install libssl-dev libusb-1.0-0-dev libudev-dev pkg-config libgtk-3-dev
安装构建工具链:
sudo apt-get install git wget cmake build-essential
安装图形子系统支持包(用于OpenGL示例):
sudo apt-get install libglfw3-dev libgl1-mesa-dev libglu1-mesa-dev
📥 获取RealSense SDK源码
从官方仓库克隆最新版本的librealsense2:
git clone https://gitcode.com/GitHub_Trending/li/librealsense
设置udev规则以确保设备访问权限:
cd librealsense
./scripts/setup_udev_rules.sh
🔧 内核模块编译与安装
根据您的Ubuntu版本和内核选择合适的补丁脚本:
Ubuntu 20/22/24 LTS 版本(内核5.15+):
./scripts/patch-realsense-ubuntu-lts-hwe.sh
Ubuntu 20 LTS(内核<5.13):
./scripts/patch-realsense-ubuntu-lts.sh
这些脚本会自动执行以下操作:
- 下载相关的内核源码
- 应用RealSense特定的补丁
- 编译修改后的内核模块
- 尝试插入新的模块
🏗️ 构建librealsense2 SDK
创建构建目录并配置编译选项:
mkdir build && cd build
基础编译配置:
cmake ../
包含示例程序的完整构建:
cmake ../ -DBUILD_EXAMPLES=true
仅构建文本示例(无图形界面):
cmake ../ -DBUILD_EXAMPLES=true -DBUILD_GRAPHICAL_EXAMPLES=false
编译并安装:
sudo make uninstall && make clean && make && sudo make install
对于多核CPU系统,可以使用并行编译加速:
make -j$(($(nproc)-1)) install
✅ 验证安装结果
检查内核模块是否正确加载:
sudo dmesg | tail -n 50
🚨 常见问题与解决方案
问题1:模块签名验证失败
dmesg: uvcvideo: module verification failed
这是正常警告,不影响功能使用。
问题2:编译内存不足
gcc: internal compiler error
关闭内存消耗大的应用程序,虚拟机用户确保至少有2GB可用内存。
问题3:udev规则冲突
Multiple realsense udev-rules were found!
移除不需要的安装(手动或Deb包)。
📋 重要注意事项
- 内核版本兼容性:确保使用支持的内核版本
- 虚拟机限制:由于USB 3.0转换层问题,不建议在虚拟机中使用
- 企业防火墙:如果遇到下载超时,请配置系统代理
🎯 成功标志
安装完成后,您应该能够:
- 成功检测连接的RealSense设备
- 运行RealSense示例程序
- 访问深度摄像头流数据
通过遵循本指南,您将能够在Ubuntu系统上成功编译和安装Intel RealSense内核模块,为后续的深度视觉应用开发奠定坚实基础。记住,正确的内核模块编译是确保RealSense设备在Linux系统上正常运行的关键步骤。
【免费下载链接】librealsense Intel® RealSense™ SDK 项目地址: https://gitcode.com/GitHub_Trending/li/librealsense
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考







