User Manual

:WAVeform Commands 28
Keysight InfiniiVision 1000 X-Series Oscilloscopes Programmer's Guide 621
Introduction to
:WAVeform
Commands
The WAVeform subsystem is used to transfer data to a controller from the
oscilloscope waveform memories. The queries in this subsystem will only 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 page 628) and
:WAVeform:PREamble (see page 635). 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
:WAVeform:VIEW <view>
(see page 647)
:WAVeform:VIEW? (see
page 647)
<view> ::= {MAIN}
n/a :WAVeform:XINCrement?
(see page 648)
<return_value> ::= x-increment
in the current preamble in NR3
format
n/a :WAVeform:XORigin?
(see page 649)
<return_value> ::= x-origin
value in the current preamble in
NR3 format
n/a :WAVeform:XREFerence?
(see page 650)
<return_value> ::= 0
(x-reference value in the current
preamble in NR1 format)
n/a :WAVeform:YINCrement?
(see page 651)
<return_value> ::= y-increment
value in the current preamble in
NR3 format
n/a :WAVeform:YORigin?
(see page 652)
<return_value> ::= y-origin in
the current preamble in NR3
format
n/a :WAVeform:YREFerence?
(see page 653)
<return_value> ::= y-reference
value in the current preamble in
NR1 format
Table 83 :WAVeform Commands Summary (continued)
Command Query Options and Query Returns