--- /dev/null
+Dieser Beschreibungstext zur Waveform wird vom Lecroy ausgegeben, wenn man
+ TMPL?
+fragt.
+
+<pre>
+TMPL "
+/00
+000000 LECROY_2_2: TEMPLATE
+ 8 66 111
+;
+; Explanation of the formats of waveforms and their descriptors on the
+; LeCroy Digital Oscilloscopes,
+; Software Release 44.1.1.1, 94/04/18.
+;
+; A descriptor and/or a waveform consists of one or several logical data blocks
+; whose formats are explained below.
+; Usually, complete waveforms are read: at the minimum they consist of
+; the basic descriptor block WAVEDESC
+; a data array block.
+; Some more complex waveforms, e.g. Extrema data or the results of a Fourier
+; transform, may contain several data array blocks.
+; When there are more blocks, they are in the following sequence:
+; the basic descriptor block WAVEDESC
+; the history text descriptor block USERTEXT (may or may not be present)
+; the time array block (for RIS and sequence acquisitions only)
+; data array block
+; auxiliary or second data array block
+;
+; In the following explanation, every element of a block is described by a
+; single line in the form
+;
+; <byte position> <variable name>: <variable type> ; <comment>
+;
+; where
+;
+; <byte position> = position in bytes (decimal offset) of the variable,
+; relative to the beginning of the block.
+;
+; <variable name> = name of the variable.
+;
+; <variable type> = string up to 16-character name
+; terminated with a null byte
+; byte 8-bit signed data value
+; word 16-bit signed data value
+; long 32-bit signed data value
+; float 32-bit IEEE floating point value
+; with the format shown below
+; 31 30 .. 23 22 ... 0 bit position
+; s exponent fraction
+; where
+; s = sign of the fraction
+; exponent = 8 bit exponent e
+; fraction = 23 bit fraction f
+; and the final value is
+; (-1)**s * 2**(e-127) * 1.f
+; double 64-bit IEEE floating point value
+; with the format shown below
+; 63 62 .. 52 51 ... 0 bit position
+; s exponent fraction
+; where
+; s = sign of the fraction
+; exponent = 11 bit exponent e
+; fraction = 52 bit fraction f
+; and the final value is
+; (-1)**s * 2**(e-1023) * 1.f
+; enum enumerated value in the range 0 to N
+; represented as a 16-bit data value.
+; The list of values follows immediately.
+; The integer is preceded by an _.
+; time_stamp double precision floating point number,
+; for the number of seconds and some bytes
+; for minutes, hours, days, months and year.
+;
+; double seconds (0 to 59)
+; byte minutes (0 to 59)
+; byte hours (0 to 23)
+; byte days (1 to 31)
+; byte months (1 to 12)
+; word year (0 to 16000)
+; word unused
+; There are 16 bytes in a time field.
+; data byte, word or float, depending on the
+; read-out mode reflected by the WAVEDESC
+; variable COMM_TYPE, modifiable via the
+; remote command COMM_FORMAT.
+; text arbitrary length text string
+; (maximum 160)
+; unit_definition a unit definition consists of a 48 character
+; ASCII string terminated with a null byte
+; for the unit name.
+;
+;==========================================================================
+;
+WAVEDESC: BLOCK
+;
+; Explanation of the wave descriptor block WAVEDESC;
+;
+;
+< 0> DESCRIPTOR_NAME: string ; the first 8 chars are always WAVEDESC
+;
+< 16> TEMPLATE_NAME: string
+;
+< 32> COMM_TYPE: enum ; chosen by remote command COMM_FORMAT
+ _0 byte
+ _1 word
+ endenum
+;
+< 34> COMM_ORDER: enum
+ _0 HIFIRST
+ _1 LOFIRST
+ endenum
+;
+;
+; The following variables of this basic wave descriptor block specify
+; the block lengths of all blocks of which the entire waveform (as it is
+; currently being read) is composed. If a block length is zero, this
+; block is (currently) not present.
+;
+;
+;BLOCKS :
+;
+< 36> WAVE_DESCRIPTOR: long ; length in bytes of block WAVEDESC
+< 40> USER_TEXT: long ; length in bytes of block USERTEXT
+< 44> RES_DESC1: long ;
+;
+;ARRAYS :
+;
+< 48> TRIGTIME_ARRAY: long ; length in bytes of TRIGTIME array
+;
+< 52> RIS_TIME_ARRAY: long ; length in bytes of RIS_TIME array
+;
+< 56> RES_ARRAY1: long ; an expansion entry is reserved
+;
+< 60> WAVE_ARRAY_1: long ; length in bytes of 1st simple
+ ; data array. In transmitted waveform,
+ ; represent the number of transmitted
+ ; bytes in accordance with the NP
+ ; parameter of the WFSU remote command
+ ; and the used format (see COMM_TYPE).
+;
+< 64> WAVE_ARRAY_2: long ; length in bytes of 2nd simple
+ ; data array
+;
+< 68> RES_ARRAY2: long
+< 72> RES_ARRAY3: long ; 2 expansion entries are reserved
+;
+; The following variables identify the instrument
+;
+< 76> INSTRUMENT_NAME: string
+;
+< 92> INSTRUMENT_NUMBER: long
+;
+< 96> TRACE_LABEL: string ; identifies the waveform.
+;
+<112> RESERVED1: word
+<114> RESERVED2: word ; 2 expansion entries
+;
+; The following variables describe the waveform and the time at
+; which the waveform was generated.
+;
+<116> WAVE_ARRAY_COUNT: long ; number of data points in the data
+ ; array. If there are two data
+ ; arrays (FFT or Extrema), this number
+ ; applies to each array separately.
+;
+<120> PNTS_PER_SCREEN: long ; nominal number of data points
+ ; on the screen
+;
+<124> FIRST_VALID_PNT: long ; count of number of points to skip
+ ; before first good point
+ ; FIRST_VALID_POINT = 0
+ ; for normal waveforms.
+;
+<128> LAST_VALID_PNT: long ; index of last good data point
+ ; in record before padding (blanking)
+ ; was started.
+ ; LAST_VALID_POINT = WAVE_ARRAY_COUNT-1
+ ; except for aborted sequence
+ ; and rollmode acquisitions
+;
+<132> FIRST_POINT: long ; for input and output, indicates
+ ; the offset relative to the
+ ; beginning of the trace buffer.
+ ; Value is the same as the FP parameter
+ ; of the WFSU remote command.
+;
+<136> SPARSING_FACTOR: long ; for input and output, indicates
+ ; the sparsing into the transmitted
+ ; data block.
+ ; Value is the same as the SP parameter
+ ; of the WFSU remote command.
+;
+<140> SEGMENT_INDEX: long ; for input and output, indicates the
+ ; index of the transmitted segment.
+ ; Value is the same as the SN parameter
+ ; of the WFSU remote command.
+;
+<144> SUBARRAY_COUNT: long ; for Sequence, acquired segment count,
+ ; between 0 and NOM_SUBARRAY_COUNT
+;
+<148> SWEEPS_PER_ACQ: long ; for Average or Extrema,
+ ; number of sweeps accumulated
+ ; else 1
+;
+<152> POINTS_PER_PAIR: word ; for Peak Dectect waveforms (which always
+ ; include data points in DATA_ARRAY_1 and
+ ; min/max pairs in DATA_ARRAY_2).
+ ; Value is the number of data points for
+ ; each min/max pair.
+;
+<154> PAIR_OFFSET: word ; for Peak Dectect waveforms only
+ ; Value is the number of data points by
+ ; which the first min/max pair in
+ ; DATA_ARRAY_2 is offset relative to the
+ ; first data value in DATA_ARRAY_1.
+;
+<156> VERTICAL_GAIN: float
+;
+<160> VERTICAL_OFFSET: float ; to get floating values from raw data :
+ ; VERTICAL_GAIN * data - VERTICAL_OFFSET
+;
+<164> MAX_VALUE: float ; maximum allowed value. It corresponds
+ ; to the upper edge of the grid.
+;
+<168> MIN_VALUE: float ; minimum allowed value. It corresponds
+ ; to the lower edge of the grid.
+;
+<172> NOMINAL_BITS: word ; a measure of the intrinsic precision
+ ; of the observation: ADC data is 8 bit
+ ; averaged data is 10-12 bit, etc.
+;
+<174> NOM_SUBARRAY_COUNT: word ; for Sequence, nominal segment count
+ ; else 1
+;
+<176> HORIZ_INTERVAL: float ; sampling interval for time domain
+ ; waveforms
+;
+<180> HORIZ_OFFSET: double ; trigger offset for the first sweep of
+ ; the trigger, seconds between the
+ ; trigger and the first data point
+;
+<188> PIXEL_OFFSET: double ; needed to know how to display the
+ ; waveform
+;
+<196> VERTUNIT: unit_definition ; units of the vertical axis
+;
+<244> HORUNIT: unit_definition ; units of the horizontal axis
+;
+<292> RESERVED3: word
+<294> RESERVED4: word ; 2 expansion entries
+;
+<296> TRIGGER_TIME: time_stamp ; time of the trigger
+;
+<312> ACQ_DURATION: float ; duration of the acquisition (in sec)
+ ; in multi-trigger waveforms.
+ ; (e.g. sequence, RIS, or averaging)
+;
+<316> RECORD_TYPE: enum
+ _0 single_sweep
+ _1 interleaved
+ _2 histogram
+ _3 graph
+ _4 filter_coefficient
+ _5 complex
+ _6 extrema
+ _7 sequence_obsolete
+ _8 centered_RIS
+ _9 peak_detect
+ endenum
+;
+<318> PROCESSING_DONE: enum
+ _0 no_processing
+ _1 fir_filter
+ _2 interpolated
+ _3 sparsed
+ _4 autoscaled
+ _5 no_result
+ _6 rolling
+ _7 cumulative
+ endenum
+;
+<320> RESERVED5: word ; expansion entry
+;
+<322> RIS_SWEEPS: word ; for RIS, the number of sweeps
+ ; else 1
+;
+; The following variables describe the basic acquisition
+; conditions used when the waveform was acquired
+;
+<324> TIMEBASE: enum
+ _0 1_ps/div
+ _1 2_ps/div
+ _2 5_ps/div
+ _3 10_ps/div
+ _4 20_ps/div
+ _5 50_ps/div
+ _6 100_ps/div
+ _7 200_ps/div
+ _8 500_ps/div
+ _9 1_ns/div
+ _10 2_ns/div
+ _11 5_ns/div
+ _12 10_ns/div
+ _13 20_ns/div
+ _14 50_ns/div
+ _15 100_ns/div
+ _16 200_ns/div
+ _17 500_ns/div
+ _18 1_us/div
+ _19 2_us/div
+ _20 5_us/div
+ _21 10_us/div
+ _22 20_us/div
+ _23 50_us/div
+ _24 100_us/div
+ _25 200_us/div
+ _26 500_us/div
+ _27 1_ms/div
+ _28 2_ms/div
+ _29 5_ms/div
+ _30 10_ms/div
+ _31 20_ms/div
+ _32 50_ms/div
+ _33 100_ms/div
+ _34 200_ms/div
+ _35 500_ms/div
+ _36 1_s/div
+ _37 2_s/div
+ _38 5_s/div
+ _39 10_s/div
+ _40 20_s/div
+ _41 50_s/div
+ _42 100_s/div
+ _43 200_s/div
+ _44 500_s/div
+ _45 1_ks/div
+ _46 2_ks/div
+ _47 5_ks/div
+ _100 EXTERNAL
+ endenum
+;
+<326> VERT_COUPLING: enum
+ _0 DC_50_Ohms
+ _1 ground
+ _2 DC_1MOhm
+ _3 ground
+ _4 AC,_1MOhm
+ endenum
+;
+<328> PROBE_ATT: float
+;
+<332> FIXED_VERT_GAIN: enum
+ _0 1_uV/div
+ _1 2_uV/div
+ _2 5_uV/div
+ _3 10_uV/div
+ _4 20_uV/div
+ _5 50_uV/div
+ _6 100_uV/div
+ _7 200_uV/div
+ _8 500_uV/div
+ _9 1_mV/div
+ _10 2_mV/div
+ _11 5_mV/div
+ _12 10_mV/div
+ _13 20_mV/div
+ _14 50_mV/div
+ _15 100_mV/div
+ _16 200_mV/div
+ _17 500_mV/div
+ _18 1_V/div
+ _19 2_V/div
+ _20 5_V/div
+ _21 10_V/div
+ _22 20_V/div
+ _23 50_V/div
+ _24 100_V/div
+ _25 200_V/div
+ _26 500_V/div
+ _27 1_kV/div
+ endenum
+;
+<334> BANDWIDTH_LIMIT: enum
+ _0 off
+ _1 on
+ endenum
+;
+<336> VERTICAL_VERNIER: float
+;
+<340> ACQ_VERT_OFFSET: float
+;
+<344> WAVE_SOURCE: enum
+ _0 CHANNEL_1
+ _1 CHANNEL_2
+ _2 CHANNEL_3
+ _3 CHANNEL_4
+ _9 UNKNOWN
+ endenum
+;
+/00 ENDBLOCK
+;
+;==========================================================================
+;
+USERTEXT: BLOCK
+;
+; Explanation of the descriptor block USERTEXT at most 160 bytes long.
+;
+;
+< 0> TEXT: text ; a list of ASCII characters
+;
+/00 ENDBLOCK
+;
+;==========================================================================
+;
+DATA_ARRAY_1: ARRAY
+;
+; Explanation of the data array DATA_ARRAY_1.
+; This main data array is always present. It is the only data array for
+; most waveforms.
+; The data item is repeated for each acquired or computed data point
+; of the first data array of any waveform.
+;
+< 0> MEASUREMENT: data ; the actual format of a data is
+ ; given in the WAVEDESC descriptor
+ ; by the COMM_TYPE variable.
+;
+/00 ENDARRAY
+;
+;==========================================================================
+;
+DATA_ARRAY_2: ARRAY
+;
+; Explanation of the data array DATA_ARRAY_2.
+; This is an optional secondary data array for special types of waveforms:
+; Complex FFT imaginary part (real part in DATA_ARRAY_1)
+; Extrema floor trace (roof trace in DATA_ARRAY_1)
+; Peak Detect min/max pairs (data values in DATA_ARRAY_1)
+; In the first 2 cases, there is exactly one data item in DATA_ARRAY_2 for
+; each data item in DATA_ARRAY_1.
+; In Peak Detect waveforms, there may be fewer data values in DATA_ARRAY_2,
+; as described by the variable POINTS_PER_PAIR.
+;
+< 0> MEASUREMENT: data ; the actual format of a data is
+ ; given in the WAVEDESC descriptor
+ ; by the COMM_TYPE variable.
+;
+/00 ENDARRAY
+;
+;==========================================================================
+;
+TRIGTIME: ARRAY
+;
+; Explanation of the trigger time array TRIGTIME.
+; This optional time array is only present with SEQNCE waveforms.
+; The following data block is repeated for each segment which makes up
+; the acquired sequence record.
+;
+< 0> TRIGGER_TIME: double ; for sequence acquisitions,
+ ; time in seconds from first
+ ; trigger to this one
+;
+< 8> TRIGGER_OFFSET: double ; the trigger offset is in seconds
+ ; from trigger to zeroth data point
+;
+/00 ENDARRAY
+;
+;==========================================================================
+;
+RISTIME: ARRAY
+;
+; Explanation of the random-interleaved-sampling (RIS) time array RISTIME.
+; This optional time array is only present with RIS waveforms.
+; This data block is repeated for each sweep which makes up the RIS record
+;
+< 0> RIS_OFFSET: double ; seconds from trigger to zeroth
+ ; point of segment
+;
+/00 ENDARRAY
+;
+;==========================================================================
+;
+SIMPLE: ARRAY
+;
+; Explanation of the data array SIMPLE.
+; This data array is identical to DATA_ARRAY_1. SIMPLE is an accepted
+; alias name for DATA_ARRAY_1.
+;
+< 0> MEASUREMENT: data ; the actual format of a data is
+ ; given in the WAVEDESC descriptor
+ ; by the COMM_TYPE variable.
+;
+/00 ENDARRAY
+;
+;==========================================================================
+;
+DUAL: ARRAY
+;
+; Explanation of the DUAL array.
+; This data array is identical to DATA_ARRAY_1, followed by DATA_ARRAY_2.
+; DUAL is an accepted alias name for the combined arrays DATA_ARRAY_1 and
+; DATA_ARRAY_2 (e.g. real and imaginary parts of an FFT).
+;
+< 0> MEASUREMENT_1: data ; data in DATA_ARRAY_1.
+;
+< 0> MEASUREMENT_2: data ; data in DATA_ARRAY_2.
+;
+/00 ENDARRAY
+;
+;
+000000 ENDTEMPLATE
+"
+
+</pre>
projects / stratum0-wiki.git / commitdiff