跳转到内容

故障排除 (采集卡)#

本主题包含使用 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 动态重新配置期间(当您激活小程序时开始),采集卡会从 PCI 总线上短暂消失。但是,并非所有主板都支持设备从 PCI 总线上消失。有关详细信息,请参阅 Crash Protection (microDiagnostics)。

如果您的计算机不支持 FPGA 的在线重新配置,您可以禁用 FPGA 在线配置。

信息

在某些主板上,以下芯片组支持无需重启的 FPGA 在线配置:

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

Basler 不保证上述芯片组一定支持 FPGA 在线配置。

您可以随时禁用 FPGA 的在线重新配置。禁用后,在写入新固件后,您需要进行电源循环(冷启动)。

要禁用 FPGA 的在线重新配置:

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

每次写入固件后,系统现在会提示您对计算机进行电源循环(冷启动):

microDisplay X:Message Power Cycle

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

  1. 单击关闭以完全关闭计算机(仅使用重启选项是不够的)。
  2. 计算机完全关闭后,等待几秒钟。
  3. 再次启动主计算机。

FPGA 后备配置#

FPGA 在断电时会丢失其配置。配置会在每次冷启动时重新加载,或者稍后在可选的时间重新加载。在采集卡上,FPGA 从 BPI flash 内存加载其配置。

BPI flash 内存分为 8 个分区。分区 1–7 之一包含用户要使用的配置(引导配置和/或活动配置)。为了确保采集卡在特殊情况下也能可靠工作,分区 0 包含一个后备配置(SAVE Configuration 1)。如果在极少数情况下无法使用预期的配置(引导配置或活动配置)进行 FPGA 配置,则会自动加载 SAVE Configuration。

这样,您就可以始终通过软件访问 FPGA,即,您可以始终使用完全功能配置(小程序)来配置帧捕获器。

何时会出现此类情况?#

导致无法加载预期配置的最常见原因是,在加载 BPI 闪存时,图像采集卡断电。断电会导致加载过程未完成。之后,FPGA 无法使用 BPI 闪存中(不完整的)内容进行配置,而是改用“保存配置”功能。

配置开关#

您可以随时通过位于板卡上的配置开关激活 SAVE Configuration。万一 SAVE Configuration 未能自动加载,这是最终的后备替代方案。

采集卡上的配置开关:

配置开关

要使用配置开关:

  1. 按下配置开关。
  2. 重新加载采集卡的设备驱动程序,或重新启动主机计算机(热启动)。
重新配置/重新烧录采集卡#

当SAVE Configuration成功激活(自动激活或通过开关激活)时,相应的SAVE LED 会变为红色。这表示可以通过软件访问采集卡。您现在可以使用要用于图像采集的小程序的完全功能版本来重新配置或重新烧录采集卡。要进行烧录,请使用软件工具 microDiagnostics(请参阅烧录)。

加载新 Applet(烧录)未完成#

如果您在将小程序烧录到 mE5 采集卡时遇到问题,即烧录过程没有结束:

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

禁用 FPGA 动态重新配置#

在 FPGA 动态重新配置期间(当您激活小程序时开始),采集卡会从 PCI 总线上短暂消失。但是,并非所有主板都支持设备从 PCI 总线上消失。(另请参阅Crash Protection。)

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

注意

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

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

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

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

要禁用 FPGA 的在线重新配置:

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

每次写入固件后,系统现在会提示您对计算机进行电源循环(冷启动):

Message After Flashing Power Cycle

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

  1. 单击关闭以完全关闭计算机(仅使用重启选项是不够的)。
  2. 计算机完全关闭后,等待几秒钟。
  3. 再次启动主计算机。

烧录后采集卡不可用#

如果您将 microEnable 5 采集卡烧录 *.hap 文件,且之后 Windows 设备管理器和 microDisplay X 无法识别采集卡,则您烧录到采集卡上的 *.hap 文件有误(存在时序违例等)。

在这种情况下,不会自动使用 SAVE Configuration 进行 FPGA 配置。

要激活 SAVE Configuration,请使用直接位于采集卡上的配置开关:

配置开关

要使用配置开关:

  1. 按下 Configuration 开关。
  2. 重新加载采集卡的设备驱动程序,或重新启动主机计算机(热启动)。

当 SAVE Configuration 成功激活(自动激活或通过开关激活)时,相应的 SAVE LED 会变为红色。这表示可以通过软件访问采集卡。您现在可以使用要用于图像采集的小程序的完全功能版本来重新配置或重新烧录采集卡。要进行烧录,请使用软件工具 microDiagnostics。

打开 microDiagnostics 并如烧录中所述,将要使用的小程序(完全功能版本)加载到采集卡上。