4 #ifndef ALIHLTTPCHWCLUSTERTRANSFORMCOMPONENT_H
5 #define ALIHLTTPCHWCLUSTERTRANSFORMCOMPONENT_H
7 //* This file is property of and copyright by the ALICE HLT Project *
8 //* ALICE Experiment at CERN, All rights reserved. *
9 //* See cxx source for full Copyright notice *
11 /** @file AliHLTTPCHWClusterTransformComponent.h
12 @author Kalliopi Kanaki
17 // see below for class documentation
19 // refer to README to build package
21 // visit http://web.ift.uib.no/~kjeks/doc/alice-hlt
23 #include "AliHLTProcessor.h"
24 #include "AliTPCRecoParam.h"
27 class AliTPCTransform;
30 * @class AliHLTTPCHWClusterTransformComponent
32 * The format of the incoming HW clusters is as follows:
38 * WORD 4 : CDH4 8 32-bit words for the common data header
43 * WORD 8 : contains cluster identification (bits 30-31), Row (6 bits (bit 24-29)) and Charge (24 bits (bit 0-23))
44 * WORD 9 : contain the pad (32 bits)
45 * WORD 10 : contain the time (32 bits)
46 * WORD 11 : contain the pad error (32 bits)
47 * WORD 12 : contain the time error (32 bits)
49 * WORD 13 : contains cluster identification (bits 30-31), Row (6 bits (bit 24-29)) and Charge (24 bits (bit 0-23))
50 * WORD 14 : contains the pad (32 bits)
51 * WORD 15 : contains the time (32 bits)
52 * WORD 16 : contains the pad error (32 bits)
53 * WORD 17 : contains the time error (32 bits)
55 * WORD 18 : RCU TRAILER WORD 0
56 * WORD 19 : RCU TRAILER WORD 1
58 * WORD 18+N : RCU TRAILER WORD N
60 * The cluster is signified with bits 30 and 31 being 11 (0x3).
61 * The RCU trailer is signified with bits 30 and 31 being 10 (0x2).
63 * A buffer reads the incoming data block. We skip the first 8 words of the CDH.
64 * Then we shift 30 bits to the right to get the last 2 bits of the next word, 30 and 31.
66 * If bit3031 = 0x3 (11), we are in the beginning of a cluster.
67 * We apply a 24-bit mask to get the first 24 bits that represent the charge of the cluster.
68 * We cast the word buffer to an 8-bit pointer that will point at bit 0 (for little endian),
69 * then increment it by 3 bytes, which takes us to bit 24. The last byte of the word
70 * contains row info and the cluster tag (11).
72 * With a & bit operation the row info is retrieved (6 bits).
73 * The rest of the cluster information is contained in the following 4 words.
75 * If bit3031 = 0x2 (10), we have reached the RCU trailer.
77 * -------------------------------------------------------
79 * Short note about little endian:
81 * DE AD BE EF (a 4 byte word)
83 * The byte order in memory to represent this word will be:
90 * The least significant byte value is stored at the lowest address.
91 * http://en.wikipedia.org/wiki/Endianness#Little-endian
93 * @ingroup alihlt_tpc_components
96 class AliHLTTPCHWClusterTransformComponent : public AliHLTProcessor {
100 /** standard constructor */
101 AliHLTTPCHWClusterTransformComponent();
103 virtual ~AliHLTTPCHWClusterTransformComponent();
105 // Public functions to implement AliHLTComponent's interface.
106 // These functions are required for the registration process
108 /** interface function, see AliHLTComponent for description */
109 const char* GetComponentID();
110 /** interface function, see AliHLTComponent for description */
111 void GetInputDataTypes( vector<AliHLTComponentDataType>& list);
112 /** interface function, see AliHLTComponent for description */
113 AliHLTComponentDataType GetOutputDataType();
114 /** interface function, see AliHLTComponent for description */
115 int GetOutputDataTypes(AliHLTComponentDataTypeList& tgtList);
116 /** interface function, see AliHLTComponent for description */
117 virtual void GetOutputDataSize( unsigned long& constBase, double& inputMultiplier );
118 /** interface function, see AliHLTComponent for description */
119 AliHLTComponent* Spawn();
120 /** interface function, see @ref AliHLTComponent for description */
121 void GetOCDBObjectDescription( TMap* const targetMap);
123 void PrintDebug(AliHLTUInt32_t * buffer, Int_t size);
127 // Protected functions to implement AliHLTComponent's interface.
128 // These functions provide initialization as well as the actual processing capabilities of the component.
130 int DoInit( int argc, const char** argv );
131 int DoEvent( const AliHLTComponentEventData& evtData, const AliHLTComponentBlockData* blocks,
132 AliHLTComponentTriggerData& trigData, AliHLTUInt8_t* outputPtr,
133 AliHLTUInt32_t& size, vector<AliHLTComponentBlockData>& outputBlocks );
136 int Reconfigure(const char* cdbEntry, const char* chainId);
138 using AliHLTProcessor::DoEvent;
139 AliTPCTransform *fOfflineTransform;
141 UInt_t fChargeThreshold; //!transient
145 int ScanConfigurationArgument(int argc, const char** argv);
147 /** copy constructor prohibited */
148 AliHLTTPCHWClusterTransformComponent(const AliHLTTPCHWClusterTransformComponent&);
150 /** assignment operator prohibited */
151 AliHLTTPCHWClusterTransformComponent& operator=(const AliHLTTPCHWClusterTransformComponent&);
153 AliTPCRecoParam fOfflineTPCRecoParam; //! transient
154 static const char* fgkOCDBEntryHWTransform; //!transient
156 ClassDef(AliHLTTPCHWClusterTransformComponent, 4)