重要通知

尊敬的開(kāi)發(fā)者：

為了更好地支持您進(jìn)行 Gemini 335Lg 相機的集成與開(kāi)發(fā)，我們創(chuàng )建了一個(gè)全新的、內容更全面的 GitHub 代碼庫。詳細信息如下：

新代碼庫地址：https://github.com/orbbec/MIPI_Camera_Platform_Driver

新代碼庫包含：

●      更全面的官方文檔

●      最新的二進(jìn)制文件

●      驅動(dòng)適配源碼

●      豐富的開(kāi)發(fā)示例

期待您的加入！

1. 準備工作

1.1  硬件設備

●      Gemini 335Lg 盒裝相機

●      NVIDIA Jetson AGX Orin DevKit 及適配電源

●      GMSL 相機解串板(示例型號:FG96_8CH_GMSL(EVK)) 及適配電源

支持的相機和平臺信息如下表 1-1所示

表 1-1

1.2  軟件資源

●      預編譯驅動(dòng)文件

●      OrbbecViewer 軟件（版本支持OrbbecViewer_v2.0.7-rc及以上）

2. 盒裝開(kāi)箱與安裝步驟

2.1  撕開(kāi)或剪斷盒裝兩側透明膠帶

圖 2-1

2.2  取出Gemini 335Lg相機、FAKRA-Z 對接線(xiàn)、三腳架、三腳架云臺、快速入門(mén)手冊

圖 2-2

2.3   撕掉相機玻璃蓋板白色保護膜

圖 2-3

2.4  將三腳架和三腳架云臺組裝好，然后安裝Gemini 335Lg相機

圖 2-4

2.5  打開(kāi)Gemini 335Lg相機頂部同步端口蓋，將右側的USB/MIPI切換開(kāi)關(guān)撥至M端，并恢復同步端口蓋

圖 2-5

3. 連接設備并上電啟動(dòng)

3.1  打開(kāi)Gemini 335Lg相機右側FAKRA接口蓋板，用 FAKRA-Z 對接線(xiàn)連接相機與 GMSL 相機解串板

圖 3-1

3.2  將GMSL 相機解串板和Jetson AGX Orin DevKit 安裝好

圖 3-2

3.3  接入電源

為Jetson AGX Orin DevKit和GMSL 相機解串板連接適配電源

提示:該示例GMSL 相機解串板為12V 3A電源；

圖 3-3

3.4  Jetson AGX Orin DevKit連接顯示器、鍵盤(pán)和鼠標等外設，并對Jetson AGX Orin DevKit和GMSL 相機解串板上電啟動(dòng)設備

4. 加載預編譯驅動(dòng)文件

4.1  查詢(xún)JetPack軟件版本

終端輸入命令查詢(xún)Jetson AGX Orin DevKit當前安裝的JetPack軟件版本

dpkg -l | grep nvidia-l4t-core

終端輸出nvidia-l4t-core 版本，通過(guò)NVIDIA的JetPack-L4T對應表得知當前安裝的JetPack軟件版本(示例輸出nvidia-l4t-core版本為36.4.3，對應JetPack 6.2版本)

圖 4-1

示例圖 4-2

4.2  獲取預編譯驅動(dòng)文件

從Github代碼庫下載預編譯驅動(dòng)文件"gmsl-driver-jetson-vx.x.x(JPx.x).zip"，并放置在"~/Downloads"文件目錄下

圖 4-3

4.3  解壓與安裝

終端輸入命令解壓與安裝預編譯驅動(dòng)文件

提示:GMSL 相機解串板FG96_8CH_GMSL(EVK)對應預編譯驅動(dòng)文件為copy_to_target_agx_orin_fg96.sh腳本，若預編譯與GMSL 相機解串板不一致的腳本，會(huì )導致加載驅動(dòng)失敗，重新預編譯正確的腳本即可。

cd ~/Downloads/
unzip MIPI_Camera_Platform_Driver.zip
cd gmsl-driver-jetson-v1.2.03(JP6.2)/
chmod +x copy_to_target_agx_orin_fg96.sh
sh copy_to_target_agx_orin_fg96.sh
reboot

圖 4-4

5. 開(kāi)始使用

5.1  檢查驅動(dòng)版本

終端輸入命令查看內核模塊GMSL相機驅動(dòng)版本

提示:確認驅動(dòng)版本號與預編譯驅動(dòng)文件版本號一致

cat /sys/module/g300/version

圖 5-1

5.2  列出視頻節點(diǎn)

終端輸入命令列出/dev目錄路徑下的視頻節點(diǎn)數量

ls /dev/video*

提示:1臺Gemini 335Lg相機會(huì )有8個(gè)視頻節點(diǎn)，其中video0是深度數據流，video1是深度元數據，video2是彩色數據流，video3是彩色元數據，video4是左紅外數據流，video5是左紅外元數據，video6是右紅外數據流，video7是右紅外元數據

圖 5-2

5.3  獲取OrbbecViewer軟件

為確認Jetson AGX Orin DevKit在加載預編譯驅動(dòng)文件后成功適配Gemini 335Lg相機，故運行OrbbecViewer軟件。若適配成功，則OrbbecViewer軟件可以連接Gemini 335Lg相機，并預覽彩色數據流、深度數據流、紅外數據流和IMU數據流的圖像。否則，OrbbecViewer軟件連接Gemini 335Lg相機失敗，無(wú)法預覽圖像。

從OrbbecSDK_v2 Releases中下載最新版本的OrbbecViewer軟件，并放置在"~/Downloads"文件目錄下(當前最新版本為OrbbecViewer_v2.4.8_xxx.zip)

圖 5-3

5.4  解壓與運行

終端輸入命令解壓與運行OrbbecViewer軟件

cd ~/Downloads/
unzip OrbbecViewer_v2.4.8_202507031357_a1355db_linux_aarch64.zip
cd OrbbecViewer_v2.4.8_202507031357_a1355db_linux_aarch64/
sudo ./OrbbecViewer

圖 5-4

圖 5-5

5.5  預覽圖像

在設備管理區中，依次開(kāi)啟彩色數據流、深度數據流、左紅外數據流、右紅外數據流和IMU數據流預覽對應的圖像

圖 5-6