Agilent 83480A Programmer's Quick Reference

Programmer's Quick Reference

HP

83480A

Analyzer

,

HP 54750A Oscilloscope

HP part number: 83480-90024

Printed in USA July 1997

Hewlett-Packard Company

Santa Rosa Systems Division

1400 Fountaingrove Parkway

Santa Rosa, CA 95403-1799, USA

[phone]

Notice

This manual and any information contained herein are provided \as is"

not

but

particular

a

furnishing,

the

no

limited

herein

subject

are

and

warranty

,

to

purpose

for

of any

implied

the

Hewlett-P

.

incidental

performance

change

to

kind

warranties

ackard

consequential

or

use

or

,

with

of

without

regard

merchantability

of

shall

material.

this

notice

this

to

be

not

damages

Hewlett-P

.

material,

liable

connection

in

and

for

ackard

including

tness

errors

makes

for

contained

with

or

c



Copyright Hewlett-P

ackard Company 1997

All Rights Reserved. Reproduction, adaptation, or translation without prior

written permission is prohibited, except as allowed under the copyright laws.

About This Quick Reference

This quick reference is intended for use by the experienced programmer.It

contains a listing of all the programming commands. Refer to the

HP 54750A Programmer's Guide

for detailed programming information.

HP 83480A,

The following notation conventions are used in this book:

computer

type

AL

CAPIT

LETTERS

>

<

]

[

g

f

j

All characters appearing in

computer type

and must be entered exactly as shown.

Capital

letters

indicate

actual command

upper or

lowercase.

Characters appearing

dened in

are

that

Square

brackets

Braces

brackets

is

are

indicate

optional.

to

used

the

case sensitive

is not

in angular

the programmer's

whatever

that

clarify

which

brackets

elements

form

short

from.

<

one

>

a

\Or",

(for

indicates

example

exactly

<

j

>

b

of

indicates

choice

a

>

a

<

,

both).

command.

a

of

and can

indicate

.

guide

occurs

are

element

b

<

or

are key words

The

entered

be

values

be

from

the

chosen

list

a

not

within

to

but

>

in

3

4

Contents

Common Commands

Root Level Commands

System Commands

Acquire Commands

Calibration Commands

Channel Commands

Disk Commands

Display Commands

Commands

FFT

Function

Hardcopy

Histogram

Limit

Marker

Mask

Measure

Pixel

Service

Timebase

Trigger

TriggerN

Waveform

Waveform

Commands

Commands

Commands

Commands

est

T

Commands

Commands

est

T

Commands

Memory

Commands

Commands

Commands

Commands

Commands

Memory Commands

::::::::::::::::::::::::::::::::::::::::::::::::::::::

::::::::::::::::::::::::::::::::::::::::::::::::::::::

::::::: ::::::: ::::::: :::::: ::::::: ::::::: :::::: ::::::: :::

::::::::::::::::::::::::::::::::::::::::::::::::::::::

:

:

:

:

:

:

Commands

:

::

::::: ::::::: ::::::: :::::: ::::::: ::::::: :::::: ::::::: ::

::::: ::::::: :::::: ::::::: ::::::: :::::: ::::::: :::::::

::::::: ::::::: :::::: ::::::: ::::::: :::::: ::::::: ::::

:::::: :::::: ::::::: ::::::: :::::: ::::::: ::::::: :::::: :

::

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

::

::

::

::

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

::

::

::

::

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

::

::

::

::

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

::

::

::

::

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

::

::

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

::

::

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

::

::

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

::

::

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

::

::

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

::

::

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

::

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

::

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

::

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

::

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

::

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

::

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

::

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

::

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

::

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

::

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

::

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

::

::

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

::

::

::

::

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

::

::

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

::

::

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

::

::

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

::

::

::

::

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

::

::

::

::

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

::

::

:

:

:

:

:

:

:

:

:

:

:

:

:

:

::

::

::

::

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

:

::

::

7

9

12

13

14

17

19

20

23

24

:

27

:

29

:

31

:

35

:

37

:

44

:

52

:

53

:

54

56

:

57

:

58

62

:

5

6

Common Commands

*CLS

Clears the status data structures and the Request-for-OPC ag.

*ESE[?]<mask

>

Sets the Standard Event Status Enable Register bits.

*ESR?

Reads

the

Standard

Event

Status

Register

.

*IDN?

option,

string)

,

that

Returns

software

*LRN[?]

Sends

current

the

version.

setup

<

response

a

setup

instrument

>

message

.

model

(learn

number

*OPC[?]

Sets

the

operation

complete bit

when all

pending

nished.

*RCL

<

register

Recalls

>

the state

instrument from

of the

the specied

*RST

Places the instrument in a known state.

*SAV<register

>

serial

contains

device

number

the

,

instrument's

operations

save/recall

and

register

have

.

current

Stores

*SRE

the

>

mask

]

<

?

[

Sets the Service

*STB?

Reads the Status Byte

state of

instrument

the

in

Request Enable Register bits

.

save/recall

a

.

register

.

7

Common Commands

*TRG

Has the same eect as the Group Execute Trigger message (GET) or RUN

command.

*TST?

Causes the instrument to perform a self-test and places a result in the

output queue.

*WAI

Prevents the instrument from executing any further commands or queries

until all currently executing commands are completed.

8

Root Level Commands

:AER?

Reads the Arm Event Register.

:AUToscale

Causes the instrument to evaluate all input signals and to nd the

optimum conditions for displaying the signal.

:BLANKfCHANnel<number>j

FFT

j

an

>

active

channel,

PMEMory

Turns

FFT

number

<

o

histogram.

or

,

FUNCtion<number>j

HISTogram

j

function,

:CDISplay

Clears

:DIGitize

Initializes

acquires

then

PMEMory

:ERASe

[

Erases

]

[

:HEEN

?

the

the

mask

<

<

[

the

display

waveform

specied

and

selected

them

<

number

>

[,

]

>

name

channels

,

according to

>

]

pixel memory

<

all

resets

Sets the Histogram Event Enable register.

:HER?

Reads the Histogram Event Register.

:LER?

Reads

:LTEE

?]<

[

the

mask

Local

>

(LCL) Event

Register

g

waveform

associated

waveform

functions

current

the

.

.

WMEMory<number>j

memory

measurements

]

>

name

to

FFT

or

,

instrument

,pixel

memory,

.

\unacquired,"

settings

.

and

Sets the Limit T

:LTER?

Returns the Limit T

est Event Enable register

est Event Register

.

.

9

Root Level Commands

:MENU[?]f

APPLicationjCHANnel<number>j

ACQuirejTIMebase

j

TRIGgerjDISKjDISPlayjMARKerjMEASurejMATHjWAVeformjSETup

PRINtjHELPjUTILityjFFTjLTEStjHISTogramjMTEStjMEYE

g

Selects one of the menus on the front panel.

:MERGe[PMEMory<number>]

Stores the active display into the pixel memory.

:MODel?fFRAMejPLUGin<number>g

Returns the HP model number for the frame or plug-in.

:MTEE[?]<

Sets

the

mask

Mask

>

Event

Enable

register

.

:MTER?

Reads

:OPEE

Sets

]

?

[

the

mask

<

Operation

the

Mask

>

Event

Status

Register

.

Enable

register

.

:OPER?

Reads

Operation

the

Status

Register

.

:PRINt

j

Outputs

specied

a

Hardcopy

the

in

screen

the

of

copy

:RECall:SETup<setup num

printer

a

to

subsystem.

>

or

other

device

destination

Recalls a setup.

:RUN

Places the instrument in the running state, in which waveforms are

acquired

:SERial

Sets the

settings

number

]

?

[

according

FRAMe

f

to

PLUGin

j

the

current

<

serial number for the instrument frame or plug-in.

.

>

string

<

,

g

>

:SINGle

Causes the instrument to make a single

event occurs

.

acquisition when the next trigger

10

Root Level Commands

:STOP

Causes the instrument to stop acquiring data for the active display.

:STORe:PMEM1 PMEM1

Stores the current display in pixel memory 1.

:STORe:SETup<setup num

>

Saves the current instrument setup in setup memories 0 through 9.

:STORe:WAVeformfCHANnel<number>j

WMEMory<number>j

channel,

Copies

waveform

:TEER

Sets

a

memory

]

?

[

Trigger

the

HISTogramjFFTg,fWMEMory<number>g

function,

stored

.

Event

Enable

Register

FUNCtion<number>j

waveform,

histogram,

.

or

:TER?

.

register

.

:UEE

Reads

]

?

[

Sets

<

the

the

mask

User

Trigger

>

Event

Event

Enable

Register

:UER?

Event

User

the

Reads

number

:VIEW

CHANnel

f

<

PMEMory<number>j

Register

>

HISTogramjFFT

.

FUNCtion

j

number

<

g

j

>

WMEMory

Turns on a channel, function, pixel memory, waveform memory,

histogram, or FFT.

FFT

<

number

to

a

>

j

11

System Commands

:SYSTem:DATE[?]<

day>,<month>,<year

>

Sets the date in the instrument.

:SYSTem:DSP[?]<

string

>

Writes a quoted string, excluding quotes, to the advisory line of the

instrument display.

:SYSTem:ERRor?[f

Outputs the

:SYSTem:HEADer

Species

responses

whether

.

:SYSTem:KEY

Simulates

:SYSTem:LONGform

Species

the

:SYSTem:SETup

up the

Sets

controller.

the

:SYSTem:TIME[?]<

NUMBerjSTRingg]

f

ON

the

code

ON

f

]

?

for

binary

number in

OFF

j

j

1

instrument

>

specied

a

of

j

1

j

query

block

dened by

next error

?

]

[

key

<

]

?

[

pressing

the

[

format

<

]

?

[

instrument, as

hour>,<minute>,<second

the error

g

0

j

will

0

j

OFF

response

data

queue

output

front-panel

g

headers

>

the data

>

header

a

.

in

key

the

over

.

the

for

setup

query

HP-IB

string

.

from

Sets the time in the instrument.

12

Acquire Commands

:ACQuire:AVERage[?]fONj1j

OFFj0

Controls averaging.

:ACQuire:BESTfTHRuputjFLATness

Improves step atness.

:ACQuire:COUNt[?]<

number

the

Sets

:ACQuire:POINts

Species

the

of

]

?

[

requested

HP 54750A only.

value

>

j

.

points

<

averages

AUTO

f

record

length

g

g

value

for

g

>

acquisition.

an

13

Calibration Commands

:CALibrate:FRAMe:CANCel

Is equivalent to pressing the Cancel softkey when in the front-panel

Calibrate Frame menu. This command cancels the calibration on the

instrument mainframe.

:CALibrate:FRAMe:CONTinue

Is equivalent to pressing the front-panel CONTINUE softkey when in the

calibration

Calibration

instrument

Frame

mainframe

menu.

:CALibrate:FRAMe:DATA

Sends

the

FRAMe

data

This

command

continues

.

>

factors

cal

<

]

?

[

instrument.

the

to

the

:CALibrate:FRAMe:DONE?

pass/fail

Returns

the

:CALibrate:FRAMe:LABel

string of

ccepts

A

frame

notes

a

calibration

as name/initials

such

,

status

up

status

<

]

?

[

characters

80

to

screen and

of the

label

>

is

It

.

is optional.

calibrator

displayed

is

It

special

or

part

as

intended

notes

of

for

about

calibration.

frame

last

the

of

calibration.

the

user

on

the

the

:CALibrate:FRAMe:MEMory?

Returns the state of the frame calibration write-protect switch.

:CALibrate:FRAMe:STARt

Starts the annual calibration on the instrument mainframe.

:CALibrate:FRAMe:TIME?

Returns

calibration

the

process

, time

date

:CALibrate:OUTPut[?

was

]

and

<

value

temperature

completed.

>

at

which

the

frame

full

last

Sets the dc level of the calibrator signal output through the front-panel

CAL connector

.

14

Calibration Commands

:CALibrate:PLUGin:ACCuracyfSLOT1jSLOT2jSLOT3jSLOT4

Sets the plug-in calibration accuracy level.

:CALibrate:PLUGin:CANCel

Is equivalent to pressing the front-panel Cancel softkey when in the

Calibrate Plugin menu. This command cancels the calibration on a

selected slot (plug-in).

:CALibrate:PLUGin:CONTinue

Is equivalent to pressing the front-panel Continue softkey when in the

Calibrate Plugin menu. This command continues the calibration on a

(plug-in).

selected

slot

:CALibrate:PLUGin:DONE?

Returns

the

pass/fail

status

:CALibrate:PLUGin:MEMory?

Returns

specied

the

slot.

plug-in

the

of

state

:CALibrate:PLUGin:OFFSet

Sets

the

plug-in

calibration

the

of

SLOT1

f

CHAN1

f

oset.

last

SLOT2

j

memory

CHAN2

j

plug-in

calibration.

SLOT3

j

write-protect

CHAN3

j

j

SLOT4

j

switch

CHAN4

g

:CALibrate:PLUGin:OPOWer

g

in

g

the

plug-in

the

Sets

:CALibrate:PLUGin:OPTical

WAV2jUSER

]

calibration.

CHAN1

f

CHAN2

j

Starts the plug-in optical calibration sequence.

:CALibrate:PLUGin:OWAVelength<wavelength

Sets the plug-in calibration wavelength.

SLOT3

at

j

which

:CALibrate:PLUGin:TIME?

Returns

the

specied slot,

, time

date

was last calibrated.

and

SLOT1

f

j

temperature

SLOT2

:CALibrate:PLUGin:VERTicalfSLOT1jSLOT2

Starts the plug-in electrical calibration sequence

CHAN4

CHAN3

j

j

>

j

SLOT4

plug-in,

the

j

SLOT3jSLOT4

.

j

WAV1

[

,

g

g

the

in

g

15

Calibration Commands

:CALibrate:PROBEfCHAN1jCHAN2jCHAN3jCHAN4

Sets the plug-in probe calibration factor.

:CALibrate:SAMPlersfDISablejENABle

Enables or disables samplers for service.

:CALibrate:SKEW[?]f

Sets the channel-to-channel skew factor for channel N.

:CALibrate:STATus?

Returns the calibration status of the instrument.

CHANnel<N>g,<

g

skew

>

g

16

Channel Commands

:CHANnel<number>:AUToscale

Causes the instrument to evaluate the input signal and to nd the

optimum vertical scale for displaying the signal.

:CHANnel<number>:BANDwidth[?]f

HIGHjLOW

g

Controls an internal low-pass lter if one is present in the channel

hardware.

g

0

j

OFF

j

1

j

ON

f

]

to on

lters

one

?

[

?

[

or o.

A.04.00

and

internal

ON

f

]

lter

FILTer

and

brief

a

low-pass

OFF

j

1

j

one

if

lter

<

and above

.

above

description

lter

g

0

j

present

is

number

.

lter

each

of

.

channel

the

in

>

:CHANnel

<

Sets the

equires

R

<

:CHANnel

Returns

channels

:CHANnel

<

Controls

hardware

:CHANnel

<

equires rmware

R

number

:DISPlay

>

specied channel

:FDEScription?

number

with

internal

>

more

:FILTer

>

revision

of

than

low-pass

number

rmware

the

number

an

.

:FSELect

number

>

revision A.04.00

Selects which lter is controlled by on/o for channels with more than

one internal low-pass lter.

:CHANnel<number>:OFFSet[?]<

oset value

>

Sets the voltage that is represented at center screen for the selected

channel.

for

:CHANnel

number

<

:PROBe

>

]

<

?

[

attenuation

factor

Sets the probe attenuation factor and, optionally

attenuation factor

.

:CHANnel<number>:PROBe:CALibrate

Starts the probe's calibration for the selected channel.

DECibel

j

RATio

f

[,

>

, the units for the

]

g

probe

17

Channel Commands

:CHANnel<number>:RANGe[?]<

range value

>

Sets up acquisition and display hardware to display the waveform at a

given full-scale range.

:CHANnel<number>:SCALe[?]<

scale value

>

Denes the vertical scale of the channel in units per division. This

command is the same as the front-panel channel scale.

:CHANnel<number>:SKEW[?

]

Sets the skew.

:CHANnel<number>:UNITs[?]f

vertical

in

work

to

Allows

changes

UNKNown.

(such

:CHANnel

Species

:CHANnel

:CHANnel

Species

compensate

you

the name

RANGe

as

number

<

a

<

number

<

a

the

of

are

units

The

OFFSet).

and

:UNITs:ATTenuation

>

indicates

that

ratio

:UNIT

number

constant

for

>

:UNITs:OFFSet

>

value

oset.

any

VOLT | AMPerejWATTjUNKNown

volts

than

other

units

AMP

to

T

OL

V

from

implied

how

relates

s

volts

in

units

for

?

[

that

other

]

?

[

unit specied

the

to one

oset

]

<

will be

pertinent

attenuation

<

volt.

>

added to

Y-axis

units command

The

.

,

ere

channel

>

in

the

W

signal

g

or

,

TT

A

commands

to

:CHANnel

Sets

number

<

wavelength

the

:WAVelength

>

selection

[

for

optical

channels

.

The

HP

83487A

USER

g

j

WAV2

j

WAV1

f

]

?

plug-in module will have one factory calibration; all other optical modules

will have two.

18

Disk Commands

:DISK:DELete\<

lename>"

Deletes a le from the disk. An error is displayed on the screen if the

requested le does not exist.

:DISK:DIRectory?

Returns the directory listing of the currently installed disk. Each entry is

63 bytes long, including a carriage return and line feed.

:DISK:FORMat

to

is

that

disk

the

>

one

<

sux.

a

and

that

]

database

a

the

by

is

format

mask,

a

,

le

is

not

>

The

format

issued.

or

,

lename

present.

]

pixel

or

sux

specied.

a pixel

sux

The

memory

supplied

is

memory

if one

database may

Formats

formatted

:DISK:LOAD

Restores

disk.

the

be

or

loaded

present

only

:DISK:STORe

Stores

disk.

a

The

instrument

a disk

in the

is

<

lename

\

setup

a

The

by

source

<

,

setup

lename

depending

in the

drive when

waveform,

a

,

of

type

destination

the

internal

in

>

waveform,

a

does

drive.

>

"[,

le

\

,

on

<

is

It

the

destination

<

a

determined

is

eld

format.

lename

database

a

include

not

source

the

assumed

command

mask,

if

"[,

>

be

to

by

from

is

the

the

19