據(jù))
RealSense 深度相機快速上手15分鐘從插線到讀出深度數(shù)據(jù)【免費下載鏈接】librealsenseRealSense SDK項目地址: https://gitcode.com/GitHub_Trending/li/librealsenselibrealsense 是 RealSense 深度相機的官方開源 SDK把相機的彩色、深度、紅外流變成代碼能用的數(shù)據(jù)。這篇寫給做機器人、3D 掃描、視覺項目的你讀完能裝好 SDK、確認(rèn)相機在線并讓程序讀出物體距離。裝好 SDK按場景挑最省事的安裝路徑先按場景選Python 用戶走 pipUbuntu 上寫 C 走官方 apt 源因為兩者都是預(yù)編譯的省掉源碼編譯那半小時。Python任何平臺pip install pyrealsense2這條命令裝 Python 綁定裝完就能import pyrealsense2。穩(wěn)定版叫 pyrealsense2嘗鮮版叫 pyrealsense-beta兩個只裝一個。Ubuntu 20/22/24C 開發(fā)curl -sSf https://librealsense.realsenseai.com/Debian/librealsenseai.asc | gpg --dearmor | sudo tee /etc/apt/keyrings/librealsenseai.gpg /dev/null echo deb [signed-by/etc/apt/keyrings/librealsenseai.gpg] https://librealsense.realsenseai.com/Debian/apt-repo $(lsb_release -cs) main | sudo tee /etc/apt/sources.list.d/librealsense.list sudo apt-get update這三行添加官方 APT 源并刷新包列表。sudo apt-get install librealsense2-dkms librealsense2-utils librealsense2-devdkms 包會自動打好內(nèi)核模塊補丁內(nèi)核模塊是 OS 加載進內(nèi)核、用來驅(qū)動硬件的一段代碼升級內(nèi)核后自動重編utils 提供 realsense-viewer 等工具dev 提供編譯頭文件。裝完驗證驅(qū)動是否生效modinfo uvcvideo | grep version:輸出包含 realsense 字樣說明打過補丁的驅(qū)動已加載。源碼編譯只有兩種情況需要內(nèi)核不在 dkms 支持的 LTS 列表里或要合并自己的補丁。步驟是git clone https://gitcode.com/GitHub_Trending/li/librealsense cd librealsense ./scripts/setup_udev_rules.sh ./scripts/patch-realsense-ubuntu-lts-hwe.sh克隆倉庫、裝 udev 規(guī)則udev 規(guī)則是決定哪個用戶能讀 USB 設(shè)備的系統(tǒng)配置、再給當(dāng)前 Ubuntu LTS 內(nèi)核打驅(qū)動補丁。然后編譯安裝mkdir build cd build cmake .. -DBUILD_EXAMPLEStrue make -j$(nproc) sudo make install在 build 目錄完成配置和編譯把庫、示例、工具裝進 /usr/local。完整流程見 doc/distribution_linux.md。看懂?dāng)?shù)據(jù)深度相機給你的四類數(shù)據(jù)各在說什么相機給你的不是一張圖而是四類數(shù)據(jù)各自回答不同的問題。彩色幀普通 RGB 照片給人看和展示用單位是像素。深度幀每個像素存著相機到物體的距離單位毫米0 表示沒測出來。這是整個 SDK 的核心產(chǎn)出?；A(chǔ)設(shè)施幀紅外左右紅外相機拍下的圖是算深度的原料人眼在暗處看到的就是它。點云把每個深度像素按相機參數(shù)投影到三維空間得到 (x, y, z) 坐標(biāo)集合是機器人抓取和 3D 掃描的起點。完成最常用的四個操作從出流到調(diào)參裝完之后的日常工作基本就這四件事。跑通第一個出流程序用 pipeline 接口因為它把配置、啟動、取幀打包成一個對象5 行就能出數(shù)。import pyrealsense2 as rs pipe rs.pipeline() pipe.start() frames pipe.wait_for_frames() print(frames.get_depth_frame().get_distance(320, 240))保存后運行 → 終端打印畫面中心像素的距離單位是米。C 版等價物是示例目錄里的 hello-realsense完整示例清單在 examples/。把深度變成 3D 點云深度幀還是二維的點云把它立起來。編譯時帶-DBUILD_EXAMPLEStrue運行 rs-pointcloud → 彈出一個實時 3D 點云窗口鼠標(biāo)可以旋轉(zhuǎn)和縮放。每個深度像素都用標(biāo)定數(shù)據(jù)相機鏡頭參數(shù)SDK 已內(nèi)置算出自己的三維坐標(biāo)。錄制與回放 .db3 文件把現(xiàn)場一次流式會話存成文件之后不接相機也能反復(fù)調(diào)試。.db3 是基于 SQLite 的錄制文件和 ROS2 的 rosbag2 同格式標(biāo)準(zhǔn) ROS2 工具能直接打開。代碼側(cè)兩個對象各管一頭rs2::recorder 把真實設(shè)備包成邊用邊錄的設(shè)備rs2::playback 把文件加載成只讀設(shè)備兩者用法和普通設(shè)備一致還能 seek、變速。viewer 里在 Settings Playback Record 勾選錄制。注意想讓文件被 ROS2 工具兼容把壓縮選項設(shè)成 Never Compress。細(xì)節(jié)看 doc/record-and-playback.md。打開 D400 高級模式控制面板在 viewer 里開啟高級模式 → 出每個傳感器的獨立控制項激光功率、曝光、幀率都能單獨調(diào)開啟動作會寫進相機閃存重置相機后也不用再開。過一遍三個高頻故障找不到相機、深度圖有洞、顏色對不齊真實問題大多落在這三類里各按現(xiàn)象 → 怎么查 → 看到什么 → 怎么解決走一遍。系統(tǒng)找不到相機現(xiàn)象lsusb | grep 8086無輸出viewer 列表是空的程序報找不到設(shè)備。怎么查先看 USB 層再看內(nèi)核日志。lsusb | grep 8086 dmesg | tail -508086 是 RealSense 的 USB 廠商號第一條確認(rèn)硬件是否被系統(tǒng)看到第二條看驅(qū)動有沒有報錯。看到什么lsusb 為空是 USB 層問題lsusb 有設(shè)備但 dmesg 里 uvcvideo 報錯是驅(qū)動層問題。怎么解決換到 USB3 口口內(nèi)是藍(lán)色換原裝線剛升級過內(nèi)核的話重跑一次內(nèi)核補丁腳本再插拔相機。深度圖大片空洞現(xiàn)象深度圖大面積黑色0 值物體邊緣鋸齒深度質(zhì)量工具的 Fill Rate有效像素占比直接反映圖能用來算的比例只有 78% 左右。怎么查編譯 post-processing 示例掛上空間濾波器spatial filter讓每個像素參考鄰居值平滑?？吹绞裁撮_啟后 Fill Rate 升到 92% 左右邊緣變連續(xù)把它的 alpha 強度參數(shù)調(diào)到 0空洞立刻回來證明是濾波在起作用。怎么解決空間濾波常開再疊一個時域濾波器temporal filter默認(rèn)時間常數(shù) 200 ms壓掉逐幀抖動的噪點。顏色和深度對不齊現(xiàn)象深度幀和彩色幀疊在一起同一個物體的輪廓錯位點云顏色串邊。怎么查跑 align 示例它把深度幀映射到彩色幀的坐標(biāo)系空間對齊spatial alignment?？吹绞裁磳R后兩幀共用同一套像素網(wǎng)格錯位消失單幀對齊開銷幾毫秒實時流完全夠用。怎么解決下游計算統(tǒng)一用對齊后的深度幀需要反方向彩色到深度映射時看 align-advanced 示例。平臺差異與高頻坑差異集中在 Linux 驅(qū)動環(huán)節(jié)Windows 和 Python 路線基本沒有摩擦。平臺安裝方式驗證驅(qū)動備注Ubuntu 20/22/24官方 apt 包modinfo 輸出含 realsense推薦路線功能最完整非 LTS 內(nèi)核 / 其他發(fā)行版源碼編譯 手動補丁dmesg 出現(xiàn)新 uvcvideo 注冊需自己確認(rèn)內(nèi)核版本受支持Windows官方預(yù)編譯 bundle設(shè)備管理器識別相機不用打內(nèi)核補丁macOS源碼編譯依賴走 Homebrewlsusb 看到設(shè)備文檔見 doc/installation_osx.md僅 Pythonpip install pyrealsense2lsusb 看到 8086 設(shè)備起步最快高頻坑按癥狀 → 原因 → 解法記lsusb | grep 8086為空相機插了 USB2 口或線不行 → 換 USB3 口換原裝線。dmesg 報tainting kernel內(nèi)核 4.4 之后的常規(guī)警告不影響功能 → 忽略。編譯報fastrtps/fastcdr錯找不到 DDS 依賴 → cmake 加-DBUILD_WITH_DDSOFF。編譯報 curl 依賴錯更新檢查模塊找不到 libcurl → cmake 加-DCHECK_FOR_UPDATESOFF。gcc: internal compiler error編譯內(nèi)存不夠 → 關(guān)掉占內(nèi)存的程序虛擬機里把內(nèi)存加到至少 2 GB。虛擬機里相機行為詭異USB3 透傳有損耗官方不保證 VM 支持 → 要用就選 VMware 并確認(rèn) USB3 控制器模擬正?！，F(xiàn)在就做插好相機運行 realsense-viewer → 彩色、深度、紅外三個視口亮起。跑一遍上面那段 5 行腳本拿到你的第一個深度數(shù)值。相機不亮就先lsusb | grep 8086按第一節(jié)的順序往下排。【免費下載鏈接】librealsenseRealSense SDK項目地址: https://gitcode.com/GitHub_Trending/li/librealsense創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考 RealSense 深度相機快速上手：15分鐘從插線到讀出深度數(shù)據(jù)
RealSense 深度相機快速上手15分鐘從插線到讀出深度數(shù)據(jù)【免費下載鏈接】librealsenseRealSense SDK項目地址: https://gitcode.com/GitHub_Trending/li/librealsenselibrealsense 是 RealSense 深度相機的官方開源 SDK把相機的彩色、深度、紅外流變成代碼能用的數(shù)據(jù)。這篇寫給做機器人、3D 掃描、視覺項目的你讀完能裝好 SDK、確認(rèn)相機在線并讓程序讀出物體距離。裝好 SDK按場景挑最省事的安裝路徑先按場景選Python 用戶走 pipUbuntu 上寫 C 走官方 apt 源因為兩者都是預(yù)編譯的省掉源碼編譯那半小時。Python任何平臺pip install pyrealsense2這條命令裝 Python 綁定裝完就能import pyrealsense2。穩(wěn)定版叫 pyrealsense2嘗鮮版叫 pyrealsense-beta兩個只裝一個。Ubuntu 20/22/24C 開發(fā)curl -sSf https://librealsense.realsenseai.com/Debian/librealsenseai.asc | gpg --dearmor | sudo tee /etc/apt/keyrings/librealsenseai.gpg /dev/null echo deb [signed-by/etc/apt/keyrings/librealsenseai.gpg] https://librealsense.realsenseai.com/Debian/apt-repo $(lsb_release -cs) main | sudo tee /etc/apt/sources.list.d/librealsense.list sudo apt-get update這三行添加官方 APT 源并刷新包列表。sudo apt-get install librealsense2-dkms librealsense2-utils librealsense2-devdkms 包會自動打好內(nèi)核模塊補丁內(nèi)核模塊是 OS 加載進內(nèi)核、用來驅(qū)動硬件的一段代碼升級內(nèi)核后自動重編utils 提供 realsense-viewer 等工具dev 提供編譯頭文件。裝完驗證驅(qū)動是否生效modinfo uvcvideo | grep version:輸出包含 realsense 字樣說明打過補丁的驅(qū)動已加載。源碼編譯只有兩種情況需要內(nèi)核不在 dkms 支持的 LTS 列表里或要合并自己的補丁。步驟是git clone https://gitcode.com/GitHub_Trending/li/librealsense cd librealsense ./scripts/setup_udev_rules.sh ./scripts/patch-realsense-ubuntu-lts-hwe.sh克隆倉庫、裝 udev 規(guī)則udev 規(guī)則是決定哪個用戶能讀 USB 設(shè)備的系統(tǒng)配置、再給當(dāng)前 Ubuntu LTS 內(nèi)核打驅(qū)動補丁。然后編譯安裝mkdir build cd build cmake .. -DBUILD_EXAMPLEStrue make -j$(nproc) sudo make install在 build 目錄完成配置和編譯把庫、示例、工具裝進 /usr/local。完整流程見 doc/distribution_linux.md。看懂?dāng)?shù)據(jù)深度相機給你的四類數(shù)據(jù)各在說什么相機給你的不是一張圖而是四類數(shù)據(jù)各自回答不同的問題。彩色幀普通 RGB 照片給人看和展示用單位是像素。深度幀每個像素存著相機到物體的距離單位毫米0 表示沒測出來。這是整個 SDK 的核心產(chǎn)出?；A(chǔ)設(shè)施幀紅外左右紅外相機拍下的圖是算深度的原料人眼在暗處看到的就是它。點云把每個深度像素按相機參數(shù)投影到三維空間得到 (x, y, z) 坐標(biāo)集合是機器人抓取和 3D 掃描的起點。完成最常用的四個操作從出流到調(diào)參裝完之后的日常工作基本就這四件事。跑通第一個出流程序用 pipeline 接口因為它把配置、啟動、取幀打包成一個對象5 行就能出數(shù)。import pyrealsense2 as rs pipe rs.pipeline() pipe.start() frames pipe.wait_for_frames() print(frames.get_depth_frame().get_distance(320, 240))保存后運行 → 終端打印畫面中心像素的距離單位是米。C 版等價物是示例目錄里的 hello-realsense完整示例清單在 examples/。把深度變成 3D 點云深度幀還是二維的點云把它立起來。編譯時帶-DBUILD_EXAMPLEStrue運行 rs-pointcloud → 彈出一個實時 3D 點云窗口鼠標(biāo)可以旋轉(zhuǎn)和縮放。每個深度像素都用標(biāo)定數(shù)據(jù)相機鏡頭參數(shù)SDK 已內(nèi)置算出自己的三維坐標(biāo)。錄制與回放 .db3 文件把現(xiàn)場一次流式會話存成文件之后不接相機也能反復(fù)調(diào)試。.db3 是基于 SQLite 的錄制文件和 ROS2 的 rosbag2 同格式標(biāo)準(zhǔn) ROS2 工具能直接打開。代碼側(cè)兩個對象各管一頭rs2::recorder 把真實設(shè)備包成邊用邊錄的設(shè)備rs2::playback 把文件加載成只讀設(shè)備兩者用法和普通設(shè)備一致還能 seek、變速。viewer 里在 Settings Playback Record 勾選錄制。注意想讓文件被 ROS2 工具兼容把壓縮選項設(shè)成 Never Compress。細(xì)節(jié)看 doc/record-and-playback.md。打開 D400 高級模式控制面板在 viewer 里開啟高級模式 → 出每個傳感器的獨立控制項激光功率、曝光、幀率都能單獨調(diào)開啟動作會寫進相機閃存重置相機后也不用再開。過一遍三個高頻故障找不到相機、深度圖有洞、顏色對不齊真實問題大多落在這三類里各按現(xiàn)象 → 怎么查 → 看到什么 → 怎么解決走一遍。系統(tǒng)找不到相機現(xiàn)象lsusb | grep 8086無輸出viewer 列表是空的程序報找不到設(shè)備。怎么查先看 USB 層再看內(nèi)核日志。lsusb | grep 8086 dmesg | tail -508086 是 RealSense 的 USB 廠商號第一條確認(rèn)硬件是否被系統(tǒng)看到第二條看驅(qū)動有沒有報錯。看到什么lsusb 為空是 USB 層問題lsusb 有設(shè)備但 dmesg 里 uvcvideo 報錯是驅(qū)動層問題。怎么解決換到 USB3 口口內(nèi)是藍(lán)色換原裝線剛升級過內(nèi)核的話重跑一次內(nèi)核補丁腳本再插拔相機。深度圖大片空洞現(xiàn)象深度圖大面積黑色0 值物體邊緣鋸齒深度質(zhì)量工具的 Fill Rate有效像素占比直接反映圖能用來算的比例只有 78% 左右。怎么查編譯 post-processing 示例掛上空間濾波器spatial filter讓每個像素參考鄰居值平滑?？吹绞裁撮_啟后 Fill Rate 升到 92% 左右邊緣變連續(xù)把它的 alpha 強度參數(shù)調(diào)到 0空洞立刻回來證明是濾波在起作用。怎么解決空間濾波常開再疊一個時域濾波器temporal filter默認(rèn)時間常數(shù) 200 ms壓掉逐幀抖動的噪點。顏色和深度對不齊現(xiàn)象深度幀和彩色幀疊在一起同一個物體的輪廓錯位點云顏色串邊。怎么查跑 align 示例它把深度幀映射到彩色幀的坐標(biāo)系空間對齊spatial alignment?？吹绞裁磳R后兩幀共用同一套像素網(wǎng)格錯位消失單幀對齊開銷幾毫秒實時流完全夠用。怎么解決下游計算統(tǒng)一用對齊后的深度幀需要反方向彩色到深度映射時看 align-advanced 示例。平臺差異與高頻坑差異集中在 Linux 驅(qū)動環(huán)節(jié)Windows 和 Python 路線基本沒有摩擦。平臺安裝方式驗證驅(qū)動備注Ubuntu 20/22/24官方 apt 包modinfo 輸出含 realsense推薦路線功能最完整非 LTS 內(nèi)核 / 其他發(fā)行版源碼編譯 手動補丁dmesg 出現(xiàn)新 uvcvideo 注冊需自己確認(rèn)內(nèi)核版本受支持Windows官方預(yù)編譯 bundle設(shè)備管理器識別相機不用打內(nèi)核補丁macOS源碼編譯依賴走 Homebrewlsusb 看到設(shè)備文檔見 doc/installation_osx.md僅 Pythonpip install pyrealsense2lsusb 看到 8086 設(shè)備起步最快高頻坑按癥狀 → 原因 → 解法記lsusb | grep 8086為空相機插了 USB2 口或線不行 → 換 USB3 口換原裝線。dmesg 報tainting kernel內(nèi)核 4.4 之后的常規(guī)警告不影響功能 → 忽略。編譯報fastrtps/fastcdr錯找不到 DDS 依賴 → cmake 加-DBUILD_WITH_DDSOFF。編譯報 curl 依賴錯更新檢查模塊找不到 libcurl → cmake 加-DCHECK_FOR_UPDATESOFF。gcc: internal compiler error編譯內(nèi)存不夠 → 關(guān)掉占內(nèi)存的程序虛擬機里把內(nèi)存加到至少 2 GB。虛擬機里相機行為詭異USB3 透傳有損耗官方不保證 VM 支持 → 要用就選 VMware 并確認(rèn) USB3 控制器模擬正?！，F(xiàn)在就做插好相機運行 realsense-viewer → 彩色、深度、紅外三個視口亮起。跑一遍上面那段 5 行腳本拿到你的第一個深度數(shù)值。相機不亮就先lsusb | grep 8086按第一節(jié)的順序往下排。【免費下載鏈接】librealsenseRealSense SDK項目地址: https://gitcode.com/GitHub_Trending/li/librealsense創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考