|
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
|
///
/// \class l1t::LUT
///
/// Description: A class implimentating a look up table
///
/// Implementation:
/// Internally stores data in vector filled with 32 bit ints
/// address and output is masked to specifed number of bits
/// vector only allocates as necessary, eg we may have a 32 bit address but we obviously dont want to allocate a 4gb vector
///
/// Error handling: currently waiting guidance on how to deal with this
/// Exceptions are currently forbiden, emulator fails should not impact on the rest of the software chain. As such, everything silently fails gracefully
/// \author: Sam Harper - RAL, Jim Brooke - Bristol
///
//
#ifndef CondFormats_L1TObjects_LUT_h
#define CondFormats_L1TObjects_LUT_h
#include <iostream>
#include <vector>
#include <limits>
#include "CondFormats/Serialization/interface/Serializable.h"
namespace l1t {
class LUT {
public:
enum ReadCodes {
SUCCESS = 0,
NO_ENTRIES = 1,
DUP_ENTRIES = 2,
MISS_ENTRIES = 3,
MAX_ADDRESS_OUTOFRANGE = 4,
NO_HEADER = 5
};
LUT() : nrBitsAddress_(0), nrBitsData_(0), addressMask_(0), dataMask_(0), data_() {}
explicit LUT(std::istream& stream) : data_() { read(stream); }
~LUT() {}
int data(unsigned int address) const {
return (address & addressMask_) < data_.size() ? dataMask_ & data_[addressMask_ & address] : 0;
}
int read(std::istream& stream);
void write(std::ostream& stream) const;
unsigned int nrBitsAddress() const { return nrBitsAddress_; }
unsigned int nrBitsData() const { return nrBitsData_; }
//following the convention of vector::size()
unsigned int maxSize() const {
return addressMask_ == std::numeric_limits<unsigned int>::max() ? addressMask_ : addressMask_ + 1;
}
bool empty() const { return data_.empty(); }
private:
int readHeader_(std::istream&);
unsigned int nrBitsAddress_; //technically redundant with addressMask
unsigned int nrBitsData_; //technically redundant with dataMask
unsigned int addressMask_;
unsigned int dataMask_;
std::vector<int> data_;
COND_SERIALIZABLE;
};
} // namespace l1t
#endif
|