命令列工具 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：

來自 applet set 版本 1.x 的 acquisition applets，或
使用 VisualApplets 3.0.4 或更低版本建置的自訂 applets)

mE5 marathon ACL 或 mE5 marathon VCL。

概覽#

下表顯示何時必須啟用 PoCL 以及在相應情況下可使用哪些工具：

擷取卡型號	Applet Set 版本（標準 Applet）	VisualApplets 版本（自訂 Applet）	Framegrabber SDK 版本	PoCL 操作需要啟用 PoCL	用於啟用 PoCL 的工具
mE5 marathon VCLx	任意 applet set 1.0 或更高版本	3.1（或更高版本）	5.6 或更高版本	是，此機板一律適用	命令列工具 mE5 Board Settings, microDiagnostics
mE5 marathon ACLmE5 marathon VCL	2.0（或更高版本）	3.0.6（或更高版本）	5.5.1 或更高版本	yes	命令列工具 mE5 Board Settings, microDiagnostics
mE5 marathon ACLmE5 marathon VCL	2.0（或更高版本）	3.0.6（或更高版本）	5.5 或更低版本	yes	命令列工具 mE5 Board Settings
mE5 marathon ACLmE5 marathon VCL	1.x	3.0.5（或更低版本）	any	否

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

先決條件：

您使用的是 marathon Camera Link 取像卡（mE5 marathon ACL、mE5 marathon VCL 或 mE5 marathon VCLx）。
您的相機支援 Power Over Camera Link (PoCL)。
您想要使用
- 來自 applet set 2.0（或更高）版本 1 的 acquisition applets，適用於 marathon ACL/VCL
- 來自 applet set 1.0（或更高）版本的主機板 acquisition applets，適用於 marathon VCLx，或是使用 VisualApplets 3.0.6（或更高）建置的自訂 applets。在使用 VisualApplets 3.0.5 或更低版本建置的 applets 中，PoCL 支援會自動啟用。
您已在電腦（Windows 或 Linux）上安裝並執行 Basler Framegrabber SDK（5.4 或更高版本）。

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

擷取卡型號	Applets	使用 VisualApplets 構建
mE5 marathon ACL	Standard Applets 2.0（或更高版本）自訂 Applet	3.0.6（或更高版本）
mE5 marathon VCL	Standard Applets 2.0（或更高版本）自訂 Applet	3.0.6（或更高版本）
mE5 marathon VCLx	Standard Applets 1.0（或更高版本）自訂 Applet	3.1（或更高版本）

啟用與停用 PoCL#

若要透過命令列介面在擷取卡上啟用或停用 PoCL：

關閉所有使用擷取卡的應用程式。
開啟命令列直譯器（在 Windows 下為 cmd.exe，在多數 Linux 發行版下為 Terminal）。
在命令列直譯器中，前往 Basler Framegrabber SDK 安裝目錄中的 bin 資料夾。
輸入 mE5BoardSettings，後面接著根據您要執行的工作而定的參數：
- 取得系統中所有主機板設定的相關資訊：
  
  輸入 mE5BoardSettings 不帶任何參數。
  
  系統中所有主機板的設定隨即顯示。範例：在下圖中，您可以看到系統中安裝了一個主機板索引為 0 的主機板（mE5 marathon VCL）。在此主機板上，PoCL 已停用。
- 啟用與停用系統中所有主機板的 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 Ports，此時您必須始終重新啟動主機電腦以啟用此功能。

這不會反映在 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 支援已成功啟用／停用。不過，重新設定失敗（例如因為主機板上已啟動當機保護，請參閱 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 設定就會變得相關。擷取卡已按照您的需求進行設定。因此，您嘗試以完全相同的數值覆寫設定的操作將會被忽略。