Agilent Technologies
Warn in G
WA R N I N G
Japan 0120 421 0120 421 678 FAX Mexico 5081
Agilent Technologies Sales and Service Offices
This manual is divided into 5 parts
Structure of this Manual
Conventions used in this Manual
T E
Related Manuals
Table of Contents
Root Layer Command
Specific Command Summary
Signal Generation The SOURce Subsystem
Signal Conditioning
Using Visual Programming Environments
Installing the Agilent 816x Instrument Driver
Features of the Agilent 816x Instrument Driver
Error Handling
Preset Defaults
Compatibility Issues
Removed Command
Obsolete Commands
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Sixth Edition
Operational/Questionable Status System for
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Sixth Edition
List of Tables
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Sixth Edition
Introduction to Programming
Camino del Rio South, Suite 340 San Diego, CA
Gpib Interface
Introduction to Programming
Scpi Consortium Office Bode Enterprise
Mnemonic Function
Gpib Interface
If the instrument is in remote control, a screen resembling
Returning the Instrument to Local Control
Message Queues
Message Queues
Clearing the Input Queue
How the Input Queue Works
Output Queue
If no error has occurred, the error queue contains
Error Queue
If more than 29 errors are put into the queue, the message
Is placed as the last message in the queue
Crlf
Command message is ended by a line feed character LF or
Programming and Syntax Diagram Conventions
Short Form and Long Form
Statusoperationenable
Is in long form Short form of this message is
Statoperenab
Unit Default Allowed Mnemonics
Command and Query Syntax
Units
String Value Wsp
Slot and Channel Numbers
Data Types
Laser Selection Numbers
112,
Input to your Return Loss module for the following commands
Common Commands
Common Commands
Parameter Function
Common Command Summary
Gives a summary of the common commands
Common Status Information
ESE sets the Standard Event Status Enable Mask
All bits shown as are unused Event Status Enable Mask
T E
Status Registers
Status Model
Status Model
Slot Status Condition
Status System for 8163A/B & 8164A/B
Slot Status Event
Status System for 8166A/B
Status Byte Register
Annotations
Standard Event Status Register
Operation/Questionable Status Summary
Operation/Questionable Slot Status
Operation/Questionable Status Summary Register
Operation Slot Status Register
Questionable Slot Status Register
Status Model
Long
Status Command Summary
OPT? WAI IDN?
Other Commands
Introduction to Programming
Specific Commands
Specific Commands
Specific Command Summary
Command Description
WAVelengthREFerence/?
FETChnCHANnelmSCALar
Command Description DISPlay
INITiatenCHANnelm
INPUTnCHANnelm
Terminals
PATH/?
READnCHANnelm
ROUTen
SENSenCHANnelmFUNCtion
SENSenCHANnelmPOWer
SENSenCHANnelmRETurnlossCALibration
Command Description SENSenCHANnelmPOWerReference
SENSenCHANnelmRETurnlossCORRection
SLOTn
SOURcenCHANnelmPOWerATTenuationl
SOURcenCHANnelmPOWer
SOURcenCHANnelm
SOURcenCHANnelmAM
SOURcenCHANnelmWAVelengthREFerence
SOURcenCHANnelmWAVelengthCORRection
SOURcenCHANnelmWAVelengthSWEepSTEP
Command Description SOURcenCHANnelmWAVelengthSWEep
STATusn
Command Description SPECial
STATusOPERation
STATusnOPERation
Slot n
Command Description STATusnQUEStionable
SYSTem
SYSTemCOMMunicateGPIB
Specific Commands
Instrument Setup and Status
Instrument Setup and Status
IEEE-Common Commands
At power-on By sending a value of zero
Error queue
Standard event status register Sesr
Status byte register STB
Bit Mnemonic Decimal Value
ESE?
Power-on
Complete, Command Idle State
Parameters None Response Identification terminated by END
Agilent Technologies Manufacturer
Lead to useful gains in program execution efficiency
Plete, Command Idle State
Slot 1 for the Agilent 8163A/B and Agilent 8166A/B
Example OPT? → 81682A , , 81533B, 81532A, END
Following are not changed
Error queue
Selftest failed on Mainframe
Bits Mnemonic
Pending operations, are completed during the wait period
WAI
STATusOPERationEVENtLEVel0?
Status Reporting The STATus Subsystem
Bits Mnemonics
Agilent 8163A/B Agilent 8164A/B Agilent 8166A/B
STATusOPERationCONDitionLEVel0?
Status Reporting The STATus Subsystem
STATusOPERationENABleLEVel0?
STATusOPERationENABleLEVel
STATusOPERationEVENtLEVel1?
Bits Mnemonics Decimal Value Agilent 8166A/B
Syntax STATusOPERationENABleLEVel1wspvalue Description
STATusOPERationENABleLEVel1
STATusOPERationENABleLEVel1?
STATusOPERationCONDitionLEVel1?
Extrapolated values
Offset
STATus nOPERationEVENt?
STATus nOPERationCONDition?
STATusnOPERationENABlewspvalue
STATusnOPERationENABle
STATusnOPERationENABle?
STATusPRESet
Statques? → +0END
STATusQUEStionableEVENtLEVel0?
Agilent 8163A/B Agilent 8164A/B
STATusQUEStionableCONDitionLEVel0?
STATusQUEStionableEVENtLEVel1?
STATusQUEStionableENABleLEVel
STATusQUEStionableENABleLEVel0?
STATusQUEStionableENABleLEVel1?
Syntax STATusQUEStionableENABleLEVel 1wspvalue Description
STATusQUEStionableCONDitionLEVel 1?
Syntax STATusQUEStionableCONDitionLEVel 1? Description
Syntax STATusnQUEStionableEVENt? Description
STATusnQUEStionableEVENt?
11-15 Not Used
STATusnQUEStionableCONDition?
STATusnQUEStionableENABle?
STATusnQUEStionableENABle
STATusnQUEStionableENABlewspvalue
SYSTemDATE?
SYSTemERRor?
SYSTemDATE
Standard Event Status Enable Mask SESEM,
Output and error queues
Gpib interface state
Backlight and contrast of the display
SYSTemVERSion?
SYSTemTIME?
SYSTemCOMMunicateGPIBSELFADDRess
Systcommgpibaddr
Measurement Operations & Settings
LOCK?
Root Layer Command
Measurement Operations & Settings
Manufacturer
Agilent Technologies as the manufacturer
Slot nEMPTy?
Slot nIDN?
SLOTnHEADnIDN?
SLOTnTST?
SLOTnHEADnEMPTy?
SLOTnHEADmTST?
SLOTnHEADmOPTions?
SLOTnHEADmWAVelengthRESPonse?
Syntax SLOTnHEADmWAVelengthRESPonse? Description
SLOTnHEADmWAVelengthRESPonseSIZE?
SPECialREBoot
SLOTnHEADmWAVelengthRESPonseCSV?
Measurement Functions SENSe Subsystem
Command
Agilent 81635A and Agilent 81619A Master Slave Channels
Measurement Functions The SENSe Subsystem
SENSenCHANnelmPOWerUNIT/? SENSenCHANnelmPOWerWAVelength/?
FETChnCHANnelmSCAlarRETurnloss?
FETChnCHANnelmSCAlarPOWerDC?
INITiatenCHANnelmCONTinuous
FETChnCHANnelmSCAlarMONitor?
INITiatenCHANnelmIMMediate
INITiate nCHANnel mCONTinuous?
Read nCHANnel mSCALarPOWerALL?
READnCHANnelmSCALarPOWerDC?
Read nCHANnel mPOWerALLCONFig?
Ber
Member of the pair represents the channel number
READnCHANnelmSCALarRETurnloss?
READnCHANnelmSCALarMONitor?
SENSenCHANnelmCORRectionCOLLectZERO
SENSe nCHANnel mCORRectionLOSSINPutMAGNitude
SENSenCHANnelmCORRectionLOSSINPutMAGNitude?
SENSenCHANnelmCORRectionCOLLectZEROALL
SENSe nCHANnel mCORRectionCOLLectZERO?
Operation
SENSenCHANnelmFUNCtionPARameterLOGGing?
SENSenCHANnelmFUNCtionPARameterLOGGing
Averaging Time
SENSenCHANnelmFUNCtionPARameterMINMax?
SENSenCHANnelmFUNCtionPARameterMINMax
Cont
Wind
Period time
SENSenCHANnelmFUNCtionPARameterSTABility
Averaging Time Period Time
Response Example Affects Dual sensors
SENSenCHANnelmFUNCtionRESult?
SENSenCHANnelmFUNCtionPARameterSTABility?
Sens1funcres? →
Return Loss modules
SENSe nCHANnel mFUNCtionRESultMAXBlocksize?
SENSe nCHANnel mFUNCtionRESultBLOCk?
SENSenCHANnelmFUNCtionRESultMONitor?
SENSenCHANnelmFUNCtionSTATe?
100
SENSenCHANnelmFUNCtionSTATe
101
SENSenCHANnelmPOWerATIMe
SENSenCHANnelmFUNCtionTHReshold
SENSenCHANnelmFUNCtionTHReshold?
SENSenCHANnelmPOWerRANGeUPPer
SENSenCHANnelmPOWerATIMe?
Range Upper Linear Power Limit
102
SENSenCHANnelmPOWerRANGeMONitorUPPer
SENSenCHANnelmPOWerRANGeUPPer?
103
Range Upper Linear
SENSenCHANnelmPOWerRANGeAUTO
SENSenCHANnelmPOWerRANGeMONitorUPPer?
Ment. Otherwise, it must be set by the sensnpowrang command
SENSenCHANnelmPOWerRANGeAUTO?
105
Reference mode using the command
You must append a unit type
DB if you use TOMODule or
SENSenCHANnelmPOWerREFerenceSTATe
SENSenCHANnelmPOWerREFerenceDISPlay
SENSenCHANnelmPOWerREFerenceSTATe?
106
SENSenCHANnelmPOWerREFerenceSTATeRATio?
SENSe nCHANnel mPOWerREFerenceSTATeRATio
107
To the channel for the second value
SENSenCHANnelmPOWerUNIT?
SENSe nCHANnel mPOWerUNIT
SENSenCHANnelmPOWerWAVelength
108
109
SENSenCHANnelmPOWerWAVelength?
SENSenCHANnelmRETurnlossCALibrationFACTory
SENSenCHANnelmRETurnlossCALibrationFACTory
SENSe nCHANnel mRETurnlossCALibrationCOLLectTERMination
110
Defined termination reference measurement. See
SENSe nCHANnel mRETurnlossCALibrationTERMination?
SENSenCHANnelmRETurnlossCORRectionFPDeltal?
111
SENSenCHANnelmRETurnlossCORRectionFPDeltal
SENSe nCHANnel mRETurnlossCORRectionREFLectance l
112
DB reference
Lower wavelength source is denoted by
113
Signal Generation The SOURce Subsystem
OUTPutnCHANnelmCONNection
OUTPutnCHANnelmCONNection?
OUTPutnCHANnelmSTATe
114
OUTPutnCHANnelmPATH?
SOURcenCHANnelmAMINTernalFREQuencyl?
115
SOURcenCHANnelmAMINTernalFREQuencyl
SOURcenCHANnelmAMSOURcel
116
Syntax SOURcenCHANnelmAMSOURcelwsp
INTINT1INT2COHCAEXTEXTDEXTWVLLBACK012356
SOURcenCHANnelmAMSTATel
117
SOURcenCHANnelmAMSTATel?
Wavelength source is denoted by
SOURce nCHANnel mAMCOHCtrlCOHLevel l
118
SOURcenCHANnelmAMCOHCtrlCOHLevell?
SOURcenCHANnelmFMSOURcel
SOURce nCHANnel mFMSOURce l?
119
SOURcenCHANnelmFMSTATel
SOURcenCHANnelmFMSTATel?
SOURcenCHANnelmFMSBSCtrlFREQuencyl
120
Mhzkhzhzminmaxdef
SOURcenCHANnelmFMSBSCtrlFREQuencyl?
SOURcenCHANnelmFMSBSCtrlLevell?
121
SOURcenCHANnelmMODout
SOURcenCHANnelmMODout?
122
SOURcenCHANnelmPOWerATTenuationl?
SOURcenCHANnelmPOWerATTenuationlAUTO?
SOURcenCHANnelmPOWerATTenuationlAUTO
SOURcenCHANnelmPOWerATTenuationlDARK
This command is available in Attenuation Mode Only
124
SOURcenCHANnelmPOWerATTenuationlDARK?
SOURcenCHANnelmPOWerLEVelIMMediateAMPLitudel
Also allowed MIN minimum amplitude level
SOURcenCHANnelmPOWerLEVelIMMediateAMPLitudel?
125
126
SOURcenCHANnelmPOWerLEVelRISetimel
SOURcenCHANnelmPOWerLEVelRISetimel?
SOURcenCHANnelmPOWerSTATe?
SOURce nCHANnel mPOWerSTATe
SOURcenCHANnelmPOWerUNIT
SOURcenCHANnelmPOWerUNIT?
128
SOURcenCHANnelmPOWerWAVelength
SOURcenCHANnelmPOWerWAVelength?
SOURce nCHANnel mREADoutDATA?
129
Pmax
SOURce nCHANnel mREADoutDATABLOCk?
SOURcenCHANnelmWAVelengthCWlFIXEDlwspvalue
130
SOURcenCHANnelmREADoutPOINts?
SOURcenCHANnelmWAVelengthCWlFIXEDl
SOURcenCHANnelmWAVelengthCORRectionARA
131
SOURcenCHANnelmWAVelengthCWlFIXEDl?
SOURce nCHANnel mWAVelengthCORRectionARAALL
132
SOURce nCHANnel mWAVelengthCORRectionAUTocalib
81989A, 81949A
SOURcenCHANnelmWAVelengthCORRectionZEROALL
133
SOURce nCHANnel mWAVelengthCORRectionZERO
SOURcenCHANnelmWAVelengthCORRectionZEROAUTO
134
SOURcenCHANnelmWAVelengthFREQuencyl
Thzghzmhzkhzhz
SOURcenCHANnelmWAVelengthFREQuencyl?
135
SOURcenCHANnelmWAVelengthREFerencel?
SOURcenCHANnelmWAVelengthREFerenceDISPlay
Message
136
SOURcenCHANnelmWAVelengthSWEepCHECkparams?
ValueMINMAXDEF0
137
SOURce nCHANnel mWAVelengthSWEepCYCLes
SOURce nCHANnel mWAVelengthSWEepCYCLes?
SOURce nCHANnel mWAVelengthSWEepDWELl
138
SOURce nCHANnel mWAVelengthSWEepDWELl?
SOURcenCHANnelmWAVelengthSWEepEXPectedtriggers?
SOURcenCHANnelmWAVelengthSWEepFLAG?
139
Sweep state
Start Sweep waiting for trigger Trigger →
140
Following settings are the prerequisites for Lambda Logging
SOURcenCHANnelmWAVelengthSWEepLLOGging
SOURcenCHANnelmWAVelengthSWEepLLOGgingwspOFFON01
SOURcenCHANnelmWAVelengthSWEepMODE
141
SOURcenCHANnelmWAVelengthSWEepMODE?
SOURcenCHANnelmWAVelengthSWEepPMAX?
SOURcenCHANnelmWAVelengthSWEepREPeat?
142
SOURcenCHANnelmWAVelengthSWEepREPeat
SOURce nCHANnel mWAVelengthSWEepSOFTtrigger
143
SOURcenCHANnelmWAVelengthSWEepSPEed
SOURcenCHANnelmWAVelengthSWEepSPEed?
SOURce nCHANnel mWAVelengthSWEepSTARt
144
SOURcenCHANnelmWAVelengthSWEepSTARt?
SOURcenCHANnelmWAVelengthSWEepSTOP
145
If you enable lambda logging see
SOURcenCHANnelmWAVelengthSWEepSTOP?
SOURcenCHANnelmWAVelengthSWEepSTATe
SOURcenCHANnelmWAVelengthSWEepSTATe?
146
SOURcenCHANnelmWAVelengthSWEepSTEPNEXT
SOURcenCHANnelmWAVelengthSWEepSTEPPREVious
SOURce nCHANnel mWAVelengthSWEepSTEPWIDTh?
147
INPut and OUTput commands
Signal Conditioning
148
INPut nCHANnel mATTenuation
INPutnCHANnelmOFFSet
149
INPutnCHANnelmOFFSet?
INPutnCHANnelmOFFSetDISPlay
150
INPutnCHANnelmOFFSetPOWermeter
INPutnCHANnelmATTenuationSPEed
INPutnCHANnelmATTenuationSPEed?
INPutnCHANnelmWAVelength
151
MAX DEF
INPutnCHANnelmWAVelength?
OUTPutnCHANnelmPOWer?
OUTPutnCHANnelmPOWer
152
OUTPut nCHANnel mAPMode?
OUTPutnCHANnelmPOWerREFerence?
OUTPutnCHANnelmPOWerREFerence
OUTPutnCHANnelmPOWerREFerencePOWermeter
153
OUTPutnCHANnelmPOWerOFFSet?
OUTPutnCHANnelmPOWerOFFSet
OUTPutnCHANnelmPOWerOFFSetPOWermeter
154
OUTPutnCHANnelmPOWerCONTRol?
OUTPut nCHANnel mPOWerCONTRol
OUTPutnCHANnelmPOWerUNit
155
OUTPutnCHANnelmSTATeAPOWeron
OUTPut nCHANnel mPOWerUNit?
156
OUTPut nCHANnel mSTATe
157
OUTPutnCHANnelmSTATeAPOWeron?
OUTPutnCHANnelmATIMe
OUTPutnCHANnelmATIMe?
OUTPCORRCOLLZER0? → 0END
158
OUTPutnCHANnelmCORRectionCOLLectionZEROALL
159
Table of wavelength-dependent offsets
CONFigurenCHANnelmOFFSetWAVelengthSTATe?
CONFigurenCHANnelmOFFSetWAVelengthSTATe
160
CONF1OFFSWAVSTAT on
CONFigurenCHANnelmOFFSetWAVelengthREFerence
CONFigurenCHANnelmOFFSetWAVelengthVALue
161
CONF1OFFSWAVREF 4,2
CONFigurenCHANnelmOFFSetWAVelengthVALueWAVelength?
CONFigurenCHANnelmOFFSetWAVelengthREFerence?
CONFigurenCHANnelmOFFSetWAVelengthVALueOFFSet?
162
CONFigurenCHANnelmOFFSetWAVelengthVALueDELete
CONFigurenCHANnelmOFFSetWAVelengthVALuePAIR?
CONFigurenCHANnelmOFFSetWAVelengthVALueDELeteALL
163
CONFigurenCHANnelmOFFSetWAVelengthTABleSIZE?
CONFigurenCHANnelmOFFSetWAVelengthTABle?
164
CONF1OFFSWAVTABSIZE? →
TIP Query the Scpi error queue using SYSTERR?
When the attenuator is hosted in Slot
Slot Numbers
165
166
Command Semantic
167
Display and System Commands
Ieee Commands
168
Status Commands
User Calibration Data
Switch modules
Signal Routing
169
ROUTe nCHANnel m
Syntax ROUTenCHANnelmCONFig? Description
ROUTenCHANnelmCONFig?
ROUTenCHANnelmCONFigROUTe?
170
171
Triggering The TRIGger Subsystem
Hardware
Software Triggering Data Acquisition Functions Sensfuncstat
DISabled An output trigger will never be generated AVGover
Generating Output Triggers from Power Measurements
172
Software Triggering Data Acquisition Functions
173
TRIGgernCHANnelmINPutREARm
174
TRIGgernCHANnelmINPut?
TRIGger nCHANnel mINPutREARm?
175
TRIGgernCHANnelmOFFSet
TRIGgernCHANnelmOFFSet value
TRIGger nCHANnel mOUTPut
176
Return loss modules
Continuous mode, wavswestepwidt is used for triggering, see
TRIGgerCONFiguration
Output triggers using power measurements
177
TRIGger nCHANnel mOUTPutREARm
TRIGgerCONFigurationFPEDal
TRIGgerCONFiguration?
TRIGgerCONFigurationFPEDal?
178
179
Extended Trigger Configuration
TRIGger
Bit unsigned integer , see below
180
Extended Trigger Configuration
181
Node a Input Configuration
Node B Input Configuration
Output Trigger Connector or Individual module slots
Extended Trigger Configuration Example
Output Matrix Configuration
182
Sequence starts again at and continues until the sweep ends
183
Trigconfext #H2,#H0,#H0 is described by -1 and sets one bit
184
185
Mass Storage, Display, and Print Functions
DISPlay Subsystem
Display Operations
186
Display
DISPlayENABle?
DISPlayENABle
187
DISPlayBRIGhtness?
DISPlayLOCKout?
188
Mass Storage, Display, and Print Functions
189
Instrument using Visa library calls
Same program
CD-ROM 08164-90BC4
Visa Programming Examples
How to Use Visa Calls
190
191
How to Use Visa Calls
192
How to Set up a Fixed Laser Source
193
How to Set up a Fixed Laser Source
194
195
How to Measure Power using FETCh and Read
How to Measure Power using FETCh and Read
196
197
198
199
How to Co-ordinate Two Modules
How to Co-ordinate Two Modules
200
201
202
203
How Power Varies with Wavelength
How Power Varies with Wavelength
204
205
206
207
How to Log Results
How to Log Results
208
209
210
211
212
213
Agilent 816x VXIplug&play Instrument Driver
Agilent 816x VXIplug&play Instrument Driver
214
215
Installing the Agilent 816x Instrument Driver
216
Program Folder Item Options
217
Getting Started with Agilent VEE
Using Visual Programming Environments
Gpib Interfacing in Agilent VEE
218
219
Using Visual Programming Environments
Enter the following information Name enter hp816X
Select hp816X from the Plug&play Driver Name drop-down list
220
This folder contains a subfolder named instr.lib
Getting Started with LabView
221
FP Conversion Options Box
222
Instrument Driver with LabView
223
LabView is a trademark of National Instruments Corporation
224
Getting Started with LabWindows
225
Features of the Agilent Instrument Driver
Features of the Agilent 816x Instrument Driver
226
Directory Structure
227
Opening an Instrument Session
Successful completion of this function returns Visuccess
Opening an Instrument Session
228
Closing an Instrument Session
Visa Data Types and Selected Constant Definitions
229
Check for an error or event after each function
Error Handling
230
ViStatus errStatus
231
Error Handling
Example Programs
Introduction to Programming
VISA-Specific Information
Development Environments
Agilent VEE 5.01 or higher
Microsoft Visual Basic 4.0 or higher
LabWindows CVI/ R 4.0 or higher
233
Latest copy of this driver can be downloaded via
Online Information
234
Lambda Scan Applications
Lambda Scan Applications
235
236
Equally Spaced Datapoints
237
How to Perform a Lambda Scan Application
Prepare Lambda Scan Function
Execute Lambda Scan Function
Get Lambda Scan Parameters Function
238
Get Lambda Scan Parameters
8164A or B Power
How to Perform a Multi-Frame Lambda Scan Application
Power 8163A or B
239
Register Mainframe Function
Equally Spaced Datapoints Function
Unregister Mainframe Function
240
241
Prepare Multi Frame Lambda Scan Function
Execute Multi Frame Lambda Scan Function
Get MF Lambda Scan Parameters Function
Get Lambda Scan Result Function
242
Get Channel Location Function
Get Number of PWM Channels Function
243
Maximum number of channels that may be specified is
244
257
Error Codes
258
Gpib Error Strings
Suffix too long
259
Program mnemonic too long
260
New 185
261
Standard 200
New 201
Old 211
262
Old 212
Old 213
Standard 222
263
Old 221
264
265
266
267
268
To -499 Query Errors
Standard 420
269
Standard 430
Standard 440
Overview for Unsupported Strings
270
245
Gpib Command Compatibility List
These commands are incompatible
Compatibility Issues
Command Change Affects
Gpib Bus Compatibility
247
248
Preset Defaults
Preset defaults are different
249
Removed Command
250
Obsolete Commands
Old Command New Command Affects
251
Changed Parameter Syntax Semantics
SOURAMFREQ/?
Dispbrig
252
Changed Query Result Values
TST
SENSPOWUNIT?
253
Timing Behavior
Details the ways in which timing behavior is different
Change Affects
FLT/DBLMAX
254
Returned Value Affects
255
Command Order
Command Order
256
Instrument Status Settings
271
Index
Slot
272
Page
Agilent Technologies, Deutschland GmbH 08164-90B64