Agilent Technologies InfiniiVision 5000 Series Programmer's Manual page 502

5
Commands by Subsystem
Table 71 :WAVeform Commands Summary (continued)
Command
n/a
n/a
n/a
n/a
n/a
Introduction to
The WAVeform subsystem is used to transfer data to a controller from the
:WAVeform
oscilloscope waveform memories. The queries in this subsystem will only
Commands
operate when the channel selected by :WAVeform:SOURce is on.
Waveform Data and Preamble
The waveform record is actually contained in two portions: the preamble
and waveform data. The waveform record must be read from the
oscilloscope by the controller using two separate commands,
:WAVeform:DATA (see
The waveform data is the actual data acquired for each point in the
specified source. The preamble contains the information for interpreting
the waveform data, which includes the number of points acquired, the
format of acquired data, and the type of acquired data. The preamble also
contains the X and Y increments, origins, and references for the acquired
data, so that word and byte data can be translated to time and voltage
values.
Data Acquisition Types
There are three types of waveform acquisitions that can be selected for
analog channels with the :ACQuire:TYPE command (see
NORMal, AVERage, PEAK, and HRESolution. When the data is acquired
using the :DIGitize command (see
page
502
Query
:WAVeform:XORigin?
(see page 530)
:WAVeform:XREFerence?
(see page 531)
:WAVeform:YINCrement?
(see page 532)
:WAVeform:YORigin?
(see page 533)
:WAVeform:YREFerence?
(see page 534)
page
156), the data is placed in the channel buffer of the specified source.
Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Guide
Options and Query Returns
<return_value> ::= x-origin
value in the current preamble in
NR3 format
<return_value> ::= 0
(x-reference value in the current
preamble in NR1 format)
<return_value> ::= y-increment
value in the current preamble in
NR3 format
<return_value> ::= y-origin in
the current preamble in NR3
format
<return_value> ::= y-reference
value in the current preamble in
NR1 format
509) and :WAVeform:PREamble (see
page 132) or :RUN command (see
page 516).
page 177):