Building from sources

Requirements

To build the project, you will need:

An x86 Linux system with 32-bit system libraries
Kernel headers for your system
gcc >= 4.0
xz >= 5.0
git >= 1.7.2.5
(Optional) quartus system edition, v12 or newer
(Optional) Xilinx v14.2 or newer

Obtaining the source code

The complete project consists of many subprojects, most of which are hosted on the Open Hardware Repository (OHWR). Fortunately for you, gentle reader, you can get all of it with a single command:

git clone --recursive git:https://www.ohwr.org/white-rabbit/gsi-timing-starter-kit.git

Everything you need for the GSI Timing Starter Kit will be contained somewhere in the resulting tree.

Building the sources

Supposing you have all prerequisite software installed on your linux system, run

make

to build the Etherbone library, kernel device drivers, and white rabbit firmware.

If you are just trying to Configure-a-SPEC-host or Configure-a-Data-Master, you can just run

make install

as root and skip building the gateware for the SCU/EXPLODER/VETAR and SPEC below.

If you have quartus system edition installed and the environment variable QUARTUS set appropriate (example: /opt/hdl/altera/11.1/quartus), you can run

make scu

make exploder

make vetar

to create the file jam (e.g. wr-cores/syn/gsi_scu2/wr_core_demo/scu2.jam) which you can then use to Flash-an-Altera-device.

If you have ISE installed and in your PATH, you can run:

make spec

to create the file wr-cores/syn/spec_1_1/wr_core_demo/spec_top.bit which you can then use to Flash-a-Xilinx-device.