1 /**************************************************************************
2 * Copyright(c) 1998-1999, ALICE Experiment at CERN, All rights reserved. *
4 * Author: The ALICE Off-line Project. *
5 * Contributors are mentioned in the code where appropriate. *
7 * Permission to use, copy, modify and distribute this software and its *
8 * documentation strictly for non-commercial purposes is hereby granted *
9 * without fee, provided that the above copyright notice appears in all *
10 * copies and that both the copyright notice and this permission notice *
11 * appear in the supporting documentation. The authors make no claims *
12 * about the suitability of this software for any purpose. It is *
13 * provided "as is" without express or implied warranty. *
14 **************************************************************************/
16 /** @file AliFMDRawReader.cxx
17 @author Christian Holm Christensen <cholm@nbi.dk>
18 @date Mon Mar 27 12:45:23 2006
19 @brief Class to read raw data
22 //____________________________________________________________________
24 // Class to read ADC values from a AliRawReader object.
26 // This class uses the AliFMDRawStreamer class to read the ALTRO
34 // +-----------------+ <<references>> +--------------+
35 // | AliFMDRawReader |<>----------------| AliRawReader |
36 // +-----------------+ +--------------+
40 // +-----------------+ <<uses>> |
41 // | AliFMDRawStream |------------------------+
42 // +-----------------+
49 // #include <AliLog.h> // ALILOG_H
50 #include "AliFMDDebug.h" // Better debug macros
51 #include "AliFMDParameters.h" // ALIFMDPARAMETERS_H
52 #include "AliFMDDigit.h" // ALIFMDDIGIT_H
53 #include "AliFMDRawStream.h" // ALIFMDRAWSTREAM_H
54 #include "AliRawReader.h" // ALIRAWREADER_H
55 #include "AliFMDRawReader.h" // ALIFMDRAWREADER_H
56 #include "AliFMDDebug.h"
57 #include "AliFMDCalibSampleRate.h"
58 #include "AliFMDCalibStripRange.h"
59 // #include "AliFMDAltroIO.h" // ALIFMDALTROIO_H
60 #include <TArrayS.h> // ROOT_TArrayS
61 #include <TTree.h> // ROOT_TTree
62 #include <TClonesArray.h> // ROOT_TClonesArray
64 // #include <iostream>
67 //____________________________________________________________________
68 ClassImp(AliFMDRawReader)
70 ; // This is here to keep Emacs for indenting the next line
73 //____________________________________________________________________
74 AliFMDRawReader::AliFMDRawReader(AliRawReader* reader, TTree* tree)
75 : TTask("FMDRawReader", "Reader of Raw ADC values from the FMD"),
85 //____________________________________________________________________
87 AliFMDRawReader::Exec(Option_t*)
90 TClonesArray* array = new TClonesArray("AliFMDDigit");
95 fTree->Branch("FMD", &array);
99 Int_t nWrite = fTree->Fill();
100 AliFMDDebug(1, ("Got a grand total of %d digits, wrote %d bytes to tree",
101 array->GetEntriesFast(), nWrite));
106 //____________________________________________________________________
108 AliFMDRawReader::ReadAdcs(TClonesArray* array)
111 // Read raw data into the digits array, using AliFMDAltroReader.
113 AliError("No TClonesArray passed");
116 // if (!fReader->ReadHeader()) {
117 // AliError("Couldn't read header");
121 AliFMDParameters* pars = AliFMDParameters::Instance();
122 AliFMDRawStream input(fReader);
123 AliFMDDebug(5, ("Setting 7 word headers"));
124 input.SetShortDataHeader(!pars->HasCompleteHeader());
126 UShort_t stripMin = 0;
127 UShort_t stripMax = 127;
128 UShort_t preSamp = 14+5;
134 // Data array is approx twice the size needed.
137 Bool_t isGood = kTRUE;
139 isGood = input.ReadChannel(ddl, hwaddr, last, data);
142 AliFMDDebug(5, ("Read channel 0x%x of size %d", hwaddr, last));
143 UShort_t det, sec, str;
145 if (!pars->Hardware2Detector(ddl, hwaddr, det, ring, sec, str)) {
146 AliError(Form("Failed to get detector id from DDL %d "
147 "and hardware address 0x%x", ddl, hwaddr));
150 rate = pars->GetSampleRate(det, ring, sec, str);
151 stripMin = pars->GetMinStrip(det, ring, sec, str);
152 stripMax = pars->GetMaxStrip(det, ring, sec, str);
153 preSamp = pars->GetPreSamples(det, ring, sec, str);
154 AliFMDDebug(5, ("DDL 0x%04x, address 0x%03x maps to FMD%d%c[%2d,%3d]",
155 ddl, hwaddr, det, ring, sec, str));
157 // Loop over the `timebins', and make the digits
158 for (size_t i = 0; i < last; i++) {
159 if (i < preSamp) continue;
160 Int_t n = array->GetEntriesFast();
161 Short_t curStr = str + stripMin + (i-preSamp) / rate;
162 if ((curStr-str) > stripMax) {
163 // AliInfo(Form("timebin %4d -> (%3d+%3d+(%4d-%d)/%d) -> %d",
164 // i, str, stripMin, i, preSamp, rate, curStr));
165 // AliError(Form("Current strip is %3d (0x%04x,0x%03x,%4d) "
166 // "but DB says max is %3d (rate=%d)",
167 // curStr, ddl, hwaddr, i, str+stripMax, rate));
168 // Garbage timebins - ignore
171 AliFMDDebug(5, ("making digit for FMD%d%c[%2d,%3d] from sample %4d",
172 det, ring, sec, curStr, i));
173 new ((*array)[n]) AliFMDDigit(det, ring, sec, curStr, data[i],
174 (rate >= 2 ? data[i+1] : 0),
175 (rate >= 3 ? data[i+2] : 0),
176 (rate >= 4 ? data[i+3] : 0));
185 //____________________________________________________________________
187 AliFMDRawReader::ReadAdcs(TClonesArray* array)
189 // Read raw data into the digits array, using AliFMDAltroReader.
191 AliError("No TClonesArray passed");
194 // if (!fReader->ReadHeader()) {
195 // AliError("Couldn't read header");
199 AliFMDParameters* pars = AliFMDParameters::Instance();
202 fReader->Select("FMD");
204 UShort_t stripMin = 0;
205 UShort_t stripMax = 127;
206 UShort_t preSamp = 0;
210 if (!fReader->ReadNextData(cdata)) break;
211 size_t nchar = fReader->GetDataSize();
212 UShort_t ddl = fReader->GetDDLID();
214 AliFMDDebug(1, ("Reading %d bytes (%d 10bit words) from %d",
215 nchar, nchar * 8 / 10, ddl));
216 // Make a stream to read from
217 std::string str((char*)(cdata), nchar);
218 std::istringstream s(str);
219 // Prep the reader class.
220 AliFMDAltroReader r(s);
221 // Data array is approx twice the size needed.
222 UShort_t data[2048], hwaddr, last;
223 while (r.ReadChannel(hwaddr, last, data) > 0) {
224 AliFMDDebug(5, ("Read channel 0x%x of size %d", hwaddr, last));
225 UShort_t det, sec, str;
227 if (!pars->Hardware2Detector(ddl, hwaddr, det, ring, sec, str)) {
228 AliError(Form("Failed to detector id from DDL %d "
229 "and hardware address 0x%x", ddl, hwaddr));
232 rate = pars->GetSampleRate(det, ring, sec, str);
233 stripMin = pars->GetMinStrip(det, ring, sec, str);
234 stripMax = pars->GetMaxStrip(det, ring, sec, str);
235 AliFMDDebug(5, ("DDL 0x%04x, address 0x%03x maps to FMD%d%c[%2d,%3d]",
236 ddl, hwaddr, det, ring, sec, str));
238 // Loop over the `timebins', and make the digits
239 for (size_t i = 0; i < last; i++) {
240 if (i < preSamp) continue;
241 Int_t n = array->GetEntries();
242 UShort_t curStr = str + stripMin + i / rate;
243 if ((curStr-str) > stripMax) {
244 AliError(Form("Current strip is %d but DB says max is %d",
247 AliFMDDebug(5, ("making digit for FMD%d%c[%2d,%3d] from sample %4d",
248 det, ring, sec, curStr, i));
249 new ((*array)[n]) AliFMDDigit(det, ring, sec, curStr, data[i],
250 (rate >= 2 ? data[i+1] : 0),
251 (rate >= 3 ? data[i+2] : 0));
255 if (r.IsBof()) break;
263 // This is the old method, for comparison. It's really ugly, and far
265 //____________________________________________________________________
267 AliFMDRawReader::Exec(Option_t*)
269 // Read raw data into the digits array
270 // if (!fReader->ReadHeader()) {
271 // Error("ReadAdcs", "Couldn't read header");
276 TClonesArray* array = new TClonesArray("AliFMDDigit");
277 fTree->Branch("FMD", &array);
280 AliFMDParameters* pars = AliFMDParameters::Instance();
281 fSampleRate = pars->GetSampleRate(0);
283 // Use AliAltroRawStream to read the ALTRO format. No need to
284 // reinvent the wheel :-)
285 AliFMDRawStream input(fReader, fSampleRate);
287 fReader->Select("FMD");
291 UShort_t detector = 1; // Must be one here
292 UShort_t oldDetector = 0;
299 // Loop over data in file
304 Int_t ddl = fReader->GetDDLID();
305 AliFMDDebug(10, ("Current DDL is %d", ddl));
306 if (ddl != oldDDL || input.IsNewStrip() || !next) {
307 // Make a new digit, if we have some data (oldDetector == 0,
308 // means that we haven't really read anything yet - that is,
309 // it's the first time we get here).
310 if (oldDetector > 0) {
312 AliFMDDebug(10, ("Add a new strip: FMD%d%c[%2d,%3d] "
313 "(current: FMD%d%c[%2d,%3d])",
314 oldDetector, input.PrevRing(),
315 input.PrevSector() , input.PrevStrip(),
316 detector , input.Ring(), input.Sector(),
318 new ((*array)[n]) AliFMDDigit(oldDetector,
322 counts[0], counts[1], counts[2]);
326 static_cast<AliFMDDigit*>(fFMD->Digits()->
327 UncheckedAt(fFMD->GetNdigits()-1));
332 AliFMDDebug(10, ("Read %d channels for FMD%d",
333 count + 1, detector));
338 // If we got a new DDL, it means we have a new detector.
341 AliFMDDebug(10, ("Read %d channels for FMD%d", count + 1, detector));
342 // Reset counts, and update the DDL cache
345 // Check that we're processing a FMD detector
346 Int_t detId = fReader->GetDetectorID();
347 if (detId != (AliDAQ::DetectorID("FMD"))) {
348 AliError(Form("Detector ID %d != %d",
349 detId, (AliDAQ::DetectorID("FMD"))));
352 // Figure out what detector we're deling with
353 oldDetector = detector;
355 case 0: detector = 1; break;
356 case 1: detector = 2; break;
357 case 2: detector = 3; break;
359 AliError(Form("Unknown DDL 0x%x for FMD", ddl));
362 AliFMDDebug(10, ("Reading ADCs for 0x%x - That is FMD%d",
363 fReader->GetEquipmentId(), detector));
368 counts[input.Sample()] = input.Count();
370 AliFMDDebug(10, ("ADC of FMD%d%c[%2d,%3d] += %d",
371 detector, input.Ring(), input.Sector(),
372 input.Strip(), input.Count()));
373 oldDetector = detector;
380 //____________________________________________________________________
381 Bool_t AliFMDRawReader::ReadSODevent(AliFMDCalibSampleRate* sampleRate,
382 AliFMDCalibStripRange* stripRange,
384 TArrayS &pulseLength) {
386 AliFMDDebug(0, ("Start of SOD/EOD"));
388 UInt_t shift_clk[18];
389 UInt_t sample_clk[18];
390 UInt_t strip_low[18];
391 UInt_t strip_high[18];
392 UInt_t pulse_size[18];
393 UInt_t pulse_length[18];
395 while(fReader->ReadNextData(fData)) {
397 Int_t ddl = fReader->GetDDLID();
398 Int_t detID = fReader->GetDetectorID();
399 AliFMDDebug(0, (" From reader: DDL number is %d , det ID is %d",ddl,detID));
401 fNbytes = fReader->GetDataSize();
403 ULong_t nWords = GetNwords();
404 UInt_t trailerLast = Get32bitWord(nWords);
405 AliFMDDebug(20, (" # Bytes: %d, # Words: %d, Last word: 0x%08x",
406 fNbytes, nWords, trailerLast));
407 if ((trailerLast & 0xFFFF0000) != 0xAAAA0000) {
408 AliWarning(Form("Last word 0x%08x does not match RCU II trailer",
413 ULong_t nTrailerWords = trailerLast & 0x7f; // 7 last bits is size of trailer
415 ULong_t nPayloadWords = Get32bitWord(nWords - nTrailerWords+1);
416 AliFMDDebug(20, (" # trailer words: %d, # payload words: %d",
417 nTrailerWords, nPayloadWords));
420 for (ULong_t i = 1; i <= nPayloadWords ; i++) {
421 UInt_t payloadWord = Get32bitWord(i);
422 // if(!((i-CDH_length-1)%2)) {
423 // address is only 24 bit
424 UInt_t address = (0xffffff & payloadWord);
425 UInt_t type = ((address >> 21) & 0xf);
426 UInt_t error = ((address >> 20) & 0x1);
427 UInt_t bcast = ((address >> 18) & 0x1);
428 UInt_t bc_not_altro = ((address >> 17) & 0x1);
429 UInt_t board = ((address >> 12) & 0x1f);
430 UInt_t instruction = 0;
434 instruction = address & 0xfff;
436 chip = ((address >> 9) & 0x7);
437 channel = ((address >> 5) & 0x5);
438 instruction = (address & 0x1f);
442 AliWarning(Form("error bit detected at Word 0x%06x; error % d, type %d, bc_not_altro %d, bcast %d, board 0x%02x, chip 0x%x, channel 0x%02x, instruction 0x%03x",address, error, type, bc_not_altro, bcast,board,chip,channel,instruction));
444 UInt_t errorWord = Get32bitWord(i);
448 Bool_t readDataWord = kFALSE;
450 case 0x00: i++; readDataWord = kTRUE; break; //FEC_RD
451 case 0x01: i++; readDataWord = kFALSE; break; //FEC_CMD
452 case 0x10: i++; readDataWord = kFALSE; break; //FEC_WR
453 case 0x11: readDataWord = kFALSE; break; //IS: LOOP, WAIT, ENDSEQ, ENDMEM
454 default: i++; readDataWord = kFALSE; break;
457 if(!readDataWord) //Don't read unless we have a FEC_RD
459 UInt_t dataWord = Get32bitWord(i);
460 UInt_t data = (0xFFFFFF & dataWord) ;
461 //UInt_t data = (0xFFFF & dataWord) ;
465 switch(instruction) {
467 case 0x01: break; // First ADC T
468 case 0x02: break; // I 3.3 V
469 case 0x03: break; // I 2.5 V altro digital
470 case 0x04: break; // I 2.5 V altro analog
471 case 0x05: break; // I 2.5 V VA
472 case 0x06: break; // First ADC T
473 case 0x07: break; // I 3.3 V
474 case 0x08: break; // I 2.5 V altro digital
475 case 0x09: break; // I 2.5 V altro analog
476 case 0x0A: break; // I 2.5 V VA
477 case 0x2D: break; // Second ADC T
478 case 0x2E: break; // I 1.5 V VA
479 case 0x2F: break; // I -2.0 V
480 case 0x30: break; // I -2.0 V VA
481 case 0x31: break; // 2.5 V Digital driver
482 case 0x32: break; // Second ADC T
483 case 0x33: break; // I 1.5 V VA
484 case 0x34: break; // I -2.0 V
485 case 0x35: break; // I -2.0 V VA
486 case 0x36: break; // 2.5 V Digital driver
487 case 0x37: break; // Third ADC T
488 case 0x38: break; // Temperature sens. 1
489 case 0x39: break; // Temperature sens. 2
490 case 0x3A: break; // U 2.5 altro digital (m)
491 case 0x3B: break; // U 2.5 altro analog (m)
492 case 0x3C: break; // Third ADC T
493 case 0x3D: break; // Temperature sens. 1
494 case 0x3E: break; // Temperature sens. 2
495 case 0x3F: break; // U 2.5 altro digital (m)
496 case 0x40: break; // U 2.5 altro analog (m)
497 case 0x41: break; // Forth ADC T
498 case 0x42: break; // U 2.5 VA (m)
499 case 0x43: break; // U 1.5 VA (m)
500 case 0x44: break; // U -2.0 VA (m)
501 case 0x45: break; // U -2.0 (m)
502 case 0x46: break; // Forth ADC T
503 case 0x47: break; // U 2.5 VA (m)
504 case 0x48: break; // U 1.5 VA (m)
505 case 0x49: break; // U -2.0 VA (m)
506 case 0x4A: break; // U -2.0 (m)
508 case 0x0B: break; // L1 trigger CouNTer
509 case 0x0C: break; // L2 trigger CouNTer
510 case 0x0D: break; // Sampling CLK CouNTer
511 case 0x0E: break; // DSTB CouNTer
513 case 0x0F: break; // Test mode word
514 case 0x10: break; // Undersampling ratio.
515 // Configuration and status
516 case 0x11: break; // Config/Status Register 0
517 case 0x12: break; // Config/Status Register 1
518 case 0x13: break; // Config/Status Register 2
519 case 0x14: break; // Config/Status Register 3
520 case 0x15: break; // Free
522 case 0x16: break; // Latch L1, L2, SCLK Counters
523 case 0x17: break; // Clear counters
524 case 0x18: break; // Clear CSR1
525 case 0x19: break; // rstb ALTROs
526 case 0x1A: break; // rstb BC
527 case 0x1B: break; // Start conversion
528 case 0x1C: break; // Scan event length
529 case 0x1D: break; // Read event length
530 case 0x1E: break; // Start test mode
531 case 0x1F: break; // Read acquisition memory
533 case 0x20: break; // FMDD status
534 case 0x21: break; // L0 counters
535 case 0x22: break; // FMD: Wait to hold
536 case 0x23: break; // FMD: L1 timeout
537 case 0x24: break; // FMD: L2 timeout
538 case 0x25: // FMD: Shift clk
539 shift_clk[board] = ((data >> 8 ) & 0xFF);
541 case 0x26: // FMD: Strips
542 strip_low[board] = ((data >> 0 ) & 0xFF);
543 strip_high[board] = ((data >> 8 ) & 0xFF);
545 case 0x27: // FMD: Cal pulse
546 pulse_size[board] = ((data >> 8 ) & 0xFF);
548 case 0x28: break; // FMD: Shape bias
549 case 0x29: break; // FMD: Shape ref
550 case 0x2A: break; // FMD: Preamp ref
551 case 0x2B: // FMD: Sample clk
552 sample_clk[board] = ((data >> 8 ) & 0xFF);
554 case 0x2C: break; // FMD: Commands
555 case 0x4B: // FMD: Cal events
556 pulse_length[board] = ((data >> 8 ) & 0xFF);
564 UShort_t det,sector,strip;
567 const UInt_t boards[4] = {0,1,16,17};
568 for(Int_t i=0;i<4;i++) {
570 UInt_t chip =0, channel=0;
572 AliFMDParameters::Instance()->Hardware2Detector(ddl,boards[i],chip,channel,det,ring,sector,strip);
574 if(sample_clk[boards[i]])
575 samplerate = shift_clk[boards[i]]/sample_clk[boards[i]];
576 sampleRate->Set(det,ring,sector,0,samplerate);
577 stripRange->Set(det,ring,sector,0,strip_low[boards[i]],strip_high[boards[i]]);
578 pulseSize.AddAt(pulse_size[boards[i]],GetHalfringIndex(det,ring,boards[i]%16));
579 pulseLength.AddAt(pulse_length[boards[i]],GetHalfringIndex(det,ring,boards[i]%16));
581 AliFMDDebug(20, ("board %d, strip_low %d, strip_high %d",boards[i],strip_low[i],strip_high[i]));
582 AliFMDDebug(20, ("board %d, shift_clk %d, sample_clk %d",boards[i],shift_clk[i],sample_clk[i]));
588 AliFMDParameters::Instance()->SetSampleRate(sampleRate);
589 AliFMDParameters::Instance()->SetStripRange(stripRange);
591 AliFMDDebug(0, ("End of SOD/EOD"));
595 //____________________________________________________________________
597 UInt_t AliFMDRawReader::Get32bitWord(Int_t idx)
599 // This method returns the 32 bit word at a given
600 // position inside the raw data payload.
601 // The 'index' points to the beginning of the next word.
602 // The method is supposed to be endian (platform)
605 AliFatal("Raw data paylod buffer is not yet initialized !");
611 // fRawReader->AddFatalErrorLog(k32bitWordReadErr,Form("pos = %d",index));
613 AliWarning(Form("Invalid raw data payload position (%d) !",index));
617 //word = fData[--index] << 24;
618 // word |= fData[--index] << 16;
619 // word |= fData[--index] << 8;
620 //word |= fData[--index];
622 word = fData[--index] << 24;
623 word |= fData[--index] << 16;
624 word |= fData[--index] << 8;
625 word |= fData[--index] << 0 ;
629 //_____________________________________________________________________
630 Int_t AliFMDRawReader::GetHalfringIndex(UShort_t det, Char_t ring, UShort_t board) {
632 UShort_t iring = (ring == 'I' ? 1 : 0);
634 Int_t index = (((det-1) << 2) | (iring << 1) | (board << 0));
639 //____________________________________________________________________