跳至內容

命令列工具 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 的 Acquisition Applets，或
  • 使用 VisualApplets 3.0.4 或更低版本建置的自訂 applet）

mE5 marathon ACL 或 mE5 marathon VCL。

總覽#

下表顯示您必須啟用 PoCL 的時機以及在各情況下可用的工具：

擷取卡型號 Applet 集版本（標準 Applets） VisualApplets 版本（自訂 Applets） Framegrabber SDK 版本 PoCL 運作所需的 PoCL 啟用 用於啟用 PoCL 的工具
mE5 marathon VCLx 任何 applet 集 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 no

如果您使用的是 Framegrabber SDK 5.5.1 或更高版本，您也可以透過作為 Framegrabber SDK 一部分的 GUI 工具 microDiagnostics 在主機板上啟用 PoCL 支援。如需如何操作的資訊，請參閱 microDiagnostics 使用者手冊的 PoCL 支援一節。

先決條件：

  • 您使用 marathon Camera Link 擷取卡（mE5 marathon ACL、mE5 marathon VCL 或 mE5 marathon VCLx）。
  • 您的相機支援 Power Over Camera Link (PoCL)。
  • 您想要使用
    • marathon ACL/VCL 上的應用程式集版本 2.0（或更高版本）1 的 acquisition applets
    • marathon VCLx 上的應用程式集版本 1.0（或更高版本）的 acquisition applets，或使用 VisualApplets 3.0.6（或更高版本）建置的自訂 applet。在使用 VisualApplets 3.0.5 或更低版本建置的 applet 中，PoCL 支援會自動啟用。
  • 您的電腦上已安裝並正常運作 Basler Framegrabber SDK（版本 5.4 或更高版本）（Windows 或 Linux）。

如果您想在系統中使用 PoCL 並將以下元件搭配使用，則必須啟用 PoCL：

擷取卡型號 Applet 使用 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 的機板（mE5 marathon VCL）。在該機板上，PoCL 已停用。

      mE5 Board Settings 命令列

    • 啟用與停用系統中所有機板的 PoCL 支援：

      若要啟用 PoCL 支援，請輸入 mE5BoardSettings -a -pocl enable -reconfigure.

      若要停用 PoCL 支援，請輸入 mE5BoardSettings -a -pocl disable -reconfigure.

      -a 代表 系統中的所有機板.

    • 啟用與停用系統中單一機板的 PoCL 支援：

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

    • 停用系統中單一機板的 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 命令列工具輸出的訊息中。

如果設定失敗（例如因為機板上已啟用 當機保護 (crash protection)），您將會收到以下訊息：

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

在這種情況下，請將電腦關機再重新開機 (power cycle)。重新開機後，擷取卡上的 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 命令列工具會顯示下列訊息：

Message 含意
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 支援已成功啟用／停用。但是，重新設定失敗（例如，因為應上已啟用當機防護功能，請參閱 Crash Protection）。您必須將主機電腦重新開機。
Ignored: Feature already enabled 若您嘗試以完全相同的數值覆寫設定，將會收到此訊息。擷取卡的設定已符合您的需求。
Ignored: Board feature not supported by board type 所選的擷取卡應用板不是 Camera Link 應用板，因此無法使用 PoCL。
Warning: Board features not supported by firmware; Ok 閃存至應用板的 applet（包含韌體）預設會啟用 PoCL 支援。版本 1.7 或更舊版本的 Acquisition Applets 集以及所有使用 VisualApplets 版本 3.0.5 或更舊版本建置的自訂 applet 皆是如此。使用這些 applet 時，您完全不需要設定 PoCL 支援。不過，一旦您閃存版本 2.0 或更新版本的標準 applet，或是使用 VisualApplets 3.0.6 或更新版本建置的 applet，您在應用板上的 PoCL 設定就會變得相關。

訊息輸出為 OK，因為 PoCL 支援已成功啟用／停用。
Warning: Board features not supported by firmware; Ignored: Feature already enabled 閃存至應用板的 applet（包含韌體）預設會啟用 PoCL 支援。版本 1.7 或更舊版本的 Acquisition Applets 集以及所有使用 VisualApplets 版本 3.0.5 或更舊版本建置的自訂 applet 皆是如此。使用這些 applet 時，您完全不需要設定 PoCL 支援。不過，一旦您閃存版本 2.0 或更新版本的標準 applet，或是使用 VisualApplets 3.0.6 或更新版本建置的 applet，您在應用板上的 PoCL 設定就會變得相關。

擷取卡的設定已符合您的需求。因此，您嘗試以完全相同的數值覆寫設定的操作將遭到忽略。