Intel Acceleration Stack Quick Start Guide: Intel FPGA Programmable Acceleration Card D5005

Download PDF
ID 683394
Date 7/09/2021
Public
Document Table of Contents
Document Table of Contents x
1. About this Document 2. System Requirements and Release Installation 3. Installing the OPAE Software Package 4. Identify the FPGA Interface Manager (FIM) and BMC Firmware Version 5. Running FPGA Diagnostics 6. Running the OPAE in a Non-Virtualized Environment 7. Running the OPAE in a Virtualized Environment 8. Intel® Acceleration Stack Quick Start Guide: Intel® FPGA PAC D5005 Archives 9. Document Revision History for Intel® Acceleration Stack Quick Start Guide: Intel® FPGA PAC D5005 A. Handling Graceful Thermal Shutdown B. FPGA Device Access Permission C. Memlock Limit D. Troubleshooting Frequently Asked Questions (FAQ)
2. System Requirements and Release Installation x
2.1. Unpacking the Intel® FPGA PAC 2.2. Precautions for Hardware Installation 2.3. Hardware Installation 2.4. Setting Up the Host Machine Software
2.4. Setting Up the Host Machine Software x
2.4.1. Installing Red Hat* Enterprise Linux* version 7.6 2.4.2. Installing the Intel Acceleration Stack 2.4.3. Verifying the Installation
2.4.2. Installing the Intel Acceleration Stack x
2.4.2.1. Installing the Intel Acceleration Stack Runtime Package on the Host Machine 2.4.2.2. Installing the Intel Acceleration Stack Development Package on the Host Machine
3. Installing the OPAE Software Package x
3.1. Unpacking and Installing the Intel FPGA Driver and the OPAE Software Development Kit (SDK) 3.2. Installing the PACSign
4. Identify the FPGA Interface Manager (FIM) and BMC Firmware Version x
4.1. Updating the FIM and BMC
4.1. Updating the FIM and BMC x
4.1.1. Updating the FIM and BMC using the fpgaotsu
6. Running the OPAE in a Non-Virtualized Environment x
6.1. Loading an AFU Image into the FPGA 6.2. Running the Hello FPGA Example
7. Running the OPAE in a Virtualized Environment x
7.1. Updating Settings Required for VFs 7.2. Configuring the VF Port on the Host 7.3. Running the Hello FPGA Example on Virtual Machine 7.4. Disconnecting the VF from the VM and Reconnecting to the PF
D. Troubleshooting Frequently Asked Questions (FAQ) x
D.1. Why do I see a 'No Suitable slots found' message when running fpgasupdate on my AFU image? D.2. Which environment variables are required? D.3. What actions do I take if I see the error message 'Error enumerating resources: no driver available'? D.4. Command lsmod | grep fpga shows no output after installing the OPAE driver. How to successfully install the OPAE driver? D.5. Command rpm -qa | grep opae does not return the installed opae rpm package. How to successfully install the packages? D.6. What action do I take if the Intel® FPGA PAC D5005 does not show up on the PCIe bus? D.7. Why does the PCIe not detect the Intel® FPGA PAC D5005 card?
1. About this Document
2. System Requirements and Release Installation
3. Installing the OPAE Software Package
4. Identify the FPGA Interface Manager (FIM) and BMC Firmware Version
5. Running FPGA Diagnostics
6. Running the OPAE in a Non-Virtualized Environment
7. Running the OPAE in a Virtualized Environment
8. Intel® Acceleration Stack Quick Start Guide: Intel® FPGA PAC D5005 Archives
9. Document Revision History for Intel® Acceleration Stack Quick Start Guide: Intel® FPGA PAC D5005
A. Handling Graceful Thermal Shutdown
B. FPGA Device Access Permission
C. Memlock Limit
D. Troubleshooting Frequently Asked Questions (FAQ)

2.4.2.2. Installing the Intel Acceleration Stack Development Package on the Host Machine

The Python3 package is required to install one of the OPAE rpm. 
$ sudo yum install -y python36 python36-pip

Use this installation for Accelerator Functional Unit (AFU) development and compilation.

  1. Extract the runtime archive file: 
    tar xvf *dev_installer.tar.gz
  2. Change to the installation directory: 
    cd *dev_installer
  3. Run setup.sh. 
    ./setup.sh
  4. You are prompted with the following questions:
    1. Do you wish to continue to install the software (Acceleration Stack)?2
      Option Description
      Select Yes (y) If you want to continue using an unsupported platform.
      Select No (n) To set up the correct environment, refer to Installing Red Hat* Enterprise Linux* version 7.6.
    2. Do you wish to install the OPAE?
      Option Description
      Select Yes (y) If you have admin and network access.
      Select No (n) If you do not have admin and network access. After the installation, follow the manual steps listed in section Installing the OPAE Software Package.
    3. Do you wish to install the OPAE PACSign package?
      Note: This installation requires you have to admin and network access.
      Option Description
      Select Yes (y) If you plan on signing any bitstreams.
      Select No (n) If you do not intent to sign any bitstream. To manually install the OPAE PACSign package later, follow the steps listed in section Installing the PACSign.
  5. Accept the license.
  6. When you receive an installation directory prompt, you can specify an install directory. Otherwise, the installer uses the default directory at /home/<username>/inteldevstack to install the Intel Acceleration Stack.
  7. A second prompt displays to install the Intel OpenCL* SDK package and Intel® Quartus® Prime Pro Edition software. The default location for this installation is /opt/intelFPGA_pro.
    1. If you select OPAE as an installation option, you will be prompted for (y/d/N) permission to install the package opae-intel-fpga-driver.
    2. You need to enter the sudo password to install the OpenCL SDK package if you are not installing as an administrator.
  8. Run the initialization script to set the required environment variables, QUARTUS_HOME, OPAE_PLATFORM_ROOT, and other OpenCL variables. 
    source /home/<username>/inteldevstack/init_env.sh
    Note: Intel recommends that you run this initialization script after every login. You can also add this script to your shell initialization so that it automatically runs at every login.
  9. The OPAE_PLATFORM_ROOT environment variable is used as a relative path to executables and files throughout the document. The following command prints OPAE_PLATFORM_ROOT. 
    echo $OPAE_PLATFORM_ROOT
Related Information
2 This question is only asked if your OS and kernel version doesn't match the system requirements.
Level Two Title