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

ID 683030
Date 4/20/2022
Public
Document Table of Contents

3.8. Verifying Host Runtime Functionality via Emulation

Test the functionality of the host runtime by emulating an OpenCL™ design example using the Intel® FPGA SDK for OpenCL™ Emulator.
Attention: Emulation is a Linux-only optional step when setting up the SDK for use with Intel SoC FPGAs. Specifically, you must emulate your OpenCL kernel on a non-SoC FPGA board before executing your kernel on the SoC FPGA.
  1. Install a Custom or Reference Platform because emulation targets a specific FPGA board.
  2. Verify that the QUARTUS_ROOTDIR_OVERRIDE environment variable points to the Intel® Quartus® Prime Standard Edition software. Open a shell and then type echo $QUARTUS_ROOTDIR_OVERRIDE at the command prompt.

    If the path to the installation directory of the Intel® Quartus® Prime Standard Edition software is not returned, add it to the QUARTUS_ROOTDIR_OVERRIDE setting.

  3. Verify that the LD_LIBRARY_PATH environment variable setting includes the paths identified in Setting the Intel® FPGA SDK for OpenCL™ User Environment Variables for SoC FPGA. Open a shell and then type echo $LD_LIBRARY_PATH at the command prompt.

    If the returned path do not include $INTELFPGAOCLSDKROOT/host/linux64/lib, add it to the LD_LIBRARY_PATH setting.

  4. Verify that the LD_LIBRARY_PATH environment variable setting includes the paths identified in Setting the Intel® FPGA SDK for OpenCL™ User Environment Variables for SoC FPGA. Open a shell and then type echo $LD_LIBRARY_PATH at the command prompt.

    If the returned path do not include $INTELFPGAOCLSDKROOT/host/linux64/lib, add it to the LD_LIBRARY_PATH setting.

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 TMPDIR environment variable.