HP 8163A Series Programming Manual

HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System Programming Guide

& HP 8166A Lightwave Multichannel System Programming Guide, E1299 Notices This document contains proprietary information that is protected by copyright. All rights are reserved. No part of this document may be photocopied, reproduced, or translated to another language without the prior written consent of Hewlett-Packard GmbH.  Copyright 1999 by: Hewlett-Packard GmbH Herrenberger Str. 130 71034 Böblingen Germany Subject Matter The information in this document is subject to change without notice. Hewlett-Packard makes no warranty of any kind with regard to this printed material, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose. Hewlett-Packard shall not be liable for errors contained herein or for incidental or consequential damages in connection with the furnishing, performance, or use of this material. Printing History New editions are complete revisions of the guide reflecting alterations in the functionality of the instrument. Updates are occasionally made to the guide between editions. The date on the title page changes when an updated guide is published. To find out the current revision of the guide, or to purchase an updated guide, contact your Hewlett-Packard representative. Control Serial Number: First Edition applies directly to all instruments. Warranty This Hewlett-Packard instrument product is warranted against defects in material and workmanship for a period of one year from date of shipment. During the warranty period, HP 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 HP. Buyer shall prepay shipping charges to HP and HP shall pay shipping charges to return the product to Buyer. However, Buyer shall pay all shipping charges, duties, and taxes for products returned to HP from another country. HP warrants that its software and firmware designated by HP for use with an instrument will execute its programming instructions when properly installed on that instrument. HP 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. Hewlett-Packard 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. Hewlett-Packard 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 Hewlett-Packard products. For any assistance contact your nearest Hewlett-Packard Sales and Service Office. Certification Hewlett-Packard Company certifies that this product met its published specifications at the time of shipment from the factory. Hewlett-Packard 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. 08164-91016 E1299 First Edition: E1299: December 1999 Second Edition E0599: May 1999

& HP 8166A Lightwave Multichannel System Programming Guide, E1299 3 In this Manual This manual contains information about SCPI commands which can be used to program the following instruments: • HP 8163A Lightwave Multimeter • HP 8164A Lightwave Measurement System • HP 8166A Lightwave Multichannel System The Structure of this Manual This manual is divided into 5 parts: • “Introduction to Programming” on page 13 gives a general introduction to SCPI programming with the HP 8163A Lightwave Multimeter, the HP 8164A Lightwave Measurement System, and the HP 8166A Lightwave Multichannel System. • “Specific Commands” on page 33 lists all instrument specific commands. • “Instrument Setup and Status” on page 43, “Measurement Operations & Settings” on page 63, and “Mass Storage, Display, and Print Functions” on page 121 give fuller explanations of all instrument specific commands. • “Programming Examples” on page 125 gives some example programs showing how the SCPI commands can be used with the HP 8163A Lightwave Multimeter, the HP 8164A Lightwave Measurement System, and the HP 8166A Lightwave Multichannel System. • “The HP 816x VXIplug&play Instrument Driver” on page 147, “GPIB Command Compatibility List” on page 163, and “Error Codes” on page 171 give information about the HP 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.

& HP 8166A Lightwave Multichannel System Programming Guide, E1299 • 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: • HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide (HP Product Number 08164-91011). NOTE Please note that User Guides no longer contain programming information, and must now be used in conjunction with this manual. If you are not familiar with the General Purpose Interface Bus, GPIB, then refer to the following books: • ANSI/IEEE-488.1-1978, IEEE Standard Digital Interface for Programmable Instrumentation, and ANSI/IEEE-488.2-1987, IEEE Standard Codes, Formats, and Common Commands, published by the Institute of Electrical and Electronic Engineers. In addition, the commands not from the IEEE 488.2 standard are defined according to the Standard Commands for Programmable Instruments (SCPI). For an introduction to SCPI and SCPI programming techniques, refer to the following documents: • Hewlett-Packard Press (Addison-Wesley Publishing Company, Inc.): A Beginners Guide to SCPI by Barry Eppler. • The SCPI Consortium: Standard Commands for Programmable Instruments. To obtain a copy of this manual, contact the following address: SCPI Consortium Office Bode Enterprise 2515 Camino del Rio South, Suite 340 San Diego, CA, 92108 USA Web: http://www.scpiconsortium.org

& HP 8166A Lightwave Multichannel System Programming Guide, E1299 5 Contents In this Manual 3 The Structure of this Manual 3 Conventions used in this Manual 3 Related Manuals 4 Contents 5 Figures 9 Tables 11 Introduction to Programming 13 GPIB Interface 15 Setting the GPIB Address 16 Returning the Instrument to Local Control 17 Message Queues 17 How the Input Queue Works 17 Clearing the Input Queue 18 The Output Queue 18 The Error Queue 18 Programming and Syntax Diagram Conventions 19 Short Form and Long Form 19 Command and Query Syntax 19 Units 20 Data Types 20 Slot and Channel Numbers 21 Laser Selection Numbers 22 Common Commands 22 Common Command Summary 23 Common Status Information 23 The Status Model 25 Status Registers 25 Status System for HP 8163A & HP 8164A 26 Status System for HP 8166A 27 Annotations 28 Status Byte Register 28

& HP 8166A Lightwave Multichannel System Programming Guide, E1299 Standard Event Status Register 29 Operation/Questionable Status Summary 29 Operation/Questionable Status Summary Register 29 Operation/Questionable Slot Status 29 Operation Slot Status Register 30 Questionable Slot Status Register 30 Status Command Summary 30 Other Commands 31 Specific Commands 33 Specific Command Summary 35 Instrument Setup and Status 43 IEEE-Common Commands 45 Status Reporting – The STATus Subsystem 50 Interface/Instrument Behaviour Settings – The SYSTem Subsystem59 Measurement Operations & Settings 63 Root Layer Command 65 Measurement Functions – The SENSe Subsystem 68 HP 81635A and HP 81619A- Master and Slave Channels 68 Signal Generation – The SOURce Subsystem 86 Triggering - The TRIGger Subsystem 108 Extended Trigger Configuration 114 Extended Trigger Configuration Example 118 Mass Storage, Display, and Print Functions 121 Display Operations – The DISPlay Subsystem 123 Programming Examples 125 How to Use VISA Calls 127 How to Set up a Fixed Laser Source 129 How to Measure Power using FETCh and READ 131 How to Co-ordinate Two Modules 134 How Power Varies with Wavelength 138 How to Log Results 142 The HP 816x VXIplug&play Instrument Driver 147 Installing the HP 816x Instrument Driver 149

& HP 8166A Lightwave Multichannel System Programming Guide, E1299 7 Using Visual Programming Environments 152 Getting Started with HP VEE 152 GPIB Interfacing in HP VEE 153 Getting Started with LabView 154 Getting Started with LabWindows 156 Features of the HP 816x Instrument Driver 156 Directory Structure 157 Opening an Instrument Session 157 Closing an Instrument Session 158 VISA Data Types and Selected Constant Definitions 159 Error Handling 159 Introduction to Programming 161 Example Programs 161 VISA-Specific Information 161 Instrument Addresses 161 Callbacks 161 Development Environments 161 Microsoft Visual C++ 4.0 (or higher) and Borland C++ 4.5 (or higher)161 Microsoft Visual Basic 4.0 (or higher) 161 HP VEE 5.01 (or higher) 162 LabWindows CVI/ (R) 4.0 (or higher) 162 Online Information 162 GPIB Command Compatibility List 163 Compatibility Issues 165 GPIB Bus Compatibility 165 Status Model 165 Preset Defaults 165 Removed Command 166 Obsolete Commands 166 Changed Parameter Syntax and Semantics 167 Changed Query Result Values 168 Timing Behavior 168 Error Handling 169 Command Order 169 Instrument Status Settings 169

& HP 8166A Lightwave Multichannel System Programming Guide, E1299 Error Codes 171 GPIB Error Strings 173 Index 179

& HP 8166A Lightwave Multichannel System Programming Guide, E1299 9 Figures Figure 1 Remote Control . . . . . . . . . . . . . . 17 Figure 2 The Event Status Bit . . . . . . . . . . . . . 24 Figure 3 The Registers and Filters for a Node . . . . . . . . . . 25 Figure 4 The Operational/Questionable Status System for HP 8163A & HP 8164A . 27 Figure 5 The Operational/Questionable Status System for HP 8166A . . . . 28 Figure 6 Extended Trigger Configuration . . . . . . . . . . . 116 Figure 7 Setup for Extended Trigger Configuration Example . . . . . . 118 Figure 8 Non-Administrator Installation Pop-Up Box . . . . . . . . 149 Figure 9 Message Screen . . . . . . . . . . . . . . 150 Figure 10 Customizing Your Setup . . . . . . . . . . . . 151 Figure 11 Program Folder Item Options . . . . . . . . . . . 151 Figure 12 Device Configuration . . . . . . . . . . . . . 153 Figure 13 Advanced Device Configuration - Plug&play Driver . . . . . . 153 Figure 14 FP Conversion Options Box. . . . . . . . . . . . 155 Figure 15 Windows 95 and Windows NT VXIPNP Directory Structure . . . . 157

& HP 8166A Lightwave Multichannel System Programming Guide, E1299

& HP 8166A Lightwave Multichannel System Programming Guide, E1299 11 Tables Table 1 GPIB Capabilities . . . . . . . . . . . . . . 16 Table 2 Units and allowed Mnemonics . . . . . . . . . . . 20 Table 3 Common Command Summary . . . . . . . . . . . 23 Table 4 Specific Command Summary . . . . . . . . . . . 35 Table 5 Commands that can only be configured using the master channel . . . 69 Table 6 Commands that are independent for both master and slave channels. . . 69 Table 7 Triggering and Power Measurements . . . . . . . . . 108 Table 8 Generating Output Triggers from Power Measurements . . . . . 109 Table 9 Incompatible GPIB Bus Commands . . . . . . . . . . 165 Table 10 Removed Commands . . . . . . . . . . . . . 166 Table 11 Obsolete Commands . . . . . . . . . . . . . 167 Table 12 Commands with Different Parameters or Syntax . . . . . . . 167 Table 13 Queries with Different Result Values . . . . . . . . . 168 Table 14 Timing Behavior Changes . . . . . . . . . . . . 168 Table 15 Error Handling Changes . . . . . . . . . . . . 169 Table 16 Specific Errors. . . . . . . . . . . . . . . 169 Table 17 Overview for Supported Strings . . . . . . . . . . . 173 Table 18 Overview for Unsupported Strings . . . . . . . . . . 177

& HP 8166A Lightwave Multichannel System Programming Guide, E1299

& HP 8166A Lightwave Multichannel System User’s Guide, E1299 13 Introduction to Programming

14 HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299 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 HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, and HP 8166A Lightwave Multichannel System and assumes that you are already familiar with programming the GPIB.

HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299 15 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. New York, NY, 1987 • The International Institute of Electrical and Electronics Engineers. IEEE Standard 488.2-1987, IEEE Standard Codes, Formats, Protocols and Common Commands For Use with ANSI/IEEE Std 488.1-1987. New York, NY, 1987 To obtain a copy of either of these last two documents, write to: The Institute of Electrical and Electronics Engineers, Inc. 345 East 47th Street New York, NY 10017 USA. In addition, the commands not from the IEEE-488.2 standard, are defined according to the Standard Commands for Programmable Instruments (SCPI). For an introduction to SCPI, and SCPI programming techniques, please refer to the following documents: • Hewlett-Packard Press (Addison-Wesley Publishing Company, Inc.). A Beginners Guide to SCPI. Barry Eppler. 1991. • The SCPI Consortium: Standard Commands for Programmable Instruments. To obtain a copy of this manual, contact the following address: SCPI Consortium Office Bode Enterprise 2515 Camino del Rio South, Suite 340 San Diego, CA, 92108 USA Web: http://www.scpiconsortium.org The interface of the HP 8163A Lightwave Multimeter and of the HP 8164A Lightwave Measurement System to the GPIB is defined by the IEEE Standards 488.1 and 488.2. Table 1 shows the interface functional subset that the instruments implement.

GPIB Interface 16 HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299 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 62. • 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; unaddressed to talk if addressed to listen L4 Basic listener; unaddressed to listen if addressed to talk; no listen only SR1 Complete service request capability RL1 Complete remote/local capability PP0 No parallel poll capability DC1 Device clear capability DT0 No device trigger capability C0 No controller capability (Controller capability to be imple- mented) Table 1 GPIB Capabilities

HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299 17 Returning the Instrument to Local Control If the instrument is in remote control, a screen resembling Figure 1 will appear. Press [Local] if you wish to return the instrument to local control. Message Queues The instrument exchanges messages using an input and an output queue. Error messages are kept in a separate error queue. How the Input Queue Works The input queue is a FIFO queue (first-in first-out). Incoming bytes are stored in the input queue as follows: 1 Receiving a byte: – Clears the output queue. – Clears Bit 7 (MSB). 2 No modification is made inside strings or binary blocks. Outside strings and binary blocks, the following modifications are made: Figure 1 Remote Control

Message Queues 18 HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299 – Lower-case characters are converted to upper-case. – The characters 0016 to 0916 and 0B16 to 1F16 are converted to spaces (2016). – Two or more blanks are truncated to one. 3 An EOI (End Or Identify) sent with any character is put into the input queue as the character followed by a line feed (LF, 0A16). If EOI is sent with a LF, only one LF is put into the input queue. 4 The parser starts if the LF character is received or if the input queue is full. Clearing the Input Queue Switching the power off, or sending a Device Interface Clear signal, causes commands that are in the input queue, but have not been executed to be lost. The Output Queue The output queue contains responses to query messages. The instrument transmits any data from the output queue when a controller addresses the instrument as a talker. Each response message ends with a carriage return (CR, 0D16) and a LF (0A16), with EOI=TRUE. If no query is received, or if the query has an error, the output queue remains empty. The Message Available bit (MAV, bit 4) is set in the Status Byte register whenever there is data in the output queue. The Error Queue The error queue is 30 errors long. It is a FIFO queue (first-in first-out). That is, the first error read is the oldest error to have occurred. A new error is only put into the queue if it is not already in it. If more than 29 errors are put into the queue, the message: -350 is placed as the last message in the queue.

Introduction to Programming HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299 19 Programming and Syntax Diagram Conventions A program message is a message containing commands or queries that you send to the instruments. The following are a few points about program messages: • You can use either upper-case or lower-case characters. • You can send several commands in a single message. Each command must be separated from the next one by a semicolon (;). • A command message is ended by a line feed character (LF) or . • You can use any valid number/unit combination. In other words, 1500NM,1.5UM and 1.5E-6M are all equivalent. If you do not specify a unit, then the default unit is assumed. The default unit for the commands are given with command description in the next chapter. Short Form and Long Form The instrument accepts messages in short or long forms. For example, the message :STATUS:OPERATION:ENABLE 768 is in long form. The short form of this message is :STAT:OPER:ENAB 768 In this manual, the messages are written in a combination of upper and lower case. Upper case characters are used for the short form of the message. For example, the above command would be written :STATus:OPERation:ENABle The first colon can be left out for the first command or query in your message. That is, the example given above could also be sent as STAT:OPER:ENAB 768 Command and Query Syntax All characters not between angled brackets must be sent exactly as shown. The characters between angled brackets (<...>) indicate the kind of data that you should send, or that you get in a response. You do not type the angled brackets in the actual message.

Programming and Syntax Diagram Conventions 20 HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299 Descriptions of these items follow the syntax description. The following types of data are most commonly used: Other kinds of data are described as required. The characters between square brackets ([...]) show optional information that you can include with the message. The bar (|) shows an either-or choice of data, for example, a|b means either a or b, but not both simultaneously. Extra spaces are ignored, so spaces can be inserted to improve readability. Units Where units are given with a command, usually only the base units are specified. The full sets of units are given in the table below. Data Types With the commands you give parameters to the instrument and receive response values from the instrument. Unless explicitly specified these data are given in ASCII format. The following types of data are used: • Boolean data may only have the values 0 or 1. • Integer range is given for each individual command. • Float variables may be given in decimal or exponential writing (0.123 or 123E-3). All Float values conform to the 32 bit IEEE Standard, that is, all Float values are returned as 32-bit real values. • A string is contained between double quotes ("...") or single quotes (‘...’). When the instrument returns a string, it is always included in " " and terminated by . string is ascii data. A string is contained between double quotes ("...") or single quotes (‘...’). value is numeric data in integer (12), decimal (34.5) or ex- ponential format (67.8E-9). wsp is a white space. Unit Default Allowed Mnemonics meters M PM, NM, UM, MM, M decibel DB MDB, DB second S NS, US, MS, S decibel/1mW DBM MDBM, DBM Hertz HZ HZ, KHZ, MHZ, GHZ, THZ Watt Watt PW, NW, UW, MW, Watt meters per second M/S NM/S, UM/S, MM/S, M/S Table 2 Units and allowed Mnemonics

Introduction to Programming HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299 21 • When a register value is given or returned (for example *ESE), the decimal values for the single bits are added. For example, a value of nine means that bit 0 and bit 3 are set. • Larger blocks of data are given as Binary Blocks, preceded by “#”, terminated by ; represents the number of digits, represents the number of bytes, and is the data block. For example, for a Binary Block with 1 digit and 6 bytes this is: #16TRACES. Slot and Channel Numbers Each module is identified by a slot number and a channel number. For commands that require you to specify a channel, the slot number is represented by [n] in a command and the channel number is represented by [m]. The slot number represents the module’s position in the mainframe. These are: • from one to two for the HP 8163A, • from zero to four for the HP 8164A, and • from one to seventeen for the HP 8166A. These numbers are displayed on the front panel beside each module slot. NOTE The HP 8164A slot for back-loadable tunable laser modules is numbered zero. Channel numbers apply to modules that have two inputs/outputs, for example, the HP 81635A Dual Power Sensor. Modules with two channels, for example, the HP 81635A Dual Power Sensor, use the channel number to distinguish between these channels. NOTE The channel number of single channel modules is always one. For example, if you want to query slot 1, channel 2 with the command, “:SENSe[n]:[CHANnel[m]]:POWer:WAVelength?” on page 83, you should send the command: • :sens1:chan2:pow:wav? NOTE If you do not specify a slot or channel number, the lowest possible number is used as the default value. This means: • Slot 1 for the HP 8163A and HP 8166A mainframes. • Slot 0 for the HP 8164A mainframe. • Channel 1 for all channels.

Common Commands 22 HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299 Laser Selection Numbers The laser selection number, [l], identifies the upper or lower wavelength laser source for dual wavelength Laser Source modules and Return Loss modules with two internal laser sources. The lower wavelength source is denoted by 1. The upper wavelength source is denoted by 2. NOTE For Return Loss modules, 0 denotes the use of an external laser source as the input to your Return Loss module for the following commands: • “:SENSe[n]:[CHANnel[m]]:RETurnloss:CORRection:FPDelta[l]” on page 85, • “:SENSe[n]:[CHANnel[m]]:RETurnloss:CORRection:FPDelta[l]?” on page 85, • “:SENSe[n]:[CHANnel[m]]:RETurnloss:CORRection:REFLectance[l]” on page 85, and • “:SENSe[n]:[CHANnel[m]]:RETurnloss:CORRection:REFLectance[l]?” on page 86. Common Commands The IEEE 488.2 standard has a list of reserved commands, called common commands. Some of these commands must be implemented by any instrument using the standard, others are optional. Your instrument implements all the necessary commands, and some optional ones. This section describes the implemented commands.

HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299 23 Common Command Summary Table 3 gives a summary of the common commands. NOTE These commands are described in more detail in “IEEE-Common Commands” on page 45. Common Status Information There are three registers for the status information. Two of these are status- registers and one is an enable-registers. These registers conform to the IEEE Standard 488.2-1987. You can find further descriptions of these registers under *ESE, *ESR?, and *STB?. Command Parameter Function Page *CLS Clear Status Command page 45 *ESE Standard Event Status Enable Command page 45 *ESE? Standard Event Status Enable Query page 46 *ESR? Standard Event Status Register Query page 46 *IDN? Identification Query page 46 *OPC Operation Complete Command page 47 *OPC? Operation Complete Query page 47 *OPT? Options Query page 47 *RST Reset Command page 48 *STB? Read Status Byte Query page 48 *TST? Self Test Query page 49 *WAI Wait Command page 49 Table 3 Common Command Summary

Common Commands 24 HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299 Figure 2 shows how the Standard Event Status Enable Mask (SESEM) and the Standard Event Status Register (SESR) determine the Event Status Bit (ESB) of the Status Byte. The SESR contains the information about events that are not slot specific. For details of the function of each bit of the SESR, see “Standard Event Status Register” on page 29. The SESEM allows you to choose the event that may affect the ESB of the Status Byte. If you set a bit of the SESEM to zero, the corresponding event cannot affect the ESB. The default is for all the bits of the SESEM to be set to 0. The questionable and operation status systems set the Operational Status Bit (OSB) and the Questionable Status Bit (QSB). These status systems are described in “The Status Model” on page 25 and “Status Reporting – The STATus Subsystem” on page 50. NOTE Unused bits in any of the registers change to 0 when you read them. Figure 2 The Event Status Bit 0 1 2 3 4 5 6 7 *STB? returns the Status Byte Register Status OSB ESB QSB *ESR? returns the Standard Event Status Register 0 0 1 0 1 2 3 4 5 6 7 Event 1 0 0 0 0 0 Status Register 0 1 2 3 4 5 6 7 Event 1 1 1 1 1 1 Status Enable Mask *ESE sets the Standard Event Status Enable Mask & & & & & & & & OR Byte All bits shown as are unused

Introduction to Programming HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299 25 The Status Model Status Registers Each node of the status circuitry has three registers: • A condition register (CONDition), which contains the current status. This register is updated continuously. It is not changed by having its contents read. • The event register (EVENt), which contains details of any positive transitions in the corresponding condition register, that is, when a bit changes from 0 → 1. The contents of this register are cleared when it is read. The contents of any higher-level registers are affected with regard to the appropriate bit. • The enable register (ENABle), which enables changes in the event register to affect the next stage of registers. NOTE The event register is the only kind of register that can affect the next stage of registers. The structures of the Operational and Questionable Status Systems are similar. Figure 4 describe how the Questionable Status Bit (QSB) and the Operational Status Bit (OSB) of the Status Byte Register are determined. Figure 3 The Registers and Filters for a Node Enable Registers To the Condition Register of the Next Node Event Registers Condition Registers OR 1 1 1 1 1 A positive transition in the condition causes the corresponding bit of the to change from 0 → 1. corresponding event register register, when a bit changes from 0 → 1,

The Status Model 26 HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299 The Operational/Questionable Slot Status Event Register (OSSER/QSSER) contains the status of a particular module slot. A bit changes from 0 → 1 when an event occurs, for example, when a laser is switched on. For details of the function of each bit of these registers, see “Operation/Questionable Status Summary Register” on page 29 and “Operation/Questionable Status Summary Register” on page 29. The Operational/Questionable Slot Enable Status Mask (OSESM/QSESM) allows you to choose the events for each module slot that may affect the Operational/Questionable Status Event Register (see below). If you set a bit of the OSESM/QSESM to zero, the occurence of the corresponding event for this particular module slot cannot affect the Operational/Questionable Status Event Register. The default is for all the bits of the OSESM/QSESM to be set to 0. The Operational/Questionable Status Event Summary Register (OSESR/QSESR) summarizes the status of every module slot of your instrument. If, for any slot, any bit of the QSSER goes from 0 → 1 AND the corresponding bit of the QSSEM is 1at the same time, the QSESR bit representing that slot is set to 1. The Operational/Questionable Status Enable Summary Mask (OSESM/QSESM) allows you to choose the module slots that may affect the OSB/QSB of the Status Byte. If any bit of the QSESR goes from 0 → 1 AND the corresponding bit of the QSESM is 1at the same time, the QSB of the Status Byte is set to 1. If you set a bit of the OSESM/QSESM to zero, the corresponding module slot cannot affect the OSB/QSB. The default is for all the bits of the OSESM/QSESM to be set to 0. The Operational/Questionable Status Enable Summary Mask for the HP 8163A Lightwave Multimeter and the HP 8164A Lightwave Measurement System consists of one level. These are described in “The Operational/Questionable Status System for HP 8163A & HP 8164A” on page 27. As the HP 8166A Lightwave Multichannel System has 17 module slots, the Operational/Questionable Status Enable Summary Mask consists of two levels. This is described in “Status System for HP 8166A” on page 27. Status System for HP 8163A & HP 8164A The status system for the HP 8163A Lightwave Multimeter and the HP 8164A Lightwave Measurement System returns the status of 2 and 5 module slots respectively. The Operational/Questionable Status Summary Registers consist of

Introduction to Programming HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299 27 one level and are described by Figure 4. Any commands that require LEVel1 do not apply to these mainframes. Status System for HP 8166A The status system for the HP 8166A Lightwave Multichannel System returns the status of 17 module slots. The Operational/Questionable Status Summary Registers consists of two levels, as described by Figure 5. Module slots 1 to 14 affect the Level 0 summary register as described in Figure 4. Bit 0 of the Level 0 summary registers represents the summary of the status of Figure 4 The Operational/Questionable Status System for HP 8163A & HP 8164A Operational/Questionable Status Operational/Questionable Status Operational/Questionable Status Condition Summary Register Event Summary Register Enable Summary Mask Register Status Byte Status Byte Register Status Summary to next Operational/Questionable Operational/Questionable Operational/Questionable Slot Status Condition Slot Status Event Slot Status Enable Mask & &&& OR level to next for a positive & &&& OR level Slot 1 transition for a positive transition Register Register Register

The Status Model 28 HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299 module slots 15, 16, and 17. The Level 1 summary registers contain an individual summary for each of these module slots. Annotations Status Byte Register • Bit 3, the QSB, is built from the questionable event status register and its enable mask. • Bit 5, the ESB, is built from the SESR and its SESEM. • Bit 7, the OSB, is built from the operation event status register and its enable mask. • All other bits are unused, and therefore set to 0. Figure 5 The Operational/Questionable Status System for HP 8166A Operational/Questionable Status Operational/Questionable Status Operational/Questionable Status Condition Summary Register (Level 0) Event Summary Register (Level 0) Enable Summary Mask Register (Level 0) Status Byte Status Byte Register Status Summary to next & &&& OR level to next Operational/Questionable Operational/Questionable Operational/Questionable Slot Status Condition Slot Status Event Slot Status Enable Mask & &&& OR level to next for a positive & &&& OR level Status Summary Slot 15 transition for a positive transition for a positive transition Operational/Questionable Status Operational/Questionable Status Operational/Questionable Status Condition Summary Register (Level 1) Event Summary Register (Level 1) Enable Summary Mask Register Register Register Register (Level 1) for Level 1 for Level 0

Introduction to Programming HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299 29 Standard Event Status Register • Bit 0 is set if an operation complete event has been received since the last call to *ESR?. • Bit 1 is always 0 (no service request). • Bit 2 is set if a query error has been detected. • Bit 3 is set if a device dependent error has been detected. • Bit 4 is set if an execution error has been detected. • Bit 5 is set if a command error has been detected. • Bit 6 is always 0 (no service request). • Bit 7 is set for the first call of *ESR? after Power On. Operation/Questionable Status Summary • The Operation/Questionable Status Summary consist of a condition and an event register. • A "rising" bit in the condition register is copied to the event register. • A "falling" bit in the condition register has no effect on the event register. • Reading the condition register is non-destructive. • Reading the event register is destructive. • A summary of the event register and its enable mask is set in the status byte. Operation/Questionable Status Summary Register • Bits 0 to 4 are built from the OSSER/QSSER and the OSSEM/QSSEM. • A summary of the event register, the condition register and the enable mask is set in the status byte. Operation/Questionable Slot Status • The Operation/Questionable Slot Status consist of a condition and an event register. • A "rising" bit in the condition register is copied to the event register. • A "falling" bit in the condition register has no effect on the event register. • Reading the condition register is non-destructive. • Reading the event register is destructive. • A summary of the event register, the condition register and the enable mask is set in the status byte.

The Status Model 30 HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299 Operation Slot Status Register • Bit 0 is set if the laser is switched on. • Bit 1 is set if the Coherence Control is switched on. • Bit 3 is set if Power Meter zeroing or Tunable Laser module lambda zeroing is ongoing. • All other bits are unused, and therefore set to 0. Questionable Slot Status Register • Bit 0 is set if excessive power is set by the user for any source module or if excessive averaging time is set for any Power Meter. • Bit 1 is set if the last Power Meter zeroing or Tunable Laser module lambda zeroing failed. • Bit 2 is set if temperature is out of range. • Bit 3 is set if laser protection is switched on. • Bit 4 is set if the module has not settled. • Bit 5 is set if the module is out of specifications. • Bit 6 is set if ARA is recommended. • Bit 7 is set if the duty cycle is out of range. • All other bits are unused, and therefore set to 0. Status Command Summary *STB? returns status byte, value 0 .. +255 *ESE sets the standard event status enable mask, parameter 0 .. +255 *ESE? returns SESE, value 0 .. +255 *ESR? returns the standard event status register, value 0 .. +255 *OPC parses all program message units in the message queue. *OPC? returns 1 if all operations (scan trace printout, measurement) are com- pleted. Otherwise it returns 0. *CLS clears the status byte and SESR, and removes any entries from the error queue. *RST clears the error queue, loads the default setting, and restarts communi- cation. NOTE: *RST does NOT touch the STB or SESR. A running measure- ment is stopped. *TST? initiates an instrument selftest and returns the results as a 32 bit LONG.

Introduction to Programming HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299 31 Other Commands *OPT? returns the installed modules and the slots these modules are installed in: For example, *OPT? → 81682A, 81533B, 81532A, , Modules 81682A, 81533B, and 81532A are installed in slots 0 to 2 re- spectively. Slots 3 and 4 are empty. *WAI prevents the instrument from executing any further commands until the current command has finished executing. All pending operations are completed during the wait period. *IDN? identifies the instrument; returns the manufacturer, instrument model number, serial number, and firmware revision level.

The Status Model 32 HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299

& HP 8166A Lightwave Multichannel System User’s Guide, E1299 33 Specific Commands

& HP 8166A Lightwave Multichannel System User’s Guide, E1299 This chapter lists all the instrument specific commands relating to the HP 8163A Lightwave Multimeter and the HP 8164A Lightwave Measurement System, with a single-line description. Each of these summaries contains a page reference for more detailed information about the particular command later in this manual.

Specific Commands HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299 35 Specific Command Summary The commands are ordered in a command tree. Every command belongs to a node in this tree. The root nodes are also called the subsystems. A subsystem contains all commands belonging to a specific topic. In a subsystem there may be further subnodes. All the nodes have to be given with a command. For example in the command disp:brig • DISPlay is the subsystem containing all commands for controlling the display, • BRIGhtness is the command selecting brightness. NOTE If a command and a query are both available, the command ends /?. So, disp:brig/? means that disp:brig and disp:brig? are both available. Table 4 gives an overview of the command tree. You see the nodes, the subnodes, and the included commands. Command Description Page :DISPlay :BRIGhtness/? Changes or queries the current display brightness. 123 :CONTrast/? Changes or queries the current display contrast. 123 :ENABle/? Switches the display on or off or queries whether the display is on or off. 124 :FETCh[n][:CHANnel[m]][:SCALar] :POWer[:DC]? Returns a power value from a sensor. 70 :RETurnloss? Returns the current return loss value. 70 :RETurnloss? Returns a return loss value. 70 :INITiate[n]:[CHANnel[m]] [:IMMediate] Starts a measurement. 70 :CONTinuous/? Starts or Queries a single/continuous measurement. 71 :LOCK/? Switches the lock on/off or returns the current state of the lock. 65 :OUTPut[n][:CHANnel[m]] Table 4 Specific Command Summary

36 HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299 :CONNection/? Selects or returns Analog Output parameter. 86 :PATH/? Sets or returns the regulated path. 87 [:STATe]/? Sets a source’s output terminals to open or closed or returns the current status of a source’s output termi- nals. 87 :READ[n][:CHANnel[m]][:SCALar] :POWer[:DC]? Reads the current power value from a sensor. 71 :RETurnloss? Reads the current return loss value. 72 :RETurnloss? Returns the current return loss value. 72 :SENSe[n][:CHANnel[m]]:CORRection [:LOSS][:INPut][:MAGNitude]/? Sets or returns the value of correction data for a sen- sor. 72 :COLLECT:ZERO Executes a zero calibration of a sensor module. 73 :COLLECT:ZERO? Returns the current zero state of a sensor module. 73 :COLLECT:ZERO:ALL Executes a zero calibration of all sensor modules. 73 :SENSe[n][:CHANnel[m]]:FUNCtion :PARameter:LOGGing/? Sets or returns the number of samples and the aver- aging time, tavg, for logging. 74 :PARameter:MINMax/? Sets or returns the minmax mode and the window size. 75 :PARameter:STABility/? Sets or returns the total time, delay time and the av- eraging time, tavg, for stability. 76 :RESult? Returns the data array of the last function. 77 :STATe/? Enables/disables the function mode or returns whether the function mode is enabled. 77 :THReshold/? Sets or returns the threshold value and the start mode. 78 :SENSe[n][:CHANnel[m]]:POWer :ATIMe/? Sets or returns the average time of a sensor. 78 :RANGe[:UPPer]/? Sets or returns the most positive signal entry expect- ed for a sensor. 79 :RANGe:AUTO/? Sets or returns the range of a sensor to produce the most dynamic range without overloading. 79 :REFerence/? Sets or returns the reference level of a sensor. 80 UNIT/? Sets or returns the units used for absolute readings on a sensor. 82 :WAVelength/? Sets or returns the wavelength for a sensor. 83 :SENSe[n][:CHANnel[m]]:POWer:REFerence Command Description Page Table 4 Specific Command Summary (continued)

Specific Commands HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299 37 :DISPlay Sets the reference level for a sensor from the input power level. 81 :STATe/? Sets or returns whether sensor results are in relative or absolute units. 81 :STATe:RATio/? Sets or returns whether sensor results are displayed relative to a channel or to an absolute reference. 82 :SENSe[n][:CHANnel[m]]:RETurnloss:CALibration :FACTory 84 :REFLectance 84 :TERMination 84 :SENSe[n][:CHANnel[m]]:RETurnloss:CORRection :FPDelta[l]/? Sets or returns 85 :REFLectance[l]/? Sets or returns 85 :SENSe[n][:CHANnel[m]]:RETurnloss:CALibration :FACTory Selects the factory-set calibration values 84 :COLLect:REFLectance Sets the Reflection Reference calibration values to the values currently measured by the chosen return loss module 84 :COLLect:TERMination Sets the Reflection Reference calibration values to the values currently measured by the chosen return loss module 84 :SENSe[n][:CHANnel[m]]:RETurnloss:CORRection :FPDelta[n]/? Sets or returns the front panel delta, that is, the loss variation value due to the front panel connector 85 :REFLectance[n]/? Sets or returns Return Loss Reference, the return loss value of your reference reflector. 85 :SLOT[n] :EMPTy? Returns whether the module slot is empty. 65 :IDN? Returns information about the module. 66 :OPTions? Returns the module’s options. 66 :TST? Returns the latest selftest results for a module. 66 :SLOT[n][:HEAD[m]] :EMPTy? Returns whether an optical head is connected. 67 :IDN? Returns information about the optical head. 67 :OPTions? Returns the optical head’s options. 67 :TST? Returns the latest selftest results for an optical head. 68 Command Description Page Table 4 Specific Command Summary (continued)

38 HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299 [:SOURce[n]][:CHANnel[m]] :MODout/? Returns the mode of the modulation output. 91 [:SOURce[n]][:CHANnel[m]:]AM [:INTernal]:FREQuency[l]/? Sets or returns the frequency of an internal signal source. 88 :SOURce[l]/? Sets or returns a source for the modulating system. 89 :STATe[l]/? Turns Amplitude Modulation of a source on or off or returns whether Amplitude Modulation is on or off. 90 [:SOURce[n]][:CHANnel[m]:]POWer [:LEVel][:IMMediate][:AMPLitude] Sets the laser output power of a source. 94 [:LEVel][:IMMediate][:AMPLitude[l]]? Returns the laser output power of a source. 95 [:LEVel]:RISetime/? Sets or returns the laser rise time of a source. 95 :ATTenuation[l]/? Sets or returns the attenuation level for a source. 92 :STATe/? Sets or returns the state of the source output signal. 96 :UNIT/? Sets or returns the power units. 96 :WAVelength/? Sets or returns the wavelength source of a dual- wavelength source. 99 [:SOURce[n]][:CHANnel[m]:]POWer:ATTenuation :AUTO/? Selects Automatic or Manual Attenuation Mode for a source or returns the selected mode. 93 :DARK/? Enables/disables ‘dark’ position on a source or re- turns whether ‘dark’ position is active for a source. 93 [:SOURce[n]][:CHANnel[m]:]READout :DATA? Returns number of datapoints returned by the [:SOURce[n]][:CHANnel[m]]:READout:POINts? command. 98 :POINts? Returns the data as a binary stream from either a lambda logging operation or the maximum power the laser can produce at each wavelength. 98 [:SOURce[n]][:CHANnel[m]:]WAVelength [:CW|:FIXED] Sets the absolute wavelength of a source. 99 [:CW|:FIXED[l]]? Returns the absolute wavelength of a source. 99 :FREQuency/? Sets the frequency difference used to calculate a rel- ative wavelength for a source. 100 :REFerence? Returns the reference wavelength of a source. 101 [:SOURce[n]][:CHANnel[m]:]WAVelength:CORRection :ARA Realigns the laser cavity. 100 Command Description Page Table 4 Specific Command Summary (continued)

Specific Commands HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299 39 :ZERO Exexutes a wavelength zero. 100 [:SOURce[n]][:CHANnel[m]:]WAVelength:REFerence :DISPlay Sets the reference wavelength of a source to the val- ue of the output wavelength. 101 [:SOURce[n]][:CHANnel[m]:]WAVelength:SWEep :CYCLes/? Sets or returns the number of cycles. 101 :DWELl/? Sets or returns the dwell time. 102 :LLOGging/? Switches lambda logging on or off or queries the state of lambda logging. 103 :MODE/? Sets or returns the sweep mode. 103 :PMAX? Returns the highest permissible power for a wave- length sweep. 104 :REPeat/? Sets or returns the repeat mode. 104 :SPEed/? Sets or returns the speed for continuous sweeping. 105 :STARt/? Sets or returns the start point of the sweep. 105 :STOP/? Sets or returns the end point of the sweep. 106 [:STATe]/? Stops, starts, pauses or continues a wavelength sweep or returns the the state of a sweep. 106 [:SOURce[n]][:CHANnel[m]:]WAVelength:SWEep:STEP :NEXT Performs the next sweep step. 107 :PREVious Performs the previous sweep step again. 107 [:WIDTh]/? Sets or returns the width of the sweep step. 107 :SPECial :REBoot Reboots the mainframe and all modules. 68 :STATus[n] :PRESet Presets all Enable Registers. 54 :STATus:OPERation [:EVENt]? Returns the Operational Status Event Summary Reg- ister. 50 [:EVENt]:LEVel1? Returns the Operational Status Event Summary Reg- ister for slots 15 - 17 of the HP 8166A Lightwave Multichannel System. 52 :CONDition? Returns the Operational Status Condition Summary Register. 51 :CONDition:LEVel1? Returns the Operational Status Condition Summary Register for slots 15 - 17 of the HP 8166A Light- wave Multichannel System. 52 Command Description Page Table 4 Specific Command Summary (continued)

40 HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299 :ENABle/? Sets or queries the Operational Status Enable Sum- mary Mask. 51 :ENABle:LEVel1/? Sets or queries the Operational Status Enable Sum- mary Mask for slots 15 - 17 of the HP 8166A Light- wave Multichannel System. 52 :STATusn:OPERation [:EVENt]? Returns the Operational Slot Status Event Register for slot n. 53 :CONDition? Returns the Operational Slot Status Condition Reg- ister for slot n. 53 :ENABle/? Sets or queries the Operation Slot Status Enable Mask for slot n. 54 :STATus:QUEStionable [:EVENt]? Returns the Questionable Status Event Summary Register. 55 [:EVENt]:LEVel1? Returns the Questionable Status Event Summary Register for slots 15 - 17 of the HP 8166A Light- wave Multichannel System. 57 :CONDition? Returns the Questionable Status Condition Summa- ry Register. 56 :CONDition:LEVel1? Returns the Questionable Status Condition Summa- ry Register for slots 15 - 17 of the HP 8166A Light- wave Multichannel System. 57 :ENABle/? Sets or queries the Questionable Status Enable Sum- mary Mask. 56 :ENABle:LEVel1/? Sets or queries the Questionable Status Enable Sum- mary Mask for slots 15 - 17 of the HP 8166A Light- wave Multichannel System. 57 :STATusn:QUEStionable [:EVENt]? Returns the Questionable Slot Status Event Register for slot n. 58 :CONDition? Returns the Questionable Slot Status Condition Reg- ister for slot n. 58 :ENABle/? Sets or queries the Questionable Slot Status En- able Mask for slot n. 59 :SYSTem :DATE/? Sets or returns the instrument’s internal date. 59 :ERRor? Returns the contents of the instrument’s error queue.60 :HELP:HEADers? Returns a list of GPIB commands. 60 :PRESet Sets all parameters to their default values. 61 :TIME/? Sets or returns the instrument’s internal time. 61 Command Description Page Table 4 Specific Command Summary (continued)

Specific Commands HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299 41 :VERSion? Returns the instrument’s SCPI version. 61 :SYSTem:COMMunicate:GPIB [:SELF]:ADDress/? Sets or returns the GPIB address. 62 :TRIGger Generates a hardware trigger. 109, 115 :CONFiguration/? Sets or returns trigger configuration. 113 :TRIGger:CONFiguration :EXTended/? Sets or returns extended trigger configuration. 115 :FPEDal/? Enables/disables the Input Trigger connector to be triggered using a Foot Pedal or returns whether the Input Trigger connector can be triggered using a Foot Pedal. 115 :TRIGger[n][CHANnel[m]] :INPut/? Sets or returns the incoming trigger response . 110 :OUTPut/? Sets or returns the outgoing trigger response. 112 Command Description Page Table 4 Specific Command Summary (continued)

42 HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299

& HP 8166A Lightwave Multichannel System User’s Guide, E1299 43 Instrument Setup and Status

44 HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299 This chapter gives descriptions of commands that you can use when setting up your instrument. The commands are split into the following separate subsytems: • IEEE specific commands that were introduced in “Common Commands” on page 22. • STATus subsystem commands that relate to the status model. • SYSTem subsystem commands that control the serial interface and internal data.

HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299 45 IEEE-Common Commands “Common Commands” on page 22 gave a brief introduction to the IEEE- common commands which can be used with the instruments. This section gives fuller descriptions of each of these commands. command: *CLS syntax: *CLS description: The CLear Status command *CLS clears the following: • Error queue • Standard event status register (SESR) • Status byte register (STB) After the *CLS command the instrument is left waiting for the next command. The instru- ment setting is unaltered by the command, although *OPC/*OPC? actions are cancelled. parameters: none response: none example: *CLS command: *ESE syntax: *ESE 0 ≤ value ≤ 255 description: The standard Event Status Enable command (*ESE) sets bits in the Standard Event Status Enable Mask (SESEM) that enable the corresponding bits in the standard event status reg- ister (SESR). The register is cleared: • at power-on, • by sending a value of zero. The register is not changed by the *RST and *CLS commands. parameters: The bit value for the register (a 16-bit signed integer value): Bit Mnemonic Decimal Value 7 (MSB) Power On 128 6 Not Used 0 5 Command Error 32 4 Execution Error 16 3 Device Dependent Error 8 2 Query Error 4 1 Not Used 0 0 (LSB) Operation Complete 1 response: none example: *ESE 21

IEEE-Common Commands 46 HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299 command: *ESE? syntax: *ESE? description: The standard Event Status Enable query *ESE? returns the contents of the Standard Event Status Enable Mask (see *ESE for information on this register). parameters: none response: The bit value for the register (a 16-bit signed integer value). example: *ESE? → 21 command: *ESR? syntax: *ESR? description: The standard Event Status Register query *ESR? returns the contents of the Standard Event Status Register. The register is cleared after being read. parameters none response The bit value for the register (a 16-bit signed integer value): Bit Mnemonic Decimal Value 7 (MSB) Power On 128 6 Not used 0 5 Command Error 32 4 Execution Error 16 3 Device Dependent Error 8 2 Query Error 4 1 Not used 0 0 (LSB) Operation Complete 1 example: *ESR? → 21 command: *IDN? syntax: *IDN? description: The IDeNtification query *IDN? gets the instrument identification over the interface. parameters: none response: The identification terminated by : For example. HEWLETT-PACKARD mmmm ssssssss rrrrrrrrrr manufacturer instrument model number (for example 8164A) serial number firmware revision level NOTE The HP 8163A, HP8164A, and HP8166A will always return HEWLETT-PACKARD as the manufacturer. This will not be affected by the transition of these instruments to Agilent Technologies. This will allow programs that use this string to continue functioning. See “:SLOT[n]:HEAD[n]:IDN?” on page 67 for information on module identity strings. example: *IDN? → HEWLETT-PACKARD,mmmm,ssssssss,rrrrrrrrrr

HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299 47 command: *OPC syntax: *OPC description: The instrument parses and executes all program message units in the input queue and sets the operation complete bit in the standard event status register (SESR). This command can be used to avoid filling the input queue before the previous commands have finished executing. The following actions cancel the *OPC command (and put the instrument into Operation Complete, Command Idle State): • Power-on • the Device Clear Active State is asserted on the interface. • *CLS • *RST parameters: none response: none example: *OPC command: *OPC? syntax: *OPC? description: The OPeration Complete query *OPC? parses all program message units in the input queue, sets the operation complete bit in the Standard Event Status register, and places an ASCII ’1’ in the output queue, when the contents of the input queue have been processed. The following actions cancel the *OPC? query (and put the instrument into Operation Complete, Command Idle State): • Power-on • the Device Clear Active State is asserted on the interface. • *CLS • *RST parameters: none response: 1 is always returned. example: *OPC? → 1 command: *OPT? syntax: *OPT? description: The OPTions query *OPT? returns the modules installed in your instrument. parameters: none response: Returns the part number of all installed modules, separated by commas. Slots are listed starting with the lowest slot number, that is, slot 0 for the HP 8164A and Slot 1 for the HP 8163A and HP 8166A. If any slot is empty or not recognised, two spaces are inserted instead of the module’s part number. See the example below, where slots 1 and 4 are empty. example: *OPT? → 81682A , , 81533B, 81532A,

IEEE-Common Commands 48 HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299 command: *RST syntax: *RST description: The ReSeT command *RST sets the mainframe and all modules to the reset setting (stan- dard setting) stored internally. Pending *OPC? actions are cancelled. The instrument is placed in the idle state awaiting a command. The *RST command clears the error queue. The *RST command is equivalent to the *CLS command AND the syst:preset com- mand. The following are not changed: • GPIB (interface) state • Instrument interface address • Output queue • Service request enable register (SRE) • Standard Event Status Enable Mask (SESEM) parameters: none response: none example: *RST command: *STB? syntax: *STB? description: The STatus Byte query *STB? returns the contents of the Status Byte register. parameters: none response: The bit value for the register (a 16-bit signed integer value): Bit Mnemonic Decimal Value 7 (MSB) Operation Status 128 6 Not used 0 5 Event Status Bit 32 4 Not used 0 3 Questionable Status 8 2 Not used 0 1 Not used 0 0 Not used 0 example: *STB? → 128

HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299 49 command: *TST? syntax: *TST? description: The self-TeST query *TST? makes the instrument perform a self-test and place the results of the test in the output queue. If the self-test fails, the results are also put in the error queue. We recommend that you read self-test results from the error queue. No further commands are allowed while the test is running. After the self-test the instrument is re- turned to the setting that was active at the time the self-test query was processed. The self- test does not require operator interaction beyond sending the *TST? query. parameters: none response: The sum of the results for the individual tests (a 32-bit signed integer value, where 0 ≤ value ≤ 4294967296): Bits Mnemonic Decimal Value 31 Selftest failed on Mainframe A negative value 18 - 30 Not used 0 17 Selftest failed on Slot 17 131072 16 Selftest failed on Slot 16 65536 15 Selftest failed on Slot 15 32768 14 Selftest failed on Slot 14 16384 13 Selftest failed on Slot 13 8192 12 Selftest failed on Slot 12 4096 11 Selftest failed on Slot 11 2048 10 Selftest failed on Slot 10 1024 9 Selftest failed on Slot 9 512 8 Selftest failed on Slot 8 256 7 Selftest failed on Slot 7 128 6 Selftest failed on Slot 6 64 5 Selftest failed on Slot 5 32 4 Selftest failed on Slot 4 16 3 Selftest failed on Slot 3 8 2 Selftest failed on Slot 2 4 1 Selftest failed on Slot 1 2 0 Selftest failed on Slot 0 1 If 16 is returned, the module in slot 4 has failed. If 18 is returned, the modules in slots 1 and 4 have failed. A value of zero indicates no errors. example: *TST? → 0 command: *WAI syntax: *WAI description: The WAIt command prevents the instrument from executing any further commands until the current command has finished executing. All pending operations are completed during the wait period. parameters: none response: none example: *WAI

Status Reporting – The STATus Subsystem 50 HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299 Status Reporting – The STATus Subsystem The Status subsystem allows you to return and set details from the Status Model. For more details, see “The Status Model” on page 25. command: :STATus:OPERation[:EVENt][:LEVel0]? syntax: :STATus:OPERation[:EVENt][:LEVel0]? description: Returns the Operational Status Event Summary Register (OSESR). parameters: none response: The sum of the results for the slots (a 16-bit signed integer value, where 0 ≤ value ≤ 32767): Bits Mnemonics Decimal Value HP 8163A HP 8164A HP 8166A 15 Not used Not used Not used 0 14 Not used Not used Slot 14 Summary 16384 13 Not used Not used Slot 13 Summary 8192 12 Not used Not used Slot 12 Summary 4096 11 Not used Not used Slot 11 Summary 2048 10 Not used Not used Slot 10 Summary 1024 9 Not used Not used Slot 9 Summary 512 8 Not used Not used Slot 8 Summary 256 7 Not used Not used Slot 7 Summary 128 6 Not used Not used Slot 6 Summary 64 5 Not used Not used Slot 5 Summary 32 4 Not used Slot 4 Summary Slot 4 Summary 16 3 Not used Slot 3 Summary Slot 3 Summary 8 2 Slot 2 Summary Slot 2 Summary Slot 2 Summary 4 1 Slot 1 Summary Slot 1 Summary Slot 1 Summary 2 0 Not used Slot 0 Summary Level 1 Summary 1 example: stat:oper? → +0

Instrument Setup and Status HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299 51 command: :STATus:OPERation:CONDition[:LEVel0]? syntax: :STATus:OPERation:CONDition[:LEVel0]? description: Reads the Operational Status Condition Summary Register. parameters: none response: The sum of the results for the individual slots (a 16-bit signed integer value, where 0 ≤ val- ue ≤ 32767): Bits Mnemonics Decimal Value HP 8163A HP 8164A HP 8166A 15 Not used Not used Not used 0 14 Not used Not used Slot 14 Summary 16384 13 Not used Not used Slot 13 Summary 8192 12 Not used Not used Slot 12 Summary 4096 11 Not used Not used Slot 11 Summary 2048 10 Not used Not used Slot 10 Summary 1024 9 Not used Not used Slot 9 Summary 512 8 Not used Not used Slot 8 Summary 256 7 Not used Not used Slot 7 Summary 128 6 Not used Not used Slot 6 Summary 64 5 Not used Not used Slot 5 Summary 32 4 Not used Slot 4 Summary Slot 4 Summary 16 3 Not used Slot 3 Summary Slot 3 Summary 8 2 Slot 2 Summary Slot 2 Summary Slot 2 Summary 4 1 Slot 1 Summary Slot 1 Summary Slot 1 Summary 2 0 Not used Slot 0 Summary Level 1 Summary 1 example: stat:oper:cond? → +0 command: :STATus:OPERation:ENABle[:LEVel0] syntax: :STATus:OPERation:ENABle[:LEVel0] description: Sets the bits in the Operational Status Enable Summary Mask (OSESM) that enable the contents of the OSESR to affect the Status Byte (STB). Setting a bit in this register to 1 enables the corresponding bit in the OSESR to affect bit 7 of the Status Byte. parameters: The bit value for the OSESM as a 16-bit signed integer value (0 .. +32767) The default value is 0. response: none example: stat:oper:enab 128 command: :STATus:OPERation:ENABle[:LEVel0]? syntax: :STATus:OPERation:ENABle[:LEVel0]? description: Returns the OSESM for the OSESR parameters: none response: The bit value for the operation enable mask as a 16-bit signed integer value (0 .. +32767) example: stat:oper:enab? → +128

Status Reporting – The STATus Subsystem 52 HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299 command: :STATus:OPERation[:EVENt]:LEVel1? syntax: :STATus:OPERation[:EVENt]:LEVel1? description: Returns the Operational Status Event Summary Register (OSESR) for slots 15 to 17 of the HP 8166A Lightwave Multichannel System. parameters: none response: The sum of the results for the slots (a 16-bit signed integer value, where 0 ≤ value ≤ 32767): Bits Mnemonics Decimal Value HP 8166A 15-4 Not used 0 3 Slot 17 Summary 8 2 Slot 16 Summary 4 1 Slot 15 Summary 2 0 Not used 0 example: stat:oper:level1? → +0 command: :STATus:OPERation:CONDition:LEVel1? syntax: :STATus:OPERation:CONDition:LEVel1? description: Returns the Operational Status Condition Summary Register for slots 15 to 17 of the HP 8166A Lightwave Multichannel System. parameters: none response: The sum of the results for slots 15 to 17 (a 16-bit signed integer value, where 0 ≤ value ≤ 32767): Bits Mnemonics Decimal Value HP 8166A 15-4 Not used 0 3 Slot 17 Summary 8 2 Slot 16 Summary 4 1 Slot 15 Summary 2 0 Not used 0 example: stat:oper:cond:level1? → +0 command: :STATus:OPERation:ENABle:LEVel1 syntax: :STATus:OPERation:ENABle:LEVel1 description: Sets the bits in the Operational Status Enable Summary Mask (OSESM) that enable the contents of the OSESR for slots 15 - 17 of the HP 8166A Lightwave Measurement System to affect the Status Byte (STB). Setting a bit in this register to 1 enables the corresponding bit in the OSESR for slots 15 - 17 of the HP 8166A Lightwave Measurement System to affect bit 7 of the Status Byte. parameters: The bit value for the OSESM as a 16-bit signed integer value (0 .. +32767) The default value is 0. response: none example: stat:oper:enab:level1 128

Instrument Setup and Status HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299 53 command: :STATus:OPERation:ENABle:LEVel1? syntax: :STATus:OPERation:ENABle:LEVel1? description: Returns the OSESM for the OSESR for slots 15 - 17 of the HP 8166A Lightwave Measure- ment System parameters: none response: The bit value for the operation enable mask as a 16-bit signed integer value (0 .. +32767) example: stat:oper:enab:level1? → +128 command: :STATusn:OPERation[:EVENt]? syntax: :STATusn:OPERation[:EVENt]? description: Returns the Operational Slot Status Event Register (OSSER) of slot n. parameters: none response: The results for the individual slot events (a 16-bit signed integer value, where 0 ≤ value ≤ 32767): Bit 4-15 3 2 1 0 Mnemonic Not used Slot n: Zeroing started Not used Slot n: Coherence Control has been switched on Slot n: Laser has been switched on Decimal Value 0 8 0 2 1 example: stat1:oper? → +0 command: :STATusn:OPERation:CONDition? syntax: :STATusn:OPERation:CONDition? description: Returns the Operational Slot Status Condition Register of slot n. parameters: none response: The results for the individual slot events (a 16-bit signed integer value, where 0 ≤ value ≤ 32767): Bit 4-15 3 2 1 0 Mnemonic Not used Slot n: Zeroing ongoing Not used Slot n: Coherence Control is switched on Slot n: Laser is switched on Decimal Value 0 8 0 2 1 example: stat1:oper:cond? → +0

Status Reporting – The STATus Subsystem 54 HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299 command: :STATusn:OPERation:ENABle syntax: :STATusn:OPERation:ENABle description: Sets the bits in the Operation Slot Status Enable Mask (OSSEM) for slot n that enable the contents of the Operation Slot Status Event Register (OSSER) for slot n to affect the OS- ESR. Setting a bit in this register to 1 enables the corresponding bit in the OSSER for slot n to affect bit n of the OSESR. parameters: The bit value for the OSSEM as a 16-bit signed integer value (0 .. +32767) response: none example: stat:oper:enab 128 command: :STATusn:OPERation:ENABle? syntax: :STATusn:OPERation:ENABle? description: Returns the OSSEM of slot n parameters: none response: The bit value for the OSSEM as a 16-bit signed integer value (0 .. +32767) example: stat:oper:enab? → +128 command: :STATus:PRESet syntax: :STATus:PRESet description: Presets all bits in all the enable masks for both the OPERation and QUEStionable status systems to 0, that is, OSSEM, QSSEM, OSESM, and QSESM. parameters: none response: none example: stat:pres

Instrument Setup and Status HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299 55 command: :STATus:QUEStionable[:EVENt][:LEVel0]? syntax: :STATus:QUEStionable[:EVENt][:LEVel0]? description: Returns the Questionable Status Event Summary Register (QSESR). parameters: none response: The sum of the results for the QSESR as a 16-bit signed integer value (0 .. +32767) Bits Mnemonics Decimal Value HP 8163A HP 8164A HP 8166A 15 Not used Not used Not used 0 14 Not used Not used Slot 14 Summary 16384 13 Not used Not used Slot 13 Summary 8192 12 Not used Not used Slot 12 Summary 4096 11 Not used Not used Slot 11 Summary 2048 10 Not used Not used Slot 10 Summary 1024 9 Not used Not used Slot 9 Summary 512 8 Not used Not used Slot 8 Summary 256 7 Not used Not used Slot 7 Summary 128 6 Not used Not used Slot 6 Summary 64 5 Not used Not used Slot 5 Summary 32 4 Not used Slot 4 Summary Slot 4 Summary 16 3 Not used Slot 3 Summary Slot 3 Summary 8 2 Slot 2 Summary Slot 2 Summary Slot 2 Summary 4 1 Slot 1 Summary Slot 1 Summary Slot 1 Summary 2 0 Not used Slot 0 Summary Level 1 Summary 1 example: stat:ques? → +0

Status Reporting – The STATus Subsystem 56 HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299 command: :STATus:QUEStionable:CONDition[:LEVel0]? syntax: :STATus:QUEStionable:CONDition[:LEVel0]? description: Returns the Questionable Status Condition Summary Register. parameters: none response: The sum of the results for the Questionable Status Condition Summary Register as a 16- bit signed integer value (0 .. +32767) Bits Mnemonics Decimal Value HP 8163A HP 8164A HP 8166A 15 Not used Not used Not used 0 14 Not used Not used Slot 14 Summary 16384 13 Not used Not used Slot 13 Summary 8192 12 Not used Not used Slot 12 Summary 4096 11 Not used Not used Slot 11 Summary 2048 10 Not used Not used Slot 10 Summary 1024 9 Not used Not used Slot 9 Summary 512 8 Not used Not used Slot 8 Summary 256 7 Not used Not used Slot 7 Summary 128 6 Not used Not used Slot 6 Summary 64 5 Not used Not used Slot 5 Summary 32 4 Not used Slot 4 Summary Slot 4 Summary 16 3 Not used Slot 3 Summary Slot 3 Summary 8 2 Slot 2 Summary Slot 2 Summary Slot 2 Summary 4 1 Slot 1 Summary Slot 1 Summary Slot 1 Summary 2 0 Not used Slot 0 Summary Level 1 Summary 1 example: stat:ques:cond? → +0 command: :STATus:QUEStionable:ENABle[:LEVel0] syntax: :STATus:QUEStionable:ENABle[:LEVel0] description: Sets the bits in the Questionable Status Enable Summary Mask (QSESM) that enable the contents of the QSESR to affect the Status Byte (STB). Setting a bit in this register to 1 enables the corresponding bit in the QSESR to affect bit 3 of the Status Byte. parameters: The bit value for the questionable enable mask as a 16-bit signed integer value (0 .. +32767) The default value is 0. response: none example: stat:ques:enab 128 command: :STATus:QUEStionable:ENABle[:LEVel0]? syntax: :STATus:QUEStionable:ENABle[:LEVel0]? description: Returns the QSESM for the event register parameters: none response: The bit value for the QSEM as a 16-bit signed integer value (0 .. +32767) example: stat:ques:enab? → +128

Instrument Setup and Status HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299 57 command: :STATus:QUEStionable[:EVENt]:LEVel1? syntax: :STATus:QUEStionable[:EVENt]:LEVel1? description: Returns the Questionable Status Event Summary Register (QSESR) for slots 15 to 17 of the HP 8166A Lightwave Multichannel System. parameters: none response: The sum of the results for the slots (a 16-bit signed integer value, where 0 ≤ value ≤ 32767): Bits Mnemonics Decimal Value HP 8166A 15-4 Not used 0 3 Slot 17 Summary 8 2 Slot 16 Summary 4 1 Slot 15 Summary 2 0 Not used 0 example: stat:ques:level1? → +0 command: :STATus:QUEStionable:CONDition:LEVel1? syntax: :STATus:QUEStionable:CONDition:LEVel1? description: Returns the Questionable Status Condition Summary Register for slots 15 to 17 of the HP 8166A Lightwave Multichannel System. parameters: none response: The sum of the results for the slots (a 16-bit signed integer value, where 0 ≤ value ≤ 32767): Bits Mnemonics Decimal Value HP 8166A 15-4 Not used 0 3 Slot 17 Summary 8 2 Slot 16 Summary 4 1 Slot 15 Summary 2 0 Not used 0 example: stat:ques:cond:level1? → +0 command: :STATus:QUEStionable:ENABle:LEVel1 syntax: :STATus:QUEStionable:ENABle:LEVel1 description: Sets the bits in the Questionable Status Enable Summary Mask (QSESM) that enable the contents of the QSESR for slots 15 - 17 of the HP 8166A Lightwave Measurement Sys- tem to affect the Status Byte (STB). Setting a bit in this register to 1 enables the corresponding bit in the OSESR for slots 15 - 17 of the HP 8166A Lightwave Measurement System to affect bit 7 of the Status Byte. parameters: The bit value for the QSESM as a 16-bit signed integer value (0 .. +32767) The default value is 0. response: none example: stat:oper:enab:level1 128

Status Reporting – The STATus Subsystem 58 HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299 command: :STATus:QUEStionable:ENABle:LEVel1? syntax: :STATus:QUEStionable:ENABle:LEVel1? description: Returns the QSESM for the QSESR for slots 15 - 17 of the HP 8166A Lightwave Mea- surement System parameters: none response: The bit value for the QSESM as a 16-bit signed integer value (0 .. +32767) example: stat:oper:enab:level1? → +128 command: :STATusn:QUEStionable[:EVENt]? syntax: :STATusn:QUEStionable[:EVENt]? description: Returns the questionable status of slot n - the Questionable Slot Status Event Register (QSSER). parameters: none response: The results for the individual slot events (a 16-bit signed integer value, where 0 ≤ value ≤ 32767): Bit 8-15 7 6 5 4 3 2 1 0 Mnemonic Not used Slot n: Duty cycle has been out of range Slot n: ARA has been recommended Slot n: Module has been out of specification Slot n: Module has settled unsuccessfully Slot n: Laser protection has been on Slot n: Temperature has been out of range Slot n: A Zeroing operation has failed Slot n: Excessive Value has occurred Decimal Value 0 128 64 32 16 8 4 2 1 Every nth bit is the summary of slot n. example: stat1:oper? → +0 command: :STATusn:QUEStionable:CONDition? syntax: :STATusn:QUEStionable:CONDition? description: Returns the Questionable Slot Status Condition Register for slot n. parameters: none response: The results for the individual slot events (a 16-bit signed integer value, where 0 ≤ value ≤ 32767): Bit 8-15 7 6 5 4 3 2 1 0 Mnemonic Not used Slot n: Duty cycle is out of range Slot n: ARA recommended Slot n: Module is out of specification Slot n: Module has not settled Slot n: Laser protection on Slot n: Temperature out of range Slot n: Zeroing failed Slot n: Excessive Value Decimal Value 0 128 64 32 16 8 4 2 1 Every nth bit is the summary of slot n. example: stat1:ques:cond? → +0

Instrument Setup and Status HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299 59 Interface/Instrument Behaviour Settings – The SYSTem Subsystem The SYSTem subsystem lets you control the instrument’s serial interface. You can also control some internal data (like date, time, and so on). command: :STATusn:QUEStionable:ENABle syntax: :STATusn:QUEStionable:ENABle description: Sets the bits in the Questionable Slot Status Enable Mask (QSSEM) for slot n that enable the contents of the Questionable Slot Status Register (QSSR) for slot n to affect the QS- ESR. Setting a bit in this register to 1 enables the corresponding bit in the QSSER for slot n to affect bit n of the QSESR. parameters: The bit value for the QSSEM as a 16-bit signed integer value (0 .. +32767) response: none example: stat:ques:enab 128 command: :STATusn:QUEStionable:ENABle? syntax: :STATusn:QUEStionable:ENABle? description: Returns the QSSEM for slot n parameters: none response: The bit value for the QSSEM as a 16-bit signed integer value (0 .. +32767) example: stat:ques:enab? → +128 command: :SYSTem:DATE syntax: :SYSTem:DATE,, description: Sets the instrument’s internal date. parameters: • the first value is the year (four digits), • the second value is the month, and • the third value is the day. response: none example: syst:date 1999, 1, 12

Interface/Instrument Behaviour Settings – The SYSTem Subsystem 60 HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299 command: :SYSTem:DATE? syntax: :SYSTem:DATE? description: Returns the instrument’s internal date. parameters: none response: The date in the format year, month, day (16-bit signed integer values) example: syst:date? → +1999,+1,+12 command: :SYSTem:ERRor? syntax: :SYSTem:ERRor? description: Returns the next error from the error queue (see “The Error Queue” on page 18). Each error has the error code and a short description of the error, separated by a comma, for example 0, "No error". Error codes are numbers in the range -32768 and +32767. Negative error numbers are defined by the SCPI standard. Positive error numbers are de- vice dependent. parameters: none response: The number of the latest error, and its meaning. example: syst:err? → -113,"Undefined header" command: :SYSTem:HELP:HEADers? syntax: :SYSTem:HELP:HEADers? description: Returns a list of GPIB commands. parameters: none response: Returns a list of GPIB commands example: syst:help:head? → Returns a list of all GPIB commands

Instrument Setup and Status HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299 61 command: :SYSTem:PRESet syntax: :SYSTem:PRESet description: Sets the mainframe and all installed modules to their standard settings. This command has the same function as the Preset hardkey. The following are not affected by this command: • the GPIB (interface) state, • the backlight and contrast of the display, • the interface address, • the output and error queues, • the Service Request Enable register (SRE), • the Status Byte (STB), • the Standard Event Status Enable Mask (SESEM), and • the Standard Event Status Register (SESR). parameters: none response: none example: SYST:PRES command: :SYSTem:TIME syntax: :SYSTem:TIME,, description: Sets the instrument’s internal time. parameters: • the first value is the hour (0 .. 23), • the second value is the minute, and • the third value is the seconds. response: none example: syst:time 20,15,30 command: :SYSTem:TIME? syntax: :SYSTem:TIME? description: Returns the instrument’s internal time. parameters: none response: The time in the format hour, minute, second. Hours are counted 0...23 (16-bit signed inte- ger values). example: syst:time? → +20,+15,+30 command: :SYSTem:VERSion? syntax: :SYSTem:VERSion? description: Returns the SCPI revision to which the instrument complies. parameters: none response: The revision year and number. example: syst:vers? → 1995.0

Interface/Instrument Behaviour Settings – The SYSTem Subsystem 62 HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299 command: :SYSTem:COMMunicate:GPIB[:SELF]:ADDRess syntax: :SYSTem:COMMunicate:GPIB[:SELF]:ADDRess description: Sets the GPIB address. parameters: The GPIB Address response: none example: SYST:COMM:GPIB:ADDR 20 command: :SYSTem:COMMunicate:GPIB[:SELF]:ADDRess? syntax: :SYSTem:COMMunicate:GPIB[:SELF]:ADDRess? description: Returns the GPIB address. parameters: none response: The GPIB Address example: SYST:COMM:GPIB:ADDR? → +20

& HP 8166A Lightwave Multichannel System User’s Guide, E1299 63 Measurement Operations & Settings

64 HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299 This chapter gives descriptions of commands that you can use when you are setting up or performing measurements. The commands are split up into the following subsystems: • Root layer commands that take power measurements, configures triggering, and return information about the mainframe and it’s slots • SENSe subsystem commands that control Power Sensors, Optical Head Interface Modules, and Return Loss Modules. • SOURce subsystem commands that control Laser Source modules, DFB source modules, Tunable Laser modules, and Return Loss Modules with internal laser sources. • TRIGger subsystem commands that control triggering.

Measurement Operations & Settings HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299 65 Root Layer Command The commands in the Slot subsystem allow you to query the following: • a particular slot, for example, using slot1:empt?, • or, an Optical Head attached to an Optical Head Interface Module, for example, an Optical Head Interface Module in slot1 with an Optical Head attached to channel 2, using slot1:head2:empt?. command: :LOCK syntax: :LOCK, description: Switches the lock off and on. High power lasers cannot be switched on, if you switch the lock on. High power lasers are switched off immediately when you switch the lock on. parameters: A boolean value: 0 or OFF: switch lock off 1 or ON: switch lock on is the four-figure lock password. response: none example: lock 1,1234 - 1234 is the default password command: :LOCK? syntax: :LOCK? description: Returns the current state of the lock. parameters: none response: A boolean value: 0: lock is switched off 1: lock is switched on example: lock? → 1 command: :SLOT[n]:EMPTy? syntax: :SLOT[n]:EMPTy? description: Returns whether the module slot is empty. parameters: none response: A boolean value: 0: there is a module in the slot 1: the module slot is empty examples: slot1:empt? → 0 There is a module in slot1 affects: Independent of module type

Root Layer Command 66 HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299 command: :SLOT[n]:IDN? syntax: :SLOT[n]:IDN? description: Returns information about the module. parameters: none response: HEWLETT-PACKARD: mmmm: ssssssss: rrrrrrrrrr: manufacturer instrument model number (for example 81533B) serial number date of firmware revision example: slot1:idn? → HEWLETT-PACKARD, 81533B,3411G06054,07-Aug-98 NOTE • The HP 81640A/80A/82A/89A Tunable Laser modules will always return HEWLETT-PACKARD as the manufacturer. • All other HP 8163A Series modules return Agilent Technologies as the manufacturer. • The HP 8153A Series modules will always return HEWLETT-PACKARD as the manufacturer. See “*IDN?” on page 46 for information on mainframe identity strings. affects: Independent of module type command: :SLOT[n]:OPTions? syntax: :SLOT[n]:OPTions? description: Returns information about a module’s options. parameters: none response: A string. example: slot1:opt? → NO CONNECTOR OPTION, NO INSTRUMENT OPTIONS affects: Independent of module type command: :SLOT[n]:TST? syntax: :SLOT[n]:TST? description: Returns the latest selftest results for a module. NOTE This command does not perform a selftest. Use selfTeST command, *TST? on page 59, to perform a selftest. parameters: none response: Returns an error code and a short description of the error. example: slot:tst? → +0,"self test OK" affects: Independent of module type

Measurement Operations & Settings HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299 67 command: :SLOT[n]:HEAD[n]:EMPTy? syntax: :SLOT[n]:HEAD[n]:EMPTy? description: Returns whether an optical head is connected. parameters: none response: A boolean value: 0: there is a module in the slot 1: the module slot is empty examples: slot1:head:empt? → 0 An optical head is connected to the optical head interface module in slot 1 NOTE • All other HP 8163A Series Optical Heads return Agilent Technologies as the manufacturer. • The HP 8153A Series Optical Heads will always return HEWLETT-PACKARD as the manufacturer. See “*IDN?” on page 46 for information on mainframe identity strings. affects: Optical heads command: :SLOT[n]:HEAD[n]:IDN? syntax: :SLOT[n]:HEAD[n]:IDN? description: Returns information about the optical head. parameters: none response: HEWLETT-PACKARD: mmmm: ssssssss: rrrrrrrrrr: manufacturer instrument model number (for example 81520A) serial number date of firmware revision example: slot1:head:idn? → HEWLETT-PACKARD, 81520A,3411G06054,07-Aug-98 affects: Optical heads command: :SLOT[n]:HEAD[m]:OPTions? syntax: :SLOT[n]:HEAD[m]:OPTions? description: Returns information about an optical head’s options. parameters: none response: A string. example: slot1:head:opt? → NO CONNECTOR OPTION, NO INSTRUMENT OPTIONS affects: Optical heads

Measurement Functions – The SENSe Subsystem 68 HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299 Measurement Functions – The SENSe Subsystem The SENSe subsystem lets you control measurement parameters for a Power Sensor, an Optical Head Interface module, or a return loss module. HP 81635A and HP 81619A- Master and Slave Channels For the HP 81635A Dual Power Sensor and HP 81619A Dual Optical Head Interface module, channel 1 is the master channel and channel 2 is the slave channel. The master and slave channels share the same software and hardware triggering system. For some commands, setting parameters for the master channel sets the parameters for the slave channel. In these cases, you may only set parameters for the slave channel by setting master channel parameters. The commands listed in Table 5 can only be configured using the master channel. The commands listed in Table 6 are independent for both master and slave channels. command: :SLOT[n]:HEAD[m]:TST? syntax: :SLOT[n]:HEAD[m]:TST? description: Returns the latest selftest results for an optical head. NOTE This command does not perform a selftest. Use selfTeST command, “*TST?” on page 49, to perform a selftest. parameters: none response: Returns an error code and a short description of the error. example: slot:head:tst? → +0,"self test OK" affects: Optical heads command: :SPECial:REBoot syntax: :SPECial:REBoot description: Reboots the mainframe and all modules. parameters: none response: none example: spec:reb

Measurement Operations & Settings HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299 69 Command Page :INITiate[n]:[CHANnel[m]][:IMMediate] 70 :INITiate[n]:[CHANnel[m]]:CONTinuous/? 71 :READ[n][:CHANnel[m]][:SCALar]:POWer[:DC]? 71 :SENSe[n]:[CHANnel[m]]:CORRection:COLLect:ZERO 73 :SENSe[n][:CHANnel[m]]:FUNCtion:PARameter:LOGGing/? 74 :SENSe[n][:CHANnel[m]]:FUNCtion:PARameter:MINMax/? 75 :SENSe[n][:CHANnel[m]]:FUNCtion:PARameter:STABility/? 76 :SENSe[n][:CHANnel[m]]:FUNCtion:STATe/? 77 :SENSe[n]:[CHANnel[m]]:POWer:ATIME/? 78 :SENSe[n]:[CHANnel[m]]:POWer:RANGe:AUTO/? 79 :TRIGger[n][:CHANnel[m]]:INPut/? 110 :TRIGger[n][:CHANnel[m]]:INPut:REARm/? 111 :TRIGger[n][:CHANnel[m]]:OUTPut/? 112 :TRIGger[n][:CHANnel[m]]:OUTPut:REARm/? 112 Table 5 Commands that can only be configured using the master channel Command Page :FETCh[n][:CHANnel[m]][:SCAlar]:POWer[:DC]? 70 :SENSe[n]:[CHANnel[m]]:CORRection[:LOSS][:INPut] [:MAGNitude]/? 72 :SENSe[n]:[CHANnel[m]]:CORRection:COLLect:ZERO? 73 :SENSe[n]:[CHANnel[m]]:CORRection:COLLect:ZERO:ALL 73 :SENSe[n][:CHANnel[m]]:FUNCtion:RESult? 77 :SENSe[n]:[CHANnel[m]]:POWer:RANGe[:UPPer]/? 79 :SENSe[n]:[CHANnel[m]]:POWer:REFerence/? 80 :SENSe[n]:[CHANnel[m]]:POWer:REFerence:DISPlay 81 :SENSe[n]:[CHANnel[m]]:POWer:REFerence:STATe/? 81 :SENSe[n]:[CHANnel[m]]:POWer:REFerence:STATe:RATio/? 82 :SENSe[n]:[CHANnel[m]]:POWer:UNIT/? 82 :SENSe[n]:[CHANnel[m]]:POWer:WAVelength/? 83 Table 6 Commands that are independent for both master and slave channels

Measurement Functions – The SENSe Subsystem 70 HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299 command: :FETCh[n][:CHANnel[m]][:SCAlar]:POWer[:DC]? syntax: :FETCh[n]:[CHANnel[m]][:SCAlar]:POWer[:DC]? description: Reads the current power meter value. It does not provide its own triggering and so must be used with either continuous software triggering (see “:INITiate[n]:[CHANnel[m]]:CONTinuous?” on page 71) or a directly preceding imme- diate software trigger (see “:INITiate[n]:[CHANnel[m]][:IMMediate]” on page 70). It returns the power meter value the previous software trigger measured. Any subsequent FETCh command will return the same value, if there is no subsequent software trigger. parameters: none response: The current power meter value as a float value in dBm,W or dB. NOTE If the reference state is absolute, units are dBm or W. If the reference state is relative, units are dB. example: fetc1:pow? → +6.73370400E-04 affects: All power meters and return loss modules dual sensors: Master and slave channels are independent. command: :FETCh[n][:CHANnel[m]][:SCAlar]:RETurnloss? syntax: :FETCh[n]:[CHANnel[m]][:SCAlar]:RETurnloss? description: Reads the current return loss value. It does not provide its own triggering and so must be used with either continuous software triggering (see “:INITiate[n]:[CHANnel[m]]:CONTinuous?” on page 71) or a directly preceding imme- diate software trigger (see “:INITiate[n]:[CHANnel[m]][:IMMediate]” on page 70). It returns the return loss value the previous software trigger measured. Any subsequent FETCh command will return the same value, if there is no subsequent software trigger. parameters: none response: The current power meter value as a float value in dB. example: fetc1:ret? → +6.73370400E-00 affects: All return loss modules command: :INITiate[n]:[CHANnel[m]][:IMMediate] syntax: :INITiate[n]:[CHANnel[m]][:IMMediate] description: Initiates the software trigger system and completes one full trigger cycle, that is, one mea- surement is made. parameters: none response: none example: init affects: All power meters and return loss modules dual sensors: Can only be sent to master channel, slave channel is also affected.

Measurement Operations & Settings HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299 71 command: :INITiate[n]:[CHANnel[m]]:CONTinuous syntax: :INITiate[n]:[CHANnel[m]]:CONTinuous description: Sets the software trigger system to continuous measurement mode. parameters: A boolean value: 0 or OFF: do not measure continuously 1 or ON: measure continuously response: none example: init2:cont 1 affects: All power meters and return loss modules dual sensors: Can only be sent to master channel, slave channel is also affected. command: :INITiate[n]:[CHANnel[m]]:CONTinuous? syntax: :INITiate[n]:[CHANnel[m]]:CONTinuous? description: Queries whether the software trigger system operates continuously or not parameters: none response: A boolean value: 0 or OFF: measurement is not continuous 1 or ON: measurement is continuous example: init2:cont? → 1 affects: All power meters and return loss modules dual sensors: Can only be sent to master channel, slave channel parameters are identical. command: :READ[n][:CHANnel[m]][:SCALar]:POWer[:DC]? syntax: :READ[n]:[CHANnel[m]][:SCALar]:POWer[:DC]? description: Reads the current power meter value. It provides its own software triggering and does not need a triggering command. If the software trigger system operates continuously (see “:INITiate[n]:[CHANnel[m]]:CONTinuous?” on page 71), this command is identical to “:FETCh[n][:CHANnel[m]][:SCAlar]:POWer[:DC]?” on page 70. If the software trigger system does not operate continuously, this command is identical to generating a software trigger (“:INITiate[n]:[CHANnel[m]][:IMMediate]” on page 70) and then reading the power meter value. NOTE The power meter must be running for this command to be effective. parameters: none response: The current power meter reading as a float value in dBm, W or dB. NOTE If the reference state is absolute, units are dBm or W. If the reference state is relative, units are dB. example: read1:pow? → +1.33555600E-006 affects: All power meters and return loss modules dual sensors: Can only be sent to master channel, slave channel is also triggered. To read a simultaneous result from the slave channel, send “:FETCh[n][:CHANnel[m]][:SCAlar]:POWer[:DC]?” on page 70 directly after this command.

Measurement Functions – The SENSe Subsystem 72 HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299 command: :READ[n][:CHANnel[m]][:SCALar]:RETurnloss? syntax: :READ[n]:[CHANnel[m]][:SCALar]:RETurnloss? description: Reads the current return loss value. It provides its own software triggering and does not need a triggering command. If the software trigger system operates continuously (see “:INITiate[n]:[CHANnel[m]]:CONTinuous?” on page 71), this command is identical to “:FETCh[n][:CHANnel[m]][:SCAlar]:RETurnloss?” on page 70. If the software trigger system does not operate continuously, this command is identical to generating a software trigger (“:INITiate[n]:[CHANnel[m]][:IMMediate]” on page 70) and then reading the power meter value. NOTE The return loss module must be running for this command to be effective. parameters: none response: The current power meter reading as a float value in dB. example: read1:ret? → +1.33555600E-000 affects: All return loss modules command: :SENSe[n]:[CHANnel[m]]:CORRection[:LOSS][:INPut][:MAGNitude] syntax: :SENSe[n]:[CHANnel[m]]:CORRection[:LOSS][:INPUT][:MAGNitude] [DB|MDB] description: Enters a calibration value for a module. parameters: The calibration factor as a float value If no unit type is specified, decibels (dB) is implied. response: none example: sens1:corr 10DB affects: All power meters dual sensors: Master and slave channels are independent. command: :SENSe[n]:[CHANnel[m]]:CORRection[:LOSS][:INPut][:MAGNitude]? syntax: :SENSe[n]:[CHANnel[m]]:CORRection[:LOSS][:INPUT][:MAGNitude]? description: Returns the calibration factor for a module. parameters: none response: The calibration factor as a float value. Units are in dB, although no units are returned in the response message. example: sens1:corr? → +1.00000000E+000 affects: All power meters dual sensors: Master and slave channels are independent.

Measurement Operations & Settings HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299 73 NOTE Setting parameters for the logging function sets some parameters, including hidden parameters, for the stability and MinMax functions and vice versa. You must use the :SENSe[n][:CHANnel[m]]:FUNCtion:PARameter:LOGGing command: :SENSe[n]:[CHANnel[m]]:CORRection:COLLect:ZERO syntax: :SENSe[n]:[CHANnel[m]]:CORRection:COLLect:ZERO description: Zeros the electrical offsets for a power meter or return loss module. parameters: none response: none example: sens1:corr:coll:zero affects: All power meters and return loss modules dual sensors: Can only be sent to master channel, slave channel is also zeroed. command: :SENSe[n]:[CHANnel[m]]:CORRection:COLLect:ZERO? syntax: :SENSe[n]:[CHANnel[m]]:CORREction:COLLect:ZERO? description: Returns the status of the most recent zero command. parameters: none response: 0: any other number: zero succeeded without errors. remote zeroing failed (the number is the error code returned from the operation). example: sens1:corr:coll:zero? → 0 affects: All power meters and return loss modules dual sensors: Master and slave channels are independent. command: :SENSe[n]:[CHANnel[m]]:CORRection:COLLect:ZERO:ALL syntax: SENSe[n]:[CHANnel[m]]:CORRection:COLLect:ZERO:ALL description: Zeros the electrical offsets for all installed power meter and return loss modules. parameters: none response: none example: sens:chan:corr:coll:zero:all affects: All power meters and return loss modules dual sensors: Command is independent of channel.

Measurement Functions – The SENSe Subsystem 74 HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299 command to set parameters before you start a logging function using the :SENSe[n][:CHANnel[m]]:FUNCtion:STATe command. NOTE Setting parameters for the MinMax function sets some parameters, including hidden parameters, for the stability and logging functions and vice versa. You must use the :SENSe[n][:CHANnel[m]]:FUNCtion:PARameter:MINMax command: :SENSe[n][:CHANnel[m]]:FUNCtion:PARameter:LOGGing syntax: :SENSe[n][:CHANnel[m]]:FUNCtion:PARameter:LOGGing, [NS|US|MS|S] description: Sets the number of data points and the averaging time for the logging data acquisition function. parameters: Data Points: Averaging time: Data Points is the number of samples that are recorded before the logging mode is completed. Data Points is an integer value. Averaging time is a time value in seconds. There is no time delay between averaging time periods. Use “:SENSe[n][:CHANnel[m]]:FUNCtion:PARameter:STABility?” on page 76 if you want to use delayed measurement. If you specify no units for the averaging time value in your command, seconds are used as the default. NOTE See “:SENSe[n][:CHANnel[m]]:FUNCtion:STATe” on page 77 for information on start- ing/stopping a data acquisition function. NOTE See “:SENSe[n][:CHANnel[m]]:FUNCtion:RESult?” on page 77 for information on ac- cessing the results of a data acquisition function. NOTE See “Triggering and Power Measurements” on page 108 for information on how trigger- ing affects data acquisition functions. response: none example: sens1:func:par:logg 64,1ms affects: All power meters and return loss modules dual sensors: Can only be sent to master channel, slave channel is also affected. command: :SENSe[n][:CHANnel[m]]:FUNCtion:PARameter:LOGGing? syntax: :SENSe[n][:CHANnel[m]]:FUNCtion:PARameter:LOGGing? description: Returns the number of data points and the averaging time for the logging data acquisition function. parameters: none response: Returns the number of data points as an integer value and the averaging time, tavg, as a float value in seconds. example: sens1:func:par:logg? → +64,+1.00000000E-001 affects: All power meters and return loss modules dual sensors: Can only be sent to master channel, slave channel parameters are identical. Averaging Time t Measurement Running Measurement Stopped 1 3 5 2 4 6 8 7 9

Measurement Operations & Settings HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299 75 command to set parameters before you start a MinMax function using the :SENSe[n][:CHANnel[m]]:FUNCtion:STATe command. NOTE Setting parameters for the stability function sets some parameters, including hidden parameters, for the logging and MinMax functions and vice versa. You must use the :SENSe[n][:CHANnel[m]]:FUNCtion:PARameter:STABility command: :SENSe[n][:CHANnel[m]]:FUNCtion:PARameter:MINMax syntax: :SENSe[n][:CHANnel[m]]:FUNCtion:PARameter:MINMax CONTinous|WINDow|REFResh, description: Sets the MinMax mode and the number of data points for the MinMax data acquisition function. parameters: CONTinous: WINDow: REFResh: continuous MinMax mode window MinMax mode refresh MinMax mode Data Points is the number of samples that are recorded in the memory buffer used by the WINDow and REFResh modes. Data Points is an integer value. See Chapter 3 of the HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measure- ment System, & HP 8166A Lightwave Multichannel System User’s Guide, for more in- formation on MinMax mode. NOTE See “:SENSe[n][:CHANnel[m]]:FUNCtion:STATe” on page 77 for information on start- ing/stopping a data acquisition function. NOTE See “:SENSe[n][:CHANnel[m]]:FUNCtion:RESult?” on page 77 for information on ac- cessing the results of a data acquisition function. NOTE See “Triggering and Power Measurements” on page 108 for information on how trigger- ing affects data acquisition functions. response: none example: sens1:func:par:minm WIND,10 affects: All power meters and return loss modules dual sensors: Can only be sent to master channel, slave channel is also affected. command: :SENSe[n][:CHANnel[m]]:FUNCtion:PARameter:MINMax? syntax: :SENSe[n][:CHANnel[m]]:FUNCtion:PARameter:MINMax? description: Returns the MinMax mode and the number of data points for the MinMax data acquisition function. parameters: none response: CONT: WIND: REFR: continuous MinMax mode window MinMax mode refresh MinMax mode The number of data points is returned as an integer value. example: sens1:func:par:minm? → WIND,+10 affects: All power meters and return loss modules dual sensors: Can only be sent to master channel, slave channel parameters are identical.

Measurement Functions – The SENSe Subsystem 76 HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299 command to set parameters before you start a stability function using the :SENSe[n][:CHANnel[m]]:FUNCtion:STATe command. command: :SENSe[n][:CHANnel[m]]:FUNCtion:PARameter:STABility syntax: :SENSe[n][:CHANnel[m]]:FUNCtion:PARameter:STABility [NS|US|MS|S],[NS|US|MS|S],[NS|US|MS|S] description: Sets the total time, period time, and averaging time for the stability data acquisition function. parameters: Total time: Period time: Averaging time: The total time from the start of stability mode until it is completed. A new measurement is started after the completion of every period time. A measurement is averaged over the averaging time. NOTE The total time should be longer than the period time. The period time should be longer than the averaging time. The number of data points is equal to the total time divided by the period time. Total time, period time, and averaging time are time values in seconds. If you specify no units in your command, seconds are used as the default. NOTE See “:SENSe[n][:CHANnel[m]]:FUNCtion:STATe” on page 77 for information on start- ing/stopping a data acquisition function. NOTE See “:SENSe[n][:CHANnel[m]]:FUNCtion:RESult?” on page 77 for information on ac- cessing the results of a data acquisition function. NOTE See “Triggering and Power Measurements” on page 108 for information on how triggering affects data acquisition functions. response: none example: sens1:func:par:stab 1s,0.1s,0.1s affects: All power meters and return loss modules dual sensors: Can only be sent to master channel, slave channel is also affected. command: :SENSe[n][:CHANnel[m]]:FUNCtion:PARameter:STABility? syntax: :SENSe[n][:CHANnel[m]]:FUNCtion:PARameter:STABility? description: Returns the total time, period time, and averaging time for the stability data acquisition function. parameters: none response: Total time, delay time, and averaging time are float values in seconds. example: sens1:func:par:stab? → +1.00000000E+000, +1.00000000E-001,+1.00000000E-001 affects: All power meters and return loss modules dual sensors: Can only be sent to master channel, slave channel parameters are identical. Averaging Time Period Time t Measurement Running Measurement Stopped 1 2 3 4 5

Measurement Operations & Settings HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299 77 command: :SENSe[n][:CHANnel[m]]:FUNCtion:RESult? syntax: :SENSe[n][:CHANnel[m]]:FUNCtion:RESult? description: Returns the data array of the last data acquisition function. parameters: none response: The last data acquisition function’s data array as a binary block, one measurement value is a 4-byte-long float in Intel byte order. example: sens1:func:res? → returns a data array affects: All power meters and return loss modules dual sensors: Master and slave channels are independent. command: :SENSe[n][:CHANnel[m]]:FUNCtion:STATe syntax: :SENSe[n][:CHANnel[m]]:FUNCtion:STATe LOGGing|STABility|MINMax,STOP|STARt description: Enables/Disables the logging, MinMax, or stability data acquisition function mode. parameters: LOGGing: STABility: MINMax: STOP: STARt: Logging data acquisition function Stability data acquisition function MinMax data acquisition function Stop data acquisition function Start data acquisition function NOTE When you enable a logging data acquisition function for a HP 8163A Series Power Meter with averaging time of less than 100 ms with input hardware triggering disabled, all GPIB commands will be ignored for the duration of the function. See “:SENSe[n][:CHANnel[m]]:FUNCtion:PARameter:LOGGing” on page 74 for more information on the logging data acquisition function. NOTE Stop any function before you try to set up a new function. Some parameters cannot be set until you stop the function. response: none example: sens1:func:stat logg,star affects: All power meters and return loss modules dual sensors: Can only be sent to master channel, slave channel is also affected. command: :SENSe[n][:CHANnel[m]]:FUNCtion:STATe? syntax: :SENSe[n][:CHANnel[m]]:FUNCtion:STATe? description: Returns the function mode and the status of the data acquisition function. parameters: none response: NONE LOGGING_STABILITY MINMAX PROGRESS COMPLETE No function mode selected Logging or stability data acquisition function MinMax data acquisition function Data acquisition function is in progress Data acquisition function is complete example: sens1:func:stat? → LOGGING_STABILITY,COMPLETE affects: All power meters and return loss modules dual sensors: Can only be sent to master channel, slave channel parameters are identical.

Measurement Functions – The SENSe Subsystem 78 HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299 command: :SENSe[n][:CHANnel[m]]:FUNCtion:THReshold syntax: :SENSe[n][:CHANnel[m]]:FUNCtion:THReshold, [PW|NW|UW|MW|Watt|DBM] description: Sets the start mode and the threshold value. parameters: ABOVe: BELow: IMMediately: Threshold Value: Function starts when power is above the threshold value. Function starts when power is below the threshold value. Function starts immediately. A float value in Watts or dBm. response: none example: sens1:func:thr IMM,20nw affects: All HP 8153A Lightwave Multimeter series power meters and the HP 81534A Return Loss module command: :SENSe[n][:CHANnel[m]]:FUNCtion:THReshold? syntax: :SENSe[n][:CHANnel[m]]:FUNCtion:THReshold? description: Returns the start mode and the threshold value. parameters: none response: ABOV: BEL: IMM: Threshold Value: Function starts when power is above the threshold value. Function starts when power is below the threshold value. Function starts immediately. A float value in Watts or dBm. example: sens1:func:thr? → IMM,+2.00000000E-008 affects: All HP 8153A Lightwave Multimeter series power meters and the HP 81534A Return Loss module command: :SENSe[n]:[CHANnel[m]]:POWer:ATIMe syntax: :SENSe[n]:[CHANnel[m]]:POWer:ATIMe[NS|US|MS|S] description: Sets the averaging time for the module. parameters: The averaging time as a float value in seconds. If you specify no units in your command, seconds are used as the default. response: none example: sens1:pow:atim 1s affects: All power meters and return loss modules dual sensors: Can only be sent to master channel, slave channel is also affected. command: :SENSe[n]:[CHANnel[m]]:POWer:ATIMe? syntax: :SENSe[n]:[CHANnel[m]]:POWer:ATIMe? description: Returns the averaging time for the module. parameters: none response: The averaging time as a float value in seconds. example: sens1:pow:atim? → +1.00000000E+000 affects: All power meters and return loss modules dual sensors: Can only be sent to master channel, slave channel parameters are identical.

Measurement Operations & Settings HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299 79 command: :SENSe[n]:[CHANnel[m]]:POWer:RANGe[:UPPer] syntax: :SENSe[n]:[CHANnel[m]]:POWer:RANGe[:UPPer][DBM] description: Sets the power range for the module. The range changes at 10 dBm intervals. The corresponding ranges for linear measure- ments (measurements in Watts) is given below: Range +30 dBm +20 dBm +10 dBm 0 dBm −10 dBm −20 dBm −30 dBm −40 dBm Upper Linear Power Limit 1999.9 mW 199.99 mW 19.999 mW 1999.9 µW 199.99 µW 19.999 µW 1999.9 nW 199.99 nW Range −50 dBm −60 dBm −70 dBm −80 dBm −90 dBm −100 dBm −110 dBm Upper Linear Power Limit 19.999 nW 1999.9 pW 199.99 pW 19.999 pW 1.999 pW 0.199 pW 0.019 pW parameters: The range as a float value in dBm. The number is rounded to the closest multiple of 10, because the range changes at 10 dBm intervals. Units are in dBm. response: none example: sens1:pow:rang -20DBM affects: All power meters dual sensors: Master and slave channels are independent. command: :SENSe[n]:[CHANnel[m]]:POWer:RANGe[:UPPer]? syntax: :SENSe[n]:[CHANnel[m]]:POWer:RANGe[:UPPer]? description: Returns the range setting for the module parameters: none response: The range setting as a float value in dBm (−110 Š≤ value ≤ +30). example: sens1:pow:rang? → -2.00000000E+001 affects: All power meters dual sensors: Master and slave channels are independent. command: :SENSe[n]:[CHANnel[m]]:POWer:RANGe:AUTO syntax: SENSe[n]:[CHANnel[m]]:POWer:RANGe:AUTO description: Enables or disables automatic power ranging for the module. If automatic power ranging is enabled, ranging is automatically determined by the instru- ment. Otherwise, it must be set by the sensn:pow:rang command. parameters: A boolean value: 0 or OFF: automatic ranging disabled 1 or ON: automatic ranging enabled response: none example: sens1:pow:rang:auto 1 affects: All power meters dual sensors: Can only be sent to master channel, slave channel is also affected.

Measurement Functions – The SENSe Subsystem 80 HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299 command: :SENSe[n]:[CHANnel[m]]:POWer:RANGe:AUTO? syntax: :SENSe[n]:[CHANnel[m]]:POWer:RANGe:AUTO? description: Returns whether automatic power ranging is being used by the module. parameters: none response: A boolean value: 0: automatic ranging is not being used. 1: automatic ranging is being used. example: sens1:pow:rang:auto? → 1 affects: All power meters dual sensors: Can only be sent to master channel, slave channel parameters are identical. command: :SENSe[n]:[CHANnel[m]]:POWer:REFerence syntax: :SENSe[n]:[CHANnel[m]]:POWer:REFerence TOMODule|TOREF,PW|NW|UW|MW|Watt|DBM|DB|MDB description: Sets the sensor reference value. parameters: TOMODule: TOREF: Sets the reference value in dB used if you choose measurement rela- tive to another channel Sets the reference value in Watts or dBm if you choose measurement relative to a constant reference value The reference as a float value. NOTE You must append a unit type • dB if you use TOMODule or • Watts or dBm if you use TOREF. NOTE The two reference values are completely independent. When you change the reference mode using the command “:SENSe[n]:[CHANnel[m]]:POWer:REFerence:STATe:RATio?” on page 82, the instrument uses the last reference value entered for the selected reference mode. response: none example: sens1:pow:ref tomod,-40DB affects: All power meters dual sensors: Master and slave channels are independent. command: :SENSe[n]:[CHANnel[m]]:POWer:REFerence? syntax: :SENSe[n]:[CHANnel[m]]:POWer:REFerence?TOMODule|TOREF description: Returns the sensor reference value. parameters: TOMODule: TOREF: Returns the reference value in dB used if you choose measurement relative to another channel Returns the reference value in Watts or dBm if you choose measure- ment relative to a constant reference value response: The reference as a float value. example: sens1:pow:ref? toref → +1.00000000E-006 affects: All power meters dual sensors: Master and slave channels are independent.

Measurement Operations & Settings HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299 81 command: :SENSe[n]:[CHANnel[m]]:POWer:REFerence:DISPlay syntax: :SENSe[n]:[CHANnel[m]]:POWer:REFerence:DISPlay description: Takes the input power level value as the reference value. parameters: none response: none example: sens1:pow:ref:disp affects: All power meters dual sensors: Master and slave channels are independent. command: :SENSe[n]:[CHANnel[m]]:POWer:REFerence:STATe syntax: :SENSe[n]:[CHANnel[m]]POWer:REFerence:STATe description: Sets the measurement units to relative or absolute units. parameters: A boolean value: 0 or OFF: absolute 1 or ON: relative response: none example: sens1:pow:ref:stat 1 affects: All power meters dual sensors: Master and slave channels are independent. command: :SENSe[n]:[CHANnel[m]]:POWer:REFerence:STATe? syntax: :SENSe[n]:[CHANnel[m]]POWer:REFerence:STATe? description: Inquires whether the current measurement units are relative (dB) or absolute (Watts or dBm). parameters: none response: A boolean value: 0: absolute 1: relative example: sens1:pow:ref:stat? → 1 affects: All power meters dual sensors: Master and slave channels are independent.

Measurement Functions – The SENSe Subsystem 82 HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299 command: :SENSe[n]:[CHANnel[m]]:POWer:REFerence:STATe:RATio syntax: :SENSe[n]:[CHANnel[m]]POWer:REFerence:STATe:RATio |255|TOREF, description: Selects the reference for the module. parameters: slot number: 255 or TOREF: channel number: an integer value representing the slot number you want to reference results are displayed relative to an absolute reference an integer value representing the channel number you want to ref- erence NOTE If you want to reference another power sensor channel, use an integer value corresponding to the slot for the first parameter and an integer value corresponding to the channel for the second value. If you want to use an absolute reference, use TOREF as the first parameter and any integer value as the second parameter. response: none examples: sens1:pow:ref:stat:rat 2,1 sens1:pow:ref:stat:rat TOREF,1 References channel 2.1 References an absolute reference affects: All power meters dual sensors: Master and slave channels are independent. command: :SENSe[n]:[CHANnel[m]]:POWer:REFerence:STATe:RATio? syntax: :SENSe[n]:[CHANnel[m]]POWer:REFerence:STATe:RATio? description: Returns the reference setting for the module. parameters: none response: results are displayed relative to an absolute reference or to the current power reading from another channel. examples: sens1:pow:ref:stat:rat? → +255,+0 sens1:pow:ref:stat:rat? → +2,+1 results are displayed relative to an absolute reference results are displayed relative to channel 2.1 affects: All power meters dual sensors: Master and slave channels are independent. command: :SENSe[n]:[CHANnel[m]]:POWer:UNIT syntax: :SENSe[n]:[CHANnel[m]]:POWer:UNITDBM|0|Watt|1 description: Sets the sensor power unit parameters: An integer value: 0: dBm 1: Watt or DBM or Watt response: none example: sens1:pow:unit 1 affects: All power meters dual sensors: Master and slave channels are independent.

Measurement Operations & Settings HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299 83 command: :SENSe[n]:[CHANnel[m]]:POWer:UNIT? syntax: :SENSe[n]:[CHANnel[m]]:POWer:UNIT? description: Inquires the current sensor power unit parameters: none response: An integer value: 0: Current power units are dBm. 1: Current power units are Watts. example: sens1:pow:unit? → +1 affects: All power meters dual sensors: Master and slave channels are independent. command: :SENSe[n]:[CHANnel[m]]:POWer:WAVelength syntax: :SENSe[n]:[CHANnel[m]]:POWer:WAVelength|MIN|MAX|DEF [PM|NM|UM|MM|M] description: Sets the sensor wavelength. parameters: The wavelength as a float value in meters. Also allowed are: MIN: minimum programmable value MAX: maximum programmable value DEF: This is not the preset (*RST) default value but is half the sum of, the minimum programmable value and the maximum programmable value response: none example: sens1:pow:wav 1550nm affects: All power meters and return loss modules dual sensors: Master and slave channels are independent. command: :SENSe[n]:[CHANnel[m]]:POWer:WAVelength? syntax: :SENSe[n]:[CHANnel[m]]:POWer:WAVelength?[MIN|MAX|DEF] description: Inquires the current sensor wavelength. parameters: none Also allowed are: MIN: minimum programmable value MAX: maximum programmable value DEF: This is not the preset (*RST) default value but is half the sum of, the minimum programmable value and the maximum programmable value response: The wavelength as a float value in meters. example sens1:pow:wav? → +1.55000000E-006 affects: All power meters and return loss modules dual sensors: Master and slave channels are independent.

Measurement Functions – The SENSe Subsystem 84 HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299 command: :SENSe[n]:[CHANnel[m]]:RETurnloss:CALibration:FACTory syntax: :SENSe[n]:[CHANnel[m]]:RETurnloss:CALibration:FACTory description: Overwrites the current calibration values with the factory-set calibration settings. See “:SENSe[n]:[CHANnel[m]]:RETurnloss:CALibration:COLLect:REFLectance” on page 84 and “:SENSe[n]:[CHANnel[m]]:RETurnloss:CALibration:COLLect:TERMination” on page 84 for information on calibrating your return loss module. parameters: none response: none example sens1:ret:cal:fact affects: All return loss modules command: :SENSe[n]:[CHANnel[m]]:RETurnloss:CALibration:COLLect:REFLectance syntax: :SENSe[n]:[CHANnel[m]]:RETurnloss:CALibration:COLLect:REFLectance description: Start the calibration and save the calibration values for a defined reflectance reference measurement. See “:SENSe[n]:[CHANnel[m]]:RETurnloss:CORRection:REFLectance[l]” on page 85 for information on setting the return loss value of your reference reflector. parameters: none response: none example sens1:ret:cal:coll:refl affects: All return loss modules command: :SENSe[n]:[CHANnel[m]]:RETurnloss:CALibration:COLLect:TERMination syntax: :SENSe[n]:[CHANnel[m]]:RETurnloss:CALibration:COLLect:TERMination description: Start the calibration and save the calibration values for a defined termination reference measurement. See “:SENSe[n]:[CHANnel[m]]:RETurnloss:CORRection:REFLectance[l]” on page 85 for information on setting the return loss value of your reference reflector. parameters: none response: none example sens1:ret:cal:coll:term affects: All return loss modules

Measurement Operations & Settings HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299 85 command: :SENSe[n]:[CHANnel[m]]:RETurnloss:CORRection:FPDelta[l] syntax: :SENSe[n]:[CHANnel[m]]:RETurnloss:CORRection:FPDelta[l][dB] description: Sets the front panel delta, that is, the loss correction value, for example, due to the front panel connector. Twice this value is added to the measured Return Loss. NOTE Use [l] to set the front panel delta for an external source or the upper or lower wavelength laser source of a dual return loss module. An external laser source is denoted by 0. 0 is the default value of [l]. A lower wavelength source is denoted by 1. An upper wavelength source is denoted by 2. parameters: Sets the front panel delta as a float value in dB response: none example sens1:ret:cal:corr:fpd 0.08DB affects: All return loss modules command: :SENSe[n]:[CHANnel[m]]:RETurnloss:CORRection:FPDelta[l]? syntax: :SENSe[n]:[CHANnel[m]]:RETurnloss:CORRection:FPDelta[l]? description: Returns the front panel delta, that is, the loss correction value, for example, due to the front panel connector. Twice this value is added to the measured Return Loss. NOTE Use [l] to query the front panel delta for an external source or the upper or lower wave- length laser source of a dual return loss module. An external laser source is denoted by 0. 0 is the default value. A lower wavelength source is denoted by 1. An upper wavelength source is denoted by 2. parameters: Returns the front panel delta as a float value in dB response: none example sens1:ret:cal:corr:fpd? → +8.00000000E-002 affects: All return loss modules command: :SENSe[n]:[CHANnel[m]]:RETurnloss:CORRection:REFLectance[l] syntax: :SENSe[n]:[CHANnel[m]]:RETurnloss:CORRection:REFLectance[l][dB] description: Sets the Return Loss Reference, the return loss value of your reference reflector. For example, the HP 81000BR reference reflector provides an accurate and stable 0.18 dB reference. NOTE Use [l] to set the return loss value of your reference reflector for an external source or the upper or lower wavelength laser source of a dual return loss module. An external laser source is denoted by 0. 0 is the default value of [l]. A lower wavelength source is denoted by 1. An upper wavelength source is denoted by 2. parameters: Sets the Return Loss Reference as a float value in dB response: none example sens1:ret:cal:corr:refl 0.18DB affects: All return loss modules

Signal Generation – The SOURce Subsystem 86 HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299 Signal Generation – The SOURce Subsystem The SOURce subsystem allows you to control a laser source module, DFB source module, tunable laser module, or a return loss module that has an internal source. command: :SENSe[n]:[CHANnel[m]]:RETurnloss:CORRection:REFLectance[l]? syntax: :SENSe[n]:[CHANnel[m]]:RETurnloss:CORRection:REFLectance[l]? description: Returns the Return Loss Reference, the return loss value of your reference reflector. For example, the HP 81000BR reference reflector provides an accurate and stable 0.18 dB reference. NOTE Use [l] to query the return loss value of your reference reflector for an external source or the upper or lower wavelength laser source of a dual return loss module. An external laser source is denoted by 0. 0 is the default value of [l]. A lower wavelength source is denoted by 1. An upper wavelength source is denoted by 2. parameters: none response: Returns the Return Loss Reference as a float value in dB example sens1:ret:cal:corr:refl? → +1.80000000E-001 affects: All return loss modules command: :OUTPut[n][:CHANnel[m]]:CONNection syntax: OUTPut[n][:CHANnel[m]]:CONNectionMOD|VPP description: Sets the analog output parameter. parameters: MOD: VPP: The modulation frequency modulates the analog output. Output Voltage is proportional to optical power. response: none example: outp1:conn mod affects: All tunable laser modules command: :OUTPut[n][:CHANnel[m]]:CONNection? syntax: OUTPut[n][:CHANnel[m]]:CONNection? description: Returns the analog output parameter. parameters: none response: MOD: VPP: The modulation frequency modulates the analog output. Output Voltage is proportional to optical power. example: outp1:conn? → MOD affects: All tunable laser modules

Measurement Operations & Settings HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299 87 command: :OUTPut[n][:CHANnel[m]]:PATH syntax: :OUTPut[n][:CHANnel[m]]:PATH description: Sets the regulated path. parameters: HIGHpower: LOWSse: BHRegulated: BLRegulated: The High Power output is regulated. The Low SSE output is regulated. Both outputs are active but only the High Power output is Regulated. Both outputs are active but only the Low SSE output is Regulated. response: none example: output1:path high affects: All tunable laser modules command: :OUTPut[n][:CHANnel[m]]:PATH? syntax: :OUTPut[n][:CHANnel[m]]:PATH? description: Returns the regulated path. parameters: none response: HIGH: LOWS: BHR: BLR: The High Power output is regulated. The Low SSE output is regulated. Both outputs are active but only the High Power output is Regulated. Both outputs are active but only the Low SSE output is Regulated. example: output1:path? → HIGH affects: All tunable laser modules command: :OUTPut[n][:CHANnel[m]][:STATe] syntax: :OUTPut[n][:CHANnel[m]][:STATe]OFF|ON|0|1 description: Switches the laser current off and on. The laser emits light only when the current is on. Set the state to OFF or 0 to switch the laser current off. Set the state to ON or 1 to switch the laser current on. The default is for the laser current to be off. parameters: 0 or OFF: 1 or ON: switch laser current off switch laser current on response: none example: outp 1 affects: All laser source, DFB source, tunable laser modules and return loss modules with an in- ternal source command: :OUTPut[n][:CHANnel[m]][:STATe]? syntax: :OUTPut[n][:CHANnel[m]][:STATe]? description: Returns the current state of the laser current. parameters: none response: A boolean value: 0 – laser current off 1 – laser current on example: outp? → 1 affects: All laser source, DFB source, tunable laser modules and return loss modules with an inter- nal source

Signal Generation – The SOURce Subsystem 88 HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299 command: [:SOURce[n]][:CHANnel[m]]:AM[:INTernal]:FREQuency[l] syntax: [:SOURce[n]][:CHANnel[m]]:AM[:INTernal]:FREQuency[l] [THZ|GHZ|MHZ|KHZ|HZ] description: Sets the frequency of the amplitude modulation of the laser output. parameters: The frequency as a float value in Hz. Also allowed are: MIN: minimum programmable value MAX: maximum programmable value DEF: This is not the preset (*RST) default value but is half the sum of, the minimum programmable value and the maximum programmable value The default units are HZ, although KHZ, MHZ, GHZ, and THZ can also be specified. The resolution of the frequency is always 1 Hz. NOTE Use [l] to set the modulation frequency of the upper or lower wavelength laser source of a dual-wavelength laser source or a return loss module with an internal dual-wavelength la- ser source. The default value of [l] is 1, the lower wavelength source. The upper wave- length source is denoted by 2. response: none example: sour2:am:freq 270hz affects: All laser source, DFB source, and tunable laser modules command: [:SOURce[n]][:CHANnel[m]]:AM[:INTernal]:FREQuency[l]? syntax: [:SOURce[n]][:CHANnel[m]]:AM[:INTernal]:FREQuency[l]? [MIN|DEF|MAX] description: Returns the frequency of the amplitude modulation as a float value in Hertz. parameters: MIN: minimum modulation frequency MAX: maximum modulation frequency DEF: This is not the preset (*RST) default value but is half the sum of, the minimum modulation frequency and the maximum modulation frequency NOTE Use [l] to query the modulation frequency of the upper or lower wavelength laser source of a dual-wavelength laser source or a return loss module with an internal dual-wave- length laser source. The default value of [l] is 1, the lower wavelength source. The upper wavelength source is denoted by 2. response: modulation frequency relevant to the current value or specified parameter (if MIN, MAX, or DEF are chosen as a parameter). example: sour2:am:freq? min → +2.00000000E+002 All laser source, DFB source, and tunable laser modules

Measurement Operations & Settings HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299 89 command: [:SOURce[n]][:CHANnel[m]]:AM:SOURce[l] syntax: [:SOURce[n]][:CHANnel[m]]:AM:SOURce[l] INT|INT1|INT2|EXT|0|1|2 description: Selects the type or source of the modulation of the laser output. parameters: 0, INT1, or INTernal: 1, COHCtrl, or INT2: 2, AEXTernal, or EXT: 3 or DEXTernal: 4 or LFCohctrl: 5 or WVLLocking: 6 or BACKplane: internal digital modulation coherence control external analog modulation external digital modulation low frequency coherence control wavelength locking external digital modulation using Input Trigger Connector NOTE Use [l] to set the modulation source of the upper or lower wavelength laser source of a dual-wavelength laser source or a return loss module with an internal dual-wavelength la- ser source. The default value of [l] is 1, the lower wavelength source. The upper wave- length source is denoted by 2. response: none example: sour2:am:sour int affects: All laser source, DFB source, and tunable laser modules can use internal digital modula- tion All other modulation modes are only available with tunable laser modules. command: [:SOURce[n]][:CHANnel[m]]:AM:SOURce[l]? syntax: [:SOURce[n]][:CHANnel[m]]:AM:SOURce[l]? description: Returns the type or source of the modulation of the laser output. parameters: 0: 1: 2: 3: 4: 5: 6: internal digital modulation coherence control external analog modulation external digital modulation low frequency coherence control wavelength locking external digital modulation using Input Trigger Connector NOTE Use [l] to query the modulation source of the upper or lower wavelength laser source of a dual-wavelength laser source or a return loss module with an internal dual-wavelength la- ser source. The default value of [l] is 1, the lower wavelength source. The upper wave- length source is denoted by 2. response: none example: sour2:am:sour? → +0 affects: All laser source, DFB source, and tunable laser modules can use internal digital modula- tion All other modulation modes are only available with tunable laser modules.

Signal Generation – The SOURce Subsystem 90 HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299 command: [:SOURce[n]][:CHANnel[m]]:AM:STATe[l] syntax: [:SOURce[n]][:CHANnel[m]]:AM:STATe[l] OFF|ON|0|1 description: Enables and disables amplitude modulation of the laser output. parameters: A boolean value: OFF or 0: modulation disabled (default) ON or 1: modulation enabled. NOTE Use [l] to enable/disable amplitude modulation for the upper or lower wavelength laser source of a dual-wavelength laser source or a return loss module with an internal dual- wavelength laser source. The default value of [l] is 1, the lower wavelength source. The upper wavelength source is denoted by 2. NOTE When the internal modulation is selected, the Modulation Output on the front panel outputs a version of the modulating signal that has the same frequency and phase as the modulating signal, but has a fixed, TTL-level amplitude. You can use this to synchronize your external measuring equipment to your instrument. To allow for your possible synchronization requirements, there are two ways in which the signal can be output. Either the signal is combined with the laser-ready signal, so that the output is kept low when there is no optical signal being output (for example, while the laser is settling after a change of wavelength). Or the modulation signal is output all the time. This is set by the :SOURCE:MODOUT command (see “[:SOURce[n]][:CHANnel[m]]:MODout” on page 91). NOTE When you enable lambda logging, see “[:SOURce[n]][:CHANnel[m]]:WAVelength:SWEep:LLOGging” on page 103, and modulation simultaneously, a sweep can not be started, see “[:SOURce[n]][:CHANnel[m]]:WAVelength:SWEep:[STATe]” on page 106. response: none example: sour2:am:stat 0 affects: All laser source, DFB source, and tunable laser modules command: [:SOURce[n]][:CHANnel[m]]:AM:STATe[l]? syntax: [:SOURce[n]][:CHANnel[m]]:AM:STATe[l]? description: Returns the current state of modulation. NOTE Use [l] to query the current state of modulation of the upper or lower wavelength laser source of a dual-wavelength laser source or a return loss module with an internal dual- wavelength laser source. The default value of [l] is 1, the lower wavelength source. The upper wavelength source is denoted by 2. parameters: none response: A boolean value: 0: modulation is disabled 1: modulation is enabled example: sour2:am:stat? → 0 affects: All laser source, DFB source, and tunable laser modules

Measurement Operations & Settings HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299 91 command: [:SOURce[n]][:CHANnel[m]]:MODout syntax: [:SOURce[n]][:CHANnel[m]]:MODoutFRQ|FRQRDY|0|1 description: Sets the modulation output parameters: FRQ or 0: FRQRDY or 1: modulation signal is output all the time modulation is combined with the laser-ready signal. In this case, the output is kept low when no optical signal is output (for example, while the laser is settling after a change of wavelength). response: none example: sour2:mod 0 affects: All tunable laser modules command: [:SOURce[n]][:CHANnel[m]]:MODout? syntax: [:SOURce[n]][:CHANnel[m]]:MODout? description: Returns the mode of the modulation output. parameters: none response: 0: 1: modulation signal is output all the time modulation is combined with the laser-ready signal. In this case, the output is kept low when no optical signal is output (for example, while the laser is settling after a change of wavelength). example: sour2:mod? → 0 affects: All tunable laser modules

Signal Generation – The SOURce Subsystem 92 HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299 command: [:SOURce[n]][:CHANnel[m]]:POWer:ATTenuation[l] syntax: [:SOURce[n]][:CHANnel[m]]:POWer:ATTenuation[l][DB|MDB] description: Sets the level of attenuation. parameters: Any value in the specified range (see the specifications in the appropriate User’s Guide). Also allowed (for tunable la- ser modules only) are: MIN: minimum programmable value MAX: maximum programmable value DEF: This is not the preset (*RST) default value but is half the sum of, the minimum programmable value and the maximum programmable value NOTE Use [l] to set the attenuation level of the upper or lower wavelength laser source of a dual- wavelength laser source or of a return loss module with an internal dual-wavelength laser source. The default value of [l] is 1, the lower wavelength source. The upper wavelength source is denoted by 2. NOTE Tunable laser modules with in-built optical attenuators need to be in Manual Attenuation Mode (see “[:SOURce[n]][:CHANnel[m]]:POWer:ATTenuation:AUTO” on page 93) for this value to have an affect. The output power is a combination of this value and the laser output power (see “[:SOURce[n]][:CHANnel[m]]:POWer[:LEVel][:IMMediate][:AMPLitude]” on page 94). NOTE In this respect, this command does not conform to the SCPI standard. The SCPI standard requires that entering an explicit value for the attenuation switches the attenuation mode OFF. The default units are dB. response: none example: sour2:pow:att 22.32db affects: All tunable laser modules with an in-built optical attenuator, all laser source modules, and return loss modules with an internal source command: [:SOURce[n]][:CHANnel[m]]:POWer:ATTenuation[l]? syntax: [:SOURce[n]][:CHANnel[m]]:POWer:ATTenuation[l]?[MIN|DEF|MAX] description: Returns the attenuation level. When using a tunable laser module with an in-built optical attenuator, the value returned applies only to the attenuation mode (see “[:SOURce[n]][:CHANnel[m]]:POWer:ATTenuation:AUTO” on page 93). NOTE Use [l] to query the attenuation level of the upper or lower wavelength laser source of a dual-wavelength laser source or of a return loss module with an internal dual-wavelength laser source. The default value of [l] is 1, the lower wavelength source. The upper wave- length source is denoted by 2. parameters: Also allowed (for tunable laser mod- ules only) are: MIN: minimum amplitude level MAX: maximum amplitude level DEF: This is not the preset (*RST) default value but is half the sum of, the minimum amplitude level and the maximum amplitude level response: attenuation level relevant to the current value or specified parameter (if MIN, MAX, or DEF are chosen as a parameter). example: sour2:pow:att? def → +3.10000000+E001 affects: All tunable laser modules with an in-built optical attenuator, all laser source modules, and return loss modules with an internal source

Measurement Operations & Settings HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299 93 command: [:SOURce[n]][:CHANnel[m]]:POWer:ATTenuation:AUTO syntax: [:SOURce[n]][:CHANnel[m]]:POWer:ATTenuation:AUTOOFF|ON|0|1 description: Selects Automatic or Manual Attenuation Mode. In Automatic Attenuation Mode, you specify the output power. In Manual Attenuation Mode, you must specify both the laser output power, and the atten- uation level. parameters: OFF or 0: ON or 1: Attenuation Mode Power Mode response: none example: sour2:pow:att:auto 1 affects: All tunable laser modules with an in-built optical attenuator command: [:SOURce[n]][:CHANnel[m]]:POWer:ATTenuation:AUTO? syntax: [:SOURce[n]][:CHANnel[m]]:POWer:ATTenuation:AUTO? description: Returns whether the instrument is in Automatic or Manual Attenuation Mode. parameters: none response: 0: 1: Manual Attenuation Mode Automatic Attenuation Mode example: sour2:pow:att:auto? → 1 affects: All tunable laser modules with an in-built optical attenuator command: [:SOURce[n]][:CHANnel[m]]:POWer:ATTenuation:DARK syntax: [:SOURce[n]][:CHANnel[m]]:POWer:ATTenuation:DARKOFF|ON|0|1 description: Sets or unsets the attenuator to ‘dark’ position. Dark position blocks all light from the laser. You can use this as an alternative to dis- abling the laser, the advantage of doing this is that you avoid the laser rise time. This command is available in Attenuation Mode Only. parameters: OFF or 0: ON or 1: Unsets dark position Sets dark position response: none example: sour2:pow:att:dark 1 affects: All tunable laser modules with an in-built optical attenuator command: [:SOURce[n]][:CHANnel[m]]:POWer:ATTenuation:DARK? syntax: [:SOURce[n]][:CHANnel[m]]:POWer:ATTenuation:DARK? description: Queries whether the attenuator is set to ‘dark’ position (where all light is blocked by the laser). parameters: none response: 0: 1: dark position not set dark position set example: sour2:pow:att:dark? → 1 affects: All tunable laser modules with an in-built optical attenuator

Signal Generation – The SOURce Subsystem 94 HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299 command: [:SOURce[n]][:CHANnel[m]]:POWer[:LEVel][:IMMediate][:AMPLitude] syntax: [:SOURce[n]][:CHANnel[m]]:POWer[:LEVel][:IMMediate][:AMPLitude] [PW|NW|UW|MW|Watt|DBM] description: Sets the power of the laser output. NOTE If an optical attenuator is installed, the power value returned is dependent on whether you are using power or attenuation mode (see “[:SOURce[n]][:CHANnel[m]]:POWer:ATTenuation:AUTO” on page 93). • If you are using power mode, the value returned is the output power. • If you are using attenuation mode, the value returned is the laser output power, and you must also use the attenuation value to calculate the output power (see “[:SOURce[n]][:CHANnel[m]]:POWer:ATTenuation[l]” on page 92). The values for the output power that you set in the Power Mode, and the laser output power that you set in the Attenuation Mode, are stored and used independently. NOTE The instrument may not be able to output a signal with the maximum programmable power, it will output a signal with the maximum power. Use the “[:SOURce[n]][:CHANnel[m]]:POWer[:LEVel][:IMMediate][:AMPLitude]” on page 94 to query the power being output. The default units are DBM or W, depending on the unit selected using the following com- mand: “[:SOURce[n]][:CHANnel[m]]:POWer:UNIT” on page 96. parameters: Any value in the specified range (see the appropriate User’s Guide). Also allowed are: MIN: minimum programmable value MAX: maximum programmable value DEF: This is not the preset (*RST) default value, but is half the sum of the minimum programmable value and the maximum pro- grammable level response: none example: sour2:pow 23uW affects: All tunable laser and DFB source modules

Measurement Operations & Settings HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299 95 command: [:SOURce[n]][:CHANnel[m]]:POWer[:LEVel][:IMMediate][:AMPLitude[l]]? syntax: [:SOURce[n]][:CHANnel[m]]:POWer[:LEVel][:IMMediate][:AMPLitude[l]]? [MIN|DEF|MAX] description: Returns the amplitude level of the output power. The value returned is the actual amplitude that is output, which may be dif-ferent from the value set for the output. If these two figures are not the same, it is indicated in the :STA- Tus:OPERation register. NOTE If an optical attenuator is installed, the power value returned is dependent on whether you are using power or attenuation mode (see “[:SOURce[n]][:CHANnel[m]]:POWer:ATTenuation:AUTO” on page 93). • If you are using power mode, the value returned is the output power. • If you are using attenuation mode, the value returned is the laser output power, and you must also use the attenuation value to calculate the output power (see “[:SOURce[n]][:CHANnel[m]]:POWer:ATTenuation[l]” on page 92). The values for the output power that you set in the Power Mode, and the laser output power that you set in the Attenuation Mode, are stored and used independently. parameters: Also allowed (for tunable laser modules only) are: MIN: minimum amplitude level MAX: maximum amplitude level DEF: This is not the preset (*RST) default value but is half the sum of, the minimum amplitude level and the maximum amplitude level NOTE Use [l] to query the amplitude level of the output power of the upper or lower wavelength laser source of a dual-wavelength laser source or a return loss module with an internal dual-wavelength laser source. The default value of [l] is 1, the lower wavelength source. The upper wavelength source is denoted by 2. response: Amplitude level relevant to the current value or specified parameter (if MIN, MAX, or DEF are chosen as a parameter). example: sour2:pow? → +8.00000000E-004 affects: All laser source, DFB source, and tunable laser modules and return loss modules with an internal source command: [:SOURce[n]][:CHANnel[m]]:POWer[:LEVel]:RISetime syntax: [:SOURce[n]][:CHANnel[m]]:POWer[:LEVel]:RISetime[NS|US|MS|S] description: Sets the laser rise time of the chosen source. parameters: Any value in the specified range (see the appropriate User’s Guide). Also allowed are: MIN: minimum programmable value MAX: maximum programmable value DEF: This is not the preset (*RST) default value but is half the sum of, the minimum programmable level and the maximum programmable level response: none example: sour2:pow:ris 10ns affects: All tunable laser and DFB source modules

Signal Generation – The SOURce Subsystem 96 HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299 command: [:SOURce[n]][:CHANnel[m]]:POWer[:LEVel]:RISetime? syntax: [:SOURce[n]][:CHANnel[m]]:POWer[:LEVel]:RISetime?[MIN|DEF|MAX] description: Returns the laser rise time of the chosen source. parameters: Also allowed are: MIN: minimum programmable value MAX: maximum programmable value DEF: This is not the preset (*RST) default value but is half the sum of, the minimum programmable level and the maximum programmable level response: The rise time as a float value in seconds. example: sour2:pow:ris? → +1.00000000E-009 affects: All tunable laser and DFB source modules command: [:SOURce[n]][:CHANnel[m]]:POWer:STATe syntax: [:SOURce[n]][:CHANnel[m]]:POWer[1|2]:STATe description: Switches the laser of the chosen source on or off. parameters: A boolean value: 0: Laser Off 1: Laser On response: none example: sour2:pow:stat 1 affects: All laser source, DFB source, and tunable laser modules and return loss modules with an internal source command: [:SOURce[n]][:CHANnel[m]]:POWer:STATe? syntax: [:SOURce[n]][:CHANnel[m]]:POWer:STATe? description: Queries the laser state of the chosen source. parameters: none response: A boolean value: 0: Laser Off 1: Laser On example: sour2:pow:stat? → 1 affects: All laser source, DFB source, and tunable laser modules and return loss modules with an internal source command: [:SOURce[n]][:CHANnel[m]]:POWer:UNIT syntax: [:SOURce[n]][:CHANnel[m]]:POWer:UNITDBM|0|Watt|1 description: Sets the power units parameters: 0 or DBM: 1 or W: dBm (default) Watts response: none example: sour2:pow:unit w affects: All tunable laser and DFB source modules

Measurement Operations & Settings HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299 97 command: [:SOURce[n]][:CHANnel[m]]:POWer:UNIT? syntax: [:SOURce[n]][:CHANnel[m]]:POWer:UNIT? description: Return the current power units parameters: 0: 1: dBm Watts response: none example: sour2:pow:unit? → +0 affects: All tunable laser and DFB source modules command: [:SOURce[n]][:CHANnel[m]]:POWer:WAVelength syntax: [:SOURce[n]][:CHANnel[m]:POWer:WAVelength[LOWer|UPPer|BOTH] NOTE For compatibility reasons, WAVelength may be replaced with WAVE. description: Sets the wavelength source for a dual-wavelength laser source. parameters: LOWer: UPPer: BOTH: The lower wavelength source The upper wavelength source Both wavelength sources response: none example: sour2:pow:wav upp affects: All dual-wavelength laser source modules and return loss modules with two internal sources command: [:SOURce[n]][:CHANnel[m]]:POWer:WAVelength? syntax: [:SOURce[n]][:CHANnel[m]:POWer:WAVelength? NOTE For compatibility reasons, WAVelength may be replaced with WAVE. description: Returns the wavelength source for a dual-wavelength laser source. parameters: none response: LOW UPP BOTH The lower wavelength source The upper wavelength source Both wavelength sources example: sour2:pow:wav? → LOW affects: All dual-wavelength laser source modules and return loss modules with two internal sources

Signal Generation – The SOURce Subsystem 98 HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299 command: [:SOURce[n]][:CHANnel[m]]:READout:DATA? syntax: [:SOURce[n]][:CHANnel[m]:READout:DATA? description: Returns the data as a binary stream from either a lambda logging operation or the maxi- mum power the laser can produce at each wavelength. parameters: LLOGging: PMAX: Returns a binary stream that contains each wavelength step of the lambda logging operation, see “[:SOURce[n]][:CHANnel[m]]:WAVelength:SWEep:LLOGging” on page 103. Each binary block is an 8-byte long double in Intel byte order. Returns a binary stream that contains the maximum power the laser can produce at each wavelength. Each binary block is a 8-byte long double (the wavelength value) followed by a 4-byte long float (the power value). The stream is in Intel byte order. response: A binary stream in Intel byte order. example: sour2:read:data? llog → the data as a binary stream affects: All tunable laser and DFB source modules command: [:SOURce[n]][:CHANnel[m]]:READout:POINts? syntax: [:SOURce[n]][:CHANnel[m]:READout:POINts?LLOGging|PMAX description: Returns the number of datapoints that the [:SOURce[n]][:CHANnel[m]]:READout:DA- TA? command will return. parameters: LLOGging: PMAX: Returns the number of wavelength steps for a lambda logging operation, see “[:SOURce[n]][:CHANnel[m]]:WAVelength:SWEep:LLOGging” on page 103. Returns the number of datapoints (each datapoint contains a value for wavelength and power) the [:SOURce[n]][:CHANnel[m]]:READout:DA- TA? PMAX command will return, number of datapoints depends on the calibration data for your module. response: The number of datapoints as an integer value. example: sour2:read:poin? pmax → 120 affects: All tunable laser and DFB source modules

Measurement Operations & Settings HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299 99 command: [:SOURce[n]][:CHANnel[m]]:WAVelength[:CW|:FIXED] syntax: [:SOURce[n]][:CHANnel[m]]:WAVelength[:CW|:FIXED] [PM|NM|UM|MM|M] description: Sets the absolute wavelength of the output. parameters: Any wavelength in the specified range (see the specifications in the appropriate User’s Guide). The programmable range is larger than the range specified in the User’s Guide. The pro- grammable range is set individually for each instrument when it is calibrated during pro- duction. Also allowed are: MIN: minimum wavelength value MAX: maximum wavelength value DEF: This is not the preset (*RST) default value but is half the sum of, the minimum wavelength value and the maximum wavelength value The default units are M. response: none example: sour2:wav 1550NM affects: All tunable laser and DFB source modules command: [:SOURce[n]][:CHANnel[m]]:WAVelength[:CW[l]|:FIXED[l]]? syntax: [:SOURce[n]][:CHANnel[m]:WAVelength[:CW[l]|:FIXED[l]]?[[MIN|DEF|MAX] description: Returns the wavelength value in meters. NOTE Use [l] to query the upper or lower wavelength laser source of a dual-wavelength laser source. The default value of [l] is 1, the lower wavelength source. The upper wavelength source is denoted by 2. parameters: none Also allowed (for tunable laser modules only) are: MIN: minimum wavelength MAX: maximum wavelength DEF: This is not the preset (*RST) default value but is half the sum of, the minimum wavelength value and the maximum wavelength value response: The wavelength as a float value in meters. example: sour0:wav? → +1.5672030E-006 sour0:wav? min → +1.5500000E-006 sour2:wav:fixed2? → +1.61544494E-006 Returns the current wave- length value for a tunable laser module. Returns minimum wave- length for a tunable laser module. Returns the wavelength val- ue of the upper wavelength source of a dual-wavelength laser source. affects: All laser source, DFB source, and tunable laser modules and return loss modules with an internal source

Signal Generation – The SOURce Subsystem 100 HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299 command: [:SOURce[n]][:CHANnel[m]]:WAVelength:CORRection:ARA syntax: [:SOURce[n]][:CHANnel[m]]:WAVelength:CORRection:ARA description: Realigns the laser cavity. parameters: none response: none example: sour2:wav:corr:ara affects: All tunable laser modules except HP 81689A command: [:SOURce[n]][:CHANnel[m]]:WAVelength:CORRection:ZERO syntax: [:SOURce[n]][:CHANnel[m]]:WAVelength:CORRection:ZERO description: Executes a wavelength zero. parameters: none response: none example: sour2:wav:corr:zero affects: All tunable laser modules except HP 81689A command: [:SOURce[n]][:CHANnel[m]]:WAVelength:FREQuency syntax: [:SOURce[n]][:CHANnel[m]]:WAVelength:FREQuency [THZ|GHZ|MHZ|KHZ|HZ] description: Sets the frequency difference used to calculate a relative wavelength. The output wave- length is made up of the reference wavelength and this frequency difference. The default units for frequency are Hertz. The output wavelength (λ) is set from the base wavelength (λ0) and the frequency offset (df). The formula for calculating the output wavelength is: where c is the speed of light in a vacuum (2.990 x 108 ms-1) parameters: The frequency difference is a float value in Hz. response: none example: sour2:wav:freq -10THZ affects: All tunable laser and DFB modules command: [:SOURce[n]][:CHANnel[m]]:WAVelength:FREQuency? syntax: [:SOURce[n]][:CHANnel[m]]:WAVelength:FREQuency? description: Returns the frequency difference used to calculate a relative wavelength. parameters: none response: Returns the frequency difference as a float value in Hz. example: wav:freq? → -1.00000000E+013 affects: All tunable laser and DFB modules λ c ( ) (λodf ) + c ( ) ------------------------------ λo =