9 #include <svd/modules/svdUnpacker/SVDUnpackerModule.h>
12 #include <framework/datastore/DataStore.h>
13 #include <framework/datastore/StoreObjPtr.h>
14 #include <framework/logging/Logger.h>
16 #include <boost/crc.hpp>
17 #define CRC16POLYREV 0x8005
19 #include <arpa/inet.h>
45 SVDUnpackerModule::SVDUnpackerModule() :
Module(),
46 m_mapping(m_xmlFileName),
48 m_FADCTriggerNumberOffset(0)
51 setDescription(
"Produce SVDShaperDigits from RawSVD. NOTE: only zero-suppressed mode is currently supported!");
58 "if >0 is the number of reported FTB header ERRORs before quiet operations. If <0 full log produced.", -1);
60 "number to be added to the FADC trigger number to match the main trigger number", 0);
64 addParam(
"silentlyAppend",
m_silentAppend,
"Append digits to a pre-existing non-empty storeArray",
bool(
false));
66 addParam(
"UnpackerErrorRate",
m_errorRate,
"Unpacker will print one error every UnpackerErrorRate",
int(1000));
67 addParam(
"PrintRawData",
m_printRaw,
"Printing Raw data words for debugging",
bool(
false));
94 B2FATAL(
"no valid SVD Channel Mapping. We stop here.");
100 B2ERROR(
"SVD xml map not loaded." << std::endl <<
101 "No SVDShaperDigit will be produced for this run!");
128 B2FATAL(
"SVDGlobalConfigParameters not valid!!");
135 #pragma GCC diagnostic push
136 #pragma GCC diagnostic ignored "-Wstack-usage="
144 B2WARNING(
"Unpacking SVDShaperDigits to a non-empty pre-existing \n"
145 <<
"StoreArray. This can lead to undesired behaviour. At least\n"
146 <<
"remember to use SVDShaperDigitSorter in your path and \n"
147 <<
"set the silentlyAppend parameter of SVDUnpacker to true.");
150 vector<SVDDAQDiagnostic*> vDiagnostic_ptr;
152 map<SVDShaperDigit, SVDDAQDiagnostic*> diagnosticMap;
154 map<unsigned short, set<pair<unsigned short, unsigned short> > > apvsByPipeline;
157 B2ERROR(
"Missing valid EventMetaData." << std::endl <<
"No SVDShaperDigit produced for this event!");
161 bool nAPVmatch =
true;
162 bool badMapping =
false;
163 bool badHeader =
false;
164 bool badTrailer =
false;
165 bool missedHeader =
false;
166 bool missedTrailer =
false;
169 bool isSetEventInfo =
false;
172 bool isSetNAPVsamples =
false;
174 unsigned short nAPVheaders = 999;
175 set<short> seenAPVHeaders = {};
177 unsigned short nEntries_rawSVD =
m_rawSVD.getEntries();
180 short fadc = 255, apv = 63;
182 unsigned short cntFADCboards = 0;
183 for (
unsigned int i = 0; i < nEntries_rawSVD; i++) {
185 unsigned int numEntries_rawSVD =
m_rawSVD[ i ]->GetNumEntries();
186 for (
unsigned int j = 0; j < numEntries_rawSVD; j++) {
188 const unsigned short maxNumOfCh =
m_rawSVD[i]->GetMaxNumOfCh(j);
190 unsigned short nWords [maxNumOfCh];
191 uint32_t* data32tab[maxNumOfCh];
192 for (
unsigned int k = 0; k < maxNumOfCh; k++) {
193 nWords[k] =
m_rawSVD[i]->GetDetectorNwords(j, k);
194 data32tab[k] = (uint32_t*)
m_rawSVD[i]->GetDetectorBuffer(j, k);
197 unsigned short ftbError = 0;
198 unsigned short trgType = 0;
199 unsigned short trgNumber = 0;
200 unsigned short daqMode = -1;
201 unsigned short daqType = 0;
204 unsigned short apvErrors;
205 unsigned short pipAddr;
206 unsigned short ftbFlags = 0;
207 unsigned short apvErrorsOR = 0;
209 bool is3sampleData =
false;
210 bool is6sampleData =
false;
212 for (
unsigned int buf = 0; buf < maxNumOfCh; buf++) {
214 if (data32tab[buf] ==
nullptr || nWords[buf] == 0) {
215 if (data32tab[buf] !=
nullptr || nWords[buf] != 0) {
216 B2WARNING(
"Invalid combination of buffer pointer and nWords:" <<
217 LogVar(
"COPPER/PCIe40 ID", i) <<
218 LogVar(
"COPPER/PCIe40 Entry", j) <<
219 LogVar(
"COPPER/PCIe40 Channel", buf) <<
220 LogVar(
"data32tab[buf]", data32tab[buf]) <<
221 LogVar(
"nWords[buf]", nWords[buf]));
225 if (
m_printRaw)
printB2Debug(data32tab[buf], data32tab[buf], &data32tab[buf][nWords[buf] - 1], nWords[buf]);
229 missedHeader =
false;
230 missedTrailer =
false;
232 uint32_t* data32_it = data32tab[buf];
233 short strip, sample[6];
234 vector<uint32_t> crc16vec;
239 for (; data32_it != &data32tab[buf][nWords[buf]]; data32_it++) {
249 crc16vec.push_back(*data32_it);
255 if (ftbError != 240) {
259 switch (ftbError - 240) {
261 B2ERROR(
"FADC Event Number is different from (FTB & TTD) Event Numbers");
264 B2ERROR(
"TTD Event Number is different from (FTB & FADC) Event Numbers");
267 B2ERROR(
"FTB Event Number is different from (TTD & FADC) Event Numbers");
270 B2ERROR(
"(FTB, TTD & FADC) Event Numbers are different from each other");
273 B2ERROR(
"Problem with errorsField variable in FTB Header" <<
LogVar(
"abnormal value", ftbError));
279 (eventNo & 0xFFFFFF)) {
283 B2ERROR(
"Event number mismatch detected! The event number given by EventMetaData object is different from the one in the FTB Header."
284 <<
LogVar(
"Expected event number & 0xFFFFFF",
305 if (daqType) daqMode = 3;
313 is3sampleData =
false;
314 is6sampleData =
false;
316 if (daqMode == 0) B2ERROR(
"SVDDataFormatCheck: the event " << eventNo <<
317 " is apparently taken with 1-sample mode, this is not expected.");
318 if (daqMode == 1) is3sampleData =
true;
319 if (daqMode == 2) is6sampleData =
true;
327 B2ERROR(
"Event number mismatch detected! The event number given by EventMetaData object is different from the one in the FADC Header. "
328 <<
LogVar(
"Event number", eventNo) <<
LogVar(
"FADC", fadc) <<
LogVar(
"Trigger number LSByte reported by the FADC",
337 if (!isSetEventInfo) {
349 isSetEventInfo =
true;
360 seenAPVHeaders.insert(apv);
367 if (apvErrors != 0) {
374 currentDAQDiagnostic =
m_storeDAQDiagnostics.appendNew(trgNumber, trgType, pipAddr, cmc1, cmc2, apvErrors, ftbError,
true,
376 badHeader, missedHeader, missedTrailer,
378 vDiagnostic_ptr.push_back(currentDAQDiagnostic);
380 apvsByPipeline[pipAddr].insert(make_pair(fadc, apv));
400 if (!isSetNAPVsamples) {
402 isSetNAPVsamples =
true;
405 B2ERROR(
"DAQMode value (indicating 3-sample acquisition mode) doesn't correspond to the actual number of samples (6) in the data! The data might be corrupted!");
419 if (!isSetNAPVsamples) {
421 isSetNAPVsamples =
true;
424 B2ERROR(
"DAQMode value (indicating 6-sample acquisition mode) doesn't correspond to the actual number of samples (3) in the data! The data might be corrupted!");
430 if (newShaperDigit) {
431 diagnosticMap.insert(make_pair(*newShaperDigit, currentDAQDiagnostic));
432 delete newShaperDigit;
434 B2FATAL(
"Respective FADC/APV combination not found -->> incorrect payload in the database! ");
447 if (
APVmap->find(fadc) ==
APVmap->end()) badMapping =
true;
450 unsigned short nAPVs =
APVmap->count(fadc);
452 if (nAPVheaders == 0) {
453 currentDAQDiagnostic =
m_storeDAQDiagnostics.appendNew(0, 0, 0, 0, 0, 0, ftbError,
true, nAPVmatch, badHeader, 0, 0, fadc, 0);
454 vDiagnostic_ptr.push_back(currentDAQDiagnostic);
457 if (nAPVs != nAPVheaders) {
459 for (
const auto& fadcApv : *
APVmap) {
460 if (fadcApv.first != fadc)
continue;
461 if (seenAPVHeaders.find(fadcApv.second) == seenAPVHeaders.end()) {
463 auto missingRec =
m_missingAPVs.find(make_pair(fadcApv.first, fadcApv.second));
466 if (missingRec->second.first > eventNo)
467 missingRec->second.first = eventNo;
468 if (missingRec->second.second < eventNo)
469 missingRec->second.second = eventNo;
474 make_pair(fadcApv.first, fadcApv.second),
475 make_pair(eventNo, eventNo)
478 int(fadcApv.second)) <<
LogVar(
"FADC",
479 int(fadcApv.first)));
486 seenAPVHeaders.clear();
489 if ((ftbFlags >> 5) != 0) badTrailer =
true;
493 B2ERROR(
" FTB Flags variable has an active error bit(s)" <<
LogVar(
"on FADC number", fadc));
495 if (ftbFlags & 16) B2ERROR(
"----> CRC error has been detected. Data might be corrupted!");
496 if (ftbFlags & 8) B2ERROR(
"----> Bad Event indication has been detected. Data might be corrupted!");
497 if (ftbFlags & 4) B2ERROR(
"----> Double Header has been detected. Data might be corrupted!");
498 if (ftbFlags & 2) B2ERROR(
"----> Time Out has been detected. Data might be corrupted!");
499 if (ftbFlags & 1) B2ERROR(
"----> Event Too Long! Data might be corrupted!");
514 unsigned short iCRC = crc16vec.size();
515 uint32_t crc16input[iCRC];
517 for (
unsigned short icrc = 0; icrc < iCRC; icrc++)
518 crc16input[icrc] = htonl(crc16vec.at(icrc));
521 boost::crc_basic<16> bcrc(0x8005, 0xffff, 0,
false,
false);
522 bcrc.process_block(crc16input, crc16input + iCRC);
523 unsigned int checkCRC = bcrc.checksum();
526 B2WARNING(
"FTB CRC16 checksum DOES NOT MATCH" <<
LogVar(
"for FADC no.", fadc));
536 if (!(
seenHeadersAndTrailers & 1)) {B2ERROR(
"Missing FTB Header is detected. SVD data might be corrupted!" <<
LogVar(
"Event number", eventNo) <<
LogVar(
"FADC", fadc)); missedHeader =
true;}
537 if (!(
seenHeadersAndTrailers & 2)) {B2ERROR(
"Missing FADC Header is detected -> related FADC number couldn't be retreived. SVD data might be corrupted! " <<
LogVar(
"Event number", eventNo) <<
LogVar(
"previous FADC", fadc)); missedHeader =
true;}
538 if (!(
seenHeadersAndTrailers & 4)) {B2ERROR(
"Missing FADC Trailer is detected. SVD data might be corrupted!" <<
LogVar(
"Event number", eventNo) <<
LogVar(
"FADC", fadc)); missedTrailer =
true;}
539 if (!(
seenHeadersAndTrailers & 8)) {B2ERROR(
"Missing FTB Trailer is detected. SVD data might be corrupted!" <<
LogVar(
"Event number", eventNo) <<
LogVar(
"FADC", fadc)); missedTrailer =
true;}
542 for (
auto p : vDiagnostic_ptr) {
544 p->setFTBFlags(ftbFlags);
545 p->setApvErrorOR(apvErrorsOR);
546 p->setAPVMatch(nAPVmatch);
547 p->setBadMapping(badMapping);
548 p->setBadTrailer(badTrailer);
549 p->setMissedHeader(missedHeader);
550 p->setMissedTrailer(missedTrailer);
553 vDiagnostic_ptr.clear();
565 LogVar(
"# of data objects in rawSVD",
570 p.setFADCMatch(
false);
575 auto major_apv = max_element(apvsByPipeline.begin(), apvsByPipeline.end(),
576 [](
const decltype(apvsByPipeline)::value_type & p1,
577 const decltype(apvsByPipeline)::value_type & p2) ->
bool
578 {
return p1.second.size() < p2.second.size(); }
583 p.setEmuPipelineAddress(major_apv->first);
585 if (apvsByPipeline.size() > 1)
586 for (
const auto& p : apvsByPipeline) {
587 if (p.first == major_apv->first)
continue;
588 for (
const auto& fadcApv : p.second) {
590 auto upsetRec =
m_upsetAPVs.find(make_pair(fadcApv.first, fadcApv.second));
593 if (upsetRec->second.first > eventNo)
594 upsetRec->second.first = eventNo;
595 if (upsetRec->second.second < eventNo)
596 upsetRec->second.second = eventNo;
601 make_pair(fadcApv.first, fadcApv.second),
602 make_pair(eventNo, eventNo)
606 if (pp.getFADCNumber() == fadcApv.first and pp.getAPVNumber() == fadcApv.second)
607 pp.setUpsetAPV(
true);
610 int(fadcApv.first)) <<
LogVar(
"Event number", eventNo));
617 for (
auto& p : diagnosticMap) {
619 if ((
m_killUpsetDigits && p.second->getPipelineAddress() != p.second->getEmuPipelineAddress()) || p.second->getFTBError() != 240
620 || p.second->getFTBFlags() || p.second->getAPVError() || !(p.second->getAPVMatch()) || !(p.second->getFADCMatch())
621 || p.second->getBadHeader()
622 || p.second->getBadMapping() || p.second->getUpsetAPV() || p.second->getMissedHeader() || p.second->getMissedTrailer())
continue;
632 #pragma GCC diagnostic pop
639 B2WARNING(
"SVDUnpacker summary 1: Missing APVs");
641 B2WARNING(
LogVar(
"Missing APV", miss.first.second) <<
LogVar(
"FADC", miss.first.first) <<
LogVar(
"since event",
642 miss.second.first) <<
LogVar(
"to event", miss.second.second));
645 B2WARNING(
"SVDUnpacker summary 2: Upset APVs");
647 B2WARNING(
LogVar(
"Upset APV", upst.first.second) <<
LogVar(
"FADC", upst.first.first) <<
648 LogVar(
"since event", upst.second.first) <<
LogVar(
"to event", upst.second.second));
657 uint32_t* min = std::max((data32 - nWords), data32_min);
658 uint32_t* max = std::min((data32 + nWords), data32_max);
661 std::stringstream os;
662 os << std::hex << std::setfill(
'0');
663 for (uint32_t* ptr = min; ptr <= max; ++ptr) {
664 os << std::setw(8) << *ptr;
665 if (++counter % 10 == 0) os << std::endl;
bool hasChanged()
Check whether the object has changed since the last call to hasChanged of the accessor).
bool isValid() const
isValid is always true if we have a filename
@ c_ErrorIfAlreadyRegistered
If the object/array was already registered, produce an error (aborting initialisation).
void setDescription(const std::string &description)
Sets the description of the module.
void setPropertyFlags(unsigned int propertyFlags)
Sets the flags for the module properties.
@ c_ParallelProcessingCertified
This module can be run in parallel processing mode safely (All I/O must be done through the data stor...
std::string getFileName() const
Get the name of the downloaded payload file.
Class to store SVD DAQ diagnostic information.
Class to store SVD mode information.
The SVD ShaperDigit class.
Class to store Trigger Type information.
int m_wrongFTBcrc
FTB CRC no-Match counter.
StoreArray< SVDDAQDiagnostic > m_storeDAQDiagnostics
SVDDAQDiagnostic array.
virtual ~SVDUnpackerModule()
Destructor of the module.
unsigned short seenHeadersAndTrailers
this 4-bits value should be 1111 if no headers/trailers are missing
int m_shutUpFTBError
regulates the number of "Event number mismatch" errors reported
MainHeader m_MainHeader
Implementation of FADC Header.
StoreArray< RawSVD > m_rawSVD
output for RawSVD
FADCTrailer m_FADCTrailer
Implementation of FADC Trailer.
StoreObjPtr< SVDEventInfo > m_svdEventInfoPtr
SVDEventInfo output per event.
virtual void initialize() override
Initializes the Module.
StoreArray< SVDShaperDigit > m_storeShaperDigits
SVDShaperDigit array.
virtual void event() override
event
int nAPVErrors
counter of APV errors
FTBHeader m_FTBHeader
Implementation of FTB Header.
virtual void endRun() override
end run
std::string m_rawSVDListName
RawSVD StoreArray name.
DBObjPtr< PayloadFile > m_mapping
pointer to the payload with the mapping
int nFADCMatchErrors
counter of FADC boards =/= n of RawData objects errors
bool m_killUpsetDigits
Optionally, we can kill digits coming from upset APVs right in the unpacker.
data_B m_data_B
Implementation of 2nd data word.
int m_FADCTriggerNumberOffset
FADC Trigger Offset.
std::map< std::pair< unsigned short, unsigned short >, std::pair< std::size_t, std::size_t > > m_missingAPVs
Map to store a list of missing APVs.
int nMissingAPVsErrors
counter of missing APVs errors
static std::string m_xmlFileName
XML filename.
int nEventMatchErrors
counter of Event match errors
FTBTrailer m_FTBTrailer
Implementation of FTB Trailer.
int m_errorRate
The parameter that indicates what fraction of B2ERRORs messages should be suppressed to not overload ...
APVHeader m_APVHeader
Implementation of APV Header.
int nUpsetAPVsErrors
counter of upset APV errors
void printB2Debug(uint32_t *data32, uint32_t *data32_min, uint32_t *data32_max, int nWords)
additional function that prints raw data words
virtual void beginRun() override
begin run
std::string m_svdShaperDigitListName
SVDShaperDigit StoreArray name.
DBObjPtr< HardwareClockSettings > m_hwClock
system clock
std::string m_svdEventInfoName
SVDEventInfo name.
DBObjPtr< SVDGlobalConfigParameters > m_svdGlobalConfig
SVDGlobal Configuration payload.
bool m_printRaw
Optionally we can get printout of Raw Data words.
int nEventInfoMatchErrors
counter of inconsistencies in SVDEventInfo within an event
bool m_badMappingFatal
Optionally we can stop the unpacking if there is a missing APV/FADC combination in the mapping -> wro...
int nErrorFieldErrors
counter of event mismatch errors in FTB's ErrorField
data_A m_data_A
Implementation of 1st data word.
uint32_t m_data32
Input 32-bit data word.
StoreObjPtr< EventMetaData > m_eventMetaDataPtr
Required input for EventMetaData.
bool m_silentAppend
Silently append new SVDShaperDigits to a pre-existing non-empty SVDShaperDigits storeArray.
std::unordered_multimap< unsigned char, unsigned char > * APVmap
pointer to APVforFADCmap filled by mapping procedure
SVDTriggerType m_SVDTriggerType
SVDTriggerType object.
SVDModeByte m_SVDModeByte
instance of SVDModeByte for the event
std::unique_ptr< SVDOnlineToOfflineMap > m_map
Pointer to online-to-offline map.
int m_relativeTimeShift
latency difference between the 3- and 6-sample acquired events in usint of APV clock / 4,...
std::map< std::pair< unsigned short, unsigned short >, std::pair< std::size_t, std::size_t > > m_upsetAPVs
Map to store a list of upset APVs.
int nFTBFlagsErrors
counter of errors in FTBFlags variable
bool m_emulatePipelineAddress
Software emulation of pipeline address This is a replacement of hardware pipeline address emulation.
std::string m_svdDAQDiagnosticsListName
SVDDAQDiagnostic StoreArray name.
int nTriggerMatchErrors
counters for specific ERRORS produced by the Unpacker
unsigned short nFADCboards
how many FADCs we have
Class to store variables with their name which were sent to the logging service.
void addParam(const std::string &name, T ¶mVariable, const std::string &description, const T &defaultValue)
Adds a new parameter to the module.
#define REG_MODULE(moduleName)
Register the given module (without 'Module' suffix) with the framework.
Namespace to encapsulate code needed for simulation and reconstrucion of the SVD.
Abstract base class for different kinds of events.
unsigned int apvErrOR
APV Errors Field OR.
unsigned int check
MSB "1110" - for FADC Trailer identification.
unsigned int FTBFlags
FTB Flags Field.
unsigned int controlWord
MSB "ff55" - FADC Trailer ID.
unsigned int crc16
FTB CRC16 Checksum
unsigned int DAQType
(from 2020c) Event type(0): "0"…3 or …6 acquisition mode, "1"…3-mixed-6 acquisition mode
unsigned int runType
Run Type.
unsigned int FADCnum
FADC number.
unsigned int xTalk
cross talk tag
unsigned int check
MSB "110" - for FADC Header identification.
unsigned int trgNumber
Trigger Number.
unsigned int trgTiming
Trigger Timing.
unsigned int DAQMode
Event type(2:1): "00"…1-sample, "01"…3-sample, "10"…6-sample.
unsigned int trgType
Trigger Type.
unsigned int sample3
3rd data sample
unsigned int stripNum
Strip number.
unsigned int sample2
2nd data sample
unsigned int check
MSB "1" - for Data word identification.
unsigned int sample1
1st data sample
unsigned int sample6
6th data sample
unsigned int stripNum
Strip number.
unsigned int check
MSB "1" - for Data word identification.
unsigned int sample4
4th data sample
unsigned int sample5
5th data sample