Getting Started

JetStream has two parts, hardware and software. While you need both to use the system, it is enough to install the software when you get a bitstream. In all other cases you need to install both. This quickstart guide should get you jumpstarted. However, if you have trouble check the README file of the corresponding repository as these contain the latest information and additional tips for troubleshooting.

Software installation

First of you have to install the dependencies:

• Boost program options
• Boost program options development headers
• CMake ≥ 2.8.12
• make
• Linux Kernel ≥ 3.3
• Linux Kernel headers

Chances are you are already running a Kernel ≥ 3.3, as of writing CentOS ships with 3.10. The rest should be available as packages, the package names on CentOS would be cmake3 boost boost-devel kernel-devel (you can try to be specific: boost-program-options). For CentOS you will have to replace cmake by cmake3 in the following to use a recent enough version.

Now you can check out the git repository maltevesper/JetStream-driver .

After your checkout completes you have to create a build directory and generate the makefiles:

You have now completed the onetime setup required, you do not have to repeat the above steps in the future. All that is left is to build and install the library and the driver:

If you make changes to the driver or the user library you will have to repeat the last two steps above. If you plan to work a lot on the driver or the userlibrary, it is worthwhile noting that there are individual build targets. The targets are driver, install-driver, fpga, install-fpga, fpga++, install-fpga++. They build/install the driver, the C-library, or the C++-library respectivley.

Hardware

To get the hardware, simply checkout maltevesper/JetStream-hardware and open the contained project with Vivado 2015.4. While we intend to port to Vivado 2016 this work is currently hindred by a regression in Vivado, causing the synthesis to fail.