Belle II Software release-09-00-02
SVDUnpackerModule.cc
1/**************************************************************************
2 * basf2 (Belle II Analysis Software Framework) *
3 * Author: The Belle II Collaboration *
4 * *
5 * See git log for contributors and copyright holders. *
6 * This file is licensed under LGPL-3.0, see LICENSE.md. *
7 **************************************************************************/
8
9#include <svd/modules/svdUnpacker/SVDUnpackerModule.h>
10
11
12#include <framework/datastore/DataStore.h>
13#include <framework/datastore/StoreObjPtr.h>
14#include <framework/logging/Logger.h>
15
16#include <boost/crc.hpp> // for boost::crc_basic, boost::augmented_crc
17#define CRC16POLYREV 0x8005 // CRC-16 polynomial, normal representation
18
19#include <arpa/inet.h>
20
21#include <sstream>
22#include <iomanip>
23#include <cstring>
24#include <vector>
25#include <set>
26#include <map>
27#include <utility>
28#include <algorithm>
29
30using namespace std;
31using namespace Belle2;
32using namespace Belle2::SVD;
33
34//-----------------------------------------------------------------
35// Register the Module
36//-----------------------------------------------------------------
37REG_MODULE(SVDUnpacker);
38
39//-----------------------------------------------------------------
40// Implementation
41//-----------------------------------------------------------------
42
43std::string Belle2::SVD::SVDUnpackerModule::m_xmlFileName = std::string("SVDChannelMapping.xml");
44
46 m_mapping(m_xmlFileName),
47 m_shutUpFTBError(0),
48 m_FADCTriggerNumberOffset(0)
49{
50 //Set module properties
51 setDescription("Produce SVDShaperDigits from RawSVD. NOTE: only zero-suppressed mode is currently supported!");
53
54 addParam("SVDEventInfo", m_svdEventInfoName, "Name of the SVDEventInfo object", string(""));
55 addParam("rawSVDListName", m_rawSVDListName, "Name of the raw SVD List", string(""));
56 addParam("svdShaperDigitListName", m_svdShaperDigitListName, "Name of the SVDShaperDigits list", string(""));
57 addParam("shutUpFTBError", m_shutUpFTBError,
58 "if >0 is the number of reported FTB header ERRORs before quiet operations. If <0 full log produced.", -1);
59 addParam("FADCTriggerNumberOffset", m_FADCTriggerNumberOffset,
60 "number to be added to the FADC trigger number to match the main trigger number", 0);
61 addParam("svdDAQDiagnosticsListName", m_svdDAQDiagnosticsListName, "Name of the DAQDiagnostics list", string(""));
62 addParam("softwarePipelineAddressEmulation", m_emulatePipelineAddress, "Estimate emulated pipeline address", bool(true));
63 addParam("killDigitsFromUpsetAPVs", m_killUpsetDigits, "Delete digits from upset APVs", bool(false));
64 addParam("silentlyAppend", m_silentAppend, "Append digits to a pre-existing non-empty storeArray", bool(false));
65 addParam("badMappingFatal", m_badMappingFatal, "Throw B2FATAL if there's a wrong payload in the database", 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));
68}
69
71{
72}
73
75{
76 m_eventMetaDataPtr.isRequired();
77 // Don't panic if no SVD data.
78 m_rawSVD.isOptional(m_rawSVDListName);
79
80 // Register default SVDEventInfo for unpacking Raw Data
82
85
88
89}
90
92{
93 if (!m_mapping.isValid())
94 B2FATAL("no valid SVD Channel Mapping. We stop here.");
95
96 m_wrongFTBcrc = 0;
97 if (m_mapping.hasChanged()) { m_map = std::make_unique<SVDOnlineToOfflineMap>(m_mapping->getFileName()); }
98
99 if (! m_map) { //give up
100 B2ERROR("SVD xml map not loaded." << std::endl <<
101 "No SVDShaperDigit will be produced for this run!");
102 return;
103 }
104
105 //number of FADC boards
106 nFADCboards = m_map->getFADCboardsNumber();
107
108 //passing APV<->FADC mapping from SVDOnlineToOfflineMap object
109 APVmap = &(m_map->APVforFADCmap);
110
111 //setting UnpackerErrorRate factor to use it for BadMapping error suppression
112 m_map->setErrorRate(m_errorRate);
113
116 nUpsetAPVsErrors = -1;
117 nSEURecoveryCase = -1;
120 nFADCMatchErrors = -1;
121 nAPVErrors = -1;
122 nFTBFlagsErrors = -1;
124
126
127 //get the relative time shift
128 if (!m_svdGlobalConfig.isValid())
129 B2FATAL("SVDGlobalConfigParameters not valid!!");
130
131 m_relativeTimeShift = m_svdGlobalConfig->getRelativeTimeShift();
132
133}
134
135#ifndef __clang__
136#pragma GCC diagnostic push
137#pragma GCC diagnostic ignored "-Wstack-usage="
138#endif
140{
141 if (!m_rawSVD || !m_rawSVD.getEntries())
142 return;
143
145 B2WARNING("Unpacking SVDShaperDigits to a non-empty pre-existing \n"
146 << "StoreArray. This can lead to undesired behaviour. At least\n"
147 << "remember to use SVDShaperDigitSorter in your path and \n"
148 << "set the silentlyAppend parameter of SVDUnpacker to true.");
149
150 SVDDAQDiagnostic* currentDAQDiagnostic;
151 vector<SVDDAQDiagnostic*> vDiagnostic_ptr;
152
153 map<SVDShaperDigit, SVDDAQDiagnostic*> diagnosticMap;
154 // Store encountered pipeline addresses with APVs in which they were observed
155 map<unsigned short, set<pair<unsigned short, unsigned short> > > apvsByPipeline;
156
157 if (!m_eventMetaDataPtr.isValid()) { // give up...
158 B2ERROR("Missing valid EventMetaData." << std::endl << "No SVDShaperDigit produced for this event!");
159 return;
160 }
161
162 bool nAPVmatch = true;
163 bool badMapping = false;
164 bool badHeader = false;
165 bool badTrailer = false;
166 bool missedHeader = false;
167 bool missedTrailer = false;
168
169 // flag to set SVDEventInfo once per event
170 bool isSetEventInfo = false;
171
172 //flag to set nAPVsamples in SVDEventInfo once per event
173 bool isSetNAPVsamples = false;
174
175 unsigned short nAPVheaders = 999;
176 set<short> seenAPVHeaders = {};
177
178 unsigned short nEntries_rawSVD = m_rawSVD.getEntries();
179 auto eventNo = m_eventMetaDataPtr->getEvent();
180
181 short fadc = 255, apv = 63;
182
183 unsigned short cntFADCboards = 0;
184 for (unsigned int i = 0; i < nEntries_rawSVD; i++) {
185
186 unsigned int numEntries_rawSVD = m_rawSVD[ i ]->GetNumEntries();
187 for (unsigned int j = 0; j < numEntries_rawSVD; j++) {
188
189 const unsigned short maxNumOfCh = m_rawSVD[i]->GetMaxNumOfCh(j);
190
191 unsigned short nWords [maxNumOfCh];
192 uint32_t* data32tab[maxNumOfCh]; //vector of pointers
193 for (unsigned int k = 0; k < maxNumOfCh; k++) {
194 nWords[k] = m_rawSVD[i]->GetDetectorNwords(j, k);
195 data32tab[k] = (uint32_t*)m_rawSVD[i]->GetDetectorBuffer(j, k); // points at the begining of the 1st buffer
196 }
197
198 unsigned short ftbError = 0;
199 unsigned short trgType = 0;
200 unsigned short trgNumber = 0;
201 unsigned short daqMode = -1;
202 unsigned short daqType = 0;
203 unsigned short cmc1;
204 unsigned short cmc2;
205 unsigned short apvErrors;
206 unsigned short pipAddr;
207 unsigned short ftbFlags = 0;
208 unsigned short apvErrorsOR = 0;
209
210 bool is3sampleData = false;
211 bool is6sampleData = false;
212
213 for (unsigned int buf = 0; buf < maxNumOfCh; buf++) { // loop over 4(COPPER) or 48(PCIe40) buffers
214
215 if (data32tab[buf] == nullptr || nWords[buf] == 0) {
216 if (data32tab[buf] != nullptr || nWords[buf] != 0) {
217 B2WARNING("Invalid combination of buffer pointer and nWords:" <<
218 LogVar("COPPER/PCIe40 ID", i) <<
219 LogVar("COPPER/PCIe40 Entry", j) <<
220 LogVar("COPPER/PCIe40 Channel", buf) <<
221 LogVar("data32tab[buf]", data32tab[buf]) <<
222 LogVar("nWords[buf]", nWords[buf]));
223 }
224 continue;
225 }
226 if (m_printRaw) printB2Debug(data32tab[buf], data32tab[buf], &data32tab[buf][nWords[buf] - 1], nWords[buf]);
227
228 cntFADCboards++;
229
230 missedHeader = false;
231 missedTrailer = false;
232
233 uint32_t* data32_it = data32tab[buf];
234 short strip, sample[6];
235 vector<uint32_t> crc16vec;
236
237 //reset value for headers and trailers check
239
240 for (; data32_it != &data32tab[buf][nWords[buf]]; data32_it++) {
241 m_data32 = *data32_it; //put current 32-bit frame to union
242
243 if (m_data32 == 0xffaa0000) { // first part of FTB header
244 crc16vec.clear(); // clear the input container for crc16 calculation
245 crc16vec.push_back(m_data32);
246
247 seenHeadersAndTrailers |= 0x1; // we found FTB header
248
249 data32_it++; // go to 2nd part of FTB header
250 crc16vec.push_back(*data32_it);
251
252 m_data32 = *data32_it; //put the second 32-bit frame to union
253
254 ftbError = m_FTBHeader.errorsField;
255
256 if (ftbError != 240) {
258
260 switch (ftbError - 240) {
261 case 3:
262 B2ERROR("FADC Event Number is different from (FTB & TTD) Event Numbers");
263 break;
264 case 5:
265 B2ERROR("TTD Event Number is different from (FTB & FADC) Event Numbers");
266 break;
267 case 6:
268 B2ERROR("FTB Event Number is different from (TTD & FADC) Event Numbers");
269 break;
270 case 7:
271 B2ERROR("(FTB, TTD & FADC) Event Numbers are different from each other");
272 break;
273 default:
274 B2ERROR("Problem with errorsField variable in FTB Header" << LogVar("abnormal value", ftbError));
275 }
276 }
277 }
278
280 (eventNo & 0xFFFFFF)) {
283 m_shutUpFTBError -= 1;
284 B2ERROR("Event number mismatch detected! The event number given by EventMetaData object is different from the one in the FTB Header."
285 << LogVar("Expected event number & 0xFFFFFF",
286 (eventNo & 0xFFFFFF)) << LogVar("Event number in the FTB", m_FTBHeader.eventNumber));
287 }
288 }
289
290 continue;
291 } // is FTB Header
292
293 crc16vec.push_back(m_data32);
294
295 if (m_MainHeader.check == 6) { // FADC header
296
297 seenHeadersAndTrailers |= 0x2; //we found FADC Header
298
299 fadc = m_MainHeader.FADCnum;
300 trgType = m_MainHeader.trgType;
301 trgNumber = m_MainHeader.trgNumber;
302 daqMode = m_MainHeader.DAQMode;
303 daqType = m_MainHeader.DAQType;
304
305 //Let's add run-dependent info: daqMode="11" in case of 3-mixed-6 sample acquisition mode.
306 if (daqType) daqMode = 3;
307
308 nAPVheaders = 0; // start counting APV headers for this FADC
309 nAPVmatch = true; //assume correct # of APV headers
310 badMapping = false; //assume correct mapping
311 badHeader = false;
312 badTrailer = false;
313
314 is3sampleData = false;
315 is6sampleData = false;
316
317 if (daqMode == 0) B2ERROR("SVDDataFormatCheck: the event " << eventNo <<
318 " is apparently taken with 1-sample mode, this is not expected.");
319 if (daqMode == 1) is3sampleData = true;
320 if (daqMode == 2) is6sampleData = true;
321
322 if (
324 ((eventNo - m_FADCTriggerNumberOffset) & 0xFF)) {
325
328 B2ERROR("Event number mismatch detected! The event number given by EventMetaData object is different from the one in the FADC Header. "
329 << LogVar("Event number", eventNo) << LogVar("FADC", fadc) << LogVar("Trigger number LSByte reported by the FADC",
330 m_MainHeader.trgNumber) << LogVar("+ offset", m_FADCTriggerNumberOffset) << LogVar("expected", (eventNo & 0xFF)));
331 badHeader = true;
332 }
333
334 // create SVDModeByte object from MainHeader vars
336
337 // create SVDEventInfo and fill it with SVDModeByte & SVDTriggerType objects
338 if (!isSetEventInfo) {
340 m_svdEventInfoPtr.create();
341 m_svdEventInfoPtr->setModeByte(m_SVDModeByte);
342 m_svdEventInfoPtr->setTriggerType(m_SVDTriggerType);
343 m_svdEventInfoPtr->setAPVClock(m_hwClock);
344
345 //set relative time shift
346 m_svdEventInfoPtr->setRelativeShift(m_relativeTimeShift);
347 // set X-talk info online from Raw Data
348 m_svdEventInfoPtr->setCrossTalk(m_MainHeader.xTalk);
349
350 isSetEventInfo = true;
351 } else { // let's check if the current SVDModeByte and SVDTriggerType are consistent with the one stored in SVDEventInfo
352 if (m_SVDModeByte != m_svdEventInfoPtr->getModeByte()) {m_svdEventInfoPtr->setMatchModeByte(false); badHeader = true; nEventInfoMatchErrors++;}
353 if (trgType != (m_svdEventInfoPtr->getTriggerType()).getType()) { m_svdEventInfoPtr->setMatchTriggerType(false); badHeader = true; nEventInfoMatchErrors++;}
354 }
355 } // is FADC header
356
357 if (m_APVHeader.check == 2) { // APV header
358
359 nAPVheaders++;
360 apv = m_APVHeader.APVnum;
361 seenAPVHeaders.insert(apv);
362
363 cmc1 = m_APVHeader.CMC1;
364 cmc2 = m_APVHeader.CMC2;
365 apvErrors = m_APVHeader.apvErr;
366 pipAddr = m_APVHeader.pipelineAddr;
367
368 if (apvErrors != 0) {
369 nAPVErrors++;
370 if (!(nAPVErrors % m_errorRate)
371 or nAPVErrors < 100) B2ERROR("APV error has been detected." << LogVar("FADC", fadc) << LogVar("APV", apv) << LogVar("Error value",
372 apvErrors));
373 }
374 // temporary SVDDAQDiagnostic object (no info from trailers and APVmatch code)
375 currentDAQDiagnostic = m_storeDAQDiagnostics.appendNew(trgNumber, trgType, pipAddr, cmc1, cmc2, apvErrors, ftbError, true,
376 nAPVmatch,
377 badHeader, missedHeader, missedTrailer,
378 fadc, apv);
379 vDiagnostic_ptr.push_back(currentDAQDiagnostic);
380
381 apvsByPipeline[pipAddr].insert(make_pair(fadc, apv));
382
383 // Let's check if the data frame does not come after APV header with piplAddr = 255 (special SEU recovery pseudo-data)
384 if (pipAddr == 255) {
385 data32_it++;
386 m_data32 = *data32_it;
387 if (m_data_A.check == 0) B2ERROR("The strip data frame is detected for the special SEU recovery mode. " << LogVar("pipline address",
388 pipAddr) << "This is unexpected!");
389 data32_it--;
390 m_data32 = *data32_it;
391 }
392
393 } //is APV Header
394
395 if (m_data_A.check == 0) { // data
396 strip = m_data_A.stripNum;
397
398 sample[0] = m_data_A.sample1;
399 sample[1] = m_data_A.sample2;
400 sample[2] = m_data_A.sample3;
401
402 sample[3] = 0;
403 sample[4] = 0;
404 sample[5] = 0;
405
406 // Let's check the next rawdata word to determine if we acquired 3 or 6 sample
407 data32_it++;
408 m_data32 = *data32_it;
409
410 if (m_data_B.check == 0 && strip == m_data_B.stripNum) { // 2nd data frame with the same strip number -> six samples
411
412 if (!isSetNAPVsamples) {
413 m_svdEventInfoPtr->setNSamples(6);
414 isSetNAPVsamples = true;
415 } else {
416 if (is3sampleData)
417 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!");
418 }
419
420 crc16vec.push_back(m_data32);
421
422 sample[3] = m_data_B.sample4;
423 sample[4] = m_data_B.sample5;
424 sample[5] = m_data_B.sample6;
425 }
426
427 else { // three samples
428 data32_it--;
429 m_data32 = *data32_it;
430
431 if (!isSetNAPVsamples) {
432 m_svdEventInfoPtr->setNSamples(3);
433 isSetNAPVsamples = true;
434 } else {
435 if (is6sampleData)
436 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!");
437 }
438 }
439
440 // Generating SVDShaperDigit object
441 SVDShaperDigit* newShaperDigit = m_map->NewShaperDigit(fadc, apv, strip, sample, 0.0);
442 if (newShaperDigit) {
443 diagnosticMap.insert(make_pair(*newShaperDigit, currentDAQDiagnostic));
444 delete newShaperDigit;
445 } else if (m_badMappingFatal) {
446 B2FATAL("Respective FADC/APV combination not found -->> incorrect payload in the database! ");
447 } else {
448 badMapping = true;
449 }
450
451 } //is data frame
452
453
454 if (m_FADCTrailer.check == 14) { // FADC trailer
455
456 seenHeadersAndTrailers |= 0x4; // we found FADC trailer
457
458 //additional check if we have a faulty/fake FADC that is not in the map
459 if (APVmap->find(fadc) == APVmap->end()) badMapping = true;
460
461 //comparing number of APV chips and the number of APV headers, for the current FADC
462 unsigned short nAPVs = APVmap->count(fadc);
463
464 if (nAPVheaders == 0) {
465 currentDAQDiagnostic = m_storeDAQDiagnostics.appendNew(0, 0, 0, 0, 0, 0, ftbError, true, nAPVmatch, badHeader, 0, 0, fadc, 0);
466 vDiagnostic_ptr.push_back(currentDAQDiagnostic);
467 }
468
469 if (nAPVs != nAPVheaders) {
470 // There is an APV missing, detect which it is.
471 for (const auto& fadcApv : *APVmap) {
472 if (fadcApv.first != fadc) continue;
473 if (seenAPVHeaders.find(fadcApv.second) == seenAPVHeaders.end()) {
474 // We have a missing APV. Look if it is a known one.
475 auto missingRec = m_missingAPVs.find(make_pair(fadcApv.first, fadcApv.second));
476 if (missingRec != m_missingAPVs.end()) {
477 // This is known to be missing, so keep quiet and just update event counters
478 if (missingRec->second.first > eventNo)
479 missingRec->second.first = eventNo;
480 if (missingRec->second.second < eventNo)
481 missingRec->second.second = eventNo;
482 } else {
483 // We haven't seen this previously.
485 m_missingAPVs.insert(make_pair(
486 make_pair(fadcApv.first, fadcApv.second),
487 make_pair(eventNo, eventNo)
488 ));
489 if (!(nMissingAPVsErrors % m_errorRate)) B2ERROR("missing APV header! " << LogVar("Event number", eventNo) << LogVar("APV",
490 int(fadcApv.second)) << LogVar("FADC",
491 int(fadcApv.first)));
492 }
493 }
494 }
495 nAPVmatch = false;
496 } // is nAPVs != nAPVheaders
497
498 seenAPVHeaders.clear();
499
500 ftbFlags = m_FADCTrailer.FTBFlags;
501 if ((ftbFlags >> 5) != 0) badTrailer = true;
502 if (ftbFlags != 0) {
504 if (!(nFTBFlagsErrors % m_errorRate) or nFTBFlagsErrors < 100) {
505 B2ERROR(" FTB Flags variable has an active error bit(s)" << LogVar("on FADC number", fadc));
506
507 if (ftbFlags & 16) B2ERROR("----> CRC error has been detected. Data might be corrupted!");
508 if (ftbFlags & 8) B2ERROR("----> Bad Event indication has been detected. Data might be corrupted!");
509 if (ftbFlags & 4) B2ERROR("----> Double Header has been detected. Data might be corrupted!");
510 if (ftbFlags & 2) B2ERROR("----> Time Out has been detected. Data might be corrupted!");
511 if (ftbFlags & 1) B2ERROR("----> Event Too Long! Data might be corrupted!");
512 }
513 }
514
515 apvErrorsOR = m_FADCTrailer.apvErrOR;
516
517
518 }// is FADC trailer
519
520 if (m_FTBTrailer.controlWord == 0xff55) {// FTB trailer
521
522 seenHeadersAndTrailers |= 0x8; // we found FTB trailer
523
524 //check CRC16
525 crc16vec.pop_back();
526 unsigned short iCRC = crc16vec.size();
527 uint32_t crc16input[iCRC];
528
529 for (unsigned short icrc = 0; icrc < iCRC; icrc++)
530 crc16input[icrc] = htonl(crc16vec.at(icrc));
531
532 //verify CRC16
533 boost::crc_basic<16> bcrc(0x8005, 0xffff, 0, false, false);
534 bcrc.process_block(crc16input, crc16input + iCRC);
535 unsigned int checkCRC = bcrc.checksum();
536
537 if (checkCRC != m_FTBTrailer.crc16) {
538 B2WARNING("FTB CRC16 checksum DOES NOT MATCH" << LogVar("for FADC no.", fadc));
540 }
541
542 } // is FTB trailer
543
544 } // end loop over 32-bit frames in each buffer
545
546 //Let's check if all the headers and trailers were in place in the last frame
547 if (seenHeadersAndTrailers != 0xf) {
548 if (!(seenHeadersAndTrailers & 1)) {B2ERROR("Missing FTB Header is detected. SVD data might be corrupted!" << LogVar("Event number", eventNo) << LogVar("FADC", fadc)); missedHeader = true;}
549 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;}
550 if (!(seenHeadersAndTrailers & 4)) {B2ERROR("Missing FADC Trailer is detected. SVD data might be corrupted!" << LogVar("Event number", eventNo) << LogVar("FADC", fadc)); missedTrailer = true;}
551 if (!(seenHeadersAndTrailers & 8)) {B2ERROR("Missing FTB Trailer is detected. SVD data might be corrupted!" << LogVar("Event number", eventNo) << LogVar("FADC", fadc)); missedTrailer = true;}
552 }
553
554 for (auto p : vDiagnostic_ptr) {
555 // adding remaining info to Diagnostic object
556 p->setFTBFlags(ftbFlags);
557 p->setApvErrorOR(apvErrorsOR);
558 p->setAPVMatch(nAPVmatch);
559 p->setBadMapping(badMapping);
560 p->setBadTrailer(badTrailer);
561 p->setMissedHeader(missedHeader);
562 p->setMissedTrailer(missedTrailer);
563 }
564
565 vDiagnostic_ptr.clear();
566
567 } // end iteration on 4(COPPER)/48(PCIe40) data buffers
568
569 } // end event loop
570
571 }// end loop over RawSVD objects
572
573 // Check the number of FADC boards
574 if (cntFADCboards != nFADCboards) { // nFADCboards=52
576 if (!(nFADCMatchErrors % m_errorRate)) B2ERROR("Number of data objects in rawSVD do not match the number of FADC boards" <<
577 LogVar("# of data objects in rawSVD",
578 cntFADCboards) << LogVar("# of FADCs", nFADCboards) << LogVar("Event number", eventNo));
579
580 // We override all FADCMatch fields in diagnostics and set it to false.
581 for (auto& p : m_storeDAQDiagnostics) {
582 p.setFADCMatch(false);
583 }
584 }
585
586
587 // Check if we have special data for SEU recovery mode (pipAddr = 0xFF)
588 // If so, let's monitor affected FADC/APV's and the event range with seuRecMap
589 auto itPtr = apvsByPipeline.find(255);
590 if (itPtr != apvsByPipeline.end()) {
591 for (const auto& fadcApv : itPtr->second) {
592
593 auto seuRec = m_seuRecMap.find(make_pair(fadcApv.first, fadcApv.second));
594 if (seuRec != m_seuRecMap.end()) {
595 if (seuRec->second.first > eventNo)
596 seuRec->second.first = eventNo;
597 if (seuRec->second.second < eventNo)
598 seuRec->second.second = eventNo;
599 } else {
601 m_seuRecMap.insert(make_pair(
602 make_pair(fadcApv.first, fadcApv.second),
603 make_pair(eventNo, eventNo)
604 ));
606 B2ERROR("Special Recovery Data (Dummy APV Header) found due to the detection of Single Event Upset (SEU)!!!" << LogVar("APV",
607 int(fadcApv.second)) << LogVar("FADC", int(fadcApv.first)) << LogVar("Event number", eventNo));
608
609 }
610 for (auto& pp : m_storeDAQDiagnostics) {
611 if (pp.getFADCNumber() == fadcApv.first and pp.getAPVNumber() == fadcApv.second)
612 pp.setSEURecoData(true);
613 }
614 }
615 }
616
617
618 // Detect upset APVs and report/treat
619 auto majorAPV = max_element(apvsByPipeline.begin(), apvsByPipeline.end(),
620 [](const decltype(apvsByPipeline)::value_type & p1,
621 const decltype(apvsByPipeline)::value_type & p2) -> bool
622 { return p1.second.size() < p2.second.size(); }
623 );
624 // We set emuPipelineAddress fields in diagnostics to this.
626 for (auto& p : m_storeDAQDiagnostics)
627 p.setEmuPipelineAddress(majorAPV->first);
628
629 unsigned short apvsByPipelineSize = apvsByPipeline.size();
630 if (majorAPV->first == 255) apvsByPipelineSize = 1;
631
632 // And report any upset apvs or update records
633 if (apvsByPipelineSize > 1)
634 for (const auto& p : apvsByPipeline) {
635 if (p.first == majorAPV->first or p.first == 255) continue;
636 for (const auto& fadcApv : p.second) {
637 // We have an upset APV. Look if it is a known one.
638 auto upsetRec = m_upsetAPVs.find(make_pair(fadcApv.first, fadcApv.second));
639 if (upsetRec != m_upsetAPVs.end()) {
640 // This is known to be upset, so keep quiet and update event counters
641 if (upsetRec->second.first > eventNo)
642 upsetRec->second.first = eventNo;
643 if (upsetRec->second.second < eventNo)
644 upsetRec->second.second = eventNo;
645 } else {
646 // We haven't seen this one previously.
648 m_upsetAPVs.insert(make_pair(
649 make_pair(fadcApv.first, fadcApv.second),
650 make_pair(eventNo, eventNo)
651 ));
652
653 if (!(nUpsetAPVsErrors % m_errorRate)) B2ERROR("Upset APV detected!!!" << LogVar("APV", int(fadcApv.second)) << LogVar("FADC",
654 int(fadcApv.first)) << LogVar("Event number", eventNo));
655 }
656
657 for (auto& pp : m_storeDAQDiagnostics) {
658
659 if (pp.getFADCNumber() == fadcApv.first and pp.getAPVNumber() == fadcApv.second)
660 pp.setUpsetAPV(true);
661 }
662
663 }
664 }
665
666 // Here we can delete digits coming from upset APVs. We detect them by comparing
667 // actual and emulated pipeline address fields in DAQDiagnostics.
668 for (auto& p : diagnosticMap) {
669
670 if ((m_killUpsetDigits && p.second->getPipelineAddress() != p.second->getEmuPipelineAddress()) || p.second->getFTBError() != 240
671 || p.second->getFTBFlags() || p.second->getAPVError() || !(p.second->getAPVMatch()) || !(p.second->getFADCMatch())
672 || p.second->getBadHeader()
673 || p.second->getBadMapping() || p.second->getUpsetAPV() || p.second->getMissedHeader() || p.second->getMissedTrailer()) continue;
674 m_storeShaperDigits.appendNew(p.first);
675 }
676
677 if (!m_svdEventInfoPtr->getMatchTriggerType()) {if (!(nEventInfoMatchErrors % m_errorRate) or nEventInfoMatchErrors < 200) B2WARNING("Inconsistent SVD Trigger Type value for: " << LogVar("Event number", eventNo));}
678 if (!m_svdEventInfoPtr->getMatchModeByte()) {if (!(nEventInfoMatchErrors % m_errorRate) or nEventInfoMatchErrors < 200) B2WARNING("Inconsistent SVD ModeByte object for: " << LogVar("Event number", eventNo));}
679
680
681} //end event function
682#ifndef __clang__
683#pragma GCC diagnostic pop
684#endif
685
687{
688
689 // Summary report on missing APVs
690 if (m_missingAPVs.size() > 0) {
691 B2WARNING("SVDUnpacker summary 1: Missing APVs");
692 for (const auto& miss : m_missingAPVs)
693 B2WARNING(LogVar("Missing APV", miss.first.second) << LogVar("FADC", miss.first.first) << LogVar("since event",
694 miss.second.first) << LogVar("to event", miss.second.second));
695 }
696 if (m_upsetAPVs.size() > 0) {
697 B2WARNING("SVDUnpacker summary 2: Upset APVs");
698 for (const auto& upst : m_upsetAPVs)
699 B2WARNING(LogVar("Upset APV", upst.first.second) << LogVar("FADC", upst.first.first) <<
700 LogVar("since event", upst.second.first) << LogVar("to event", upst.second.second));
701 }
702
703 if (m_seuRecMap.size() > 0) {
704 B2WARNING("SVDUnpacker summary 2: Special SEU Recovery Data");
705 for (const auto& seu : m_seuRecMap)
706 B2WARNING(LogVar("SEU recovery data: APV", seu.first.second) << LogVar("FADC", seu.first.first) <<
707 LogVar("since event", seu.second.first) << LogVar("to event", seu.second.second));
708 }
709
710}
711
712
713// additional printing function
714void SVDUnpackerModule::printB2Debug(uint32_t* data32, uint32_t* data32_min, uint32_t* data32_max, int nWords)
715{
716
717 uint32_t* min = std::max((data32 - nWords), data32_min);
718 uint32_t* max = std::min((data32 + nWords), data32_max);
719
720 size_t counter{0};
721 std::stringstream os;
722 os << std::hex << std::setfill('0');
723 for (uint32_t* ptr = min; ptr <= max; ++ptr) {
724 os << std::setw(8) << *ptr;
725 if (++counter % 10 == 0) os << std::endl;
726 else os << " ";
727 }
728
729 os << std::endl;
730 B2INFO(os.str());
731 return;
732
733}
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
Definition: PayloadFile.h:64
@ c_ErrorIfAlreadyRegistered
If the object/array was already registered, produce an error (aborting initialisation).
Definition: DataStore.h:72
Base class for Modules.
Definition: Module.h:72
void setDescription(const std::string &description)
Sets the description of the module.
Definition: Module.cc:214
void setPropertyFlags(unsigned int propertyFlags)
Sets the flags for the module properties.
Definition: Module.cc:208
@ c_ParallelProcessingCertified
This module can be run in parallel processing mode safely (All I/O must be done through the data stor...
Definition: Module.h:80
std::string getFileName() const
Get the name of the downloaded payload file.
Definition: PayloadFile.h:35
Class to store SVD DAQ diagnostic information.
Class to store SVD mode information.
Definition: SVDModeByte.h:69
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
SVDUnpackerModule()
Constructor of the module.
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
std::map< std::pair< unsigned short, unsigned short >, std::pair< std::size_t, std::size_t > > m_seuRecMap
Map to store a list of APVs for special data for SEU recovery.
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
int nSEURecoveryCase
counter of SEU Special Recovery data cases
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 &paramVariable, const std::string &description, const T &defaultValue)
Adds a new parameter to the module.
Definition: Module.h:560
#define REG_MODULE(moduleName)
Register the given module (without 'Module' suffix) with the framework.
Definition: Module.h:650
Namespace to encapsulate code needed for simulation and reconstrucion of the SVD.
Definition: GeoSVDCreator.h:23
Abstract base class for different kinds of events.
STL namespace.
unsigned int pipelineAddr
Pipeline Address.
unsigned int CMC1
Common Mode Noise w/o masking out particle signals.
unsigned int check
MSB "10" - for APV Header identification.
unsigned int CMC2
Common Mode Noise after masking out particle signals.
unsigned int apvErr
APV Errors field.
unsigned int apvErrOR
APV Errors Field OR.
unsigned int check
MSB "1110" - for FADC Trailer identification.
unsigned int errorsField
FTB error fields.
unsigned int eventNumber
FTB event number.
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 check
MSB "110" - for FADC Header identification.
unsigned int DAQMode
Event type(2:1): "00"…1-sample, "01"…3-sample, "10"…6-sample.
unsigned int sample3
3rd data sample
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 check
MSB "1" - for Data word identification.
unsigned int sample4
4th data sample
unsigned int sample5
5th data sample