Belle II Software release-09-00-00
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;
119 nFADCMatchErrors = -1;
120 nAPVErrors = -1;
121 nFTBFlagsErrors = -1;
123
125
126 //get the relative time shift
127 if (!m_svdGlobalConfig.isValid())
128 B2FATAL("SVDGlobalConfigParameters not valid!!");
129
130 m_relativeTimeShift = m_svdGlobalConfig->getRelativeTimeShift();
131
132}
133
134#ifndef __clang__
135#pragma GCC diagnostic push
136#pragma GCC diagnostic ignored "-Wstack-usage="
137#endif
139{
140 if (!m_rawSVD || !m_rawSVD.getEntries())
141 return;
142
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.");
148
149 SVDDAQDiagnostic* currentDAQDiagnostic;
150 vector<SVDDAQDiagnostic*> vDiagnostic_ptr;
151
152 map<SVDShaperDigit, SVDDAQDiagnostic*> diagnosticMap;
153 // Store encountered pipeline addresses with APVs in which they were observed
154 map<unsigned short, set<pair<unsigned short, unsigned short> > > apvsByPipeline;
155
156 if (!m_eventMetaDataPtr.isValid()) { // give up...
157 B2ERROR("Missing valid EventMetaData." << std::endl << "No SVDShaperDigit produced for this event!");
158 return;
159 }
160
161 bool nAPVmatch = true;
162 bool badMapping = false;
163 bool badHeader = false;
164 bool badTrailer = false;
165 bool missedHeader = false;
166 bool missedTrailer = false;
167
168 // flag to set SVDEventInfo once per event
169 bool isSetEventInfo = false;
170
171 //flag to set nAPVsamples in SVDEventInfo once per event
172 bool isSetNAPVsamples = false;
173
174 unsigned short nAPVheaders = 999;
175 set<short> seenAPVHeaders = {};
176
177 unsigned short nEntries_rawSVD = m_rawSVD.getEntries();
178 auto eventNo = m_eventMetaDataPtr->getEvent();
179
180 short fadc = 255, apv = 63;
181
182 unsigned short cntFADCboards = 0;
183 for (unsigned int i = 0; i < nEntries_rawSVD; i++) {
184
185 unsigned int numEntries_rawSVD = m_rawSVD[ i ]->GetNumEntries();
186 for (unsigned int j = 0; j < numEntries_rawSVD; j++) {
187
188 const unsigned short maxNumOfCh = m_rawSVD[i]->GetMaxNumOfCh(j);
189
190 unsigned short nWords [maxNumOfCh];
191 uint32_t* data32tab[maxNumOfCh]; //vector of pointers
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); // points at the begining of the 1st buffer
195 }
196
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;
202 unsigned short cmc1;
203 unsigned short cmc2;
204 unsigned short apvErrors;
205 unsigned short pipAddr;
206 unsigned short ftbFlags = 0;
207 unsigned short apvErrorsOR = 0;
208
209 bool is3sampleData = false;
210 bool is6sampleData = false;
211
212 for (unsigned int buf = 0; buf < maxNumOfCh; buf++) { // loop over 4(COPPER) or 48(PCIe40) buffers
213
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]));
222 }
223 continue;
224 }
225 if (m_printRaw) printB2Debug(data32tab[buf], data32tab[buf], &data32tab[buf][nWords[buf] - 1], nWords[buf]);
226
227 cntFADCboards++;
228
229 missedHeader = false;
230 missedTrailer = false;
231
232 uint32_t* data32_it = data32tab[buf];
233 short strip, sample[6];
234 vector<uint32_t> crc16vec;
235
236 //reset value for headers and trailers check
238
239 for (; data32_it != &data32tab[buf][nWords[buf]]; data32_it++) {
240 m_data32 = *data32_it; //put current 32-bit frame to union
241
242 if (m_data32 == 0xffaa0000) { // first part of FTB header
243 crc16vec.clear(); // clear the input container for crc16 calculation
244 crc16vec.push_back(m_data32);
245
246 seenHeadersAndTrailers |= 0x1; // we found FTB header
247
248 data32_it++; // go to 2nd part of FTB header
249 crc16vec.push_back(*data32_it);
250
251 m_data32 = *data32_it; //put the second 32-bit frame to union
252
253 ftbError = m_FTBHeader.errorsField;
254
255 if (ftbError != 240) {
257
259 switch (ftbError - 240) {
260 case 3:
261 B2ERROR("FADC Event Number is different from (FTB & TTD) Event Numbers");
262 break;
263 case 5:
264 B2ERROR("TTD Event Number is different from (FTB & FADC) Event Numbers");
265 break;
266 case 6:
267 B2ERROR("FTB Event Number is different from (TTD & FADC) Event Numbers");
268 break;
269 case 7:
270 B2ERROR("(FTB, TTD & FADC) Event Numbers are different from each other");
271 break;
272 default:
273 B2ERROR("Problem with errorsField variable in FTB Header" << LogVar("abnormal value", ftbError));
274 }
275 }
276 }
277
279 (eventNo & 0xFFFFFF)) {
282 m_shutUpFTBError -= 1;
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",
285 (eventNo & 0xFFFFFF)) << LogVar("Event number in the FTB", m_FTBHeader.eventNumber));
286 }
287 }
288
289 continue;
290 } // is FTB Header
291
292 crc16vec.push_back(m_data32);
293
294 if (m_MainHeader.check == 6) { // FADC header
295
296 seenHeadersAndTrailers |= 0x2; //we found FADC Header
297
298 fadc = m_MainHeader.FADCnum;
299 trgType = m_MainHeader.trgType;
300 trgNumber = m_MainHeader.trgNumber;
301 daqMode = m_MainHeader.DAQMode;
302 daqType = m_MainHeader.DAQType;
303
304 //Let's add run-dependent info: daqMode="11" in case of 3-mixed-6 sample acquisition mode.
305 if (daqType) daqMode = 3;
306
307 nAPVheaders = 0; // start counting APV headers for this FADC
308 nAPVmatch = true; //assume correct # of APV headers
309 badMapping = false; //assume correct mapping
310 badHeader = false;
311 badTrailer = false;
312
313 is3sampleData = false;
314 is6sampleData = false;
315
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;
320
321 if (
323 ((eventNo - m_FADCTriggerNumberOffset) & 0xFF)) {
324
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",
329 m_MainHeader.trgNumber) << LogVar("+ offset", m_FADCTriggerNumberOffset) << LogVar("expected", (eventNo & 0xFF)));
330 badHeader = true;
331 }
332
333 // create SVDModeByte object from MainHeader vars
335
336 // create SVDEventInfo and fill it with SVDModeByte & SVDTriggerType objects
337 if (!isSetEventInfo) {
339 m_svdEventInfoPtr.create();
340 m_svdEventInfoPtr->setModeByte(m_SVDModeByte);
341 m_svdEventInfoPtr->setTriggerType(m_SVDTriggerType);
342 m_svdEventInfoPtr->setAPVClock(m_hwClock);
343
344 //set relative time shift
345 m_svdEventInfoPtr->setRelativeShift(m_relativeTimeShift);
346 // set X-talk info online from Raw Data
347 m_svdEventInfoPtr->setCrossTalk(m_MainHeader.xTalk);
348
349 isSetEventInfo = true;
350 } else { // let's check if the current SVDModeByte and SVDTriggerType are consistent with the one stored in SVDEventInfo
351 if (m_SVDModeByte != m_svdEventInfoPtr->getModeByte()) {m_svdEventInfoPtr->setMatchModeByte(false); badHeader = true; nEventInfoMatchErrors++;}
352 if (trgType != (m_svdEventInfoPtr->getTriggerType()).getType()) { m_svdEventInfoPtr->setMatchTriggerType(false); badHeader = true; nEventInfoMatchErrors++;}
353 }
354 } // is FADC header
355
356 if (m_APVHeader.check == 2) { // APV header
357
358 nAPVheaders++;
359 apv = m_APVHeader.APVnum;
360 seenAPVHeaders.insert(apv);
361
362 cmc1 = m_APVHeader.CMC1;
363 cmc2 = m_APVHeader.CMC2;
364 apvErrors = m_APVHeader.apvErr;
365 pipAddr = m_APVHeader.pipelineAddr;
366
367 if (apvErrors != 0) {
368 nAPVErrors++;
369 if (!(nAPVErrors % m_errorRate)
370 or nAPVErrors < 100) B2ERROR("APV error has been detected." << LogVar("FADC", fadc) << LogVar("APV", apv) << LogVar("Error value",
371 apvErrors));
372 }
373 // temporary SVDDAQDiagnostic object (no info from trailers and APVmatch code)
374 currentDAQDiagnostic = m_storeDAQDiagnostics.appendNew(trgNumber, trgType, pipAddr, cmc1, cmc2, apvErrors, ftbError, true,
375 nAPVmatch,
376 badHeader, missedHeader, missedTrailer,
377 fadc, apv);
378 vDiagnostic_ptr.push_back(currentDAQDiagnostic);
379
380 apvsByPipeline[pipAddr].insert(make_pair(fadc, apv));
381 } //is APV Header
382
383 if (m_data_A.check == 0) { // data
384 strip = m_data_A.stripNum;
385
386 sample[0] = m_data_A.sample1;
387 sample[1] = m_data_A.sample2;
388 sample[2] = m_data_A.sample3;
389
390 sample[3] = 0;
391 sample[4] = 0;
392 sample[5] = 0;
393
394 // Let's check the next rawdata word to determine if we acquired 3 or 6 sample
395 data32_it++;
396 m_data32 = *data32_it;
397
398 if (m_data_B.check == 0 && strip == m_data_B.stripNum) { // 2nd data frame with the same strip number -> six samples
399
400 if (!isSetNAPVsamples) {
401 m_svdEventInfoPtr->setNSamples(6);
402 isSetNAPVsamples = true;
403 } else {
404 if (is3sampleData)
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!");
406 }
407
408 crc16vec.push_back(m_data32);
409
410 sample[3] = m_data_B.sample4;
411 sample[4] = m_data_B.sample5;
412 sample[5] = m_data_B.sample6;
413 }
414
415 else { // three samples
416 data32_it--;
417 m_data32 = *data32_it;
418
419 if (!isSetNAPVsamples) {
420 m_svdEventInfoPtr->setNSamples(3);
421 isSetNAPVsamples = true;
422 } else {
423 if (is6sampleData)
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!");
425 }
426 }
427
428 // Generating SVDShaperDigit object
429 SVDShaperDigit* newShaperDigit = m_map->NewShaperDigit(fadc, apv, strip, sample, 0.0);
430 if (newShaperDigit) {
431 diagnosticMap.insert(make_pair(*newShaperDigit, currentDAQDiagnostic));
432 delete newShaperDigit;
433 } else if (m_badMappingFatal) {
434 B2FATAL("Respective FADC/APV combination not found -->> incorrect payload in the database! ");
435 } else {
436 badMapping = true;
437 }
438
439 } //is data frame
440
441
442 if (m_FADCTrailer.check == 14) { // FADC trailer
443
444 seenHeadersAndTrailers |= 0x4; // we found FADC trailer
445
446 //additional check if we have a faulty/fake FADC that is not in the map
447 if (APVmap->find(fadc) == APVmap->end()) badMapping = true;
448
449 //comparing number of APV chips and the number of APV headers, for the current FADC
450 unsigned short nAPVs = APVmap->count(fadc);
451
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);
455 }
456
457 if (nAPVs != nAPVheaders) {
458 // There is an APV missing, detect which it is.
459 for (const auto& fadcApv : *APVmap) {
460 if (fadcApv.first != fadc) continue;
461 if (seenAPVHeaders.find(fadcApv.second) == seenAPVHeaders.end()) {
462 // We have a missing APV. Look if it is a known one.
463 auto missingRec = m_missingAPVs.find(make_pair(fadcApv.first, fadcApv.second));
464 if (missingRec != m_missingAPVs.end()) {
465 // This is known to be missing, so keep quiet and just update event counters
466 if (missingRec->second.first > eventNo)
467 missingRec->second.first = eventNo;
468 if (missingRec->second.second < eventNo)
469 missingRec->second.second = eventNo;
470 } else {
471 // We haven't seen this previously.
473 m_missingAPVs.insert(make_pair(
474 make_pair(fadcApv.first, fadcApv.second),
475 make_pair(eventNo, eventNo)
476 ));
477 if (!(nMissingAPVsErrors % m_errorRate)) B2ERROR("missing APV header! " << LogVar("Event number", eventNo) << LogVar("APV",
478 int(fadcApv.second)) << LogVar("FADC",
479 int(fadcApv.first)));
480 }
481 }
482 }
483 nAPVmatch = false;
484 } // is nAPVs != nAPVheaders
485
486 seenAPVHeaders.clear();
487
488 ftbFlags = m_FADCTrailer.FTBFlags;
489 if ((ftbFlags >> 5) != 0) badTrailer = true;
490 if (ftbFlags != 0) {
492 if (!(nFTBFlagsErrors % m_errorRate) or nFTBFlagsErrors < 100) {
493 B2ERROR(" FTB Flags variable has an active error bit(s)" << LogVar("on FADC number", fadc));
494
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!");
500 }
501 }
502
503 apvErrorsOR = m_FADCTrailer.apvErrOR;
504
505
506 }// is FADC trailer
507
508 if (m_FTBTrailer.controlWord == 0xff55) {// FTB trailer
509
510 seenHeadersAndTrailers |= 0x8; // we found FTB trailer
511
512 //check CRC16
513 crc16vec.pop_back();
514 unsigned short iCRC = crc16vec.size();
515 uint32_t crc16input[iCRC];
516
517 for (unsigned short icrc = 0; icrc < iCRC; icrc++)
518 crc16input[icrc] = htonl(crc16vec.at(icrc));
519
520 //verify CRC16
521 boost::crc_basic<16> bcrc(0x8005, 0xffff, 0, false, false);
522 bcrc.process_block(crc16input, crc16input + iCRC);
523 unsigned int checkCRC = bcrc.checksum();
524
525 if (checkCRC != m_FTBTrailer.crc16) {
526 B2WARNING("FTB CRC16 checksum DOES NOT MATCH" << LogVar("for FADC no.", fadc));
528 }
529
530 } // is FTB trailer
531
532 } // end loop over 32-bit frames in each buffer
533
534 //Let's check if all the headers and trailers were in place in the last frame
535 if (seenHeadersAndTrailers != 0xf) {
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;}
540 }
541
542 for (auto p : vDiagnostic_ptr) {
543 // adding remaining info to Diagnostic object
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);
551 }
552
553 vDiagnostic_ptr.clear();
554
555 } // end iteration on 4(COPPER)/48(PCIe40) data buffers
556
557 } // end event loop
558
559 }// end loop over RawSVD objects
560
561 // Check the number of FADC boards
562 if (cntFADCboards != nFADCboards) { // nFADCboards=52
564 if (!(nFADCMatchErrors % m_errorRate)) B2ERROR("Number of data objects in rawSVD do not match the number of FADC boards" <<
565 LogVar("# of data objects in rawSVD",
566 cntFADCboards) << LogVar("# of FADCs", nFADCboards) << LogVar("Event number", eventNo));
567
568 // We override all FADCMatch fields in diagnostics and set it to false.
569 for (auto& p : m_storeDAQDiagnostics) {
570 p.setFADCMatch(false);
571 }
572 }
573
574 // Detect upset APVs and report/treat
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(); }
579 );
580 // We set emuPipelineAddress fields in diagnostics to this.
582 for (auto& p : m_storeDAQDiagnostics)
583 p.setEmuPipelineAddress(major_apv->first);
584 // And report any upset apvs or update records
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) {
589 // We have an upset APV. Look if it is a known one.
590 auto upsetRec = m_upsetAPVs.find(make_pair(fadcApv.first, fadcApv.second));
591 if (upsetRec != m_upsetAPVs.end()) {
592 // This is known to be upset, so keep quiet and update event counters
593 if (upsetRec->second.first > eventNo)
594 upsetRec->second.first = eventNo;
595 if (upsetRec->second.second < eventNo)
596 upsetRec->second.second = eventNo;
597 } else {
598 // We haven't seen this one previously.
600 m_upsetAPVs.insert(make_pair(
601 make_pair(fadcApv.first, fadcApv.second),
602 make_pair(eventNo, eventNo)
603 ));
604 for (auto& pp : m_storeDAQDiagnostics) {
605
606 if (pp.getFADCNumber() == fadcApv.first and pp.getAPVNumber() == fadcApv.second)
607 pp.setUpsetAPV(true);
608 }
609 if (!(nUpsetAPVsErrors % m_errorRate)) B2ERROR("Upset APV detected!!!" << LogVar("APV", int(fadcApv.second)) << LogVar("FADC",
610 int(fadcApv.first)) << LogVar("Event number", eventNo));
611 }
612 }
613 }
614
615 // Here we can delete digits coming from upset APVs. We detect them by comparing
616 // actual and emulated pipeline address fields in DAQDiagnostics.
617 for (auto& p : diagnosticMap) {
618
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;
623 m_storeShaperDigits.appendNew(p.first);
624 }
625
626 if (!m_svdEventInfoPtr->getMatchTriggerType()) {if (!(nEventInfoMatchErrors % m_errorRate) or nEventInfoMatchErrors < 200) B2WARNING("Inconsistent SVD Trigger Type value for: " << LogVar("Event number", eventNo));}
627 if (!m_svdEventInfoPtr->getMatchModeByte()) {if (!(nEventInfoMatchErrors % m_errorRate) or nEventInfoMatchErrors < 200) B2WARNING("Inconsistent SVD ModeByte object for: " << LogVar("Event number", eventNo));}
628
629
630} //end event function
631#ifndef __clang__
632#pragma GCC diagnostic pop
633#endif
634
636{
637 // Summary report on missing APVs
638 if (m_missingAPVs.size() > 0) {
639 B2WARNING("SVDUnpacker summary 1: Missing APVs");
640 for (const auto& miss : m_missingAPVs)
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));
643 }
644 if (m_upsetAPVs.size() > 0) {
645 B2WARNING("SVDUnpacker summary 2: Upset APVs");
646 for (const auto& upst : m_upsetAPVs)
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));
649 }
650}
651
652
653// additional printing function
654void SVDUnpackerModule::printB2Debug(uint32_t* data32, uint32_t* data32_min, uint32_t* data32_max, int nWords)
655{
656
657 uint32_t* min = std::max((data32 - nWords), data32_min);
658 uint32_t* max = std::min((data32 + nWords), data32_max);
659
660 size_t counter{0};
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;
666 else os << " ";
667 }
668
669 os << std::endl;
670 B2INFO(os.str());
671 return;
672
673}
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
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 &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