Define SCT byte stream errors and utility methods. More...

#include <array>
#include <vector>
#include <cstdint>

Include dependency graph for SCT_ByteStreamErrors.h:

This graph shows which files directly or indirectly include this file:

Namespaces
namespace	SCT_ByteStreamErrors

Macros
#define	SCT_ERRORTYPELIST(XYZ)
	Specifications of the data format and errors is found in [1] http://www-eng.lbl.gov/~jmjoseph/Atlas-SiROD/Manuals/usersManual-v164.pdf [2] http://cds.cern.ch/record/683741/files/ [3] https://twiki.cern.ch/twiki/bin/view/Atlas/SCTDaqErrors [4] https://twiki.cern.ch/twiki/bin/view/Atlas/ROBINFragmentErrors#Definition_of_the_first_status_e.
#define	SCT_DO_ENUM(e)
#define	SCT_DO_DESCRIPTION(e)

Enumerations
enum	SCT_ByteStreamErrors::ErrorType
	SCT byte stream error type enums used in SCT_RodDecoder, SCT_ByteStreamErrorsTool, SCTErrMonAlg. More...

Functions
template<ErrorType et>
static constexpr uint64_t	SCT_ByteStreamErrors::maskUpTo ()
static constexpr uint64_t	SCT_ByteStreamErrors::ABCDErrorMask ()
static constexpr uint64_t	SCT_ByteStreamErrors::TempMaskedChipsMask ()
ErrorType	SCT_ByteStreamErrors::TempMaskedChipToBit (const int chip)

Variables
static const std::vector< std::string >	SCT_ByteStreamErrors::ErrorTypeDescription
	SCT byte stream error type strings used in SCTErrMonAlg.
static const std::vector< ErrorType >	SCT_ByteStreamErrors::BadErrors
	Bad error enums used in SCT_ByteStreamErrorsTool and SCTErrMonAlg.
static const std::vector< ErrorType >	SCT_ByteStreamErrors::LinkLevelBadErrors
	Bad error enums in FE-link level used in SCTErrMonAlg.
static const std::vector< ErrorType >	SCT_ByteStreamErrors::RodLevelBadErrors
	Bad error enums in ROD level used in SCTErrMonAlg.
static const std::vector< ErrorType >	SCT_ByteStreamErrors::LinkLevelErrors
	Error enums in FE-link level used in SCTErrMonAlg (assigned by SCT_RodDecoder::addSingleError)
static const std::vector< ErrorType >	SCT_ByteStreamErrors::RodLevelErrors
	Error enums in ROD level used in SCTErrMonAlg (assigned by SCT_RodDecoder::addRODError)

Detailed Description

Define SCT byte stream errors and utility methods.

Author: Susum.nosp@m.u.Od.nosp@m.a@cer.nosp@m.n.ch

Definition in file SCT_ByteStreamErrors.h.

Macro Definition Documentation

◆ SCT_DO_DESCRIPTION

#define SCT_DO_DESCRIPTION ( e )

Value:

#e,

Definition at line 169 of file SCT_ByteStreamErrors.h.

◆ SCT_DO_ENUM

#define SCT_DO_ENUM ( e )

Value:

e,

Definition at line 165 of file SCT_ByteStreamErrors.h.

◆ SCT_ERRORTYPELIST

#define SCT_ERRORTYPELIST ( XYZ )

Specifications of the data format and errors is found in [1] http://www-eng.lbl.gov/~jmjoseph/Atlas-SiROD/Manuals/usersManual-v164.pdf [2] http://cds.cern.ch/record/683741/files/ [3] https://twiki.cern.ch/twiki/bin/view/Atlas/SCTDaqErrors [4] https://twiki.cern.ch/twiki/bin/view/Atlas/ROBINFragmentErrors#Definition_of_the_first_status_e.

The following is almost a copy of description of https://its.cern.ch/jira/browse/ATLASRECTS-4444

Link header : table 27 of [1] 001ptlbKdMMMMMMM d = link masked by DSP (MaskedLink) t = time out error (TimeOutError) p = Preamble Error (PreambleError) l = L1 error (LVL1IDError) b = BCID error (BCIDError) M = link number (FormatterError if M>11)

Link trailer : table 16 of [1] 010zhvxxxxxxmmmm z = trailer bit error (TrailerError) h = header trailer limit error (HeaderTrailerLimitError) v = data overflow error (HeaderTrailerLimitError) m = dynamically masked chips to reduced data size at high pileup Not written in [1]. (TempMaskedChipX, X=0-5)

0 means no masked chip (always has been 0 until April 2017)

If Rx redundacy is not used, 1 means chips 0-5 are temporarily masked. (TempMaskedChip0-TempMaskedChip5 in link-0) 6 means chip 5 is temporarily masked. (TempMaskedChip5 in link-0) 7 means chips 6-11 are temporarily masked. (TempMaskedChip0-TempMaskedChip5 in link-1) 12 means chip 11 is temporarily masked. (TempMaskedChip5 in link-1)

If Rx redundacy is used and link-1 is not used, 1 means chips 0-11 are temporarily masked. (TempMaskedChip0-TempMaskedChip5 in both link-0 and link-1) 6 means chips 5-11 are temporarily masked. (TempMaskedChip5 in link-0 and TempMaskedChip0-TempMaskedChip5 in link-1) 7 means chips 6-11 are temporarily masked. (TempMaskedChip0-TempMaskedChip5 in link-1) 12 means chip 11 is temporarily masked. (TempMaskedChip5 in link-1)

If Rx redundacy is used and link-0 is not used, 1 means chips 0-5 are temporarily masked. (TempMaskedChip0-TempMaskedChip5 in link-0) 6 means chip 5 is temporarily masked. (TempMaskedChip5 in link-0) 7 means chips 6-11, 0-5 are temporarily masked. (TempMaskedChip0-TempMaskedChip5 in both link-0 and -1) 12 means chips 11, 0-5 are temporarily masked. (TempMaskedChip0-TempMaskedChip5 in link-0 and TempMaskedChip5 in link-1)

ABCD error : table 16 of [1] 000xxxxxxFFFFEEE F = FE number (ABCDError_ChipX, ABCDError_Invalid) E = ABC error code (ABCDError_ErrorX, ABCDError_Invalid)

Raw data : table 16 of [1] 011nnnxxWWWWWWWW n = count of raw data bits + 1 W = raw data (RawError)

ByteStreamParseError When invalid data word is found, this BS error is assigned.

MissingLinkHeaderError When hit, ABCD error or raw data appear earlier than header, this BS error is assigned. Since we cannot know which FE-link does not have header, we assign this error to all the FE-links without hit, ABCD error or raw data of the ROD.

ROD status words : table 32 of [1] Bit 16 TIM Clock Error (RODClockError) Bit 17 BOC Clock Error (RODClockError) Bit 20-23 DCS HV bits (Expanded. Not written in [1])

ROB status word : [4] Non-zero status word (ROBFragmentError) Bit 31 Discard: the ROBIN did not have a fragment for the requested L1ID because it is in "discard" mode. It therefore generated an empty fragment Bit 29 Lost: the ROBIN did not have a fragment for the requested L1ID. It therefore generated an empty fragment (MaskedROD) Bit 27 Truncation: the amount of data sent across S-Link for this fragment was larger than the maximum fragment size the ROBIN was configured to handle. Therefore this fragment has been truncated (TruncatedROD)

The detector event type of ROB (do not know where these are documented) Bit 20 : RODSimulatedData Bit 21 : Super-condensed mode (not BS error)

For enum to string conversion http://stackoverflow.com/questions/21456262/enum-to-string-in-c11

Definition at line 125 of file SCT_ByteStreamErrors.h.

#define SCT_ERRORTYPELIST(XYZ) \
  XYZ(ByteStreamParseError)    \
  XYZ(TimeOutError)            \
  XYZ(BCIDError)               \
  XYZ(LVL1IDError)             \
  XYZ(PreambleError)           \
  XYZ(FormatterError)          \
  XYZ(TrailerError)            \
  XYZ(TrailerOverflowError)    \
  XYZ(HeaderTrailerLimitError) \
  XYZ(ABCDError)               \
  XYZ(RawError)                \
  XYZ(MaskedLink)              \
  XYZ(RODClockError)           \
  XYZ(TruncatedROD)            \
  XYZ(ROBFragmentError)        \
  XYZ(MissingLinkHeaderError)  \
  XYZ(MaskedROD)               \
  XYZ(ABCDError_Chip0)         \
  XYZ(ABCDError_Chip1)         \
  XYZ(ABCDError_Chip2)         \
  XYZ(ABCDError_Chip3)         \
  XYZ(ABCDError_Chip4)         \
  XYZ(ABCDError_Chip5)         \
  XYZ(ABCDError_Error1)        \
  XYZ(ABCDError_Error2)        \
  XYZ(ABCDError_Error4)        \
  XYZ(TempMaskedChip0)         \
  XYZ(TempMaskedChip1)         \
  XYZ(TempMaskedChip2)         \
  XYZ(TempMaskedChip3)         \
  XYZ(TempMaskedChip4)         \
  XYZ(TempMaskedChip5)         \
  XYZ(ABCDError_Error7)        \
  XYZ(ABCDError_Invalid)       \
  XYZ(RODSimulatedData)        \
  XYZ(NUM_ERROR_TYPES) // always have this one last, so we can use it as a loop index

Namespaces

Macros

Enumerations

Functions

Variables

Detailed Description

Macro Definition Documentation

◆ SCT_DO_DESCRIPTION

◆ SCT_DO_ENUM

◆ SCT_ERRORTYPELIST