Skip to content

Latest commit

 

History

History
66 lines (45 loc) · 2.6 KB

README.md

File metadata and controls

66 lines (45 loc) · 2.6 KB
Raw

OneAPI-ASP

Overview

This repository contains files necessary to generate ASP for the OFS D5005 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_d5005_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_d5005: 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/d5005.

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