1 /**************************************************************************
2 * Copyright(c) 2007-2009, 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 **************************************************************************/
18 ///////////////////////////////////////////////////////////////////////////////
20 /// This class provides access to ITS SDD digits in raw data.
22 ///////////////////////////////////////////////////////////////////////////////
24 #include "AliITSRawStreamSDD.h"
25 #include "AliITSRawStreamSDDCompressed.h"
26 #include "AliRawReader.h"
29 ClassImp(AliITSRawStreamSDD)
31 const UInt_t AliITSRawStreamSDD::fgkCodeLength[8] = {8, 18, 2, 3, 4, 5, 6, 7};
33 //______________________________________________________________________
34 AliITSRawStreamSDD::AliITSRawStreamSDD(AliRawReader* rawReader) :
35 AliITSRawStream(rawReader),
44 fDecompressAmbra(kTRUE)
46 // create an object to read ITS SDD raw digits
48 for(Int_t im=0;im<kSDDModules;im++){
49 fLowThresholdArray[im][0]=0;
50 fLowThresholdArray[im][1]=0;
52 for(Int_t i=0;i<kFifoWords;i++) fNfifo[i]=0;
54 fRawReader->Select("ITSSDD");
56 for(Short_t i=0; i<kCarlosWords; i++) fICarlosWord[i]=0x30000000 + i; // 805306368+i;
57 for(Short_t i=0; i<kFifoWords; i++) fIFifoWord[i]=0x30000010 + i; // 805306384+i;
60 //______________________________________________________________________
61 AliITSRawStreamSDD::AliITSRawStreamSDD(const AliITSRawStreamSDD& rs) :
62 AliITSRawStream(rs.fRawReader),
63 fDDLModuleMap(rs.fDDLModuleMap),
71 fDecompressAmbra(kTRUE)
74 AliError("Copy constructor should not be used.");
76 //__________________________________________________________________________
77 AliITSRawStreamSDD& AliITSRawStreamSDD::operator=(const AliITSRawStreamSDD& rs) {
78 // assignment operator
80 AliError("Assignment opertator should not be used.");
84 //______________________________________________________________________
85 AliITSRawStreamSDD::~AliITSRawStreamSDD(){
86 if(fDDLModuleMap) delete fDDLModuleMap;
88 //______________________________________________________________________
89 UChar_t AliITSRawStreamSDD::ReadBlockAttributes(AliRawReader* rawReader){
90 // reads block attribuited from CDH
93 rawReader->Select("ITSSDD");
95 if(!rawReader->ReadNextData(data)) return 0x0;
96 }while(rawReader->GetDataSize()==0);
97 UChar_t attr=rawReader->GetBlockAttributes();
100 //______________________________________________________________________
101 AliITSRawStream* AliITSRawStreamSDD::CreateRawStreamSDD(AliRawReader* rawReader, UChar_t attributes){
102 // instantiates the proper raw stream from block attributes value
104 Int_t rawFormat=(attributes&0xE0)>>5;
106 AliITSRawStream* inputSDD;
108 inputSDD=new AliITSRawStreamSDDCompressed(rawReader);
109 inputSDD->SetADCEncoded(kTRUE);
111 inputSDD=new AliITSRawStreamSDD(rawReader);
115 //______________________________________________________________________
116 AliITSRawStream* AliITSRawStreamSDD::CreateRawStreamSDD(AliRawReader* rawReader){
117 // reads the data format from CDH and instantiates the proper raw stream
118 UChar_t attr=ReadBlockAttributes(rawReader);
119 return CreateRawStreamSDD(rawReader,attr);
121 //______________________________________________________________________
122 UInt_t AliITSRawStreamSDD::ReadBits()
124 // read bits from the given channel
125 UInt_t result = (fChannelData[fCarlosId][fChannel] & ((1<<fReadBits[fCarlosId][fChannel]) - 1));
126 fChannelData[fCarlosId][fChannel] >>= fReadBits[fCarlosId][fChannel];
127 fLastBit[fCarlosId][fChannel] -= fReadBits[fCarlosId][fChannel];
131 //______________________________________________________________________
132 Int_t AliITSRawStreamSDD::DecompAmbra(Int_t value) const
134 // AMBRA decompression (from 8 to 10 bit)
136 if ((value & 0x80) == 0) {
138 } else if ((value & 0x40) == 0) {
139 if(value&1) return 0x080 + ((value & 0x3f) << 1);
140 return 0x081 + ((value & 0x3f) << 1);
141 } else if ((value & 0x20) == 0) {
142 if(value&1) return 0x103 + ((value & 0x1f) << 3);
143 return 0x104 + ((value & 0x1f) << 3);
145 if(value&1) return 0x207 + ((value & 0x1f) << 4);
146 return 0x208 + ((value & 0x1f) << 4);
151 //______________________________________________________________________
152 Bool_t AliITSRawStreamSDD::Next()
154 // read the next raw digit
155 // returns kFALSE if there is no digit left
156 // returns kTRUE and fCompletedModule=kFALSE and fCompletedDDL=kFALSE when a digit is found
157 // returns kTRUE and fCompletedModule=kTRUE and fCompletedDDL=kFALSE when a module is completed (=3x3FFFFFFF footer words)
158 // returns kTRUE and fCompletedModule=kFALSE and fCompletedDDL=kTRUE when a DDL is completed (=jitter word)
160 fPrevModuleID = fModuleID;
161 fCompletedModule=kFALSE;
166 Bool_t kSkip = SkipHeaderWord();
167 if(!kSkip) return kSkip;
170 if ((fChannel < 0) || (fCarlosId < 0) || (fChannel >= 2) || (fCarlosId >= kModulesPerDDL) || (fLastBit[fCarlosId][fChannel] < fReadBits[fCarlosId][fChannel]) ) {
171 if (!fRawReader->ReadNextInt(fData)) return kFALSE; // read next word
174 if((fData >> 16) == 0x7F00){ // jitter word
175 fJitter = fData&0x000000ff;
177 fCompletedModule=kFALSE;
182 UInt_t nData28= fData >> 28;
183 UInt_t nData30= fData >> 30;
186 if (nData28== 0x02) { // header
187 fEventId = (fData >> 3) & 0x07FF;
188 } else if (nData28== 0x03) { // Carlos and FIFO words or Footers
189 if(fData>=fICarlosWord[0]&&fData<=fICarlosWord[11]) { // Carlos Word
190 fCarlosId = fData-fICarlosWord[0];
191 Int_t iFifoIdx = fCarlosId/3;
192 fNfifo[iFifoIdx] = fCarlosId;
193 } else if (fData>=fIFifoWord[0]&&fData<=fIFifoWord[3]){ // FIFO word
194 fCarlosId = fNfifo[fData-fIFifoWord[0]];
195 } else if(fData==0x3FFFFFFF){ // Carlos footer
196 fICountFoot[fCarlosId]++; // stop before the last word (last word=jitter)
197 if(fICountFoot[fCarlosId]==3){
198 fCompletedModule=kTRUE;
199 fCompletedDDL=kFALSE;
202 } else if(fData==0x3F1F1F1F){ // CarlosRX footer
203 // CARLOSRX footer -- do nothing
205 fRawReader->AddMajorErrorLog(kDataError,"Bad footer");
206 AliWarning(Form("Invalid data: bad footer %08X\n", fData));
209 } else if (nData30 == 0x02 || nData30 == 0x03) {
210 fChannel = nData30-2;
211 fChannelData[fCarlosId][fChannel] +=
212 (ULong64_t(fData & 0x3FFFFFFF) << fLastBit[fCarlosId][fChannel]);
213 fLastBit[fCarlosId][fChannel] += 30;
214 } else if (nData28== 0x04) {
215 // JTAG word -- do nothing
216 } else { // unknown data format
217 fRawReader->AddMajorErrorLog(kDataFormatErr,Form("Invalid data %8.8x",fData));
218 AliWarning(Form("Invalid data: %08X\n", fData));
222 if(fCarlosId>=0 && fCarlosId <kModulesPerDDL){
223 Int_t nDDL=fRawReader->GetDDLID();
224 fModuleID = GetModuleNumber(nDDL,fCarlosId);
226 } else { // decode data
227 if (fReadCode[fCarlosId][fChannel]) {// read the next code word
228 fChannelCode[fCarlosId][fChannel] = ReadBits();
229 fReadCode[fCarlosId][fChannel] = kFALSE;
230 fReadBits[fCarlosId][fChannel] = fgkCodeLength[fChannelCode[fCarlosId][fChannel]];
231 } else { // read the next data word
232 UInt_t data = ReadBits();
233 fReadCode[fCarlosId][fChannel] = kTRUE;
234 fReadBits[fCarlosId][fChannel] = 3;
235 if (fChannelCode[fCarlosId][fChannel] == 0) { // set the time bin
236 fTimeBin[fCarlosId][fChannel] = data;
237 } else if (fChannelCode[fCarlosId][fChannel] == 1) { // next anode
238 fTimeBin[fCarlosId][fChannel] = 0;
239 fAnode[fCarlosId][fChannel]++;
240 } else { // ADC signal data
241 fEightBitSignal=data + (1 << fChannelCode[fCarlosId][fChannel]);
242 if(fDecompressAmbra) fSignal = DecompAmbra(fEightBitSignal + fLowThresholdArray[fModuleID-kSPDModules][fChannel]);
243 fCoord1 = fAnode[fCarlosId][fChannel];
244 fCoord2 = fTimeBin[fCarlosId][fChannel];
245 fTimeBin[fCarlosId][fChannel]++;
246 fCompletedModule=kFALSE;
247 fCompletedDDL=kFALSE;
256 //______________________________________________________________________
257 void AliITSRawStreamSDD::Reset(){
259 //reset data member for a new ddl
260 for(Int_t i=0;i<2;i++){
261 for(Int_t ic=0;ic<kModulesPerDDL;ic++){
262 fChannelData[ic][i]=0;
264 fChannelCode[ic][i]=0;
265 fReadCode[ic][i]=kTRUE;
274 //______________________________________________________________________
275 Bool_t AliITSRawStreamSDD::SkipHeaderWord(){
276 // skip the 1 DDL header word = 0xffffffff
278 if (!fRawReader->ReadNextInt(fData)) return kFALSE;
279 if ((fData >> 30) == 0x01) continue; // JTAG word
280 if(fData==0xFFFFFFFF) return kTRUE;