% Benoit RAT, Jose Jimenez, Javier Diaz (Seven Solutions) & Miguel Jimenez (UGR)
% Benoit RAT, Jose Jimenez, Javier Diaz (Seven Solutions)
Introduction
Introduction
=============
=============
...
@@ -86,8 +86,27 @@ System Setup
...
@@ -86,8 +86,27 @@ System Setup
This section describes the main elements required to start with the White-Rabbit based
This section describes the main elements required to start with the White-Rabbit based
on the *"White Rabbit (SPEC-based) starting kit"*. The different
on the *"White Rabbit (SPEC-based) starting kit"*. The different
hardware elements and theirs connections are described in this section.
hardware elements and theirs connections are described in this section.
What do you need?
----------------
In order to use the white rabbit starting kit and setup the different
experiments you will need:
* An oscillocope with at least 150Mhz bandwitdh (500Mhz is recommanded).
* A PC with with at least two `PCIe x4` ports (`x8` & `x16` are also compatible)
* The Operative System Ubuntu 12.04 LTS 32bit (Long Term Support) with kernel `3.2.x.`
* Two mini-USB (B) cables (not provided with the kit).
> ***Note:*** This tutorial follow a configuration with two [SPEC+FMCDIO] boards connected in the two **PCIe x16** interfaces of the same computer. However, you can also use two different computers (if you do not have two **PCIe x4**) and follow this tutorial; you just need to replace all the commands with `wr1` or `0x0300` by the `wr0` and its corresponding bus_id on the second PC. The configuration with two separated PCs is more *"natural"* to understand how to communicate two different nodes using the starting kit,
but it requires more physical space to implement it.
![Configuration with one or two PCs](ssk_configs.png)
> ***Warning:*** This tutorial fully support the latest ubuntu LTS release. Other distro or kernel version might work, however we can not guarantee full compatibility and therefore full support. Please check the
[wr-starting-kit] wiki for a more detailed list of which distro has been tested.
Starting kit components
Starting kit components
----------------
----------------
...
@@ -95,7 +114,7 @@ Starting kit components
...
@@ -95,7 +114,7 @@ Starting kit components
The starting kit is composed of various elements that you should find
The starting kit is composed of various elements that you should find
in the package[^standardssk] :
in the package[^standardssk] :
* 2x [SPEC]s boards compatible with *PCIe x4* or more
* 2x [SPEC]s boards
* 2x [FMC-DIO]s 5CH TTL A
* 2x [FMC-DIO]s 5CH TTL A
* 2x SFPs LC
* 2x SFPs LC
...
@@ -114,24 +133,23 @@ Physical configurations
...
@@ -114,24 +133,23 @@ Physical configurations
-------------------
-------------------
* Plug the [SPEC+FMCDIO] into your *PCIe x{4,8,16}* port.
* Plug the [SPEC+FMCDIO] into your `PCIe x{4,8,16}` port.
* You should also connect a micro-USB cable to the UART of the board.
* You should also connect a micro-USB cable to the UART of the board.
(A Virtual UART is also available, but it is safer to use the physical
(A Virtual UART is also available, but it is safer to use the physical
one).
one).
* Connect the two [SPEC+FMCDIO] boards using the SFPs and the optical fiber cable (LC-LC)
* Connect the two [SPEC+FMCDIO] boards using the SFPs and the optical fiber cable (LC-LC)
* Run a linux distribution (This tutorial has been written using Ubuntu 12.04 and it is focused on
* Start your Ubuntu LTS distribution.
debian's like distribution).
* Prepare an oscilloscope with at least two input channels to access
* Prepare an oscilloscope with at least two input channels to access
the [FMCDIO] outputs.
the [FMCDIO] outputs.
> ***Note:*** This tutorial follow a configuration with two [SPEC+FMCDIO] boards connected in the two **PCIe x16** interfaces of the same computer.
> ***Note:*** This tutorial follow a configuration with two [SPEC+FMCDIO] boards connected in the two **PCIe x16** interfaces of the same computer.
> You can also use two different computers (if you do not have two **PCIe x4**) and follow this tutorial; you
> You can also use two different computers (if you do not have two **PCIe x4**) and follow this tutorial; you
just need to replace all the commands with `wr1` or `0x0300` by the `wr0` and its corresponding bus_id on the second PC.
just need to replace all the commands with `wr1` or `0x0300` by the `wr0` and its corresponding bus_id on the second PC.
The configuration with two separated PCs is more *"natural"* to
The configuration with two separated PCs is more *"natural"* to
understand how to communicate two different nodes using the starting kit,
understand how to communicate two different nodes using the starting kit,
but it requires more physical space to implement it.
but it requires more physical space to implement it.
![Configuration with one or two PCs](ssk_configs.png)
![Configuration with one or two PCs](ssk_configs.png)
...
@@ -1320,122 +1338,35 @@ By default the SPEC+DIO should be configured to be run in GM setup, but if you a
...
@@ -1320,122 +1338,35 @@ By default the SPEC+DIO should be configured to be run in GM setup, but if you a
You can also run GM in a full standalone mode in order to transmit WR clock without the need of a PC.
You can also run GM in a full standalone mode in order to transmit WR clock without the need of a PC.
First you need to flash the SPEC with the latest bitstream you can find the package: