|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
|
#ifndef L1GlobalTrigger_L1GtfeExtWord_h
#define L1GlobalTrigger_L1GtfeExtWord_h
/**
* \class L1GtfeExtWord
*
*
* Description: L1 Global Trigger - extended GTFE block in the readout record.
*
* Implementation:
* <TODO: enter implementation details>
*
* \author: Vasile Mihai Ghete - HEPHY Vienna
*
*
*/
// system include files
#include <vector>
#include <iosfwd>
// user include files
#include "FWCore/Utilities/interface/typedefs.h"
// base class
#include "DataFormats/L1GlobalTrigger/interface/L1GtfeWord.h"
// forward declarations
// class declaration
class L1GtfeExtWord : public L1GtfeWord {
public:
/// constructors
L1GtfeExtWord(); // empty constructor, all members set to zero;
/// all members set to zero, m_bst has bstSizeBytes zero elements
L1GtfeExtWord(int bstSizeBytes);
/// constructor from unpacked values, m_bst size taken from bstValue
L1GtfeExtWord(cms_uint16_t boardIdValue,
cms_uint16_t recordLengthValue,
cms_uint16_t recordLength1Value,
cms_uint16_t bxNrValue,
cms_uint32_t setupVersionValue,
cms_uint16_t activeBoardsValue,
cms_uint16_t altNrBxBoardValue,
cms_uint32_t totalTriggerNrValue, // end of L1GtfeWord
const std::vector<cms_uint16_t>& bstValue,
cms_uint16_t bstSourceValue);
/// destructor
~L1GtfeExtWord() override;
/// equal operator
bool operator==(const L1GtfeExtWord&) const;
/// unequal operator
bool operator!=(const L1GtfeExtWord&) const;
public:
/// get the full BST block
inline const std::vector<cms_uint16_t>& bst() const { return m_bst; }
/// get the size of the BST block
inline const unsigned int bstLengthBytes() const { return m_bst.size(); }
public:
/// LHC-BOB-ES-0001 (EDMS 638899)
const cms_uint64_t gpsTime() const;
void setGpsTime(const cms_uint64_t);
const cms_uint16_t bstMasterStatus() const;
const cms_uint32_t turnCountNumber() const;
const cms_uint32_t lhcFillNumber() const;
const cms_uint16_t beamMode() const;
const cms_uint16_t particleTypeBeam1() const;
const cms_uint16_t particleTypeBeam2() const;
const cms_uint16_t beamMomentum() const;
const cms_uint32_t totalIntensityBeam1() const;
const cms_uint32_t totalIntensityBeam2() const;
public:
/// get/set BST block for index iB
const cms_uint16_t bst(int iB) const;
void setBst(const cms_uint16_t bstVal, const int iB);
/// set the BST block for index iB from a 64-bits word
void setBst(const cms_uint64_t& word64, const int iB);
/// set the BST block in a 64-bits word, having the index iWord
/// in the GTFE raw record
void setBstWord64(cms_uint64_t& word64, int iB, const int iWord);
/// get/set hex message indicating the source of BST message
inline const cms_uint16_t bstSource() const { return m_bstSource; }
inline void setBstSource(const cms_uint16_t bstSourceVal) { m_bstSource = bstSourceVal; }
/// set the hex message indicating the source of BST message from a 64-bits word
void setBstSource(const cms_uint64_t& word64);
/// set hex message indicating the source of BST message in a 64-bits word,
/// having the index iWord in the GTFE raw record
void setBstSourceWord64(cms_uint64_t& word64, const int iWord);
public:
/// get the size of the GTFE block in GT EVM record (in multiple of 8 bits)
const unsigned int getSize() const;
public:
/// resize the BST vector to get the right size of the block
void resize(int bstSizeBytes);
/// reset the content of a L1GtfeExtWord
void reset() override;
/// pretty print the content of a L1GtfeExtWord
void print(std::ostream& myCout) const override;
/// unpack GTFE
/// gtfePtr pointer to the beginning of the GTFE block in the raw data
void unpack(const unsigned char* gtfePtr) override;
private:
/// block description in the raw GT record
/// index of first word for BST blocks
static const int BstFirstWord;
/// size in bits for a BST block
static const int BstBitSize;
/// BST block mask, correlated with the number of bits of a block
/// 8 bit = 0xFF
static const cms_uint64_t BstBlockMask;
/// BST blocks: conversion to defined quantities (LHC-BOB-ES-0001)
static const int GpsTimeFirstBlock;
static const int GpsTimeLastBlock;
static const int BstMasterStatusFirstBlock;
static const int BstMasterStatusLastBlock;
static const int TurnCountNumberFirstBlock;
static const int TurnCountNumberLastBlock;
static const int LhcFillNumberFirstBlock;
static const int LhcFillNumberLastBlock;
static const int BeamModeFirstBlock;
static const int BeamModeLastBlock;
static const int ParticleTypeBeam1FirstBlock;
static const int ParticleTypeBeam1LastBlock;
static const int ParticleTypeBeam2FirstBlock;
static const int ParticleTypeBeam2LastBlock;
static const int BeamMomentumFirstBlock;
static const int BeamMomentumLastBlock;
static const int TotalIntensityBeam1FirstBlock;
static const int TotalIntensityBeam1LastBlock;
static const int TotalIntensityBeam2FirstBlock;
static const int TotalIntensityBeam2LastBlock;
// BST message source written always in the last word of GTFE extended
static const cms_uint64_t BstSourceMask;
static const int BstSourceShift;
private:
/// BST message - each byte is an vector element
std::vector<cms_uint16_t> m_bst;
/// hex message indicating the source of BST message (beam or simulated)
cms_uint16_t m_bstSource;
};
#endif /*L1GlobalTrigger_L1GtfeExtWord_h*/
|