librealsense 深度相机排障 30 分钟上手【免费下载链接】librealsenseRealSense SDK项目地址: https://gitcode.com/GitHub_Trending/li/librealsense机器人卡在玻璃门前深度图大片缺失先查相机。librealsense 是 Intel RealSense 深度相机的跨平台 SDKC、Python、OpenCV 取深度数据都走它。30 秒跑起来从 clone 到枚举相机在 Ubuntu 20/22/24 LTS 机器上跑一遍这条命令链SDK、示例和 udev 权限全部就位git clone https://gitcode.com/GitHub_Trending/li/librealsense.git cd librealsense ./scripts/setup_udev_rules.sh mkdir build cd build cmake .. -DBUILD_EXAMPLEStrue make -j$(nproc) sudo make install其他平台、更多 CMake 开关见安装文档。udev rules 那行把 RealSense 的 USB 权限写进系统跳过它后面读相机都要 sudo。先扫两处跑rs-enumerate-devices设备表里要有名称和固件版本再启动realsense-viewer把深度传感器开关拨亮看彩色的深度画面出不出来。排障第一步证明相机是活的相机刚插上、或程序读不出帧时用。目标只有一个物理层通没通驱动在不在SDK 看不看得见。枚举运行rs-enumerate-devices默认列出每台设备和支持的全部流配置看选项加-o看曝光、激光点等可控项加-c看内外参标定看 USB设备表是空的跑lsusb | grep 80868086 是 Intel 的 USB 厂商号看到什么lsusb有输出、设备表却空问题在驱动或 SDK 层dmesg -T | tail -50里找 uvcvideo 报错lsusb没输出链路本身就断了先换口换线。排障第二步把现场变成可复现资产深度图在你工位正常、到现场偶尔缺失时用。先把现场固化成文件再离线调试。录现场执行这条命令收 30 秒原始流rs-record -f ./scene.db3 -t 30文件是.db3格式ROS2 rosbag2SQLite 底座。录制不只存帧还存设备拓扑和当时的参数快照。载入在 Viewer 里点设备名旁的菜单选 Record to File... 是录制载入走 Add Source Load Recorded Sequence回放载入后设备名旁出现电影图标用进度条跳到出问题的帧暂停逐帧看对比在 Viewer 里开关空间、时间滤波看补洞前后差异。推荐链路顺序是抽稀 → 空间 → 时间 → 补洞看到什么问题只在真机出现、回放消失现场是时序相关的把录制拉长、带上 metadata 再收一轮问题在回放里复现锅在深度算法参数你现在可以随便改参数试。排障第三步用日志钉死卡点场景已经能回放要回答到底死在哪一步时用。开 SDK 日志设置LRS_LOG_LEVEL再跑一遍SDK 会落全量日志。文件涨得快用完就关export LRS_LOG_LEVELdebug realsense-viewer盯内核dmesg -wH实时滚内核消息USB 超时、断连事件从这里冒出来升固件第一步里看到固件版本落后用仓库里的 fw-update 工具或 Viewer 的升级按钮刷新版官方命令合集内核版本、uvcvideo 详细日志、strace、core dump在 doc/troubleshooting.md找支持前先附上这份日志。影响最大的 3 个开关LRS_LOG_LEVEL 决定问题可见不可见。默认级别只给一行摘要排障等于蒙眼。调到debug才能看到每个流、每帧的走向代价是日志文件巨大。只排障时开排完立刻关。udev 规则决定你要不要 sudo。仓库里的setup_udev_rules.sh把 RealSense 设备的 USB 权限写进系统。不跑它每个程序都得 sudo多个 sudo 实例还会互相抢相机。不想要时./scripts/setup_udev_rules.sh --uninstall卸载。CMake 开关决定编译过不过、装出来有什么。-DBUILD_EXAMPLEStrue才会编出 rs-record 这些示例。卡在 fastrtps 或 curl 依赖加-DBUILD_WITH_DDSOFF -DCHECK_FOR_UPDATESOFF关掉 DDS 和更新检查即可通过。高频坑速查症状一行解法rs-enumerate-devices空、lsusb无 8086物理层没通查 USB3 口和线再看dmesg -T里 uvcvideo 报错Multiple realsense udev-rules were found!apt 包和源码编译装了两套卸掉一套深度图缺洞、边缘破碎先走空间 时间滤波链路别急着动相机参数编译卡在 fastrtps / curl加-DBUILD_WITH_DDSOFF和-DCHECK_FOR_UPDATESOFF老.bag录制打不开rs-convert -i in.bag -D out.db3转成新格式什么时候用它什么时候别用做 C/Python 开发、要深度控制、滤波、固件管理librealsense 是最底层上层封装全走它学核心 API 不会走弯路只想在 notebook 里快速取帧pip install PyRealsense2直接装它是这个 SDK 的 Python 封装不用碰 C 编译已在 ROS 体系里用 realsense2_camera 驱动它在上层包好了这个库不用手写原生接口想用 OpenCV 当普通 USB 摄像头cv2.VideoCapture 只能拿到 RGB 流深度、曝光、激光点全在这个库里下次深度图不对别先猜参数。敲rs-record -f ./scene.db3 -t 30把现场变成可回放的文件再慢慢调——大多数深度问题先能复现才谈得上修。【免费下载链接】librealsenseRealSense SDK项目地址: https://gitcode.com/GitHub_Trending/li/librealsense创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考