Belle II Software  release-06-01-15
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 
30 using namespace std;
31 using namespace Belle2;
32 using namespace Belle2::SVD;
33 
34 //-----------------------------------------------------------------
35 // Register the Module
36 //-----------------------------------------------------------------
37 REG_MODULE(SVDUnpacker)
38 
39 //-----------------------------------------------------------------
40 // Implementation
41 //-----------------------------------------------------------------
42 
43 std::string Belle2::SVD::SVDUnpackerModule::m_xmlFileName = std::string("SVDChannelMapping.xml");
44 
45 SVDUnpackerModule::SVDUnpackerModule() : Module(),
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 
86  m_storeShaperDigits.registerInDataStore(m_svdShaperDigitListName);
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 
114  nTriggerMatchErrors = -1;
115  nEventMatchErrors = -1;
116  nUpsetAPVsErrors = -1;
117  nErrorFieldErrors = -1;
118  nMissingAPVsErrors = -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 
258  if (!(nErrorFieldErrors % m_errorRate) or nErrorFieldErrors < 100) {
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 
278  if (m_FTBHeader.eventNumber !=
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) {
338  m_SVDTriggerType = SVDTriggerType(trgType);
339  m_svdEventInfoPtr.create();
340  m_svdEventInfoPtr->setModeByte(m_SVDModeByte);
341  m_svdEventInfoPtr->setTriggerType(m_SVDTriggerType);
342 
343  //set relative time shift
344  m_svdEventInfoPtr->setRelativeShift(m_relativeTimeShift);
345  // set X-talk info online from Raw Data
346  m_svdEventInfoPtr->setCrossTalk(m_MainHeader.xTalk);
347 
348  isSetEventInfo = true;
349  } else { // let's check if the current SVDModeByte and SVDTriggerType are consistent with the one stored in SVDEventInfo
350  if (m_SVDModeByte != m_svdEventInfoPtr->getModeByte()) {m_svdEventInfoPtr->setMatchModeByte(false); badHeader = true; nEventInfoMatchErrors++;}
351  if (trgType != (m_svdEventInfoPtr->getTriggerType()).getType()) { m_svdEventInfoPtr->setMatchTriggerType(false); badHeader = true; nEventInfoMatchErrors++;}
352  }
353  } // is FADC header
354 
355  if (m_APVHeader.check == 2) { // APV header
356 
357  nAPVheaders++;
358  apv = m_APVHeader.APVnum;
359  seenAPVHeaders.insert(apv);
360 
361  cmc1 = m_APVHeader.CMC1;
362  cmc2 = m_APVHeader.CMC2;
363  apvErrors = m_APVHeader.apvErr;
364  pipAddr = m_APVHeader.pipelineAddr;
365 
366  if (apvErrors != 0) {
367  nAPVErrors++;
368  if (!(nAPVErrors % m_errorRate)
369  or nAPVErrors < 100) B2ERROR("APV error has been detected." << LogVar("FADC", fadc) << LogVar("APV", apv) << LogVar("Error value",
370  apvErrors));
371  }
372  // temporary SVDDAQDiagnostic object (no info from trailers and APVmatch code)
373  currentDAQDiagnostic = m_storeDAQDiagnostics.appendNew(trgNumber, trgType, pipAddr, cmc1, cmc2, apvErrors, ftbError, true,
374  nAPVmatch,
375  badHeader, missedHeader, missedTrailer,
376  fadc, apv);
377  vDiagnostic_ptr.push_back(currentDAQDiagnostic);
378 
379  apvsByPipeline[pipAddr].insert(make_pair(fadc, apv));
380  } //is APV Header
381 
382  if (m_data_A.check == 0) { // data
383  strip = m_data_A.stripNum;
384 
385  sample[0] = m_data_A.sample1;
386  sample[1] = m_data_A.sample2;
387  sample[2] = m_data_A.sample3;
388 
389  sample[3] = 0;
390  sample[4] = 0;
391  sample[5] = 0;
392 
393  // Let's check the next rawdata word to determine if we acquired 3 or 6 sample
394  data32_it++;
395  m_data32 = *data32_it;
396 
397  if (m_data_B.check == 0 && strip == m_data_B.stripNum) { // 2nd data frame with the same strip number -> six samples
398 
399  if (!isSetNAPVsamples) {
400  m_svdEventInfoPtr->setNSamples(6);
401  isSetNAPVsamples = true;
402  } else {
403  if (is3sampleData)
404  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!");
405  }
406 
407  crc16vec.push_back(m_data32);
408 
409  sample[3] = m_data_B.sample4;
410  sample[4] = m_data_B.sample5;
411  sample[5] = m_data_B.sample6;
412  }
413 
414  else { // three samples
415  data32_it--;
416  m_data32 = *data32_it;
417 
418  if (!isSetNAPVsamples) {
419  m_svdEventInfoPtr->setNSamples(3);
420  isSetNAPVsamples = true;
421  } else {
422  if (is6sampleData)
423  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!");
424  }
425  }
426 
427  // Generating SVDShaperDigit object
428  SVDShaperDigit* newShaperDigit = m_map->NewShaperDigit(fadc, apv, strip, sample, 0.0);
429  if (newShaperDigit) {
430  diagnosticMap.insert(make_pair(*newShaperDigit, currentDAQDiagnostic));
431  delete newShaperDigit;
432  } else if (m_badMappingFatal) {
433  B2FATAL("Respective FADC/APV combination not found -->> incorrect payload in the database! ");
434  } else {
435  badMapping = true;
436  }
437 
438  } //is data frame
439 
440 
441  if (m_FADCTrailer.check == 14) { // FADC trailer
442 
443  seenHeadersAndTrailers |= 0x4; // we found FADC trailer
444 
445  //additional check if we have a faulty/fake FADC that is not in the map
446  if (APVmap->find(fadc) == APVmap->end()) badMapping = true;
447 
448  //comparing number of APV chips and the number of APV headers, for the current FADC
449  unsigned short nAPVs = APVmap->count(fadc);
450 
451  if (nAPVheaders == 0) {
452  currentDAQDiagnostic = m_storeDAQDiagnostics.appendNew(0, 0, 0, 0, 0, 0, ftbError, true, nAPVmatch, badHeader, 0, 0, fadc, 0);
453  vDiagnostic_ptr.push_back(currentDAQDiagnostic);
454  }
455 
456  if (nAPVs != nAPVheaders) {
457  // There is an APV missing, detect which it is.
458  for (const auto& fadcApv : *APVmap) {
459  if (fadcApv.first != fadc) continue;
460  if (seenAPVHeaders.find(fadcApv.second) == seenAPVHeaders.end()) {
461  // We have a missing APV. Look if it is a known one.
462  auto missingRec = m_missingAPVs.find(make_pair(fadcApv.first, fadcApv.second));
463  if (missingRec != m_missingAPVs.end()) {
464  // This is known to be missing, so keep quiet and just update event counters
465  if (missingRec->second.first > eventNo)
466  missingRec->second.first = eventNo;
467  if (missingRec->second.second < eventNo)
468  missingRec->second.second = eventNo;
469  } else {
470  // We haven't seen this previously.
472  m_missingAPVs.insert(make_pair(
473  make_pair(fadcApv.first, fadcApv.second),
474  make_pair(eventNo, eventNo)
475  ));
476  if (!(nMissingAPVsErrors % m_errorRate)) B2ERROR("missing APV header! " << LogVar("Event number", eventNo) << LogVar("APV",
477  int(fadcApv.second)) << LogVar("FADC",
478  int(fadcApv.first)));
479  }
480  }
481  }
482  nAPVmatch = false;
483  } // is nAPVs != nAPVheaders
484 
485  seenAPVHeaders.clear();
486 
487  ftbFlags = m_FADCTrailer.FTBFlags;
488  if ((ftbFlags >> 5) != 0) badTrailer = true;
489  if (ftbFlags != 0) {
490  nFTBFlagsErrors++;
491  if (!(nFTBFlagsErrors % m_errorRate) or nFTBFlagsErrors < 100) {
492  B2ERROR(" FTB Flags variable has an active error bit(s)" << LogVar("on FADC number", fadc));
493 
494  if (ftbFlags & 16) B2ERROR("----> CRC error has been detected. Data might be corrupted!");
495  if (ftbFlags & 8) B2ERROR("----> Bad Event indication has been detected. Data might be corrupted!");
496  if (ftbFlags & 4) B2ERROR("----> Double Header has been detected. Data might be corrupted!");
497  if (ftbFlags & 2) B2ERROR("----> Time Out has been detected. Data might be corrupted!");
498  if (ftbFlags & 1) B2ERROR("----> Event Too Long! Data might be corrupted!");
499  }
500  }
501 
502  apvErrorsOR = m_FADCTrailer.apvErrOR;
503 
504 
505  }// is FADC trailer
506 
507  if (m_FTBTrailer.controlWord == 0xff55) {// FTB trailer
508 
509  seenHeadersAndTrailers |= 0x8; // we found FTB trailer
510 
511  //check CRC16
512  crc16vec.pop_back();
513  unsigned short iCRC = crc16vec.size();
514  uint32_t crc16input[iCRC];
515 
516  for (unsigned short icrc = 0; icrc < iCRC; icrc++)
517  crc16input[icrc] = htonl(crc16vec.at(icrc));
518 
519  //verify CRC16
520  boost::crc_basic<16> bcrc(0x8005, 0xffff, 0, false, false);
521  bcrc.process_block(crc16input, crc16input + iCRC);
522  unsigned int checkCRC = bcrc.checksum();
523 
524  if (checkCRC != m_FTBTrailer.crc16) {
525  B2WARNING("FTB CRC16 checksum DOES NOT MATCH" << LogVar("for FADC no.", fadc));
526  m_wrongFTBcrc++;
527  }
528 
529  } // is FTB trailer
530 
531  } // end loop over 32-bit frames in each buffer
532 
533  //Let's check if all the headers and trailers were in place in the last frame
534  if (seenHeadersAndTrailers != 0xf) {
535  if (!(seenHeadersAndTrailers & 1)) {B2ERROR("Missing FTB Header is detected. SVD data might be corrupted!" << LogVar("Event number", eventNo) << LogVar("FADC", fadc)); missedHeader = true;}
536  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;}
537  if (!(seenHeadersAndTrailers & 4)) {B2ERROR("Missing FADC Trailer is detected. SVD data might be corrupted!" << LogVar("Event number", eventNo) << LogVar("FADC", fadc)); missedTrailer = true;}
538  if (!(seenHeadersAndTrailers & 8)) {B2ERROR("Missing FTB Trailer is detected. SVD data might be corrupted!" << LogVar("Event number", eventNo) << LogVar("FADC", fadc)); missedTrailer = true;}
539  }
540 
541  for (auto p : vDiagnostic_ptr) {
542  // adding remaining info to Diagnostic object
543  p->setFTBFlags(ftbFlags);
544  p->setApvErrorOR(apvErrorsOR);
545  p->setAPVMatch(nAPVmatch);
546  p->setBadMapping(badMapping);
547  p->setBadTrailer(badTrailer);
548  p->setMissedHeader(missedHeader);
549  p->setMissedTrailer(missedTrailer);
550  }
551 
552  vDiagnostic_ptr.clear();
553 
554  } // end iteration on 4(COPPER)/48(PCIe40) data buffers
555 
556  } // end event loop
557 
558  }// end loop over RawSVD objects
559 
560  // Check the number of FADC boards
561  if (cntFADCboards != nFADCboards) { // nFADCboards=52
563  if (!(nFADCMatchErrors % m_errorRate)) B2ERROR("Number of data objects in rawSVD do not match the number of FADC boards" <<
564  LogVar("# of data objects in rawSVD",
565  cntFADCboards) << LogVar("# of FADCs", nFADCboards) << LogVar("Event number", eventNo));
566 
567  // We override all FADCMatch fields in diagnostics and set it to false.
568  for (auto& p : m_storeDAQDiagnostics) {
569  p.setFADCMatch(false);
570  }
571  }
572 
573  // Detect upset APVs and report/treat
574  auto major_apv = max_element(apvsByPipeline.begin(), apvsByPipeline.end(),
575  [](const decltype(apvsByPipeline)::value_type & p1,
576  const decltype(apvsByPipeline)::value_type & p2) -> bool
577  { return p1.second.size() < p2.second.size(); }
578  );
579  // We set emuPipelineAddress fields in diagnostics to this.
581  for (auto& p : m_storeDAQDiagnostics)
582  p.setEmuPipelineAddress(major_apv->first);
583  // And report any upset apvs or update records
584  if (apvsByPipeline.size() > 1)
585  for (const auto& p : apvsByPipeline) {
586  if (p.first == major_apv->first) continue;
587  for (const auto& fadcApv : p.second) {
588  // We have an upset APV. Look if it is a known one.
589  auto upsetRec = m_upsetAPVs.find(make_pair(fadcApv.first, fadcApv.second));
590  if (upsetRec != m_upsetAPVs.end()) {
591  // This is known to be upset, so keep quiet and update event counters
592  if (upsetRec->second.first > eventNo)
593  upsetRec->second.first = eventNo;
594  if (upsetRec->second.second < eventNo)
595  upsetRec->second.second = eventNo;
596  } else {
597  // We haven't seen this one previously.
599  m_upsetAPVs.insert(make_pair(
600  make_pair(fadcApv.first, fadcApv.second),
601  make_pair(eventNo, eventNo)
602  ));
603  for (auto& pp : m_storeDAQDiagnostics) {
604 
605  if (pp.getFADCNumber() == fadcApv.first and pp.getAPVNumber() == fadcApv.second)
606  pp.setUpsetAPV(true);
607  }
608  if (!(nUpsetAPVsErrors % m_errorRate)) B2ERROR("Upset APV detected!!!" << LogVar("APV", int(fadcApv.second)) << LogVar("FADC",
609  int(fadcApv.first)) << LogVar("Event number", eventNo));
610  }
611  }
612  }
613 
614  // Here we can delete digits coming from upset APVs. We detect them by comparing
615  // actual and emulated pipeline address fields in DAQDiagnostics.
616  for (auto& p : diagnosticMap) {
617 
618  if ((m_killUpsetDigits && p.second->getPipelineAddress() != p.second->getEmuPipelineAddress()) || p.second->getFTBError() != 240
619  || p.second->getFTBFlags() || p.second->getAPVError() || !(p.second->getAPVMatch()) || !(p.second->getFADCMatch())
620  || p.second->getBadHeader()
621  || p.second->getBadMapping() || p.second->getUpsetAPV() || p.second->getMissedHeader() || p.second->getMissedTrailer()) continue;
622  m_storeShaperDigits.appendNew(p.first);
623  }
624 
625  if (!m_svdEventInfoPtr->getMatchTriggerType()) {if (!(nEventInfoMatchErrors % m_errorRate) or nEventInfoMatchErrors < 200) B2WARNING("Inconsistent SVD Trigger Type value for: " << LogVar("Event number", eventNo));}
626  if (!m_svdEventInfoPtr->getMatchModeByte()) {if (!(nEventInfoMatchErrors % m_errorRate) or nEventInfoMatchErrors < 200) B2WARNING("Inconsistent SVD ModeByte object for: " << LogVar("Event number", eventNo));}
627 
628 
629 } //end event function
630 #ifndef __clang__
631 #pragma GCC diagnostic pop
632 #endif
633 
635 {
636  // Summary report on missing APVs
637  if (m_missingAPVs.size() > 0) {
638  B2WARNING("SVDUnpacker summary 1: Missing APVs");
639  for (const auto& miss : m_missingAPVs)
640  B2WARNING(LogVar("Missing APV", miss.first.second) << LogVar("FADC", miss.first.first) << LogVar("since event",
641  miss.second.first) << LogVar("to event", miss.second.second));
642  }
643  if (m_upsetAPVs.size() > 0) {
644  B2WARNING("SVDUnpacker summary 2: Upset APVs");
645  for (const auto& upst : m_upsetAPVs)
646  B2WARNING(LogVar("Upset APV", upst.first.second) << LogVar("FADC", upst.first.first) <<
647  LogVar("since event", upst.second.first) << LogVar("to event", upst.second.second));
648  }
649 }
650 
651 
652 // additional printing function
653 void SVDUnpackerModule::printB2Debug(uint32_t* data32, uint32_t* data32_min, uint32_t* data32_max, int nWords)
654 {
655 
656  uint32_t* min = std::max((data32 - nWords), data32_min);
657  uint32_t* max = std::min((data32 + nWords), data32_max);
658 
659  size_t counter{0};
660  std::stringstream os;
661  os << std::hex << std::setfill('0');
662  for (uint32_t* ptr = min; ptr <= max; ++ptr) {
663  os << std::setw(8) << *ptr;
664  if (++counter % 10 == 0) os << std::endl;
665  else os << " ";
666  }
667 
668  os << std::endl;
669  B2INFO(os.str());
670  return;
671 
672 }
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
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.
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.
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