Installation Guide

  • 2021.4
  • 09/27/2021
  • Public Content

Install Intel® FPGA Add-on for oneAPI Base Toolkit Package

The Intel® FPGA Add-on for oneAPI Base Toolkit provides the necessary tools to compile an FPGA bitstream for deployment onto your chosen FPGA platform. It is intended for use in conjunction with the Intel® oneAPI DPC++/C++ Compiler, and cannot be used as a standalone component. Use the FPGA add-on to compile your FPGA design for deployment to FPGA hardware.
The Intel® FPGA Add-on for oneAPI Base Toolkit package includes the Intel® Quartus® Prime Pro Edition and the board support package (BSP) for its targeted FPGA platform. The Intel® Quartus® Prime Pro Edition contains the following:
  • Hybrid Placer & Global Router
  • Timing Analyzer
  • Physical Synthesis
  • Incremental Fitter Optimization
  • Interface Planner
  • Synthesis Engine
  • Platform Designer
  • Partial Reconfiguration
  • Block-Based (Hierarchical) Design
The FPGA add-on is not required for the emulation or report generation stages of the FPGA development flow. You can complete those stages with just the Intel® oneAPI DPC++/C++ Compiler.

Install the Intel® FPGA Add-on for Intel® PAC with Intel® Arria® 10 GX FPGA and Intel® FPGA PAC D5005

If you have the Intel® PAC with Intel® Arria® 10 GX FPGA (a10gx) or the Intel® FPGA PAC D5005 (s10sx) on the system and you want to compile your FPGA design for deployment to FPGA hardware, perform the following steps:
  1. Based on the FPGA add-on installation instructions in the Installation section, obtain the Intel® FPGA add-on for Intel® PAC with Intel® Arria® 10 GX FPGA and Intel® FPGA PAC D5005 package from the Toolkit Download page. See also Intel® FPGA Add-On for oneAPI Base Toolkit home page.
  2. Unzip the package using the following command:
    unzip intel-fpga-addon-for-oneapi-base-kit-for-a10gx-s10sx-linux.zip
  3. Run the
    setup.sh
    script in the add-on package directory, as follows:
    cd intel-fpga-addon-for-oneapi-base-kit-for-a10gx-s10sx-linux/l_intel_fpga_dpcpp_<version_number>-a10gx-s10sx sudo ./setup.sh
    To install the Intel FPGA add-on package, you need root or
    sudo
    privileges. Otherwise, the installer displays an error.
    If you do not have Internet access during installation, you should install prerequisite packages
    python-jsonschema
    on Ubuntu 18.04 LTS and
    python2-jsonschema
    on RHEL 7.0 before or after your installation of the Intel FPGA add-on package.
  4. Perform the following for the installer prompts:
    1. Accept the license agreement.
    2. Enter your Intel® oneAPI Base Toolkit installation path. The default path is
      /opt/intel/oneapi/.
    3. Choose to install the prerequisite packages.
  5. Close the existing shell.
  6. Open a new shell and set up the Intel® oneAPI Base Toolkit user environment.
    cd /opt/intel/oneapi or <you own oneAPI base toolkit installation path> source setvars.sh
  7. Diagnose the oneAPI Base Toolkit installation, including the FPGA installation and environment by running the
    sys_check.sh
    script:
    cd /opt/intel/oneapi or <your own oneAPI base toolkit installation path> ./sys_check.sh
    If this diagnostic passes, the script does not print anything. If it fails, the script prints why it failed.

Install the Intel® FPGA Add-on for Intel® Custom Platform

The following add-on options are supported for the Custom Platform:
  • FPGA Add-on for Custom Platforms using Intel® Quartus® Prime Pro 19.4 software
  • FPGA Add-on for Custom Platforms using Intel® Quartus® Prime Pro 20.2 software
  • FPGA Add-on for Custom Platforms using Intel® Quartus® Prime Pro 20.3 software
  • FPGA Add-on for Custom Platforms using Intel® Quartus® Prime Pro 20.4 software
  • FPGA Add-on for Custom Platforms using Intel® Quartus® Prime Pro 21.1 software
  • FPGA Add-on for Custom Platforms using Intel® Quartus® Prime Pro 21.2 software
If you are unsure about which software your Custom Platform supports, check with your board vendor.
If you have Intel® Custom Platform on the system and you want to compile your FPGA design for deployment to FPGA hardware, perform the following steps:
  1. Download the FPGA Add-on for Custom Platforms using Intel® Quartus® Prime Pro software package from the Toolkit Download page. See also Intel® FPGA Add-On for oneAPI Base Toolkit home page.
  2. Unzip the package using the following command:
    unzip intel-fpga-addon-for-oneapi-base-kit-for-custom-platforms-quartus[version_number]-linux.zip
  3. Run the
    setup.sh
    script in the add-on package directory using the following commands:
    cd intel-fpga-addon-for-oneapi-base-kit-for-custom-platforms-quartus[version_number]-linux cd l_intel_fpga_dpcpp_<version_number>-custom-platforms-quartus[version_number] sudo ./setup.sh
    To install the Intel FPGA add-on package, you need root or
    sudo
    privileges. Otherwise, the installer displays an error.
  4. Perform the following for the installer prompts:
    1. Accept the license agreement.
    2. Enter your Intel® oneAPI Base Toolkit installation path. By default, it is
      /opt/intel/oneapi/
      .
    3. Choose to install prerequisite packages.
  5. Visit the Intel® FPGA Development Tools website and download the following two packages: The Intel® FPGA add-on for oneAPI Base Toolkit for Custom Platforms does not include the software stack for a10_ref and s10_ref. So, you must obtain the following software stack manually:
    • Intel FPGA OpenCL Board Support Package for Arria 10 GX Linux x86-64 TGZ
    • Intel FPGA OpenCL Board Support Package for Stratix 10 GX Linux x86-64 TGZ
  6. Unzip the packages to one of the following locations:
    • /opt/intel/oneapi/intelfpgadpcpp/<version_number>/board
    • <your own oneAPI base toolkit installation path>/intelfpgadpcpp/<version_number>/board
  7. Close the existing shell.
  8. Open a new shell and set up the Intel® oneAPI Base Toolkit user environment.
    cd /opt/intel/oneapi or <you own oneAPI base toolkit installation path> source setvars.sh
  9. Diagnose the oneAPI Base Toolkit installation, including the FPGA installation and environment by running the
    sys_check.sh
    script:
    cd /opt/intel/oneapi or <your own oneAPI base toolkit installation path> ./sys_check.sh
    If this diagnostic passes, the script does not print anything. If it fails, the script prints why it failed.

Product and Performance Information

1

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