1- 8 Keysight B2961A/B2962A SCPI Command Reference, Edition 6
Programming Basics
SCPI Messages
Numeric Suffix
All command headers can be accompanied by a numeric suffix for differentiating
multiple instances of the same structure, i.e. for multi-channel instruments. The
numeric suffix can be appended to both long and short forms. For example, TRIG1
is the short form of TRIGger1. A numeric suffix of 1 is implied on all command
headers that do not explicitly define a suffix; thus, TRIG is equivalent to TRIG1.
For B2961A/B2962A SCPI commands, some commands have a numeric suffix for
classifying the channels, the trigger lines, etc. The numeric suffix is an optional
character, and can be expressed by [c], [d], [h], [i], [j], and [n], where:
c is the integer 1 or 2, used to specify the channel 1 or 2, respectively.
d is the integer 1 or 2, used to specify the upper half (1) or lower half (2),
respectively, of the display area on the front panel display.
h is an integer between 1 and 100, used to specify a variable in a program memory.
i is the integer 1 or 2, used to specify the internal trigger line 1 or 2, respectively.
j is the integer 1 or 2, used to specify the primary (1) or secondary (2), respectively.
n is an integer between 1 and 14, used to specify a Digital I/O pin.
Abbreviating the numeric suffix gives the same result as specifying 1.
Channel List Parameter
The channel list parameter is used for identifying the channel number as well as the
numeric suffix.
The notation (@1,2) specifies a channel list that includes channels 1 and 2.
The notation (@1:2) specifies a channel list that includes channels 1 to 2.
In the B2961A/B2962A SCPI commands, the channel list parameter is only
available on certain commands which requires synchronization of channels (e.g.
some commands of the
TRIGger Subsystem) or specification of the channel itself
(e.g. some commands of the MMEMory Subsystem).
The channel list parameter is also used for identifying the grouped channels defined
by the
:SYSTem:GROup[:DEFine] command for performing synchronous channel
operations.