Keysight Technologies 8163A/B Mode d'emploi

Programming

Guide

8163A/B Lightwave Multimeter,

8164A/B Lightwave Measurement

System, & 8166A/B Lightwave

Multichannel System

Notices

No part of this manual may be reproduced

in any form or by any means (including

electronic storage and retrieval or transla-

tion into a foreign language) without prior

agreement and written consent from

Keysight Technologies as governed by

United States and international copyright

laws.

Manual Part Number

08164-90B65

Edition

Edition 2.0, June 2016

Keysight Technologies Deutschland GmbH

Herrenberger Strasse 130,

71034 Böblingen, Germany

Technology Licenses

The hardware and/or software described in

this document are furnished under a

license and may be used or copied only in

accordance with the terms of such license.

U.S. Government Rights

The Software is “commercial computer

software,” as defined by Federal Acquisition

Regulation (“FAR”) 2.101. Pursuant to FAR

12.212 and 27.405-3 and Department of

Defense FAR Supplement

(“DFARS”) 227.7202, the U.S. government

acquires commercial computer software

under the same terms by which the soft-

ware is customarily provided to the public.

Accordingly, Keysight provides the Soft-

ware to U.S. government customers under

its standard commercial license, which is

embodied in its End User License Agree-

ment (EULA), a copy of which can be found

at http://www.keysight.com/find/sweula.

The license set forth in the EULA represents

the exclusive authority by which the U.S.

government may use, modify, distribute, or

disclose the Software. The EULA and the

license set forth therein, does not require

or permit, among other things, that Key-

sight: (1) Furnish technical information

related to commercial computer software

or commercial computer software docu-

mentation that is not customarily provided

to the public; or (2) Relinquish to, or other-

wise provide, the government rights in

excess of these rights customarily provided

to the public to use, modify, reproduce,

release, perform, display, or disclose com-

mercial computer software or commercial

computer software documentation. No

additional government requirements

beyond those set forth in the EULA shall

apply, except to the extent that those

terms, rights, or licenses are explicitly

required from all providers of commercial

computer software pursuant to the FAR and

the DFARS and are set forth specifically in

writing elsewhere in the EULA. Keysight

shall be under no obligation to update,

revise or otherwise modify the Software.

With respect to any technical data as

defined by FAR 2.101, pursuant to FAR

12.211 and 27.404.2 and DFARS 227.7102,

the U.S. government acquires no greater

than Limited Rights as defined in FAR

27.401 or DFAR 227.7103-5 (c), as appli-

cable in any technical data.

Warranty

THE MATERIAL CONTAINED IN THIS DOCU-

MENT IS PROVIDED "AS IS," AND IS SUB-

JECT TO BEING CHANGED, WITHOUT

NOTICE, IN FUTURE EDITIONS. FURTHER,

TO THE MAXIMUM EXTENT PERMITTED BY

APPLICABLE LAW, KEYSIGHT DISCLAIMS

ALL WARRANTIES, EITHER EXPRESS OR

IMPLIED WITH REGARD TO THIS MANUAL

AND ANY INFORMATION CONTAINED

HEREIN, INCLUDING BUT NOT LIMITED TO

THE IMPLIED WARRANTIES OF MER-

CHANTABILITY AND FITNESS FOR A PAR-

TICULAR PURPOSE. KEYSIGHT SHALL NOT

BE LIABLE FOR ERRORS OR FOR INCIDEN-

TAL OR CONSEQUENTIAL DAMAGES IN

CONNECTION WITH THE FURNISHING,

USE, OR PERFORMANCE OF THIS DOCU-

MENT OR ANY INFORMATION CONTAINED

HEREIN. SHOULD KEYSIGHT AND THE

USER HAVE A SEPARATE WRITTEN AGREE-

MENT WITH WARRANTY TERMS COVER-

ING THE MATERIAL IN THIS DOCUMENT

THAT CONFLICT WITH THESE TERMS, THE

WARRANTY TERMS IN THE SEPARATE

AGREEMENT WILL CONTROL.

Safety Notices

CAUTION

A CAUTION notice denotes a hazard.

It calls attention to an operating pro-

cedure, practice, or the like that, if

not correctly performed 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 pro-

cedure, practice, or the like that, if

not correctly performed or adhered

to, could result in personal injury or

death. Do not proceed beyond a

WARNING notice until the indicated

conditions are fully understood and

met.

28163A/B, 8164A/B & 8166A/B Mainframes Programming Guide

8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide 3

Contents

1 Introduction to Programming

GPIB Interface 8

LAN Interface 10

Returning the Instrument to Local Control 12

Message Queues 13

How the Input Queue Works 13

Clearing the Input Queue 13

The Output Queue 13

The Error Queue 14

Programming and Syntax Diagram Conventions 15

Short Form and Long Form 15

Command and Query Syntax 15

Common Commands 20

Common Command Summary 20

Common Status Information 21

The Status Model 23

Status Registers 23

Status System for 8166A/B 26

Annotations 28

Status Command Summary 30

Other Commands 30

2 Specific Commands

Specific Command Summary 32

4 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide

Contents

3 Instrument Setup and Status

IEEE-Common Commands 46

Status Reporting – The STATus Subsystem 55

Interface/Instrument Behaviour Settings – The SYSTem

Subsystem 68

System Communicate - The :SYST:COMMunicate sub tree. 71

4 Measurement Operations & Settings

Root Layer Command 80

Measurement Functions – The SENSe Subsystem 86

Keysight 81635A and Keysight 81619A - Master and Slave

Channels 86

Signal Generation – The SOURce Subsystem 122

Signal Conditioning 182

The INPut and OUTput commands 182

The table of wavelength-dependent offsets 196

Compatibility of the 81560A/1A/6A/7A modular attenuator family to the

8156A attenuator 202

Display and System Commands 204

IEEE Commands 205

Status Commands 205

User Calibration Data 205

Signal Routing 206

Triggering - The TRIGger Subsystem 208

Extended Trigger Configuration 217

Extended Trigger Configuration Example 221

5 Mass Storage, Display, and Print Functions

Display Operations – The DISPlay Subsystem 224

8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide 5

Contents

6 VISA Programming Examples

How to Use VISA Calls 230

How to Set up a Fixed Laser Source 232

How to Measure Power using FETCh and READ 235

How to Co-ordinate Two Modules 239

How Power Varies with Wavelength 244

How to Log Results 249

7 The Keysight 816x VXIplug&play Instrument Driver

Installing the Keysight 816x Instrument Driver 256

Using Visual Programming Environments 257

Getting Started with Keysight VEE 257

GPIB Interfacing in Keysight VEE 258

Getting Started with LabView 260

Getting Started with LabWindows 262

Features of the Keysight 816x Instrument Driver 263

Directory Structure 264

Opening an Instrument Session 265

Closing an Instrument Session 266

VISA Data Types and Selected Constant Definitions 267

Error Handling 268

Introduction to Programming 270

Example Programs 270

VISA-Specific Information 270

Development Environments 270

Online Information 272

6 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide

Contents

Lambda Scan Applications 273

How to Perform a Lambda Scan Application 275

How to Perform a Multi-Frame Lambda Scan Application 277

8 GPIB Command Compatibility List

Compatibility Issues 282

GPIB Bus Compatibility 282

Status Model 282

Preset Defaults 282

Removed Command 283

Obsolete Commands 284

Changed Parameter Syntax and Semantics 285

Changed Query Result Values 286

Timing Behavior 287

Error Handling 288

Command Order 288

9 Error Codes

GPIB Error Strings 290

Index

8163A/B, 8164A/B & 8166A/B Mainframes

Programming Guide

1Introduction to

Programming

GPIB Interface / 8

Message Queues / 13

Programming and Syntax Diagram Conventions / 15

Common Commands / 20

The Status Model / 23

This chapter gives general information on how to control your instrument

remotely.

Descriptions for the actual commands for the instruments are given in the

following chapters. The information in these chapters is specific to the

8163A/B Lightwave Multimeter, 8164A/B Lightwave Measurement

System, and 8166A/B Lightwave Multichannel System and assumes that

you are already familiar with programming the GPIB.

8 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide

1 Introduction to Programming

GPIB Interface

The interface used by your instrument is the GPIB (General Purpose

Interface Bus).

GPIB is the interface used for communication between a controller and an

external device, such as the tunable laser source. The GPIB conforms to

IEEE standard 488-1978, ANSI standard MC 1.1 and IEC recommendation

625-1.

If you are not familiar with the GPIB, then refer to the following books:

• The International Institute of Electrical and Electronics Engineers. IEEE

Standard 488.1-1987, IEEE Standard Digital Interface for

Programmable Instrumentation.

• The International Institute of Electrical and Electronics Engineers. IEEE

Standard 488.2-1992, IEEE Standard Codes, Formats, Protocols and

Common Commands For Use with ANSI/IEEE Std 488.1-1987.

To obtain a copy of either of these last two documents, look at:

http://standards.ieee.org/findstds/standard/instrumentation_and_measur

ement.html

In addition, the commands not from the IEEE-488.2 standard, are defined

according to the Standard Commands for Programmable Instruments

(SCPI).

For information about SCPI, and SCPI programming techniques, please

refer to:

•Standard Commands for Programmable Instruments.

Web: http://www.ivifoundation.org/docs/scpi-99.pdf

See also: http://www.ivifoundation.org/scpi/

The interface of the 8163A/B Lightwave Multimeter, 8164A/B Lightwave

Measurement System, and 8166A/B Lightwave Multichannel System to

the GPIB is defined by the IEEE Standards 488.1 and 488.2.

Table 1 on page -9 shows the interface functional subset that the

instruments implement.

8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide 9

Introduction to Programming 1

Table 1 GPIB Capabilities

Setting the GPIB Address

There are two ways to set the GPIB address:

• You can set the GPIB address by using the command

:SYSTem:COMMunicate:GPIB[:SELF]:ADDRess on page 71.

• You can set the GPIB address from the front panel. See your

instrument’s User’s Guide for more information.

The default GPIB address is 20.

Mnemonic Function

SH1 Complete source handshake capability

AH1 Complete acceptor handshake capability

T6 Basic talker; serial poll; no talk only mode; unaddressed to talk if addressed to listen

L4 Basic listener; no listen only mode; unaddressed to listen if addressed to talk

SR0 No service request capability

RL1 Complete remote/local capability

PP0 No parallel poll capability

DC1 Complete device clear capability

DT0 No device trigger capability

C0 No controller capability.

NOTE

GPIB address 21 is often applied to the GPIB controller. If so, 21 cannot be used

as an instrument address.

10 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide

1 Introduction to Programming

LAN Interface

The current generation of mainframes 8163B (starting with S/N

DE48204000) and 8164B (starting with S/N DE48202000) are also

equipped with a LAN Interface. The LAN Interface can be operated either

with fixed or variable IP address, depending on whether a DHCP server is

available and the DHCP mode is enabled.

The GPIB conforms to IEEE standard 488-1978, ANSI standard MC 1.1 and

IEC recommendation 625-1.

Available connections:

• LAN (VXI-11 (RPC))

• LAN (TCP Socket, port 5025)

• LAN (Telnet, port 5024)(Quit telnet sessions with Ctrl-D)

2 VXI-11 connections and up to 10 socket or telnet connections (socket +

telnet ~ 10) are possible. The ports for socket and telnet connections

cannot be modified.

Please note the following points:

• We recommend you use socket connections for applications. (Can be

configured in Keysight Connection Expert)

• All LAN VXI-11 connections share their status information (Error queue,

status registers).

• Socket and telnet connections are independent of each other.

• The status registers are updated if a new socket or telnet connection is

opened.

• Be careful if there is more than one connection:

••When using a VISA layer you can lock a device, so another

controller accessing the same device with the same connection type

(VISA VXI-11 or VISA socket) cannot access this device. However

the device can be accessed with a different connection. This means,

for example, if a device is locked in a VISA socket connection it can

still be accessed with VXI-11.

•A telnet connection cannot be locked.

Ce manuel convient aux modèles suivants

Table des matières

Autres manuels Keysight Technologies Instrument de mesure

Keysight Technologies

Keysight Technologies N9020B Manuel d'installation et d'exploitation

Keysight Technologies

Keysight Technologies N4373E Manuel utilisateur

Keysight Technologies

Keysight Technologies N9041B Manuel d'installation et d'exploitation

Keysight Technologies

Keysight Technologies 53147A Manuel utilisateur

Keysight Technologies

Keysight Technologies B1505A Manuel utilisateur

Keysight Technologies

Keysight Technologies P5000A Series Manuel utilisateur

Keysight Technologies

Keysight Technologies EXA N9010B Manuel d'installation et d'exploitation

Keysight Technologies

Keysight Technologies M9710A Guide rapide

Keysight Technologies

Keysight Technologies U1701B Manuel utilisateur

Keysight Technologies

Keysight Technologies PNA-X N5249A Manuel utilisateur

Keysight Technologies

Keysight Technologies MXA N9020A Manuel utilisateur

Keysight Technologies

Keysight Technologies N4960A Manuel utilisateur

Keysight Technologies

Keysight Technologies i7090 Manuel utilisateur

Keysight Technologies

Keysight Technologies M9300A Guide de l'utilisateur

Keysight Technologies

Keysight Technologies 1130B Series Manuel utilisateur

Keysight Technologies

Keysight Technologies B2900A Series Manuel utilisateur

Keysight Technologies

Keysight Technologies U4164A Manuel utilisateur

Keysight Technologies

Keysight Technologies 5061B Manuel utilisateur

Keysight Technologies

Keysight Technologies E5061B ENA Series Manuel utilisateur

Keysight Technologies

Keysight Technologies N9340B Manuel utilisateur

Keysight Technologies

Keysight Technologies B2900B Series Manuel utilisateur

Keysight Technologies

Keysight Technologies S9106AC-2IF Guide de l'utilisateur

Keysight Technologies

Keysight Technologies M9451A Guide de l'utilisateur

Keysight Technologies

Keysight Technologies X Series Manuel d'installation et d'exploitation

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