Technical data

592 Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Guide
5 Commands by Subsystem
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 599) and :WAVeform:PREamble (see page 606).
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 four types of waveform acquisitions that can be selected for
analog channels with the :ACQuire:TYPE command (see page 191):
NORMal, AVERage, PEAK, and HRESolution. When the data is acquired
using the :DIGitize command (see page 146) or :RUN command (see
page 170), the data is placed in the channel buffer of the specified source.
n/a :WAVeform:XORigin?
(see page 620)
<return_value> ::= x-origin
value in the current preamble in
NR3 format
n/a :WAVeform:XREFerence?
(see page 621)
<return_value> ::= 0
(x-reference value in the current
preamble in NR1 format)
n/a :WAVeform:YINCrement?
(see page 622)
<return_value> ::= y-increment
value in the current preamble in
NR3 format
n/a :WAVeform:YORigin?
(see page 623)
<return_value> ::= y-origin in
the current preamble in NR3
format
n/a :WAVeform:YREFerence?
(see page 624)
<return_value> ::= y-reference
value in the current preamble in
NR1 format
Table 86 :WAVeform Commands Summary (continued)
Command Query Options and Query Returns