Getting Started - ORKA-HPC/orka-hpc-llp GitHub Wiki

Content of this page: Instructions on how to obtain, build, and use ORKA-HPC LLP

Setting up Build Requirements

Linux

Most build dependencies for Ubuntu Linux 18.04 64-bit, CentOS 7 and CentOS 8 can be installed via their default package managers from standard repositories. The following command installs the tools and libraries that are necessary to build the ORKA-HPC LLP Generator

# Ubuntu 18.04
sudo apt-get install build-essential git tcl-dev
# CentOS 7
sudo yum install binutils gcc gcc-c++ git make tcl-dev
# CentOS 8
sudo dnf install binutils gcc gcc-c++ git make tcl-dev

Setting up the build requirements on other Linux distributions should work quite similar but is tested less often.

Windows

The ORKA-HPC Generic Driver may be built on Windows 10 with Visual Studio. IP and bitstream generation is not supported.

Dependencies for HLS and Bitstream Generation For HLS and bitstream generation, additional

dependencies must be installed. The ORKA-HPC bitstream generator relies on tools provided by the FPGA vendors. We currently support Xilinx and Intel FPGAs. Please install the toolchain corresponding to your target FPGA:

  • Xilinx Vivado 2020.2. Tested versions include 2018.2 and 2020.2, others might work as well. Configuration of Xilinx FPGAs via JTAG requires the Xilinx USB cable drivers included in Xilinx Vivado. They need to be installed manually, please refer to Xilinx documentation for more information.
  • Intel Quartus Pro 21.1.

Getting ORKA-HPC LLP

To get a copy of the ORKA-HPC LLP, clone from the public git repository. Multiple dependencies are included as git submodules, so make sure to also initialize the git submodules. This can be achieved using the following commands:

git clone https://github.com/ORKA-HPC/orka-hpc-llp.git
cd orka-hpc-llp
git submodule update --init --recursive

Building ORKA-HPC LLP

On a command line, if necessary, navigate to the directory you just cloned ORKA-HPC LLP to, and invoke make.

cd orka-hpc-llp
make

Please note that Host-FPGA communication via PCIe requires the installation of PCIe drivers.

Using ORKA-HPC LLP

ORKA-HPC LLP consists of multiple parts:

While all parts may be used independently, they are primarily intended to be used together. Please refer to the ORKA-HPC LLP Examples for detailed information.