Constellation#

title: “AidaTLU” description: “Satellite for the AIDA-2020 TLU using a Python-based control software” category: “Readout Systems” language: “Python” parent_class: “TransmitterSatellite” —————————————————————————————————————————————————————————————–

Description#

The AIDA-2020 Trigger Logic Unit is designed to provide flexible trigger configurations in test beam setups (doi.org/10.48550/arXiv.2005.00310).

The Python-based control software for the AIDA-2020 TLU provides a comprehensive interface for controlling the TLU. The software establishes a connection to the hardware and allows for easy configuration of different trigger setups.

The satellite connects the AIDA-2020 TLU to the Constellation control and data acquisition framework.

Building#

Install the Aida-TLU package with the constellation and hw requirement:

pip install aidatlu[constellation,hw]

Building the ControlHub from the IPbus software is required for connection with the TLU.

Usage#

Start the ControlHub:

/opt/cactus/bin/controlhub_start

Finally, start the satellite with:

SatelliteAidaTLU -g testbeam -n TLU

The TLU configuration resets during launching and landing.
This means DUT interface signals (e.g. clock signals) are disrupted during these transitions.

Parameters#

Configuration	Description	Type	Default Value
`internal_trigger_rate`	(Optional) Generates internal triggers with a given frequency given in Hz.	Integer	0
`dut_interfaces`	(Required) Specify the operation mode of the DUT interface (`aida`, `eudet`, `aidatrig`, `off`), given as list with a required length of 4. `aida` and `eudet` correspond to the classic AIDA and EUDET mode respectively and `aidatrig` to the AIDA-mode with handshake. Disable a DUT interface with `off`.	List	None
`ignore_busy`	(Optional) Specific DUT interface ignores busy signals.	List	`[false, false, false, false]`
`trigger_threshold`	(Required) Threshold setting of each individual trigger input channel given in V.	List	None
`trigger_inputs_logic`	(Required) Trigger Logic configuration accepts a Python expression for the trigger inputs. The logic is set by using the variables for the input channels `CH1`, `CH2`, `CH3`, `CH4`, `CH5` and `CH6` and the Python logic operators `and`, `or`, `not` and so on. Don’t forget to use brackets…	String	None
`trigger_polarity`	(Optional) TLU can trigger on a rising or falling edge. Set to `rising` or `falling`	String	`falling`
`trigger_signal_stretch`	(Required) Stretches each individual trigger input by a given number of clock cycles (corresponds to `6.25ns` steps)	List	None
`trigger_signal_delay`	(Required) Delays each individual trigger input by a given number of clock cycles (corresponds to `6.25ns` steps)	List	None
`enable_clock_lemo_output`	(Optional) Enable the LEMO clock output.	String	False
`pmt_power`	(Required) Sets the four PMT control voltages in V	List	None
`clock_config`	(Optional) Specify a custom clock configuration. If no path is provided, the TLU uses the default configuration.	String	None
`status_interval`	(Optional) Set status calculation interval in seconds. Affects logging and calculation interval (pre and post trigger rates).	float	1

The default clock configuration can be found in aidatlu/misc/aida_tlu_clk_config.txt.

Configuration Example#

An example configuration for the AIDA-TLU satellite which could be dropped into a Constellation configuration as a starting point:

[AidaTLU.2020]

internal_trigger_rate = 0
dut_interfaces = ['aida', 'aidatrig', 'eudet', 'off']

trigger_threshold = [-0.1, -0.1, -0.1, -0.1, -0.1, -0.1]
trigger_inputs_logic = 'CH1 and CH2'
trigger_polarity = 'falling'
trigger_signal_stretch = [2, 2, 2, 2, 2, 2]
trigger_signal_delay = [0, 0, 0, 0, 0, 0]

pmt_power = [0.8, 0.8, 0.0, 0.0]

enable_clock_lemo_output = false

Metrics#

The following metrics are distributed by this satellite and can be subscribed to. Timed metrics provide an interval in units of time, triggered metrics in number of calls.

Metric	Description	Value Type	Interval
`PRE_VETO_RATE`	Trigger rate after trigger logic (before DUT veto) in Hertz	Float	1s
`POST_VETO_RATE`	Outgoing trigger rate to the devices (after DUT veto) in Hertz	Float	1s
`TOTAL_PRE_VETO`	Total number of pre veto trigger	Integer	1s
`TOTAL_POST_VETO`	Total number of post veto trigger	Integer	1s
`SC1`	Total number that trigger input 1 received a valid signal	Integer	1s
`SC2`	Total number that trigger input 2 received a valid signal	Integer	1s
`SC3`	Total number that trigger input 3 received a valid signal	Integer	1s
`SC4`	Total number that trigger input 4 received a valid signal	Integer	1s
`SC5`	Total number that trigger input 5 received a valid signal	Integer	1s
`SC6`	Total number that trigger input 6 received a valid signal	Integer	1s

Data#

This satellite sends the raw data read from the TLU FIFO, consisting of six 32bit words with the following data:

event type: (word0 >> 28) & 0xf
trigger flag, input 0: (word0 >> 16) & 0x1
trigger flag, input 1: (word0 >> 17) & 0x1
trigger flag, input 2: (word0 >> 18) & 0x1
trigger flag, input 3: (word0 >> 19) & 0x1
trigger flag, input 4: (word0 >> 20) & 0x1
trigger flag, input 5: (word0 >> 21) & 0x1
timestamp: ((word0 & 0x0000ffff) << 32) + word1
fine timestamp, input 0: (word2 >> 24) & 0xff
fine timestamp, input 1: (word2 >> 16) & 0xff
fine timestamp, input 2: (word2 >> 8) & 0xff
fine timestamp, input 3: word2 & 0xff
fine timestamp, input 4: (word4 >> 24) & 0xff
fine timestamp, input 5: (word4 >> 16) & 0xff
event number: word3

The AIDA-TLU satellite can be tested using a TLU mock. By default, the hardware will be used, but the mock can be selected using an environmental variable.

`sh TLU_MOCK=True SatelliteAidaTLU -g some_group -n TLU `

This Page