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

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

2.6. Branding Your Intel® Arria® 10 Custom Platform

Modify the library, driver, and source files in the Intel® Arria® 10 GX FPGA Development Kit Reference Platform to reference your Intel® FPGA SDK for OpenCL™ Custom Platform.
  1. In the software development environment available with the a10_ref Reference Platform, replace all references of "a10_ref" with the name of your Custom Platform.
  2. Modify the PACKAGE_NAME and MMD_LIB_NAME fields in the <your_custom_platform>/source/Makefile.common file.
  3. Modify the name, linklib, and mmlibs elements in <your_custom_platform>/board_env.xml file to your custom MMD library name.
  4. In your Custom Platform, modify the following lines of code in the hw_pcie_constants.h file to include information of your Custom Platform:
    #define ACL_BOARD_PKG_NAME "a10_ref"
    #define ACL_VENDOR_NAME "Intel Corporation"
    #define ACL_BOARD_NAME "Arria 10 Reference Platform"

    For Windows, the hw_pcie_constants.h file is in the <your_custom_platform>\source_windows64\include folder. For Linux, the hw_pcie_constants.h file is in the <your_custom_platform>/linux64/driver directory.

    Note: The ACL_BOARD_PKG_NAME variable setting must match the name attribute of the board_env element that you specified in the board_env.xml file.
  5. Define the Device ID, Subsystem Vendor ID, Subsystem Device ID, and Revision ID, as defined in the Device Identification Registers for Intel® Arria® 10 PCIe Hard IP section.
    Note: The PCIe* IDs in the hw_pcie_constants.h file must match the parameters in the PCIe® controller hardware.
  6. Update your Custom Platform's board.qsys Platform Designer system and the hw_pcie_constants.h file with the IDs defined in step 5.
  7. For Windows, update the DeviceList fields in the <your_custom_platform>\windows64\driver\acl_boards_a10_ref.inf file to match your PCIe ID values and then rename the file to acl_board_<your_custom_platform>.inf.
    Note: The <your_custom_platform> string in acl_board_<your_custom_platform>.inf must match the string you specify for the name field in the board_env.xml file.
  8. Run make in the <your_custom_platform>/source directory to generate the driver.