HP 8163A Series Programming Manual
  1. Manuals
  2. Brands
  3. HP Manuals
  4. Measuring Instruments
  5. 8163A Series
  6. Programming manual

HP 8163A Series Programming Manual

Lightwave multimeter, lightwave measurement system & lightwave multichannel system, mainframes
Hide thumbs Also See for 8163A Series:
Table of Contents

Advertisement

Quick Links

Download this manual
H P
8 1 6 3 A / 4 A / 6 A
L i g h t w a v e S e r i e s M a i n f r a m e s
HP 8163A Lightwave Multimeter,
HP 8164A Lightwave Measurement
System,
& HP 8166A Lightwave
Multichannel System Programming
Guide
E1299

Advertisement

Table of Contents
loading

Related Manuals for HP 8163A Series

Summary of Contents for HP 8163A Series

  • Page 1 8 1 6 3 A / 4 A / 6 A L i g h t w a v e S e r i e s M a i n f r a m e s HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, &...
  • Page 2 For warranty service or repair, this product must be returned to a service facility designated by HP. Buyer shall prepay shipping charges to HP and HP shall pay shipping charges to return the product to Buyer. However, Buyer shall pay all shipping charges, duties, and taxes for products returned to HP from another country.

  • Page 3: In This Manual

    121 give fuller explanations of all instrument specific commands. • “Programming Examples” on page 125 gives some example programs showing how the SCPI commands can be used with the HP 8163A Lightwave Multimeter, the HP 8164A Lightwave Measurement System, and the HP 8166A Lightwave Multichannel System.

  • Page 4: Related Manuals

    Related Manuals You can find more information about the instruments covered by this manual in the following manuals: • HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide (HP Product Number 08164-91011).

  • Page 5: Table Of Contents

    The Status Model Status Registers Status System for HP 8163A & HP 8164A Status System for HP 8166A Annotations Status Byte Register HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System Programming Guide, E1299...
  • Page 6 Interface/Instrument Behaviour Settings – The SYSTem Subsystem Measurement Operations & Settings Root Layer Command Measurement Functions – The SENSe Subsystem HP 81635A and HP 81619A- Master and Slave Channels Signal Generation – The SOURce Subsystem Triggering - The TRIGger Subsystem Extended Trigger Configuration...
  • Page 7 Removed Command Obsolete Commands Changed Parameter Syntax and Semantics Changed Query Result Values Timing Behavior Error Handling Command Order Instrument Status Settings HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System Programming Guide, E1299...
  • Page 8 Contents Error Codes GPIB Error Strings Index HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System Programming Guide, E1299...

  • Page 9: Figures

    . 24 Figure 3 The Registers and Filters for a Node . . 25 Figure 4 The Operational/Questionable Status System for HP 8163A & HP 8164A . 27 Figure 5 The Operational/Questionable Status System for HP 8166A . 28 Figure 6 Extended Trigger Configuration .
  • Page 10 Figures HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System Programming Guide, E1299...

  • Page 11: Tables

    Specific Errors. . 169 Table 17 Overview for Supported Strings . . 173 Table 18 Overview for Unsupported Strings . . 177 HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System Programming Guide, E1299...
  • Page 12 Tables HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System Programming Guide, E1299...

  • Page 13: Introduction To Programming

    Introduction to Programming HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...
  • Page 14 Descriptions for the actual commands for the instruments are given in the following chapters. The information in these chapters is specific to the HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, and HP 8166A Lightwave Multichannel System and assumes that you are already familiar with programming the GPIB.

  • Page 15: Gpib Interface

    2515 Camino del Rio South, Suite 340 San Diego, CA, 92108 Web: http://www.scpiconsortium.org The interface of the HP 8163A Lightwave Multimeter and of the HP 8164A Lightwave Measurement System to the GPIB is defined by the IEEE Standards 488.1 and 488.2.

  • Page 16: Setting The Gpib Address

    • You can set the GPIB address from the front panel. See your instrument’s User’s Guide for more information. The default GPIB address is 20. HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...

  • Page 17: Returning The Instrument To Local Control

    – Clears Bit 7 (MSB). 2 No modification is made inside strings or binary blocks. Outside strings and binary blocks, the following modifications are made: HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...

  • Page 18: Clearing The Input Queue

    If more than 29 errors are put into the queue, the message: -350 <Queue Overflow> is placed as the last message in the queue. HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...

  • Page 19: Programming And Syntax Diagram Conventions

    The characters between angled brackets (<...>) indicate the kind of data that you should send, or that you get in a response. You do not type the angled brackets in the actual message. HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...

  • Page 20: Units

    • A string is contained between double quotes ("...") or single quotes (‘...’). When the instrument returns a string, it is always included in " " and terminated by <END>. HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...

  • Page 21: Slot And Channel Numbers

    Channel numbers apply to modules that have two inputs/outputs, for example, the HP 81635A Dual Power Sensor. Modules with two channels, for example, the HP 81635A Dual Power Sensor, use the channel number to distinguish between these channels. N O T E The channel number of single channel modules is always one.

  • Page 22: Laser Selection Numbers

    Your instrument implements all the necessary commands, and some optional ones. This section describes the implemented commands. HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...

  • Page 23: Common Command Summary

    These registers conform to the IEEE Standard 488.2-1987. You can find further descriptions of these registers under *ESE, *ESR?, and *STB?. HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...
  • Page 24 “The Status Model” on page 25 and “Status Reporting – The STATus Subsystem” on page 50. NO TE Unused bits in any of the registers change to 0 when you read them. HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...

  • Page 25: The Status Model

    0 → 1. Condition Registers Figure 3 The Registers and Filters for a Node HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...

  • Page 26: Status System For Hp 8163A & Hp 8164A

    This is described in “Status System for HP 8166A” on page 27. Status System for HP 8163A & HP 8164A The status system for the HP 8163A Lightwave Multimeter and the HP 8164A Lightwave Measurement System returns the status of 2 and 5 module slots respectively.

  • Page 27: Status System For Hp 8166A

    The Operational/Questionable Status System for HP 8163A & HP 8164A Status System for HP 8166A The status system for the HP 8166A Lightwave Multichannel System returns the status of 17 module slots. The Operational/Questionable Status Summary Registers consists of two levels, as described by Figure 5.

  • Page 28: Annotations

    • Bit 7, the OSB, is built from the operation event status register and its enable mask. • All other bits are unused, and therefore set to 0. HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...

  • Page 29: Standard Event Status Register

    • Reading the event register is destructive. • A summary of the event register, the condition register and the enable mask is set in the status byte. HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...

  • Page 30: Operation Slot Status Register

    NOTE: *RST does NOT touch the STB or SESR. A running measure- ment is stopped. *TST? initiates an instrument selftest and returns the results as a 32 bit LONG. HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...

  • Page 31: Other Commands

    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. HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...
  • Page 32 Introduction to Programming The Status Model HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...

  • Page 33: Specific Commands

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

  • Page 35: Specific Command Summary

    Starts or Queries a single/continuous measurement. 71 Switches the lock on/off or returns the current state :LOCK/? of the lock. :OUTPut[n][:CHANnel[m]] Table 4 Specific Command Summary HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...
  • Page 36 Sets or returns the units used for absolute readings on a sensor. :WAVelength/? Sets or returns the wavelength for a sensor. :SENSe[n][:CHANnel[m]]:POWer:REFerence Table 4 Specific Command Summary (continued) HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...
  • Page 37 Returns the optical head’s options. :TST? Returns the latest selftest results for an optical head. 68 Table 4 Specific Command Summary (continued) HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...
  • Page 38 :REFerence? Returns the reference wavelength of a source. [:SOURce[n]][:CHANnel[m]:]WAVelength:CORRection :ARA Realigns the laser cavity. Table 4 Specific Command Summary (continued) HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...
  • Page 39 :STATus:OPERation [:EVENt]? Returns the Operational Status Event Summary Reg- ister. [:EVENt]:LEVel1? Returns the Operational Status Event Summary Reg- ister for slots 15 - 17 of the HP 8166A Lightwave Multichannel System. :CONDition? Returns the Operational Status Condition Summary Register. :CONDition:LEVel1?
  • Page 40 Sets or queries the Operational Status Enable Sum- mary Mask. :ENABle:LEVel1/? Sets or queries the Operational Status Enable Sum- mary Mask for slots 15 - 17 of the HP 8166A Light- wave Multichannel System. :STATusn:OPERation [:EVENt]? Returns the Operational Slot Status Event Register for slot n.
  • Page 41 Sets or returns the incoming trigger response . :OUTPut/? Sets or returns the outgoing trigger response. Table 4 Specific Command Summary (continued) HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...
  • Page 42 Specific Commands Specific Command Summary HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...

  • Page 43: Instrument Setup And Status

    Instrument Setup and Status HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...
  • Page 44 • STATus subsystem commands that relate to the status model. • SYSTem subsystem commands that control the serial interface and internal data. HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...

  • Page 45: Ieee-Common Commands

    Not Used Command Error Execution Error Device Dependent Error Query Error Not Used 0 (LSB) Operation Complete response: none example: *ESE 21 HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...
  • Page 46 N O T E The HP 8163A, HP8164A, and HP8166A will always return HEWLETT-PACKARD as the manufacturer. This will not be affected by the transition of these instruments to Agilent Technologies. This will allow programs that use this string to continue functioning.
  • Page 47 Returns the part number of all installed modules, separated by commas. Slots are listed starting with the lowest slot number, that is, slot 0 for the HP 8164A and Slot 1 for the HP 8163A and HP 8166A. If any slot is empty or not recognised, two spaces are inserted instead of the module’s part number.
  • Page 48 7 (MSB) Operation Status Not used Event Status Bit Not used Questionable Status Not used Not used Not used *STB? → 128<END> example: HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...
  • Page 49 The WAIt command prevents the instrument from executing any further commands until the current command has finished executing. All pending operations are completed during the wait period. parameters: none response: none example: *WAI HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...

  • Page 50: Status Reporting - The Status Subsystem

    Slot 2 Summary Slot 1 Summary Slot 1 Summary Slot 1 Summary Not used Slot 0 Summary Level 1 Summary stat:oper? → +0<END> example: HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...
  • Page 51 The bit value for the operation enable mask as a 16-bit signed integer value (0 .. +32767) stat:oper:enab? → +128<END> example: HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...
  • Page 52 Sets the bits in the Operational Status Enable Summary Mask (OSESM) that enable the contents of the OSESR for slots 15 - 17 of the HP 8166A Lightwave Measurement System to affect the Status Byte (STB). Setting a bit in this register to 1 enables the corresponding bit in the OSESR for slots 15 - 17 of the HP 8166A Lightwave Measurement System to affect bit 7 of the Status Byte.
  • Page 53 :STATus:OPERation:ENABle:LEVel1? syntax: :STATus:OPERation:ENABle:LEVel1? description: Returns the OSESM for the OSESR for slots 15 - 17 of the HP 8166A Lightwave Measure- ment System parameters: none response: The bit value for the operation enable mask as a 16-bit signed integer value (0 .. +32767) stat:oper:enab:level1? →...
  • Page 54 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 HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...
  • Page 55 Slot 2 Summary Slot 1 Summary Slot 1 Summary Slot 1 Summary Not used Slot 0 Summary Level 1 Summary stat:ques? → +0<END> example: HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...
  • Page 56 The bit value for the QSEM as a 16-bit signed integer value (0 .. +32767) stat:ques:enab? → +128<END> example: HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...
  • Page 57 Sets the bits in the Questionable Status Enable Summary Mask (QSESM) that enable the contents of the QSESR for slots 15 - 17 of the HP 8166A Lightwave Measurement Sys- tem to affect the Status Byte (STB). Setting a bit in this register to 1 enables the corresponding bit in the OSESR for slots 15 - 17 of the HP 8166A Lightwave Measurement System to affect bit 7 of the Status Byte.
  • Page 58 :STATus:QUEStionable:ENABle:LEVel1? syntax: :STATus:QUEStionable:ENABle:LEVel1? description: Returns the QSESM for the QSESR for slots 15 - 17 of the HP 8166A Lightwave Mea- surement System parameters: none response: The bit value for the QSESM as a 16-bit signed integer value (0 .. +32767) stat:oper:enab:level1? →...

  • Page 59: Interface/Instrument Behaviour Settings - The System Subsystem

    • the second value is the month, and • the third value is the day. response: none example: syst:date 1999, 1, 12 HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...
  • Page 60 Returns a list of GPIB commands. parameters: none response: Returns a list of GPIB commands → example: syst:help:head? Returns a list of all GPIB commands HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...
  • Page 61 Returns the SCPI revision to which the instrument complies. parameters: none response: The revision year and number. syst:vers? → 1995.0<END> example: HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...
  • Page 62 SYST:COMM:GPIB:ADDR 20 command: :SYSTem:COMMunicate:GPIB[:SELF]:ADDRess? syntax: :SYSTem:COMMunicate:GPIB[:SELF]:ADDRess? description: Returns the GPIB address. parameters: none response: The GPIB Address → example: SYST:COMM:GPIB:ADDR? +20<END> HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...

  • Page 63: Measurement Operations & Settings

    Measurement Operations & Settings HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...
  • Page 64 • SOURce subsystem commands that control Laser Source modules, DFB source modules, Tunable Laser modules, and Return Loss Modules with internal laser sources. • TRIGger subsystem commands that control triggering. HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...

  • Page 65: Root Layer Command

    0: there is a module in the slot 1: the module slot is empty → examples: There is a module in slot1 slot1:empt? 0<END> affects: Independent of module type HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...
  • Page 66 N O T E • The HP 81640A/80A/82A/89A Tunable Laser modules will always return HEWLETT-PACKARD as the manufacturer. • All other HP 8163A Series modules return Agilent Technologies as the manufacturer. • The HP 8153A Series modules will always return HEWLETT-PACKARD as the manufacturer.
  • Page 67 0<END> head interface module in slot 1 N O T E • All other HP 8163A Series Optical Heads return Agilent Technologies as the manufacturer. • The HP 8153A Series Optical Heads will always return HEWLETT-PACKARD as the manufacturer.

  • Page 68: Measurement Functions - The Sense Subsystem

    HP 81635A and HP 81619A- Master and Slave Channels For the HP 81635A Dual Power Sensor and HP 81619A Dual Optical Head Interface module, channel 1 is the master channel and channel 2 is the slave channel. The master and slave channels share the same software and hardware triggering system.
  • Page 69 :SENSe[n]:[CHANnel[m]]:CORRection:COLLect:ZERO? :SENSe[n]:[CHANnel[m]]:CORRection:COLLect:ZERO:ALL :SENSe[n][:CHANnel[m]]:FUNCtion:RESult? :SENSe[n]:[CHANnel[m]]:POWer:RANGe[:UPPer]/? :SENSe[n]:[CHANnel[m]]:POWer:REFerence/? :SENSe[n]:[CHANnel[m]]:POWer:REFerence:DISPlay :SENSe[n]:[CHANnel[m]]:POWer:REFerence:STATe/? :SENSe[n]:[CHANnel[m]]:POWer:REFerence:STATe:RATio/? :SENSe[n]:[CHANnel[m]]:POWer:UNIT/? :SENSe[n]:[CHANnel[m]]:POWer:WAVelength/? Table 6 Commands that are independent for both master and slave channels HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...
  • Page 70 All power meters and return loss modules dual sensors: Can only be sent to master channel, slave channel is also affected. HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...
  • Page 71 Can only be sent to master channel, slave channel is also triggered. To read a simultaneous result from the slave channel, send “:FETCh[n][:CHANnel[m]][:SCAlar]:POWer[:DC]?” on page 70 directly after this command. HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...
  • Page 72 The calibration factor as a float value. Units are in dB, although no units are returned in the response message. → example: sens1:corr? +1.00000000E+000<END> affects: All power meters dual sensors: Master and slave channels are independent. HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...
  • Page 73 Setting parameters for the logging function sets some parameters, including hidden parameters, for the stability and MinMax functions and vice versa. You must use the :SENSe[n][:CHANnel[m]]:FUNCtion:PARameter:LOGGing HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...
  • Page 74 Setting parameters for the MinMax function sets some parameters, including hidden parameters, for the stability and logging functions and vice versa. You must use the :SENSe[n][:CHANnel[m]]:FUNCtion:PARameter:MINMax HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...
  • Page 75 WINDow and REFResh modes. Data Points is an integer value. See Chapter 3 of the HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measure- ment System, & HP 8166A Lightwave Multichannel System User’s Guide, for more in- formation on MinMax mode.
  • Page 76 All power meters and return loss modules dual sensors: Can only be sent to master channel, slave channel parameters are identical. HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...
  • Page 77 Start data acquisition function N O T E When you enable a logging data acquisition function for a HP 8163A Series Power Meter with averaging time of less than 100 ms with input hardware triggering disabled, all GPIB commands will be ignored for the duration of the function.
  • Page 78 Threshold Value: A float value in Watts or dBm. response: none example: sens1:func:thr IMM,20nw<END> affects: All HP 8153A Lightwave Multimeter series power meters and the HP 81534A Return Loss module command: :SENSe[n][:CHANnel[m]]:FUNCtion:THReshold? syntax: :SENSe[n][:CHANnel[m]]:FUNCtion:THReshold? description: Returns the start mode and the threshold value.
  • Page 79 1 affects: All power meters dual sensors: Can only be sent to master channel, slave channel is also affected. HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...
  • Page 80 The reference as a float value. → example: sens1:pow:ref? toref +1.00000000E-006<END> affects: All power meters dual sensors: Master and slave channels are independent. HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...
  • Page 81 A boolean value: 0: absolute 1: relative sens1:pow:ref:stat? → 1<END> example: affects: All power meters dual sensors: Master and slave channels are independent. HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...
  • Page 82 1: Watt or DBM or Watt response: none example: sens1:pow:unit 1 affects: All power meters dual sensors: Master and slave channels are independent. HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...
  • Page 83 The wavelength as a float value in meters. sens1:pow:wav? → +1.55000000E-006<END> example affects: All power meters and return loss modules dual sensors: Master and slave channels are independent. HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...
  • Page 84 All return loss modules HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...
  • Page 85 :SENSe[n]:[CHANnel[m]]:RETurnloss:CORRection:REFLectance[l]<wsp><value>[dB] description: Sets the Return Loss Reference, the return loss value of your reference reflector. For example, the HP 81000BR reference reflector provides an accurate and stable 0.18 dB reference. N O T E Use [l] to set the return loss value of your reference reflector for an external source or the upper or lower wavelength laser source of a dual return loss module.

  • Page 86: Signal Generation - The Source Subsystem

    :SENSe[n]:[CHANnel[m]]:RETurnloss:CORRection:REFLectance[l]? description: Returns the Return Loss Reference, the return loss value of your reference reflector. For example, the HP 81000BR reference reflector provides an accurate and stable 0.18 dB reference. N O T E Use [l] to query the return loss value of your reference reflector for an external source or the upper or lower wavelength laser source of a dual return loss module.
  • Page 87 → example: outp? 1<END> affects: All laser source, DFB source, tunable laser modules and return loss modules with an inter- nal source HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...
  • Page 88 (if MIN, MAX, or DEF are chosen as a parameter). sour2:am:freq? min → +2.00000000E+002<END> example: All laser source, DFB source, and tunable laser modules HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...
  • Page 89 All laser source, DFB source, and tunable laser modules can use internal digital modula- tion All other modulation modes are only available with tunable laser modules. HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...
  • Page 90 0: modulation is disabled 1: modulation is enabled → example: sour2:am:stat? 0<END> affects: All laser source, DFB source, and tunable laser modules HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...
  • Page 91 In this case, the output is kept low when no optical signal is output (for example, while the laser is settling after a change of wavelength). → example: sour2:mod? 0<END> affects: All tunable laser modules HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...
  • Page 92 All tunable laser modules with an in-built optical attenuator, all laser source modules, and return loss modules with an internal source HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...
  • Page 93 → example: sour2:pow:att:dark? 1<END> affects: All tunable laser modules with an in-built optical attenuator HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...
  • Page 94 23uW affects: All tunable laser and DFB source modules HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...
  • Page 95 10ns affects: All tunable laser and DFB source modules HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...
  • Page 96 0 or DBM: dBm (default) 1 or W: Watts response: none example: sour2:pow:unit w affects: All tunable laser and DFB source modules HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...
  • Page 97 BOTH Both wavelength sources sour2:pow:wav? → LOW<END> example: affects: All dual-wavelength laser source modules and return loss modules with two internal sources HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...
  • Page 98 The number of datapoints as an integer value. sour2:read:poin? pmax → 120<END> example: affects: All tunable laser and DFB source modules HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...
  • Page 99 All laser source, DFB source, and tunable laser modules and return loss modules with an internal source HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...
  • Page 100 Returns the frequency difference as a float value in Hz. → example: wav:freq? -1.00000000E+013<END> affects: All tunable laser and DFB modules HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...
  • Page 101 The number of cycles as an integer value. → example: wav:swe:cycl? +3<END> affects: All tunable laser modules HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...
  • Page 102 The dwell time in seconds. → example: wav:swe:dwel? +5.00000000E-001<END> affects: All tunable laser modules HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...
  • Page 103 STEPped: Stepped sweep mode MANual: Manual sweep mode CONTinuous: Continuous sweep mode response: none example: wav:swe:mode STEP affects: All tunable laser modules HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...
  • Page 104 Set the start and stop wavelength of the sweep using “[:SOURce[n]][:CHANnel[m]]:WAVelength:SWEep:STARt” on page 105 and “[:SOURce[n]][:CHANnel[m]]:WAVelength:SWEep:STOP” on page 106 respectively. response: none example: wav:swe:rep twow affects: All tunable laser modules HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...
  • Page 105 If you specify no units in your command, meters are used as the default. response: none example: wav:swe:star 1500nm affects: All tunable laser modules HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...
  • Page 106 “[:SOURce[n]][:CHANnel[m]]:AM:STATe[l]” on page 90, simultaneously, a sweep can not be started. response: none example: wav:swe STOP affects: All tunable laser modules HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...
  • Page 107 Returns the width of the sweep step parameters: none response: The sweep step as a float value in meters. → example: wav:swe:step? +5.00000000E-009<END> affects: All tunable laser modules HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...

  • Page 108: Triggering - The Trigger Subsystem

    The first hardware trigger starts the function. Subsequent pow- er measurements are automati- cally performed until the function is finished. Table 7 Triggering and Power Measurements HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...
  • Page 109 N O T E “:TRIGger” on page 115 describes the :TRIGger command for advanced users using “:TRIGger:CONFiguration:EXTended” on page 115. response: none example: trig 1 HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...
  • Page 110 All tunable laser modules and HP 8163A Series power meters N O T E If you use the HP 816x VXIplug&play Instrument Driver, you can trigger power mea- surements using HP 8153A Series power meters. dual sensors: Can only be sent to master channel, slave channel is also affected.
  • Page 111 All HP 8163A Series power meter modules dual sensors: Can only be sent to master channel, slave channel parameters are identical. HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...
  • Page 112 SWSTarted: When a sweep cycle starts. response: none example: trig1:outp dis affects: All tunable laser modules and HP 8163A series power meters dual sensors: Can only be sent to master channel, slave channel is also affected. command: :TRIGger[n][:CHANnel[m]]:OUTPut? syntax: :TRIGger[n][:CHANnel[m]]:OUTPut? description: Returns the condition that causes an output trigger.
  • Page 113 The same as DEFault but a trigger at the Output Trigger Connector generates a trigger at the Input Trigger Connector automatically. response: none example: trig:conf dis HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...

  • Page 114: Extended Trigger Configuration

    Input Trigger Connector automatically. CUSTOM: A custom configuration is active using either the command “:TRIGger:CONFiguration:EXTended” on page 115 or the HP 816x VXI- plug&play Instrument Driver. See Appendix A “The HP 816x VXI- plug&play Instrument Driver”. trig:conf? → DEF<END> example:...
  • Page 115 Node B Input Configuration: A 32-bit unsigned integer, see below. Output Matrix Configuration: A 32-bit unsigned integer, see below. trig:conf:ext? → +0,+0,+0<END> example: HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...
  • Page 116 ]]:INPut” explains how a slot responds to an incoming trigger. “:TRIGger” generates a trigger at Node A or Node B directly. Figure 6 Extended Trigger Configuration HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...
  • Page 117 Slot 0: 0 - Inactive, 1 - Event at slot 0 can trigger Node B “:TRIGger[n][:CHANnel[m]]:OUTPut” on page 112 explains how slot events can generate triggers. HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...

  • Page 118: Extended Trigger Configuration Example

    The short example below demonstrates how to use extended triggering configuration to make tunable laser source modules sweep simultaneously. Setup your mainframe with two HP 81689A modules in slots 1 and 2. The example below presumes you set up identical stepped sweeps for both modules, for...
  • Page 119 Node A triggers the tunable laser module in slot 2 to perform a sweep step because trig2:inp next is set. 5 The sequence starts again at step 3 and continues until the sweep ends. HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...
  • Page 120 Measurement Operations & Settings Triggering - The TRIGger Subsystem HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...

  • Page 121: Mass Storage, Display, And Print Functions

    Mass Storage, Display, and Print Functions HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...
  • Page 122 Mass Storage, Display, and Print Functions This chapter gives descriptions of commands that you can use when you want to change the instrument’s display. HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...

  • Page 123: Display Operations - The Display Subsystem

    Requests the contrast for the display. parameters: none response: An integer value in the range 0 to 100 disp:cont? → +50<END> example: affects: HP 8163A Lightwave Multimeter HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...
  • Page 124 A boolean value: 0 – the display is turned off 1 – the display is turned on disp:enab? → 1<END> example: HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...

  • Page 125: Programming Examples

    Programming Examples HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...
  • Page 126 They are intended only as an introduction, how to program the instrument using VISA library calls. The VISA calls used, are explained in detail in the VISA User’s Guide. HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...

  • Page 127: How To Use Visa Calls

    ViChar replyBuf[256]; /*buffer holding answers from the instrument*/ ViChar /* Initialize visa resource manger */ errStatus = viOpenDefaultRM (&defaultRM); if(errStatus < VI_SUCCESS) HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...
  • Page 128 = 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); HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...

  • Page 129: How To Set Up A Fixed Laser Source

    VISA Resource manager\n"); exit(errStatus); /* Open session to HPIB device at address 20;*/ errStatus = viOpen (defaultRM, "GPIB::20::INSTR", VI_NULL,VI_NULL,&vi); HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...
  • Page 130 = 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]; HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...

  • Page 131: How To Measure Power Using Fetch And Read

    /* buffer used for comparsion */ ViChar /* used in the keyboard wait loop */ ViReal64 averagingTime; /* averaging time */ ViInt32 i; /* loop counter */ HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...
  • Page 132 = viPrintf(vi,"INIT1:CHAN1:CONT 0\n"); if (errStatus < VI_SUCCESS) checkError(vi,errStatus); /* trigger a measurement */ errStatus = viPrintf(vi,"INIT1:CHAN1:IMM\n"); if (errStatus < VI_SUCCESS) checkError(vi,errStatus); HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...
  • Page 133 :%s",replyBuf); else printf("\nFirst:%s",replyBuf); /*copy new value to compare buffer*/ strcpy(compBuf,replyBuf); /* loop, until a key is pressed */ HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...

  • Page 134: How To Co-Ordinate Two Modules

    --> %s\n", err_status,errMsg) ; How to Co-ordinate Two Modules This example shows the interaction of two modules in the same frame. HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...
  • Page 135 /* set timeout to 20 sec; this should work for all commands except zeroing */ errStatus = viSetAttribute(vi,VI_ATTR_TMO_VALUE,20000); if (errStatus < VI_SUCCESS) checkError(vi,errStatus); /* clear error queue */ HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...
  • Page 136 = viQueryf(vi,"*OPC?\n","%d",&cmdDone); checkError(vi,errStatus); } while (!cmdDone); /* set the power meter reference to the displayed value (display to reference) */ errStatus = viPrintf(vi,"SENS1:CHAN1:POW:REF:DISP\n"); HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...
  • Page 137 /* turn the laser off */ errStatus = 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 ) HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...

  • Page 138: How Power Varies With Wavelength

    ViStatus err_status ); void main (void) ViStatus errStatus; /* returned error code from visa call */ ViSession defaultRM; /* default visa resource manager variable* HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...
  • Page 139 /* 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); HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...
  • Page 140 /* display the power read from power meter and wavelength */ printf("#%02d power:%s wavelength:%g\n",i,replyBuf,wavelength); /* increase the wavelength */ wavelength += 10.0e-9; if(wavelength > wavelength_max) break; /*set the new wavelength*/ HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...
  • Page 141 (error == VI_ERROR_TMO) printf("System Error!\n") ; else /* only errors should be displayed */ if(errMsg[0] != ’+’) printf("error:%ld --> %s\n", err_status,errMsg) ; HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...

  • Page 142: How To Log Results

    */ ViUInt32 retCnt; /* returns the number of bytes read calling viRead */ errStatus = InitVisa(&vi); if(errStatus < VI_SUCCESS) HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...
  • Page 143 /* find the substring "COMPLETE" in the reply of the instrument */ replySubStr = replyBuf; while(*replySubStr) if(!strncmp(replySubStr,"COMPLETE",strlen("COMPLETE"))) break; replySubStr ++; }while (!*replySubStr); /*substring "COMPLETE" not found */ /*continue polling */ HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...
  • Page 144 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); HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...
  • Page 145 /* Open session to HPIB 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; HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...
  • Page 146 Programming Examples How to Log Results HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...

  • Page 147: The Hp 816X Vxiplug&Play Instrument Driver

    The HP 816x VXIplug&play Instrument Driver HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...
  • Page 148 There are details about opening and closing an instrument session, data types and constants used, error handling, and the programming environments supported. HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...

  • Page 149: Installing The Hp 816X Instrument Driver

    You install the driver by running the executable hp816x.exe. 1 Run hp816x.exe, you see a Welcome screen telling you that the HP 816x VXIplug&play Instrument Driver will be installed and the instruments that support the driver.
  • Page 150 Setup. 5 You can choose a Typical, Compact, or Custom Setup. Choose a setup option and press Next> to continue. HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...
  • Page 151 Figure 11 Program Folder Item Options You see a window asking you in which folder you want to install the files. HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...

  • Page 152: Using Visual Programming Environments

    Hewlett-Packard Visual Engineering Environment (HP VEE) is a visual programming language optimized for instrument control applications. To develop programs in HP VEE, you connect graphical ‘objects’ instead of writing lines of code. These programs resemble easy-to-understand block diagrams with lines.

  • Page 153: Gpib Interfacing In Hp Vee

    Using Visual Programming Environments The HP 816x VXIplug&play Instrument Driver GPIB Interfacing in HP VEE HP VEE supports interfacing with an instrument from a GPIB card. Before you can do this, you must do the following: 1 Select I from the IO menu.

  • Page 154: Getting Started With Labview

    Getting Started with LabView The 32-bit HP 816x driver can be used with LabView 5.0 and above. LabView 5.0 is a 32-bit version of LabView which runs on Windows 95 and Windows NT. To access the functions of the HP 816x instrument driver convert the driver using the following steps: 1 Run LabView.
  • Page 155 VI’s. This library of VI’s can then be accessed like any other VI library in LabView. N O T E You must use the 32-bit version of the HP 816x driver with LabView 5.0. N O T E LabView is a trademark of National Instruments Corporation.

  • Page 156: Getting Started With Labwindows

    • The HP 816x VXIplug&play Instrument Driver conforms with the VXIplug&play standard. There is one exception as the HP 816x driver does not have a soft front panel or a knowledge-based file. • The HP 816x VXIplug&play Instrument Driver is built on top of VISA, and uses the services provided.

  • Page 157: Directory Structure

    Directory Structure The HP 816x VXIplug&play Instrument Driver • The HP 816x VXIplug&play Instrument Driver includes a Visual Basic (.BAS) file which contains the function calls in Visual Basic syntax, and allows the driver functions to be called from Visual Basic.

  • Page 158: Closing An Instrument Session

    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. HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...

  • Page 159: Visa Data Types And Selected Constant Definitions

    N O T E You can find a partial list of the type definitions and constant definitions for the visatype.h in the HP 816x VXIplug&play Instrument Driver Online Help. Error Handling Events and errors within a instrument control program can be detected by polling (querying) the instrument.
  • Page 160 /* display the error */ printf("Driver Error : %ld, %s\n", errStatus, err_message); /* optionally reset the instrument, close the instrument handle */ hp816x_reset(instrumentHandle); hp816x_close(instrumentHandle); exit(1); return; HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...

  • Page 161: Introduction To Programming

    The following information is useful if you are using the driver with a version of VISA. Instrument Addresses When you are using HP VXIplug&play instrument drivers, you should enter the instrument addresses using only upper case letters. This is to ensure maximum portability.

  • Page 162: Hp Vee 5.01 (Or Higher)

    The HP 816x driver is located in a self-extracting archive file called hp816x.EXE. If you do not have ftp or web access, please contact your HP supplier, or use the version of hp816x.exe on your installation CD. HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System,...

  • Page 163: Gpib Command Compatibility List

    GPIB Command Compatibility List HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...
  • Page 164 GPIB Command Compatibility List This chapter gives information about adapting programs developed for use with HP 8153A Lightwave Multimeter or HP 8167B/8D/8E/8F Tunable Laser Source. HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...

  • Page 165: Compatibility Issues

    Both Table 9 Incompatible GPIB Bus Commands Status Model The status model is completely incompatible with the HP 8153A and HP 8167/8. Preset Defaults The preset defaults are different. HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...

  • Page 166: Removed Command

    Risetime control is not supported yet. 8167/8 Table 10 Removed Commands Obsolete Commands Table 10 contains details of commands that have been directly replaced. HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...

  • Page 167: Changed Parameter Syntax And Semantics

    PROGram command tree SENSe:FUNCtion command tree. 8153 Some commands from the PROGram command tree have not been replaced. 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 Com-...

  • Page 168: Changed Query Result Values

    8153 length; use SOUR:WAV? to query the wavelength. SOUR:WAV:FIXED1? returns the wavelength of the first laser and SOUR:WAV:FIXED2? returns the wavelength of the second laser. For the HP 8153A, SOUR:POW:WAV? returned the wavelength of the ac- tive laser. SYSTem:ERRor? Same functionality but different numbers and errors are 8153 returned for instrument specific errors.

  • Page 169: Error Handling

    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 HP 8163A/4A; instead of timing out for every error, special values are returned for erroneous queries.
  • Page 170 GPIB Command Compatibility List Instrument Status Settings HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...
  • Page 171 Error Codes HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...
  • Page 172 Error Codes This chapter gives information about error codes used with the HP 8163A Lightwave Multimeter, the HP 8164A Lightwave Measurement System, and the HP 8166A Lightwave Multichannel System. HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...
  • Page 173 “Invalid block data” Standard -168 “Block data not allowed” Standard -170 “Expression error” Standard -171 “Invalid expression” Table 17 Overview for Supported Strings HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...
  • Page 174 Standard -222 “Data out of range” Standard -223 “Too much data” Standard -224 “Illegal parameter value” Table 17 Overview for Supported Strings HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...
  • Page 175 -322 “Flash programming error” -330 “Self-test failed” -340 “Printing error” -341 “Printing error - paper out” Table 17 Overview for Supported Strings HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...
  • Page 176 “Query INTERRUPTED” Standard -420 “Query UNTERMINATED” Standard -430 “Query DEADLOCKED” Standard -440 “Query UNTERMINATED after indef resp” Table 17 Overview for Supported Strings HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...
  • Page 177 “Protect user data memory lost” -313 “Calibration memory lost” -314 “Save/Recall Memory lost” -315 “Configuration memory lost” Table 18 Overview for Unsupported Strings HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...
  • Page 178 Error Codes GPIB Error Strings HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System User’s Guide, E1299...
  • Page 179 Status Byte 48 state 96 switch on 96 Status Command Summary 30 Laser Selection Numbers 22 Status Information 23 LCD 124 Status Reporting 50 HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System Programming Guide, E1299...
  • Page 180 SYSTem 59 TRIGger 108 SYSTem subsystem 59 Test 49 Time 61 Trace Data Access 61 TRIGger Subsystem 108 Units 20 Wait 49 HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System, & HP 8166A Lightwave Multichannel System Programming Guide, E1299...

This manual is also suitable for:

8164a series8166a series

Table of Contents