Belle II Software  release-08-01-10
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  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) {
491  nFTBFlagsErrors++;
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));
527  m_wrongFTBcrc++;
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
654 void 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
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.
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