Intel® Acceleration Stack用户指南: Intel FPGA Programmable Acceleration Card N3000

下载 PDF
ID 683040
日期 8/17/2020
Public
文档目录
文档目录 x
1. 关于本文档 2. 系统要求 3. 硬件安装 4. 安装OPAE软件 5. OPAE工具 6. 样例测试：本地环回(Native Loopback) 7. 安装Intel XL710驱动程序 8. 配置以太网接口 9. 使用Data Plane Development Kit (DPDK)测试网络环回 10. 正常关机 11. 单粒子翻转(Single Event Upset (SEU)) 12. Intel Acceleration Stack用户指南： Intel® FPGA PAC N3000的文档修订历史 A. 故障排除 B. 通过BMC的Production版本和 Intel® Arria® 10映像对 Intel® FPGA PAC N3000进行升级 C. 配置4.19 Kernel D. fpgabist样例输出
1. 关于本文档 x
1.1. 略缩语列表
2. 系统要求 x
2.1. 冷却需求
3. 硬件安装 x
3.1. 安装 Intel® FPGA PAC N3000
4. 安装OPAE软件 x
4.1. 安装其他软件包 4.2. 安装发布软件包(Release Package) 4.3. 识别 Intel® FPGA PAC N3000上的 Intel® MAX® 10版本
4.2. 安装发布软件包(Release Package) x
4.2.1. 删除之前的OPAE软件包 4.2.2. 安装Acceleration Stack for Runtime 4.2.3. 安装Acceleration Stack for Development 4.2.4. 验证OPAE安装 4.2.5. 安装配置文件
4.3. 识别 Intel® FPGA PAC N3000上的 Intel® MAX® 10版本 x
4.3.1. FPGA出厂映像概述
5. OPAE工具 x
5.1. 使用fpgasupdate 5.2. 使用fpgainfo 5.3. 使用fpgabist测试PCIe和外部存储器 5.4. 使用fpgadiag测试网络环回
7. 安装Intel XL710驱动程序 x
7.1. 更新Intel XL710固件
8. 配置以太网接口 x
8.1. 修改接口Maximum Transmission Unit (MTU)大小 8.2. 设置前向纠错(FEC)模式 8.3. Ethernet暂停流控制(Ethernet Pause Flow Control) 8.4. 获取链路状态和统计信息
9. 使用Data Plane Development Kit (DPDK)测试网络环回 x
9.1. 使用外部流量生成器进行测试 9.2. 使用数据包生成器进行测试 9.3. DPDK中的故障排除 9.4. 从DPDK还原为OPAE
10. 正常关机 x
10.1. 背景 10.2. 使用OPAE 10.3. 使用DPDK
11. 单粒子翻转(Single Event Upset (SEU)) x
11.1. SEU的OPAE处理 11.2. SEU的DPDK处理
A. 故障排除 x
A.1. 如果OPAE安装验证失败，如何手动安装OPAE？
B. 通过BMC的Production版本和 Intel® Arria® 10映像对 Intel® FPGA PAC N3000进行升级 x
B.1. 从1.1 Beta升级到产品(Production)版本 B.2. 从1.1 Alpha-2或者更早版本升级到产品(Production)版本
B.1. 从1.1 Beta升级到产品(Production)版本 x
B.1.1. 编程的根条目哈希(Root Entry Hash Programmed) B.1.2. 未编程的根条目哈希(Root Entry Hash Programmed)
D. fpgabist样例输出 x
D.1. 2x2x25G配置 D.2. 8x10G配置
1. 关于本文档
2. 系统要求
3. 硬件安装
4. 安装OPAE软件
5. OPAE工具
6. 样例测试：本地环回(Native Loopback)
7. 安装Intel XL710驱动程序
8. 配置以太网接口
9. 使用Data Plane Development Kit (DPDK)测试网络环回
10. 正常关机
11. 单粒子翻转(Single Event Upset (SEU))
12. Intel Acceleration Stack用户指南： Intel® FPGA PAC N3000的文档修订历史
A. 故障排除
B. 通过BMC的Production版本和 Intel® Arria® 10映像对 Intel® FPGA PAC N3000进行升级
C. 配置4.19 Kernel
D. fpgabist样例输出

11.2. SEU的DPDK处理

当出现SEU错误时，在DPDK IFPGA Rawdev驱动程序(支持FPGA管理)中生成一个中断。中断处理程序在文件$RTE_SDK/drivers/raw/ifpga/ifpga_rawdev.c中定义为： 
static void
fme_interrupt_handler(void *param)
{
        struct opae_manager *mgr = (struct opae_manager *)param;
        IFPGA_RAWDEV_PMD_INFO("%s interrupt occurred\n", __func__);
        fme_err_handle_error0(mgr);
        fme_err_handle_nonfaterror(mgr);
        fme_err_handle_catfatal_error(mgr);
}

函数fme_err_handle_catfatal_error(mgr)通过rte_panic()功能调用引起恐慌来处理SEU错误。此中断处理程序的实现作为参考代码提供，可以自定义。

当发生SEU事件时，使用以下命令在运行DPDK应用程序时会收到一个恐慌(panic)消息： 
$ sudo ./x86_64-native-linuxapp-gcc/app/testpmd -l 0,1,2,3,4,5,6,7 -n 4 \
--vdev 'ifpga_rawdev_cfg0,ifpga=15:00.0,port=0' -- -i --no-numa
图 25. 恐慌消息(Panic Message)
要从由参考SEU事件中断处理程序引起的SEU恐慌中恢复，请执行以下步骤：
  1. 从vfio驱动程序解除绑定：
    sudo rmmod vfio-pci
  2. 重新绑定到OPAE驱动程序：
    modprobe intel-fpga-pci
echo 0000:BB:DD.F > /sys/bus/pci/drivers/intel-fpga-pci/bind
  3. 重新配置FPGA：
    1. 解压缩N3000_supplemental_files.zip，此zip文件作为Acceleration Stack Installer的一部分提供：
      $ unzip N3000_supplemental_files.zip 
      $ cd N3000_supplemental_files/
    2. 查找PCIe Root Port：
      $ chmod +x find_RP.sh
      样例输出：
      0000:ae:00.0
0000:af:00.0
0000:b0:09.0
0000:b2:00.0 -> intel-fpga-dev.0
      列表中的第一个条目是PCIe Root端口。最后一个条目是 Intel® FPGA PAC N3000。
    3. 记录RP AER值：
      $ sudo setpci -s ae:00.0 ECAP_AER+0x08.L
00210000
      $ sudo setpci -s ae:00.0 ECAP_AER+0x14.L
000031c1
      注： AER值可能与上述响应不同。
    4. 禁止AER:
      $ sudo setpci -s <RP BDF> ECAP_AER+0x08.L=0xffffffff
      $ sudo setpci -s <RP BDF> ECAP_AER+0x14.L=0xffffffff
    5. 触发重配置FPGA：
      $ sudo rsu fpga b2:00.0
    6. 使能AER，使用从步骤3b得到的值：
      $ sudo setpci -s <RP BDF> ECAP_AER+0x08.L=0x00210000
      $ sudo setpci -s <RP BDF> ECAP_AER+0x14.L=0x000031c1
  4. 安装vfio-pci驱动程序。
    $ sudo modprobe vfio-pci
  5. 将所有端口绑定到vfio-pci驱动程序，重新启动DPDK应用程序。
二级标题