完整的 Zivid 勘误表
下面带点的文字,比如这句话,隐藏了更多的信息。将鼠标悬停即可显示。(像这样)
错误代码 |
概括: |
描述: |
版本: |
变通方案: |
开始于: |
修复于: |
E-39 |
Zivid 2, Zivid 2+ and Zivid 3 cameras stop responding on the network after receiving an Ethernet frame larger than 1526 bytes |
This issue affects Zivid 2, Zivid 2+ and Zivid 3 cameras with camera firmware 1.39.2 and earlier, which the Zivid SDK installs. It only affects cameras on a local subnet where some device sends Ethernet frames larger than the standard maximum. This happens when an interface on the local subnet is set to an MTU above 1500 (jumbo frames). Cameras on subnets where every interface uses MTU 1500 are not affected. The issue can happen when the camera receives a single frame of 1527 bytes or more. The frame does not need to be addressed to the camera. Broadcast and multicast frames reach every device on the subnet, and a switch can forward large frames between other devices to every port before it has learned where the receiver is. After such a frame, the camera stops receiving all network traffic. It can no longer be discovered by the SDK or Zivid Studio, does not answer ping, and drops any open connection with a timeout. Its LEDs look normal, and it keeps sending some network traffic of its own, so the network link appears healthy. Unplugging and re-inserting the network cable does not help. Only a power cycle of the camera recovers it. The camera logs nothing about the event. The cause is a bug in the camera firmware: a received frame longer than the camera's receive buffer stops the receive path instead of being dropped. |
|
Set the MTU to 1500 on every network interface on the same subnet as the camera, including the PC that runs the SDK. On Linux, for example: sudo ip link set dev <interface> mtu 1500. |
v2.17.0 |
不适用 |
E-38 |
Capture hangs or fails on Intel GPUs when the application's OpenCL queue waits on an incomplete user event |
This issue affects Zivid SDK 2.18 and later on Linux with Intel GPUs, and is confirmed with Intel Compute Runtime 25.13.33276.19. It only affects applications that pass their own OpenCL command queue to the SDK through the DeviceArray API, for example with ComputeDevice::createDeviceArrayView or Frame2D::imageDeviceArray. Applications that do not do this are not affected. The issue can happen when the application enqueues a barrier on its own command queue that waits on a user event that is not complete yet, passes that queue to the SDK, and starts a capture before the user event completes. What happens next depends on what else is on the application's queue. If the queue holds more work after the barrier, such as an upload to the buffer, that work never finishes after the user event completes, and the capture never returns. The application hangs without an error message. If the queue holds nothing after the barrier, the capture fails with the error "An OpenCL error occurred: Failed to enqueue barrier on destination OpenCL queue". The cause is a bug in the Intel OpenCL driver: a barrier on one queue that waits on another queue's gated work never completes. It can be reproduced with plain OpenCL code, without the Zivid SDK. |
|
Upgrade to Intel Compute Runtime 26.40.40196.8 or later, where the issue is fixed. If upgrading is not possible, complete every user event that the application's queue waits on before passing the queue to an SDK function or starting a capture. |
v2.18.0 |
不适用 |
E-37 |
投影仪的热稳定功能会导致亮度设置为 0 时 2D 捕获图像出现亮度波动 |
当将投影仪亮度设置为 0 并拍摄 2D 图像时,由于热稳定机制的原因,投影仪可能仍会发出微弱的光。因此,在拍摄期间投影仪并未完全关闭,这会导致即使使用相同的设置,连续拍摄的图像之间也会出现亮度差异。 |
|
不适用 |
v2.17.2 |
v2.18.0 |
E-34 |
在使用较慢的以太网连接进行全分辨率 HDR 捕获时,相机可能会重启 |
这种情况可能发生在相机通过 2.5 Gbps 或更慢的以太网连接时。如果多台相机通过交换机等方式连接到计算机的同一个以太网端口,发生此问题的可能性会更高。 |
|
不适用 |
v2.17.0 |
v2.17.1 |
E-33 |
GenICam/HALCON 点云看起来比 Zivid Studio 更暗 |
从 SDK 2.11 开始,Studio 将在 sRGB 色彩空间中显示颜色/RGB 值。与以前版本的 Studio(在线性 RGB 色彩空间中显示颜色)相比,这使得彩色图像在显示器上看起来更明亮、更准确。 通过 GenICam/HALCON 捕获仍将显示线性色彩空间中的颜色,在屏幕上会显得更暗。 |
|
不适用 |
v2.11.0 |
v2.14.0 |
E-32 |
使用 Halcon 时,在捕获一个较低分辨率的点云后,再去捕获一个较高分辨率的点云可能会失败(仅限 GenICam) |
Halcon 中的内存缓冲区在捕获后不会重置。因此,如果您首先捕获较低分辨率的点云,内存缓冲区的大小将不足以进行更高分辨率的捕获,这就是更高分辨率捕获失败的原因。 失败的捕获序列示例: set_framegrabber_param (AcqHandle, 'SamplingPixel', 'blueSubsample2x2') grab_data (Image, Region, Contours, AcqHandle, ObjectModel3D) set_framegrabber_param (AcqHandle, 'SamplingPixel', 'all') grab_data (Image, Region, Contours, AcqHandle, ObjectModel3D) |
|
不适用 |
v2.10.0 |
v2.14.0 |
E-30 |
导出的 PLY/PCD/XYZ 点云看起来比 Zivid Studio 中更暗 |
从 SDK 2.11 开始,Studio 将在 sRGB 色彩空间中显示颜色/RGB 值。与以前版本的 Studio(在线性 RGB 色彩空间中显示颜色)相比,这使得彩色图像在显示器上看起来更明亮、更准确。 将 frames 导出为 PLY/PCD/XYZ 文件会将颜色值存储在线性色彩空间中,这在屏幕上会显得更暗。所有 SDK 版本都是如此。 |
|
不适用 |
v2.11.0 |
v2.14.0 |
E-29 |
使用 Zivid::Experimental::Projection::showImage() 时,Zivid 2/2+ 可能会显示不正确的图像 |
有时,当使用 Zivid::Experimental::Projection::showImage() 时,相机可能会通过投影仪显示不正确的图像。 |
|
不适用 |
v2.10.0 |
v2.11.1 |
E-28 |
如果 PC 进程在捕获过程中中止,Zivid 2/2+ 可能会出现无响应/离线状态 |
如果 PC 进程在捕获过程中非干净地中止,则在极少数情况下,Zivid 2 或 2+ 相机可能会变得无响应,并且不会通过 Zivid SDK、Zivid Studio 或 ZividListCameras 出现。相机也不会响应 ping。但是,相机上的以太网活动 LED 可能仍会正常闪烁。 如果您进行长时间捕获并出现网络拥塞(fex 使用 1G 网络连接),则可能会出现此问题。 |
|
不适用 |
不适用 |
v2.12.0 |
E-27 |
在搭载了 Intel GPU 的 Windows 设备上使用 Zivid 2 或 2+ 相机时可能发生程序崩溃 |
在 Windows 操作系统上使用 Zivid 2 或 2+ 相机时,极少数情况下会发生异常代码为 c0000005(访问冲突)的崩溃。使用英特尔作为计算设备时可能会发生此问题。 崩溃将在捕获期间发生,并且在受影响的系统上崩溃的频率可能从几个小时到几天不等。 使用 Ubuntu 时尚未观察到此问题。 |
不适用 |
不适用 |
不适用 |
v2.13.0 |
E-26 |
Linux 上的 Segmentation fault |
libZividCore.so 会从 boost 和 asio 等第三方库中导出弱符号(weak symbols)。如果用户也将这些库用作其软件的一部分,则可能会发生诸如 segmentation fault 之类的崩溃。 |
不适用 |
不适用 |
不适用 |
v2.9.0 |
E-25 |
点云上部的图案/条纹不正确 |
当使用 Nvidia 驱动程序 510 并使用两个或多个相机进行背靠背拍摄时,有时会在点云的上部看到不正确的图案/条纹。此问题仅在此 Nvidia 驱动程序版本上出现。 |
不适用 |
如果您使用多个相机进行捕获,我们建议使用不同的 Nvidia 驱动程序版本。驱动程序 470、515 和 525 已经过测试并且运行良好。如果您只使用一台相机,则不会出现此问题。 |
不适用 |
不适用 |
E-24 |
Zivid 2 恢复出厂设置按钮可能不起作用 |
某些 Zivid 2 Rev B2/B3 可能没有用于重置网络配置的有效出厂重置按钮。状态指示灯将正确闪烁,表示网络重置已完成,但相机的 IP 仍与之前相同。 |
|
https://support.zivid.com/en/latest/support/reset-button-failure.html |
不适用 |
不适用 |
E-23 |
Zivid 2 上的固件更新在极少数情况下可能会因超时而失败 |
Zivid 2 相机的固件更新在极少数情况下可能会失败并出现以下错误: "The firmware reported a timeout while updating the camera. Please power cycle the camera, restart the application, and try again." |
|
不适用 |
不适用 |
v2.14.0 |
E-17 |
在使用 Ubuntu 20.04 加 Intel GPU 的方案时发生错误 "CL_OUT_OF_RESOURCES" 或 "OpenGL error: GL_INVALID_OPERATION" |
使用 Linux 5.8 kernel 时(使用较新的 HWE kernels 时随 Ubuntu 20.04.2 发布),如果同时使用 Intel GPU 作为渲染设备,Zivid Studio 和 Visualizer 在显示点云时可能会出现/"CL_OUT_OF_RESOURCES/"和/"OpenGL error: GL_INVALID_OPERATION/"等错误"。 |
|
不适用 |
不适用 |
v2.7.0 |
E-16 |
与相同硬件配置的装有 Linux 系统的 PC 相比,Windows 上的捕获时间可能更长。 |
较短的曝光时间设置之间的差异较大,较长的曝光时间设置之间的差异较小。与使用 Zivid One+ 相比,使用 Zivid 2/2+ 时 Windows 和 Linux 在相同硬件上的相对差异更大。 |
|
锁定 GPU 核心和内存时钟速度可以减少捕获时间的波动(仅限 Nvidia GPU)。 |
不适用 |
不适用 |
E-15 |
Windows 上的捕获时间有时会更长(比正常时间长 1 秒以上) |
由于以太网数据包丢失导致数据重新传输,Windows 上的捕获时间有时会更长(比正常时间长 1 秒以上)。我们建议在 Windows 的网络驱动设置中增加 "Receive Buffers" 和 "Transmit Buffers",以减少丢包的发生。 |
|
在 Windows 的网络驱动设置中增加 "Receive Buffers" 和 "Transmit Buffers",减少丢包的发生。 |
不适用 |
不适用 |
E-14 |
捕获期间抛出"CameraImageTimeout"或"Timeout"异常 |
在极少数情况下,捕获期间可能会发生 "Command failed: CameraImageTimeout" 异常。 |
|
不适用 |
不适用 |
v2.14.0 |
E-13 |
创建 Zivid::Application 时发生内存泄漏 |
创建 Zivid::Application 时,它会分配内存。当对象被销毁时,所有这些内存都不会被释放。如果您在同一进程中创建了多个 Zivid::Applications,泄漏可能会导致内存不足的错误 |
不适用 |
不适用 |
不适用 |
v2.7.0 |
E-10 |
如果 PC 进程在捕获过程中中止,Zivid 2/2+ 可能会挂起,导致 15 秒后重新启动。 |
如果 PC 进程在捕获过程中中止且同时存在网络拥塞,则 Zivid 2/2+ 可能会挂起。当多个相机连接在 1G 链路上时,通常会发生网络拥塞。 Zivid 相机将在 15 秒后重新启动以从此状态恢复。在某些特定的罕见情况下,相机可能不会自行重启。请参阅 {{ERRATA-28}} 了解更多信息。 |
|
不适用 |
v2.4.0 |
v2.13.0 |
E-9 |
Windows 上的 OpenCV assertion error 报错 |
如果您在 Windows 上以 debug 模式运行 SDK,并使用带有校准模型 v2.1.0 的 Zivid 2,那么您可能会在捕获过程中遇到 OpenCV assertion 错误。 |
|
不适用 |
v2.4.0 |
v2.4.1 |
E-7 |
如果收到 SIGTERM,SDK 可能会挂起 |
如果在操作期间向 Zivid SDK 发送 SIGTERM,SDK 可能会挂起。 |
不适用 |
不适用 |
v2.3.0 |
v2.5.0 |