1.8.4 Specifying the Name of an Intel FPGA SDK for OpenCL Offline Compiler
Output File (-o <filename>)...................................................................... 97
1.8.5 Compiling a Kernel for a Specific FPGA Board (--board <board_name>)........... 97
1.8.6 Resolving Hardware Generation Fitting Errors during Kernel Compilation (--
high-effort)............................................................................................. 99
1.8.7 Defining Preprocessor Macros to Specify Kernel Parameters (-D
<macro_name>)..................................................................................... 99
1.8.8 Generating Compilation Progress Report (-v).............................................. 101
1.8.9 Displaying the Estimated Resource Usage Summary On-Screen (--report).......102
1.8.10 Suppressing Warning Messages from the Intel FPGA SDK for OpenCL
Offline Compiler (-W)..............................................................................102
1.8.11 Converting Warning Messages from the Intel FPGA SDK for OpenCL
Offline Compiler into Error Messages (-Werror)...........................................102
1.8.12 Removing Debug Data from Compiler Reports and Source Code from
the .aocx File (-g0).................................................................................103
1.8.13 Disabling Burst-Interleaving of Global Memory (--no-interleaving
<global_memory_type>)........................................................................ 103
1.8.14 Configuring Constant Memory Cache Size (--const-cache-bytes <N>)...........104
1.8.15 Relaxing the Order of Floating-Point Operations (--fp-relaxed)..................... 104
1.8.16 Reducing Floating-Point Rounding Operations (--fpc).................................. 105
1.9 Emulating and Debugging Your OpenCL Kernel........................................................ 105
1.9.1 Modifying Channels Kernel Code for Emulation............................................ 106
1.9.2 Compiling a Kernel for Emulation (-march=emulator)...................................107
1.9.3 Emulating Your OpenCL Kernel.................................................................. 109
1.9.4 Debugging Your OpenCL Kernel on Linux.................................................... 110
1.9.5 Limitations of the Intel FPGA SDK for OpenCL Emulator................................111
1.10 Reviewing Your Kernel's report.html File............................................................... 112
1.11 Profiling Your OpenCL Kernel...............................................................................112
1.11.1 Instrumenting the Kernel Pipeline with Performance Counters (--profile)....... 113
1.11.2 Launching the Intel FPGA SDK for OpenCL Profiler GUI (report)................... 113
1.12 Conclusion........................................................................................................113
1.13 Document Revision History................................................................................. 114
2 Intel FPGA SDK for OpenCL Advanced Features........................................................... 120
2.1 OpenCL Library...................................................................................................120
2.1.1 Understanding RTL Modules and the OpenCL Pipeline................................... 122
2.1.2 Packaging an OpenCL Helper Function File for an OpenCL Library...................131
2.1.3 Packaging an RTL Component for an OpenCL Library ...................................132
2.1.4 Verifying the RTL Modules........................................................................ 135
2.1.5 Packaging Multiple Object Files into a Library File.........................................135
2.1.6 Specifying an OpenCL Library when Compiling an OpenCL Kernel...................135
2.1.7 Using an OpenCL Library that Works with Simple Functions (Example 1).........136
2.1.8 Using an OpenCL Library that Works with External Memory (Example 2).........137
2.1.9 OpenCL Library Command-Line Options......................................................138
2.2 Kernel Attributes for Configuring Local Memory System............................................139
2.2.1 Restrictions on the Usage of Local Variable-Specific Kernel Attributes............. 141
2.3 Kernel Attributes for Reducing the Overhead on Hardware Usage...............................142
2.3.1 Hardware for Kernel Interface................................................................... 142
2.4 Kernel Replication Using the num_compute_units(X,Y,Z) Attribute............................. 145
2.4.1 Customization of Replicated Kernels Using the get_compute_id() Function...... 146
2.4.2 Using Channels with Kernel Copies............................................................ 147
2.5 Document Revision History...................................................................................148
Contents
Intel
®
FPGA SDK for OpenCL Programming Guide
3
