Agilent Technologies Agilent 8163A Mode d'emploi

Agilent Technologies

Agilent 8163A/B Lightwave Multimeter,

Agilent 8164A/B Lightwave Measurement System, &

Agilent 8166A/B Lightwave Multichannel System

Programming Guide

Advanced Test Equipment Rentals

www.atecorp.com 800-404-ATEC (2832)

Notices

This document contains proprietary

information that is protected by

No part of this document may repro-

duced in (including electronic storage

and retrieval or translation into a for-

eign language) without prior agree-

ment and written consent from Agilent

Technologies GmbH as governed by

United States and international

Agilent Technologies Deutschland

GmbH

Herrenberger Str. 130

71034 Böblingen

Germany

Manual Part Number

08164-90B64

Edition

Fifth edition, January 2005

Fourth edition, April 2003

Third edition, February 2002

Second edition, Oktober 2001

First edition, July 2001

Warranty

This Agilent Technologies instrument

product is warranted against defects in

material and workmanship for a period

of one year from date of shipment.

During the warranty period, Agilent

will, at its option, either repair or

replace products that prove to be

defective.

For warranty service or repair, this

product must be returned to a service

facility designated by Agilent. Buyer

shall prepay shipping charges to

Agilent and Agilent shall pay shipping

charges to return the product to Buyer.

However, Buyer shall pay all shipping

charges, duties, and taxes for products

returned to Agilent from another

country.

Agilent warrants that its software and

firmware designated by Agilent for use

with an instrument will execute its

programming instructions when

properly installed on that instrument.

Agilent does not warrant that the

operation of the instrument, software,

or firmware will be uninterrupted or

error free.

Limitation of Warranty

The foregoing warranty shall not apply

to defects resulting from improper or

inadequate maintenance by Buyer,

Buyer-supplied software or interfacing,

unauthorized modification or misuse,

operation outside of the environmental

specifications for the product, or

improper site preparation or

maintenance.

No other warranty is expressed or

implied. Agilent Technologies

specifically disclaims the implied

warranties of Merchantability and

Fitness for a Particular Purpose.

Exclusive Remedies

The remedies provided herein are

Buyer's sole and exclusive remedies.

Agilent Technologies shall not be liable

for any direct, indirect, special,

incidental, or consequential damages

whether based on contract, tort, or any

other legal theory.

Assistance

Product maintenance agreements and

other customer assistance agreements

are available for Agilent Technologies

products. For any assistance contact

your nearest Agilent Technologies

Sales and Service Office.

Certification

Agilent Technologies Inc. certifies that

this product met its published

specifications at the time of shipment

from the factory.

Agilent Technologies further certifies

that its calibration measurements are

traceable to the United States National

Institute of Standards and Technology,

NIST (formerly the United States

National Bureau of Standards, NBS) to

the extent allowed by the Institutes’s

calibration facility, and to the

calibration facilities of other

International Standards Organization

members.

ISO 9001 Certification

Produced to ISO 9001 international

quality system standard as part of our

objective of continually increasing

customer satisfaction through

improved process control.

Safety Notices

CAUTION

A CAUTION notice denotes a

hazard. It calls attention to an

operating procedure, practice, or

the like that, if not correctly per-

formed or adhered to, could result

in damage to the product or loss of

important data. Do not proceed

beyond a CAUTION notice until the

indicated conditions are fully

understood and met.

WARNING

A WARNING notice denotes a

hazard. It calls attention to an

operating procedure, practice, or

the like that, if not correctly per-

formed or adhered to, could result

in personal injury or death. Do not

proceed beyond a WARNING

notice until the indicated condi-

tions are fully understood and met.

Warnings and Notices

WARNING

To avoid the possibility of injury or death, you must observe the following

precautions before switching on the instrument.

Insert the power cable plug only into a socket outlet provided with a

protective earth contact. Do not negate this protective action by the

using an extension cord without a protective conductor.

WARNING

Never look directly into the end of a fiber or a connector, unless you are

absolutely certain that there is no signal in the fiber.

Agilent Technologies Sales and Service Offices

For more information about Agilent Technologies test and measurement

products, applications, services, and for a current sales office listing, viesit

our web site:

http://www.agilent.com/comms/lightwave

You can also contact one of the following centers and ask for a test and

measurement sales representative.

United States: 1 800 829 4444

1 800 829 4433(FAX)

Canada: 1 877 894 4414

(1888 900 8921(FAX)

Europe: (31 20) 547 2111

(31 20) 547 2190 (FAX)

Japan: 0120 421 345

0120 421 678 (FAX)

Mexico (52 55) 5081 9469

(52 55) 5081 9467 (FAX)

Australia: 1 800 629 485

1 800 142 134 (FAX)

Asia-Pacific: 800 930 871

800 908 476 (FAX)

Brazil (55 11) 4197 3600

(55 11) 4197 3800 (FAX)

In this Manual

This manual contains information about SCPI commands which can be

used to program the following instruments:

• Agilent 8163A/B Lightwave Multimeter

• Agilent 8164A/B Lightwave Measurement System

• Agilent 8166A/B Lightwave Multichannel System

The Structure of this Manual

This manual is divided into 5 parts:

•“Introduction to Programming” on page 15 gives a general introduction

to SCPI programming with the Agilent 8163A/B Lightwave Multimeter,

the Agilent 8164A/B Lightwave Measurement System, and the

Agilent 8166A/B Lightwave Multichannel System.

•“Specific Commands” on page 43 lists all instrument specific

commands.

•“Instrument Setup and Status” on page 55, “Measurement Operations

& Settings” on page 79, and “Mass Storage, Display, and Print

Functions” on page 185 give fuller explanations of all instrument

specific commands.

•“VISA Programming Examples” on page 189 gives some example

programs showing how the SCPI commands can be used with the

Agilent 8163A/B Lightwave Multimeter, the Agilent 8164A/B

Lightwave Measurement System, and the Agilent 8166A/B Lightwave

Multichannel System.

•“The Agilent 816x VXIplug&play Instrument Driver” on page 213, “GPIB

Command Compatibility List” on page 245, and “Error Codes” on

page 257 give information about the Agilent 816x VXIplug&play

Instrument Driver, compatibility issues, and error codes.

Conventions used in this Manual

• All commands and typed text is written in Courier font, for example

INIT[:IMM].

• SCPI commands are written in mixed case: text that you MUST print is

written in capitals; text which is helpful but nor necessary is written in

lower case.

So, the command INITiate[:IMMediate] can be entered either as

init[:imm], or as initiate[:immediate]. It does not matter whether you

enter text using capitals or lower-case letters.

• SCPI commands often contain extra arguments in square brackets.

These arguments may be helpful, but they need not be entered.

So, the command INITiate[:IMMediate] can be entered as init or

initiate:imm.

• A SCPI command which can be either a command or a query is

appended with the text /?.

So, DISPlay:ENABle/? refers to both the command DISPlay:ENABle and

the query DISPlay:ENABle?.

Related Manuals

You can find more information about the instruments covered by this

manual in the following manuals:

•Agilent 8163A/B Lightwave Multimeter, Agilent 8164A/B Lightwave

Measurement System, & Agilent 8166A/B Lightwave Multichannel

System User’s Guide (Agilent Product Number 08164-90B14).

NOTE Please note that User Guides no longer contain programming information,

and must now be used in conjunction with this manual.

Refer to the books listed on page 16 for additional information about the

General Purpose Interface Bus, GPIB.

Agilent 8163A/B, 8164A/B, & 8166A/B Programming Guide, Fourth Edition 7

Table of Contents

The Structure of this Manual 5

Conventions used in this Manual 5

Related Manuals 6

Introduction to Programming 15

GPIB Interface 16

Returning the Instrument to Local Control 18

Message Queues 19

How the Input Queue Works 20

Clearing the Input Queue 20

The Output Queue 21

The Error Queue 22

Programming and Syntax Diagram Conventions 23

Short Form and Long Form 24

Command and Query Syntax 25

Units 25

Data Types 26

Slot and Channel Numbers 26

Laser Selection Numbers 27

Common Commands 29

Common Command Summary 30

Common Status Information 31

The Status Model 33

Status Registers 33

Status System for 8163A/B & 8164A/B 35

Status System for 8166A/B 36

Annotations 37

Status Byte Register 37

Standard Event Status Register 37

Operation/Questionable Status Summary 37

Operation/Questionable Status Summary Register 38

Operation/Questionable Slot Status 38

Operation Slot Status Register 38

Questionable Slot Status Register 38

Status Command Summary 40

Other Commands 41

8Agilent 8163A/B, 8164A/B, & 8166A/B Programming Guide, Fourth Edition

Specific Commands 43

Specific Command Summary 44

Instrument Setup and Status 55

IEEE-Common Commands 56

Status Reporting –The STATus Subsystem 64

Interface/Instrument Behaviour Settings –The SYSTem

Subsystem 76

Measurement Operations & Settings 79

Root Layer Command 80

Measurement Functions –The SENSe Subsystem 85

Agilent 81635A and Agilent 81619A- Master and Slave

Channels 85

Signal Generation –The SOURce Subsystem 113

Signal Conditioning 148

The INPut and OUTput commands 148

The table of wavelength-dependent offsets 159

Compatibility of the 81560A/1A/6A/7A modular

attenuator family to the 8156A attenuator 165

Slot Numbers 165

Command Semantic 166

Display and System Commands 167

IEEE Commands 167

Status Commands 168

User Calibration Data 168

Signal Routing 169

Triggering - The TRIGger Subsystem 171

Extended Trigger Configuration 179

Extended Trigger Configuration Example 182

Mass Storage, Display, and Print Functions 185

Display Operations – The DISPlay Subsystem 186

Agilent 8163A/B, 8164A/B, & 8166A/B Programming Guide, Fourth Edition 9

VISA Programming Examples 189

How to Use VISA Calls 190

How to Set up a Fixed Laser Source 192

How to Measure Power using FETCh and READ 195

How to Co-ordinate Two Modules 199

How Power Varies with Wavelength 203

How to Log Results 207

The Agilent 816x VXIplug&play Instrument Driver 213

Installing the Agilent 816x Instrument Driver 214

Using Visual Programming Environments 218

Getting Started with Agilent VEE 218

GPIB Interfacing in Agilent VEE 218

Getting Started with LabView 221

Getting Started with LabWindows 224

Features of the Agilent 816x Instrument Driver 225

Directory Structure 226

Opening an Instrument Session 227

Closing an Instrument Session 228

VISA Data Types and Selected Constant Definitions 229

Error Handling 230

Introduction to Programming 232

Example Programs 232

VISA-Specific Information 232

Instrument Addresses 232

Callbacks 232

Development Environments 232

Microsoft Visual C++ 4.0 (or higher) and Borland C++ 4.5

(or higher) 232

Microsoft Visual Basic 4.0 (or higher) 233

Agilent VEE 5.01 (or higher) 233

LabWindows CVI/ (R) 4.0 (or higher) 233

Online Information 234

Lambda Scan Applications 235

Equally Spaced Datapoints 236

10 Agilent 8163A/B, 8164A/B, & 8166A/B Programming Guide, Fourth Edition

How to Perform a Lambda Scan Application 237

The Prepare Lambda Scan Function 237

The Get Lambda Scan Parameters Function 238

The Execute Lambda Scan Function 238

How to Perform a Multi-Frame Lambda Scan Application 239

The Equally Spaced Datapoints Function 240

The Register Mainframe Function 240

The Unregister Mainframe Function 240

The Prepare Multi Frame Lambda Scan Function 241

The Get MF Lambda Scan Parameters Function 242

The Execute Multi Frame Lambda Scan Function 242

The Get Lambda Scan Result Function 242

The Get Number of PWM Channels Function 243

The Get Channel Location Function 243

GPIB Command Compatibility List 245

Compatibility Issues 246

GPIB Bus Compatibility 246

Status Model 247

Preset Defaults 248

Removed Command 249

Obsolete Commands 250

Changed Parameter Syntax and Semantics 251

Changed Query Result Values 252

Timing Behavior 253

Error Handling 254

Command Order 255

Instrument Status Settings 256

Error Codes 257

GPIB Error Strings 258

Index 271

Autres manuels pour Agilent 8163A

Ce manuel convient aux modèles suivants

Table des matières

Autres manuels Agilent Technologies Instrument de mesure

Agilent Technologies

Agilent Technologies ENA Series Manuel utilisateur

Agilent Technologies

Agilent Technologies 85052A Mode d'emploi

Agilent Technologies

Agilent Technologies 4339B Manuel utilisateur

Agilent Technologies

Agilent Technologies 81950A Manuel utilisateur

Agilent Technologies

Agilent Technologies E4980A Manuel utilisateur

Agilent Technologies

Agilent Technologies OmniBER OTN J7232A Mode d’emploi

Agilent Technologies

Agilent Technologies 5185-5991 Manuel utilisateur

Agilent Technologies

Agilent Technologies Agilent 8163A Manuel utilisateur

Agilent Technologies

Agilent Technologies 8753ET Manuel utilisateur

Agilent Technologies

Agilent Technologies FieldFox MW N9913A Manuel utilisateur

Agilent Technologies

Agilent Technologies E5062A ENA-L Series Guide de démarrage rapide

Agilent Technologies

Agilent Technologies 8590 Series Manuel utilisateur

Agilent Technologies

Agilent Technologies 8453 Manuel utilisateur

Agilent Technologies

Agilent Technologies Agilent 4396B Mode d'emploi

Agilent Technologies

Agilent Technologies AN 1287-6 Instructions d'installation et d'utilisation

Agilent Technologies

Agilent Technologies Seahorse XFe Manuel utilisateur

Agilent Technologies

Agilent Technologies U1731C Manuel utilisateur

Agilent Technologies

Agilent Technologies E5052A Manuel utilisateur

Agilent Technologies

Agilent Technologies InfiniiVision 7000B Series Manuel de l'opérateur

Agilent Technologies

Agilent Technologies 4263B Manuel utilisateur

Agilent Technologies

Agilent Technologies 4284A Manuel utilisateur

Agilent Technologies

Agilent Technologies U3025AE10 Manuel utilisateur

Agilent Technologies

Agilent Technologies E2730A Manuel utilisateur

Agilent Technologies

Agilent Technologies 8757D Manuel utilisateur

Manuels Instrument de mesure populaires d'autres marques

Suaoki

Suaoki D40 Manuel utilisateur

Elster

Elster BK-G1.6 Manuel utilisateur

Endress+Hauser

Endress+Hauser Deltabar FMD71 Manuel

Duratool

Duratool D03128 Manuel utilisateur

Vega

Vega VEGAPULS 65 Manuel utilisateur

Tonghui

Tonghui TH2618B Manuel utilisateur

Tenmars

Tenmars TM-801 Manuel utilisateur

MSR

MSR 145 Manuel utilisateur

TPS

TPS WP-82 Manuel utilisateur

ELMETRON

ELMETRON CP-511 Manuel utilisateur

PCB Piezotronics

PCB Piezotronics 003C30 Manuel utilisateur

Tenma

Tenma 72-10465 Manuel utilisateur

Endress+Hauser

Endress+Hauser Proline Promag 50 Caractéristiques techniques

Siemens

Siemens SITRANS F Coriolis FCT030 Manuel de la liste des pièces

KLINGER

KLINGER CMF V Series Manuel utilisateur

EXFO

EXFO FTB-2 Manuel d'exploitation et d'entretien

Keysight

Keysight M8290A Manuel utilisateur

ADTEK

ADTEK MW-5 Manuel utilisateur