尧图网络 高端网站定制 · 原创设计
免费咨询热线
400-888-6620
免费获取方案
RealSense SR300 在 Ubuntu 22.04 上用 Python 取到深度流:librealsense 连接指南
RealSense SR300 在 Ubuntu 22.04 上用 Python 取到深度流librealsense 连接指南【免费下载链接】librealsenseRealSense SDK项目地址: https://gitcode.com/GitHub_Trending/li/librealsenselibrealsense 是 Intel RealSense 深度相机的官方 SDK。在 Ubuntu 22.04 上接入 SR300 这类立体红外相机核心障碍只有一个内核里的 uvcvideo 驱动Linux 处理 USB 摄像头的内置驱动必须打上补丁Python 绑定才有数据可取。下面从接上设备到跑通深度流带你走一遍。先诊断确认设备和驱动是否就绪 拿到相机后最常见的现象是插上没反应或者Python 里pipeline.start()直接抛No device connected。别急着写代码先用两条命令判断环境处于哪一层lsusb | grep 8086—— 8086 是 Intel 的 USB 厂商 ID能列出设备说明 USB 层识别正常完全没输出先换 USB 3.0 口直连、去掉扩展坞再试。sudo dmesg -T | tail -n 50—— 翻看最近的内核日志。如果看到新的uvcvideo注册记录说明打过补丁的驱动已经生效如果设备明明在lsusb里却没有任何取帧相关的活动多半还是原生驱动在工作。这一步能帮你分清问题卡在硬件/USB、内核驱动还是上层 SDK后面两步才不会白做。另外用uname -r记一下你的内核版本Ubuntu 22.04 常见的 HWE 内核是 5.15 / 5.19 / 6.5 / 6.8 / 6.11 / 6.14后续补丁脚本只覆盖这些版本。安装与配置依赖、udev 规则和内核补丁一次做完建议先拔下相机再动系统。把下面这段整体贴进终端它依次完成系统包更新、编译依赖安装含构建 SDK 和内核模块所需的全部包、拉取源码、写入 udev 权限规则让普通用户能读写设备脚本支持--uninstall回退、按当前 HWE 内核下载并编译打过补丁的 uvcvideo 模块sudo apt-get update sudo apt-get upgrade sudo apt-get install -y libusb-1.0-0-dev libudev-dev libssl-dev pkg-config \ libgtk-3-dev git wget cmake build-essential libglfw3-dev libgl1-mesa-dev libglu1-mesa-dev at git clone https://gitcode.com/GitHub_Trending/li/librealsense cd librealsense ./scripts/setup_udev_rules.sh ./scripts/patch-realsense-ubuntu-lts-hwe.sh两个可以少踩坑的细节依赖包官方文档建议拆开装是因为某些平台一次装会出依赖冲突这里合并成一条apt-get一般没问题失败再拆开即可libudev-dev让 SDK 用事件驱动方式监听插拔比默认轮询更灵敏值得装。装完确认两件事跑sudo dmesg | tail -n 50应能看到新uvcvideo驱动注册的字样日志里若出现uvcvideo: module verification failed ... tainting kernel这是 4.4-30 内核的标准警告不用理会。接下来在build目录下构建 SDK 并生成 Python 绑定。系统里装了多个 Python 版本时用-DPYTHON_EXECUTABLE显式指定路径避免绑错解释器mkdir build cd build cmake ../ -DBUILD_PYTHON_BINDINGS:booltrue -DBUILD_EXAMPLEStrue -DPYTHON_EXECUTABLE$(which python3) make -j$(nproc) sudo make install export PYTHONPATH$PYTHONPATH:/usr/local/lib产物落在/usr/local/lib库和/usr/local/bin示例和工具。想先脱离代码验证设备本身可以运行刚装好的realsense-viewer能打开并显示相机画面说明驱动、SDK、设备三层都通了图RealSense Viewer 的画面看到实时彩色与深度流即表示连接链路正常跑通最小验证15 行 Python 深度流 绑定装好后一行命令确认能导入python3 -c import pyrealsense2 as rs; print(rs.__version__)打印出版本号才算成功报ModuleNotFoundError就是PYTHONPATH没生效。然后写一个最小脚本只开 640×480、30fps 的深度流循环打印画面中心像素的距离原始值是毫米除以 1000 换成米import pyrealsense2 as rs import numpy as np pipeline rs.pipeline() config rs.config() config.enable_stream(rs.stream.depth, 640, 480, rs.format.z16, 30) pipeline.start(config) try: while True: depth pipeline.wait_for_frames().get_depth_frame() if depth: img np.asanyarray(depth.get_data()) print(f中心距离: {img[240, 320] / 1000:.2f} m) finally: pipeline.stop()预期输出是一行接一行的中心距离: 1.42 m之类对着镜头前放个物体数值会随距离平滑变化。如果卡在pipeline.start()抛异常把LRS_LOG_LEVEL环境变量设为debug再跑一次SDK 会落一份详细日志报错原因基本能一眼定位。常见的坑 ⚠️现象原因处理办法lsusb \| grep 8086无输出走了 USB 2.0 口、有源扩展坞或线损换 USB 3.0 口直连主机换线重试设备可见但start()报无设备/无流仍在使用未打补丁的原生 uvcvideo重跑patch-realsense-ubuntu-lts-hwe.shdmesg确认新驱动已注册升级内核后相机突然失联补丁模块只适配编译时的内核版本uname -r核对版本重新执行补丁脚本dmesg 出现module verification failed ... tainting kernel内核 4.4-30 的常规警告仅提示性质无需处理ModuleNotFoundError: No module named pyrealsense2PYTHONPATH未导出或换了解释器export PYTHONPATH$PYTHONPATH:/usr/local/lib或把pyrealsense2.so拷到脚本旁取到的帧偶尔是空的、处理后数据错乱帧对象生命周期只覆盖当前循环见仓库帧生命周期文档在wait_for_frames()同一轮内完成数据拷贝再使用最后一行值得多看一眼depth.get_data()返回的缓冲不是你的下一轮wait_for_frames()之后随时可能失效要留数据就当场np.asanyarray或copy图帧生命周期——帧数据仅在当前轮次内有效跨轮使用需自行拷贝延伸与资源 跑通之后有几个方向可以直接接着做这里只给入口多相机同步接第二台 RealSense 时rs.pipeline()会自动分配到新设备思路见 examples/multicam/ 的 C 实现。深度与彩色对齐把深度图投影到彩色坐标系参考 wrappers/python/examples/align-depth2color.py。点云与可视化wrappers/python/examples/ 下有 OpenCV 显示、PLY 导出、对象检测等现成脚本。录制与回放用rs::save_to_disk/rs::play可以把现场数据存成 bag 文件离线调试数据流向见下图示例在 examples/record-playback/图录制回放流程——数据流经 SDK 写入 bag 文件回放时反向喂给 pipeline文档类路径安装细节在 doc/installation.md排查工具命令udevadm monitor、strace、uvcvideo 详细日志汇总在 doc/troubleshooting.mdPython 绑定的构建选项说明见 wrappers/python/readme.mdC 最简示例可对照 examples/hello-realsense/。【免费下载链接】librealsenseRealSense SDK项目地址: https://gitcode.com/GitHub_Trending/li/librealsense创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
RELATED

相关推荐

深度强化学习如何优化热处理晶粒度:从MDP建模到TensorRT部署

深度强化学习如何优化热处理晶粒度:从MDP建模到TensorRT部署

简介:这份764页的技术方案文档围绕DeepSeek深度强化学习在工业热处理晶粒度精准控制中的落地应用,面向材料工艺、智能制造与AI算法交叉领域的研究人员和工程师。文档按60个大章节系统展开,既涵盖晶粒度控制痛点、升温曲线耦合影响机制等工艺背…

📅 2026/9/19 20:28:48
Qwen2.5-Turbo 调 API 报 401?TaoToken 通道这样排查

Qwen2.5-Turbo 调 API 报 401?TaoToken 通道这样排查

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

📅 2026/9/19 20:23:47
Unity模型导入避坑指南:3DMax单位设置与轴心调整全攻略

Unity模型导入避坑指南:3DMax单位设置与轴心调整全攻略

做Unity项目最烦的事情之一,就是3DMax里辛辛苦苦搭好的模型,拖进Unity场景后,要么变得巨大无比,要么变成一个肉眼几乎看不见的点,要么整个模型悬在半空或者陷进地里。更崩溃的是,有时候旋转一下模型&#x…

📅 2026/9/19 20:23:47
MORE NEWS

更多资讯

📰

QMK 固件中的 Boardsource 5x12 正交线性键盘:配置解析与固件构建指南

QMK 固件中的 Boardsource 5x12 正交线性键盘:配置解析与固件构建指南 【免费下载链接】qmk_firmware Open-source keyboard firmware for Atmel AVR and Arm USB families 项目地址: https://gitcode.com/GitHub_Trending/qm/qmk_firmware 导读 Boardsourc…

📰

Vue3自定义Hooks实战:从useTable到useRequest的封装与复用

去年团队接到一个后台管理系统重构,光是搜索表格这类页面就有二十几个。某个版本上线前我随手搜了一下代码库里复制粘贴的列表请求逻辑,结果搜出来十几份几乎一模一样的loading、page、data状态管理代码。那时候团队里大多数人还在用 Options API 写业务…

📰

RBAC前端架构之Layout布局:从页面骨架到动态权限体系

“RBAC前端架构-08”这个名字,看着像是系列文章里的某一篇,光说“页面骨架Layout布局搭建”,可能很多人觉得不就是套个后台模板吗?侧边栏、顶栏、内容区,脚手架一堆,换换样式就完事了。但真正动手写RBAC系统…

📰

在 GitHub Actions 中集成 minikube 作为 CI 步骤:从集群启动到镜像构建与部署验证

在 GitHub Actions 中集成 minikube 作为 CI 步骤:从集群启动到镜像构建与部署验证 【免费下载链接】minikube Run Kubernetes locally 项目地址: https://gitcode.com/gh_mirrors/mi/minikube 本指南以 minikube 官方教程文档 setup_minikube_in_github_act…

📰

SSM+Vue实现军队任务管理系统:从设计到答辩全流程

写这篇东西之前,先聊聊背景。2026届的毕业设计季其实已经悄悄拉开序幕了,不少同学开始焦虑选题和技术栈选型的事。在Java Web方向,ssm vue这套组合依然是出镜率极高的搭配,尤其是涉及“管理系统”这类业务逻辑清晰、前后端分离特…

📰

从录制流量到独立客户端:用 agent-browser 逆向网站内部 API 的完整实战指南

从录制流量到独立客户端:用 agent-browser 逆向网站内部 API 的完整实战指南 【免费下载链接】agent-browser Browser automation CLI for AI agents 项目地址: https://gitcode.com/gh_mirrors/agen/agent-browser 导读 "第一次访问网站应该用浏览器&…

TODAY

今日更新

THIS WEEK

本周精选

THIS MONTH

本月热门

读完文章,想聊聊您的网站?

告诉我们您的行业与需求,资深顾问一对一梳理方案与报价,全程免费。

📞 💬