Agilent 8719D Programming Guide

Notice

Hewlett-Packard to Agilent Technologies Transition

This documentation supports a product that previously shipped under the HewlettPackard company brand name. The brand name has now been changed to Agilent Technologies. The two products are functionally identical, only our name has changed. The document still includes references to Hewlett-Packard products, some of which have been transitioned to Agilent Technologies.

Printed in USA March 2000

Programmer’s Guide

HP 8719D/20D/22D Network

Analyzer

Bl?RtrtNo.

08720-90293 Supersedes October

PrintedinUSA February 1999

F!!

HEWLETT PACKARD

Notice.

The information contained in this document is subject to change without notice. Hewlett-Packard 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. Hewlett-Packard shah not be liable for errors contained herein or for incidental or consequential damages in connection with the furnishing, performance, or use of this material.

Hewlett-F’ackard

Company 1996, 1997, 1998, 1999

Assistance

Product maintenance

Hewlett-Rzchmrd

agre

products.

seruice om

!hble O-l. Hewlett-Packard

Instrument Support Center Hewlett-Packard Company (800)

403-0801

Headquarters Hewlett-Packard S.A. 150, Route du Nant-d’Avril 1217 Meyrin Switzerland (4122) 780.8111

Great Britain Hewlett-Packard Ltd.

E&dale Road, Woldngham,

2Eeneva

Winnemh Triangle

Berkshire RG416DZ

696622

and other

l%r

ang assistance,

EUROPEAN FIELD OPEIWI’IONS

Prance Hewlett-Packard Prance

1 Avenue Du Canada Hewlett-Packard

Zone

D’Activite

F-91947

Les Prance (33 1) 69 82 60 60

custom assistance agrm

contact z/our

Sales

UNITED STATES

De Courtaboeuf

LJlis

Cedex

nearest

and Service Offices

G=--w

Hewlett-Packard

61352 Bad Homburg v.d.H

gz&-o

are available for

Hmlett-&hrd

GmbH Strasse

Sales and

Beadquarters

Hewlett-Packard Company 3495 Deer Creek Road Palo Alto, California, USA

84304-1316

(416)

857-6027

INTEIWON

AnstraIia

Hewlett-Packard Australia Ltd. 31-41

Joseph Street

Blackburn, Victoria 3130

(61 3)

896-2896

FIELD OPERATIONS

Japan

China Hewlett-Packard Company Hewlett-Packard Japan, Ltd.

38BeiSanHuanXlRoad shuang Yu shll EaiDiaIlDistrict Beiiin&china (86

266-6338

IktiWtUl

Hewlett-Packard

6th Flooq

337 Fu Hsing North Road

lhipei, !&wan (886

H-P Building

7124404

!lhiwan

Q-l %kakuraCho, Hachioji

lblcyo 192,

(81 426) 60-2111

Japan

Hewlett-Packard (Canada) Ltd.

17500 South Service Road

Transcanada Highway

Kirkland, Quebec HQJ

E7-4232

2X&?

SlnBapore

Hewlett-Packard Singapore (Pte.) Ltd.

150 Beach Road

#29-00

Gateway West

Singapore 0718 (65)

291-9033

. . .

III

How to Use This Guide

The Example Programs Disks

The example programs shipped with this instrument were originally written for the HP 8753D Network Analyzer, but are compatible with the HP to maintain compatibility with the HP

8719D/20D/22D,

example programs . The example programs that need modification are clearly identifled in Chapter 2, “HP BASE Programming Examples.”

8719D/20D/22D

Network Analyzer. ln order

it will be necessary to modify certain

The following is included with the “Programming Examples HP

HP BASE example programs (compatible with Rocky Mountain Basic)

IJF

DC% ille-transformation

utility,

“LlFXMXEXE”

BASE

disk:

The following is included with the “Programming Examples QuickC and QuickBASW disk:

QuickC example programs

QuickBASlC

example programs

Programming Documentation

This Programmer’s Guide consists of the following two chapters:

HP-IB

network analyzer under

w IIP

example programs (which offer solutions for several remotely-controlled analyzer processes).

The programming examples have only been documented for HP BASE in Chapter 2. However, if the programming language QuickC or programming examples can be used or Programming Examples” as an overall guide in determining the organization and logic of the

programs

Programming and Command Reference provides a reference for operation of the

HP-lB

BASIC Programming

control and provides a description of all

Faamples

provides documentation for the factory-tested HP

QuickBASE

modified

is preferred, these versions of the

while referring to Chapter 2, “HP BASE

HP-lB

mnemonica

BASK

Conventions

Front-Panel Ke

Screen Text

This represents a key physically located on the instrument. This represents a “softkey,” a key whose label is determined by the

instrument’s This represents text displayed on the instrument’s screen.

ilrmware.

Network Analyzer Documentation Set

The Installation and Quick Start Guide

familiarizes you with the network analyzer’s front and rear panels, electrical and

environmental operating requirements, as well as procedures for installing, configuring, and verifying the operation of the analyzer.

The User’s Guide

shows how to make measurements, explains commonly-used features, and tells you how to get the most performance from your analyzer.

The Quick Reference Guide

provides a

summary of selected user features

The

Frogramm

Guide

provides

er’s

programming information including an HP-IB programming and command reference as well

as programming examples

The Service Guide

provides the information needed to adjust, troubleshoot, repair, and verify conformance to published specifications

Contents

HP-IB

Where to Look for More Information Preset State Analyzer Command Syntax

HP-IB Operation

Analyzer

Reading Analyzer Data

Pro@amming

.................................

Code Naming Convention

Valid

Characters units Command Formats

Device Types

HP-IB Bus Structure

HP-II3

HP-IB Operational Capabilities Bus Device Modes

Setting HP-IB Addresses

Response to HP-IB

Operation Complete Output Queue

Command Query Identification Output syntax Marker data

...................................

General Structure: Syntax Types

T&Iker

Listener Controller

DataBus..

Handshake Lines Control Lines

HP-IB Status Indicators System-Controller Mode

Talker/Listener

Pass-Control Mode

Analyzer Bus Modes

Abort

Device Clear.

Local..

Local Lockout

ParaIIel PoII

Pass Control Remote

SerialPoll

Trigger

..................................

.................................

Requirements

..................................

.................................

Operation

and

Commaan

..........................

.........................

..............................

.............................

............................

..............................

...............................

................................

............................

..............................

............................

..............................

............................

.........................

.............................

.........................

Mode

..............................

................................

..............................

...............................

................................

...............................

................................

...........................

............................

...........................

..........................

Meta-Messages (IEEE-488

.............................

............................

..............................

d Reference

.....................

.......................

Universal Commands)

......

l-2 l-3 l-8 l-8 l-9 l-9 l-9

l-9 l-10

1-11

l-11 l-11 l-11 l-11

1-12 1-12 1-12 1-12 1-13 1-14 1-15 1-15 1-16 1-16 1-16 1-16

1-17 1-17 1-17 1-17

1-17

1-18

1-18 1-18 1-18

1-18

1-19

l-20 l-20 l-20 l-20 l-20

1-21

Contents-l

Array-Data Formats Trace-Data Transfers Stimulus-Related Values

Data-Processing Chain

DataArrays

................................

Fast Data Transfer Commands Data Levels

................................

Learn String and Calibration-Kit String

Error Reporting

Status Reporting The Status Byte The Event-Status Register and Event-Status Register B Error Output

Calibration

Disk

.................................

File

Names

Using Key Codes. Key Select Codes for the Network Analyzer HP-IB

only

Commands

Alphabetical Mnemonic Listing

ErP

BASIC Programm

Introduction

.................................

Required Equipment

Optional Equipment

System Setup and HP

8719D/20D/22D

Command Structure in BASIC Command Query

Running

the Program

Operation Complete

Running the Program

Preparing for Remote (HP-IB) Control

OPaths

.................................

Measurement Process

Step1.SettingUptheInstrument

Step 2. Calibrating the Step 3. Connecting the Device under ‘I&t Step 4.

‘&king

the Measurement Data

Step 5. Post-Processing the Measurement Data

Step 6. Transferring the Measurement Data

BASIC Programming Examples

Program Information.

............................

..........................

............................

.......................

...................

...............................

..............................

............

...............................

..............................

.............................

..................

............................

........................

ing

Examples

............................

...........................

HP-II3

Verification

....................

Network Analyzer Instrument Control Using BASIC

.......................

..............................

..........................

............................

..........................

....................

............................

.....................

Test

Setup

.....................

..................

....................

...............

.................

........................

...........................

Analyzer Features Helpful in Developing Programming Routines

Analyzer-Debug Mode

User-ControIIable

Sweep

Example 1: Measurement Setup

Example

1A:

Setting Parameters

Running the Program

Example

1B:

Verifying Parameters

Running the Program

Example 2: Measurement Calibration

Calibration Kits Example

2A: Sll

..............................

l-Port Calibration

Running the Program

Example

2B: FuII 2-Port

..........................

.........................

.......................

......................

..........................

.....................

..........................

.....................

..........................

Measurement Calibration

..............

.....

.......

l-23 l-24

1-25

l-26 l-26

l-28 l-28 l-29

l-30 l-30 l-32 l-32

l-34 l-34 l-37

l-38 l-39

l-62 l-69

2-l

2-2 2-2 2-2 2-5 2-5 2-6 2-7 2-8 2-8

2-8 2-10 2-11 2-11 2-11 2-12 2-12 2-12 2-12

2-13 2-14 2-14 2-14

2-14 2-15 2-15 2-16 2-18

2-19 2-20

2-20

2-21

2-23 2-23

ContelIts-2

Running the Program

Example

Running

Example

2C:

Adapter Removal Calibration

the Program

2D:

Using Raw Data to Create a Calibration (Simmcal)

Running the Program

Example

2E: ‘Ihke4 -

..........................

.................

..........................

........

..........................

Error Correction Processed on an External PC

Overview................................

Using the Programming Example

Running the Program

Example 3: Measurement Data Transfer

Trace-Data Formats and Transfers Example 3A: Data Transfer Using Markers

Running the Program

Example

Running the Program

Example

Running the Program

Example

Running the Program

Example

Running the Program

Example 4: Measurement Process Synchronization

Status Reporting

Example4A:UsingtheErrorQueue

Running

Example

Running

Example

Running the Program

Example 5: Network Analyzer System Setups

Saving and Recalling Instrument States

Example5A:UsingtheLeamSlring

Running the Program

Example

Running the Program

Example

Running the Program

Example 6: Limit-Line lbsting

Using List-Frequency Mode Example

Running the Program

Example

Running the Program

UsingLimitLinestoPerformPASS/FAIL’Ibsts Example6C:SettingUpLimitLines.

Running the Program

Example

Running the Program

Example 7: Report Generation

Example

Running the Program

Example

Running the Program

Example

‘lake4

Mode

..........................

...................

.....................

.................

..........................

3B:

Data Transfer Using FORM 4 (ASCII Transfer)

..........

..........................

3C:

Data Transfer Using Floating-Point Numbers

..........

..........................

3D:

Data Transfer Using Frequency-Array Information

..........................

3E:

Data Transfer Using FORM 1, Internal-Binary Format

..........................

...............

..............................

....................

the Program

4B:

Generating Interrupts

the Program

4C:

Power Meter Calibration

..........................

.....................

..........................

....................

..........................

.................

...................

....................

..........................

5B:

Reading Calibration Data

...................

..........................

5C:

Saving and Restoring the Analyzer Instrument State

..........................

........................

.........................

6A:

Setting Up a List-Frequency Sweep

..............

..........................

6B:

Selecting a Single Segment from a

Table

of Segments

..........................

................

....................

..........................

6D:

Performing

PASS/FAIL Tests

While

Ttming

...........

..........................

........................

7Al:

Operation Using

Talker/Listener

Mode

............

..........................

7A2:

Controlling Peripherals Using Pass-Control Mode

..........................

7A3:

Printing with the Serial Port

.................

.......

......

.......

......

........

.....

2-26 2-27 2-28 2-29 2-34 2-36 2-36 2-36 2-37

2-42 2-43 2-43 244 2-45 2-46 248 2-49 2-50 2-51 2-53 2-54 2-55 2-56 2-56 2-57 2-58 2-59 2-61 2-62 2-65 2-66 2-66 2-66 2-67

2-68 2-70 2-71 2-73 2-74 2-74 2-74 2-76

2-77

2-79 2-79 2-80 2-82

2-83

2-85 2-86 2-86 2-87 2-88 2-90

2-91

Cont4mts3

Running the Program

Example

7B:

Plotting to a

Running the Program

..........................

File

and Transferring

File

..........................

Utilizing PC-Graphics Applications Using the Plot File Example

Running the Program

Example 8: Mixer Measurements

Example

Running the Program

Limit Line and Data Point Special Functions

Overview..

Example

Limit Segments Output Results.

Constants Used Throughout This Document

OutputLimitTbstPass/FaiIStatusPerLimitSegment

Output

7C:

Reading ASCII Disk Files to the Instrument Controller’s Disk File

..........................

.......................

8A:

Comparison of Two Mixers - Group Delay, Amplitude or Phase

..........................

..................

...............................

Display of Limit Lines

......................

.............................

.................

Pass/FhiI

Status for AR Segments

..................

Example Program of OUTPSEGAF Using BASIC

OutputMinimumandMaximumPointPerLimitSegment

Output Minimum and Maximum Point For

AII

Segments

Example Program of OUTPSEGAM Using BASIC Output Data Per Point

OutputDataPerRangeofPoints OutputLimitPass/I%IbyChannel

...........................

......................

.....................

Data to a Plotter

.....

............

.............

..............

...........

..............

2-92

2-93

2-94 2-95 2-96

2-99 2-100 2-100 2-103

2-104

2-105

2-107

2-108 2-109

2-110 2-111 2-112

2-112

2-114 2-115

2-116

2-117

2-118

2-119

Index

contents-4

Figures

l-l. HP-IB Bus Structure

l-2. Analyzer l-3.

FORM 4 (ASCII) Data-Transfer Character String

l-4.

The Data-Processing Chain

l-5.

Status Reporting Structure

l-6.

Key Codes.

2-l.

The HP 2-2. Status Reporting Structure 2-3. Connections: Comparison of Two Mixers

24.LimitSegmentsVersusLimitLines

Single

Bus Concept

................................

8719D/20D/22D

............................

........................

...............

.........................

Network Analyzer System with Controller

.........................

Group Delay, Amplitude or Phase .

.....................

......

2-100

2-107

YIhbles

O-l. Hewlett-Packard l-l. Preset Conditions (1 of 5)

l-2.

Code Naming Convention

l-3.

OPC-compatible Commands

14.

UnitsasaFunctionofDisplayFormat.

l-5.

8719D/20D/22D l-6. Status Bit Dell&ions l-7.

Status Bit Defmitions (Continued)

l-8.

Relationship between Calibrations and Classes

l-9.

Error Coefficient Arrays

l-10.

Disk File Names

l-11. Key Select Codes

1-12.

HP-LB only

2-l.

Additional BASIC 6.2 Programming Information

2-2. Additional HP-IB Information 2-3. Measurement Speed: Data Output and Error Correction to an External PC* . . 2-4. HP 2-5. Limit Line and Data Point Special Functions Commands 2-6. Limit Segment 2-7. Example Output: OUTPSEGAM 2-8.

2-9. 2-10. Example Output: OUTPSEGAF 2-11. Example Output: OUTPSEGM 2-12. Example Output: OUTPSEGAM 2-13. Example Output: OUTPDATP (data per point) 2-14. Example Output: OUTPDATPR (data per range of points)

8719D/20D/22D

Pass/FaiI/NoLimit

MinMaxlbstConstants

Sales

and Service Offices

Network Analyzer Array-Data Formats

..............................

.............................

Commands

Network Analyzer Array-Data Formats

Table

for Figure 2-3

Status Constants

.........................

...........................

......................

..........................

...........................

........................

(min/max

..........................

(pass/fail

(min/max

..................

...................

..........

................

...............

..........

...........

.....................

of all segments)

.....................

for

all

segments)

per segment)

for

ail

segments)

................

..........

............

..........

...........

2-105 2-108

2-109

2-110 2-110 2-112 2-114 2-115

2-117 2-118

1-12 1-15 1-21

l-27 l-30 l-38

2-3

2-56

. . .

l-8

1-19

l-22

l-24

1-31

l-32

l-35

l-36 l-37 14-9 l-62

2-l

2-37

246

Contents-5

HP-IB Progr

amming

and Command Reference

This chapter is a reference for operation of the network analyzer under HP-IB control. You should already be familiar with making measurements with the analyzer. Information about the HP-IB commands is organized as follows:

Analyzer Command Syntax

Code Naming Convention

Valid Characters

units

Command Formats

HP-IB Operation

Device Types

HP-IB Bus Structure

HP-H3

Requirements

HP-IB Operational Capabilities

Bus Device Modes

Setting HP-IB Addresses

Response to HP-IB

Analyzer Operation-Complete Commands

Reading Analyzer Data

Output Queue

Command Query

Met&Messages (IEEE-488

Output syntax

Marker Data

Array-Data Formats

Trace-Data Transfers

Stimulus-Related Values

Data Processing Chain

Data Arrays

Fast Data Transfer Commands

Data Levels

Learn String and Calibration Kit String

Universal Commands)

HP-M Programming and Command Reference

l-1

Error Reporting

Status Reporting

The Status Byte

The Event-Status Register and Event-Status Register B

Error Output

Calibration

Disk File Names

Using Key Codes

Key Select Codes Arranged by Front-Panel

HP-II3

Only Commands

Alphabetical Mnemonic Listing

Hardkey

For information about manual operation of the analyzer, refer to the HP

Network Analyzer User’s

Gwid.e.

87190Z?O0Z!,W

Where to Look for More Information

Additional information covering many of the topics discussed in this chapter is located in the following:

Tutorial &script&m. of the

discussion of all aspects of the HP-IB. A thorough overview of tutorial HP publication, HP part number 5021-1927.

IlZEEStundurd

Digital I-w

488.1-1987 contains detailed information on IEEE488 operation. Published by the Institute

of Electrical and Electronics Engineers, Inc, 345 East New York 10017.

Chapter 2, “HP BASIC programming examples,” includes programming examples in

HP BASIC.

Hewlett-mhrd

for Programmable

Interlface Bus,

InstmLmentation ANSMEEEstd

47th

presents a description and

ail

technical details as a broad

Street, New York,

l-2

HP-16

Programming and Command Reference

Preset State

When the state. This state is defined in

When line power is cycled, or the

key is pressed, the analyzer reverts to a known state called the factory preset

‘Ihble

l-l.

IPreset

key pressed, the analyzer performs a self-test routine.

Upon successful completion of that routine, the instrument state is set to the conditions shown

‘lhble

l-l. The same conditions are true following a “PRES;” or “RST;” command over HP-IB,

although the self-test routines are not executed.

You

also

can configure an instrument state and

dellne

it as your user preset state:

1. Set the instrument state to your desired preset conditions.

2. Save the state (save/recall menu).

3. Rename that register to “UPRESET”.

press m

The

‘~~~~~~~~.

. . . . .

. . . .

..i

.._..............._.......................

key is now toggled to the

..G.

.._.. <<F.:...

@$&..

selection and your defined instrument state will be

recalled each time you press w and when you turn power on. You can toggle back to the factory preset instrument state by pressing

Note

When you send a preset over HP-IB, you will always get the factory preset.

Ipreset]

and selecting .:~~~~~~.

.- .._.............._

-..- .._...

You can, however, activate the user-delined preset over HP-IB by recalling the

HP-IB Programming and Command Reference

lhble

l-l. Preset Conditions (1 of 5)

Preset Conditions Analyzer Mode Analyzer Mode Frequency Offset

(Opt. 089)

Offset Value

High Power

External R Channel Attenuator A Attenuator B

stimnllls S=ep Type

Step Sweep

Step Sweep (Opt. Display Mode

TriggerType ExternalTrigger

Sweep Time Start Frequency

stop Frequency

(HP

871QD)

Stop Frequency

(HF’ 8720D) Stop

Frequency

[HP

8722D) StartTime TimeSpan

CW Frequency 1GHz

l&t

Port Power

(HP

871QD/ZOD)

Test Port Power [HP

8719D/‘20D,

T&t Port Power

(HP

8719D/20D, Opt.

Test

Port Power

(HF’ 8722D) l&t

Port Power

(HP

8722D,

Start Power [HP

871QD/2OD)

(Opt.

085)

conditioM

085)

Opt. 007)

400)

Network Analyzer Mode

Off

OH2

Off

OdB OdB

Linear Frequency

Off

t3t.EZt/stop cOntinuouf4

Off

100 ms, Auto Mode

6oMHz

13.51 GHz

20.05

40.05 GHz

1OOmS

6dBm

dBm

OdBm

-10

-6 dBm

-15.0

GHz

dBm

Preset

Valne

Preset

Cm~ditions

Start Power (HP

8719D/20D,

Start Power (BP

871QD/20D,

Start Power (HP

8722D)

Start Power (HP

8722D,

start Power (HF’ 8722D,

Power Span (HP

8719DLZOD)

Power

Spau

(HP

8722D)

Coupled Power Source Power

Coupled Channels Coupled Port Power Power Range Power Range

@Pt.

400)

Number of Points

Fhqnency List

Frequency List Edit Mode

Reaponae conditionB

Parameter

Conversion Format

Display

Color Selections

DualChannel

Active Channel

Opt. 007)

Opt. 400)

Opt. 007)

Opt. 400)

Channel 3: 512;

Channel4: 522 off

Log Magnitude

(all

Same a8 before Off Channel 1

Preset

-10.0

dBm

-20.0

dBm

-20.0

dBm

-15.0

dBm

-25.0

dBm

20 dB

On On On On Auto; Range 0 Auto; Range 1

201

Empty St=WfiP,

Number of

channel

Channel 2:

Data

Points

Sll; s21;

parameters)

Value

LpTeset)

HP4B Programming and Command Reference

‘Ihble

12-3. Preset Conditions (2 of 5)

Preset Conditions

kequency

Retrace Power Standard

!lkst ‘l&t

or 085) Intensity

Beeper: Done Beeper: Wamiug Off

D2/Dl

Title

IF Bandwidth IF Averaging Factor Smoothing Aperture Phase offset Electrical Scale/Division

CfdlbllltiOll

Correction Calibration Type

calibration

(HP Calibration Kit

(HP System ZO

Velocity

EXtA?IlSiOUS

ChopAandB

Power Meter Calibration

Blank Disabled

Set Switch Continuous Set Switch (Opt. 007

DeIay

Kit

8719D/‘20D)

8722D)

Factor

Port 1 Port 2 Input A Input B

Numberof

Readin@

Pretzet

Hold

Factory selected value is not changed by

Off Channel 1 = Channel 2 = Empty 3000 Hz 16; off 1%

SPAN; off

0 Degrees

OIlS 10 dB/Division

Off None

3.5 mm

2.4 mm

50 ohms

Off

OS OS OS

on Off

Value

set to 100%; user

(jjj.

bp]

Preset Conditions

Power Loss Correction

Sensor A/B

InterpoIated Error

Correction

Markers (coupled) Markers 1, 2, 3, 4, 5 Last Active Marker Reference Marker Marker Mode Display Markers Delta Marker Mode

coupling

Marker Search Marker

‘ILxrget

Value Marker Width Marker Tracking Marker Marker Marker Marker Statistics

PoIar

Marker

Smith Marker

Limit Lines

LimitLines

Limit

n?sting LimitList

Edit Mode

stimuhls

Amplitude Offset

LimitType

Beep Fail

Value

Stimuli Value O&t Aux

Offset

Offset (Phase)

oKset

Preset Off A

on1

GHZ;

AII Markers Off

None Continuous

Off

off

-3dB

-3dB;off

Off

OH2

DdB

Degrees

Off LinMkr

R+jX Mkr

Empty

Upper/Lower

OH2

DdB

Soping Line

Value

Limit9

InterpoIated

describes how to set the factory preset state of

Error Correction can be on or OK when the

anaIyzer

InterpoIated

is in the factory preset state. The User’s Guide

Error Correction.

HP-IB

Programming and Command Reference

l-5

‘Ihble

12-3. Preset Conditions (3 of 5)

Preset

oondaioM

Preset Viahe

Time Domain Transform

!lYramform fart.

Type

Transform

stop Transform

Gating

Gate

Bhape GateBtart

Gate Stop

Demodulation window Use Memory

ou Bandpass

-1

nano6econd 4nanosecond13 OE

Normal

-600

picosecond8

600 picoseconds OlT

Normal

ByLlJtelnParame~s

HP-IB

Addresses

HP-IB Mode

Clock Time Stamp Preset:

F’actoryNser

LastActiveBtate

Lai3tActiveBtate

Last Active

state

LastGelectedSt&4Z

bPY amtion

Parallel Port La8tActiveBtat.e

Plotbr Type

Plotter Port Plotter Baud Rate

?lotter

Handshake LmtActiveBtate

HP-IB

AddTess ?rinter’Ippe ?rinter

Port

?rint.er

Baud Rate

VnterHandshake Writer HP-IB Address

LastActiveBtate

hstActiveBtate

LastActiveBtate

LaetActiveBtate

LastActiveBtate

LastActiveBtate La8tActiveBtat.e hstActive&ate

LastActiveBtate

Preset oonditioM

Disk Save

Conliguration

t-w 8tore)

Data Array Raw Data Array Formatted Data Array Graphics

D-W

DirectorySize

Ewe Using

Select Disk Disk Fbrmat

9eqpencing2

Loop

Counter

l-l-LOUT

service HP-IB

3ource Pux

Modea D&no&c

Phase Lock

Input Resolution

k.nalogBusNode

Plot

?lot Data ‘lot Memory ‘lot Graticule ‘lot

l&t

‘lot

Marker

btofeed

‘lot

Quadnmt

kale

‘lot.

Bpeed

Preset

hhe

Off Off

Off

Default1 Binary

tnternal

Memory

LIP

lm iOOpOIl

11 (Aux Input)

1 The directory size is calculated es 0.013% of the floppy disk

Pres&g

preset turns off sequencing modify (edit) mode and

size

(which is

stops

any running sequence.

~266)

or 0.006% of the hard disk size.

Preset

Cmditiom

Pen Number:

ChllCh3 Data ChllCh3 Memory Chl/Ch3 ChllCh3 Graticule

ChllCh3 Ch2/Ch4 Ch2ICh4 Ch2lCh4 ch2/Ch4 !R?xt Ch2lCh4

Type:

ChlKh3

ChllCh3 Memory

Ch2Xh4 Data Ch2/Ch4

Marker

‘lbxt

Data

Memory

Graticule

Marker

Data

Memory

‘lhble

2 5

1 7 3 6

1 7 7

7 7 7 7

12-3. Preset Conditions (4 of 5)

Preset Value

Preset

Ckmditiom

Printer Mode Auto-Feed

Printer

cOlors CHlRh3 CHl/ChS CH2/Ch4 CH2Kh4 Mem

Graticule

W=Wt lkxt

F&f Line

Data Mem Data

Last Active State

Magenta

Seen

Blue

I&d =yan

Slack

3lack 3lack

Preset

Vahe

‘Ruble

12-3. Preset Conditions (5 of 5)

Format

Log

Wude

Phase (degree) Group Delay

Smith Chart Polar Linear Magnitude

Real

SWR

(ns)

lgble

Scale

10.0

90.0

10.0

1.00

0.1

0.2

1.00

Reference

PO&ion Iblue

5.0

0.0

5.0

0.0

1.0

0.0

1.0

HP-IB Programming and Command Reference

1-7

Analyzer Command Syntax

Code Naming Convention

The analyzer HP-IB commands are derived from their front-panel key titles (where possible), according to this naming convention:

Simple commands are the command name for power. If the function label contains two words, the

letters are the

Ilrst

three letters of the

first

four letters of the function they control, as in POWE, the

iirst

three mnemonic

first

word, and the fourth mnemonic letter is the

f&t

letter of the second word. For example, ELED is derived from electrical delay. If there are many commands grouped together in a category, as in markers or plotting pen

numbers, the command is increased to 8 letters. The

ilrst

4 letters are the category label and the last 4 letters are the function specifier. As an example, category pen numbers are represented by the command PENN, which is used in combination with several functions such as PENNDATA, PENNMEMO.

The code naming guidelines, listed in lhble

make commands more meaningful and easier to remember

maintain compatibility with other products (including the HP 8510)

Note

There are times when these guidelines are not followed due to technical

l-2,

are used in order to:

considerations.

‘able

Convention

ne Word

1-2.

Key

!lWe

Power Start

Code

Naming Convention

For HP-IB Code Use

First Four Letters

Example

POWE

Words

Two Words in a Group

Three Words

Electrical Delay

Search Right

Marker

+Center

Gate--span

CalKitN50Q

Pen Num Data

Three Letters of First Word,

of Second Word

Four

I&~KXS

Both

First Three Letters of First Word,

of Second Word, First Four Letters of Third Word

First

Letter ELED

First

Letter

MARKCENT GATESPAN

CALKN50

PENNDATA

FhsZ

Some codes require appendages (ON, OFF, 1, 2, etc). Codes that do not have a front-panel equivalent are HP-IB only commands They use a similar convention based on the common name of the function.

l-8

HP-IB Programming and Command Reference

Valid Characters

The analyzer accepts the following ASCII characters:

letters

numbers

decimal points

+I-

semicolons (;)

quotation marks

carriage returns (CR)

Iinefeeds (LF)

Both upper- and lower-case letters are acceptable. Carriage returns, leading zeros, spaces, and unnecessary terminators are ignored, except for those within a command or appendage. If the analyzer does not recognize a character as appropriate, it generates a syntax error message and recovers at the next terminator.

units

(“)

The analyzer can input and output data in basic units such as Hz,

Seconds

Volts

Hz DB

Input data is assumed to be in basic units (see above) unless one of the following

dB,

seconds,

Hertz

dBordBm

etc.

units

is used

(upper and lower case are equivalent):

MS Milliseconds US Microseconds NS Nanoseconds PS

Picoseconds

KHZ Kilohertz

MHZ Megahertz

GHZ Gigahertz

Femtoseconds

Command Formats

The

HP-II3

commands accepted by the analyzer can be grouped into five input-syntax types

The analyzer does not

distmguish

between upper- and lower-case letters

General Structure:

[unit]

The general syntax structure is:

[code] [appendage] [data]

The individual sections of the syntax code are explained below.

[terminator]

[code]

The root mnemonic (these codes are described in the ‘Alphabetical Mnemonic Listing” later in this chapter.)

[appendage1

A OFF (toggle a function ON or OFF), or integers, which specify one capability out of several. There can be no spaces or symbols between the code and the appendage.

qualiher

attached to the root mnemonic Possible appendages are ON or

HP-IB Programming and Command Reference

l-9

Idat4

A single operand used by the root mnemonic, usually to set the value of a function. The data can be a number or a character string. Numbers are accepted as integers or example, STAR 0.2E+lO ; sets the start frequency to 2

decimals,

with power of ten

speciiied

GHz).

Character strings

by E (for

must be enclosed by double quotation marks

For example:

A title string using

OuTp’(JT 7~~;ll~~~llllll~~~~~llll

where the first two

RMI3

BASIC would look like:

IIll

are an escape so that RMB BASIC will interpret the

ll;ll

third II properly.

The units of the operand, if applicable. If no units are specified, the analyxer

assumes

the basic units as described above. The data is entered into the

function when either units or a terminator are received.

[terminator]

The

specific

SYNTAX

TYPE

Indicates the end of the command, enters the data, and switches the active-entry area OFF. A semicolon

YIMninators

are not necessary for the analyzer to interpret commands correctly, but in the case of a syntax error, the analyxer at the next terminator. The analyxer also interprets line feeds and OR IDENTIFY

(EOI)

messages as terminators

(;)

is the recommended terminator.

wiIl

attempt to recover

HP-R3

syntax types are:

1: [code] [terminator]

END

These are simple action commands that require no complementary information, such as AUTO ; (autoscales the active channel).

SYNTAX TYPE 2:

These

are simple action commands requiring limited

CORROFF;

[code][appendage][terminator]

(error correction ON or OFF) or

FlEXAl;, RECA2;, RECA3; (recall register 1, 2, 3).

customixation,

such as

CORROhl ;

and

There can be no characters or symbols between the code and the appendage.

Note

In the

[D] must be 2 characters For example,

CLEAREGl

SYNTAX

TYPE

3: [code] [data]

These are data-input commands such as STAR 1.0 GHZ

folIowing

cases:

CLEAREG[D],

; will generate a syntax error.

[unit][terminator]

RECAREG[D],

CLEAREGO ;

;

(set the start frequency to 1

will execute, while

SAVEREG[D],

SYNTAX TYPE 4: [code] [appendage] [data] [terminator]

These are titling and marker commands that have an appendage, such as TITRi (title register 1

QUERY

SYNTAX:

‘lb

query a front-panel-equivalent

mnemonic (For example,

STATEl), TITR2 YEST2tB

[code][?]

ftmction,

POUE?, AVERO?,

(title register 2

TEST2).

append a question mark (?) to the root

or REAL?.) lb query commands with integer

appendages, place the question mark after the appendage.

l-10

HP-IB Programming and Command Reference

and EG[D],

GHx).

“STATEI”

HP-IB Operation

The Hewlett-Packard Interface Bus (HP-IB) is Hewlett-Packard’s hardware, software, documentation, and support for IEEE 488.2 and instruments. This interface allows you to operate the analyzer and peripherals in two methods:

by an external system controller

by the network analyzer in system-controller mode

Device Types

The HP-IB employs a party-line bus structure in which up to 15 devices can be connected on one contiguous bus. The interface consists of 16 signal lines and 8 ground lines within a shielded cable. With this cabling system, many different types of devices including instruments, computers, power meters, plotters, printers, and disk drives can be connected in

IEC-625

worldwide standards for interfacing

parallel.

Every

HP-II3

device must be capable of performing one or more of the following interface

functions:

Tblker

talker

is a device capable of transmitting device-dependent data when addressed to talk.

There can be only one active talker at any given time. Examples of this type of device include:

power meters

disk drives

voltmeters

counters

tape readers

The network analyzer is a

taIker

when it sends trace data or marker information over the bus.

Listener

A listener is a device capable of receiving device-dependent data over the interface when addressed to listen. There can be as many as 14 listeners connected to the interface at any given time. Examples of this type of device include:

printers

power supplies

signal generators

The network

analyzer

is a listener when it is controlled over the bus by a system controller.

Controller

A controller is

1. managing the operation of the bus

addressing talkers and listeners

There can be only one active controller on the interface at any time. Examples of controllers include desktop computers, minicomputers, workstations, and the network analyzer. In a

multiple-controller

only be one master and can regain active control at any time. The analyzer is an active controller when it plots, prints, or stores to an system controller when it is operating in the system-controller mode.

dehned

system, active control can be passed between controllers, but there can

system

as a device capable of:

controller connected to the interface. The system controller acts as the

external

disk drive in the pass-control mode. The analyzer is also a

l-1

HP-IB Programming and Command Reference

HP-IB Bus Structure

Figure l-l.

EP-IB

Bus Structure

Data Bus

The data bus consists of 8 bi-directional lines that are used to transfer data from one device to another. Programming commands and data transmitted on these lines are typically encoded in ASCII, although binary encoding is often used to speed up the transfer of large arrays Both ASCII- and binary-data formats are available to the analyzer. In addition, every byte transferred over HP-IB undergoes a handshake to insure valid data.

HandshakeLines

A three-line handshake scheme coordinates the transfer of data between talkers and listeners. To insure data integrity in multiple-listener transfers, this technique forces data transfers to occur at the transfer rate of the slowest device connected to the interface. With most computing controllers and instruments, the handshake is performed automatically, making it transparent to the programmer.

Control Lines

The data bus

also

has five control lines. The controller uses these lines to address devices and

to send bus commands. IFC (Interface Clear)

This line is used exclusively by the system controller. When this line is true (low), all devices (whether addressed or not) unaddress and revert to an idle state.

l-12

HP-IB Programming

and Command Reference

ATN (Attention)

The active controller uses this line to

the information on the data bus is command-oriented or

data-oriented. When this line is true (low), the bus is in the

command mode, and the data lines carry bus commands. When this line is false (high), the bus is in the data mode, and the data

SRQ (Service Request)

This and the active controller services the requesting device. The network analyzer can be enabled to pull the SRQ line for a variety of reasons such as requesting control of the interface, for the purposes of printing, plotting, or accessing a disk.

deline

whether

lines

carry device-dependent instructions or data.

line

is set true (low) when a device requests service

REN (Remote Enable)

This line is used exclusively by the system controller. When this line is set true (low), the bus is in the remote mode, and devices are addressed by the controller to either listen or talk. When the bus is in remote mode and a device is addressed, it receives instructions from the system controller via HP-IB rather than from its front panel (pressing m returns the device to front-panel operation). When this line is set false (high), the

bus and all of the connected devices return to local operation.

EOI (End or Identify)

This line is used by a talker to indicate the last data byte in a multiple-byte tr

ansmission,

a parallel-poll sequence. The analyzer recognizes the EOI line as a terminator, and it pulls the EOI line with the last byte of a message output (data, markers, plots, prints, error messages). The analyzer does not respond to parallel poll.

HP-IB Requirements

Number of Interconnected Devices: Interconnection Path

Maximu

Cable Length:

Message Transfer Scheme:

15 maximum. 20 meters maximum or 2 meters per device

(whichever is less). Byte serial, bit parallel asynchronous data

transfer using a

or by an active controller to initiate

3-line

handshake system.

Data Rate:

Address Capability:

Multiple-Controller Capability:

Maximum of 1 megabyte-per-second over the

spetied

distances with tri-state drivers Actual data rate depends on the transfer rate of the slowest device connected to the bus

Primary addresses: 31

maximu

of 1 talker and 14 listeners can be

talk,

31 listen. A

connected to the interface at given time. In systems with more than one controller (such

as this instrument), only one controller can be active at any given time. The active controller can pass control to another controller, but only the system controller can assume unconditional control. Only one wm controller is allowed.

HP-IB Programming and Command Reference

l-13

HP-IB Operational Capabilities

On the network analyzer’s rear panel, next to the HP-IB connector, there is a list of HP-IB device subsets as capabilities:

delined

by the IEEE 488.2 standard. The analyzer has the following

SHl

AH1 T6 L 4

SRl RLl

PPO DC1

DTl

Cl,C2,C3

Cl0

LEO TEO

Pull-source handshake. Pull-acceptor handshake. Basic talker, answers serial poll, unaddresses if MLA is issued. No talk-only mode. Basic listener, unaddresses if MTA is issued. No listen-only mode. Complete service request (SRQ) capabilities. Complete remote/local capability including local lockout. Does not respond to parallel poll. Complete device clear Responds to a Group Execute Trigger (GET) in the hold-trigger mode. System controller capabilities in system-controller mode. Pass control capabilities in pass-control mode.

T&state

drivers No extended listener capabilities. No extended talker capabilities

These codes are completely explained in the IEEE Std 488 documents, published by the Institute of Electrical and Electronic Engineers, Inc, 345 East

47th

Street, New York,

New York 11017.

1-14 HP-IB Programming and Command Reference

BP-IB Status Indicators

When the analyzer is connected to other instruments over the HP-IB, the HP-IB status indicators illuminate to display the current status of the analyzer. The HP-IB status indicators are located in the instrument-state function block on the front panel of the network analyzer.

R = Remote Operation L = Listen mode T = Talk mode S = Service request (SRQ) asserted by the analyzer

Bus Device Modes

The analyzer uses a single-bus architecture. The single bus allows both the analyzer and the host controller to have complete access to the peripherals in the system.

Three different controller modes are possible in and

system-controller mode

talker/listener mode

pass-control mode

GRAPHICS PLOTTER

HP-16

PRINTER

HP-II3

system:

DISK DRIVE

HOST CONTROLLER

Figure

l-2.

NETWORK ANALYZER

Analyzer Single Bus Concept

HPJB Programming and Command Reference

l-15

System-Controller Mode

This mode allows the analyzer to control peripherals directly in a stand-alone environment (without an external controller). This mode can only be selected manually from the

analyzer’s front panel. It can only be used if no active computer or instrument controller is connected to the system via HP-IB. If an attempt is made to set the network analyzer to the system-controller mode when another controller is connected to the interface, the following

message is displayed on the analyzer’s display screen:

"ANOTHER SYSTEM CONTROLLER ON HP-IB BUS"

The analyzer must be set to the system-controller mode in order to access peripherals from the front panel. In this mode, the analyzer can directly control peripherals (plotters, printers, disk drives, power meters, etc) and the analyzer may plot, print, store on disk or perform power meter functions

Note

Do not attempt to use this mode for programming. HP recommends using an external instrument controller when programming. See the following section,

“lhIker/Listener

Mode.

‘Ih&erListener Mode

This is the mode that is normally used for remote programming of the analyzer. In talker/listener mode, the analyzer and all peripheral devices are controlled from an external instrument controller. The controller can command the analyzer to talk and other devices to listen. The analyzer and peripheral devices cannot talk directly to

each

other unless the computer sets up a data path between them. This mode allows the analyzer to act as either a talker or a listener, as required by the controlling computer for the particular operation in progress.

Pass-Control Mode

This mode

allows

the computer to control the analyzer via

HP-LB

(as with the talker/listener mode), but also allows the analyzer to take control of the interface in order to plot, print, or access a disk. During an analyzer controlled peripheral operation, the host computer is free to perform other internal tasks (i.e. data or display manipulation) while the analyzer is controlling the bus After the analyzer-controlled task is completed, the analyzer returns control to the

system

Note

controller.

Performing an

instrument

preset does not affect the selected bus mode, although the bus mode will return to talker/listener mode if the line power is cycled.

Note

“Specifications and Measurement Uncertainties” in the

Network

AnuZ~zm

User’s

Guide

provides information on setting the correct bus

HP 8719~A2OWZ?~

mode from the front-panel menu.

Analyzer Bus Modes

As discussed earlier, under control, the analyzer can operate in one of three modes: talker/listener, pass-control, or system-controller mode.

taIker/Iistener

mode, the analyzer can make a plot or print using the

mode, the analyzer behaves as a simple device on the bus. While in this

OUTPPLOT;

OUTPPRIN

; commands The analyzer will wait until it is addresses to talk by the system controller and then dump the display to a plotter/printer that the system controller has addressed to listen. Use of the commands

l-16

PLOT ;

HP-IB Programming and Command Reference

and

PRINALL ; require control to be passed to another controller.

In pass-control mode, the analyzer can request control from the system controller and take control of the bus if the controller addresses it to take control. This allows the analyzer to

take control of printers, plotters, and disk drives on an as-needed basis. The analyzer sets

event-status register bit 1 when it needs control of the interface, and the analyzer will transfer control back to the system controller at the completion of the operation. It will pass control

back to its controller address, specified by ADDRCONT. The analyzer can also operate in the system-controller mode. This mode is only used when

there is no remote controller on the bus. In this mode, the analyzer takes control of the bus, and uses it whenever it needs to access a peripheral. While the analyzer is in this mode, no other devices on the bus can attempt to take control. Specifically, the REN, must remain unasserted, and the data lines must be freed by

all

but the addressed

ATN,

and IFC lines

taIker.

Setting HP-IB Addresses

In systems interfaced using HP-IB, each instrument on the bus is address This address code must be different for each instrument on the bus. These addresses

are stored in short-term, non-volatile memory and are not affected when you press

cycle the power.

Note

The analyzer addresses are set by pressing m the addresses must be set for the plotter, printer, disk drive, and power meter.

The default address for the analyzer is device 16, and the display address is device 17.

Note

Response to HP-IB Meta-Messages

The analyzer occupies two HP-IB addresses: the instrument itself and the display. The display address is derived from the instrument address by complementing the instrument’s least-significant bit. Hence, if the instrument is at an even address, the display occupies the next higher address. If the instrument is at an odd address, the display occupies the next lower address

.~~~~~~~~.

_..._.._

- . . - .

.._..... - - - .._ -.

There is also an address for the system controller. This address refers to the

controller when the network analyzer is being used in pass-control mode. This

is the address that control is passed back to when the analyzer-controlled

operation is complete.

(IEEE-488

Universal Co

identilied

. . . . . . . . . . . . . . . .

In system-controller mode,

by an

HP-B3

-W

Abort

The analyzer responds to the abort message (IFC) by halting all listener, talker, and controller functions

Device Clear

The analyzer responds to the device clear commands (DCL, SDC) by clearing the input and output queues, and clearing any HP-IB errors. The status registers and the error queue are unaffected.

Local

The analyzer will go into local mode if the unasserted, or the front-panel local key is pressed. Changing the analyzer’s HP-IB status from remote to local does not affect any of the front-panel functions or values.

local

command (GTL) is received, the remote line is

HP-IB Programming and Command Reference

l-17

Local Lockout

If the analyzer receives the local-lockout command

(LLO)

while it is in remote mode, it will disable the entire front panel except for the line power switch. A local-lockout condition can only be cleared by releasing the remote line, although the local command (GTL) will place the instrument temporarily in local mode.

Parallel Poll

The analyzer does not respond to parallel-poll conhgure (PPC) or parallel-poll

unconhgure

(PPU)

messages.

If the analyzer is in pass-control mode, is addressed to talk, and receives the take-control

command

(TCT),

from the system control it will take active control of the bus. If the analyzer

is not requesting control, it will immediately pass control to the system controller’s address.

Otherwise, the analyzer will execute the function for which it sought control of the bus and then pass control back to the system controller.

Remote

The analyzer will go into remote mode when the remote line is asserted and the analyzer is addressed to listen. While the analyzer is held in remote mode, exception of

=I)

are disabled. Changing the analyzer’s HP-IB status from remote

ail

front-panel keys (with the

local

does not affect any front-panel settings or values.

Serial Poll

The analyzer will respond to a serial poll with its status byte, as Reporting” section of this chapter. talk and issue a

serial-polI

enable command (SPE). Upon receiving this command, the analyzer

‘RI

initiate the serial-poll sequence, address the analyzer to

dehned

in the “Status

will return its status byte. End the sequence by issuing a serial-poll disable command (SPD). A serial poll does not affect the value of the status byte, and it does not set the instrument to remote mode.

Trigger

In hold mode, the analyzer responds to device trigger by taking a single sweep. The analyzer responds only to selected-device trigger execute-trigger (GET) unless it is addressed to listen. The analyzer will not respond to GET if it is not in hold mode.

(SDT).

This means that it will not respond to group

l-18

HP-IB Programming and Command Reference

Analyzer Operation

Operation Complete

Occasionally, there is a need to know when certain analyzer operations have been completed. There is an operation-complete function (OPC) that the execution of certain key commands This mechanism is activated by issuing OPC ; or OPC? ; prior to an OPC-compatible command. The status byte or ESR operation-complete bit

be set after the execution of the OPC-compatible command. For example, issuing OPC

causes the OPC bit to be set when the

single

sweep is

the OPC ; causes the analyzer to output a one (1) when the command execution is complete. The analyzer completed. For example, executing OPC? causes the bus to

wiII halt

halt untiI

the computer by not transmitting the one (1)

; PRES

the instrument preset is complete and the analyzer outputs a one

(1).

As another example, consider the timing of sweep completion. Send the command string SWET

S; OPC? ; SING; to the analyzer. This string sets the analyzer sweep time to 3 seconds, and

then waits for completion of a

single

sweep to respond with a one (1). The computer should be programmed to read the number one (1) response from the analyzer indicating completion of the

single

sweep. At this point a

valid

trace exists and the trace data could be read into the

computer.

‘Ihble

1-3. OPGcompatible

ahows

a synchronization of programs with

wiII

then

;

SING;

Iinished.

Issuing OPC? ; in place of

until

the command has

; , and then immediately querying the analyzer

Chnmands

AUXC<ONIOFF> CHANl

CHANB

cHAN31 cHAN41

CLASS1 1A2 CLASS1 1B2 cLASS11c2 CLASS22A2 CLASS22B2

cLAss22c2

CLEA<l

5> CLEARALL

CLEAREG<Ol to 31) DATI

EXTTOFF EXlTON

EX’ITPOIN RESPDONE

FREQOFFS<ONJOFF>

FWD12 FWDM2

REVI REVM2

REVT2 FWDT2 GkI’EO<ONIOF’F>

INSMNETA

INSMTUNR

ISOD MANTRIG

NOOP NUMG

PRES

RAID

RECA<l RECAREG<Ol

31>

REFD

SAVl

SAV2

SAVC

SAVE<1

SAVEREG<Ol to 31>

SAVT

SING

SLIS STAN<A

to G>

SWI’START

WAIT

1TheSecOmmands are not queriable, but the active channel may be found by OUTPCHAN.

2Theclassco

mmands

are OPC-comptible if there is only one standard in the class.

HP-IB Programming and Command Reference

l-19

+ 219 hidden pages

Agilent 8719D Programming Guide

Specifications and Main Features

Frequently Asked Questions

User Manual

Notice

Assistance

How to Use This Guide

Network Analyzer Documentation Set

Where to Look for More Information

Preset State

Analyzer Command Syntax

Code Naming Convention

Valid Characters

units

Command Formats

HP-IB Operation

Device Types

talker

Listener

Controller

HP-IB Bus Structure

HP-IB Requirements

HP-IB Operational Capabilities

Bus Device Modes

Pass-Control Mode

Analyzer Bus Modes

Setting HP-IB Addresses

Analyzer Operation

Operation Complete