Framegrabber SDK 5.11.4 已知问题
本节提供有关 Basler Framegrabber SDK 5.11.4 版本已知问题的相关信息。
所有组件
| 总结 | 使用 Vivado 2025.1 构建的小程序可能无法加载 |
| 描述 | 使用 Vivado 版本 2025.1 创建的小程序有时可能无法加载。 |
| 受影响的操作系统 | Linux 和Windows |
| 变通方法 | 这个问题已在 Framegrabber SDK 5.11.6 中修复。因此，为避免出现此问题，请使用 Framegrabber SDK 5.11.6 或更高版本。或者使用 Vivado 2023.2 构建您的 applet。 |
| 工单 ID | 341684 |
| 总结 | 当 PCIe 低于 Gen 3x8 时使用 Basler CXP-12 Interface Card 1C/2C/4C 和 imaworx CXP-12 Quad Frame Grabbers 可能会降低相机的 Acquisition Frame Rate 并导致丢图 |
| 描述 | Basler CXP-12 Interface Card 1C/2C/4C 和 imaWorx CXP-12 Quad 采集卡需要具有 PCIe Gen 3x8（直接内存访问）或更高规格的主机接口。使用较慢的主机接口可能会降低相机的 Acquisition Frame Rate 并导致丢图。 |
| 受影响的操作系统 | Linux 和Windows |
| 变通方法 | 暂无可用绕过方法。 |
| 工单 ID | – |
| 总结 | 如果在采集卡或接口卡上丢失图像，丢失的图像将由下一个传输的缓冲区进行指示 |
| 描述 | 如果在采集卡或接口卡上因缓冲区溢出而丢失图像（例如，当用户应用程序未能足够快地（重新）将缓冲区排队以传输图像时），丢失的图像将由下一个传输的缓冲区进行指示。丢失的图像标记为 INCOMPLETE，其文件大小为 0，且自定义错误代码为 BUFFER_INFO_BASLER_XAPI_ERROR_CODE 参数 42。此外，流信息中会添加一个丢失帧。请注意，无论由于溢出丢失了多少帧，都只会添加一个丢失帧。 |
| 受影响的操作系统 | Linux 和Windows |
| 变通方法 | 暂无可用绕过方法。 |
| 工单 ID | – |
| 总结 | 通过接口卡更改 Applet 会导致设备列表不正确 |
| 描述 | 在更改 Applet 期间，连接到接口卡的相机仍会显示在设备列表中，尽管它们已无法访问。在此状态下尝试打开相机会导致错误消息。 |
| 受影响的操作系统 | Linux 和Windows |
| 变通方法 | 暂无可用绕过方法。 |
| 工单 ID | – |
| 总结 | 计算机启动后可能无法检测到相机 |
| 描述 | 在少数情况下，计算机启动后检测不到相机。 |
| 受影响的操作系统 | Linux 和Windows |
| 变通方法 | 要检测相机，请对相机进行断电重启。 |
| 工单 ID | – |
| 总结 | 分配用于采集的缓冲区必须使用堆内存 |
| 描述 | 分配用于采集的缓冲区时，缓冲区地址必须按 8 字节对齐。如果使用堆内存，则会自动满足此条件。 |
| 受影响的操作系统 | Linux 和Windows |
| 变通方法 | 请使用堆内存。 |
| 工单 ID | – |
| 总结 | 安装塔架时出现的不兼容性Framegrabber SDK 同时在您的电脑上 |
| 描述 | 如果您的计算机上同时安装了 pylon 和 Framegrabber SDK，Basler 建议在安装 pylon 时取消勾选 CXP 选项。为避免因竞争 CXP 生产者而产生问题，应仅由 pylon 或 Framegrabber SDK 负责操作 Basler 采集卡和/或接口卡。 |
| 受影响的操作系统 | Linux 和Windows |
| 变通方法 | 如果您的计算机上同时安装了 pylon 和 Framegrabber SDK，请在安装 pylon 时取消勾选 CXP 选项。 |
| 工单 ID | – |
| 总结 | 每秒帧数 (fps) 限制在 50000 fps 到 90000 之间 |
| 描述 | 每秒帧数 (fps) 限制在 50000 fps 到 90000 之间，具体取决于缓冲区数量和图像大小： - 10 个缓冲区且最小图像尺寸为 48x1 时，限制约为 50000 fps
- 50 个缓冲区且最小图像尺寸为 48x1 时，限制约为 90000 fps
- 50 个缓冲区和 8192x1 的图像大小所决定的限制约为 50000 fps
|
| 受影响的操作系统 | Linux 和Windows |
| 变通方法 | 暂无可用绕过方法。 |
| 工单 ID | – |
| 总结 | 存储和加载 MCF 文件导致双精度值被四舍五入为整数 |
| 描述 | 从 MCF 文件加载配置时，使用逗号作为分隔符的双精度值可能会被四舍五入为最接近的整数。这是由 Linux 操作系统的当前区域设置引起的。如果区域设置将点定义为分隔符，则不会发生四舍五入。 |
| 受影响的操作系统 | Linux |
| 变通方法 | 设置适当的区域设置，例如 LC_NUMERIC="C" ./<applicationName>，然后启动 microDisplay X 或 microDiagnostics。 |
| 工单 ID | 265213 |
| 总结 | 相机无法输出正确的图像 |
| 描述 | 如果多链路相机不符合 CXP 标准中关于图像数据在链路间分配的规定，相机将无法正确传输图像。在 JAI SP-12000C-CXP4 相机上观察到了此问题。 |
| 受影响的操作系统 | Windows 和 Linux |
| 变通方法 | 暂无可用绕过方法。 |
| 工单 ID | 211645 |
| 总结 | Linux 驱动程序无法使用受信任的 Basler 证书进行签名 |
| 描述 | 在 Linux 中使用安全启动（UEFI 模式）需要使用受信任证书签名的驱动程序。由于驱动程序以源代码形式提供，因此无法使用受信任的 Basler 证书对其进行签名。 |
| 受影响的操作系统 | Linux |
| 变通方法 | 若要使用该驱动程序，可以禁用安全启动。或者，您可以按照此 Ubuntu 博客条目中的说明对驱动程序进行签名。 |
| 工单 ID | – |
Framegrabber API
| 总结 | 显示高帧率图像可能会导致输入延迟 |
| 描述 | 使用 display_lib Framegrabber API 库（仅在 Windows 上可用）时，显示高帧率图像（约每秒 10,000 帧）可能会导致主计算机出现输入延迟（例如键盘和鼠标延迟）。 |
| 受影响的操作系统 | Windows |
| 变通方法 | 暂无可用绕过方法。 |
| 工单 ID | – |
CLComDriver
| 总结 | 系统中安装的驱动程序多于 CLSer 端口 |
| 描述 | 有时在使用 Install COM driver(s) for all Ports 时，安装的驱动程序数量会多于系统中的 CLSer 端口数量。 |
| 受影响的操作系统 | Windows |
| 变通方法 | 选择多余的端口，并使用命令 Remove selected COM driver 将其移除。 |
| 工单 ID | – |
| 总结 | 使用 Basler Runtime 5.9.0 或更早版本时，无法识别板卡类型 |
| 描述 | 使用 Basler Runtime 5.9.0 或更早版本时，无法识别板卡类型，且端口仅显示 CLSer 标识符。 |
| 受影响的操作系统 | Windows |
| 变通方法 | 将您的 Basler Runtime/Framegrabber SDK 版本更新至 5.10 或更高版本。 |
| 工单 ID | – |
| 总结 | 设备管理器中的端口设置未反映实际设置 |
| 描述 | 设备管理器中的端口设置未反映实际设置，且更改未生效。 |
| 受影响的操作系统 | Windows |
| 变通方法 | 使用 Windows COM Port API 来更改端口设置。 |
| 工单 ID | – |
Linux 驱动程序
| 总结 | marathon 采集卡上的采集产生畸变图像 |
| 描述 | 在 marathon CXP 和 CL 采集卡上采集的图像可能会显示为畸变图像。这是因为 Linux 驱动程序不支持使用输入输出内存管理单元 (IOMMU)。 |
| 受影响的操作系统 | Linux |
| 变通方法 | 通过在以下文件中添加这一行来停用输入输出内存管理单元 (IOMMU)： etc/default/grub.txt: GRUB_CMDLINE_LINUX_DEFAULT="intel_iommu=off" |
| 工单 ID | 336093 |
GenTL Producer
| 总结 | GenTL Device Discovery 不适用于 Camera Link 线扫描 Applets |
| 描述 | 可以通过 GenPC 和 CLP 访问连接到 marathon Camera Link 采集卡（例如 ACL 或 VCL）的相机，如本主题中所述。目前这仅适用于面阵 Acquisition Applets，不适用于线扫描 Acquisition Applets。 |
| 受影响的操作系统 | Linux 和Windows |
| 变通方法 | 暂无可用绕过方法。 |
| 工单 ID | 335339 |
| 总结 | GenTL BUFFER_INFO_FRAME_ID 包含所有帧的 Counter，而不是 CXP 图像标头源标记 |
| 描述 | GenTL BUFFER_INFO_FRAME_ID，可以通过以下方式查询 DSGetBufferInfo，不包含来自 CXP 图像标头的源标记。相反，它包含已传输到计算机的所有帧的 Counter。 |
| 受影响的操作系统 | Windows 和 Linux |
| 变通方法 | 暂无可用绕过方法。 |
| 工单 ID | – |
| 总结 | 更改相机的 DeviceUserID 后需要重新启动 |
| 描述 | 当 DeviceUserID 更改相机的参数后，需要重新启动 GenTL Producer 才能使更改生效。这会影响使用 GenTL Producer 的两种方式：通过 GenTL API 以及使用 GUI 通过 GenTL 与相机进行交互（即 pylon Viewer）。 |
| 受影响的操作系统 | Windows 和 Linux |
| 变通方法 | 暂无可用绕过方法。 |
| 工单 ID | – |
| 总结 | 对于 GenTL 版本 1.4 及以下的 Producer，GenTL 支持有限 |
| 描述 | 对 GenTL 版本 1.4 及更低版本的 Producer 的 GenTL 支持有限。 |
| 受影响的操作系统 | Windows 和 Linux |
| 变通方法 | 暂无可用绕过方法。 |
| 工单 ID | – |
| 总结 | 图像大小限制为 2 GB |
| 描述 | 由于 GenTL Producer 缓冲区大小的限制，图像大小被限制为 2 GB。 |
| 受影响的操作系统 | Windows 和 Linux |
| 变通方法 | 暂无可用绕过方法。 |
| 工单 ID | – |
| 总结 | 在 Acquisition Start 之后更改的相机参数未反映在图像采集卡中 |
| 描述 | 当图像采集过程中相机参数发生变化时，图像采集卡不会反映出这些变化。这是因为…… GenTL Producer 在开始采集之前检索相关参数（宽度、高度、图像格式等），并将其与帧捕获器同步。 |
| 受影响的操作系统 | Windows 和 Linux |
| 变通方法 | 暂无可用绕过方法。 |
| 工单 ID | 195482 和 225591 |
| 总结 | 当小程序更改时，GenTL 设备 ID 也会更改。 |
| 描述 | 根据 GenTL 标准，设备 ID 在两次会话之间应保持不变。然而，当小程序更改时，GenTL 设备 ID 也会随之改变。因此，只有当小程序名称与生成该设备 ID 的小程序名称相同时，才能重复使用该设备 ID。 |
| 受影响的操作系统 | Windows 和 Linux |
| 变通方法 | 暂无可用绕过方法。 |
| 工单 ID | – |
microDisplay X
| 总结 | 打开 Camera 选项卡时 microDisplay X 崩溃 |
| 描述 | 如果在仍在检测相机时点击 Camera 选项卡，microDisplay X 将崩溃。 |
| 受影响的操作系统 | Linux 和Windows |
| 变通方法 | 这已在 Framegrabber SDK 5.11.5 版本中修复。请将您的 Framegrabber SDK 版本更新至 5.11.5 或更高版本。 |
| 工单 ID | 333828 |
| 总结 | 删除已加载的 Applet 后 microDisplay X 冻结 |
| 描述 | 在 Linux 系统上，删除 Applet 后如果尝试重新扫描 mE6 采集卡以查找可用的 Applets，microDisplay X 可能会冻结。 |
| 受影响的操作系统 | Linux |
| 变通方法 | 这已在 Framegrabber SDK 5.11.5 版本中修复。请将您的 Framegrabber SDK 版本更新至 5.11.5 或更高版本。 |
| 工单 ID | 334080 |
| 总结 | 对于包含两个相机运算符的 VisualApplets 设计，微型显示器 microDisplay X 中的相机检测有时会失效 |
| 描述 | 对于包含两个相机运算符的 VisualApplets 设计，如果其中至少一个运算符有两个通道且资源索引按直接升序分配，则 microDisplay X 中的相机检测将无法正常工作。例如，两个相机运算符各有两个通道，运算符 A 使用端口 0 和 1，运算符 B 使用端口 2 和 3。 |
| 受影响的操作系统 | Windows 和 Linux |
| 变通方法 | 请勿按直接升序分配资源索引。例如，将运算符 A 的通道分配给端口 0 和 2，将运算符 B 的通道分配给端口 1 和 3。 |
| 工单 ID | 314206 |
| 总结 | 加载包含复杂设计的 HAP 文件时 microDisplay X 崩溃 |
| 描述 | 某些非常复杂的 VisualApplets 设计可能会在 microDisplay X 中加载 Applet 期间或加载后立即导致崩溃。在 SDK 程序中未观察到此类崩溃。 |
| 受影响的操作系统 | Windows 和 Linux |
| 变通方法 | 再次在 microDisplay X 中加载 Applet。通常在尝试第二次或第三次后，即可成功在 microDisplay X 中加载 Applet。 |
| 工单 ID | 314234 |
| 总结 | 干净Linux 安装， microDisplay X 无法启动 |
| 描述 | 干净Linux 安装， microDisplay X 无法启动。出现此问题的原因是，在干净的磁盘上。 Linux 安装， xcb QT平台插件缺失。 |
| 受影响的操作系统 | Linux |
| 变通方法 | 安装缺失的插件 sudo apt install libxcb-xinerama0 命令。 |
| 工单 ID | 259941 |
| 总结 | 在Linux ， microDisplay X 关闭时可能会崩溃。 |
| 描述 | 在Linux ， microDisplay X 关闭时可能会崩溃。这不会造成其他后果，可以忽略。 |
| 受影响的操作系统 | Linux |
| 变通方法 | 暂无可用绕过方法。 |
| 工单 ID | 211811 |
Python 封装器
| 总结 | 目前没有适用于imaFlex平台的Python封装示例。 |
| 描述 | imaFlex平台没有提供任何Python封装器示例。 Framegrabber SDK 。 |
| 受影响的操作系统 | Windows 和 Linux |
| 变通方法 | 请参考其他平台的示例并进行相应调整。 |
| 工单 ID | – |