Agilent Technologies 11896A User Manual

User

,

Programming and

Service Guide

Agilent

11896A

Polarization Controller

Notice

The

information

notice

contained

in

this

document

is

subject

to

change

without

.

Agilent

this

T

echnologies

material,

merchantability

shall

not

be

liable

consequential

of

this

material.

Agilent

Printed

P

in

art

Number:

US

A

makes

including,

and

tness

for

errors

damages

April

2000

no

warranty

but

not

limited

for

a

contained

in

connection

11896-90011

to

particular

herein

with

of

any

,

the

purpose

the

kind

with

implied

.

Agilent

or

for

incidental or

furnishing,

regard

warranties

T

echnologies

performance

to

of

,

or

use

c



Copyright Agilent T

echnologies 2000

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

1400 F

ountaingrove P

arkway, Santa Rosa, CA 95403-1799, US

A

.

Certication

Agilent

at

certies

National

the

International

Technologies

the time

of

shipment

that its

Institute of

Institute's calibration

Standards

certies

from

that

the

this

factory

product

.

calibration measurements

Standards and

facility,

Organization

T

echnology

and

to

members

Agilent

are

the

calibration

met

its

T

echnologies

traceable

,

to

the

.

published

to

the

extent

allowed

facilities

specications

further

United

States

by

of

other

iii

W

arranty

This

Agilent T

material

During

repair

F

or warranty

facility

charges

another

and workmanship

the warranty

or replace

designated

to

, duties

country

echnologies

products which

service or

Agilent

return

,

the

and

.

instrument

for

period, Agilent

repair

by

Agilent

T

echnologies

product

taxes

for

product

a

period

T

echnologies

prove

,

this

product

T

echnologies

and

Agilent

to

Buyer

.

products

of

one

to

be

defective

must

.

Buyer

T

echnologies

However

returned

is

warranted

year

from

will,

be

shall

,

Buyer

to

Agilent

against

date

at

its

.

returned

prepay

shall

T

defects

of

shipment.

option,

to

a

service

either

shipping

pay

shipping

pay

all

shipping

echnologies

in

from

Agilent T

instructions when

does not

rmware

Limit

The

or

interfacing,

environmental

or

NO

TECHNOLOGIES

OF

Ex

THE

REMEDIES

ANY

echnologies warrants

echnologies for

warrant that

will

be uninterrupted

a

tion

of

W

foregoing

inadequate

unauthorized

maintenance

OTHER

W

ARRANTY

MERCHANT

clusive

Remedies

REMEDIES

.

A

GILENT TECHNOLOGIES

DIRECT, INDIRECT

properly installed

arranty

warranty

maintenance

specications

.

SPECIFICALL

ABILITY

PRO

DAMAGES, WHETHER B

LEGAL THEORY

.

use

that its

with

software

an

instrument

on

the

operation

shall

by

or

not

Buyer

of

error-free

apply

modication

for

the

IS

EXPRESSED

Y

DISCLAIMS

AND

FITNESS

VIDED HEREIN

, SPECIAL, INCIDENT

ASED ON CONTRA

and

will

that

instrument.

the

instrument,

.

to

defects

,

Buyer-supplied

or

misuse

,

product,

OR

or

improper

IMPLIED

THE

FOR

A

P

ARTICULAR

ARE BUYER'S

SHALL

NOT

AL, OR CONSEQUENTIAL

CT

, TORT

rmware

execute

designated

its

programming

Agilent

or

software

resulting

from

software

operation

.

IMPLIED

A

GILENT

outside

site

preparation

W

ARRANTIES

PURPOSE.

SOLE AND

BE

LIABLE

, OR ANY OTHER

by

T

echnologies

,

or

improper

or

of

the

EXCLUSIVE

FOR

iv

Assistance

Product

are

available for

F

or any

maintenance agreements

A

gilent

T

echnologies

assistance,

contact

your

and

products.

nearest

other

A

customer

gilent

assistance

T

echnologies

agreements

Service

Oce

.

v

C

W

AU

A

Safety

The

following safety

yourself

Symbols

with each

symbols

of

the

are

symbols

used

and

throughout

its

meaning

this

before

manual.

operating

F

amiliarize

this

instrument.

The

TI

O

N

caution

procedure

damage

sign

until

The

R

N

I

N

G

warning

procedure

in

injury

indicated

sign

which, if

to

or

destruction

the

indicated

sign

which, if

or

loss

conditions

denotes a

not correctly

conditions

denotes

not

of

life

.

are

hazard

performed

of

the

instrument.

a

life-threatening

correctly

Do

not

proceed

fully

understood

to

the

instrument.

are

fully

performed

beyond

or

adhered

Do

not

proceed

understood

hazard.

or

adhered

a

warning

and

met.

It

calls

to

and

It

,

could

met.

calls

to

attention

beyond

,

could

sign

to

result

in

a

caution

attention to

result

until the

a

Instruction

Manual

L

vi

The

instruction

for

the

user

to

manual

refer

to

symbol.

the

The

instructions

product is

in

the

marked

manual.

with

this

symbol

when

it

is

necessary

General

Safety Considerations

W

A

R

N

I

N

G

Before

grounded

socket

Any

outside

can

W

AR

N

I

N

G

This

ground

inserted

Any

instrument is

interruption is

W

A

R

N

I

N

G

There

personal

Any

instrument

trained

W

A

R

N

I

N

G

If

equipment

condition

this

through

outlet

interruption

the

result

is

a

Safety

in

incorporated in

in

interruption

are

many

injury

adjustments

service

this

instrument

(in

instrument

the

provided

of

the

instrument,

personal

Class

a

socket

of

outlet

the

likely to

prohibited.

points

.

Be

extremely

or

service

with

protective

personnel.

is not

could

be

impaired. This

which

all

is

switched

protective

with

protective

or

disconnection

injury

.

I

product

the

power

provided

protective

make the

in

the

procedures

covers

used as

means

on

,

conductor

(grounding)

(provided

cord).

with a

conductor

instrument

careful.

removed

specied,

instrument must

for

protection

make

sure

of

the

earth

contact.

conductor

of

the

protective

with

a

protective

The

mains

protective earth

inside or

dangerous

which

that

can,

require

should

the

protection

are

intact)

it

has

ac

power

plug

outside of

.

Intentional

if

contacted,

operation

be

performed

be

used

only

been

properly

cable

,

inside

earth

earthing

shall

only

contact.

of

provided

in

.

to

a

or

terminal

be

the

cause

the

only

by

a

normal

by

the

N

O

Clean

T

E

the

cabinet

using

a

damp cloth

only.

vii

How

This

manual provides

controller

.

to Use

This Manual

information

about

the

Agilent

11896A

polarization

Chapter

Chapter 5

Appendix

1

provides

general information

and

specications

for

the

controller

2

3

describes

use

and

shows

how

to

make

to

manually

prepare

ber

the

optic

control

polarization

connections

the

lightwave

controller

polarization

for

controller

4

A

B

C

shows

using a

how

to

computer

control

provides procedures

Agilent 11896A

selecting scan

measurement

provides

a

polarization controller

rate

considerations

sample

the lightwave

for

verifying

and

measurement

GPIB

program

polarization controller

and

servicing

the

time

viii

Programming

What

you'll

nd

in

this

section

This

section

programming

Programmable

Y

ou

can

perform



Set

up

the



Make

measurements.



Get

data



Send

information

Other

tasks

introduces

instructions

(measurements,

are

the

basics

in

Instrumentation.

the

following

instrument.

(congurations)

accomplished

this

for

remote

manual

The

programming

basic

operations

conguration)

to

the

b

y combining

programming

conform

from

polarization

these basic

to

the

instructions

with

a

the

polarization

of

IEEE

488.2

computer

controller

functions.

a

polarization

Standard

provide

and

controller

.

the

means

a

polarization

.

controller

Digital

of

.The

Interface for

remote

controller:

control.

4-2

Using the

Programming

Agilent 11896A

Changing the

The polarization

N

O

T

E

The

programming

HP

9000

Series

controller's default

examples

200/300

GPIB address

(factory

for

individual

Controller

commands

.

set)

primary

in

this

manual

are

written

address

in

HP

is

BASIC

20.

5.0

for

an

4-3

T

alking

to

the Instrument

Computers

and

receiving messages

normally

statements

polarization

F

or

example

sending

read

Messages

the device

appear as

commands

in using

are

address,

acting as

of a

of the

controller

,

HP

the

placed

address ensures

instrument.

The following

position

OUTPUT

The

<

to

50.

<

device

programmed.

the

following

pages

controllers

over

ASCII character

\host" language

host language

.

9000

Series

and

queries

ENTER

on

the

statement.

program message

that the

HP B

ASIC

program

statement

address

Each

of

>

the

represents

other

.

communicate

a

remote

200/300

.

bus

>

;":PADD1:POSITION

interface

strings

available

are

used

B

After

a

using an

,

and

message

sends

the

parts

of

embedded

on

to

read

ASIC

uses

query

output command

terminator

is

a

command

address

the

above

with

the

.

Instructions

your

controller

in

the

is

sent,

sent

to

of

the

statement

instrument

inside

responses

OUTPUT

the

response

.

by

for

programming

the

output

The

input

from

the

statement

is

and passing

.

P

assing

the

which

correct

sets

the

device

interface

the

50"<terminator>

device

being

are

explained

sending

for

usually

paddle

and

1

in

4-4

Program

T

o program

command

syntax

program

instructions

are

formatted.

the

format and

rules govern

data, and

. Syntax

Message

instrument

structure

how individual

terminators may

denitions are

Syntax

remotely

expected

,

you

must

by

elements

be

grouped

also

given

have

the

instrument.

such

together

to

show

an

understanding

as

headers

to

how

The

,

separators

form

complete

query

of

IEEE

488.2

responses

the

,

Output

The

output

Throughout

examples

need

and

CLEAR

manual

Device

The

location

on

the

be specied

specied

command

to

command

of

nd

are

this

individual

the

in

order

always

is

entirely

manual

commands

equivalents

to

convert

shown

address

where the

device address

programming language

outside the

after

the

output command.

keyword

HP 9000

the polarization controller is

the address varies according

dependent

of HP

the examples

between

you are

OUTPUT.

Series 200/300

.

If you

B

ASIC

quotes

are

commands

in

must be

using. In

In

The

examples

on

the

programming

B

ASIC

using

other

like

.

The

instructions

the example

specied is

some languages

HP

B

ASIC,

in

5.0

is

languages

OUTPUT

programs

also

this

manual

language

used

,

listed

dependent

,

this

is

always

in

,

you

ENTER,

.

assume

at device address 720. When writing programs

to how the bus is congured.

the

in

may

.

will

this

,

4-5

Programming

Program Message

Syntax

Instructions

Instructions (both

embedded in

a statement

Instructions are



The

header

,

which



The

the

program

meaning

data,

of

Instruction

The

instruction

represent

Queries are

Many

whether

query

queries

the

operation

indicated

instructions can

or not

forms of

do not

you

an instruction

use any

commands and

of your

composed of

species

which

the

instruction.

header

is

one

to

by

adding

be

used

have

included

program

two main

the

provide

or

be

performed

a

as

usually

data.

queries)

host

normally

language

parts:

command

or

additional

more

mnemonics separated

by

the instrument.

question

either

the

mark

commands

question

have

dierent

appear

,

such

as

B

query

to

be

information

(?)

to

the

or

queries

mark.

The

program

as

a

string

ASIC,

P

sent.

needed

by

colons

end

of

,

depending

command

data.

ascal,

to

the

Many

or

clarify

(:)

header

on

and

C.

that

.

White space

White space is used to separate the

(separator)

instruction header from the program data.

If the instruction does not require any program

need to include any white space

one or more spaces

. ASCII denes a space to be character 32 (in decimal).

. In this manual, white space is dened as

4-6

data parameters

, you do not

Program data

Programming

Program Message

Syntax

Simple

command

header

Program data

are used

provide necessary

o. Each

the values

chapter has

When there

commas

Header

There



Simple



Compound



Common Command

Simple

are

The

<program

instruction's syntax

they

all

of

is

more

(,).

Spaces

types

are

three

Command

command

examples

syntax

of

is:

mnemonic><terminator>

to

clarify

information, such

accept.

types

the

than

can

headers

The

general

one

be

added

of

headers:

section

.

headers

headers contain

simple

command

the

meaning

as whether

denition shows

\Program

rules

about

acceptable

data

parameter

around

the

.

a single

mnemonic.

headers typically

of

the

a

function

the

Data

,

they

commas

command

program

Syntax

values

are

separated

to

improve

INITIA

used in

or

should

data,

Rules"

.

TE

this

instrument.

query

.

be

on

as

well

in

this

by

readability

and

ABORT

They

or

as

.

4-7

Programming

Program Message

Syntax

Compound

header

Common

command

header

Compound

The

rst mnemonic

the

function within

message

T

o execute

command headers

selects the

that subsystem.

are separated

a single

function within

are a

by colons

combination of

subsystem, and

The mnemonics

.F

or

example:

a

subsystem:

the

:<subsystem>:<function><separator><program

(F

or example

Common

instrument

*<command

No space

header

.

Combining

T

o

execute

semi-colon

:PADD1:POSITION

command

(such

headers

as

clear

status).

header><terminator>

or separator

*CLS

is

an

is

allowed

example

commands

more

than

one

function

(;)

is

used

to

separate

50)

control

between

of

a

common

the

IEEE

Their

within

functions:

488.2

syntax

the

asterisk

command

the

functions

is:

same

two

program

second

within

mnemonics

mnemonic

the

compound

data><terminator>

within

(*)

and

header

subsystem

the

command

.

a

.

selects

:<subsystem>:<function><separator><data>;<function><separ

(F

or

example

:SCAN:RA

TE

5;TIMER:CLEAR)

4-8

ator><data><terminator>

Duplicate mnemonics

Programming

Program Message

Syntax

Identical function

example,

the function

status operation



T

o

set

the

register (the

mnemonics can

register or

lower

four

enable

mnemonic ST

bits

register

use:

:STATus:OPER:ENABle



T

o

set

the

fth

bit

of

15

the

use:

:STATus:QUES:ENABle 16

OPER

and

the

QUES are

operation

or

subsystem selectors

the

questionable

be

the status

of

the

enable

is

a

bit

enable

register

,

the

used

for

A

Tus

may

questionable

register

mask

for

and

command

more

be

used

for

the

status

determine

will

than

one

to

register

the

status

questionable

which

aect.

subsystem.

set

bits

.

status

operation

status

in

either

register),

register

F

or

the

register

,

4-9

Programming

Program Message

Syntax

Query command

Command headers

After receiving

and places

queue until

is transmitted

For

example

the output

ENTER

<

passes the

aquery

the answer

it

is

across

,

the

queue

device address

value across

Rate.

Query commands

congured.

the

instrument.

instrument

was

initiated.

The

output

example

query

ENTER

reads

to

queue

,

when

with

an

statement

the

result

They

report

you

input

of

immediately followed

, the

instrument

in its

output

read

or

another

the

bus

query

:SCAN:RA

.

In

HP

B

the bus

are used

are also

F

or

example

the

amount

must

be

send

statement.

immediately

the

query

used to

the

to

ASIC,

>

;Rate

to nd

,

the

read

query

and

command

the

to

of

before

In

followed

by

a

interrogates

queue

.

The

is

designated

TE?

places

controller

the

controller

out how

get

command

time

the

results

:SCAN:TIMER?

elasped

the

HP

B

ASIC,

by

a

places

the

result

question

the

answer

issued.

When

listener

the

current

input

statement:

and

places

instrument

of

measurements

in

seconds

program

you

this

is

usually

variable

in

name

a

mark

(?)

requested

remains

read,

(typically

scan

it

in

is

currently

instructs

since

message

must

follow

done

.

This

specied

are

function

in

the

a

rate

the

made

scanning

is

with

statement

variable

queries

the

.

output

answer

controller).

setting

in

variable

by

the

sent.

F

or

that

an

.

N

Sending

be

error

4-10

O

T

cleared

queue

E

another

and

.

command

the

current

or

query

response

before

to

be

reading

lost. This

the

result

also generates

of

a

query

causes

the

output

buer

to

a query

interrupted error

in the

Programming

Program Message

Syntax

Program header

Program headers

lowercase ASCII

returned in

Program command

(complete spelling),

long form

and

can be

characters.

uppercase.

and

short

form.

:PADDLE1:POSITION

:PADD1:POS

Programs written

documenting. The

memory

needed

50

{

short

in long

short form

for program

options

sent

using

any

Instrument responses

query

headers

form

(abbreviated

50

{

long

form

form are

easily

syntax conserves

storage and

combination

may

be

sent

spelling),

read

and

reduces

of

uppercase

,

however

in

either

or

any

are

almost

the amount

the

amount

or

,

are

always

long

form

combination

self-

of

controller

of

I/O

activity

of

.

4-11

Programming

Program Message

Syntax

Numeric

program

data

Program data

related to

the command

command header

syntax rules

is used

to

or query

convey

header.

header from

a

variety

At

least

of

one

the

types

of

space

program

parameter

must

data.

Some

command

F

or

example

expressed

F

or

numeric

or

using

numbers

28

=

0.28E2

When

a

syntax

that

the

truncating

values

All

sending

the

three

when

are

numbers

the number

character \9"

bytes (ASCII

you

sux

are all

number

headers

,

:P

ADD:POS

numerically

program

multipliers

equal:

= 280e-1

denition

should

the

number

called

real

are

expected

(which

codes

include

the

require

requires

.

data,

to

= 28000m

species

be

.

Numeric

numbers

to

9,

you

is

49,

entire

program

the

you

have

indicate

=

that a

whole.

data

.

be

strings

would

57).

48,

send

A

and

instruction

data

to

desired

the

0.028K

paddle position

option

numeric

=

28e-3K.

number

Any

fractional

parameters which

of

ASCII

a

byte

representing

three-digit

50).

in

This

a

number

is

string.

be

expressed numerically

of using

is

part

exponential notation

value

.The

an

integer

would

accept

characters

like

taken

care

information

separate

range to

following

,

that

be

fractional

.

Thus

the

ASCII

102

would

of

automatically

the

means

ignored,

,

when

code

take

.

be

for

up

4-12

Programming

Program Message

Syntax

Program message

The program

program message

(New Line)

or a

combination

on the

instructions within

character,

of

last

byte

of

terminator is

an EOI

the

data

(decimal 10).

N

O

T

E

The

NL

(New

Line)

terminator

Selecting

.

multiple

terminator

a

data

received. The

(End-Or-Identify)

two

.

Asserting

message

has

the

same

function

subsystems

.

The

message

the

EOI

NL

as

an

are

executed

terminator

asserted

sets

the

character

EOS (End

Of String)

in

EOI

is

may

the

an

after

be

either

GPIB

control

ASCII

and EO

T (End

the

an

interface

line

low

linefeed

Of

T

NL

,

ext)

Y

ou

can

send

subsystems

The

colon

multiple

on

the

following

same

the

program

line

semicolon

by

example:

:<program mnemonic><data>;:<program

:PADD1:POS 50; :SCAN:RATE 6

commands

separating

enables

and

each

you

program

command

to

enter

queries

with

a

new

for

a

semicolon.

subsystem.

mnemonic><data><terminator>

dierent

For

4-13

Programming

Program Message

N

O

T

E

Multiple

commands

Syntax

Initialization

T

o

make

sure

the

begin

every

program

CLEAR

command

ma

y

bus

which

be

any

and

with

combination of

all

appropriate

an

initialization

clears

the

compound and

interfaces

interface

simple

statement.

buer:

commands.

are

in

HP

a

B

ASIC

known

provides

state

,

a

CLEAR

When

parser

send

After

OUTPUT

720

!

you

are

.

The

parser

it.

clearing

720;"*RST"

state.

N

O

T

E

Refer

to

your

controller

initializing the interface

4-14

initializes

using

GPIB

,

is

the

program

the

interface

!

initializes

manual

and

.

the

CLEAR

,

initialize

programming

interface

also

resets

which

reads

the instrument

the

language

of

the

instrument

the

polarization

in

the

instructions

to a

instrument

reference

manual

preset

to a

for

information on

controller's

which

state:

preset

you

Programming

This

section describes

concepts

with

sent

.In

general,

general interface

over the

interface as

over

the

these

GPIB

interface

functions

are

management issues

interface

commands

functions

dened

,

as

well

.

and

by

as

some

IEEE

488.2.

messages

general

They

which

deal

can

be

Interface

The

interface

IEEE

488.1,

are

Command

The

interface



command



data

The

bus

mode

such

as

The bus

used

to

mode.

is in

is

used to

a group

is in

convey

mode

capabilities

SH1,

and

has

two

of

AH1,

data

modes

T5,

.

the command

send talk

and listen

execute trigger

the

data

mode

device-dependent

the

polarization

L4,

SR1,

concepts

of

operation:

mode when

addresses

(GET).

when

the

messages across

A

RL1,

the

TN

controller

PP1,

A

TN

line

and

line

is

false

the

as

DC1,

is

true

various

.

bus

dened

DT1, C0,

.

The

bus

commands

The

data

.

by

and E2.

command

,

mode is

4-15

Programming

Programming over

Addressing

To

allow the

send the

instrument

command:

''REMOTE 7''

To

place

the

instrument

''REMOTE 720''

N

O

T

E

There is

no wa

y

GPIB

to

place

the

to

go

in

remote

instrument

into

in

remote

mode

remote

,

send

mode

from

when

the

command:

the

front-panel.

sent

a

GPIB

command,



Each

device



The

active



An

instrument

the

controller

If

the

controller

congured

on

controller

to

talk until

instrument's talk

untalk

If

congured

talk address

command

the

controller addresses

to

listen until

(MT

4-16

the

GPIB

may

be

.

addresses

it receives

address (OT

(UNT).

A),

or

a

resides

species

talk

addressed,

the

instrument

which

A), its

the instrument

it receives

universal

at

a

particular

devices

listen

to

an

interface

own listen

to listen,

an interface

unlisten

address

talk

addressed,

talk,

the

clear

address

clear message

command

,

and

which listen.

or

instrument

message

(MLA),

the

instrument

(UNL).

0{30.

unaddressed by

remains

(IFC),

another

or

a

universal

remains

(IFC),

its

own

Programming

Programming over

GPIB

Interface select

(selects

interface)

Instrument

(selects

address

instrument)

code

Communicating over

(HP

9000 series

Since

GPIB can

device

correct

address passed

interface select

Each interface

by the

interface

Each

decimal

include

select

DEVICE

controller

.

The

instrument on

0and

not only

code

.

ADDRESS

address

card has

default

30. The

200/300 controller)

multiple

with

the

code

,

a unique

to

direct

commands

is typically

aGPIB

must

device

the

correct

=

(Interface

Address)

F

or

example

and

the

routine

F

or

the

at

the

,

if

interface

performs

polarization

factory

.

This

the

instrument

select

its

function

controller

address

code

the bus

devices

program

but

also

interface select

\7"

have

address

instrument

Select

address

is

7,

when

on

the

instrument

,

the

instrument

can

be

changed

through

message

the

correct

and

communications

for

GPIB

controllers

a

unique

passed

address

Code

for

the

with

,

*

polarization

program

address

in

the

same

must

include

instrument

code

.

This

instrument

the

program

but

also

100)

+

(Instrument

message

at

device

is

typically

GPIB

menu.

interface

not

address

code

to

the

.

address

the

correct

controller

is

address

card,

only

.

is

used

proper

between

message

interface

is

passed,

704.

set

to \20"

the

must

4

the

N

O

T

E

The examples

in this

manual assume

the polarization

controller

is

at

device

address

720.

4-17

Programming

Programming over

Lockout

To

disable front-panel

LOCKOUT

command.

GPIB

control

while

a

program

is

running,

send

the

LOCAL

Device clear

The instrument

command to

N

O

T

Cycling

Bus

commands

The

following

IEEE

488.2

commands

The device

input and

the

E

the

power

denes

are

clear

output buers

can be

instrument.

also

restores

commands

many

received

(DCL)

returned to

front-panel

are

IEEE

of

the

actions

by

the

instrument.

or

selected

, reset

the

local

control.

488.2

device

parser

mode

bus

which

clear

,

and

by

sending

commands

are

taken

(SDC)

clear

any

the

LOCAL

(A

TN

true).

when

commands

pending

these

clear

commands

the

.

Interface

clear

The

interface

unaddressing all listeners and the talker

clear

(IFC) command

halts

all

bus

, disabling serial poll on all devices

and returning control to the system controller

4-18

activity

.

This

includes

,

Common commands

Programming

Common Commands

*CLS (Clear

Status)

The

*CLS (clear

including the

status)

device-dened error

Request-for-OPC ag.

If the

*CLS command

output queue

Command

Syntax:

and the

*CLS

Example: OUTPUT

common

command

queue.

immediately follows

MA

V

(message

available)

720;\*CLS"

clears

the

status

This command

a program

bit

message

are

cleared.

data

also

structures

clears

the

terminator

,

the

4-19

*ESE

(Event

Status Enable)

Programming

Common Commands

The

*ESE command

Register

for

Standard

information

and

The

.The

the bits

to be

Event Status

what each

*ESE query

Standard Event

about the

sets the

enabled in

Enable Register

Register.

Standard Event

bit masks

returns the

bits in

Status Enable

the

.

current

the

Standard

enables the

Azero

Status

contents

Standard

Register

Event

disables

Enable

of

Event

Status

contains

Status

Register

corresponding

the

bit.

Refer

Register

the

register

.

Enable

a

mask

.

A

to

T

bits

,

one

bit

able

bit

value

in

the

in

the

4-1

weights

for

,

Command Syntax:

Where:

1

Example:

Query

Syntax:

Returned

F

Where:

Example: OUTPUT

1

In

this

example

Therefore

, when

ormat:

,

the

a

*ESE

front

*ESE

<

mask

OUTPUT

*ESE?

<

mask

<

mask

ENTER

PRINT

64

command

panel

T

able

Enables

<

mask

>

::=

720;\*ESE

><

>

::=

720;\*ESE?"

720;Event

Event

ke

y

is

4-1.

>

0

to

NL

>

0

to

enables

pressed,

the

Standard

(High{Enables

255

64"

255

(integer{NR1

URQ

ESB

Event

(user

(event

Event

request)

summary

Status

the ERS

format)

bit 6

bit)

Enable Register

bit)

Bit Weight Enables

7 128 PON

6 64 URQ

5 32 CME

-

Power

-User

Request

- Command

On

Error

4 16 EXE - Execution Error

3 8 DDE - Device Dependent Error

2 4 QYE - Query Error

1 2 TRG - T

rigger Query

0 1 OPC - Operation Complete

of

the

in

the

Enable

Standard

Status

Register

Event

Byte

Status

Register

Enable

is

also

Register

set.

.

4-20

*ESR

(Event

Status Register)

The

*ESR query

When

bit

weights of

T

able 4-2

you read

shows each

returns the

the Event

all of

the bits

contents of

Status Register

that

bit in

the

are

Event

high

Status

the

,

the

at

Standard

value

the

time

Register

Event

returned

you

read

and

its

Programming

Common Commands

Status

is

the

bit

Register

the

total

byte

weight.

.

Reading

Query Syntax:

the register

*ESR?

Returned

Where:

Example:

F

ormat:

<

status

<

status

OUTPUT

ENTER

PRINT

Bit

Weight

7 128 PON 0

6 64 URQ 0

5 32 CME 0

4 16 EXE 0

3 8 DDE 0

2 4 QYE 0

1 2 TRG 0

clears the

><

>

::=

Event

NL

>

0

to

255

720;\*ESR?"

720;Event

Event

T

able

4-2.

Standard

Bit

Name Condition

=

no

1

=

power-on

=

no

1

=

a

front-panel

=

no

1

=

a

command

=no

1

=

an

=

no

1

=

a

device

=

no

1

=

a

query

=no

1

=

trigger

0 1 OPC 0 = operation is not complete

1 = operation is

0=F

alse = L

ow 1=T

Status

(integer{NR1

Event

power-on

detected

front-panel

ke

command

errors

error

execution error

execution

device

error

dependent

query

errors

error

has

trigger or

(can

AUT

be

1

complete

Register

format)

Status

y

has

y

has

been

has

errors

error

been

O

(autolevel)

only

rue = High

Register

been

pressed

been

detected

been

detected

has

been

detected

in

Normal, Single

.

detected

,

TV

trigger

modes)

4-21

*IDN

(Identication

Number)

Programming

Common Commands

The

*IDN query

returning

\

HEWLETT-PACKARD 11896A

identies the

the following

string:

Where:

instrument type

0 <X.X>

"

and

software

version

by

*OPC

(Operation

Complete)

<X.X>

An

*IDN

::= the

*IDN query

query in

Query

Syntax:

Returned

F

Example:

The

*OPC

the

Standard

nished.

The

*OPC

device

operations

Command Syntax:

Example:

software revision

must be

the

aprogram

*IDN?

ormat:

HEWLETT-P

DIM

Id$[50]

OUTPUT 720;\*IDN?"

ENTER

720;Id$

PRINT

Id$

(operation

Event

query

Status

places

have

complete)

an

nished.

*OPC

OUTPUT

720;\*OPC"

last

message

ACKARD

,11896A,0,X.X

Register

ASCII

of

query

in

are

ignored.

<

command

when

\1"

in

the

instrument.

a

message

NL

>

sets

the

all

pending

the

output

.

Any

queries

operation

device

queue

when

after

complete

operations

all

pending

the

bit

have

in

Query

4-22

Syntax:

Returned F

Example:

ormat:

*OPC?

1

<

NL

>

OUTPUT

720;\:P

ENTER 720;Op$

ADD1:POS

100;*OPC?"

*RCL

(Recall)

The

*RCL command

save/recall

the

specied register

register.

restores the

An instrument

. *RCL

0has

state of

setup must

the

same

the instrument

have

been

eect

as

*RST

Programming

Common Commands

from

the

specied

stored

previously

.

in

*RST

*SA

V

(Reset)

(Save)

Command Syntax:

Example:

The

*RST

is

placed

rate

Command

in

and

instrument

Syntax:

Example:

The

*S

A

V

command

The

data

parameter

saved.

Command

Registers

Syntax:

Example:

*RCL

OUTPUT

command

manual

*RST

OUTPUT

1

*SA

OUTPUT

f

0

j

1

j

720;\*RCL

places

mode

and

status

720;\*RST"

stores

is the

the current

number

through 9

V

f

1

j

2

j

3

720;\*SA

2

j

3

j

4

3"

the

instrument

all

paddles

registers

are

valid

j

4

j

5

j

6

j

V

3"

j

7

of

j

5

are

8

j

6

j

7

not

state of

the

for

j

9

g

j

8

j

in

are

aected.

save

this

9

g

a

known

set

to

position

the

device

register

command.

state

in

where

.

500.

a

The

save

the

instrument

The

scan

register

data

will

.

be

4-23

*SRE

(Service

Request Enable)

Programming

Common Commands

The

*SRE command

Service

enabled

Register

disables

and

The

Request Enable

in the

enables the

the bit.

what they

*SRE query

sets the

Register contains

Status Byte

corresponding bit

Table

4-3 lists

mask.

returns the

bits in

Register.

the

current

the

A

bits

value

Service

a mask

one

in

in the

in

the

.

Request

value

the

Service

Status

Service

Enable

for

Byte

Request

the

bits

Request

Register

Enable

Register

to

be

Enable

.

A

zero

Register

.

The

Command Syntax:

Where:

Example:

Query

Syntax:

Returned

Format:

Where:

Example: OUTPUT

*SRE

<

mask

OUTPUT

*SRE?

<

mask

<

mask

ENTER

PRINT

<

mask

>

::=

720;\*SRE

><

>

::=

720;\*SRE?"

720;V

V

alue

T

able

>

0

to 255

NL

>

sum

alue

4-3.

Service

(High

32"

of

all

Service

Request

-

Enables

bits

Request

that

Enable

the

are

SRE

set, 0

Enable

Register

Bit Weight Enables

7 128 Not

6 64 RQS

5 32 ESB -

4 16 MA

3 8 not

2 4 not

Used

-

Request

Event Status

V

-

Message

used

Service

A

vailable

1 2 instrument is scanning

0 1 paddles moving in manual mode

through 255

bit)

Bit

Register

(integer{NR1

format)

4-24

*STB

(Status

Byte)

The *STB

The

MSS (Master

(request

least

one reason

the

bits in

T

o read

interface

Query

Syntax:

Returned

Where:

Example:

query returns

Summary Status)

service) bit.

The MSS

for requesting

the status

byte.

the instrument's

Serial P

oll.

*STB?

Format:

<

value

><

<

value

>

OUTPUT

ENTER

720;V

PRINT

Value

the current

status

NL

>

::=

0

through

720;\*STB?"

alue

T

able

value of

bit is

the

reported

indicates whether

service.

byte

4-4. Status

with

255

(integer{NR1)

Refer

to

RQS

Byte Register

instrument's

on

bit

or

not

T

able

4-4

reported

Common Commands

status

6

instead

the

for

on

bit

device

the

6,

of

meaning

use

Programming

byte

.

the

RQS

has

at

the

of

Bit Bit/Weight Bit/Name Condition

7 128 | 0

6 64 RQS/MSS 0

5 32 ESB 0

4 16 MA

V

3 8 | 0

2 4 | 0

1 2 | 0

=

not

=

instrument

1

=

instrument

=

no

1

=

an

0

=

no

1=

an output

= not

=

not used

= instrument

1

=

instrument

used.

event

enabled

output

used

has

no

is

requesting

status

conditions

event

messages

message is

is in

manual mode

is

scanning

reason

status

are ready

for

service

have

condition has

ready

service

0 1 | 0 = paddles not moving in manual mode

1 = paddles moving in manual mode

0 = false = low

1 = true = high

occurred

4-25

*TST

Programming

Common Commands

(T

est)

The *TST

is

placed in

A

zero indicates

If

a test

fails,

service

Query

manual.

Syntax:

Returned

Where:

Example:

query performs

the output

queue.

the test

refer to

the

*TST?

Format:

<

result

<

result

0

indicates

non-zero

><

>

indicates

OUTPUT 720;\*TST?"

a self-test

passed and

on the

a

troubleshooting

NL

>

::=

0

or

non-zero value

the

test

passed

the

test

failed

instrument.

non-zero

section

value

of

The

indicates

the

polarization

result

the

of

the

test

failed.

controller

ENTER 720;Result

PRINT

Result

*W

AI

(W

ait)

The

*W

is

completed

Command

Example:

AI

command

Syntax:

before

*W

OUTPUT

causes

executing

AI

720;\*W

the

instrument

the

AI"

to

next remote

wait

until the

command.

current

command

4-26

Instrument Specic

Programming

Commands

:ABORt

:INITiate:IMMediate

Instrument specic

The

:ABORt

manual

The

:INITiate:IMMediate

mode

command

and

the

stops

scan

command

scanning.

Command

The :INITiate:IMMediate

Command

Example:

Syntax:

:ABORt

OUTPUT 720;\:ABOR"

command starts

:INITiate:IMMediate

OUPUT

720;\:INIT

commands

the

scanning.

time

is

set

to

must

:IMM"

The

instrument

zero

.

be

executed

the paddles

is

to

restart

scanning.

placed

the

in

paddles

4-27

:P

ADDle:POSition

Programming

Instrument Specic

The

:PADDle:POSition

the

instrument is

position,

other

error

The

it is

best to

commands.

. The

default is

:POSition query

Commands

command sets

in manual

send either

If the

PADD1.

returns the

mode.

T

the

instrument is

position

the positions

o

insure

*W

AI

or

the

*OPC

scanning,

of

a

paddle

of one

paddle

commands

this

command

.

of

has

the

paddles

reached

before

generates

when

its

nal

issuing

an

Command Syntax:

Where:

Example:

Query

Syntax:

Returned

F

ormat:

Where:

Example:

:P

ADDle

<

value

OUTPUT

:P

ADD

<

value

<

value

the

maximum

OUTPUT

ENTER

PRINT

>

<

><

>

720;P

P

<

1

::= the

720;\:P

1

j

::=

720;\:P

addle3

j

2

j

ADD:POS

2

j

3

j

NL

>

the

or

minimum

ADD3:POS?"

addle3

pos

3

j

4

>

position of

4

>

:POS?

position

pos

:POSition

the selected

15;"

MAX;"

<

of

the

allowable

f

MAXimum

selected

position

j

paddle

j

MINimum

paddle

MINimum

>

or

j

<

value

>

g

4-28

Instrument Specic

Programming

Commands

:SCAN:RA

TE

:SCAN:TIMer

The

:SCAN:RATE

possible

scan

the

The

values.

rate.

scan timer

:SCAN:RATE

Command Syntax:

Where:

Example:

Query

Syntax:

Returned F

Where:

Example:

The

:SCAN:TIMer

command sets

Scan rate

Setting the

.

query returns

:SCAN:RATE

<

value

OUTPUT

:SCAN:RA

ormat:

<

value

<

value

the

maximum

OUTPUT

ENTER

PRINT

query

\1" is

scan when

f

MAXimum

>

::= the

desired scan

720;\:SCAN:RA

TE?

<

MAXimum

><

NL

>

::=

the

current

or

minimum

720;\:SCAN:RA

Scan

rate

720;

Scan

returns

the scan

the

rate of

slowest

instrument

the current

j

MINimum

j

rate.

TE

4;"

TE

MAX;"

j

MINimum

scan

rate

or

allowable

range

TE?"

the

value of

rate

scan

<

value

>

the scan

>

the

,

is

g

paddles

scan

already

rate

.

timer

to

one

\8"

is

the

scanning

in

seconds

of

eight

fastest

resets

.

Query Syntax:

Returned

F

ormat:

Where:

Example: OUTPUT

:SCAN:TIMer?

<

value

>

<

value

>

::=value

720;

ENTER

720;

PRINT

Timer

NL

>

of

\:SCAN:TIM?"

val

Timer

val

the

scan timer

(exponential{NR3 format)

4-29

Programming

Instrument Specic

Commands

:SCAN:TIMer:CLEar

:ST

A

T

us:OPERation

:CONDition

:ST

A

T

us:OPERation

:ENABle

The

:SCAN:TIMer:CLEar

commands

scan

Command

*RST,

timer to

Syntax:

Example:

The

:ST

A

Tus:OPERation:CONDition

Agilent

only

Query

11896A.

for

completeness

Syntax:

Example:

The

ST

A

Tus:OPERation:ENABle

The

:ST

A

Tus:OPERation:ENABle

number

of

bits

command resets

INITiate:IMMediate,

zero.)

:SCAN:TIMer:CLEar

OUPUT 720;\:SCAN:TIM:CLE;"

It

is

a

required command

.

:ST

AT

us:OPERation:CONDition?

OUTPUT

720;\:ST

ENTER

720;Result

PRINT

Result

set

in

the

status

A

T

:OPER:COND?"

command

query

enable

ABORT,

query

returns

register

the scan

and

timer to

SCAN:RA

always returns

for IEEE

sets

the

a

decimal

488.2 and

status

.

zero.

(The

TE

also

zero for

the

is implemented

enable

value

register

indicating

reset

the

.

the

Command

Query

Where:

Example:

Syntax:

Returned

Where:

Syntax:

F

ormat:

:ST

A

<

value

OUTPUT

:ST

A

<

value

<

value

Example: OUTPUT 720;\:ST

ENTER 720; Operation enable

PRINT Operation enable

4-30

T

us:OPERation:ENABle

>

::=

0

to

255

720;\:ST

A

T

:OPER:ENAB

T

us:OPERation:ENABle?

><

NL

>

::=

0

T

O

255

AT:OPER:ENAB?"

<

value

>

4;"

(integer{NR1 format)

:ST

A

T

us:OPERation

:EVENt

:ST

A

T

us:PRESet

The

:STA

Tus:OPERation:EVENt query

11896A.

It is

completeness

Query

Syntax:

Example:

The

:ST

ATus:PRESet

enable

registers

,

the

aected.

a required

.

:ST

A

T

us:OPEReration:EVENt?

OUTPUT

ENTER

PRINT

,

and

IEEE

488.2

command for

720;\:ST

A

T:OPER:EVEN?"

720;Result

Result

command presets

the

SCPI

error/event

status

byte

,

always returns

IEEE

488.2

the

SCPI

transition

and

queue

the

enable

standard

Instrument Specic

zero

for

and

is

implemented

lters

.

The

SCPI

event

status

the

,

Programming

Commands

Agilent

only

the

SCPI

event

are

not

for

:ST

A

T

us:QUEStionable

:CONDition

Command

Example:

The

:ST

Agilent

only

for

Query Syntax:

Example:

Syntax:

A

Tus:QUEStionable:CONDition query

11896A.

completeness

:ST

A

T

us:PRESet

OUTPUT

720;\:ST

A

T

It

is

a required

.

:ST

A

T

us:QUEStionable:CONDition?

OUTPUT

720;\:ST

A

T

ENTER

720;Result

PRINT

Result

:PRES;"

command

:QUES:COND?"

for

always

IEEE

returns

488.2

and

zero

for

is

implemented

the

4-31

:ST

A

T

us:QUEStionable

:ENABle

Programming

Instrument Specic

The

:STA

Tus:QUEStionable:ENABle command

enable

The

the

register.

:STA

Tus:QUEStionable:ENABle query

bits set

in the

Commands

questionable data

enable

sets the

returns a

register

questionable

decimal

.

value

data

indicating

:ST

A

T

us:QUEStionable

:EVENt

Command Syntax:

Where:

Example:

Query

Syntax:

Returned

F

Where:

Example:

The

:ST

A

Tus:QUEStionable:EVENt

Agilent

only

Query

11896A.

for

completeness

Syntax:

Example:

ormat:

:STA

Tus:QUEStionable:ENABle

<

value

>

::= 0

OUTPUT

720;\:ST

:ST

AT

us:QUEStionable:ENABle?

<

value

><

NL

>

<

value

>

::=

0

OUTPUT

720;\:ST

ENTER

720; Status

PRINT

It

is

Status

a

required

enable

.

:ST

A

Tus:QUEStionable:EVENt?

OUTPUT

720;\:ST

ENTER

720;Result

PRINT

Result

to 255

A

T

:QUES:ENAB

T

O

255

(integer{NR1

A

T:QUES:ENAB?"

enable

query

command

A

T

:QUES:EVEN?"

<

value

4;"

>

format)

always

for

IEEE

returns

488.2 and

zero

for

the

is

implemented

4-32

:SYST

em:ERRor

The

:SYSTEM:ERROR

queue

errors

the

occurred

another

number

over the

deep and

query :SY

until the

error occurs

and the

query outputs

interface.

operates on

This instrument

a rst-in,

STEM:ERROR? returns

queue is

.If

error message

a

string

empty.

is

will

the next

rst-out

the error

Any

used

be

returned.

error number

has

further

for

the

an

error

basis

.

numbers

queries

return

in

the

queue

that

Repeatedly

in

the

order

return

variable

zeros

,

Programming

error

is

30

sending

they

until

the

error

Query Syntax:

Returned

Where:

Example:

F

ormat:

:SYST

em:ERRor?

<

error

><

NL

>

<

error

>

::=

an

integer

error

OUTPUT

720;\:SYSTEM:ERROR?"

ENTER

720;Emsg

PRINT

Emsg

T

able

4-5.

Error

Number

{100 command

{101 invalid

{102 syntax

{103 invalid

{104 data

{105 get

type

not

{108 parameter

{109 missing

{112 program

{113 undened

{400 query error

{410 query

{420 query UNTERMINA

{430 query DEADL

{440 query UNTERMINA

code

.

Error

error

character

error

separator

error

allowed

not allowed

parameter

mnemonic

header

INTERRUP

OCKED

Messages

Description

(unknown

too

command)

long

TED

TED after indenite response

4-33

:SYST

em:VERSion

Programming

The

:SYST

instrument

em:VERSion query

complies.

returns the

version of

SCPI

with

which

this

Query Syntax:

Returned

Example:

F

ormat:

:SYSTem:VERSion?

f

version

g

<

NL

>

OUTPUT

720;\:SYST

ENTER 720;version

PRINT

version

:VERS?"

4-34

5

V

erication

Information

and

Service

V

erication and

What



you'll nd

How

to

perform

verify

return

service

in this

chapter

aquick

the Agilent

the

Agilent

the

Agilent

verication check

Service Information

of the

11896A specications.

11896A polarization

11896A

polarization

Agilent 11896A

controller for

controller.

service

lightwave

.

polarization

controller

.

5-2

Agilent Technologies 11896A User Manual

Specifications and Main Features

Frequently Asked Questions

User Manual

warranty

Assistance

Contents

Description

Storage

Making connections

Summary

inspection

Programming

device address

Instructions

Program data

Duplicate mnemonics

Query command

Initialization

Addressing

Lockout

Common commands