Fmc-adc test system setup
Attention:
The instructions below this section are only necessary for setting up
your own PTS.
If you just need to setup a Linux box to use the FMC-ADC, please refer to the documentation of the driver:
This procedure would work for a modern Linux box (as of 2017) if one does not need to setup a PTS:
Ubuntu installation & setup
- Download and install ubuntu 14.04 (32-bit, desktop edition).
- Do not check "download updates while installing" or "install this third-party software".
- Choose timezone and keyboard.
- Set username and password to "user", computer's name to "fmc-adc-pts", check "log in automatically".
- After reboot, do not upgrade to another Ubuntu version, choose
"Don't Upgrade" if asked.
- Also, do not update any software packages, if prompted to do so.
- Set date & time if not correct.
- Give admin access to "user" without the need for a password:
- launch a terminal (press the "Windows" key once, then start typing the word "terminal" and click on the icon that will appear)
- type
sudo visudo
- enter the password ("user")
- press the PageDown key until you reach the end of the file
- add the line:
user ALL=(ALL) NOPASSWD: ALL
at the end - Save (Ctrl+O, followed by Enter) and exit (Ctrl+X)
- Close the terminal window when you are done
- Auto-hide the launcher (system settings>appearance>behavior).
- Disable 'Lock' and 'Require my password when waking from suspend' (system settings>brightness&lock).
Connect to Internet
For CERN network:
- Connect to a portable socket.
- Open a web browser and declare the MAC address on the cern network.
Install missing packages
Launch a terminal (press the "Windows" key once, then start typing the word "terminal" and click on the icon that will appear).
sudo apt-get install emacs git gitk python-scipy python-matplotlib libusb-dev python2-pyro4
Optional: install SSH server for remote access.
sudo apt-get install openssh-server
sudo /etc/init.d/ssh restart
Close the terminal window when you are done.
Disable all software updates
Go to 'system settings->software&updates', then uncheck all sources in the "Ubuntu Software" and "Other Software" tabs).
If prompted for a password, provide it ("user").
When done, you will be asked to reload the software database, say yes.
Improve barcode reader speed (only applies to barcode scanner model: CR1421)
- Download: http://www.codecorp.com/assets/download/D006284-CR1000-CR1400-CR8000--Configuration-Guide.pdf
- Print page 13.
- Scan "Enable Alternative OS (Windows CE/MAC/Unix/Linux)" QrCode.
Install & configure PTS + dependencies
Launch a terminal (press the "Windows" key once, then start typing the word "terminal" and click on the icon that will appear).
Clone fmc-adc testing repository:
cd ~
git clone git:https://www.ohwr.org/fmc-projects/fmc-adc-100m14b4cha/fmc-adc-100m14b4cha-tst.git fmc-adc-tst/
cd fmc-adc-tst
git submodule init
git submodule update
Build driver, tools and library:
cd ~/fmc-adc-tst/pts/gnurabbit/
make
cd kernel/
sudo make install
cd ~/fmc-adc-tst/pts/gnurabbit/python
make
Build libipmi tool:
cd ~/fmc-adc-tst/pts/common/fmceeprom/libipmi/
make
Get fmc-adc gateware:
mkdir ~/fmc-adc-tst/gatewares
cd ~/fmc-adc-tst/gatewares
wget https://www.ohwr.org/project/fmc-adc-100m14b4cha-gw/uploads/adaf1cc571aba9ff9dcbc046801237b9/spec-fmc-adc-v4.0.bin .
ln -s spec-fmc-adc-v4.0.bin spec_fmcadc100m14b4cha.bin
Clone USB relay box repository and build modified cp210x driver:
cd ~
git clone git:https://www.ohwr.org/usb-projects/usb-relay-box1.git usb-relay-box1
cd usb-relay-box1/sw/cp210x-driver/
git checkout 3.13.0-24-generic
make
sudo make install
Clone fpga-config-space and build sdbfs tools:
cd ~
git clone git:https://www.ohwr.org/hdl-core-lib/fpga-config-space.git fpga-config-space/
cd ~/fpga-config-space/sdbfs/lib/
make
cd ~/fpga-config-space/sdbfs/userspace/
make
cd /usr/bin
sudo ln -s ~/fpga-config-space/sdbfs/userspace/gensdbfs gensdbfs
sudo ln -s ~/fpga-config-space/sdbfs/userspace/sdb-read sdb-read
sudo ln -s ~/fpga-config-space/sdbfs/userspace/sdb-extract sdb-extract
Close the terminal window when you are done.
Make PTS run at startup
- Launch "Startup Applications" (press the "Windows" key once, then start typing the name of the application and click on the icon that will appear)
- Add
Name : fmc-adc-pts
Command: gnome-terminal --maximize -e "/home/user/fmc-adc-tst/run_pts.sh"
Comment: Launch fmc-adc production tests
Restart the system
You should be greeted with the "FmcAdc100M14b4cha Test program" running in a maximized terminal window. From here, follow the on-screen instructions to perform the tests and read the documentation.
Matthieu Cattin - July 2014
Erik van der Bij - August 2017
Dimitris Lampridis - January 2018