This project provides a convenient runtime for PCIe-based FPGAs programmed under the OpenCL host-kernel model. Both Intel and Xilinx platforms are supported.

• Ubuntu 16.04+

./install.sh

template <typename... Args>
fpga::Instance Invoke(const std::string& bitstream, Args&&... args);

This invokes the kernel contained in file bitstream. bitstream should be a file that can be read via ifstream and can be a pipe with proper EOF. args are the arguments to the kernel. If an argument is not a scalar, it needs to be wrapped in one of the following wrappers:

ReadOnly(T* ptr, size_t n);
WriteOnly(T* ptr, size_t n);
ReadWrite(T* ptr, size_t n);

This will tell the runtime the data exchange direction and how many elements are allocated. The directions are with respect to the host, not the device (because this is host code). Passing a host pointer directly will not work (doesn't even compile).

Invoke returns an fpga::Instance object that contains profiling information.

double Instance::LoadTimeSeconds();
double Instance::ComputeTimeSeconds();
double Instance::StoreTimeSeconds();
double Instance::LoadThroughputGbps();
double Instance::StoreThroughputGbps();

Streaming is supported (on Xilinx platforms).

class fpga::ReadStream;
class fpga::WriteStream;

The streams need to be created and passed to fpga::Invoke as a parameter. If the arguments to fpga::Invoke contains a stream, it will not wait for the kernel to finish; instead, it will return an fpga::Instance object immediately. The host program can read from fpga::ReadStream and/or write to fpga::WriteStream. When all stream I/O are done, instance.Finish() should be invoked to wait until the kernel finishes.