CXP-12インターフェースカードの設定#

このトピックでは、pylon API、pylon Viewer、またはgpioToolを使用してBasler CXP-12インターフェースカードを設定する方法について説明します。

インターフェースカードの設定は、次の状況で特に役立ちます。

• インターフェースカードで使用するアプレットを変更する場合。
• インターフェースカードを介して接続されたBasler boost CXP-12カメラをトリガーする場合。
• 画像処理システムのパフォーマンスを向上させるために、インターフェースカードでデバイエルを実行する場合。
• 16ビットモノラル形式など、カメラでは使用できない出力形式を使用する場合。
• インターフェースカードによって送受信されるトリガー信号を設定する場合。

利用可能なエリアスキャン用アプレットおよびデフォルトアプレット#

インターフェースカードのモデルに応じて、次のアプレットが使用可能で、デフォルトとして設定されています。

Acquisition Appletsに加えて、Enhanced Appletsを使用することもできます。Enhanced Appletsはプロトタイプであり、お近くのBaslerの営業担当者またはフィールドアプリケーションエンジニアを通じてリクエストした場合のみご利用いただけます。すべてのEnhanced Appletsには、以下の追加機能があります。

• 最大4x4のBinning（現在はモノクロのみ）
• モノクロカメラ用のBlock-based flat field correction (FFC)
• PGI 高品質デベザリングおよび画質改善

利用可能なラインスキャン用アプレット#

インターフェースカードのモデルに応じて、以下のアプレットが利用可能です。なお、デフォルトアプレット（つまり、デフォルトでロードされるアプレット）は常にエリアスキャン用アプレットです。そのため、ラインスキャン用アプレットを使用する場合は、Changing the Appletで説明されているように、最初にそれをロードする必要があります。

Documentation#

以下のセクションでは、acquisition applets のドキュメントへのリンクを提供しています。

CXP-12インターフェースカード1C#

CXP-12インターフェースカード2C#

CXP-12インターフェースカード4C#

適切なアプレットの選択#

シングルチャンネル（1-CXP）カメラのみを使用している場合、デフォルトのアプレットは常に機能し、変更する必要はありません。

ただし、マルチチャンネル（2-CXPや4-CXPなど）のカメラを使用している場合は、カメラ設定に適したアプレットを選択する必要があります。そうしないと、カメラが動作しなかったり、カメラのパフォーマンスが大幅に低下したりする可能性があります。

どちらのアプレットが適切かは、カメラ数、カメラあたりのチャンネル数、目的のROIステップサイズによって異なります。

ROIステップサイズは画像前処理の並列性によって異なるため、カメラやフレームグラバーによって異なります。

CXP-12インターフェースカード1C#

CXP-12 Interface Card 1C用のエリアスキャン用アプレット#

CXP-12 Interface Card 1C用のラインスキャン用アプレット#

CXP-12インターフェースカード2C#

CXP-12 Interface Card 2C用のエリアスキャン用アプレット#

CXP-12 Interface Card 2C用のラインスキャン用アプレット#

CXP-12インターフェースカード4C#

CXP-12 Interface Card 4C用のエリアスキャン用アプレット#

CXP-12 Interface Card 4C用のラインスキャン用アプレット#

アプレットの変更#

インターフェースカード上で実行されるアプレットによって、その機能が定義されます。一部のカメラ設定では、デフォルトのアプレットを変更する必要があります。

pylonでインターフェイスカードで使用されるアプレットを変更するには、次を設定します InterfaceApplet パラメータをロードするアプレットの名前に設定します（例： 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に設定すると、インターフェースカードは1秒あたり8つのトリガー信号を生成します。
3. パラメーターを TriggerCameraOutSelect パラメータを目的の出力ラインに設定します（例： PulseGenerator0.
4. パラメーターを TriggerState パラメータを Active.

これで、画像取得を開始する際には必ず、インターフェースカードが指定された周波数でトリガー信号を生成します。

すべてのトリガー信号がカメラのソース信号に転送されます CxpTrigger0 および CxpTrigger1。これらの信号はさまざまな目的に使用できます。最も一般的なユースケースは画像取得です。次を参照してください： 以下の例.

例：画像取得のトリガー信号の使用#

インターフェースカードによって生成された外部または内部トリガー信号を使用して画像を取得するには：

1. カメラ側で、次のように設定します。 TriggerSelector パラメータを FrameStart.
2. パラメーターを TriggerMode パラメータを On.
3. パラメーターを ExposureMode パラメータを Timed.
4. パラメーターを TriggerSource パラメータを CxpTrigger0 または CxpTrigger1.

これで、インターフェースカードがトリガー信号を受信または生成するたびに、カメラは画像を取得します。

インターフェースカードでのデベイヤリングの実行#

CXP-12インターフェースカード1Cでは、インターフェースカードでディベートを行うことができます。これにより、カメラとホストコンピューターのコンピューティング負荷が軽減されます。

これを行うには：

1. pylon Viewerを起動し、インターフェースカードおよびカメラとの接続を開きます。
2. フィーチャツリーを使用して、以下の設定を行います。
   • カメラ側で、Pixel FormatオプションをBayerピクセルフォーマット（例: Bayer RG 12）に設定します。
   • Device Transport Layerに移動し、Automatic Format Controlオプションを無効にします。
     これにより、カメラで使用されるピクセルフォーマットとは独立して出力フォーマットを設定できます。
   • インターフェースカード側で、OutputFormatオプションを対応するRGBピクセルフォーマットに設定します。
     ビット深度は、Bayerピクセルフォーマットのビット深度の3倍である必要があります。例えば、Bayer RG 12（カメラ） = Color 36 bit（インターフェースカード）となります。

これで、インターフェースカードは、カメラの生画像データでデベイヤリングを実行し、RGB画像データを出力します。

カメラでは使用できない出力形式の使用#

Basler boostカメラは、いくつかのピクセルフォーマットで画像データを出力できます（Bayer RG 8やRBG 8など）。詳細については、ピクセルフォーマットのトピックを参照してください。

必要なピクセルフォーマットがカメラで使用できず、ホストコンピューターでの画像変換も避けたい場合は、インターフェースカードが提供するピクセルフォーマットのいずれかを使用できる場合があります。

インターフェースカードには、次の形式があります。

カメラで使用できない出力形式を使用するには：

1. カメラ側で、次のように設定します。 PixelFormat パラメータを希望のカメラのPixel Formatに設定します（例： Mono12.
2. インターフェースカードで、 AutomaticFormatControl パラメータを false.
   これにより、カメラで使用されるピクセルフォーマットとは独立して出力フォーマットを設定できます。
3. インターフェースカードで、 Format パラメータを希望の出力フォーマットに設定します（例： Gray16bit.

上記の例の値を使用すると、インターフェースカードは12ビットカメラの画像データに基づいて16ビットの画像データを出力します。パディングビット（ゼロ）は、下図のように挿入されます。

gpioToolを使用したトリガー信号の設定#

gpioToolコマンドラインツールを使用すると、インターフェースカードで受信または送信されるトリガー信号の物理的特性を次のように設定できます。

• シングルエンドまたは差動信号を受信するように入力ラインを設定できます。
• プルアップまたはプルダウンモードで動作するように入力ラインを設定できます。
• 出力信号を反転するかどうかを指定できます。

gpioToolはpylon Software Suiteに含まれています。

ツールを起動するには：

1. コマンドプロンプトウィンドウ（Windows）またはターミナルウィンドウ（Linux）を開きます。

2. pylonインストールのbinディレクトリーに移動します。

   • Windows（64ビット）：%programfiles%\Basler\pylon x\Runtime\x64\pylonCXP\bin
   • Windows（32ビット）：%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が1枚のみの場合は、 [board_index] を0に設定します。

-b [board_index] -g
指定したCXP-12 Interface Cardの現在のGPIOバンク設定を表示します。

-b [board_index] -v
詳細情報を含めて、現在のGPIOバンク設定を表示します。

-b [board_index] -s [bank]:[settings]
指定したCXP-12 Interface CardのGPIOバンクを設定します。
[bank] はGPIOバンクのインデックス番号を指定します。CXP Interface Card 1Cでは、正確に1つのGPIOバンク（フロントGPIO）が利用可能です。したがって、常に [bank] を0に設定します。
[settings] は設定を構成します。次を参照してください: 以下.

-h
ヘルプを表示します。

設定#

内の [settings] の部分については、 -b [board_index] -s [bank]:[settings]において次の設定を利用できます：

設定は次の形式で入力する必要があります： [signal],[pull-up-down],[inversion]。例： ds,pu,ni

または、 [settings] を default。これにより GPIO バンクの設定を リセットします。

例#

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を使用して、パラメーターを簡単に設定することもできます。