Intel Acceleration Stack Quick Start Guide for Intel® Programmable Acceleration Card with Intel® Arria® 10 GX FPGA

Download PDF
ID 683633
Date 12/04/2020
Public
Document Table of Contents
Document Table of Contents x
1. About This Document 2. Introduction 3. Getting Started 4. Installing the OPAE Software Package 5. Identifying the Flash Image and BMC Firmware 6. Running FPGA Diagnostics 7. Running the OPAE in a Non-Virtualized Environment 8. Running the OPAE in a Virtualized Environment 9. Intel® Acceleration Stack Quick Start Guide for Intel® Programmable Acceleration Card with Intel® Arria® 10 GX FPGA Archives 10. Document Revision History for Intel® Acceleration Stack Quick Start Guide for Intel® Programmable Acceleration Card with Intel® Arria® 10 GX FPGA A. Updating the FIM and BMC Firmware B. Handling Graceful Thermal Shutdown C. FPGA Device Access Permission D. Memlock Limit E. Hugepage Settings F. Troubleshooting Frequently Asked Questions (FAQ) G. Documentation Available for the Intel® Acceleration Stack for Intel® Xeon® CPU with FPGAs 1.2.1 Release
1. About This Document x
1.1. Intended Audience 1.2. Acronym List 1.3. Acceleration Glossary
3. Getting Started x
3.1. Intel Acceleration Stack Hardware Features 3.2. System Requirements 3.3. Installing the Intel® PAC with Intel® Arria® 10 GX FPGA Card In the Host Machine 3.4. Installing the Intel Acceleration Stack
3.4. Installing the Intel Acceleration Stack x
3.4.1. Installing the Intel Acceleration Stack Runtime Package on the Host Machine 3.4.2. Installing the Intel Acceleration Stack Development Package on the Host Machine 3.4.3. Understanding the Extracted Intel® PAC with Intel® Arria® 10 GX FPGA Release Package
4. Installing the OPAE Software Package x
4.1. RHEL 7.6: Installing the OPAE Framework from Prebuilt Binaries (RPM) 4.2. Ubuntu: Installing the OPAE Framework from Prebuilt Binaries (deb) 4.3. (Optional) Building and Installing the OPAE Software from Source Code 4.4. Installing the OPAE PACSign
7. Running the OPAE in a Non-Virtualized Environment x
7.1. Loading an AFU Image into the FPGA 7.2. OPAE Sample Application Programs
7.2. OPAE Sample Application Programs x
7.2.1. Running the Hello FPGA Example
8. Running the OPAE in a Virtualized Environment x
8.1. Updating Settings Required for VFs 8.2. Configuring the VF Port on the Host 8.3. Running the Hello FPGA Example on Virtual Machine
8.3. Running the Hello FPGA Example on Virtual Machine x
8.3.1. Disconnecting the VF from the VM and Reconnecting to the PF
A. Updating the FIM and BMC Firmware x
A.1. Selecting the Correct Update Method
A.1. Selecting the Correct Update Method x
A.1.1. Updating FPGA Flash and BMC Firmware
F. Troubleshooting Frequently Asked Questions (FAQ) x
F.1. Why do I see a 'No Suitable slots found' message when running fpgaconf on my AFU image? F.2. How do I flash the FIM or program the AFU in a multicard system? F.3. Which environment variables are required? F.4. What actions do I take if I see the error message 'Error enumerating resources: no driver available'? F.5. Troubleshooting OPAE Installation on RHEL
1. About This Document
2. Introduction
3. Getting Started
4. Installing the OPAE Software Package
5. Identifying the Flash Image and BMC Firmware
6. Running FPGA Diagnostics
7. Running the OPAE in a Non-Virtualized Environment
8. Running the OPAE in a Virtualized Environment
9. Intel® Acceleration Stack Quick Start Guide for Intel® Programmable Acceleration Card with Intel® Arria® 10 GX FPGA Archives
10. Document Revision History for Intel® Acceleration Stack Quick Start Guide for Intel® Programmable Acceleration Card with Intel® Arria® 10 GX FPGA
A. Updating the FIM and BMC Firmware
B. Handling Graceful Thermal Shutdown
C. FPGA Device Access Permission
D. Memlock Limit
E. Hugepage Settings
F. Troubleshooting Frequently Asked Questions (FAQ)
G. Documentation Available for the Intel® Acceleration Stack for Intel® Xeon® CPU with FPGAs 1.2.1 Release

10. Document Revision History for Intel® Acceleration Stack Quick Start Guide for Intel® Programmable Acceleration Card with Intel® Arria® 10 GX FPGA

Document Version Intel® Quartus® Prime Version Changes
2020.12.04 1.2.1 (supported with Intel® Quartus® Prime Pro Edition 19.2) Corrected the package installation step in the Ubuntu: Installing the OPAE Framework from Prebuilt Binaries (deb) section
2020.10.09 1.2.1 (supported with Intel® Quartus® Prime Pro Edition 19.2)
  • Updated the sudo apt-get command that must be ran before installing and building the OPAE software in the Ubuntu: Installing the OPAE Framework from Prebuilt Binaries (deb).
  • Corrected the typo in rsu-09c4.json in the Updating FPGA Flash and BMC Firmware section.
2020.06.24 1.2.1 (supported with Intel® Quartus® Prime Pro Edition 19.2) Added a note about what to do if you receive an error message when trying to update the kernel source using a sudo yum install command.
2020.03.06 1.2.1 (supported with Intel® Quartus® Prime Pro Edition 19.2)
  • Updated tool versions
  • Updated download size for "Acceleration Stack for Development"
  • Updated the Intel® PAC with Intel® Arria® 10 GX FPGA 1.2.1 Directory Structure figure in section Understanding the Extracted Intel® PAC with Intel® Arria® 10 GX FPGA Release Package
  • Removed CentOS as a system requirement
  • Removed section Installing Required OS Packages and Components While Installing CentOS 7.4
  • Updated steps and output for sections:
    • RHEL 7.6 : Installing the OPAE Framework from Prebuilt Binaries (RPM)
    • Ubuntu: Installing the OPAE Framework from Prebuilt Binaries (deb)
    • Identifying the Flash Image and BMC Firmware
    • Running FPGA Diagnostics
    • Running the OPAE in a Non-Virtualized Environment
  • Updated the output for section Why do I see a "No Suitable slots found" message when running fpgaconf on my AFU image?
  • Updated Installing the Intel® PAC with Intel® Arria® 10 GX FPGA Card In the Host Machine
    • Added "Precautions for Hardware Installation"
    • Updated steps
  • Added new section Installing the PACSign
  • Added 1.2 version of the Intel® Acceleration Stack Quick Start Guide for Intel® Programmable Acceleration Card with Intel® Arria® 10 GX FPGA to section Intel® Acceleration Stack Quick Start Guide for Intel® Programmable Acceleration Card with Intel® Arria® 10 GX FPGA Archives.
  • Added security and authentication features:
    • Trusted Configuration Manager (TCM) and Bitstream Authentication IP (BIP) for secure updates
    • OPAE security tools:
      • FPGA one-time secure update (fpgaotsu)
      • FPGA secure update (fpgasupdate)
      • Super-RSU (super-rsu)
      • PACSign
2019.08.05 1.2 (supported with Intel® Quartus® Prime Pro Edition 17.1.1) Corrected a document title in appendix Documentation Available for the Intel® Acceleration Stack for Intel® Xeon® CPU with FPGAs 1.2 Release:

From HSSI User Guide for Intel Programmable Acceleration Card with Intel Arria 10 GX FPGA to Networking Interface for Open Programmable Acceleration Engine: Intel Programmable Acceleration Card with Intel Arria 10 GX FPGA.

2019.05.30 1.2 (supported with Intel® Quartus® Prime Pro Edition 17.1.1)
  • Updated steps under section:
    • Configuring the VF Port on the Host
    • Updating FPGA Flash and BMC Firmware
    • Troubleshooting OPAE Installation on CentOS
2019.03.08 1.2 (supported with Intel® Quartus® Prime Pro Edition 17.1.1) Added a note regarding use of pacd at the top of section Handling Graceful Thermal Shutdown.
2019.02.23 1.2 (supported with Intel® Quartus® Prime Pro Edition 17.1.1) Added a note regarding upgrading to the Intel® Acceleration Stack version 1.2 in the Correspondence Between Acceleration Stack, FIM, and OPAE Versions table in section Identify the Flash Image and BMC Firmware.
2019.02.06 1.2 (supported with Intel® Quartus® Prime Pro Edition 17.1.1)
  • Added a note about the init_env.sh script in the Installing the Intel® Acceleration Stack Runtime Package on the Host Machine and Intel® Acceleration Stack Development Package on the Host Machine.
  • Moved section Updating the Flash Image and BMC Firmware to an appendix.
  • Added a important note about BMC firmware version permissions after upgrading to version 26889.
  • Added section Troubleshooting Frequently Asked Questions (FAQ).
2018.12.04 1.2 (supported with Intel® Quartus® Prime Pro Edition 17.1.1)
  • Added the following sections:
    • Intel® Acceleration Stack Quick Start Guide for Intel® Programmable Acceleration Card with Intel® Arria® 10 GX FPGA Archives that contains the archived versions of this document.
    • Ubuntu: Installing the OPAE Framework from Prebuilt Binaries (deb)
    • Handling Graceful Thermal Shutdown
  • Removed section Updating the Board Management Controller (BMC) Configuration and Firmware.
2018.08.27 1.1 supported with Intel® Quartus® Prime Pro Edition 17.1.1) Added the following sections:
  • FPGA Device Access Permission
  • Memlock Unit
  • Hugepage Settings
2018.08.14 1.1 supported with Intel® Quartus® Prime Pro Edition 17.1.1) Made the following changes:
  • Changed a10_gx_pac_ias_1_1_pv_eth.pv to a10_gx_pac_ias_1_1_pv_eth.patch in Installing the Intel Acceleration Stack Runtime package on the Host Machine and Installing the Intel Acceleration Stack Development Package on the Host Machine
  • Corrected the OPAE Software Development Kit (SDK) version 1.1 .tar file names and Download sizes in Installing the Intel Acceleration Stack
2018.08.06 1.1 supported with Intel® Quartus® Prime Pro Edition 17.1.1) Initial release.
Level Two Title