跳转到内容

命令行工具 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 或更低版本构建的自定义 applet

mE5 marathon ACL 或 mE5 marathon VCL。

概述#

下表显示了何时必须启用 PoCL 以及在不同情况下可用的工具：

采集卡型号 Applet Set 版本（标准 Applets） VisualApplets 版本（自定义 Applets） Framegrabber SDK 版本 进行 PoCL 操作需要启用 PoCL 用于启用 PoCL 的工具
mE5 marathon VCLx 任意 1.0 或更高版本的 applet set 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 支持一节。

前提条件：

  • 您使用的是 marathon Camera Link 采集卡（mE5 marathon ACL、mE5 marathon VCL 或 mE5 marathon VCLx）。
  • 您的相机支持 Power Over Camera Link (PoCL)。
  • 您希望使用
    • 来自 applet 集版本 2.0（或更高版本）1 的 acquisition applets，适用于 marathon ACL/VCL
    • 来自 applet set 1.0（或更高版本）且运行于 marathon VCLx 上的 Acquisition Applets，或者使用 VisualApplets 3.0.6（或更高版本）构建的自定义 applet。在通过 VisualApplets 3.0.5 或更低版本构建的 applet 中，系统会自动启用 PoCL 支持。
  • 您已经在计算机（Windows 或 Linux）上安装并配置好了 Basler Framegrabber SDK（版本 5.4 或更高版本）。

如果要在系统中启用 PoCL 并将以下组件组合使用，则必须启用 PoCL：

采集卡型号 Applet 基于 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：

  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 命令行工具输出的消息中。

如果配置失败（例如因为板卡上已激活崩溃保护），您将收到以下消息：

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 支持。对于 1.7 或更低版本的 Acquisition Applets 集以及使用 VisualApplets 3.0.5 或更低版本构建的所有自定义小应用程序，情况正是如此。在使用这些小应用程序时，您完全无需设置 PoCL 支持。但是，一旦您烧录 2.0 或更高版本的标准小应用程序，或者使用 VisualApplets 3.0.6 或更高版本构建的小应用程序，板卡上的 PoCL 设置就会变得相关。

消息输出为 OK，因为 PoCL 支持已成功启用/禁用。
Warning: Board features not supported by firmware; Ignored: Feature already enabled 烧录到板卡上的小应用程序（包括固件）默认已激活 PoCL 支持。对于 1.7 或更低版本的 Acquisition Applets 集以及使用 VisualApplets 3.0.5 或更低版本构建的所有自定义小应用程序，情况正是如此。在使用这些小应用程序时，您完全无需设置 PoCL 支持。但是，一旦您烧录 2.0 或更高版本的标准小应用程序，或者使用 VisualApplets 3.0.6 或更高版本构建的小应用程序，板卡上的 PoCL 设置就会变得相关。

采集卡已经按您的需求进行了配置。因此，您尝试用完全相同的值覆盖该设置的操作将被忽略。