502 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 509) and :WAVeform:PREamble (see page 516).
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 page 177):
NORMal, AVERage, PEAK, and HRESolution. When the data is acquired
using the :DIGitize command (see page 132) or :RUN command (see
page 156), the data is placed in the channel buffer of the specified source.
n/a :WAVeform:XORigin?
(see page 530)
<return_value> ::= x-origin
value in the current preamble in
NR3 format
n/a :WAVeform:XREFerence?
(see page 531)
<return_value> ::= 0
(x-reference value in the current
preamble in NR1 format)
n/a :WAVeform:YINCrement?
(see page 532)
<return_value> ::= y-increment
value in the current preamble in
NR3 format
n/a :WAVeform:YORigin?
(see page 533)
<return_value> ::= y-origin in
the current preamble in NR3
format
n/a :WAVeform:YREFerence?
(see page 534)
<return_value> ::= y-reference
value in the current preamble in
NR1 format
Table 71 :WAVeform Commands Summary (continued)
Command Query Options and Query Returns