|
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
|
#ifndef DIGIHGCAL_HGCSAMPLE_H
#define DIGIHGCAL_HGCSAMPLE_H
#include <iostream>
#include <ostream>
#include <cstdint>
/**
@class HGCSample
@short wrapper for a data word
*/
class HGCSample {
public:
enum HGCSampleMasks {
kThreshMask = 0x1,
kModeMask = 0x1,
kToAValidMask = 0x1,
kGainMask = 0xf,
kToAMask = 0x3ff,
kDataMask = 0xfff
};
enum HGCSampleShifts {
kThreshShift = 31,
kModeShift = 30,
kToAValidShift = 29,
kToGainShift = 22,
kToAShift = 12,
kDataShift = 0
};
/**
@short CTOR
*/
HGCSample() : value_(0) {}
HGCSample(uint32_t value) : value_(value) {}
HGCSample(const HGCSample& o) : value_(o.value_) {}
HGCSample& operator=(const HGCSample&) = default;
/**
@short setters
*/
void setThreshold(bool thr) { setWord(thr, kThreshMask, kThreshShift); }
void setMode(bool mode) { setWord(mode, kModeMask, kModeShift); }
void setGain(uint16_t gain) { setWord(gain, kGainMask, kToGainShift); }
void setToA(uint16_t toa) { setWord(toa, kToAMask, kToAShift); }
void setData(uint16_t data) { setWord(data, kDataMask, kDataShift); }
void setToAValid(bool toaFired) { setWord(toaFired, kToAValidMask, kToAValidShift); }
void set(bool thr, bool mode, uint16_t gain, uint16_t toa, uint16_t data) {
setThreshold(thr);
setMode(mode);
setGain(gain);
setToA(toa);
setData(data);
}
void print(std::ostream& out = std::cout) {
out << "THR: " << threshold() << " Mode: " << mode() << " ToA: " << toa() << " Data: " << data() << " Raw=0x"
<< std::hex << raw() << std::dec << std::endl;
}
/**
@short getters
*/
uint32_t raw() const { return value_; }
bool threshold() const { return getWord(kThreshMask, kThreshShift); }
bool mode() const { return getWord(kModeMask, kModeShift); }
uint16_t gain() const { return getWord(kGainMask, kToGainShift); }
uint16_t toa() const { return getWord(kToAMask, kToAShift); }
uint16_t data() const { return getWord(kDataMask, kDataShift); }
bool getToAValid() const { return getWord(kToAValidMask, kToAValidShift); }
uint32_t operator()() { return value_; }
/**
@short Data Model Evolution
*/
static uint32_t convertV9ToV10(uint32_t valueOldForm, bool toaFiredOldForm) {
// combine value&toaFired from the dataformat V9-or-earlier
// from persisted objects
// to produce a value_ compatible w/ the V10 format
// i.e.
// 1) shift the 10 toa bits by 1 bit
// 2) insert the toaFired into _value
// NOTE: nothing can be done for the gain bits:
// info about gain was not preswent in V9-or-earlier, and will be left to 0 in V10
// root doc: https://root.cern.ch/root/html/io/DataModelEvolution.html
// see PR 28349 for more info
// V9 Format: tm--------tttttttttt-dddddddddddd
uint32_t valueNewForm(valueOldForm);
// set to 0 the 17 bits bits (between 13 and 29 - both included)
valueNewForm &= ~(0x3FFFF << kToAShift);
// copy toa to start from bit 13
valueNewForm |= ((valueOldForm >> 13) & kToAMask) << kToAShift;
// set 1 bit toaFiredOldForm in position 30
valueNewForm |= (toaFiredOldForm & kToAValidMask) << kToAValidShift;
return valueNewForm;
}
private:
/**
@short wrapper to reset words at a given position
*/
void setWord(uint16_t word, HGCSampleMasks mask, HGCSampleShifts shift) {
// mask and shift bits
const uint32_t masked_word = (word & mask) << shift;
//clear to 0 bits which will be set by word
value_ &= ~(mask << shift);
//now set bits
value_ |= (masked_word);
}
uint32_t getWord(HGCSampleMasks mask, HGCSampleShifts shift) const { return ((value_ >> shift) & mask); }
// a 32-bit word
// V10 Format: tmt---ggggttttttttttdddddddddddd
uint32_t value_;
};
#endif
|