Skip to content
No description, website, or topics provided.
Branch: master
Clone or download
Lisa Liu
Latest commit 1df1bde Feb 18, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
boost add boot code for host code development Oct 16, 2017
gemx add run_app.sh May 11, 2018
.gitignore
LICENSE.md
README.md updated GEMM engine with + and postScale support, and updated Makefil… Mar 12, 2018

README.md

General Matrix Operation

This README file contains the following sections:

  1. OVERVIEW
  2. SOFTWARE TOOLS AND SYSTEM REQUIREMENTS
  3. DESIGN FILE HIERARCHY
  4. BUILD GEMX-BASED EXAMPLE APPLICATIONS
  5. SUPPORT
  6. LICENSE AND CONTRIBUTING TO THE REPOSITORY
  7. ACKNOWLEDGEMENTS
  8. REVISION HISTORY

1. OVERVIEW

GEMX is a General Matrix Operation library, which is used for accelerating BLAS-like matrix operations on SDAccel supported FPGA cards. This library includes three components: an engine library, a host code compiler and an application or system building environment. The engine library consists of a set of C++ templates with BLAS-like function interfaces for realizing matrix operations on FPGAs. The host code compiler compiles the host code matrix function calls into a sequence of instructions for triggering matrix operations on FPGAs. The building environment utilizes GNU make flow to automate the FPGA and host code image generation process. It also allows users to configure different aspects of the system, e.g. FPGA platform, number of engines implemented in the FPGA image and etc. For detailed information about GEMX engine design, please refer to GEMX_ENGINE_UG

2. SOFTWARE AND SYSTEM REQUIREMENTS

Board DSA Name Software Version
Xilinx KCU1500 xilinx:kcu1500:dynamic:5_0 SDx 2017.4
Xilinx VU9P xilinx:vcu1525:dynamic:5_0 SDx 2017.4

3. DESIGN FILE HIERARCHY

Source code for building FPGA and host code images is located in the gemx/src directory. boost/ directory provides implementation for OpenCL functions used to instantiate an accelerator, trasmit data between the host and the accelerator and etc. Please refer to gemx_api_gemm.cpp to see its usage. gemx/Makefile is used to build FPGA and host images with different configurations. gemx/hls_config.tcl is used to configure the hls compilation options. gemx/run-hls.tcl is used to create vivado_hls project from cpu emulation results. gemx/data includs input sparse matrices' data.

4.BUILD GEMX-BASED EXAMPLE APPLICATIONS

Following four GEMX-BASED applications are created for xilinx:vcu1525:dynamic:5_0 DSA to demonstrate the GEMX engine usage.

  • gemm_perf: dense matrix matrix multiplication performance measurement
  • spmv_perf: sparse matrix vector multiplication performance measurement
  • gemm_test_python: python-based densen matrix matrix multiplication testing
  • gemx_func_test: GEMX engine testing in sofware emulation

Before compiling and building FPGA and host images, make sure SDAccel 2017.4 envioronment variales are set up properly and navigate to gemx/ directory, and enter command:

./run_app.sh

enter one of the four application names when the command line prompts for input.

5. SUPPORT

For more information about SDAccel check the SDAccel User Guides

For questions and to get help on this project or your own projects, visit the SDAccel Forums.

6. LICENSE AND CONTRIBUTING TO THE REPOSITORY

The source for this project is licensed under the 3-Clause BSD License

To contribute to this project, follow the guidelines in the Repository Contribution README

7. ACKNOWLEDGEMENTS

This example is written by developers at

8. REVISION HISTORY

Date README Version Description
Oct2017 1.0 Initial Xilinx Release
Mar2018 2.0 Updated to SDx 2017.4
You can’t perform that action at this time.