RealSense SDK 部署教程从设备握手到三维重建的四个里程碑【免费下载链接】librealsenseRealSense SDK项目地址: https://gitcode.com/GitHub_Trending/li/librealsense相机插上后深度画面一片黑或者枚举命令毫无反应——多半不是相机坏了而是内核驱动没打补丁。librealsense 是 Intel RealSense 深度相机的官方开源 SDK覆盖 Linux 内核模块修补、深度/彩色/点云取流、高级调参与录制回放。下面按四个里程碑把 Ubuntu 上跑通数据链路的全过程演示一遍。 先对齐预期维度说明硬件RealSense D400 系列、L500、T265 等 USB3 深度相机平台Ubuntu 20.04/22.04/24.04 LTS、Windows 10/11、JetsonL4T能力深度/彩色/红外/IMU 取流、后处理滤波、点云生成、.db3 录制回放前置条件Linux 需替换打过补丁的 uvcvideo 内核驱动机器内核必须可修改如果你的机器是锁定内核的 OEM 机型、无法替换内核模块这个项目就先不适合你其余情况跟着走即可。 里程碑一让设备握手成功环境要求压缩成三行项要求硬件RealSense 深度相机插 USB 3.0蓝色口系统Ubuntu 20/22/24 LTS依赖cmake、build-essential、git、wget、libusb-1.0-0-dev、libudev-dev先克隆代码并配置 USB 权限规则setup_udev_rules.sh会把相机的 udev 规则装进系统避免权限拦截git clone https://gitcode.com/GitHub_Trending/li/librealsense cd librealsense ./scripts/setup_udev_rules.sh真正的硬骨头是内核驱动。Ubuntu LTS 机器上跑下面这条脚本它会自动下载、打补丁、编译并替换 uvcvideo 相关模块Jetson 设备则改跑./scripts/patch-realsense-ubuntu-L4T.sh./scripts/patch-realsense-ubuntu-lts-hwe.sh跑完用sudo dmesg | tail -n 50检查日志里出现新注册的 uvcvideo 驱动条目才算补丁生效。接着编译 SDK-DBUILD_EXAMPLEStrue会连同后面要用的全部示例一起构建mkdir build cd build cmake ../ -DBUILD_EXAMPLEStrue make -j$(($(nproc)-1)) sudo make install验收标准回到仓库根目录运行scripts/rs-enum.sh能打印出相机序列号再运行realsense-viewer主窗口出现实时深度预览。两条都通过握手才算成功。 里程碑二拿到能用的数据3分钟跑通第一帧深度图rs-capture是最小可用示例默认配置启动 pipeline深度与彩色双流同屏colorizer 把 12bit 灰度深度转成伪彩色rates_printer 实时打印每一路流的实际帧率。rs-capture深度图的直觉是近亮远暗前景物体亮度高、轮廓清晰图rs-capture 深度流输出前景更亮距离直接反映在亮度上调参提示原始深度是 12bit 灰度偏暗属正常现象。如果测量范围不够跑rs-sensor-control进入高级模式先调激光功率再收紧最小深度阈值。验收标准窗口里出现两个距离不同的物体且亮度梯度明显状态行打印出稳定帧率即算通过。低光场景用红外流补位红外流不依赖环境光是低光场景下对齐与纹理恢复的可靠参考。最快的查看方式是启动realsense-viewer在流列表勾选 Infrared对应窗口立刻出图。图红外流伪彩色渲染暗光下场景纹理依然清晰调参提示如果要喂给算法而不是给人看关掉 color map 拿原始灰度红外比伪彩色干净得多。验收标准关灯或遮挡彩色窗口后红外画面仍然稳定出图即算拿到可用数据。点云把帧变成三维点点云示例rs-pointcloud把每个像素的深度反投影回三维坐标直接渲染出场景点云rs-pointcloud图由深度数据渲染出的场景点云视角调参提示点云有孔洞或噪点时在 pipeline 里串一个空间滤波或空洞填补滤波器仓库examples/post-processing/有现成写法。验收标准灰窗内出现可旋转的三维点云桌面、物体轮廓可分辨。 里程碑三把数据变成应用选物流场景走完整链路多相机包裹尺寸测量。Python wrapper 让多路 RealSense 相机可以直接用 Python 驱动装好绑定后进入官方多相机示例目录运行pip install pyrealsense2 cd wrappers/python/examples/box_dimensioner_multicam python box_dimensioner_multicam_demo.py完成相机标定后程序对进入视场的包裹做三维尺寸解算输出长宽高。这是仓储、快递柜场景做体积测量的标准入口。验收标准每个相机画面上出现包裹边框控制台打印出以米为单位的三维尺寸数值。如果目标是重建而非测量改用 OpenCV 封装的 Kinect Fusion 示例rs-kinfu它把连续深度帧累积成环境实时三维模型适合机器人导航与 AR 建图图kinfu 示例把深度数据累积成实时三维场景 里程碑四把坑提前绕开问设备识别不到枚举为空先跑sudo dmesg | tail -n 50。若没有新 uvcvideo 驱动注册记录说明补丁没生效——用uname -r确认当前内核在脚本支持列表内重跑补丁脚本。另一个高频原因是插了 USB 2.0 口带宽不够设备直接不上线。问权限装错了怎么回滚./scripts/setup_udev_rules.sh --uninstall一键移除。若报 Multiple realsense udev-rules were found是 deb 包与源码安装共存了必须卸掉其中一个。问编译报 fastrtps 或 curl 依赖错误只是 DDS 与固件更新模块找不到依赖配置时关掉即可cmake ../ -DBUILD_WITH_DDSOFF -DCHECK_FOR_UPDATESOFF后重编。问Jetson 上和 Ubuntu 有何不同流程相同但补丁脚本换成./scripts/patch-realsense-ubuntu-L4T.sh且必须先让 L4T 内核补丁生效再编译。装好后设备应能正常出图图Jetson 平台完成 L4T 内核补丁后RealSense 设备输出实时三维点云验收标准对应报错消失、scripts/rs-enum.sh能列出设备即算绕坑成功。 资源导航doc/installation.mdLinux 安装细节、支持内核版本与补丁排错对照表doc/record-and-playback.md.db3 录制格式、回放设备的 pause/seek/变速 APIdoc/troubleshooting.md运行期常见问题的逐项排查清单examples/C 示例源码含深度、点云、高级模式、录制回放wrappers/python/Python 绑定与全部 Python 示例从 udev 规则到第一帧深度整条链路约半小时跑完。先执行scripts/rs-enum.sh确认序列号再动手写自己的取流代码。【免费下载链接】librealsenseRealSense SDK项目地址: https://gitcode.com/GitHub_Trending/li/librealsense创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考