Keysight Technologies RP7900 Series, Operating And Service Manual

Page: 171 / 318

Semicolons ( ; ) separate commands within the same subsystem. This lets you send several
subsystem commands within the same message string. For example, sending the following command
string:
OUTPut:STATe ON;DELay:RISE 1;FALL 2
is the same as sending the following commands:
OUTPut ON
OUTPut:DELay:RISE 1
OUTPut:DELay;FALL 2
Note that the semicolon follows the implied path of the hierarchical tree structure. In the above
example, the optional :STATe keyword must follow the OUTput keyword to place the command parser
at the second level in the hierarchy. This allows the use of the DELay keyword after the semicolon,
since DELay is a second-level keyword. Next, the command parser is placed at the third level in the
hierarchy by the :RISE keyword. This allows the use of the FALL keyword after the second semicolon,
since FALL is a third-level keyword.
You can also combine commands of different subsystems within the same message string. In this
case, you must use a colon to return the command parser to the root level in order to access another
subsystem. For example, you could clear the output protection and check the status of the Operation
Condition register in one message by using a root specifier as follows:
OUTPut:PROTection:CLEar;:STATus:OPERation :CONDition?
Note the use of the colon after the semicolon in order to return the command parser to the root.
Terminators
A command string sent to the instrument must terminate with a new line (<NL>) character. The IEEE-
488 EOI (End-Or-Identify) message is interpreted as a <NL> character and can be used to terminate a
command string in place of an <NL>. A carriage return followed by a new line (<CR><NL>) is also
accepted. Command string termination will always reset the current SCPI command path to the root
level.
Syntax Conventions
l
Triangle brackets ( < > ) indicate that you must specify a value for the enclosed parameter. For
example, in the OUTPut:DELay syntax statements shown above, the <
value > parameter is
enclosed in triangle brackets. The brackets are not sent with the command string. You must spe-
cify a value for the parameter (Example: "OUTP:DEL:FALL 0.1") unless you select another option
shown in the syntax (Example: "OUTP:DEL:FALL MIN").
l
A vertical bar ( | ) separates multiple parameter choices for a given command string. For example,
LATChing|LIVE|OFF in the OUTPut:INHibit command indicates that you can specify "LATChing",
"LIVE", or "OFF". The bar is not sent with the command string.
Keysight RP7900 Series Operating and Service Guide 171
5 SCPI Programming Reference