Testing using ITSDAQ

Install ITSDAQ

https://twiki.cern.ch/twiki/bin/view/Atlas/StripsUpgradeDAQInstall

Installation

#Dependencies

• sudo yum install boost-devel

#Download software

• git clone https://gitlab.cern.ch/atlas-itk-strips-daq/itsdaq-sw.git

#change directory to itsdaq-sq

• cd itsdaq-sw

#For choosing a particular git commit, use this command:

• git checkout cb92ccb4

Here cb92ccb4 is the commit number (as can be seen on the git history page https://gitlab.cern.ch/atlas-itk-strips-daq/itsdaq-sw/-/commits/master/ )

#Going back to the master:

• git checkout master

#Linux install

• python3 waf configure
• python3 waf build
• python3 waf install

or

• python3 waf clean install

#create sctvar directory

• mkdir /home/atlas-itk2/disk1/sctvar

##set environment variables for all users:

• ##/etc/profile.d/itk-env.sh
• ##- add new commands in this file (as sudo using emacs)
• export SCTDAQ_ROOT=/home/atlas-itk2/disk1/itsdaq-sw
• export SCTDAQ_VAR=/home/atlas-itk2/disk1/sctvar
• export ITSDAQ_LOCATION='Liverpool'
• export ITSDAQ_DB_INSTITUTE='LIV'

#create sub-directories in sctvar

• mkdir /home/atlas-itk2/disk1/sctvar/config /home/atlas-itk2/disk1/sctvar/data /home/atlas-itk2/disk1/sctvar/etc /home/atlas-itk2/disk1/sctvar/ps /home/atlas-itk2/disk1/sctvar/results

#create desktop link to sctvar

• ln -s $SCTDAQ_VAR /home/atlas-itk2/Desktop/sctvar

#copy old config files into new config directory in sctvar

#copy link to run to itsdaq onto desktop

• https://teonotebook.wordpress.com/2019/03/14/create-a-desktop-shortcut-in-centos-7/

#modify /home/atlas-itk2/disk1/itsdaq-sw/macros/parameters.h

ITSDAQ with Keithley

Following Instructions provided by Luise:

• how to read out power supplies through ITSDAQ.txt: HV suppy ITSDAQ (Luise)

HV Supply

• Connect Power supply to PC, it should now be visible in /dev/serial/by-id (e.g. usb-Prolific_Technology_Inc._USB-Serial_Controller_D-if00-port0 from the usb-to-serial connector)
• in 'itsdaq-sq/macros/Stavelet.cpp' ensure 'hvtype = -1' is set
• Change Keithley menue to serial communication and set baud rate:
  • Keithley: Menu -> Communication -> RS232
  • Keithley: Menu -> Communication -> RS232 -> Baud -> 9600
  • Further Keithley settings: data bits = 8, parity = none, terminator = <cr>, flow control = NONE
• settin up the communication (assuming the Keithley is connected to ttyUSB0
  • sudo chmod 666 /dev/ttyUSB0
  • sudo stty -F /dev/ttyUSB0 ispeed 9600 cs8 -cstopb -parenb -ixon
  • sudo stty -F /dev/ttyUSB0
    • -> check that buad really is 9600
• set up 'power_supplies.json' in 'sctvar/config'
  • if file is not there, can copy a template from 'itsdaq-sw/config'
  • power_supplies.json: HV-Supply Json file
    • output defines which connectors are active: 0 for front, 1 for back

LV Supply

Alternative Instructions:

• Glasgow talk: LV & HV supply to ITSDAQ: https://indico.cern.ch/event/1011149/contributions/4243300/attachments/2196808/3714505/A_Blue_Glasgow.pdf
• https://atlas-strips-itsdaq.web.cern.ch/build_options.html
• https://twiki.cern.ch/twiki/bin/viewauth/Atlas/ITSDAQHvLvInterlock

• ITSDAQ-HV_UK-Discussion.txt: UK ITSDAQ HV with niVisa

• Keithley: RS232
• TTI: USB Type B

Update ITSDAQ

• cd $SCTDAQ_ROOT
• git pull

#For choosing a particular git commit, use this command:

• git checkout cb92ccb4

Here cb92ccb4 is the commit number (as can be seen on the git history page https://gitlab.cern.ch/atlas-itk-strips-daq/itsdaq-sw/-/commits/master/ )

• sudo yum install boost-devel

• python3 waf configure #this step is not always necessary depending on what has changed
• python3 waf install

ITSDAQ Issues

Full test crashes ITSDAQ

Caused by and issue in the GUI script that executes the full test

• open itsdaq-sq/macros/STGUICommon.cpp
• search for "ABCStarFullTest()"
• change code:

old

#ifndef ITSDAQ_ROOT6_DEFINE
gROOT->ProcessLine(".L abc_star/StandardTests.cpp");
#else
loadmacro("abc_star/StandardTests");
#endif
gROOT->ProcessLine("ABCStarFullTest();");

new

loadmacro("abc_star/StandardTests");
gROOT->ProcessLine("ABCStarFullTest();");

ITSDAQ Usage

Autoconfig

Let ITSDAQ automatically download and create the config files for hybrids

https://docs.google.com/presentation/d/1DD2VgvwdBLEvlVhigQS_S_mh89LrH3-U8EgsRd3cjyE/edit#slide=id.g237fb8842e4_7_40

Chip Assembly

Using the results of a test to assemble ABC and HCC chips to a hybrid

Use Script from: https://gitlab.cern.ch/atlas-itk/sw/db/production_database_scripts/-/tree/AsicAssemblyAndConfig/strips/modules?ref_type=heads

ASIC assembly to a panel: assembleHybridsByFuseIDs.py

IV Scans

Taking IV with ITSDAQ tutorial: https://indico.cern.ch/event/1084324/contributions/4558877/attachments/2332120/3974567/IVScaninningandUploadingTutorial.pdf

IV Procedure specification: https://edms.cern.ch/document/2647669

(outdated) Check out a branch on an existing ITSDAQ installation:

• git checkout IVScanEmilyUpdates

or more explicitly

• git checkout origin/IVScanEmilyUpdates –b IVScanEmilyUpdates
  • does not work!

(IV scan is now merged into master)

Configuration of IV scan

• create an IV scan configuration file in itsdaq/config
  • Name: IVScanConfig.txt
  • Example: IVScanConfig.txt
  • Chane entries corresponding to tested object, they are printed to output file and are important for database upload

Name	Value	Comment
Rshunt:	0.00 MOhm	optional, if shunt resistor is used
R_series:	14.3 MOhm	Series resistor: 1 MOhm for bare sensor or module without powerboard, ... for module with powerboard
TestType:	ATLAS18_IV_TEST_V1	CODE of test in DB
Type:	ATLAS18R1 Sensor	Name
Software type and version, fw version:	ITSDAQ	describe used software/hardware
Vbias_SMU:	Keithley 2410	High voltage supply
Institute:	LIV	Institute Code
Test_DMM:	none	optional if a DMM is used for current measurement

For every test:

• Set Powersuply limit to -700V if bare sensors are measured: HVSupplies[0]->SetLimit(-700);

• Update IVSvenConfig.txt in config directory
• Run ITSDAQ for tests:
  • Run Test (from DCS menu, see slides)
    • Fiel with useful database codes to complete the GUI fields: Module_IV_Help
    • files are saved in sctvar/results as dat files
      • Sensor_Batch_W00999_IV_666.dat: Example File for Sensor IV Scan
      • 20USBXX9999999_MODULE_STAGE_IV_667.dat: Example File for Module IV Scan (without Powerboard)
• Upload Test to Database, e.g. using Kenny's Streamlit Web App (http://uk-itk-pdb-webapp-strips.web.cern.ch/)

* plotIV.cpp: updated file for IV test (should be merged to branch soon)

Liverpool Software

https://gitlab.cern.ch/atlas-itk-production-software/strips/liverpool-scripts/liverpool-itsdaq-scripts

installation:

Go to the directory in which the git code should be installed

• git clone https://gitlab.cern.ch/atlas-itk-production-software/strips/liverpool-scripts/liverpool-itsdaq-scripts.git

Update:

• go to directory where the code was downloaded in
• git pull

Useful Links

• Production Database: https://itkpd-test.unicorncollege.cz/
• Google drive: https://drive.google.com/drive/u/0/folders/1e5STNgiWFjGmJ55967PuShWbqHHdegzo
  • needs LSDC google account credentials
• Strip TWiki: https://twiki.cern.ch/twiki/bin/view/Atlas/ITkStrips
• Database TWiki: https://twiki.cern.ch/twiki/bin/view/Atlas/ITKProductionDatabase
• Strip Indico: https://indico.cern.ch/category/5333/

• ITk Docs: https://itk.docs.cern.ch/
• ITSDAQ: https://atlas-strips-itsdaq.web.cern.ch/ltt_testing.html#hybrid-burnin
• EDMS: https://edms.cern.ch/ui/#!master/navigator/project?P:1563561654:1563561654:subDocs

• Git Repositories
  • https://gitlab.cern.ch/atlas-itk-production-software/common-interfaces/google_sheets_with_python
  • https://gitlab.cern.ch/gdyckes/metrologyanalysis
  • https://gitlab.cern.ch/swonsak/database-batches
  • https://gitlab.cern.ch/swonsak/liverpool-core-assembly
  • https://gitlab.cern.ch/swonsak/liverpool-itsdaq-scripts
  • https://gitlab.cern.ch/swonsak/liverpool-pixel-sandwich
  • https://gitlab.cern.ch/swonsak/liverpool-strip-scripts
  • https://gitlab.cern.ch/swonsak/liv_utility

-- SvenWonsak - 27 May 2025