Intel FPGA SDK for Opencl Pro Edition: Programming Guide Send Feedback

Total Page:16

File Type:pdf, Size:1020Kb

Intel FPGA SDK for Opencl Pro Edition: Programming Guide Send Feedback Intel® FPGA SDK for OpenCL™ Pro Edition Programming Guide Updated for Intel® Quartus® Prime Design Suite: 21.2 Subscribe UG-OCL002 | 2021.06.23 Send Feedback Latest document on the web: PDF | HTML Contents Contents 1. Intel® FPGA SDK for OpenCL™ Overview......................................................................... 7 1.1. Intel FPGA SDK for OpenCL Pro Edition Programming Guide Prerequisites......................7 1.2. Intel FPGA SDK for OpenCL FPGA Programming Flow..................................................8 2. Intel FPGA SDK for OpenCL Offline Compiler Kernel Compilation Flows........................ 10 2.1. One-Step Compilation for Simple Kernels................................................................ 11 2.2. Multistep Intel FPGA SDK for OpenCL Pro Edition Design Flow.................................... 12 3. Obtaining General Information on Software, Compiler, and Custom Platform...............16 3.1. Displaying the Software Version (version)............................................................... 16 3.2. Displaying the Compiler Version (-version).............................................................. 16 3.3. Listing the Intel FPGA SDK for OpenCL Utility Command Options (help).......................17 3.3.1. Displaying Information on an Intel FPGA SDK for OpenCL Utility Command Option (help <command_option>)............................................................. 17 3.4. Listing the Intel FPGA SDK for OpenCL Offline Compiler Command Options (no argument, -help, or -h)......................................................................................17 3.5. Listing the Available FPGA Boards and Custom Platforms (-list-boards and -list- board-packages)...............................................................................................17 3.6. Displaying the Compilation Environment of an OpenCL Binary (env)........................... 18 4. Managing an FPGA Board.............................................................................................. 19 4.1. Installing an FPGA Board (install)...........................................................................20 4.2. Uninstalling an FPGA Board (uninstall).................................................................... 22 4.3. Querying the Device Name of Your FPGA Board (diagnose)........................................ 22 4.4. Running a Board Diagnostic Test (diagnose <device_name>).....................................23 4.5. Programming the FPGA Offline or without a Host (program <device_name>)............... 23 4.6. Programming the Flash Memory (flash <device_name>)........................................... 23 5. Structuring Your OpenCL Kernel................................................................................... 25 5.1. Guidelines for Naming the Kernel........................................................................... 25 5.2. Programming Strategies for Optimizing Data Processing Efficiency..............................26 5.2.1. Unrolling a Loop (unroll Pragma) ............................................................27 5.2.2. Disabling Pipelining of a Loop (disable_loop_pipelining Pragma) .......... 28 5.2.3. Coalescing Nested Loops...........................................................................29 5.2.4. Fusing Adjacent Loops (loop_fuse Pragma)...............................................30 5.2.5. Marking Loops to Prevent Automatic Fusion (nofusion Pragma)................... 32 5.2.6. Specifying a Loop Initiation interval (II)...................................................... 32 5.2.7. Loop Concurrency (max_concurrency Pragma) .........................................34 5.2.8. Loop Speculation (speculated_iterations Pragma) ............................... 35 5.2.9. Loop Interleaving Control (max_interleaving Pragma)..............................35 5.2.10. Floating Point Optimizations (fp contract and fp reassociate Pragma)................................................................................................. 37 5.2.11. Specifying Work-Group Sizes................................................................... 38 5.2.12. Specifying Number of Compute Units........................................................ 39 5.2.13. Specifying Number of SIMD Work-Items.................................................... 40 5.2.14. Specifying the private_copies Memory Attribute....................................41 5.2.15. Specifying the use_stall_enable_clusters Cluster-control Attribute ..... 42 5.3. Programming Strategies for Optimizing Pointer-to-Local Memory Size......................... 42 Intel FPGA SDK for OpenCL Pro Edition: Programming Guide Send Feedback 2 Contents 5.4. Implementing the Intel FPGA SDK for OpenCL Channels Extension............................. 43 5.4.1. Overview of the Intel FPGA SDK for OpenCL Channels Extension.................... 43 5.4.2. Channel Data Behavior............................................................................. 44 5.4.3. Multiple Work-Item Ordering for Channels................................................... 45 5.4.4. Restrictions in the Implementation of Intel FPGA SDK for OpenCL Channels Extension ................................................................................. 46 5.4.5. Enabling the Intel FPGA SDK for OpenCL Channels for OpenCL Kernel............. 48 5.5. Implementing OpenCL Pipes..................................................................................60 5.5.1. Overview of the OpenCL Pipe Functions.......................................................61 5.5.2. Pipe Data Behavior...................................................................................62 5.5.3. Multiple Work-Item Ordering for Pipes.........................................................62 5.5.4. Restrictions in OpenCL Pipes Implementation...............................................64 5.5.5. Enabling OpenCL Pipes for Kernels............................................................. 65 5.5.6. Direct Communication with Kernels via Host Pipes........................................ 75 5.6. Implementing Arbitrary Precision Integers...............................................................82 5.7. Using Predefined Preprocessor Macros in Conditional Compilation............................... 83 5.8. Declaring __constant Address Space Qualifiers........................................................ 83 5.9. Including Structure Data Types as Arguments in OpenCL Kernels................................84 5.9.1. Matching Data Layouts of Host and Kernel Structure Data Types.....................84 5.9.2. Disabling Insertion of Data Structure Padding ............................................. 86 5.9.3. Specifying the Alignment of a Struct...........................................................86 5.10. Inferring a Register............................................................................................ 87 5.10.1. Inferring a Shift Register......................................................................... 88 5.11. Enabling Double Precision Floating-Point Operations................................................89 5.12. Single-Cycle Floating-Point Accumulator for Single Work-Item Kernels.......................89 5.12.1. Programming Strategies for Inferring the Accumulator................................ 90 5.13. Integer Promotion Rules......................................................................................91 6. Designing Your Host Application................................................................................... 93 6.1. Host Programming Requirements........................................................................... 93 6.1.1. Host Machine Memory Requirements.......................................................... 93 6.1.2. Host Binary Requirement.......................................................................... 93 6.1.3. Multiple Host Threads............................................................................... 94 6.1.4. Out-of-order Command Queues................................................................. 94 6.1.5. Requirement for Multiple Command Queues to Execute Kernels Concurrently... 94 6.2. Allocating OpenCL Buffers for Manual Partitioning of Global Memory........................... 94 6.2.1. Partitioning Buffers Across Multiple Interfaces of the Same Memory Type.........95 6.2.2. Partitioning Buffers Across Different Memory Types (Heterogeneous Memory).. 96 6.2.3. Creating a Pipe Object in Your Host Application............................................ 98 6.2.4. Enabling All Global Memory....................................................................... 98 6.3. Triggering Collection Profiling Data During Kernel Execution.......................................99 6.3.1. Profiling Autorun Kernels ........................................................................ 101 6.3.2. Profile Data Acquisition........................................................................... 103 6.4. Accessing Custom Platform-Specific Functions........................................................103 6.5. Modifying Host Program for Structure Parameter Conversion.................................... 104 6.6. Managing Host Application...................................................................................105 6.6.1. Displaying Example Makefile Fragments (example-makefile or makefile)........105 6.6.2. Compiling and Linking Your Host Application.............................................. 106 6.6.3. Using OpenCL
Recommended publications
  • Nios II Custom Instruction User Guide
    Nios II Custom Instruction User Guide Subscribe UG-20286 | 2020.04.27 Send Feedback Latest document on the web: PDF | HTML Contents Contents 1. Nios II Custom Instruction Overview..............................................................................4 1.1. Custom Instruction Implementation......................................................................... 4 1.1.1. Custom Instruction Hardware Implementation............................................... 5 1.1.2. Custom Instruction Software Implementation................................................ 6 2. Custom Instruction Hardware Interface......................................................................... 7 2.1. Custom Instruction Types....................................................................................... 7 2.1.1. Combinational Custom Instructions.............................................................. 8 2.1.2. Multicycle Custom Instructions...................................................................10 2.1.3. Extended Custom Instructions................................................................... 11 2.1.4. Internal Register File Custom Instructions................................................... 13 2.1.5. External Interface Custom Instructions....................................................... 15 3. Custom Instruction Software Interface.........................................................................16 3.1. Custom Instruction Software Examples................................................................... 16
    [Show full text]
  • Intel Quartus Prime Pro Edition User Guide: Programmer Send Feedback
    Intel® Quartus® Prime Pro Edition User Guide Programmer Updated for Intel® Quartus® Prime Design Suite: 21.2 Subscribe UG-20134 | 2021.07.21 Send Feedback Latest document on the web: PDF | HTML Contents Contents 1. Intel® Quartus® Prime Programmer User Guide..............................................................4 1.1. Generating Primary Device Programming Files........................................................... 5 1.2. Generating Secondary Programming Files................................................................. 6 1.2.1. Generating Secondary Programming Files (Programming File Generator)........... 7 1.2.2. Generating Secondary Programming Files (Convert Programming File Dialog Box)............................................................................................. 11 1.3. Enabling Bitstream Security for Intel Stratix 10 Devices............................................ 18 1.3.1. Enabling Bitstream Authentication (Programming File Generator)................... 19 1.3.2. Specifying Additional Physical Security Settings (Programming File Generator).............................................................................................. 21 1.3.3. Enabling Bitstream Encryption (Programming File Generator).........................22 1.4. Enabling Bitstream Encryption or Compression for Intel Arria 10 and Intel Cyclone 10 GX Devices.................................................................................................. 23 1.5. Generating Programming Files for Partial Reconfiguration.........................................
    [Show full text]
  • Introduction to Intel® FPGA IP Cores
    Introduction to Intel® FPGA IP Cores Updated for Intel® Quartus® Prime Design Suite: 20.3 Subscribe UG-01056 | 2020.11.09 Send Feedback Latest document on the web: PDF | HTML Contents Contents 1. Introduction to Intel® FPGA IP Cores..............................................................................3 1.1. IP Catalog and Parameter Editor.............................................................................. 4 1.1.1. The Parameter Editor................................................................................. 5 1.2. Installing and Licensing Intel FPGA IP Cores.............................................................. 5 1.2.1. Intel FPGA IP Evaluation Mode.....................................................................6 1.2.2. Checking the IP License Status.................................................................... 8 1.2.3. Intel FPGA IP Versioning............................................................................. 9 1.2.4. Adding IP to IP Catalog...............................................................................9 1.3. Best Practices for Intel FPGA IP..............................................................................10 1.4. IP General Settings.............................................................................................. 11 1.5. Generating IP Cores (Intel Quartus Prime Pro Edition)...............................................12 1.5.1. IP Core Generation Output (Intel Quartus Prime Pro Edition)..........................13 1.5.2. Scripting IP Core Generation....................................................................
    [Show full text]
  • Intel® Arria® 10 Device Overview
    Intel® Arria® 10 Device Overview Subscribe A10-OVERVIEW | 2020.10.20 Send Feedback Latest document on the web: PDF | HTML Contents Contents Intel® Arria® 10 Device Overview....................................................................................... 3 Key Advantages of Intel Arria 10 Devices........................................................................ 4 Summary of Intel Arria 10 Features................................................................................4 Intel Arria 10 Device Variants and Packages.....................................................................7 Intel Arria 10 GX.................................................................................................7 Intel Arria 10 GT............................................................................................... 11 Intel Arria 10 SX............................................................................................... 14 I/O Vertical Migration for Intel Arria 10 Devices.............................................................. 17 Adaptive Logic Module................................................................................................ 17 Variable-Precision DSP Block........................................................................................18 Embedded Memory Blocks........................................................................................... 20 Types of Embedded Memory............................................................................... 21 Embedded Memory Capacity in
    [Show full text]
  • Intel FPGA Product Catalog Devices: 10 Nm Device Portfolio Intel Agilex FPGA and Soc Overview
    • Cover TBD INTEL® FPGA PRODUCT CATALOG Version 19.3 CONTENTS Overview Acceleration Platforms and Solutions Intel® FPGA Solutions Portfolio 1 Intel FPGA Programmable Acceleration Overview 61 Devices Intel Acceleration Stack for Intel Xeon® CPU with FPGAs 62 Intel FPGA Programmable Acceleration Cards 63 10 nm Device Portfolio - Intel AgilexTM - Intel Programmable Acceleration Card with 63 FPGA and SoC Overview 2 Intel Arria 10 GX FPGA - Intel Agilex FPGA Features 4 - Intel FPGA Programmable Acceleration Card D5005 64 Generation 10 Device Portfolio - Intel FPGA Programmable Acceleration Card N3000 65 - Generation 10 FPGAs and SoCs 6 - Intel FPGA Programmable Acceleration Card 66 - Intel Stratix® 10 FPGA and SoC Overview 7 Comparison - Intel Stratix 10 FPGA Features 9 Accelerated Workload Solutions 67 - Intel Stratix 10 SoC Features 11 - Intel Stratix 10 TX Features 13 - Intel Stratix 10 MX Features 15 Design Tools, OS Support, and Processors - Intel Stratix 10 DX Features 17 Intel Quartus® Prime Software 68 - Intel Arria® 10 FPGA and SoC Overview 20 DSP Builder for Intel FPGAs 71 - Intel Arria 10 FPGA Features 21 Intel FPGA SDK for OpenCL™ 72 - Intel Arria 10 SoC Features 23 - Intel Cyclone® 10 FPGA Overview 25 Intel SoC FPGA Embedded Development Suite 73 - Intel Cyclone 10 GX FPGA Features 26 SoC Operating System Support 74 - Intel Cyclone 10 LP FPGA Features 27 Nios® II Processor 75 - Intel MAX® 10 FPGA Overview 29 - Intel MAX 10 FPGA Features 30 Nios II Processor Embedded Design Suite 76 Nios II Processor Operating System Support 28
    [Show full text]
  • Intel® Arria® 10 FPGA Performance Benchmarking Methodology and Results
    WHITE PAPER FPGA Intel® Arria® 10 FPGA Performance Benchmarking Methodology and Results Intel Arria 10 FPGAs deliver more than a speed grade faster core performance † and up to a 20% fMAX advantage for publicly available OpenCore designs. Authors Introduction Martin S. Won This paper presents a rigorous methodology for evaluating and benchmarking the Senior Member of Technical Staff core performance of the Intel® Arria® 10 FPGA programmable logic product family, Intel Programmable Solutions Group with the goal of transparently presenting the methods and data such that any interested party can reproduce and analyze the results.† To this end, ten publicly- Madhu Monga available designs from OpenCores representing a variety of functions were Applications Engineer implemented in a device from the Intel Arria 10 FPGA family and a device from the Intel Programmable Solutions Group closest competitor: the Xilinx* UltraScale* family. The benchmark results show that Intel Arria 10 FPGAs deliver up to 20% higher performance than Xilinx UltraScale devices, as measured by the maximum clock frequencies achieved in the example designs across a range of device utilization.† Background: evaluating the performance of Intel FPGA and Table of Contents SoC products Introduction ....................1 The programmable logic industry does not have a standard benchmarking Background: evaluating the methodology. Therefore, Intel employs rigorous internal analysis using a broad performance of Intel FPGA and combination of customer and internally-generated designs to understand and SoC products .................1 quantify the performance of its programmable logic products relative to prior- generation Intel products and competing products. The designs are collected from Increasing transparency via a variety of market segments, such as high-performance computing, image and OpenCore-based performance video processing, wired and wireless communications, and consumer products.
    [Show full text]
  • Embedded Design Handbook
    Embedded Design Handbook Subscribe EDH | 2020.07.22 Send Feedback Latest document on the web: PDF | HTML Contents Contents 1. Introduction................................................................................................................... 6 1.1. Document Revision History for Embedded Design Handbook........................................ 6 2. First Time Designer's Guide............................................................................................ 8 2.1. FPGAs and Soft-Core Processors.............................................................................. 8 2.2. Embedded System Design...................................................................................... 9 2.3. Embedded Design Resources................................................................................. 11 2.3.1. Intel Embedded Support........................................................................... 11 2.3.2. Intel Embedded Training........................................................................... 11 2.3.3. Intel Embedded Documentation................................................................. 12 2.3.4. Third Party Intellectual Property.................................................................12 2.4. Intel Embedded Glossary...................................................................................... 13 2.5. First Time Designer's Guide Revision History............................................................14 3. Hardware System Design with Intel Quartus Prime and Platform Designer.................
    [Show full text]
  • AN 821: Interface Planning for Intel® Stratix® 10 Fpgas
    AN 821: Interface Planning for Intel® Stratix® 10 FPGAs Updated for Intel® Quartus® Prime Design Suite: 17.1 Subscribe AN-821 | 2017.12.15 Send Feedback Latest document on the web: PDF | HTML Contents Contents 1. Interface Planning for Intel® Stratix® 10 FPGAs............................................................. 3 1.1. FPGA_TOP Design Example Overview....................................................................... 3 1.2. Design Example Files............................................................................................. 5 1.3. Design Example Walkthrough.................................................................................. 6 1.3.1. Step 1: Project Setup.................................................................................6 1.3.2. Step 2: Initialize Interface Planner............................................................... 7 1.3.3. Step 3: Update Plan with Project Assignments............................................... 8 1.3.4. Step 4: Plan Periphery Placement................................................................ 8 1.3.5. Step 5: Report Placement Data.................................................................. 14 1.3.6. Step 6: Validate and Export Plan Constraints............................................... 15 1.3.7. Step 7: Apply Plan Constraints...................................................................16 1.4. Modifying the FPGA_TOP Design Example................................................................17 1.4.1. Modifying the VHDL Generics.....................................................................17
    [Show full text]
  • CPRI Intel® FPGA IP Core Release Notes
    CPRI Intel® FPGA IP Core Release Notes Subscribe RN-1107 | 2021.08.13 Send Feedback Latest document on the web: PDF | HTML Contents Contents 1. CPRI Intel® FPGA IP Core Release Notes........................................................................ 3 1.1. CPRI Intel FPGA IP v19.4.0..................................................................................... 3 1.2. CPRI Intel FPGA IP v19.3.0..................................................................................... 4 1.3. CPRI Intel FPGA IP v19.2.0..................................................................................... 4 1.4. CPRI Intel FPGA IP v18.1........................................................................................4 1.5. CPRI v7.0 IP Core v17.1......................................................................................... 5 1.6. CPRI v6.0 IP Core v17.0......................................................................................... 5 1.7. CPRI v6.0 IP Core v14.1......................................................................................... 6 1.8. CPRI v6.0 IP Core v14.0......................................................................................... 6 1.9. CPRI v5.0 IP Core v13.1......................................................................................... 6 1.10. CPRI v5.0 IP Core v13.0....................................................................................... 7 ® CPRI Intel FPGA IP Core Release Notes Send Feedback 2 RN-1107 | 2021.08.13 Send Feedback 1. CPRI Intel® FPGA
    [Show full text]
  • Intel® Quartus® Prime Standard Edition Handbook Volume 2 Design Implementation and Optimization
    Intel® Quartus® Prime Standard Edition Handbook Volume 2 Design Implementation and Optimization Updated for Intel® Quartus® Prime Design Suite: 17.1 Subscribe QPS5V2 | 2017.11.06 Send Feedback Latest document on the web: PDF | HTML Contents Contents 1 Constraining Designs..................................................................................................... 11 1.1 Constraining Designs with Intel Quartus Prime Tools.................................................. 11 1.1.1 Global Constraints and Assignments............................................................ 11 1.1.2 Node, Entity, and Instance-Level Constraints................................................ 12 1.1.3 Probing Between Components of the Intel Quartus Prime GUI......................... 14 1.1.4 Specifying Individual Timing Constraints...................................................... 14 1.2 Constraining Designs with Tcl Scripts....................................................................... 16 1.2.1 Generating Intel Quartus Prime Settings Files............................................... 16 1.2.2 Timing Analysis with .sdc Files and Tcl Scripts............................................... 18 1.2.3 Using Tcl-only Script Flows......................................................................... 19 1.3 A Fully Iterative Scripted Flow................................................................................ 22 1.4 Document Revision History.....................................................................................22 2 Managing
    [Show full text]
  • Getting Started with Intel's DE-Series Boards
    Getting Started with Intel’s DE-Series Boards For Quartus Prime 16.1 1 Introduction This document introduces Intel’s DE-series Development and Education Boards and the supporting materials pro- vided by Intel Corporation. It also explains the installation process needed to use a DE-series board connected to a computer that has the Quartus® Prime CAD system installed on it. Intel’s DE-series Development and Education Boards have been developed to provide an ideal vehicle for learning about digital technology in a laboratory setting. The DE-series boards are highly suitable for use in courses on digital logic, computer organization, and embedded systems, as well as for design projects. In addition to the DE-series board and the associated software, Intel provides supporting materials that include tutorials and laboratory exercises. Contents: • Purpose of a DE-Series Board • Scope of a DE-Series Board and Supporting Material • Installation of Software and Drivers • Using a DE-Series Board Intel Corporation - FPGA University Program 1 November 2016 GETTING STARTED WITH INTEL’S DE-SERIES BOARDS For Quartus Prime 16.1 2 Purpose of a DE-Series Board University and college courses on the design of logic circuits, computer organization, and embedded systems usually include a laboratory component. In a modern curriculum, the laboratory equipment should ideally exemplify state- of-the-art technology and design tools, but be suitable for exercises that range from the simple tasks that illustrate basic concepts to challenging designs that require knowledge of advanced topics. From the logistic point of view, it is ideal if the same equipment can be used in all cases.
    [Show full text]
  • Intel® FPGA Software Installation and Licensing
    Intel® FPGA Software Installation and Licensing Updated for Intel® Quartus® Prime Design Suite: 21.2 Subscribe MNL-1065 | 2021.06.21 Send Feedback Latest document on the web: PDF | HTML Contents Contents 1. Introduction to Intel® FPGA Software Installation and Licensing................................... 4 1.1. Intel FPGA Download Center................................................................................... 4 1.2. Intel FPGA Self-Service Licensing Center...................................................................4 2. System Requirements and Prerequisites.........................................................................5 2.1. Minimum Hardware Requirements............................................................................5 2.2. Cable and Port Requirements.................................................................................. 5 2.3. Software Requirements.......................................................................................... 6 2.3.1. Installing Windows Subsystem for Linux* (WSL) on Windows.......................... 7 2.3.2. Intel High Level Synthesis Compiler Software Requirements............................ 7 2.3.3. ModelSim - Intel FPGA Edition Software Requirements....................................8 2.4. Interaction with Third-party Software....................................................................... 8 3. Downloading and Installing Intel FPGA Software........................................................... 9 3.1. Software Available in the Download Center................................................................9
    [Show full text]