User manual

Discussion
All structures used in this function can be found in the header files AcqirisT3Interface.h and
AcqirisDataTypes.h.
The type of the dataArray is determined from the AqT3ReadParameters struct entry dataType.
 dataType = 4 is used for raw data. For example, the 32-bit natural readout of the TC890 TOF multihit
mode is of AqT3SampleType AqT3Struct50ps6ch and has the following format:
31 28-30 0-27
Overflow Channel Data
where
Channel = 1…6 denotes the physical channels. The Data bits give the time value in units of 50 ps
0 is for the start of the next event. In this case the Data bits give the count of the common start
within the current acquisition
7 is for marker data with Data
= 0 : Switch from Auxiliary input A
= 1 : Switch marker: Common channel Event count.
= 2 : Switch marker: Memory Full.
= 16 : Marker: Auxiliary input B marker.
 dataType = 3 is used for double floating-point format time results. These results are always in seconds.
A value of 1e10 is a sign that the channel in question did not see a stop.
 dataType = 2 is used for integer format time results. These results are always in multiples of the
granularity given by the AqT3SampleType values of AqT3Count50psInt32 or AqT3Count5psInt32. A
value of 0 is a sign that the channel in question did not see a stop.
The dataSizeInBytes must fulfill the storage requirement for the raw data read from the device. This means
that for the TC840
single hit mode - 104 bytes
multi-start mode - 52KB = 53248 bytes
and for the TC890 you must configure it as a function of the number of expected values, including the start,
and markers counting 4 bytes for each. The worst case is the full bank of 8MB = 8388608.
Data beyond the point implied by the nbrSamples returned value must be ignored.
The TC890 memory overflow flags show whether that condition happened since the previous call of the
readData routine.
Programmer’s Reference Manual Page 202 of 210