設定 CXP-12 Interface Card#

本主題說明如何使用 pylon API、pylon Viewer 或 gpioTool 來設定 Basler CXP-12 介面卡。

在以下情況下，設定介面卡特別有用：

• 您想要變更 Applet 以供介面卡使用。
• 您想要透過介面卡觸發所連接的 Basler boost CXP-12 相機。
• 您想要在介面卡上執行去拜爾 (Debayering)，以提高成像系統的效能。
• 您想要使用相機上無法使用的輸出格式，例如 16-bit mono 格式。
• 您想要設定觸發訊號，以便由介面卡接收或傳送。

可用的面陣掃描 Applet 與預設 Applet#

根據介面卡型號，提供以下 applet 且預設會進行設定：

除了 Acquisition Applets 之外，您也可以使用 Enhanced Applets。Enhanced Applets 為原型版本，僅限透過您當地的 Basler 業務代表或現場應用工程師提出請求時方可取得。所有 Enhanced Applets 皆具備以下附加功能：

• Binning（目前僅限單色）最高可達 4x4
• 適用於單色相機的 Block-based flat field correction (FFC)
• PGI high quality Debayering 與影像品質提升

可用的線陣掃描 Applet#

根據介面卡型號，可提供以下 applet。請注意，預設 applet（即預設載入的 applet）一律為面陣掃描 applet。因此，如果您想使用線陣掃描 applet，必須先如 Changing the Applet 中所述將其載入。

文件#

以下章節提供採集 applet 文件的連結：

CXP-12 Interface Card 1C#

CXP-12 Interface Card 2C#

CXP-12 Interface Card 4C#

選擇正確的 Applet#

如果您僅使用單通道 (1-CXP) 相機，預設 applet 將隨時適用於您的應用，且您無需進行變更。

然而，如果您使用的是多通道（例如 2-CXP 或 4-CXP）相機，則必須為您的相機設定選擇正確的 applet。否則，相機可能無法運作，或相機效能可能會大幅降低。

哪一個 applet 才正確，取決於相機數量、每台相機的通道數以及所需的 ROI 遞增尺寸。

ROI 遞增尺寸取決於影像前處理的 Parallelism，因此會因相機和擷取卡而異。

CXP-12 Interface Card 1C#

適用於 CXP-12 Interface Card 1C 的面陣掃描 Applet#

適用於 CXP-12 Interface Card 1C 的線陣掃描 Applet#

CXP-12 Interface Card 2C#

適用於 CXP-12 Interface Card 2C 的面陣掃描 Applet#

適用於 CXP-12 Interface Card 2C 的線陣掃描 Applet#

CXP-12 Interface Card 4C#

適用於 CXP-12 Interface Card 4C 的面陣掃描 Applet#

適用於 CXP-12 Interface Card 4C 的線陣掃描 Applet#

變更 Applet#

介面卡上執行的 Applet 定義了其功能。對於特定的相機設置，您可能需要更改預設的 Applet。

若要變更 pylon 中介面卡所使用的 Applet，請設定 InterfaceApplet 參數設為要載入的 applet 名稱，例如： Acq_DualCXP12Area:

使用介面卡來觸發 Basler boost CXP-12 相機#

硬體觸發（外部）#

啟用外部觸發後，您可以將觸發輸入訊號傳送至介面卡，然後介面卡會將這些訊號轉發至 Basler boost 相機。

若要將介面卡設定為外部硬體觸發：

1. 將 AreaTriggerMode 參數設為 External.
2. 將 TriggerInSource 參數設為所需的 "Front GPI" 輸入線。
   例如，如果您想要使用 GPI0（介面卡上的針腳 11 與 12）進行外部觸發，請將參數設為 FrontGpiTriggerSource0.
3. 將 TriggerCameraOutSelect 參數設為對應的 "Bypass" 選項。
   例如，如果您選擇了 FrontGpiTriggerSource0，請將 TriggerCameraOutSelect 參數設為 BypassFrontGpi0.
4. 將 TriggerState 參數設為 Active.
5. 如有必要，請按照下方所述設定觸發訊號。

所有觸發訊號都將轉發至相機的來源訊號 CxpTrigger0 和 CxpTrigger1。這些訊號可用於各種用途。最常見的應用情境是影像擷取。請參閱 下方的範例.

硬體觸發（內部）#

啟用內部觸發後，介面卡將以指定的頻率在內部產生觸發訊號。所有外部觸發訊號都將被忽略。

若要將介面卡設定為內部硬體觸發：

1. 將 AreaTriggerMode 參數設為 Generator.
2. 將 TriggerOutputFrequency 參數設為所需的觸發輸出頻率。例如，如果您將參數設為 8，介面卡將每秒產生 8 個觸發訊號。
3. 將 TriggerCameraOutSelect 參數設為所需的輸出線，例如 PulseGenerator0.
4. 將 TriggerState 參數設為 Active.

現在，每當您開始影像擷取時，介面卡就會以指定的頻率產生觸發訊號。

所有觸發訊號都將轉發至相機的來源訊號 CxpTrigger0 和 CxpTrigger1。這些訊號可用於各種用途。最常見的應用情境是影像擷取。請參閱 下方的範例.

範例：使用觸發訊號進行影像擷取#

若要使用介面卡產生的外部或內部觸發訊號來擷取影像：

1. 在相機上，將 TriggerSelector 參數設為 FrameStart.
2. 將 TriggerMode 參數設為 On.
3. 將 ExposureMode 參數設為 Timed.
4. 將 TriggerSource 參數設為 CxpTrigger0 或 CxpTrigger1.

現在，每當介面卡接收或產生觸發訊號時，相機就會擷取一張影像。

在介面卡上執行去拜爾 (Debayering)#

透過 CXP-12 Interface Card 1C，您可以在介面卡上執行去拜爾 (debayering)。這能降低相機與主機電腦的運算負載。

若要這樣做：

1. 啟動 pylon Viewer 並建立與介面卡和相機的連線。
2. 使用功能樹狀結構進行下列設定：
   • 在相機上，將 Pixel Format 選項設定為 Bayer pixel format，例如 Bayer RG 12。
   • 導覽至 Device Transport Layer 並停用 Automatic Format Control 選項。
     這可讓您獨立於相機所使用的像素格式來設定輸出格式。
   • 在介面卡上，將 OutputFormat 選項設定為對應的 RGB 像素格式。
     其位元深度必須是 Bayer 像素格式位元深度的三倍。例如，Bayer RG 12 (相機) = Color 36 bit (介面卡)。

現在，介面卡將會在相機的原始影像資料上執行去拜爾，並輸出 RGB 影像資料。

使用相機不支援的輸出格式#

Basler boost 相機能以多種像素格式輸出影像資料，例如 Bayer RG 8 或 RGB 8。如需詳細資訊，請參閱 pixel format 主題。

如果相機不提供您所需的像素格式，且您也想避免在主機電腦上進行影像轉換，您或許可以使用介面卡所提供的其中一種像素格式。

介面卡提供下列格式：

若要使用相機不支援的輸出格式：

1. 在相機上，將 PixelFormat 將 parameter 設定為所需的相機 Pixel Format，例如： Mono12.
2. 在介面卡上，將 AutomaticFormatControl 參數設為 false.
   這可讓您獨立於相機所使用的 Pixel Format 來設定輸出格式。
3. 在介面卡上，將 Format 將 parameter 設定為所需的輸出格式，例如： Gray16bit.

根據上述範例數值，介面卡將根據 12-bit 相機影像資料輸出 16-bit 影像資料。將會如以下圖示插入填補位元（零）。

使用 gpioTool 設定觸發訊號#

透過 gpioTool 命令列工具，您可以設定介面卡接收或傳送之觸發訊號的實體 Property：

• 您可以設定輸入線路以接收單端或差動訊號。
• 您可以設定輸入線路以在上拉或下拉模式下運作。
• 您可以指定是否應反相輸出訊號。

gpioTool 包含在 pylon Software Suite 中。

若要啟動工具：

1. 開啟命令提示字元視窗 (Windows) 或終端機視窗 (Linux)。

2. 切換至 pylon 安裝目錄下的 bin 目錄：

   • Windows (64 bit)：%programfiles%\Basler\pylon x\Runtime\x64\pylonCXP\bin
   • Windows (32 bit)：%programfiles%\Basler\pylon x\Runtime\Win32\pylonCXP\bin
   • Linux：/opt/pylon/lib/pylonCXP/bin

3. 使用以下描述的選項啟動 gpioTool。

選項#

以下選項可用：

gpioTool -b [board_index]
         -g
         -v
         -s [bank]:[settings]
         -h

-b [board_index]
指定要定址系統中的哪個 CXP-12 Interface Card。除了以下選項外，此參數為必填： -h.
的值範圍 [board_index] 是安裝在您系統中的所有 CXP-12 Interface Card 板卡的索引編號。如果您的系統中只有一張 CXP-12 Interface Card，請將 [board_index] 設為 0。

-b [board_index] -g
顯示指定的 CXP-12 Interface Card 的目前 GPIO bank 設定。

-b [board_index] -v
顯示詳細輸出的目前 GPIO bank 設定。

-b [board_index] -s [bank]:[settings]
設定指定的 CXP-12 Interface Card 上的 GPIO bank。
[bank] 指定 GPIO bank 的索引編號。在 CXP Interface Card 1C 上，剛好有一個 GPIO bank（前置 GPIO）可用。因此，請務必設定 [bank] 設為 0。
[settings] 進行設定。請參閱下方的 .

-h
顯示說明。

Settings#

對於 [settings] 部分中的 -b [board_index] -s [bank]:[settings]，提供以下設定：

您必須以以下格式輸入設定： [signal],[pull-up-down],[inversion]。範例： ds,pu,ni

或者，您可以設定 [settings] 設定為 default。這會 重設組態 某個 GPIO 組 (bank)。

範例#

gpioTool -b 0 -s 0:ds,pu,ni

此命令會按如下方式設定介面卡：

• -b 0：設定板卡 0 上的 GPIO。
• -s：開始實際的組態設定。
• 0:：設定 GPIO 組 0（前置 GPIO）。
• ds,pu,ni：將前置 GPIO 設定為接收差動訊號 (ds)、以上拉 (pu) 模式運作，以及發送未取反的輸出訊號 (ni)。

重設組態#

若要將板卡和 GPIO 組重設為預設設定，請啟動 gpioTool 並使用 [settings] 設為時，參數未正確呈現為灰色 default:

gpioTool -b [board_index] -s [bank]:default

範例： gpioTool -b 0 -s 0:default

範例程式碼#

// Select the Acq_SingleCXP12Area applet
camera.GetTLParams().InterfaceApplet.SetValue(Acq_SingleCXP12Area);
// Configure the interface card for external triggering
camera.GetTLParams().AreaTriggerMode.SetValue(AreaTriggerMode_External);
camera.GetTLParams().TriggerInSource.SetValue(TriggerInSource_FrontGpiTriggerSource0);
camera.GetTLParams().TriggerCameraOutSelect.SetValue(TriggerCameraOutSelect_BypassFrontGpi0);
camera.GetTLParams().TriggerState.SetValue(TriggerState_Active);
// Configure the interface card for internal triggering
camera.GetTLParams().AreaTriggerMode.SetValue(AreaTriggerMode_Generator);
camera.GetTLParams().TriggerOutputFrequency.SetValue(8);
camera.GetTLParams().TriggerCameraOutSelect.SetValue(TriggerCameraOutSelect_PulseGenerator0);
camera.GetTLParams().TriggerState.SetValue(TriggerState_Active);
// Use the external or internal trigger signals for image acquisition
camera.TriggerSelector.SetValue(TriggerSelector_FrameStart);
camera.TriggerMode.SetValue(TriggerMode_On);
camera.ExposureMode.SetValue(ExposureMode_Timed);
camera.TriggerSource.SetValue(TriggerSource_CxpTrigger0);
// Perform debayering on the interface card (Bayer RG 12 --> RGB 36 bit)
camera.PixelFormat.SetValue(PixelFormat_BayerRG12);
camera.GetTLParams().AutomaticFormatControl.SetValue(false);
camera.GetTLParams().Format.SetValue(Format_Color36bit);
// Configure the interface card to output 16-bit mono image data based on
// 12-bit mono image data from the camera
camera.PixelFormat.SetValue(PixelFormat_Mono12);
camera.GetTLParams().AutomaticFormatControl.SetValue(false);
camera.GetTLParams().Format.SetValue(Format_Gray16bit);

此範例程式碼僅提供 C++ 語言版本。

您也可以使用 pylon Viewer 來輕鬆設定參數。