已知问题Framegrabber SDK 5.11.7
本节提供有关 Basler 已知问题的信息。 Framegrabber SDK 版本 5.11.7。
所有组件
| 总结 | 加载库需要 Visual Studio 2022 可再发行组件包 |
| 描述 | GenTL 生产者现在使用 Visual Studio 2022 编译。因此，目标系统上必须安装 Microsoft Visual Studio 2022 可再发行组件包。如果缺少这些组件包，SDK 库可能无法加载。 |
| 受影响的操作系统 | Linux 和Windows |
| 变通方法 | 在加载或部署 SDK 库之前，请在系统上安装相应的 Microsoft Visual C++ 2022 可再发行组件包（与目标架构匹配，例如 x64）。您可以从 Microsoft 官方网站获取这些可再发行组件包，或者它们可能包含在您的应用程序安装程序中。 |
| 工单 ID | - |
| 总结 | 微启用 5 marathon 使用以下方式创建的小程序VisualApplets 3.6.1 或更新版本无法刷入Framegrabber SDK 5.11.6 或更高版本 |
| 描述 | 为 microEnable 5 构建的小程序marathon 帧捕获器VisualApplets 版本高于 3.6.0 的固件无法使用以下方式刷写： Framegrabber SDK 5.11.6 或更高版本。刷写完成后，即可使用该小程序进行操作。 Framegrabber SDK 5.11.6 或更高版本。 |
| 受影响的操作系统 | Linux 和Windows |
| 变通方法 | 使用以下方式构建小程序VisualApplets 3.6.0 或更早版本，或者刷写小程序Framegrabber SDK 5.11.6 或更早版本。 |
| 工单 ID | 355906 |
| 总结 | 使用巴斯勒CXP-12 Interface Card 2C /4C 和 imaworx CXP-12 四画面采集卡PCIe 低于第三代 x 8 规格可能会降低摄像头的性能Acquisition Frame Rate 并导致图像丢失 |
| 描述 | Basler CXP-12 Interface Card 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 | – |
| 总结 | 帧率上限介于 50000 FPS 和 90000 FPS 之间。 |
| 描述 | 每秒帧数 (FPS) 的限制在 50000 FPS 到 90000 FPS 之间，具体取决于缓冲区数量和图像大小： - 对于 10 个缓冲区和最小图像尺寸为 48x1 的情况，极限约为 50,000 FPS。
- 对于 50 个缓冲区和 48x1 的最小图像尺寸，极限约为 90,000 FPS。
- 对于 50 个缓冲区和 8192x1 的图像大小，极限约为 50,000 FPS。
|
| 受影响的操作系统 | Linux 和Windows |
| 变通方法 | 暂无可用绕过方法。 |
| 工单 ID | 295445 |
| 总结 | 存储和加载 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
| 总结 | 初始化后不久关闭日志记录时发生死锁 |
| 描述 | 当 SDK 配置为连接到 pylon Event Logger如果在初始化后立即关闭日志记录，则可能发生死锁。常见场景包括：- 呼叫
Fg_FreeLibraries() 在 Fg_InitLibraries() - 呼叫
Fg_... 无需显式生命周期管理的函数 Fg_InitLibraries() 和 Fg_FreeLibraries(). - 呼叫
GCCloseLib() 在 GCInitLib() 。
|
| 受影响的操作系统 | Windows |
| 变通方法 | 为避免此问题，请确保日志子系统和相关库在 SDK 使用的整个期间保持初始化状态，并避免在初始化后立即关闭它们。 |
| 工单 ID | 360731 |
| 总结 | 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 | 231049 |
| 总结 | 在 Acquisition Start 之后更改的相机参数未反映在图像采集卡中 |
| 描述 | 当图像采集过程中相机参数发生变化时，图像采集卡不会反映出这些变化。这是因为…… GenTL Producer 在开始采集之前检索相关参数（宽度、高度、图像格式等），并将其与帧捕获器同步。 |
| 受影响的操作系统 | Windows 和 Linux |
| 变通方法 | 暂无可用绕过方法。 |
| 工单 ID | 195482 和 225591 |
| 总结 | 当小程序更改时，GenTL 设备 ID 也会更改。 |
| 描述 | 根据 GenTL 标准，设备 ID 在两次会话之间应保持不变。然而，当小程序更改时，GenTL 设备 ID 也会随之改变。因此，只有当小程序名称与生成该设备 ID 的小程序名称相同时，才能重复使用该设备 ID。 |
| 受影响的操作系统 | Windows 和 Linux |
| 变通方法 | 暂无可用绕过方法。 |
| 工单 ID | – |
microDisplay X
| 总结 | 对于包含两个相机运算符的 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 |
| 总结 | 如果打开 Camera 选项卡，microDisplay X 可能会崩溃 |
| 描述 | 如果打开 Camera 选项卡，microDisplay X 可能会崩溃。这种情况发生在：仅安装了一块带有单台相机的 mE6 采集卡，且发现操作已完成后，您在 microDisplay X 中的第一次点击落在了 Camera 选项卡上。 |
| 受影响的操作系统 | Windows 和 Linux |
| 变通方法 | 在发现相机之前打开 Camera 选项卡。 |
| 工单 ID | 333828 |
Python 封装器
| 总结 | 目前没有适用于imaFlex平台的Python封装示例。 |
| 描述 | imaFlex平台没有提供任何Python封装器示例。 Framegrabber SDK 。 |
| 受影响的操作系统 | Windows 和 Linux |
| 变通方法 | 请参考其他平台的示例并进行相应调整。 |
| 工单 ID | – |