1 Dieser Beschreibungstext zur Waveform wird vom Lecroy ausgegeben, wenn man
8 000000 LECROY_2_2: TEMPLATE
11 ; Explanation of the formats of waveforms and their descriptors on the
12 ; LeCroy Digital Oscilloscopes,
13 ; Software Release 44.1.1.1, 94/04/18.
15 ; A descriptor and/or a waveform consists of one or several logical data blocks
16 ; whose formats are explained below.
17 ; Usually, complete waveforms are read: at the minimum they consist of
18 ; the basic descriptor block WAVEDESC
20 ; Some more complex waveforms, e.g. Extrema data or the results of a Fourier
21 ; transform, may contain several data array blocks.
22 ; When there are more blocks, they are in the following sequence:
23 ; the basic descriptor block WAVEDESC
24 ; the history text descriptor block USERTEXT (may or may not be present)
25 ; the time array block (for RIS and sequence acquisitions only)
27 ; auxiliary or second data array block
29 ; In the following explanation, every element of a block is described by a
30 ; single line in the form
32 ; <byte position> <variable name>: <variable type> ; <comment>
36 ; <byte position> = position in bytes (decimal offset) of the variable,
37 ; relative to the beginning of the block.
39 ; <variable name> = name of the variable.
41 ; <variable type> = string up to 16-character name
42 ; terminated with a null byte
43 ; byte 8-bit signed data value
44 ; word 16-bit signed data value
45 ; long 32-bit signed data value
46 ; float 32-bit IEEE floating point value
47 ; with the format shown below
48 ; 31 30 .. 23 22 ... 0 bit position
51 ; s = sign of the fraction
52 ; exponent = 8 bit exponent e
53 ; fraction = 23 bit fraction f
54 ; and the final value is
55 ; (-1)**s * 2**(e-127) * 1.f
56 ; double 64-bit IEEE floating point value
57 ; with the format shown below
58 ; 63 62 .. 52 51 ... 0 bit position
61 ; s = sign of the fraction
62 ; exponent = 11 bit exponent e
63 ; fraction = 52 bit fraction f
64 ; and the final value is
65 ; (-1)**s * 2**(e-1023) * 1.f
66 ; enum enumerated value in the range 0 to N
67 ; represented as a 16-bit data value.
68 ; The list of values follows immediately.
69 ; The integer is preceded by an _.
70 ; time_stamp double precision floating point number,
71 ; for the number of seconds and some bytes
72 ; for minutes, hours, days, months and year.
74 ; double seconds (0 to 59)
75 ; byte minutes (0 to 59)
76 ; byte hours (0 to 23)
78 ; byte months (1 to 12)
79 ; word year (0 to 16000)
81 ; There are 16 bytes in a time field.
82 ; data byte, word or float, depending on the
83 ; read-out mode reflected by the WAVEDESC
84 ; variable COMM_TYPE, modifiable via the
85 ; remote command COMM_FORMAT.
86 ; text arbitrary length text string
88 ; unit_definition a unit definition consists of a 48 character
89 ; ASCII string terminated with a null byte
92 ;==========================================================================
96 ; Explanation of the wave descriptor block WAVEDESC;
99 < 0> DESCRIPTOR_NAME: string ; the first 8 chars are always WAVEDESC
101 < 16> TEMPLATE_NAME: string
103 < 32> COMM_TYPE: enum ; chosen by remote command COMM_FORMAT
108 < 34> COMM_ORDER: enum
114 ; The following variables of this basic wave descriptor block specify
115 ; the block lengths of all blocks of which the entire waveform (as it is
116 ; currently being read) is composed. If a block length is zero, this
117 ; block is (currently) not present.
122 < 36> WAVE_DESCRIPTOR: long ; length in bytes of block WAVEDESC
123 < 40> USER_TEXT: long ; length in bytes of block USERTEXT
124 < 44> RES_DESC1: long ;
128 < 48> TRIGTIME_ARRAY: long ; length in bytes of TRIGTIME array
130 < 52> RIS_TIME_ARRAY: long ; length in bytes of RIS_TIME array
132 < 56> RES_ARRAY1: long ; an expansion entry is reserved
134 < 60> WAVE_ARRAY_1: long ; length in bytes of 1st simple
135 ; data array. In transmitted waveform,
136 ; represent the number of transmitted
137 ; bytes in accordance with the NP
138 ; parameter of the WFSU remote command
139 ; and the used format (see COMM_TYPE).
141 < 64> WAVE_ARRAY_2: long ; length in bytes of 2nd simple
144 < 68> RES_ARRAY2: long
145 < 72> RES_ARRAY3: long ; 2 expansion entries are reserved
147 ; The following variables identify the instrument
149 < 76> INSTRUMENT_NAME: string
151 < 92> INSTRUMENT_NUMBER: long
153 < 96> TRACE_LABEL: string ; identifies the waveform.
155 <112> RESERVED1: word
156 <114> RESERVED2: word ; 2 expansion entries
158 ; The following variables describe the waveform and the time at
159 ; which the waveform was generated.
161 <116> WAVE_ARRAY_COUNT: long ; number of data points in the data
162 ; array. If there are two data
163 ; arrays (FFT or Extrema), this number
164 ; applies to each array separately.
166 <120> PNTS_PER_SCREEN: long ; nominal number of data points
169 <124> FIRST_VALID_PNT: long ; count of number of points to skip
170 ; before first good point
171 ; FIRST_VALID_POINT = 0
172 ; for normal waveforms.
174 <128> LAST_VALID_PNT: long ; index of last good data point
175 ; in record before padding (blanking)
177 ; LAST_VALID_POINT = WAVE_ARRAY_COUNT-1
178 ; except for aborted sequence
179 ; and rollmode acquisitions
181 <132> FIRST_POINT: long ; for input and output, indicates
182 ; the offset relative to the
183 ; beginning of the trace buffer.
184 ; Value is the same as the FP parameter
185 ; of the WFSU remote command.
187 <136> SPARSING_FACTOR: long ; for input and output, indicates
188 ; the sparsing into the transmitted
190 ; Value is the same as the SP parameter
191 ; of the WFSU remote command.
193 <140> SEGMENT_INDEX: long ; for input and output, indicates the
194 ; index of the transmitted segment.
195 ; Value is the same as the SN parameter
196 ; of the WFSU remote command.
198 <144> SUBARRAY_COUNT: long ; for Sequence, acquired segment count,
199 ; between 0 and NOM_SUBARRAY_COUNT
201 <148> SWEEPS_PER_ACQ: long ; for Average or Extrema,
202 ; number of sweeps accumulated
205 <152> POINTS_PER_PAIR: word ; for Peak Dectect waveforms (which always
206 ; include data points in DATA_ARRAY_1 and
207 ; min/max pairs in DATA_ARRAY_2).
208 ; Value is the number of data points for
211 <154> PAIR_OFFSET: word ; for Peak Dectect waveforms only
212 ; Value is the number of data points by
213 ; which the first min/max pair in
214 ; DATA_ARRAY_2 is offset relative to the
215 ; first data value in DATA_ARRAY_1.
217 <156> VERTICAL_GAIN: float
219 <160> VERTICAL_OFFSET: float ; to get floating values from raw data :
220 ; VERTICAL_GAIN * data - VERTICAL_OFFSET
222 <164> MAX_VALUE: float ; maximum allowed value. It corresponds
223 ; to the upper edge of the grid.
225 <168> MIN_VALUE: float ; minimum allowed value. It corresponds
226 ; to the lower edge of the grid.
228 <172> NOMINAL_BITS: word ; a measure of the intrinsic precision
229 ; of the observation: ADC data is 8 bit
230 ; averaged data is 10-12 bit, etc.
232 <174> NOM_SUBARRAY_COUNT: word ; for Sequence, nominal segment count
235 <176> HORIZ_INTERVAL: float ; sampling interval for time domain
238 <180> HORIZ_OFFSET: double ; trigger offset for the first sweep of
239 ; the trigger, seconds between the
240 ; trigger and the first data point
242 <188> PIXEL_OFFSET: double ; needed to know how to display the
245 <196> VERTUNIT: unit_definition ; units of the vertical axis
247 <244> HORUNIT: unit_definition ; units of the horizontal axis
249 <292> RESERVED3: word
250 <294> RESERVED4: word ; 2 expansion entries
252 <296> TRIGGER_TIME: time_stamp ; time of the trigger
254 <312> ACQ_DURATION: float ; duration of the acquisition (in sec)
255 ; in multi-trigger waveforms.
256 ; (e.g. sequence, RIS, or averaging)
258 <316> RECORD_TYPE: enum
263 _4 filter_coefficient
271 <318> PROCESSING_DONE: enum
282 <320> RESERVED5: word ; expansion entry
284 <322> RIS_SWEEPS: word ; for RIS, the number of sweeps
287 ; The following variables describe the basic acquisition
288 ; conditions used when the waveform was acquired
342 <326> VERT_COUPLING: enum
350 <328> PROBE_ATT: float
352 <332> FIXED_VERT_GAIN: enum
383 <334> BANDWIDTH_LIMIT: enum
388 <336> VERTICAL_VERNIER: float
390 <340> ACQ_VERT_OFFSET: float
392 <344> WAVE_SOURCE: enum
402 ;==========================================================================
406 ; Explanation of the descriptor block USERTEXT at most 160 bytes long.
409 < 0> TEXT: text ; a list of ASCII characters
413 ;==========================================================================
417 ; Explanation of the data array DATA_ARRAY_1.
418 ; This main data array is always present. It is the only data array for
420 ; The data item is repeated for each acquired or computed data point
421 ; of the first data array of any waveform.
423 < 0> MEASUREMENT: data ; the actual format of a data is
424 ; given in the WAVEDESC descriptor
425 ; by the COMM_TYPE variable.
429 ;==========================================================================
433 ; Explanation of the data array DATA_ARRAY_2.
434 ; This is an optional secondary data array for special types of waveforms:
435 ; Complex FFT imaginary part (real part in DATA_ARRAY_1)
436 ; Extrema floor trace (roof trace in DATA_ARRAY_1)
437 ; Peak Detect min/max pairs (data values in DATA_ARRAY_1)
438 ; In the first 2 cases, there is exactly one data item in DATA_ARRAY_2 for
439 ; each data item in DATA_ARRAY_1.
440 ; In Peak Detect waveforms, there may be fewer data values in DATA_ARRAY_2,
441 ; as described by the variable POINTS_PER_PAIR.
443 < 0> MEASUREMENT: data ; the actual format of a data is
444 ; given in the WAVEDESC descriptor
445 ; by the COMM_TYPE variable.
449 ;==========================================================================
453 ; Explanation of the trigger time array TRIGTIME.
454 ; This optional time array is only present with SEQNCE waveforms.
455 ; The following data block is repeated for each segment which makes up
456 ; the acquired sequence record.
458 < 0> TRIGGER_TIME: double ; for sequence acquisitions,
459 ; time in seconds from first
460 ; trigger to this one
462 < 8> TRIGGER_OFFSET: double ; the trigger offset is in seconds
463 ; from trigger to zeroth data point
467 ;==========================================================================
471 ; Explanation of the random-interleaved-sampling (RIS) time array RISTIME.
472 ; This optional time array is only present with RIS waveforms.
473 ; This data block is repeated for each sweep which makes up the RIS record
475 < 0> RIS_OFFSET: double ; seconds from trigger to zeroth
480 ;==========================================================================
484 ; Explanation of the data array SIMPLE.
485 ; This data array is identical to DATA_ARRAY_1. SIMPLE is an accepted
486 ; alias name for DATA_ARRAY_1.
488 < 0> MEASUREMENT: data ; the actual format of a data is
489 ; given in the WAVEDESC descriptor
490 ; by the COMM_TYPE variable.
494 ;==========================================================================
498 ; Explanation of the DUAL array.
499 ; This data array is identical to DATA_ARRAY_1, followed by DATA_ARRAY_2.
500 ; DUAL is an accepted alias name for the combined arrays DATA_ARRAY_1 and
501 ; DATA_ARRAY_2 (e.g. real and imaginary parts of an FFT).
503 < 0> MEASUREMENT_1: data ; data in DATA_ARRAY_1.
505 < 0> MEASUREMENT_2: data ; data in DATA_ARRAY_2.