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

Page: 1111 / 1420

:WAVeform Commands
34
Keysight InfiniiVision 3000T X-Series Oscilloscopes Programmer's Guide 1111
:WAVeform:SOURce
(see page 1276 )
Command Syntax
:WAVeform:SOURce <source>
<source> ::= {CHANnel<n> | FUNCtion<m> | MATH<m> | WMEMory<r>
| SBUS{1 | 2}} for DSO models
<source> ::= {CHANnel<n> | POD{1 | 2} | BUS{1 | 2} | FUNCtion<m>
| MATH<m> | WMEMory<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
The :WAVeform:SOURce command selects the analog channel, function, digital
pod, digital bus, reference waveform, or serial decode bus to be used as the source
for the :WAVeform commands.
Function capabilities include add, subtract, multiply, integrate, differentiate, and
FFT (Fast Fourier Transform) operations.
When the :WAVeform:SOURce is the serial decode bus (SBUS1 or SBUS2), ASCii
is the only waveform format allowed, and the :WAVeform:DATA? query returns a
string with timestamps and associated bus decode information.
With MSO oscilloscope models, you can choose a POD or BUS as the waveform
source. There are some differences between POD and BUS when formatting and
getting data from the oscilloscope:
• When POD1 or POD2 is selected as the waveform source, you can choose the
BYTE, WORD, or ASCii formats (see ":WAVeform:FORMat" on page 1101).
When the WORD format is chosen, every other data byte will be 0. The setting
of :WAVeform:BYTeorder controls which byte is 0.
When the ASCii format is chosen, the :WAVeform:DATA? query returns a string
with unsigned decimal values separated by commas.
• When BUS1 or BUS2 is selected as the waveform source, you can choose the
WORD or ASCii formats (but not BYTE because bus values are always returned
as 16-bit values).
When the ASCii format is chosen, the :WAVeform:DATA? query returns a string
with hexadecimal bus values, for example: 0x1938,0xff38,...
Query Syntax
:WAVeform:SOURce?
The :WAVeform:SOURce? query returns the currently selected source for the
WAVeform commands.