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
or
make exploder
or
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.