Intel® FPGA SDK for OpenCL™ Standard Edition: Getting Started Guide

Download PDF
ID 683678
Date 9/24/2018
Public
Document Table of Contents
Document Table of Contents x
1. Intel® FPGA SDK for OpenCL™ Standard Edition Getting Started Guide 2. Getting Started with the Intel® FPGA SDK for OpenCL™ Standard Edition for Windows 3. Getting Started with the Intel® FPGA SDK for OpenCL™ Standard Edition for Linux A. Document Revision History for Intel® FPGA SDK for OpenCL™ Standard Edition Getting Started Guide
1. Intel® FPGA SDK for OpenCL™ Standard Edition Getting Started Guide x
1.1. Prerequisites for the Intel® FPGA SDK for OpenCL™ Standard Edition 1.2. Contents of the Intel® FPGA SDK for OpenCL™ Standard Edition 1.3. Overview of the Intel® FPGA SDK for OpenCL™ Standard Edition Setup Process
2. Getting Started with the Intel® FPGA SDK for OpenCL™ Standard Edition for Windows x
2.1. Downloading the Intel® FPGA SDK for OpenCL™ Standard Edition 2.2. Installing the Intel® FPGA SDK for OpenCL™ 2.3. Setting the Intel® FPGA SDK for OpenCL™ Standard Edition User Environment Variables 2.4. Verifying Software Installation 2.5. Installing an FPGA Board 2.6. Verifying Host Runtime Functionality via Emulation 2.7. Creating the FPGA Hardware Configuration File of an OpenCL Kernel 2.8. Updating the Hardware Image on the FPGA 2.9. Executing an OpenCL Kernel on an FPGA 2.10. Uninstalling the Software 2.11. Uninstalling the FPGA Board
2.6. Verifying Host Runtime Functionality via Emulation x
2.6.1. Downloading an OpenCL Design Example 2.6.2. Compiling a Kernel for Emulation 2.6.3. Building the Host Application 2.6.4. Emulating Your OpenCL Kernel
2.8. Updating the Hardware Image on the FPGA x
2.8.1. Querying the Device Name of Your FPGA Board 2.8.2. Programming the Flash Memory of an FPGA
2.9. Executing an OpenCL Kernel on an FPGA x
2.9.1. Running the Host Application 2.9.2. Output from Successful Kernel Execution
3. Getting Started with the Intel® FPGA SDK for OpenCL™ Standard Edition for Linux x
3.1. Downloading the Intel® FPGA SDK for OpenCL™ Standard Edition 3.2. Installing the Intel® FPGA SDK for OpenCL™ 3.3. Setting the Intel® FPGA SDK for OpenCL™ Standard Edition User Environment Variables 3.4. Verifying Software Installation 3.5. Installing an FPGA Board 3.6. Verifying Host Runtime Functionality via Emulation 3.7. Creating the FPGA Hardware Configuration File of an OpenCL Kernel 3.8. Updating the Hardware Image on the FPGA 3.9. Executing an OpenCL Kernel on an FPGA 3.10. Uninstalling the Software 3.11. Uninstalling the FPGA Board
3.6. Verifying Host Runtime Functionality via Emulation x
3.6.1. Downloading an OpenCL Design Example 3.6.2. Compiling a Kernel for Emulation 3.6.3. Building the Host Application 3.6.4. Emulating Your OpenCL Kernel
3.8. Updating the Hardware Image on the FPGA x
3.8.1. Querying the Device Name of Your FPGA Board 3.8.2. Programming the Flash Memory of an FPGA
3.9. Executing an OpenCL Kernel on an FPGA x
3.9.1. Running the Host Application 3.9.2. Output from Successful Kernel Execution
1. Intel® FPGA SDK for OpenCL™ Standard Edition Getting Started Guide
2. Getting Started with the Intel® FPGA SDK for OpenCL™ Standard Edition for Windows
3. Getting Started with the Intel® FPGA SDK for OpenCL™ Standard Edition for Linux
A. Document Revision History for Intel® FPGA SDK for OpenCL™ Standard Edition Getting Started Guide

2.6.3. Building the Host Application

The <path_to_exm_opencl_hello_world_x64_windows_<version>>\hello_world\hello_world.sln file contains the host solution. After you open this .sln file in Microsoft Visual Studio, you can build the OpenCL™ host application in the main.cpp file.
If you are using Microsoft Visual Studio, you need the FCD, and the Installable Client Driver (ICD) from Khronos. To set up Microsoft Visual Studio with FCD and ICD, perform the following tasks prior to building the host application:
  1. Verify that FCD and ICD are set up correctly. You must set up FCD and ICD manually if invoking the aocl install <path_to_customplatform> utility command fails to set them up. For instructions, refer to the Accessing Custom Platform-Specific Functions and Linking to the ICD Loader Library on Windows sections of the Intel® FPGA SDK for OpenCL™ Standard Edition Programming Guide for more information.
  2. Link the host application to the OpenCL.lib library.
    1. Under the solution properties, select Configuration Properties > Linker > Input.
    2. In the Additional Dependencies field, enter OpenCL.lib.
    Attention: Because you are using FCD and ICD, do not link the host program to alteracl.lib or to your Custom Platform's MMD libraries directly.
To build the hello_world host application, perform the following tasks:
  1. Open the <path_to_exm_opencl_hello_world_x64_windows_<version>>\hello_world\hello_world.sln file in Microsoft Visual Studio.
  2. Verify that the build configuration is correct. The default build configuration is Debug, but you can use Release. You must select the appropriate option as the solution platform (for example, for x64 architecture, select x64).
  3. Build the solution by selecting the Build > Build Solution menu option, or by pressing the F7 key.
    The hello_world.exe executable will be in the <path_to_exm_opencl_hello_world_x64_windows_<version>>\hello_world\bin folder.
  4. Verify that the build is correct. An output ending with a message similar to the one shown below notifies you of a successful build: 
    1> Build succeeded.
1>
1> Time Elapsed 00:00:03:29
========== Build: 1 succeeded, 0 failed, 0 up-to-date, 0 skipped ==========
    Attention: You can ignore the LNK4009: PDB 'vc90.pdb' was not found with... warnings because they have no effect on the build. The compiler might issue this type of warning messages if you have built your Windows libraries using a previous version of Microsoft Visual Studio.
Related Information
Level Two Title