使用 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. 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 版本而異,請以目標系統顯示的選項為準。
第一次完成接頭配置後,請將系統完整斷電 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。

圖 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。

圖 3. 展開 ADVANCE 後,可檢查標示為 g1、g2 的兩顆 deserializer 之產生路由資訊。
CLI 使用的相機名稱
| GUI 名稱 | 主要 CLI 代號 | 可用別名 |
|---|---|---|
| RealSense - D457 | d457 | — |
| Orbbec - Gemini 335Lg | g335Lg | gemini、g300 |
| StereoLabs - ZED X | zedx | — |
| StereoLabs - ZED X Mini | zedxmini | — |
| StereoLabs - ZED X Nano | zedxnano | — |
| StereoLabs - ZED X One (GS) | zedxone | — |
| StereoLabs - ZED X One 4K | zedxone4k | — |
| Leopard Imaging - OX03F10 | li-ox03f10 | ox03f10、leopard |
| Leopard Imaging - ISX031 | li-isx031 | leopard-isx031 |
| 欣普羅(APPRO) - AR0234(ISP module) | appro-ar0234 | — |
| 森雲智能(Sensing World)- SG8A | sw | sensingworld、sgcam、isx031 |
| None | none | — |
未加限定的 isx031 別名代表森雲智能(Sensing World)- SG8A;Leopard Imaging 的 ISX031 請使用 li-isx031。
設定曝光同步
TIME SYNC 分頁會為兩顆 deserializer 的所有接頭產生同一組觸發脈衝。Trigger frequency 可設為 off、10、15、20、25 或 30 Hz;選擇數值頻率代表開啟 Time Sync,設為 off 則讓相機各自依自身時脈運作。此頁也會依目前配置的相機,顯示可否跟隨觸發及所需模式。

圖 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 啟動設定。

圖 5. ROS CONFIGURATION 設定頁面。每個接頭各有一列,IR 控制只會出現在支援的 Gemini 與 D457 列。
部分相機需要外部套件:
| 相機 | 需求 | 安裝方式 |
|---|---|---|
| RealSense D457 | librealsense2 2.58 | 套件內附;缺少時工具會詢問是否安裝,後續可在 2.58.x 內升級。 |
| Leopard OX03F10 | Argus GStreamer 外掛與 gstreamer1.0-plugins-base | unicam-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。

圖 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= 配置,未出現在該指令中的接頭都會變成 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 重新開啟所需接頭的服務。直接升級套件不受此問題影響。 |
套件行為與支援裝置可能變更,部署前請確認與目標系統的相容性。