Visible to Intel only — GUID: hpq1478091658090
Ixiasoft
1.1. Introduction to Custom Platforms
1.2. OpenCL System Architecture
1.3. Hierarchical Structure of the Intel® Arria® 10 GX FPGA Development Kit Reference Platform's Hardware
1.4. Intel® Quartus® Prime Software Revisions Describing the Custom Platform
1.5. Intel® FPGA SDK for OpenCL™ and User Environment Setup
1.6. Intel® Arria® 10 Custom Platform Project Setup and Customization Procedure
1.7. Intel® Arria® 10 Custom Platform Customization Example
1.8. Updating Your Custom Platform to Target a Different Device
1.9. Migrating the Custom Platform between Different Intel® Quartus® Prime Software Versions
1.10. Document Revision History for Compiling and Customizing an Intel® Arria® 10 Custom Platform for OpenCL*
1.7.1. Modifying the board.qsys File in the Custom Platform
1.7.2. Modifying the Kernel (freeze_wrapper.v and board_spec.xml)
1.7.3. Updating the Top-Level I/O Ring with the Modified board.qsys and freeze_wrapper.v Files
1.7.4. Updating the Original Custom Platform Directory with the New Custom Platform Modifications
1.7.5. Compilation Log Files
1.7.6. Analyzing the Results from Compilation
1.7.1.1. Opening an Existing Intel® Quartus® Prime Project and the board.qsys Platform Designer System Design
1.7.1.2. Adding the Avalon® -ST Single Clock FIFO Component into the Platform Designer System
1.7.1.3. Connecting the Avalon® -ST Single Clock FIFO Component's Exported Signals in the Top-Level Platform Designer System
1.7.2.1. Opening an Existing Intel® Quartus® Prime Project and the kernel_system.qsys Platform Designer System Design
1.7.2.2. Adding an Avalon® -ST Adapter Component into the Platform Designer System
1.7.2.3. Connecting the Avalon® -ST Adapter Component's Exported Signals in the Top-Level Platform Designer System
1.7.2.4. Modifying the board_spec.xml File
1.7.2.5. Modifying the freeze_wrapper.v File
Visible to Intel only — GUID: hpq1478091658090
Ixiasoft
1.6.3.1. Compiling a Kernel without Regenerating the Custom Platform
Step 1 in the Intel® Arria® 10 Custom Platform customization flow is to verify the functionality of the existing Reference Platform by compiling it with a simple OpenCL kernel but without regenerating the platform. Compiling the existing platform checks the platform’s setup and verifies that the Intel® FPGA SDK for OpenCL™ Offline Compiler works as expected. A main advantage to compiling a kernel without regenerating the Reference Platform is that it preserves placement and routing as well as timing, which saves compilation time.
Intel assumes that you have set up your Windows or Linux environment correctly to run the Intel® FPGA SDK for OpenCL™ Offline Compiler.
- Obtain the Intel® Arria® 10 GX FPGA Development Kit Reference Platform (for example, a10_ref_18.1_b222.zip) from your Intel representative.
- Unpack the Reference Platform and store it in a directory named <your_custom_platform> . For this example, <your_custom_platform> is a10gx_ref_18.1.
- Choose one of the board variants in the a10gx_ref_18.1/hardware directory as the basis of your design (for example, a10gx).
- Open the a10gx_ref_18.1/board_env.xml file in a text editor and perform the following tasks:
- Change the board name setting from a10_ref to a10gx_ref_18.1.
- Verify that the board default setting is a10gx_es3.
- Save and then close the board_env.xml file.
- Open the a10gx_ref_18.1/hardware/a10gx/board_spec.xml file in a text editor and perform the following tasks:
- Verify that the board name setting is a10gx_es3.
- Save and then close the board_spec.xml file.
- To set the AOCL_BOARD_PACKAGE_ROOT environment variable, at a command prompt, invoke the set AOCL_BOARD_PACKAGE_ROOT=<path to a10gx_ref_18.1> command, where a10gx_ref_18.1 is the new design directory.
- To test the environment, first invoke the aocl board-xml-test command to read the board_env.xml file and display the Custom Platform information on-screen.
- Invoke the aoc --list-boards command to display the board variants that are available in the a10gx_ref_18.1 Custom Platform.
Figure 4. Sample Output from the aocl board-xml-test and aoc --list-boards Commands
- To compile an OpenCL kernel without regenerating a10gx_ref_18.1, perform the following tasks:
- Download the Vector Addition design example from the OpenCL Design Examples page.
- Copy the vector_add.cl file to the project directory a10gx_ref_18.1.
- Invoke the aoc vector_add.cl –v --no-interleaving default command.
- After the compilation is completed, you can review the resulting files in the vector_add directory within your working directory.
- Refer to the Analyzing the Results from Compilation section to check the Fitter, Timing Analyzer reports and placement in the Floorplanner.
Related Information