AN 807: Configuring the Intel® Arria® 10 GX FPGA Development Kit for the Intel® FPGA SDK for OpenCL™

ID 683446
Date 2/14/2020
Public

Installing the OpenCL Runtime Driver

After your Intel® Arria® 10 GX FPGA Development Kit board is initialized for use with the Intel® FPGA SDK for OpenCL™ Offline Compiler, install the OpenCL* runtime driver, and run a diagnostic.

To install the OpenCL* runtime driver and run a diagnostic test:

  1. Ensure that the AOCL_BOARD_PACKAGE_ROOT environment variable points to where you have the a10_ref board support package (BSP).
  2. On Linux host systems, set the LD_LIBRARY_PATH environment variable as follows:
    export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:$INTELFPGAOCLSDKROOT/host/linux64/lib:$AOCL_BOARD_PACKAGE_ROOT/linux64/lib
  3. Install the OpenCL* runtime driver by running the following command with root or administrator privileges:
    aocl install

    The command should produce output like the following example output:

    aocl install: Running install from /tools/aclboardpkg/altera_a10pciedk/16.0/linux64/libexec
    Using kernel source files from  /lib/modules/2.6.32-358.el6.x86_64/build
    Building driver for BSP with name a10_ref
    make: Entering directory `/usr/src/kernels/2.6.32-358.el6.x86_64'
      CC [M]  /tmp/opencl_driver_x6GjWS/aclpci_queue.o
      CC [M]  /tmp/opencl_driver_x6GjWS/aclpci.o
      CC [M]  /tmp/opencl_driver_x6GjWS/aclpci_fileio.o
      CC [M]  /tmp/opencl_driver_x6GjWS/aclpci_dma.o
      CC [M]  /tmp/opencl_driver_x6GjWS/aclpci_pr.o
      CC [M]  /tmp/opencl_driver_x6GjWS/aclpci_cmd.o
      LD [M]  /tmp/opencl_driver_x6GjWS/aclpci_a10_ref_drv.o
      Building modules, stage 2.
      MODPOST 1 modules
      CC      /tmp/opencl_driver_x6GjWS/aclpci_a10_ref_drv.mod.o
      LD [M]  /tmp/opencl_driver_x6GjWS/aclpci_a10_ref_drv.ko.unsigned
      NO SIGN [M] /tmp/opencl_driver_x6GjWS/aclpci_a10_ref_drv.ko
    make: Leaving directory `/usr/src/kernels/2.6.32-358.el6.x86_64'
    
    CAUTION:
    The aocl install command may fail in Ubuntu* 16.04, kernel 4.14 or newer version because of a problem with the installed PCIe* drivers. Refer to The aocl install command fails due to a problem with PCIe drivers for solution.