Update documentation and changes to get system running at UVA

.gitignore

@@ -5,4 +5,12 @@
 *.cpp.b
 *.so
 *_C.d
-
+build
+*.swp
+*.bins
+*.idxf
+*.modf
+*.rawf
+*.trim
+*.root
+*.png

CMakeLists.txt

@@ -52,7 +52,11 @@ configure_file("src/petsys_util/acquire_qdc_calibration_fixed" "acquire_qdc_cali
 configure_file("src/petsys_util/acquire_sipm_data" "acquire_sipm_data" COPYONLY)
 configure_file("src/petsys_util/acquire_sipm_data_basic" "acquire_sipm_data_basic" COPYONLY)
 configure_file("src/petsys_util/acquire_sipm_data_scan" "acquire_sipm_data_scan" COPYONLY)
+configure_file("src/petsys_util/acquire_sipm_IV_scan" "acquire_sipm_IV_scan" COPYONLY)
+configure_file("src/petsys_util/acquire_sipm_stressTest" "acquire_sipm_stressTest" COPYONLY)
+configure_file("src/petsys_util/scan_aldo_hv" "scan_aldo_hv" COPYONLY)
 configure_file("src/petsys_util/convert.py" "convert.py" COPYONLY)
+configure_file("src/petsys_util/create_ALDO_calibration_combined.py" "create_ALDO_calibration_combined.py" COPYONLY)
 configure_file("src/petsys_util/make_bias_calibration_table" "make_bias_calibration_table" COPYONLY)
 configure_file("src/petsys_util/make_simple_bias_settings_table" "make_simple_bias_settings_table" COPYONLY)
 configure_file("src/petsys_util/make_simple_channel_map" "make_simple_channel_map" COPYONLY)

README

@@ -0,0 +1,128 @@
+TOFHIR2 Data Taking Instructions
+================================
+
+This repository contains code to calibrate and take data from TOFHIR2 chips.
+This README has instructions for how to install, calibrate, and take data.
+
+Installation
+------------
+
+    $ cd
+    $ mkdir tofhir
+    $ git clone https://github.com/Lab5015/sw_daq_tofhir2.git
+    $ git clone https://github.com/Lab5015/Lab5015Utils.git
+    $ sudo pip install minimalmodbus==1.0.1
+    $ sudo pip install simple-pid
+    $ git clone https://github.com/Lab5015/Lab5015Analysis.git
+    $ cd sw_daq_tofhir2
+    $ mkdir build
+    $ cd build
+    $ cmake ..
+    $ make -j4
+
+Running
+-------
+
+First, we need to start the daq daemon. Make sure you have all the correct
+power to the FEB/D.
+
+    $ cd ~/tofhir/sw_daq_tofhir2/build
+    $ rm /tmp/d.sock
+    $ rm /dev/shm/daqd_shm
+    $ ./daqd --socket-name /tmp/d.sock --daq-type GBE
+
+You should see the following output
+
+    Size of frame is 16384
+    Got FPGA reply
+    FrameServer::startWorker called...
+    FrameServer::startWorker exiting...
+    UDPFrameServer::runWorker starting...
+
+This command will continue running the whole time you are communicating with
+the FEB/D and/or TOFHIR. So now you should open a new terminal. Now, we can try
+to initialize the system:
+
+    $ cd ~/tofhir/sw_daq_tofhir2/build
+    $ python set_system_mode.py --mode tofhir2x
+
+or, if you are running with a TOFHIR2B:
+
+    $ python set_system_mode.py --mode tofhir2b
+
+Now, we can initialize the system:
+
+    $ ./init_system
+
+With one active ASIC connected, you should see the following:
+
+    INFO: active units on ports:  0
+    INFO: TGR unit is ( 0,  0)
+    INFO: FEB/D ( 0,  0) has  1 active ASICs: 0
+
+Now, we start the QDC, TDC, and threshold calibrations:
+
+    $ cd ~/tofhir/sw_daq_tofhir2/build
+    $ ./make_bias_calibration_table -o ../config/bias_calibration.tsv
+    $ ./make_simple_bias_settings_table --config ../config/config.ini --offset 0.0 --prebd 30 --bd 38.5 --over 3.5 -o ../config/bias_settings.tsv
+    $ sh ../configuration.template.sh ../config
+
+You should now see the following calibration files in the config directory:
+
+    bias_calibration.tsv           qdc_calibration.idxf
+    bias_settings.tsv              qdc_calibration.modf
+    config.ini                     qdc_calibration.rawf
+    disc_calibration_00_00_00.pdf  qdc_calibration.trim
+    disc_calibration_baseline.tsv  qdc_calibration.tsv
+    disc_calibration_dark.tsv      tdc_calibration_00_00_00.pdf
+    disc_calibration_noise.tsv     tdc_calibration_00_00_00.png
+    disc_calibration.root          tdc_calibration_00_00_00.root
+    disc_calibration.tsv           tdc_calibration.bins
+    disc_settings.tsv              tdc_calibration.idxf
+    qdc_calibration_00_00_00.pdf   tdc_calibration.modf
+    qdc_calibration_00_00_00.png   tdc_calibration.rawf
+    qdc_calibration_00_00_00.root  tdc_calibration.tsv
+    qdc_calibration.bins
+
+Next we do the ALDO calibrations. Run the following commands and physically
+connect the mutlimeter to the outputs of ALDO A and B as directed by the
+terminal output. Note that the IP address will depend on your specific setup;
+you can find it on a Keithley 2450 under MENU:Communication:IP Adress
+
+    $ cd ~/tofhir/sw_daq_tofhir2/build
+    $ ./scan_aldo_hv --config ../config/config.ini -o aldo_scan --keithley-model 2450 --keithley-ip-address 10.168.233.197
+    $ ./create_ALDO_calibration_combined.py aldo_scan_ASIC*tsv --dest-dir ../config
+
+scan_aldo_hv creates two tsv files for each ALDO in the current directory, and
+create_ALDO_calibration_combined combines tsv files to include all active ASICs
+and place the resulting files in dest-dir.
+
+Next we apply a constant bias to the SiPMs and observe the current. If you are
+injecting light with a laser, this can be used to estimate the number of pe.
+Connect the multimeter to measure voltage across the SiPM current measurement
+resistors for ALDO A and B in turn.
+
+    $ ./acquire_sipm_stressTest --config ../config/config.ini --bv 42 --ch 0 --time 10 --label test --asic 0 --aldoA --keithley-model 2450 --verbose
+    $ ./acquire_sipm_stressTest --config ../config/config.ini --bv 42 --ch 0 --time 10 --label test --asic 0 --aldoB --keithley-model 2450 --verbose
+
+To run an IV scan to determine the breakdown voltage of the SiPMs you can run
+the following commands. You will need to connect the multimeter to read across
+the SiPM current measurement resistors as before, and you may need to expose
+the SiPMs to light to get enough current:
+
+    $ ./acquire_sipm_IV_scan --config ../config/config.ini --aldo A --keithley-model 2450 --verbose --bvMin 36 --bvMax 39
+    $ ./acquire_sipm_IV_scan --config ../config/config.ini --aldo B --keithley-model 2450 --verbose --bvMin 36 --bvMax 39
+
+Based on the observed breakdown voltage, you can update ~/tofhir/sw_daq_tofhir2/config/bias_settings_aldo.tsv.
+
+We are now ready to take data. The following command will acquire data for one
+second at OV=3.5V while self-triggering on ith1:
+
+    $ python acquire_sipm_data_scan --config ../config/config.ini --time 1 --ith1 10 --ith2 1 --ithe 1 --ov 3.5 --trigger none --aldo --data-dir ../../data
+
+The data will be stored in the specified data directory, and the run number
+will be incremented automatically. You can then convert the data into a ttree
+with the following command. Note that the run number and data directory should
+be updated as needed.
+
+    $ python convert.py --config ../config/config.ini -r run0001 --mode e --data-dir ../../data/

README.md

@@ -0,0 +1 @@
+README

config/bias_settings_aldo.tsv

@@ -0,0 +1,5 @@
+#portID	slaveID	chipID	aldo Breakdown	Overvoltage
+0	0	0	A    38.50	3.50
+0	0	0	B    38.50	3.50
+0	0	2	A    38.50	3.50
+0	0	2	B    38.50	3.50

config/config.ini

@@ -0,0 +1,59 @@
+[main]
+bias_calibration_table =  %CDIR%/bias_calibration.tsv
+bias_settings_table = %CDIR%/bias_settings.tsv
+bias_settings_table_aldo = %CDIR%/bias_settings_aldo.tsv
+
+tdc_calibration_table = %CDIR%/tdc_calibration.tsv
+qdc_calibration_table = %CDIR%/qdc_calibration.tsv
+disc_calibration_table = %CDIR%/disc_calibration.tsv
+
+acquisition_mode_table = %CDIR%/acquisition_mode_settings.tsv
+#energy_calibration_table = %CDIR%/energy_calibration.tsv
+disc_settings_table = %CDIR%/disc_settings.tsv
+
+channel_map = %CDIR%/map_channel.tsv
+trigger_map = %CDIR%/map_trigger.tsv
+
+aldo_A_calibration = %CDIR%/aldo_scan_ALDO_A_high.tsv
+aldo_B_calibration = %CDIR%/aldo_scan_ALDO_B_high.tsv
+
+[hw_trigger]
+type = builtin
+threshold = 1
+pre_window = 3
+post_window = 15
+coincidence_window = 3
+single_fraction = 0
+
+[sw_trigger]
+coincidence_time_window = 20
+group_time_window = 20
+
+[asic_parameters]
+global.Valdo_A_Gain = 1
+global.Valdo_B_Gain = 1
+
+channel.cfg_a2_dcr_delay_t = 0b01111111
+channel.cfg_a2_dcr_delay_e = 0b1111111
+
+channel.cfg_a2_pulse_trim_t = 15
+channel.cfg_a2_pulse_trim_e = 19
+
+channel.cfg_a2_attenuator_gain = 0
+
+channel.c_max_v_en = 0
+channel.c_min_q = 5
+channel.c_max_q = 5
+
+# using t1 for timing
+channel.cfg_a3_range_t1 = 1
+channel.cfg_a3_range_t2 = 3
+channel.c_tgr_t1 = 0b00
+channel.c_tgr_q = 0b00
+channel.c_tgr_t2 = 0b00
+channel.c_tgr_V = 0b00
+channel.c_tgr_B = 0b000
+
+# pre-amp scaling; uncomment when running with TOFHIR2B
+#channel.cfg_a1_scaling = 1
+