跳至主要内容

使用 UniCAM 設定 ASR702 GMSL 相機

UniCAM 是研華針對 ASR702 提供的 GMSL 相機設定工具,將相機接頭配置、曝光同步與 ROS 2 開機啟動管理整合為單一操作流程。面對多相機系統,開發者可以為八個 GMSL 接頭分別指定支援的相機型號、檢查硬體偵測與設定驗證訊息,並為支援同步的相機設定共用觸發訊號,在套用前集中確認整體相機配置。

UniCAM 同時提供適用於桌面環境的圖形介面、無桌面環境的文字介面,以及用於設定與 ROS 服務管理的命令列工具。重點功能包含逐接頭相機配置與 ROS 啟動控制、可選擇的同步觸發頻率,以及支援的 Gemini 與 D457 相機之 IR 控制。透過整合設定驗證與設定檔產生流程,UniCAM 讓多相機系統的配置與維護更有一致性。相機設定變更須儲存並重新開機後才會生效;首次設定則需依下文說明完整斷電。

本指南說明如何使用 UniCAM,在搭載 Jetson AGX Thor、JetPack 7.2 的 ASR702 上完成 GMSL 相機設定。

了解通道架構​

ASR702 具有兩顆 MAX96712 deserializer:第 1 顆連接 CH1~CH4,第 2 顆連接 CH5~CH8。每顆 deserializer 提供 8 個 video pipe,最多可同時承載 8 路影像串流。一台相機可能使用多路串流;來源以 ZED X 使用 2 路、Gemini 335Lg 使用 4 路為例。

第 1 顆 Deserializer 的 Link A、B、C、D 分別對應 CH4、CH3、CH2、CH1,第 2 顆 Deserializer 的 Link A、B、C、D 分別對應 CH8、CH7、CH6、CH5 的架構圖

圖 1. ASR702 的每顆 Deserializer 皆採反向通道順序:第 1 顆將 Link A~D 對應至 CH4~CH1;第 2 顆將 Link A~D 對應至 CH8~CH5。

透過 Robotic Suite 安裝​

請透過 Robotic Suite Complete 安裝所需環境,不要再執行獨立的相機套件安裝程式。請依照 Robotic Suite Complete 安裝指南,並依其下載頁說明取得 adv-robotic-suite-installer.run。

安裝前請確認系統已安裝研華 SUSI,且目標為研華平台、至少有 10 GB 可用空間、Ubuntu 使用英文介面並可連線網際網路。接著啟動安裝程式:

sudo ./adv-robotic-suite-installer.run

安裝程式選單出現後,以空白鍵勾選目標平台所需元件,選擇 OK,等待完成訊息後重新開機,以完成環境設定。可選套件可能因平台與 Robotic Suite 版本而異,請以目標系統顯示的選項為準。

第一次設定 UniCAM

第一次完成接頭配置後,請將系統完整斷電 30 秒再開機。後續修改 UniCAM 設定只需執行 sudo reboot。

開啟 UniCAM​

有桌面環境時使用圖形介面;無桌面環境時可使用文字介面:

sudo unicam
sudo unicam --tui

在 TUI 中使用方向鍵操作,按 F10 套用。GUI 包含 CAMERA CONNECTION、TIME SYNC 與 ROS CONFIGURATION 三個分頁;在任一分頁按 SAVE & APPLY,都會一併儲存三頁設定。

配置並驗證相機​

在 CAMERA CONNECTION 分頁,為 CH1~CH8 選擇實際連接的相機;未使用的接頭請選 None。

顯示通道選單、硬體偵測、驗證訊息與操作按鈕的 Camera Connection 分頁

圖 2. CAMERA CONNECTION 將通道配置、硬體偵測與設定驗證整合在同一頁。

此頁提供以下控制與狀態資訊:

  • ADVANCE 顯示 PHY、VI、lane 數、連線速率與虛擬通道配置,供工程人員確認,不需在此修改。
  • DETECTED HARDWARE 顯示系統從各接頭讀到的硬體。綠色代表偵測到的型號;黃色 (not read) 代表驅動已接管相機,因此顯示的是已儲存設定,而不是即時硬體讀值。
  • Auto Apply 會自動將偵測結果填入通道選單;RE-SCAN 會重新偵測。
  • VALIDATION 以紅色顯示阻擋儲存的錯誤,以黃色顯示提醒;例如單顆 deserializer 宣告超過 8 路串流。
  • SET ALL TO NONE 將八個接頭全部清為 None。
  • APPLY DETECTED 將偵測結果填入選單,但尚未儲存。
  • SAVE & APPLY 會驗證、儲存並產生設定,接著詢問是否重新開機。
偵測前先停止所有串流

硬體偵測必須在沒有相機串流開啟時進行。若出現 Not scanned: a stream is open,請先停止使用相機的應用程式,並查詢各接頭的 ROS 服務:

sudo unicam-ros status
sudo systemctl stop adv-ros-ch1.service

服務名稱採 adv-ros-chN.service 格式,每個接頭各有一個服務。請停止占用待偵測相機的服務,再按 RE-SCAN。若偵測後未修改設定,以 sudo systemctl start <服務名稱> 重新啟動先前停止的服務;若有套用新的相機設定,則執行 sudo reboot。

展開的進階路由檢視,列出 g1 與 g2 的 PHY、VI、lane、速率與虛擬通道配置

圖 3. 展開 ADVANCE 後,可檢查標示為 g1、g2 的兩顆 deserializer 之產生路由資訊。

CLI 使用的相機名稱​

GUI 名稱主要 CLI 代號可用別名
RealSense - D457d457—
Orbbec - Gemini 335Lgg335Lggemini、g300
StereoLabs - ZED Xzedx—
StereoLabs - ZED X Minizedxmini—
StereoLabs - ZED X Nanozedxnano—
StereoLabs - ZED X One (GS)zedxone—
StereoLabs - ZED X One 4Kzedxone4k—
Leopard Imaging - OX03F10li-ox03f10ox03f10、leopard
Leopard Imaging - ISX031li-isx031leopard-isx031
欣普羅(APPRO) - AR0234(ISP module)appro-ar0234—
森雲智能(Sensing World)- SG8Aswsensingworld、sgcam、isx031
Nonenone—
ISX031 代號

未加限定的 isx031 別名代表森雲智能(Sensing World)- SG8A;Leopard Imaging 的 ISX031 請使用 li-isx031。

設定曝光同步​

TIME SYNC 分頁會為兩顆 deserializer 的所有接頭產生同一組觸發脈衝。Trigger frequency 可設為 off、10、15、20、25 或 30 Hz;選擇數值頻率代表開啟 Time Sync,設為 off 則讓相機各自依自身時脈運作。此頁也會依目前配置的相機,顯示可否跟隨觸發及所需模式。

已開啟 30 Hz 同步並顯示相機相容性提醒的 Time Sync 分頁

圖 4. 此範例已開啟 TIME SYNC:Trigger frequency 設為 30 Hz,因此兩顆 deserializer 會收到共用的 30 Hz 觸發脈衝。選單下方的訊息會說明目前配置的相機是否跟隨該脈衝,以及哪些相機仍依自身時脈運作。

相機是否同步來源所述需求
ZED X/ZED X Mini/ZED X Nano是不需額外設定。
Gemini 335Lg是模式 fps 必須高於觸發頻率;30 Hz 時使用 60 fps 模式,ROS 會自動設定。
RealSense D457是僅支援 15 或 30 Hz;fps 等於觸發頻率。
Leopard ISX031是驅動會自動切換。
森雲智能(Sensing World)- SG8A是可搭配要求的頻率同步。
Leopard OX03F10/欣普羅(APPRO) AR0234否按自身時脈輸出影像。

ZED X One 系列尚未驗證 Time Sync,因此本表不將其列為支援同步。

擷取方式與同步驗證步驟請參閱另行提供的 FSYNC-TUTORIAL.zh-TW.pdf。修改 FSYNC 後必須重新開機。

設定 ROS 2 開機啟動​

ROS CONFIGURATION 分頁需要先透過 Robotic Suite 安裝 ROS 2 Jazzy。若頁面顯示 ROS 2 Jazzy is not installed,開機啟動控制將無法使用。表格採每個接頭各一列,欄位為 CAMERA MODEL、CHANNEL、START AT BOOT 與 IR。請針對開機時要啟動 ROS 2 節點的接頭開啟 START AT BOOT。

IR 僅適用於 Gemini 與 D457。Gemini 必須先開啟 Time Sync,才能開啟 ROS 啟動設定。

UniCAM ROS Configuration 實際截圖,每個接頭各一列,包含 Camera Model、Channel、Start at Boot 與 IR 欄位

圖 5. ROS CONFIGURATION 設定頁面。每個接頭各有一列,IR 控制只會出現在支援的 Gemini 與 D457 列。

部分相機需要外部套件:

相機需求安裝方式
RealSense D457librealsense2 2.58套件內附;缺少時工具會詢問是否安裝,後續可在 2.58.x 內升級。
Leopard OX03F10Argus GStreamer 外掛與 gstreamer1.0-plugins-baseunicam-ros install-deps 會安裝所需相依套件;GStreamer base 外掛會透過 APT 取得,可能需要網路連線。
ZED 系列ZED SDK 5.4.1請從 StereoLabs 手動安裝 JetPack 7.2 版本。
Gemini、ISX031、森雲智能(Sensing World)、欣普羅(APPRO)來源未列額外需求依來源不需安裝額外套件。

儲存、重新開機與套用​

當 VALIDATION 仍有紅色錯誤時,SAVE & APPLY 不會儲存。驗證通過後,工具會儲存並產生設定,再顯示 Reboot now?。選 Yes 立即重新開機;選 No 則稍後執行 sudo reboot。

Save and Apply 確認訊息與後續的 Reboot now 提示

圖 6. 已儲存的設定必須在重新開機後生效;第一次安裝則需完整斷電。

使用命令列設定​

unicam --show
sudo unicam CH1=zedx CH2=g335Lg CH8=d457 FSYNC=30
sudo unicam FSYNC=15
sudo unicam --detect
sudo unicam --apply
sudo reboot
CHn= 代表完整通道設定

指令只要包含任何 CHn= 配置,未出現在該指令中的接頭都會變成 none。修改前先執行 unicam --show,並把所有需要保留的配置一併寫入。只修改 FSYNC 的指令會保留原有通道配置。

使用以下指令管理 ROS 服務:

sudo unicam-ros status
sudo unicam-ros on CH1
sudo unicam-ros off CH1
sudo unicam-ros ir CH2 on
sudo unicam-ros install-deps

on 與 off 可指定單一接頭。套用相機設定後,UniCAM 會自動更新對應的 ROS 服務。

常見問題​

狀況處理方式
設定修改後沒有變化儲存後重新開機。第一次安裝後需完整斷電 30 秒。
VALIDATION 顯示超過 8 路串流每顆 deserializer 只有 8 個 video pipe。設定可以儲存,但該 deserializer 不可同時開啟超過 8 路串流。
偵測顯示 Not scanned: a stream is open執行 sudo unicam-ros status,停止受影響的 adv-ros-chN.service,再執行 RE-SCAN。若未修改設定,重新啟動原先停止的服務;若有套用新設定則重新開機。
偵測顯示 (not read)驅動已接管相機。若要取得即時讀值,將該接頭設為 None、儲存、重新開機後再掃描。
同一顆 deserializer 的相機全部消失或大量掉幀檢查相機是否也連接 USB 或外接電源。拔除 USB 並完整移除所有電源(包含外接電源);sudo reboot 不會切斷外接電源。
ZED 的 ROS 節點無法啟動安裝適用 JetPack 7.2 的 ZED SDK 5.4.1。
移除並重新安裝套件後 ROS 服務仍為關閉使用 unicam-ros 重新開啟所需接頭的服務。直接升級套件不受此問題影響。

套件行為與支援裝置可能變更,部署前請確認與目標系統的相容性。