★ FEATURED ARTICLE Jetson Orin RealSense 不识别完整实操两条路径 20 分钟跑通深度流【免费下载链接】librealsenseRealSense SDK项目地址: https://gitcode.com/GitHub_Trending/li/librealsenseIntel RealSense D400 系列相机接到 NVIDIA Jetson OrinLinux for Tegra 系统简称 L4T后设备不可见或深度流无输出基本都卡在 L4T 定制内核缺少 RealSense 所需的驱动修改。librealsense 提供两条适配路径用户态 RSUSB 后端与内核补丁核心卡点就是驱动适配下面分别给出完整操作。一、故障现象与快速定位先跑三条命令把问题范围缩小到最小lsusb 里看不到 8086:0b07→ 通常是连接或供电问题 → 验证lsusb | grep 8086预期输出ID 8086:0b07 Intel Corp. RealSense D435ilsusb 能看到设备但没有 /dev/video 节点→ uvcvideo 内核模块缺少 RealSense 格式支持 → 验证ls /dev/video*节点在深度流却异常或帧率低→ 驱动未打补丁缺少 metadata 与格式支持 → 验证lsmod | grep uvcvideo再看modinfo -F version uvcvideo打过补丁的版本输出1.1.1-realsense二、选择你的适配路径两种后端互斥在 CMake 配置阶段一次性定死目标是快速看到画面、搭原型验证→ 走路径 ARSUSB 用户态后端。SDK 内置 UVC 协议栈完全不改内核代价约 20 分钟编译不支持多相机同步性能略低于原生。目标是生产环境、多相机同步或需要完整 metadata 功能→ 走路径 B原生内核驱动 RealSense 补丁。代价是 30 分钟以上的脚本耗时、约 2.5GB 空闲空间且要求 L4T 版本被补丁脚本覆盖。先跑通再说路径 A 能满足就先停在 A别急着动内核。三、路径A 完整操作RSUSB 用户态后端3.1 安装构建依赖并拉取源码先在板端装齐构建依赖udev 规则依赖 v4l-utils一并装上再克隆 librealsense 源码预期 apt 与 git 均无报错sudo apt-get install git cmake libssl-dev freeglut3-dev libusb-1.0-0-dev pkg-config libgtk-3-dev v4l-utils -y git clone https://gitcode.com/GitHub_Trending/li/librealsense cd librealsense3.2 配置 udev 设备访问规则这一步给非 root 用户授予 RealSense 设备访问权限省掉后续大量权限报错预期结尾输出udev-rules successfully installed./scripts/setup_udev_rules.sh3.3 配置 CMake 并以 RSUSB 后端编译FORCE_RSUSB_BACKENDtrue切换到用户态后端这是免内核补丁的关键参数L4T 35.1 及以上环境加BUILD_WITH_CUDAtrue启用 GPU 加速未装 CUDA 工具链时去掉该参数即可预期编译完成且安装无报错mkdir build cd build cmake .. -DCMAKE_BUILD_TYPERelease -DFORCE_RSUSB_BACKENDtrue -DBUILD_WITH_CUDAtrue make -j$(nproc) sudo make install3.4 启动 viewer 确认出图编译完成后启动查看器深度与彩色帧都有画面即说明路径 A 已跑通完整核对清单见下一节realsense-viewer四、路径B 完整操作原生内核驱动与补丁4.1 确认内核版本与磁盘空间补丁脚本按系统的 L4T 版本自动选取内核源码树先确认版本与空闲空间需要约 2.5GB输出留底以便排查uname -r cat /etc/nv_tegra_release df -hJetPackNVIDIA 集成软件包5.x 对应 L4T 35.x6.x 对应 36.x。若脚本提示Unsupported JetPack revision说明当前版本不被覆盖先停下来核对版本再动手。4.2 运行内核补丁脚本执行前拔下所有 RealSense 相机脚本会检测并提示。脚本会下载对应版本的 L4T 内核源码树应用 camera-formats、metadata 等 RealSense 补丁编译 uvcvideo、v4l2-core 与 HID IMU 相关内核模块并加载全程约 30 分钟预期最后输出 Done./scripts/patch-realsense-ubuntu-L4T.sh⚠️ 此步失败大概率是内核版本不匹配请先确认uname -r输出脚本开头会显示 NVIDIA 许可页面30 秒内按任意键接受才能继续。4.3 安装 SDK 依赖并配置 udev 规则与路径 A 相同依赖列表额外加了原生后端需要的 libudev-dev预期输出同样以udev-rules successfully installed结尾sudo apt-get install git libssl-dev libusb-1.0-0-dev libudev-dev pkg-config libgtk-3-dev -y ./scripts/setup_udev_rules.sh4.4 以原生后端构建 SDK 并安装FORCE_RSUSB_BACKENDfalse表示走原生内核驱动-DBUILD_EXAMPLEStrue会一并编译 multicam 等示例程序方便后面做多相机验证mkdir build cd build cmake .. -DBUILD_EXAMPLEStrue -DCMAKE_BUILD_TYPERelease -DFORCE_RSUSB_BACKENDfalse -DBUILD_WITH_CUDAtrue make -j$(($(nproc)-1)) sudo make install五、验证与闭环跑通与否按下面清单逐项验收设备枚举正常lsusb | grep 8086输出ID 8086:0b07 Intel Corp. RealSense D435i无结果先换线、换 USB 3.0 端口再查踩坑记录视频节点已生成ls /dev/video*输出/dev/video0及后续节点缺失则重跑./scripts/setup_udev_rules.sh后重新插拔相机驱动为补丁版路径 B 必查modinfo -F version uvcvideo输出1.1.1-realsense仍是1.1.1说明模块未生效回到 4.2 检查加载过程深度与彩色同时出图realsense-viewer中深度帧、彩色帧均有画面且帧率稳定六、踩坑记录与延伸Qlsusb 能看到设备viewer 却提示无设备或权限错误A重跑./scripts/setup_udev_rules.sh并重新插拔相机Jetson 上优先使用供电充足的 USB 3.0 口。Q深度流帧率明显低于标称A先sudo nvpmodel -m 0把板端切到 MAXN 功耗模式再测仍不达标就降到 1280x72030fps 平衡负载。Q接了两台相机只认一台同步异常A这是 RSUSB 后端的已知局限改走路径 B多相机连接与硬件同步配置参考 examples/multicam/ 示例。跑通之后空洞填充、抽稀等后处理滤波器见 doc/post-processing-filters.mdD400 的曝光、激光等高级选项入口在 doc/rs400/rs400_advanced_mode.md。完整步骤与版本兼容表以官方指南为准doc/installation_jetson.md。【免费下载链接】librealsenseRealSense SDK项目地址: https://gitcode.com/GitHub_Trending/li/librealsense创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
阅读完成 · 觉得有帮助？
