Keysight Technologies InfiniiVision 3000T X Series - Page 1112

1112 Keysight InfiniiVision 3000T X-Series Oscilloscopes Programmer's Guide
34 :WAVeform Commands
Return Format <source><NL>
<source> ::= {CHAN<n> | FUNC<m> | WMEM<r> | SBUS{1 | 2}} for DSO models
<source> ::= {CHAN<n> | POD{1 | 2} | BUS{1 | 2} | FUNC<m>
| WMEM<r> | SBUS{1 | 2}} for MSO models
<n> ::= 1 to (# analog channels) in NR1 format
<m> ::= 1 to (# math functions) in NR1 format
<r> ::= 1 to (# ref waveforms) in NR1 format
See Also • "Introduction to :WAVeform Commands" on page 1091
• ":DIGitize" on page 203
• ":WAVeform:FORMat" on page 1101
• ":WAVeform:BYTeorder" on page 1097
• ":WAVeform:DATA" on page 1099
• ":WAVeform:PREamble" on page 1106
Example Code
' WAVEFORM_DATA - To obtain waveform data, you must specify the
' WAVEFORM parameters for the waveform data prior to sending the
' ":WAVEFORM:DATA?" query. Once these parameters have been sent,
' the waveform data and the preamble can be read.
'
' WAVE_SOURCE - Selects the channel to be used as the source for
' the waveform commands.
myScope.WriteString ":WAVEFORM:SOURCE CHAN1"
' WAVE_POINTS - Specifies the number of points to be transferred
' using the ":WAVEFORM:DATA?" query.
myScope.WriteString ":WAVEFORM:POINTS 1000"
' WAVE_FORMAT - Sets the data transmission mode for the waveform
' data output. This command controls whether data is formatted in
' a word or byte format when sent from the oscilloscope.
Dim lngVSteps As Long
Dim intBytesPerData As Integer
' Data in range 0 to 65535.
myScope.WriteString ":WAVEFORM:FORMAT WORD"
lngVSteps = 65536
intBytesPerData = 2
' Data in range 0 to 255.
'myScope.WriteString ":WAVEFORM:FORMAT BYTE"
'lngVSteps = 256
'intBytesPerData = 1
' GET_PREAMBLE - The preamble block contains all of the current
NOTE
MATH<m> is an alias for FUNCtion<m>. The :WAVeform:SOURce? query returns FUNC<m> if
the source is FUNCtion<m> or MATH<m>.