コンテンツにスキップ

コマンドラインツール mE5 Board Settings#

mE5 Board Settingsコマンドラインツールを使用すると、PoCLのオン/オフオプションを備えたフレームグラバーで、コマンドラインからPower over Camera Link（PoCL）を有効/無効にすることができます。

対象となるフレームグラバーは次のとおりです：

  • mE5 marathon ACL
  • mE5 marathon VCL
  • mE5 marathon VCLx

mE5 Board Settingsツールは、Basler Framegrabber SDKと一緒にインストールされます。このツールは、Framegrabber SDKのインストールディレクトリのサブディレクトリであるbin（%BASLER_FG_SDK_DIR%\bin）にあります。

PoCLサポートを有効にする必要があるのはなぜですか？#

Power over Camera Link（PoCL）サポートは、上記のフレームグラバーではデフォルトで無効になっています。これらのフレームグラバーのいずれかでPoCLを使用するには、フレームグラバーでPoCLサポートを明示的に有効にする必要があります。

情報

例外：

次を使用する場合、PoCLを有効にする必要はありません：

  • アプレットセットバージョン1.xのアプレット、または
  • VisualApplets 3.0.4以前で構築されたカスタムアプレット）

mE5 marathon ACL、またはmE5 marathon VCL。

概要#

以下の表は、PoCLを有効にする必要がある場合と、それぞれの状況で使用できるツールを示しています：

フレームグラバーモデル アプレットセットバージョン（標準アプレット） VisualAppletsバージョン（カスタムアプレット） Framegrabber SDKバージョン PoCL操作に必要なPoCLの有効化 PoCL有効化ツール
mE5 marathon VCLx アプレットセット1.0以降 3.1以降 5.6以降 はい、このボードでは常に必要です コマンドラインツール mE5 Board Settings、microDiagnostics
mE5 marathon ACLmE5 marathon VCL 2.0以降 3.0.6以降 5.5.1以降 はい コマンドラインツール mE5 Board Settings、microDiagnostics
mE5 marathon ACLmE5 marathon VCL 2.0以降 3.0.6以降 5.5以下 はい コマンドラインツール mE5 Board Settings
mE5 marathon ACLmE5 marathon VCL 1.x 3.0.5（またはそれ以前） any いいえ

Framegrabber SDK バージョン 5.5.1 以降を使用している場合は、Framegrabber SDK に付属する GUI ツール microDiagnostics を使用して、ボード上の PoCL サポートを有効にすることもできます。その方法については、microDiagnostics ユーザーマニュアルの「PoCL Support」セクションを参照してください。

前提条件：

  • marathon Camera Linkフレームグラバー（mE5 marathon ACL、mE5 marathon VCL、またはmE5 marathon VCLx）を使用します。
  • お使いのカメラは Power Over Camera Link (PoCL) をサポートしています。
  • 使用する要件：
    • applet set バージョン 2.0 (以降) の acquisition applets を marathon ACL/VCL で使用する場合
    • marathon VCLx 上の applet set バージョン 1.0 (以降) の acquisition applets、または VisualApplets 3.0.6 (以降) で作成されたカスタムアプレット。VisualApplets 3.0.5 以前で作成されたアプレットでは、PoCL サポートは自動的に有効になります。
  • Basler Framegrabber SDK (バージョン 5.4 以降) がコンピュータ (Windows または Linux) にインストールされ、正常に動作していること。

システムで PoCL を使用し、以下のコンポーネントを組み合わせて使用する場合は、PoCL を有効にする必要があります：

フレームグラバーモデル アプレット VisualApplets を使用して構築
mE5 marathon ACL Standard Applets 2.0（またはそれ以降）

Custom Applet

3.0.6以降
mE5 marathon VCL Standard Applets 2.0（またはそれ以降）

Custom Applet

3.0.6以降
mE5 marathon VCLx Standard Applets 1.0（またはそれ以降）

Custom Applet

3.1以降

PoCLの有効化と無効化#

コマンドラインインターフェイスを使用してフレームグラバーで PoCL を有効または無効にするには：

  1. フレームグラバーを使用しているすべてのアプリケーションを終了します。
  2. コマンドラインインタープリターを開きます（Windows の場合は cmd.exe、Linux の場合はほとんどのディストリビューションで Terminal）。
  3. コマンドラインインタープリターで、Basler Framegrabber SDK インストールの bin フォルダーに移動します。

  4. 入力 mE5BoardSettingsを実行し、実行するタスクに応じてパラメータを追加します：

    • システム内のすべてのボードの設定に関する情報の取得：

      入力 mE5BoardSettings パラメータを指定せずに行います。

      システム内のすべてのボードの設定が表示されます。例：次の画像では、ボードインデックス 0 の 1 つのボード (mE5 marathon VCL) がシステムにインストールされていることがわかります。このボードでは、PoCL は無効になっています。

      コマンドライン mE5 Board Settings

    • システム内のすべてのボードの PoCL サポートの有効化および無効化：

      PoCL サポートを有効にするには、以下を入力します mE5BoardSettings -a -pocl enable -reconfigure.

      PoCL サポートを無効にするには、以下を入力します mE5BoardSettings -a -pocl disable -reconfigure.

      -a を示します システム内のすべてのボード.

    • システム内の 1 つのボードの PoCL サポートの有効化および無効化：

      入力 mE5BoardSettings -b <board index> -pocl enable -reconfigure.

    • システム内の 1 つのボードの PoCL サポートを無効にするには：

      PoCL サポートを有効にするには、以下を入力します mE5BoardSettings -b <board index> -pocl enable -reconfigure.

      PoCL サポートを無効にするには、以下を入力します mE5BoardSettings -b <board index> -pocl disable -reconfigure

      の代わりに、 <board index>PoCL サポートを有効にするボードの実際のボードインデックスを入力します。例：

      mE5BoardSettings -b 0 -pocl enable -reconfigure システム内のボード 0 を設定する場合。

PoCLサポートの有効化または無効化に成功すると、次のメッセージが表示されます：

Ok; Board reconfigured; Close all applications using the board.

ボードを使用しているすべてのアプリケーションを閉じてください。

情報

Basler ClSerCOM Wrapperを使用して仮想COMポートを使用している場合は、この時点で必ずホストコンピュータを再起動して機能を有効にする必要があります。

これは、mE5 Board Settings コマンドラインツールが出力するメッセージには反映されません。

たとえば、ボード上でクラッシュプロテクションが有効になっていることが原因で設定に失敗した場合、次のメッセージが表示されます。

Ok; Warning: Failed to reconfigure board; Powercycle required to activate board features.

この場合は、コンピュータの電源を入れ直してください（電源サイクル）。電源サイクルを実行すると、フレームグラバーのPoCLが有効または無効になります。

構文の概要#

呼び出し mE5 Board Settings コマンドラインツールを入力して呼び出します mE5BoardSettings.

次のパラメータを使用できます：

-all または -a

-board <board-index> または -b <board-index>

-pocl enable|disable

-reconfigure

次のコマンドを使用できます：

ツールの呼び出し ボードの指定 PoCL サポートの設定 再設定の開始
mE5BoardSettings -b <board-index> -pocl enable -reconfigure
mE5BoardSetting -b <board-index> -pocl disable -reconfigure
mE5BoardSetting -board <board-index> -pocl enable -reconfigure
mE5BoardSetting -board <board-index> -pocl disable -reconfigure
mE5BoardSetting -a <board-index> -pocl enable -reconfigure
mE5BoardSetting -a <board-index> -pocl disable -reconfigure
mE5BoardSetting -all <board-index> -pocl enable -reconfigure
mE5BoardSetting -all <board-index> -pocl disable -reconfigure

For <board-index>, enter the actual index number of the board you want to enable/disable PoCL support for. The index numbers of your frame grabber boards are displayed, for example, in microDiagnostics.

を使用する場合、 -a または -all の代わりに）オペレーター -b <board-index> または -board <board-index>)、システム内のすべてのフレームグラバーが一度に設定されます。

設定を有効にするには、フレームグラバー上のFPGAを再設定する必要があるため、パラメータ -reconfigure がコマンドラインの最後に追加されます。

パラメータを指定せずにツールを呼び出した場合、システム内のすべてのボードの現在の設定が表示されます。

出力メッセージ#

mE5 Board Settings コマンドラインツールには、次のメッセージが表示されます。

メッセージ 意味
Ok; Board reconfigured; Close all applications using the board PoCLサポートの有効化または無効化に成功し、ボード上のFPGAが再設定されました。アプリケーションに変更を反映させるには、ボードを使用しているすべてのアプリケーションを閉じてから再度開く必要があります。
Ok; Reconfiguration or powercycle required to activate feature PoCLサポートの有効化または無効化に成功しました。ただし、パラメータが追加されていません -reconfigure コマンドラインの最後に追加します。設定はFPGAの再設定後にのみ有効になるため、FPGAを再設定するか、ホストコンピュータの電源を入れ直してください。
Ok; Warning: Failed to reconfigure board; Powercycle required to activate board features PoCLサポートの有効化/無効化に成功しました。ただし、再設定に失敗しました（ボード上でクラッシュプロテクションが有効になっていることが原因である可能性があります。クラッシュプロテクションを参照してください）。ホストコンピュータの電源を入れ直す必要があります。
Ignored: Feature already enabled 設定をまったく同じ値で上書きしようとすると、このメッセージが表示されます。フレームグラバーはすでに希望どおりに設定されています。
Ignored: Board feature not supported by board type 選択したフレームグラバーボードはCamera Linkボードではないため、PoCLを使用できません。
Warning: Board features not supported by firmware; Ok ボードに書き込まれたアプレット（ファームウェアを含む）では、デフォルトでPoCLサポートが有効になっています。これは、Acquisition Appletsセットのバージョン1.7以下およびVisualAppletsバージョン3.0.5以下でビルドされたすべてのカスタムアプレットに当てはまります。これらのアプレットを使用する場合、PoCLサポートを設定する必要はありません。ただし、バージョン2.0以上の標準アプレット、またはVisualApplets 3.0.6以上でビルドされたアプレットを書き込むとすぐに、ボード上のPoCL設定が適用されるようになります。

メッセージは次のように出力されます。 OKPoCLサポートの有効化または無効化に成功したためです。
Warning: Board features not supported by firmware; Ignored: Feature already enabled ボードに書き込まれたアプレット（ファームウェアを含む）では、デフォルトでPoCLサポートが有効になっています。これは、Acquisition Appletsセットのバージョン1.7以下およびVisualAppletsバージョン3.0.5以下でビルドされたすべてのカスタムアプレットに当てはまります。これらのアプレットを使用する場合、PoCLサポートを設定する必要はありません。ただし、バージョン2.0以上の標準アプレット、またはVisualApplets 3.0.6以上でビルドされたアプレットを書き込むとすぐに、ボード上のPoCL設定が適用されるようになります。

フレームグラバーはすでに希望どおりに設定されているため、まったく同じ値で設定を上書きしようとする試みは無視されます。