故障排除（采集卡）#

本主题包含在使用 Basler 图像采集卡时遇到常见问题的解决方案。

imaWorx CXP-12 Quad#

相机发现问题#

如果您在使用 Framegrabber API 库 siso_genicam 或 microDisplay X 工具进行相机发现时遇到问题，可以通过重新设置特定的环境变量来微调发现行为：

变量名	默认值	定义
SISO_CXP_COMMAND_ACK_TIMEOUT	200 ms	Framegrabber SDK 在发送命令后等待相机响应的最大时间。默认值 200 ms 是 CXP 1.1 标准所要求的值。如果您经常收到报告确认 (ACK) 超时的日志消息，可以增大此值。
SISO_CXP_WAIT_AFTER_LINKRESET	300 ms	Framegrabber SDK 在单个通道上发送链路重置命令后等待的时间（以毫秒为单位）。在发现期间，Framegrabber SDK 会在所有通道上发送链路重置命令。链路重置会依次执行。Framegrabber SDK 在每次链路重置后会等待 SISO_CXP_WAIT_AFTER_LINKRESET ms，然后再执行下一次链路重置。 CXP 1.1 标准要求 200 ms，但未明确指出链路重置命令是应同时在所有通道上发送还是分别发送。Framegrabber SDK 允许通过三个环境变量来配置该行为：SISO_CXP_WAIT_AFTER_LINKRESET、SISO_CXP_WAIT_AFTER_LINKRESET_AT_DISCOVERY 和 SISO_CXP_WAIT_AFTER_LINKRESET_OF_ALL_PORTS。选择默认值是为了支持市场上的大多数相机。如果您遇到日志消息提示链路锁定成功，但在发现期间相机通信失败，您可以尝试增大 SISO_CXP_WAIT_AFTER_LINKRESET 和/或 SISO_CXP_WAIT_AFTER_LINKRESET_AT_DISCOVERY 的值，或者尝试将 SISO_CXP_WAIT_AFTER_LINKRESET 设置为 0，并将 SISO_CXP_WAIT_AFTER_LINKRESET_AT_DISCOVERY 设置为 200 或更高的大写值。
SISO_CXP_WAIT_AFTER_LINKRESET_AT_DISCOVERY	200 ms	所有通道都收到链路重置命令后，Framegrabber SDK 等待的额外时间。有关进一步说明，请参阅 SISO_CXP_WAIT_AFTER_LINKRESET。
SISO_CXP_WAIT_AFTER_LINKRESET_OF_ALL_PORTS	0 ms	在所有可锁定通道上建立通道链路锁定后，Framegrabber SDK 等待的额外时间。通常，用户无需更改默认值 0。如果两个变量（SISO_CXP_WAIT_AFTER_LINKRESET 和 SISO_CXP_WAIT_AFTER_LINKRESET_AT_DISCOVERY）都已设置为 0，则必须将 SISO_CXP_WAIT_AFTER_LINKRESET_OF_ALL_PORTS 的值设置为 200 或更高。）有关进一步说明，请参阅 SISO_CXP_WAIT_AFTER_LINKRESET。
SISO_CXP_WAIT_AFTER_CAMERACONFIG_DONE	750 ms	Framegrabber SDK 在发送链路配置命令后等待的时间。 CXP 1.1 标准要求 200 毫秒。但在 Framegrabber SDK 中，默认值为 750 毫秒，因为某些相机在更改链路配置后需要更多时间来恢复。如果在更改配置后遇到与相机的通信中断，可以增大此值。
SISO_CXP_RECEIVE_ACK_PACKET_ON_LINKCONFIG	熄灭	CXP 1.1 标准要求相机在应用更改后确认链路配置更改。但是，大多数相机在链路配置更改后不会发送确认。若要强制等待相机发送确认，请将此值设置为 ON。
SISO_CXP_SKIP_REGISTER_CHECK_ON_LINKCONFIG	熄灭	为确保在更改链路配置后相机通信正常工作，Framegrabber SDK 会在应用更改后尝试进行寄存器读取。若要取消此行为，请将此值设置为 ON。

microEnable 5 采集卡#

激活 Applet 导致蓝屏#

在 FPGA 实时重新配置（在激活 applet 时开始）期间，采集卡会短暂从 PCI 总线上消失。但是，并非所有主板都支持设备从 PCI 总线上消失。有关详细信息，请参阅 Crash Protection (microDiagnostics)。

如果您的计算机不支持 FPGA 动态重配置，您可以禁用 FPGA 动态配置。

信息

在某些主板中，以下芯片组支持无需重启的 FPGA 动态配置：

Intel X58 Express
Intel X79 Express
Intel Z87 (Z99)

Basler 不保证上述芯片组能够进行 FPGA 动态配置。

您可以随时禁用 FPGA 的动态重配置。禁用后，在烧录新固件后，您需要进行电源循环（冷启动）。

要禁用 FPGA 的实时重新配置：

将以下系统环境变量添加到您的系统： SISO_ENABLE_RECONFIGURATION
将其设置为 NO: SISO_ENABLE_RECONFIGURATION=NO

每次刷写后，系统现在会提示您对计算机进行电源循环（冷启动）：

microDisplay X：断电重启消息

要对计算机进行电源循环：

单击关机以完全关闭计算机（重新启动选项是不够的）。
计算机完全关闭后，等待几秒钟。
重新启动主计算机。

FPGA 故障保护配置#

FPGA 在断电时会丢失其配置。配置会在每次冷启动时重新加载，或者可选地在稍后重新加载。在采集卡上，FPGA 从 BPI Flash Memory 加载其配置。

BPI Flash Memory 被划分为 8 个分区。分区 1–7 之一包含用户想要使用的配置（启动配置和/或活动配置）。为了确保采集卡在特殊情况下也能可靠工作，分区 0 包含一个回退配置（SAVE Configuration 1）。如果在极少数情况下无法将预期的配置（启动配置或活动配置）用于 FPGA 配置，系统将自动加载 SAVE Configuration。

通过这种方式，您始终可以通过软件访问 FPGA，即您始终可以使用完全功能的配置（Applet）来配置采集卡。

何时会发生这种情况？#

无法加载预期配置的最常见原因是，在加载 BPI Flash Memory 时采集卡断电。断电会导致加载过程未完成。之后，FPGA 无法使用 BPI Flash Memory 中（不完整）的内容进行配置。FPGA 转而使用 SAVE Configuration。

配置开关#

在极少数情况下未自动加载 SAVE Configuration 的极端情况下，您可以随时通过直接位于板卡上的配置开关激活 SAVE Configuration。

采集卡上的配置开关：

配置开关

要使用配置开关：

按下配置开关。
重新加载采集卡的设备驱动程序，或重新启动主计算机（热启动）。

重新配置/重新烧录采集卡#

当 SAVE Configuration 成功激活时（自动或通过开关），对应的 SAVE LED 会变为红色。这表示采集卡可通过软件进行访问。现在，您可以使用要用于图像采集的 applet 的完整功能版本重新配置采集卡或为其重新烧录固件。要进行烧录，请使用软件工具 microDiagnostics（请参阅烧录）。

加载新 Applet（烧录）未完成#

如果您在将 Applet 刷写到 mE5 采集卡时遇到问题，即刷写过程没有结束：

保持采集卡通电。切勿关闭采集卡电源。
请联系 Basler 技术支持团队。

禁用 FPGA 动态重新配置#

在 FPGA 实时重新配置（在激活 applet 时开始）期间，采集卡会短暂从 PCI 总线上消失。但是，并非所有主板都支持设备从 PCI 总线上消失。（另请参阅Crash Protection。）

如果您的计算机不支持 FPGA 实时重新配置，您可能希望总体禁用 FPGA 实时配置。

注意

具有服务器级芯片组的高端主板支持 FPGA 实时配置。已知以下芯片组在某些主板上支持无需重启的 FPGA 实时配置：

Intel X58 Express
Intel X79 Express
Intel Z87 (Z99)

Basler 不保证上述芯片组支持 FPGA 实时配置。有关更多详细信息，请参阅烧录。

您可以随时禁用 FPGA 的实时重新配置。禁用后，在对采集卡进行烧录后，您需要对计算机进行断电重启（冷启动）。

要禁用 FPGA 的实时重新配置：

将以下系统环境变量添加到您的系统： SISO_ENABLE_RECONFIGURATION
将其设置为 NO: SISO_ENABLE_RECONFIGURATION=NO

每次刷写后，系统现在会提示您对计算机进行电源循环（冷启动）：

烧录断电重启后的消息

要对计算机进行电源循环：

单击关机以完全关闭计算机（重新启动选项是不够的）。
计算机完全关闭后，等待几秒钟。
重新启动主计算机。

烧录后采集卡不可用#

如果您使用 *.hap 文件烧录 microEnable 5 采集卡，且烧录后 Windows 设备管理器和 microDisplay X 无法识别该采集卡，则说明您烧录到采集卡上的 *.hap 文件有误（存在时序违规等问题）。

在这种情况下，SAVE Configuration 不会自动用于 FPGA 配置。

要激活 SAVE Configuration，请使用位于采集卡上的配置开关：

配置开关

要使用配置开关：

按下配置开关。
重新加载采集卡的设备驱动程序，或重新启动主计算机（热启动）。

当 SAVE Configuration 成功激活时（自动或通过开关），对应的 SAVE LED 会变为红色。这表示采集卡可通过软件访问。现在，您可以使用要用于图像采集的 applet 的完整功能版本重新配置采集卡或为其重新烧录固件。要进行烧录，请使用软件工具 microDiagnostics。

打开 microDiagnostics，并按照烧录中的描述将您要使用的 applet（完整功能版本）加载到采集卡上。