Running Test Software
Main Page -> Control & Readout Software Documentation and Howto's -> Running Test Software
This is a guide for how to install and run the test software.
Software Function
The test software consists of multiple tests which aims to provide a classification of the ALPIDE chip and scripts needed to run the ALPIDE in a beam environment.
Install
Requires devtoolset-7 or higher, gcc 7.3 or higher.
The software requires installation of the pct-online software.
It also requires a working version of rootpy, the installation guide can be accessed at http://www.rootpy.org/install.html
Make sure you have installed all other requirements: https://wiki.uib.no/pct/img_auth.php/d/d5/Requirements.pdf
You need access to the project at https://git.app.uib.no/pct
Using a terminal in the location where you want to install the Test software:
<syntaxhighlight lang="bash"> $ git clone git@git.app.uib.no:pct/production_tests.git
$ cd production_tests
$ git checkout v2.0
$ pip3 install -r requirements.txt </syntaxhighlight>
You should now be able to use the test software.
Usage
The How to and usage for individual tests are listed in their dedicated pages linked below:
Tests
- Analog Scan
- Digital Scan
- Threshold Scan
- DTU Scans
- Register Test
- High Speed Link Test
- FIFO Test
- Slow Control Test
- Power Test
- PRBS Test
Data Taking
The test software can also be used to perform data taking. This information can be accessed here * Data Taking
Calibration Curves
The threshold of the analog front-end can be altered by changing certain DAC settings in the config files. Calibration curves for the relevant settings are linked below.
Trouble Shooting
If it is difficult to establish communication with the board/alpides the following error message may be displayed when running a text: <syntaxhighlight lang="bash"> $ File "registertest.py", line 276, in <module>
register_test(args['--board'], args['--tctype'], args['--chips']) File "registertest.py", line 48, in register_test board = BoardPTB() File "../bsp/board_ptb.py", line 43, in __init__ super(BoardPTB, self).__init__(interface=MainSocket(49153, "192.168.1.10", "SOCK_STREAM")) File "../bsp/mainsocket.py", line 29, in __init__ self.open_socket(socket_type) File "../bsp/mainsocket.py", line 55, in open_socket self.sock.connect((self.addr, self.port))
KeyboardInterrupt
</syntaxhighlight>
Make sure that the necessary ports are open, this can be checked by the following command:
<syntaxhighlight lang="bash">
$ sudo iptables -L
</syntaxhighlight>
If you need to open a port, this can be done with the following command.
<syntaxhighlight lang="bash">
$ sudo iptables -I INPUT -p udp --sport portnumber -j ACCEPT
</syntaxhighlight>
For the VCU118 board, udp is used in communication. For the PTB tcp is used. You also need to specify if the port is source or destination. This is the --sport/--dport argument.
If you have issues with the offload. Make sure that you don't have any readout clients running in the background. This can be checked by using the top command anywhere in the terminal.
<syntaxhighlight lang="bash">
PID USER PR NI VIRT RES SHR S %CPU %MEM TIME+ COMMAND
36449 vei046 20 0 618664 114944 80376 S 99.7 0.2 0:51.09 run-pdtp-pru-parser
</syntaxhighlight>
