Agilent 8703B Programming Manual

Download

Page 1

Agilent 8703B Lightwave Component Analyzer

Programmer’s Guide

Page 2

Agilent Part No. 08703- 90 20 2 Printed in USA July 2001

Agilent Technologies Lightwave Division 3910 Brickway BoulevardSanta Rosa, CA 95403, USA

Notice.

The information contained in this document is subject to change without notice. Companies, names, and data used in examples herein are fictitious unless otherwise noted. Agilent Technologies makes no warranty of any kind with regard to this material, including but not limited to, the implied warranties of merchantability and fitness for a particular purpose. Agilent Technologies shall not be liable for errors contained herein or for incidental or consequential damages in connection with the furnishing, performance, or use of this material.

Restricted Rights Legend.

Use, duplication, or disclosure by the U.S. Government is subject to restrictions as set forth in subparagrap h (c) (1 ) (i i) of the Rights in Technical Data and Computer Software clause at DFARS 252.227-7013 for DOD agencies, and subparagraphs (c) (1) and (c) (2) of the Commercial Computer Software Restricted Rights clause at FAR 52.227-19 for other agencies.

Warranty.

This Agilent Technologies instrument product is warranted against defects in material and workmanship for a period of one yea r fro m date of shipment. During the warranty period, Agilent Technologies will, at its option, either repair or replace products which prove to be defective. For warranty service or repair, this product must be returned to a service facility designated by Agilent Technologies. Buyer shall prepay shipping charges to Agilent Technologies and Agilent Technologies shall pay shipping charges to return the product to Buyer. However, Buyer shall pay all shipping charges, duties, and taxes for products returned to Agilent Technologies from another country.

Agilent Technologies warrants that its software and firmware designated by Agilent Technologies for use with an instrument will execute its programming instructions when properly installed on that instrument. Agilent Technologies does not warrant that the operation of the instrument, or software, or firmware will be uninterrupted or error-free.

Limitation of Warranty.

The foregoing warranty shall not apply to defects resulting from improper or inadequate maintenance by Buyer, Buyer-supplied software or interfacing, unauthorized modification or misuse, operation outside of the environmental specifications for the product, or improper site preparation or maintenance.

No other warranty is expressed or implied. Agilent Technologies specifically disclaims the implied warranties of merchantability and fitness for a particular purpose.

Exclusive Remedies.

The remedies provided herein are buyer's sole and exclusive remedies. Agilent Technologies shall not be liable for any direct, indirect, special, incidental, or consequential damages, whether based on contract, tort, or any other legal theory.

Safety Symbols.

CAUTION The caution sign denotes a

hazard. It calls attention to a procedure which, if not correctly performed or adhered to, could result in damage to or destruction of the product. Do not proceed beyond a caution sign until the indicated conditions are fully understood and met.

WARNING The warning sign denotes a

hazard. It calls attention to a procedure which, if not correctly performed or adhered to, could result in injury or loss of life. Do not proceed beyond a warning sign until the indicated conditions are fully understood and met.

The instruction manual symbol. The product is marked with this warning symbol when it is necessary for the user to refer to the instructions in the manual.

The laser radiation symbol. This warning symbol is marked on products which have a laser output.

The AC symbol is used to indicate the required nature of the line module input power.

| The ON symbols are

used to mark the positions of the instrument power line switch.

❍ The OFF symbols

are used to mark the positions of the instrument power line switch.

The CE mark is a registered trademark of the European Community.

The CSA mark is a registered trademar k of the Canadian Standards Association.

The C-Tick mark is a registered trademark of the Australian Spectrum Management Agency.

This text denotes the

ISM1-A

instrument is an Industrial Scientific and Medical Group 1 Class A product.

Typographi ca l C on ve nt io ns .

The following conventions are used in this book:

Key type for keys or text lo cated on the keyboard or ins tr ume nt.

Softkey type for key names that are displayed on the instrument’s screen.

Display type for words or

characters displayed on the computer’s screen or instrument’s display.

User type for words or charac-

ters that you type or enter. Emphasis type for words or

characters that emphasize some point or that are used as place holders for text that you type.

Page 3

1. Alphabetical Command Reference

Alphabetical Command Reference 1-2 Symbol Conventions 1-3 Keys to Programming Commands 1-4 Programming Commands 1-15 PAUS 1-56 8703A Commands Not Supported in the 8703B 1-79

2. Command Listings

Alphabetical List of Commands 2-2 OPC-Compatible List of Commands 2-4

3. Introduction to Instrument Control

Introduction to Instrument Control 3-2 Instrument Control using the VXIplug&play Driver 3-3 Instrument Control using HP BASIC 3-9

4. GPIB Programming

GPIB Programming 4-2 Analyzer Command Syntax 4-3 Analyzer Operation 4-7 GPIB Operation 4-8 Calibration 4-19 Display Graphics 4-22 Disk File Names 4-25

5. Reading Analyzer Data

Reading Analyzer Data 5-2 Output Queue 5-3 Command Query 5-3 Identification 5-3 Output Syntax 5-4 Marker Data 5-5 Array-Data Formats 5-7 Trace-Data Transfers 5-8 Stimulus-Related Values 5-9

6. Data Processing Chain

Data Processing Chain 6-2 Data Arrays 6-2 Common Output Commands 6-3 Fast Data Transfer Commands 6-4 Data Levels 6-4 Learnstring and Calibration-Kit String 6-5

7. Error Reporting

Error Reporting 7-2

Contents-1

Page 4

Contents

Status Reporting 7-3 The Status Byte 7-6 The Event-Status Register and Event-Status Registers B and L 7-7 Error Output 7-8 Error Messages in Numerical Order 7-9

8. Programming Examples

Example Programs 8-2 Measurement Process 8-3 Programming Examples 8-5 Measurement Setup Examples 8-9 Measurement Calibration Examples 8-26 Measurement Data Transfer Examples 8-63 Measurement Process Synchronization Examples 8-74 Analyzer System Setup Examples 8-84 List-Frequency and Limit-Test Table Examples 8-92 Report Generation Examples 8-106 Limit Line and Data Point Special Functions 8-125

9. Preset State and Memory Allocation

Preset State and Memory Allocation 9-2 Preset State 9-3 Memory Allocation 9-13

Contents-2

Page 5

Alphabetical Command Reference 1-2 Keys to Programming Commands 1-4 Programming Commands 1-15 8703A Commands Not Supported in the 8703B 1-79

Alphabetical Command Reference

Page 6

Alphabetical Command Reference Alphabetical Command Reference

Alphabetical Command Reference

In this chapter, you can find an alphabetical list and brief descriptions of the supported commands for controlling the Agilent 8703B remotely.

NOTE Some commands have a range of values associated with them. If you send a

value that is beyond the analyzer’s capability, the analyzer will default to the closest allowed value. Refer to the individual commands for the specific range of values allowed.

1-2

Page 7

Alphabetical Command Reference

Symbol Conventions

<num> Required numerical data.

<choice1|choice2|…|choicen> An appendage that is part of the command. For example,

FORMAT<DOS|LIF> indicates that the actual commands are FORMATDOS and FORMATLIF.

<$> Indicates a character string operand which must be

enclosed by double quotes.

| An either/or choice in an appendage or optional data.

[ ] Optional data.

A terminator indicates the end of a command string, and this manual uses a semicolon as the terminator in all syntax examples. The analyzer also interprets line feeds and GPIB end or identify (EOI) messages as terminators.

Terminators are not necessary for the analyzer to interpret commands correctly, however in the case of a syntax error, the analyzer will attempt to recover at the next terminator. Therefore, it is recommended that you conclude each command with a terminator.

Because this chapter is an “Alphabetical Command Reference,” the commands have been listed alphabetically, rather than by function, in both the “Syntax” sections and the “Description ” sections. Therefore, commands grouped together in the “Syntax” sections, are grouped alphabetically and/or due to common syntax form, not necessarily due to common functionality.

The softkeys listed in the “Front Panel Equivalents” tables may not be in the first menu viewed when the associated hardkey is pressed. In many cases, more than one key press will be required to locate the softkey. Refer to your analyzer’s reference guide for the exact location of any softkey.

Some commands that do not have an associated query syntax can be queried by sending the command (without a value) and then sending the OUTPACTI command, as in the following example that queries the segment power value:

10 OUTPUT 716;”SEGPOWER;OUTPACTI;”

Many of the commands that do have a listed query syntax can also be queried in this manner.

1-3

Page 8

Alphabetical Command Reference Keys to Programming Commands

Keys to Programming Commands

Table 1-1. Front Panel Equivalents (1 of 11)

Hardkey Softkey Command

Avg AVERAGING FACTOR AVERFACT

AVERAGING <ON |OFF> AVERO <ON|OFF> AVERAGING RESTART AVERREST IF BW [ ] IFBW SMOOTHING APERTURE SMOOAPER

SMOOTHING ON OFF SMOOO <ON|OFF> Cal ISOLATION ISOL Cal ALTERNATE A and B ALTAB Cal ALTERNATE RFL/TRAN ALTAB Cal CORRECTION ON OFF CORR Cal DEFINE STANDARD DEFS Cal DONE 1-PORT CAL SAV1 Cal DONE 2-PORT CAL SAV2 Cal DONE RESP ISOL’N CAL RAID Cal DONE: DONE Cal DONE: RESPDONE Cal EXTENSION PORT 1 PORT1 Cal EXTENSION PORT 2 PORT2 Cal EXTENSIONS ON OFF PORE Cal FULL 2-PORT CALIFUL2 Cal FWD ISOL’N FWDI Cal FWD MA TCH FWDM Cal FWD TRA NS FWDT Cal INTERPOL ON OFF CORI Cal ISO L’N STD RAIISOL Cal ISOLATION DONE ISOD Cal MAXIMUM FREQUENCY MAXF Cal OMIT ISOLATION OMII

1-4

Page 9

Alphabetical Command Reference

Keys to Programming Commands

Table 1-1. Front Panel Equivalents (2 of 11)

Hardkey Softkey Command

Cal REFLECTION REFL Cal RESPONSE CALIRESP Cal RESPONSE RAIRESP Cal RESPON SE & IS OL’N CALIRAI Cal Respons e & Match (E/O) CA LIEORM Cal Response & Match (O/E) CALIOERM Cal Response & Match: Done RAMD Cal RESUME CA L SEQUENCE RESC Cal REV ISOL’NREVI Cal REV MATCH REVM Cal REV TRAN S REVT Cal S11 1-PORT CALIS111 Cal S11A CLASS11A Cal S11B CLASS11B Cal S11C CLASS11C Cal S22 1-PORT CALIS221 Cal S22A CLASS22A Cal S22A CLASS22B Cal S22A CLASS22C Cal SET Z0 SETZ Cal SLIDING LOAD DONE SLID Cal SPECIFY CLASS DONE CLAD Cal standard listed under softkey 1 STANA Cal standard listed under softkey 2 STANB Cal standard listed under softkey 3 STANC Cal standard listed under softkey 4 STAND Cal standard listed under softkey 5 STANE Cal standard listed under softkey 6 STANF Cal standard listed under softkey 7 STANG Cal STANDARDS DONE REFD Cal STANDARDS DONE TRAD

1-5

Page 10

Alphabetical Command Reference Keys to Programming Commands

Table 1-1. Front Panel Equivalents (3 of 11)

Hardkey Softkey Command

Cal TESTS ET SW n Sweeps TSSWIn Cal TRANSMISSN TRAN Cal VELOCITY FACTOR VELOFACT Center CENT Chan 1 N/A CHAN1 Chan 2 N/A CHAN2 Chan 3 N/A CHAN3 Chan 4 N/A CHAN4 Copy LINE TYPE DATA LINTDATA

LINE TYPE MEMORY LINTMEMO

LIST VALUES LISV

NEXT PAGE NEXP

OP PARAMS O PE P

PLOT PLOT

RESTORE DISPLAY RESD

1-6

Page 11

Table 1-1. Front Panel Equivalents (4 of 11)

Hardkey Softkey Command

Display 2x:[1&2][3&4] D2XUPCH2

2x:[1&3][2&4] D2XUPCH3 4x:[1][2][3][4] D4XUPCH2 4x:[1][3][2][4] D4XUPCH3 AUX CHAN ON OFF AUXC <ON|OFF> BACKGROUND INTENSITY BACI BEEP DONE ON OFF BEEPDONE <ON|OFF> BEEP FAIL ON OFF BEEPFAIL <ON|OFF> BEEP WARN ON OFF BEEPWARN <ON|OFF> BRIGHTNESS CBRI DATA ->MEMORY DATI

Alphabetical Command Reference

Keys to Programming Commands

DATA and MEMORY DISPDATM DATA/MEM DISPDDM DATA-MEM DISPDMM DATA+MEM DISPDPM DATA*MEM DISPDTM MEM1/MEM2 DISPM1DM MEM1-MEM2 DISPM1MM MEM1+MEM2 DISPM1PM MEM1*MEM2 DISPM1TM MEM2/MEM1 DISPM2DM MEM2-MEM1 DISPM2MM MEM/DATA DISPMDD MEM-DATA DISPMMD MATH->MEM MATI MEM1->MEM2 MEM1I MEM2->MEM1 MEM2I DEFAULT COLORS DEFC DISPLAY: DATA DISPDATA DUAL CHAN ON OFF DUAC <ON|OFF> FREQUENCY BLANK FREO INTENSITY INTE

1-7

Page 12

Alphabetical Command Reference Keys to Programming Commands

Table 1-1. Front Panel Equivalents (5 of 11)

Hardkey Softkey Command

down N/A D OWN Entry Off N/A ENTO Format DELAY DELA

IMAGINARY IMAG

LIN MAG LINM

LOG MAG LOGM

PHASE PHAS

POLAR POLA

REAL REAL

SMITH CHART SMIC

SWR SWR Local ADDRESS: CONTROLLER ADDRCONT

ADDRESS: DISK ADDRDISC

ADDRESS: P MTR/GPIB ADDRPOWM

DISK UNIT NUMBER DISCUNIT

GPIB DIAG ON OFF DEBU <ON|OFF>

PLTR PORT GPIB ADDRPLOT

PRNTR PORT GPIB ADDRPRIN

USE PASS CONTROL USEPASC Marker all OFF MARKOFF

D MODE OFF DELO

D REF = D FIXED MKR DELRFIXM

D REF = n DELR

FIXED MKR AUX VALUE MARKFAUV

FIXED MKR STIMULUS MARKFSTI

FIXED MKR VALUE MARKFVAL

MARKER n MARKn

1-8

MKR ZERO MARKZERO

Page 13

Table 1-1. Front Panel Equivalents (6 of 11)

Hardkey Softkey Command

Marker Fctn DISP MKRS ON OFF DISM

G + jB MKR SMIMGB POLAR LIN MKR POLMLIN SMITH LIN MKR SMIMLIN POLAR LOG MKR POLMLOG SMITH LOG MKR SMIMLOG MARKER -> CENTER MARKCENT MARKER -> DELAY MARKDELA MARKER -> SPAN MARKSPAN MARKER -> START MARKSTAR MARKER -> STOP MARKSTOP

Alphabetical Command Reference

Keys to Programming Commands

MARKERS: CONTIN UOUS MARKCONT MARKERS: COUPLED MARKCOUP MARKERS: DISCRETE MARKDISC MARKERS: UNCOUP LED MARKUNCO MEASURE: STATS MEASTAT SMITH R + jX MKR SMIMRX POLAR Re/Im MKR POLMRI SMITH Re/Im MKR SMIMRI

Marker Search BANDWIDTH MARK3DB

SEARCH LEFT SEAL SEARCH RIGHT SEAR SEARCH: MAX MARKMAXI SEARCH: MAX SEAMAX SEARCH: MIN MARKMINI SEARCH: MIN SEAMIN SEARCH: OFF SEAOFF SEARCH: TARGET SEATARG TRACKING ON OFF TRACK WIDTH VALUE WIDV WIDTHS ON OFF WIDT

1-9

Page 14

Alphabetical Command Reference Keys to Programming Commands

Table 1-1. Front Panel Equivalents (7 of 11)

Hardkey Softkey Command

Meas B MEASB

AMEASA

A/B AB

A/R AR

B/R BR

CONVERSION 1/S CONV1DS

CONVERSION OFF CONVOFF

CONVERSION Y:Ref l CONVYREF

CONVERSION Y:Tran s CONVYTRA

CONVERSION Z:Refl CO NVZREF

CONVERSION Z:Trans CONVZT RA

E/O Trans M EASEO1

O/E Trans (Port 1) MEASOE1

O/E Trans (Port 2) MEASOE2

O Refl MEASO1

O Trans MEAS001

RMEASR

Refl:FWD S11 (A/R) S11

Refl:REV S22 (B/R) S22

Trans:FWD S21 (B/R) S21

Trans:REV S12 (A/R) S12 Power N/A POWE

PORT POWER PORTP

PWR RANGE AUTO MAN PWRR <PMAN|PAUTO>

RANGE n PRAN

SOURCE PWR ON OFF SOUP <ON|OFF> Preset N/A PRES

1-10

N/A RST

Page 15

Table 1-1. Front Panel Equivalents (8 of 11)

Hardkey Softkey Command

Save/Recall CLEAR CLEAREG <01-31>

CLEAR ALL CLEARALL DATA ARRAY ON OFF EXTMDATA DATA ONLY EXTMDATO FILE NAME TITF FORMAT ARY ON OFF EXTMFORM FORMAT INT DISK INID GRAHPICS ON OFF EXTMGRAP INTERNAL DISK INTD LOAD LOAD RAW ARRAY ON OFF EXTMRAW

Alphabetical Command Reference

Keys to Programming Commands

READ FILE TITLES REFT SAVE SAVEREG SAVE FILE when GRAPH FMT [ ] is set to CSV and

FILETYPE: GRAPHIC is selected. SAVE FILE when GRAPH FMT [ ] is set to JPG and

FILETYPE: GRAPHIC is selected. SAVE USING ASCII SAVUASCI SAVE USING BINARY SAVUBINA TITLE TITREG

Scale Ref AUTOSCALE AUT O

ELECTRICAL DELAY ELED MARKER -> REFERENCE MARKREF PHASE OFFSET PHAO REFERENCE POSITI ON REFP REFERENCE VALUE REFV SCALE / DIV SCAL

Span N/A SPAN

SAVECSV

SAVEJPG

Start N/A STAR Stop N/A STOP

1-11

Page 16

Alphabetical Command Reference Keys to Programming Commands

Table 1-1. Front Panel Equivalents (9 of 11)

Hardkey Softkey Command

Sweep Setup ALL SEGS SWEEP ASEG

CONTINUOUS CONT

CONTINUOUS FRER

COUPLED CH ON OFF COUC

CW FREQ CWFREQ

CW TIME CWTIME

EXT TRIG ON SWEEP EXTTON

HOLD HOLD

LIN FREQ LINFREQ

LIST FREQ LI SFREQ

LIST IF BW ON OFF LISIFBWM

LIST POWER ON OFF LISPWRM

LIST TYPE: STEPPED LISTTYPELSTP

LIST TYPE: SWEPT LISTTYPELSWP

LOG FREQ LOGFREQ

MANUAL TRG ON POINT MANTRIG

MEASURE RESTAR T R E ST

NUMBER of GROUPS NUMG

NUMBER of POINTS POIN <NUM>

POWER SWEEP POWS

SEGMENT IF BW SEGIFBW

SEGMENT POWER SEGPOWER

SINGLE SING

SINGLE SEG SWEEP SSEG

STEP SIZE STPSIZE

SWEEP TIME AUTO SWEA

SWEEP TIME MANUAL SWET <NUM>

TRIGGER: TRIG OFF EXTTOFF

EDIT LIST EDITLIST Sweep Setup or Cal CLEAR LIST YES CLEL Sweep Setup or System STEP SWP ON OFF STEPSWP ON| OFF>

1-12

Page 17

Table 1-1. Front Panel Equivalents (10 of 11)

Hardkey Softkey Command

System AMPLITUDE OFFSET LIMIAMPO

BEEP FAIL ON OFF BEEPFAIL ON|OFF> BW DISPLAY on OFF BWLIMDISP ON|OFF> BW TEST on OFF BWLIMTEST ON|OFF> CLEAR LIST CLER CLEAR LIST YES CLEAL DELTA LIMITS LIMD DEMOD: AMPLITUDE DEMOAMPL DEMOD: OFF DEMOOFF DEMOD: PHASE DEMOPHAS EDIT LIMIT LINE EDITLIML

Alphabetical Command Reference

Keys to Programming Commands

EDIT RIPL LIMIT EDITRLIM FIRMWARE REVISION SOFR FLAT LINE LIMTFL FREQUENCY BAND SELBND HARMONIC OFF HARMOFF HARMONIC SECOND HARMSEC HARMONIC THIRD HARMTHIR LIMIT LINE ON OFF LIMILINE LIMIT TEST ON OFF LIMITEST LOWER LIMIT LIML MARKER -> AMP. OFS. LIMIMAOF MARKER -> CW MARKCW MARKER -> MIDDLE MARKMIDD MARKER -> STIMULUS MARKSTIM MAXIMUM BANDWIDTH BWLIMMA X MAXIMUM FREQUENCY RLIMSTP MAXIMUM RIPPLE RLIMM MIDDLE VALUE LIMM MINIMUM BANDWIDTH BWLIMMIN MINIMUM FREQUENCY RLIMSTR N DB POINTS BWLI MDB

1-13

Page 18

Alphabetical Command Reference Keys to Programming Commands

Table 1-1. Front Panel Equivalents (11 of 11)

Hardkey Softkey Command

System or Sweep Setup or Cal

up N/A UP

SEGMENT DELETE SDEL

DONE EDITDONE

DONE SDON

EDIT SEGMENT SEDI

SEGMENT ADD SADD

1-14

Page 19

Alphabetical Command Reference

Programming Commands

AB; or AB?;

Command Description Range Query Response

AB Measures and displays A/B on the active

channel.

N/A

<0|1><

ADDR

Sets the GPIB address for the following peripherals.

Command Description Range Query Response

ADDRCONT Controller GPIB address. The address

where control is returned after a pass control.

ADDRDISC External disk drive GPIB address. integers 0–30

ADDRPLOT Plotter GPIB address. integers 0–30

ADDRPOWM Power meter GPIB address. integers 0–30

ADDRPRIN Printer GPIB address. integers 0–30

integers 0–30

<num><

ADJB

Executes autobiasing of optical modulator. No query response

ALTAB

ALTAB; or ALTAB?;

Command Description Range Query Response

ALTAB Places the analyzer in the alternate inputs

measurement mode, where A and B measurements are made on alternate sweeps. See also “CHOPAB.”

N/A

<0|1><

1-15

Page 20

Alphabetical Command Reference AR

AR; or AR?;

Command Description Range Query Response

AR Measures and displays A/R on the active

channel.

N/A

<0|1><

ASEG

ASEG; or ASEG?;

Command Description Range Query Response

ASEG Uses all segments for list frequency sweep.

See also “MINU.”

DISPMEMO Memory only. N/A

DISP

DPM

DTM

M1DM

Display data plus memory. N/A

Display data times memory. N/A

Display memory 1 divided by memory 2. N/A

N/A

<0|1><

1-29

Page 34

Alphabetical Command Reference DONE

Command Description Range Query Response

DISPM1MM

DISP

M1PM

DISP

M1TM

DISP

M2DM

DISP

M2MM

DISP

MATH

DISP

MMD

DISP

MDD

Display memory 1 minus by memory 2 N/A

Display memory 1 plus memory 2. N/A

Display memory 1 times memory 2. N/A

Display memory 2 divided by memory 1. N/A

Display memory 2 minus memory 1. N/A

Display math results N/A

Display memory minus data N/A

Display memory divided by data N/A

<0|1><

DONE

DONE;

Done with a class of standards, during a calibration. Only needed when multiple standards are measured to complete the class. OPC-compatible. No query response.

DONM

DONM;

Done modifying a test sequence. No query response.

DOSEQ

DOSEQ<1-6>;

Start sequence 1-6. No query response.

DOWN

DOWN;

Decrements the value displayed in the active entry area (emulates pressing the down-arrow key). No query response.

1-30

Page 35

Alphabetical Command Reference

DRIVPORT

DRIVPORT<ON|OFF>;

Drive port; ON = LW, OFF = RF.

DUAC

DUAC<ON|OFF>; or DUAC?;

Command Description Range Query Response

DRIVPORT

DUAC Turns dual channel display on and off. N/A

<0|1><

EDIT

EDIT<DONE|LIML|LIST>;

Command Description Range Query Response

EDITDONE Done editing list frequency, limit table, cal

sensor table, or power loss list. OPC-compatible.

EDITLIML Begins editing limit table. N/A N/A

EDITLIST Begins editing list frequency table. N/A N/A

N/A N/A

EDITRLIM

EDITRLIM;

Begins the editing of the ripple limit list. No query response.

ELED

ELED<num>[S]; or ELED?;

Command Description Range Query Response

ELED

Sets the electrical delay offset. ±10 seconds

<num><

1-31

Page 36

Alphabetical Command Reference ENTO

ENTO

ENTO;

Command Description Range Query Response

ENTO Removes displayed information from the

active entry area on the screen.

N/A N/A

EOCAL

EOCAL;

Internal E/O service calibration parameter.

ESE

ESE<num>; or ESE?;

Command Description Range Query Response

ESE Enables the selected event-status register

bits to be summarized by bit 5 in the status byte. An event-status register bit is enabled when the corresponding bit in the operand <num> is set.

integers 0–255

<num><

ESNL

ESNL<num>; or ESNL?;

Command Description Range Query Response

ESNL Enables the selected event-status register L

bits to be summarized by bit 2 in the status byte. An event-status register bit is enabled when the corresponding bit in the operand <num> is set.

integers 0–4095

<num><

ESL?

ESL?;

Command Description Range Query Response

ESL? Query only. Outputs event-status register. N/A

<num><

1-32

Page 37

Alphabetical Command Reference

EXTM

These commands include the indicated information when an instrument state is stored to the internal floppy disk drive or an external disk.

Command Description Range Query Response

EXTMDATA Adds error corrected data (real and

imaginary pairs) along with the other files.

EXTMFORM Formatted trace data. Uses currently

selected format for data.

EXTMGRAP User graphics. N/A

EXTMRAW Raw data arrays (real and imaginary pairs). N/A

a. See Figure 6-1 on page 6-3. This error corrected data is the same as that output by the OUTPDATA command.

N/A

<0|1><

EXTT

EXTT<ON|OFF>; or EXTT?;

Command Description Range Query Response

EXTT Activates or deactivates the external

trigger mode. OPC-compatible.

N/A

<0|1><

FORM

FORM<1|2|3|4|5>;

These 5 commands set the data format for array transfers in and out of the instrument:

Command Description Range Query

Response

FORM1 The analyzer's internal binary format, 6 bytes-per-data point.

The array is preceded by a four-byte header. The first two bytes represent the string “#A”, the standard block header. The second two bytes are an integer representing the number of bytes in the block to follow. FORM1 is best applied when rapid data transfers, not to be modified by the computer nor interpreted by the user, are required.

N/A N/A

1-33

Page 38

Alphabetical Command Reference FREO

Command Description Range Query

Response

FORM2 IEEE 32-bit floating-point format, 4 bytes-per-number,

8 bytes-per-data point. The data is preceded by the same header as in FORM1. Each number consists of a 1-bit sign, an 8-bit biased exponent, and a 23-bit mantissa. FORM2 is the format of choice if your computer is not a PC, but supports single-precision floating-point numbers.

FORM3 IEEE 64-bit floating-point format, 8 bytes-per-number,

16 bytes-per-data point. The data is preceded by the same header as in FORM1. Each number consists of a 1-bit sign, an 11-bit biased exponent, and a 52-bit mantissa. This format may be used with double-precision floating-point numbers. No additional precision is available in the analyzer data, but FORM3 may be a convenient form for transferring data to your computer.

FORM4 ASCII floating-point format. The data is transmitted as ASCII

numbers, as described in “Output Syntax” on page 5-4. There is no header. The analyzer always uses FORM4 to transfer data that is not related to array transfers (i.e. marker responses and instrument settings). Data is comma delimited.

FORM5 PC-DOS 32-bit floating-point format with 4 bytes-per-number,

8 bytes-per-data point. The data is preceded by the same header as in FORM1. The byte order is reversed with respect to FORM2 to comply with PC-DOS formats. If you are using a PC-based controller, FORM5 is the most effective format to use.

N/A N/A

N/A

FREO

FREO;

Frequency blank. Turns frequency notation off. Once the frequency notation has been turned off (blanked), it cannot be turned back on until a preset or recall is initiated. No query response.

FRER

FRER; or FRER?;

Command Description Range Query Response

FRER Places the analyzer in GPIB free run mode.

(Same as continuous sweep trigger mode.) See “CONT.”

N/A

<0|1><

1-34

Page 39

Alphabetical Command Reference

FWD

FWD<I|M|T>;

These commands are OPC-compatible if there is only one standard in the class. If there is just one standard, that standard is measured automatically. If there is more than one standard in the class, the standard being used must be selected with the STAN command.

Command Description Range Query Response

FWDI Selects the forward isolation calibration

class during a 2-port calibration sequence.

FWDM Selects the forward match calibration class

during a 2-port calibration sequence.

FWDT Selects the forward transmission

calibration class during a 2-port calibration sequence.

N/A N/A

HOLD

HOLD; or HOLD?;

Command Description Range Query Response

HOLD Puts the sweep trigger into hold mode. N/A

<0|1><

IDN?

IDN?;

Command Description Range Query Response

IDN? Query only. Outputs the identification string:

where 87NNEX is the model number of the instrument, xxxxxxxxxx is the serial number of the instrument, and X.XX is the firmware revision of the instrument.

N/A See command description

IFBW

IFBW<num>[HZ]; or IFBW?;

Command Description Range Query Response

IFBW Sets the IF bandwidth. Choose from 10, 30,

100, 300, 1000, 3000

<num><

1-35

Page 40

Alphabetical Command Reference IMAG

IMAG

IMAG; or IMAG?;

Command Description Range Query Response

IMAG Selects the imaginary display format. N/A

<0|1><

INI

INI<D>;

Initializes the internal disk. All previous information on the disk will be destroyed. No query response.

INPU

All of these commands (with a few noted exceptions) input an array and require that you set the format for data transfers with the FORM command. All of these commands have an associated OUTPut command that is used to transfer data from the analyzer. See “OUTP,”

later in this chapter.

Command Description Range Query

Response

INPUCALC

INPUCALK

INPUDATA Inputs an error corrected data array, using the current

INPUFORM Inputs a formatted data array, using the current setting

INPULEAS

INPURAW1 Inputs raw data array 1 (S

Error coefficient array

Inputs a cal kit array in FORM1 only. Can be read out with the OUTCALK command. After the transfer, the data should be saved into the user cal kit area with the SAVEUSEK command.

setting of the FORM command.

of the FORM command.

Inputs a learn string in FORM1 only. Can be read out with the OUTPLEAS command, or with INPULEAS?.

received, the analyzer stops sweeping, error-corrects the data, then formats and displays the data.

<num>.

data). After the data is

two-digit integers 01–12

N/A N/A

N/A

N/A N/A

N/A

<data><

1-36

Page 41

Alphabetical Command Reference

Command Description Range Query

Response

INPU

INPURAW2 Inputs raw data array 2 (S21 data). After the data is

N/A N/A

received, the analyzer stops sweeping, error-corrects the data, then formats and displays the data.

INPURAW3 Inputs raw data array 3 (S

data). After the data is

N/A N/A

received, the analyzer stops sweeping, error-corrects the data, then formats and displays the data.

INPURAW4 Inputs raw data array 4 (S

data). After the data is

N/A N/A

received, the analyzer stops sweeping, error-corrects the data, then formats and displays the data.

a. These commands input an individual error coefficient array. Before sending an array, issue a CALIXXXX; command,

where XXXX specifies the calibration type. (See “CALI” earlier in this book.) Then input the array or arrays. Lastly store the data with the SAVC command. The instrument goes into hold, displaying uncorrected data. Complete the process by triggering a sweep, with the CONT command (for continuous sweep) or the SING command (for a single sweep). See Table 1-1 on page 1-38 for the contents of the different arrays.

b. Does not require a preceding “FORM” command.

1-37

Page 42

Alphabetical Command Reference INT

Table 1-1. Error Coefficient Arrays

Array

Response Response

& Isolation

01 E

or E

EX (ED)

02 ET (ER)ESE

03 E

04 E

06 E

1-port Enhanced

Response

07 E

08 E

09 E

10 E

11 E

12 E

2-port

TRL/ LRM

O/E Response & Match

E/O Response & Match

a. One path, 2-port cal duplicates arrays 1 to 6 in arrays 7 to 12. b. Response and isolation corrects for crosstalk and transmission tracking in transmission measurements, and for

directivity and reflection tracking in reflection measurements.

c. This term is used to generate the calibration coefficients, but is not used during measurement error correction.

Meaning of first subscript: Meaning of second subscript:

D: directivity F: forward

S: source match R: reverse

R: reflection tracking

X: crosstalk or isolation

L: load match

T: transmission tracking

INT

INT<D>;

Selects the internal disk as the active storage device. No query response.

1-38

Page 43

Alphabetical Command Reference

INTE

INTE<num>; or INTE?;

Command Description Range Query Response

INTE

INTE Sets the display intensity, 50 to 100

percent.

integers 50–100

<num><

ISO

ISO<D|L>;

Command Description Range Query Response

ISOD Done with isolation subsequence in a

2-port or enhance response calibration. OPC-compatible.

ISOL Begins the isolation subsequence step in a

2-port calibration.

N/A N/A

LIM

LIM<D|L|M|S|U><num>[DB|HZ]; These commands edit a limit test segment. The limit table editing is begun with EDITLIML;,

and a segment is brought up for editing with SEDI<num>; or added using SADD;. The segment is closed with SDON;, the table is closed with EDITDONE;.

Command Description Range Query Response

LIMD Sets the limit delta value while editing a

limit line segment.

LIML Sets the lower limit value.

LIMM Sets the middle limit value.

LIMS Sets the limit stimulus break point.

LIMU Sets the upper limit value.

a. For log mag: ± 500 dB. For phase: ± 500 degrees. For Smith chart and Polar: ± 500 units. For linear magnitude: ± 500

units. For SWR: ± 500 units. The scale is always positive, and has minimum values of 0.001 dB, 10e-12 degrees, 10e-15 seconds, and 10 picounits.

b. For frequency or power sweeps, refer to “Preset State and Memory Allocation,” in your analyzer’s reference guide.

For CW time: 0 to 24 hours. For frequency sweep, transform on: ± 1/frequency step. For CW time sweep, transform on: ±1/time step.

amplitude range

stimulus range

amplitude range

see “Note” below

NOTE Currently these commands can be queried by sending the command followed by

1-39

Page 44

Alphabetical Command Reference LIMI

the OUTPACTI command, as in the following example to query the upper limit value:

10 OUTPUT 716;”LIMU;OUTPACTI;”

Future revisions of firmware may support the standard query form (which currently always returns a zero) for these commands.

LIMI

These commands are used to define and display limit testing.

Command Description Range Query Response

LIMIAMPO Enters the limit line amplitude offset.

LIMILINE Turns the display of the limit lines on and

off.

LIMIMAOF Marker to limit offset. Centers the limit

lines about the current marker position using the limit amplitude offset function.

LIMISTIO Enters the stimulus offset of the limit lines.

LIMITEST Turns limit testing on and off. N/A

a. For log mag: ± 500 dB. For phase: ± 500 degrees. For Smith chart and Polar: ± 500 units. For linear magnitude: ± 500

units. For SWR: ± 500 units. The scale is always positive, and has minimum values of 0.001dB, 10e-12 degrees, 10e-15 seconds, and 10 picounits.

b. For frequency or power sweeps, refer to “Preset State and Memory Allocation,” in your analyzer’s reference guide.

For CW time: 0 to 24 hours. For frequency sweep, transform on: ± 1/frequency step. For CW time sweep, transform on: ±1/time step.

amplitude range

N/A

N/A N/A

stimulus range

<num><

<0|1><

<num><

<0|1><

LIMT

LIMT<FL|SL|SP>; or LIMT<FL|SL|SP>?; These commands edit a limit test segment. The limit table editing is begun with EDITLIML;,

and a segment is brought up for editing with SEDI N; or added using SADD;. The segment is closed with SDON;, the table is closed with EDITDONE;.

Command Description Range Query Response

LIMTFL Makes the segment a flat line. N/A

LIMTSL Makes the segment a sloping line. N/A

<0|1><

1-40

Page 45

Alphabetical Command Reference

LINFREQ

Command Description Range Query Response

LIMTSP Makes the segment a single point. N/A

<0|1><

LINFREQ

LINFREQ; or LINFREQ?;

Command Description Range Query Response

LINFREQ Selects a linear frequency sweep. N/A

<0|1><

LINM

LINM; or LINM?;

Command Description Range Query Response

LINM Selects the linear magnitude display

format.

N/A

<0|1><

LINT

LINT<DATA|MEMO><num>;

Command Description Range Query Response

LINTDATA LINTMEMO

Enters the line type for plotting data. integers 0–10 N/A

Enters the line type for plotting memory. integers 0–10 N/A

LIS

LISFREQ; or LISFREQ?; LIS<IFBWM|PWRM><ON|OFF>; or LIS<IFBWM|PWRM>?;

List frequency functions.

Command Description Range Query Response

LISFREQ Selects the list frequency sweep mode. N/A

LISIFBWM Enables/disables the IFBW setting for a

list-frequency table in swept list mode.

N/A

<0|1><

1-41

Page 46

Alphabetical Command Reference LISTTYPE

Command Description Range Query Response

LISPWRM Enables/disables the power setting for a

list-frequency table in swept list mode.

N/A

<0|1><

LISTTYPE

LISTTYPE<LSTP|LSWP>; or LISTTYPE?;

Command Description Range

LISTTYPELSTP Selects the stepped list mode for use with a

list-frequency table.

LISTTYPELSWP Selects the swept list mode for use with a

list-frequency table.

a. 0 = stepped list mode

1 = swept list mode

N/A

Query Response

<0|1><

LISV

LISV;

Command Description Range Query Response

LISV Activates the list values function. Requesting a

plot (or print) copies only the current page. See also “NEXP,” “PREP,” “PLOT,” “PRINALL,” and

“PRINTALL.”

N/A N/A

LOAD

LOAD<num>;

Command Description Range Query Response

LOAD Loads the file from disk using the file name

provided by the preceding TITF<num>; command. The actual file loaded depends on the file title in the file position specified by the TITF<num> command. Requires pass control mode when using the GPIB port.

integers 1–5 N/A

1-42

Page 47

Alphabetical Command Reference

LOGFREQ

LOGFREQ; or LOGFREQ?;

Command Description Range Query Response

LOGFREQ

LOGFREQ Selects a log frequency sweep. N/A

<0|1><

LOGM

LOGM; or LOGM?;

Command Description Range Query Response

LOGM Selects the log magnitude display format. N/A

<0|1><

MANTRIG

MANTRIG; or MANTRIG?;

Command Description Range Query Response

MANTRIG Sets the trigger mode to manual trigger on

point. OPC-compatible.

N/A

<0|1><

MAN_LASER

MAN_LASER<ON|OFF>; or MAN_LASER?;

Toggles laser on and off (with autobias).

MARK

Command Description Range Query

Response

MARK1 Makes marker 1 active and sets its stimulus

value.

stimulus range

<num><

1-43

Page 48

Alphabetical Command Reference MARK

Command Description Range Query

Response

MARK2 Makes marker 2 active and sets its stimulus

value.

MARK3 Makes marker 3 active and sets its stimulus

value.

MARK4 Makes marker 4 active and sets its stimulus

value.

MARK5 Makes marker 5 active and sets its stimulus

value.

MARK3DB Searches for 3dB bandwidth on the

bandpass high-side, using marker 1 as the reference.

MARKBUCK Places the active marker on a specific

sweep point (bucket). <num> is the bucket number.

MARKCENT Sets the center stimulus value to that of the

active marker's stimulus value.

MARKCONT Places the markers continuously on the

trace, not on discrete points (interpolates the marker values between discrete points).

MARKCOUP Couples the markers between the channels,

as opposed to

MARKUNCO.

stimulus range

0 to (number-of-points − 1)

See footnote

<num><

N/A N/A

N/A

<0|1><

MARKCW Sets the CW frequency to the active

marker's frequency.

MARKDELA Sets electrical length so group delay is zero

at the active marker's stimulus.

MARKDISC Places the markers on the discrete

measurement points.

MARKFAUV Sets the auxiliary value of the fixed marker

position. Works in coordination with

MARKFVAL and MARKFSTI.

MARKFSTI Sets the stimulus position of the fixed

marker.

MARKFVAL Sets the value of the fixed marker position.

MARKMAXI

MARKMIDD Makes the marker amplitude the limit

MARKMINI

Same as

SEAMAX (search for maximum on

current channel's trace).

segment middle value during a limit segment edit.

Same as

SEAMIN (search for minimum on

current channel's trace).

N/A N/A

N/A

amplitude range

stimulus range

amplitude range

N/A

<0|1><

<num><

<0|1><

N/A N/A

N/A

<0|1><

1-44

Page 49

Alphabetical Command Reference

Command Description Range Query

Response

MATI

MARKOFF Turns all markers and marker functions

off.

MARKREF Sets the reference value to that of the active

marker's amplitude.

MARKSPAN Sets the span for the entire trace to that of

the span between the active marker and the delta reference marker.

MARKSTAR Sets the start stimulus to that of the active

marker's.

MARKSTIM During a limit segment edit, sets the limit

stimulus break point to that of the active marker's.

MARKSTOP Sets the stop stimulus to that of the active

marker's.

MARKUNCO Uncouples the markers between channels,

as opposed to

MARKZERO Places the fixed marker at the active

marker position and makes it the delta reference.

a. For frequency or power sweeps, refer to “Preset State and Memory Allocation.” For CW time: 0 to 24 hours. For

frequency sweep, transform on: ±1/frequency step. For CW time sweep, transform on: ±1/time step.

b. For example, on a 201 point sweep, <num> can range from 0 to 200. c. For log mag: ± 500 dB. For phase: ± 500 degrees. For Smith chart and Polar: ± 500 units.

For linear magnitude: ± 500 units. For SWR: ± 500 units. The scale is always positive, and has minimum values of 0.001dB, 10e−12 degrees, 10e−15 seconds, and 10 picounits.

MARKCOUP.

N/A

N/A N/A

N/A

N/A N/A

<0|1><

MATI

MATI;

MATI to current memory.

MAXF

MAXF[<num>[freq suffix]];

Command Description Range Query Response

MAXF Sets the maximum valid frequency of a

standard being defined during a cal kit modification.

0–1000 GHz N/A

1-45

Page 50

Alphabetical Command Reference MEAS

MEAS

MEAS<A|B|R|E01|O1|OE1|OE2|OFF|MEASOO1>; or MEAS<A|B|RE01|O1|OE1|OE2|OFF|MEASOO1>?;

Command Description Range Query Response

MEASA Measures and displays input A on the

N/A

active channel.

MEASB Measures and displays input B on the

N/A

active channel.

MEASR Measures and displays input R on the

N/A

active channel.

MEASEO1 Measures and displays electrical-to-optical

N/A

transmission.

MEASO1 Measures and displays optical reflection. N/A

MEASOE1 Measures and displays optical-to-electrical

N/A

transmission in port 1

MEASOE2 Measures and displays optical-to-electrical

N/A

transmission in port 2.

MEASOFF Switches off marker function

N/A

measurements.

MEASOO1 Measures and displays optical

N/A

transmission.

<0|1><

MEASTAT

MEASTAT<ON|OFF>; or MEASTAT?;

Command Description Range Query Response

MEASTAT Turns trace statistics on and off. N/A

1-46

<0|1><

Page 51

Alphabetical Command Reference

MEM

MEM<O1|O2|1I|2I>;

Command Description Range Query Response

MEM

MEMO1

MEMO2

MEM1I

MEM2I

Activate memory 1. Activate memory 2. Memory 1 to memory 2. Memory 2 to memory 1.

Command Description Range Query

Response

MENUON Turns the softkey menu on. N/A N/A

MENUOFF Blanks the softkey menu. Use with caution, as this

may give unusual results when setting up an instrument state. Recommend setting up states using MENUON (default) and, when setup is complete, using MENUOFF .

MENUAVG Brings up the menu associated with the

panel key.

Avg front

N/A N/A

MENUCAL Brings up the menu associated with the

panel key.

MENUCOPY Brings up the menu associated with the

panel key.

MENUDISP Brings up the menu associated with the

panel key.

MENUFORM Brings up the menu associated with the

panel key.

MENUMARK Brings up the menu associated with the

panel key.

MENUMEAS Brings up the menu associated with the

panel key.

MENUMRKF Brings up the menu associated with the

front panel key.

MENUSRCH Brings up the menu associated with the

front panel key.

Cal front

Copy front

Display front

Format front

Marker front

Meas front

Marker Fctn

N/A N/A

1-47

Page 52

Alphabetical Command Reference MINMAX

Command Description Range Query

Response

MENUPOWE Brings up the menu associated with the Marker Fctn

front panel key.

MENURECA Brings up the menu associated with the

front panel key

MENUSAVE Brings up the menu associated with the

front panel key

MENUSCAL Brings up the menu associated with the

front panel key.

MENUSTIM Brings up the menu associated with the

front panel key.

MENUSWEE Brings up the menu associated with the

front panel key.

MENUSYST Brings up the menu associa ted wit h the

panel key.

Save/Recall

Scale Ref

Sweep Setup

System front

Front Panel Equivalents

Press the associated hardkey listed above.

MINMAX

N/A N/A

MINMAX<ON|OFF>; or MINMAX?;

Command Description Range Query Response

MINMAX Enables/disables min/max recording per

segment. Min and max values are recorded per limit segment. Limit testing need not be active.

N/A

<0|1><

For more information refer to “Limit Line and Data Point Special Functions” on page 8-125.

MINU

MINU; or MINU?;

Command Description Range Query Response

MINU Data minus memory (linear subtraction).

PAUS

PAUS;

Pauses the sequence; to be followed by CONS to resume the sequence. No query response.

PHAO

PHAO<num>; or PHAO?;

Command Description Range Query Response

PHAO Sets the phase offset. 0–360 degrees

<num><

PHAS

PHAS; or PHAS?;

Command Description Range Query Response

PHAS Selects the phase display format. N/A

<0|1><

PLOT

PLOT;

Initiates a plot. Requires pass control mode when using the GPIB port. No query response.

POIN

POIN<num>; or POIN?;

Command Description Range Query Response

POIN Sets the number of points in the sweep, or

in a sweep segment.

Choose from: 3, 11, 21, 26, 51, 101, 201, 401, 801, 1601

<num><

NOTE This command should be followed by a wait equal to 2 sweeps. Example wait

code written in BASIC:

OUTPUT 716;"POIN801;" OUTPUT 716;”SWET?;” ENTER 716;T

1-56

Page 61

Alphabetical Command Reference

WAIT 2*T

POL

Command Description Range Query Response

POL

POLA Selects the polar display format. N/A

POLMLIN Selects linear as the marker readout format

for polar display.

POLMLOG Selects log as the marker readout format

for polar display.

POLMRI Selects real/imaginary as the marker

readout format for polar display.

N/A

<0|1><

PORE

PORE<ON|OFF>; or PORE?;

Command Description Range Query Response

PORE Turns port extensions on and off. N/A

<0|1><

PORT

PORT<1|2><num>[S]; or PORT<1|2>?;

These commands set the port extension length for the indicated port or input. Ports 1 and 2 refer to the test set ports.

Command Description Range Query Response

PORT1 Port 1 ±10 seconds

PORT2 Port 2 ±10 seconds

<num><

1-57

Page 62

Alphabetical Command Reference PORTP

PORTP

PORTP<CPLD|UNCPLD>; or PORTP?;

Command Description Range

PORTP Selects either coupled or uncoupled for the

port powers of a given channel.

a. 0 = uncoupled

1 = coupled

N/A

Query Response

<0|1><

1-58

Page 63

Alphabetical Command Reference

POWE

POWE<num>[DB]; or POWE?;

Command Description Range Query Response

POWE

POWE Sets the output power level. output power

range of your analyzer

a. The output power range of your analyzer depends upon the model and installed options. Refer to your analyzer’s

reference guide to determine the power range of your analyzer.

<num><

POWS

POWS; or POWS?;

Command Description Range Query Response

POWS Selects power sweep, from the sweep type

menu.

N/A

<0|1><

PRAN

Syntax

PRAN<num>;

Command Description Range Query Response

PRAN Sets the source power range.

a. PRAN0 through PRAN7 are used for ranges 0 through 7. b. Use two-digit integers 01 through 12. PRAN01 through PRAN12 are used for ranges 0 through 11.

integers integers

0–7

01–12

N/A

PRES

PRES;

Presets the analyzer to the factory preset state. OPC-compatible. No query response.

NOTE Pressing the Preset key on the analyzer will either invoke the factory preset

state, or a user-selected state (if one has been set up). Sending the PRES command will always invoke the factory preset state. This is true even if the analyzer is currently set up to recall a user preset state when the pressed. Refer to “Preset State and Memory Allocation” on page 9-1. For more

Preset key is

1-59

Page 64

Alphabetical Command Reference PWRR

information on user presets, see your analyzer’s user’s guide.

NOTE This command should use OPC? to prevent timing errors with subsequent

commands. Example code written in BASIC:

10 OUTPUT 716;"OPC?;PRES;" 20 ENTER 716;X

PWRR

PWRR<PMAN|PAUTO>; or PWRR?;

Command Description Range Query Response

PWRR Selects whether the power range is in auto

or manual mode.

a. 0 = manual mode

1 = auto mode

N/A

<0|1><

PULV [value];

Set pulse width search value.

PULW<ON|OFF>;

Select pulse width sear ch OF F /ON.

RAI

RAI<D|ISOL|RESP>;

Command Description Range Query Response

RAID Completes the response and isolation cal

sequence. OPC-compatible.

RAIISOL Calls the isolation class for the response

and isolation calibration.

N/A N/A

RAIRESP Calls the response class for the response

and isolation calibration.

1-60

N/A N/A

Page 65

Alphabetical Command Reference

RAMD;

Response and match cal done.

READ

READ<DATE|TIME>;

Command Description Range Query Response

RAMD;

READDATE Outputs the date in the following string

format: DD MMM YYYY.

READTIME Outputs the time in the following string

format: HH:MM:SS.

N/A N/A

REAL

REAL; or REAL?;

Command Description Range Query Response

REAL Sets the display format to real. N/A

<0|1><

RECAREG

RECAREG<num>;

Command Description Range Query Response

RECAREG Recalls from save/recall registers 01–31.

OPC-compatible.

two-digit integers 01–31

N/A

RECAREG<1-31>;

Recalls previously saved display colors. No query response.

RECEOUT<ON|OFF>;

Select path to receiver output; ON=CAL, OFF = OPT.

1-61

Page 66

Alphabetical Command Reference RECO

RECO

RECO;

Recalls previously saved display colors. No query response.

REF

REF<D|L>;

Command Description Range Query Response

REFD Completes the reflection calibration

subsequence of a 2-port calibration. OPC-compatible.

REFL Begins the reflection calibration

subsequence of a 2-port calibration.

N/A N/A

REF

REF<P|V><num>; or REF<P|V>?;

Command Description Range Query Response

REFP Enters the reference position. 0 is the

bottom, 10 is the top of the graticule.

REFV Enters the reference line value.

a. For log mag: ± 500 dB. For phase: ± 500 degrees. For Smith chart and Polar: ± 500 units. For linear magnitude: ±500

units. For SWR: ± 500 units. The scale is always positive, and has minimum values of 0.001dB, 10e−12 degrees, 10e−15 seconds, and 10 picounits.

integers 0–10

amplitude range

<num><

REFT

REFT;

Recalls file titles from disk. Requires pass control if using an external disk drive on GPIB. No query response.

RESC

RESC;

Command Description Range Query Response

RESC Resume a previously started cal sequence. N/A N/A

1-62

Page 67

Alphabetical Command Reference

RESD

RESD;

Command Description Range Query Response

RESD

RESD Restores the measurement display after

viewing the operating parameters or list values.

N/A N/A

RESM;

Reset model 1.

RESPDONE

RESPDONE;

Command Description Range Query Response

RESPDONE Completes the response calibration

sequence. OPC-compatible.

N/A N/A

REST

REST;

Measurement restart. No query response.

REV

REV<I|M|T>;

Command Description Range Query Response

REVI Calls the reverse isolation calibration class

during a full 2-port calibration.

REVM Calls the reverse match calibration class

during a full 2-port calibration.

REVT Calls the reverse transmission calibration

class during a full 2-port calibration.

N/A N/A

1-63

Page 68

Alphabetical Command Reference RLIMLINE

RLIMLINE

RLIMLINE<ON|OFF>; or RLIMLINE?;

Command Description Range Query Response

RLIMLINE Turns the lines that represent the ripple

test limits on and off.

N/A

<0|1><

RLIMM

RLIMM<num>[DB]; or RLIMM?;

Command Description Range Query Response

RLIMM Sets the value of the maximum allowable

ripple limit for current frequency band.

0.01 to 100 dB

<num><

RLIMSTP

RLIMSTP<num>[HZ|KHZ|MHZ|GHZ]; or RLIMSTP?;

Command Description Range Query Response

RLIMSTP Sets the stop frequency of the current

frequency band.

a. Refer to “Preset State and Memory Allocation.”

stimulus range

<num><

RLIMSTR

RLIMSTR<num>[HZ|KHZ|MHZ|GHZ]; or RLIMSTR?;

Command Description Range Query Response

RLIMSTR Sets the start frequency of the current

ripple limit.

a. Refer to “Preset State and Memory Allocation.”

stimulus range

<num><

RLIMTEST

RLIMTEST<ON|OFF>; or RLIMTEST?;

Command Description Range Query Response

RLIMTEST Turns the ripple limit test on and off. N/A

1-64

<0|1><

Page 69

Alphabetical Command Reference

RLIMVAL

RLIMVAL<OFF|ABS|MAR>;

Command Description Range Query Response

RLIMVAL

RLIMVAL Displays the ripple limit value of the

selected band (see “SELBND”) in absolute format (AB S) or margin format (MAR). OFF turns the displayed ripple limit value off.

N/A N/A

RST

RST;

Presets the analyzer to the factory preset state. OPC-compatible. See Chapter 9, “Preset State

and Memory Allocation” No query response.

NOTE Pressing the Preset key on the analyzer will either invoke the factory preset

state, or a user-selected state (if one has been set up). Sending the RST command will always invoke the factory preset state. This is true even if the analyzer is currently set up to recall a user preset state when the

Preset key is

pressed. For more information on user presets, see your analyzer’s user’s guide.

S<11|12|21|22>; or S<11|12|21|22>?;

Command Description Range Query Response

S11 Forward reflection measurement N/A

S12 Reverse transmission measurement N/A

S21 Forward transmission measurement N/A

S22

Reverse reflection measurement

N/A

<0|1><

SADD

SADD;

Adds a new segment to the table during a list-frequency, limit-table, cal sensor table, or power loss table edit. No query response.

1-65

Page 70

Alphabetical Command Reference SAV

SAV

SAV<1|2|C>;

Command Description Range Query Response

SAV1 Completes the 1-port calibration sequence.

OPC-compatible.

SAV2 Completes the 2-port calibration sequence.

OPC-compatible.

SAVC Completes the transfer of error correction

coefficients back into the instrument. OPC-compatible.

N/A N/A

SAVE

SAVEREG<num>;

Command Description Range Query Response

SAVEREG Saves to save/recall registers 01–31.

SAVEREG01 through SAVEREG05 are the same as SAVE1 through SAVE5. OPC-compatible.

two-digit integers 01–31

N/A

SAVECSV

SAVECSV;

Saves the current measurement to the disk drive in the comma-separated value (CSV) format. No query response.

SAVEJPG

SAVEJPG;

Saves the current display to the disk drive in the JPG format. OPC-compatible. No query response.

1-66

Page 71

Alphabetical Command Reference

SAVU

SAVU<ASCI|BINA>;

Command Description Range Query Response

SAVU

SAVUASCI Selects ASCII format for saving to disk.

Conforms to CITIFile specifications.

SAVUBINA Selects binary format for saving to disk. N/A N/A

N/A N/A

SCAL

SCAL<num>; or SCAL?;

Command Description Range Query Response

SCAL Sets the trace scale factor.

a. For log mag: ± 500 dB. For phase: ± 500 degrees. For Smith chart and Polar: ±500 units. For linear magnitude: ± 500

units. For SWR: ± 500 units. The scale is always positive, and has minimum values of 0.001dB, 10e−12 degrees, 10e−15 seconds, and 10 picounits.

amplitude range

<num><

SDEL

SDEL;

Deletes the current segment while editing a list frequency, a limit table, or a power loss list. No query

response.

SDON

SDON;

Closes a segment after editing a list frequency, a limit table, or a power loss list. No query response.

SEA

These commands control the marker searches. The marker searches place the active marker according to the indicated search criteria. The search is continuously updated if tracking is

1-67

Page 72

Alphabetical Command Reference SEDI

ON (see “TRACK”).

Command Description Range Query Response

SEAL Search left for next occurrence of the target

N/A N/A

value.

SEAMAX Search for trace maximum on the current

N/A

channel.

SEAMIN Search for trace minimum on the current

N/A

channel.

SEAOFF Turns the marker search off. N/A

SEAR Search right for next occurrence of the

N/A N/A

<0|1><

target value.

SEATARG Set the search target amplitude.

a. For log mag: ± 500 dB. For phase: ± 500 degrees. For Smith chart and Polar: ±500 units.

For linear magnitude: ± 500 units. For SWR: ± 500 units.

amplitude range

<num><

SEDI

SEDI<num>; or SEDI?;

Command Description Range Query Response

SEDI During either a frequency, limit, or power

loss table edit, selects segment <num> for editing.

state dependent. Range for frequency segment = 1 to 30. Range for limit test segment = 1 to 18 . Range for power loss table segment = 1 to 12

<num><

SEG

SEG<IFBW|POWER><num>;

Command Description Range Query Response

SEGIFBW Sets the IFBW for the active segment of a

list-frequency table in swept list mode.

SEGPOWER Sets the power for the active segment of a

list-frequency table in swept list mode.

1-68

Choose from 10, 30, 100, 300, 1000, 3000, 3700, 6000

output power range of your

analyzer

see “Note” below

see “Note below

Page 73

Alphabetical Command Reference

SEL

a. The output power range is dependent upon the model and option configuration of your analyzer. Refer to your

analyzer’s reference guide to determine the output power range of your analyzer.

NOTE Currently these commands can be queried by sending the command followed by

the OUTPACTI command, as in the following example to query the upper limit value:

10 OUTPUT 716;”SEGIFBW;OUTPACTI;”

Future revisions of firmware may support the standard query form (which currently always returns a zero) for these commands.

SEL

SEL<MAXPT|MINPT|PT|SEG><num>; or SEL<MAXPT|MINPT|PT|SEG>?;

Command Description Range Query Response

SELMAXPT Selects the last point number in the range

of points that the report.

SELMINPT Selects the first point number in the range

of points that the report.

SELPT Selects the point number that the

OUTPDATR command will

OUTPDATP command will report.

SELSEG Selects the segment number to report on

for the

OUTPSEGF and OUTPSEGM

commands.

0 to n−1, where

n=number of points

0 to n−1, where

n=number of points

0 to n−1, where

n=number of points

integers 1–18

<num><

NOTE For the definition of a limit segment, see “Limit Line and Data Point Special

Functions” on page 8-125.

SELBND

SELBND<num>; or SELBND?;

Command Description Range Query Response

SELBND Selects the ripple frequency band for the

following commands: OUTPRPLBNDPF, OUTPRPLBNDVAL, and RLIMVAL.

integers 1−12

<num><

1-69

Page 74

Alphabetical Command Reference SET

SET

SET<Z><num>; or SET<BIT|Z>?; SET<DATE|TIME><$>;

Command Description Range Query Response

SETDATE Sets the date in the following format: DD

MMM YYYY, where DD is the day and must be 2 digits, MMM is the month and must be three alpha characters (JAN, FEB, MAR, APR, MAY, JUN, JUL, AUG, SEP, OCT, NOV, DEC), and YYYY is the year and must be 4 digits.

SETTIME Sets the time in the following format:

HH:MM:SS, where HH is the hour, MM is minutes, SS is seconds, and each must be 2 digits.

SETZ Sets the characteristic impedance of the

measurement system.

SING

SING;

Single sweep. OPC-compatible. No query response.

SLI

See “Description .” N/A

0.1 to 500 Ω

<num><

SLI<D>;

Sliding load done. No query response.

SMI

SMI<C|MGB|MLIN|MLOG|MRI|MRX>; or SMI<C|MGB|MLIN|MLOG|MRI|MRX>?;

Command Description Range Query Response

SMIC Selects Smith chart display format. N/A

SMIMGB Selects G+jB (conductance and

susceptance) marker readout on a Smith chart.

SMIMLIN Selects linear magnitude marker readout

on a Smith chart.

N/A

1-70

<0|1><

Page 75

Alphabetical Command Reference

Command Description Range Query Response

SMOO

SMIMLOG Selects log magnitude marker readout on a

Smith chart.

SMIMRI Selects real/imaginary pairs (resistance

and reactance) marker readout on a Smith chart.

SMIMRX Selects R + jX marker readout on a Smith

chart.

N/A

<0|1><

SMOO

SMOOAPER<num>; or SMOOAPER?; SMOOO<ON|OFF>; or SMOOO?;

Command Description Range Query

Response

SMOOAPER Sets the smoothing aperture as a percent of the

trace.

SMOOO Selects whether smoothing is on or off. N/A

0.05 to 20%

<num><

<0|1><

SOFR

SOFR;

Displays the firmware revision on the screen. No query response.

SOFT

SOFT<num>;

Command Description Range Query Response

SOFT Acts as though the indicated softkey was

pressed.

integers 1–8 N/A

SOUP

SOUP<ON|OFF>; or SOUP?;

Command Description Range Query Response

SOUP Selects whether the source power is on or

off.

N/A

<0|1><

1-71

Page 76

Alphabetical Command Reference SPAN

SPAN

SPAN<num>[HZ|DB]; or SPAN?;

Command Description Range Query Response

SPAN Sets the stimulus span value. If a list

frequency segment is being edited, sets the span of the list segment.

a. For frequency or power sweeps, refer to “Preset State and Memory Allocation,” in your analyzer’s reference guide.

For CW time: 0 to 24 hours. For frequency sweep, transform on: ± 1/frequency step. For CW time sweep, transform on: ±1/time step.

stimulus range

<num><

SPLD

SPLD<ON|OFF>; or SPLD?;

Command Description Range Query Response

SPLD Turns the split display mode on and off. N/A

<0|1><

SPLID

SPLID<1|2|4>; or SPLID<1|2|4>?;

Command Description Range Query Response

SPLID1 Puts all displayed channels on one full-size

graticule.

N/A

<0|1><

SPLID2 Puts all displayed channels on two

graticules.

SPLID4 Puts each displayed channel on a separate

graticule.

N/A

<0|1><

SRE

SRE<num>; or SRE?;

Command Description Range Query Response

SRE Service request enable. A bit set in <num>

enables the corresponding bit in the status byte to generate an SRQ.

1-72

integers 0–255

<num><

Page 77

Alphabetical Command Reference

SSEG

SSEG<num>; or SSEG?;

Command Description Range Query Response

SSEG

SSEG Selects the desired segment of the

frequency list for a list frequency sweep. See also “ASEG”.

integers 1–30

<num><

STAN

STAN<A|B|C|D|E|F|G>;

Standards A through G are associated with softkeys 1 through 7, respectively.

Command Description Range Query

Response

STANA These 7 commands (OPC-compatible) select a

STANB N/A N/A

STANC N/A N/A

STAND N/A N/A

STANE N/A N/A

STANF N/A N/A

STANG N/A N/A

standard from a class during a calibration sequence. If a class is requested, as in CLASS11A (S11 1-port cal) the analyzer will do one of two things:

• If there is only one standard in the class, it will measure that standard automatically.

• If there are several standards in the class, then one of these commands must be used to select one of these standards, causing it to be measured.

N/A N/A

STAR

STAR<num>[HZ|DB]; or STAR?;

Command Description Range Query Response

STAR Sets the start stimulus value. If a list

frequency segment is being edited, sets the start of the list segment.

a. For frequency or power sweeps, refer to “Preset State and Memory Allocation,” in your analyzer’s reference guide.

For CW time: 0 to 24 hours. For frequency sweep, transform on: ± 1/frequency step. For CW time sweep, transform on: ±1/time step.

stimulus range

<num><

1-73

Page 78

Alphabetical Command Reference STB?

STB?

STB?;

Command Description Range Query Response

STB? Query only. Outputs the status byte in

ASCII format (FORM4). Same as OUTPSTAT.

N/A

<num><

STEPSWP

Syntax

STEPSWP<ON|OFF>; or STEPSWP?;

Command Description Range Query Response

STEPSWP Turns step sweep mode on or off. N/A

<0|1><

STOP

STOP<num>[HZ|DB]; or STOP?;

Command Description Range Query Response

STOP Sets the stop stimulus value. If a list

frequency segment is being edited, sets the stop of the list segment.

stimulus range

<num><

a. For frequency or power sweeps, refer to “Preset State and Memory Allocation,” in your analyzer’s reference guide.

For CW time: 0 to 24 hours. For frequency sweep, transform on: ± 1/frequency step. For CW time sweep, transform on: ±1/time step.

STPSIZE

STPSIZE<num>[HZ|DB]; or STPSIZE?;

Command Description Range Query Response

STPSIZE Sets the step size while editing a list

frequency segment.

a. For frequency or power sweeps, refer to “Preset State and Memory Allocation,” in your analyzer’s reference guide.

For CW time: 0 to 24 hours. For frequency sweep, transform on: ±1/frequency step. For CW time sweep, transform on: ±1/time step.

stimulus range

<num><

1-74

Page 79

Alphabetical Command Reference

SWE

SWEA; SWET<num>[S]; or SWET?;

Command Description Range Query Response

SWE

SWEA Automatically selects the fastest sweep

time based on the current analyzer settings for number of points, IF bandwidth, sweep mode, averaging condition and frequency span.

SWET Sets the sweep time. (Setting SWET0 is

equivalent to sending the

SWEA command.)

N/A N/A

0–86,400 s

<num><

NOTE The SWET command should be followed by a wait equal to 2 sweeps. Example

wait code written in BASIC:

10 OUTPUT 716;"SWET.1;" 20 WAIT 2*.1

SWR

SWR; or SWR?;

Command Description Range Query Response

SWR Selects the SWR display format. N/A

<0|1><

TESS?

TESS?;

Command Description Range Query Response

TESS? Query only. Queries whether a test set is

connected. Returns a one on the standard analyzer.

N/A

<0|1><

1-75

Page 80

Alphabetical Command Reference TINT

TINT

TINT<num>; or TINT?;

Command Description Range Query Response

TINT Adjusts the tint for the selected display

feature.

integers 0–100

<num><

TIT

TIT<F|REG><num><$>; TIT<L><$>; TITSQ;

Command Description Range Query Response

TITF Titles the indicated file numbers. <num>: 1–5

<$>: 10 char. max.

TITL Enters a new display title. 48 characters max N/A

TITREG Titles save/recall registers 01 through 31.

TITREG01 through TITREG05 are the

same as

TITR1 through TIT R5.

<num>: 01–31 <$>: 10 char. max.

N/A

TRA

TRA<D|N>;

Command Description Range Query Response

TRAD Completes the transmission calibration

subsequence of a 2-port calibration or enhanced response calibration. OPC-compatible.

TRAN Begins the transmission calibration

subsequence of a 2-port calibration or enhanced response calibration.

N/A N/A

TRACK

TRACK<ON|OFF>; or TRACK?;

Command Description Range Query Response

TRACK Turns marker search tracking on and off. N/A

1-76

<0|1><

Page 81

Alphabetical Command Reference

20 ENTER 716;X

TRIG

TRIG;

Wait for sweep trigger.

TST?

TST?;

Command Description Range Query Response

TRIG

TST? Query only. Causes a self test and returns a

zero if the test is passed.

N/A

<num><

TSTP

TSTP<P1|P2>;

Selects test port 1 or 2 for non-S-parameter measurements. No query response.

UP;

Increments the value displayed in the active entry area (emulates pressing the up-arrow key). No query response.

USEPASC

USEPASC; or USEPASC?;

Command Description Range Query Response

USEPASC Puts the analyzer in pass control mode. N/A

<0|1><

VELOFACT

VELOFACT<num>; or VELOFACT?;

Command Description Range Query Response

VELOFACT Enters the velocity factor of the

transmission medium.

0 to 10

<num><

1-77

Page 82

Alphabetical Command Reference WID

WID

WIDT<ON|OFF>; or WIDT?; WIDV<num>; or WIDV?;

Command Description Range Query Response

WIDT Turns the bandwidth search on and off. N/A

WIDV Enters the widths search parameter.

a. For log mag: ± 500 dB. For phase: ± 500 degrees. For Smith chart and Polar: ±500 units.

For linear magnitude: ± 500 units. For SWR: ± 500 units.

amplitude range

<0|1><

<num><

WINDUSEM

WINDUSEM;

Uses trace memory as window.

WRSK

WRSK<num><$>;

Command Description Range Query Response

WR SK Enter s new softkey labels in to the indica ted

softkey positions. Initial use of these commands requires previous commands MENUFORM; and MENUOFF;.

<num>: integers 1–8 <$>: 10 char. max.

N/A

1-78

Page 83

8703A Commands Not Supported in the 8703B

Table 1-3.

ALIS HARMSEC MAXF ASAMP HARMTHIR MEAS EO2 CALCEXEC INDEREFRxx MEASO2 CALCEXIT INPUOEO1 MEASOO2 CALCHECK INPUOEO2 MODRF CWEXT INPUOEO3 OUTKEY EXTAOPTI INPUOEO4 OU TMUPL FRES INPUOEO5 WAVL1300 GUIS INPUOEO6 WAVL1550

Alphabetical Command Reference

HARMOFF KOR?

1-79

Page 84

Alphabetical Command Reference 8703A Commands Not Supported i n th e 8703B

1-80

Page 85

Alphabetical List of Commands 2-2 OPC-Compatible List of Commands 2-4

Command Listings

Page 86

Command Listings Alphabetical List of Commands

Alphabetical List of Commands

AB ADDRCONT ADDRDISC ADDRPLOT ADDRPOWM ADDRPRIN ADJB ALTAB AR ASEG AUTB AUTO AUXC AVERFACT AVERO AVERREST BACI BEEPDONE BEEPFAIL BEEPWARN BR BSAMP BWLIMDB BWLIMDISP BWLIMMAX BWLIMMKR BWLIMIN BWLIMSTAT BWLIMTEST BWLIMVAL CALIEORM CALIOERM CALIFUL2 CALIRAI CALIRESP CALIS111 CALIS221 CALK35MM CBRI CENT CHAN1 CHAN2 CHAN3 CHAN4 CLAD CLASS11A CLASS11B CLASS11C CLASS22A CLASS22B CLASS22C CLEAL CLEARALL

CLEAREG<01-31> CLEL CLER CLES CLS COEFA<1-4> COEFB<1-4> COEFDELA COEFK CONS CONT CONV1DS CONVOFF CONVYREF CONVYTRA CONVZREF CONVZTRA CORI CORR COUC COUS CWFREQ CWTIME D2XUPCH2 D2XUPCH3 D4XUPCH2 D4XUPCH3 DATI DEBU DEFC DEFS DELA DELO DELR<1-5> DELRFIXM DEMOAMPL DEMOOFF DEMOPHAS DISCUNIT DISM DISPDATA DISPDATM DISPDDM DISPDMM DISPMATH DISPMEMO DISPDPM DISPDTM DISPM1DM DISPM1MM DISPM1PM DISPM1TM DISPM2DM

DISPM2MM DISPMMD DISPMDD DONE DONM DOSEQ<1-6> DOWN DRIVPORT DUAC<ON|OFF> EDITDONE EDITLIML EDITLIST EDITRLIM ELED ENTO EOCAL ESE ESNB ESR? EXTMDATA EXTMFORM EXTMGRAP EXTMRAW EXTT FORM1 FORM2 FORM3 FORM4 FORM5 FREO FRER FWDI FWDM FWDT HOLD IDN? IFBW IMAG INID INPUCALC<01-04> INPUCALK INPUDATA INPUFORM INPULEAS INPURAW1 INPURAW2 INPURAW3 INPURAW4 INTD INTE ISOD ISOL LIMD

LIMIAMPO LIMILINE LIMIMAOF LIMISTIO LIMITEST LIML LIMM LIMS LIMTFL LIMTSL LIMTSP LIMU LINFREQ LINM LINTDATA LINTMEMO LISFREQ LISIFBWM LISPWRM LISTTYPELSTP LISTTYPELSWP LISV LOAD<1-5> LOGFREQ LOGM LWALCI LWALCV? LWALCVxx MAN_LASER MANTRIG MARK1 MARK2 MARK3 MARK4 MARK5 MARK3DB MARKBUCK MARKCENT MARKCONT MARKCOUP MARKCW MARKDELA MARKDISC MARKFAUV MARKFSTI MARKFVAL MARKMAXI MARKMIDD MARKMINI MARKOFF MARKREF MARKSPAN MARKSTAR

MARKSTIM MARKSTOP MARKUNCO MARKZERO MATI MAXF MEASA MEASB MEASR MEASEO1 MEAS01 MEASOE1 MEASOE2 MEASOFF MEASOO1 MEASTAT MENUAVG MEMO1 MEMO2 MEM1I MEM2I MENUCAL MENUCOPY MENUDISP MENUFORM MENUMARK MENUMEAS MENUMRKF MENUOFF MENUON MENUPOWE MENURECA MENUSAVE MENUSCAL MENUSRCH MENUSTIM MENUSWEE MENUSYST MINMAX MINU MODEI NEXP NUMG OMII OPC OPEP OUTPACTI OUTPAMAX OUTPAMIN OUTPAPER OUTPCALC<01-12> OUTPCALK OUTPCHAN

2-2

Page 87

Command Listings

Alphabetical List of Commands

OUTCNTR OUTPDATA OUTPDATP OUTPDATR OUTPERRO OUTPFAIP OUTPFARPLPT OUTPFORM OUTPIDEN OUTPLEAS OUTPLIM<1-4> OUTPLIMF OUTPLIML OUTPLIMM OUTPMARK OUTMAXP OUTPMEMO OUTPMINP OUTPMRIS OUTPMSTA OUTMUPL OUTPMWID OUTPOPTS OUTPPLOT OUTPPRIN OUTPRAW<1-4> OUTPRIPL OUTPRPLBNDALL OUTPRPLBNDPF OUTPRPLBNDVAL OUTPSEGAF OUTPSEGAM OUTPSEGF OUTPSEGM OUTPSERN OUTPSTAT OUTPTESS OUTPTITL PAUS PHAO PHAS PLOT POIN POLA POLMLIN POLMLOG POLMRI PORE PORT1 PORT2 PORTP POWE POWS PRAN<01-12> PRES PWRR PULV PULW

RAID RAIISOL RAIRESP RAMD READDATE READTIME REAL RECAREG <01-31> RECEOUTON RECEOUTOFF RECO REFD REFL REFP REFT REFV RESC RESD RESM RESPDONE REST REVI REVM REVT RISTON RISTOFF RLIMLINE RLIMM RLIMSTP RLIMSTR RLIMTEST RLIMVAL<ABS|MAR| OFF> RST S11 S12 S21 S22 SADD SAV1 SAV2 SAVC SAVECSV SAVEJPG SAVEREG<01-31> SAVUASCI SAVUBINA SCAL SDEL SDON SEAL SEAMAX SEAMIN SEAOFF SEAR SEATARG SEDI SEGIFBW

SEGPOWER SELBND SELMAXPT SELMINPT SELPT SELSEG SETDATE SETTIME SETZ SING SLID SMIC SMIMGB SMIMLIN SMIMLOG SMIMRI SMIMRX SMOOAPER SMOOO<ON|OFF> SOFR SOFT<1-8> SOUP SPAN SPLD SPLID1 SPLID2 SPLID4 SRE SSEG STANA STANB STANC STAND STANE STANF STANG STAR STB? STEPSWP STOP STPSIZE SWEA SWET SWR TESS? TINT TITF<1-5> TITL TITREG<01-31> TRACK TRAD TRAN TRIG TST? TSTP UP USEPASC VELOFACT

WIDT WIDV WINDUSEM WRSK<1-8>

2-3

Page 88

Command Listings OPC-Compatible List of Commands

OPC-Compatible List of Commands

AUXC CHAN1 CHAN2 CHAN3 CHAN4 CLASS11A CLASS11B CLASS11C

CLASS22A CLASS22B CLASS22C CLEARALL CLEAREG DATI DONE EDITDONE

FWDI FWDM FWDT ISOD MANTRIG NUMG PRES RAID

RECAREG REFD RESPDONE REVI REVM REVT RST SAV1

SAV2 SAVC SAVEJPG SAVEREG SING STAN TRAD

2-4

Page 89

Introduction to Instrument Control 3-2 Instrument Control using the VXIplug&play Driver 3-3 Instrument Control using HP BASIC 3-9

Introduction to Instrument Control

Page 90

Introduction to Instrument Control Introduction to Instrument Control

Introduction to Instrument Control

In this chapter, you can find an introduction to the remote operation of your analyzer using an external controller. You should be familiar with the operation of the analyzer before attempting to remotely control the analyzer over the General Purpose Interface Bus (GPIB). See the analyzer’s user’s guide and reference guide for operating information.

This manual is not intended to teach programming or to discuss GPIB theory except at an introductory level.

Programming examples that demonstrate the remote operation of the analyzer are documented in Chapter 8, “Programming Examples” and are also provided on the CD-ROM that was shipped with this manual. All example programs are provided in HP BASIC, and most are also provided in Visual C++ and Visual BASIC for use with the VXIplug&play driver.

3-2

Page 91

Introduction to Instrument Control

Instrument Control using the VXIplug&play Driver

VXIplug&play is a term indicating conformance to a set of system-level standards produced by the VXIplug&play Systems Alliance. The charter of the alliance was “to improve the effectiveness of VXI-based solutions by increasing ease-of-use and improving the interoperability of multi-vendor VXI systems.”

Installing the VXIplug&play driver on your computer will allow you to control the analyzer via common programming environments without having to learn the instrument-specific mnemonics.

Requirements

The VXIplug&play driver for your analyzer is designed for a PC operating Windows 95 or Windows NT version 3.51 or higher. The driver requires a virtual instrument software architecture (VISA)-compatible GPIB interface, and the VISA I/O Library version 1.1 or higher. The driver is compatible with the following programming environments:

• Microsoft Visual Basic, version 4.0 or higher

• Microsoft Visual C++, version 4.0 or higher

• Borland C++, version 4.5 or higher

• HP VEE, version 3.2 or higher

• National Instruments LabWindows/CVI, version 4.0.1 or higher

• National Instruments LabVIEW, version 4.0.1 or higher

Installing the VXIplug&play Driver

NOTE This procedure assumes that you have installed a VISA-compatible GPIB

interface and the VISA I/O library, version 1.1 or higher. It also assumes that you have installed—and are familiar with—one of the programming environments listed above.

1. The install program for the VXIplug&play driver for your analyzer is located in the root directory of the CD-ROM that accompanied this manual. The file is titled “875x.exe”

a. If you need to order a new CD-ROM, contact Agilent Technologies and order part

number 08703-10202.

b. You can also download the file from the Web. Go to http://www.tm.agilent.com and

follow the “Software and Driver” and “Instrument Driver” links.

2. Run “875x.exe” to install the VXIplug&play driver on your computer. The default directory that is used by the install-shield is vxipnp\winxx\hp875x, where winxx designates the operating system in use by your computer, such as winnt, win95, etc.

3. If you have difficulty installing the VXIplug&play driver, contact Agilent Technologies by calling the nearest sales or service office.

3-3

Page 92

Introduction to Instrument Control Instrument Control using the VXIplug&play Driver

System Setup

1. Use an GPIB interconnect cable (such as 10833A/B/C/D) to connect the analyzer to the GPIB interface card on your computer.

2. Switch on the computer.

3. Switch on the analyzer.

a. To verify the analyzer's address, press:

Local, SET ADDRESSES, ADDRESS: 8703

The analyzer has only one GPIB interface, though it occupies two addresses: one for the instrument and one for the display. The display address is equal to the instrument address with the least-significant bit incremented. The display address is automatically set each time the instrument address is set.

The default analyzer addresses are:

—16 for the instrument

—17 for the display

CAUTION Other devices connected to the bus cannot occupy the same address as the

analyzer or the display.

The analyzer should now be displaying the instrument's address in the upper right section of the display. If the address is not 16, return the address to its default setting (16) by pressing:

16, x1, Preset

b. Set the system control mode to either “pass-control” or “talker/listener” mode. These

are the only control modes in which the analyzer will accept commands over GPIB. To set the system-control mode, press:

Local, TALKER/LISTENER

Local, USE PASS CONTROL

3-4

Page 93

Introduction to Instrument Control

Instrument Control using the VXIplug&play Driver

Verifying the Bus Connection

Check the interface bus connection and operation by following the appropriate procedure (for the type of interface card you are using) below.

Interface Bus Verification Procedure (GPIB Interface Card)

1. Check the bus connection by running the VISA Assistant in the I/O Libraries. The VISA Assistant will automatically report what it finds on the bus. Notice that the VISA Assistant is reporting instruments at addresses 16 and 17. As mentioned earlier, these addresses designate the instrument and its display, respectively.

Figure 3-1. VISA Assistant Window

2. To further verify GPIB operation, send a preset command to the analyzer by doing the following in the VISA Assistant window:

a. Single-click on “GPIB0::16::INSTR” to highlight it.

b. Make sure that the “Formatted I/O” tab is selected. c. Enter PRES; in the text box.

d. Click on “viPrintf.”

e. This command should preset the analyzer. If an instrument preset does not occur,

there is a problem. Check all GPIB address settings and physical connections. Most GPIB problems are caused by an incorrect address or faulty/loose GPIB cables.

3-5

Page 94

Introduction to Instrument Control Instrument Control using the VXIplug&play Driver

Interface Bus Verification Procedure (National Instruments Card)

1. Check the bus connection by running Win32 VISA Interactive Control. When this program is run, it automatically reports what it finds on the bus. Notice that the program is reporting instruments at addresses 16 and 17. As mentioned earlier, these addresses designate the instrument and its display, respectively.

Figure 3-2. Win32 VISA Interactive Control Window: Bus Report

2. To further verify GPIB operation, double click on “GPIB0::16::INSTR” and then perform the following steps.

a. Make sure that the “Basic I/O” tab is selected.

b. Click on the “Write” tab. c. Enter PRES; in the “Buffer” text box.

d. Click on “Execute.”

e. This command should preset the analyzer. If an instrument preset does not occur,

there is a problem. Check all GPIB address settings and physical connections. Most GPIB problems are caused by an incorrect address or faulty/loose GPIB cables.

3-6

Page 95

Instrument Control using the VXIplug&play Driver

Figure 3-3. Win32 VISA Interactive Control: Sending a Command

Introduction to Instrument Control

Controlling the Analyzer with the VXIplug&play Driver

The “Programming Examples” CD-ROM that was shipped with this manual includes many example programs that can be used to control your analyzer. The following sections provide some information on using the VXIplug&play driver with the Visual C++ and Visual BASIC programming environments.

Using Visual BASIC to Control the Analyzer

When using Visual BASIC, you will need to include the two files listed below in your project. They were installed on your computer in the following directories when you installed the driver:

• \vxipnp\winxx\hp875x\hp875x.bas

• \vxipnp\winxx\include\visa32.bas

NOTE The directories shown above are the default locations for these files. (“winxx”

indicates the operating system you are using, such as winnt, win95, etc.) If you designated a different path during installation, you will need to amend the path above to include the specific path that you indicated during installation.

3-7

Page 96

Introduction to Instrument Control Instrument Control using the VXIplug&play Driver

Using Visual C++ to Control the Analyzer

When using Visual C++, you will need to include the file listed below in your project. The file was installed on your computer in the following directory when you installed the driver:

\vxipnp\winxx\lib\msc\hp875x_32.lib

NOTE The directory shown above is the default location for this file. (“winxx”

3-8

Page 97

Introduction to Instrument Control

Instrument Control using HP BASIC

This section describes how to control the analyzer using HP BASIC 6.2 (or higher), or HP BASIC for Windows 6.3 (or higher) on one of the following computers:

• HP 9000 Series 200/300

• HP 9000 Series 700 with HP BASIC-UX

• PC with a GPIB interface card installed

Table 3-1. Additional BASIC 6.2 Programming Information

Description HP/Agilent

Part Number

HP BASIC 6.2 Programming Guide 98616-90010

HP BASIC 6.2 Language Reference (2 Volumes) 98616-90004

Using HP BASIC for Instrument Control, Volume I 82303-90001

Using HP BASIC for Instrument Control, Volume II 82303-90002

HP BASIC for Windows Manual Set E2060-90100

Table 3-2. Additional GPIB Information

Description HP/Agilent

Part Number

HP BASIC 6.2 Interface Reference 98616-90013

Tutorial Description of the General Purpose Interface Bus 5021-1927

Required Equipment

• Computer running HP BASIC 6.2 (or higher) or HP BASIC for Windows 6.3 (or higher)

• Supported GPIB interface card

• GPIB interconnect cables (such as 10833A/B/C/D)

System Setup and GPIB Verification

1. Connect the analyzer to the computer with an GPIB cable.

3-9

Page 98

Introduction to Instrument Control Instrument Control using HP BASIC

Figure 3-4. The Analyzer System with Controller

2. Switch on the computer, and launch HP BASIC or HP BASIC for Windows.

3. Switch on the analyzer.

a. To verify the analyzer's address, press:

Local, SET ADDRESSES, ADDRESS: 8703

The default analyzer addresses are:

—16 for the instrument

—17 for the display

CAUTION Other devices connected to the bus cannot occupy the same address as the

analyzer.

The analyzer displays the instrument's address in the upper right section of the display. If the address is not 16, return the address to its default setting (16) by pressing:

3-10

16, x1, Preset

Page 99

Introduction to Instrument Control

Instrument Control using HP BASIC

b. Set the system control mode to either “pass-control” or “talker/listener” mode. These

are the only control modes in which the analyzer will accept commands over GPIB. To set the system-control mode, press:

Local, TALKER/LISTENER

Local, USE PASS CONTROL

4. Check the interface bus by performing a simple command from the computer controller. Type the following command on the controller:

OUTPUT 716;”PRES;”

Execute, or Return

NOTE HP 9000 Series 300 computers use the Return key as both execute and enter.

Some other computers may have an

Enter, Execute, or Exec key that performs

the same function. For reasons of simplicity, the notation Return is used throughout this document.

This command should preset the analyzer. If an instrument preset does not occur, there is a problem. Check all GPIB addresses and connections. Most GPIB problems are caused by an incorrect address or faulty/loose GPIB cables.

3-11

Page 100

Introduction to Instrument Control Instrument Control using HP BASIC

Sending Commands

A remote controller can manipulate the functions of the analyzer by sending commands to the analyzer via the General Purpose Interface Bus (GPIB). The commands used are specific to the analyzer. Remote commands executed over the bus take precedence over manual commands executed from the instrument's front panel. Remote commands are executed as soon as they are received by the analyzer. A command only applies to the active channel (except in cases where functions are coupled between channels). Most commands are equivalent to front-panel hardkeys and softkeys.

Command Structure in BASIC

Consider the following BASIC command for setting the analyzer's start frequency to 50 MHz:

OUTPUT 716;”STAR 50 MHZ;”

The command structure in BASIC has several different elements: the BASIC command statement OUTPUT - The BASIC data-output statement. the appendage 716 - The data is directed to interface 7 (GPIB), and

on to the device at address 16 (the analyzer). This appendage is terminated with a semicolon. The next appendage is STAR, the instrument mnemonic for setting the analyzer's start frequency.

data 50 - a single operand used by the root mnemonic STAR

to set the value.

unit MHZ - the units that the operand is expressed in. terminator ; - indicates the end of a command, enters the data,

and deactivates the active-entry area.

The “STAR 50 MHZ;” command performs the same function as pressing the following keys on the analyzer's front panel:

Start, 50, M/u

STAR is the root mnemonic for the start key, 50 is the data, and MHZ are the units. Where possible, the analyzer's root mnemonics are derived from the equivalent key label. Otherwise they are derived from the common name for the function. Chapter 1, “Alphabetical

Command Reference” lists all the root mnemonics and all the different units accepted.

The semicolon (;) following MHZ terminates the command within the analyzer. It removes start frequency from the active-entry area, and prepares the analyzer for the next command. If there is a syntax error in a command, the analyzer will ignore the command and look for the next terminator. When it finds the next terminator, it starts processing incoming commands normally. Characters between the syntax error and the next terminator are lost. A line feed also acts as a terminator. The BASIC OUTPUT statement transmits a carriage return/line feed following the data. This can be suppressed by putting a semicolon at the end of the statement.

3-12

Agilent 8703B Programming Manual

Specifications and Main Features

Frequently Asked Questions

User Manual

Contents

Alphabetical Command Reference

Alphabetical Command Reference

Symbol Conventions

Keys to Programming Commands

Programming Commands

PAUS

8703A Commands Not Supported in the 8703B

Command Listings

Alphabetical List of Commands

OPC-Compatible List of Commands

Introduction to Instrument Control

Introduction to Instrument Control

Instrument Control using the VXIplug&play Driver

Instrument Control using HP BASIC