OpenCL* on Intel® Programmable Acceleration Card with Intel® Arria® 10 GX FPGA Quick Start User Guide

Download PDF
ID 683831
Date 6/05/2020
Public
Document Table of Contents
Document Table of Contents x
1. About this Document 2. Setting Up the Host Machine 3. Running Diagnostics 4. OpenCL* Support for Multi-Card Systems 5. Running Samples 6. Compiling OpenCL* Kernels 7. Intel® PAC with Intel® Arria® 10 GX FPGA Security for OpenCL* Applications 8. OpenCL* on the Intel® PAC with Intel® Arria® 10 GX FPGA Quick Start User Guide Archives 9. Document Revision History for OpenCL* Quick Start User Guide Intel® Programmable Acceleration Card with Intel® Arria® 10 GX FPGA
1. About this Document x
1.1. Conventions 1.2. Acceleration Glossary 1.3. Acronyms
2. Setting Up the Host Machine x
2.1. Introduction 2.2. Initializing the Environment for OpenCL* with Intel Acceleration Stack 2.3. Initializing the Intel® Acceleration Stack for OpenCL* in a Virtualized Environment
2.1. Introduction x
2.1.1. Release Content
5. Running Samples x
5.1. Running Hello World 5.2. Running Vector Add
6. Compiling OpenCL* Kernels x
6.1. Checking Timing Results
1. About this Document
2. Setting Up the Host Machine
3. Running Diagnostics
4. OpenCL* Support for Multi-Card Systems
5. Running Samples
6. Compiling OpenCL* Kernels
7. Intel® PAC with Intel® Arria® 10 GX FPGA Security for OpenCL* Applications
8. OpenCL* on the Intel® PAC with Intel® Arria® 10 GX FPGA Quick Start User Guide Archives
9. Document Revision History for OpenCL* Quick Start User Guide Intel® Programmable Acceleration Card with Intel® Arria® 10 GX FPGA

6. Compiling OpenCL* Kernels

Before compiling an OpenCL* kernel, you must install the Intel® Acceleration Stack for Development.
  1. Set the user environment variable using one of the following commands: 
    source <DEV Install Path>/init_env.sh
  2. Ensure that the environment is setup with correct BSP using the following command: 
    aoc -list-boards
    Example sample output: 
    Board list:
pac_a10
Board Package: /home/username/inteldevstack/opencl_bsp
    Board list:
pac_s10_dc
Board Package: /tools/<username>/dcp_2_0_1_PV_RC2/inteldevstack/d5005_ias_2_0_1_b237/opencl/opencl_bspBoard list:
  3. Compile an OpenCL Kernel to an aocx using commands similar to the following: 
    cd $OPAE_PLATFROM_ROOT/opencl/exm_opencl_vector_add_x64_linux/vector_add

aoc device/vector_add.cl -o bin/vector_add.aocx -board pac_a10
    cd $OPAE_PLATFROM_ROOT/opencl/vector_add

aoc device/vector_add.cl -o bin/vector_add.aocx -board pac_s10_dc
  4. The security features of the Intel® PAC with Intel® Arria® 10 GX FPGA requires the signing of metadata in a bitstream even if you don't intend to use the security features of the card. If you try to program the aocx file as is generated after the compilation in the above step, the PACSign tool gives the following error message: 
    $ aocl program acl0 hello_world.aocx
aocl program: Running program from /home/DCPsupport/inteldevstack_1_2_1_pv/a10_gx_pac_ias_1_2_1_pv/opencl/opencl_bsp/linux64/libexec
libopae-c reconf.c:427:fpgaReconfigureSlot() **ERROR** : Failed to reconfigure bitstream: Input/output error
libopae-c reconf.c:450:fpgaReconfigureSlot() **ERROR** : PR incompatible bitstream error detected
Error writing bitstream to FPGA: reconfiguration error
Error programming device
aocl program: Program failed
  5. If you are in the development process or have a new Intel® PAC with Intel® Arria® 10 GX FPGA card with no root entry hash programmed to it, follow the instructions from this section Example: Creating an Unsigned .aocx File Using OpenSSL Manager to create an unsigned aocx file with only signing metadata.
  6. If you have Intel® PAC with Intel® Arria® 10 GX FPGA with the root entry hash programmed, follow the steps from section Creating the OpenCL Bitstream to create signed aocx file with your preferred method.
  7. After you follow the steps above, depending on the condition of your Intel® PAC with Intel® Arria® 10 GX FPGA, you should be able to successfully program the signed or unsigned aocx file by using the following command: 
    aocl program acl0 <unsigned_file.aocx>
Related Information
Level Two Title