Intel® Acceleration Stack User Guide: Intel® FPGA Programmable Acceleration Card N3000-N/2

Download PDF
ID 683362
Date 11/01/2021
Public
Document Table of Contents
Document Table of Contents x
1. About this Document 2. System Requirements 3. Hardware Installation 4. Installing the OPAE Software 5. Identify the Intel® MAX® 10 BMC Version 6. Intel XL710 Driver Installation and Firmware Update 7. Updating the Retimer Firmware 8. OPAE Tools 9. Sample Test: Native Loopback 10. Configuring Ethernet Interfaces 11. Testing Network Loopback Using Data Plane Development Kit (DPDK) 12. Graceful Shutdown 13. Single Event Upset (SEU) 14. Document Revision History for Intel Acceleration Stack User Guide: Intel® FPGA PAC N3000-N/2 A. Troubleshooting B. fpgabist Sample Output
1. About this Document x
1.1. Acronym List
3. Hardware Installation x
3.1. Installing the Intel® FPGA PAC N3000-N/2
4. Installing the OPAE Software x
4.1. Install the Release Package
4.1. Install the Release Package x
4.1.1. Remove Previous OPAE Packages 4.1.2. Install the Acceleration Stack for Runtime 4.1.3. Install the Acceleration Stack for Development 4.1.4. Verify the OPAE Installation
4.1.2. Install the Acceleration Stack for Runtime x
4.1.2.1. For RHEL 4.1.2.2. For CentOS
4.1.2.2. For CentOS x
4.1.2.2.1. Download kernel 4.19 4.1.2.2.2. Build and Install kernel 4.19 4.1.2.2.3. Install OPAE in kernel 4.19
5. Identify the Intel® MAX® 10 BMC Version x
5.1. FPGA Factory Image Overview
6. Intel XL710 Driver Installation and Firmware Update x
6.1. Installing the Intel XL710 Driver 6.2. Updating the Intel XL710 Firmware
8. OPAE Tools x
8.1. Using fpgasupdate 8.2. Using fpgainfo 8.3. Test PCIe and External Memories with fpgabist 8.4. Test Network Loopback using fpgadiag
10. Configuring Ethernet Interfaces x
10.1. Modifying the Interface Maximum Transmission Unit (MTU) Size 10.2. Setting Forward Error Correction (FEC) Mode 10.3. Ethernet Pause Flow Control 10.4. Get Link Statistics 10.5. Ethernet Link Status
11. Testing Network Loopback Using Data Plane Development Kit (DPDK) x
11.1. Test Using an External Traffic Generator 11.2. Revert Back from DPDK to OPAE
12. Graceful Shutdown x
12.1. Using OPAE
13. Single Event Upset (SEU) x
13.1. OPAE Handling of SEU
A. Troubleshooting x
A.1. If OPAE installation verification fails, how to install OPAE manually?
B. fpgabist Sample Output x
B.1. For 4x25G Configuration B.2. For 2x2x25G Configuration
1. About this Document
2. System Requirements
3. Hardware Installation
4. Installing the OPAE Software
5. Identify the Intel® MAX® 10 BMC Version
6. Intel XL710 Driver Installation and Firmware Update
7. Updating the Retimer Firmware
8. OPAE Tools
9. Sample Test: Native Loopback
10. Configuring Ethernet Interfaces
11. Testing Network Loopback Using Data Plane Development Kit (DPDK)
12. Graceful Shutdown
13. Single Event Upset (SEU)
14. Document Revision History for Intel Acceleration Stack User Guide: Intel® FPGA PAC N3000-N/2
A. Troubleshooting
B. fpgabist Sample Output

A.1. If OPAE installation verification fails, how to install OPAE manually?

Before the OPAE installation, the dependency packages must be installed.
Table 11.  Dependency Packages
Distribution OPAE Package External Dependency Packages
Centos 7.6 opae-libs

uuid

json-c
opae-devel libuuid-devel
opae-tools-extra hwloc-libs
opae.admin

pciutils

python3

sysvinit-tools
opae-intel-fpga-driver

gcc

make

dkms

kernel-devel

kernel-headers
Compile OPAE SDK source code gcc-c++ cmake libxml2-devel json-c-devel hwloc-devel libpng12 rsync python3-devel python3-libs python3-sphinx python3-pip python3
RHEL 8.2 opae-libs

uuid

json-c
opae-devel libuuid-devel
opae-tools-extra hwloc-libs
opae.admin

pciutils

python3
opae-intel-fpga-driver

gcc

make

dkms

kernel-devel

kernel-headers
Compile OPAE SDK source code gcc-c++ cmake libxml2-devel json-c-devel hwloc-devel libpng12 rsync python3-devel python3-libs python3-sphinx python3-pip python3
  1. Download the Acceleration Stack runtime (rte) installer.
  2. Extract the OPAE packages:
    $ ./n3000-1.3.8-*-setup.sh extract
    $ cp opae-intel-fpga*.rpm n3000-1.3.8-rte/opae/
    $ cd n3000-1.3.8-rte/opae/
  3. Remove any previously installed OPAE:
    $ sudo yum remove opae*
  4. Manually install OPAE driver:
    $ sudo yum install opae-intel-fpga*.rpm
  5. Verify installation:
    $ lsmod | grep fpga
    ifpga_sec_mgr 16384 1 intel_max10
intel_fpga_fme 65536 0 
intel_fpga_afu 32768 0 
fpga_mgr_mod 16384 1 intel_fpga_fme
intel_fpga_pci 24576 2 intel_fpga_fme,intel_fpga_afu
    If the verification fails, analyze the message log of kernel installation for hints to fix the issue.
  6. Manually install OPAE libraries and tools:
    $ sudo yum install opae*.rpm
  7. Verify installation of OPAE libraries and tools:
    $ rpm -qa | grep opae

opae.admin-1.0.3-2.el8.noarch
opae-devel-1.3.7-5.el8.x86_64
opae-intel-fpga-driver-2.0.1-10.x86_64
opae-tools-1.3.7-5.el8.x86_64
opae.pac_sign-1.0.4-3.el8.x86_64
opae-tools-extra-1.3.7-5.el8.x86_64
opae-libs-1.3.7-5.el8.x86_64
Level Two Title