SCPI Device Command Summary. Agilent Technologies 8712ES, 8714ET, 8714ES, 8712ET

Add to My manuals
320 Pages

advertisement

SCPI Device Command Summary. Agilent Technologies 8712ES, 8714ET, 8714ES, 8712ET | Manualzz

SCPI Command Summary

SCPI Device Command Summary

NOTE

NOTE

SCPI Device Command Summary

This SCPI command reference is also available online. It is stored inside your analyzer in electronic form. To use it, you must connect your instrument to the network, and access it using your Web browser. See the The LAN Interface User’s Guide Supplement for details.

Throughout this chapter, the following conventions are used:

Square brackets ( [ ] ) are used to enclose a keyword that is optional or implied when programming the command; that is, the instrument will process the command to have the same effect whether the option node is omitted or not.

Parameter types ( < > ) are distinguished by enclosing the type name in angle brackets.

A vertical bar ( | ) can be read as “or” and is used to separate alternative parameter options.

• UPPER -case letters (as found in the command MODify , for example) are used to indicate the short form of a given mnemonic. The remaining lower-case letters are the rest of the long form mnemonic.

Table 11-1 ABORt

SUBSYSTEM COMMANDS

ABORt

FORM command only

DESCRIPTION

Aborts and resets the sweep in progress.

11-4 Programmer’s Guide

SCPI Command Summary

SCPI Device Command Summary

Table 11-2 CALCulate (1 of 7)

SUBSYSTEM

COMMANDS

CALCulate[1|2]:DATA?

1

CALCulate[1|2]:FORMat

<char>

CALCulate[1|2]:FORMat

:UNIT:MLIN <char>

CALCulate[1|2]:FORMat

:UNIT:MLOG <char>

FORM query only

BLOCK or NR3

CHAR

CHAR

CHAR

2

DESCRIPTION

Queries the formatted data trace — functionally equivalent to the command

TRAC? CH<1|2>FDATA .

Selects the display format for measurement data — choose from MLOGarithmic|

MLINear|SWR or PHASe|SMITh|POLar|

GDELay|REAL|IMAGinary|MIMPedance .

Selects linear magnitude units for Y-axis display. Choose from W|MW|UW|V|MV|UV .

Selects log magnitude units for Y-axis display.

Choose from

DBW|DBM|DBUW|DBV|DBMV|DBUV .

Sets the group delay aperture as a ratio of desired aperture / measured frequency span.

CALCulate[1|2]

:GDAPerture:APERture

<num>

NR3

CALCulate[1|2]

:GDAPerture:SPAN <num>

NR3 Specifies the group delay aperture in Hertz.

1. Refer to

Chapter 6 , "Trace Data Transfers," and to the ASCDATA and REALDATA

example programs in the Example Programs Guide for more information on this command.

2. The parameter type of the data is determined by the format selected — FORMat

REAL uses BLOCK data, FORMat ASCii uses NR3 data separated by commas.

Programmer’s Guide 11-5

SCPI Command Summary

SCPI Device Command Summary

Table 11-2 CALCulate (2 of 7)

SUBSYSTEM COMMANDS FORM DESCRIPTION

CALCulate[1|2]:LIMit:DISPlay

1

<ON|OFF>

NR1 Turns display of limit lines on/off.

CALCulate[1|2]:LIMit:MARKer

:FLATness:MAXimum <num>

CALCulate[1|2]:LIMit:MARKer

:FLATness:MINimum <num>

NR3

NR3

Sets the maximum value for a flatness limit test.

Sets the minimum value for a flatness marker limit test.

Turns flatness marker limit test on/off.

CALCulate[1|2]:LIMit:MARKer

:FLATness:STATe <ON|OFF>

1

NR1

CALCulate[1|2]:LIMit:MARKer

:FREQuency:MAXimum <num>

2

CALCulate[1|2]:LIMit:MARKer

:FREQuency:MINimum <num>

2

NR3

NR3

Sets the maximum value for delta frequency marker limit test.

Sets the minimum value for delta frequency marker limit test.

CALCulate[1|2]:LIMit:MARKer

:FREQuency [:STATe] <ON|OFF>

1

NR1 Turns delta frequency marker limit testing on or off.

CALCulate[1|2]:LIMit:MARKer

:STATistic:MEAN:MAXimum <num>

CALCulate[1|2]:LIMit:MARKer

:STATistic:MEAN:MINimum <num>

NR3

NR3

Sets the maximum value for a statistic mean limit test.

Sets the minimum value for a statistic mean limit test.

Turn statistic mean marker limit test on/off.

CALCulate[1|2]:LIMit:MARKer

:STATistic:MEAN:STATe

<ON|OFF>

1

NR1

CALCulate[1|2]:LIMit:MARKer

:STATistic:PEAK:MAXimum <num>

CALCulate[1|2]:LIMit:MARKer

:STATistic:PEAK:MINimum <num>

NR3

NR3

Sets the maximum value for a statistic peak-to-peak limit test.

Sets the minimum value for a statistic peak-to-peak limit test.

1. Binary parameters accept the values of 1 (on) and 0 (off) in addition to ON and OFF .

2. Numeric parameters may include an appropriate suffix; if no suffix is included, the default ( HZ for frequency or S for time) is assumed.

11-6 Programmer’s Guide

SCPI Command Summary

SCPI Device Command Summary

Table 11-2 CALCulate (3 of 7)

SUBSYSTEM COMMANDS FORM DESCRIPTION

CALCulate[1|2]:LIMit:MARKer

:STATistic:PEAK:STATe

<ON|OFF>

1

NR1 Turns statistic peak-to-peak marker limit test on/off.

CALCulate[1|2]:LIMit:MARKer

:TILT:MAXimum <num>

2

NR3 Sets the maximum value for delta amplitude marker limit test.

CALCulate[1|2]:LIMit:MARKer

:TILT:MINimum <num>

2

CALCulate[1|2]:LIMit:MARKer

:TILT [:STATe] <ON|OFF>

1

NR3

NR1

Sets the minimum value for delta amplitude marker limit test.

Turns delta amplitude marker limit testing on or off.

CALCulate[1|2]:LIMit:SEGMent

[1|2|12]:AMPLitude:STARt

<num>

2

NR3 Sets the Begin Limit for the specified limit segment.

CALCulate[1|2]:LIMit:SEGMent

[1|2|12]:AMPLitude:STOP

<num>

2

NR3 Sets the End Limit for the specified limit segment.

CALCulate[1|2]:LIMit:SEGMent

:AOFF

CALCulate[1|2]:LIMit:SEGMent

[1|2|12]:DISTance:STARt

2

<num> command only

NR3

Turns off all limit segments for a given channel — deletes all segments in the channel's limit table.

Sets the Begin Distance for the specified limit segment.

(Option 100 only)

CALCulate[1|2]:LIMit:SEGMent

[1|2|12]:DISTance:STOP <num>

CALCulate[1|2]:LIMit:SEGMent

[1|2|12]:FREQuency:STARt

2

<num>

2

NR3

NR3

Sets the End Distance for the specified limit segment.

(Option 100 only)

Sets the Begin Frequency for the specified limit segment.

1. Binary parameters accept the values of 1 (on) and 0 (off) in addition to ON and OFF.

2. Numeric parameters may include an appropriate suffix; if no suffix is included, the default ( HZ for frequency or S for time) is assumed.

Programmer’s Guide 11-7

SCPI Command Summary

SCPI Device Command Summary

Table 11-2 CALCulate (4 of 7)

SUBSYSTEM COMMANDS FORM DESCRIPTION

CALCulate[1|2]:LIMit:SEGMent

[1|2|12]:FREQuency:STOP

<num>

2

NR3 Sets the End Frequency for the specified limit segment.

CALCulate[1|2]:LIMit:SEGMent

[1|2|12]:POWer:STARt

<num>

2

NR3 Sets the Begin Power for the specified limit segment.

CALCulate[1|2]:LIMit:SEGMent

[1|2|12]:POWer:STOP

<num>

2

NR3 Sets the End Power for the specified limit segment.

CALCulate[1|2]:LIMit:SEGMent

[1|2|12]:STATe

<ON|OFF>

1

NR1 Turns the specified limit segment on/off

— adds or deletes the segment.

CALCulate[1|2]:LIMit:SEGMent

[1|2|12]:TYPE

<char>

CHAR Sets the limit type for the specified segment, choose from

LMAX|LMIN|PMAX|PMIN (Max Line,

Min Line, Max Point, Min Point) — sets all of the segment's limit parameters to their default values.

Turns the limit test on/off.

CALCulate[1|2]:LIMit:STATe

<ON|OFF>

1

NR1

CALCulate[1|2]:MARKer:AOFF command

only

Turns off all markers for a given channel — this has the effect of turning off marker functions and tracking as well.

CALCulate[1|2]:MARKer:BWIDth

<num>

2

NR3 Calculates the bandwidth of a bandpass filter — num is the target bandwidth

(

3 for the 3 dB bandwidth).

1. Binary parameters accept the values of 1 (on) and 0 (off) in addition to ON and OFF.

2. Numeric parameters may include an appropriate suffix; if no suffix is included, the default ( HZ for frequency or S for time) is assumed.

11-8 Programmer’s Guide

SCPI Command Summary

SCPI Device Command Summary

Table 11-2 CALCulate (5 of 7)

SUBSYSTEM COMMANDS FORM DESCRIPTION

CALCulate[1|2]:MARKer

:FUNCtion:RESult?

CALCulate[1|2]:MARKer

:FUNCtion[:SELect] <char> query only

NR3

[,NR3,

NR3,

NR3]

CHAR

Queries the results of the active marker function — MAX and MIN return the amplitude; TARG returns the frequency;

BWID returns bandwidth, center frequency, Q and loss; STAT returns the frequency span, the mean and standard deviation of the amplitude response, and the peak-to-peak ripple; FLAT returns the frequency span, gain, slope and flatness; and FSTAT returns the insertion loss and peak-to-peak ripple of the passband of a filter, as well as the maximum signal amplitude in the stopband. Refer to the MARKERS example program in the Example

Programs Guide for more information.

Selects the active marker function — choose from

OFF|MAXimum|MINimum|TARGet

|BWIDth|NOTCh|MPEak|MNOTch

|STATistics|

FLATness|FSTATistics .

Turn marker function tracking on/off.

CALCulate[1|2]:MARKer

:FUNCtion:TRACking

1

<ON|OFF>

NR1

CALCulate[1|2]:MARKer

[1|2|8]:GDELay?

CALCulate[1|2]:MARKer

[1|2|8]:MAXimum query only command only

Returns the group delay value, in seconds, at the specified marker.

Sets the specified marker to the maximum value on the trace.

CALCulate[1|2]:MARKer

[1|2|8]:MAXimum:LEFT command only

Moves the specified marker to the next local maximum to the left.

1. Binary parameters accept the values of 1 (on) and 0 (off) in addition to ON and OFF.

Programmer’s Guide 11-9

SCPI Command Summary

SCPI Device Command Summary

Table 11-2 CALCulate (6 of 7)

SUBSYSTEM COMMANDS FORM DESCRIPTION

CALCulate[1|2]:MARKer

[1|2|8]:MAXimum:RIGHt

CALCulate[1|2]:MARKer

[1|2|8]:MINimum

CALCulate[1|2]:MARKer

[1|2|8]:MINimum:LEFT

CALCulate[1|2]:MARKer

[1|2|8]:MINimum:RIGHt

CALCulate[1|2]:MARKer

:MODE <char>

CALCulate[1|2]:MARKer

:NOTCh <num>

3

command only command only command only command only

CHAR

NR3

Moves the specified marker to the next local maximum to the right.

Sets the specified marker to the minimum value on the trace.

Moves the specified marker to the next local minimum to the left.

Moves the specified marker to the next local minimum to the right.

Turns delta marker state on/off — choose ABSolute or RELative .

Calculates the notch width of a notch filter — num is the marker search level

(

6 for the default 6 dB bandwidth).

Sets the specified marker point.

CALCulate[1|2]

:MARKer[1|2|8]:POINt

1

NR3

CALCulate[1|2]

:MARKer:REFerence:X?

CALCulate[1|2]

:MARKer:REFerence:Y?

query only NR3 query only NR3

NR1

Queries the frequency of the reference marker.

Queries the amplitude of the reference marker.

Turns the specified marker on/off.

CALCulate[1|2]

:MARKer[1|2|8][:STATe]

<ON|OFF>

2

CALCulate[1|2]

:MARKer[1|2|8]:TARGet

<char>,<num>

3

CHAR,

NR3

Performs a marker search for a target value — char is the direction LEFT or

RIGHt .

1. Refer to "Displaying Measurement Results" in Chapter 7 of the User's Guide for more information on using this command.

2. Binary parameters accept the values of 1 (on) and 0 (off) in addition to ON and

OFF.

3. Numeric parameters may include an appropriate suffix; if no suffix is included, the default ( HZ for frequency or S for time) is assumed.

11-10 Programmer’s Guide

SCPI Command Summary

SCPI Device Command Summary

Table 11-2 CALCulate (7 of 7)

SUBSYSTEM COMMANDS FORM DESCRIPTION

CALCulate[1|2]

:MARKer[1|2|8]:X <num>

CALCulate[1|2]

:MARKer[1|2|8]:X:ABS <num>

NR3

NR?

Sets the specified marker frequency

(or power if in power sweep).

Sets a marker to an absolute value

(such as frequency or amplitude). The set value is not relative to a reference marker if one is enabled.

Queries the specified marker amplitude.

CALCulate[1|2]

:MARKer[1|2|8]:Y?

CALCulate[1|2]

:MARKer[1|2|8]:Y:INDuctance?

CALCulate[1|2]

:MARKer[1|2|8]:Y:MAGNitude?

CALCulate[1|2]

:MARKer[1|2|8]:Y:PHASe?

query only NR3 query only NR3 query only NR3 query only NR3 query only NR3

Queries the specified marker's inductance when in Smith chart format.

Queries the specified marker's magnitude when in polar format.

Queries the specified marker's phase value when in polar format.

CALCulate[1|2]

:MARKer[1|2|8]:Y:REACtance?

CALCulate[1|2]

:MARKer[1|2|8]:Y:RESistance?

query only NR3

Queries the specified marker's reactance value when in Smith chart format.

Queries the specified marker's resistance value when in Smith chart format.

CALCulate[1|2]

:MATH[:EXPRession] <expr>

1

EXPR Selects a trace math expression — choose measurement trace from

(IMPL) for "data only" or

(IMPL/CH<1|2>SMEM) for "data / memory”.

1.

<expr> and EXPR represent expressions, a parameter type that consists of mathematical expressions that use character parameters and are enclosed in parentheses.

Programmer’s Guide 11-11

SCPI Command Summary

SCPI Device Command Summary

Table 11-3 CALibration

SUBSYSTEM COMMANDS FORM DESCRIPTION

CALibration

:SELF:ALL

CALibration

:SELF:METHod

<ONEPort|TWOPort> command only

CHAR

Initiates a SelfCal on all ports that were calibrated during the Test Set Cal.

1

Selects the method of SelfCal: enhanced response/1-port or 2-port.

CALibration

:SELF <ON|OFF|ONCE>

2

NR1

CHAR

Initiates a SelfCal on the currently selected ports and selects Periodic

SelfCal ( ON ) or SelfCal Once ( OFF or

ONCE ).

1

CALibration

:SELF:TIMER <num>

CALibration

:ZERO:AUTO <ON|OFF|ONCE>

2

NR1

NR1

Sets the time interval for automatic

SelfCals.

1

Turns the broadband detector autozeroing function on/off.

1. For use with multiport test sets only.

2. Binary parameters accept the values of 1 (on) and 0 (off) in addition to ON and OFF .

11-12 Programmer’s Guide

SCPI Command Summary

SCPI Device Command Summary

Table 11-4 CONFigure

SUBSYSTEM COMMANDS

CONFigure <string>

FORM DESCRIPTION

STRING Configures the analyzer to measure a specific device type and parameter (the BEGIN function) — choose from one of the following strings:

'AMPLifier:TRANsmission'

'AMPLifier:REFLection'

'AMPLifier:TRANsmission:REVerse'

1

'AMPLifier:REFLection:REVerse'

1

'AMPLifier:POWer'

'FILTer:TRANsmission'

'FILTer:REFLection'

'BBANd:TRANsmission'

'BBANd:REFLection'

'BBANd:TRANsmission:REVerse'

1

'BBANd:REFLection:REVerse'

1

'MIXer:CLOSs'

'MIXer:GDEL'

'MIXer:REFLection'

'CABLe:TRANsmission'

'CABLe:REFLection'

'CABLe:FAULT'

'CABLe:SRL'

1. For use with 8712ES and 8714ES only.

Programmer’s Guide 11-13

SCPI Command Summary

SCPI Device Command Summary

Table 11-5 CONTrol

SUBSYSTEM COMMANDS FORM

CONTrol[1|2]:MULTiport

:STATE <ON|OFF>

NR1

1. For use with multiport test sets only.

DESCRIPTION

When on, configures analyzer for use with a multiport test set.

1

Table 11-6 DIAGnostic (1 of 4)

SUBSYSTEM COMMANDS FORM DESCRIPTION

DIAGnostic:CCONstants:INSTalled?

DIAGnostic:CCONstants:LOAD

DIAGnostic:CCONstants:STORE:DISK

DIAGnostic:CCONstants:STORE

:EEPRom

DIAGnostic:COMMunicate:LAN

:NETWork:STAT

DIAGnostic:COMMunicate:LAN:PING

:IMM

DIAGnostic:COMMunicate:LAN:PING

:IPAD <string> query only NR1 command only command only command only

Queries if correction constants are installed in flash. Returns a 1 if true, and a 0 if false.

Loads default factory calibration constants from floppy disk to memory.

Stores default factory calibration constants from memory to floppy disk.

Stores default factory calibration constants from memory to flash

EEPROM.

command only command only

Displays the menu to set the IP address to ping and to perform ping.

"Pings" a remote user-specified

IP address. Used in troubleshooting or verifying a

LAN connection.

STRING Sets the IP address to ping.

11-14 Programmer’s Guide

SCPI Command Summary

SCPI Device Command Summary

Table 11-6 DIAGnostic (2 of 4)

SUBSYSTEM COMMANDS

DIAGnostic:COMMunicate:LAN:SEND

<IP_address>,<port_num>,<string> , < timeout>

FORM

NR1,

STRING

DESCRIPTION

Instructs the analyzer to open a socket to the specified IP address and port number, and send the string specified.

<timeout> is an integer <num> in the range 0-75 specifying the number of seconds allocated for a successful transmission. If 0 is specified, a minimum interval of

0.10 seconds is used. If

<timeout> is not specified, the default interval of 75 seconds is used.

DIAGnostic:MDISplay[1|2]

:CORRection

<I_Direct|I_SRcmatch|I_TRacking

|I_Response|I_LDmatch|I_ISolation

|M_Direct|M_ISolation|M_SRcmatch

|M_TRacking|M_Response|M_LDmatch

|M_XScalar|C_Direct|C_SRcmatch

|C_RTracking|C_LDmatch

|C_TTracking|C_Isolation> command only

DIAGnostic:COMMunicate:LA

N:SEND ? returns 0 if the last socket connection was successful, and -1 if the last socket connection failed. This may not be the last socket connection made by the IBASIC program. Multiple socket connections are possible, and telnet sessions may be interspersed among programmed socket connections.

Return to measurement mode and auto scales after viewing calibration uncertainties.

Programmer’s Guide 11-15

SCPI Command Summary

SCPI Device Command Summary

Table 11-6 DIAGnostic (3 of 4)

SUBSYSTEM COMMANDS

DIAGnostic:MDISplay[1|2]

:CORRection <string>

FORM command only

DESCRIPTION

Displays corrected measurement uncertainties. Choose from one of the following strings:

Cal check

C_DIRECTivity

C_LDMATCH

C_ISOLATION

C_RTRACKING

C_SRCMATCH

C_TTRACKING

Interpolated Array (accessed through the service menu.)

I_DIRECTivity

I_RESPONSE

I_SRCMATCH

I_TRACKING

I_LDMATCH

I_ISOLATION

Master Array (accessed through the service menu.)

M_DIRECTivity

M_RESPONSE

M_SRCMATCH

M_TRACKING

M_XSCALAR

M_LDMATCH

I_ISOLATION

DIAGnostic:MDISplay[1|2]

:RESTore command only

Returns to measurement mode and autoscales after viewing calibration uncertainties.

11-16 Programmer’s Guide

SCPI Command Summary

SCPI Device Command Summary

Table 11-6 DIAGnostic (4 of 4)

SUBSYSTEM COMMANDS FORM DESCRIPTION

DIAGnostic:PORT:READ?

<port><register>

1

DIAGnostic:PORT:WRITE

<port><register>

2 query only

NR1,

NR1

NR1,

NR1,

NR1

Reads the rear panel I/O ports.

Writes to the rear panel I/O ports.

DIAGnostic:SNUMber <string>?

query only

STRING

NR1

Queries the instrument's serial number.

DIAGnostic:SPUR:METHod

<NONE|DITHer|AVOid>

Selects the spur avoid mode.

1. Refer to "Controlling Peripherals" in Chapter 7 of the User's Guide for more information on using this command. See also

Table 11-7 on page 11-18

and

Table 11-8 on page 11-19 .

2. See “Controlling Peripherals” in Chapter 7 of the User’s Guide for more information on using this command. See also

Table 11-7 on page 11-18

and

Table 11-8 on page 11-19 .

Programmer’s Guide 11-17

NOTE

SCPI Command Summary

SCPI Device Command Summary

Table 11-7

15

Port

Number

15

15

15

9

Writeable Ports

0

1

2

3

0

Register Description

Outputs 8-bit data to the Cent_D0 through D7 lines of the

Centronics port. Cent_D0 is the least significant bit,

Cent_D7 is the most significant bit. Checks Centronics status lines for:

• Out of Paper

• Printer Not on Line

• BUSY

• ACKNOWLEDGE

Sets/clears the user bit according to the least significant bit of A. A least significant bit equal to 1 sets the user bit high.

A least significant bit of 0 clears the user bit.

Sets/clears the limit pass/fail bit according to the least significant bit of A. A least significant bit equal to 1 sets the pass/fail bit high. A least significant bit of 0 clears the pass/fail bit.

Outputs 8-bit data to the Cent_D0 through D7 lines of the

Centronics port. Cent_D0 is the least significant bit,

Cent_D7 is the most significant bit. Does not check

Centronics status lines.

Outputs a byte to the serial port. The byte is output serially according to the configuration for the serial port.

When using the WRITEIO(15,0) or WRITEIO(15,3) command, the

Printer_Select Line is set high. However, when the instrument is doing hardcopy, the Printer_Select Line is set low. The Printer_Select line may or may not be used by individual printers. Check with your printer manual.

11-18 Programmer’s Guide

SCPI Command Summary

SCPI Device Command Summary

Table 11-8

9

15

15

15

15

Port

Number

Readable Ports

1

2

0

0

10

Register Description

Reads the serial port.

Reads the 8-bit data port Cent_D0 through D7.

Reads the user bit.

Reads the limit test pass/fail bit.

Reads the 8-bit status port.

• D0 — Cent_acknowledge

• D1 — Cent_busy

• D2 — Cent_out_of_paper

• D3 — Cent_on_line

• D4 — Cent_printer_err

Programmer’s Guide 11-19

Table 11-9

SCPI Command Summary

SCPI Device Command Summary

DISPlay (1 of 7)

SUBSYSTEM COMMANDS FORM DESCRIPTION

DISPlay:ANNotation:CHANnel[1|

2][:STATe] <OFF|ON>

DISPlay:ANNotation

:CHANnel[1|2]:USER:LABel:DATA

2

<string>

1

NR1

STRING Specifies the string to be displayed in the measurement channel annotation area (above the graticule).

NR1

Enables/disables measurement channel annotation.

Enables user-defined measurement channel annotation.

DISPlay:ANNotation

:CHANnel[1|2]:USER:STATe<OFF|

ON>

1,2

DISPlay:ANNotation:CLOCk

:DATE:FORMat <char>

DISPlay:ANNotation:CLOCk

:DATE:MODE <char>

DISPlay:ANNotation:CLOCk

:MODE <char>

CHAR

CHAR

CHAR

Selects the Year/Month/Day ordering of the date in the clock display — choose from YMD|MDY|DMY .

Selects the format for the date in the clock display — choose NUMeric or

ALPHa .

Selects how the clock will appear in the measurement display title area — choose from LINE1|LINE2|OFF .

Turns on/off display of seconds in the clock display.

DISPlay:ANNotation:CLOCk

:SEConds[:STATe]<ON|OFF>

1

NR1

DISPlay:ANNotation

:FREQuency[1|2]:MODE <char>

DISPlay:ANNotation

:FREQuency[1|2]:RESolution

<char>

CHAR

CHAR

Sets the frequency annotation on the display — choose SSTOP (start/stop),

CSPAN (center/span) or CW .

Sets the resolution of display frequency values — choose from

MHZ|KHZ|HZ .

Enables/disables frequency annotation.

DISPlay:ANNotation:FREQuency

[1|2] [:STATe] <OFF|ON>

1

NR1

DISPlay:ANNotation:FREQuency

[1|2]:USER:LABel:DATA<string>

STRING A user-defined X-axis label.

1. Binary parameters accept the values of 1 (on) and 0 (off) in addition to ON and OFF .

2. Refer to "Displaying Measurement Results" in Chapter 7 of the User's Guide for more information on using this command.

11-20 Programmer’s Guide

SCPI Command Summary

SCPI Device Command Summary

Table 11-9 DISPlay (2 of 7)

SUBSYSTEM COMMANDS FORM DESCRIPTION

DISPlay:ANNotation:FREQuency

[1|2]:USER:STARt<num>

2

NR3 Specifies the start value for user-defined frequency annotation.

DISPlay:ANNotation:FREQuency

[1|2]:USER:STATe[OFF|ON]

1,2

NR1 Enables user-defined frequency annotation.

DISPlay:ANNotation:FREQuency

[1|2]:USER:STOP<num>

2

NR3 Specifies the stop value for user-defined frequency annotation.

DISPlay:ANNotation:FREQuency

[1|2]:USER:SUFFix[:DATA]

<string>

2

STRING Specifies the suffix for user defined frequency annotation.

DISPlay:ANNotation:LIMit:ICON

[1|2]:FLAG[:STATe] <ON|OFF>

1

NR1 Enables/disables the display of the limit test fail icon.

DISPlay:ANNotation:LIMit:ICON

[1|2] :POSition:X <num>

DISPlay:ANNotation:LIMit:ICON

[1|2] :POSition:Y <num>

NR1

NR1

Positions the limit test pass/fail text and icon on the display. Accepts whole number values from 0 (flush left) to 100 (flush right).

Positions the limit test pass/fail text and icon on the display. Accepts whole number values from 0 (bottom of display) to 100 (top of display).

Turns the limit test "PASS/FAIL" text on or off.

DISPlay:ANNotation:LIMit:ICON

[1|2] :TEXT[:STATe] <ON|OFF>

1

NR1

DISPlay:ANNotation:MARKer[1|2]

:NUMBers [:STATe] <OFF|ON>

1

NR1 Enables/disables the display of marker numbers on trace markers.

DISPlay:ANNotation:MARKer[1|2]

[:STATe]<ON|OFF>

1

NR1 Enables/disables the active marker annotation for measurement channels 1 and 2.

1. Binary parameters accept the values of 1 (on) and 0 (off) in addition to ON and OFF .

2. Refer to “Displaying Measurement Results” in Chapter 7 of the User’s Guide for more information on using this command.

Programmer’s Guide 11-21

SCPI Command Summary

SCPI Device Command Summary

Table 11-9 DISPlay (3 of 7)

SUBSYSTEM COMMANDS FORM DESCRIPTION

DISPlay:ANNotation:MESSage:AOFF

DISPlay:ANNotation:MESSage

:CLEar

1

DISPlay:ANNotation:MESSage

:DATA <string>

:STATe <ON|OFF>

1

DISPlay:ANNotation:MESSage

1

command only command only

STRING

NR1

Turns off any currently showing message window — includes message window, active entry and IBASIC window.

Removes a user-defined pop-up message window.

Displays a user-defined message in the pop-up message window.

Optional argument specifies the timeout: choose from

NONE|SHORt|MEDium|LONG .

Enables/disables the message window — CAUTION: this suppresses display of all messages (even ERROR messages).

Enters a string for the specified title line.

DISPlay:ANNotation:TITLe[1|2]

:DATA <string>

1

STRING

DISPlay:ANNotation:TITLe[:STATe]

<ON|OFF>

1

NR1 Turns on/off display of the title and clock.

DISPlay:ANNotation:YAXis:MODE

<char>

CHAR Sets mode for the Y-axis labels — choose RELative or ABSolute

Turns on/off Y-axis labels.

DISPlay:ANNotation:YAXis[:STATe]

2

<ON|OFF>

NR1

DISPlay:CMAP:COLor[1|2|…16]

:GREYscale <num>

NR2 Changes the default intensity of the selected item on the analyzer's internal monitor.

1. Refer to "Operator Interaction" in Chapter 7 of the User's Guide for more information on using this command.

2. Binary parameters accept the values of 1 (on) and 0 (off) in addition to ON and OFF .

11-22 Programmer’s Guide

SCPI Command Summary

SCPI Device Command Summary

Table 11-9 DISPlay (4 of 7)

SUBSYSTEM COMMANDS FORM DESCRIPTION

DISPlay:CMAP:COLor[1|2|…16]

:HSL <num>,<num>,<num>

DISPlay:CMAP:COLor[1|2|…16]

:RGB <num,num,num>

DISPlay:CMAP:DEFault

DISPlay:CMAP:SCHeme <char>

NR2

NR2 command

only

CHAR

For use with an external VGA compatible monitor. Sets hue, saturation, and luminance for the selected display item. Accepted values for each parameter are 0 to 1.

For use with an external monitor.

Sets the color map based on the

Red/Green/Blue model. Accepted values for each parameter are 0 to 1.

For use with an external monitor.

Sets the color scheme to the factory default.

Sets the color scheme for an external monitor. Choose from

DEFault|DEFault2|GREY|

INVerse|CUSTom .

DISPlay:FORMat <char>

DISPlay:FORMat:EXPAND

<ON|OFF>

DISPlay:MENU:KEY[1|2|7]

<string>

1

CHAR Selects the format

(full or split screen) for displaying trace data — choose SINGle (overlay) or ULOWer (split).

NR1 Enables/disables expand measurement mode.

STRING Specifies the softkey menu labels from a remote controller or IBASIC

STRING Specifies the softkey menu labels when using user-defined BEGIN key.

DISPlay:MENU[2]:KEY[1|2|7]

<string>

1

DISPlay:MENU:RECall:FAST

2

[:STATe] <ON|OFF>

NR1 Turns on/off fast recall mode.

1. Refer to "Operator Interaction" in Chapter 7 of the User's Guide for more information on using this command.

2. Binary parameters accept the values of 1 (on) and 0 (off) in addition to ON and OFF .

Programmer’s Guide 11-23

SCPI Command Summary

SCPI Device Command Summary

Table 11-9 DISPlay (5 of 7)

SUBSYSTEM COMMANDS FORM DESCRIPTION

DISPlay:PROGram[:MODE]

<char>

DISPlay:WINDow[1|2|10]

:GEOMetry:LLEFT?

DISPlay:WINDow[1|2|10]

:GEOMetry:SIZE?

DISPlay:WINDow[1|2|10]

:GEOMetry:URIGHT?

DISPlay:WINDow:GRAPhics

:BUFFer[:STATe]<ON|OFF>

DISPlay:WINDow[1|2|10]

:GRAPhics :CIRCle <num>

2

1

CHAR query only NR1,

NR1 query only

NR1, NR1 query only

NR1,NR1

NR1 command only

Selects the portion of the analyzer's screen to be used as an HP Instrument

BASIC display — choose from

OFF|FULL|UPPer|LOWer .

Queries the absolute pixel coordinates of the lower left corner of the selected display window.

Queries the width and height (in pixels) of the selected display window.

Queries the absolute pixel coordinates of the upper right corner of the selected display window.

Turn on/off buffering of user graphics commands.

Draws a circle of the specified Y-axis radius centered at the current pen location — num is the radius in pixels.

3

Clears the user graphics and graphics buffer for the specified window.

DISPlay:WINDow[1|2|10]

:GRAPhics :CLEar

3

command only

DISPlay:WINDow[1|2|10]

:GRAPhics :COLor <num>

DISPlay:WINDow[1|2|10]

:GRAPhics [:DRAW]

<num1>,<num2>

3

3

NR1 command only

Sets the color of the user graphics pen — choose from 0 for erase, 1 for bright, and

2 for dim.

Draws a line from the current pen position to the specified new pen position

— num1 and num2 are the new absolute

X and Y coordinates in pixels.

3

1. Binary parameters accept the values of 1 (on) and 0 (off) in addition to ON and OFF .

2. Refer to

Chapter 7, “Using Graphics,” for more information.

3. Refer to

Chapter 7 , and to the example program titled "GRAPHICS" in the Example

Programs Guide for more information.

11-24 Programmer’s Guide

SCPI Command Summary

SCPI Device Command Summary

Table 11-9 DISPlay (6 of 7)

SUBSYSTEM COMMANDS FORM DESCRIPTION

DISPlay:WINDow[1|2|10]

:GRAPhics:LABel <string>

DISPlay:WINDow[1|2|10]

:GRAPhics:LABel:FONT <char>

DISPlay:WINDow[1|2|10]

DISPlay:WINDow[1|2|10]

:GRAPhics:RECTangle

<num1>,<num2>

1

1

:GRAPhics :MOVE <num1>,<num2>

1

command only

CHAR

Draws a label with the lower left corner at the current pen location.

Selects the user graphics label font

— choose from

SMALl|HSMall|NORMal|HNORmal|

BOLD|HBOLd|SLANt|HSLant .

NR1,NR1 Moves the pen to the specified new pen position — num1 and num2 are the new absolute X and Y coordinates in pixels.

1

command only

Draws a rectangle of the specified size with lower left corner at the current pen position — num1 and num2 are the width and height in pixels.

1

NR1 Specifies new coordinates for window.

DISPlay:WINDow[1|2|10]

:GRAPhics:SCALe

<xmin>,<xmax>,<ymin,<ymax>

DISPlay:WINDow[1|2|10]

:GRAPhics :STATe?

query onlyNR1

Queries whether a window is enabled for user graphics commands.

Turns display graticule on/off.

DISPlay:WINDow[1|2]:TRACe

:GRATicule:GRID[:STATe]<ON|OF

F>

2

NR1

DISPlay:WINDow[1|2]

:TRACe[1|2][:STATe]<ON|OFF>

2

NR1 Turns the display of trace and memory data from the specified measurement channel on/off.

DISPlay:WINDow[1|2]:TRACe

:Y[:SCALe]:AUTO ONCE command only

Scales the measurement data for a best fit display.

1. Refer to “Using Graphics” in Chapter 7 and the “GRAPHICS” program in the

Example Programs Guide for more information on using this command.

2. Binary parameters accept the values of 1 (on) and 0 (off) in addition to ON and OFF .

Programmer’s Guide 11-25

SCPI Command Summary

SCPI Device Command Summary

Table 11-9 DISPlay (7 of 7)

SUBSYSTEM COMMANDS FORM DESCRIPTION

DISPlay:WINDow[1|2]:TRACe

:Y[:SCALe]:PDIVision<num>

DISPlay:WINDow[1|2]:TRACe

:Y[:SCALe]:RLEVel<num>

1

DISPlay:WINDow[1|2]:TRACe

1

:Y[:SCALe]:RPOSition <num>

1

NR3

NR3

NR3

Specifies the height (dB or units per division) of each vertical division of the specified measurement channel.

Specifies the value for the Y-axis reference position for the specified measurement channel.

Specifies the Y-axis reference position for the specified measurement channel.

Selects the method for reference offset tracking.

DISPlay:WINDow[1|2|10]

:TRACe[1|2]:Y:TRACk

<OFF|PEAK|FREQ>

CHAR

DISPlay:WINDow[1|2|10]

:TRACe[1|2]:Y:TRACk:FREQuency

<num>

1

NR3 Selects frequency to track with reference tracking.

1. Numeric parameters may include an appropriate suffix; if no suffix is included, the default ( HZ for frequency or S for time) is assumed.

11-26 Programmer’s Guide

SCPI Command Summary

SCPI Device Command Summary

Table 11-10 FORMat

SUBSYSTEM COMMANDS

FORMat:BORDer <char>

FORMat[:DATA] <char>[,<num>]

FORM

CHAR

CHAR

[,NR1]

DESCRIPTION

Specifiesa the byte order used for

GPIB data transfer — choose

NORMal or SWAPped (for

PC-compatible systems).

Specifies the data format for use during data transfer — choose from

REAL,64|REAL,32|INTeger,16

|ASCii .

Programmer’s Guide 11-27

SCPI Command Summary

SCPI Device Command Summary

Table 11-11 HCOPy (1 of 2)

SUBSYSTEM COMMANDS FORM DESCRIPTION

HCOPy:ABORt

HCOPy:DEVice[1|2|3]:COLor

<ON|OFF>

1, 2 command

only

NR1

Aborts any hardcopy currently in progress.

Selects monochrome

ON

OFF or color

mode for hardcopy output.

HCOPy:DEVice[1|2|3]:LANGuage

<char>

2

HCOPy:DEVice[1|2|3]:MODE <char>

2

CHAR

CHAR

Selects the language for hardcopy output — choose from

PCL|HPGL|EPSon|IBM|PCX|

PCL5

3

Selects the graph and/or table(s) to appear on a hardcopy plot — choose from

GMARker|GRAPh|ISETtings|M

ARKer|TABLe .

Sets the left margin (for printer output) in millimeters.

HCOPy:DEVice[1|2|3]:PAGE:MARGin

:LEFT <num>

2

NR2

HCOPy:DEVice[1|2|3]:PAGE:MARGin

:TOP <num>

2

NR2 Sets the top margin (for printer output) in millimeters.

HCOPy:DEVice[1|2|3]:PAGE

:ORIentation <char>

2

HCOPy:DEVice[1|2|3]:PAGE:WIDTh

<num>

2

HCOPy:DEVice[1|2|3]:PORT <char>

2

CHAR

NR2

Sets printer output page orientation — choose PORTrait or LANDscape .

Sets the print width (for printer output) in millimeters.

CHAR Selects the communications port for hardcopy output — choose from

CENTronics|SERial|GPIB|MM

EMory|LAN .

1. Binary parameters accept the values of 1 (on) and 0 (off) in addition to ON and OFF .

2. For DEVice , use 1 for PCL/Epson printers, 2 for plotters, and 3 for PCL5 printers.

3.

EPSon and IBM produce the same results.

11-28 Programmer’s Guide

SCPI Command Summary

SCPI Device Command Summary

Table 11-11 HCOPy (2 of 2)

SUBSYSTEM COMMANDS FORM DESCRIPTION

HCOPy:DEVice[1|2]:RESolution

<num>

1

HCOPy[:IMMediate]

HCOPy:ITEM[1|2|3]:ANNotation

:STATe <ON|OFF>

HCOPy:ITEM[1|2|3]:FFEed:STATe

<ON|OFF>

1, 2

1, 2

NR1 command

only

NR1

NR1

Sets the printer resolution in dots per inch.

Initiates a hardcopy output (print or plot).

For DEVice , use 1 for PCL/Epson printers, or 2 for plotters.

Turns on/off channel and frequency annotation as part of hardcopy output.

Turns on/off an automatic form feed at the completion of hardcopy output — use item 1 for printers and 2 for plotters.

Turns on/off graticule as part of hardcopy output.

HCOPy:ITEM[1|2|3]:GRATicule

:STATe <ON|OFF>

1, 2

NR1

HCOPy:ITEM[1|2|3]:MARKer:STATe

<ON|OFF>

2, 3

NR1 Turns on/off marker symbols as part of hardcopy output.

HCOPy:ITEM[1|2|3]:TITLe:STATe

<ON|OFF>

2, 3

NR1 Turns on/off title and clock lines as part of hardcopy output.

HCOPy:ITEM[1|2|3]:TRACe:STATe

<ON|OFF>

2, 3

NR1 Turns on/off trace data as part of hardcopy output.

1. For DEVice , use 1 for PCL/Epson printers, or 2 for plotters.

2. For DEVice , use 1 for PCL/Epson printers, 2 for plotters, and 3 for PCL5 printers.

3. Binary parameters accept the values of 1 (on) and 0 (off) in addition to ON and OFF .

Programmer’s Guide 11-29

SCPI Command Summary

SCPI Device Command Summary

Table 11-12 INITiate

SUBSYSTEM COMMANDS FORM DESCRIPTION

INITiate[1|2]:CONTinuous

<ON|OFF>

1

NR1 Sets the trigger system to continuously sweep or to stop sweeping.

INITiate[1|2][:IMMediate] command only

Initiates a new measurement sweep.

1. Binary parameters accept the values of 1 (on) and 0 (off) in addition to ON and OFF .

Table 11-13 INPut

SUBSYSTEM COMMANDS FORM DESCRIPTION

INPut:GAIN:AUTo <R|A|B>,<ON|OFF> command only

INPut:GAIN:SETTing <R|A|B>,

<HIGH|MEDHIGH|MEDIUM|LOW> command only

Sets the R, A, or B IF input automatic gain control on or off.

Sets the R, A, or B IF input gain to one of four choices: high, medium-high, medium, or low.

11-30 Programmer’s Guide

SCPI Command Summary

SCPI Device Command Summary

Table 11-14 MMEMory (1 of 3)

SUBSYSTEM COMMANDS

MMEMory:CATalog?<string>

1

MMEMory:CDIRectory <string>

MMEMory:COPY <string1>,

<string2>

1, 2

MMEMory:DELete <string>

MMEMory:INITialize

1, 2

[<string>[,<char>[,<num>]]]

FORM query only

STRING

STRING command only command only command only

DESCRIPTION

Lists the names of the files in memory.

(a directory listing, file names only.)

Changes the current directory on a DOS formatted disk — new directory must be on the same mass storage device.

Copies a file — string1 is the source file, string2 is the destination file.

Deletes a file — string is the filename.

Formats a disk — string is the mass storage device MEM:

(internal memory), or INT:

(internal floppy disk). Disk format char is DOS , and the interleave factor num .

MMEMory:LOAD:STATe 1, <string>

1, 3

command only

Recalls an instrument state from mass storage — string is the filename.

Recalls a user cal kit.

MMEMory:LOAD:CKIT:USER[:SELect]

<KIT1|KIT2...KIT10>

MMEMory:FILE:INFO?<string>

1

command only query only

STRING

Returns file information such as date/time.

(a directory listing, file names and more info.)

MMEMory:MDIRectory <string>

2

command only

Makes a new directory on a DOS formatted disk.

1. Filenames may include the mass storage device — MEM: (internal non-volatile memory), RAM: (internal volatile memory), INT: (internal 3.5 disk drive) or NFS local path. Wildcards ? and * may be used.

2. Be sure to catalog the desired disk using MMEM:MSIS before using this command.

3. Refer to "Automated Measurement Setup and Control" in Chapter 7 of the User's Guide for more information on using this command.

Programmer’s Guide 11-31

SCPI Command Summary

SCPI Device Command Summary

Table 11-14 MMEMory (2 of 3)

SUBSYSTEM COMMANDS FORM DESCRIPTION

MMEMory:MOVE

<string1>,<string2>

1, 2

MMEMory:MSIS <string>

MMEMory:RDIRectory <string>

MMEMory:STORe:STATe 1,

<string>

<ON|OFF>

1, 2, 3

2

MMEMory:STORe:STATe:CORRection

3

command only

STRING command only command only

NR1

Moves or renames a file — string1 is the source (or old) filename and string2 is the destination (or new) filename.

Selects a mass storage device — choose MEM: (internal memory),

INT: (internal floppy disk drive), etc.

Deletes a directory from a DOS formatted disk.

Saves an instrument state to mass storage — string is the filename.

Turns the calibration on/off — part of the definition of a saved file.

MMEMory:STORe:STATe:FORMat

<char>

MMEMory:STORe:STATe:ISTate

<ON|OFF>

3

CHAR

NR1

Saves instrument state files to be compatible with older "A/B" model analyzers (choose B8711 ), or with current "C" model analyzers (choose C8711 ).

Turns the instrument state on/off — part of the definition of a saved file.

MMEMory:STORe:STATe:TRACe

<ON|OFF>

3

NR1 Turns the data trace on/off — part of the definition of a saved file.

1. File names may include the mass storage device name— MEM: (internal non-volatile memory), RAM: (internal volatile memory), INT: (internal 3.5” disk drive), or NFS

local path. Wildcards ?

and * may be used.

2. Be sure to catalog the desired disk using MMEM:MSIS before using this command.

3. Binary parameters accept the values of 1 (on) and 0 (off) in addition to ON and OFF .

11-32 Programmer’s Guide

SCPI Command Summary

SCPI Device Command Summary

Table 11-14 MMEMory (3 of 3)

SUBSYSTEM COMMANDS FORM DESCRIPTION

MMEMory:STORe:STATe:TSCAL

<ON|OFF>

MMEMory:STORe:TRACe:FORMat

<char>

1

MMEMory:STORe:TRACe

<char>,<string>

2, 3

NR1 command only

CHAR

When on, the saved state will be the test set cal only.

Stores an ASCII list of trace and frequency values to a file — char is the formatted data trace

CH<1|2>FDATA and string is the filename.

Selects the format that the ASCII data will be saved in. Choose from LOTus 123 or TOUChstone .

Copies a file to or from the analyzer's disk drive.

5

MMEMory:TRANsfer:BDAT

<string>

2

[,<block>]

4

STRING,

BLOCK

MMEMory:TRANsfer[:HFS]

<string>

2

[,<block>]

4

STRING, Copies a file to or from the analyzer's disk drive.

5

1. Binary parameters accept the values of 1 (on) and 0 (off) in addition to ON and OFF .

2. File names may include the mass storage device name— MEM: ( internal non-volatile memory), RAM: (internal volatile memory), INT: (internal 3.5” disk drive), or NFS

local path. Wildcards ?

and * may be used.

3. Refer to “Automated Measurement and Control” in Chapter 7 of the User’s Guide for more information on using this command

4. Refer to the Example Programs Guide for more information on using this command.

5. Refer to the example programs PUTFILE and GETFILE in the Example Programs

Guide.

Programmer’s Guide 11-33

SCPI Command Summary

SCPI Device Command Summary

Table 11-15 OUTPut

SUBSYSTEM COMMANDS

OUTPut[:STATe] <ON|OFF>

1

FORM DESCRIPTION

NR1 Turns RF power from the source on/off.

1. Binary parameters accept the values of 1 (on) and 0 (off) in addition to ON and OFF .

Table 11-16 POWer

DESCRIPTION

SUBSYSTEM COMMANDS FORM

POWer[1|2]:MODE <char> CHAR Specifies either frequency sweep

( FIXed ) or power sweep ( SWEep ).

11-34 Programmer’s Guide

SCPI Command Summary

SCPI Device Command Summary

Table 11-17 PROGram (1 of 2)

SUBSYSTEM COMMANDS

PROGram

1

:CATalog?

FORM DESCRIPTION query only

STRING

Lists the names of the defined

IBASIC programs — response is

"PROG" (if a program is present) or the null string ( "" ).

Downloads an IBASIC program from an external controller.

PROGram

1

[:SELected]

2

:DEFine

<block>

PROGram

1

[:SELected]

2

:DELete:ALL

BLOCK

PROGram

1

[:SELected]

:DELete[:SELected]

2

command

only command

only

Deletes all IBASIC programs from the program buffer — equivalent to an HP BASIC

SCRATCH A command.

Deletes the active IBASIC program — equivalent to an HP

BASIC SCRATCH A command.

Executes an IBASIC command.

PROGram

1

[:SELected]

2

:EXECute

<string> command

only

PROGram

1

<num>

[:SELected]

2

:MALLocate

NR1 Allocates memory space for

IBASIC programs — choose an integer between 2048 and

4000000 bytes.

1. IBASIC programs can be generated and controlled in the instrument.

2. Commands grouped under the SELected mnemonic in the PROGram subsystem operate on the active program buffer.

Programmer’s Guide 11-35

SCPI Command Summary

SCPI Device Command Summary

Table 11-17 PROGram (2 of 2)

SUBSYSTEM COMMANDS

PROGram [:SELected]

1

:NAME 'PROG'

FORM DESCRIPTION

PROGram [:SELected]

1

<string>,<data>

2

PROGram [:SELected]

<char>

PROGram [:SELected]

<string1>,<string2>

1

1

:NUMBer

:STATe

:STRing

STRING Selects the IBASIC program in the program buffer to be active.

BLOCK or NR3

2

Loads a new value for a numeric variable string in the active

IBASIC program — num is the new value.

CHAR Selects the state of the active

IBASIC program — choose from

STOP|PAUSe|RUN|CONTinue .

STRING Loads a new value for a string variable string1 in the active

IBASIC program — string2 is the new value.

PROGram [:SELected]

1

:WAIT

NR1 Waits until the IBASIC program completes.

1. Commands grouped under the SELected mnemonic in the PROGram subsystem operate on the active program buffer.

2. The parameter type of the data is determined by the format selected — FORMat

REAL uses BLOCK data, FORMat ASCii uses NR3 data separated by commas.

11-36 Programmer’s Guide

SCPI Command Summary

SCPI Device Command Summary

Table 11-18 ROUTe

SUBSYSTEM COMMANDS

ROUTe[1|2]:REFLection:PATH

:DEFine:PORT<1|2|…|12>

ROUTe[1|2]:TRANsmission:PATH

:DEFine: PORT <1|2|…|12>

ROUTe[1|2]:PATH:DEFine

: PORT <num>,<num>

FORM

NR1

NR1

NR1

1. For use with multiport test sets only.

2. For use with the 8712ES and 8714ES models only.

DESCRIPTION

Selects which port of the test set is connected to the REFLECTION port of the analyzer.

1

Selects which port of the test set is connected to the TRANSMISSION port of the analyzer.

1

Selects which port of the analyzer is to function as the reflection (RF out) port and which port is to function as the transmission (RF in) port. Choose from 1,2

(forward), or 2,1 (reverse).

2

Programmer’s Guide 11-37

SCPI Command Summary

SCPI Device Command Summary

Table 11-19 SENSe (1 of 16)

SUBSYSTEM COMMANDS FORM DESCRIPTION

SENSe[1|2]:ACTIVE?

SENSe[1|2]:AVERage:CLEar

SENSe[1|2]:AVERage:COUNt

<num>

SENSe[1|2]:AVERage[:STATe]

<ON|OFF>

1

SENSe[1|2]:BWIDth

[:RESolution] <num> HZ query only command only

NR1

NR1

NR2

Returns true (1) if the channel is active, false (0) if the channel is not active. (Only one channel can be

“active” at a time.)

Re-starts the trace averaging function.

Specifies a count or weighting factor for the averaged measurement data.

Turns the trace averaging function on/off.

Specifies the bandwidth of the IF receiver (fine, narrow, medium or wide) to be used in the measurement

— choose

15 (fine)

250 (narrow)

1200 (medium narrow)

3700 (medium)

4000 (medium wide)

6500 (wide)

SENSe[1|2]:CORRection:

[OFF/ON]

1

SENSe[1|2]:CORRection:

ANNotation?

NR1 query only

NR3

Turns measurement calibration function on/off. Uncorrected readings are used when “off.”

Returns the current calibration annotation: "C", "C?", “Cx”, or "".

SENSe[1|2]:CORRection:

CAPacitance:CONNector <num>

Selects a connector compensating capacitance value. (For use with structural return loss measurements on analyzers with Option 100 only.)

1. NR1 values of 1 (on) and 0 (off) can be used in place of CHAR values ON and OFF.

11-38 Programmer’s Guide

SCPI Command Summary

SCPI Device Command Summary

Table 11-19 SENSe (2 of 16)

SUBSYSTEM COMMANDS

SENSe[1|2]:CORRection:CKIT:LOAD

:MODify:DELay? #0~1e-06[S]#

SENSe[1|2]:CORRection:CKIT:LOAD

:MODify:LOSS? #0~1e+12#

SENSe[1|2]:CORRection:CKIT:LOAD

:MODify:ZOFFset? #25~100[OHM]#

SENSe[1|2]:CORRection:CKIT:MODify

[:SElect]

<TYPenf|TYPenm|UD1|TYPe35mm

|TYPeff|TYPe716f|TPe716m|UD2

|TYPeapc7|UD3|UD4|...|UD10>

SENSe[1|2]:CORRection:CKIT:NAME

<KIT1|KIT2|...|KIT10>,<STRING>

SENSe[1|2]:CORRection:CKIT:OPEN

:MODify:CONE? #-10000~1[FARAD]#

SENSe[1|2]:CORRection:CKIT:OPEN

:MODify:CTHRee? #-10000~1[FARAD]#

SENSe[1|2]:CORRection:CKIT:OPEN

:MODify:CTWO? #-10000~1[FARAD]#

SENSe[1|2]:CORRection:CKIT:OPEN

:MODify:CZERo? #-10000~1[FARAD]#

SENSe[1|2]:CORRection:CKIT:OPEN

:MODify:DELay? #0~1e-06[S]#

FORM

NR3

NR3

NR1

CHAR

STRING

NR3

NR3

NR3

NR3

NR3

DESCRIPTION

Sets or queries the cal kit load standard offset delay time.

Sets or queries the cal kit load standard offset loss value.

Sets or queries the cal kit load standard offset impedance value.

Selects or queries the cal kit connector type. Select

TYPe716f or TYPe716m for modifiable cal kit.

Sets the description of the user-defined calibration kit.

Sets or queries the cal kit open standard fringe capacitance C1

(f

1

, Farad/Hz) value.

Sets or queries the cal kit open standard fringe capacitance C3

(f

3

, Farad/Hz

3

) value.

Sets or queries the cal kit open standard fringe capacitance C2

(f

2

, Farad/Hz

2

) value.

Sets or queries the cal kit open standard fringe capacitance model C0 (f

0

, Farad) value.

Modifies or queries the cal kit open standard offset delay time.

Programmer’s Guide 11-39

SCPI Command Summary

SCPI Device Command Summary

Table 11-19 SENSe (3 of 16)

SUBSYSTEM COMMANDS

SENSe[1|2]:CORRection:CKIT:OPEN

:MODify:LOSS? #0~1e+12#

SENSe[1|2]:CORRection:CKIT:OPEN

:MODify:ZOFFset? #25~100[OHM]#

SENSe[1|2]:CORRection:CKIT:PRESet

[:IMMediate]-?

[<KIT1|KIT2|...|KIT10>]

SENSe[1|2]:CORRection:CKIT:SAVE?

<KIT1|KIT2|...|KIT10>

SENSe[1|2]:CORRection:CKIT:SHORt

:MODify:DELay? #0~1e-06[S]#

SENSe[1|2]:CORRection:CKIT:SHORt

:MODify:LOSS? #0~1e+12#

SENSe[1|2]:CORRection:CKIT:SHORt

:MODify:ZOFFset? #25~100[OHM]#

SENSe[1|2]:CORRection:CKIT:THRU

:MODify:DELay? #0~1e-06[S]#

SENSe[1|2]:CORRection:CKIT:THRU

:MODify:LOSS? #0~1e+12#

SENSe[1|2]:CORRection:CKIT:THRU

:MODify:ZOFFset? #25~100[OHM]#

FORM

NR3

Command

Only

CHAR

NR3

NR3

NR1

NR3

NR3

NR3

NR3

DESCRIPTION

Modifies or queries the cal kit open standard offset loss value.

Modifies or queries the cal kit open standard offset impedance value.

Sets all values of all user-defined cal kits to the default values.

Saves the user-defined cal kit or queries whether the selected user-defined cal kit has been saved.

Modifies or queries the cal kit short standard offset delay time.

Modifies or queries the cal kit short standard offset loss value.

Modifies or queries the cal kit short standard offset impedance value.

Modifies or queries the cal kit thru standard offset delay time.

Modifies or queries the cal kit thru standard offset loss value.

Modifies or queries the cal kit thru standard offset impedance value.

11-40 Programmer’s Guide

SCPI Command Summary

SCPI Device Command Summary

Table 11-19 SENSe (4 of 16)

SUBSYSTEM COMMANDS FORM DESCRIPTION

SENSe[1|2]:CORRection:CLASs

[:SELect]?

SENSe[1|2]:CORRection:CLASs

[:SELect] <item>

SENSe[1|2]:CORRection:COLLect

:ABORt

CHAR command

only

Returns the current calibration choice. Returns string from the

<item> list (below). (ES models only)

Selects an existing calibration from the following <item> list:

DEFault1

DEFault2

REFLection3 *

TRANsmission1 *

TRANsmission2

TRANsmission3

TESTset1

TWOPort * calibration

*

*

Default factory one-port calibration

Default factory two-port calibration

User one-port calibration

User response calibration

User response and isolation calibration

User enhanced response calibration

Multi-port testset calibration

User two-port calibration Multi-port testset

* The requested user calibration may or may not be stored in memory, and may or may not be valid for the current instrument settings. If the requested user calibration is invalid, a valid user calibration will be selected, if found.

If no valid user calibration is found, the default factory calibration will be selected. The instrument can be queried with

SENSe[1|2]:CORRection:CLASs[:SELect]?

to determine the current calibration choice.

command

only

Aborts the calibration that is currently in progress.

Programmer’s Guide 11-41

SCPI Command Summary

SCPI Device Command Summary

Table 11-19 SENSe (5 of 16)

SUBSYSTEM COMMANDS

SENSe[1|2]:CORRection:

COLLect[:ACQuire] <char>

SENSe[1|2]:CORRection

:COLLect:CKIT:PORT[1|2|…|12

][:SELect]<string>

SENSe[1|2]:CORRection:COLLe ct:CKIT[:SELect]<string>

FORM DESCRIPTION command

only

Measures a calibration standard — select <char> from:

STANdard1

STANdard2

STANdard3

STANdard4

STANdard5

STANdard6

STANdard7

STRING Selects which port of the analyzer or multiport test set will be assigned a Cal

Kit. Also, selects a Cal Kit— choose from one of the following strings:

‘COAX,7MM,TYPE-N,50,FEMALE’

‘COAX,7MM,TYPE-N,50,MALE’

‘COAX,3.5MM,APC-3.5,50,IMPLIED’

‘USER|USER1|USER2,IMPLIED,

IMPLIED,IMPLIED, IMPLIED’

‘COAX,7MM,TYPE-F,75,IMPLIED’

‘COAX,7MM,TYPE-N,75,FEMALE’

‘COAX,7MM,TYPE-N,75,MALE’

‘COAX,7MM,APC-7,50,IMPLIED’

‘COAX,7MM,TYPE-7-16,50,FEMALE’

STRING Selects a Cal Kit— choose from one of the following strings:

'COAX,7MM,TYPE-N,50,FEMALE'

'COAX,7MM,TYPE-N,50,MALE'

'COAX,3.5MM,APC-3.5,50,IMPLIED'

'USER|USER1|USER2,IMPLIED,

IMPLIED,IMPLIED, IMPLIED'

'COAX,7MM,TYPE-F,75,IMPLIED'

'COAX,7MM,TYPE-N,75,FEMALE'

'COAX,7MM,TYPE-N,75,MALE'

‘COAX,7MM,TYPE-7-16,50,FEMALE’

‘COAX,7MM,TYPE-7-16,50,MALE’

11-42 Programmer’s Guide

SCPI Command Summary

SCPI Device Command Summary

Table 11-19 SENSe (6 of 16)

SUBSYSTEM COMMANDS FORM DESCRIPTION

SENSe[1|2]:CORRection:COLL ect:ISTate[:AUTO]<ON|OFF>

SENSe[1|2]:CORRection:

COLLect:METHod <char>

1

NR1 command only

Selects the instrument state for calibration — choose Full Band ( ON ) or

User Defined ( OFF ).

Selects the type of calibration — choose from:

TRAN1 — Transmission response

TRAN2 — Transmission response &

Isolation

TRAN3 — Transmission enhanced response

REFL3 — Reflection one port

TESTset — Test Set Calibration

(Enhanced Response/1-Port)

1

TESTset1 — Test Set Calibration

(Enhanced Response/1-Port)

1

TESTset2 — Test Set Calibration

(2-Port)

1

VERIFY — Calibration Check

TWOPort — Two-port calibration

NONE — No calibration

Measures an open on the port selected during a test set calibration.

2

SENSe[1|2]:CORRection:COLL ect:MP:OPEN

<STAN1|STAN2|…|STAN12> command only

SENSe[1|2]:CORRection:COLL ect:MP:SHORT

<STAN1|STAN2|…|STAN12> command only

Measures a short on the port selected during a test set calibration.

2

1. Binary parameters accept the values of 1 (on) and 0 (off) in addition to ON and OFF .

2. For use with multiport test sets only.

Programmer’s Guide 11-43

SCPI Command Summary

SCPI Device Command Summary

Table 11-19 SENSe (7 of 16)

SUBSYSTEM COMMANDS FORM DESCRIPTION

SENSe[1|2]:CORRection:COLLect

:MP:LOAD

<STAN1|STAN2|…|STAN12> command only

Measures a load on the port selected during a test set calibration.

2

SENSe[1|2]:CORRection:COLLect

:MP:THRU

<STAN1|STAN2|…|STAN6> command only

Measures a thru on the port selected during a test set calibration.

2

SENSe[1|2]:CORRection:COLLect

:PORTS <2|4|6|8|10|12>

SENSe[1|2]:CORRection:COLLect

:SAVE

SENSe[1|2]:CORRection:COLLect

:VERify:REFLection

<STAN1|STAN2|…|STAN12>

SENSe[1|2]:CORRection:COLLect

:VERify:TRANsmission

<STAN1|STAN2|…|STAN12>;

NR1 command only command only command only

Selects the number of ports to perform a test set calibration on.

1

Completes and saves current calibration.

Measures a calibration standard during a cal check procedure for reflection measurements.

Measures a calibration standard during a cal check procedure for transmission measurements.

SENSe[1|2]:CORRection:CSET

[:SELect] DEFault

SENSe[1|2]:CORRection:CSET

[:SELect]?

command only query only

CHAR

Restores the "factory" default calibration for the current measurement and channel.

Queries the current calibration type

— returns DEF (factory default),

FULL (full band) or USER (user defined).

SENSe[1|2]:CORRection:EDELay

:TIME <num>

2

SENSe[1|2]:CORRection:EXTensi on:REFLection[:TIME]<num>

2

NR3

NR3

Specifies the electrical delay in seconds.

Specifies the port extension at the reflection port, in seconds.

1. For use with multiport test sets only.

2. Numeric parameters may include an appropriate suffix; if no suffix is included, the default ( HZ for frequency or S for time) is assumed.

11-44 Programmer’s Guide

SCPI Command Summary

SCPI Device Command Summary

Table 11-19 SENSe (8 of 16)

SUBSYSTEM COMMANDS FORM DESCRIPTION

SENSe[1|2]:CORRection:EXTension[:

1

STATe]<ON|OFF>

NR1 Enables port extensions.

SENSe[1|2]:CORRection:EXTension

:TRANsmission[:TIME] <num>

2

SENSe[1|2]:CORRection:IMPedance

:INPut:MAGNitude<num>

2

SENSe[1|2]:CORRection:IMPedance

:INPut:MAGNitude:SELect ZO_50

SENSe[1|2]:CORRection:IMPedance

:INPut:MAGNitude:SELect ZO_75

NR3

NR3

NR1

NR1

Specifies the port extension at the transmission port, in seconds.

Specifies the reference impedance for the Smith chart display. The default is the analyzer's system impedance.

Selects 50 ohms as the system impedance.

Selects 75 ohms as the system impedance.

SENSe[1|2]:CORRection:ISOLation

[:STATe] {OFF|0|ON|1}

SENSe[1|2]:CORRection:LENGth

:COAX <num>

2

NR1

NR2

Enables or disables use of isolation error correction when

2-port calibrations are selected.

Specifies the length of cable to be calibrated, in feet or meters.

3

SENSe[1|2]:CORRection:LENGth

:CONNector <num>

2

NR2 Specifies the length of an interface connector, in mm or inches.

3

SENSe[1|2]:CORRection:LOSS

:COAX <num>

2

NR2 Specifies the loss of a cable under test, in dB/100 ft.

3

1. Binary parameters accept the values of 1 (on) and 0 (off) in addition to ON and OFF .

2. Numeric parameters may include an appropriate suffix; if no suffix is included, the default ( HZ for frequency or S for time) is used.

3. For use with structural return loss measurements using analyzers with Option 100 only.

Programmer’s Guide 11-45

SCPI Command Summary

SCPI Device Command Summary

Table 11-19 SENSe (9 of 16)

SUBSYSTEM COMMANDS FORM DESCRIPTION

SENSe[1|2]:CORRection:MODel

:CONNector[:IMMediate] command only

Measures the cable connector and determine the optimum values for connector length and connector capacitance.

3

Specifies the phase offset.

SENSe[1|2]:CORRection:OFFSet

:PHASe

NR3

SENSe[1|2]:CORRection:ONEPort

:REFLection[:IMMediate]

SENSe[1|2]:CORRection:ONEPort

:TRANSmission[:IMMediate]

SENSe[1|2]:CORRection:TWOPort

[:IMMediate] command only command only command only

Retrieves the user one-port reflection error correction factors from internal memory and applies them to the current measurement.

Retrieves the user one-port transmission error correction factors from internal memory and applies them to the current measurement.

Retrieves the user two-port error correction factors from internal memory and applies them to the current measurement.

Turns multi-peak correction on or off.

2

SENSe[1|2]:CORRection:PEAK

1

:COAX[:STATe]<ON|OFF>

NR1

SENSe:CORRection:RVELocity

:COAX <num>

SENSe[1|2]:CORRection:RVELocity

[:IMMediate]

3

NR3 command only

Specifies the velocity factor to be used when displaying the distance for electrical length and port extensions. 1.0 the speed of light.

Measures the cable and determine the optimum values for cable loss and velocity factor.

2

1. Binary parameters accept the values of 1 (on) and 0 (off) in addition to ON and OFF .

2. For use with fault location measurements on analyzers with Option 100 only.

3. Numeric parameters may include an appropriate suffix; if no suffix is included, the default (H Z for frequency or S for time) is assumed.

11-46 Programmer’s Guide

SCPI Command Summary

SCPI Device Command Summary

Table 11-19 SENSe (10 of 16)

SUBSYSTEM COMMANDS FORM DESCRIPTION

SENSe[1|2]:CORRection:TESTSET command only

NR2

Brings up the Test Set Cal menu.

2

SENSe[1|2]:CORRection:THReshol d:COAX <num>

SENSe[1|2]:COUPle <char>

SENSe[1|2]:DETector[:FUNCtion]

<char>

SENSe[1|2]:DISTance:CENTer

<num>

SENSe[1|2]:DISTance:STARt

<num>

SENSe[1|2]:DISTance:UNITs

<char>

SENSe[1|2]:DISTance:STOP <num>

SENSe[1|2]:FREQuency:CENTer

2

<num>

CHAR

CHAR

NR3

NR3

CHAR

NR3

NR3

Selects multi-peak threshold value, in dB.

1

Turns the alternate sweep mode on/off — choose ALL (coupled sweep) or NONE (alternate sweep).

Specifies which detection mode is used to make the measurement — choose BBANd (broadband) or NBANd

(narrowband).

Sets the center distance for a fault location measurement, in feet or meters.

1

Sets the start distance for a fault location measurement, in feet or meters.

1

Specifies distance units. Choose

METers or FEET .

1

Sets the stop distance for a fault location measurement, in feet or meters.

1

Sets the center frequency of the RF source.

1. For use with fault location measurements on analyzers with Option 100 only.

2. Numeric parameters may include an appropriate suffix; if no suffix is included, the default (H Z for frequency or S for time) is assumed.

Programmer’s Guide 11-47

SCPI Command Summary

SCPI Device Command Summary

Table 11-19 SENSe (11 of 16)

SUBSYSTEM COMMANDS FORM DESCRIPTION

SENSe[1|2]:FREQuency:MODE <char>

SENSe[1|2]:FREQuency:SPAN <num>

SENSe[1|2]:FREQuency:SPAN

:MAXimum <num>

1

SENSe[1|2]:FREQuency:STARt <num>

SENSe[1|2]:FREQuency:STOP <num>

1

1

1

CHAR

NR3

NR3

NR3

NR3

Sets the fault location measurement to CENTer

(bandpass) or LOWPass .

2

Sets the frequency span of the

RF source.

Sets the maximum frequency span of the RF source for bandpass fault location measurements.

2

Sets the start frequency of the

RF source.

Sets the stop frequency of the

RF source.

SENSe[1|2]:FREQuency:ZSTOp

<num>

1

SENSe[1|2]:FUNCtion?

NR3 query only

STRING

Sets the Z cutoff frequency for

cable impedance calculations.

2

See SENSe [1|2]:FUNction

‘. . . . .’ commands for string definitions .

Queries the measurement function — returns a string that defines the current measurement function.

1. Numeric parameters may include an appropriate suffix; if no suffix is included, the default (H Z for frequency or S for time) is assumed.

2. For use with fault location measurements on analyzers with Option 100 only.

11-48 Programmer’s Guide

SCPI Command Summary

SCPI Device Command Summary

Table 11-19

SUBSYSTEM COMMANDS

SENSe[1|2]:FUNCtion ‘FLOC

<num>,<num>’

SENSe (12 of 16)

FORM command only

SENSe[1|2]:FUNCtion

'XFRequency:POWer <num>' command only

DESCRIPTION

Specifies that the receiver will measure the ratio of the power (fault location) into the specified measurement channel.

For 8712ET/8714ET models—choose

1,0 (Forward A/R).

For 8712ES/8714ES models—choose

1,0 (Forward A/R), or 22, 20 (Reverse

B/R).

(For use with fault location measurement on analyzers with Option

100 only.)

Specifies that the receiver will measure the power into a specific detector on the specified measurement channel.

For 8712ET/8714ET models— choose from detectors 0 (R), 1 (A), 2 (B), 11 (Ext

X) or 12 (Ext Y).

For 8712ES/8714ES models—choose from detectors:

0 ( Forward R )

20 (Reverse R)

1 (Forward A)

21 (Reverse A)

11 (Forward Ext X)

12 (Forward Ext Y)

2 (Forward B)

22 (Reverse B)

Programmer’s Guide 11-49

SCPI Command Summary

SCPI Device Command Summary

Table 11-19

SUBSYSTEM COMMANDS

SENSe[1|2]:FUNCtion

'XFRequency:GDELay:RATio

<num>,<num>'

SENSe (13 of 16)

FORM command only

DESCRIPTION

Specifies that the receiver will measure the ratio of the power ( group delay) into the specified measurement channel. For

8712ET/8714ET models—choose ratio

2,0 (B/R).

For 8712ES/8714ES models—choose from ratios 2,0 (Forward B/R), or

21,20 (Reverse A/R).

SENSe[1|2]:FUNCtion

'XFRequency:POWer:RATio

<num>,<num>' command only

Specifies that the receiver will measure a ratio of the power into the specified measurement channel.

For 8712ET/8714ET models— choose from ratios 1,0 (A/R), 2,0 (B/R), 12,0

(Ext Y/R), 11,12 (Ext X/Ext Y), or

12,11 (Ext Y/Ext X).

For 8712ES/8714ES models—choose from ratios:

1,0 (Forward A/R)

21,20 (Reverse A/R)

2,0 (Forward B/R)

22,20 (Reverse B/R)

12,0 (Forward Ext Y/R)

11,12 (Forward Ext X/Ext Y)

12,11 (Forward Ext Y/Ext X)

11-50 Programmer’s Guide

SCPI Command Summary

SCPI Device Command Summary

Table 11-19 SENSe (14 of 16)

SUBSYSTEM COMMANDS FORM DESCRIPTION

SENSe[1|2]:FUNCtion

'XFRequency:S <num>,<num>'

NR1,NR1 Specifies that the receiver will measure an s-parameter into the specified measurement channel. The s-parameter choices will depend on the number of ports. For example, with a 2-port device, choose from 1,1 ( S

11

), 1,2 ( S

12

), 2,2

( S

22

), or 2,1 ( S

21

).

As another example, with a 12-port device using the 87075C multiport test set, some choices would include 1,8

(S

18

), or 12,1 ( S

12

,

1

), or 7,7 (S

77

).

This command may be used in place of:

SENS[1|2]:FUNC ‘XFR:POW:RAT and ROUT[1|2}:PATH:DEF:PORT .

If using the 87075C multiport test set, this command may be used in place of the two commands just listed, as well as:

ROUT[1|2]:REFL:PATH:DEF:PORT and

OUT[1|2]:TRAN:PATH:DEF:PORT .

1

SENSe[1|2]:FUNCtion:FAULt

:CONNector [:IMMediate] command only

Forces a connector verification measurement on the alternate channel.

(For use with SRL measurements on analyzers with Option 100 only.)

1. For use with the 8712ES and 8714ES models only.

Programmer’s Guide 11-51

SCPI Command Summary

SCPI Device Command Summary

Table 11-19 SENSe (15 of 16)

SUBSYSTEM COMMANDS

SENSe[1|2]:FUNCtion:SRL

:<num>,<num>

1

FORM DESCRIPTION

NR1,NR1 Specifies that the receiver will measure the ratio of the power (SRL) into the specified measurement channel

2

.

For 8712ET/8714ET models—choose

1,0 (Forward A/R).

For 8712ES/8714ES models—choose

1,0 (Forward A/R), or 22, 20 (Reverse

B/R).

SENSe[1|2]:FUNCtion:SRL

:IMPedance <num>

1

NR2

Sets the cable impedance.

2

SENSe[1|2]:FUNCtion:SRL

:MODE <char>

CHAR Sets the auto z function to AUTO or

MANual

.

2

Starts a cable scan.

2

SENSe[1|2]:FUNCtion:SRL

:SCAN[:IMMediate] command only

CHAR SENSe[1|2]:ROSCillator

:SOURce <char>

Specifies the source of the reference oscillator — select INTernal or

EXTernal .

SENSe[1|2]:STATe <ON|OFF>

3

NR1 Turns the specified channel on/off .

1. Numeric parameters may include an appropriate suffix; if no suffix is included, the default (H Z for frequency or S for time) is assumed.

2. For use with structural return loss measurements on analyzers with Option 100 only.

3. Binary parameters accept the values of 1 (on) and 0 (off) in addition to ON and OFF .

11-52 Programmer’s Guide

SCPI Command Summary

SCPI Device Command Summary

Table 11-19 SENSe (16 of 16)

SUBSYSTEM COMMANDS FORM DESCRIPTION

SENSe[1|2]:SWEep:POINts <num> NR1 Sets the number of data points for the measurement — choose from

3|5|11|21|51|101|201|401|8

01|1601 .

SENSe[1|2]:SWEep:TIME <num>

SENSe[1|2]:SWEep:TIME:AUTO

<ON|OFF|ONCE>

2

1

NR3

CHAR or

NR1

CHAR

Sets the sweep time.

Turns the automatic sweep time function on/off.

SENSe:SWEep:TRIGger:SOURce

<char>

SENSe[1|2]:WINDow[:TYPE] <char> CHAR

Sets the trigger source for each point in a sweep — choose

IMMediate or EXTernal (used in conjunction with

TRIGger[:SEQuence]:SOURce ).

Sets the window selection for fault location measurements.

Choose from RECTangular

(Minimum), HAMMing (Medium), or KBESsel (Maximum). (For use with fault location measurements on analyzers with

Option 100 only.)

1. Numeric parameters may include an appropriate suffix; if no suffix is included, the default (H Z for frequency or S for time) is assumed.

2. Binary parameters accept the values of 1 (on) and 0 (off) in addition to ON and OFF

S

21

.

Programmer’s Guide 11-53

SCPI Command Summary

SCPI Device Command Summary

Table 11-20 SOURce

DESCRIPTION

SUBSYSTEM COMMANDS FORM

SOURce[1|2]:POWer[:LEVel]

[:IMMediate][:AMPLitude]<num>

SOURce:POWer:PRESet <num>

1

NR3

NR3

Sets the RF power output from the source.

Sets the power level that the analyzer will always return to after an instrument preset.

SOURce[1|2]:POWer:RANGe <char> CHAR Specifies the power sweep range.

Choose from ATTen0

|ATTen10|ATTen20|ATTen30

|ATTen40 |ATTen50|ATTen60 .

SOURce[1|2]:POWer:STARt <num> NR3

NR3

Sets the power sweep start power.

Sets the power sweep stop power.

SOURce[1|2]:POWer:STOP <num>

1. Numeric parameters may include an appropriate suffix; if no suffix is included, the default ( HZ for frequency or S for time) is assumed.

11-54 Programmer’s Guide

SCPI Command Summary

SCPI Device Command Summary

Table 11-21 STATus (1 of 4)

DESCRIPTION

SUBSYSTEM COMMANDS FORM

STATus:DEVice:CONDition?

STATus:DEVice:ENABle <num>

STATus:DEVice[:EVENt]?

STATus:DEVice:NTRansition <num>

STATus:DEVice:PTRansition <num>

STATus:OPERation:AVERaging

:CONDition?

query only

NR1

NR1 query only

NR1

NR1

NR1 query only

NR1

Reads the Device Status condition register.

1

Sets and queries bits in the

Device Status enable register.

2

Reads and clears the Device

Status event register.

1

Sets and queries bits in the

Device Status negative transition register.

2

Sets and queries bits in the

Device Status positive transition register.

2

Reads the Averaging status condition register.

1

STATus:OPERation:AVERaging:

ENABle <num>

STATus:OPERation:AVERaging

[:EVENt]?

NR1 query only

NR1

Sets and queries bits in the

Averaging status enable register.

2

Reads and clears the Averaging status event register.

1

STATus:OPERation:AVERaging

:NTRansition <num>

NR1 Sets and queries bits in the

Averaging status negative transition register.

2

1. Returns the sum of the decimal weights (2 n

where n is the bit number) of all bits currently set. For more information on using the status registers, refer to

Chapter

5, “Using Status Registers.”

2.

<num> is the sum of the decimal weights of all bits to be set.

Programmer’s Guide 11-55

SCPI Command Summary

SCPI Device Command Summary

Table 11-21 STATus (2 of 4)

DESCRIPTION

SUBSYSTEM COMMANDS FORM

STATus:OPERation:AVERaging

:PTRansition <num>

STATus:OPERation:CONDition?

STATus:OPERation:ENABle

<num>

STATus:OPERation[:EVENt]?

STATus:OPERation:MEASuring

:CONDition?

STATus:OPERation:MEASuring

:ENABle <num>

STATus:OPERation:MEASuring

[:EVENt]?

NR1 query only

NR1

NR1 query only

NR1 query only

NR1

NR1 query only

NR1

Sets and queries bits in the

Averaging status positive transition register.

1

Reads the Operational status condition register.

2

Sets and queries bits in the

Operational status enable register.

1

Reads and clears the Operational status event register.

2

Reads the Measuring status condition register.

2

Sets and queries bits in the

Measuring status enable register.

1

Reads and clears the Measuring status event register.

2

STATus:OPERation:MEASuring

:NTRansition <num>

STATus:OPERation:MEASuring

:PTRansition <num>

NR1

NR1

Sets and queries bits in the

Measuring status negative transition register.

1

Sets and queries bits in the

Measuring status positive transition register.

1

1.

<num> is the sum of the decimal weights of all bits to be set.

2. Returns the sum of the decimal weights (2 n

where n is the bit number) of all bits currently set. For more information on using the status registers refer to

Chapter

5, “Using Status Registers.”

11-56 Programmer’s Guide

SCPI Command Summary

SCPI Device Command Summary

Table 11-21 STATus (3 of 4)

DESCRIPTION

SUBSYSTEM COMMANDS FORM

STATus:OPERation:NTRansition

<num>

STATus:OPERation:PTRansition

<num>

STATus:PRESet

NR1

NR1 command only

Sets and queries bits in the

Operational Status negative transition register.

1

Sets and queries bits in the

Operational Status positive transition register.

1

Sets bits in most enable and transition registers to their default state.

Reads the Questionable Status condition register.

2

STATus:QUEStionable:CONDition?

query only

NR1

STATus:QUEStionable:ENABle <num> NR1

STATus:QUEStionable[:EVENt]?

STATus:QUEStionable:LIMit

:CONDition?

query only

NR1 query only

NR1

Sets and queries bits in the

Questionable Status enable register.

1

Reads and clears the

Questionable Status event register.

2

Reads the Limit Fail condition register.

2

1.

<num> is the sum of the decimal weights of all bits to be set.

2. Returns the sum of the decimal weights (2 n

where n is the bit number) of all bits currently set. For more information on using the status registers refer to

Chapter 5,

“Using Status Registers.”

Programmer’s Guide 11-57

SCPI Command Summary

SCPI Device Command Summary

Table 11-21 STATus (4 of 4)

DESCRIPTION

SUBSYSTEM COMMANDS FORM

STATus:QUEStionable:LIMit:

ENABle <num>

STATus:QUEStionable:LIMit

[:EVENt]?

STATus:QUEStionable:LIMit

:NTRansition <num>

STATus:QUEStionable:LIMit

:PTRansition <num>

NR1 query only

NR1

NR1

NR1

Sets and queries bits in the Limit

Fail enable register.

1

Reads and clears the Limit Fail event register.

2

Sets and queries bits in the Limit

Fail negative transition register.

1

Sets and queries bits in the Limit

Fail positive transition register.

1

STATus:QUEStionable:NTRansition

<num>

STATus:QUEStionable:PTRansition

<num>

NR1

NR1

Sets and queries bits in the

Questionable Status negative transition register.

1

Sets and queries bits in the

Questionable Status positive transition register.

1

1.

<num> is the sum of the decimal weights of all bits to be set.

2. Returns the sum of the decimal weights (2 n

where n is the bit number) of all bits currently set. For more information on using the status registers refer to

Chapter 5,

“Using Status Registers.”

11-58 Programmer’s Guide

SCPI Command Summary

SCPI Device Command Summary

Table 11-22 SYSTem (1 of 8)

DESCRIPTION

SUBSYSTEM COMMANDS FORM

SYSTem:BEEPer[:IMMediate]

[<freq>[,<dur>[,<vol>]

1

SYSTem:BEEPer:VOLume <num>

NR3, NR3,

NR3

NR2

Instructs the analyzer to beep.

Arguments are frequency (Hz), duration (seconds), and volume

(0 to 1).

Sets the volume of the beeper

— num is a number between 0 for 0% and 1 for 100%.

Makes the analyzer the system controller.

SYSTem:COMMunicate:GPIB

:CONTroller[:STATe]<ON|OFF>

2,3

NR1

SYSTem:COMMunicate:GPIB:ECHO

<ON|OFF>

2

NR1 Turns GPIB mnemonic echo on/off .

SYSTem:COMMunicate:GPIB:HCOPy

:ADDRess <num>

SYSTem:COMMunicate:GPIB[:SELF]

:ADDRess <num>

4

NR1

NR1

Sets the address of an GPIB printer or plotter for hardcopy output — num must be an integer between 0 and 30.

Sets the analyzer's GPIB address — num must be an integer between 0 and 30.

SYSTem:COMMunicate:LAN:BOOTp

:HOST <string>

SYSTem:COMMunicate:LAN:BOOTp

:STATE <OFF|0|ON|1>

STRING

NR1

Sets the host name or host IP address of the remote host that receives the BOOTP requests.

Sets a BOOTP request when the analyzer boots up.

1. <freq>, <dur>, and <vol> are optional <num> parameters.

2.

Binary parameters accept the values of 1 (on) and 0 (off) inaddition to ON and

OFF .

3. For use with IBASIC—this command cannot be executed from an external controller.

4. A delay of 5 seconds is required before a command is sent to the new address.

Programmer’s Guide 11-59

SCPI Command Summary

SCPI Device Command Summary

Table 11-23 SYSTem (2 of 8)

DESCRIPTION

SUBSYSTEM COMMANDS FORM

SYSTem:COMMunicate:LAN:BOOTp

:TIMeout

#1~MAX_AUTO_CAL_TIME[S]#

SYSTem:COMMunicate:LAN:BOOTp

:TRANsfer:FILE:NAME <string>

NR1

STRING

SYSTem:COMMunicate:LAN:BOOTp

:TRANsfer:FTP:PASSword-?

<string>

SYSTem:COMMunicate:LAN:BOOTp

:TRANsfer:FTP:USERname

<string>

SYSTem:COMMunicate:LAN:BOOTp

:TRANsfer:METHod <TFTP|FTP>

SYSTem:COMMunicate:LAN:EADDres s?

SYSTem:COMMunicate:LAN:IPADdre ss <string>

SYSTem:COMMunicate:LAN:LOGin

:USER:ADD-? <string>,<string>

SYSTem:COMMunicate:LAN:LOGin

:USER:DELETE-?

<string>,<string>

SYSTem:COMMunicate:LAN:LOGin

:USER:LIST:COUNt?

SYSTem:COMMunicate:LAN:LOGin

:USER:LIST:NAME? #1-7

SYSTem:COMMunicate:LAN:NFS

:AUTHentiation:ID:GROup

#0~4.74836e+07# command only

STRING

NR1 query only

STRING

STRING command only command only query only

NR1 query only

STRING

NR2

Sets the number of seconds the analyzer will retry the BOOTP requests at boot time.

Sets the path file name of the boot file you want to receive at boot time.

Selects the password of the remote

BOOTP host.

Selects the user name of the remote BOOTP host.

Selects TFTP as the file transfer program.

Queries the analyzer's ethernet address.

Sets the analyzer's Internet

Protocol address.

Selects the login user/password pairs.

Deletes the login user/password pairs.

Queries login user names.

Queries user name.

Selects the NFS remote file system for entering a Group ID.

11-60 Programmer’s Guide

SCPI Command Summary

SCPI Device Command Summary

Table 11-24 SYSTem (3 of 8)

DESCRIPTION

SUBSYSTEM COMMANDS FORM

SYSTem:COMMunicate:LAN:NFS

:AUTHentiation:ID:USER

#0~4.74836e+07#

SYSTem:COMMunicate:LAN:NFS

:AUTOmount:ADD-?

<string>,<string>,<string>

SYSTem:COMMunicate:LAN:NFS

:AUTOmount:LIST:COUNt?

SYSTem:COMMunicate:LAN:NFS

:AUTOmount:LIST:LOCFilesys? #1-7

SYSTem:COMMunicate:LAN:NFS

:AUTOmount:LIST:REMFilesys? #1-7

SYSTem:COMMunicate:LAN:NFS

:AUTOmount:LIST:REMHost? #1-7

NR2 command only

SYSTem:COMMunicate:LAN:NFS

:AUTOmount:REMove-? <string>

SYSTem:COMMunicate:LAN:NFS

:MOUNT-?

<string>,<string>,<string>

SYSTem:COMMunicate:LAN:NFS

:MOUNT:LIST:COUNt?

SYSTem:COMMunicate:LAN:NFS

:MOUNT:LIST:LOCFilesys? #1-7

SYSTem:COMMunicate:LAN:NFS

:MOUNT:LIST:REMFilesys? #1-7

Selects the NFS remote file system for entering a User ID.

Sets the mounted NFS device to the automount device table.

query only

NR1 query only

STRING query only

STRING query only

STRING

Selects the number of NFS devices in Automount list.

Selects the local file system name for an NFS device.

Queries the automount list.

command only command only query only

NR1 query only

STRING

STRING

Queries the remote host name

(or host IP address) for an NFS device.

Removes device from automount list.

Selects the remote host, file system, and local system name for an NFS device.

Queries the number of currently mounted NFS devices.

Queries the local file system name.

Selects the remote host file system name for an NFS device.

Programmer’s Guide 11-61

SCPI Command Summary

SCPI Device Command Summary

Table 11-23 SYSTem (4 of 8)

SYSTem:COMMunicate:LAN:SICL

:GPIB:ADDRess #0~20, 22~30#

SYSTem:COMMunicate:LAN:SICL

:GPIB:LU #0~1024#

SYSTem:COMMunicate:LAN:SICL

:GPIB:NAME <string>

NR1

NR1

STRING

DESCRIPTION

SUBSYSTEM COMMANDS FORM

SYSTem:COMMunicate:LAN:NFS

:MOUNT:LIST:REMHost? #1-7

SYSTem:COMMunicate:LAN:NFS

:UNMount-? <string>

SYSTem:COMMunicate:LAN:PRINter

:HOSTname <string>

SYSTem:COMMunicate:LAN:ROUTe

:GATeway <string>

SYSTem:COMMunicate:LAN:ROUTe

:SMASk <string>

SYSTem:COMMunicate:LAN:SCPI

:SOCKet:PORT <num>

STRING

NONE

STRING

STRING

STRING

NR1

Selects the remote host name (or host IP address) for an NFS device.

Selects the NFS device table.

Specifies the IP address of the LAN printer.

Sets the IP address for a LAN gateway.

Sets the subnet mask.

Selects the port number for a socket connection to the analyzer for SCPI socket programming.

Sets the GPIB address for SICL

LAN.

Sets the GPIB logical unit number for SICL LAN.

Sets the GPIB name for SICL LAN.

11-62 Programmer’s Guide

SCPI Command Summary

SCPI Device Command Summary

Table 11-23 SYSTem (5 of 8)

DESCRIPTION

SUBSYSTEM COMMANDS FORM

SYSTem:COMMunicate:SERial

:TRANsmit:BAUD <num>

SYSTem:COMMunicate:SERial

:TRANsmit:HANDshake <char>

NR1

CHAR

Sets the baud rate for hardcopy output to a device on the serial port

— choose from

1200|2400|4800|9600|19200 .

Sets the handshake for communication to a hardcopy device on the serial port — choose XON or

DTR .

SYSTem:COMMunicate:TTL:USER:

FEED <char>

SYSTem:DATE

<num1>,<num2>,<num3>

SYSTem:ERRor?

1

CHAR

NR1,

NR1,

NR1 query only

NR1,

STRING command

only

Selects the function of the USER

TTL IN/OUT port on the rear panel of the analyzer. Choose from

DEFault|KEY|SWEep .

Sets the year ( and day ( clock.

num3 num1 ), month ( num2

) of the real time

Queries the error queue — returns the error number and message.

SYSTem:KEY <char> Sends key names

2

which execute the same functions as front panel keys.

1. For more information on errors, refer to

Chapter 13, “SCPI Error Messages.”

2. A list analyzer front panel key codes is provided in

Chapter 8, “Front Panel Keycodes.”

)

Programmer’s Guide 11-63

SCPI Command Summary

SCPI Device Command Summary

Table 11-23 SYSTem (6 of 8)

DESCRIPTION

SUBSYSTEM COMMANDS FORM

SYSTem:KEY:MASK?

query only

NR1

Queries the mask (shift, ctrl, alt) associated with a keypress on an external keyboard.

Clears the key queue.

SYSTem:KEY:QUEue:CLEar

SYSTem:KEY:QUEue:COUNt?

command only query only

NR1

SYSTem:KEY:QUEue:MAXimum?

query only

NR1

Queries the number of key codes in the queue.

Queries the size of the key queue (the maximum number of key codes it can hold).

Turns on/off the key queue.

SYSTem:KEY:QUEue[:STATe]

1

<ON|OFF>

NR1

SYSTem:KEY:TYPE?

SYSTem:KEY:USER

SYSTem:KEY[:VALue]?

query only

CHAR command only query only

NR1

Queries the type of key that was pressed

— returns NONE , RPG , KEY (front panel key) or ASC (external keyboard).

Sets the User Request bit of the

Standard Event Status Register.

Queries the key code value for the last key pressed — RPG type returns the knob count, positive for clockwise rotation, KEY type returns the front panel keycode,

2

and ASC type returns the ASCII code number.

1. Binary parameters accept the values of 1 (on) and 0 (off) in addition to ON and OFF .

2. A list of the analyzer's front panel keycodes and key names is provided in

Chapter

8, “Front Panel Keycodes.”

11-64 Programmer’s Guide

SCPI Command Summary

SCPI Device Command Summary

Table 11-23 SYSTem (7 of 8)

DESCRIPTION

SUBSYSTEM COMMANDS FORM

SYSTem:PRESet

SYSTem:SET <block>

SYSTem:SET:LRN? [<USER>]

1

SYSTem:SET:LRNLong? [<USER>]

1

command only command only

BLOCK

BLOCK

Performs a system preset — this is the same as the front panel PRESET key.

Sends a learn string (obtained using *LRN?

) to the analyzer

— this command is included in the learn string.

Queries or set the instrument state.

Queries or set the instrument state, data, and calibration.

Similar to save/recall.

SYSTem:TIME <num1>,<num2>,<num3>

SYSTem:VERSion?

NR1, NR1,

NR1 query only

NR2

Sets the hour ( num1 ), minute

( num2 ) and second ( num3 ) of the real time clock.

Queries the SCPI version of the analyzer. See *IDN?

to query the firmware revision.

1. Refer to "Automated Measurement Setup and Control" in Chapter 7 of the User's

Guide for more information on using this command.

Programmer’s Guide 11-65

SCPI Command Summary

SCPI Device Command Summary

Table 11-24 SYSTem (8 of 8)

SUBSYSTEM COMMANDS

TEST:RESult?

TEST:SELect <num>

TEST:STATe <char>

TEST:VALue <num>

NR1

CHAR

NR1

DESCRIPTION

FORM query only

CHAR

Queries the result of the selected adjustment or self-test — the response will be

NULL|PASS|FAIL .

Selects the adjustment or self-test to execute.

Selects the state of the active adjustment or self-test — choose from RUN|CONTinue|STOP for the command. Query returns

NULL|RUN|PAUS|DONE .

Sets or queries a value for an adjustment or self-test.

11-66 Programmer’s Guide

SCPI Command Summary

SCPI Device Command Summary

Table 11-25 TRACe (1 of 2)

SUBSYSTEM COMMANDS FORM DESCRIPTION

TRACe[:DATA]? <char> query only

BLOCK or NR3

1

Queries trace data — choose from the following array types:

CH<1|2>FDATA

CH<1|2>FMEM

Formatted data

2

Formatted memory data

2

CH<1|2>SDATA

CH<1|2>SMEM

Unformatted data

3

Unformatted memory data

3

CH<1|2><A|B|R>FWD Raw data

CH<1|2>SCORR<X> Two-port error correction terms.

Choose X from the list below:

Array choices for two-port error correction

1 Forward directivity

2 Forward source matching

3 Forward reflection tracking

4 Forward transmission tracking

5 Forward load matching

6 Forward isolation

7

8

9

10

11

12

Reverse directivity

Reverse source matching

Reverse reflection tracking

Reverse transmission tracking

Reverse load matching

Reverse isolation

1. The parameter type of the data is determined by the format selected — FORMat

REAL uses BLOCK data, FORMat ASCii uses NR3 data separated by commas.

2. Single magnitude value for each measured point.

3. Corrected data in real/imaginary pairs for each measured point.

Programmer’s Guide 11-67

SCPI Command Summary

SCPI Device Command Summary

Table 11-25 TRACe (2 of 2)

SUBSYSTEM COMMANDS

TRACe[:DATA] <char>,<data>

TRACe[:DATA] <char1>,<char2>

FORM command only command only

DESCRIPTION

Inputs trace data — choose from the above list of arrays. The data can be either BLOCK or NR3 type.

1

Note: See

Chapter 6

for more information.

Moves data from one internal array to another — char1 is the target array ( CH<1|2>SMEM ) while char2 is the source array

( CH<1|2>SDATA ). Note that the source and target arrays must be from the same measurement channel.

TRACe:CORRection:SIMulate

[:DATA] {STD1|STD2|...|STD12} command only

Reads simulated calibration standards. Loads pre-computed or stored measurements of calibration standards from a remote controller into the analyzer.

2

Computes cal error correction arrays.

TRACe:CORRection:SIMulate:SAVE

<TRAN1|TRAN2|TRAN3|REFL3|TESTset|

TESTset1|TESTset2|VERIFY||TWOPort

|NONE> command only

1.

The parameter type of the data is determined by the format selected — FORMat REAL uses

BLOCK data, FORMat ASCii uses NR3 data separated by commas.

2.

See the example program titled “SIMCAL.” This program demonstrates how to create 2-port correction arrays from measurements of the raw (uncorrected) calibration standards when using the analyzer’s simcal command.

Example programs can be found in the following four locations:

• Example Programs Disk, 8712ET/ES and 8714ET/ES (DOS format): part number

08714-10003

• Example Programs Disk, 8712ET/ES and 8714ET/ES (LIF format): part number 08714-10004

• Web site http://www.agilent.com. Use the search function to find Web pages related to

8712 example programs.

Example Programs Guide, 8712ET/ES and 8714ET/ES: part number 08714-90016

11-68 Programmer’s Guide

SCPI Command Summary

SCPI Device Command Summary

Table 11-26 TRIGger

SUBSYSTEM COMMANDS FORM DESCRIPTION

TRIGger[:SEQuence]:SOURce <char> CHAR Sets the source for the sweep trigger signal — choose IMMediate or EXTernal (used in conjunction with

SENSe:SWEep:TRIGger:SOURce ).

Programmer’s Guide 11-69

12 SCPI Conformance Information

12-1

advertisement

Key Features

  • Frequency range: 9 kHz to 1.8 GHz
  • Dynamic range: >120 dB
  • Sweep speed: up to 200 sweeps/s
  • Multiple measurement modes: scalar, vector, and time domain
  • Built-in signal generator and power meter
  • GPIB and LAN interfaces for remote control and data transfer

Related manuals

Frequently Answers and Questions

What is the frequency range of the 8712ES?
The frequency range of the 8712ES is 9 kHz to 1.8 GHz.
What is the dynamic range of the 8712ES?
The dynamic range of the 8712ES is >120 dB.
What is the sweep speed of the 8712ES?
The sweep speed of the 8712ES is up to 200 sweeps/s.
What measurement modes does the 8712ES support?
The 8712ES supports scalar, vector, and time domain measurement modes.
Does the 8712ES have a built-in signal generator?
Yes, the 8712ES has a built-in signal generator.
Does the 8712ES have a built-in power meter?
Yes, the 8712ES has a built-in power meter.
What interfaces does the 8712ES have?
The 8712ES has GPIB and LAN interfaces.
Download PDF

advertisement

Table of contents