Intel® FPGA Add-On for oneAPI Base Toolkit Release Notes

Version: 2022.2   Last Updated: 04/13/2022

Where To Find the Component

Visit the Intel® FPGA Add-On for the oneAPI Base Toolkit website to download the toolkit.

The Intel® FPGA Add-On for oneAPI Base Toolkit is a specialized component intended to be used in conjunction with the Intel® oneAPI DPC++/C++ Compiler that is part of the Intel® oneAPI Base Toolkit (Base Kit). Installation of both the base toolkit and this add-on is required to work through the hardware compile stage of the FPGA design flow.

NOTE: This add-on is not required for emulation or report generation stages of the FPGA development flow. You can complete them with just the Intel® oneAPI Base Toolkit.

New in This Release

In the 2022.2 release, added support for Intel® custom platforms with Intel® Quartus® Prime software version 21.4.

DEPRECATION NOTICE: oneAPI 2022.2 is the last release to support a newer version of custom platform addons. The add-ons will be deprecated in a future release.

Disclaimer

Use the Intel® FPGA Add-on for oneAPI Base Toolkit with the following:

Supported Hardware and Operating System

See Intel® FPGA Add-On for oneAPI Base Toolkit System Requirements.

Compatibility

The Intel® FPGA Add-on for the oneAPI Base Toolkit 2022.2 version is compatible with the Intel® oneAPI Base Toolkit 2022.2 version.

Bugs Fixed

  • ​​Fixed an issue with the Linux Custom Platforms add-on packages with Intel® Quartus® Prime Pro Edition software versions 20.4 and 21.1 where the module files did not successfully set up the environment.
  • Fixed an issue with FPGA Add-on for Custom Platforms using Intel® Quartus® Prime Pro 21.3 software, which could not be installed seamlessly through the Intel® oneAPI Base Toolkit installer on Linux systems. 

Known Issues

  • If you are using the Intel® FPGA Add-on for Intel® Custom Platforms installer on Windows*, ensure that the Board Support Package (BSP) provided to you by your vendor is not calling the adjust_plls.tcl script that is provided as part of the Intel® oneAPI DPC++/C++ Compiler. Calling this script results in compilation errors due to the space in the install path. If your BSP does call this script, please contact your board vendor for alternatives.
  • In the Windows FPGA add-on packages, the uninstall script might sometimes remain in the intelfpgadpcpp folder upon uninstallation. You can safely delete the file manually once the uninstall process is completed.
  • When using the YUM installer on Linux systems to install the Custom Platforms FPGA add-ons using the .rpm files, upon uninstallation, the latest symlink folder continues to exist and you must remove it manually.
  • The FPGA Add-on for Custom Platforms using Intel® Quartus® Prime Pro 21.2 software does not include the Questa* simulation software. As a workaround, you must download and install the Questa*-Intel® FPGA Editon or Questa*-Intel® FPGA Starter Edition software separately from the FPGA Software Download Center and set up the environment for the FPGA simulation flow. For comprehensive instructions, see Evaluate Your Kernel Through Simulation topic in the Intel® oneAPI Programming Guide
  • When installing any FPGA add-on .rpm files on a RHEL 7/CentOS 7 system, you might encounter an error as shown in the following example for FPGA Add-on for Custom Platforms using Intel® Quartus® Prime Pro 20.4 software:
    Error downloading packages:
    intel-oneapi-intelfpgadpcpp-custom-platforms-quartus20.4-2021.3.0-1.x86_64: [Errno 256] No more mirrors to try.

    If you still want to install the add-ons using .rpm files on that system, as a workaround, use wget or curl to first download the add-on .rpm files, and then install them with yum locally. For example:
    wget https://yum.repos.intel.com/oneapi/intel-oneapi-intelfpgadpcpp-custom-platforms-quartus20.4-2021.3.0-1.x86_64.rpm
    wget https://yum.repos.intel.com/oneapi/intel-oneapi-intelfpgadpcpp-custom-platforms-quartus20.4-part2-2021.3.0-1.x86_64.rpm
    yum install ./intel-oneapi-intelfpgadpcpp-custom-platforms-quartus20.4-2021.3.0-1.x86_64.rpm ./intel-oneapi-intelfpgadpcpp-custom-platforms-quartus20.4-part2-2021.3.0-1.x86_64.rpm
  • After installing the Windows FPGA add-on for custom platforms using Intel Quartus software 19.4 or 20.2, you might encounter the following error: 
    ERROR: Can't load library: <install_dir>\oneapi\intelfpgadpcpp\latest\quartusprimepro\<19.4/20.2>\quartus\bin64\fitter_fdrgn.dll. The operating system reports the following error: The specified module could not be found.
    To resolve this issue on the Windows system, follow the instructions provided in Internal Error: Sub-system: ATCL, File: /quartus/ccl/atcl/atcl_root.cpp. Do note that the workaround mentioned in the article works on Windows 10 system.

 

Note: For Intel® oneAPI DPC++/C++ Compiler related issues, refer to Intel® oneAPI DPC++/C++ Compiler Release Notes.

Code Samples

Download FPGA design examples and tutorials from the oneAPI-Samples git repository.

Previous oneAPI Releases

References

Refer to the following guides for additional information:

Notices and Disclaimers

Intel® technologies may require enabled hardware, software, or service activation.

No product or component can be absolutely secure.

Your costs and results may vary.

© Intel Corporation. Intel, the Intel logo, and other Intel marks are trademarks of Intel Corporation or its subsidiaries. Other names and brands may be claimed as the property of others.

No license (express or implied, by estoppel or otherwise) to any intellectual property rights is granted by this document.

The products described may contain design defects or errors known as errata, which may cause the product to deviate from published specifications. Currently, characterized errata are available on request.

Intel disclaims all express and implied warranties, including without limitation, the implied warranties of merchantability, fitness for a particular purpose, and non-infringement, as well as any warranty arising from a course of performance, course of dealing, or usage in trade.

Product and Performance Information

1

Performance varies by use, configuration and other factors. Learn more at www.Intel.com/PerformanceIndex.