Table of Contents

Advertisement

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

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the 8163A/B and is the answer not in the manual?

Questions and answers

Subscribe to Our Youtube Channel

Summary of Contents for Keysight Technologies 8163A/B

  • Page 1 8163A/B Lightwave Multimeter, 8164A/B Lightwave Measurement System, & 8166A/B Lightwave Multichannel System Programming Guide...
  • Page 2: Safety Notices

    The license set forth in the EULA represents CHANTABILITY AND FITNESS FOR A PAR- the exclusive authority by which the U.S. TICULAR PURPOSE. KEYSIGHT SHALL NOT government may use, modify, distribute, or BE LIABLE FOR ERRORS OR FOR INCIDEN- 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 3: Table Of Contents

    Command and Query Syntax Common Commands Common Command Summary Common Status Information The Status Model Status Registers Status System for 8166A/B Annotations Status Command Summary Other Commands 2 Specific Commands Specific Command Summary 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 4 IEEE Commands Status Commands User Calibration Data Signal Routing Triggering - The TRIGger Subsystem Extended Trigger Configuration Extended Trigger Configuration Example 5 Mass Storage, Display, and Print Functions Display Operations – The DISPlay Subsystem 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 5 Features of the Keysight 816x Instrument Driver Directory Structure Opening an Instrument Session Closing an Instrument Session VISA Data Types and Selected Constant Definitions Error Handling Introduction to Programming Example Programs VISA-Specific Information Development Environments Online Information 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 6 GPIB Bus Compatibility Status Model Preset Defaul ts Removed Command Obsolete Commands Changed Parameter Syntax and Semantics Changed Query Resul t Values Timing Behavior Error Handling Command Order 9 Error Codes GPIB Error Strings Index 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 7: Introduction To Programming

    Descriptions for the actual commands for the instruments are given in the following chapters. The information in these chapters is specific to the 8163A/B Lightwave Multimeter, 8164A/B Lightwave Measurement System, and 8166A/B Lightwave Multichannel System and assumes that you are already familiar with programming the GPIB.
  • Page 8: Gpib Interface

    Web: http://www.ivifoundation.org/docs/scpi-99.pdf See also: http://www.ivifoundation.org/scpi/ The interface of the 8163A/B Lightwave Multimeter, 8164A/B Lightwave Measurement System, and 8166A/B Lightwave Multichannel System to the GPIB is defined by the IEEE Standards 488.1 and 488.2. Table 1 on page -9 shows the interface functional subset that the instruments implement.
  • Page 9 User’s Guide for more information. The default GPIB address is 20. GPIB address 21 is often applied to the GPIB controller. If so, 21 cannot be used NOTE as an instrument address. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 10: Lan Interface

    This means, for example, if a device is locked in a VISA socket connection it can still be accessed with VXI-11. • A telnet connection cannot be locked. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 11 The Agilent VISA Assistant is confused by ‘newline’ inside a reply. In this case, click the button [viScanf] until the whole reply is read. • VXI-11 connections are about 50% slower than Socket 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 12: Returning The Instrument To Local Control

    -12 will appear. Press [Local] if you wish to return the instrument to local control. Figure 1 Remote Control If your 8163A/B, 8164A/B or 8166A/B mainframe is in local lockout mode (refer NOTE on page 226) the Local softkey is not available. :DISPlay:LOCKout...
  • Page 13: Message Queues

    ), 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. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 14: The Error Queue

    + 0, "N -113, "Undefined header" -113, "Undefined header" If more than 29 errors are put into the queue, the message: -350, "Queue overflow" is placed as the last message in the queue. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 15: Programming And Syntax Diagram Conventions

    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. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 16 PM, NM, UM, MM, M decibel MDB, DB second NS, US, MS, S decibel/1mW MDBM, DBM Hertz HZ, KHZ, MHZ, GHZ, THZ Watt Watt PW, NW, UW, MW, Watt meters per second NM/S, UM/S, MM/S, M/S 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 17 VISA COM interface is used, then its IFormattedIO488 interface is very convenient, setting the property InstrumentBigEndian to "false" and using the READIEEEBlock method. Note that within your program, calculations with wavelengths may require NOTE double-precision 64-bit floats to provide the desired resolution. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 18 [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 8163A/B, • from zero to four for the 8164A/B, and • from one to seventeen for the 8166A/B.
  • Page 19 If you do not specify a slot or channel number, the lowest possible number is NOTE used as the default value. This means: • Slot 1 for the 8163A/B and 8166A/B mainframes. • Slot 0 for the 8164A/B mainframe. • Channel 1 for all channels.
  • Page 20: Common Commands

    *RST Reset Command page *STB? Read Status Byte Query page *TST? Self Test Query page *WAI Wait Command page These commands are described in more detail in IEEE-Common Commands NOTE page 46. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 21: Common Status Information

    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. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 22 The Status Model on page 23 and Status Reporting – The STATus Subsystem on page 55. Unused bits in any of the registers change to 0 when you read them. NOTE 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 23: The Status Model

    The structures of the Operational and Questionable Status Systems are similar. Figure 4 on page -26describes how the Questionable Status Bit (QSB) and the Operational Status Bit (OSB) of the Status Byte Register are determined. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 24 If, for any slot, any bit of the QSSER goes from 0 -> 1 AND the corresponding bit of the QSSEM is 1 at the same time, the QSESR bit representing that slot is set to 1. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 25 OSESM/QSESM to be set to 0. The Operational/Questionable Status Enable Summary Mask for the 8163A/B Lightwave Multimeter and the 8164A/B Lightwave Measurement System consists of one level. These are described in Status System for 8163A/B &...
  • Page 26: Status System For 8166A/B

    Introduction to Programming The status system for the 8163A/B Lightwave Multimeter and the 8164A/B Lightwave Measurement System returns the status of 2 and 5 module slots respectively. The Operational/Questionable Status Summary Registers consist of one level and are described by Figure 4.
  • Page 27 4. Bit 0 of the Level 0 summary registers represents the summary of the status of module slots 15, 16, and 17. The Level 1 summary registers contain an individual summary for each of these module slots. Figure 5 The Operational/Questionable Status System for 8166A/B 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 28: Annotations

    • 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. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 29 Bit 10 is set if lambda zeroing is recommended. • Bit 11 is set if the 81490A transmitter needs to be calibrated. • Bit 12 is set if the 81950A frequency offset does not equal zero. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 30: Status Command Summary

    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. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 31: Specific Commands

    Specific Command Summary / 32 This chapter lists all the instrument specific commands relating to the 8163A/B Lightwave Multimeter, the 8164A/B Lightwave Measurement System, and the 8166A/B Lightwave Multichannel System with a single-line description. Each of these summaries contains a page reference for more detailed...
  • Page 32: Specific Command Summary

    :WAVelength:VALue:DELete:ALL Deletes all value pairs from the offset table. page :WAVelength:VALue:OFFSet? Queries an offset value according to wavelength or index. page :WAVelength:VALue:PAIR? Queries an offset/wavelength value pair according to wavelength or index. page 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 33 Sets or queries the shutter status at power on. page :ATIMe/? Sets or queries the powermeter averaging time. page :CONNection/? Selects or returns Analog Output parameter. page :CORRection:COLLection:ZERO Zeros the offsets of attenuators powermeter page 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 34 Reads the current return loss value. page :ROUTe[n] [:CHANnel[m]]/? Sets or returns the channel route between two ports. page [:CHANnel[m]]:CONFig? Reads the switch configuration of an instrument. page [:CHANnel[m]]:CONFig:ROUTe? Reads the allowed switch routes of an instrument. page 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 35 Sets or returns the reference level of a sensor. page :UNIT/? Sets or returns the units used for absolute readings on a sensor. page :WAVelength/? Sets or returns the wavelength for a sensor. page 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 36 Returns whether an optical head is connected. page :IDN? Returns information about the optical head. page :OPTions? Returns the optical head’s options. page :TST? Returns the latest selftest results for an optical head. page 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 37 :STATe/? Sets or returns the state of the source output signal. page :UNIT/? Sets or returns the power units. page :WAVelength/? Sets or returns the wavelength source of a dual-wavelength source. page 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 38 Reports the current lambda zero temperature page :ZERO:TEMPerature:DIFFerence? Reports the temperature difference required to trigger an auto lamda zero. page :ZERO:TEMPerature:LASTzero? Reports the temperature at which the last auto lamda zero took place. page 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 39 Page :ZERO:AUTO Forces an auto lamda zero. This is quicker than the equilavent manual page process. [:SOURce[n]][:CHANnel[m]:]WAVelength:REFerence :DISPlay Sets the reference wavelength of a source to the value of the output page wavelength. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 40 Stops, starts, pauses or continues a wavelength sweep or returns the the state page of a sweep. [:SOURce[n]][:CHANnel[m]:]WAVelength:SWEep:STEP :NEXT Performs the next sweep step. page :PREVious Performs the previous sweep step again. page [:WIDTh]/? Sets or returns the width of the sweep step. page 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 41 :ENABle/? Sets or queries the Questionable Status Enable Summary Mask. page :ENABle:LEVel1/? Sets or queries the Questionable Status Enable Summary Mask for slots 15 - page 17 of the 8166A/B Lightwave Multichannel System. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 42 Set and returns the domain name. page :ETHernet:SMASk/? Set and returns the subnet mask. page :ETHernet:DGATeway/? Set and returns the default gateway. page :ETHernet:RESTart Restart the system’s network interface with the new parameters. page 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 43 Sets or returns the number of incoming triggers received before data logging page begins :INPut:REARm/? Re-arms input trigger page :OUTPut/? Sets or returns the outgoing trigger response. page :OUTPut:REARm/? Re-arms output trigger page 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 45 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide Instrument Setup and Status IEEE-Common Commands / 46 Status Reporting – The STATus Subsystem / 55 Interface/Instrument Behaviour Settings – The SYSTem Subsystem / 68 This chapter gives descriptions of commands that you can use when setting up your instrument.
  • Page 46: Ieee-Common Commands

    Instrument Setup and Status IEEE-Common Commands Common Commands on page 20 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. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 47 The register is not changed by the *RST and *CLS commands. parameters: The bit value for the register (a 16-bit signed integer value): Mnemonic Decimal Value 7 (MSB) Power On Not Used Command Error Execution Error Device Dependent Error Query Error Not Used 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 48 The bit value for the register (a 16-bit signed integer value): Mnemonic Decimal Value 7 (MSB) Power On Not used Command Error Execution Error Device Dependent Error Query Error 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 49 Instrument Setup and Status Not used 0 (LSB) Operation Complete -> example: *ESR? 21<END> 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 50 *IDN? -> Keysight Technologies,8164B,DE42100168,V5.25(72634)<END> Depending on the date of production, the manufacturer will be reported as Keysight Technologies, Agilent Technologies or HEWLETT-PACKARD. :SLOT[n]:IDN? :SLOT[n]:HEAD[n]:IDN? on page 81 for information on module identity strings and on page 82 for information on optical head identity strings.
  • Page 51 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 8164A/B and Slot 1 for the 8163A/B and 8166A/B. 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.
  • Page 52 The bit value for the register (a 16-bit signed integer value): Mnemonic Decimal Value 7 (MSB) Operation Status (OSB) Not used Event Status Bit (ESB) Message Available (MAV) Questionable Status (QSB) Not used Not used Not used -> example: 128<END> *STB? 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 53 Selftest failed on Slot 7 Selftest failed on Slot 6 Selftest failed on Slot 5 Selftest failed on Slot 4 Selftest failed on Slot 3 Selftest failed on Slot 2 Selftest failed on Slot 1 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 54 *WAI blocks the GPIB bus to all commands until every module hosted by the instrument is no longer busy. All pending operations, are completed during the wait period. parameters: none response: none example: *WAI 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 55: Status Reporting - The Status Subsystem

    Slot 3 Summary Slot 2 Summary Slot 2 Summary Slot 2 Summary Slot 1 Summary Slot 1 Summary Slot 1 Summary Not used Slot 0 Summary Level 1 Summary -> example: stat:oper? +0<END> 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 56 Slot 3 Summary Slot 2 Summary Slot 2 Summary Slot 2 Summary Slot 1 Summary Slot 1 Summary Slot 1 Summary Not used Slot 0 Summary Level 1 Summary -> example: stat:oper:cond? +0<END> 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 57 ≤ ≤ response: The sum of the results for the slots (a 16-bit signed integer value, where 0 value 32767): Bits Mnemonics Decimal Value 8166A/B 15-4 Not used Slot 17 Summary 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 58 Setting a bit in this register to 1 enables the corresponding bit in the OSESR for slots 15 - 17 of the 8166A/B Lightwave Measurement System to affect bit 7 of the Status Byte. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 59 Slot n: Coherence Control has been switched on Slot n: Laser has been switched on -> example: stat1:oper? +0<END> command: :STATusn:OPERation:CONDition? syntax: :STATusn:OPERation:CONDition? description: Returns the Operational Slot Status Condition Register of slot n. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 60 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 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 61 :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 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 62 Slot 3 Summary Slot 2 Summary Slot 2 Summary Slot 2 Summary Slot 1 Summary Slot 1 Summary Slot 1 Summary Not used Slot 0 Summary Level 1 Summary -> example: stat:ques? +0<END> 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 63 Slot 3 Summary Slot 2 Summary Slot 2 Summary Slot 2 Summary Slot 1 Summary Slot 1 Summary Slot 1 Summary Not used Slot 0 Summary Level 1 Summary -> example: stat:ques:cond? +0<END> 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 64 ≤ response: The sum of the results for the slots (a 16-bit signed integer value, where 0 value 32767): Bits Mnemonics Decimal Value 8166A/B 15-4 Not used Slot 17 Summary Slot 16 Summary 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 65 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 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 66 Slot n: Excessive Value has occurred Every nth bit is the summary of slot n. -> example: stat1:oper? +0<END> command: :STATusn:QUEStionable:CONDition? syntax: :STATusn:QUEStionable:CONDition? description: Returns the Questionable Slot Status Condition Register for slot n. parameters: none 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 67 :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<END> 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 68: Interface/Instrument Behaviour Settings - The System Subsystem

    Error codes are numbers in the range -32768 and +32767. Negative error numbers are defined by the SCPI standard. Positive error numbers are device dependent. parameters: none response: The number of the latest error, and its meaning. -> example: syst:err? -113,"Undefined header"<END> 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 69 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 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 70 The time in the format hour, minute, second. Hours are counted 0...23 (16-bit signed integer values). -> example: syst:time? +20,+15,+30<END> 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<END> 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 71: System Communicate - The :Syst:communicate Sub Tree

    :SYSTem:COMMunicate:GPIB[:SELF]:ADDRess syntax: :SYSTem:COMMunicate:GPIB[:SELF]:ADDRess<wsp><GPIB Address> description: Sets the GPIB address. parameters: The GPIB Address Values allowed 0-30 21 is often reseverved by the GPIB Controller. response: none example: SYST:COMM:GPIB:ADDR 20 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 72 (hexadecimal value without a prefix or separators). -> example: :syst:comm:eth:mac? “0007E014AE08”<END> command: :SYSTem:COMMunicate:ETHernet:IPADdress:CURRent? syntax: :SYSTem:COMMunicate:ETHernet:IPADdress:CURRent? description: Get the current IP address of the instrument. parameters: none response: string -> example: :syst:comm:eth:ipad:curr? “192.132.13.2”<END> 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 73 Get the current host name. parameters: none response: string -> example: :syst:comm:eth:host:curr? “A-8164B-1234567”<END> command: :SYSTem:COMMunicate:ETHernet:DOMainname:CURRent? syntax: :SYSTem:COMMunicate:ETHernet:DOMainname:CURRent? description: Get the currently used domain name. parameters: none response: string -> example: :syst:comm:eth:dom:curr? “.companyame.com”<END> 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 74 (0 | 1 | off | on) response: none example: :syst:comm:eth:dhcp:enab on command: :SYSTem:COMMunicate:ETHernet:DHCP:ENABle? syntax: :SYSTem:COMMunicate:ETHernet:DHCP:ENABle? description: Check whether DHCP is enabled or disabled. parameters: none response: boolean (0 | 1) -> example: :syst:comm:eth:dhcp:enab? 1<END> 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 75 Set the IP address of the system manually (used if DHCP is disabled). parameters: string (Up to four groups of up to 3 digits, groups separated by ".". Groups with leading zeroes are interpreted as octal numbers.) response: none example: :syst:comm:eth:ipad “192.132.13.2” 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 76 Set the domain name (used if DHCP is disabled). parameters: string response: none example: :syst:comm:eth:dom “.companyname.com” command: :SYSTem:COMMunicate:ETHernet:DOMainname? syntax: :SYSTem:COMMunicate:ETHernet:DOMainname? description: Get the domain name. parameters: none response: string -> example: :syst:comm:eth:dom? “.companyname.com”<END> 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 77 Set the default gateway. parameters: string (Up to four groups of up to 3 digits, groups separated by ".". Groups with leading zeroes are interpreted as octal numbers.) response: none example: :syst:comm:eth:dgat “192.168.101.11“ 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 78 This command only works if the instrument has a working network connection at the time the command is issued. If not you either have to wait until the instrument decides on an IP address using AutoIP or reboot the instrument. parameters: none response: string example: :syst:comm:eth:rest 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 79: Measurement Functions - The Sense Subsystem

    8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide Measurement Opera- tions & Settings Root Layer Command / 80 Measurement Functions – The SENSe Subsystem / 86 Signal Generation – The SOURce Subsystem / 122 Signal Conditioning / 182 Signal Routing / 206...
  • Page 80: Root Layer Command

    • 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?. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 81 -> example: slot1:idn? HEWLETT-PACKARD, 81533B,3411G06054,07-Aug-98<END> Depending on the date of production, the manufacturer will be reported as Keysight Technologies, Agilent Technologies or HEWLETT-PACKARD. *IDN? :SLOT[n]:HEAD[n]:IDN? on page 50 for information on mainframe identity strings. See on page 82 for information on optical head identity strings.
  • Page 82 Optical heads command: :SLOT[n]:HEAD[n]:IDN? syntax: :SLOT[n]:HEAD[n]:IDN? description: Returns information about the optical head. parameters: none response: MMMMMMMM manufacturer mmmm instrument model number (for example 81520A) ssssssss serial number rrrrrrrrrr date of firmware revision 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 83 Keysight Technologies,81623B,DE41300402,V4.01(1126) affects: Optical heads Depending on the date of production, the manufacturer will be reported as Keysight Technologies, Agilent Technologies or HEWLETT-PACKARD. *IDN? on page 50 for information on mainframe identity strings, :SLOT[n]:HEAD[n]:IDN? on page 82 for information on module identity strings.
  • Page 84 One 8 byte long wavelength calibration value pair consisting of a 4 byte long float for wavelength and a 4 byte long float for format: the scalar calibration factor. Data Types For more information on binary block formats see on page 17. -> example: slot1:head1:wav:resp? #536570..affects: Attenuator with power control, all powermeters, return loss modules 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 85 Number of elements in the wavelength table as an integer value -> example: slot2:head1:wav:resp:size? 50<END> affects: Attenuator with power control, all powermeters, return loss modules command: :SPECial:REBoot syntax: :SPECial:REBoot description: Reboots the mainframe and all modules. parameters: none response: none example: spec:reb 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 86 Commands that can only be configured using the master channel Command Page :INITiate[n]:[CHANnel[m]][:IMMediate] page :INITiate[n]:[CHANnel[m]]:CONTinuous/? page :READ[n][:CHANnel[m]][:SCALar]:POWer[:DC]? page :SENSe[n]:[CHANnel[m]]:CORRection:COLLect:ZERO page :SENSe[n][:CHANnel[m]]:FUNCtion:PARameter:LOGGing/? page :SENSe[n][:CHANnel[m]]:FUNCtion:PARameter:MINMax/? page :SENSe[n][:CHANnel[m]]:FUNCtion:PARameter:STABility/? page :SENSe[n][:CHANnel[m]]:FUNCtion:STATe/? page :SENSe[n]:[CHANnel[m]]:POWer:ATIME/? page :SENSe[n]:[CHANnel[m]]:POWer:RANGe:AUTO/? page :TRIGger[n][:CHANnel[m]]:INPut/? page :TRIGger[n][:CHANnel[m]]:INPut:REARm/? page :TRIGger[n][:CHANnel[m]]:OUTPut/? page :TRIGger[n][:CHANnel[m]]:OUTPut:REARm/? page 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 87: Channels

    Command Page :FETCh[n][:CHANnel[m]][:SCAlar]:POWer[:DC]? page :ROUTe[n][:CHANnel[m]]/? page :ROUTe[n][:CHANnel[m]]:CONFig? page :ROUTe[n][:CHANnel[m]]:CONFig:ROUTe? page :SENSe[n]:[CHANnel[m]]:CORRection[:LOSS][:INPut] [:MAGNitude]/? page :SENSe[n]:[CHANnel[m]]:CORRection:COLLect:ZERO? page :SENSe[n]:[CHANnel[m]]:CORRection:COLLect:ZERO:ALL page :SENSe[n][:CHANnel[m]]:FUNCtion:RESult? page :SENSe[n]:[CHANnel[m]]:POWer:RANGe[:UPPer]/? page :SENSe[n]:[CHANnel[m]]:POWer:REFerence/? page :SENSe[n]:[CHANnel[m]]:POWer:REFerence:DISPlay page :SENSe[n]:[CHANnel[m]]:POWer:REFerence:STATe/? page :SENSe[n]:[CHANnel[m]]:POWer:REFerence:STATe:RATio/? page :SENSe[n]:[CHANnel[m]]:POWer:UNIT/? page :SENSe[n]:[CHANnel[m]]:POWer:WAVelength/? page 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 88 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 value as a float value in dB. -> example: fetc1:ret? +6.73370400E-00<END> affects: All return loss modules 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 89 Can only be sent to master channel, slave channel is also affected. command: :INITiate[n]:[CHANnel[m]]:CONTinuous syntax: :INITiate[n]:[CHANnel[m]]:CONTinuous<wsp><boolean> 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 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 90 Measurement Operations & Settings example: init2:cont 1 affects: All power meters, return loss modules. dual sensors: Can only be sent to master channel, slave channel is also affected. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 91 +1.33555600E-006|+1.34789100E-006|+1.37456900E-006<END> affects: All power meters (v3.0x firmware or later). dual sensors: Master channels receive a read command, see: :READ[n][:CHANnel[m]][:SCALar]:POWer[:DC]? on page 92. Slave channels receive a fetch command, see: :FETCh[n][:CHANnel[m]][:SCAlar]:POWer[:DC]? on page 88. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 92 The current power meter reading as a float value in dBm, W or dB. If the reference state is absolute, units are dBm or W. If the reference state is relative, units are dB. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 93 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 W or dBm -> example: read1:mon? +1.33555600E-000<END> affects: All return loss modules 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 94 All power meters dual sensors: Master and slave channels are independent. 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 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 95 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. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 96 MinMax functions and vice versa. You must use the :SENSe[n][:CHANnel[m]]:FUNCtion:PARameter:LOGGing page 97 command to set parameters before you start a logging function using on page 104 command. :SENSe[n][:CHANnel[m]]:FUNCtion:STATe 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 97 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, t , as a float value in seconds. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 98 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 8163A/B Lightwave Multimeter, 8164A/B Lightwave Measurement System, & 8166A/B Lightwave Multichannel System User’s Guide, for more information on MinMax mode.
  • Page 99 The total time from the start of stability mode until it is completed. Period time: A new measurement is started after the completion of every period time. Averaging time: A measurement is averaged over the averaging time. Averaging Time Period Time Measurement Running Measurement Stopped 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 100 For Logging and Stability Data Acquisition functions, one measurement value is a 4-byte-long float in Intel byte order. For the MinMax Data Acquisition function, the query returns the minimum, maximum and current power values. Data Types on page 17 for more information on Binary Blocks. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 101 All power meters and return loss modules . dual sensors: Master and slave channels are independent. Return Loss modules: For Logging and Stability Data Acquisition functions, the data array contains power values. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 102 An integer value, number of data points. Data Types on page 17 for more information on Binary Blocks. example: affects: All power meters and return loss modules. dual sensors: Master and slave channels are independent. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 103 For Logging and Stability Data Acquisition functions, the data array contains power values for the monitor diode. For the MinMax Data Acquisition function, the data array contains return loss values for the monitor diode. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 104 Start data acquisition function When you enable a logging data acquisition function for a 8163A/B Series Power Meter with averaging time of less than 100 ms with input hard ware triggering disabled, all GPIB commands will be ignored for the duration of the function.
  • Page 105 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 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 106 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 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 107 Measurement Operations & Settings example: sens1:pow:rang -20DBM affects: All power meters and return loss modules. dual sensors: Master and slave channels are independent. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 108 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:mon -20DBM affects: All return loss modules. dual sensors: Master and slave channels are independent. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 109 :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. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 110 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 measurement relative to a constant TOREF: reference value response: The reference as a float value. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 111 Measurement Operations & Settings -> example: sens1:pow:ref? toref +1.00000000E-006<END> affects: All power meters dual sensors: Master and slave channels are independent. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 112 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 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 113 Measurement Operations & Settings -> example: sens1:pow:ref:stat? 1<END> affects: All power meters dual sensors: Master and slave channels are independent. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 114 -> examples: sens1:pow:ref:stat:rat? +255,+0<END> results are displayed relative to an absolute reference -> sens1:pow:ref:stat:rat? +2,+1<END> results are displayed relative to channel affects: All power meters dual sensors: Master and slave channels are independent. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 115 Sets the sensor wavelength. Frequent use of this command can conflict with the timing of autoranging in some configurations. Autorange can be disabled before and enabled after the command if needed. parameters: The wavelength as a float value in meters. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 116 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 dual sensors: Master and slave channels are independent. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 117 For the currently selected source, start the calibration and save the calibration values for a defined reflectance reference :SENSe[n]:[CHANnel[m]]:RETurnloss:CORRection:REFLectance[l] measurement. See on page 121 for information on setting the return loss value of your reference reflector. parameters: none 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 118 :SENSe[n]:[CHANnel[m]]:RETurnloss:CALibration:TERMination? description: Queries the T-value (termination calibration value) for the return loss module parameters: none response: Termination calibration value as a float in dB -> example sens1:ret:cal:term? +6.5000E+001 affects: All return loss modules 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 119 1. monitor diode reference power 2. return loss diode reference power 3. monitor diode parasitics power 4. return loss diode parasitics power. parameters: Returns power values in W response: none example sens1:ret:cal:val affects: All return loss modules 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 120 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:corr:fpd? +8.00000000E-002<END> affects: All return loss modules 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 121 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:corr:refl? +1.80000000E-001<END> affects: All return loss modules 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 122: Signal Generation - The Source Subsystem

    LOWSse: The Low SSE output is regulated. BHRegulated: Both outputs are active but only the High Power output is Regulated. BLRegulated: Both outputs are active but only the Low SSE output is Regulated. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 123 1 or ON: switch laser current on response: none example: outp 1 affects: All laser sources, DFB sources, tunable laser modules and return loss modules with an internal source 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 124 The default value of [l] is 1, the lower wavelength source. The upper wavelength source is denoted by 2. response: none example: sour2:am:freq 270hz affects: All laser sources, DFB sources, and tunable laser modules except 81950A. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 125 (if MIN, MAX, or DEF is chosen as a parameter). example: sour2:am:freq? min -> +2.00000000E+002<END> affects: All laser sources, DFB sources, and tunable laser modules except 81950A. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 126 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 laser source. The default value of [l] is 1, the lower wavelength source. The upper wavelength source is denoted by 2. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 127 170, and modulation simultaneously, a sweep cannot be started, see [:SOURce[n]][:CHANnel[m]]:WAVelength:SWEep:[STATe] on page 176. response: none example: sour2:am:stat 0 affects: All laser sources, DFB sources, tunable laser modules except 81950A, and return loss modules containing an internal source. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 128 Queries the current level of coherence, when using Coherence Control. Coherence is expressed on an arbitrary scale from 1 to 99.98%. A 100% coherence level corresponds to maximum coherence length and minimum linewidth. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 129 Queries the type of frequency modulation currently set. Currently, only SBS Control is available. parameters: none response: SBS Control -> example: sour2:fm:sour? +0<END> affects: Keysight 81960A, 81980A, 81940A, 81989A, 81949A compact tunable lasers. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 130 Queries the current state of frequency modulation of the laser output. parameters: none response: A boolean value: 0: frequency modulation is disabled 1: frequency modulation is enabled. -> example: sour2:fm:state? +1<END> affects: Keysight 81960A, 81980A, 81940A, 81989A, 81949A compact tunable lasers. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 131 +4.00000E+03<END> affects: Keysight 81960A, 81980A, 81940A, 81989A, 81949A compact tunable lasers. command: [:SOURce[n]][:CHANnel[m]]:FM:SBSCtrl:LEVel[l] syntax: [:SOURce[n]][:CHANnel[m]]:FM:SBSCtrl:LEVel[l]<wsp>[MIN|MAX|DEF] description: Sets the excursion of the SBS Control frequency modulation to a percentage of its maximum value. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 132 DEF: returns the default preset (*RST) value. response: Returns the currently set excursion level as a percentage of its maximum value. -> example: sour2:fm:sbsc:lev? +8.000E+01<END> affects: Keysight 81960A, 81980A, 81940A, 81989A, 81949A compact tunable lasers. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 133 MIN - minimum programmable value MAX - maximum programmable value DEF - default value response: The current frequency value or the minimum, maximum, or default frequency value. example: sour1:freq? +1.88000000E+014 affects: 81950A Notes 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 134 MIN - minimum programmable value MAX - maximum programmable value DEF - default value response: The current reference frequency value or the minimum, maximum, or default reference frequency value in Hz. example: sour1:freq:ref? +1.93100000E+014 affects: 81950A Notes 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 135 MIN - minimum programmable value MAX - maximum programmable value DEF - default value response: The current grid spacing value or the minimum, maximum, or default grid spacing value in Hz. example: sour1:freq:grid? +5.00000000E+010 affects: 81950A Notes 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 136 The current grid channel value or the minimum, maximum, or default grid channel value. example: sour1:freq:chan? -20 affects: 81950A Notes The minimum, maximum, and default value depend on the current reference frequency and grid spacing values. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 137 MIN - minimum programmable value MAX - maximum programmable value DEF - default value response: The current frequency offset value or the minimum, maximum, or default frequency offset value in Hz. example: sour1:freq:offs? +1.00000000E+008 affects: 81950A Notes 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 138 Switch between "Auto Mode" and "Grid Mode" parameters: OFF or 0: "Grid Mode" (= Auto Mode off) ON or 1: "Auto Mode" response: None example: sour1:freq:auto on affects: 81950A Notes This command is equivalent to [:SOURce[n][:CHANnel[m]]:WAVelength:AUTO 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 139 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: sour0:mod 0 affects: Tunable laser sources with BNC output connector, except 81602A, 81606A, 81607A, 81608A and 81609A. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 140 Switches the internal modulation (SBS suppression) on or off. parameters: OFF or 0: Disable the modulation ON or 1: Enable the modulation response: None example: sour1:modu:int on affects: 81950A Notes SBSControl must be set to an appropriate value, too. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 141 Any value in the specified range (see appropriate User's Guide) Also allowed: MIN - minimum programmable value MAX - maximum programmable value DEF - default value response: None example: sour1:modu:int:sbsc 0.2GHz affects: 81950A Notes 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 142 81950A Notes command: [:SOURce[n]][:CHANnel[m]]:MODUlation:EXTernal[:STATe] syntax: [:SOURce[n]][:CHANnel[m]]:MODUlation:EXTernal[:STATe]<wsp>OFF|0|ON|1 description: Sets the state of the external amplitude modulation. parameters: OFF or 0: off ON or 1: on response: None example: sour1:modu:ext on affects: 81950A only Notes 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 143 Any value in the specified range (see appropriate User's Guide) Also allowed: MIN - minimum programmable value MAX - maximum programmable value DEF - default value response: None example: sour1:modu:ext:am 2.0 affects: 81950A only Notes 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 144 MIN - minimum programmable value MAX - maximum programmable value DEF - default value response: The current amplitude modulation level or the minimum, maximum, or default amplitude modulation level. example: sour1:modu:ext:am? +2.00000000E+000 affects: 81950A only Notes 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 145 MAX: maximum amplitude level only) are: DEF: This is not the preset (*RST) default value but is half the sum of, the minimum amplitude level and the maximum amplitude level 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 146 Queries whether the instrument is in Automatic or Manual Attenuation Mode. parameters: none response: Manual Attenuation Mode Automatic Attenuation Mode -> example: sour0:pow:att:auto? 1<END> affects: All tunable laser modules with a built-in optical attenuator. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 147 This command is available in Attenuation Mode Only. parameters: OFF or 0: Unsets dark position ON or 1: Sets dark position response: none example: sour0:pow:att:dark 1 affects: All tunable laser modules with a built-in optical attenuator. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 148 The default value of [l] is 1, the lower wavelength source. The upper wavelength source is denoted by 2. response: none example: sour2:pow 23uW affects: All tunable laser including 81950A and DFB source modules 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 149 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<END> affects: All laser sources, DFB sources, and tunable laser modules including 81950A and return loss modules with an internal source 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 150 2. response: The rise time as a float value in seconds. -> example: sour2:pow:ris? +1.00000000E-009<END> affects: All laser sources, DFB sources, and tunable laser modules and return loss modules with an internal source 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 151 0 or DBM: dBm (default) 1 or W: Watts response: none example: sour2:pow:unit w affects: All tunable laser including 81950A and DFB source modules command: [:SOURce[n]][:CHANnel[m]]:POWer:UNIT? syntax: [:SOURce[n]][:CHANnel[m]]:POWer:UNIT? description: Return the current power units 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 152 The lower wavelength source The upper wavelength source BOTH Both wavelength sources -> example: sour2:pow:wav? LOW<END> affects: All dual-wavelength laser source modules and return loss modules with two internal sources 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 153 All tunable laser and DFB source modules command: [:SOURce[n]][:CHANnel[m]]:READout:DATA:MAXBlocksize? syntax: [:SOURce[n]][:CHANnel[m]:READout:DATA:MAXBlocksize? description: Returns the maximum block size for a single GPIB transfer for lambda logging functions. If your application requires more data points please use SOURce[n]][:CHANnel[m]]:READout:DATA:BLOCk? instead of SOURce[n]][:CHANnel[m]]:READout:DATA? 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 154 Measurement Operations & Settings parameters: none response: The maximum number of data points (not bytes!) in the transferred block, as an integer value. -> example: sour0:read:data:maxb? 120<END> affects: All tunable laser and DFB source modules 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 155 The upper wavelength source is denoted by 2. For 81950A, only available in "Auto Mode". "CW" and "Fixed" are just present for backwards compatibility. response: none example: sour2:wav 1550NM affects: All tunable laser including 81950A and DFB source modules 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 156 Set the wavelength to the nearest grid point only changing the channel number. parameters: The wavelength value. response: none example: sour4:wav:togr 1.6um affects: 81950A Notes Only available in "Grid Mode" The frequency offset is neither changed nor taken into account when calculating the nearest channel. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 157 [:SOURce[n]][:CHANnel[m]]:WAVelength:AUTO? syntax: [:SOURce[n]][:CHANnel[m]]:WAVelength:AUTO? description: Returns the current operation mode. parameters: none response: 0: "Grid Mode" (= Auto Mode off) 1: "Auto Mode" example: sour1:wav:auto affects: 81950A Notes This query is equivalent to [:SOURce[n][:CHANnel[m]]:FREQuency:AUTO? 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 158 Measurement Operations & Settings 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: sour0:wav:corr:ara affects: All tunable laser modules except 81649A, 81689A/B, and 81950A 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 159 All tunable laser modules except 81649A, 81689A/B and 81980A, 81940A, 81989A, 81949A, 81602A, 81606A, 81607A, 81608A, 81609A, and 81950A. command: [:SOURce[n]][:CHANnel[m]]:WAVelength:CORRection:AUTocalib? syntax: [:SOURce[n]][:CHANnel[m]]:WAVelength:CORRection:AUTocalib? description: Returns whether Autocalibration is enabled or disabled parameters: none 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 160 Measurement Operations & Settings response: 0 Autocalibration disabled 1 Autocalibration enabled -> example: sour0:wav:corr:aut? affects: All tunable laser modules except 81649A, 81689A/B and 81980A, 81940A, 81989A, 81949A, 81602A, 81606A, 81607A, 81608A, 81609A, and 81950A. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 161 Reports the current lambda zero tempearture. parameters: none response: float value; temperature in °C example: sour0:wav:corr:zero:temp:act? affects: All tunable laser modules except 81649A, 81689A/B and 819xxA/B, 81602A, 81606A, 81607A, 81608A, 81609A, and 81950A. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 162 Forces an auto lamda zero. This is quicker but a little less accurate than the equilavent manual process because some checks are omitted: parameters: none response: none example: sour0:wav:corr:zero:auto affects: All tunable laser modules except 81649A, 81689A/B and 819xxA/B, 81602A, 81606A, 81607A, 81608A, 81609A. and 81950A. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 163 The default value of [l] is 1, the lower wavelength source. The upper wavelength source is denoted by 2. parameters: none response: Returns the frequency difference as a float value in Hz. -> example: wav:freq? -1.00000000E+013<END> affects: All tunable laser sources 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 164 Sets the reference wavelength to the value of the output wavelength ( ), that is, sets the frequency offset (d f) to zero. parameters: none response: none example: sour2:wav:ref:disp affects: All tunable laser and DFB modules 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 165 379, Continuous Sweep AND 379,Continuous Sweep = On for 81602A, 81606A, 81607A, 81608A, 81609A Modulation = On -> example: sour0:wav:swe:chec? "triggerNum > max" affects: All tunable laser modules except Keysight 81649A, Keysight 81689A/B, and 81950A. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 166 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 number of cycles as a signed integer value. -> example: wav:swe:cycl? +3<END> affects: All tunable laser modules, except 81950A. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 167 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 d well time in seconds. -> example: wav:swe:dwel? +5.00000000E-001<END> affects: All tunable laser modules, except 81950A. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 168 Power Meter for coordinated measurements with a tunable laser source (see command :SENSe[n][:CHANnel[m]]:FUNCtion:PARameter:LOGGing on page 97). parameters: none response: the number of expected triggers as a signed integer value. -> example: sour0:wav:swe:exp? +12001 affects: All tunable laser modules except 81649A, 81689A/B, and 81950A. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 169 -> example: sour0:wav:swe:flag? affects: All tunable laser modules except 81649A, 81689A/B, 81949A, 81989A, 81950A, and 81609A. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 170 A boolean value: 0 – lambda logging is switched off 1 – lambda logging is switched on -> example: wav:swe:llog? 1<END> affects: All tunable laser modules that support continuous sweeps. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 171 Returns the power to the highest permissible power for the selected wavelength sweep. parameters: start wavelength: The wavelength at which the sweep starts as a float value. stop wavelength: The wavelength at which the sweep starts as a float value. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 172 Measurement Operations & Settings response: The highest permissible power for the selected wavelength sweep as a float value. example: wav:swe:pmax? 1540nm,1550nm -> +3.5500000E-004<END> affects: All tunable laser modules, and except 81950A. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 173 Set the start and stop wavelength of the sweep using [:SOURce[n]][:CHANnel[m]]:WAVelength:SWEep:STARt on page 175 and [:SOURce[n]][:CHANnel[m]]:WAVelength:SWEep:STOP on page 176 respectively. -> example: wav:swe:rep? ONEW<END> affects: All tunable laser modules, except 81950A. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 174 All tunable laser modules that support continuous sweeps. command: [:SOURce[n]][:CHANnel[m]]:WAVelength:SWEep:SPEed? syntax: [:SOURce[n]][:CHANnel[m]]:WAVelength:SWEep:SPEed?[<wsp>MIN|MAX] description: Returns the speed for continuous sweeping. parameters: optional MIN Returns the minimum sweep speed available. MAX Returns the maximum sweep speed available. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 175 MAX Returns the maximum start wavelength available. This value is wavelength dependent. response: The wavelength at which the sweep starts as a float value in meters. -> example: wav:swe:star? +1.50000000E-006<END> affects: All tunable laser modules, except 81950A. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 176 The wavelength at which the sweep ends as a float value in meters. -> example: wav:swe:stop? +1.55000000E-006<END> affects: All tunable laser modules command: [:SOURce[n]][:CHANnel[m]]:WAVelength:SWEep:[STATe] syntax: [:SOURce[n]][:CHANnel[m]]:WAVelength:SWEep:[STATe]<wsp> STOP|0|STARt|1|PAUSe|2|CONTinue|3 description: Stops, starts, pauses or continues a wavelength sweep. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 177 In addition, a continuous sweep with lambda logging requires: the trigger output to be set to step finished modulation set to coherence control or off. response: none example: wav:swe STOP affects: All tunable laser modules, except 81950A. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 178 [:SOURce[n]][:CHANnel[m]]:WAVelength:SWEep:STEP:PREVious syntax: [:SOURce[n]][:CHANnel[m]]:WAVelength:SWEep:STEP:PREVious description: Performs one sweep step backwards in stepped sweep if it is paused or in manual sweep parameters: none response: none example: wav:swe:step:prev affects: All tunable laser modules, except 81950A. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 179 It is either ‘+0,”No error”’ or e.g. ‘-200,”Execution error (StatExecError)”’ Recalibration takes about 6.8 seconds, so it also takes this time to get the reply to the :SYSTem:ERRor? query. parameters: none response: none example: :SOUR1:TRAN:REC affects: 81490A 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 180 Get the operating point for one of the reference transmitter's two laser diodes. You can also query the minimum, maximum or default value. parameters: none | MINimum | MAXimum | DEFault response: The operating point. −> example: :sour1:tran:opo2 -17<END> affects: 81490A 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 181 Values near 1.0 indicate the current temperature is close to the temperature at the last recalibration. Values near 0.0 indicate the current temperature has drifted towards its maximum tolerance limit to trigger the UNCAL bit. −> example: :SOUR1:TRAN:TCH? 1.0<END> affects: 81490A 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 182: Signal Conditioning

    MIN | DEF | MAX Returns the minimum, default, or maximum value of the attenuation factor possible. response: 4 byte Intel floating point; attenuation in dB. -> example: INP1:ATT? 14<END> affects: All attenuator modules 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 183 Sets the offset factor (a ) such that the attenuation factor is zero. Offset (dB) = a (dB) - a (dB) = - a (dB) Offset (new) Offset (old) (old) filter parameters: none 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 184 :INPut[n][:CHANnel[m]]:ATTenuation:SPEed?<wsp> MIN | MAX | DEF description: Without the optional parameter, queries the transition speed of the filter. parameters: MIN | MAX | DEF Queries the transition speed limits, or the module default. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 185 +1.55000000E-006<END> INP1:WAV affects: All attenuator modules. command: :OUTPutn[:CHANnel[m]]:APMode syntax: :OUTPutn[:CHANnel[m]]:APMode<wsp><OFF(0) | ON(1)> description: The use of this command is optional and has no effect on operation. Included for compatibility with Keysight 8156A mainframe. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 186 Measurement Operations & Settings parameters: OFF or 0 ON or 1 response: none example: OUTP1:APMode OFF affects: All attenuator modules. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 187 :OUTPutn[:CHANnel[m]]:POWer? syntax: :OUTPutn[:CHANnel[m]]:POWer<wsp>MIN | MAX | DEF description: Without the optional parameter, queries the output power value. parameters: MIN | MAX | DEF Queries the output power module limits, or the module default. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 188 Measurement Operations & Settings response: 4 byte Intel floating point; output power in current power unit. -> example: OUTP1:POW? 12<END> affects: All attenuator modules. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 189 (P (dBm) = P (dBm) + a (dB) filter parameters: <slot> Slot number of the powermeter. <channel> Channel number of the powermeter. response: none example: OUTP1:POW:REF:POW 4,2 affects: Attenuator modules without power control. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 190 P offset λ (dBm) = P (dBm) - P (dBm) + P (dB) offset(new) offset ( parameters: <slot> Slot number of the external powermeter. <channel> Channel number of the external powermeter. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 191 Queries whether the power control mode is on or off. parameters: none response: boolean 0 The power control mode is off 1 The power control mode is on. -> example: OUTP1:POW:CONTR? 0<END> affects: Attenuator modules with power control. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 192 (if available), and P parameters: DBM (or 0) Sets the power unit to dBm WATT (or 1) Sets the power unit to W response: none example: OUTP1:POW:UN DBM affects: All attenuator modules, and 81950A. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 193 1 The shutter is open. -> example: OUTP1:STAT? 0<END> affects: All attenuator modules, and 81950A. command: :OUTPutn[:CHANnel[m]]:STATe:APOWeron syntax: :OUTPutn[:CHANnel[m]]:STATe:APOWeron<wsp>OFF(0) | ON(1) description: Sets the state of the shutter when the mainframe is turned on. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 194 <value> The averaging time (in seconds if no unit specified). response: none example: OUTP1:ATIM 1s affects: Attenuator modules with power control. command: :OUTPutn]:CHANnel[m]]:ATIMe? syntax: :OUTPutn[:CHANnel[m]]:ATIMe? description: Queries the powermeter averaging time. parameters: none 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 195 :OUTPutn[:CHANnel[m]]:CORRection:COLLection:ZERO? syntax: :OUTPutn[:CHANnel[m]]:CORRection:COLLection:ZERO? description: Queries the status of the last :OUTPutn[:CHANnel[m]]:CORRection:COLLection:ZERO operation. parameters: none response: integer 0 = OK, otherwise not OK. -> example: OUTP:CORR:COLL:ZER0? 0<END> affects: Attenuator modules with power control. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 196: The Table Of Wavelength-Dependent Offsets

    • Whether an exact, interpolated, or extrapolated offset value is applied, the algorithm applied can be queried using :STATusn:OPERation:CONDition? on page 59 λ Figure 6 Extrapolation and interpolation of attenuator module offset table 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 197 Queries whether the attenuator uses power values from its offset table . parameters: none response: boolean 0 The offset table is not used. λ 1 The attenuator uses its offset table. -> example: CONF1:OFFS:WAV:STAT? 0<END> affects: All attenuator modules. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 198 Specifies the slot and channel of the external powermeter (hosted in the same mainframe as the attenuator module) used by TOREF. :CONFigure[n][:CHANnel[m]]:OFFSet:WAVelength:VALue See: on page 198 parameters: <slot> Slot number of the powermeter. <channel> Channel number of the powermeter. response: none example: CONF1:OFFS:WAV:REF 4,2 affects: Attenuator modules with power control. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 199 Or: Queries the offset applied for a particular wavelength. parameters: <index> The position of the value pair (wavelength; offset) in the offset table. <wavelength> The wavelength for the offset table entry, in m 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 200 <index> The position of the wavelength:offset value pair in the offset table. <wavelength> The wavelength for the offset table entry, in m response: none example: CONF1:OFFS:WAV:VAL:DEL 1 affects: All attenuator modules. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 201 Without optional parameter, queries the size of the offset table. parameters: Queries the maximum size of the offset table. -> (available flash memory 1000 entries) -> Queries the minimum size of the offset table. (should 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 202: 8156A Attenuator

    OUTP2:POW 10 dBm 8156x: (when the attenuator is hosted in Slot 2) If you forget to enter the slot number, one of the following error messages is placed in the SCPI error queue: 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 203 No change. INPut:LCMode No longer supported. Use the wavelength dependent offset command. INPut:LCMode? No longer supported. Use the wavelength dependent offset command. INPut:OFFSet No change. INPut:OFFSet? No change. INPut:OFFSet:DISPlay No change. INPut:WAVelength No change. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 204: Display And System Commands

    No change. OUTPut:STATe:APOWeron? No change. Display and System Commands The commands to adjust the instrument display (page 104ff) and query the error queue (page 122) also work with the 816xA/B platform: DISPlay:BRIGhtness DISPlay:ENABle SYSTem:ERRor? 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 205: Ieee Commands

    For additional information, refer to our Application Note "Variable Optical Attenuator in BER Test Applications", part number 5988-3159EN. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 206: Signal Routing

    "," separates input and output ports of a specific connection. ";" separates parallel connections (as used in 2x2 switch). -> example: rout3:chan1? A,1 simple 1xN switch -> A,2;B,1 (2x2 crossover switch in crossover config). rout2:chan1? affects: All switch modules 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 207 A,1;B,2.A,2;B,1 2x2 x-over switcch: state 1: When A to 1 then B to 2nd connection (straight) state 2: When A to 2 then B to 1st connection (cross-over) affects: All switch modules 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 208: Triggering - The Trigger Subsystem

    Further hardware triggers are ignored until you send power measurement until the trig:inp:rearm again. function is finished. CMEasure The first hard ware trigger starts the function. Subsequent power measurements are automatically performed until the function is finished. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 209 A hard ware trigger cannot be effective in the DISabled triggering mode but can be effective in DEFault, PASSthrough or :TRIGger:CONF LOOPback triggering modes, see on page 214 for information on triggering modes. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 210 If you use the Keysight 816x VXIplug&play Instrument Driver, you can trigger power measurements using HP 8153A Series power meters. dual sensors: Can only be sent to master channel, slave channel is also affected. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 211 If you return to Local control, all modules return to the default setting. response: none example: trig1:inp:rearm 0 affects: All 8163A/B series power meter modules, and 8161x series return loss modules. dual sensors: Can only be sent to master channel, slave channel is also affected. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 212 1: trigger rearming enabled (default) -> example: trig1:inp:rearm? 0<END> affects: All 8163A/B series power meter modules, and 8161x series return loss modules. dual sensors: Can only be sent to master channel, slave channel parameters are identical. command: :TRIGger[n][:CHANnel[m]]:OFFSet syntax: :TRIGger[n][:CHANnel[m]]:OFFSet <value>...
  • Page 213 When a sweep cycle starts. -> example: trig1:outp? dis<END> affects: All tunable laser modules (except 81950A), power meters, and return loss modules. dual sensors: Can only be sent to master channel, slave channel parameters are identical. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 214 Can only be sent to master channel, slave channel parameters are identical. command: :TRIGger:CONF syntax: :TRIGger:CONF<wsp><triggering mode> description: Sets the hard ware trigger configuration with regard to Output and Input Trigger Connectors. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 215 CUSTOM: page 217 or the Keysight 816x VXIplug&play Instrument Driver. -> example: trig:conf? DEF<END> command: :TRIGger:CONF:FPEDal syntax: :TRIGger:CONF:FPEDal<wsp>OFF|ON|0|1 description: Enables or disables the Input Trigger connector to be triggered using a Foot Pedal. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 216 :TRIGger:CONF:FPEDal? description: Returns whether the Input Trigger connector can be triggered using a Foot Pedal. parameters: none response: A boolean value: 0: foot pedal disabled 1: foot pedal enabled -> example: trig:conf? DEF<END> 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 217: Extended Trigger Configuration

    Node B Input Configuration: A 32-bit unsigned integer, see below. Output Matrix Configuration: A 32-bit unsigned integer, see below. response: none example: trig:conf:ext 0,0,0 command: :TRIGger:CONF:EXTended? syntax: :TRIGger:CONF:EXTended? description: Returns the extended hardware trigger configuration. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 218 Node A Input Configuration: A 32-bit signed integer, see below. Node B Input Configuration: A 32-bit signed integer, see below. Output Matrix Configuration: A 32-bit signed integer, see below. -> example: trig:conf:ext? +0,+0,+0<END> 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 219 ]]:OUTPut” explains how slot events can generate triggers. “:TRIGger[ ][:CHANnel[ ]]:INPut” explains how a slot responds to an incoming trigger. “:TRIGger” generates a trigger at Node A or Node B directly. Figure 7 Extended Trigger Configuration 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 220 Slot 1: 0 - Inactive, 1 - Event at slot 1 can trigger Node B Slot 0: 0 - Inactive, 1 - Event at slot 0 can trigger Node B :TRIGger[n][:CHANnel[m]]:OUTPut on page 213 explains how slot events can generate triggers. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 221: Extended Trigger Configuration Example

    1 and 2. The example below presumes you set up identical stepped sweeps for both modules, for example, by pressing P RESET Tunable Tunable Laser Laser Figure 8 Setup for Extended Trigger Configuration Example trig:conf:ext #H2,#H0,#H0 trig2:outp dis trig2:inp next 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 222 Node A triggers the tunable laser module in slot 2 to perform a sweep step because trig2:inp next is set. The sequence starts again at step 3 and continues until the sweep ends. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 223 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide Mass Storage, Display, and Print Functions Display Operations – The DISPlay Subsystem / 224 This chapter gives descriptions of commands that you can use when you want to change the instrument’s display.
  • Page 224: Display Operations - The Display Subsystem

    :DISPlay:CONTrast? description: Queries the contrast of the display. parameters: none response: An integer value in the range 0 to 100 -> example: disp:cont? +50<END> affects: 8163B Lightwave Multimeter and 8166B Lightwave Multichannel System 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 225 -> example: disp:brig? +75<END> affects: 8163B Lightwave Multimeter and 8166B Lightwave Multichannel System - 8164A Lightwave Measurement System: only checks if the value equals 0. (0 -> display off, other values: display on) 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 226 A boolean value: 0 – the display is turned off 1 – the display is turned on -> example: disp:enab? 1<END> :DISPlay:LOCKout command: :DISPlay:LOCKout syntax: :DISPlay:LOCKout<wsp>ON|OFF|1|0 description: Enables or Disables local operation. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 227 :DISPlay:LOCKout? syntax: :DISPlay:LOCKout? description: Queries whether local operation is locked out. parameters: none response: A boolean value: 0 – local operation is disabled 1 – local operation is enabled. -> example: disp:lock 1<END> 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 229: Visa Programming Examples

    8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide VISA Programming Examples How to Use VISA Calls / 230 How to Set up a Fixed Laser Source / 232 How to Measure Power using FETCh and READ / 235 How to Co-ordinate Two Modules...
  • Page 230: How To Use Visa Calls

    (void) ViStatus errStatus; /*return error code from visa call */ ViSession defaultRM; /*default visa resource manager variable*/ ViSession /*current session handle */ ViChar replyBuf[256]; /*buffer holding answers from the instrument*/ ViChar 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 231 /* get information about the available options of a slot errStatus = viQueryf(vi,"%s","%t","SLOT1:OPT?\ n",replyBuf); if(errStatus < VI_SUCCESS) { checkError(vi,errStatus); } else printf("%s",replyBuf); /*loop, until a key is pressed */ while(!scanf("%c",&c)); /*close the session */ viClose(vi); 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 232: How To Set Up A Fixed Laser Source

    < VI_SUCCESS) printf("Failed to open VISA Resource manager\n"); exit(errStatus); /* Open session to GPIB device at address 20;*/ errStatus = viOpen (defaultRM, "GPIB::20::INSTR", VI_NULL,VI_NULL,&vi); if(errStatus < VI_SUCCESS) printf("Failed to open instrument\n"); exit(errStatus); 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 233 = viPrintf(vi,"SOURCE2:CHAN1:POW:STATE 0\n"); if (errStatus < VI_SUCCESS) checkError(vi,errStatus); /* close the session */ viClose(vi); void checkError(ViSession session, ViStatus err_status ) ViStatus error; ViChar errMsg[256]; error = viQueryf(session,"SYST:ERR?\n","%t",errMsg); if (error == VI_ERROR_TMO) printf("System Error!\n") ; 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 234 VISA Programming Examples exit(1); else /* only errors should be displayed */ if(errMsg[0] != '+') printf("error:%ld --> %s\n", err_status,errMsg) ; 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 235: How To Measure Power Using Fetch And Read

    ViInt32 /* loop counter */ errStatus = viOpenDefaultRM (&defaultRM); if(errStatus < VI_SUCCESS) printf("Failed to open VISA Resource manager\n"); exit(errStatus); errStatus = viOpen (defaultRM, "GPIB::20::INSTR", VI_NULL,VI_NULL,&vi); if(errStatus < VI_SUCCESS) printf("Failed to open instrument\n"); exit(errStatus); 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 236 /* read 10 values and display the result; */ for (i = 0; i < 10; i++) /* Now because an averaged value is available, the value will be fetched */ errStatus = viQueryf(vi,"%s","%s","FETCH1:CHAN1:POW?\ n",replyBuf); if (errStatus < VI_SUCCESS) checkError(vi,errStatus); 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 237 /*copy new value to compare buffer*/ strcpy(compBuf,replyBuf); /* loop, until a key is pressed */ while(!scanf("%c",&c)); checkError(vi,errStatus); /* close the session */ viClose(vi); void checkError(ViSession session, ViStatus err_status ) { ViStatus error; 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 238 VISA Programming Examples ViChar errMsg[256]; error = viQueryf(session,"SYST:ERR?\n","%t",errMsg); if (error == VI_ERROR_TMO) printf("System Error!\n") ; exit(1); else /* only errors should be displayed */ if(errMsg[0] != '+') printf("error:%ld --> %s\n", err_status,errMsg) ; 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 239: How To Co-Ordinate Two Modules

    /* First get initialized the visa library (see example 1) errStatus = viOpenDefaultRM (&defaultRM); if(errStatus < VI_SUCCESS) printf("Failed to open VISA Resource manager\n"); exit(errStatus); /* Open session to GPIB device at address 20; */ 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 240 /*set the averaging time for measuring to 20 ms, therefore no timeout needs to implemented */ errStatus = viPrintf(vi,"SENS1:CHAN1:POW:ATIME 0.02\n"); checkError(vi,errStatus); /* set the attenuation to zero for maximum power */ errStatus = viPrintf(vi,"SOURCE2:CHAN1:POW:ATT 0.0\n"); checkError(vi,errStatus); 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 241 */ for (i = 1; i <= 30; i++) errStatus = viQueryf(vi,"READ1:CHAN1:POW?\ n","%s",replyBuf); checkError(vi,errStatus); if(errStatus ==VI_SUCCESS)printf("power #%02d:%s\ n",i,replyBuf); 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 242 /*close the session */ viClose(vi); void checkError(ViSession session, ViStatus err_status ) ViStatus error; ViChar errMsg[256]; error = viQueryf(session,"SYST:ERR?\n","%t",errMsg); if (error == VI_ERROR_TMO) printf("System Error!\n") ; exit(1); else /* only errors should be displayed */ 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 243 VISA Programming Examples if(errMsg[0] != '+') printf("error:%ld --> %s\n", err_status,errMsg) ; 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 244: How Power Varies With Wavelength

    ViInt32 /* loop counter */ ViInt32 cmdDone; /* return value for OPC command errStatus = viOpenDefaultRM (&defaultRM); if(errStatus < VI_SUCCESS) printf("Failed to open VISA Resource manager\n"); exit(errStatus); 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 245 /* set the power meter to same wavelength like the tunable laser source */ errStatus = viPrintf(vi,"SENS1:CHAN1:POW:WAV %s\ n",replyBuf); checkError(vi,errStatus); /* read the maximum wavelength from the tunable laser source */ errStatus = viQueryf(vi,"SOURCE2:WAV? MAX\ n","%s",replyBuf); checkError(vi,errStatus); /*save this wavelength */ 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 246 */ for(i=1;1;i++) /*query the power */ errStatus = viQueryf(vi,"READ1:CHAN1:POW?\ n","%s",replyBuf); checkError(vi,errStatus); /* display the power read from power meter and wavelength */ 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 247 /* turn laser off */ errStatus = viPrintf(vi,"SOURCE2:CHAN1:POW:STATE 0\n"); checkError(vi,errStatus); /* close the session */ viClose(vi); void checkError(ViSession session, ViStatus err_status ) ViStatus error; ViChar errMsg[256]; error = viQueryf(session,"SYST:ERR?\n","%t",errMsg); if (error == VI_ERROR_TMO) printf("System Error!\n") ; else 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 248 VISA Programming Examples /* only errors should be displayed */ if(errMsg[0] != '+') printf("error:%ld --> %s\n", err_status,errMsg) ; 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 249: How To Log Results

    /* used in the keyboard wait loop */ ViInt32 slot; /* slot number where the power meter is plugged */ ViInt32 chan; /* channel to be logged */ ViInt32 /* loop counter */ 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 250 /* start logging */ viPrintf(vi,"SENS%1d:CHAN%1d:FUNC:STAT LOGG,START\ n",slot,chan); checkError(vi,errStatus); /* to display the results, logging should be completed */ /* the instrument has to be polled about the progress of the logging */ 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 251 ! */ if(errStatus < VI_SUCCESS)checkError(vi,errStatus); /* read the binary data */ errStatus = viRead(vi, logBuffer, MAX_LOG_VALUES * sizeof(ViReal32) + HEADER_SIZE, &retCnt); checkError(vi,errStatus); if(logBuffer[0] != '#') printf("invalid format returned from logging\n"); exit(1); else 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 252 /* only errors should be displayed */ if(errMsg[0] != '+') printf("error:%ld --> %s\n", err_status,errMsg) ; ((!strncmp(errMsg, "-303,\"Module slot empty or slot / channel invalid\ "", strlen("-303,\"Module slot empty or slot / channel invalid\""))) 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 253 (errStatus < VI_SUCCESS) printf("Failed to open VISA Resource manager\n"); /* Open session to GPIB device at address 20; */ errStatus = viOpen (defaultRM, "GPIB::20::INSTR", VI_NULL,VI_NULL,iHandle); if (errStatus < VI_SUCCESS) printf("Failed to open instrument\n"); return errStatus; 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 255 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide The Keysight 816x VXIplug&play Instrument Driver Installing the Keysight 816x Instrument Driver / 256 Using Visual Programming Environments / 257 Getting Started with LabView / 260 Getting Started with LabWindows / 262 Features of the Keysight 816x Instrument Driver...
  • Page 256: The Keysight 816X Vxiplug&Play Instrument Driver

    > to continue. Specify the folder to which files will be saved. Press Next > to continue. Files are copied and extracted. If necessary, a dialog requests your premission to overwrite existing files. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 257: Using Visual Programming Environments

    The Keysight 816x VXIplug&play Instrument Driver Using Visual Programming Environments Getting Started with Keysight VEE Keysight Technologies Visual Engineering Environment (Keysight VEE) is a visual programming language optimized for instrument control applications. To develop programs in Keysight VEE, you connect graphical ‘objects’...
  • Page 258: Gpib Interfacing In Keysight Vee

    • Gateway: This host. Advanced I/O Config ... Press , the Advanced Device Configuration box pops up. Select the Plug&play Driver tab, the box in Figure 10 page -259 appears. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 259 Select whether to Perform Reset or to Perform Identification Query whenever Keysight VEE opens the instrument for interaction. Confirm the selections pressing the OK button. Return to the Instrument Manager screen and press the Save Config to save the configuration. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 260: Getting Started With Labview

    You must check the box. Add Front Panel Controls for Size of Array Parameters NOTE There will be a front panel control created for each VI that requires you to assign the array size. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 261 The Keysight 816x VXIplug&play Instrument Driver You must use the 32-bit version of Labview with the Keysight 816x VXIplug&play NOTE Instrument Driver. LabView is a trademark of National Instruments Corporation. NOTE 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 262: Getting Started With Labwindows

    OK button. LabWindows loads the function panel and instrument driver. The driver now appears as a selection on the Instrument menu, and can be treated like any LabWindows driver. LabWindows is a trademark of National Instruments Corporation. NOTE 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 263: Features Of The Keysight 816X Instrument Driver

    Visual Basic. You should only use Visual Basic with this driver if you are familiar with C/C++ function declarations. You must take particular care when working with C/C++ pointers. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 264: Directory Structure

    Figure 12 on page -264. Figure 12 Windows VXIPNP Directory Structure In the directory example, hp816x is a directory containing the instrument driver. There would be a directory for each instrument driver. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 265: Opening An Instrument Session

    ViPSession instrumentHandle: a pointer to an instrument session. InstrumentHandle is the handle which addresses the instrument, and is the first parameter passed in all driver functions. • Successful completion of this function returns VI_SUCCESS 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 266: Closing An Instrument Session

    When no further communication with an instrument is required, the session must be explicitly closed (hp816x_close() function). VISA does not remove sessions unless they are explicitly closed. Closing the instrument session frees all data structures and system resources allocated to that session. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 267: Visa Data Types And Selected Constant Definitions

    You can find a partial list of the type definitions and constant definitions for the NOTE visatype.h in the Keysight 816x VXIplug&play Instrument Driver Online Help. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 268: Error Handling

    Create a routine to respond to the error or event. This example queries whether an error has occured, checks if the error is an instrument error and then checks if the error is a driver error. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 269 /* get the driver error message */ hp816x_error_message(instrumentHandle, errStatus, err_message); /* display the error */ printf("Driver Error : %ld, %s\n", errStatus, err_mes- sage); /* optionally reset the instrument, close the instrument handle */ hp816x_reset(instrumentHandle); hp816x_close(instrumentHandle); exit(1); return; 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 270: Introduction To Programming

    The BASIC include file is hp816x.bas. You can find this file in the directory C:\Program Files (x86)\IVI Foundation\VISA\WinNT\Include. You may also need to include the file visa.bas. visa is provided with .bas your VISA DLL. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 271 Do not include hp816x.C in your project. You must provide an include file for hp816x.H. You do this by ensuring that the directory C:\Program Files (x86)\IVI Foundation\VISA\WinNT\Include is added to the include paths (CVI Project Option menu). 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 272: Online Information

    N7700A Package Manager from www.keysight.com/find/n7700 If you do not have web access, the 816x driver package and N7700A Package Manager are available on your OCT Support CD, or contact your Keysight Technologies supplier. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 273: Lambda Scan Applications

    If you choose Disable, the highest sweep speed will not be used. Equally Spaced Datapoints A linear interpolation is performed on all wavelength and power data for the Lambda Scan Application and is optional for the Multi Frame Lambda Scan Application. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 274 -274shows the original curve as measured directly by a Power Meter and the interpolated curve. Interpolation will always tend to produce a smoother curve by rounding off any peaks in the curve. Original Curve Interpolated Curve Figure 13 Equally Spaced Datapoints 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 275: How To Perform A Lambda Scan Application

    Triggers coordinate the Tunable Laser module with all Power Meters. The function sets for the lowest possible averaging time available for the installed Power Meters and, then, sets the highest possible sweep speed for the selected Tunable Laser module sweep. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 276 Equally Spaced Datapoints is enabled as part of this function and cannot be disabled. Use Multi Frame Lambda Scan if you need to have inequally spaced datapoints. See Equally Spaced Datapoints on page 273 for more details. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 277: How To Perform A Multi-Frame Lambda Scan Application

    This results in Lambda Array wavelength points that are not equally spaced. Lambda Logging is not available if your Tunable Laser module firmware revision NOTE is lower than 2.0. Equally Spaced Datapoints is enabled as a default. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 278 Register Mainframe function (hp816x_registerMainframe). The first continuous-sweep tunable laser found will perform the sweep operation.If more than one tunable laser is installed, only the laser with the lower slot number will be used. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 279 Use the values returned from the Prepare Multi Frame Lambda Scan (hp816x_prepareMfLambdaScan) function to set the parameters of the Execute Multi Frame Lambda Scan (hp816x_executeMfLambdaScan) function. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 280 The Get Channel Location function (hp816x_getChannelLocation_Q) returns the location of the chosen Power Meter channel as used in a Multi Frame Lambda Scan operation. The maximum number of channels that may be specified is 1000. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 281 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide GPIB Command Compatibility List Compatibility Issues / 282 GPIB Bus Compatibility / 282 Status Model / 282 Preset Defaults / 282 Removed Command / 283 Obsolete Commands / 284 Changed Parameter Syntax and Semantics...
  • Page 282: Compatibility Issues

    DCL - device clear Both GET - group execute trigger Both Status Model The status model is completely incompatible with the HP 8153A and HP 8167/8. Preset Defaults The preset defaults are different. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 283: Removed Command

    The TRACe tree is not supported; the CC_UNCAL curve 8167/8 TRACE:DATA? does not exist. TRACE:POINts? WAVEACT Alignment to external wavemeter is not supported. 8167/8 misc 200 Risetime control is not supported yet. 8167/8 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 284: Obsolete Commands

    The HP 8153A application interface on the GPIB is not supported. Stability/Logging and Min/Max are available via a new interface. Return Loss Module Commands The commands for the return loss modules will be 8153 completely different than those for the HP 8153A. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 285: Changed Parameter Syntax And Semantics

    Accepts TOREF,0 or values for slot,channel, instead of 8153 accepting TOA|TOB as the HP 8153A does. The numbers have a different meaning. SYST:DATe SYST:DATe from HP 8167/8 is not supported, but 8167/8 SYST:DATe from HP 8153 is supported. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 286: Changed Query Result Values

    For the HP 8153A, SOUR:POW:WAV? returned the wavelength of the active laser. SYSTem:ERRor? Same functionality but different numbers and errors are 8153 returned for instrument specific errors. SOURce:AM:SOURce? Returns different enum values than the HP 8167/8. 8167/8 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 287: Timing Behavior

    While a command is pending *OPC? returns 0 now. This is the behaviour of the 8153. When continuous triggering and averaging times are greater than 1 second, the read-out values 8153 reset after the averaging time is over; there is no sliding behavior. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 288: Error Handling

    Most error commands and error texts for all instruments are new. The HP 8153A timed out for every error. Errors are handled differently by the 8163A/B and 8164A/B; instead of timing out for every error, special values are returned for erroneous queries.
  • Page 289: Gpib Error Strings

    8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide Error Codes GPIB Error Strings / 290 This chapter gives information about error codes used with the 8163A/B Lightwave Multimeter, the 8164A/B Lightwave Measurement System, and the 8166A/B Lightwave Multichannel System.
  • Page 290 Standard -105 "GET not allowed" [A Group Execute Trigger was received within a program message (see IEEE488.2, 7.7).] Standard -108 "Parameter not allowed" [More parameters were received than expected for the header] 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 291 [Either the character data element contains an invalid character or the particular element received is not valid for the header.] Standard -148 “Character data not allowed” [A legal character data element was encountered where prohibited by the device.] 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 292 [Indicates that a macro parameter placeholder ($<number) was encountered outside of a macro definition.] Standard -183 “Invalid inside macro definition” [Indicates that the program message unit sequence, sent with a *DDT or *DMC command, is syntactically invalid (see IEEE 488.2, 10.7.6.3).] 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 293 The user can set the automatic re-arming option for input and output trigger events (see GPIB Error Strings on page 290). When this error occurs, the device ignores the setting because the current module status does not allow the change of trigger settings. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 294 The user has passed a parameter that exceeds the valid range for this parameter. -220 "Parameter error (StatParmIllegalVal)" Description: The user has passed a parameter that does not match a value in a list of possible values. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 295 Wavelength 1800nm when maximum wavelength is 1700nm. Standard -222 "Data out of range (StatParmTooSmall)" Description: The user has passed a continuous parameter that is too small. Example: Wavelength 700nm when minimum wavelength is 800nm. 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 296 Standard -272 “Macro execution error” [Indicates that a syntactically legal macro program data sequence could not beexecuted due to some error in the macro definition (see IEEE 488.2, 10.7.6.3.)] 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 297 When an application is running error -290 will be returned if any command other than one the following is sent: *WAI *OPC? :SPECial:REBoot :SYSTem:ERRor? :SYSTem:VERSion? -300 to -399 or between 1 and 32767 Device-Specific Errors (Module) 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 298 The channel supports this command, but it cannot be executed because the optical measurement head is not plugged into the interface module. Standard -310 “System error” [Indicates that some error, termed “system error” by the device, has occurred. This code is device-dependent.] 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 299 “Query error” [This is the generic query error for devices that cannot detect more specific errors. This code indicates only that a Query Error as defined in IEEE 488.2, 11.5.1.1.7 and 6.3 has occurred.] 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 300 -114 “Header suffix out of range” -130 “Suffix error” -140 “Character data error” -144 “Character data too long” -160 “Block data error” -201 “Invalid while in local” -202 “Settings lost due to ???” 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 301 “Illegal variable name” -285 “Program syntax error” -286 “Program runtime error” -311 “Memory error” [checksum or parity] -312 “Protect user data memory lost” -313 “Calibration memory lost” -314 “Save/Recall Memory lost” -315 “Configuration memory lost” 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 303 Event register mult-frame, operation enable, 57, 59, 61, prepare function, questionable enable, 64, Lambda scans, Event Status Enable, Laser Event Status Register, state, Questionable enable, 64, switch on, Laser Selection Numbers, LCD, 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 304 Vxipnp directory, measurement, power meter measurement, Status Byte, Status Command Summary, Status Information, Wait, Status Reporting, Wavelength dependent offset STATus subsystem, table, Stop laser, Subsystem DISPlay, FETCh, INITiate, LOCK, OUTPut, 122, 8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide...
  • Page 306 This information is subject to change without notice. © Keysight Technologies 2016 Edition 2.0, June 2016 www.keysight.com...

This manual is also suitable for:

8164a/b8166a/b

Table of Contents