CERN Front End Computer
For a CERN installation please make a hardware installation request here.
The installation team will provide an industrial computer with the SPEC-masterFIP and the proper CCDE configuration for the automatic loading of the masterFIP drivers upon the startup. Note that a CERN budget code is required.
Ubuntu 16.04
With your PC OFF, insert the spec-masterFIP in a PCIe slot. Switch the computer ON and check if the red Pwr led on the SPEC is ON.
Packages to install
Please find in packages.txt a list with the packages that need to be installed in your machine.
Clone the software repositories
$ git clone https://ohwr.org/project/spec-sw.git
$ cd spec-sw
$ git checkout wrnc-support
$ git submodule init
$ git submodule update
$ cd ..
$ git clone https://gitlab.cern.ch/cohtdrivers/masterfip.git
$ cd masterfip
$ git checkout orson-diot
$ git submodule init
$ git submodule update
$ cd ..
$ git clone https://ohwr.org/project/wishbone-gen.git
Build the software stacks
Make wbgen2 and add it to /usr/local/bin. This is needed for the spec-sw drivers.
$ cd wishbone-generator
$ make
$ sudo cp wbgen2 /usr/local/bin/
Change dir into the spec-sw, and just type 'make':
$ cd ../spec-sw
$ make
Change dir into the masterfip, and:
$ cd ../masterfip/mockturtle/software/
$ make
$ cd ../../lib
$ make
$ cd ../tools
$ make
Download spec-init binary
$ cd ~
$ wget https://www.ohwr.org/project/spec-sw/uploads/636e7eaa2e1c3a884e2f9f694fdfd1b9/spec-init.bin-2015-09-18
$ sudo mv spec-init.bin-2015-09-18 /lib/firmware/fmc/spec-init.bin
Download masterFIP binaries
Create first a new directory masterfip-init with a subdirectory firmware
$ mkdir masterfip-init
$ cd masterfip-init
$ mkdir firmware
Download the binaries and store them in masterfip-init/firmware
$ wget https://www.ohwr.org/project/masterfip-gw/uploads/f8e5fa0982a2b0e46691793553b0eb17/spec_masterfip_mt_20171123.bin
$ sudo mv spec_masterfip_mt_20171123.bin firmware/spec-fmc-masterfip-gw.bin
$ wget https://ohwr.org/project/masterfip-gw/wikis/uploads/700efe21a4007249fea98375a75a651d/masterfip-rt-ba.bin-g35f83574
$ sudo mv masterfip-rt-ba.bin-g35f83574 firmware/masterfip-rt-ba.bin
$ wget https://ohwr.org/project/masterfip-gw/wikis/uploads/109a54481d7b846c95c965717629f57b/masterfip-rt-cmd.bin-g35f83574
$ sudo mv masterfip-rt-cmd.bin-g35f83574 firmware/masterfip-rt-cmd.bin
Download installation script and store it in masterfip-init
$ wget https://ohwr.org/project/masterfip-gw/wikis/uploads/30d53f6477fab2727fcb77c11f649b3b/start.sh
$ sudo mv start.sh masterfip-init/start.sh
$ wget https://ohwr.org/project/masterfip-gw/wikis/uploads/0f21aff473da9aec14f73ea09867d3e7/stop.sh
$ sudo mv stop.sh masterfip-init/stop.sh
$ chmod +x masterfip-init/*.sh
Run the installation scripts
Always run first the stop.sh followed by the start.sh. Running the start.sh should give the following:
$ sudo ./stop.sh
$ sudo ./start.sh
Loading FMC & SPEC drivers...
Downloading the bitstream to SPEC...
2904+1 records in
0+1 records out
1486892 bytes (1.5 MB, 1.4 MiB) copied, 0.755627 s, 2.0 MB/s
Loading Mockturtle driver...
Loading Mockturtle firmware...
Creating device symlinks...
Now the green LED on the SPEC front panel should be blinking.
Hardware check
To check the installation you could connect a FIPdiag slave to the masterFIP and run the FIPmon3 scrip, as follows:
$ cd ~/masterfip/tools/FIPmon3
$ sudo ./FIPmon3 -c0
--::::RECTIFER(PO) -2.5MHz- APPLICATION (EXIT : press ENTER)::::--
MACROCYCLE : FIXED=20ms CALCULATED=20ms MODE : BA_WAIT
IDENTIFICATION FIELDBUS
Area:EX4 System:RECTIFER(PO) Segment Number:A
FIPDIAG COM BUS Status:OK Var Stat:S/F
Last Restart : Wed Mar 6 13:03:38 2019
Cycle counter : 1454
Cycle Date : Wed Mar 6 13:04:07 2019
Com OK Counter : 1454
Sent Data Value : 168
Received Data Value : 172
R/W Data error : 0
Recovery Com OK Counter : 0
Last Recovery Com OK Date : Thu Jan 1 01:00:00 1970
Com Fault Counter : 0
Last Com Fault Date : Thu Jan 1 01:00:00 1970
TRANSACTIONS MONITORING
Nb of Tx OK per unit of time : 144
Nb of Rx OK per unit of time : 2
Nb of Rx Frames Error : 0
Nb of Tx Frames error : 0
ACTIVE NODES LIST
0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15
0 X . . . . . . . . . . . . . . .
16 . . . . . . . . . . . . . . . .
32 . . . . . . . . . . . . . . . .
48 . . . . . . . . . . . . . . . .
64 . . . . . . . . . . . . . . . .
80 . . . . . . . . . . . . . . . .
96 . . . . . . . . . . . . . . . .
112 . . . . . . . . . . . . . . . X
128 . . . . . . . . . . . . . . . .
144 . . . . . . . . . . . . . . . .
160 . . . . . . . . . . . . . . . .
176 . . . . . . . . . . . . . . . .
192 . . . . . . . . . . . . . . . .
208 . . . . . . . . . . . . . . . .
224 . . . . . . . . . . . . . . . .
240 . . . . . . . . . . . . . . . .
Regarding LEDs, while FIPmon3 is running:
- the green LED on the SPEC front panel should remain blinking.
- the green LEDs RX ACT and TX ACT on the masterFIP front panel should be blinking
- since there is no SYNC input to the masterFIP card, both green and red SYNC LEDs should be ON.