FPGA AI Suite: Version 2025.3 Release Notes

ID 772497
Date 9/29/2025
Public

5. Known Issues and Workarounds

FPGA AI Suite Version 2025.3 has the following known issues:

  • The FPGA AI Suite runtime is not compatible with Boost 1.88.0 or higher due to a change in how the Boost header files are structured. This incompatibility results in a compile-time error when you build the runtime.

    The highest supported version is Boost 1.85.0.

  • The hostless design examples that use JTAG for host-FPGA communication may see a "claim_service: Path cannot be found" error.
    The workaround is to reprogram the FPGA and lower the JTAG clock frequency to a lower frequency, such as 16 MHz, with a command similar to the following example command:
    jtagconfig --setparam 1 JtagClock 16M
  • The hostless DDR-free design example Quartus® Prime System Console script generates performance counter values that are displayed with a prefix that indicates that the value is a hexadecimal number. Despite the hexadecimal prefix, the value displayed is a decimal value.
  • Area estimates provided by the FPGA AI Suite compiler do not reflect changes in ALM counts when buffer sizes change.
  • Area estimates provided by the FPGA AI Suite (ALMs and M20Ks) underestimate the number of ALMs when the folding layout transform is used with a small CVEC (specifically, when the stride volume of the first convolution exceeds the CVEC length).
  • The JTAG-attach design example for the Agilex™ 3 FPGA C-Series Development Kit ( agx3c_jtag) might see a Quartus® Prime internal error during the PLL adjustment stage of the example design compilation. The signature appears as follows:
    Error (23098): One or more blocks are configured incorrectly and
    will not have the desired functionality. --BCM instance name: hvio_0_1
    As a workaround, compile the example design with a different seed.

Multilane Known Issues

  • Multilane exhibits low performance when used with DDR with a graph that includes residual connections.

OpenVINO Open Model Zoo Known Issues

The Open Model Zoo graph conversion tool (omz_converter) may encounter the following errors when converting certain TensorFlow models such as MobileNetV3:
ValueError: Invalid filepath extension for saving. Please add either 
a `.keras` extension for the native Keras format (recommended) or 
a `.h5` extension. 
Use `model.export(filepath)` if you want to export a SavedModel for 
use with TFLite/TFServing/etc.

For a workaround, refer to "Preparing a Model" in FPGA AI Suite Getting Started Guide .