Keysight Technologies InfiniiVision 3000T X Series, Programmer'S Manual

Page: 1099 / 1420

:WAVeform Commands
34
Keysight InfiniiVision 3000T X-Series Oscilloscopes Programmer's Guide 1099
:WAVeform:DATA
(see page 1276 )
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.
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 1091
• ":WAVeform:UNSigned" on page 1117
• ":WAVeform:BYTeorder" on page 1097
• ":WAVeform:FORMat" on page 1101
• ":WAVeform:POINts" on page 1102
• ":WAVeform:PREamble" on page 1106
• ":WAVeform:SOURce" on page 1111
• ":WAVeform:TYPE" on page 1116
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,
' and the actual waveform data followed by a new line (NL) character.
' The query data has the following format:
'
' <header><waveform_data><NL>
'
' Where:
' <header> = #800001000 (This is an example header)