管理 Applets (microDiagnostics)

配置图像采集卡

如何配置采集卡取决于您的采集卡型号。请参见以下章节。

什么时候可以使用 Applet？

• 在 imaWorx 和 imaFlex 采集卡，只要 Applet 存在于计算机的文件系统中（Framegrabber SDK 安装目录、DLL 或 Hardware Applets 子目录），它就可用。如果 Applet 不在其中，请运行包含所需 Applet 的 Applet 安装程序；或者，如果您需要使用通过 VisualApplets 创建的 Applet，请将 Applet 文件 (*.hap) 复制到 Framegrabber SDK 安装目录的 Hardware Applets 文件夹中（例如： ...\Basler\FramegrabberSDK5.x.x\Hardware Applets\*.hap）。
• 在 marathon 图像采集卡上，Applet 一经烧录到采集卡上即可使用。如果要使用的 Applet 尚未烧录到图像采集卡上，请按照 将 Applets 烧录到 marathon 图像采集卡上 中的说明进行烧录。

有哪些可用的 Applets？

要查看哪些小程序（applets）已烧录到采集卡上：

1. 启动 microDiagnostics（例如 <Framegrabber SDK installation directory>/bin/microDiagnostics.exe）。
2. 在 microDiagnostics 中，选择要安装小程序的目标采集卡设备。

3. 点击工具栏中的 Manage Firmware/Applet(s)。

   

4. 在程序窗口的下半部分，列出了当前烧录在采集卡上的小程序：

   

信息

如果您要用于配置 FPGA 的 Applet 在分区 1–7 上不可用，则必须将此 Applet 烧录到图像采集卡上。请参阅 将 Applets 烧录到 marathon 图像采集卡上。

小程序的标记方式如下：

图标	含义
	这是当前活动的 Applet，即图像采集卡当前配置的 Applet。
	图像采集卡将在系统启动时配置此 Applet（启动分区）。
	此 Applet 在文件系统中可用（版本相同）。文件系统中没有更新的版本。
	此 Applet 在文件系统中不可用（或者版本与烧录到图像采集卡上的版本不同）。
	这是 SAVE Configuration，一个备用选项。如果在活动配置出现问题（例如在刷写过程中），采集卡将使用此配置。SAVE Configuration 始终存储在分区 0 上。

更改活动 Applet

如果要使用活动小程序以外的小程序来配置采集卡上的 FPGA，请按以下步骤操作：

1. 右键点击列出您要用于 FPGA 配置的小程序的行。
2. 从上下文菜单中，选择 Activate Now。

信息

如果您在 FPGA 配置期间遇到问题，请参考 Crash Protection。

如果您的计算机支持 FPGA 的实时重新配置（请参见下方的芯片组列表），您将收到以下消息之一（A 或 B）：

消息 A：“请重启所有正在使用该板卡的应用程序”

关闭 Framegrabber SDK 的所有应用程序（microDisplay/microDisplay X、microDiagnostics、GenICam Explorer）。

重新打开 Framegrabber SDK 程序后，程序将允许您访问您定义为活动的小程序。您可以继续通过 microDisplay X 或 Framegrabber API 配置小程序。

信息

支持服务器级芯片组的高端主板支持此行为。已知以下芯片组在某些主板上支持无需重启的 FPGA 动态配置：

• Intel X58 Express
• Intel X79 Express
• Intel Z87 (Z99)

我们不保证上述芯片组在行为 A 下的性能。

消息 B：“您应重新启动计算机以完成更改”

选择新的小程序作为活动小程序后，PCI 速度将降低。要在使用此小程序时获得完整的 PCI 带宽，您必须重新启动计算机。

重启后，您将在 PCI 接口上获得完整带宽。Framegrabber SDK 程序将提供对该小程序的访问权限。您可以继续通过 microDisplay X 或 API 配置此小程序。

信息

支持服务器级芯片组的高端主板支持此行为。已知以下芯片组在某些主板上支持无需重启的 FPGA 动态配置：

• Intel X58 Express
• Intel X79 Express
• Intel Z87 (Z99)

我们不保证上述芯片组在情况 B 下的行为。

信息

如果在管理相机连接时使用通用服务 (gs)，则在采集卡上激活分区（即使用新小程序重新配置 FPGA）将导致以下系统行为：

将为主机中所有使用通用服务 (gs) 的采集卡重新启动该服务。根据主机中安装的板卡数量，这可能需要一些时间。连接到主机的采集卡上的所有相机连接都将重置。相机需要重新被发现。

在通用服务 (gs) 重启期间，所有 GUI 应用程序（microDisplay/microDisplay X、microDiagnostics、GenICam Explorer）将显示为“未响应”。

设置启动分区

在 microEnable 5 marathon 采集卡上，启动分区包含用于系统启动时采集卡配置的小程序。要选择将哪个分区用作启动分区，请按以下步骤操作：

1. 打开 microDiagnostics。
2. 单击 Manage Firmware/Applet(s) 按钮，或者从 Tools 菜单中选择菜单项 Manage Applets。
3. 右键点击列出您要用于 FPGA 配置的小程序的行。
4. 从上下文菜单中，选择 Set as Boot Partition。

将 Applets 加载到 imaWorx CXP-12 Quad 上

在 imaWorx CXP-12 Quad 上，所有随附的 applet 都已经位于 imaWorx CXP-12 Quad 采集卡上，但仅激活了一个。如果您想在 imaWorx CXP-12 Quad 上激活不同的 applet，请按照 Activate the Applet 中的说明进行操作。

将 Applets 烧录到 marathon 图像采集卡上

信息

如果您获得的是单个小程序（并非安装程序形式），而是来自外部来源的单个 HAP 文件：请确保您收到的程序是以 ZIP 压缩包形式提供的。

applet 文件 (HAP) 必须安全地受到 ZIP 压缩包的保护，才能从 VisualApplet 开发者机器传输。否则，它在传输过程中可能会损坏。如果您使用损坏的 HAP 文件刷写采集卡，采集卡会使用 SAVE Configuration 配置其 FPGA。板载 SAVE LED 发出红光即表示正在使用 SAVE Configuration。在这种情况下，请确保获取您打算使用的未损坏版本的 HAP 文件，并重新刷写采集卡。

前提条件

在使用小程序文件（HAP 或 DLL）烧录采集卡之前，必须将此文件复制到计算机的文件系统中。

作为 Framegrabber SDK 一部分提供的 Acquisition Applets（DLL 文件）可能已与 Framegrabber SDK 一起安装。如果您想烧录单个 Applet（HAP 文件），请将其复制到 <Framegrabber SDK installation directory>/Hardware Applets.

烧录

要将小程序烧录到采集卡上：

1. 如果 microDisplay X 处于打开状态，请将其关闭，并确保系统中没有打开任何 microDisplay X 实例。
2. 启动 microDiagnostics（例如，直接从安装目录中启动） <Framegrabber SDK installation directory>/bin/microDiagnostics.exe)

3. 在 microDiagnostics 中，选择要安装小程序的采集卡设备：

   

4. 单击按钮 Manage Firmware/Applet(s)。

   在程序窗口的下半部分，列出了当前烧录在板卡上的固件：

   

   采集卡为 applet 提供多达 8 个分区（取决于您正在使用的采集卡型号）。每个分区包含一个 applet。分区 0 上存储有 SAVE Configuration。对于分区（1 到 7），您可以定义要在其中存储哪些 applet。

   

   您可以将刷写到分区 1 至 7 上的任何 applet 用于采集卡 (FPGA) 配置。在这些 applet 之间切换不需要重新刷写。（有关如何切换，请参见 Changing the Active Applet。）

   小程序的标记方式如下：

   图标	含义
   	这是当前活动的 Applet，即图像采集卡当前配置的 Applet。
   	图像采集卡将在系统启动时配置此 Applet（启动分区）。
   	此 Applet 在文件系统中可用（版本相同）。文件系统中没有更新的版本。
   	此 Applet 在文件系统中不可用（或者版本与烧录到图像采集卡上的版本不同）。
   	这是 SAVE Configuration，一个备用选项。如果在活动配置出现问题（例如在刷写过程中），采集卡将使用此配置。SAVE Configuration 始终存储在分区 0 上。

   要使用 Applet 烧录分区，或使用另一个 Applet 重新烧录分区：

5. 单击 Load new applet 按钮。

   

   程序将引导您进入文件选择对话框。

6. 选择所需的 applet（DLL 或 HAP 文件）并单击 Open。
   所选文件现在显示在分区中。所选文件会以黄色高亮显示。

   

7. 继续并为要烧录的所有分区选择 Applet。

8. 对系统中要烧录的所有采集卡重复步骤 3 到 7。
9. 单击 Flash Now 按钮。
   将打开 Flash Dialog 对话框。
10. 检查声明的所选板卡和固件版本是否为您要烧录的版本。
11. 单击 Flash。
    刷写过程开始。一个接一个地安装 applet（每个板卡一个）。
12. 等待所有 Applet 完全安装。您将收到一条相应的消息。

信息

如果使用 Generic Service (gs) 来管理相机连接，则在采集卡上烧录处于活动状态的分区将导致以下系统行为：

• 将为主机中所有使用该服务的采集卡重新启动通用服务 (gs)。根据主机中安装的板卡数量，这可能需要一些时间。
• 连接到主计算机的所有采集卡上的相机连接将被重置。需要重新发现相机。
• 在通用服务 (gs) 重新启动期间，所有 GUI 应用程序（microDisplay X、microDiagnostics、GenICam Explorer）将显示为“无响应”。

在烧录非活动分区之后

如果您仅刷写了不包含当前活动 applet 的分区，您将收到以下消息：Flashing Done。

在这种情况下，您已完成刷写，可以继续进行其他活动，例如 configuring the FPGA 采集卡上的。

在烧录活动分区之后

如果您烧录的分区包含活动 applet，并且您的计算机支持 FPGA 的实时重新配置（参见下方的芯片组列表），您将在烧录后收到以下消息之一（A、B 或 C）：

消息 A：“Please restart all applications using the board.”

applet 已成功烧录。

关闭 Basler Framegrabber SDK 的所有应用程序（microDisplay/microDisplay X、microDiagnostics、GenICam Explorer）。

重新打开 Framegrabber SDK 程序后，这些程序将提供对烧录到 FPGA 活动分区上的 applet 的访问权限。您可以继续通过 microDisplay X 或 Framegrabber API 配置该 applet。

信息

支持服务器级芯片组的高端主板支持此行为。已知以下芯片组在某些主板上支持无需重启的 FPGA 动态配置：

• Intel X58 Express
• Intel X79 Express
• Intel Z87 (Z99)

我们不保证上述芯片组在行为 A 下的性能。

消息 B：“You should reboot your computer for the changes to be completed.”

Applet 已成功烧录，但由于 FPGA 活动分区上有新的 Applet，烧录后 PCI 速度会降低。要在使用此 Applet 时获得完整的 PCI 带宽，您必须重新启动计算机：

重新启动计算机以获取完整的 PCI 带宽。

重新启动后，您将在 PCI 接口上获得完整带宽。Framegrabber SDK 程序将提供对您烧录到 FPGA 活动分区上的 Applet 的访问权限。您可以继续通过 microDisplay X 或 Framegrabber API 配置此 Applet。

信息

支持服务器级芯片组的高端主板支持此行为。已知以下芯片组在某些主板上支持无需重启的 FPGA 动态配置：

• Intel X58 Express
• Intel X79 Express
• Intel Z87 (Z99)

我们不保证上述芯片组在情况 B 下的行为。

消息 C：“您必须重新启动计算机才能使更改生效。”

applet 已成功烧录，包括烧录到采集卡活动分区上的那个。要配置活动分区上的 applet，您必须重新启动计算机。

重新启动后，Framegrabber SDK 程序将提供对活动分区上的 Applet 的访问权限。您可以继续通过 microDisplay X 或 Framegrabber API 配置此 Applet。

信息

已知以下芯片组在 FPGA 配置后需要重新启动：

• Intel C220
• Intel H87