Installation Guide

  • 2021.4
  • 09/27/2021
  • Public Content

Install Intel® PAC Software Stack

This step applies only to the machine with a physical card or the runtime system. If you need an Intel® PAC with Intel Arria® 10 GX FPGA or an Intel® FPGA PAC D5005 (previously known as Intel® PAC for Intel® Stratix® 10 SX FPGA), contact the Intel sales representatives. Refer to www.intel.com/arria10pac and www.intel.com/d5005pac for more information.
For systems that are used for FPGA bitstream compilation and generation, execute the steps in Install the Software Stack Shipped with Intel® FPGA Add-on Package to install the correct version of the Intel PAC software stack.
Perform the following steps:
  1. Install one of the following software stacks on a system with a physical card:
    • If you are on a system with the Intel® PAC with Intel Arria® 10 GX FPGA, run the following command to install its software stack:
      aocl install intel_a10gx_pac
    • If you are on a system with the Intel® FPGA PAC D5005 (previously known as Intel® PAC for Intel® Stratix® 10 SX FPGA), run the following command to install its software stack:
      aocl install intel_s10sx_pac
    • Avoid running the
      aocl install
      command with secure boot enabled. Otherwise, an error is displayed since it is currently not supported.
    • The software stack for Intel® PAC with Intel Arria® 10 GX FPGA and Intel® FPGA PAC D5005 (previously known as Intel® PAC for Intel® Stratix® 10 SX FPGA) cannot be simultaneously installed on the same system. If you have installed one of them and want to install the other one, you must uninstall the former one first by either running the
      aocl uninstall intel_a10gx_pac
      or
      aocl uninstall intel_s10sx_pac
      command.
  2. Accept the installation prompts to proceed with installing the Intel® PAC software stack.
You must ensure that the FPGA development board is plugged into the system. Verify it using the
aocl diagnose
command. This diagnostic should be done only once per installation.
The installer attempts to install the prerequisite packages. If it fails to install a package (for example, due to version conflict or repository incomplete), you can either manually install that package or run the
sudo apt -fix-broken install
command.

(Caveat) Install the Correct Version of Intel® PAC Software Stack

Both Intel® oneAPI Base Toolkit and Intel® FPGA add-on contains Intel® PAC software stack. The software stack shipped with Intel® oneAPI Base Toolkit has limited functionalities, while the software stack shipped with Intel® FPGA add-on has full functionalities:
Supported Functionality
Intel® PAC Software Stack in Intel® oneAPI Base Toolkit
Intel® PAC Software Stack in Intel® FPGA Add-on
Emulation
Yes
Yes
Report generation
Yes
Yes
FPGA runtime
Yes
Yes
FPGA bitstream generation
No
Yes
Running steps to install the software stack before installing the FPGA Add-on causes the PAC software stack in Base Toolkit to be used by default. If you want to compile your FPGA design for deployment to FPGA hardware, you must make sure the Intel® PAC software stack shipped with Intel® FPGA add-on has been installed. You can check the installed software stack by running the
aoc -list-board-packages
command. The installed software stacks are listed in the Installed board packages section in the command output.
To uninstall a previously installed software stack, refer to the uninstall instructions.

Install the Software Stack Shipped with Intel® FPGA Add-on for oneAPI Base Toolkit Package

To install the software stack shipped with the Intel® FPGA Add-on for oneAPI Base Toolkit package, perform the following steps:
  1. Follow the steps in Install the Intel® FPGA Add-on for oneAPI Base Toolkit Package to install the FPGA add-on package.
  2. Setup the Intel® oneAPI base toolkit user environment by running the following commands:
    cd /opt/intel/oneapi or <you own oneAPI base toolkit installation path> source setvars.sh
  3. Install the Intel® PAC software stack.

Update the Firmware on your Intel® PAC

For Intel® PAC​ with Intel® Arria® 10 GX FPGA
If you used your Intel® PAC with Intel® Arria® 10 GX FPGA with the 2021.1-beta06 or a lower version of the Intel® FPGA Add-on in the past, you must update the firmware to the version compatible with the acceleration stack version 1.2.1 in order for the FPGA to work with the 2021.1-beta07 and later versions of the Intel® PAC software stack. The firmware update files are available in the Intel® FPGA Add-on for oneAPI Base Toolkit Package and the files are installed after you run the
aocl install
command.
Use the instructions in Identifying the Flash Image and BMC Firmware to identify your firmware version. If you need to update the firmware, use the instructions in Updating the FIM and BMC Firmware.
For Intel® FPGA PAC D5005
Each Acceleration Stack release has a unique FIM version. Use the
fpgainfo
command to identify the FIM (PR interface) and BMC firmware version:
sudo fpgainfo fme
If your Intel® FPGA PAC D5005 board firmware does not correspond to the most recent version for Acceleration Stack 2.0.1, then update your Intel® FPGA PAC D5005 board firmware from version 2.0 to 2.0.1 by performing these steps:
  1. Update the FPGA Interface Manager (FIM) and BMC firmware version using the following command.
    sudo fpgaotsu /usr/share/opae/d5005/fpgaotsu/base/otsu.json
    For more information, refer to Updating the FIM and BMC using the fpgaotsu.
  2. Power cycle the server for the updates to take effect.
    sudo fpgaotsu /usr/share/opae/d5005/fpgaotsu/base/otsu.json --verify --log-level debug
  3. Run the following command to confirm whether the output matches the desired FIM and BMC version:
    sudo fpgainfo fme

Product and Performance Information

1

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