Skip to content

Latest commit

 

History

History
66 lines (45 loc) · 2.62 KB

README.md

File metadata and controls

66 lines (45 loc) · 2.62 KB
Raw

OneAPI-ASP

Overview

This repository contains files necessary to generate ASP for the OFS I-series devkit reference platform. The hardware currently relies on platforms that implement the OFS PCIe TLP format using AXI-S interfaces, and the software uses OPAE SDK interfaces.

Repo Structure

The repository is structured as follows:

  • bringup: contains files used by 'aocl install' command to install prerequisite software on a target system and to load a ASP. The files are stored in two separate git submodules that each use git-lfs to store their contents.

  • hardware: contains files used by the OneAPI compiler to integrate the generated kernel code with platform specific code. Contains distinct board variant targets with distinct functionalities (ex. USM and non-USM variants targeting the same board platform).

  • linux64: contains the libraries and utilities that are used by the OneAPI software stack. The repository itself contains a few scripts that are checked-in to linux64/libexec. The linux64 directory is also the target for files compiled from the source directory.

  • scripts: a variety of helper scripts used for configuring ASP and for running tests

ASP variants

The hardware folder contains subdirectories with the 2 different oneAPI-ASP variants:

  • ofs_iseries-dk_usm: ASP that supports shared virtual memory between host and device. This variant is the same as the non-USM variant with the addition of the USM path between the kernel-system and the host.

  • ofs_iseries-dk: DMA-based ASP that supports local memory and host memory interfaces for the kernel system.

Generating ASP

Generating a ASP requires 2 primary steps: generating hardware and compiling the software.

The hardware folder contains code that implements the ASP modules, but it needs copies of the OFS FIM pr-release-template files to work with a specific platform. The setup_asp.py script copies the required files from the FIM pr-release-template and updates the project qsf files appropriately.

Need to set OPAE_PLATFORM_ROOT to point to pr_build_template in FIM build area.

Need to set OFS_ASP_ROOT to point to oneapi-asp/iseries-dk.

To generate ASP hardware and software, acquire the appropriate resources (mentioned above) and run: scripts/build-asp.sh.

To generate MMD software only run: scripts/build_mmd.sh

To package generated ASP into tarball run: scripts/create-tarball.sh

Kernel Compilation Options

  • Default Design - simple-add-buffers.cpp Use script - scripts/build-default-binaries.sh. Generated binary will be in $OFS_ASP_ROOT/build/bringup folder. Host code will be in $OFS_ASP_ROOT/bringup/source folder