Intel® Acceleration Stack User Guide: Intel FPGA Programmable Acceleration Card N3000

Download PDF
ID 683040
Date 6/14/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. OPAE Tools 6. Sample Test: Native Loopback 7. Installing the Intel XL710 Driver 8. Configuring Ethernet Interfaces 9. Testing Network Loopback Using Data Plane Development Kit (DPDK) 10. Graceful Shutdown 11. Single Event Upset (SEU) 12. Document Revision History for Intel Acceleration Stack User Guide: Intel® FPGA PAC N3000 A. Troubleshooting B. Upgrade your Intel® FPGA PAC N3000 with Production Version of BMC and Intel® Arria® 10 Image C. Configure the 4.19 Kernel D. fpgabist Sample Output
1. About this Document x
1.1. Acronym List
2. System Requirements x
2.1. Cooling Requirements
3. Hardware Installation x
3.1. Installing the Intel® FPGA PAC N3000
4. Installing the OPAE Software x
4.1. Install Additional Packages 4.2. Install the Release Package 4.3. Identify the Intel® MAX® 10 Version on your Intel® FPGA PAC N3000
4.2. Install the Release Package x
4.2.1. Remove Previous OPAE Packages 4.2.2. Install the Acceleration Stack for Runtime 4.2.3. Install the Acceleration Stack for Development 4.2.4. Verify the OPAE Installation 4.2.5. Install the Configuration Files
4.3. Identify the Intel® MAX® 10 Version on your Intel® FPGA PAC N3000 x
4.3.1. FPGA Factory Image Overview
5. OPAE Tools x
5.1. Using fpgasupdate 5.2. Using fpgainfo 5.3. Test PCIe and External Memories with fpgabist 5.4. Test Network Loopback using fpgadiag
7. Installing the Intel XL710 Driver x
7.1. Updating the Intel XL710 Firmware
8. Configuring Ethernet Interfaces x
8.1. Modifying the Interface Maximum Transmission Unit (MTU) Size 8.2. Setting Forward Error Correction (FEC) Mode 8.3. Ethernet Pause Flow Control 8.4. Get Link Status and Statistics
9. Testing Network Loopback Using Data Plane Development Kit (DPDK) x
9.1. Test Using an External Traffic Generator 9.2. Test Using a Packet Generator 9.3. Troubleshooting in DPDK 9.4. Revert Back from DPDK to OPAE
10. Graceful Shutdown x
10.1. Background 10.2. Using OPAE 10.3. Using DPDK
11. Single Event Upset (SEU) x
11.1. OPAE Handling of SEU 11.2. DPDK Handling of SEU
A. Troubleshooting x
A.1. If OPAE installation verification fails, how to install OPAE manually?
B. Upgrade your Intel® FPGA PAC N3000 with Production Version of BMC and Intel® Arria® 10 Image x
B.1. Upgrading from 1.1 Beta to Production Version B.2. Upgrading from 1.1 Alpha-2 or Older to Production Version
B.1. Upgrading from 1.1 Beta to Production Version x
B.1.1. Root Entry Hash Programmed B.1.2. Root Entry Hash Not Programmed
D. fpgabist Sample Output x
D.1. For 2x2x25G Configuration D.2. For 8x10G Configuration
1. About this Document
2. System Requirements
3. Hardware Installation
4. Installing the OPAE Software
5. OPAE Tools
6. Sample Test: Native Loopback
7. Installing the Intel XL710 Driver
8. Configuring Ethernet Interfaces
9. Testing Network Loopback Using Data Plane Development Kit (DPDK)
10. Graceful Shutdown
11. Single Event Upset (SEU)
12. Document Revision History for Intel Acceleration Stack User Guide: Intel® FPGA PAC N3000
A. Troubleshooting
B. Upgrade your Intel® FPGA PAC N3000 with Production Version of BMC and Intel® Arria® 10 Image
C. Configure the 4.19 Kernel
D. fpgabist Sample Output

4.2.3. Install the Acceleration Stack for Development

  1. Download, extract, and change permission for the DEV installer:
    $ tar xvzf n3000_ias_1_1_pv_dev_installer.tar.gz

    $ cd n3000_ias_1_1_pv_dev_installer
    $ chmod +x  n3000-1.3.6-dev-setup.sh
  2. Run the script:
    $ sudo ./n3000-1.3.6-dev-setup.sh -y --owner <user[:group]>
    The --owner argument allows you to change the ownership of directories to a given user. Running interactively without the -y option is not supported. For example: 
    $ sudo ./n3000-1.3.6-dev-setup.sh -y --owner john:john
    The installation will take approximately 20 minutes to complete.
    Sample output: 
    Running setup
Beginning installation
Processing group "OPAE Software"
Analyzing dependencies...
Analyzing packages to install...
error running: ['yum', 'info', 'opae-intel-fpga-driver.x86_64']
error running: ['yum', 'info', 'opae.admin.noarch']
error running: ['yum', 'info', 'opae-libs.x86_64']
error running: ['yum', 'info', 'opae-tools.x86_64']
error running: ['yum', 'info', 'opae-tools-extra.x86_64']
error running: ['yum', 'info', 'opae-devel.x86_64']
        Installing OPAE Software packages...
                opae-intel-fpga-driver-2.0.1-6.x86_64.rpm
                opae.admin-1.0.2-3.noarch.rpm
                opae-libs-1.3.6-4.x86_64.rpm
                opae-tools-1.3.6-4.x86_64.rpm
                opae-tools-extra-1.3.6-4.x86_64.rpm
                opae-devel-1.3.6-4.x86_64.rpm
Processing group "OPAE PACSign"
Analyzing dependencies...
Analyzing packages to install...
error running: ['yum', 'info', 'opae.pac_sign.x86_64']
        Installing OPAE PACSign packages...
                opae.pac_sign-1.0.2-3.x86_64.rpm
Extracting opae-1.3.6-4.tar.gz
Extracting pac_n3000_rtl_1.3.6.tar.gz
Installing main Quartus package: QuartusProSetup-19.2.0.57-linux.run
                Installing update: quartus-19.2-0.01vc-linux.run
Source /home/<user>/inteldevstack/bin/init_env.sh to setup your environment.
Changing ownership on /home/<user>/inteldevstack
Installation done

    The message error running: [ 'yum' , …] in the above output is expected and can be ignored.

  3. Add the Intel® Quartus® Prime development tool to the path. This is required for AFU compilation:
    $ source /home/<username>/inteldevstack/bin/init_env.sh
    Adding /home/<username>/inteldevstack/intelFPGA_pro/quartus/bin to PATH
Adding /home/<username>/inteldevstack/intelFPGA_pro/nios2eds/bin/gnu/H-x86_64-pc-linux-gnu/bin to PATH
Adding /home/<username>/inteldevstack/bin to PATH
  4. Verify Intel® Quartus® Prime installation by bringing up Intel® Quartus® Prime GUI and verifying the version and IP licenses:
    $ quartus
    1. Click Help > About Quartus Prime to verify Intel® Quartus® Prime version:
      Figure 9.  Intel® Quartus® Prime Version
      If patch .01vc is not installed, then verify that init_env.sh ran successfully.
    2. Click Tools > License Setup to verify IP licenses.
      Figure 10. IP Licenses
Level Two Title