Definition:

The configuration package contains a large set of parameters which can be used to control the configuration of the front-end and the simulation conditions

Configuration:

Bunch Structure configuration

Bunch_Period : time
Time between bunches in ns. (25ns)

Bunch_Structure_Enable : boolean
Enable of LHCb Bunch structure. (true)

Bunch_Count : integer
Number of bunch periods in LHC machine cycle ( including both active and non-active bunches), (3564)

Bunch_Group_Size : integer
Number of consecutive active bunches. (78)

Bunch_Low_Group_Gap : integer
Number of missing bunches in small sized gap. (11)

Bunch_Medium_Group_Gap : integer
Number of missing bunches in medium sized gap. (41)

Bunch_High_Group_Gap : integer
Number of missing bunches in large sized gap. (130)

Bunch_ID_Width : integer
Number of bits in Bunch_ID. (12)

Detector Channel configuration

Detector_Resolution : integer
Number of equivalent bits in detector signal. (8)

Detector_Occupancy : real
Percentage of real bunch collisions generating detector signal. (0.1% to 10%)

Detector_Min_Amplitude : real
Minimum amplitude of signal caused by passing particle. (3.0)

Detector_Max_Amplitude : real
Maximum amplitude of signal caused by passing particle. (255.0)

Detector_Noise_Amplitude : real
Root mean square noise amplitude. (1.0)

Detector_Delay : time
Delay from bunch crossing in ns (particle flight time + detector + analog front-end) (0)

(Detector_Type: Type of signal shape, Not yet implemented.)

Detector_Signal_Width : integer
Width of signal pulse in clock cycles (5). (Not yet fully implemented)

Detector_Sample_Period : time
Time between generated samples in ns (25ns). (Not yet fully implemented)

Detector_Debug_Mode_Enable : boolean
Enable of channel debug mode (false). In this mode the channel continously generates a signal value equal to its channel ID.

L0 Buffer configuration

L0_Samples : integer
Number of samples to extract per L0 trigger. (1,2 or 4), (1).

L0_Buffer_Width : natural := Detector_Resolution*L0_Samples
Number of data bits. Calculated from other configuration parameters.

L0_Buffer_Latency : integer
Latency of L0 trigger in number of clock cycles. (160 = 4us)

L0_Event_Number_of_Words : integer
Number of data words per L0 event. (34)

L0_Derandomizer_Depth : integer
Depth of derandomizer buffer in number of events. (16)

L0_Derandomizer_Readout_Cycles : integer
Number of clock cycles to readout event from derandomizer. (36)
(Included in L0 buffer in first priliminary model)

L0_Derandomizer_Occupancy_File_Name : string
Name of file where to dump information about L0 derandomizer occupancy.

L0_Derandomizer_Monitoring_File_Name : string
Name of file where to dump information about L0 derandomizer parameters.

L0_Derandomizer_Histogram_File_Name : string
Name of file where to dump information about L0 derandomizer occupancy.

L0 Trigger Generator configuration

L0_Trigger_Latency : integer
Latency of trigger decision in number of clock cycles. (128)

L0_Rejection_Ratio : real
Ratio between rejected L0 events and accepted L0 events. (29.6)

Event_ID_Width : integer
Definition of number of bits in event ID. (12)

L0_Limit_Derandomizer_Depth :
Limiting derandomizer depth. (15)
(Included in first preliminary L0 trigger model. Belongs in trigger supervisor)

L0_Limit_Derandomizer_Readout_Cycles : integer
Limiting derandomizer readout cycles. (34)
(Included in first preliminary L0 trigger model. Belongs in trigger supervisor)

L0_Limit_Gap : integer
Limiting L0 trigger gap. (0)
(Included in first preliminary L0 trigger model. Belongs in trigger supervisor)

L0_Overflow_Controller_Enable : boolean
Enabling/disabling of the L0 electronics overflow controller

L0_Overflow_Controller_Fixed_Cycle_Enable : boolean
If this mode is enable, the readout cycle is always a multiple of the derandomizer readout cycle. (enabled)

L0_Monitoring_File_Name : string
Name of file to dump monitoring information about L0 triggers.

Multiplexer Controller configuration

Readout_Fixed_Cycle_Enable : boolean := False;
If this mode is enable, the readout cycle is always a multiple of the derandomizer readout cycle. (enabled)

L1 Trigger Generator configuration

L1_Overflow_Controller_Enable : boolean
Enabling/disabling of the L1 electronics overflow controller.

L1_Trigger_Min_Latency : real
Minimum L1 trigger latency in clock cycles. (1280.0 = 32us)

L1_Trigger_Max_Latency : real
Maximum L1 trigger latency in clock cycles.

L1_Latency_File_Name : string
Name of file to dump information about the L1 trigger latency before the trigger reorganization.

L1_Rejection_Ratio : real
Ratio between rejected L1 events and accepted L1 events. (25.0)

Global_L1_Derandomizer_Depth : integer
Depth of derandomizer buffer in number of triggers. (1024)

Global_L1_Derandomizer_Readout_Cycles : integer
Number of clock cycles to readout triggers from derandomizer. (34)

Global_L1_Derandomizer_Occupancy_File_Name : string
Name of file where to dump information about Global L1 derandomizer occupancy.

Global_L1_Derandomizer_Monitoring_File_Name : string
Name of file where to dump information about Global L1 derandomizer parameters.

Global_L1_Derandomizer_Histogram_File_Name : string
Name of file where to dump information about Global L1 derandomizer occupancy.

L1 Buffer configuration

Local_Event_ID_Generator_Enable : boolean
Enabling/disabling of the Local Event_ID generator.

Local_L1_Derandomizer_Enable : integer
Enabling/disabling of the Local L1 derandomizer.

Local_L1_Derandomizer_Depth : integer
Depth of derandomizer buffer in number of triggers. (32)

Local_L1_Derandomizer_Occupancy_File_Name : string
Name of file where to dump information about Local L1 derandomizer occupancy.

Local_L1_Derandomizer_Monitoring_File_Name : string
Name of file where to dump information about Local L1 derandomizer parameters.

Local_L1_Derandomizer_Histogram_File_Name : string
Name of file where to dump information about Local L1 derandomizer occupancy.

L1_Buffer_Depth : integer := 1024*L0_Event_Number_of_Words;
Depth of L1 buffer in number of event words.

L1_Buffer_Occupancy_File_Name : string
Name of file where to dump information about L1 Buffer occupancy.

L1_Buffer_Histogram_File_Name : string
Name of file where to dump information about L1 Buffer occupancy.

L1_Buffer_DPM_Mode_Enable : boolean
If true, the L1 Buffer works as a DPM else it works as a FIFO.

ID_Checker_File_Name : string
Name of file where to dump information about synchronization failures.

L1 Accepted Derandomizer configuration

L1_Accepted_Occupancy_Control : boolean
If true, the L1 Accepted derandomizer occupancy is controlled by the L1 Buffer controller.

L1_Accepted_Derandomizer_Depth : integer := 16*L0_Event_Number_of_Words;
Depth of derandomizer buffer in number of event words.

L1_Accepted_Derandomizer_Readout_Cycles : integer := 8*L0_Event_Number_of_Words; (6.8us)
Number of clock cycles to readout events from derandomizer.

L1_Accepted_Derandomizer_Occupancy_File_Name : string
Name of file where to dump information about L1 Accepted derandomizer occupancy.

L1_Accepted_Derandomizer_Monitoring_File_Name : string
Name of file where to dump information about L1 Accepted derandomizer parameters.

L1_Accepted_Derandomizer_Histogram_File_Name : string
Name of file where to dump information about L1 Accepted derandomizer occupancy.

Monitoring parameters

Clock_Cycles_Between_Writings : integer
Controls the Histogram file dumping frequency.

Debuger_On : boolean
If true, the Monitor and Occupancy files are written.

Checker_On : boolean
If true, the ID_Checker file is written.

Auto_On : boolean
If true, the Histogram file is written.

Error check & recovering

L0_Error_Register_Width : integer
Number of bits of the L0 error register. (8)

L1_Error_Register_Width : integer
Number of bits of the L1 error register. (8)

Zero suppression & data format

Zero_Suppression_Enable : boolean
If true, the event data is zero-suppressed before being sent to the DAQ system.

Zero_Suppression_Threshold : integer
Threshold level for the zero-suppression. (2)

Formated_Data_Width : natural
Number of bits of the formated data word (32).

Output_Buffer_Depth : integer
Depth of Output Buffer in number of event words. (10000)

Last_Word_Count_FIFO_Depth : integer
Depth of the FIFO that stores the wordcounts in number of words. (256)

Output_Buffer_Occupancy_File_Name : string
Name of file where to dump information about Output Buffer occupancy.

Output_Buffer_Monitoring_File_Name : string
Name of file where to dump information about Output Buffer parameters.

Output_Buffer_Histogram_File_Name : string
Name of file where to dump information about Output Buffer occupancy.