Intel® FPGA SDK for OpenCL™: Stratix® V Network Reference Platform Porting Guide

ID 683645
Date 11/06/2017
Document Table of Contents

2.8. Integrating an OpenCL Kernel

After you establish host communication and connect the external memory, test the FPGA programming process from kernel creation to program execution.
  1. Perform the steps outlined in INTELFPGAOCLSDKROOT/board/custom_platform_toolkit/tests/README.txt file to build the hardware configuration file from the INTELFPGAOCLSDKROOT/board/custom_platform_toolkit/tests/boardtest/ kernel source file.
    The environment variable INTELFPGAOCLSDKROOT points to the location of the Intel® FPGA SDK for OpenCL™ installation.
  2. Program your FPGA device with the boardtest.aocx Intel® FPGA SDK for OpenCL™ Offline Compiler executable file and reboot your machine.
  3. Remove the early-exit modification in the version_id_test function in the <your_custom_platform_name>/source/host/mmd/acl_pcie_device.cpp file that you implemented when you established communication between the board and the host interface.
  4. Invoke the aocl diagnose <device_name> command, where <device_name> is the string you define in your Custom Platform to identify each board.
    By default, <device_name> is the acl number (for example, acl0 to acl31) that corresponds to your FPGA device. In this case, invoke the aocl diagnose acl0 command.
  5. Build the boardtest host application. The .sln file for Windows and the Makefile for Linux are available in the INTELFPGAOCLSDKROOT/board/custom_platform_toolkit/tests/boardtest directory.
    Attention: You must modify the .sln file to link it against the MMD library in your Custom Platform.
  6. Set the environment variable CL_CONTEXT_COMPILER_MODE_INTELFPGA to a value of 3.
    For more information on this environment variable, refer to Troubleshooting.