受支持的图像采集接口

目前，以下行业标准的图像采集接口均受支持：

  • GenICam GenTL
  • GigEVision2
  • USB3 Vision

MERLIC 使用 HALCON MVTec HALCON 是一个用于机器视觉的综合标准软件，带有一个集成开发环境 (HDevelop)。MERLIC 利用了各种 HALCON 程序和其他程序功能。 的各图像采集接口。因此，已注册客户可以通过 MVTec 服务器的 MVTec Interfaces 下载来下载最新版本的接口。

以下章节将概要介绍所有兼容相机的访问接口。如需其他文档（包括其他技术信息），请参阅 MVTec 网站上的 HALCON 接口文档。

GenICam GenTL

  • 装有 Windows 10（64 位）或所用 GenTL Producer 支持的更高版本操作系统且兼容英特尔的 PC 机。
  • 已经成功安装 GenICam GenTL Producer。环境变量 GENICAM_GENTL64_PATH 指定的路径之一中必须包含相应的 .cti 文件。
  • 根据所用传输层，确保您有设备的访问权限。按照各 GenTL Producer 指定的所有要求和建议保证完美、有效地访问设备。尤其，对于万兆以太网，必须检查以下几点：
    • 我们建议使用支持超大帧的 PCIe 网络适配器。请相应地配置网络适配器，例如将 MTU 值设置为 9000。此外，相机应直接连接网络适配器，以防受到其他网络流量的干扰。请注意，交换机等联网设备不一定支持超大帧。
    • 如果您正在使用防火墙，请确保您的防火墙设置允许与相机进行通讯以便搜索、控制和串流传输，这取决于所用的传输层。对于 Windows，最简单方法就是在防火墙上允许应用程序，即 MERLIC 或您编译的应用程序。
  • GenICam 版本 3.4.2 相应文件属于 MERLIC 安装程序的一部分，且位于 MERLIC 安装目录中的 genicam 目录内。由于 GenICamTL 接口已自行设置所有必需的环境变量，所以无需设置或修改任何环境变量。
  • 默认采集模式假设了计算机的处理速度足够处理来自相机的所有缓存。如果不够，将（由 GenTL Producer）静默丢弃它们。
  • 仅支持串流通道 0。这意味着，目前无法从同一设备的多个数据流中进行同步采集。
  • 不支持从只读访问模式的设备进行采集。
  • 有限支持具有多个 ROI 功能的设备。

  • 如果使用弃用的“从相机获取图像”工具采集图像，还存在以下限制：一些相机设备不支持保存和加载相机配置调整。在这种情况下，您对相机参数设置进行的调整无法在 MERLIC Vision App 中保存！如果使用了此类设备，再次加载工具时会恢复默认相机设置。但是，即使选定相机设备支持保存和加载功能，该功能仍然取决于实际保存相机参数的相机设备。

    如果在弃用的“从相机获取图像”工具中连接了 GigE Vision 相机，相机参数 [Stream]GevStreamAbortCheckPeriod 的值会自动设置为 500 µs，以减少图像采集时间。每次加载相机时，即加载 MVApp 时，都会自动设置该值。要使用其他值，您必须在加载 MVApp 后手动调整该值。

此接口可以通过多个环境变量控制。

  • GENICAM_GENTL64_PATH 是保存 GenTL Producer 安装目录列表的标准 GenTL 变量。GenTL Producer 的安装程序通常自动调整这些变量。

GigEVision2

  • 装有 Windows 10（64 位）或更高版本操作系统的英特尔兼容 PC 机。
  • 千兆以太网网络适配器建议使用支持超大帧的 PCIe 网络适配器。请相应地配置网络适配器，例如将 MTU 值设置为 9000，以便减少中断次数。此外，相机应直接连接网络适配器，以防受到其他网络流量的干扰。请注意，交换机等联网设备不一定支持超大帧。
  • 如果您正在使用防火墙，请确保防火墙设置允许应用程序或 MERLIC 连接相机和接收传入的图像，否则，捕捉将失败。
  • Windows x64 下的 MVTec GigE Vision Streaming Filter：GigEVision2 接口自动使用滤镜驱动程序来增强图像串流传输性能。在安装 MERLIC 时，如果勾选相应复选框，滤镜驱动程序将自动安装。
    请确保驱动程序版本 v2.2.8.4 可用。较早版本的驱动程序将不会工作！
  • GenICam 版本 3.4.2 相应文件属于接口数据包的一部分，且位于 MERLIC 安装目录中的 genicam 目录内。由于接口自己已设置所有必需环境变量，因此无需设置或修改任何环境变量。
  • 默认缓冲区处理模式假设了计算机的处理速度足够处理来自相机的所有缓存。如果不够，将静默丢弃它们。
  • 仅支持串流通道 0。这意味着，目前无法从同一设备的多个数据流中进行同步采集。

  • 如果使用弃用的“从相机获取图像”工具采集图像，还存在以下限制：一些相机设备不支持保存和加载相机配置调整。在这种情况下，您对相机参数设置进行的调整无法在 MERLIC Vision App 中保存！如果使用了此类设备，再次加载工具时会恢复默认相机设置。但是，即使选定相机设备支持保存和加载功能，该功能仍然取决于实际保存相机参数的相机设备。

    如果在弃用的“从相机获取图像”工具中连接了 GigE Vision 相机，相机参数 [Stream]GevStreamAbortCheckPeriod 的值会自动设置为 500 µs，以减少图像采集时间。每次加载相机时，即加载 MVApp 时，都会自动设置该值。要使用其他值，您必须在加载 MVApp 后手动调整该值。

USB3 Vision

  • 装有 Windows 10（64 位）或更高版本操作系统的英特尔兼容 PC 机。
  • 计算机必须配有 USB 3.0 接口。确保您使用 USB 3.0 主机控制器的最新驱动程序。在 Windows 系统上，通过内置机制进行搜索根本不够，您需要在主机控制器制造商的网站上检查最新版本。
  • 确保已经通过相应驱动程序设定对设备的访问。这可通过此操作完成：在首次连接设备时，在打开的消息窗口中确认安装驱动程序。
  • GenICam 版本 3.4.2 相应文件属于 MERLIC 安装程序的一部分，且位于 MERLIC 安装目录中的 genicam 目录内。由于 HALCONGenICamTL 接口自己已设置所有必需环境变量，因此无需设置或修改任何环境变量。
  • 默认采集模式假设了计算机的处理速度足够处理来自相机的所有缓存。如果不够，将静默丢弃它们。
  • 具有多项 USB 配置的设备无法获得完全支持。

  • 如果使用弃用的“从相机获取图像”工具采集图像，还存在以下限制：一些相机设备不支持保存和加载相机配置调整。在这种情况下，您对相机参数设置进行的调整无法在 MERLIC Vision App 中保存！如果使用了此类设备，再次加载工具时会恢复默认相机设置。但是，即使选定相机设备支持保存和加载功能，该功能仍然取决于实际保存相机参数的相机设备。

    如果在弃用的“从相机获取图像”工具中连接了 GigE Vision 相机，相机参数 [Stream]GevStreamAbortCheckPeriod 的值会自动设置为 500 µs，以减少图像采集时间。每次加载相机时，即加载 MVApp 时，都会自动设置该值。要使用其他值，您必须在加载 MVApp 后手动调整该值。

限制

只有使用 Image Source Manager 的 MERLIC 才支持硬件触发器。

如需设置由硬件触发器触发的相机，请参阅配置图像源主题。

为通过 Image Source Manager 进行图像采集配置的相机设备不能在“从相机获取图像”工具中使用，但它们属于当前活动配置的一部分。

故障排除

  • 检查是否使用最新版本的接口。
  • 检查是否满足系统要求。
  • 检查设备是否有最新固件。
  • 检查“工具状态”值以查询关于问题的更多信息。
  • 检查使用的 GenICam 二进制文件是否正确。MERLIC在专用安装中（MERLIC 安装目录中的 genicam 目录）使用官方二进制文件。如果在您的路径或一些系统路径中（例如，在 C:\Windows\System32\ 中）存在其他 GenICam 二进制文件，请将它们与 MERLIC 安装中的文件进行比较，确保它们是官方二进制文件。使用非官方二进制文件可能产生问题。
  • 检查所用 GenICamTL Producer 的较新版本。
  • 检查相机是否兼容 GigE Vision。
  • 检查是否使用滤镜驱动程序（请参阅参数“[Stream]GevStreamActiveEngine”）。
  • 检查防火墙的设置（Windows 或其他）是否允许与 GigE Vision 相机通讯。系统使用不同的连接来控制设备 (GVCP) 和串流传输数据 (GVSP)。可能需要使用 Windows 防火墙设置对话框来明确访问特定应用程序（例如，MERLIC），而非使用防火墙首次阻止应用程序时出现的默认 Windows 对话框。

此外，以下提示可能有助于解决一些特定问题。

  • 原因：可能有几种原因，例如，网络设置错误或程序受到干扰。
    • 建议 a)：检查防火墙设置。
    • 建议 b)：检查相机的迷你端口驱动程序，它们可能会盗取数据包。
    • 建议 c)：检查能否在网络中访问相机，例如，使用 ping 命令。
    • 建议 d)：检查相机是否兼容 GigE Vision 或者是否需要更新固件。
    • 建议 e)：在出现“no exclusive access”错误时：
      • 有其他人正在使用相机。
      • 尝试将相机关闭后再打开。
      • 在当前网络中无法访问相机。
  • 原因：可能具有几种原因，例如，程序被阻止、出现网络问题或参数设置不对。
    • 建议 a)：检查防火墙设置。
    • 建议 b)：检查相机的迷你端口驱动程序，它们可能会盗取数据包。
  • 原因：由于以太网卡速度慢、计算机速度慢、网络访问速度慢或总线速度慢/负载繁重，系统无法接收或处理所有必需数据包且无法重新发送。
    • 建议 a)：检查是否使用滤镜驱动程序。
    • 建议 b)：将 GevSCPD 设为较高值以防数据包激增导致超载。
    • 建议 c)：增大数据包大小（网卡和相机上）以便减少中断负载和开销。
    • 建议 d)：减少其他应用程序或相机的总线负载。
  • 原因：正在进行图像采集。
    • 解决方案：通过停止执行 MVApp 来停止采集图像。
  • 原因：相机需要更多时间来设置参数。
    • 解决方案：增大参数 [Device]LinkCommandTimeout。

如果仍然存在问题，请联系当地经销商。为了避免不必要的咨询，在请求支持时，需要提供以下信息。

  • 所用 MERLIC 和采集接口版本。
  • 相机制造商、型号和固件版本。
  • 计算机系统的详情，例如，操作系统、RAM 和 CPU。
  • MERLIC 输出控制台中显示的错误消息和生成的日志文件。
  • 重现问题的最小 MERLIC Vision App 样本。
  • 所观察与预测行为的描述。
  • 对于 GenICamTL 接口：
    • 所用 GenICam GenTL Producer 的详情（至少名称和版本）。
  • 对于 GigEVision2 接口：
    • 网卡的详情（PCI、CardBus、超大帧、链接速度等）。
    • 网络拓扑的详情（直连、交换机等）。