OmpSs-2@FPGA User Guide

The information included in this document is provided “as is”, with no warranties whatsoever, including any warranty of merchantability, fitness for any particular purpose, or any warranty otherwise arising out of any proposal, specification, or sample. The document is not guaranteed to be complete and/or error-free at this stage and it is subject to changes without furthernotice. Barcelona Supercomputing Center will not assume any responsibility for errors or omissions in this document. Please send comments, corrections and/or suggestions to ompss-fpga-support at bsc.es. This document is provided for informational purposes only.

Note

There is a PDF version of this document at http://pm.bsc.es/ftp/ompss-2-at-fpga/doc/user-guide-git/OmpSs2FPGAUserGuide.pdf

• 1. Install OmpSs-2@FPGA toolchain
  • 1.1. Prerequisites
    • 1.1.1. Git Large File Storage
    • 1.1.2. Vendor backends - Xilinx Vivado
  • 1.2. Stable release
  • 1.3. Individual git repositories
    • 1.3.1. Accelerator Integration Tool (AIT)
    • 1.3.2. Kernel module
    • 1.3.3. XDMA
    • 1.3.4. xTasks
    • 1.3.5. ovni
    • 1.3.6. Nanos6-fpga
    • 1.3.7. LLVM/Clang
• 2. Develop OmpSs-2@FPGA programs
  • 2.1. Limitations
  • 2.2. Specific differences in clauses and directives in OmpSs-2@FPGA VS OmpSs-2
  • 2.3. Clauses of task directive
    • 2.3.1. num_instances
    • 2.3.2. affinity
    • 2.3.3. copy_in/out
    • 2.3.4. copy_deps
  • 2.4. Calls to Nanos6 API
    • 2.4.1. Nanos6 FPGA Architecture API
• 3. Compile OmpSs-2@FPGA programs
  • 3.1. LLVM/Clang FPGA Phase options
    • 3.1.1. fompss-fpga-wrapper-code
    • 3.1.2. fompss-fpga-ait-flags
    • 3.1.3. fompss-fpga-memory-port-width
    • 3.1.4. fompss-fpga-check-limits-memory-port
    • 3.1.5. fompss-fpga-instrumentation
  • 3.2. AIT options
    • 3.2.1. AIT options
    • 3.2.2. Accelerator placement options
    • 3.2.3. Accelerator interconnect options
  • 3.3. Binaries
  • 3.4. Bitstream
    • 3.4.1. HW Instrumentation
    • 3.4.2. Shared memory port
  • 3.5. Boot Files
• 4. Running OmpSs-2@FPGA Programs
  • 4.1. Nanos6 FPGA Architecture configuration
  • 4.2. Running OMPIF applications
    • 4.2.1. Install cluster scripts
    • 4.2.2. Application execution
  • 4.3. POM AXI-Lite interface memory map
    • 4.3.1. How to enable the AXI-Lite interface
    • 4.3.2. How to read the registers with QDMA
  • 4.4. Ovni FPGA instrumentation
    • 4.4.1. Prerequisites
    • 4.4.2. Running the application
    • 4.4.3. Processing traces
• 5. Generate boot files for Xilinx SoC boards
  • 5.1. Prerequisites
    • 5.1.1. PetaLinux installation
  • 5.2. PetaLinux project setup
    • 5.2.1. Unpack the bsp
    • 5.2.2. Configure PetaLinux
    • 5.2.3. Configure linux kernel
  • 5.3. Generate boot files manually
    • 5.3.1. Add OmpSs@FPGA node to the device tree
    • 5.3.2. Build the Linux system
    • 5.3.3. Create BOOT.BIN file
  • 5.4. Use AIT to generate boot files
  • 5.5. Copy the files to the SD boot partition
• 6. Cluster Installations
  • 6.1. Ikergune cluster installation
    • 6.1.1. General remarks
    • 6.1.2. Module structure
    • 6.1.3. Build applications
    • 6.1.4. Running applications
  • 6.2. Xaloc cluster installation
    • 6.2.1. General remarks
    • 6.2.2. Node specifications
    • 6.2.3. Logging into xaloc
    • 6.2.4. Module structure
    • 6.2.5. Build applications
    • 6.2.6. Running applications
  • 6.3. Quar cluster installation
    • 6.3.1. General remarks
    • 6.3.2. Node specifications
    • 6.3.3. Logging into quar
    • 6.3.4. Module structure
    • 6.3.5. Build applications
    • 6.3.6. Running applications
  • 6.4. crdbmaster cluster installation
    • 6.4.1. General remarks
    • 6.4.2. Node specifications
    • 6.4.3. System overview
    • 6.4.4. Logging into the system
    • 6.4.5. Module structure
    • 6.4.6. Build applications
    • 6.4.7. Running applications
  • 6.5. Llebeig cluster installation
    • 6.5.1. General remarks
    • 6.5.2. Logging into llebeig
    • 6.5.3. Module structure
    • 6.5.4. Build applications
  • 6.6. Meep cluster installation
    • 6.6.1. General remarks
    • 6.6.2. Node specifications
    • 6.6.3. Logging into Meep
    • 6.6.4. Module structure
    • 6.6.5. Build applications
    • 6.6.6. Running applications

• Index