Difference between revisions of "Compton Counting DAQ Software HOWTO"

Revision as of 12:04, 3 December 2019 (view source) Moffit (Talk | contribs) (→‎Machines in use) ← Older edit		Revision as of 17:19, 11 December 2019 (view source) Braydo (Talk | contribs) Newer edit →
Line 76:		Line 76:
	source ${HOME}/env/setupCODA		source ${HOME}/env/setupCODA
		+
		+	== Compton Trigger ==
		+
		+	=== VTP Trigger Parameters ===
		+	These parameters are set in a config file (e.g. params/vtp/hallcvtp.cnf):
		+	=== <code>VTP_COMPTON_FADC_THRESHOLD <threshold></code> ===
		+	<threshold> 0 to 8191 (units are FADC after pedestal and gain correction). It is the minumum required FADC pulse integral to be accepted for triggering (pedestal and gain parameters are setup on the FADC module). Used in trigger bit 0.
		+	=== <code>VTP_COMPTON_VETROC_WIDTH <width></code> ===
		+	<width> 0 to 1000 (units are ns). It is pulse width used for VETROC hits in the trigger logic for coincidence.
		+	=== <code>VTP_COMPTON_EPLANE_MULT_MIN <mult_min></code> ===
		+	<mult_min> 0 to 7. It is the minimum number of electron planes to have a hit used in trigger bit 0
		+	=== <code>VTP_COMPTON_WIDTH <width></code> ===
		+	<width> 0 to 1000 (units are ns). It is the pulse width the VTP sends to the TS whenever a trigger is satisfied.
		+	=== <code>VTP_COMPTON_LATENCY <latency></code> ===
		+	<latency> 0 to 8000 (units are ns). It is the trigger latency (~time from when a signal goes into the FADC or VETROC to when the VTP would create a trigger pulse that goes to the TS).
		+	=== <code>VTP_COMPTON_PRESCALE <trgbit> <prescale></code> ===
		+	<trgbit> 0 to 4. Selects the trigger bit to apply the <prescale> to.
		+	<prescale> 0 to 65535. 0 disables the trigger output. 1-65535 divides the output trigger be <prescale>.
		+
		+	=== <code>Trigger bit definitions</code> ===
		+	trgbit0: (fadc_pulse_integral >= VTP_COMPTON_FADC_THRESHOLD) && (multiplicity(hit_electron_planes) >= VTP_COMPTON_EPLANE_MULT_MIN)
		+	trgbit1: hit_electron_plane_1
		+	trgbit1: hit_electron_plane_2
		+	trgbit1: hit_electron_plane_3
		+	trgbit1: hit_electron_plane_4
	== Stuff to finish ==		== Stuff to finish ==

---

Revision as of 17:19, 11 December 2019

CODA scripts

These scripts are located in compton@compton2:$HOME/bin/

Frontend scripts to use on compton@compton2

startCoda

• executes each CODA component (platform, rcgui, PEB, all ROCs) in a separate xterm

restartStuff

• kills and restarts the PEB and ROCs. The xterms are not killed with this script.

kcoda

• kills all CODA components

Backend scripts, called by the frontend scripts

remote_vme

• script that restarts an ssh connection if it is closed.

PEB_compton2

• script that launches coda_emu_peb. restarts it when it is killed.

ROC_acomp1

• script that uses remote_vme to launch SBS_startroc.sh on acomp1

ROC_hallcvtp

• script that uses remote_vme to launch SBS_startroc.sh on hallcvtp

SBS_startroc.sh

• script on acomp1, hallcvtp that launches coda_roc with a ROC name determined from it's hostname.

kill_remotes.sh

• kills off ROC_acomp1, ROC_hallcvtp, and coda_roc on acomp1 and hallcvtp.

Useful stand-alone programs

tiLibTest

/home/coda/3.10/linuxvme/ti/test/tiLibTest <TI slot number>

• Test triggering capabilities of the local TI.

- Puts the local TI in master mode (with no slaves).

- Accepts triggers either from Front Panel TSinputs or Internal Random Pulser

vme_display

/home/coda/3.10_i686/linuxvme/Linux-i686/bin/vme_display <VME Address> <read size in bytes>

• Display the read value of specified size from the specified VME address.

- Run without arguments for usage

vme_modmem

/home/coda/3.10_i686/linuxvme/Linux-i686/bin/vme_modmem <VME Address> <read/write size in bytes>

• Modify the value of specified size of the specified VME address.

- Run without arguments for usage

Machines in use

compton2

• NFS server for coda and a-compton home directory.

• CODA and hardware drivers in /home/coda/

• DAQ Computer (RunControl, Event Building)

acomp1

• VME Controller

• 'root' login
• Slots 3: fADC250
• Slots 13-16: vetroc
• Slot 21: TI

hallcvtp

• VTP in Switch Slot B

• 'root' login

Updated/Cloned New repos in /home/acompdaq/src/

github links (team:coda-user):

• dma_memalloc
• linuxvme/fadc-HallB
• linuxvme/vetroc
• vtp

CODA environment setup script

Using BASH, source the environment setup script:

source ${HOME}/env/setupCODA

Compton Trigger

VTP Trigger Parameters

These parameters are set in a config file (e.g. params/vtp/hallcvtp.cnf):

VTP_COMPTON_FADC_THRESHOLD <threshold>

  <threshold> 0 to 8191 (units are FADC after pedestal and gain correction). It is the minumum required FADC pulse integral to be accepted for triggering (pedestal and gain parameters are setup on the FADC module). Used in trigger bit 0.

VTP_COMPTON_VETROC_WIDTH <width>

  <width> 0 to 1000 (units are ns). It is pulse width used for VETROC hits in the trigger logic for coincidence.

VTP_COMPTON_EPLANE_MULT_MIN <mult_min>

  <mult_min> 0 to 7. It is the minimum number of electron planes to have a hit used in trigger bit 0

VTP_COMPTON_WIDTH <width>

  <width> 0 to 1000 (units are ns). It is the pulse width the VTP sends to the TS whenever a trigger is satisfied.

VTP_COMPTON_LATENCY <latency>

  <latency> 0 to 8000 (units are ns). It is the trigger latency (~time from when a signal goes into the FADC or VETROC to when the VTP would create a trigger pulse that goes to the TS).

VTP_COMPTON_PRESCALE <trgbit> <prescale>

  <trgbit> 0 to 4. Selects the trigger bit to apply the <prescale> to.
  <prescale> 0 to 65535. 0 disables the trigger output. 1-65535 divides the output trigger be <prescale>.

Trigger bit definitions

  trgbit0: (fadc_pulse_integral >= VTP_COMPTON_FADC_THRESHOLD) && (multiplicity(hit_electron_planes) >= VTP_COMPTON_EPLANE_MULT_MIN)
  trgbit1: hit_electron_plane_1
  trgbit1: hit_electron_plane_2
  trgbit1: hit_electron_plane_3
  trgbit1: hit_electron_plane_4

Stuff to finish

compton daq account

• Update /etc/passwd on relevant OS's
• Update id/gid permission settings on relevant directories.

Log CODA runs to logbook

remex

$CODA/Linux-i686/bin/remex <remexHost> <function call>

• Execute a function call on the specified remote Host

- Run without arguments for usage