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.4. Emulating Your OpenCL Kernel

To emulate your OpenCL™ kernel, run the emulation .aocx file on the platform on which you build your kernel.

To emulate your kernel, perform the following steps:

  1. Run the utility command aocl linkflags to find out which libraries are necessary for building a host application. The software lists the libraries for both emulation and regular kernel compilation flows.
  2. Link your host application to the libraries returned by the aocl linkflags utility command.
  3. Move the hello_world_emulation.aocx file to the current working directory so that the host can locate it easily.
  4. To run the host application for emulation, first define the number of emulated devices by invoking the set CL_CONTEXT_EMULATOR_DEVICE_INTELFPGA=<number_of_devices> command and then run the host application.
    This command specifies the number of identical emulation devices that the Emulator needs to provide.
    Remember: When the environment variable CL_CONTEXT_EMULATOR_DEVICE_INTELFPGA is set, only the emulated devices are available, that is, access to all physical boards is disabled.
  5. After you run the host application, unset the CL_CONTEXT_EMULATOR_DEVICE_INTELFPGA variable by invoking the set CL_CONTEXT_EMULATOR_DEVICE_INTELFPGA= command.
Each invocation of the emulated kernel creates a shared library copy called <process_ID>-libkernel.so in a default temporary directory, where <process_ID> is a unique numerical value assigned to each emulation run. You may override the default directory by setting the TMP or TEMP environment variable.
Related Information
Level Two Title