Introduction to SCPI

IEEE 488.2 Common Commands

IEEE 488.2 Common Commands

IEEE 488.2 defines a set of common commands. All instruments are required to implement a subset of these commands, specifically those commands related to status reporting, synchronization and internal operations. The rest of the common commands are optional. The following list details which of these IEEE 488.2 common commands are implemented in the analyzer and the response of the analyzer when the command is received.

*CLS Clears the instrument Status Byte by emptying the error queue and clearing all event registers, also cancels any preceding *OPC command or query (does not change the enable registers or transition filters).

*ESE <num>

*ESE?

*ESR?

*IDN?

Sets bits in the Standard Event Status Enable Register

— current setting is saved in non-volatile memory.

Reads the current state of the Standard Event Status

Enable Register.

Reads and clears the current state of the Standard

Event Status Register.

Returns a string that uniquely identifies the analyzer.

The string is of the form

*LRN?

"HEWLETT-PACKARD,8712,<serial number>,<software evision>"

This returns a string of device specific characters that, when sent back to the analyzer will restore the instrument state active when *LRN?

was sent. Data formatting ( ENTER USING "-K" in HP BASIC) or a similar technique should be used to ensure that the transfer does not terminate on a carriage return or line feed (both

C

R

and

L

F

are present in the learn string as part of the data).

9-16 Programmer’s Guide

*OPC

*OPC?

*OPT?

Introduction to SCPI

IEEE 488.2 Common Commands

Operation complete command. The analyzer will generate the OPC message in the Standard Event

Status Register when all pending overlapped operations have been completed (e.g. a sweep, or a preset). For more information about overlapped operations, refer to

“Overlapped Commands” on page 2-3 .

Operation complete query. The analyzer will return an

ASCII "1" when all pending overlapped operations have been completed.

Returns a string identifying the analyzer's option configuration. The string is of the form "1E1,100" .

The options are identified by the following:

*PCB <num>

*PSC <num>

1EC 75 ohm

1E1 60 dB step attenuator

100 SRL and Fault Location

Sets the pass-control-back address (the address of the controller before a pass control is executed).

Sets the state of the Power-on Status Clear flag — flag is saved in non-volatile memory. This flag determines whether or not the Service Request enable register and the Event Status enable register are cleared at powerup.

Programmer’s Guide 9-17

Introduction to SCPI

IEEE 488.2 Common Commands

*RST Executes a device reset and cancels any pending *OPC command or query. The contents of the instrument's nonvolatile memory are not affected by this command.

This command is different from the front panel

PRESET function in the state of the commands (and their reset states) listed below.

The preset instrument state is described in the User's

Guide.

*SRE <num>

*SRE?

*STB?

*TRG

*TST?

*WAI

INITiate:CONTinuous

OUTPut[:STATe]

CALibration:ZERO:AUTO

SENSe:CORRection[:STATe]

SENSe:SWEep:POINts

SOURce:POWer

= OFF

= OFF

= OFF

= OFF

= MAX

= MIN

Sets bits in the Service Request Enable Register.

Current setting is saved in non-volatile memory.

Reads the current state of the Service Request Enable

Register.

Reads the value of the instrument Status Byte. This is a non-destructive read—the Status Byte is cleared by the *CLS command.

Triggers a sweep on the active measurement channel when in Trigger Hold mode. Ignored if in continuous sweep.

Returns the result of a complete self-test. An ASCII 0 indicates no failures found. Any other character indicates a specific self-test failure. Does not perform any self-tests. See the Service Guide for further information.

Prohibits the instrument from initiating any new commands until all pending overlapped commands have been initiated.

9-18 Programmer’s Guide

10 Menu Map with SCPI

Commands

10-1

NOTE

NOTE

Menu Map with SCPI Commands

This chapter shows all softkey menu choices available. Each hardkey on the instrument front panel has a corresponding table in this chapter showing all softkey choices available after pressing the hardkey.

Hardkeys and softkeys are shown as HARDKEY and Soft Key .

Each softkey is shown with an associated SCPI command, if one exists.

SCPI commands are shown as the short form.

The configuration of the currently active measurement channel determines the order of appearance and the content of the softkey menus.

Command Conventions

Commands requiring a choice of measurement channel are shown with both choices: SENS[1|2]: (for example). The command is entered with the appropriate channel given: SENS1: (channel 1 chosen) or SENS2: (channel 2 chosen).

Parameter Types

<num> and <string> refer to parameter types described in the

“Parameter Types” section.

<string> parameters are enclosed in single quotes: ‘the string data’ .

<value> parameters include <num> and an optional <unit> .

Softkey Menus

Most softkey choices and associated SCPI commands are shown in the following Menu Map tables. Because the analyzer provides great flexibility in measurement configuration, and because many softkey menus and user operations are very similar to each other, not every variation of each softkey menu is shown.

SCPI commands that are associated with menu selections can be found by reading the program that is created after keystroke recording has been enabled and the desired keys have been pressed.

Refer to the Hardkey/Softkey Reference in your instrument’s User’s

Guide for a description of each key.

10-2 Programmer’s Guide

Menu Map with SCPI Commands

Entering Frequency, Power, and Other Numeric Values

Entry of frequency, power, and other numeric values requires a choice of measurement unit. All entries of this type follow the same sequence:

Enter the number then choose the appropriate unit, or press Enter for default units.

Menu Map Tables and Instrument Types

The instrument displays menu choices based on the instrument type and the active measurement channel configuration. In the tables of softkey menu choices that follow, the instrument type is shown in the table title, and the channel configuration is shown in the table body. See

Figure

10-1

, below.

Figure 10-1

Table 10-8

Example Menu Map Table

CAL Functions, 8712ES/8714ES

CAL (Reflection)

Default 1-Port

KEYSTROKES

Default 2-Port

User 1-Port

Softkey

Channel configuration

Hardkey

SCPI COMMAND

(hardkey entry)

SENS[1|2]:CORR:CSET DEF; *WAI

SENS[1|2]:CORR:CLASS DEF2; *WAI

SENS[1|2]:CORR:CLASS DEF1; *WAI

SENS[1|2]:CORR:CSET DEF; *WAI

SCPI command

Applicable models

Programmer’s Guide 10-3