Agilent 83711A Programming Manual

Notice

Hewlett-Packard to Agilent Technologies Transition

This documentation supports a product that previously shipped under the Hewlett­Packard 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

Contacting Agilent

By internet, phone, or fax, get assistance with all your test and measurement needs.

Table 1-1 Contacting Agilent

Online assistance: www.agilent.com/find/assist
United States

(tel) 1 800 452 4844

New Zealand

(tel) 0 800 738 378
(fax) ([phone]

Latin America

(tel) [phone]
(fax) [phone]

Japan

(tel) ([phone]
(fax) ([phone]

Canada

(tel) 1 877 894 4414
(fax) [phone]

Australia

(tel) 1 800 629 485
(fax) ([phone]

Asia Call Center Numbers

Country Phone Number Fax Number

Singapore 1-800-375-8100 (65) 836-0252
Malaysia 1-800-828-848 1-800-801664
Philippines (632) 8426802

1-800-16510170 (PLDT
Subscriber Only)

Thailand [phone] (outside Bangkok)

[phone] (within Bangkok)
Hong Kong 800-930-871 (852) 2506 9233
Taiwan 0800-047-866 (886) 2 25456723
People’s Republic

of China

800-810-0189 (preferred)

10800-650-0021

(632) 8426809
1-800-16510288 (PLDT
Subscriber Only)

(66) 1-661-3714

10800-650-0121

Europe

(tel) ([phone]
(fax) ([phone]

India 1-600-11-2929 000-800-650-1101

Programming

Guide

HP

83711A/12A

HP 83711B/12B

Synthesized CW

Generators

and

HP

part

Printed

Notice.

The

information

notice

.

number:

in

US

A

83711-90132

April,

contained

1995

in

Supersedes

this

document

5960-7089

is

subject

to

change

without

Hewlett-P

including

tness

for

contained

with

the

ackard

but

not

a

particular

herein

makes

limited

or

furnishing,

no

warranty

to

,

the

purpose

for

incidental

performance

implied

.

Hewlett-P

or

,

or

of

any

kind

warranties

ackard

consequential

use

of

this

with

regard

of

merchantability

shall

not

damages

material.

be

to

liable

in

this

material,

and

for

errors

connection

c



Copyright Hewlett-Packard Company 1995

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

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

1400 F

ountaingrove P

arkway, Santa Rosa, CA 95403-1799, US

A

.

The

HP 83711A/12A

and HP

83711B/12B

Synthesized

The

HP 83711A/12A

referred

has

has

information

HP

This

commands

to as

\synthesizers" throughout

a carrier

a carrier

frequency range

frequency range

can be

found in

83711B/12B Synthesized

programming guide

used

to

program

Notes

1. This

2.

If

HP

3.

T

o

manual applies

you have

83711A/12A

view rmware

an

HP

Synthesized C

revision,

to

83711A/12A

CW

and HP

provides

instruments

W

press

Generators

83711B/12B

Synthesized

this

of 1

GHz

to

20

of 10

MHz

to

20

Chapter 4

CW

the

synthesizer

with

instrument

Generator

4

SPCL

in

the

Generators

specic,

rmware

with

revision

rmware

Programmer's

5

5

,

,

4

4

1

HZ

detailed

.

5

manual.

GHz

GHz.

HP

User's

10.0

revision

Reference

(ENTER).

CW

Generators

The

HP

and

the

HP

Complete

83711A/12A

Guide

.

information

or

greater

.

number

<

(5960-7089).

are

83711A/11B

83712A/12B

specication

and

about

the

10.0,

refer

to

the

iii

In

This Book

This

book provides

programming

Information



Chapter 1,

information,

Instruments



Chapter

2,

programming

subdivided

example

one



Chapter

that

list

,

tabbed

3,

might

contains

is divided

all

information about

the synthesizer

\Getting Started

introduces the

(SCPI), and

\Programming

commands

into

sections

commands

section.

\Error

be

Messages,"

generated

a

sequence

condition.



Chapter

4,

\HP

8673

compatibility information.

, error

into chapters

Programming," contains

Standard Commands

provides

Commands

used

by

that

contain

related

to

contains a

during use

that can

Compatibility

the

various

messages

,

as follows:

example

the

programs

,"

contains

synthesizer

groupings

automatic

list

of the

instrument.

be followed

Guide

,"

commands

and

regulatory

general

for Programmable

.

entries

.

This

of

related

level

control

of

all

of

the

to

recover

contains

HP

used

information.

on

all

chapter

commands

are

error

Each

entry

from

8673

in

HP-IB

of

the

is

.

grouped in

messages

in

the

the

error

to

SCPI

F

or



Chapter

5,

information. The

iv

\Legal

and

product warranty

Regulatory

Information,"

is

also

contained

contains

in

SCPI

this

conformance

chapter

.

Contents

1.

Getting

HP-IB

In

Instrumen

HP-IB

Programming

HP-IB

Abort

Remote

Lo

Lo

Clear

Output

En

Getting

Denitions

Standard

How to Use Examples

Essentials for Beginners

Program and Response Messages

Started

General Information

terconnecting Cables

Instrument

Listener

T

alk

er

Con

troller

Command

Related

Some

cal

Lo

A

BASIC

cal

Some

Some

Related

A

BASIC

Related

ter

Related

Started

Command Mnemonics

Angle Brackets . . . . . .

Command Examples .

Response Examples

Programming

t Addresses

.

.

.

.

.

.

the

.

.

.

.

statemen

.

.

.

BASIC

c

k

.

BASIC

.

BASIC

.

.

of T

examples

out

.

example

.

.

.

examples

.

.

.

examples

statemen

.

.

.

example

statemen

.

.

.

statemen

with

erms .

Notation .

.

.

.

.

.

Nomenclature

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

Syn

thesizer

Statements

.

.

.

.

.

ts

used

b

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

ts

used

b

.

.

.

.

. .

.

.

.

ts

used

b

.

.

.

. .

ts

used

b

SCPI

.

. .

. .

. .

. .

. . . . . . .

. . . . . .

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

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

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

.

.

.

.

.

.

.

y

.

.

.

.

.

.

.

.

y

.

y

. .

y

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. .

.

.

.

.

.

.

. .

. .

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. .

. .

.

.

.

.

.

.

.

.

.

.

.

.

. .

some

computers

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. .

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

some

computers

. .

.

.

.

.

. .

. .

. .

some

computers .

. .

.

.

.

some

computers

.

.

.

. .

. .

.

.

.

.

.

.

. .

. .

. .

. . . . . . .

. . . . . . . . . . .

. . . . . . . . .

. . . . . . . . . .

.

.

.

.

.

.

. .

.

.

. .

.

.

.

.

.

.

.

.

.

.

.

.

. .

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. .

.

.

.

. .

.

.

.

.

.

.

.

.

.

.

.

.

. .

.

. .

. .

.

.

.

.

.

.

.

.

.

.

.

.

.

. .

.

.

.

.

. .

.

.

.

.

.

.

.

1-3

.

1-3

.

1-5

.

1-6

.

1-6

.

1-6

.

1-6

.

1-6

.

1-7

.

1-8

.

1-8

.

1-9

.

1-9

1-10

.

1-10

.

1-10

.

1-10

.

1-11

1-11

.

1-11

.

1-12

.

1-13

.

1-13

.

1-14

.

1-15

.

1-16

.

1-17

.

1-18

1-18

1-18

1-18

1-19

1-19

1-20

1-21

Contents-1

F

orgiving

Types

Subsystem

The

P

aths

More

Ab

Query

Implied

Optional

Program

Example

Example

Example

Example

Reading

Details

Programming

of

Program

SCPI

Common

Resp

onse

SCPI

P

arameter

Numeric

Extended

Discrete

Bo

olean

Resp

onse

Real

In

teger Resp

Discrete

String

Using

HP-IB

Program Comments . . . . . . .

Local Lo c

Program Commen

Internally Leveled CW Signal, Example Program 3

Program Commen

Level Correction Routine, Example Program 4

Program Commen

Listening

of

Commands

Command

Command

Through

out

Commands

and

Ev

Commands

P

arameters

Message

1

.

2

.

3

.

4

.

Instrumen

Commands

Message

Subsystem

Command

Message

Data

T

yp

es

T

yp

es .

P

arameters

Numeric

P

arameters

P

arameters

Data

T

Response

onse

Response

Response

Typical

the

Example

Chec

k,

Example

kout Demonstration, Example Program 2

and

Precise

.

.

.

T

rees

T

ree

Structure

the

Command

.

en

t

Commands

.

.

.

.

Examples

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

t

Errors

and

Resp

Syn

tax

.

Command

Syn

tax

Syn

tax

.

.

.

.

.

.

.

.

.

P

arameters

.

.

.

. .

yp

es .

Data

Data

Data .

Programs

. .

.

.

.

Data

Measurements

Program

ts . . . . . . . . .

ts . . . . . . . . . . . . . . .

ts . . . . . . . . . . . . . . .

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

onses

.

.

Syn

.

.

.

.

.

.

.

.

. .

. .

. .

.

.

.

.

.

.

.

.

.

.

.

.

T

.

.

.

.

.

.

.

.

.

.

.

tax

.

.

. .

.

.

. .

.

.

.

.

.

.

1

T

alking

.

.

.

.

.

.

.

.

.

.

.

.

ree

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. .

.

. .

. .

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. .

. .

.

.

.

.

.

. .

.

.

.

. .

.

.

.

.

.

.

.

.

.

.

.

.

. .

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. . . . . . . .

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. .

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. . . . . .

.

.

.

.

.

.

.

.

.

.

.

. .

.

.

.

.

.

. .

.

.

. .

.

.

.

.

.

.

.

.

.

.

.

.

. .

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. .

.

.

. . . .

.

..

.

.

.

. .

. .

.

. .

.

.

.

.

.

.

. .

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. .

. .

.

.

.

.

. .

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. .

.

.

. .

.

1-21

. 1-21

.

1-23

.

1-23

.

1-23

1-26

.

1-26

.

1-26

1-26

.

1-27

.

1-27

.

1-27

.

1-28

.

1-28

1-29

.

1-30

.

1-31

.

1-32

.

1-33

.

1-34

.

1-35

.

1-36

.

1-36

.

1-37

.

1-38

.

1-38

.

1-39

.

1-39

.

1-39

.

1-40

.

1-40

.

1-41

1-41

.

1-42

1-42

.

1-43

1-44

1-45

1-45

1-46

1-47

Contents-2

Sa

ving

and

Recalling

Program

Related

2.

Programming

Command

2a.

A

utomatic

[SOURce[1]:]PO

Query

See

Also

[SOURce[1]:]PO

Query

See

Also

[SOURce[1]:]PO

Query

See

Also

2b

.

Carrier

[SOURce[1]:]FREQuency[:CW

Query

See

Also

[SOURce[1]:]FREQuency[:CW

Query

See

Also

[SOURce[1]:]FREQuency:MUL

Query

See Also

[SOURce[1]:]FREQuency:MULTiplier:STEP

Query Syn

See Also

Comments

Do

cumen

Commands

Syn

tax

Level

Control

W

Syn

tax

.

.

.

.

W

Syn

tax

.

.

.

.

Wer:ALC:SOURce

Syntax

Commands

Syn

Syn

Syn

.

.

tax

.

.

tax

.

.

tax

. .

tax .

. .

. .

.

.

.

.

.

.

.

. .

States,

.

.

.

.

ts

.

.

.

.

.

.

.

.

.

Commands

er:ALC:PMET

.

.

. .

. .

.

. .

. .

er:ALC:PMET

.

.

.

.

.

.

.

.

.

.

. .

.

.

.

.

.

.

.

j

.

.

.

.

.

.

.

.

.

.

j

.

.

. .

.

.

. .

. .

.

.

. .

. .

.

.

.

.

.

.

.

.

.

.

.

.

.

.

:FIXed]

:FIXed]:STEP

Tiplier

Example

.

.

.

.

.

.

.

.

.

er

.

. .

. .

. .

er:STEP

.

.

.

.

.

.

. .

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

Program

.

.

.

.

.

.

.

. .

. .

.

.

.

.

.

.

.

.

.

.

.

. .

. .

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. .

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. .

. .

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. .

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. .

.

.

.

.

. .

. .

.

.

.

.

.

.

. .

.

.

.

.

.

.

. .

.

.

.

.

5

.

.

.

1-50

.

..

. 1-51

.

. .

.

1-52

. .

.

2-3

. .

.

2a-3

.

.

.

.

2a-4

.

.

.

.

2a-4

.

.

.

.

2a-5

.

.

.

.

2a-6

.

.

.

.

2a-6

.

.

.

.

2a-7

.

.

.

.

2a-7

. .

.

2a-8

.

.

.

.

2b-3

.

.

.

.

2b-4

.

.

.

.

2b-4

.

. .

.

2b-5

.

.

.

.

2b-6

.

.

.

.

2b-6

. .

.

2b-7

.

.

.

.

2b-8

.

.

. .

.

.

.

.

.

.

.

.

.

.

.

.

2b-9

2b-10

2b-11

2b-11

2c.

Instrument

*IDN?

*OPT? (Option Iden

OUTPut:IMPedance? . . . . . . . . . . . . . . . .

[SOURce[1]:]ROSCillator:SOURce? . . . . . . . . . .

See Also

SYSTem:ERRor? . . . . . .

See Also

SYSTem:VERSion? . . . . . . . .

Information

(Iden

tication

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

. . . . . . .

Commands

Query)

tication Query)

.

.

.

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

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

.

.

.

.

. . . . . . . . .

. . . . . . . . .

.

.

.

.

.

.

2c-3

2c-4

2c-5

2c-6

2c-6

2c-7

2c-8

2c-9

Contents-3

*TST?

2d.

Instrument

*LRN?

MEMory:RAM:INITialize

*R

*RST

*SA

SYST

MEMory:CA

MEMory:CA

2e

.

Level

MEMory:T

MEMory:T

MEMory:T

MEMory:T

MEMory:T

[SOURce[1]:]CORRection:CSET[:SELect] .

[SOURce[1]:]CORRection:FLATness[:DA

[SOURce[1]:]CORRection:FLATness:POINts . . . . . .

(Self-T

(Learn

See

Also

See

Also

CL

(Recall

See

Also

(Reset

See

Also

V

(Sa

v

e

See

Also

em:PRESet

See

Also

See

Also .

See

Also .

Correction

ABLe:FREQuency

Query

See

See

Query

See

See

Query Syn

See

Query Syn

See Also

Query Syn

See Also

Syn

Also

ABLe:FREQuency:POINts?

Also

ABLe:LOSS[:MA

Syn

Also

ABLe:LOSS[:MA

Also

ABLe:SELect

Also

est

Query)

State

Commands

Device

.

.

.

.

.

.

.

.

Command)

.

.

.

.

Command)

.

.

.

.

Command)

.

.

.

.

.

.

.

.

.

T

alog[:ALL]?

. .

.

Talog:T

. .

.

Commands

tax

.

.

.

.

.

.

.

.

.

.

tax

.

. .

.

.

.

.

.

.

.

.

tax .

.

tax .

. . .

tax .

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

. .

.

.

.

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

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

. . . . . . . . . . .

.

Setup

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. .

.

.

.

ABLe? .

.

.

.

.

.

.

.

.

.

.

.

.

. .

. .

. .

. .

. .

.

. .

.

.

.

.

.

.

.

.

Query)

.

.

.

.

.

. .

.

.

.

. .

.

.

.

. .

.

. .

.

.

.

.

. .

.

.

.

.

.

.

.

.

.

.

.

.

.

.

GNitude]

. .

. .

GNitude]:POINts?

. .

.

.

.

.

.

.

.

.

.

.

.

.

. .

.

.

.

.

.

.

.

.

. .

.

.

.

.

.

. .

.

. .

.

. .

. .

.

.

.

.

.

.

.

.

.

.

.

. .

. .

.

.

.

.

.

.

.

.

.

.

. .

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. .

. .

.

.

.

. .

. .

. .

. .

. .

. .

.

. .

. .

. .

.

.

.

.

.

.

.

.

.

.

.

.

. .

.

.

.

.

.

.

.

.

.

.

.

.

.

. .

. .

.

.

.

.

. .

. .

.

.

.

.

.

.

.

.

.

.

.

.

. .

. .

.

.

.

.

.

.

.

TA] .

. . . . . . .

. . . . . . .

.

.

.

. .

.

.

.

.

.

. .

.

.

.

.

.

.

.

.

.

.

.

. .

. .

.

.

.

.

. .

. .

. .

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. .

. .

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. .

.

.

.

.

.

. .

.

.

.

.

.

.

.

.

.

.

.

.

. . . . . .

. . . . .

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

2c-10

2d-3

2d-4

2d-5

2d-5

2d-6

2d-6

2d-7

2d-7

2d-8

2d-8

2d-9

2d-9

2d-10

2d-10

2d-11

2d-11

2e-3

2e-4

2e-5

2e-6

2e-6

2e-7

2e-8

2e-9

2e-10

2e-10

2e-11

2e-12

2e-12

2e-13

2e-14

2e-14

2e-15

2e-16

2e-16

2e-17

Contents-4

Query

See

[SOURce[1]:]CORRection:CSET:ST

Query

See

[SOURce[1]:]CORRection[:ST

Query

See

SYST

Query

See

2f.

Macro

*DMC

See

*EMC

Query

See

*GMC?

See

*LMC?

See

MEMory:FREE:MA

See

*PMC

See

*RMC

See

Syn

tax

.

.

.

Also

.

.

.

.

.

.

Syn

tax

.

.

.

Also

Also

em:COMMunicate:PMET

Also

Commands

Also

Also .

Also

Also

Also

Also

Also

.

.

Syn

tax

.

.

Syn

tax

.

.

(Dene

(Enable

(Get Macro

(List

(Purge

(Remo

.

Syntax

.

Macro

.

.

.

v

.

Macro

.

Macros)

. .

. .

.

.

Macros

.

e

.

.

.

.

.

.

.

.

.

.

.

.

.

. .

.

Conten

.

Query) .

. .

CRo?

.

.

.

.

Macro

.

.

.

.

.

.

.

Command)

.

.

.

.

.

.

Command)

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

A

T

e]

.

.

.

.

.

.

.

.

er:ADDRess

.

.

.

.

.

.

.

.

. .

. .

.

.

.

.

.

.

.

.

.

.

.

ts

Query)

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

Command)

.

.

.

.

.

.

.

.

.

.

.

.

. .

.

.

.

.

.

.

.

.

.

.

.

.

A

.

.

.

.

.

.

.

.

. .

.

.

.

.

.

.

.

.

.

. .

.

.

.

.

. .

. .

. .

2e-17

.

..

..

..

..

.

2e-18

T

e

.

.

.

.

.

.

.

.

2e-19

.

.

.

.

.

.

. .

. .

2e-19

.

.

.

.

.

. .

. .

.

2e-20

.

.

.

.

.

.

.

.

.

.

2e-21

.

.

. .

. .

. .

. .

2e-22

.

. .

. .

. .

. .

.

2e-22

.

.

.

.

.

.

.

2e-23

.

.

. .

. .

. .

. .

2e-24

.

. .

. .

. .

. .

.

2e-24

.

.

.

.

.

.

.

.

.

.

2f-3

.

.

.

.

.

.

.

.

.

.

2f-3

. .

. .

. .

.

.

.

2f-4

.

.

.

.

.

.

.

.

.

.

2f-4

.

.

.

.

.

.

.

.

.

.

2f-5

.

.

.

.

.

.

.

.

.

2f-6

.

.

.

.

.

.

.

.

.

.

2f-6

.

.

.

.

.

.

.

.

.

.

2f-7

.

.

.

.

.

.

.

.

.

.

2f-7

.

.

.

.

.

.

.

.

.

.

2f-8

.

.

.

.

.

.

.

.

.

.

2f-8

.

.

.

.

.

.

.

.

.

.

2f-9

.

.

.

.

.

.

.

.

.

.

2f-9

.

.

.

.

.

.

.

.

.

.

2f-10

. .

. .

. .

.

.

.

2f-10

2g.

Miscellaneous

DISPla

SYSTem:KEY

Query

Query

Commands

y[:WINDo

Syn

tax

Syn

tax

w][:ST

.

.

.

. .

. .

.

.

.

A

. .

.

T

e]

. .

. .

. .

. .

.

.

.

.

.

2g-3

. .

. .

. .

.

.

.

.

.

.

.

.

2g-4

. .

.

.

.

.

.

.

.

.

.

.

.

.

.

2g-5

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

2g-7

Contents-5

2h.

P

ower

[SOURce[1]:]PO

Query

See

[SOURce[1]:]PO

Query

See

2i.

Programmable

*OPC

Query

See

SYST

Query

SYST

Query

UNIT:FREQuency

Query

UNIT:PO

Query

*W

AI

See

2j.

RF

Output

OUTPut:PR

Query

See

OUTPut[:ST

Query

See

[SOURce[1]:]PO

Adv

Disadvan

Query

See Also

Level

Also

Also

Also

em:COMMunicate:GPIB:ADDRess

em:LANGuage

(W

Also

Also

Also

an

Commands

Syn

tax

.

.

Syn

tax

.

.

Interface

(Op

eration

Syn

tax

.

.

Syn

tax

Syn

tax

Syntax

Wer

j

:V

Syn

tax

ait-to-Contin

.

.

Control

OT

Syn

tax

.

.

A

T

Syn

tax

.

.

tages

.

tages .

Syn

tax

.

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

W

er[:LEV

.

.

.

.

.

.

W

er[:LEV

.

.

.

.

.

.

Complete)

.

.

.

.

.

.

.

.

.

.

.

.

.

. .

. .

.

OL

T

age

. .

.

ue

. .

.

Commands

ection[:ST

.

.

.

.

.

.

e]

. .

.

.

.

.

.

. .

W

er:A

TT

.

.

. .

. .

.

.

.

el]

.

.

.

.

.

.

.

.

.

el]:STEP

.

.

.

.

.

.

.

.

Commands

.

.

.

.

.

.

. .

. .

.

.

.

.

.

.

.

.

.

. .

. .

. .

.

.

.

.

.

.

.

.

.

.

.

.

Command)

.

.

.

.

A

T

e]

.

.

.

.

.

.

.

.

. .

. .

. .

. .

. .

. .

en

uation:A

. .

. .

. .

.

.

.

.

.

.

.

.

.

.

.

.

. .

.

. .

.

.

.

.

.

.

.

.

. .

. .

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. .

.

.

.

.

. .

. .

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

UTO .

. .

.

.

.

.

.

.

.

.

.

. .

.

.

.

. .

.

.

.

.

.

.

.

.

. .

.

.

.

.

.

.

.

.

.

.

. .

.

. .

.

.

.

. .

.

.

.

.

.

.

.

. .

.

.

.

.

.

.

.

.

.

.

. .

. .

.

.

.

.

.

.

.

.

.

.

.

. .

.

.

.

. .

.

.

.

.

.

.

.

. .

. .

.

.

.

.

.

.

.

.

.

.

.

.

. .

.

.

.

.

.

.

.

.

. .

.

. .

. .

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. .

.

.

.

.

. .

.

. .

.

.

.

.

.

.

.

.

.

.

.

.

. .

.

.

.

.

.

.

.

.

.

. .

.

. .

. .

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. .

.

.

.

.

. .

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. .

.

.

.

.

.

.

.

.

.

2h-3

2h-5

.

2h-5

.

2h-6

.

2h-7

.

2h-7

.

2i-3

.

2i-3

.

2i-4

.

2i-5

.

2i-6

.

2i-7

.

2i-8

.

2i-9

.

2i-11

.

2i-12

.

2i-14

.

2i-15

.

2i-15

2j-3

.

2j-4

.

2j-4

.

2j-5

.

2j-5

.

2j-6

.

2j-7

.

2j-7

.

2j-8

.

2j-8

2j-9

Contents-6

2k.

Status

The

*CLS

*ESE

*ESR?

*PSC

*SRE

ST

ST

STATus:OPERation[:EVENt]? . . . . . .

STATus:OPERation:NTRansition . . . . . . . .

STATus:OPERation:PTRansition . . . . . . . . . . .

Register

Status

General

Condition

Negativ

P

ositiv

Event

Enable

Syn

thesizer

The

Status

The

Standard

The

Standard

The

Questionable

Status

See

Query

See

Status

See

Query

See

Query

See

AT

See

AT

Query

See

See Also . . . . . . . . .

Query Syn

See Also

Query Syn

Register

Program

(Clear

Also

(Standard

Syn

Also

(Standard

Rep

Also

(P

o

w

Syn

Also

(Service

Syntax

Also .

us:OPERation:CONDition?

Also .

us:OPERation:ENABle .

Syn

Also

Commands

Register

Status

e

T

e

T

Register

Register

Status

Commen

Status

.

tax

.

orting

.

er-On

tax

.

tax

.

tax . . . . . . . . . .

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

tax .

System

Group

Register

ransition

ransition

.

.

.

Groups

Byte

Group

Ev

en

Op

eration

System

Command)

.

.

.

.

Ev

en

t

.

.

.

.

.

.

.

Ev

en

.

.

.

. .

Status Clear)

.

.

. .

.

.

. .

Request

.

.

.

.

.

.

.

. .

.

.

.

.

.

.

.

.

.

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

.

Mo

del

.

.

Register

Register

.

.

.

.

.

.

t

Status

Status

Data

Status

Programming

ts

.

.

.

.

. .

Status

.

.

.

.

.

.

t

Status

. .

.

.

.

.

. .

. .

.

Enable)

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

..

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

Group

.

.

.

. .

Enable)

. .

.

. .

Register

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

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

.

.

.

Group

Group

.

.

.

.

.

. .

.

.

.

.

.

.

.

.

.

.

.

. .

.

.

.

.

.

.

.

.

.

.

.

. .

.

.

.

.

Example

.

.

.

.

.

.

.

.

.

.

.

. .

.

.

.

.

.

.

Query)

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. .

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. .

.

.

.

. . . . . . . . .

.

.

.

.

. .

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. .

. .

..

..

. 2k-5

.

. .

. .

.

.

.

. .

.

.

.

. .

.

.

.

.

. .

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. .

.

.

.

.

.

.

.

.

.

.

. .

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. .

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. .

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. .

. .

. .

.

.

.

.

.

. . . . . .

. . .

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

2k-3

2k-3

2k-4

2k-4

2k-4

2k-5

2k-5

2k-5

2k-6

2k-7

2k-7

2k-8

2k-8

2k-10

2k-10

2k-11

2k-12

2k-12

2k-13

2k-14

2k-14

2k-15

2k-16

2k-16

2k-17

2k-18

2k-18

2k-19

2k-20

2k-21

2k-22

2k-23

2k-24

2k-26

2k-27

2k-29

2k-29

2k-30

2k-32

Contents-7

3.

4.

See

Also

ST

A

Tus:PRESet

See

Also

ST

A

T

us:QUEStionable:CONDition?

See

Also

ST

A

T

us:QUEStionable:ENABle

Query

See

Also

ST

A

T

us:QUEStionable[:EVENt]?

See

Also

ST

A

T

us:QUEStionable:NTRansition

Query

See

Also

ST

A

T

us:QUEStionable:PTRansition

Query

See

Also

*STB?

See

Also

Error

HP

Messages

Error

Messages

Messages

8673

Command

Out

Rounding

Out

Rounding

P

o

w

er

Output

System

Query Return

HP

8673

Images .

Event Register

Condition Register Bits

Source Settled Bit P

ALC Unlev

Change in ESB Bit

FrontP

.

.

.

.

.

.

.

.

.

.

.

Syn

tax

.

.

.

.

.

.

.

Syn

tax

.

.

.

.

Syn

tax

.

.

.

.

(Read

of

of

Status

.

.

.

List

.

.

.

. .

Compatibility

Mapping

Range

Range

Suxes

Activ

ALC

Status

anel En

P

P

ersonalit

.

.

.

e

P

Mo

Format

Bits

.

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

eled and F

try Complete Bit .

ersonalit

Bits . . . . . . . . . . . . . . . .

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. .

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

Byte

Query)

.

.

.

.

. .

. .

.

.

.

.

.

.

Guide

to

SCPI

y

Dierence

y

Dierence

. .

. .

. .

.

.

.

. .

.

. .

. .

arameter

de

.

.

. .

. .

.

.

.

.

. .

ersonality

requency Error Bits .

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

.

.

. .

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. .

.

. .

. .

. .

.

.

.

. .

. .

. .

. .

. .

.

.

.

.

.

.

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

Dierence . . . . . . .

. . . . . . .

.

.

. .

. .

. .

.

2k-32

.

.

..

..

..

..

2k-33

.

.

.

.

. .

. .

.

2k-34

.

.

.

.

.

.

.

.

.

2k-35

.

.

.

.

. .

. .

.

2k-36

.

.

.

.

.

.

.

. .

2k-37

.

. .

. .

. .

. .

2k-38

. .

. .

. .

. .

.

2k-39

.

.

.

.

.

.

.

.

.

2k-40

. .

. .

. .

. .

.

2k-42

.

.

.

.

.

.

.

.

.

2k-43

. .

.

.

.

.

.

.

2k-45

.

.

.

.

.

.

.

.

.

2k-45

.

.

.

.

.

.

.

.

.

2k-46

.

.

. .

. .

. .

.

2k-48

.

. .

. .

. .

. .

2k-48

.

.

. .

. .

.

.

.

2k-49

.

.

.

.

.

.

.

.

.

2k-50

.

.

.

.

.

.

.

.

.

3-3

.

.

.

.

.

.

.

.

.

3-5

.

.

.

.

.

.

. .

.

4-3

.

.

.

.

.

.

.

. .

.

.

.

.

.

.

.

. .

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. .

. .

.

.

.

. .

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. . . . . .

. . . .

. . .

4-12

4-12

.

4-12

.

4-13

.

4-13

.

4-13

.

4-13

.

4-14

.

4-15

4-16

4-17

4-17

4-17

4-17

4-18

4-18

Contents-8

5.

Legal

SCPI

Certication

W

Assistance

Index

and

Regulatory

Conformance

Regulatory

arran

t

y

.

Limitation

Exclusiv

e

.

.

.

Information

.

.

.

.

of

W

arran

Remedies

.

.

.

.

Information

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

t

y

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. .

.

5-3

.

.

.

.

.

.

.

.

.

. .

.

5-7

.

.

.

.

.

.

.

.

.

.

.

.

5-7

.

.

.

.

. .

. .

. .

.

.

5-8

.

.

.

.

.

.

. .

. .

. .

.

.

.

.

.

.

.

. .

. .

.

.

.

.

. .

. .

. .

. .

5-8

.

5-9

5-10

Contents-9

Figures

1-1.

HP-IB Connector

1-2.

SCPI Command

1-3.

A Simplied

1-4.

Proper Use

1-5.

Simplied Program

1-6.

SCPI Simplied

1-7.

Simplied Common

1-8.

Simplied

2k-1.

Status

2k-2.

General

T

ables

Command Tree

of the

Response

Register

Status

and Cable

Types .

Colon and

Message Syntax

Subsystem

Command

Message

System

Group

Hierarchy

Model

.

.

.

.

.

.

.

..

Semicolon

Command

Syntax

Syntax

.

.

.

.

.

.

.

.

.

.

.

.

.

..

Syntax

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

1-3

.

.

.

.

.

.

.

.

.

.

1-22

.

.

.

.

.

.

.

.

.

.

1-23

.

.

.

.

.

.

.

.

.

.

1-25

.

.

.

.

.

.

.

.

.

.

1-31

.

.

.

.

.

.

.

.

1-32

.

.

.

.

.

.

.

.

.

.

1-33

.

.

.

.

.

.

.

.

.

.

1-34

.

.

.

.

.

.

.

.

.

.

2k-3

.

.

.

.

.

.

.

.

.

.

2k-4

1-1.

HP-IB

1-2.

SCPI

4-1.

HP

4-2.

HP

5-1.

SCPI

5-2.

Hewlett-P

Contents-10

Interface

Data

Types

8673

Command

8673

Status

Conformance

ackard Sales

Cables

.

Mapping

and

Extended

.

A

vailable

.

.

.

.

to

.

.

.

.

and Service

.

.

SCPI

Bytes

.

.

.

.

.

.

.

..

..

Commands

.

.

.

.

.

..

Oces .

..

..

.

.

..

..

..

.

.

..

..

..

..

.

.

.

.

..

..

..

..

.

.

.

..

..

.

.

.

.

. 4-16

.

..

1-4

1-35

4-4

5-4

5-11

1

Getting

Programming

Started

Getting

HP-IB

,the

Hewlett-Packard

communication

instruments

Synthesizer

\ANSI

for

HP-IB; all

connector).

synthesizer

The

rst

the

Standard

introduced,

. Any

, including

MC1.1," or

This portion

to

part

and

Started Programming

system between

instrument having

non-HP instruments

\IEC-625" capability

are

electrically

of

a

computer

of

this

Commands

.

chapter

for

example programs

Interface

equivalent

the

provides

Programmable

Bus

,

is

the

the Synthesizer

HP-IB capability

that have

(these are

although

manual

specically

general

Instruments

are given.

instrument-to-instrument

and

HP-IB

up

to

can

\GP-IB

common

IEC-625

describes

information.

language

14

other

be

interfaced

,"

\IEEE-488,"

generic

uses

a

interfacing

terms

unique

Later

(SCPI)

to

the

the

,

is

1-2

HP-IB

General

Information

Interconnecting

The

HP-IB

connector

instrument

connected

Figure

that

have recessed

1-1.

or

with

The

device

HP-IB

adapters

or

Cables

allows

on

the

cables

are

crowded

the

synthesizer to

interface

and

adapters

principally

HP-IB

bus

. All

.

These

extension

connectors

be connected

to any

HP-IB instruments

cables

devices

are

shown

for

instruments

.

can

other

be

in

Figure 1-1. HP-IB Connector and Cable

1-3

Getting

Started

HP-IB General

Programming

Information

T

able

1-1.

HP-IB

Interface

Cables

A

vailable

As

many

as

(fteen

in

from

(like

a

\star"

that

boxcars

total

instrument

restrictions:



Each

instrument must

(decimal).

on

setting



In

a

two-instrument

must

not



When

more

length to

fourteen

instruments

pattern

exceed

(one

on

a

train),

Refer

to

the

synthesizer's

4

than

each

instrument

HP-IB Cable

Part

HP

HP

HP

HP

HP-IB

instruments

in

central

like

spokes

or

have a

\Instrument

system

meters

two

instruments

Numbers

10833A

10833B

10833C

10833D

the

system).

instrument,

on

a

any

combination

unique

Addresses"

HP-IB address

that uses

(13

ft).

are

must

not

Lengths

1m

2m

4m

0.5m (1.6

can

be

The

with

wheel),

HP-IB

.

just

connected

exceed

(3.3

ft)

(6.6

ft)

(13.2

ft)

ft)

connected

cables

the

or in

can

be

HP-IB

a linear

pattern. There

address

in

one

2

this

HP-IB

on

meters

,

ranging

chapter

cable

the

(6.5

to

the

synthesizer

interconnected

cables

emanating

pattern

are certain

from

0

for

information

,

the

cable

bus

,

the

cable

ft)

per

unit.

to

30

length



The

total

cable

Hewlett-P

37201A,

cabling

(3,280

service

The

rules

ft),

oces

codes

ackard

manufactures

37204A/B)

.

These

and

telephone

can

next

to

length

that

extenders

provide

the

HP-IB

between

HP-IB

overcome

allow

modem

additional

connector

all

units

extender

the

range

twin-pair

operation

information

,

illustrated

must

instruments

limitations

cable

over

the HP-IB electrical capabilities of the synthesizer

mnemonics (HP-IB

equivalent). Briey

SH1

AH1

, GP-IB

, IEEE-488, and IEC-625 are all electrically

, the mnemonics translate as follows:

Source Handshake

Acceptor Handshake

, complete capability

, complete capability

1-4

not

any

on

in

exceed

operation

distance

the

Figure

20

(HP

imposed

.

HP-IB

1-1

meters

(65

models

by

the

up

to

1

HP

sales

extenders

,

describe

km

and

, using IEEE Std. 488-1978

.

.

ft).

.

Getting

Started

HP-IB General

Programming

Information

T5:

TE0

L3

LE0

SR1

RL1

PP0

DC1

DT0

C0, 1

E2

These

codes

published

East

47th

are

by

the

Street,

T

alker; capable

MLA.

T

alker

,

Extended

Listener

Listener

Service

Remote

P

Device

Device

arallel

,

capable

, Extended

Request,

Local,

P

oll,

Clear

,

Trigger

Controller capability

system controller

Electrical

described

Institute

New

Y

specication

completely

of

Electrical

ork,

New

of basic

address;

of

address;

complete

complete

no

capability

complete

,

complete

.

in

and

Y

ork

11017.

talker

basic

capability

capability

capability

options;

indicating

the

IEEE

Electronic

,

serial

no

capability

listener

no

capability

capability

.

C0,

Std.

poll,

.

,

and

unaddress

.

.

.

.

no

capabilities;

open

collector

488-1978

Engineers

and

.

,

unaddress

if

MT

C1,

outputs

document,

Inc.,

345

if

A.

.

Instrument

Each

instrument

ranging

but

this

in

can

value

be

A

ddresses

in

an

from

changed

HP-IB

0

to

using

network

30.

the

The

must

default

4

SHIFT

address

5

4

LOCAL

have

5

a

keys

unique

for

the

.

address

,

an

synthesizer

integer

is

19,

1-5

Getting

Started

HP-IB General

Programming

Information

Listener

T

alker

Controller

HP-IB Instrument

An HP-IB

depending on

A

listener

instruments

listeners

A

talker

instruments

time

A

controller

various

Programming

The

PO

WER

are

procedures

statement,

codes to

instrument is

is

. Any

simultaneously.

is

a

.

to

be

an

HP-IB

synthesizer

or LINE

possible

only by

for

then

that statement

its current

a

device capable

number of

device

is

T

o

avoid

active

an

instrument,

activities

capable

confusion,

talker

.

the

can

be

switch must

computer (remote)

the

synthesizer

adding

Nomenclature

categorized as

function in

a

the network.

of receiving

instruments in

of

transmitting

an

HP-IB

.

Only

typically

one device

a

Synthesizer

controlled entirely

be operated

control. Computer

involve selecting

the

specic synthesizer

to

achieve

the

desired

\listener

computer

at a

data or

the HP-IB

data

system

time

by a

,"

\talker

commands from

network

or

commands

allows

,

capable

can

be

computer

manually). Several

an HP-IB

(SCPI, HP

operating

,"

or

\controller

other

can

be

to

other

only

one

device

of

managing

an

active

(although

the

controller

the

functions

programming

command

8673) programming

conditions

.

,"

at

a

.

In the

programming explanations

that

are

written

in

a

generic

dialect

that follow

of

the

B

, specic

ASIC

language

examples

selected because the majority of HP-IB computers have B

capability. However

, other programming languages can also be used.

1-6

are

included

.

B

ASIC

was

ASIC language

Getting

Started

HP-IB General

Programming

Information

HP-IB Command

Command statements

understood by

the programming

all instruments

language codes

Statements

form the

communication instructions

An explanation

However,

extended or

explanations

B

ASIC

language

manual

Syntax

oval

items

for

drawings

are

computer

enclosed

statement; and

of statement

of the

eight

some computers

enhanced

as

a

version

starting

reference

the

particular

accompany

specic

in

a

rectangular

the

arrows

elements

.

nucleus of

in the

for the

network and,

, they

provide all

system.

fundamental

use

a

slightly

of

these

point,

but

for

manual,

the

I/O

computer used.

each

statement: All

terms

that

must be

box

are names

indicate

a

path

HP-IB

command

dierent

commands

detailed

programming

entered exactly

of parameters

that

generates

programming;

when

combined

management

statements

terminology

.

Consider

information

guide

items enclosed

a

valid

they

and

follows

,

or

support

the

following

consult

,

and

the

by a

as

described;

used

in

combination

are

with

data

.

an

the

HP-IB

circle or

the

1-7

Getting

Started

HP-IB General

Abort

Programming

Information

Related

b

y

some

statements

computers

used

Abort abruptly

and prepares

Typically,

terminates all

all instruments

this is

starting condition.

where

typically

10

100







the

port

ABORT

IF

V>20

ABORTIO

HAL

T

RESET

interface

7.

7

THEN

(used

listener/talker activity

to receive

an initialization

The syntax

select

code

Some

B

ASIC

examples:

ABORT

by

HP-80

7

series

anew

command used

is:

is

the

computer's

computers)

on

command

to

place

HP-IB

the

from

the

I/O

interface

the

controller

bus

in

port,

which

bus

a

known

,

.

is

1-8

Remote

Getting

Started

HP-IB General

Programming

Information

Some

BASIC

examples

Remote causes

In remote

key and

The syntax

where

HP-IB

address

10

which

nothing

talk),

10

control, the

the PO

is:

the

device

port

number

for

the

REMOTE

prepares

appears

or

REMOTE

an instrument

front panel

WER or

LINE switch),

selector is

.

Typically

synthesizer

7

all

HP-IB

to

happen

719

to change

keys are

the address

,the

HP-IB

is

19, so

instruments

to

the

from

disabled

and

the

of the

port

the

device

for

remote

instruments

local

control

(except

REMOTE

instrument

number

selector

operation

until

to

remote

for

annunciator

appended

is

7,

and

is

719.

they

are addressed

control.

the

4

LOCAL

is

lit.

to

the

default

(although

5

the

to

10

which

aects the

REMOTE 719,

which

eects four

HP-IB instrument

721, 726,

715

instruments that

located at

address

have addresses

19,

19, 21,

or

26, and

15.

1-9

Getting

Started

Programming

HP-IB General

Information

Local Lockout

A

BASIC

example

LOCAL LOCK

front panel

ahard

10

20

4

reset by

REMOTE

LOCAL

Local

LOCAL

local

is

the

control

OUT can

5

LOCAL

key

the PO

719

LOCKOUT

complement

with

a

fully

be used

. With

in

the

WER switch)

7

to

REMOTE,

enabled

conjunction

5

can

key

restore

4

LOCAL

causing

front

panel.

with

REMOTE

disabled, only

local

control.

an

instrument to

The syntax

to

disable

the controller

The

syntax

return

is:

the

(or

is:

to

Some BASIC examples

10 LOCAL 7

which

10 LOCAL

eects all instruments in the network, or

719

for an addressed instrument

1-10

(address 19).

Clear

Getting

Started

HP-IB General

Programming

Information

Some

BASIC

examples

CLEAR causes

all HP-IB

\cleared" condition,

device.

1. All

2. The

The

10

10

For

the synthesizer:

pending output-parameter

parser (the

and now

syntax

to

to

CLEAR

clear

CLEAR

clear

expects to

is:

7

all

HP-IB

719

an

addressed

instruments,

with the

software

receive

instruments

instrument.

denition of

operations

that

interprets

the

rst

,

or

or

addressed

\cleared" being

are

the

character

instruments

unique

halted.

programming

of

a

programming

,

to

codes)

assume

for

each

is

reset,

code

a

.

Related

statements

b

y

some computers

used



RESET



CONTROL



SEND

The preceding

statements are

incorporate programming codes

programming codes

, and are used for data communication.

primarily management

commands that

do not

. The following two statements do incorporate

1-11

Getting

Started

HP-IB General

Output

Programming

Information

OUTPUT is

controller to

where

way

command

output;

to

the

virtually

USING

,

such

is

these

a

statement

programming

identical

used to

send function

the addressed

is

a

secondary

as

a

binary

followed

image

line

in

codes

to

or

by

items

the

the

commands

instrument. The

command

ASCII

representation

\image

can

items"

be

a

computer

where

syntax

they

for

that

that

string

of code

program.

are

needed.

the

ENTER

and

data

syntax is:

formats

of

numbers

precisely

characters,

Image

Notice

statement

commands

the

output

.

dene

items

that

that

from

in

a

particular

The

USING

the

format

or a

reference

are explained

this

syntax is

follows.

the

of

the

in

1-12

A

BASIC

example

100

OUTPUT

719; "programming

codes"

Getting

Started

HP-IB General

Programming

Information

Related

b

y

some

statements

computers

used



CONTROL



CONVERT



IMA

GE



IOBUFFER



TRANSFER

1-13

Getting

Started

HP-IB General

Enter

Programming

Information

ENTER is

the complement

addressed instrument

ENTER

100

110

ENTER

command

items

literal

is

always

OUTPUT

ENTER

statements

719;

719;

used

"

are

USING and

involve end-of-line

inputs

.

of OUTPUT

to the

controller.

in conjunction

"

.

..

programming

.

.

.

response

commonly

the

appropriate

(end

formatted,

or

identify)

,

and

The syntax

with

codes

data

.

image

is

used

to

is:

OUTPUT

.

.

items

.

.

"

which

,

such

.

"

requires

.

The

suppression,

transfer

as:

most-used

binary

data

the

secondary

inputs

from

image

,

and

the

Example

100

ENTER

suppresses

are to be lled with binary (B) data. As another example

719

the

USING

EOI

"#,

B";

sequence

A,

(#),

B,

and

C

indicates

that

variables

,

A,

100 ENTER 719 USING "#, 123A"; A$

suppresses EOI, and indicates that string variable A$ is to be lled with

123 bytes of literal data (123A).

1-14

B

,

and

C

N

O

T

E

Be

careful

when

match

the

actual

state

.

The

suppression

premature

EOI

termination

the

LF

bit pattern

binary

for

the

data,

ASCII

termination.

patterns

line

for

as

correct

using

b

yte-counting

number

available

of

the

termination

occurs

could coincidentally

where it

CR

(carriage return),

Suppression

data,

not

end-of-data

image

,

data

EOI

sequence

of

the

data

when

an

might cause

of

the

commands,

termination.

speciers.

might

be

lost,

is

input.

ASCII

occur randomly

a false

comma, or

EOI causes

and relies

If

the

requested

or

the

program

frequently

When

LF

(line

necessary

not

specied,

feed)

termination. Also

semicolon

the computer

on

the

HP-IB

Getting

HP-IB General

number

of

might

enter

is

received.

in

a

long

,

the

might

to

accept

EOI

Started

b

ytes

an

to

prevent

the

string

bit

cause

(end

Programming

Information

does

not

endless wait

typical

However

of

patterns

a

false

all

bit

or

identify)

a

,

Related

b

y

some

statements

computers

used



CONVERT



IMA

GE



IOBUFFER



ON

TIMEOUT



SET

TIMEOUT



TRANSFER

This completes

material explains

with the

OUTPUT

the

\HP-IB

the

and

Command

SCPI

programming

ENTER

HP-IB

Statements"

codes

,

command

subsection.

and

shows

statements

how

.

The

they

following

are

used

1-15

Getting

This

section of

Programmable

SCPI

commands in

If

you want

\Related

to explore

Documents."

Started

Chapter 1

with

describes

Instruments language

general. This

the topic

SCPI

the

use

of

(SCPI). This

section presents

in

greater

depth,

the

Standard

section

only

the

see

the

Commands

explains

basics

paragraph

how

of

for

to

SCPI.

titled,

use

1-16

Denitions

Y

ou need

continue

a general

.

of

T

erms

understanding

of

the

terms

listed

below

before

you

controller

instrument

program

message

response

message

command

A controller

SCPI

instrument. A

a

minicomputer,

intelligent

also

An

instrument

instruments can

function

instruments

but

this

is not

use

an

HP-IB interface

concepts

type

A

program

properly

always

apply

of

interface

formatted

go

from

messages tell

and output

A response

formats

to

tell

and

A

.

Response

a

controller

the

controller

about

command

measured

commands

general,

parameters

a

command

,

is any

computer used

controller can

or a

as

controllers

is

any

are

electronic

a requirement.

regardless

used.

message

is

SCPI

a

controller

the

instrument

signals

.

message is

messages

or

listening

about

values

is

an

instruction

to

form

messages

consists

and

punctuation.

to

communicate

be a

plug-in card

in

a

.

device

that

implements

measurement

Similarly,

for communication.

of

the instrument

a

combination

commands

to

an

how

a

collection

always

of one

.

Program

instrument.

to

make

of

go

instrument.

the

internal

state

.

in

SCPI.

that

control

of

mnemonics

personal

card

cage

or

stimulus

most

The same

function or

or

measurements

data

in

from

Response

of

Y

ou

combine

instruments

(keywords),

with

computer

.

Some

SCPI.

Most

devices

instruments

more

messages

Program

specic

an

SCPI

instrument

messages

the

instrument

.

a

,

,

the

In

query

A query is a special type of command. Queries instruct the

instrument to make response data available to the controller

Query mnemonics always end with a question mark.

1-17

.

Getting

Started

Programming

Denitions of

Terms

Standard Notation

Command

Mnemonics

Angle Brackets

This section

Many

commands

one

or

the

FREQuency

form

is

long

and short

is

just

forms

uses several

the

other

FREQUENCY

as

valid as

of

the

FREQuency

Angle brackets

other than

themselves.

character with

asserted

rigidly

section

bracketed

SCPI.

<program

on

dened

uses

words

If

you

the

the

need

message>

have

both a

(SCPI

does not

command,for

(this notation

form of

commands). SCPI

FREQUENCY

command.

indicate that

For

the decimal

HP-IB

interface

meaning

word

than

\message"

<program

them,

you

in

a

forms of

long and

example

,

but

the

example

value

.

words

message>

can

syntax

notation

accept a

.

style is

FREQ

word

or

,

<new

10.

Similarly

W

ords

used

to

talk

indicate

nd

the

diagram.

that

have

a short

form, and

combination of

The short

form is

a shorthand

is not

case

and

FREQUENCY

words

enclosed

line>

,

<^END>

in

angle

brackets

in

ordinary

about

messages

a

precisely

exact

denitions

specic

you

the two).

FREQ

to

document

sensitive

are

represent

represents

means

have

text.

generally

dened

of

meaning.

must

and

,

so

the

the

that

much

F

or

example

words

use

either

Consider

the long

both

the

fREquEnCy

only

valid

something

ASCII

EOI

is

more

,

this

.

But

the

element

such

of

as

How

It

knowledge

your

is

important

controller

to

Use

of

two

to

(B

Examples

understand

languages

ASIC,

C,

.

P

ascal)

that

programming

Y

ou must

as

know the

well

as

with

SCPI

actually

programming language

the

language

of

your

requires

of

instrument

(SCPI). The semantic requirements of your controller's language determine

how the SCPI commands and responses are handled in your application.

1-18

Getting

Denitions of

Started

Programming

Terms

Command

Response

Examples

Examples

Command

examples

:FREQuency:CW?

This

example

statement

encounter

message

statements

OUTPUT

Command

at

the

end

discusses

Response

tells

appropriate

problems,

terminators such

in HP

BASIC,

719;":FREQuency:CW?"

examples do

of

every

message

examples

3.000000000000E+009

These

are

the

characters

sending

the

programming

input

handles

handles

you

a

query

controller

statement

punctuation

<new

type:

command.

,

use

language

operates

line>

look

like this:

you to

put the

to

your application

study the

as

this is

not

show

program

terminators

look

like

you

T

the

input

.

If

you

.

In

characters

and

EOI.

string

details of

<new

line>

taken

message

message

in

.

more

this:

would

o

read

actually

statement

have

problems

particular

such

T

o

enter

:FREQuency:CW?

programming language

how

the

output

.

If

you

are

care

of

for

you.

terminators

\Details

of

Commands

detail.

from

an

instrument

pull

them

from

appropriate

,

investigate

as

comma

the

previous

,

study

to

how

and

semicolon,

response in

the

statement

using

In

HP

because

the

your

details

the

in

the

output

.If

handles

simple

B

ASIC,

OUTPUT

they

and

Responses

after

instrument

application

of

how

input

statement

and

how

HP

you

you

are

into

B

ASIC,

type:

used

,"

the

it

ENTER

Response

they

719;CW_frequency

examples

are

always

automatically

of

Commands

terminators

do

not

<new

line> <^END>

handled

by the

and Responses

in

more detail.

show

response

.These

input statement.

," later

in this

message

terminators

The paragraph

chapter,

terminators

are

discusses

because

typically

titled

message

\Details

1-19

Essentials

This

section discusses

Read

and understand

following

topics:

for

Beginners

elementary concepts

this section

before

critical

continuing.

to

rst-time

This

section

users

includes

of

SCPI.

the

Program

Messages

Subsystem

Reading

Instrument

Example

and Response

Command

Errors

Programs

Trees

These

paragraphs introduce

of

messages sent

controllers

These

used

These

and

messages

These

.

paragraphs

in

subsystem

paragraphs

print

an instrument's

.

paragraphs

measurement

SCPI

programming

the basic

between instruments

describe

commands

explain

the

.

how

internal error

contain two

programs

that

principles

illustrate

.

tree

to

read

simple

types

and

structure

basic

1-20

Getting

Started

Essentials for

Programming

Beginners

F

orgiving

Precise

Listening

T

alking

and

Program and

To

understand how

SCPI, you

must understand

Program messages

Response Messages

your instrument

are the

instrument. Conversely

the instrument

commands,

The controller

responses

command

query

.

All

measured

be

programmed

SCPI

uses

IEEE

488.2.

F

orgiving

various

accepts

Precise

always

(using

command

either

talking

the

:POWer:STATe?

previously

to the

and response

may

send

only

when

used

to

instruct

query

mnemonics end

values

or

internal

with

the

concept

listening

means

and

:POWer:STATe

means

same

.

For

sent

:POWer:STATe 1

specically

SCPI

the concepts

formatted data

,

response

controller

.

messages

commands

the

instrument

instrument settings

can also

of

forgiving

that

instruments

parameter

ON

that

the

response

example,

),

the

response is

if

and

controller

of program

sent from

messages

Program

contain

at

messages

any

one

time

instructed

to

with a

question mark.

be queried.

listening

formats

or

.

F

:POWer:STATe

format

you

query

always

or

:POWer:STATe

are

the

,

to

do

send

and

are

or

example

the

communicate

and

the

formatted

contain

or

more

but

the

so

.

The

a

response

. Any

internal setting

precise

very

exible

,

1

to

for

a

particular

power

1

state

,

regardless

ON.

response

controller

data

one

responses

instrument

special

message

Queries

talking

the

turn

outlined

in

accepting

synthesizer

RF

query

when

of

using

messages

to

the

sent

or

more

.

sends

type

of

is

return

that can

output

is

it

is

whether

.

from

the

either

in

on.

on

you

T

ypes

of

Commands

Commands

subsystem

Common

used

commands

to

manage

can

be

separated

commands

macros

.

are

,

status

into

generally

registers

two

groups

,

common

not measurement

,

synchronization,

commands

related. They

and

data

and

are

storage

Common commands are easy to recognize because they all begin with an

asterisk, such as

*IDN?,*OPC

,and

*RST

. Common commands are dened by

IEEE 488.2.

Subsystem commands

purpose functions

between keywords

include all measurement functions

. Subsystem commands are distinguished

,asin

:FREQuency:CW?

.

Each command subsystem is a

and some general

by the colon used

.

1-21

Getting

Started

Essentials for

set

of

commands

instrument.

generation,

status

registers

Programming

Beginners

that

F

or

example

while

the

.

roughly

,

the

STATus

corresponds

POWer

subsystem

subsystem

to

a

functional

contains

contains

commands

block

inside

commands

for

accessing

for

the

power

The

more

and

1-22

remaining

detail.

not

in

another

paragraphs

Remember

,

depending

,

some

Figure

in

1-2.

SCPI

Command

this

subsection

commands

on

its measurement

T

ypes

discuss

are

implemented

subsystem

function.

in

one

commands

instrument

in

Getting

Started

Essentials for

Programming

Beginners

The

Command

Structure

Subsystem Command

Most

T

ree

programming

hierarchical

most

computers

structure

tasks

involve

for

.

In

SCPI,

Figure

In

the

command

is

the

root

particular

to

access

the

tree

command

path

to

GG

command,

shown

,

reach

or

lower

simply

Trees

subsystem

subsystem

this

command

1-3.

A

Simplied

in

Figure

the

level

you

must

commands

commands

similar

structure

Command

1-3

,

the

command

root

.

Notice

subcommands

follow

the

is

T

that

.

path

.

called

ree

you

F

or

AA

SCPI

to

the

a

command

closest

must

example

to

BB

uses

le

follow

,

to

a

systems

to

the

if

you

GG

.

top

a

wish

tree

on

.

Paths

Through the

Command

T

o

access

T

ree

understand

instrument

The

rules to

the

next

appear

keyword is

commands

rmware

parser

breaks

determine the

current

how

path

in

an

instrument

,

a

up

the

,

the

level

dierent

parser

,

message

command

in

the

paths

in

interprets

decodes

into

tree

path

command

the

command

commands

each

message

component

used.

tree

.

A

sent

commands

The

parser

where

tree

,

special

to

it

expects

you

must

part

the

instrument.

using

keeps

to

of

a

set

track

nd

command you send. This is important because the same keyword may

in dierent paths

. The particular path you use determines how the

interpreted. The following rules are used by the parser:

the

of

of

the

1-23

Getting

Started

Essentials for



P

ower On

Programming

Beginners

and R

eset

After power



Message

A message

path to

that

send

of

Commands

terminators



Colon

When

it

path

down

MEAS:VOLT

is the

rst character

mnemonic is

species that



Semicolon

A

semicolon

changing



Whitespace

Whitespace

There

are

as

:FREQ

parameters

and

6.2

does

not

is

cycled

T

erminators

terminator

the root.

message

and

in

more

is

between

one

level

species

a root

INIT

separates

the

current

characters

two

important

uency

from

in

the command

aect

the current

or

,

such

Many

terminators

Responses

detail.

two

in

that

of

a

level

is

a

root

two

path.

,

such

,

is

not

commands

after

*RST

,

the

as

a

<new

line>

programming

languages

automatically

,"

later

in

this

command

the

command

VOLT

command,

command.

commands

exceptions

allowed.

.

level

as

F

or

mnemonics

is

one

it

F

or

command.

<tab>

.

Whitespace

Y

ou

must

example

tree

level

species

in

and

:POWer:LEVel 6.2

path.

current

character

.

The

chapter

,

.

F

or

below

example

the

same

<space>

use

,

the

is mandatory

path

is

set

,

sets

have

output

paragraph

,

discusses

a

colon

moves

example

that

,

MEAS

the

the

,

.

next

colon

message

,

are

inside

a

white space

<space>

between

to

the

the

statements

titled,

message

the

the

colon

When

the

command

in

:INIT

without

generally

keyword,

to separate

.

Whitespace

root.

current

\Details

current

in

colon

ignored.

such

LEVel



Commas

If

a

command

adjacent

requires more

parameters using

than one

a comma.

Commas do

path.



Common Commands

Common commands

, such as

*RST

, are not part of any subsystem. An

instrument interprets them in the same way

setting.

1-24

parameter,

you must

not aect

separate

the current

, regardless of the current path

Getting

Started

Essentials for

Programming

Beginners

Figure

navigate

semicolon

1-4

shows

eciently

can

Sending this

:AA:BB:EE; FF;

Is

the

same

as

:AA:BB:EE

:AA:BB:FF

:AA:BB:GG

Figure

examples

through

save

typing.

message:

sending

1-4.

GG

these

Proper

of how

the

command

three

Use

of

the

to use

messages:

Colon

and

the colon

tree

. Notice

Semicolon

and semicolon

how proper

to

use of

the

1-25

Getting

Started

Essentials for

Programming

Beginners

Query

and

Commands

Implied

Commands

Optional

Event

P

arameters

More About

Y

ou

can query

synthesizer

also

exists

.If

only

command.

event has

no corresponding

the instrument

Implied

commands

immediately

command,

and

behaves

expects

The

using

Example

the

you

following

explicit

Synthesizer

Commands

any value

FREQuency:STEP

you see

a command

Some commands

at a

particular instant.

appear

preceding

an

instrument

just

as

if

you

to

include

example

and

any

illustrates

implied

commands

FREQuency:STEP:INCRement

FREQuency:STEP

Optional

a

value

The

parameters

parameter

for

an

instrument's

.

optional

1

names

parameter

command

that you

can

command implies

ending with

are

setting if

in

square

implied

assumes

had

command,

you

sent

parameters

equivalent

commands

with

1

are

enclosed

,the

dictionary

set.

F

or

example

that a

a

question

events

,and

cannot be

it

causes

brackets

intend

it.

Note

required

something

.

If

you

but

do

to

use

that

this

by

ways

to

.

and

without

using

using

in

square

an

explicit

implied

brackets

instrument chooses

documents the

,

the

presence

FREQuency:STEP?

mark,

it

queried.

to

happen

send

a

subcommand

not

send

the

the

implied

means

the

program

implied

the

implied

instrument

command.

the

command:

commands

commands

.

If

you

a

default

values used

of

the

is

a

query

An

inside

implied

command,

synthesizer

do not

value

send

.

for optional

1-26

Getting

Started

Essentials for

Programming

Beginners

Example

Example

Program Message

The following

demonstrate how

parts of

to create

Examples

the synthesizer

complete SCPI

SCPI

command

program messages:

set

will

be

used

to

:FREQuency

[:CW]

:STEP

:POWER

[:LEVel]

1

"FREQuency:CW

The

command

5 GHZ;

is

correct and

STEP 2

GHZ"

will not

cause errors

.It

is

equivalent

to

sending:

"FREQuency:CW

2

"FREQuency

This

command

the

default

the

current

an

error

results

5

GHZ;

5

GHZ;

:STEP

results in

[:CW] node

path

position.

.

A

correct

:FREQuency:STEP

2

GHZ"

a

command

.

When

using

a

Since

there

way

to

send

error

default

is

this

2

.

The

no

command

is:

GHZ"

.

command

node

,

there

"STEP"

makes

is

no

use

change

at

the

of

to

root,

"FREQ

or

as

5

in

example

GHZ;

FREQ:STEP

1.

2

GHZ"

1-27

Getting

Started

Essentials for

Programming

Beginners

Example

Example

3

4

"FREQuency:STEP

This

command

command

colon

command

FREQ:STEP

reset

until

to the

is

missing

it

is in

is

sent,

subsystem. By

root. The

"FREQuency:STEP

"FREQ

5

GHZ;

Notice

that

command

Since

default

use

a

leading

POWER

in

is

correct.

nodes

1

GHZ;

results

in a

a leading

the FREQ:STEP

it causes

corrected command

1 GHZ;

4

DBM"

this

example

It

do

colon

before

FREQuency:CW 5

command error

colon. The

subsystem. So

confusion because

adding a

leading colon,

:FREQuency:CW 5

the

keyword

utilizes

not

aect

PO

WER.

the

default

the

current

GHZ"

. The

path level

no such

is:

GHZ"

short

form

nodes

path,

FREQ:CW

is

dropped

when

the

node

the

current

.

is

used.

of

[:CW]

it

is

not necessary

portion

at

FREQ:CW

occurs

path

The

and

[:LEVEL].

of

each

in

is

the

the

to

1-28

Getting

Started

Essentials for

Programming

Beginners

Reading Instrument

When debugging

has occurred.

panels.

If your

segment in

a program,

Some instruments

instrument cannot

your program

to

10 !

20 !

30 !

40

50

60

70

80

90

The rest

variable

!

Assign

DIM

Err_msg$[75]

INTEGER

!

!

Part

!

that

of

declarations

@box

Err_num

of

your program

generates

100 !

110 !

200 REPEAT

210

220

230

240

250

260

270

280

290

300

310

OUTPUT @Box;":SYST:ERR?"

! Query

ENTER

!

PRINT

!

UNTIL

!

Repeat

Read

Print

instrument

@Box;Err_num,Err_msg$

error

Err_num,Err_msg$

error

Err_num

=

until

!

!

The

rest

of

!

Errors

you may

read

your

to

719

errors

#,

message

message

0

no

errors

your

want

can display

do this

,

you

and

display

error

program

to

know

if

an

error messages

can

put

the

error

messages

instrument

on

their

following

.

error

front

code

1-29

Details

This

section describes

provides

response

many examples

data. The

of

Commands

the syntax

following topics

of the

and

of

SCPI

data

types

are explained:

Responses

commands

used

for

command

and

responses

parameters

.

It

and

Program

Syntax

Response

Syntax

SCPI

Data

Message

Message

Types

These

paragraphs explain

the

messages you

instruments

These

paragraphs

from

instruments

These

paragraphs

in

program

send from

.

discuss

to

the

explain

and response

how to

the computer

the

format

computer

the

types

messages.

properly construct

to

of

messages

sent

.

of

data

contained

1-30

Details of

Getting

Started

Commands and

Programming

Responses

Program Message

These program

punctuation and

Figure 1-5.

messages contain

program message

Simplied

Syntax

commands combined

Program

terminators.

Message

Syntax

with

appropriate

As

Figure

commands

same

end a

shown in

as

the

asserted on the HP-IB

sent. Most programming languages send

For example

automatically sent after your last data

1-5

in

message

program

Figure

program

,ifyou

shows

the

same

,

you

message

1-5

message

,

you

can

send

must

.

Use

message

separate

with

one

<new

terminator

common

.

If

you

them

of

line>

.

the

The

send

with

three

,

<^END>

word

commands

more

than

a

semicolon.

program

,

or

<new

<^END>

and

subsystem

one

command

Y

ou

must

message

terminators

line>

means that

<^END>

EOI is

interface at the same time the preceding data byte is

these terminators automatically

use the HP B

ASIC

OUTPUT

statement,

<new line>

byte. If you are using a PC, you can

usually congure the system to send whatever terminator you specify

in

the

always

.

is

.

1-31

Getting

Started

Details of

Programming

Commands and

Responses

SCPI Subsystem

Figure

1-6.

SCPI

Simplied

As

Figure

mnemonic

the

more

parameters

few

places

than

1-6

and

one

with

shows,

the

rst

in

SCPI where

parameter

a

comma.

subsection.

Command Syntax

Subsystem

there

must

parameter in

<space>

with

P

arameter types

Command Syntax

be

a

<space>

a

a single

subsystem

is

required.

command,

between

are

explained

the

command.

Note

that

you

must

later

last

command

This

is

if

you

separate

in

this

one

of

send

adjacent

1-32

Details of

Getting

Started

Commands and

Programming

Responses

Common Command

Figure

1-7.

Simplied Common

As

with

mnemonic

comma.

subsystem

from subsequent

P

arameter types

commands

are

Syntax

Command Syntax

,

use

a

<space>

parameters

explained

.

Separate

later

to separate

adjacent

in

this

subsection.

a

command

parameters

with

a

1-33

Getting

Started

Details of

Programming

Commands and

Responses

Response Message

Figure

1-8.

Simplied

Response

When

each

the

semicolon.

return

a

single

data

groups

a

messages

query

item.

of

data

F

or

example

response

can

When

items corresponding

message

Syntax

Response

contain

command

multiple

,the

of:

both

returns

queries

ctitious

<data1>,<data1>;<data2>,<data2>

Message

commas

multiple

are

to

query

Syntax

and

semicolons

values

,

a

comma separates

sent

in

the

same

each

query

are

separated

:QUERY1?:QUERY2?

as

separators

message,

might

by

.

a

Response data

types

<new line><^END>

1-34

are

is

always

explained

sent

later

as

in

a

response

this

subsection.

message

Note

that

terminator

.

Details of

Getting

Started

Commands and

Programming

Responses

SCPI Data

Types

These paragraphs

response data.

type.

SCPI denes

and response

They list

messages.

forgiving listening

instruments are

formats.

query in

exible

are

Precise talking

a

predened,

in

the

dened

to

spirit

meet

explain the

the types

dierent data

It

does

and precise

exible,

accepting

means

rigid

format.

of

forgiving

the requirements

T

Parameter

Numeric Real

Extended

Discrete Discrete

Boolean Numeric

String String

data types

available and

formats for

this

talking.

commands

an

instrument

listening.

able

1-2.

T

ypes

Numeric

available

use

to

accommodate

Recall

P

arameter

Conversely

of precise

SCPI

Data T

Response

or

Integer

Integer

Boolean

present

in

that

and

always

data

talking.

ypes

Data

T

for

parameters

examples

program

the

principle

forgiving

parameters

responds

types

are

,

response

ypes

and

for

messages

of

listening

in

various

to

a

designed

data

each

means

particular

to

be

types

Block Denite

Non-decimal

Numeric

L

ength

Indenite

Hexadecimal

L

ength

Block

Block

Octal

Binary

Notice that each

data types

.F

parameter type has one or more corresponding response

or example

, a setting that you program using a numeric

parameter returns either real or integer response data when queried.

Whether real or integer response data is returned depends on the instrument

used. However

dened for a particular instrument and query

, precise talking requires that the response data type be clearly

. The instrument command

1-35

Getting

Started

Details of

Programming

Commands and

Responses

Numeric

Parameters

dictionary

individual

response

P

arameter

in

Chapter

commands

data

type

Types

Numeric parameters

commands

representations

scientic

If

an

assume

the

impedance

the

values

*ESE 10.123

Examples of

.

Numeric

notation.

instrument

a

nite

parameter

of

value

is

,

it

automatically

of

setting

number

.

F

or example

50

or

rounded

is

the

numeric

2

generally

.

The

following

in

more

detail.

are

used

parameters

numbers

including

programmed with

of values

,if

75

ohms

,and

to

75

.If

rounds

same

as

sending

parameters:

contains

in

both

accept

, the

an

instrument

you

the

instrument

the

paragraphs

subsystem

all

optional

a numeric

instrument

specied

value

to

*ESE

information

explain

commands

commonly

signs

,

automatically

has

a

programmable

76.1

setting

an

integer

10

.

about

each

and

used

decimal

decimal

parameter

for

output

can

only

.

F

or

example

data

types

parameter

common

points

,

and

can

only

rounds

output

impedance

assume

,

for

and

,

integer

sending

100

100.

-1.23

4.56e<space>3

-7.89E-01

+256

.5

1-36

no

decimal point

fractional digits

leading

space

use

leading

digits left

allowed

either

signs

allowed

after

E

or

+ allowed

of decimal

required

optional

e

in

e

in

exponentials

point optional

exponentials

Extended

P

arameters

Numeric

Most

subsystems use

quantities

values

accept

DOWN

MAXimum

determining

In

some instruments

suxes

Note

or

STATus

.

Extended

and

other

MAXimum

may

be

can be

the range

as part

that extended

subsystem

extended numeric

numeric parameters

special values

and

MINimum

available as

used to

of values

, extended

of the

parameter value

numeric

commands

as well.

as

values.

documented in

set or

query

allowed for

numeric parameters

parameters

.

Details of

parameters to

accept all

All extended

Other special

Chapter 2.

values

.

The

a

given

.

are

not

Getting

Commands and

specify physical

numeric parameter

numeric

values

,

Note

that

query

forms

parameter

accept

used

for

common

engineering

Started

Programming

Responses

parameters

such

as

MINimum

are

useful

.

commands

UP

unit

and

and

for

Examples

of

100.

-1.23

4.56e<space>3

-7.89E-01

+256

.5

MAX

MIN

-100

mV

extended

numeric

any

simple

largest

valid

setting

negative

parameters:

numeric

valid

setting

nearest

100

millivolts

values

negative

innity

1-37

Discrete

P

arameters

Getting

Started

Details of

Use

discrete

values

.

They

have

used

mixed

Programming

Commands and

parameters

Discrete

parameters use

a

long and

upper

Responses

to

a short

and lower

program settings

mnemonics to

form, just

case letters

like

for discrete

that have

represent each

command

parameters

a nite

number

valid

mnemonics

.

setting.

.

Y

ou

of

can

Boolean

P

arameters

Examples

INTernal

DIODe

Although

confuse

a

colon

to

separate

Examples

100

100

Boolean

false

.

There

Examples

ON

OFF

1

0

of

discrete

internal leveling

external

discrete

the

two

.

separate

parameters

of

discrete

OUTPUT

OUTPUT

parameters

are

only four

of

Boolean

Boolean

Boolean

Boolean

Boolean

parameters used

diode

parameters

In

particular

command

from

command

parameters

detector

values

,

be

mnemonics

with the

leveling

look

sure

to

mnemonics

in

commands:

like

use

from

command

colons

each

@Source;"POWer:ALC:SOURce

@Source;"POWer:ALC:SOURce

represent

a

possible

single

values

binary

for

condition

a

parameters:

TRUE,

F

ALSE,

upper/lower

upper/lower

case

case

allowed

allowed

TRUE

F

ALSE

ALC:SOURce subsystem:

and

other

keywords

spaces

.

Use

,

do

properly

a

space

.

INT"

DIODe"

that

is

either true

Boolean

parameter

.

not

. Use

to

or

1-38

Details of

Getting

Started

Commands and

Programming

Responses

Real

Integer

Response

Response

Data

Data

Response Data

A

large

portion

Real

response

scientic

formatting

Most

high

either

type

Examples

of

all

data

notation.

real

data,

level

programming

transparently

of

real

response

1.23E+0

-1.0E+2

+1.0E+2

0.5E+0

1.23

-100.0

+100.0

0.5

Integer

optional

response

signs

. Most

data

data.

Types

measurement

are

decimal

In

general,

or

whether

.

data:

are

decimal

status

register

data

numbers

you

do

not

xed

decimal

languages

representations

related

are

in

need

that

either

queries

formatted

xed

to

worry

or

scientic

support

of

return

as

real

response

decimal

about

notation

the

notation

instrument

integer values

integer

rules

is

used.

I/O

handle

including

response

data.

or

for

Examples

0

+100

-100

256

of

integer response

signs

are

optional

leading +

leading

never

sign allowed

sign

any

decimal

data:

allowed

point

1-39

Discrete

Response

Data

Getting

Started

Details of

Discrete

is

that

Commands and

response

discrete

mnemonic,

Programming

data are

response data

in

all

upper case

Responses

similar to

discrete parameters

return only

letters.

the short

form

. The

of

a

main

dierence

particular

String

Response

Data

Examples

of

INTernal

DIODe

String

that string

response data

response data

single quotes

data.

Embedded

characters

Examples

"This

"SO

"I

between

of

IS

IS

said,

discrete

level internally

level

are similar

. Embedded

quotes

them.

string

response

valid"

THIS

""

""Hello!"""

response data:

using

an

external

to string

use only

double

appear

double

quotes

as

two

data:

"

diode

parameters

quotes

may

be

adjacent

.

as

delimiters

present

double

The

in

quotes

main

,

string

with

dierence

rather

response

no

is

than

1-40

Programming

This

section illustrates

sections

programming

will

apply to

begin with

programming real

with SCPI,

a simplied

Typical

how the

general

we must

example.

Measurements

SCPI

concepts

measurements

list the

commands

.

T

o

for

presented

introduce

the

synthesizer

in

previous

you

to

.

W

e

Using

The

example

the

operator

following

follow

The

this

T

o

nd

the

HP-IB

section

the

Press

The

active

displayed

Now

check

4

5

ENTER

keys

.

to change

the

Example

programs

.

If

you

all

of

the

programmed

select

expect

present

5

4

SHIFT

4

LOCAL

entry

is

not

19, press

that

the

The

selected

the

Programs

are

interactive

desire

to

instructions

activity

code

is

assumed

the

synthesizer's

HP-IB

address

5

.

area indicates

5

4

19

interface

interface

language

.

get

an

understanding

,

read

.

to

be

HP-IB

use

the present

ENTER

5

4

language

language

.

They

the

preset

the

to

is

reset

require

\Program

to 7.

address

front

panel.

decimal

it to

set

to

SCPI.

is

then

shown,

active

of

the

principles

participation

Comments"

All

example

to

be

decimal

address

.

19.

Press

4

SPECIAL

use

the

paragraphs

programs

19.

If

the

number

5

up

by

without

5

4

15

and

down

to

in

1-41

Getting

Started

Programming T

Programming

ypical Measurements

HP-IB Check,

This rst

program is

functional. Connect

and reset

the controller

10 Synthesizer

20 ABORT

30 LOCAL

40 CLEAR

50

REMOTE

60

CLS

70

PRINT

80

PRINT

90

END

Run

the

program

synthesizer.

that the

If

program

interface

the controller

was entered

statement

service

guide

but

7

Synthesizer

Synthesizer

"The

"Verify

and

If

it

is

cable

display

the synthesizer

to

nd

Example Program

to verify

a controller

that

and type

the

to the

in the

HP-IB

synthesizer via

following

=719

Synthesizer

synthesizer

verify

not,

verify

is

properly

indicates

in

incorrectly

the

trouble

that

that

that

RMT

should now

the 'RMT'

the RMT

the

synthesizer

connected.

an

error

.

If

the

annunciator

shooting

1

connections

program:

be in

annunciator is

annunciator is

address

message

controller

,

does

it

accepts

not

information.

and

an

lit

is

possible

turn

interface

HP-IB

REMOTE."

on

the

is

set

the

on,

cable

.

on."

to

19

and

that

the

REMOTE

refer

are

Clear

to

the

Program

Comments

10:

Set

up a

20:

Abort

states

30: Place

may have

40: Reset

source

variable to

any bus

.

the synthesizer

been setup

the synthesizer's

.

Prepare

contain

activity and

into

.

parser and

the

synthesizer

the

HP-IB

return the

LOCAL

to

address

HP-IB interfaces

to

cancel

clear any

receive

50: Place the synthesizer into REMOTE.

60: Clear the display of the computer

.

70: Print a message to the computer's display

1-42

any

new

.

of

the

Local

pending

commands

source

to

their

Lockouts

output

.

.

from

reset

that

the

Getting

Programming T

Started

Programming

ypical Measurements

Local Lockout

When the

disabled except

is set

executed from

instruments to

synthesizer is

on the

bus,

the LOCAL

even the

the controller

front panel

Continue example

commands:

90

PRINT

"Verify

except

100

PRINT

"Verify

RMT

110

PRINT

"

.....

120 PAUSE

130 REMOTE

140 LOCAL

150

PRINT

160

PRINT "Synthesizer

170

PRINT

Synthesizer

LOCKOUT

"Verify that

have

180

190

200

210

220

230

PRINT

PAUSE

LOCAL

PRINT

PRINT

PRINT

"

.....

Synthesizer

"Synthesizer

"Verify

is

240

END

Demonstration, Example

in REMOTE

key.

LOCAL

,

is

mode

But, when

key

is

then

the

,

all

the

the

disabled.

only

way

LOCAL

control.

program 1.

annunciator

Delete

that

all

the

'LOCAL'

that

'LOCAL' causes

press

CONTINUE"

line

keys

to

90

END

are

key."

go

OFF."

ignored,

the

7

no

effect."

press

that

should

all

CONTINUE"

should

the

now

be

in

keys

(including

now

be

in

synthesizer's

functional."

front

The

to

return

and

type

LOCAL

LOCAL

keyboard

Program 2

panel

keys

LOCK

OUT

LOCAL

command,

all

(or

in

the

LOCKOUT

'LOCAL')

mode."

are

command

selected)

following

mode."

1-43

Getting

Started

Programming T

Programming

ypical Measurements

Program

Comments

90

130:

140:

150

200:

210

to

120:

to

190:

to 230:

Print a

Place

Place

Print a

message on

the

the

message on

Return the

Print a

message on

the computer's

synthesizer into

synthesizer into

the computer's

synthesizer to

the

computer's

display,

REMOTE.

LOCAL LOCK

display

local control.

display

then

OUT mode

,

then

.

pause

.

pause

.

.

1-44

Getting

Programming T

Started

Programming

ypical Measurements

Program

Comments

Internally Leveled

In the

following example

frequency of

the controller

2.000203 GHz

and type

,an

in the

10 Synthesizer=719

20 ABORT

30 LOCAL

40 CLEAR

50

REMOTE

60

OUTPUT

70

OUTPUT

80

OUTPUT

90

OUTPUT

100

OUTPUT

7

7

Synthesizer

Synthesizer

Synthesizer;"*RST"

Synthesizer;"POW:ALC:SOUR

Synthesizer;"FREQuency

Synthesizer;"POWer:LEVel

Synthesizer;"OUTP:STATe

110 END

Run the

10:

20

60:

to

program.

50:

Assign

Abort

Set

the

*RST

the

any

synthesizer

state

CW Signal,

internally

with a

power level

following program:

synthesizer's

HP-IB

activity

to its

is

the

same as

Example Program

leveled,

of

CW

0

signal

2.1

dBm.

INT"

2.000203GHZ"

-2.1

DBM"

ON"

HP-IB

address

and

initialize

initial state

the PRESET

to

a

variable

the

HP-IB

for

programming.

state

.

is

generated

Clear

interface

.

and

3

at

reset

.

The

a

70:

80:

Enable

Set

90: Set

100: Turn

internal leveling.

the

frequency

to 2.000203

the synthesizer's

the RF

output

power

on.

GHz.

level

to

0

2.1

dBm.

1-45

Getting

Started

Programming T

Programming

ypical Measurements

Level Correction

The following

externally,

correct tables

example demonstrates

then load

. Clear

Routine,

the collected

and reset

the controller

Example Program

how to

data into

gather

one

and

of

type

the

program:

10 Synthesizer=719

20 Power_meter=713

30 ABORT

40

50

60

70

80

90

LOCAL

CLEAR

REMOTE

CLS

OUTPUT

OUTPUT

100 DIM

110 DIM

120 PRINT

7

7

Synthesizer

Synthesizer

Synthesizer;"*RST"

Power_meter;"*RST"

Frequencies(1:401)

Losses(1:401)

"CHOOSE

THE

START

FREQUENCY

IN

EXAMPLE)"

130

140

ENTER

PRINT

KBD;Start_freq

"CHOOSE

THE

STOP

FREQUENCY

IN

EXAMPLE)"

150

160

170

180

190

200

210

ENTER

PRINT

ENTER

PRINT

ENTER

PRINT

PRINT

KBD;Stop_freq

"CHOOSE

KBD;Points

"CHOOSE

INTO

(1

TO

KBD;Table_num

"CHOOSE

DURING

"THE

";

LEVEL

THE

NUMBER

THE

LEVEL

4)"

THE

SYNTHESIZER

CORRECTION"

OF

POINTS

CORRECTION

POWER

(2

TABLE

220 PRINT "(-3.32 FOR EXAMPLE)"

230 ENTER KBD;Power_level

240 OUTPUT Synthesizer; "POW ";Power_level

250 OUTPUT Power_meter; "FM 32 EN"

260 OUTPUT Power_meter; "TR0"

270

Step_freq=(Stop_freq-Start_freq)/(Points-1)

280 Current_freq=Start_freq

level

correct

synthesizer

in

the

GHZ

GHZ

(15.123456

TO

LEVEL

4

data

level

following

(1.654321

401)"

TO

STORE

TO

USE

FOR

FOR

DATA

1-46

290

FOR

I=1

300

310

320

330

340

350

360

370

380

NEXT

I

390

OUTPUT

400

!

410

!

Store

420

!

430

OUTPUT

440

FOR

I=1

450

460

470

NEXT

I

480

OUTPUT

490

!

500

!

Store

510

!

520

OUTPUT

530

FOR

I=1

540

550

560

NEXT I

570

OUTPUT Synthesizer

580

PRINT "END

590

END

Programming T

TO

Points

Frequencies(I)=Current_freq

OUTPUT

OUTPUT

OUTPUT

WAIT

ENTER

Synthesizer;

Power_meter;

Power_meter;

"FREQ

"FR

";Current_freq;"

";Current_freq;"

"TR2"

5

Power_meter;Meter_reading

Losses(I)=Power_level-Meter_reading

Current_freq=Current_freq+Step_freq

Synthesizer;

"MEM:TABL:SEL

FDAT";TRIM$(VAL$(Table_num))

frequencies

Synthesizer;

TO

Points

OUTPUT

IF

I<Points

Synthesizer

"MEM:TABL:FREQ

";

Synthesizer;Frequencies(I);"GHZ";

THEN

USING

OUTPUT

"/"

Synthesizer;",";

losses

Synthesizer;

TO

Points

OUTPUT

IF I<Points

"MEM:TABL:LOSS

";

Synthesizer;Losses(I);

THEN

USING

OUTPUT

"/"

Synthesizer;",";

OF PROGRAM"

Getting

Started

Programming

ypical Measurements

GHZ"

GZ"

Program Comments

Run

the

program.

10: Assign the synthesizer's HP-IB address to a variable

20: Assign the power meter's HP-IB address

30 to 60:

70: Clear the computer's display

Abort any HP-IB activity and

initialize the HP-IB interface

.

to a variable

.

.

.

1-47

Getting

Started

Programming T

Programming

ypical Measurements

80: Set

90: Set

the synthesizer

the

power

100: Dimension

110: Dimension

120:

Print

a

message

frequency

130:

140:

Enter

Print

start

a

message

frequency

150:

160: Print

Enter

stop

a

message

measure.

170: Enter

180:

190:

200

to

220:

Print

desired

Enter

Print

power

number

a

message

correction

correction

a

message

level.

meter

frequency

correction

.

frequency

.

frequency

of

to its

initial

to

its

initial

array

.

factor

on

the

computer

into

variable

on

the

computer

into

variable

for

entering

measurement

on

the

computer

table

number

table

number

on

the

computer

array

the

points

.

into

state

state

.

display

Start

display

Stop

number

display

variable

display

for

programming.

for

programming.

for

entering

freq.

for

entering

freq.

of

frequency

into

variable

for

entering

T

able

for

entering the

the

the

P

oints

the

num.

start

stop

points

.

to

230:

240:

250:

260:

270:

280:

Enter

power

Set

Synthesizer's

Set number

Set

power

Calculate

Set variable

variable

Start

level

into

power

of averages

meter to

the

frequency step

Current

freq.

variable

level

.

trigger hold

.

freq

equal to

P

to

mode.

ower

the

entered

the start

level.

value

frequency set

.

300: Store current frequency into the Frequencies array

310: Set Synthesizer to the current frequency

.

320: Set power meter frequency to the current frequency

330: Set power meter to trigger with delay

.

1-48

by

.

.

Getting

Programming T

Started

Programming

ypical Measurements

340: W

350: Enter

ait ve

current

Meter reading.

360: Store

the

370: Increment

390:

430:

450:

460: A

480: A

measure

Select

Command

points

A

dd

dd

dd a

.

a

into

a

frequency

a

data

line

520: Command

540:

550:

570:

factors

A

A

A

dd

dd

dd

a

a

a

into

correction

data

line

seconds for

power

correction

the current

table

for

the

synthesizer

table

.

point

separator

feed.

the

synthesizer

table

.

separator

feed.

power

meter

factor

data

factor

meter

reading

into

frequency

storage

to

into

the

(comma).

to

into

the

(comma).

the

.

load

table

load

to

to

the

the

table

stabilize

into

Losses

the

next

following

.

following

.

.

variable

array

frequency

.

point

frequency

correction

to

1-49

Getting

Started

Programming T

Programming

ypical Measurements

Saving and

The complete

memories called

a program.

Recalling States

front panel

registers 0

Clear and

10 Synthesizer=719

20 ABORT

30 LOCAL

40 CLEAR

50

REMOTE

60

CLS

70

OUTPUT

7

7

Synthesizer

Synthesizer

Synthesizer;"*RST;FREQ:

;OUTP:STAT

80

OUTPUT

90

CLS

100 PRINT

110 OUTPUT

120 OUTPUT

130

PRINT "A

140

PRINT

150

PAUSE

160

OUTPUT

170

PRINT

180

PRINT

190

PAUSE

200

OUTPUT

210

PRINT

220

PRINT

230

END

Synthesizer;"*SAV

"A

Synthesizer

Synthesizer;"*RST;FREQ:CW

Synthesizer;"*SAV

CW

state

"..... Press

Synthesizer;"*RCL

"Register

"Press

Continue."

Synthesizer;"*RCL

"Register

"Verify

state may

through 9.

reset the

ON"

state

has

been

Continue"

1

recalled.

2

recalled."

Synthesizer

,Example

be

saved

This can

controller and

4GHZ;POW:LEV

1"

has

been

1.23456GHZ;:POW:LEV

2"

saved

in

1"

Verify

2"

is

in

CW

Program

for

later

use

be

done

type

in

the

-3DBM

saved

in

REGISTER

Synthesizer

mode."

in

non-volatile

remotely

following

REGISTER

2."

output

5

as

a

part

program:

1."

-1DBM"

power."

of

Run

1-50

the

program.

Getting

Programming T

Started

Programming

ypical Measurements

Program

Comments

10:

20

60:

70:

80:

90:

100:

110:

120:

to

50:

Assign

the

Abort any

Clear

the

Set

up

a Synthesizer

commands

to

the following

Save

this

Clear the

Print

a

message on

Setup

the

several

commands

equivalent

Save

this

synthesizer's HP-IB

HP-IB activity

and initialize

computer's display

state.

into a

single message

lines :

state

OUTPUT

OUTPUT

OUTPUT

OUTPUT

into

Synthesizer;"*RST"

Synthesizer;"FREQ 4GHZ"

Synthesizer;"POW:LEV -3DBM"

Synthesizer;"OUTP:STAT

storage

computer display

the computer

synthesizer for

into

to

the

following

OUTPUT

OUTPUT

OUTPUT

state

into

aCW

a

single

Source;"*RST"

Source;"FREQ:CW

Source;"POW:LEV

storage

address to

.

Note the

. This

register

.

state

message

lines

register

the

combination

single

1.

display

.

Note

:

2.

a variable

HP-IB

line

.

the

.

This

1.23456

-1DBM"

.

interface

of

several

is

equivalent

ON"

combination

single

line

GHZ"

.

of

is

130

160:

170

200:

210

to

to

and

150:

190:

220:

Print

Recall

Print

Recall

the

CW state

Print

a

message

the

instrument

a

message

the

instrument

.

messages

on

the computer

state

on

the computer

state

on

the

computer

display and

from register

display and

from

register

display

.

pause

1.

pause.

2. It

should contain

.

1-51

Related

IEEE

Standard

Programmable

Electronics

This

HP-IB

and

information

However

related

IEEE

and

Common

Engineers

standard

interface

,

it

documents

Standard

can be

International

1987.

This

document

used

in

SCPI.

for

instrument

need

to

know

common

commands

Documents

488.1-1987,

IEEE Standard

Instrumentation.

,

New

Y

ork,

denes

the technical

(IEEE

488.1). This

on

protocol that

useful to

clarify formal

.

488.2-1987,

Commands

Institute

describes

It

is

intended

F

or

of

Electrical

the

IEEE

underlying

more

user/programmers

the

precise

denition

.

The

International

NY

, 1987.

details required

standard contains

is beyond

Standard

Use

with

ANSI/IEEE

and

Electronics

message

for

instrument

.

However

of

certain

Digital Interface

Institute

to design

electrical specications

the needs

of most

denitions of

Codes,

F

ormats,

Std

488.1-1987.

Engineers

formats

rmware

,

you

may

nd

message

formats

for

of

and build

certain

Protocols,

,

and

engineers

it

useful

Electrical

and

an

programmers

terms

used

The

New

Y

ork,

NY

data

types

than

if

you

,

data

types

.

in

,

,

or

N

O

T

E

T

o

obtain a

The

Institute

copy

of

of either

Electrical

of these

documents,

and Electronics

write

Engineers, Inc

to:

. 345

East

47th

Street

USA

BASIC 5.0/5.1 Interfacing T

echniques. V

ol. 2, Specic Interfaces.

Hewlett-Packard Company 1987.

This HP B

ASIC manual contains a good non-technical description of the HP-IB

(IEEE 488.1) interface in Chapter 12, \The HP-IB Interface

revisions of HP B

ASIC may use a slightly dierent title for this manual or

1-52

New

Y

ork,

NY

10017

." Subsequent

Getting

Started

Related Documents

Programming

chapter

.

This

programmers

Tutorial

Company

This

designer

N

T

your

Standard

This

book

,

O

T

E

o

obtain

telephone

document

Description

,

1987

provides

programmer

a

cop

Commands

Instruments

N

O

T

E

manual

.

y

of

either

directory

denes

(SPCI)

is

the

best

of

the

Hewlett-P

a

thorough

,

or

user

.

of

these

documents,

.

for

Programmable

the

Standard

Consortium's

reference

ackard

overview

contact

Commands

SCPI

on

instrument

Interface

of

HP-IB

the

Hewlett-P

Bus

basics

ackard representative

Instruments (SPCI)

for

Programmable

standards

.

I/O

for

Hewlett-P

for

the

HP

ackard

HP-IB

B

ASIC

system

listed in

T

o

obtain

the

SCPI Consortium

8380

Hercules

La

Mesa,

CA

91942

Phone:

(619)

F

AX:

(619)

697-5955

CompuServe:

above

document,

Drive

,

Suite

697-8790

76516,254

contact:

P3

1-53

Getting

Started

Programming

Related Documents

2

Programming

Commands

Programming

This

chapter contains

used

by the

of

commands that

pertaining

individual

remainder

all

programming commands

the

tab

labeled

synthesizer.

to automatic

commands are

of this

labeled

\A

\Status

detailed information

are tabbed.

chapter

utomatic

Register

Commands

on

The

chapter

For

level control

is

sub-divided

example

,

are contained

all

organized alphabetically

introduction

.

The

Level

Commands

contains

programming

Control

Commands"

."

all

the

programming

into

programming

in

one

within each

information

command

and

logical

commands

tabbed

that

entries

end

commands

groupings

section.

section.

pertains

begin

with

the

The

The

to

with

tab

2-2

Command

F

ollowing the

statement

statement

showing the

is shown

Syntax

heading for

proper syntax

below:

each

programming

for

command

the

command.

2

SOURce213:3POWer2:LEVel32:IMMediate32:AMPLitude

:STEP2:INCRement

3

8

incr

>

<

MAXimum

MINimum

>

:

9

>

=

>

;

DEFault

entry

An

is

a

syntax

example

3

syntax

Syntax

example

\

separating

the

the

statements















statements

,

the

\

[:AMPLitude]

space

above

statement

example

is

are

italics

::=

j

<

repeated

[

f

be

Uppercase

means

(vertical

A

>

j

.

.

.

(an

]

(square

g

(braces)

selected.

are

used

\is

bar)

<

B

>

ellipsis)

one

brackets)

indicate that

Lettering (

read

:STEP

"

"

portion

is

legal

,

the

the

argument.

dened

to

symbolize

dened

indicates

indicates

is

or

more

from

portion

of

only

portion

as

follows:

as".

<

A

used

times

indicate

FREQ

left

of

the

between

a

a

choice

>

or

to

indicate

.

that

one and

uency

to

right

the

statement

statement

the

following

A

dditional

program

of

one

<

B

>

but

that the

the

only one

)

indicates that

and

top

to

immediately

with

no

command

the

\

[:INCRement]

conventions

code

parameter

element

not

both.

preceding element

enclosed

of

items

the

bottom.

separating

and

from

are optional.

enclosed

the uppercase

the command is the minimum required for the command.



Lowercase Lettering (

FREQuency

) indicates that the lowercase portion of

the command is optional; it can either be included with the

portion of the command or omitted.

its

used

or

a

list.

In

the

above

follows

space

the

.

argument.

"

portion

in

the

syntax

query

response

F

or

example

may

elements

portion of

uppercase

A

In

of

.

,

be

must

2-3

Programming

Command Syntax

Commands

2a

A

utomatic

Commands

Level

Control

A

utomatic Level

This

sub-chapter contains

pertaining

to automatic

Control Commands

detailed information

level control.

on

all

programming

commands

2a-2

[SOURce[1]:]POW

er:ALC:PMET

er

2

SOURce213:3POWer:ALC:PMETer2:LEVel

8

pmeter

>

>

>

MAXimum

>

>

<

MINimum

UP

>

>

>

>

DOWN

>

:

9

>

>

>

>

>

=

>

>

>

>

>

;

DEFault

The

\[SOURce[1]:]PO

reading

of

the

external power

The parameters

pmeter

MAXimum

MINimum

UP

W

er:ALC:PMET

external

power

meter leveling.

are as

follows:

Enters

the

0

when

option

Sets

the initial

synthesizer

120

dBm

option

1E1

the

initial

allowable

Sets

the

initial

allowable

Increases

current

increment

(

0

is

value

value

the

meter

reading

.

The

100

dBm

1E1

is

not

installed.

power

.

power

.

entered

er"

value

command

to

the

synthesizer

of

allowable

for

HP

installed

meter

meter

initial

.

3

2

:AMPLitude

is

used

the

external

range

for

83711A/12A)

or

0

15

dBm

reading

reading

power

to

to

meter

for

its

its

to

use

power

the

to

reading

3

enter

the

during

meter

parameter

to

+30

+30

dBm

maximum

minimum

by

initial

to

is

dBm

if

the

DO

WN

DEF

ault

The power meter

Decreases

current

Sets

value

the

increment

the initial

.

reading set with the \[SOURce[1]:]PO

command allows the synthesizer

at the power meter Recorder

Output connector

entered

power meter

initial power

value

.

meter reading

reading to

its default

by the

(preset)

Wer:ALC:PMETer"

to calculate the value of the voltage present

.

2a-3

Automatic

L

evel

Control

Commands

[SOURce[1]:]POWer:ALC:PMETer

If

an

initial

range

either

0

dBm.

,

an

its

power

error

maximum

meter

message

or

will

minimum

reading

be

is

entered

generated

limit.

The

that

and

preset

is

outside

the

parameter

value

for

of

its

the

allowable

will

be

parameter

set

to

is

Query

Syntax

2

SOURce213:3POWer:ALC:PMETer2:LEVel

2

3

MAXimum

4

MINimum

5

DEFault

Returned format:

pmeter

<

NL

>

Where:



pmeter

is



pmeter

MAXimum



pmeter

MINimum



pmeter

argument

::=

specied.

::=

::=

::=

The current

The

maximum

argument

The

minimum

argument

The

default

is

specied.

entered

is

specied.

is

specied.

(preset)

initial

initial

initial

power

power

initial

power

meter

meter

power

3

2

:AMPLitude3?

meter

reading

reading

reading

meter

that

that

reading

if

can

can

if

no

argument

be

be

set

the

DEF

set

if

if

ault

the

the

See Also

[SOURce[1]:]POWer:ALC:PMETer:STEP

[SOURce[1]:]PO

UNIT:POW

Wer:ALC:SOURce

erj:VOLTage

2a-4

[SOURce[1]:]POW

er:ALC:PMET

er:STEP

2

SOURce213:3POWer:ALC:PMETer2:LEVel3:STEP2:INCRement

8

incr

>

<

MAXimum

MINimum

>

:

9

>

=

>

;

DEFault

The

\[SOURce[1]:]PO

value

for

the

entered

The

parameters

incr

MAXimum

MINimum

DEF

ault

When

the \UP"

\[SOURce[1]:]PO

reading

will

be

\[SOURce[1]:]PO

W

er:ALC:PMET

initial

are

as

follows:

Sets

the

increment

The

allowable

when

option

1E1

is

not

installed.

Sets

the

increment value

to

its

maximum

Sets

the

increment

to

its

minimum

Sets

the

increment

to

its default

or \DO

WN"

Wer:ALC:PMET

increased

W

er:ALC:PMET

or

er:STEP"

power

meter

value

range

1E1

is

installed

allowable

value

allowable

value

(preset)

parameters

er" command,

decreased

er:STEP"

reading.

for

for

the

for the

for

for

value

are

by

a

command.

command

the

parameter

or

0.01

value

.

the initial

value

.

the

.

used

the

step

size

selects

initial

power

is

dB

to

initial power

power

initial

power

with

the

initial

power

set

with

the

meter reading.

0.01

dB

45

dB

if option

meter

meter

meter

meter

the

3

increment

to 130

dB

reading

reading

reading

Numeric

0.01

dB

power

.

meter

reading

increment

value

entries

have

a

resolution

of

If an initial power meter reading increment value entry is made that is not

within the allowable parameter range

, an error message will be generated and

it will be set to either its maximum or minimum limit. The preset value for

the

initial power meter reading increment value is 1 dB

.

2a-5

Automatic

L

evel

Control

Commands

[SOURce[1]:]POWer:ALC:PMETer:STEP

Query Syntax

2

SOURce213:3POWer:ALC:PMETer2:LEVel3:STEP2:INCRement3?

2

3

MAXimum

4

MINimum

5

DEFault

Returned

incr

format:

<

NL

>

Where:



incr

::=

The

is

specied.



incr

::=

The

set

if

the



incr

::=

The

set

if

the



incr

::=

The

DEF

ault

argument

See

Also

[SOURce[1]:]PO

UNIT:PO

W

current

maximum

MAXimum

minimum

MINimum

default

W

er:ALC:PMETer

er

j

:VOL

Tage

power

power

argument

power

argument

(preset)

is

specied.

meter

meter

is

meter

is

specied.

power

reading

reading

specied.

reading

meter

increment

increment

increment

reading

value

value

value

increment

if

value

no

that

that

argument

can be

can be

if

the

2a-6

[SOURce[1]:]POW

er:ALC:SOURce

2

SOURce213:3POWer:ALC:SOURce

The

\[SOURce[1]:]PO

for

output

The

parameters

INT

ernal

DIODe

PMET

er

The

4

EXT

DIODE

leveling),

HP

Guide

When

and

83711A/12A

provide

the synthesizer

power

automatic

are

Selects

Selects

Selects

5

(diode

4

INT

LEVEL

and

detailed

W

er:ALC:SOURce"

as

follows:

internal

external

external

detector

5

(internal

HP

83711B/12B

information

is

set

level

to

the

control.

leveling.

diode

detector

power

leveling),

leveling)

Synthesized

on

the

preset

8

INTernal

<

DIODe

:

PMETer

command

meter

leveling.

4

EXT

METER

entries

type

state

,

internal

9

=

;

selects

leveling.

5

(power

in

chapter

CW

Generators User's

of

leveling

leveling

the

you

type

meter

6

select.

of

of the

is

selected.

leveling

Query

Syntax

2

SOURce213:3POWer:ALC:SOURce?

Returned

source<NL

format:

>

Where:







source

source

source

::= \INT"

::= \DIOD"

if internal leveling is currently selected.

if external diode detector leveling is currently selected.

::= \PMET" if

external power meter leveling is currently selected.

2a-7

Automatic

L

evel

Control

Commands

[SOURce[1]:]POWer:ALC:SOURce

See Also

4

EXT

4

EXT

4

INT

DIODE

METER

LEVEL

5

5

5

[SOURce[1]:]POW

[SOURce[1]:]POW

To

Use External

To

Use External

er:ALC:PMETer

er[:LEVel]

Diode

Detector

P

ower

Meter

Leveling

Leveling

2a-8

2b

Carrier

Commands

Carrier

This

sub-chapter contains

pertaining

to carrier

Commands

detailed information

control

on

all

programming

commands

2b-2

[SOURce[1]:]FREQuency[:CW

j

:FIXed]

2

SOURce213:3FREQuency2:CW|:FIXed

The

\[SOURce[1]:]FREQuency[:CW

frequency

The parameters

freq

MAXimum

MINimum

UP

DO

WN

DEF

ault

of

the

synthesizer

are as

Sets

Sets

allowable

Sets

allowable

Increases

output

Decreases

output

Sets

value

.

follows:

the synthesizer

the

synthesizer

value

.

the

synthesizer

value

.

the

synthesizer

frequency

the

synthesizer

frequency

the

synthesizer

.

8

>

>

>

>

>

<

3

>

>

>

>

>

:

j

:FIXed]"

command

output frequency

output

output

frequency

frequency

output

increment

value

output

increment

output

value

frequency

freq

MAXimum

MINimum

UP

DOWN

DEFault

sets

.

frequency

.

frequency

.

9

>

>

>

>

>

=

>

>

>

>

>

;

the

output

to

the

maximum

to

the

minimum

by

by

to its

default (preset)

the

the

current

current

The

frequency

carrier

the

frequency of

frequency parameter

The allowable range for the

HP 83711A/11B or 0.01 GHz to

parameter entry is made that is outside

entered

any modulation

is

the

CW

is 3

frequency

type that

GHz.

if no

modulation is

is

chosen.

The

chosen, or

preset

frequency parameter is 1.0 GHz to 20 GHz for the

20 GHz for the HP 83712A/12B

the allowable range

. If a frequency

, an error message

value

will be generated and the actual frequency will be set to either its upper

or lower limit. Frequency resolution is 1 kHz. If Option 1E8 is installed,

frequency resolution is 1 Hz.

the

for

2b-3

Carrier

Commands

[SOURce[1]:]FREQuency[:CW

Query Syntax

j

:FIXed]

2

SOURce213:3FREQuency2:CW|:FIXed3?

Returned format:

freq

<

NL

>

Where:



freq

::=

The



freq

::=

argument is



freq

::= The

argument is



freq

::=

current

The

maximum output

specied.

minimum

specied.

The

default

output

output

(preset)

frequency

frequency that

frequency

output

specied.

See

Also

[SOURce[1]:]FREQuency[:CW

[SOURce[1]:]FREQuency:MUL

j

:FIXed]:STEP

Tiplier

UNIT:FREQuency

if

no

argument

that

frequency

2

MAXimum

4

MINimum

DEFault

can be

can

be

if

the

is

set

set

DEF

3

5

specied.

if

the

MAXimum

if

the

MINimum

ault

argument

is

2b-4

[SOURce[1]:]FREQuency[:CW

j

:FIXed]:STEP

2

SOURce213:3FREQuency2:CW|:FIXed3:STEP2:INCRement

8

incr

>

<

MAXimum

MINimum

>

:

9

>

=

>

;

DEFault

The \[SOURce[1]:]FREQuency[:CW

increment

The

incr

value

parameters

for

the

are

as

follows:

Sets

the increment

synthesizer

allowable range

is

1

kHz to

MAXimum

MINimum

DEF

ault

allowable

Sets

allowable

Sets

allowable

Sets

the

the

the

range

output

value

output

value

output

(preset) value

When

the

\UP"

or

\DO

WN"

\[SOURce[1]:]FREQuency[:CW

frequency

will

be

increased

or

\[SOURce[1]:]FREQuency[:CW

j

:FIXed]:STEP"

output

value for

(without option

19.99 GHz.

for the

If

option

parameter is

frequency increment

.

frequency

.

frequency

.

parameters

j

:FIXed]"

decreased

j

:FIXed]:STEP"

are

command,

by

command

frequency

output

1E8) for

1E8

increment

increment

used

with

the

the

step

command.

.

frequency

is

1

size

selects

the parameter

installed,

Hz

to

19.99

value

to

value

to

value

to

the

output

set

with

3

.

The

the

its

maximum

its

minimum

its

default

the

the

GHz.

If

an

the

output

allowable

frequency

parameter

increment

range

,

value entry

an

error

is made

message

will

that is

be

generated

not within

and

the

incremental value will be set to either its maximum or minimum limit. The

preset value for the output frequency increment value is 100 MHz.

2b-5

Carrier

Commands

[SOURce[1]:]FREQuency[:CW

j

:FIXed]:STEP

Query Syntax

2

SOURce213:3FREQuency2:CW|:FIXed3:STEP2:INCRement3?

2

3

MAXimum

4

MINimum

5

DEFault

Returned

incr

format:

<

NL

>

Where:



incr

::=

The

current

output

specied.



incr

::=

The

maximum

the



incr

the



incr

DEF

See

MAXimum

::=

MINimum

::=

ault

Also

argument

The

minimum

argument

The

default

argument

(preset)

is

specied.

[SOURce[1]:]FREQuency[:CW

UNIT:FREQuency

output

is

specied.

output

is

specied.

frequency

frequency

frequency

output

j

:FIXed]

frequency

increment

increment

increment

increment

value

value

value

if

no

that

value

argument

that

can

can

if

be set

be set

the

is

if

if

2b-6

[SOURce[1]:]FREQuency:MUL

Tiplier

2

SOURce213:3FREQuency:MULTiplier

The

\[SOURce[1]:]FREQuency:MUL

so

that

the

synthesizer

external

The

mult

frequency

parameters are

Sets

parameter

MAXimum

MINimum

UP

Sets

Sets

Increases

increment

DO

WN Decreases

value

DEF

ault

Sets

display

multiplier

as follows:

the

multiplier value

the

multiplier value

the

multiplier

the

the

increment

the

multiplier

will

.

is

1

to 100.

multiplier

value

multiplier

Tiplier"

indicate

value

.

value

value

. The

to its

to

value

value

.

to

8

mult

>

>

>

MAXimum

>

>

<

MINimum

UP

>

>

>

>

DOWN

>

:

DEFault

command

the

sets

frequency

allowable

maximum allowable

its

minimum

by

the

current

by

the

current

its

default

(preset)

9

>

>

>

>

>

=

>

>

>

>

>

;

the

multiplier

at

the

range

allowable

multiplier

output

for

the

value

value

multiplier

value

.

value

of

an

.

.

value

If

a

frequency

message

maximum

Entering

will be generated with external multiplier equipment.

multiplier

will

be

or

minimum

a

frequency

generated

limit.

multiplier

value

and

is

the

The

value

entered

parameter

preset

is

that

value

useful

is

out

of

will

be set

for

the multiplier

when

range

,

an

error

to either

its

value is

an

output

frequency

Setting the multiplier

value scales the display so that the frequency shown on the display will be

the frequency at the output of the external frequency

synthesizer

RF OUTPUT

connector.

When the multiplier function is being used and you enter a

parameter value with the \[SOURce[1]:]FREQuency[:CW

multiplier, not at the

frequency

j

:FIXed]" command,

1.

2b-7

Carrier

Commands

[SOURce[1]:]FREQuency:MULTiplier

be

aware

frequency

for

entered

actual

2,000,000,500

because

output

would

Option

and

frequency

frequency

show

that

the

before

1E8).

you

Hz.

the

standard

4,000,002,000

entered

frequency

multiplication)

As

an

example

attempt

that

the

The

synthesizer

to

synthesizer

specied

would

be

has

,

assume

enter

resolution

rounded

Hz.

divided

a

minimum

a

frequency

would

,

however

to

2,000,001,000

by

a

multiplier

of

need

,

can

is

1

kHz.

the

multiplier

resolution

value

of

of

4,000,001,000

to

generate

not

output

In

this

case

Hz

and

value

1

kHz

2

has

Hz.

would

this

,

the

the

(the

(1

been

The

be

signal

actual

display

Hz

Query

Syntax

2

SOURce213:3FREQuency:MULTiplier?

Returned

mult

<

NL

format:

>

Where:



mult

::=

The



mult

::=

argument



mult

::= The

argument is



mult

::= The

current

The

maximum

is

specied.

minimum multiplier

specied.

default (preset)

multiplier

multiplier

multiplier value

specied.

value

value

value

2

MAXimum

4

MINimum

DEFault

if

no argument

that

can be

that

can

if

be

the

set

DEF

3

5

is specied.

set if

the

if

the

ault

argument

MAXimum

MINimum

is

2b-8

See Also

Carrier

Commands

[SOURce[1]:]FREQuency:MULTiplier

[SOURce[1]:]FREQuency[:CW

j

:FIXed]

[SOURce[1]:]FREQuency:MULTiplier:STEP

To

Generate Millimeter

Signals

2b-9

[SOURce[1]:]FREQuency:MUL

Tiplier:STEP

2

SOURce213:3FREQuency:MULTiplier:STEP2:INCRement

8

incr

>

<

MAXimum

MINimum

>

:

9

>

=

>

;

DEFault

The

\[SOURce[1]:]FREQuency:MUL

increment

The

incr

MAXimum

MINimum

DEF

When

value

parameters

ault

the \UP"

for

the

are

as

Sets

the

the

parameter

Sets

the

allowable

Sets

the

allowable

Sets

the

value

.

or

\DO

external

follows:

multiplier

multiplier

value

multiplier

value

multiplier

WN"

parameters

\[SOURce[1]:]FREQuency:MUL

value

will be

increased or

decreased

\[SOURce[1]:]FREQuency:MUL

Tiplier:STEP"

frequency

increment

is

1

to

99.

increment

command

multiplier

value

value

.

.

increment

value to

.

increment

are

Tiplier" command,

by

a

step

value to

used

size

with

the

set

Tiplier:STEP" command.

selects

value

.

The

allowable

to

its

maximum

its

minimum

its

default

the

multiplier

with

the

3

the

range for

(preset)

If

a

multiplier

parameter

either

its

increment

2b-10

increment

range

,

maximum

value

is

an

1.

error

or

minimum

value

message

entry

limit.

is

will

made

be

generated

The

preset

that

is

not

value

and

within

it

will

for

the

its

allowable

be

set

to

multiplier

[SOURce[1]:]FREQuency:MULTiplier:STEP

Query Syntax

2

SOURce213:3FREQuency:MULTiplier:STEP2:INCRement3?

2

3

MAXimum

4

MINimum

5

DEFault

Carrier

Commands

Returned

incr

format:

<

NL

>

Where:



incr

::=

The



incr

MAXimum



incr

MINimum



incr

argument

See

Also

::=

::=

::=

current

The

maximum

argument

The

minimum

argument

The

default

is

specied.

multiplier

is

is

specied.

(preset)

[SOURce[1]:]FREQuency:MUL

multiplier

specied.

multiplier

multiplier

Tiplier

increment

increment

increment

increment

value

value

value

if

no

that

value

argument

that

can

can be

be

if

the

is

set if

set if

DEF

specied.

the

the

ault

2b-11

Carrier

Commands

[SOURce[1]:]FREQuency:MULTiplier:STEP

2c

Instrument

Commands

Information

Instrument

This

sub-chapter contains

pertaining

to instrument-specic

Information Commands

detailed information

information.

on

all

programming

commands

2c-2

*IDN?

*IDN?

The

\*IDN?"

number

When

,

the

following

(Identication

query

serial

\*IDN?"

returns

number

query

a

,

and

is received

string:

string

rmware

Query)

that

contains

revision

by the

instrument, it

the instrument

number.

model

returns the

HEWLETT-PACKARD,8371XX,ser

Where

HP

rmware

Note

HP

8371XX

is the

83711B/12B), \ser

revision number

that

\*IDN?"

should

instrument model

no"

is

.

always

the

instrument

be

no,REVXX.Y

number (either

serial

the

last

query

number

in

a

command

HP

83711A/12A

,

and

\XX.Y"

line

or

is

the

.

2c-3

*OPT?

*OPT?

The

\*OPT?"

In

response

following

(Option

query

to

the

form:

Identication

returns

a

list

\*OPT?" query

of

the

synthesizer option

,the

synthesizer will

Query)

return a

numbers.

string

in

the

option#1,option#2,option#3,

The

possible

the

following

the

following table

Synthesizer

table

.If

the synthesizer

,

\0"

options

will

be

returned.

Synthesizer

Option

Number

1E1 Add

1E5 Add

1E8 Add

1E9 3.5

step

high

1

mm

attenuator

stability

Hz

Frequenc

RF

Output

.

.

.

.

.option#n,

returned

contains none

Description

.

timebase

y Resolution.

connector

with

Options

.

.

this

command

of

the

options

are

shown

stated

in

in

2c-4

OUTPut:IMP

edance?

2

OUTPut:IMPedance?

The

\OUTPut:IMP

synthesizer

N

O

T

The

synthesizer

be

returned

When

imp

<

RF

E

in

the

\OUTPut:IMP

NL

>

OUTPUT

output

response

edance?"

impedance

to

4

connector

is

this

query

edance?"

query

Where:



imp

::=

The

version

of

the

current

synthesizer

output

,

returned.



imp

::=

The

the

MAXimum

maximum

argument

output impedance

is

\+5.0000000000000E+001"



imp

::=

the

The minimum

MINimum

argument

output impedance

is

\+5.0000000000000E+001" will



imp

::=

The default (preset) output impedance if the DEF

specied. In this

version of the synthesizer

will always be returned.

MAXimum

3

MINimum

5

DEFault

returns

the

output

impedance

.

not

selectable

.

This

impedance

query is

query

, therefore

provided for

is

sent,

if

, \+5.0000000000000E+001"

SCPI

compatibility

the

following

no

argument

\+5.0000000000000E+001"

that can

specied.

will

specied.

In this

always

In

be

that can

this

version of

returned.

be obtained

version

always be returned.

, \+5.0000000000000E+001"

.

is

is

specied. In

will

always

be obtained

the synthesizer

of

the

synthesizer

ault argument is

of

the

will alwa

returned:

be

when

when

ys

this

,

,

2c-5

[SOURce[1]:]ROSCillator:SOURce?

2

SOURce213:3ROSCillator:SOURce?

The

\[SOURce[1]:]ROSCillator:SOURce?"

synthesizer

When

timebase

the

\[SOURce[1]:]ROSCillator:SOURce?"

reference

.

query

returns

query

is sent,

returned:

Sour

<

NL

>

Where:



Sour

::=

\INT"

if

the



in

use

Sour

.

::=

\EXT"

if

an

synthesizer

external

internal

timebase

timebase

reference

is

the

source

reference

currently

of

the

the following

is

currently

in

use

.

is

N

O

T

E

The

synthesizer

to

the

See

Also

Connectors

2c-6

10

MHz

timebase

IN

BNC

is

automatically

connector

switched

to

external

if

a

signal

greater

than

0

dBm is

applied

.