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

7.1. Updating the Intel XL710 Firmware

To update the Intel XL710 firmware, follow these steps:
  1. Extract the N3000_XL710_firmware.zip which is provided as part of the Acceleration Stack installer:
    $ unzip N3000_XL710_firmware.zip
  2. Change directory:
    cd N3000_XL710_firmware/
    $ export N3000_XL710_FIRMWARE=$PWD
  3. The XL710 devices on each Intel® FPGA PAC N3000 are configured during board manufacturing to support either 10G or 25G operation. You cannot change the Ethernet network operation (10G or 25G). The XL710 PCIe device ID identifies whether 10G or 25G support is configured. The device ID for 25G is 0x0d58 and for 10G is 0x0cf8 respectively.

    Determine the XL710 device ID on your Intel® FPGA PAC N3000 using the following commands: 

    $ lspci -d :0d58
$ lspci -d :0cf8

    Based on the result, you will run nvmupdate with the appropriate config file.

  4. Download the NVM Update Package version 7.0: NVMUpdatePackage_700_Series.zip.
  5. Extract the nvmupdate64e tool:
    $ unzip NVMUpdatePackage_700_Series.zip
    $ cd  NVMUpdatePackage_700_Series/
    $ tar xvzf 700Series_NVMUpdatePackage_v7_00_Linux.tar.gz
    $ chmod +x 700Series/Linux_x64/nvmupdate64e
    $ sudo cp 700Series/Linux_x64/nvmupdate64e $N3000_XL710_FIRMWARE/
  6. Update the XL710:
    $ cd  $N3000_XL710_FIRMWARE/
    • For device ID: 0cf8
      $ sudo ./nvmupdate64e -c nvmupdate_10G_0CF8.cfg
    • For device ID: 0d58
      $ sudo ./nvmupdate64e -c nvmupdate_25G_0D58.cfg
  7. A menu lists all the XL710 devices and specifies which ones have updates (only 0D58 or 0CF8 device should show Update Available).
    1. Enter the Num values (use comma to separate multiple devices)
    2. Hit Enter and wait. An on-screen will prompt to hit any key when programming is completed.
    Figure 12. Step Illustration
  8. Power cycle the card using:
    $ sudo rsu bmcimg <FPGA PCIe B:D.F>
In the future, you can choose to upgrade to Intel XL710 Firmware 7.3 or later and install the corresponding i40e and iavf driver. The following steps are instructive and provide guidance on how to perform firmware updates for future versions:
  1. Check the version compatibility between firmware and driver. Refer to the Feature Support Matrix.
  2. Download the NVM Update package version 7.3 or above from download center.
  3. Extract the nvmupdate64e tool:
    $ unzip NVMUpdatePackage_*_Series.zip
$ cd  NVMUpdatePackage_*_Series/
$ tar xvzf 700Series_NVMUpdatePackage_*_Linux.tar.gz
$ chmod +x 700Series/Linux_x64/nvmupdate64e
$ cd 700Series/Linux_x64/
  4. Upgrade Intel XL710 firmware:
    # ./nvmupdate64e
    For more details, refer to the corresponding Readme file.
  5. The NVMUpdate utility returns an exit code of zero after successful completion of the update.
  6. Power cycle the card:
    $ sudo rsu bmcimg [PCIe B:D.F]
Note: You must not use firmware version 7.1 and 7.2, since these versions do not support Intel XL710 device ID 0d58.
Level Two Title