Intel® FPGA SDK for OpenCL™: Intel® Stratix® 10 GX FPGA Development Kit Reference Platform Porting Guide

ID 683809
Date 3/28/2022
Public
Document Table of Contents

3.5. Establishing Intel® Stratix® 10 Custom Platform Host Communication

After modifying and rebranding the Intel® Stratix® 10 GX FPGA Development Kit Reference Platform to your own Custom Platform, use the tools and utilities in your Custom Platform to establish communication between your FPGA accelerator board and your host application.
  1. Program your FPGA device with the <your_custom_platform>/hardware/<board_name>/base.sof file and then restart your system.
    The base.sof file is generated during base revision compile when integrating your Custom Platform with the Intel® FPGA SDK for OpenCL™ . Refer to the Integrating Your Intel® Stratix® 10 Custom Platform with the Intel® FPGA SDK for OpenCL™ section for more information.
  2. Confirm that your operating system recognizes a PCIe* device with your vendor and device IDs.
    • For Windows, open the Device Manager and verify that the correct device and IDs appear in the listed information.
    • For Linux, invoke the lspci command and verify that the correct device and IDs appear in the listed information.
  3. Set the environment variable AOCL_BOARD_PACKAGE_ROOT to point to your custom platform.
  4. Run the aocl install <path_to_customplatform> utility command to install the kernel driver on your machine.
  5. For Windows, set the PATH environment variable. For Linux, set the LD_LIBRARY_PATH environment variable.
    For more information about the settings for PATH and LD_LIBRARY_PATH, refer to Setting the Intel® FPGA SDK for OpenCL™ User Environment Variables in the Intel® FPGA SDK for OpenCL™ Getting Started Guide.
  6. Modify the version_id_test function in your <your_custom_platform>/source/host/mmd/acl_pcie_device.cpp MMD source code file to exit after reading from the version ID register. Rebuild the MMD software.
  7. Run the aocl diagnose utility command and confirm that the version ID register reads back the ID successfully. You may set the environment variables ACL_HAL_DEBUG and ACL_PCIE_DEBUG to a value of 1 to visualize the result of the diagnostic test on your terminal.