Technical data

638 Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5 Commands by Subsystem
:WAVeform:DATA
(see page 798)
Query Syntax
:WAVeform:DATA?
The :WAVeform:DATA query returns the binary block of sampled data
points transmitted using the IEEE 488.2 arbitrary block data format. The
binary data is formatted according to the settings of the
:WAVeform:UNSigned, :WAVeform:BYTeorder, :WAVeform:FORMat, and
:WAVeform:SOURce commands. The number of points returned is
controlled by the :WAVeform:POINts command.
In BYTE or WORD waveform formats, these data values have special
meaning:
• 0x00 or 0x0000 — Hole. Holes are locations where data has not yet been
acquired. Holes can be reasonably expected in the equivalent time
acquisition mode (especially at slower horizontal sweep speeds when
measuring low frequency signals).
Another situation where there can be zeros in the data, incorrectly, is
when programming over telnet port 5024. Port 5024 provides a
command prompt and is intended for ASCII transfers. Use telnet port
5025 instead.
• 0x01 or 0x0001 — Clipped low. These are locations where the waveform
is clipped at the bottom of the oscilloscope display.
• 0xFF or 0xFFFF — Clipped high. These are locations where the
waveform is clipped at the top of the oscilloscope display.
Return Format
<binary block data><NL>
See Also • For a more detailed description of the data returned for different
acquisition types, see: "Introduction to :WAVeform Commands" on
page 630
• ":WAVeform:UNSigned" on page 656
• ":WAVeform:BYTeorder" on page 636
• ":WAVeform:FORMat" on page 640
• ":WAVeform:POINts" on page 641
• ":WAVeform:PREamble" on page 645
• ":WAVeform:SOURce" on page 650
• ":WAVeform:TYPE" on page 655
Example Code
' QUERY_WAVE_DATA - Outputs waveform data that is stored in a buffer.
' Query the oscilloscope for the waveform data.
myScope.WriteString ":WAV:DATA?"
' READ_WAVE_DATA - The wave data consists of two parts: the header,