OpenCL* Quick Start User Guide: Intel FPGA Programmable Acceleration Card D5005

ID 683324
Date 7/21/2020
Public

3. Running Diagnostics

Before running diagnostics, program the board with a pre-compiled OpenCL* bitstream (.aocx file). The following instructions use the hello_world kernel or you may use your own.

  1. Load hello_world OpenCL* kernel:
    aocl program acl0  $OPAE_PLATFORM_ROOT/opencl/hello_world.aocx
    Sample program output:
    aocl program: Running program from $OPAE_PLATFORM_ROOT/opencl/opencl_bsp \
    /linux64/libexec
    Program succeed.
  2. Run the simple diagnostic utility:
    aocl diagnose
    Sample diagnostic output:
    --------------------------------------------------------------------
    	BSP Diagnostics                                                     
    	--------------------------------------------------------------------
    	--------------------------------------------------------------------
    	Device Name:
    	acl0
    	
    	BSP Install Location:
    	/home/<username>/intelrtestack/d5005_ias_2_0_1_b237/opencl/opencl_bsp
    	
    	Vendor: Intel Corp
    	
    	Physical Dev Name   Status            Information
    	
    	pac_ec00001         Passed            Intel PAC Platform (pac_ec00001)
    	                                      PCIe 175:00.0
    	                                      FPGA temperature = 0 degrees C.
    	
    	DIAGNOSTIC_PASSED
    	--------------------------------------------------------------------
    	--------------------------
    ------------------------------------------------
    
  3. Run the advanced diagnostic:
    aocl diagnose acl0
    Sample advanced diagnostic output:
    --------------------------------------------------------------------
    	ICD System Diagnostics                                              
    	------------------------------------------------------------------
    	Using the following location for ICD installation: 
    	        /etc/OpenCL/vendors
    	Found 2 icd entry at that location:
    	        /etc/OpenCL/vendors/Altera.icd
    	        /etc/OpenCL/vendors/Intel_FPGA_SSG_Emulator.icd
    	the following OpenCL libraries are referenced in the icd files:
    	        libalteracl.so
    	        libintelocl.so
    	checking LD_LIBRARY_PATH for registered libraries:
    	        libalteracl.so was registered on the system at /home/<username>/opencl_rte/aclrte-linux64/host/linux64/lib
    	        WARNING: libintelocl.so NOT FOUND
    	        WARNING: libintelocl.so NOT FOUND
    	Using the following location for fcd installations:
    	        /opt/Intel/OpenCL/Boards
    	Found 1 fcd entry at that location:
    	        /opt/Intel/OpenCL/Boards/dcp_bsp.fcd
    	the following OpenCL libraries are referenced in the fcd files:
    	        /home/<username>/intelrtestack/d5005_ias_2_0_1_b237/opencl/opencl_bsp/linux64/lib/libintel_opae_mmd.so
    	checking LD_LIBRARY_PATH for registered libraries:
    	        /home/<username>/intelrtestack/d5005_ias_2_0_1_b237/opencl/opencl_bsp/linux64/lib/libintel_opae_mmd.so was registered on the system.
    	ERROR: OpenCL host failed
    	--------------------------------------------------------------------
    	ICD diagnostics FAILED                                              
    	--------------------------------------------------------------------
    	BSP Diagnostics                                                     
    	--------------------------------------------------------------------
    	Using platform: Intel(R) FPGA SDK for OpenCL(TM)
    	Using Device with name: pac_s10_dc : Intel PAC Platform (pac_ec00001)
    	Using Device from vendor: Intel Corp
    	clGetDeviceInfo CL_DEVICE_GLOBAL_MEM_SIZE = 34359737344
    	clGetDeviceInfo CL_DEVICE_MAX_MEM_ALLOC_SIZE = 34359737344
    	Allocated 34359737344 bytes
    	Actual maximum buffer size = 34359737344 bytes
    	Writing 32767 MB to global memory ...
    	Allocated 1073741824 Bytes host buffer for large transfers
    	Write speed: 6836.57 MB/s [6694.05 -> 7032.85]
    	Reading and verifying 32767 MB from global memory ...
    	Read speed: 4951.46 MB/s [4903.23 -> 4976.84]
    	Successfully wrote and readback 32767 MB buffer
    	
    	Transferring 262144 KBs in 512 512 KB blocks ... 3861.79 MB/s
    	Transferring 262144 KBs in 256 1024 KB blocks ... 4075.48 MB/s
    	Transferring 262144 KBs in 128 2048 KB blocks ... 4170.71 MB/s
    	Transferring 262144 KBs in 64 4096 KB blocks ... 4804.90 MB/s
    	Transferring 262144 KBs in 32 8192 KB blocks ... 5567.67 MB/s
    	Transferring 262144 KBs in 16 16384 KB blocks ... 6137.93 MB/s
    	Transferring 262144 KBs in 8 32768 KB blocks ... 6490.43 MB/s
    	Transferring 262144 KBs in 4 65536 KB blocks ... 6710.80 MB/s
    	Transferring 262144 KBs in 2 131072 KB blocks ... 6788.07 MB/s
    	Transferring 262144 KBs in 1 262144 KB blocks ... 6237.66 MB/s
    	
    	As a reference:
    	PCIe Gen1 peak speed: 250MB/s/lane
    	PCIe Gen2 peak speed: 500MB/s/lane
    	PCIe Gen3 peak speed: 985MB/s/lane
    	
    	Writing 262144 KBs with block size (in bytes) below:
    	
    	Block_Size Avg    Max    Min    End-End (MB/s)
    	  524288 2706.84 3113.33 1603.70 2116.14
    	 1048576 2837.03 3454.15 2195.74 2489.07
    	 2097152 3183.19 3640.58 2402.91 2996.62
    	 4194304 4231.66 4654.73 2741.47 4062.97
    	 8388608 5109.06 5567.67 3294.77 5015.90
    	16777216 5463.67 6137.93 3702.84 5398.52
    	33554432 5826.53 6490.43 4389.44 5795.64
    	67108864 6026.71 6710.80 4781.64 6008.43
    	134217728 6156.04 6788.07 5631.68 6148.34
    	268435456 6237.66 6237.66 6237.66 6237.66
    	
    	Reading 262144 KBs with block size (in bytes) below:
    	
    	Block_Size Avg    Max    Min    End-End (MB/s)
    	  524288 3356.58 3861.79 1903.24 2510.84
    	 1048576 3679.26 4075.48 2388.34 3079.56
    	 2097152 3941.15 4170.71 2715.18 3722.70
    	 4194304 4486.87 4804.90 3194.38 4301.79
    	 8388608 4586.92 4881.49 3468.64 4497.62
    	16777216 4635.61 4904.53 3499.35 4585.22
    	33554432 4826.01 4847.88 4741.90 4806.62
    	67108864 4823.91 4851.77 4754.91 4816.26
    	134217728 4788.47 4830.65 4747.01 4784.02
    	268435456 4794.40 4794.40 4794.40 4794.40
    	
    	Write top speed = 6788.07 MB/s
    	Read top speed = 4904.53 MB/s
    	Throughput = 5846.30 MB/s
    	
    	DIAGNOSTIC_PASSED