Instructions for experts¶
Configuration file for the Pedestal Data Runner is here:
Pedestal data is taken in a special operating mode using the front end board "Digital Oscilliscope (DSO)" Mode.
First login to a dcm. To do this ssh over to the dcm in question from nova-ctrl-master:
Next setup the operating environment for running the test/scan programs:
[novadaq@dcm-06:~]$ source /home/novadaq/DAQOperationsTools/novadaq_setup.sh
Next you will need to load firmware into the DCM and front end boards. To do this use the provided script "setup_dso" which will setup the firmware in such a way that it is ready to enter DSO readout mode.
[novadaq@dcm-06:~]$ setup_dso Programing DCMs and FEBs for DCS Operation Going to load /usr/firmware/current_dcm_firmware 1966298 bytes Reseting the FPGA...done. Programming........................................
Next run the scan utility on a single channel to verify that everything was setup correctly. In the example we probe only link number 0 (all 32 pixels of it though), taking a quick 10 sample point trace, and dump out some raw information in hex format.
[novadaq@dcm-06:~]$ dcmDSOReadout -l 0 -s 10 -x
or with more descriptive options (you can type "dcmDSOReadout -h" for a full list of options)
[novadaq@dcm-06:~]$ dcmDSOReadout --link=0 --samples=10 --dump_hex
If this is successful you will see output that looks like:
Link 0 1 Openning STDOUT for output Link mask set to: 00000001 00000000 Setting: mask (lo) O00000000001 mask (hi) O00000000000 pmask 0x00000001 Single Link Pixel Scan: FEB-00 PIX-00 65532 Bytes read from DCM FEB: 00 PIX: 00 PH: 352 TDC: 3416010272 0x2c006003 0xcb9c2e20 0x0160cafe FEB: 00 PIX: 00 PH: 346 TDC: 3416010304 0x30006003 0xcb9c2e40 0x015acafe FEB: 00 PIX: 00 PH: 331 TDC: 3416010336 0x34006003 0xcb9c2e60 0x014bcafe FEB: 00 PIX: 00 PH: 331 TDC: 3416010368 0x38006003 0xcb9c2e80 0x014bcafe FEB: 00 PIX: 00 PH: 327 TDC: 3416010400 0x3c006003 0xcb9c2ea0 0x0147cafe FEB: 00 PIX: 00 PH: 323 TDC: 3416010432 0x20006003 0xcb9c2ec0 0x0143cafe FEB: 00 PIX: 00 PH: 330 TDC: 3416010464 0x24006003 0xcb9c2ee0 0x014acafe FEB: 00 PIX: 00 PH: 343 TDC: 3416010496 0x28006003 0xcb9c2f00 0x0157cafe FEB: 00 PIX: 00 PH: 351 TDC: 3416010528 0x2c006003 0xcb9c2f20 0x015fcafe FEB: 00 PIX: 00 PH: 348 TDC: 3416010560 0x30006003 0xcb9c2f40 0x015ccafe FEB: 00 PIX: 00 PH: 345 TDC: 3416010592 0x34006003 0xcb9c2f60 0x0159cafe Setting: mask (lo) O00000000001 mask (hi) O00000000000 pmask 0x00000002 Single Link Pixel Scan: FEB-00 PIX-01 65532 Bytes read from DCM FEB: 00 PIX: 01 PH: 319 TDC: 3467712492 0x38016003 0xceb117ec 0x013fcafe FEB: 00 PIX: 01 PH: 327 TDC: 3467712524 0x3c016003 0xceb1180c 0x0147cafe FEB: 00 PIX: 01 PH: 326 TDC: 3467712556 0x20016003 0xceb1182c 0x0146cafe FEB: 00 PIX: 01 PH: 335 TDC: 3467712588 0x24016003 0xceb1184c 0x014fcafe ... ...
And the scan should move through all 32 pixels.
Now for the fun. We need to scan over all 62 front end boards, each with 32 pixels (1984 total channels) and we want to take a long trace on each channel to verify it. We will write the output to a series of file, and then these can be analyzed to determine the baseline position and noise on the baseline of each channel.
First, make a directory structure to hold today's data. Example for dcm-06, wash, rinse, repeat for all:
[novadaq@dcm-06:~]$ cd /data/PedestalData/PedScans [novadaq@dcm-06:PedScans]$ mkdir 2011-01-05 [novadaq@dcm-06:PedScans]$ cd 2011-01-05 [novadaq@dcm-06:2011-01-05]$ mkdir dcm-06 [novadaq@dcm-06:2011-01-05]$ cd dcm-06
To run the actual scans....try:
[root@dcm-06:dcm-06]$ dcmDSOReadout --all --scan --csv -qx -f 400V
The output will appear as:
Openning 400V for output Opening file: 400V-FEB00.dat for scan output Scanning Front Endboard 0 Pixel: 0 Scanning Front Endboard 0 Pixel: 1 Scanning Front Endboard 0 Pixel: 2 ...
Continue until you have scanned all boards and pixels
When you have completed the scan of a DCM you will have files "400V-FEBXX.dat" (note: the base filename is what ever you passed in with the -f option, and the -FEBXX.dat is appended during the scan for each board you go through). These files contain the raw sample data and can be analyzed using a set of ROOT based macros (or loaded into anything you want that can read comma separated value files).
These macros are available on the DAQ cluster in the novadaq account under the subdirectory "Pedestal_Analysis_Macros". To use these macros, copy them to a machine that has ROOT installed on it. Edit the filename to analyze within the macro, and run it. For the single channel analysis macros, they will produce an array of pedestal plots (ped[n], where n is the pixel number) and a set of wave form graphs (waveform[n], where n is the pixel number).
The other macros produce similar data structures.