VisualApplets 3.7.0 版本已知问题#
常规#
| 概括： | 对于 mE5 平台和 imaFlex 平台，资源估算可能偏低。 |
|---|---|
| 描述： | 对于 mE5 和 imaFlex 平台，某些操作员的资源估算（即 Blob 和 Histogram可能会低估已使用的块 RAM 数量。根据模块配置的不同，块 RAM 资源的实际使用量可能高出 50% 以上。 |
| 变通方法： | 暂无可用绕过方法。 |
| 票号： | 297790 |
| 概括： | 使用剪贴板复制内容无效 |
|---|---|
| 描述： | 无法通过剪贴板（复制和粘贴）将在此 VisualApplets 版本中打开的设计的内容复制到在 VisualApplets 3.3.2 或更早版本中打开的设计中。但是，从任何 VisualApplets 版本复制到此版本是可以正常工作的。 |
| 变通方法： | 将您的设计保存为旧版 *.va 文件格式，在旧版本的 VisualApplets 中打开它，然后从那里复制内容。 |
| 票号： | – |
| 概括： | 将设计转换到不同的硬件平台时，硬件相关的运算符库可能无法使用。 |
|---|---|
| 描述： | 当转换时VisualApplets 针对不同的硬件平台进行设计时，在某些情况下，目标平台的硬件相关运算符库可能不可用。 |
| 变通方法： | 要解决此问题，请重启VisualApplets 。 |
| 票号： | – |
| 概括： | *.va 文件名仅支持 ASCII 字符。 |
|---|---|
| 描述： | 对于*.va文件命名，只能使用基于 ASCII 字符的字体；这意味着，例如，文件名不支持亚洲字体、西里尔字体、希腊字体或阿拉伯字体。 |
| 变通方法： | 暂无可用绕过方法。 |
| 票号： | – |
| 概括： | 当层级盒中的 M 类型算子直接连接到输入端口时出现 Design Rules Check 错误 |
|---|---|
| 描述： | 如果使用层级盒，在某些特定情况下，Design Rules Check 可能会出现以下错误消息：“算子 ABC（层级盒）的输入 XYZ 必须连接到 O 类型算子，例如 NOP。”原因是放置在层级盒中的某些 M 类型算子无法直接连接到层级盒的输入端口。这仅适用于某些特定的 M 类型算子。 |
| 变通方法： | 可以通过在层级盒的输入端口与 M 类型算子的输入端口之间放置一个 NOP 算子来解决此问题（在层级盒内）。 |
| 票号： | – |
| 概括： | 使用逐行 1D 仿真模式时出现 Design Rules Check 错误 |
|---|---|
| 描述： | 对于在早期版本的 VisualApplets 中通过 Design Rules Check 的某些设计，可能会报告有关最大图像高度的链接错误。特别是，当涉及 1D 处理且激活了新的逐行仿真模式（默认）时，可能会发生这种情况。原因是在逐行模式下，某些算子向输出链接传播输入链接的最大图像高度的方式与以前不同。 |
| 变通方法： | 可以通过切换到旧版仿真模式或添加用于调整最大图像高度值的 SetDimension 模块来解决此问题。 |
| 票号： | – |
| 概括： | 使用逐行 1D 仿真模式时运行时间增加 |
|---|---|
| 描述： | 对于某些设计，仿真的运行时间可能比早期版本的 VisualApplets 长得多。特别是，当涉及 1D 处理、激活了新的逐行仿真模式（默认）且设计包含许多仿真探测器时，可能会发生这种情况。 |
| 变通方法： | 可以通过切换到旧版仿真模式或减少仿真探测器的数量来解决此问题。 |
| 票号： | – |
| 概括： | CXP SDK：对 SISO_GenICam 库的访问必须由用户编程实现 |
|---|---|
| 描述： | CXP SDK：对 SISO_GenICam 库的访问不会自动生成，而必须由用户进行编程。 |
| 变通方法： | 暂无可用绕过方法。 |
| 票号： | – |
| 概括： | 提高 FPGA 设计时钟频率可能会导致构建过程变慢 |
|---|---|
| 描述： | 提高 FPGA 设计的时钟频率可能会导致构建流程耗时极长甚至失败，因为可能无法满足时序约束。这在很大程度上取决于 VisualApplets 设计的内容。 |
| 变通方法： | 暂无可用绕过方法。 |
| 票号： | 8513 |
| 概括： | 大图像未显示在仿真探测器中 |
|---|---|
| 描述： | 当仿真探测器包含非常大的图像时，由于 Memory 限制，VisualApplets 可能无法正确显示这些图像。在这种情况下，将显示灰色图像（即所有像素的值均为 205 (0xCD)）。 |
| 变通方法： | 使用较小的图像进行仿真。 |
| 票号： | 6822 |
| 概括： | 仿真仅支持小于 2 GB 的图像 |
|---|---|
| 描述： | 在仿真期间，任何图像的内部缓冲区大小都限制为 2 GB。对于大于 2 GB 的图像仿真，仿真将停止并显示错误消息。 |
| 变通方法： | 使用小于 2 GB 的图像进行仿真。 |
| 票号： | 240989 |
| 概括： | 加载到仿真探测器查看器中的 RGB 图像可能会保存为单色图像（8 位） |
|---|---|
| 描述： | 在仿真探测器查看器中，跨颜色通道包含相同值的 RGB 图像将保存为单色图像（即 8 位图像），而不是 24 位图像。 |
| 变通方法： | 如果要保留通道，请以 BMP 文件格式保存图像。 |
| 票号： | 266977 |
| 概括： | VisualApplets 可能会在某些特定类型的 TIF 图像仿真期间崩溃 |
|---|---|
| 描述： | VisualApplets 可能会在某些特定类型的 .tif 图像仿真期间崩溃。 |
| 变通方法： | 请使用其他图像工具重新保存 .tif 图像。或者，将 VisualApplets 更新至 3.8.0 或更高版本，该问题已在这些版本中得到修复。 |
| 票号： | 368717 |
Xilinx#
| 概括： | 使用 Vivado 构建 imaFlex 设计可能会在 Optimize 步骤中失败 |
|---|---|
| 描述： | 有时，使用 Vivado 构建 imaFlex 设计会在 Optimize 步骤中失败。再次运行构建过程可以解决此问题。 |
| 变通方法： | 再次运行构建过程。使构建目录的路径尽可能短。您可以在 System Settings 对话框中的 Global Build 类别 > 设置 Path for building applets 中显式设置构建目录。 |
| 票号： | 341870 |
| 概括： | Xilinx ISE 构建工具链不支持Windows 11 |
|---|---|
| 描述： | 这Xilinx ISE 构建工具链不支持Windows 11. 因此，建造VisualApplets 设计与Xilinx ISE。 |
| 变通方法： | 如果要为需要使用 Xilinx ISE 构建的平台构建 applet，请在 Windows 10 下安装 VisualApplets。如果您的目标平台由 Vivado 支持，请使用 Xilinx Vivado 构建 applet（Vivado 支持 Windows 11）。有关 Vivado 支持哪些平台的信息，请参阅系统要求主题。 在此论坛讨论中，您可以找到有关如何在 Windows 11 下安装 ISE 的一些破解方法（尽管官方并不支持此操作）。 |
| 票号： | 236990 |
| 概括： | VisualApplets 禁止使用 Vivado 2025.1 和 2025.2 为大多数平台构建设计 |
|---|---|
| 描述： | VisualApplets 不支持使用 Vivado 2025.1 和 2025.2 为大多数平台构建设计，因为使用这些版本创建的设计无法正常工作。 唯一的例外是 imaFlex 2 Dual 100 平台：此平台的设计必须使用 Vivado 2025.2 或更高版本构建。 |
| 变通方法： | 请使用 Vivado 2023.2 为除 imaFlex 2 Dual 100 之外的所有平台构建 applet。 |
| 票号： | 341684 / 348084 |
| 概括： | mE 5 的小程序marathon VCL 和 mE 5 marathon VCLx平台无法使用某些方式构建Xilinx Vivado 版本 |
|---|---|
| 描述： | 适用于 microEnable 5 平台的 Applets marathon VCL 和 microEnable 5 marathon VCLx 无法使用 2020.2 至 2021.1 之间的 Vivado 版本构建。 |
| 变通方法： | 这个问题已经通过以下方式解决： Xilinx Vivado 版本 2021.2。因此，为避免此问题，请使用 Vivado 版本 2021.2 或更高版本。 |
| 票号： | 217879 |
| 概括： | Xilinx Vivado 警告：构建 Applet 时需要注意 |
|---|---|
| 描述： | 当您使用以下方式构建小程序时Xilinx 使用 Vivado 工具时，您可能会收到严重警告（在 LinkDesign 构建步骤期间）。这些警告是由于 Vivado 工具内部存在问题引起的。 Xilinx 工具链。该问题已知。 Xilinx 修复工作正在进行中。例如： |
| 变通方法： | 忽略这些警告。对于在以下环境中创建的设计而言，此问题并不严重： VisualApplets 。 |
| 票号： | – |
Library Blob#
BlobDetector1D 操作员#
| 概括： | BlobDetector1D 逐行模式仿真期间可能会丢失数据 |
|---|---|
| 描述： | 当 BlobDetector1D 算子在逐行模式下使用时，如果下游算子引入了背压（例如在使用 SplitLine 算子时），仿真可能会在算子输出端丢失数据。此问题仅限于仿真，不会影响生成的硬件设计的行为。 |
| 变通方法： | 请在硬件上验证设计的行为。或者，将 VisualApplets 更新至 3.8.0 或更高版本，该问题已在这些版本中得到修复。 |
| 票号： | 364374 |
Blob_Analysis_1D 操作员#
| 概括： | 即： Blob_Analysis_1D 算子将 object size exceeds maximum 标志设置得不符合预期 |
|---|---|
| 描述： | 如果一个对象由于超过定义的最大尺寸而被截断， max_object_height_bits 参数，对应的 object size exceeds maximum 该标志位设置在被截断的对象中，而不是在前面的对象中。 |
| 变通方法： | 使用新的 BlobDetector1D 改为使用运算符。此问题已在新运算符中得到解决。 |
| 票号： | 9685 |
| 概括： | 即： Blob_Analysis_1D 算子未设置 label overflow 标志 |
|---|---|
| 描述： | 即： label overflow 表示所有标签均已使用且当前对象无法被标记的标志永远不会设置。 |
| 变通方法： | 使用新的 BlobDetector1D 改为使用运算符。此问题已在新运算符中得到解决。 |
| 票号： | 9691 |
| 概括： | 即： Blob_Analysis_1D 算子每行允许少于定义值的 20 个标签 |
|---|---|
| 描述： | 可用标签的数量由以下因素定义： Label_bits 参数减少了 20 个标签。例如，如果 Label_bits 设置为 5，则只有 12 (2^5 - 20) 个标签可用，而不是预期的 32 (2^5)。 |
| 变通方法： | 使用新的 BlobDetector1D 改为使用运算符。此问题已在新运算符中得到解决。 |
| 票号： | 9688 |
| 概括： | 仿真 Blob_Analysis_1D 算子与硬件行为不一致 |
|---|---|
| 描述： | 硬件和软件中对象特征输出的顺序可能不同。这是因为硬件输出取决于数据的时序，而时序是无法模拟的。 VisualApplets此外，FlushI 输入与图像数据输入是异步的，因此可能无法以真实的方式模拟完成输出帧。 |
| 变通方法： | 使用新的 BlobDetector1D 改为使用运算符。此问题已在新运算符中得到解决。 |
| 票号： | 7709 |
Library Color#
| 概括： | 某些颜色转换无法按预期工作 |
|---|---|
| 描述： | 运营商 彩色 使用该库时应谨慎：某些颜色转换的结果可能与用户预期不符：
|
| 变通方法： | 暂无可用绕过方法。 |
| 票号： | – |
ColorTransform 操作员#
| 概括： | 负变换系数的局限性 |
|---|---|
| 描述： | 即： ColorTransform 运算符仅在输入格式为有符号或系数为静态的情况下支持负变换系数。 |
| 变通方法： | 暂无可用绕过方法。 |
| 票号： | 251344 |
BAYER5x5Linear 操作员#
| 概括： | VisualApplets 中的资源估计 BAYER5x5Linear 与 Xilinx 中的估计不同 |
|---|---|
| 描述： | BAYER5x5Linear在某些情况下，资源估算VisualApplets 对于此运算符（在 FPGA Resource Usage 对话框）可能与显示的估计值有所不同Xilinx 布局布线后的工具。 |
| 变通方法： | 暂无可用绕过方法。 |
| 票号： | 6426 |
Library Compression#
JPEG_Encoder 操作员#
| 概括： | 的输出传输 JPEG_Encoder 算子启动时间早于实际图像数据传输 |
|---|---|
| 描述： | 算子：为了优化其图像吞吐量（带宽），该算子在激活标头生成后就会立即输出标头——甚至在图像数据到达算子输入端之前。这样，标头数据的传输就不会中断图像数据的传输，因为标头是提前传输的。这种做法的缺点是算子的输出传输启动时间早于实际图像数据传输。在特定情况下，这可能会引起异常： 如果您正在使用 SourceSelector 操作员紧随其后 JPEG_Encoder： SourceSelector 操作员一旦收到帧头数据，就会立即注册一个部分处理的帧。因此，如果 SourceSelector 已切换到从……获取图像数据 JPEG_Encoder, SourceSelector 无法切换到任何其他源，因为它始终检测到一个未完成的帧。此外，当启用标头生成且 SourceSelector 从另一个来源切换到 JPEG_Encoder 通道中，第一幅图像丢失。 |
| 变通方法： | 暂无可用绕过方法。 |
| 票号： | – |
Library Filter#
FIRKernelNxM 操作员#
| 概括： | FIRKernelNxM 算子可能会导致处理错误 |
|---|---|
| 描述： | 即： FIRKernelNxM 如果 EdgeHandling 参数设为常量、列数 > 2*Parallelism、kernel columns 为偶数且 Parallelism > 1，则算子可能会导致处理错误。该错误可在图像左边界监测到，此时帧内 kernel 位置使用了错误的像素数据。 |
| 变通方法： | 暂无可用绕过方法。 |
| 票号： | 2939 |
图书馆硬件平台#
CoFCamera 算子（仅限 imaFlex 2 Dual 100）#
| 概括： | 对于使用两个 CoFCamera 模块 |
|---|---|
| 描述： | 的 imaFlex 2 Dual 100 设计，DRC2 会报告常规网表生成错误 CoFCamera 当在 imaFlex 2 Dual 100 设计中使用两个 |
| 变通方法： | 模块时，DRC2 可能会报告常规网表生成错误。该设计仍然可以构建，但所生成的硬件设计可能无法正常工作。 |
| 票号： | 366304 |
触发运算符#
| 概括： | 触发算子可能会在触发输出线上产生毛刺 |
|---|---|
| 描述： | 在将小程序加载到帧捕获器时，初始化阶段触发运算符可能会在触发输出线上引起尖峰。 |
| 变通方法： | 暂无可用绕过方法。 |
| 票号： | – |
ImageBufferMultiRoiDyn 操作员#
| 概括： | 小图像的时序错误 |
|---|---|
| 描述： | 即： ImageBufferMultiRoiDyn 如果输入图像非常小，算子可能会导致时序错误。 |
| 变通方法： | 暂无可用绕过方法。 |
| 票号： | – |
Library Memory#
| 概括： | 请将 VisualApplets 更新至 3.8.0 或更高版本，该问题已在这些版本中得到修复。 |
|---|---|
| 描述： | 在 mE6 硬件平台上，启用 WritePriority 模式会降低缓冲区算子的吞吐量 WritePriority Memory Library 中的缓冲区算子模式会降低可实现的最高数据吞吐量。该模式使用效率较低的 DRAM 访问仲裁策略，从而导致整体接口性能下降。 |
| 变通方法： | 禁用 WritePriority 除非应用程序需要，否则请使用该模式。 |
| 票号： | 366936 |
基于 LUT 的算子#
| 概括： | 从文本文件导入的大整数值可能会精度受损 |
|---|---|
| 描述： | 当从文本文件将包含 53 位以上的整数值导入到整数字段参数中时，某些最低有效位可能会丢失。因此，导入的值可能会被四舍五入，并可能与文件中指定的值不同。这可能会影响基于 LUT 的算子以及其他支持导入整数值的算子，但仅在 VisualApplets 中发生。在运行时，这些值会被正确加载。 |
| 变通方法： | 确保导入的整数值不超过 53 位。或者，将 VisualApplets 更新到 3.8.0 或更高版本，该问题已在这些版本中得到修复。 |
| 票号： | 363933 |
LineBuffer imaFlex 2 Dual 100 上的算子#
| 概括： | LineBuffer 算子在 imaFlex 2 Dual 100 上可能会表现出较低的吞吐量 |
|---|---|
| 描述： | 在 imaFlex 2 Dual 100 硬件平台上， LineBuffer 算子可能会根据输入数据流的时序特征表现出性能下降。在最坏情况下，可实现的最高带宽可能会下降多达 50%。 |
| 变通方法： | 在 LineBuffer 算子上游插入足够大的 FIFO，以吸收输入流中的时序变化。 |
| 票号： | 366936 |