5. Running FPGA Diagnostics
This section presents instructions on how to run the FPGA diagnostics by using the
fpgabist
utility. You can run the diagnostic test, provided with the Acceleration Stack
Runtime/Development package, to ensure the board interface components (PCIe +
DMA) are working according to the use model. The current AFUs accepted are
nlb_mode_3
and
dma_afu
, running
fpgadiag
and
fpga_dma_test
tests,
respectively.
1. Configure the number of system hugepages the FPGA fpgadiag utility requires:
sudo sh -c "echo 20 > /sys/kernel/mm/hugepages/hugepages-\
2048kB/nr_hugepages"
Note: The above configuration is for a single card system. For multiple cards, set
the number of 2 MB hugepages to 20*<number_of_cards>.
2. Configure and run diagnostics with
nlb_mode_3
AFU image.
sudo fpgabist $OPAE_PLATFORM_ROOT/hw/samples/nlb_mode_3/bin/\
nlb_mode_3.gbs
The
fpgabist
tool accepts PCIe -B, -D, -F as arguments on multi card systems.
Sample output:
Running fpgadiag trput test...
Cachelines Read_Count Write_Count Cache_Rd_Hit Cache_Wr_Hit Cache_Rd_Miss
1024 670267380 670269108 0 0 0
Cache_Wr_Miss Eviction 'Clocks(@250 MHz)' Rd_Bandwidth Wr_Bandwidth
0 0 1250189534 12.762 GB/s 12.77 GB/s
VH0_Rd_Count VH0_Wr_Count VH1_Rd_Count VH1_Wr_Count
670267380 670269109 0 0
VL0_Rd_Count VL0_Wr_Count
0 0
Finished Executing NLB (FPGA DIAG)Tests
Built-in Self-Test Completed.
3. Configure two 1 GB hugepages for DMA AFU diagnostics.
sudo sh -c "echo 2 > /sys/kernel/mm/hugepages/hugepages-\
1048576kB/nr_hugepages"
4. Configure and run diagnostics with DMA AFU image.
sudo fpgabist $OPAE_PLATFORM_ROOT/hw/samples/dma_afu/bin/dma_afu.gbs
Sample output:
Running mode: dma_afu
Attempting Partial Reconfiguration:
Reading bitstream
UG-20202 | 2019.08.05
Intel Corporation. All rights reserved. Agilex, Altera, Arria, Cyclone, Enpirion, Intel, the Intel logo, MAX, Nios,
Quartus and Stratix words and logos are trademarks of Intel Corporation or its subsidiaries in the U.S. and/or
other countries. Intel warrants performance of its FPGA and semiconductor products to current specifications in
accordance with Intel's standard warranty, but reserves the right to make changes to any products and services
at any time without notice. Intel assumes no responsibility or liability arising out of the application or use of any
information, product, or service described herein except as expressly agreed to in writing by Intel. Intel
customers are advised to obtain the latest version of device specifications before relying on any published
information and before placing orders for products or services.
*Other names and brands may be claimed as the property of others.
