Agilent 8163A/B Lightwave Multimeter,
Agilent 8164A/B Lightwave Measurement System, &
Agilent 8166A/B Lightwave Multichannel System
Programming Guide
Agilent Technologies
Download from Www.Somanuals.com. All Manuals Search And Download.
Warnings and Notices
WARNING
To avoid the possibility of injury or death, you must observe the following
precautions before switching on the instrument.
Insert the power cable plug only into a socket outlet provided with a
protective earth contact. Do not negate this protective action by the
using an extension cord without a protective conductor.
WARNING
Never look directly into the end of a fiber or a connector, unless you are
absolutely certain that there is no signal in the fiber.
Download from Www.Somanuals.com. All Manuals Search And Download.
Agilent Technologies Sales and Service Offices
For more information about Agilent Technologies test and measurement
products, applications, services, and for a current sales office listing, viesit
our web site:
http://www.agilent.com/comms/lightwave
You can also contact one of the following centers and ask for a test and
measurement sales representative.
United States:
Canada:
Europe:
1 800 829 4444
1 800 829 4433(FAX)
1 877 894 4414
(1888 900 8921(FAX)
(31 20) 547 2111
(31 20) 547 2190 (FAX)
Japan:
0120 421 345
0120 421 678 (FAX)
Mexico
(52 55) 5081 9469
(52 55) 5081 9467 (FAX)
Australia:
Asia-Pacific:
Brazil
1 800 629 485
1 800 142 134 (FAX)
800 930 871
800 908 476 (FAX)
(55 11) 4197 3600
(55 11) 4197 3800 (FAX)
Download from Www.Somanuals.com. All Manuals Search And Download.
In this Manual
This manual contains information about SCPI commands which can be
used to program the following instruments:
• Agilent 8163A/B Lightwave Multimeter
• Agilent 8164A/B Lightwave Measurement System
• Agilent 8166A/B Lightwave Multichannel System
The Structure of this Manual
This manual is divided into 5 parts:
to SCPI programming with the Agilent 8163A/B Lightwave Multimeter,
the Agilent 8164A/B Lightwave Measurement System, and the
Agilent 8166A/B Lightwave Multichannel System.
commands.
Functions” on page 185 give fuller explanations of all instrument
specific commands.
programs showing how the SCPI commands can be used with the
Agilent 8163A/B Lightwave Multimeter, the Agilent 8164A/B
Lightwave Measurement System, and the Agilent 8166A/B Lightwave
Multichannel System.
Instrument Driver, compatibility issues, and error codes.
Conventions used in this Manual
• All commands and typed text is written in Courier font, for example
INIT[:IMM].
Download from Www.Somanuals.com. All Manuals Search And Download.
• SCPI commands are written in mixed case: text that you MUST print is
written in capitals; text which is helpful but nor necessary is written in
lower case.
So, the command INITiate[:IMMediate] can be entered either as
init[:imm], or as initiate[:immediate]. It does not matter whether you
enter text using capitals or lower-case letters.
• SCPI commands often contain extra arguments in square brackets.
These arguments may be helpful, but they need not be entered.
So, the command INITiate[:IMMediate] can be entered as init or
initiate:imm.
• A SCPI command which can be either a command or a query is
appended with the text /?.
So, DISPlay:ENABle/? refers to both the command DISPlay:ENABle and
the query DISPlay:ENABle?.
Related Manuals
You can find more information about the instruments covered by this
manual in the following manuals:
• Agilent 8163A/B Lightwave Multimeter, Agilent 8164A/B Lightwave
Measurement System, & Agilent 8166A/B Lightwave Multichannel
System User’s Guide (Agilent Product Number 08164-90B14).
Please note that User Guides no longer contain programming information,
and must now be used in conjunction with this manual.
NOTE
General Purpose Interface Bus, GPIB.
Download from Www.Somanuals.com. All Manuals Search And Download.
Table of Contents
5
5
6
15
16
18
19
20
20
21
22
23
24
25
25
26
26
27
29
30
31
33
33
35
36
37
37
37
37
38
38
38
38
40
41
Agilent 8163A/B, 8164A/B, & 8166A/B Programming Guide, Fourth Edition
7
Download from Www.Somanuals.com. All Manuals Search And Download.
43
44
55
56
64
Subsystem
76
79
80
85
85
113
148
148
159
165
165
166
167
167
168
168
169
171
179
182
185
186
8
Agilent 8163A/B, 8164A/B, & 8166A/B Programming Guide, Fourth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
189
190
192
195
199
203
207
213
214
218
218
218
221
224
225
226
227
228
229
230
232
232
232
232
232
232
232
233
233
233
234
235
236
Agilent 8163A/B, 8164A/B, & 8166A/B Programming Guide, Fourth Edition
9
Download from Www.Somanuals.com. All Manuals Search And Download.
237
237
238
238
239
240
240
240
241
242
242
242
243
243
245
246
246
247
248
249
250
251
252
253
254
255
256
257
258
271
10
Agilent 8163A/B, 8164A/B, & 8166A/B Programming Guide, Fourth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
List of Figures
Remote Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
The Operational/Questionable Status System for
Figure 4
8163A/B & 8164A/B . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .159
Figure 6
Figure 10 Welcome Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .215
Figure 11 Customizing Your Setup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .216
Figure 12 Program Folder Item Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .217
Figure 13 Device Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .219
Figure 15 Search for GPIB Instruments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .221
Figure 16 FP Conversion Options Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .222
Figure 18 Equally Spaced Datapoints . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .236
Figure 19 Lambda Scan Operation Setup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .237
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Sixth Edition
11
Download from Www.Somanuals.com. All Manuals Search And Download.
12
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Sixth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
List of Tables
Table 6
GPIB Capabilities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Commands that are independent for both master and slave
channels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
Comparison of command semantics beween 8156A attenuator
and 8156xA modular attenuator family. . . . . . . . . . . . . . . . . . . . . . . .166
Triggering and Power Measurements . . . . . . . . . . . . . . . . . . . . . . . . .171
Table 7
Table 8
Table 19
Specific Errors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .254
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Sixth Edition
13
Download from Www.Somanuals.com. All Manuals Search And Download.
14
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Sixth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
1
Introduction to Programming
This chapter gives general information on how to control your instrument
remotely.
Descriptions for the actual commands for the instruments are given in the
following chapters. The information in these chapters is specific to the
Agilent 8163A/B Lightwave Multimeter, Agilent 8164A/B Lightwave
Measurement System, and Agilent 8166A/B Lightwave Multichannel
System and assumes that you are already familiar with programming the
GPIB.
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
15
Download from Www.Somanuals.com. All Manuals Search And Download.
Introduction to Programming
GPIB Interface
GPIB Interface
The interface used by your instrument is the GPIB (General Purpose
Interface Bus).
GPIB is the interface used for communication between a controller and an
external device, such as the tunable laser source. The GPIB conforms to
IEEE standard 488-1978, ANSI standard MC 1.1 and IEC recommendation
625-1.
If you are not familiar with the GPIB, then refer to the following books:
• The International Institute of Electrical and Electronics Engineers. IEEE
Standard 488.1-1987, IEEE Standard Digital Interface for Programmable
Instrumentation. New York, NY, 1987
• The International Institute of Electrical and Electronics Engineers. IEEE
Standard 488.2-1987, IEEE Standard Codes, Formats, Protocols and
Common Commands For Use with ANSI/IEEE Std 488.1-1987. New York,
NY, 1987
To obtain a copy of either of these last two documents, write to:
The Institute of Electrical and Electronics Engineers, Inc.
345 East 47th Street
New York, NY 10017
USA.
In addition, the commands not from the IEEE-488.2 standard, are defined
according to the Standard Commands for Programmable Instruments
(SCPI).
For information about SCPI, and SCPI programming techniques, please
refer to:
• The SCPI Consortium: Standard Commands for Programmable
Instruments. To obtain a copy of this manual, contact the following
address:
SCPI Consortium Office
Bode Enterprise
2515 Camino del Rio South, Suite 340
San Diego, CA, 92108
USA
16
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
GPIB Interface
Introduction to Programming
The interface of the Agilent 8163A/B Lightwave Multimeter,
Agilent 8164A/B Lightwave Measurement System, and Agilent 8166A/B
Lightwave Multichannel System to the GPIB is defined by the IEEE
Standards 488.1 and 488.2.
implement.
Table 1 GPIB Capabilities
Mnemonic
Function
SH1
AH1
T6
Complete source handshake capability
Complete acceptor handshake capability
Basic talker; serial poll; no talk only mode; unaddressed to talk
if addressed to listen
L4
Basic listener; no listen only mode; unaddressed to listen if ad
dressed to talk
SR0
RL1
PP0
DC1
DT0
C0
No service request capability
Complete remote/local capability
No parallel poll capability
Complete device clear capability
No device trigger capability
No controller capability.
Setting the GPIB Address
There are two ways to set the GPIB address:
• You can set the GPIB address by using the command
• 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.
GPIB address 21 is often applied to the GPIB controller. If so, 21 cannot be
used as an instrument address.
NOTE
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
17
Download from Www.Somanuals.com. All Manuals Search And Download.
Introduction to Programming
GPIB Interface
Returning the Instrument to Local Control
If the instrument is in remote control, a screen resembling
local control.
Figure 1 Remote Control
If your Agilent 8163A/B, 8164A/B or 8166A/B is in local lockout mode
(refer to DISPlay:LOCKout on page 142) the Local softkey is not available.
NOTE
18
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
Message Queues
Introduction to Programming
Message Queues
The instrument exchanges messages using an input and an output queue.
Error messages are kept in a separate error queue.
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
19
Download from Www.Somanuals.com. All Manuals Search And Download.
Introduction to Programming
Message Queues
How the Input Queue Works
The input queue is a FIFO queue (first-in first-out). Incoming bytes are
stored in the input queue as follows:
1 Receiving a byte:
• Clears the output queue.
• Clears Bit 7 (MSB).
2 No modification is made inside strings or binary blocks. Outside strings
and binary blocks, the following modifications are made:
• Lower-case characters are converted to upper-case.
• The characters 00 to 09 and 0B to 1F are converted to spaces
16
16
16
16
(20 ).
16
• Two or more blanks are truncated to one.
3 An EOI (End Or Identify) sent with any character is put into the input
queue as the character followed by a line feed (LF, 0A ). If EOI is sent
16
with a LF, only one LF is put into the input queue.
4 The parser starts if the LF character is received or if the input queue is
full.
Clearing the Input Queue
Switching the power off, or sending a Device Interface Clear signal, causes
commands that are in the input queue, but have not been executed to be
lost.
20
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
Message Queues
Introduction to Programming
The Output Queue
The output queue contains responses to query messages. The instrument
transmits any data from the output queue when a controller addresses the
instrument as a talker.
Each response message ends with a carriage return (CR, 0D ) and a LF
16
(0A ), with EOI=TRUE. If no query is received, or if the query has an error,
16
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.
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
21
Download from Www.Somanuals.com. All Manuals Search And Download.
Introduction to Programming
Message Queues
The Error Queue
The error queue is 30 errors long. It is a FIFO queue (first-in first-out). That
is, the first error read is the oldest error to have occurred. For example:
1
2
If no error has occurred, the error queue contains:
+ 0, "No error"
After a command such as wav:pow, the error queue now contains:
+ 0, "No error"
-113, "Undefined header"
3
If the command is immediately repeated, the error queue now contains:
+ 0, "No error"
-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.
22
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
Programming and Syntax Diagram Conventions
Introduction to Programming
Programming and Syntax
Diagram Conventions
A program message is a message containing commands or queries that
you send to the instruments. The following are a few points about program
messages:
• You can use either upper-case or lower-case characters.
• You can send several commands in a single message. Each command
must be separated from the next one by a semicolon (;).
• A command message is ended by a line feed character (LF) or
<CR><LF>.
• You can use any valid number/unit combination.
In other words, 1500NM,1.5UM and 1.5E-6M are all equivalent.
If you do not specify a unit, then the default unit is assumed. The default
unit for the commands are given with command description in the next
chapter.
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
23
Download from Www.Somanuals.com. All Manuals Search And Download.
Introduction to Programming
Programming and Syntax Diagram Conventions
Short Form and Long Form
The instrument accepts messages in short or long forms.
For example, the message
:STATUS:OPERATION:ENABLE 768
is in long form.
The short form of this message is
:STAT:OPER:ENAB 768
In this manual, the messages are written in a combination of upper and
lower case. Upper case characters are used for the short form of the
message.
For example, the above command would be written
:STATus:OPERation:ENABle
The first colon can be left out for the first command or query in your
message. That is, the example given above could also be sent as
STAT:OPER:ENAB 768
24
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
Programming and Syntax Diagram Conventions
Introduction to Programming
Command and Query Syntax
All characters not between angled brackets must be sent exactly as
shown.
The characters between angled brackets (<...>) indicate the kind of data
that you should send, or that you get in a response. You do not type the
angled brackets in the actual message.
Descriptions of these items follow the syntax description. The following
types of data are most commonly used:
string
value
wsp
is ascii data. A string is contained between double quotes ("...") or
single quotes (‘...’).
is numeric data in integer (12), decimal (34.5) or exponential format
(67.8E-9).
is a white space.
Other kinds of data are described as required.
The characters between square brackets ([...]) show optional information
that you can include with the message.
The bar (|) shows an either-or choice of data, for example, a|b means
either a or b, but not both simultaneously.
Extra spaces are ignored, so spaces can be inserted to improve readability.
Units
Where units are given with a command, usually only the base units are
specified. The full sets of units are given in the table below.
Table 2 Units and allowed Mnemonics
Unit
Default
Allowed Mnemonics
meters
M
PM, NM, UM, MM, M
MDB, DB
decibel
DB
second
S
NS, US, MS, S
decibel/1mW
Hertz
DBM
HZ
MDBM, DBM
HZ, KHZ, MHZ, GHZ, THZ
PW, NW, UW, MW, Watt
NM/S, UM/S, MM/S, M/S
Watt
Watt
M/S
meters per second
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
25
Download from Www.Somanuals.com. All Manuals Search And Download.
Introduction to Programming
Programming and Syntax Diagram Conventions
Data Types
With the commands you give parameters to the instrument and receive
response values from the instrument. Unless explicitly specified these
data are given in ASCII format. The following types of data are used:
• Boolean data may only have the values 0 or 1.
• Integer range is given for each individual command.
• Float variables may be given in decimal or exponential writing (0.123 or
123E-3).
All Float values conform to the 32 bit IEEE Standard, that is, all Float
values are returned as 32-bit real values.
• A string is contained between double quotes ("...") or single quotes
(‘...’). When the instrument returns a string, it is always included in " "
and terminated by <END>.
• When a register value is given or returned (for example *ESE), the
decimal values for the single bits are added. For example, a value of
nine means that bit 0 and bit 3 are set.
• Larger blocks of data are given as Binary Blocks, preceded by
“#<H><Len><Block>”, terminated by <END>; <H> represents the
number of digits, <Len> represents the number of bytes, and <Block> is
the data block. For example, for a Binary Block with 1 digit and 6 bytes
this is: #16TRACES<END>.
Slot and Channel Numbers
Each module is identified by a slot number and a channel number. For
commands that require you to specify a channel, the slot number is
represented by [n] in a command and the channel number is represented
by [m].
The slot number represents the module’s position in the mainframe. These
are:
• from one to two for the Agilent 8163A/B,
• from zero to four for the Agilent 8164A/B, and
• from one to seventeen for the Agilent 8166A/B.
These numbers are displayed on the front panel beside each module slot.
26
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
Programming and Syntax Diagram Conventions
Introduction to Programming
The Agilent 8164A/B slot for a back-loadable tunable laser module is
numbered zero.
NOTE
Channel numbers apply to modules that have two inputs/outputs, for
example, the Agilent 81635A Dual Power Sensor.
Modules with two channels, for example, the Agilent 81635A Dual Power
Sensor, use the channel number to distinguish between these channels.
The channel number of single channel modules is always one.
NOTE
For example, if you want to query slot 1, channel 2 with the command,
send the command:
• :sens1:chan2:pow:wav?
If you do not specify a slot or channel number, the lowest possible number
is used as the default value. This means:
NOTE
•
•
•
Slot 1 for the Agilent 8163A/B and Agilent 8166A/B mainframes.
Slot 0 for the Agilent 8164A/B mainframe.
Channel 1 for all channels.
Laser Selection Numbers
The laser selection number, [l], identifies the upper or lower wavelength
laser source for dual wavelength Laser Source modules and Return Loss
modules with two internal laser sources. The lower wavelength source is
denoted by 1. The upper wavelength source is denoted by 2.
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
27
Download from Www.Somanuals.com. All Manuals Search And Download.
Introduction to Programming
Programming and Syntax Diagram Conventions
For Return Loss modules, 0 denotes the use of an external laser source as
the input to your Return Loss module for the following commands:
NOTE
page 112, and
28
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
Common Commands
Introduction to Programming
Common Commands
The IEEE 488.2 standard has a list of reserved commands, called common
commands. Some of these commands must be implemented by any
instrument using the standard, others are optional.
Your instrument implements all the necessary commands, and some
optional ones. This section describes the implemented commands.
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
29
Download from Www.Somanuals.com. All Manuals Search And Download.
Introduction to Programming
Common Commands
Common Command Summary
Table 3 Common Command Summary
Command Parameter Function
Page
*CLS
Clear Status Command
*ESE
Standard Event Status Enable Command
Standard Event Status Enable Query
Standard Event Status Register Query
Identification Query
*ESE?
*ESR?
*IDN?
*OPC
*OPC?
*OPT?
*RST
Operation Complete Command
Operation Complete Query
Options Query
Reset Command
*STB?
*TST?
*WAI
Read Status Byte Query
Self Test Query
Wait Command
NOTE
30
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
Common Commands
Introduction to Programming
Common Status Information
There are three registers for the status information. Two of these are
status-registers and one is an enable-registers. These registers conform to
the IEEE Standard 488.2-1987. You can find further descriptions of these
registers under *ESE, *ESR?, and *STB?.
and the Standard Event Status Register (SESR) determine the Event Status
Bit (ESB) of the Status Byte.
*ESE sets the Standard Event Status Enable Mask
Event
Status
Enable
Mask
7
1
6
5
1
4
1
3
1
2
1
1
0
1
*STB? returns the Status Byte Register
OSB ESB MAV QSB
&
7
6
5
4
3
2
1
0
Status
Byte
&
0
1
0
0
&
&
&
&
&
All bits shown as
are unused
&
7
0
6
5
0
4
0
3
0
2
0
1
0
1
Event
Status
Register
*ESR? returns the Standard Event Status Register
Figure 2 The Event Status Bit
The SESR contains the information about events that are not slot specific.
The SESEM allows you to choose the event that may affect the ESB of the
Status Byte. If you set a bit of the SESEM to zero, the corresponding event
cannot affect the ESB. The default is for all the bits of the SESEM to be set
to 0.
The questionable and operation status systems set the Operational Status
Bit (OSB) and the Questionable Status Bit (QSB). These status systems
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
31
Download from Www.Somanuals.com. All Manuals Search And Download.
Introduction to Programming
Common Commands
Unused bits in any of the registers change to 0 when you read them.
NOTE
32
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
The Status Model
Introduction to Programming
The Status Model
Status Registers
Each node of the status circuitry has three registers:
• A condition register (CONDition), which contains the current status.
This register is updated continuously. It is not changed by having its
contents read.
• The event register (EVENt), which contains details of any positive
transitions in the corresponding condition register, that is, when a bit
changes from 0 → 1. The contents of this register are cleared when it is
read. The contents of any higher-level registers are affected with regard
to the appropriate bit.
• The enable register (ENABle), which enables changes in the event
register to affect the next stage of registers.
The event register is the only kind of register that can affect the next stage
of registers.
NOTE
The structures of the Operational and Questionable Status Systems are
Operational Status Bit (OSB) of the Status Byte Register are determined.
Enable Registers
To the
Condition Register
of the Next Node
OR
Event Registers
A positive transition in the condition
register, when a bit changes from 0
causes the corresponding bit of the
corresponding event register
→
1,
1 1 1 1 1
to change from 0
→
1.
Condition Registers
Figure 3 The Registers and Filters for a Node
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
33
Download from Www.Somanuals.com. All Manuals Search And Download.
Introduction to Programming
The Status Model
The Operational/Questionable Slot Status Event Register (OSSER/QSSER)
contains the status of a particular module slot. A bit changes from 0 → 1
when an event occurs, for example, when a laser is switched on. For
details of the function of each bit of these registers, see
The Operational/Questionable Slot Enable Status Mask (OSESM/QSESM)
allows you to choose the events for each module slot that may affect the
Operational/Questionable Status Event Register (see below). If you set a
bit of the OSESM/QSESM to zero, the occurence of the corresponding
event for this particular module slot cannot affect the
Operational/Questionable Status Event Register. The default is for all the
bits of the OSESM/QSESM to be set to 0.
The Operational/Questionable Status Event Summary Register
(OSESR/QSESR) summarizes the status of every module slot of your
instrument. If, for any slot, any bit of the QSSER goes from 0 → 1 AND the
corresponding bit of the QSSEM is 1 at the same time, the QSESR bit
representing that slot is set to 1.
The Operational/Questionable Status Enable Summary Mask
(OSESM/QSESM) allows you to choose the module slots that may affect
the OSB/QSB of the Status Byte. If any bit of the QSESR goes from 0 → 1
AND the corresponding bit of the QSESM is 1 at the same time, the QSB of
the Status Byte is set to 1. If you set a bit of the OSESM/QSESM to zero,
the corresponding module slot cannot affect the OSB/QSB. The default is
for all the bits of the OSESM/QSESM to be set to 0.
The Operational/Questionable Status Enable Summary Mask for the
Agilent 8163A/B Lightwave Multimeter and the Agilent 8164A/B
Lightwave Measurement System consists of one level. These are
As the Agilent 8166A/B Lightwave Multichannel System has 17 module
slots, the Operational/Questionable Status Enable Summary Mask
consists of two levels. This is described in “Status System for 8166A/B”
34
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
The Status Model
Introduction to Programming
Status System for 8163A/B & 8164A/B
The status system for the Agilent 8163A/B Lightwave Multimeter and the
Agilent 8164A/B Lightwave Measurement System returns the status of 2
and 5 module slots respectively. The Operational/Questionable Status
Any commands that require LEVel1 do not apply to these mainframes.
Status Byte Register
Status Byte
Operational/Questionable Status
Enable Summary Mask
Register
Status Summary
to next
level
&
&
&
&
OR
Operational/Questionable Status
Event Summary Register
for a positive
transition
Operational/Questionable Status
Condition Summary Register
Operational/Questionable
Slot Status Enable Mask
Slot 1
to next
level
Register
&
&
OR
&
&
Operational/Questionable
Slot Status Event
Register
for a positive
transition
Operational/Questionable
Slot Status Condition
Register
Figure 4 The Operational/Questionable Status System for 8163A/B & 8164A/B
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
35
Download from Www.Somanuals.com. All Manuals Search And Download.
Introduction to Programming
The Status Model
Status System for 8166A/B
The status system for the Agilent 8166A/B Lightwave Multichannel
System returns the status of 17 module slots. The
Operational/Questionable Status Summary Registers consists of two
Module slots 1 to 14 affect the Level 0 summary register as described in
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.
Status Byte Register
Status Byte
Operational/Questionable Status
Enable Summary Mask
Register (Level 0)
Status
Summary
for Level 0
to next
level
&
&
&
OR
&
Operational/Questionable Status
Event Summary Register (Level 0)
for a positive
transition
Operational/Questionable Status
Condition Summary Register (Level 0)
Operational/Questionable Status
Enable Summary Mask
Register (Level 1)
Status
Summary
for Level 1
to next
level
&
&
OR
&
&
Operational/Questionable Status
Event Summary Register (Level 1)
for a positive
transition
Operational/Questionable Status
Condition Summary Register (Level 1)
Operational/Questionable
Slot Status Enable Mask
Slot 15
to next
level
Register
&
&
OR
&
&
Operational/Questionable
Slot Status Event
Register
for a positive
transition
Operational/Questionable
Slot Status Condition
Register
Figure 5 The Operational/Questionable Status System for 8166A/B
36
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
The Status Model
Introduction to Programming
Annotations
Status Byte Register
• Bit 3, the QSB, is built from the questionable event status register and
its enable mask.
• Bit 4, the MAV, is set if the message output queue is not empty.
• Bit 5, the ESB, is built from the SESR and its SESEM.
• Bit 7, the OSB, is built from the operation event status register and its
enable mask.
• All other bits are unused, and therefore set to 0.
Standard Event Status Register
• Bit 0 is set if an operation complete event has been received since the
last call to *ESR?.
• Bit 1 is always 0 (no service request).
• Bit 2 is set if a query error has been detected.
• Bit 3 is set if a device dependent error has been detected.
• Bit 4 is set if an execution error has been detected.
• Bit 5 is set if a command error has been detected.
• Bit 6 is always 0 (no service request).
• Bit 7 is set for the first call of *ESR? after Power On.
Operation/Questionable Status Summary
• The Operation/Questionable Status Summary consist of a condition and
an event register.
• A "rising" bit in the condition register is copied to the event register.
• A "falling" bit in the condition register has no effect on the event
register.
• Reading the condition register is non-destructive.
• Reading the event register is destructive.
• A summary of the event register and its enable mask is set in the status
byte.
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
37
Download from Www.Somanuals.com. All Manuals Search And Download.
Introduction to Programming
The Status Model
Operation/Questionable Status Summary Register
• Bits 0 to 4 are built from the OSSER/QSSER and the OSSEM/QSSEM.
• A summary of the event register, the condition register and the enable
mask is set in the status byte.
Operation/Questionable Slot Status
• The Operation/Questionable Slot Status consist of a condition and an
event register.
• A "rising" bit in the condition register is copied to the event register.
• A "falling" bit in the condition register has no effect on the event
register.
• Reading the condition register is non-destructive.
• Reading the event register is destructive.
• A summary of the event register, the condition register and the enable
mask is set in the status byte.
Operation Slot Status Register
• Bit 0 is set if the laser is switched on.
• Bit 1 is set if the Coherence Control is switched on.
• Bit 3 is set if Power Meter zeroing or Tunable Laser module lambda
zeroing is ongoing.
• Bit 4 is set if the attenuator output is enabled (shutter open).
• All other bits are unused, and therefore set to 0.
Questionable Slot Status Register
• Bit 0 is set if excessive power is set by the user for any source module
or if excessive averaging time is set for any Power Meter.
• Bit 1 is set if the last Power Meter zeroing failed.
• Bit 2 is set if temperature is out of range.
• Bit 3 is set if laser protection is switched on.
38
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
The Status Model
Introduction to Programming
• Bit 4 is set if the module has not settled, as during the automatic
settling of a Tunable Laser module.
• Bit 5 is set if the module is out of specifications, or if lambda zeroing
failed for a Tunable Laser module.
• Bit 6 is set if ARA is recommended.
• Bit 7 is set if the duty cycle is out of range.
• Bit 8 is set if coherence control is uncalibrated
• Bit 9 is set if attenuator beam path protection is enabled (shutter is
closed)
• Bit 10 is set if lambda zeroing is recommended.
• All other bits are unused, and therefore set to 0.
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
39
Download from Www.Somanuals.com. All Manuals Search And Download.
Introduction to Programming
The Status Model
Status Command Summary
*STB? returns status byte, value 0 .. +255
*ESE
*ESE? returns SESE, value 0 .. +255
*ESR? returns the standard event status register, value 0 .. +255
sets the standard event status enable mask, parameter 0 .. +255
*OPC
parses all program message units in the message queue, and prevents
the instrument from executing any further commands until all pending
commands are completed.
*OPC? returns 1 if all operations (scan trace printout, measurement) are com
pleted. Otherwise it returns 0.
*CLS
clears the status byte and SESR, and removes any entries from the er
ror queue.
*RST
clears the error queue, loads the default setting, and restarts communi
cation.
NOTE: *RST does NOT touch the STB or SESR. A running measurement
is stopped.
*TST? initiates an instrument selftest and returns the results as a 32 bit
LONG.
40
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
The Status Model
Introduction to Programming
Other Commands
*OPT? returns the installed modules and the slots these modules are installed
in:
For example, *OPT? → 81682A, 81533B, 81532A, ,
Modules 81682A, 81533B, and 81532A are installed in slots 0 to 2 re
spectively. Slots 3 and 4 are empty.
*WAI
prevents the instrument from executing any further commands until the
current command has finished executing. All pending operations are
completed during the wait period.
*IDN? identifies the instrument; returns the manufacturer, instrument model
number, serial number, and firmware revision level.
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
41
Download from Www.Somanuals.com. All Manuals Search And Download.
Introduction to Programming
The Status Model
42
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
2
Specific Commands
This chapter lists all the instrument specific commands relating to the
Agilent 8163A/B Lightwave Multimeter, the Agilent 8164A/B Lightwave
Measurement System, and the Agilent 8166A/B Lightwave Multichannel
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.
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
43
Download from Www.Somanuals.com. All Manuals Search And Download.
Specific Commands
Specific Command Summary
Specific Command Summary
The commands are ordered in a command tree. Every command belongs to
a node in this tree.
The root nodes are also called the subsystems. A subsystem contains all
commands belonging to a specific topic. In a subsystem there may be
further subnodes.
All the nodes have to be given with a command. For example in the
command disp:brig
• DISPlay is the subsystem containing all commands for controlling the
display,
• BRIGhtness is the command selecting brightness.
If a command and a query are both available, the command ends /?.
So, disp:brig/? means that disp:brig and disp:brig? are both available.
NOTE
subnodes, and the included commands.
Table 4 Specific Command Summary
Command
Description
Page
:CONFigure[n][:CHANnel[m]]:OFFSet
:WAVelength:REFerence/?
Sets or queries the slot and channel of the external reference
powermeter.
:WAVelength:STATe/?
Switches or queries attenuator Offset Table on or off/?
Queries the complete offset table.
:WAVelength:TABle?
:WAVelength:TABle:SIZE?
:WAVelength:VALue
Queries the size of the offset table.
Adds a value pair (wavelength, offset) to the offset table.
Deletes an offset value pair.
:WAVelength:VALue:DELete
:WAVelength:VALue:DELete:ALL
:WAVelength:VALue:OFFSet?
:WAVelength:VALue:PAIR?
Deletes all value pairs from the offset table.
Queries an offset value according to wavelength or index.
or index.
:WAVelength:VALue:WAVelength?
Queries a wavelength value from its index in the offset table
44
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
Specific Command Summary
Specific Commands
Table 4 Specific Command Summary (continued)
Command
Description
Page
:DISPlay
:BRIGhtness/?
Controls or queries the current display brightness.
Controls or queries the current display contrast.
:CONTrast/?
:ENABle/?
on or off.
:LOCKout/?
Sets or queries local lockout mode.
:FETCh[n][:CHANnel[m]][:SCALar]
:POWer[:DC]?
Returns a power value from a sensor.
Returns the current return loss value.
:RETurnloss?
:MONitor?
return loss module.
:INITiate[n]:[CHANnel[m]]
[:IMMediate]
Starts a measurement.
:CONTinuous/?
Starts or Queries a single/continuous measurement.
:LOCK/?
:INPUT[n][:CHANnel[m]]
:ATTenuation/?
Sets or returns the attenuation factor for the instrument.
Sets or returns the offset factor for the instrument.
Sets the offset factor so that attenuation factor is zero.
:OFFset/?
:OFFset:DISPlay
:OFFset:POWermeter
sured with a powermeter and with the monitor diode.
:ATTenuation:SPEed/?
:WAVelength/?
Sets or queries the filter transition speed
Sets or queries the modules attenuation wavelength
:OUTPut[n][:CHANnel[m]]
:APMode/?
been changed.
:APOWeron/?
Sets or queries the shutter status at power on.
Sets or queries the powermeter averaging time.
Selects or returns Analog Output parameter.
Zeros the offsets of attenuators powermeter
Zeros all available powermeter channels in mainframe
:ATIMe/?
:CONNection/?
:CORRection:COLLection:ZERO
:CORRection:COLLection:ZERO:ALL
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
45
Download from Www.Somanuals.com. All Manuals Search And Download.
Specific Commands
Specific Command Summary
Table 4 Specific Command Summary (continued)
Command
Description
Page
:CORRection:COLLection:ZERO?
Queries the status of the last zero operation
Sets or returns the regulated path.
:PATH/?
:POWer/?
Sets or queries the output power value.
Sets or queries power control mode status
Sets or queries the power offset value.
:POWer:CONTRol/?
:POWer:OFFSet/?
:POWer:OFFSet:POWermeter
:POWer:REFerence/?
:POWer:REFerence:POWermeter
Calculates power offset from measured power values
Sets or queries the reference power value.
power parameter
:POWer:UNit/?
[:STATe]/?
Sets or queries power unit used (dBm or W)
or returns the current status of a source’s or attenuators output
terminals.
:READ[n][:CHANnel[m]]
[:SCALar]:POWer[:DC]?
Reads the current power value from a sensor.
Reads all available power meter channels.
:POWer[:DC]:ALL?
:POWer[:DC]:ALL:CONFig?
meter channel.
[:SCALar]:RETurnloss?
[:SCALar]:MONitor?
Reads the current return loss value.
return loss module.
:ROUTe[n]
[:CHANnel[m]]/?
Sets or returns the channel route between two ports.
Reads the switch configuration of an instrument.
Reads the allowed switch routes of an instrument.
[:CHANnel[m]]:CONFig?
[:CHANnel[m]]:CONFig:ROUTe?
46
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
Specific Command Summary
Specific Commands
Table 4 Specific Command Summary (continued)
Command
Description
Page
:SENSe[n][:CHANnel[m]]:CORRection
[:LOSS][:INPut][:MAGNitude]/?
Sets or returns the value of correction data for a sensor.
Executes a zero calibration of a sensor module.
Returns the current zero state of a sensor module.
Executes a zero calibration of all sensor modules.
:COLLECT:ZERO
:COLLECT:ZERO?
:COLLECT:ZERO:ALL
:SENSe[n][:CHANnel[m]]:FUNCtion
:PARameter:LOGGing/?
Sets or returns the number of samples and the averaging time,
, for logging.
t
avg
:PARameter:MINMax/?
:PARameter:STABility/?
Sets or returns the minmax mode and the window size.
, for stability.
t
avg
:RESult?
Returns the data array of the last function.
:RESult:BLOCk?
power meter data acquisition function.
:RESult:MAXBlocksize?
:RESult:MONitor?
:STATe/?
functions.
function.
tion mode is enabled.
:THReshold/?
Sets or returns the threshold value and the start mode.
:SENSe[n][:CHANnel[m]]:POWer
:ATIMe/?
Sets or returns the average time of a sensor.
:RANGe[:UPPer]/?
sor.
:RANGe:MONitor[:UPPer]/?
:RANGe:AUTO/?
Sets or returns the range of the monitor diode within a return loss page 103
module.
ic range without overloading.
:REFerence/?
:UNIT/?
Sets or returns the reference level of a sensor.
:WAVelength/?
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
47
Download from Www.Somanuals.com. All Manuals Search And Download.
Specific Commands
Specific Command Summary
Table 4 Specific Command Summary (continued)
Command
Description
Page
:SENSe[n][:CHANnel[m]]:POWer:Reference
:DISPlay
:STATe/?
units.
:STATe:RATio/?
channel or to an absolute reference.
:SENSe[n][:CHANnel[m]]:RETurnloss:CALibration
:FACTory
Sets the calibration value to factory settings.
:COLLect:REFLectance
Sets the reference reflectance calibration values to the values
currently measured by the chosen return loss module. (When, for
example, a gold reflector is used.)
:COLLect:TERMination
Sets the termination calibration values to the values currently
measured by the chosen return loss module.
:COLLect:VALues?
:TERMination?
Returns current calibration values.
Returns T-Value
:SENSe[n][:CHANnel[m]]:RETurnloss:CORRection
:FPDelta[l]/?
due, for example, to the front panel connector.
:REFLectance[l]/?
your reference reflector.
:SLOT[n]
:EMPTy?
Returns whether the module slot is empty.
Returns information about the module.
Returns the module’s options.
:IDN?
:OPTions?
:TST?
Returns the latest selftest results for a module.
:SLOT[n][:HEAD[m]]
:EMPTy?
Returns whether an optical head is connected.
Returns information about the optical head.
Returns the optical head’s options.
:IDN?
:OPTions?
:TST?
Returns the latest selftest results for an optical head.
:WAVelength:RESPonse?
Returns the wavelength response from the module with wave-
length calibration.
:WAVelength:RESPonse:CSV?
Returns the wavelength response from the module with wave-
length calibration.
48
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
Specific Command Summary
Specific Commands
Table 4 Specific Command Summary (continued)
Command
Description
Returns the no. of elements in the wavelength response table.
Page
:WAVelength:RESPonse:SIZE?
[:SOURce[n]][:CHANnel[m]]
:MODout/?
Returns the mode of the modulation output mode of the BNC
connector on the front panel of Agilent 81640A/80A/82A Tun-
able Laser modules.
[:SOURce[n]][:CHANnel[m]]:AM
[:INTernal]:FREQuency[l]/?
Sets or returns the frequency of an internal signal source.
Sets or returns a source for the modulating system.
:SOURce[l]/?
:STATe[l]/?
Turns Amplitude Modulation of a source on or off or queries
whether Amplitude Modulation is on or off.
:COHCtrl:COHLevel[l]/?
Sets or returns the coherence level.
[:SOURce[n]][:CHANnel[m]]:FM
:SOURce[l]/?
cifically Simulated Brillouin Scattering (SBS) control.
:STATe[l]/?
Turns Frequency Modulation of a source on or off or queries
whether Frequency Modulation is on or off.
:SBSCtrl:FREQuency[l]/?
:SBSCtrl:LEVel[l]/?
Sets or returns the frequency of SBS Control modulation.
Sets or returns the level of SBS Control modulation
(as a percentage of maximum)
[:SOURce[n]][:CHANnel[m]:]POWer
[:LEVel][:IMMediate][:AMPLitude[l]]
Sets the laser output power of a source.
Returns the laser output power of a source.
Sets or returns the laser rise time of a source.
Sets or returns the attenuation level for a source.
Sets or returns the state of the source output signal.
Sets or returns the power units.
[:LEVel][:IMMediate][:AMPLitude[l]]?
[:LEVel]:RISetime[l]/?
:ATTenuation[l]/?
:STATe/?
:UNIT/?
:WAVelength/?
Sets or returns the wavelength source of a dual-wavelength
source.
[:SOURce[n]][:CHANnel[m]:]POWer:ATTenuation[l]
:AUTO/?
returns the selected mode.
:DARK/?
‘dark’ position is active for a source.
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
49
Download from Www.Somanuals.com. All Manuals Search And Download.
Specific Commands
Specific Command Summary
Table 4 Specific Command Summary (continued)
Command
Description
Page
[:SOURce[n]][:CHANnel[m]:]READout
:DATA?
Returns number of datapoints returned by the
:DATA:BLOCk?
:DATA:MAXBlocksize?
:POINts?
eration, or maximum power at wavelength characteristic.
mum power at wavelength characteristic will return.
operation or the maximum power the laser can produce at each
wavelength.
[:SOURce[n]][:CHANnel[m]:]WAVelength
[:CW[l]:FIXED]
Sets the absolute wavelength of a source.
Returns the absolute wavelength of a source.
[:CW[l]:FIXED[l]]?
:FREQuency[l]/?
length for a source.
:REFerence[l]?
Returns the reference wavelength of a source.
[:SOURce[n]][:CHANnel[m]:]WAVelength:CORRection
:ARA
Realigns the laser cavity.
:ARA:ALL
Realigns the laser cavity of every tunable laser source in the
mainframe.
:AUTocalib
:ZERO
Sets or returns tunable laser source Auto Calibration state.
Executes a wavelength zero.
:ZERO:ALL
mainframe.
:ZERO:TEMPerature:ACTual?
Reports the current lambda zero temperature
:ZERO:TEMPerature:DIFFerence?
Reports the temperature difference required to trigger an auto
lamda zero.
:ZERO:TEMPerature:LASTzero?
:ZERO:AUTO
place.
Forces an auto lamda zero. This is quicker than the equilavent
manual process.
[:SOURce[n]][:CHANnel[m]:]WAVelength:REFerence
:DISPlay
put wavelength.
50
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
Specific Command Summary
Specific Commands
Table 4 Specific Command Summary (continued)
Command
Description
Page
[:SOURce[n]][:CHANnel[m]:]WAVelength:SWEep
:CHECkparams?
:CYCLes/?
Returns whether sweep parameters set are consistent.
Sets or returns the number of cycles.
Sets or returns the dwell time.
:DWELl/?
:EXPectedtriggers?
:FLAG?
Returns number of triggers (used to configure power meter).
Returns whether waiting for trigger, or logging data available.
:LLOGging/?
logging.
:MODE/?
:PMAX?
Sets or returns the sweep mode.
:REPeat/?
:SOFTtrigger
:SPEed/?
:STARt/?
:STOP/?
Sets or returns the repeat mode.
Sends a soft trigger.
Sets or returns the speed for continuous sweeping.
Sets or returns the start point of the sweep.
Sets or returns the end point of the sweep.
[:STATe]/?
the the state of a sweep.
[:SOURce[n]][:CHANnel[m]:]WAVelength:SWEep:STEP
:NEXT
Performs the next sweep step.
:PREVious
[:WIDTh]/?
Performs the previous sweep step again.
Sets or returns the width of the sweep step.
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
51
Download from Www.Somanuals.com. All Manuals Search And Download.
Specific Commands
Specific Command Summary
Table 4 Specific Command Summary (continued)
Command
Description
Page
:SPECial
:REBoot
Reboots the mainframe and all modules.
Presets all Enable Registers.
:STATus[n]
:PRESet
:STATus:OPERation
[:EVENt]?
[:EVENt]:LEVel1?
15 - 17 of the Agilent 8166A/B Lightwave Multichannel System.
:CONDition?
Returns the Operational Status Condition Summary Register.
:CONDition:LEVel1?
slots 15 - 17 of the Agilent 8166A/B Lightwave Multichannel Sys-
tem.
:ENABle/?
Sets or queries the Operational Status Enable Summary Mask.
:ENABle:LEVel1/?
slots 15 - 17 of the Agilent 8166A/B Lightwave Multichannel Sys-
tem.
:STATusn:OPERation
[:EVENt]?
Returns the Operational Slot Status Event Register for slotn.
:CONDition?
:ENABle/?
:STATus:QUEStionable
[:EVENt]?
Returns the Questionable Status Event Summary Register.
[:EVENt]:LEVel1?
Returns the Questionable Status Event Summary Register for
slots 15 - 17 of the Agilent 8166A/B Lightwave Multichannel Sys-
tem.
:CONDition?
Returns the Questionable Status Condition Summary Register.
:CONDition:LEVel1?
slots 15 - 17 of the Agilent 8166A/B Lightwave Multichannel Sys-
tem.
:ENABle/?
:ENABle:LEVel1/?
for slots 15 - 17 of the Agilent 8166A/B Lightwave Multichannel
System.
52
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
Specific Command Summary
Specific Commands
Table 4 Specific Command Summary (continued)
Command
Description
Page
:STATusn:QUEStionable
[:EVENt]?
Returns the Questionable Slot Status Event Register for slot n.
:CONDition?
:ENABle/?
n.
slot n.
:SYSTem
:DATE/?
Sets or returns the instrument’s internal date.
Returns the contents of the instrument’s error queue.
Returns a list of GPIB commands.
:ERRor?
:HELP:HEADers?
:PRESet
Sets all parameters to their default values.
Sets or returns the instrument’s internal time.
Returns the instrument’s SCPI version.
:TIME/?
:VERSion?
:SYSTem:COMMunicate:GPIB
[:SELF]:ADDress/?
Sets or returns the GPIB address.
Generates a hardware trigger.
:TRIGger
:CONFiguration/?
Sets or returns trigger configuration.
:TRIGger:CONFiguration
:EXTended/?
Sets or returns extended trigger configuration.
:FPEDal/?
ing a Foot Pedal or returns whether the Input Trigger connector
can be triggered using a Foot Pedal.
:TRIGger[n][CHANnel[m]]
:INPut/?
Sets or returns the incoming trigger response .
:OFFset/?
data logging begins
:INPut:REARm/?
:OUTPut/?
Re-arms input trigger
Sets or returns the outgoing trigger response.
Re-arms output trigger
:OUTPut:REARm/?
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
53
Download from Www.Somanuals.com. All Manuals Search And Download.
Specific Commands
Specific Command Summary
54
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
3
Instrument Setup and Status
This chapter gives descriptions of commands that you can use when
setting up your instrument. The commands are split into the following
separate subsytems:
• STATus subsystem commands that relate to the status model.
• SYSTem subsystem commands that control the serial interface and
internal data.
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
55
Download from Www.Somanuals.com. All Manuals Search And Download.
Instrument Setup and Status
IEEE-Common Commands
IEEE-Common Commands
“Common Commands” on page 29 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.
56
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
IEEE-Common Commands
Instrument Setup and Status
command:
*CLS
syntax:
*CLS
description:
The CLear Status command *CLS clears the following:
• Error queue
• Standard event status register (SESR)
• Status byte register (STB)
After the *CLS command the instrument is left waiting for the next command. The instru-
ment setting is unaltered by the command, although *OPC/*OPC? actions are cancelled.
parameters:
response:
example:
none
none
*CLS
command:
syntax:
*ESE
*ESE<wsp><value>
0 ≤ value ≤ 255
description:
The standard Event Status Enable command (*ESE) sets bits in the Standard Event Status
Enable Mask (SESEM) that enable the corresponding bits in the standard event status regis-
ter (SESR).
The register is cleared:
• at power-on,
• by sending a value of zero.
The register is not changed by the *RST and *CLS commands.
The bit value for the register (a 16-bit signed integer value):
parameters:
Bit
Mnemonic
Decimal Value
7 (MSB)
Power On
128
0
6
Not Used
5
Command Error
Execution Error
Device Dependent Error
Query Error
32
16
8
4
3
2
4
1
Not Used
0
0 (LSB)
Operation Complete
1
response:
example:
none
*ESE 21
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
57
Download from Www.Somanuals.com. All Manuals Search And Download.
Instrument Setup and Status
IEEE-Common Commands
command:
*ESE?
syntax:
*ESE?
description:
The standard Event Status Enable query *ESE? returns the contents of the Standard Event
Status Enable Mask (see *ESE for information on this register).
parameters:
response:
example:
none
The bit value for the register (a 16-bit signed integer value).
*ESE? → 21<END>
command:
*ESR?
syntax:
*ESR?
description:
The standard Event Status Register query *ESR? returns the contents of the Standard
Event Status Register. The register is cleared after being read.
parameters
response
none
The bit value for the register (a 16-bit signed integer value):
Bit
Mnemonic
Decimal Value
7 (MSB)
Power On
128
0
6
Not used
5
Command Error
Execution Error
Device Dependent Error
Query Error
32
16
8
4
3
2
4
1
Not used
0
0 (LSB)
Operation Complete
1
example:
*ESR? → 21<END>
58
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
IEEE-Common Commands
Instrument Setup and Status
command:
*IDN?
syntax:
*IDN?
description:
parameters:
response:
The IDeNtification query *IDN? gets the instrument identification over the interface.
none
The identification terminated by <END>:
For example.
Agilent Technologies
mmmm
ssssssss
manufacturer
instrument model number (for example 8164B)
serial number
rrrrrrrrrr
firmware revision level
example:
*IDN? → Agilent Techologies,mmmm,ssssssss,rrrrrrrrrr<END>
The Agilent 8163A, Agilent 8164A, and Agilent8166A will always return Agilent Technologies 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.
NOTE
command:
*OPC
syntax:
*OPC
description:
The instrument parses and executes all program message units in the input queue and
sets the operation complete bit in the standard event status register (SESR). This com-
mand can be used to avoid filling the input queue before the previous commands have fin-
ished executing.
Some module firmware includes commands that set a "StatNOPC" flag during execution
to indicate that the module is busy. *OPC blocks the GPIB bus to all commands until every
module hosted by the instrument is no longer busy.
The following actions cancel the *OPC command (and put the instrument into Operation
Complete, Command Idle State):
•
•
•
•
Power-on
the Device Clear Active State is asserted on the interface.
*CLS
*RS
T
parameters:
response:
example:
none
none
*OPC
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
59
Download from Www.Somanuals.com. All Manuals Search And Download.
Instrument Setup and Status
IEEE-Common Commands
command:
*OPC?
syntax:
*OPC?
description:
The OPeration Complete query *OPC? parses all program message units in the input queue,
sets the operation complete bit in the Standard Event Status register, and places an ASCII
’1’ in the output queue, when the contents of the input queue have been processed.
Some module firmware includes commands that set a "StatNOPC" flag during execution to
indicate that the module is busy. If a module is executing a command which generates a
"StatNOPC" flag, the GPIB bus is not blocked to a command to another module. A second
command to a busy module is blocked until the module flag "StatOK" is set. Taking advan-
tage of this feature, and using *OPC? in a loop to query until the instrument returns 1, can
lead to useful gains in program execution efficiency.
The following actions cancel the *OPC? query (and put the instrument into Operation Com-
plete, Command Idle State):
•
•
•
•
Power-on
the Device Clear Active State is asserted on the interface.
*CLS
*RS
T
parameters:
response:
none
1<END> is returned if all modules are ready to execute a new operation.
0<END> is returned if any module is busy.
example:
*OPC? → 1<END>
command:
*OPT?
syntax:
*OPT?
description:
parameters:
response:
The OPTions query *OPT? returns the modules installed in your instrument.
none
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 Agilent 8164A/B
and Slot 1 for the Agilent 8163A/B and Agilent 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.
example:
*OPT? → 81682A , , 81533B, 81532A, <END>
60
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
IEEE-Common Commands
Instrument Setup and Status
command:
*RST
syntax:
*RST
description:
The ReSeT command *RST sets the mainframe and all modules to the reset setting (stan-
dard setting) stored internally.
Pending *OPC? actions are cancelled.
The instrument is placed in the idle state awaiting a command. The *RST command clears
the error queue.
The *RST command is equivalent to the *CLS command AND the syst:preset command.
The following are not changed:
• GPIB (interface) state
• Instrument interface address
• Output queue
• Service request enable register (SRE)
• Standard Event Status Enable Mask (SESEM)
parameters:
response:
example:
none
none
*RST
command:
*STB?
syntax:
*STB?
description:
parameters:
response:
The STatus Byte query *STB? returns the contents of the Status Byte register.
none
The bit value for the register (a 16-bit signed integer value):
Bit
Mnemonic
Decimal Value
7 (MSB)
Operation Status (OSB)
Not used
128
0
6
5
4
3
2
1
0
Event Status Bit (ESB)
Message Available (MAV)
Questionable Status (QSB)
Not used
32
16
8
0
Not used
0
Not used
0
example:
*STB? → 128<END>
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
61
Download from Www.Somanuals.com. All Manuals Search And Download.
Instrument Setup and Status
IEEE-Common Commands
command:
*TST?
syntax:
*TST?
description:
The self-TeST query *TST? makes the instrument perform a self-test and place the results of
the test in the output queue. If the self-test fails, the results are also put in the error queue.
We recommend that you read self-test results from the error queue. No further commands
are allowed while the test is running. After the self-test the instrument is returned to the set-
ting that was active at the time the self-test query was processed. The self-test does not re-
quire operator interaction beyond sending the *TST? query.
parameters:
response:
none
The sum of the results for the individual tests (a 32-bit signed integer value, where 0 ≤ value
≤ 4294967296):
Bits
31
18 - 30
17
16
15
14
13
12
11
10
9
Mnemonic
Decimal Value
Selftest failed on Mainframe
Not used
A negative value
0
Selftest failed on Slot 17
Selftest failed on Slot 16
Selftest failed on Slot 15
Selftest failed on Slot 14
Selftest failed on Slot 13
Selftest failed on Slot 12
Selftest failed on Slot 11
Selftest failed on Slot 10
Selftest failed on Slot 9
Selftest failed on Slot 8
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
Selftest failed on Slot 0
131072
65536
32768
16384
8192
4096
2048
1024
512
256
128
64
8
7
6
5
32
4
16
3
8
2
4
1
2
0
1
If 16 is returned, the module in slot 4 has failed.
If 18 is returned, the modules in slots 1 and 4 have failed.
A value of zero indicates no errors.
example:
*TST? → 0<END>
62
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
IEEE-Common Commands
Instrument Setup and Status
command:
*WAI
syntax:
*WAI
description:
The WAIt command prevents the instrument from executing any further commands until the
current command has finished executing. Some module firmware includes commands that
set a "StatNOPC" flag during execution to indicate that the module is busy. *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:
response:
example:
none
none
*WAI
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
63
Download from Www.Somanuals.com. All Manuals Search And Download.
Instrument Setup and Status
Status Reporting – The STATus Subsystem
Status Reporting – The STATus
Subsystem
The Status subsystem allows you to return and set details from the Status
command:
:STATus:OPERation[:EVENt][:LEVel0]?
syntax:
:STATus:OPERation[:EVENt][:LEVel0]?
description:
parameters:
response:
Returns the Operational Status Event Summary Register (OSESR).
none
The sum of the results for the slots (a 16-bit signed integer value, where 0 ≤ value ≤ 32767):
Bits Mnemonics
Agilent 8163A/B
Not used
Decimal Value
Agilent 8164A/B
Not used
Not used
Not used
Not used
Not used
Not used
Not used
Not used
Not used
Not used
Not used
Agilent 8166A/B
Not used
15
14
13
12
11
10
9
0
Not used
Not used
Not used
Not used
Not used
Not used
Not used
Not used
Not used
Not used
Slot 14 Summary
Slot 13 Summary
Slot 12 Summary
Slot 11 Summary
Slot 10 Summary
Slot 9 Summary
Slot 8 Summary
Slot 7 Summary
Slot 6 Summary
Slot 5 Summary
16384
8192
4096
2048
1024
512
256
128
64
8
7
6
5
32
4
usNedot
S
4 luomt maryS 4 luomt mary 16
3
Not used
Slot 3 Summary
Slot 2 Summary
Slot 1 Summary
Slot 0 Summary
Slot 3 Summary
8
4
2
1
2
Slot 2 Summary
Slot 1 Summary
Not used
Slot 2 Summary
Slot 1 Summary
Level 1 Summary
1
0
example:
stat:oper? → +0<END>
64
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
Status Reporting – The STATus Subsystem
Instrument Setup and Status
command:
:STATus:OPERation:CONDition[:LEVel0]?
syntax:
:STATus:OPERation:CONDition[:LEVel0]?
Reads the Operational Status Condition Summary Register.
none
description:
parameters:
response:
The sum of the results for the individual slots (a 16-bit signed integer value, where 0 ≤ value ≤
32767):
Bits
Mnemonics
Agilent 8163A/B
Not used
Not used
Not used
Not used
Not used
Not used
Not used
Not used
Not used
Not used
Not used
Decimal Value
Agilent 8164A/B
Not used
Agilent 8166A/B
Not used
15
14
13
12
11
10
9
0
Not used
Slot 14 Summary
Slot 13 Summary
Slot 12 Summary
Slot 11 Summary
Slot 10 Summary
Slot 9 Summary
Slot 8 Summary
Slot 7 Summary
Slot 6 Summary
Slot 5 Summary
16384
8192
4096
2048
1024
512
256
128
64
Not used
Not used
Not used
Not used
Not used
8
Not used
7
Not used
6
Not used
5
Not used
32
4
usedNot
Not used
S S
4
umlomStaSry 4 umlomt a1ry6
Slot 3 Summary
Slot 2 Summary
Slot 1 Summary
Slot 0 Summary
3
Slot 3 Summary
Slot 2 Summary
Slot 1 Summary
Level 1 Summary
8
4
2
1
2
Slot 2 Summary
Slot 1 Summary
Not used
1
0
example:
stat:oper:cond? → +0<END>
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
65
Download from Www.Somanuals.com. All Manuals Search And Download.
Instrument Setup and Status
Status Reporting – The STATus Subsystem
command:
:STATus:OPERation:ENABle[:LEVel0]
syntax:
:STATus:OPERation:ENABle[:LEVel0]<wsp><value>
description:
Sets the bits in the Operational Status Enable Summary Mask (OSESM) that enable the con-
tents of the OSESR to affect the Status Byte (STB).
Setting a bit in this register to 1 enables the corresponding bit in the OSESR to affect bit 7 of
the Status Byte.
parameters:
The bit value for the OSESM as a 16-bit signed integer value (0 .. +32767)
The default value is 0.
none
response:
example:
stat:oper:enab 128
command:
:STATus:OPERation:ENABle[:LEVel0]?
:STATus:OPERation:ENABle[:LEVel0]?
Returns the OSESM for the OSESR
syntax:
description:
parameters:
response:
example:
none
The bit value for the operation enable mask as a 16-bit signed integer value (0 .. +32767)
stat:oper:enab? → +128<END>
command:
:STATus:OPERation[:EVENt]:LEVel1?
:STATus:OPERation[:EVENt]:LEVel1?
syntax:
description:
Returns the Operational Status Event Summary Register (OSESR) for slots 15 to 17 of the
Agilent 8166A/B Lightwave Multichannel System.
parameters:
response:
none
The sum of the results for the slots (a 16-bit signed integer value, where 0 ≤ value ≤ 32767):
Bits Mnemonics
Agilent 8166A/B
15-4 Not used
Decimal Value
0
8
4
2
0
3
2
1
0
SS 17 loutmmary
SS 16 loutmmary
SS 15 loutmmary
Not used
example:
stat:oper:level1? → +0<END>
66
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
Status Reporting – The STATus Subsystem
Instrument Setup and Status
command:
:STATus:OPERation:CONDition:LEVel1?
:STATus:OPERation:CONDition:LEVel1?
syntax:
description:
Returns the Operational Status Condition Summary Register for slots 15 to 17 of the
Agilent 8166B Lightwave Multichannel System.
parameters:
response:
none
The sum of the results for slots 15 to 17 (a 16-bit signed integer value, where 0 ≤ value ≤
32767):
Bits Mnemonics
Agilent 8166A/B
15-4 Not used
Decimal Value
0
8
4
2
0
3
2
1
0
SS 17 loutmmary
SS 16 loutmmary
SS 15 loutmmary
Not used
example:
stat:oper:cond:level1? → +0<END>
command:
:STATus:OPERation:ENABle:LEVel1
syntax:
:STATus:OPERation:ENABle:LEVel1<wsp><value>
description:
Sets the bits in the Operational Status Enable Summary Mask (OSESM) that enable the con-
tents of the OSESR for slots 15 - 17 of the Agilent 8166A/B 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 Agilent 8166A/B Lightwave Measurement System to affect bit 7 of the Status Byte.
parameters:
The bit value for the OSESM as a 16-bit signed integer value (0 .. +32767)
The default value is 0.
none
response:
example:
stat:oper:enab:level1 128
command:
:STATus:OPERation:ENABle:LEVel1?
:STATus:OPERation:ENABle:LEVel1?
syntax:
description:
Returns the OSESM for the OSESR for slots 15 - 17 of the Agilent 8166A/B Lightwave Mea-
surement System
parameters:
response:
example:
none
The bit value for the operation enable mask as a 16-bit signed integer value (0 .. +32767)
stat:oper:enab:level1? → +128<END>
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
67
Download from Www.Somanuals.com. All Manuals Search And Download.
Instrument Setup and Status
Status Reporting – The STATus Subsystem
command:
:STATusn:OPERation[:EVENt]?
:STATusn:OPERation[:EVENt]?
syntax:
description:
parameters:
response:
Returns the Operational Slot Status Event Register (OSSER) of slot n.
none
The results for the individual slot events (a 16-bit signed integer value, where 0 ≤ value ≤
32767):
Bit
Mnemonic
Decimal Value
8-15
Not used
0
7
6
5
4
3
2
1
0
Slot n: offset (λ) type bit 2
Slot n: offset (λ) type bit 1
Slot n: offset (λ) has been enabled
Slot n: shutter has been opened
Slot n: Zeroing ongoing
128
64
32
16
8
0
2
1
Not used
Slot n: Coherence Control has been switched on
Slot n: Laser has been switched on
example:
stat1:oper? → +0<END>
command:
:STATusn:OPERation:CONDition?
:STATusn:OPERation:CONDition?
Returns the Operational Slot Status Condition Register of slot n.
none
syntax:
description:
parameters:
response:
The results for the individual slot events (a 16-bit signed integer value, where 0 ≤ value ≤
32767):
Bit
Mnemonic
Decimal Value
8-15
Not used
0
7
6
5
4
3
2
1
0
Slot n: offset (λ) type bit 2
Slot n: offset (λ) type bit 1
Slot n: offset (λ) enabled
Slot n: shutter open
Slot n: Zeroing ongoing
Not used
128
64
32
16
8
0
2
1
Slot n: Coherence Control is switched on
Slot n: Laser is switched on
example:
stat1:oper:cond? → +0<END>
NOTE:
Only attenuator bits 5 to 7 are used to show whether the offset feature is
used and which algorithm is used to calculate the wavelength dependent
offset.
Bit 5 states if the feature is enabled or disabled. Bits 6 and 7 are decoded as
shown below to say whether the attenuator uses saved, interpolated, or
extrapolated values.
68
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
Status Reporting – The STATus Subsystem
Instrument Setup and Status
Type
Bit 5
Bit 6
Bit 7
Decimal Value
none
0
1
1
1
1
0
0
1
0
1
0
0
0
1
1
0
exact value
32
extrapolate below
extrapolate above
interpolated
96
160
224
command:
:STATusn:OPERation:ENABle
syntax:
:STATusn:OPERation:ENABle<wsp><value>
description:
Sets the bits in the Operation Slot Status Enable Mask (OSSEM) for slotn that enable the
contents of the Operation Slot Status Event Register (OSSER) for slot n to affect the OSESR.
Setting a bit in this register to 1 enables the corresponding bit in the OSSER for slotn to af-
fect bit n of the OSESR.
parameters:
response:
example:
The bit value for the OSSEM as a 16-bit signed integer value (0 .. +32767)
none
stat:oper:enab 128
command:
:STATusn:OPERation:ENABle?
:STATusn:OPERation:ENABle?
syntax:
description:
parameters:
response:
example:
Returns the OSSEM of slot n
none
The bit value for the OSSEM as a 16-bit signed integer value (0 .. +32767)
stat:oper:enab? → +128<END>
command:
:STATus:PRESet
syntax:
:STATus:PRESet
description:
Presets all bits in all the enable masks for both the OPERation and QUEStionable status sys-
tems to 0, that is, OSSEM, QSSEM, OSESM, and QSESM.
parameters:
response:
example:
none
none
stat:pres
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
69
Download from Www.Somanuals.com. All Manuals Search And Download.
Instrument Setup and Status
Status Reporting – The STATus Subsystem
command:
:STATus:QUEStionable[:EVENt][:LEVel0]?
:STATus:QUEStionable[:EVENt][:LEVel0]?
syntax:
description:
parameters:
response:
Returns the Questionable Status Event Summary Register (QSESR).
none
The sum of the results for the QSESR as a 16-bit signed integer value (0 .. +32767)
Bits Mnemonics
Agilent 8163A/B
Not used
Decimal Value
Agilent 8164A/B
Not used
Agilent 8166A/B
15
14
13
12
11
10
9
Not used
0
Not used
Not used
Not used
Not used
Not used
Not used
Not used
Not used
Not used
Not used
Not used
Not used
Slot 2 Summary
Slot 1 Summary
uNseodt
Not used
Slot 14 Summary 16384
Slot 13 Summary 8192
Slot 12 Summary 4096
Slot 11 Summary 2048
Slot 10 Summary 1024
Slot 9 Summary 512
Slot 8 Summary 256
Slot 7 Summary 128
Slot 6 Summary 64
Slot 5 Summary 32
Slot 4 Summary 16
Not used
Not used
Not used
Not used
Not used
8
Not used
7
Not used
6
Not used
5
Not used
4
Slot 4 Summary
Slot 3 Summary
Slot 2 Summary
Slot 1 Summary
3
Slot 3 Summary
Slot 2 Summary
Slot 1 Summary
8
4
2
2
1
0
SS 0 loutmmary
S L1eveulmm1ary
example:
stat:ques? → +0<END>
70
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
Status Reporting – The STATus Subsystem
Instrument Setup and Status
command:
:STATus:QUEStionable:CONDition[:LEVel0]?
syntax:
:STATus:QUEStionable:CONDition[:LEVel0]?
Returns the Questionable Status Condition Summary Register.
none
description:
parameters:
response:
The sum of the results for the Questionable Status Condition Summary Register as a16-bit
signed integer value (0 .. +32767)
Bits Mnemonics
Agilent 8163A/B
Not used
Decimal Value
Agilent 8164A/B
Not used
Agilent 8166A/B
15
14
13
12
11
10
9
Not used
0
Not used
Not used
Not used
Not used
Not used
Not used
Not used
Not used
Not used
Not used
Not used
Not used
Slot 2 Summary
Slot 1 Summary
Not used
Not used
Slot 14 Summary 16384
Slot 13 Summary 8192
Slot 12 Summary 4096
Slot 11 Summary 2048
Slot 10 Summary 1024
Not used
Not used
Not used
Not used
Not used
Slot 9 Summary
Slot 8 Summary
Slot 7 Summary
Slot 6 Summary
Slot 5 Summary
Slot 4 Summary
Slot 3 Summary
Slot 2 Summary
Slot 1 Summary
Level 1 Summary
512
256
128
64
32
16
8
8
Not used
7
Not used
6
Not used
5
Not used
4
Slot 4 Summary
Slot 3 Summary
Slot 2 Summary
Slot 1 Summary
Slot 0 Summary
3
2
4
1
2
0
1
example:
stat:ques:cond? → +0<END>
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
71
Download from Www.Somanuals.com. All Manuals Search And Download.
Instrument Setup and Status
Status Reporting – The STATus Subsystem
command:
:STATus:QUEStionable:ENABle[:LEVel0]
syntax:
:STATus:QUEStionable:ENABle[:LEVel0]<wsp><value>
description:
Sets the bits in the Questionable Status Enable Summary Mask (QSESM) that enable the
contents of the QSESR to affect the Status Byte (STB).
Setting a bit in this register to 1 enables the corresponding bit in the QSESR to affect bit 3 of
the Status Byte.
parameters:
The bit value for the questionable enable mask as a 16-bit signed integer value (0 .. +32767)
The default value is 0.
none
response:
example:
stat:ques:enab 128
command:
:STATus:QUEStionable:ENABle[:LEVel0]?
:STATus:QUEStionable:ENABle[:LEVel0]?
Returns the QSESM for the event register
none
syntax:
description:
parameters:
response:
example:
The bit value for the QSEM as a 16-bit signed integer value (0 .. +32767)
stat:ques:enab? → +128<END>
command:
:STATus:QUEStionable[:EVENt]:LEVel1?
:STATus:QUEStionable[:EVENt]:LEVel1?
syntax:
description:
Returns the Questionable Status Event Summary Register (QSESR) for slots 15 to 17 of the
Agilent 8166A/B Lightwave Multichannel System.
parameters:
response:
none
The sum of the results for the slots (a 16-bit signed integer value, where 0 ≤ value ≤ 32767):
Bits Mnemonics
Agilent 8166A/B
15-4 Not used
Decimal Value
0
8
4
2
0
3
2
1
0
SS 17 loutmmary
SS 16 loutmmary
SS 15 loutmmary
Not used
example:
stat:ques:level1? → +0<END>
72
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
Status Reporting – The STATus Subsystem
Instrument Setup and Status
command:
:STATus:QUEStionable:CONDition:LEVel1?
:STATus:QUEStionable:CONDition:LEVel1?
syntax:
description:
Returns the Questionable Status Condition Summary Register for slots 15 to 17 of the
Agilent 8166A/B Lightwave Multichannel System.
parameters:
response:
none
The sum of the results for the slots (a 16-bit signed integer value, where 0 ≤ value ≤ 32767):
Bits Mnemonics
Agilent 8166A/B
15-4 Not used
Decimal Value
0
8
4
2
0
3
2
1
0
Slot 17 Summary
Slot 16 Summary
Slot 15 Summary
Not used
example:
stat:ques:cond:level1? → +0<END>
command:
:STATus:QUEStionable:ENABle:LEVel1
syntax:
:STATus:QUEStionable:ENABle:LEVel1<wsp><value>
description:
Sets the bits in the Questionable Status Enable Summary Mask (QSESM) that enable the
contents of the QSESR for slots 15 - 17 of the Agilent 8166A/B 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 Agilent 8166A/B Lightwave Measurement System to affect bit 7 of the Status Byte.
parameters:
The bit value for the QSESM as a 16-bit signed integer value (0 .. +32767)
The default value is 0.
none
response:
example:
stat:oper:enab:level1 128
command:
:STATus:QUEStionable:ENABle:LEVel1?
:STATus:QUEStionable:ENABle:LEVel1?
syntax:
description:
Returns the QSESM for the QSESR for slots 15 - 17 of the Agilent 8166A/B Lightwave Mea-
surement System
parameters:
response:
example:
none
The bit value for the QSESM as a 16-bit signed integer value (0 .. +32767)
stat:oper:enab:level1? → +128<END>
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
73
Download from Www.Somanuals.com. All Manuals Search And Download.
Instrument Setup and Status
Status Reporting – The STATus Subsystem
command:
:STATusn:QUEStionable[:EVENt]?
:STATusn:QUEStionable[:EVENt]?
syntax:
description:
Returns the questionable status of slot n - the Questionable Slot Status Event Register (QSS-
ER).
parameters:
response:
none
The results for the individual slot events (a 16-bit signed integer value, where 0 ≤ value ≤
32767):
Bit
Mnemonic
Decimal Value
11-15
Not Used
0
10
9
8
7
6
5
4
3
2
1
0
Slot n: Lambda zeroing has been recommended
Slot n: Beam Path Protection on (shutter off)
Slot n: Coherence control is uncalibrated
Slot n: Duty cycle has been out of range
Slot n: ARA has been recommended
Slot n: Module has been out of specification
Slot n: Module has settled unsuccessfully
Slot n: Laser protection has been on
Slot n: Temperature has been out of range
Slot n: A Zeroing operation has failed
Slot n: Excessive Value has occurred
1024
512
256
128
64
32
16
8
4
2
1
Every nth bit is the summary of slot n.
stat1:oper? → +0<END>
example:
command:
:STATusn:QUEStionable:CONDition?
:STATusn:QUEStionable:CONDition?
Returns the Questionable Slot Status Condition Register for slot n.
none
syntax:
description:
parameters:
response:
The results for the individual slot events (a 16-bit signed integer value, where 0 ≤ value ≤
32767):
Bit
Mnemonic
Decimal Value
11 - 15 Not Used
10
9
8
7
6
5
4
3
2
1
0
Slot n: Lambda zeroing is recommended
1024
512
256
128
64
32
16
8
Slot n: Beam Path Protection on (shutter off)
Slot n: Coherence control is uncalibrated
Slot n: Duty cycle is out of range
Slot n: ARA recommended
Slot n: Module is out of specification
Slot n: Module has not settled
Slot n: Laser protection on
Slot n: Temperature out of range
Slot n: Zeroing failed
Slot n: Excessive Value
4
2
1
Every nth bit is the summary of slot n.
stat1:ques:cond? → +0<END>
example:
74
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
Status Reporting – The STATus Subsystem
Instrument Setup and Status
command:
:STATusn:QUEStionable:ENABle
:STATusn:QUEStionable:ENABle<wsp><value>
syntax:
description:
Sets the bits in the Questionable Slot Status Enable Mask (QSSEM) for slot n that enable the
contents of the Questionable Slot Status Register (QSSR) for slot n to affect the QSESR.
Setting a bit in this register to 1 enables the corresponding bit in the QSSER for slotn to af-
fect bit n of the QSESR.
parameters:
response:
example:
The bit value for the QSSEM as a 16-bit signed integer value (0 .. +32767)
none
stat:ques:enab 128
command:
:STATusn:QUEStionable:ENABle?
:STATusn:QUEStionable:ENABle?
Returns the QSSEM for slot n
syntax:
description:
parameters:
response:
example:
none
The bit value for the QSSEM as a 16-bit signed integer value (0 .. +32767)
stat:ques:enab? → +128<END>
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
75
Download from Www.Somanuals.com. All Manuals Search And Download.
Instrument Setup and Status
Interface/Instrument Behaviour Settings – The SYSTem Subsystem
Interface/Instrument Behaviour
Settings – The SYSTem
Subsystem
The SYSTem subsystem lets you control the instrument’s serial interface.
You can also control some internal data (like date, time, and so on).
command:
:SYSTem:DATE
syntax:
:SYSTem:DATE<wsp><year>,<month>,<day>
Sets the instrument’s internal date.
description:
parameters:
• the first value is the year (four digits),
• the second value is the month, and
• the third value is the day.
none
response:
example:
syst:date 1999, 1, 12
command:
:SYSTem:DATE?
syntax:
:SYSTem:DATE?
description:
parameters:
response:
example:
Returns the instrument’s internal date.
none
The date in the format year, month, day (16-bit signed integer values)
syst:date? → +1999,+1,+12<END>
command:
:SYSTem:ERRor?
syntax:
:SYSTem:ERRor?
description:
Each error has the error code and a short description of the error, separated by a comma, for
example 0, "No error".
Error codes are numbers in the range -32768 and +32767.
Negative error numbers are defined by the SCPI standard. Positive error numbers are device
dependent.
parameters:
response:
example:
none
The number of the latest error, and its meaning.
syst:err? → -113,"Undefined header"<END>
76
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
Interface/Instrument Behaviour Settings – The SYSTem Subsystem
Instrument Setup and Status
command:
:SYSTem:HELP:HEADers?
syntax:
:SYSTem:HELP:HEADers?
description:
parameters:
response:
example:
Returns a list of GPIB commands.
none
Returns a list of GPIB commands
syst:help:head? → Returns a list of all GPIB commands
command:
:SYSTem:PRESet
syntax:
:SYSTem:PRESet
description:
Sets the mainframe and all installed modules to their standard settings. This command has
the same function as the Preset hardkey.
The following are not affected by this command:
• the GPIB (interface) state,
• the backlight and contrast of the display,
• the interface address,
• the output and error queues,
• the Service Request Enable register (SRE),
• the Status Byte (STB),
• the Standard Event Status Enable Mask (SESEM), and
• the Standard Event Status Register (SESR).
parameters:
response:
example:
none
none
SYST:PRES
command:
:SYSTem:TIME
syntax:
:SYSTem:TIME<wsp><hour>,<minute>,<second>
Sets the instrument’s internal time.
description:
parameters:
•
the first value is the hour (0 .. 23),
• the second value is the minute, and
• the third value is the seconds.
none
response:
example:
syst:time 20,15,30
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
77
Download from Www.Somanuals.com. All Manuals Search And Download.
Instrument Setup and Status
Interface/Instrument Behaviour Settings – The SYSTem Subsystem
command:
:SYSTem:TIME?
syntax:
:SYSTem:TIME?
description:
parameters:
response:
Returns the instrument’s internal time.
none
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:
parameters:
response:
example:
Returns the SCPI revision to which the instrument complies.
none
The revision year and number.
syst:vers? → 1995.0<END>
command:
:SYSTem:COMMunicate:GPIB[:SELF]:ADDRess
:SYSTem:COMMunicate:GPIB[:SELF]:ADDRess<wsp><GPIB Address>
Sets the GPIB address.
syntax:
description:
parameters:
Values allowed 0-30
The GPIB Address
21 is often reseverved by the GPIB Controller.
response:
example:
none
SYST:COMM:GPIB:ADDR 20
command:
:SYSTem:COMMunicate:GPIB[:SELF]:ADDRess?
:SYSTem:COMMunicate:GPIB[:SELF]:ADDRess?
Returns the GPIB address.
syntax:
description:
parameters:
response:
example:
none
The GPIB Address
SYST:COMM:GPIB:ADDR? → +20<END>
78
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
4
Measurement Operations & Settings
Compatibility of the 81560A/1A/6A/7A modular attenuator family to
the 8156A attenuator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .165
This chapter gives descriptions of commands that you can use when you
are setting up or performing measurements. The commands are split up
into the following subsystems:
• Root layer commands that take power measurements, configures
triggering, and return information about the mainframe and it’s slots
• SENSe subsystem commands that control Power Sensors, Optical Head
Interface Modules, and Return Loss Modules.
• SOURce subsystem commands that control Laser Source modules, DFB
source modules, Tunable Laser modules, and Return Loss Modules with
internal laser sources.
• Signal Conditioing commands that control Attenuator modules.
• TRIGger subsystem commands that control triggering.
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
79
Download from Www.Somanuals.com. All Manuals Search And Download.
Measurement Operations & Settings
Root Layer Command
Root Layer Command
command:
:LOCK
:LOCK<wsp><boolean>, <value>
Switches the lock off and on.
syntax:
description:
High power lasers cannot be switched on, if you switch the lock on. High power lasers are
switched off immediately when you switch the lock on.
parameters:
A boolean value:
0 or OFF: switch lock off
1 or ON: switch lock on
<value> is the four-figure lock password.
none
response:
example:
lock 1,1234 - 1234 is the default password
command:
:LOCK?
syntax:
:LOCK?
description:
parameters:
response:
Queries the current state of the lock.
none
A boolean value:
0: lock is switched off
1: lock is switched on
example:
lock? → 1<END>
The commands in the Slot subsystem allow you to query the following:
• a particular slot, for example, using slot1:empt?,
• or, an Optical Head attached to an Optical Head Interface Module, for
example, an Optical Head Interface Module in slot1 with an Optical
Head attached to channel 2, using slot1:head2:empt?.
80
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
Root Layer Command
Measurement Operations & Settings
command:
:SLOT[n]:EMPTy?
syntax:
:SLOT[n]:EMPTy?
description:
parameters:
response:
Queries whether the module slot is empty.
none
A boolean value:
0: there is a module in the slot
1: the module slot is empty
examples:
affects:
slot1:empt? → 0<END>
There is a module in slot1
Independent of module type
command:
:SLOT[n]:IDN?
syntax:
:SLOT[n]:IDN?
description:
parameters:
response:
Returns information about the module.
none
HEWLETT-PACKARD:
mmmm:
manufacturer
instrument model number (for example 81533B)
serial number
ssssssss:
rrrrrrrrrr:
date of firmware revision
example:
slot1:idn? →
HEWLETT-PACKARD, 81533B,3411G06054,07-Aug-98<END>
• The Agilent 81640A/80A/82A/89A Tunable Laser modules will always return
Agilent Technologies as the manufacturer.
NOTE
• All other Agilent 8163A Series modules return Agilent Technologies as the
manufacturer.
• The HP 8153A Series modules will always return Agilent Technologies as the
manufacturer.
affects:
Independent of module type
command:
:SLOT[n]:OPTions?
syntax:
:SLOT[n]:OPTions?
description:
parameters:
response:
example:
affects:
Returns information about a module’s options.
none
A string.
slot1:opt? → NO CONNECTOR OPTION, NO INSTRUMENT OPTIONS<END>
Independent of module type
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
81
Download from Www.Somanuals.com. All Manuals Search And Download.
Measurement Operations & Settings
Root Layer Command
command:
:SLOT[n]:TST?
syntax:
:SLOT[n]:TST?
description:
Returns the latest selftest results for a module.
This command does not perform a selftest. Use selfTeST command, *TST? on
page 59, to perform a selftest.
NOTE
parameters:
response:
example:
affects:
none
Returns an error code and a short description of the error.
slot:tst? → +0,"self test OK"<END>
Independent of module type
command:
:SLOT[n]:HEAD[n]:EMPTy?
:SLOT[n]:HEAD[n]:EMPTy?
Queries whether an optical head is connected.
none
syntax:
description:
parameters:
response:
A boolean value:
0: there is a module in the slot
1: the module slot is empty
examples:
slot1:head:empt? → 0<END>
An optical head is connected to the optical
head interface module in slot 1
• The HP 8153A Series Optical Heads will always return Agilent Technologies as
the manufacturer.
NOTE
• All other Agilent 8163A Series Optical Heads return Agilent Technologies as the
manufacturer.
affects:
Optical heads
command:
:SLOT[n]:HEAD[n]:IDN?
:SLOT[n]:HEAD[n]:IDN?
Returns information about the optical head.
none
syntax:
description:
parameters:
response:
HEWLETT-PACKARD:
mmmm:
manufacturer
instrument model number (for example 81520A)
serial number
ssssssss:
rrrrrrrrrr:
date of firmware revision
example:
affects:
slot1:head:idn? →
HEWLETT-PACKARD, 81520A,3411G06054,07-Aug-98<END>
Optical heads
82
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
Root Layer Command
Measurement Operations & Settings
command:
:SLOT[n]:HEAD[m]:OPTions?
syntax:
:SLOT[n]:HEAD[m]:OPTions?
description:
parameters:
response:
example:
Returns information about an optical head’s options.
none
A string.
slot1:head:opt? → NO CONNECTOR OPTION, NO INSTRUMENT
OPTIONS<END>
affects:
Optical heads
command:
:SLOT[n]:HEAD[m]:TST?
syntax:
:SLOT[n]:HEAD[m]:TST?
description:
Returns the latest selftest results for an optical head.
page 62, to perform a selftest.
NOTE
parameters:
response:
example:
affects:
none
Returns an error code and a short description of the error.
slot:head:tst? → +0,"self test OK"<END>
Optical heads
command:
:SLOT[n]:HEAD[m]:WAVelength:RESPonse?
syntax:
:SLOT[n]:HEAD[m]:WAVelength:RESPonse?
description:
response:
Returns the wavelength response from a wavelength calibrated module in binary format.
Wavelength Response table as a binary block.
response
format:
One 8 byte long wavelength calibration value pair consisting of a 4 byte long float for wave-
length and a 4 byte long float for the scalar calibration factor.
slot1:head1:wav:resp? → #536570........
example:
affects:
Attenuator with power control, all powermeters, return loss modules
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
83
Download from Www.Somanuals.com. All Manuals Search And Download.
Measurement Operations & Settings
Root Layer Command
command:
:SLOT[n]:HEAD[m]:WAVelength:RESPonse:CSV?
:SLOT[n]:HEAD[m]:WAVelength:RESPonse:CSV?
syntax:
description:
response:
Returns the wavelength response from the attenuator module in CSV format.
Wavelength Response table as a string
response
format:
The string is a comma separated value (CSV) list and can be written to a file and be pro-
cessed with a spreadsheet program.
List format:
λ1, c1\n
λ2, c2\n
.......
λn, cn\n
"," separates wavelength and response factor
"\n" = ASCII code 10 separate value pairs
example:
affects:
slot1:head1:wav:resp:csv? → 1200e-6,2.019\n 1210e-6,
1.956\n...
Attenuator with power control, all powermeters, return loss modules
command:
:SLOT[n]:HEAD[m]:WAVelength:RESPonse:SIZE?
syntax:
:SLOT[n]:HEAD[m]:WAVelength:RESPonse:SIZE?
description:
response
example:
affects:
Returns the number of elements in the wavelength response table.
Number of elements in the wavelength table as an integer value
slot2:head1:wav:resp:size? → 50<END>
Attenuator with power control, all powermeters, return loss modules
command:
:SPECial:REBoot
syntax:
:SPECial:REBoot
description:
parameters:
response:
example:
Reboots the mainframe and all modules.
none
none
spec:reb
84
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
Measurement Functions – The SENSe Subsystem
Measurement Operations & Settings
Measurement Functions – The
SENSe Subsystem
The SENSe subsystem lets you control measurement parameters for a
Power Sensor, an Optical Head Interface module, or a return loss module.
Agilent 81635A and Agilent 81619A - Master
and Slave Channels
For the Agilent 81635A Dual Power Sensor and Agilent 81619A Dual
Optical Head Interface module, channel 1 is the master channel and
channel 2 is the slave channel. The master and slave channels share the
same software and hardware triggering system. For some commands,
setting parameters for the master channel sets the parameters for the
slave channel. In these cases, you may only set parameters for the slave
channel by setting master channel parameters.
channel.
Table 5 Commands that can only be configured using the master channel
Command
Page
:INITiate[n]:[CHANnel[m]][:IMMediate]
:INITiate[n]:[CHANnel[m]]:CONTinuous/?
:READ[n][:CHANnel[m]][:SCALar]:POWer[:DC]?
:SENSe[n]:[CHANnel[m]]:CORRection:COLLect:ZERO
:SENSe[n][:CHANnel[m]]:FUNCtion:PARameter:LOGGing/?
:SENSe[n][:CHANnel[m]]:FUNCtion:PARameter:MINMax/?
:SENSe[n][:CHANnel[m]]:FUNCtion:PARameter:STABility/?
:SENSe[n][:CHANnel[m]]:FUNCtion:STATe/?
:SENSe[n]:[CHANnel[m]]:POWer:ATIME/?
:SENSe[n]:[CHANnel[m]]:POWer:RANGe:AUTO/?
:TRIGger[n][:CHANnel[m]]:INPut/?
:TRIGger[n][:CHANnel[m]]:INPut:REARm/?
:TRIGger[n][:CHANnel[m]]:OUTPut/?
:TRIGger[n][:CHANnel[m]]:OUTPut:REARm/?
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
85
Download from Www.Somanuals.com. All Manuals Search And Download.
Measurement Operations & Settings
Measurement Functions – The SENSe Subsystem
channels.
Table 6 Commands that are independent for both master and slave channels
Command
Page
:FETCh[n][:CHANnel[m]][:SCAlar]:POWer[:DC]?
:ROUTe[n][:CHANnel[m]]/?
:ROUTe[n][:CHANnel[m]]:CONFig?
:ROUTe[n][:CHANnel[m]]:CONFig:ROUTe?
:SENSe[n]:[CHANnel[m]]:CORRection[:LOSS][:INPut] [:MAGNi-
tude]/?
: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/?
86
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
Measurement Functions – The SENSe Subsystem
Measurement Operations & Settings
command:
:FETCh[n][:CHANnel[m]][:SCAlar]:POWer[:DC]?
:FETCh[n]:[CHANnel[m]][:SCAlar]:POWer[:DC]?
syntax:
description:
Reads the current power meter value, or for a return loss module returns current power val-
ue at return loss diode (back reflection path). It does not provide its own triggering and so
must be used with either continuous software triggering (see
It returns the value the previous software trigger measured. Any subsequent FETCh com-
mand will return the same value, if there is no subsequent software trigger.
parameters:
response:
none
The current value 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.
NOTE
example:
fetc1:pow? → +6.73370400E-04<END>
affects:
All power meters, return loss modules, and attenuators with power sensors
Master and slave channels are independent.
dual sensors:
command:
:FETCh[n][:CHANnel[m]][:SCAlar]:RETurnloss?
:FETCh[n]:[CHANnel[m]][:SCAlar]:RETurnloss?
syntax:
description:
Reads the current return loss value. It does not provide its own triggering and so must be
used with either continuous software triggering (see
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:
response:
example:
affects:
none
The current value as a float value in dB.
fetc1:ret? → +6.73370400E-00<END>
All return loss modules
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
87
Download from Www.Somanuals.com. All Manuals Search And Download.
Measurement Operations & Settings
Measurement Functions – The SENSe Subsystem
command:
:FETCh[n][:CHANnel[m]][:SCAlar]:MONitor?
:FETCh[n]:[CHANnel[m]][:SCAlar]:MONitor?
syntax:
description:
Reads current power value at a return loss module’s monitor diode (forward path). It does
not provide its own triggering and so must be used with either continuous software trigger-
It returns the monitor value the previous software trigger measured. Any subsequent FETCh
command will return the same value, if there is no subsequent software trigger.
parameters:
response:
example:
affects:
none
The current value as a float value in W or dBm.
fetc1:mon? → +6.73370400E-00<END>
All return loss modules
command:
:INITiate[n]:[CHANnel[m]][:IMMediate]
:INITiate[n]:[CHANnel[m]][:IMMediate]
syntax:
description:
Initiates the software trigger system and completes one full trigger cycle, that is, one mea-
surement is made.
parameters:
response:
example:
none
none
init
affects:
All power meters, return loss modules.
dual sensors:
Can only be sent to master channel, slave channel is also affected.
command:
:INITiate[n]:[CHANnel[m]]:CONTinuous
syntax:
:INITiate[n]:[CHANnel[m]]:CONTinuous<wsp><boolean>
Sets the software trigger system to continuous measurement mode.
description:
parameters:
A boolean value:
0 or OFF: do not measure continuously
1 or ON: measure continuously
response:
example:
affects:
none
init2:cont 1
All power meters, return loss modules.
dual sensors:
Can only be sent to master channel, slave channel is also affected.
88
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
Measurement Functions – The SENSe Subsystem
Measurement Operations & Settings
command:
:INITiate[n]:[CHANnel[m]]:CONTinuous?
:INITiate[n]:[CHANnel[m]]:CONTinuous?
syntax:
description:
parameters:
response:
Queries whether the software trigger system operates continuously or not
none
A boolean value:
0 or OFF: measurement is not continuous
1 or ON: measurement is continuous
example:
init2:cont? → 1<END>
affects:
All power meters, return loss modules.
dual sensors:
Can only be sent to master channel, slave channel parameters are identical.
command:
:READ[n][:CHANnel[m]][SCALar:]:POWer:ALL?
:READ[n]:[CHANnel[m]]:POWer:[:DC]:ALL?
syntax:
description:
Reads all available power meter channels. It provides its own software triggering and does
not need a triggering command.
The power meters must be running for this command to be effective.
none
NOTE
parameters:
response:
4-byte Intel float values in a binary block in Intel byte order. The values are ordered by slot
and channel order.
Data values are always in Watt.
NOTE
example:
read1:pow:all? → interpreted as
+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:
Slave channels receive a fetch command, see:
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
89
Download from Www.Somanuals.com. All Manuals Search And Download.
Measurement Operations & Settings
Measurement Functions – The SENSe Subsystem
command:
:READ[n][:CHANnel[m]]:POWer:ALL:CONFig?
:READ[n]:[CHANnel[m]]:POWer[:DC]:ALL:CONFig?
syntax:
description:
Returns the slot and channel numbers for all available power meter channels.
Use this command to match returned power values to the appropriate slot and channel num-
ber.
parameters:
response:
none
A binary block (Intel byte order) consisting of 2-byte unsigned integer value pairs (so each
pair has 4 bytes). The first member of the pair represents the the slot number, the second
member of the pair represents the channel number.
example:
read1:pow:all:conf? → interpreted as
1|1|1|2|12|1<END>
This 12-byte block means that there are three powermeters present:
Slot 1, Channel 1
Slot 1, Channel 2
Slot 12, Channel 1
affects:
All power meters (v3.0x firmware or later).
dual sensors:
command:
:READ[n][:CHANnel[m]][:SCALar]:POWer[:DC]?
:READ[n]:[CHANnel[m]][:SCALar]:POWer[:DC]?
syntax:
description:
Reads the current power meter value, or for a return loss module the power value at the re-
turn loss diode (back reflection path). It provides its own software triggering and does not
need a triggering command.
If the software trigger system operates continuously (see
If the software trigger system does not operate continuously, this command is identical to
then reading the power meter value.
The power meter must be running for this command to be effective.
none
NOTE
parameters:
response:
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.
NOTE
example:
read1:pow? → +1.33555600E-006<END>
affects:
All power meters and return loss modules and attenuator with power control
Can only be sent to master channel, slave channel is also triggered.
dual sensors:
To read a simultaneous result from the slave channel, send
90
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
Measurement Functions – The SENSe Subsystem
Measurement Operations & Settings
command:
:READ[n][:CHANnel[m]][:SCALar]:RETurnloss?
:READ[n]:[CHANnel[m]][:SCALar]:RETurnloss?
syntax:
description:
Reads the current return loss value. It provides its own software triggering and does not
need a triggering command.
If the software trigger system operates continuously (see
If the software trigger system does not operate continuously, this command is identical to
then reading the power meter value.
The return loss module must be running for this command to be effective.
none
NOTE
parameters:
response:
example:
affects:
The current power meter reading as a float value in dB.
read1:ret? → +1.33555600E-000<END>
All return loss modules
command:
:READ[n][:CHANnel[m]][:SCALar]:MONitor?
:READ[n]:[CHANnel[m]][:SCALar]:MONitor?
syntax:
description:
Reads the power value at the monitor diode (forward path). It provides its own software trig-
gering and does not need a triggering command.
If the software trigger system operates continuously (see
If the software trigger system does not operate continuously, this command is identical to
then reading the power meter value.
The return loss module must be running for this command to be effective.
none
NOTE
parameters:
response:
example:
affects:
The current power meter reading as a float value in W or dBm
read1:mon? → +1.33555600E-000<END>
All return loss modules
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
91
Download from Www.Somanuals.com. All Manuals Search And Download.
Measurement Operations & Settings
Measurement Functions – The SENSe Subsystem
command:
:SENSe[n]:[CHANnel[m]]:CORRection[:LOSS][:INPut][:MAGNitude]
:SENSe[n]:[CHANnel[m]]:CORRection[:LOSS][:INPUT][:MAGNitude]<wsp>
syntax:
<value>[DB|MDB]
description:
parameters:
Enters a calibration value for a module.
The calibration factor as a float value
If no unit type is specified, decibels (dB) is implied.
response:
example:
affects:
none
sens1:corr 10DB
All power meters
dual sensors:
Master and slave channels are independent.
command:
:SENSe[n]:[CHANnel[m]]:CORRection[:LOSS][:INPut][:MAGNitude]?
:SENSe[n]:[CHANnel[m]]:CORRection[:LOSS][:INPUT][:MAGNitude]?
Returns the calibration factor for a module.
none
syntax:
description:
parameters:
response:
The calibration factor as a float value. Units are in dB, although no units are returned in the
response message.
example:
sens1:corr? → +1.00000000E+000<END>
All power meters
affects:
dual sensors:
Master and slave channels are independent.
command:
:SENSe[n]:[CHANnel[m]]:CORRection:COLLect:ZERO
:SENSe[n]:[CHANnel[m]]:CORRection:COLLect:ZERO
Zeros the electrical offsets for a power meter or return loss module.
none
syntax:
description:
parameters:
response:
example:
none
sens1:corr:coll:zero
affects:
All power meters and return loss modules
Can only be sent to master channel, slave channel is also zeroed.
dual sensors:
92
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
Measurement Functions – The SENSe Subsystem
Measurement Operations & Settings
command:
:SENSe[n]:[CHANnel[m]]:CORRection:COLLect:ZERO?
syntax:
:SENSe[n]:[CHANnel[m]]:CORREction:COLLect:ZERO?
Returns the status of the most recent zero command.
none
description:
parameters:
response:
0:
zero succeeded without errors.
any other number:
remote zeroing failed (the number is the error code returned from
the operation).
example:
sens1:corr:coll:zero? → 0<END>
affects:
All power meters and return loss modules
Master and slave channels are independent.
dual sensors:
command:
:SENSe[n]:[CHANnel[m]]:CORRection:COLLect:ZERO:ALL
SENSe[n]:[CHANnel[m]]:CORRection:COLLect:ZERO:ALL
Zeros the electrical offsets for all installed power meter and return loss modules.
none
syntax:
description:
parameters:
response:
example:
none
sens:chan:corr:coll:zero:all
affects:
All power meters and return loss modules
Command is independent of channel.
dual sensors:
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
NOTE
:SENSe[n][:CHANnel[m]]:FUNCtion:PARameter:LOGGing command to set
parameters before you start a logging function using the
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
93
Download from Www.Somanuals.com. All Manuals Search And Download.
Measurement Operations & Settings
Measurement Functions – The SENSe Subsystem
command:
:SENSe[n][:CHANnel[m]]:FUNCtion:PARameter:LOGGing
:SENSe[n][:CHANnel[m]]:FUNCtion:PARameter:LOGGing<wsp><data points>,
syntax:
<averaging time>[NS|US|MS|S]
description:
parameters:
Sets the number of data points and the averaging time for the logging data acquisition func-
tion.
Data Points:
Data Points is the number of samples that are recorded before the log-
ging mode is completed. Data Points is an integer value.
Averaging time:
Averaging time is a time value in seconds.
There is no time delay between averaging time periods. Use
page 97 if you want to use delayed measurement.
Averaging Time
Measurement Running
Measurement Stopped
1
2
3
4
5
6
7
8
9
t
If you specify no units for the averaging time value in your command, seconds are used as
the default.
NOTE
ing/stopping a data acquisition function.
the results of a data acquisition function.
NOTE
NOTE
affects data acquisition functions.
response:
none
example:
sens1:func:par:logg 64,1ms
affects:
All power meters and return loss modules
Can only be sent to master channel, slave channel is also affected.
dual sensors:
command:
:SENSe[n][:CHANnel[m]]:FUNCtion:PARameter:LOGGing?
:SENSe[n][:CHANnel[m]]:FUNCtion:PARameter:LOGGing?
syntax:
description:
Returns the number of data points and the averaging time for the logging data acquisition
function.
parameters:
response:
none
Returns the number of data points as an integer value and the averaging time, t , as a float
avg
value in seconds.
example:
sens1:func:par:logg? → +64,+1.00000000E-001<END>
All power meters and return loss modules
affects:
dual sensors:
Can only be sent to master channel, slave channel parameters are identical.
94
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
Measurement Functions – The SENSe Subsystem
Measurement Operations & Settings
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
NOTE
:SENSe[n][:CHANnel[m]]:FUNCtion:PARameter:MINMax command to set
parameters before you start a MinMax function using the
command:
syntax:
:SENSe[n][:CHANnel[m]]:FUNCtion:PARameter:MINMax
:SENSe[n][:CHANnel[m]]:FUNCtion:PARameter:MINMax<wsp>
CONTinous|WINDow|REFResh,<data points>
description:
parameters:
Sets the MinMax mode and the number of data points for the
MinMax data acquisition function.
CONTinous:
WINDow:
REFResh:
continuous MinMax mode
window MinMax mode
refresh MinMax mode
Data Points is the number of samples that are recorded in the memory buffer used by the
WINDow and REFResh modes. Data Points is an integer value.
See Chapter 3 of the Agilent 8163A/B Lightwave Multimeter, Agilent 8164A/B Lightwave
Measurement System, & Agilent 8166A/B Lightwave Multichannel System User’s Guide, for
more information on MinMax mode.
NOTE
ing/stopping a data acquisition function.
the results of a data acquisition function.
NOTE
NOTE
affects data acquisition functions.
response:
none
example:
sens1:func:par:minm WIND,10
affects:
All power meters and return loss modules
Can only be sent to master channel, slave channel is also affected.
dual sensors:
command:
:SENSe[n][:CHANnel[m]]:FUNCtion:PARameter:MINMax?
:SENSe[n][:CHANnel[m]]:FUNCtion:PARameter:MINMax?
syntax:
description:
Returns the MinMax mode and the number of data points for the MinMax data acquisition
function.
parameters:
response:
none
CONT:
WIND:
REFR:
continuous MinMax mode
window MinMax mode
refresh MinMax mode
The number of data points is returned as an integer value.
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
95
Download from Www.Somanuals.com. All Manuals Search And Download.
Measurement Operations & Settings
Measurement Functions – The SENSe Subsystem
example:
sens1:func:par:minm? → WIND,+10<END>
All power meters and return loss modules
affects:
dual sensors:
Can only be sent to master channel, slave channel parameters are identical.
Setting parameters for the stability function sets some parameters,
including hidden parameters, for the logging and MinMax functions and
vice versa. You must use the
NOTE
:SENSe[n][:CHANnel[m]]:FUNCtion:PARameter:STABility command to set
parameters before you start a stability function using the
command:
:SENSe[n][:CHANnel[m]]:FUNCtion:PARameter:STABility
syntax:
:SENSe[n][:CHANnel[m]]:FUNCtion:PARameter:STABility<wsp>
<total time>[NS|US|MS|S],<period time>[NS|US|MS|S],<averaging time>[NS|US|MS|S]
description:
parameters:
Sets the total time, period time, and averaging time for the stability data acquisition function.
Total time:
The total time from the start of stability mode until it is completed.
A new measurement is started after the completion of every period time.
Period time:
Averaging time: A measurement is averaged over the averaging time.
Averaging Time
Period Time
Measurement Running
Measurement Stopped
1
2
3
4
5
t
The total time should be longer than the period time.
NOTE
The period time should be longer than the averaging time.
The number of data points is equal to the total time divided by the period time.
Total time, period time, and averaging time are time values in seconds.
If you specify no units in your command, seconds are used as the default.
ping a data acquisition function.
NOTE
NOTE
NOTE
results of a data acquisition function.
fects data acquisition functions.
response:
none
example:
sens1:func:par:stab 1s,0.1s,0.1s
affects:
All power meters and return loss modules
Can only be sent to master channel, slave channel is also affected.
dual sensors:
96
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
Measurement Functions – The SENSe Subsystem
Measurement Operations & Settings
command:
:SENSe[n][:CHANnel[m]]:FUNCtion:PARameter:STABility?
:SENSe[n][:CHANnel[m]]:FUNCtion:PARameter:STABility?
syntax:
description:
Returns the total time, period time, and averaging time for the stability data acquisition func-
tion.
parameters:
response:
example:
none
Total time, delay time, and averaging time are float values in seconds.
sens1:func:par:stab? → +1.00000000E+000,
+1.00000000E-001,+1.00000000E-001<END>
affects:
All power meters and return loss modules
dual sensors:
Can only be sent to master channel, slave channel parameters are identical.
command:
:SENSe[n][:CHANnel[m]]:FUNCtion:RESult?
:SENSe[n][:CHANnel[m]]:FUNCtion:RESult?
Returns the data array of the last data acquisition function.
none
syntax:
description:
parameters:
response:
The last data acquisition function’s data array as a binary block.
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.
NOTE
some tips about how to use float format specifiers to convert the binary blocks into float val-
ues.
If you use LabView or Agilent VEE, we recommend using the Agilent 816x VXIplug&play In-
strument Driver to perform the Logging and Stability Data Acquisition functions.
NOTE
example:
sens1:func:res? →
returns a data array for Logging and Stability Data Acquisition functions
sens1:func:res? → #255
Min: 7.24079E-04, Max: 7.24252E-04, Act: 7.24155E-04
returns the minimum, maximum and current power values for the MinMax Data
Acquisition function
affects:
All power meters and return loss modules
Master and slave channels are independent.
Return Loss modules:
dual sensors:
NOTE
For Logging and Stability Data Acquisition functions, the data array contains power
values.
For the MinMax Data Acquisition function, the data array contains return loss values.
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
97
Download from Www.Somanuals.com. All Manuals Search And Download.
Measurement Operations & Settings
Measurement Functions – The SENSe Subsystem
command:
:SENSe[n][:CHANnel[m]]:FUNCtion:RESult:BLOCk?
syntax:
:SENSe[n][:CHANnel[m]]:FUNCtion:RESult:BLOCk?<wsp><offset>,<# of data points>
description:
Returns a specific binary block (Intel byte order) from the data array for the last data acquisi-
tion function.
parameters:
response:
<offset> A zero based offset; the number of data points to ignore.
# data points The number of data points (not bytes!) to return.
The last stablility or logging data acquisition function’s data array as a binary block.
This function is not available for min-max measurements.
One measurement value is a 4-byte-long float in Intel byte order.
example:
sens1:func:res:bloc? #5, 2 → interpreted as
7.24079E-04,7.24252E-04<end>
affects:
All power meters and return loss modules .
Master and slave channels are independent.
Return Loss modules:
dual sensors:
NOTE
For Logging and Stability Data Acquisition functions, the data array contains power
values.
command:
syntax:
:SENSe[n][:CHANnel[m]]:FUNCtion:RESult:MAXBlocksize?
:SENSe[n][:CHANnel[m]]:FUNCtion:RESult:MAXBlocksize?<wsp><offset><# of data
points>
description:
Returns the maximum block size for a single GPIB transfer for power meter data acquisition
functions. If your application requires more data points please use SENSe[n][:CHAN-
nel[m]]:FUNCtion:RESult:BLOCk? instead of SENSe[n][:CHANnel[m]]:FUNCtion:RESult?
parameters:
response:
none
An integer value, number of data points.
example:
affects:
All power meters and return loss modules.
Master and slave channels are independent.
dual sensors:
98
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
Measurement Functions – The SENSe Subsystem
Measurement Operations & Settings
command:
:SENSe[n][:CHANnel[m]]:FUNCtion:RESult:MONitor?
:SENSe[n][:CHANnel[m]]:FUNCtion:RESult:MONitor?
syntax:
description:
parameters:
response:
Returns the monitor diode data array for the last data acquisition function.
none
The last data acquisition function’s data array as a binary block.
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.
NOTE
some tips about how to use float format specifiers to convert the binary blocks into float val-
ues.
If you use LabView or Agilent VEE, we recommend using the Agilent 816x VXIplug&play In-
strument Driver to perform the Logging and Stability Data Acquisition functions.
NOTE
example:
sens1:func:res:mon? →
returns a data array for Logging and Stability Data Acquisition functions
sens1:func:res? → #255
Min: 7.24079E-04, Max: 7.24252E-04, Act: 7.24155E- 04
returns the minimum, maximum and current power values for the MinMax Data Acquisition
function
affects:
All return loss modules
dual sensors:
Master and slave channels are independent.
Return Loss modules:
NOTE
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.
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
99
Download from Www.Somanuals.com. All Manuals Search And Download.
Measurement Operations & Settings
Measurement Functions – The SENSe Subsystem
command:
:SENSe[n][:CHANnel[m]]:FUNCtion:STATe
:SENSe[n][:CHANnel[m]]:FUNCtion:STATe<wsp>
syntax:
LOGGing|STABility|MINMax,STOP|STARt
description:
parameters:
Enables/Disables the logging, MinMax, or stability data acquisition function mode.
LOGGing:
STABility:
MINMax:
Logging data acquisition function
Stability data acquisition function
MinMax data acquisition function
STOP:
STARt:
Stop data acquisition function
Start data acquisition function
When you enable a logging data acquisition function for a Agilent 8163A/B 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.
NOTE
mation on the logging data acquisition function.
Stop any function before you try to set up a new function. Some parameters cannot be set
until you stop the function.
NOTE
response:
none
example:
sens1:func:stat logg,star
affects:
All power meters and return loss modules
Can only be sent to master channel, slave channel is also affected.
dual sensors:
command:
:SENSe[n][:CHANnel[m]]:FUNCtion:STATe?
:SENSe[n][:CHANnel[m]]:FUNCtion:STATe?
Returns the function mode and the status of the data acquisition function.
none
syntax:
description:
parameters:
response:
NONE
No function mode selected
LOGGING_STABILITY
MINMAX
Logging or stability data acquisition function
MinMax data acquisition function
PROGRESS
COMPLETE
Data acquisition function is in progress
Data acquisition function is complete
example:
sens1:func:stat? → LOGGING_STABILITY,COMPLETE<END>
All power meters and return loss modules
affects:
dual sensors:
Can only be sent to master channel, slave channel parameters are identical.
100
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
Measurement Functions – The SENSe Subsystem
Measurement Operations & Settings
command:
:SENSe[n][:CHANnel[m]]:FUNCtion:THReshold
:SENSe[n][:CHANnel[m]]:FUNCtion:THReshold<wsp><mode>,
syntax:
<threshold value>[PW|NW|UW|MW|Watt|DBM]
description:
parameters:
Sets the start mode and the threshold value.
ABOVe:
Function starts when power is above the threshold value.
BELow:
IMMediately:
Threshold Value:
Function starts when power is below the threshold value.
Function starts immediately.
A float value in Watts or dBm.
response:
example:
affects:
none
sens1:func:thr IMM,20nw<END>
All HP 8153A Lightwave Multimeter series power meters and the HP 81534A Return Loss
module
Does NOT affect Agilent 8161x series return loss modules
NOTE
command:
:SENSe[n][:CHANnel[m]]:FUNCtion:THReshold?
:SENSe[n][:CHANnel[m]]:FUNCtion:THReshold?
Returns the start mode and the threshold value.
none
syntax:
description:
parameters:
response:
ABOV:
Function starts when power is above the threshold value.
Function starts when power is below the threshold value.
Function starts immediately.
BEL:
IMM:
Threshold Value:
A float value in Watts or dBm.
example:
affects:
sens1:func:thr? → IMM,+2.00000000E-008<END>
All HP 8153A Lightwave Multimeter series power meters and the HP 81534A Return Loss
module
Does NOT affect Agilent 8161x series return loss modules
NOTE
command:
:SENSe[n]:[CHANnel[m]]:POWer:ATIMe
syntax:
:SENSe[n]:[CHANnel[m]]:POWer:ATIMe<wsp><averaging time>[NS|US|MS|S]
Sets the averaging time for the module.
description:
parameters:
The averaging time as a float value in seconds.
If you specify no units in your command, seconds are used as the default.
none
response:
example:
affects:
sens1:pow:atim 1s
All power meters and return loss modules
Can only be sent to master channel, slave channel is also affected.
dual sensors:
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
101
Download from Www.Somanuals.com. All Manuals Search And Download.
Measurement Operations & Settings
Measurement Functions – The SENSe Subsystem
command:
:SENSe[n]:[CHANnel[m]]:POWer:ATIMe?
syntax:
:SENSe[n]:[CHANnel[m]]:POWer:ATIMe?
Returns the averaging time for the module.
none
description:
parameters:
response:
example:
The averaging time as a float value in seconds.
sens1:pow:atim? → +1.00000000E+000<END>
affects:
All power meters and return loss modules
dual sensors:
Can only be sent to master channel, slave channel parameters are identical.
command:
:SENSe[n]:[CHANnel[m]]:POWer:RANGe[:UPPer]
syntax:
:SENSe[n]:[CHANnel[m]]:POWer:RANGe[:UPPer]<wsp><value>[DBM]
description:
Sets the power range for the module. For a return loss module, sets the power range of the
return loss diode.
The range changes at 10 dBm intervals. The corresponding ranges for linear measurements
(measurements in Watts) is given below:
Range
Upper Linear
Power Limit
Range
Upper Linear
Power Limit
+30 dBm
+20 dBm
+10 dBm
0 dBm
−10 dBm
−20 dBm
−30 dBm
−40 dBm
1999.9 mW
199.99 mW
19.999 mW
1999.9 µW
199.99 µW
19.999 µW
1999.9 nW
199.99 nW
−50 dBm
−60 dBm
−70 dBm
−80 dBm
−90 dBm
−100 dBm
−110 dBm
19.999 nW
1999.9 pW
199.99 pW
19.999 pW
1.999 pW
0.199 pW
0.019 pW
parameters:
The range as a float value in dBm. The number is rounded to the closest multiple of 10, be-
cause the range changes at 10 dBm intervals. Units are in dBm.
response:
example:
affects:
none
sens1:pow:rang -20DBM
All power meters and return loss modules.
Master and slave channels are independent.
dual sensors:
102
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
Measurement Functions – The SENSe Subsystem
Measurement Operations & Settings
command:
:SENSe[n]:[CHANnel[m]]:POWer:RANGe[:UPPer]?
:SENSe[n]:[CHANnel[m]]:POWer:RANGe[:UPPer]?
syntax:
description:
Returns the range setting for the module. For a return loss module, returns the power range
of the return loss diode.
parameters:
response:
none
The range setting as a float value in dBm
(−110 ≤ value ≤ +30).
example:
sens1:pow:rang? → -2.00000000E+001<END>
All power meters and return loss modules.
Master and slave channels are independent.
affects:
dual sensors:
command:
:SENSe[n]:[CHANnel[m]]:POWer:RANGe:MONitor[:UPPer]
syntax:
:SENSe[n]:[CHANnel[m]]:POWer:RANGe:MONitor[:UPPer]<wsp><value>[DBM]
Sets the power range for a retun loss module’s monitor diode.
description:
The range changes at 10 dBm intervals. The corresponding ranges for linear measurements
(measurements in Watts) is given below:
Range
Upper Linear
Power Limit
Range
Upper Linear
Power Limit
+30 dBm
+20 dBm
+10 dBm
0 dBm
−10 dBm
−20 dBm
−30 dBm
−40 dBm
1999.9 mW
199.99 mW
19.999 mW
1999.9 µW
199.99 µW
19.999 µW
1999.9 nW
199.99 nW
−50 dBm
−60 dBm
−70 dBm
−80 dBm
−90 dBm
−100 dBm
−110 dBm
19.999 nW
1999.9 pW
199.99 pW
19.999 pW
1.999 pW
0.199 pW
0.019 pW
parameters:
The range as a float value in dBm. The number is rounded to the closest multiple of 10, be-
cause the range changes at 10 dBm intervals. Units are in dBm.
response:
example:
affects:
none
sens1:pow:rang:mon -20DBM
All return loss modules.
Master and slave channels are independent.
dual sensors:
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
103
Download from Www.Somanuals.com. All Manuals Search And Download.
Measurement Operations & Settings
Measurement Functions – The SENSe Subsystem
command:
:SENSe[n]:[CHANnel[m]]:POWer:RANGe:MONitor[:UPPer]?
:SENSe[n]:[CHANnel[m]]:POWer:RANGe[:UPPer]?
syntax:
description:
parameters:
response:
Sets the power range for a retun loss module’s monitor diode.
none
The range setting as a float value in dBm
(−110 ≤ value ≤ +30).
example:
sens1:pow:rang? → -2.00000000E+001<END>
All return loss modules.
affects:
dual sensors:
Master and slave channels are independent.
command:
:SENSe[n]:[CHANnel[m]]:POWer:RANGe:AUTO
syntax:
SENSe[n]:[CHANnel[m]]:POWer:RANGe:AUTO <wsp><boolean>
Enables or disables automatic power ranging for the module.
description:
If automatic power ranging is enabled, ranging is automatically determined by the instru-
ment. Otherwise, it must be set by the sensn:pow:rang command.
parameters:
A boolean value:
0 or OFF: automatic ranging disabled
1 or ON: automatic ranging enabled
response:
example:
affects:
none
sens1:pow:rang:auto 1
All power meters and return loss modules
For return loss modules, affects return loss diode and monitor diode simultaneously.
Can only be sent to master channel, slave channel is also affected.
NOTE
dual sensors:
command:
:SENSe[n]:[CHANnel[m]]:POWer:RANGe:AUTO?
:SENSe[n]:[CHANnel[m]]:POWer:RANGe:AUTO?
Returns whether automatic power ranging is being used by the module.
none
syntax:
description:
parameters:
response:
A boolean value:
0: automatic ranging is not being used.
1: automatic ranging is being used.
example:
sens1:pow:rang:auto? → 1<END>
affects:
All power meters and return loss modules
dual sensors:
Can only be sent to master channel, slave channel parameters are identical.
104
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
Measurement Functions – The SENSe Subsystem
Measurement Operations & Settings
command:
:SENSe[n]:[CHANnel[m]]:POWer:REFerence
:SENSe[n]:[CHANnel[m]]:POWer:REFerence<wsp>
syntax:
TOMODule|TOREF,<value>PW|NW|UW|MW|Watt|DBM|DB|MDB
description:
parameters:
Sets the sensor reference value.
TOMODule:
TOREF:
Sets the reference value in dB used if you choose measurement rela-
tive to another channel
Sets the reference value in Watts or dBm if you choose measurement
relative to a constant reference value
The reference as a float value.
You must append a unit type
• dB if you use TOMODule or
• Watts or dBm if you use TOREF.
NOTE
The two reference values are completely independent. When you change the
reference mode using the command
NOTE
instrument uses the last reference value entered for the selected reference mode.
response:
none
example:
sens1:pow:ref tomod,-40DB
All power meters
affects:
dual sensors:
Master and slave channels are independent.
command:
:SENSe[n]:[CHANnel[m]]:POWer:REFerence?
:SENSe[n]:[CHANnel[m]]:POWer:REFerence?<wsp>TOMODule|TOREF
Returns the sensor reference value.
syntax:
description:
parameters:
TOMODule:
Returns the reference value in dB used if you choose measurement rel-
ative to another channel
TOREF:
Returns the reference value in Watts or dBm if you choose measure-
ment relative to a constant reference value
response:
example:
affects:
The reference as a float value.
sens1:pow:ref? toref → +1.00000000E-006<END>
All power meters
dual sensors:
Master and slave channels are independent.
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
105
Download from Www.Somanuals.com. All Manuals Search And Download.
Measurement Operations & Settings
Measurement Functions – The SENSe Subsystem
command:
:SENSe[n]:[CHANnel[m]]:POWer:REFerence:DISPlay
:SENSe[n]:[CHANnel[m]]:POWer:REFerence:DISPlay
syntax:
description:
parameters:
response:
example:
Takes the input power level value as the reference value.
none
none
sens1:pow:ref:disp
affects:
All power meters
dual sensors:
Master and slave channels are independent.
command:
:SENSe[n]:[CHANnel[m]]:POWer:REFerence:STATe
syntax:
:SENSe[n]:[CHANnel[m]]POWer:REFerence:STATe<wsp><boolean>
Sets the measurement units to relative or absolute units.
description:
parameters:
A boolean value:
0 or OFF: absolute
1 or ON: relative
response:
example:
affects:
none
sens1:pow:ref:stat 1
All power meters
dual sensors:
Master and slave channels are independent.
command:
:SENSe[n]:[CHANnel[m]]:POWer:REFerence:STATe?
:SENSe[n]:[CHANnel[m]]POWer:REFerence:STATe?
syntax:
description:
Inquires whether the current measurement units are relative (dB) or absolute (Watts or
dBm).
parameters:
response:
none
A boolean value:
0: absolute
1: relative
example:
sens1:pow:ref:stat? → 1<END>
All power meters
affects:
dual sensors:
Master and slave channels are independent.
106
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
Measurement Functions – The SENSe Subsystem
Measurement Operations & Settings
command:
:SENSe[n]:[CHANnel[m]]:POWer:REFerence:STATe:RATio
:SENSe[n]:[CHANnel[m]]POWer:REFerence:STATe:RATio<wsp>
syntax:
<slot number>|255|TOREF,<channel number>
description:
parameters:
Selects the reference for the module.
slot number:
an integer value representing the slot number you want to reference
255 or TOREF:
channel number:
results are displayed relative to an absolute reference
an integer value representing the channel number you want to refer-
ence
If you want to reference another power sensor channel, use an integer value
corresponding to the slot for the first parameter and an integer value corresponding
to the channel for the second value.
NOTE
If you want to use an absolute reference, use TOREF as the first parameter and any
integer value as the second parameter.
response:
examples:
none
sens1:pow:ref:stat:rat 2,1
References channel 2.1
sens1:pow:ref:stat:rat TOREF,1
All power meters
References an absolute reference
affects:
dual sensors:
Master and slave channels are independent.
command:
:SENSe[n]:[CHANnel[m]]:POWer:REFerence:STATe:RATio?
:SENSe[n]:[CHANnel[m]]POWer:REFerence:STATe:RATio?
Returns the reference setting for the module.
none
syntax:
description:
parameters:
response:
results are displayed relative to an absolute reference or to the current power reading from
another channel.
examples:
sens1:pow:ref:stat:rat? → +255,+0<END>
results are displayed relative
to an absolute reference
sens1:pow:ref:stat:rat? → +2,+1<END>
results are displayed relative
to channel 2.1
affects:
All power meters
dual sensors:
Master and slave channels are independent.
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
107
Download from Www.Somanuals.com. All Manuals Search And Download.
Measurement Operations & Settings
Measurement Functions – The SENSe Subsystem
command:
:SENSe[n]:[CHANnel[m]]:POWer:UNIT
:SENSe[n]:[CHANnel[m]]:POWer:UNIT<wsp>DBM|0|Watt|1
syntax:
description:
parameters:
Sets the sensor power unit
An integer value:
0: dBm
1: Watt
or DBM or Watt
none
response:
example:
affects:
sens1:pow:unit 1
All power meters
dual sensors:
Master and slave channels are independent.
command:
:SENSe[n]:[CHANnel[m]]:POWer:UNIT?
:SENSe[n]:[CHANnel[m]]:POWer:UNIT?
Inquires the current sensor power unit
none
syntax:
description:
parameters:
response:
An integer value:
0: Current power units are dBm.
1: Current power units are Watts.
example:
sens1:pow:unit? → +1<END>
All power meters
affects:
dual sensors:
Master and slave channels are independent.
command:
syntax:
:SENSe[n]:[CHANnel[m]]:POWer:WAVelength
:SENSe[n]:[CHANnel[m]]:POWer:WAVelength<wsp><value>|MIN|MAX|DEF
[PM|NM|UM|MM|M]
description:
parameters:
Sets the sensor wavelength.
The wavelength as a float value in meters.
Also allowed are:
MIN: minimum programmable value
MAX: maximum programmable value
DEF: This is not the preset (*RST) default value but is half
the sum of, the minimum programmable value and the
maximum programmable value
response:
example:
affects:
none
sens1:pow:wav 1550nm
All power meters
dual sensors:
Master and slave channels are independent.
108
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
Measurement Functions – The SENSe Subsystem
Measurement Operations & Settings
command:
:SENSe[n]:[CHANnel[m]]:POWer:WAVelength?
:SENSe[n]:[CHANnel[m]]:POWer:WAVelength?[<wsp>MIN|MAX|DEF]
syntax:
description:
parameters:
Inquires the current sensor wavelength.
none
Also allowed are:
MIN: minimum programmable value
MAX: maximum programmable value
DEF: This is not the preset (*RST) default value but is half
the sum of, the minimum programmable value and the
maximum programmable value
response:
example
The wavelength as a float value in meters.
sens1:pow:wav? → +1.55000000E-006<END>
All power meters
affects:
dual sensors:
Master and slave channels are independent.
command:
:SENSe[n]:[CHANnel[m]]:RETurnloss:CALibration:FACTory
:SENSe[n]:[CHANnel[m]]:RETurnloss:CALibration:FACTory
syntax:
description:
For all sources, overwrites the current calibration values with the factory-set calibration set-
page 112 for information on calibrating your return loss module.
parameters:
response:
example
none
none
sens1:ret:cal:fact
All return loss modules
affects:
command:
:SENSe[n]:[CHANnel[m]]:RETurnloss:CALibration:COLLect:REFLectance
:SENSe[n]:[CHANnel[m]]:RETurnloss:CALibration:COLLect:REFLectance
syntax:
description:
For the currently selected source, start the calibration and save the calibration values for a
defined reflectance reference measurement. See
mation on setting the return loss value of your reference reflector.
parameters:
response:
example
none
none
sens1:ret:cal:coll:refl
All return loss modules
affects:
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
109
Download from Www.Somanuals.com. All Manuals Search And Download.
Measurement Operations & Settings
Measurement Functions – The SENSe Subsystem
command:
:SENSe[n]:[CHANnel[m]]:RETurnloss:CALibration:COLLect:TERMination
:SENSe[n]:[CHANnel[m]]:RETurnloss:CALibration:COLLect:TERMination
syntax:
description:
For the currently selected source, start the calibration and save the calibration values for a
defined termination reference measurement. See
mation on setting the return loss value of your reference reflector.
parameters:
response:
example
none
none
sens1:ret:cal:coll:term
All return loss modules
affects:
command:
:SENSe[n]:[CHANnel[m]]:RETurnloss:CALibration:TERMination?
:SENSe[n]:[CHANnel[m]]:RETurnloss:CALibration:TERMination?
Queries the T-value (termination calibration value) for the return loss module
none
syntax:
description:
parameters:
response:
example
Termination calibration value as a float in dB
sens1:ret:cal:term? → +6.5000E+001
affects:
All return loss modules
command:
:SENSe[n]:[CHANnel[m]]:RETurnloss:CALibration:VALues?
:SENSe[n]:[CHANnel[m]]:RETurnloss:CALibration:VALues?
syntax:
description:
Returns the the current calibration values
1. monitor diode reference power
2. return loss diode reference power
3. monitor diode parasitics power
4. return loss diode parasitics power.
parameters:
response:
example
Returns power values in W
none
sens1:ret:cal:val
affects:
All return loss modules
110
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
Measurement Functions – The SENSe Subsystem
Measurement Operations & Settings
command:
:SENSe[n]:[CHANnel[m]]:RETurnloss:CORRection:FPDelta[l]
:SENSe[n]:[CHANnel[m]]:RETurnloss:CORRection:FPDelta[l]<wsp><value>[dB]
syntax:
description:
Sets the front panel delta, that is, the loss correction value, for example, due to the front pan-
el connector. Twice this value is added to the measured Return Loss.
Use [l] to set the front panel delta for an external source or the upper or lower wavelength la-
ser source of a dual return loss module.
NOTE
An external laser source is denoted by 0. 0 is the default value of [l].
A lower wavelength source is denoted by 1.
An upper wavelength source is denoted by 2.
parameters:
response:
example
Sets the front panel delta as a float value in dB
none
sens1:ret:cal:corr:fpd 0.08DB
All return loss modules
affects:
command:
:SENSe[n]:[CHANnel[m]]:RETurnloss:CORRection:FPDelta[l]?
:SENSe[n]:[CHANnel[m]]:RETurnloss:CORRection:FPDelta[l]?
syntax:
description:
Returns the front panel delta, that is, the loss correction value, for example, due to the front
panel connector. Twice this value is added to the measured Return Loss.
Use [l] to query the front panel delta for an external source or the upper or lower wavelength
laser source of a dual return loss module.
NOTE
An external laser source is denoted by 0. 0 is the default value.
A lower wavelength source is denoted by 1.
An upper wavelength source is denoted by 2.
parameters:
response:
example
Returns the front panel delta as a float value in dB
none
sens1:ret:cal:corr:fpd? → +8.00000000E-002<END>
All return loss modules
affects:
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
111
Download from Www.Somanuals.com. All Manuals Search And Download.
Measurement Operations & Settings
Measurement Functions – The SENSe Subsystem
command:
:SENSe[n]:[CHANnel[m]]:RETurnloss:CORRection:REFLectance[l]
syntax:
: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 Agilent 81000BR reference reflector provides an accurate and stable 0.18
dB reference.
Use [l] to set the return loss value of your reference reflector for an external source or the
upper or lower wavelength laser source of a dual return loss module.
An external laser source is denoted by 0. 0 is the default value of [l].
A lower wavelength source is denoted by 1.
NOTE
An upper wavelength source is denoted by 2.
parameters:
response:
example
Sets the Return Loss Reference as a float value in dB
none
sens1:ret:cal:corr:refl 0.18DB
All return loss modules
affects:
command:
:SENSe[n]:[CHANnel[m]]:RETurnloss:CORRection:REFLectance[l]?
:SENSe[n]:[CHANnel[m]]:RETurnloss:CORRection:REFLectance[l]?
syntax:
description:
Returns the Return Loss Reference, the return loss value of your reference reflector.
For example, the Agilent 81000BR reference reflector provides an accurate and stable 0.18
dB reference.
Use [l] to query the return loss value of your reference reflector for an external source or the
upper or lower wavelength laser source of a dual return loss module.
An external laser source is denoted by 0. 0 is the default value of [l].
A lower wavelength source is denoted by 1.
NOTE
An upper wavelength source is denoted by 2.
parameters:
response:
example
none
Returns the Return Loss Reference as a float value in dB
sens1:ret:cal:corr:refl? → +1.80000000E-001<END>
All return loss modules
affects:
112
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
Signal Generation – The SOURce Subsystem
Measurement Operations & Settings
Signal Generation – The SOURce
Subsystem
The SOURce subsystem allows you to control a laser source module, DFB
source module, tunable laser module, or a return loss module that has an
internal source.
command:
:OUTPut[n][:CHANnel[m]]:CONNection
syntax:
OUTPut[n][:CHANnel[m]]:CONNection<wsp>MOD|VPP
description:
parameters:
Sets the analog output parameter.
MOD:
VPP:
none
The modulation frequency modulates the analog output.
Output Voltage is proportional to optical power.
response:
example:
affects:
outp0:conn mod
All tunable laser modules with BNC ouput connector
command:
:OUTPut[n][:CHANnel[m]]:CONNection?
OUTPut[n][:CHANnel[m]]:CONNection?
Returns the analog output parameter.
none
syntax:
description:
parameters:
response:
MOD:
VPP:
The modulation frequency modulates the analog output.
Output Voltage is proportional to optical power.
example:
affects:
outp0:conn? → MOD<END>
All tunable laser modules with BNC ouput connector
command:
:OUTPut[n][:CHANnel[m]]:PATH
:OUTPut[n][:CHANnel[m]]:PATH<wsp><path>
Sets the regulated path.
syntax:
description:
parameters:
HIGHpower:
LOWSse:
The High Power output is regulated.
The Low SSE output is regulated.
BHRegulated:
BLRegulated:
Both outputs are active but only the High Power output is Regulated.
Both outputs are active but only the Low SSE output is Regulated.
response:
example:
affects:
none
output0:path high
Tunable laser modules with two outputs.
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
113
Download from Www.Somanuals.com. All Manuals Search And Download.
Measurement Operations & Settings
Signal Generation – The SOURce Subsystem
command:
:OUTPut[n][:CHANnel[m]]:PATH?
syntax:
:OUTPut[n][:CHANnel[m]]:PATH?
Returns the regulated path.
none
description:
parameters:
response:
HIGH:
LOWS:
BHR:
The High Power output is regulated.
The Low SSE output is regulated.
Both outputs are active but only the High Power output is Regulated.
Both outputs are active but only the Low SSE output is Regulated.
BLR:
example:
affects:
output0:path? → HIGH<END>
Tunable laser modules with two outputs.
command:
:OUTPut[n][:CHANnel[m]][:STATe]
syntax:
:OUTPut[n][:CHANnel[m]][:STATe]<wsp>OFF|ON|0|1
Switches the laser current off and on.
description:
The laser emits light only when the current is on. Set the state toOFF or 0 to switch the laser
current off. Set the state toON or 1 to switch the laser current on. The default is for the laser
current to be off.
For attenuator output see page 156
NOTE
parameters:
0 or OFF:
1 or ON:
switch laser current off
switch laser current on
response:
example:
affects:
none
outp 1
All laser sources, DFB sources, tunable laser modules and return loss modules with an inter-
nal source
command:
:OUTPut[n][:CHANnel[m]][:STATe]?
:OUTPut[n][:CHANnel[m]][:STATe]?
syntax:
description:
Queries the current state of the laser current.
For attenuator output see page 156
none
NOTE
parameters:
response:
A boolean value:
0 – laser current off
1 – laser current on
example:
affects:
outp? → 1<END>
All laser sources, DFB sources, tunable laser modules and return loss modules with an inter-
nal source
114
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
Signal Generation – The SOURce Subsystem
Measurement Operations & Settings
command:
[:SOURce[n]][:CHANnel[m]]:AM[:INTernal]:FREQuency[l]
[:SOURce[n]][:CHANnel[m]]:AM[:INTernal]:FREQuency[l]<wsp><frequency>
syntax:
[THZ|GHZ|MHZ|KHZ|HZ]
description:
parameters:
Sets the frequency of the amplitude modulation of the laser output.
The frequency as a float value in Hz.
Also allowed are: MIN: minimum programmable value
MAX: maximum programmable value
DEF: This is not the preset (*RST) default value but is half the sum of, the
minimum programmable value and the maximum programmable value
The default units are HZ, although KHZ, MHZ, GHZ, and THZ can also be specified.
The resolution of the frequency is always 1 Hz.
Use [l] to set the modulation frequency of the upper or lower wavelength laser source of a
dual-wavelength laser source or a return loss module with an internal dual-wavelength laser
source. The default value of [l] is 1, the lower wavelength source. The upper wavelength
source is denoted by 2.
NOTE
response:
example:
affects:
none
sour2:am:freq 270hz
All laser sources, DFB sources, and tunable laser modules
command:
[:SOURce[n]][:CHANnel[m]]:AM[:INTernal]:FREQuency[l]?
syntax:
[:SOURce[n]][:CHANnel[m]]:AM[:INTernal]:FREQuency[l]? [MIN|DEF|MAX]
Returns the frequency of the amplitude modulation as a float value in Hertz.
description:
parameters:
MIN: minimum modulation frequency
MAX: maximum modulation frequency
DEF: This is not the preset (*RST) default value but is half the sum of, the minimum modula-
tion frequency and the maximum modulation frequency.
Use [l] to query the modulation frequency of the upper or lower wavelength laser source of a
dual-wavelength laser source or a return loss module with an internal dual-wavelength laser
source. The default value of [l] is 1, the lower wavelength source. The upper wavelength
source is denoted by 2.
NOTE
response:
modulation frequency relevant to the current value or specified parameter (if MIN, MAX, or
DEF is chosen as a parameter).
example:
affects:
sour2:am:freq? min → +2.00000000E+002<END>
All laser sources, DFB sources, and tunable laser modules
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
115
Download from Www.Somanuals.com. All Manuals Search And Download.
Measurement Operations & Settings
Signal Generation – The SOURce Subsystem
command:
[:SOURce[n]][:CHANnel[m]]:AM:SOURce[l]
[:SOURce[n]][:CHANnel[m]]:AM:SOURce[l]<wsp>
syntax:
INT|INT1|INT2|COHC|AEXT|EXT|DEXT|WVLL|BACK|0|1|2|3|5|6
description:
parameters:
Selects the type or source of the modulation of the laser output.
0, INT1, or INTernal:
1, COHCtrl, or INT2:
2, AEXTernal, or EXT:
3 or DEXTernal:
internal digital modulation
coherence control
external analog modulation
external digital modulation
wavelength locking
5 or WVLLocking:
6 or BACKplane
:
external digital modulation using Input Trigger Connector
Use [l] to set the modulation source of the upper or lower wavelength laser source of a dual-
wavelength laser source or a return loss module with an internal dual-wavelength laser
source. The default value of [l] is 1, the lower wavelength source. The upper wavelength
source is denoted by 2.
NOTE
response:
example:
affects:
none
sour2:am:sour int
All laser sources, DFB sources, and tunable laser modules can use internal digital modula-
tion; as can return loss modules containing an internal source.
DFB source and tunable laser modules can use coherence control.
Other modulation modes are only available with tunable laser modules.
command:
[:SOURce[n]][:CHANnel[m]]:AM:SOURce[l]?
[:SOURce[n]][:CHANnel[m]]:AM:SOURce[l]?
Returns the type or source of the modulation of the laser output.
none
syntax:
description:
parameters:
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.
NOTE
response:
0:
1:
2:
3:
5:
6:
internal digital modulation
coherence control
external analog modulation
external digital modulation
wavelength locking
external digital modulation using Input Trigger Connector
example:
affects:
sour2:am:sour? → +0<END>
All laser sources, DFB sources, and tunable laser modules can use internal digital modula-
tion; as can return loss modules containing an internal source.
DFB source and tunable laser modules can use coherence control.
All other modulation modes are only available with tunable laser modules.
116
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
Signal Generation – The SOURce Subsystem
Measurement Operations & Settings
command:
[:SOURce[n]][:CHANnel[m]]:AM:STATe[l]
[:SOURce[n]][:CHANnel[m]]:AM:STATe[l]<wsp> OFF|ON|0|1
Enables and disables amplitude modulation of the laser output.
A boolean value: OFF or 0: amplitude modulation disabled (default)
ON or 1: amplitude modulation enabled.
syntax:
description:
parameters:
Use [l] to enable/disable amplitude modulation for the upper or lower wavelength laser
source of a dual-wavelength laser source or a return loss module with an internal dual-wave-
length laser source. The default value of [l] is 1, the lower wavelength source. The upper
wavelength source is denoted by 2.
NOTE
When the internal modulation is selected, the Modulation Output on the front panel outputs
a version of the modulating signal that has the same frequency and phase as the modulating
signal, but has a fixed, TTL-level amplitude. You can use this to synchronize your external
measuring equipment to your instrument.
NOTE
To allow for your possible synchronization requirements, there are two ways in which the
signal can be output. Either the signal is combined with the laser-ready signal, so that the
output is kept low when there is no optical signal being output (for example, while the laser
is settling after a change of wavelength). Or the modulation signal is output all the time. This
page 121).
When you enable lambda logging, see
NOTE
simultaneously, a sweep cannot be started, see
response:
none
example:
affects:
sour2:am:stat 0
All laser sources, DFB sources, tunable laser modules, and return loss modules containing
an internal source.
command:
[:SOURce[n]][:CHANnel[m]]:AM:STATe[l]?
[:SOURce[n]][:CHANnel[m]]:AM:STATe[l]?
Returns the current state of amplitude modulation.
syntax:
description:
Use [l] to query the current state of modulation of the upper or lower wavelength laser
source of a dual-wavelength laser source or a return loss module with an internal dual-wave-
length laser source. The default value of [l] is 1, the lower wavelength source. The upper
wavelength source is denoted by 2.
NOTE
parameters:
response:
none
A boolean value:
0: modulation is disabled
1: modulation is enabled
example:
affects:
sour2:am:stat? → 0<END>
All laser sources, DFB sources, tunable laser modules, and return loss modules containing
an internal source.
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
117
Download from Www.Somanuals.com. All Manuals Search And Download.
Measurement Operations & Settings
Signal Generation – The SOURce Subsystem
command:
[:SOURce[n]][:CHANnel[m]]:AM:COHCtrl:COHLevel[l]
syntax:
[:SOURce[n]][:CHANnel[m]]:AM:COHCtrl:COHLevel[l]<wsp><value>[MIN | MAX | DEF]
description:
Sets the level of coherence, when using coherence control, on an arbitrary scale from 1 to
99.98%. A 100% coherence level corresponds to maximum coherence length and minimum
linewidth. The coherence level required for a specific linewidth and coherence length can
vary between modules.
parameters:
The excursion level as a percentage of its maximum value.
Also allowed:
MIN: minimum programmable value (0%)
MAX: maximum programmable value (100%)
DEF: default preset (*RST) value.
response:
example:
affects:
none
source2:am:cohc 50
DFB sources and Agilent 81980A, 81940A, 81989A, 81949A
command:
[:SOURce[n]][:CHANnel[m]]:AM:COHCtrl:COHLevel[l]?
syntax:
[:SOURce[n]][:CHANnel[m]]:AM:COHCtrl:COHLevel[l]<wsp><value>?[MIN | MAX | DEF]
description:
Queries the current level of coherence, when using Coherence Control. Coherence is ex-
pressed on an arbitrary scale from 1 to 99.98%. A 100% coherence level corresponds to
maximum coherence length and minimum linewidth.
parameters:
Optional
MIN: returns the minimum programmable value (0%)
MAX: returns the maximum programmable value (100%)
DEF: returns the default preset (*RST) value.
response:
example:
affects:
Returns the currently set excursion level as a percentage between 0 and 99.98
source2:am:cohc? → 50<END>
DFB sources and Agilent 81980A, 81940A, 81989A, 81949A
command:
[:SOURce[n]][:CHANnel[m]]:FM:SOURce[l]
syntax:
[:SOURce[n]][:CHANnel[m]]:FM:SOURce[l]<wsp>SBSCtrl|0
description:
Selects the type of the frequency modulation of the laser output.
Currently, only parameter strings that select SBS Control are valid.
Enable frequency modulation before issuing this command.
parameters:
0, SBSCtrl
Simulated Brillouin Scattering
SBSCtrl (Simulated Brillouin Scattering) Control modulation suppresses SBS effects within
high-power measurement setups.
NOTE
response:
example:
affects:
none
sour2:fm:sour SBSC
Agilent 81980A, 81940A, 81989A, 81949A compact tunable lasers.
118
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
Signal Generation – The SOURce Subsystem
Measurement Operations & Settings
command:
[:SOURce[n]][:CHANnel[m]]:FM:SOURce[l]?
syntax:
[:SOURce[n]][:CHANnel[m]]:FM:SOURce[l]?
description:
Queries the type of frequency modulation currently set.
Currently, only SBS Control is available.
parameters:
response:
example:
affects:
none
0
SBS Control
sour2:fm:sour? → +0<END>
Agilent 81980A, 81940A, 81989A, 81949A compact tunable lasers.
command:
[:SOURce[n]][:CHANnel[m]]:FM:STATe[l]
syntax:
[:SOURce[n]][:CHANnel[m]]:FM:STATe[l]<wsp>OFF|ON|0|1
Enables and disables frequency modulation of the laser output.
description:
parameters:
A boolean value:
OFF or 0: disable frequency modulation
ON or 1: enable frequency modulation.
response:
example:
affects:
none
sour2:fm:state 1
Agilent 81980A, 81940A, 81989A, 81949A compact tunable lasers.
command:
[:SOURce[n]][:CHANnel[m]]:FM:STATe[l]?
[:SOURce[n]][:CHANnel[m]]:FM:STATe[l]?
Queries the current state of frequency modulation of the laser output.
none
syntax:
description:
parameters:
response:
A boolean value:
0: frequency modulation is disabled
1: frequency modulation is enabled.
example:
affects:
sour2:fm:state? → +1<END>
Agilent 81980A, 81940A, 81989A, 81949A compact tunable lasers.
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
119
Download from Www.Somanuals.com. All Manuals Search And Download.
Measurement Operations & Settings
Signal Generation – The SOURce Subsystem
command:
[:SOURce[n]][:CHANnel[m]]:FM:SBSCtrl:FREQuency[l]
[:SOURce[n]][:CHANnel[m]]:FM:SBSCtrl:FREQuency[l]<wsp><frequency>
syntax:
[MHZ|KHZ|HZ|MIN|MAX|DEF]
description:
Sets the frequency of the SBS Control modulation.
Enable frequency modulation before issuing this command.
parameters:
The modulation frequency as a float value.
The default units are HZ, although KHZ, MHZ, GHZ and THZ can also be specified.
Also allowed are:
MIN: minimum programmable value
MAX: maximum programmable value
DEF: default preset (*RST) value.
response:
example:
affects:
none
sour2:fm:sbsc:freq 4000Hz
Agilent 81980A, 81940A, 81989A, 81949A compact tunable lasers.
command:
[:SOURce[n]][:CHANnel[m]]:FM:SBSCtrl:FREQuency[l]?
syntax:
[:SOURce[n]][:CHANnel[m]]:FM:SBSCtrl:FREQuency[l]?<wsp>[MIN|MAX|DEF]
Queries the currently set frequency of the SBS Control modulation.
description:
parameters:
Optional
MIN: returns the minimum programmable value
MAX: returns the maximum programmable value
DEF: returns the default preset (*RST) value.
response:
example:
affects:
The modulation frequency in Hz as a float value
sour2:fm:freq? → +4.00000E+03<END>
Agilent 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.
parameters:
The excursion level as a percentage of its maximum value.
Also allowed:
MIN: minimum programmable value (0%)
MAX: maximum programmable value (100%)
DEF: default preset (*RST) value.
response:
example:
affects:
none
sour2:fm:sbsc:lev 80
Agilent 81980A, 81940A, 81989A, 81949A compact tunable lasers.
120
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
Signal Generation – The SOURce Subsystem
Measurement Operations & Settings
command:
[:SOURce[n]][:CHANnel[m]]:FM:SBSCtrl:Level[l]?
[:SOURce[n]][:CHANnel[m]]:FM:SBSCtrl:LEVel[l]?<wsp>[MIN|MAX|DEF]
Queries the currently set excursion level of the SBS Control frequency modulation.
syntax:
description:
parameters:
Optional
MIN: returns the minimum programmable value (0%)
MAX: returns the maximum programmable value (100%)
DEF: returns the default preset (*RST) value.
response:
example:
affects:
Returns the currently set excursion level as a percentage of its maximum value.
sour2:fm:sbsc:lev? → +8.000E+01<END>
Agilent 81980A, 81940A, 81989A, 81949A compact tunable lasers.
command:
[:SOURce[n]][:CHANnel[m]]:MODout
syntax:
[:SOURce[n]][:CHANnel[m]]:MODout<wsp>FRQ|FRQRDY|0|1
description:
Sets the modulation output mode of the BNC connector on the front panel of tunable laser
modules.
parameters:
FRQ or 0:
modulation signal is output all the time
FRQRDY or 1:
modulation is combined with the laser-ready signal.
In this case, the output is kept low when no optical signal is output (for
example, while the laser is settling after a change of wavelength).
response:
example:
affects:
none
sour0:mod 0
All tunable laser sources with BNC ouput connector.
command:
[:SOURce[n]][:CHANnel[m]]:MODout?
[:SOURce[n]][:CHANnel[m]]:MODout?
syntax:
description:
Queries the modulation output mode of the BNC connector on the front panel of tunable la-
ser modules.
parameters:
response:
none
0: modulation signal is output all the time
1: modulation is combined with the laser-ready signal.
In this case, the output is kept low when no optical signal is output (for example, while
the laser is settling after a change of wavelength).
example:
affects:
sour0:mod? → 0<END>
All tunable laser sources with BNC output connector.
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
121
Download from Www.Somanuals.com. All Manuals Search And Download.
Measurement Operations & Settings
Signal Generation – The SOURce Subsystem
command:
[:SOURce[n]][:CHANnel[m]]:POWer:ATTenuation[l]
[:SOURce[n]][:CHANnel[m]]:POWer:ATTenuation[l]<wsp><value>[DB|MDB]
syntax:
description:
parameters:
Sets the level of attenuation.
Any value in the specified range (see the specifications in the appropriate User’s Guide).
Also allowed (for MIN: minimum programmable value
tunable laser
MAX: maximum programmable value
modules only)
DEF: This is not the preset (*RST) default value but is half the sum of, the
are:
minimum programmable value and the maximum programmable value
Use [l] to set the attenuation level of the upper or lower wavelength laser source of a dual-
wavelength laser source or of a return loss module with an internal dual-wavelength laser
source. The default value of [l] is 1, the lower wavelength source. The upper wavelength
source is denoted by 2.
NOTE
Tunable laser modules with in-built optical attenuators need to be in Manual Attenuation
value to have an affect. The output power is a combination of this value and the laser output
page 124).
NOTE
NOTE
In this respect, this command does not conform to the SCPI standard. The SCPI standard re-
quires that entering an explicit value for the attenuation switches the attenuation mode OFF.
The default units are dB.
response:
none
example:
affects:
sour0:pow:att 22.32db
All tunable laser modules with an built-in optical attenuator, and all laser source modules.
command:
[:SOURce[n]][:CHANnel[m]]:POWer:ATTenuation[l]?
[:SOURce[n]][:CHANnel[m]]:POWer:ATTenuation[l]?[MIN|DEF|MAX]
Queries the attenuation level.
syntax:
description:
When using a tunable laser module with a built-in optical attenuator, the value returned ap-
plies only to the attenuation mode (see
Use [l] to query the attenuation level of the upper or lower wavelength laser source of a dual-
wavelength laser source or of a return loss module with an internal dual-wavelength laser
source. The default value of [l] is 1, the lower wavelength source. The upper wavelength
source is denoted by 2.
NOTE
parameters:
Also allowed (for MIN: minimum amplitude level
tunable laser mod-
MAX: maximum amplitude level
ules 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
response:
attenuation level relevant to the current value or specified parameter (if MIN, MAX, or DEF
are chosen as a parameter).
example:
affects:
sour0:pow:att? def → +3.10000000+E001<END>
All tunable laser modules with an in-built optical attenuator, and all laser source modules.
122
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
Signal Generation – The SOURce Subsystem
Measurement Operations & Settings
command:
[:SOURce[n]][:CHANnel[m]]:POWer:ATTenuation[l]:AUTO
[:SOURce[n]][:CHANnel[m]]:POWer:ATTenuation[l]:AUTO<wsp>OFF|ON|0|1
syntax:
description:
Selects Automatic or Manual Attenuation Mode.
In Automatic Attenuation Mode, you specify the output power.
In Manual Attenuation Mode, you must specify both the laser output power, and the attenu-
ation level.
parameters:
OFF or 0:
Attenuation Mode
Power Mode
ON or 1:
response:
example:
affects:
none
sour0:pow:att:auto 1
All tunable laser sources with a built-in optical attenuator.
command:
[:SOURce[n]][:CHANnel[m]]:POWer:ATTenuation[l]:AUTO?
[:SOURce[n]][:CHANnel[m]]:POWer:ATTenuation[l]:AUTO?
Queries whether the instrument is in Automatic or Manual Attenuation Mode.
none
syntax:
description:
parameters:
response:
0: Manual Attenuation Mode
1: Automatic Attenuation Mode
example:
affects:
sour0:pow:att:auto? → 1<END>
All tunable laser modules with a built-in optical attenuator.
command:
[:SOURce[n]][:CHANnel[m]]:POWer:ATTenuation[l]:DARK
[:SOURce[n]][:CHANnel[m]]:POWer:ATTenuation[l]:DARK<wsp>OFF|ON|0|1
Sets or unsets the attenuator to ‘dark’ position.
syntax:
description:
Dark position blocks all light from the laser. You can use this as an alternative to disabling
the laser, the advantage of doing this is that you avoid the laser rise time.
This command is available in Attenuation Mode Only.
parameters:
OFF or 0:
Unsets dark position
Sets dark position
ON or 1:
response:
example:
affects:
none
sour0:pow:att:dark 1
All tunable laser modules with a built-in optical attenuator.
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
123
Download from Www.Somanuals.com. All Manuals Search And Download.
Measurement Operations & Settings
Signal Generation – The SOURce Subsystem
command:
[:SOURce[n]][:CHANnel[m]]:POWer:ATTenuation[l]:DARK?
[:SOURce[n]][:CHANnel[m]]:POWer:ATTenuation[l]:DARK?
syntax:
description:
Queries whether the attenuator is set to ‘dark’ position (where all light is blocked by the la-
ser).
parameters:
response:
none
0: dark position not set
1: dark position set
example:
affects:
sour0:pow:att:dark? → 1<END>
All tunable laser modules with a built-in optical attenuator.
command:
syntax:
[:SOURce[n]][:CHANnel[m]]:POWer[:LEVel][:IMMediate][:AMPLitude[l]]
[:SOURce[n]][:CHANnel[m]]:POWer[:LEVel][:IMMediate][:AMPLitude[l]]<wsp><value>
[PW|NW|UW|MW|Watt|DBM]
description:
Sets the power of the laser output.
If an optical attenuator is installed, the power value returned is dependent on whether you
are using power or attenuation mode (see
NOTE
If you are using power mode, the value returned is the output power.
If you are using attenuation mode, the value returned is the laser output power, and you must
also use the attenuation value to calculate the output power (see
The values for the output power that you set in the Power Mode, and the laser output power
that you set in the Attenuation Mode, are stored and used independently.
The instrument may not be able to output a signal with the maximum programmable power, it
will output a signal with the maximum power. Use the
NOTE
query the power being output.
The default units are DBM or W, depending on the unit selected using the following com-
parameters:
Any value in the specified range (see the appropriate User’s Guide).
Also allowed are:
MIN: minimum programmable value
MAX: maximum programmable value
DEF: This is not the preset (*RST) default value, but is the maximum
programmable level
Use [l] to set the amplitude level of the output power of the upper or lower wavelength laser
source of a dual-wavelength laser source or a return loss module with an internal dual-wave-
length laser source. The default value of [l] is 1, the lower wavelength source. The upper
wavelength source is denoted by 2.
NOTE
response:
none
example:
affects:
sour2:pow 23uW
All tunable laser and DFB source modules
124
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
Signal Generation – The SOURce Subsystem
Measurement Operations & Settings
command:
[:SOURce[n]][:CHANnel[m]]:POWer[:LEVel][:IMMediate][:AMPLitude[l]]?
[:SOURce[n]][:CHANnel[m]]:POWer[:LEVel][:IMMediate][:AMPLitude[l]]?<wsp>
syntax:
[MIN|DEF|MAX]
description:
Returns the amplitude level of the output power.
The value returned is the actual amplitude that is output, which may be different from the val-
ue set for the output. If these two figures are not the same, it is indicated in the :STATus:OP-
ERation register.
If an optical attenuator is installed, the power value returned is dependent on whether you
are using power or attenuation mode (see
NOTE
If you are using power mode, the value returned is the output power.
If you are using attenuation mode, the value returned is the laser output power, and you must
also use the attenuation value to calculate the output power (see
The values for the output power that you set in the Power Mode, and the laser output power
that you set in the Attenuation Mode, are stored and used independently.
parameters:
Also allowed
(for tunable laser mod-
ules only) are:
MIN: minimum amplitude level
MAX: maximum amplitude level
DEF: This is not the preset (*RST) default value but is half the sum of,
the minimum amplitude level and the maximum amplitude level
Use [l] to query the amplitude level of the output power of the upper or lower wavelength la-
ser source of a dual-wavelength laser source or a return loss module with an internal dual-
wavelength laser source. The default value of [l] is 1, the lower wavelength source. The upper
wavelength source is denoted by 2.
NOTE
response:
Amplitude level relevant to the current value or specified parameter (if MIN, MAX, or DEF are
chosen as a parameter).
example:
affects:
sour2:pow? → +8.00000000E-004<END>
All laser sources, DFB sources, and tunable laser modules and return loss modules with an
internal source
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
125
Download from Www.Somanuals.com. All Manuals Search And Download.
Measurement Operations & Settings
Signal Generation – The SOURce Subsystem
command:
[:SOURce[n]][:CHANnel[m]]:POWer[:LEVel]:RISetime[l]
syntax:
[:SOURce[n]][:CHANnel[m]]:POWer[:LEVel]:RISetime[l]<wsp><value>[NS|US|MS|S]
Sets the laser rise time of the chosen source.
description:
parameters:
Any value in the specified range (see the appropriate User’s Guide).
Also allowed are:
MIN: minimum programmable value
MAX: maximum programmable value
DEF: This is not the preset (*RST) default value but is half the
sum of, the minimum programmable level and the maximum pro-
grammable level
Use [l] to set the risetime 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 de-
fault value of [l] is 1, the lower wavelength source. The upper wavelength source is denoted
by 2.
NOTE
response:
example:
affects:
none
sour2:pow:ris 10ns
All laser sources, DFB sources, and tunable laser modules and return loss modules with an
internal source
command:
[:SOURce[n]][:CHANnel[m]]:POWer[:LEVel]:RISetime[l]?
[:SOURce[n]][:CHANnel[m]]:POWer[:LEVel]:RISetime[l]?<wsp>[MIN|DEF|MAX]
Returns the laser rise time of the chosen source.
syntax:
description:
parameters:
Also allowed are:
MIN: minimum programmable value
MAX: maximum programmable value
DEF: This is not the preset (*RST) default value but is half the
sum of, the minimum programmable level and the maximum pro-
grammable level
Use [l] to query the risetime of the upper or lower wavelength laser source of a dual-wave-
length laser source or a return loss module with an internal dual-wavelength laser source.
The default value of [l] is 1, the lower wavelength source. The upper wavelength source is
denoted by 2.
NOTE
response:
example:
affects:
The rise time as a float value in seconds.
sour2:pow:ris? → +1.00000000E-009<END>
All laser sources, DFB sources, and tunable laser modules and return loss modules with an
internal source
126
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
Signal Generation – The SOURce Subsystem
Measurement Operations & Settings
command:
[:SOURce[n]][:CHANnel[m]]:POWer:STATe
syntax:
[:SOURce[n]][:CHANnel[m]]:POWer:STATe<wsp><boolean>
description:
parameters:
Switches the laser of the chosen source on or off.
A boolean value:
0: Laser Off
1: Laser On
response:
example:
affects:
none
sour2:pow:stat 1
All laser source, DFB source, and tunable laser modules and return loss modules with an in-
ternal source
command:
[:SOURce[n]][:CHANnel[m]]:POWer:STATe?
[:SOURce[n]][:CHANnel[m]]:POWer:STATe?
Queries the laser state of the chosen source.
none
syntax:
description:
parameters:
response:
A boolean value:
0: Laser Off
1: Laser On
example:
affects:
sour2:pow:stat? → 1<END>
All laser source, DFB source, and tunable laser modules and return loss modules with an in-
ternal source
command:
[:SOURce[n]][:CHANnel[m]]:POWer:UNIT
[:SOURce[n]][:CHANnel[m]]:POWer:UNIT<wsp>DBM|0|Watt|1
Sets the power units
syntax:
description:
parameters:
0 or DBM:
1 or W:
dBm (default)
Watts
response:
example:
affects:
none
sour2:pow:unit w
All tunable laser and DFB source modules
command:
[:SOURce[n]][:CHANnel[m]]:POWer:UNIT?
[:SOURce[n]][:CHANnel[m]]:POWer:UNIT?
Return the current power units
syntax:
description:
parameters:
0: dBm
1: Watts
response:
example:
affects:
none
sour2:pow:unit? → +0<END>
All tunable laser and DFB source modules
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
127
Download from Www.Somanuals.com. All Manuals Search And Download.
Measurement Operations & Settings
Signal Generation – The SOURce Subsystem
command:
[:SOURce[n]][:CHANnel[m]]:POWer:WAVelength
[:SOURce[n]][:CHANnel[m]:POWer:WAVelength[<wsp>
syntax:
EXTernal|LOWer|UPPer|BOTH|0|1|2|3]
For compatibility reasons, WAVelength may be replaced with WAVE.
Sets the wavelength source for a dual-wavelength laser source.
NOTE
description:
parameters:
EXTernal: or 0
LOWer: or 1
UPPer: or 2
External
The lower wavelength source
The upper wavelength source
Both wavelength sources
BOTH: or 3
none
response:
example:
affects:
sour2:pow:wav upp
All dual-wavelength laser source modules and return loss modules with two internal sourc-
es
command:
syntax:
[:SOURce[n]][:CHANnel[m]]:POWer:WAVelength?
[:SOURce[n]][:CHANnel[m]:POWer:WAVelength?
For compatibility reasons, WAVelength may be replaced with WAVE.
Returns the wavelength source for a dual-wavelength laser source.
none
NOTE
description:
parameters:
response:
LOW
UPP
The lower wavelength source
The upper wavelength source
Both wavelength sources
BOTH
example:
affects:
sour2:pow:wav? → LOW<END>
All dual-wavelength laser source modules and return loss modules with two internal sourc-
es
128
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
Signal Generation – The SOURce Subsystem
Measurement Operations & Settings
command:
[:SOURce[n]][:CHANnel[m]]:READout:DATA?
[:SOURce[n]][:CHANnel[m]:READout:DATA?
syntax:
description:
Returns the data as a binary stream from either a lambda logging operation or the maximum
power the laser can produce at each wavelength.
parameters:
LLOGging:
Returns a binary stream that contains each wavelength step of the lambda
logging operation, see
Each binary block is an 8-byte long double in Intel byte order.
PMAX:
Returns a binary stream that contains the maximum power the laser can pro-
duce at each wavelength. Each binary block is a 8-byte long double (the
wavelength value) followed by a 4-byte long float (the power value). The
stream is in Intel byte order.
response:
example:
affects:
A binary stream in Intel byte order.
sour2:read:data? llog → the data as a binary stream
All tunable laser and DFB source modules
command:
syntax:
[:SOURce[n]][:CHANnel[m]]:READout:DATA:BLOCk?
[:SOURce[n]][:CHANnel[m]:READout:DATA:BLOCk?<wsp>LLOGging|PMAX,<offset>,<# of
data points>
description:
parameters:
Returns a specified binary block from either a lambda logging operation, or maximum power
at wavelength characteristic.
LLOGging:
Returns the data block from lambda logging. The binary block is an 8-
byte long double in Intel byte order.
PMAX:
Returns the data block from the power curve characteristic. Each binary
block is a 8-byte long double (the wavelength value) followed by a 4-
byte long float (the power value). The stream is in Intel byte order.
<offset>
A zero based offset that specifies the index of the first value within the
block to be transferred.
<# of data points> The number of points (not bytes!) in the transferred block.
A binary stream in Intel byte order.
response:
example:
affects:
sour0:read:data:block? llog,100,20000 → the data as a binary stream
All tunable laser and DFB source modules
command:
[:SOURce[n]][:CHANnel[m]]:READout:DATA:MAXBlocksize?
[:SOURce[n]][:CHANnel[m]:READout:DATA:MAXBlocksize?
syntax:
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]]:READ-
out:DATA:BLOCk? instead of SOURce[n]][:CHANnel[m]]:READout:DATA?
parameters:
response:
example:
affects:
none
The maximum number of data points (not bytes!) in the transferred block, as an integer value.
sour0:read:data:maxb? → 120<END>
All tunable laser and DFB source modules
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
129
Download from Www.Somanuals.com. All Manuals Search And Download.
Measurement Operations & Settings
Signal Generation – The SOURce Subsystem
command:
[:SOURce[n]][:CHANnel[m]]:READout:POINts?
[:SOURce[n]][:CHANnel[m]:READout:POINts?<wsp>LLOGging|PMAX
syntax:
description:
Returns the number of datapoints that the [:SOURce[n]][:CHANnel[m]]:READout:DATA? com-
mand will return.
parameters:
LLOGging:
Returns the number of wavelength steps for a lambda logging operation, see
Returns the number of datapoints (each datapoint contains a value for wave-
length and power) the [:SOURce[n]][:CHANnel[m]]:READout:DATA? PMAX
command will return, number of datapoints depends on the calibration data
for your module.
PMAX:
response:
example:
affects:
The number of datapoints as an integer value.
sour2:read:poin? pmax → 120<END>
All tunable laser and DFB source modules
command:
syntax:
[:SOURce[n]][:CHANnel[m]]:WAVelength[:CW[l]:FIXED[l]]
[:SOURce[n]][:CHANnel[m]]:WAVelength[:CW[l]:FIXED[l]]<wsp><value>
[PM|NM|UM|MM|M]
description:
parameters:
Sets the absolute wavelength of the output.
Any wavelength in the specified range (see the specifications in the appropriate User’s
Guide).
The programmable range is larger than the range specified in the User’s Guide. The program-
mable range is set individually for each instrument when it is calibrated during production.
Also allowed are:
MIN: minimum wavelength value
MAX: maximum wavelength value
DEF: This is not the preset (*RST) default value but is half the sum
of, the minimum wavelength value and the maximum wavelength
value
Use [l] to set the upper or lower wavelength laser source of a dual-wavelength laser source.
The default value of [l] is 1, the lower wavelength source. The upper wavelength source is
denoted by 2.
NOTE
response:
example:
affects:
none
sour2:wav 1550NM
All tunable laser and DFB source modules
130
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
Signal Generation – The SOURce Subsystem
Measurement Operations & Settings
command:
[:SOURce[n]][:CHANnel[m]]:WAVelength[:CW[l]|:FIXED[l]]?
syntax:
[:SOURce[n]][:CHANnel[m]:WAVelength[:CW[l]|:FIXED[l]]?[<wsp>[MIN|DEF|MAX]
Returns the wavelength value in meters.
description:
parameters:
none
Also allowed, for tunable laser MIN: minimum wavelength
modules only, are
MAX: maximum wavelength
DEF: This is not the preset (*RST) default value but is half
the sum of, the minimum wavelength value and the maxi-
mum wavelength value
Use [l] to query the upper or lower wavelength laser source of a dual-wavelength laser
source. The default value of [l] is 1, the lower wavelength source. The upper wavelength
source is denoted by 2.
NOTE
response:
example:
The wavelength as a float value in meters.
sour0:wav? → +1.5672030E-006<END>
Returns the current wave-
length value for a tunable la-
ser module.
sour0:wav? min → +1.5500000E-006<END>
sour2:wav:fixed2? → +1.61544494E-006<END>
Returns minimum wave-
length for a tunable laser
module.
Returns the wavelength val-
ue of the upper wavelength
source of a dual-wavelength
laser source.
affects:
All laser source, DFB source, and tunable laser modules and return loss modules with an in-
ternal source
command:
[:SOURce[n]][:CHANnel[m]]:WAVelength:CORRection:ARA
syntax:
[:SOURce[n]][:CHANnel[m]]:WAVelength:CORRection:ARA
description:
parameters:
response:
example:
affects:
Realigns the laser cavity.
none
none
sour0:wav:corr:ara
All tunable laser modules except Agilent 81649A and Agilent 81689A/B
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
131
Download from Www.Somanuals.com. All Manuals Search And Download.
Measurement Operations & Settings
Signal Generation – The SOURce Subsystem
command:
[:SOURce[n]][:CHANnel[m]]:WAVelength:CORRection:ARA:ALL
[:SOURce[n]][:CHANnel[m]]:WAVelength:CORRection:ARA:ALL
syntax:
description:
parameters:
response:
example:
affects:
Realigns the laser cavity of every tunable laser source in a mainframe.
none
none
sour0:wav:corr:ara:all
All tunable laser modules except Agilent 81649A and Agilent 81689A/B
command:
[:SOURce[n]][:CHANnel[m]]:WAVelength:CORRection:AUTocalib
syntax:
[:SOURce[n]][:CHANnel[m]]:WAVelength:CORRection:AUTocalib<wsp>ON (1) | OFF (0)
description:
Sets the Auto Calibration feature On or OFF. Switching it OFF enables the TLS to operate for
a long period without interruption from the "auto lambda zeroing" or settling. When Auto
Calibration is disabled, it is possible to operate the TLS at a temperature that differs more
than 4.4 K from the last Lambda Zeroing temperature. In this case, the accuracy and wave-
length performance of the TLS can become less optimal due to temperature variation. The
relevent accuracy class is indicated on the user interface when Auto Calibration is off.
parameters:
a boolean value: 1 or ON: enable Autocalibration
0 or OFF: disable Autocalibration
response:
example:
affects:
none
sour0:wav:corr:aut 0
All tunable laser modules except Agilent 81649A, 81689A/B and Agilent 81980A, 81940A,
81989A, 81949A.
command:
[:SOURce[n]][:CHANnel[m]]:WAVelength:CORRection:AUTocalib?
[:SOURce[n]][:CHANnel[m]]:WAVelength:CORRection:AUTocalib?
Returns whether Autocalibration is enabled or disabled
none
syntax:
description:
parameters:
response:
0 Autocalibration disabled
1 Autocalibration enabled
example:
affects:
sour0:wav:corr:aut? → 1
All tunable laser modules except Agilent 81649A, 81689A/B and Agilent 81980A, 81940A,
81989A, 81949A.
132
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
Signal Generation – The SOURce Subsystem
Measurement Operations & Settings
command:
[:SOURce[n]][:CHANnel[m]]:WAVelength:CORRection:ZERO
syntax:
[:SOURce[n]][:CHANnel[m]]:WAVelength:CORRection:ZERO
description:
parameters:
response:
example:
affects:
Executes a wavelength zero.
none
none
sour2:wav:corr:zero
All tunable laser modules except Agilent 81649A and Agilent 81689A/B
command:
[:SOURce[n]][:CHANnel[m]]:WAVelength:CORRection:ZERO:ALL
syntax:
[:SOURce[n]][:CHANnel[m]]:WAVelength:CORRection:ZERO:ALL
description:
parameters:
response:
example:
affects:
Executes a wavelength zero on every tunable laser source in a mainframe.
none
none
sour2:wav:corr:zero:all
All tunable laser modules except Agilent 81649A and Agilent 81689A/B
command:
[:SOURce[n]][:CHANnel[m]]:WAVelength:CORRection:ZERO:TEMPerature:ACTual?
[:SOURce[n]][:CHANnel[m]]:WAVelength:CORRection:ZERO:TEMPerature:ACTual?
Reports the current lambda zero tempearture.
syntax:
description:
parameters:
response:
example:
affects:
none
float value; temperature in °C
sour0:wav:corr:zero:temp:act?
All tunable laser modules except Agilent 81649A, Agilent 81689A/B and 819xxA/B
command:
[:SOURce[n]][:CHANnel[m]]:WAVelength:CORRection:ZERO:TEMPerature:DIFFerence?
[:SOURce[n]][:CHANnel[m]]:WAVelength:CORRection:ZERO:TEMPerature:Difference?
Reports the temperature difference required to trigger an auto lamda zero.
none
syntax:
description:
parameters:
response:
example:
affects:
float value; temperature in °C
sour0:wav:corr:zero:temp:diff?
All tunable laser modules except Agilent 81649A, Agilent 81689A/B and 819xxA/B
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
133
Download from Www.Somanuals.com. All Manuals Search And Download.
Measurement Operations & Settings
Signal Generation – The SOURce Subsystem
command:
[:SOURce[n]][:CHANnel[m]]:WAVelength:CORRection:ZERO:TEMPerature:LASTzero?
[:SOURce[n]][:CHANnel[m]]:WAVelength:CORRection:ZERO:TEMPerature:LASTzero?
Reports the temperature at which the last auto lamda zero took place.
none
syntax:
description:
parameters:
response:
example:
affects:
float value; temperature in °C
sour0:wav:corr:zero:temp:last?
All tunable laser modules except Agilent 81649A, Agilent 81689A/B and 819xxA/B
command:
[:SOURce[n]][:CHANnel[m]]:WAVelength:CORRection:ZERO:AUTO
[:SOURce[n]][:CHANnel[m]]:WAVelength:CORRection:ZERO:AUTO
syntax:
description:
Forces an auto lamda zero. This is quicker but a little less accurate than the equilavent manual
process because some checks are omitted:
parameters:
response:
example:
affects:
none
none
sour0:wav:corr:zero:auto
All tunable laser modules except Agilent 81649A, Agilent 81689A/B and 819xxA/B
command:
syntax:
[:SOURce[n]][:CHANnel[m]]:WAVelength:FREQuency[l]
[:SOURce[n]][:CHANnel[m]]:WAVelength:FREQuency[l]<wsp><value>
[THZ|GHZ|MHZ|KHZ|HZ]
description:
Sets the frequency difference used to calculate a relative wavelength. The output wave-
length is made up of the reference wavelength and this frequency difference.
The default units for frequency are Hertz.
The output wavelength (λ) is set from the base wavelength (λ ) and the frequency offset
0
(df). The formula for calculating the output wavelength is:
(c)
((λodf) + c)
λ =
λo
---------------------------------
8
-1
where c is the speed of light in a vacuum (2.990 x 10 ms )
Use [l] to set the frequency of the upper or lower wavelength laser source of a dual-wave-
length laser source or a return loss module with an internal dual-wavelength laser source.
The default value of [l] is 1, the lower wavelength source. The upper wavelength source is
denoted by 2.
NOTE
parameters:
response:
example:
affects:
The frequency difference is a float value in Hz.
none
sour0:wav:freq -10THZ
All tunable laser sources
134
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
Signal Generation – The SOURce Subsystem
Measurement Operations & Settings
command:
[:SOURce[n]][:CHANnel[m]]:WAVelength:FREQuency[l]?
[:SOURce[n]][:CHANnel[m]]:WAVelength:FREQuency[l]?
syntax:
description:
Returns the frequency difference used to calculate a relative wavelength.
Use [l] to query the frequency of the upper or lower wavelength laser source of a dual-wave-
length laser source or a return loss module with an internal dual-wavelength laser source.
The default value of [l] is 1, the lower wavelength source. The upper wavelength source is
denoted by 2.
NOTE
parameters:
response:
example:
affects:
none
Returns the frequency difference as a float value in Hz.
wav:freq? → -1.00000000E+013<END>
All tunable laser sources
command:
[:SOURce[n]][:CHANnel[m]]:WAVelength:REFerence[l]?
[:SOURce[n]][:CHANnel[m]]:WAVelength:REFerence[l]?
syntax:
description:
parameters:
response:
example:
affects:
Returns the reference wavelength (λ ).
0
none
The wavelength as a float value in meters.
sour2:wav:ref? → +1.5500000E-006<END>
All tunable laser and DFB modules
command:
[:SOURce[n]][:CHANnel[m]]:WAVelength:REFerence:DISPlay
[:SOURce[n]][:CHANnel[m]]:WAVelength:REFerence:DISPlay
syntax:
description:
Sets the reference wavelength to the value of the output wavelength (λ → λ ), that is, sets
0
the frequency offset (df) to zero.
parameters:
response:
example:
affects:
none
none
sour2:wav:ref:disp
All tunable laser and DFB modules
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
135
Download from Www.Somanuals.com. All Manuals Search And Download.
Measurement Operations & Settings
Signal Generation – The SOURce Subsystem
command:
[:SOURce[n]][:CHANnel[m]]:WAVelength:SWEep:CHECkparams?
[:SOURce[n]][:CHANnel[m]]:WAVelength:SWEep:CHECkparams?
syntax:
description:
Returns whether the currently set sweep parameters (sweep mode, sweep start, stop, width,
etc.) are consistent. If there is a sweep configuration problem, the laser source is not able to
pass a wavelength sweep.
parameters:
response:
none
A string with a detailed description of a configuration problem, or "OK" if the sweep os con-
figured correctly. The responses shown below are all the possible configuration problem
strings:
Description
Message
start wavelength must be smaller than stop wavelength
368,LambdaStop
<=LambdaStart
the total time of the sweep is too small
the total time of the sweep is too large
369,sweepTime < min
370,sweepTime > max
371,triggerFreq > max
the trigger frequency (calculated from sweep speed divided by sweep step) is
too large
step size too small
372,step < min
the number of triggers exceeds the allowed limit
373,triggerNum > max
The only allowed modulation source with the lambda logging function is
coherence control.
374,LambdaLogging = On
AND Modulation = On
AND ModulationSource!
= CoherenceControl
lambda logging only works "Step Finished" output trigger configuration
375,LambdaLogging = On
AND TriggerOut! =
StepFinished
lambda logging can only be done in continuous sweep mode
the step size must be a multiple of the smallest possible step size
the number of triggers exceeds the allowed limit
376,Lambda logging in
stepped mode
377,step not multiple of
<x>
378, triggerFreq < min
example:
affects:
sour0:wav:swe:chec? → "triggerNum > max"
All tunable laser modules except Agilent 81649A and Agilent 81689A/B
136
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
Signal Generation – The SOURce Subsystem
Measurement Operations & Settings
command:
[:SOURce[n]][:CHANnel[m]]:WAVelength:SWEep:CYCLes
[:SOURce[n]][:CHANnel[m]]:WAVelength:SWEep:CYCLes<wsp>
syntax:
<value>|MIN|MAX|DEF|0
description:
Sets the number of cycles.
Cannot be set while a sweep is running.
The number of cycles is an integer value.
NOTE
parameters:
Also allowed are:
MIN: minimum programmable value
MAX: maximum programmable value
DEF: This is not the preset (*RST) default value but is half the
sum of, the minimum programmable value and the maximum
programmable value
0: cycles continuously.
response:
example:
affects:
none
wav:swe:cycl 3
All tunable laser modules
command:
syntax:
[:SOURce[n]][:CHANnel[m]]:WAVelength:SWEep:CYCLes?
[:SOURce[n]][:CHANnel[m]]:WAVelength:SWEep:CYCLes?
[<wsp>MIN|MAX|DEF]
description:
parameters:
Returns the number of cycles.
none
Also allowed are:
MIN: minimum programmable value
MAX: maximum programmable value
DEF: This is not the preset (*RST) default value but is half the
sum of, the minimum programmable value and the maximum
programmable value
response:
example:
affects:
The number of cycles as an integer value.
wav:swe:cycl? → +3<END>
All tunable laser modules
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
137
Download from Www.Somanuals.com. All Manuals Search And Download.
Measurement Operations & Settings
Signal Generation – The SOURce Subsystem
command:
[:SOURce[n]][:CHANnel[m]]:WAVelength:SWEep:DWELl
[:SOURce[n]][:CHANnel[m]]:WAVelength:SWEep:DWELl<wsp>
syntax:
<value>|MIN|MAX|DEF[NS|US|MS|S]
description:
Sets the dwell time. Can only be used when sweep is stepped.
Cannot be set while a sweep is running.
NOTE
parameters:
The dwell time as a float value.
If you specify no units in your command, seconds are used as the default.
Also allowed are: MIN: minimum programmable value
MAX: maximum programmable value
DEF: This is not the preset (*RST) default value but is half the sum of, the
minimum programmable value and the maximum programmable value
response:
example:
affects:
none
wav:swe:dwel 500ms
All tunable laser modules
command:
[:SOURce[n]][:CHANnel[m]]:WAVelength:SWEep:DWELl?
[:SOURce[n]][:CHANnel[m]]:WAVelength:SWEep:DWELl?[<wsp>MIN|MAX|DEF]
Returns the dwell time. Can only be used when sweep is stepped.
none
syntax:
description:
parameters:
Also allowed are: MIN: minimum programmable value
MAX: maximum programmable value
DEF: This is not the preset (*RST) default value but is half the sum of, the
minimum programmable value and the maximum programmable value
response:
example:
affects:
The dwell time in seconds.
wav:swe:dwel? → +5.00000000E-001<END>
All tunable laser modules
command:
[:SOURce[n]][:CHANnel[m]]:WAVelength:SWEep:EXPectedtriggers?
[:SOURce[n]][:CHANnel[m]]:WAVelength:SWEep:EXPectedtriggers?
syntax:
description:
Returns the number of triggers. A tunable laser wavelength sweep causes a number of trig-
gers, this number is required to configure a triggering data acquisition function on a power
meter. The number returned by this function can be used to configure a Power Meter for co-
ordinated measurements with a tunable laser source (see command
parameters:
response:
example:
affects:
none
the number of expected triggers as an unsigne integer value.
sour0:wav:swe:exp? → 12001
All tunable laser modules except Agilent 81649A and Agilent 81689A/B
138
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
Signal Generation – The SOURce Subsystem
Measurement Operations & Settings
command:
[:SOURce[n]][:CHANnel[m]]:WAVelength:SWEep:FLAG?
[:SOURce[n]][:CHANnel[m]]:WAVelength:SWEep:FLAG?
syntax:
description:
The sweep flag is used to find out when logging data is available and when the next sweep
cycle may be triggered.
It may also be used as a sweep cycle counter, where: flag/2 = number of sweep cycles
The flag is:
- only used in continuous sweep
- set to 0 at start/end of sweep
- incremented when the sweep is waiting for a trigger
- incremented when logging data is available
- an odd number when, waiting for a trigger
- an even number when, logging data may be read
If the trigger input isn’t configured to start a sweep cycle the flag is increased by two when
the logging data is available
If no logging data is calculated, because the user doesn’t want lambda logging, the flag is in-
cremented at the end of the sweep cycle regardless
Flag
0
Sweep state
start
1
sweep waiting for trigger
2
trigger →
first cycle | start moving back | do some post
processing | logging data available
3
.....
0
sweep waiting for next trigger
sweep stopped or finished
none
parameters:
response:
example:
affects:
the current sweep flag value as an unsigned integer value
sour0:wav:swe:flag? → 30
All tunable laser modules except Agilent 81649A and Agilent 81689A/B
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
139
Download from Www.Somanuals.com. All Manuals Search And Download.
Measurement Operations & Settings
Signal Generation – The SOURce Subsystem
command:
[:SOURce[n]][:CHANnel[m]]:WAVelength:SWEep:LLOGging
[:SOURce[n]][:CHANnel[m]]:WAVelength:SWEep:LLOGging<wsp>OFF|ON|0|1
syntax:
description:
Switches lambda logging on or off. Lambda logging is a feature that records the exact wave-
length of a tunable laser module when a trigger is generated during a continuous sweep. You
can read this data using the [:SOURce[n]][:CHANnel[m]]:READout:DATA? command.
The following settings are the prerequisites for Lambda Logging:
NOTE
If any of the above prerequisites are not met, then when the sweep is started the status
"Sweep parameters inconsistent" will be returned and Lambda Logging will automatically
be turned off.
Lambda logging is disabled at the end of a sweep.
NOTE
NOTE
Generally, a continuous sweep can only be started if:
the trigger frequency, derived from the sweep speed and sweep step, is <= 40kHz
the number of triggers, calculated from the sweep span and sweep span, is <=100001
the start wavelength is less than the stop wavelength.
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.
parameters:
0 or OFF:
1 or ON:
switch lambda logging off
switch lambda logging on
response:
example:
affects:
none
wav:swe:llog 1
All tunable laser modules except Agilent 81649A and Agilent 81689A/B
command:
[:SOURce[n]][:CHANnel[m]]:WAVelength:SWEep:LLOGging?
[:SOURce[n]][:CHANnel[m]]:WAVelength:SWEep:LLOGging?
Returns the state of lambda logging.
syntax:
description:
parameters:
response:
none
A boolean value:
0 – lambda logging is switched off
1 – lambda logging is switched on
example:
affects:
wav:swe:llog? → 1<END>
All tunable laser modules except Agilent 81649A and Agilent 81689A/B
140
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
Signal Generation – The SOURce Subsystem
Measurement Operations & Settings
command:
[:SOURce[n]][:CHANnel[m]]:WAVelength:SWEep:MODE
[:SOURce[n]][:CHANnel[m]]:WAVelength:SWEep:MODE<wsp><mode>
syntax:
description:
Sets the sweep mode.
Cannot be set while a sweep is running.
NOTE
parameters:
STEPped:
Stepped sweep mode
MANual:
Manual sweep mode
CONTinuous:
Continuous sweep mode
response:
example:
affects:
none
wav:swe:mode STEP
All tunable laser modules except Agilent 81649A, Agilent 81689A/B and 819x9A
command:
[:SOURce[n]][:CHANnel[m]]:WAVelength:SWEep:MODE?
[:SOURce[n]][:CHANnel[m]]:WAVelength:SWEep:MODE?
Returns the sweep mode.
syntax:
description:
parameters:
response:
none
STEP:
MAN:
CONT:
Stepped sweep mode
Manual sweep mode
Continuous sweep mode
example:
affects:
wav:swe:mode? → STEP<END>
All tunable laser modules
command:
syntax:
[:SOURce[n]][:CHANnel[m]]:WAVelength:SWEep:PMAX?
[:SOURce[n]][:CHANnel[m]]:WAVelength:SWEep:PMAX?<wsp><start wavelength>,
<stop wavelength>
description:
parameters:
Returns the power to the highest permissible power for the selected wavelength sweep.
start wavelength:
stop wavelength:
The wavelength at which the sweep starts as a float value.
The wavelength at which the sweep starts as a float value.
response:
example:
affects:
The highest permissible power for the selected wavelength sweep as a float value.
wav:swe:pmax? 1540nm,1550nm → +3.5500000E-004<END>
All tunable laser modules
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
141
Download from Www.Somanuals.com. All Manuals Search And Download.
Measurement Operations & Settings
Signal Generation – The SOURce Subsystem
command:
[:SOURce[n]][:CHANnel[m]]:WAVelength:SWEep:REPeat
[:SOURce[n]][:CHANnel[m]]:WAVelength:SWEep:REPeat<wsp><mode>
syntax:
description:
parameters:
Sets the repeat mode. Applies in stopped-sweep and manual-sweep modes.
ONEWay: Every stepped or continuous sweep cycle starts at the start wavelength of the
sweep and ends at the stop wavelength of the sweep
TWOWay: Every odd stepped sweep cycle starts at the start wavelength of the sweep, and
every even stepped sweep cycle starts at the stop wavelength of the sweep.
Set the start and stop wavelength of the sweep using
tively.
response:
example:
affects:
none
wav:swe:rep twow
All tunable laser modules
command:
[:SOURce[n]][:CHANnel[m]]:WAVelength:SWEep:REPeat?
[:SOURce[n]][:CHANnel[m]]:WAVelength:SWEep:REPeat?
Returns the repeat mode.
syntax:
description:
parameters:
response:
none
ONEWay:
Every stepped or continuous sweep cycle starts at the start wavelength of the
sweep and ends at the stop wavelength of the sweep
TWOWay:
Every odd stepped sweep cycle starts at the start wavelength of the sweep,
and every even stepped sweep cycle starts at the stop wavelength of the
sweep.
Set the start and stop wavelength of the sweep using
spectively.
example:
affects:
wav:swe:rep? → ONEW<END>
All tunable laser modules
142
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
Signal Generation – The SOURce Subsystem
Measurement Operations & Settings
command:
[:SOURce[n]][:CHANnel[m]]:WAVelength:SWEep:SOFTtrigger
[:SOURce[n]][:CHANnel[m]]:WAVelength:SWEep:SOFTtrigger
syntax:
description:
Softtrigger does the same as a normal (hardware) trigger at the backplane, but it doesn’t
cause a PM to take a measurement because it is only a (software) message sent to the tun-
able laser source. It only works in continuous sweep.
Usage:
- Trigger input configuration: Start Sweep
- Start Sweep
- SoftTrigger
parameters:
response:
example:
affects:
none
none
sour0:wav:sweep:soft
All tunable laser modules except Agilent 81649A and Agilent 81689A/B
command:
syntax:
[:SOURce[n]][:CHANnel[m]]:WAVelength:SWEep:SPEed
[:SOURce[n]][:CHANnel[m]]:WAVelength:SWEep:SPEed<wsp><speed>
[NM/S|UM/S|MM/S|M/S|]
description:
Sets the speed for continuous sweeping.
Cannot be set while a sweep is running.
Speed as a float value in meters per second (m/s).
none
NOTE
parameters:
response:
example:
affects:
wav:swe:spe 10nm/s
All tunable laser modules except Agilent 81649A and Agilent 81689A/B
command:
[:SOURce[n]][:CHANnel[m]]:WAVelength:SWEep:SPEed?
[:SOURce[n]][:CHANnel[m]]:WAVelength:SWEep:SPEed?[<wsp>MIN|MAX]
Returns the speed for continuous sweeping.
syntax:
description:
parameters:
optional
MIN Returns the minimum sweep speed available.
MAX Returns the maximum sweep speed available.
response:
example:
affects:
Speed as a float value in meters per second (m/s).
wav:swe:spe? → +5.00000000E-008<END>
All tunable laser modules except Agilent 81649A and Agilent 81689A/B
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
143
Download from Www.Somanuals.com. All Manuals Search And Download.
Measurement Operations & Settings
Signal Generation – The SOURce Subsystem
command:
[:SOURce[n]][:CHANnel[m]]:WAVelength:SWEep:STARt
[:SOURce[n]][:CHANnel[m]]:WAVelength:SWEep:STARt<wsp><start value>
syntax:
[PM|NM|UM|MM|M]
description:
Sets the starting point of the sweep.
Cannot be set while a sweep is running.
The wavelength at which the sweep starts as a float value.
NOTE
parameters:
If you specify no units in your command, meters are used as the default.
response:
example:
affects:
none
wav:swe:star 1500nm
All tunable laser modules
command:
[:SOURce[n]][:CHANnel[m]]:WAVelength:SWEep:STARt?
[:SOURce[n]][:CHANnel[m]]:WAVelength:SWEep:STARt?[<wsp>MIN|MAX]
Returns the starting point of the sweep.
syntax:
description:
parameters:
optional
MIN Returns the minimum start wavelength available.
This value is wavelength dependent.
MAX Returns the maximum start wavelength available.
This value is wavelength dependent.
response:
example:
affects:
The wavelength at which the sweep starts as a float value in meters.
wav:swe:star? → +1.50000000E-006<END>
All tunable laser modules
command:
syntax:
[:SOURce[n]][:CHANnel[m]]:WAVelength:SWEep:STOP
[:SOURce[n]][:CHANnel[m]]:WAVelength:SWEep:STOP<wsp><stop value>
[PM|NM|UM|MM|M]
description:
Sets the end point of the sweep.
Cannot be set while a sweep is running.
NOTE
parameters:
The wavelength at which the sweep ends as a float value in meters.
If you specify no units in your command, meters are used as the default.
response:
example:
affects:
none
wav:swe:stop 1550nm
All tunable laser modules
144
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
Signal Generation – The SOURce Subsystem
Measurement Operations & Settings
command:
[:SOURce[n]][:CHANnel[m]]:WAVelength:SWEep:STOP?
[:SOURce[n]][:CHANnel[m]]:WAVelength:SWEep:STOP?[<wsp>MIN|MAX]
Returns the end point of the sweep.
optional MIN Returns the minimum start wavelength available.
syntax:
description:
parameters:
This value is wavelength dependent.
MAX Returns the maximum start wavelength available.
This value is wavelength dependent.
response:
example:
affects:
The wavelength at which the sweep ends as a float value in meters.
wav:swe:stop? → +1.55000000E-006<END>
All tunable laser modules
command:
syntax:
[:SOURce[n]][:CHANnel[m]]:WAVelength:SWEep:[STATe]
[:SOURce[n]][:CHANnel[m]]:WAVelength:SWEep:[STATe]<wsp>
STOP|0|STARt|1|PAUSe|2|CONTinue|3
description:
parameters:
Stops, starts, pauses or continues a wavelength sweep.
0 or STOP:
Stop the sweep.
1 or STARt:
2 or PAUSe:
3 or CONTinue:
Start a sweep, run sweep.
Pause the sweep. (doesn’t apply for continuous sweep)
Continue a sweep. (doesn’t apply for continuous sweep)
If you enable lambda logging (see
NOTE
not be started.
Generally, a continuous sweep can only be started if:
NOTE
the trigger frequency, derived from the sweep speed and sweep step, is <= 40kHz
the number of triggers, calculated from the sweep span and sweep span, is <=100001
the start wavelength is less than the stop wavelength.
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.
none
response:
example:
affects:
wav:swe STOP
All tunable laser modules
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
145
Download from Www.Somanuals.com. All Manuals Search And Download.
Measurement Operations & Settings
Signal Generation – The SOURce Subsystem
command:
[:SOURce[n]][:CHANnel[m]]:WAVelength:SWEep:[STATe]?
[:SOURce[n]][:CHANnel[m]]:WAVelength:SWEep:[STATe]?
syntax:
description:
parameters:
response:
Returns the state of a sweep.
none
+0:
Sweep is not running
Sweep is running
+1:
example:
affects:
wav:swe? → +0<END>
All tunable laser modules
command:
[:SOURce[n]][:CHANnel[m]]:WAVelength:SWEep:STEP:NEXT
syntax:
[:SOURce[n]][:CHANnel[m]]:WAVelength:SWEep:STEP:NEXT
description:
parameters:
response:
example:
affects:
Performs the next sweep step in stepped sweep if it is paused or in manual sweep.
none
none
wav:swe:step:next
All tunable laser modules
command:
[:SOURce[n]][:CHANnel[m]]:WAVelength:SWEep:STEP:PREVious
syntax:
[:SOURce[n]][:CHANnel[m]]:WAVelength:SWEep:STEP:PREVious
description:
parameters:
response:
example:
affects:
Performs one sweep step backwards in stepped sweep if it is paused or in manual sweep.
none
none
wav:swe:step:prev
All tunable laser modules
command:
syntax:
[:SOURce[n]][:CHANnel[m]]:WAVelength:SWEep:STEP:[WIDTh]
[:SOURce[n]][:CHANnel[m]]:WAVelength:SWEep:STEP:[WIDTh]<wsp>
<value>[PM|NM|UM|MM|M]
description:
parameters:
Sets the width of the sweep step.
In continuous sweep mode, the end of a step is used for triggering.
The width of the sweep step as a float value.
If you specify no units in your command, meters are used as the default.
response:
example:
affects:
none
wav:swe:step 5nm
All tunable laser modules
146
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
Signal Generation – The SOURce Subsystem
Measurement Operations & Settings
command:
[:SOURce[n]][:CHANnel[m]]:WAVelength:SWEep:STEP:[WIDTh]?
syntax:
[:SOURce[n]][:CHANnel[m]]:WAVelength:SWEep:STEP:[WIDTh]?[<wsp>MIN|MAX]
description:
parameters:
Returns the width of the sweep step
optional
MIN Returns the minimum step width available.
MAX Returns the maximum step width available.
response:
example:
affects:
The sweep step as a float value in meters.
wav:swe:step? → +5.00000000E-009<END>
All tunable laser modules
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
147
Download from Www.Somanuals.com. All Manuals Search And Download.
Measurement Operations & Settings
Signal Conditioning
Signal Conditioning
The commands in this section allow you to control Agilent 8156x, and
8157x Attenuator modules
The INPut and OUTput commands
command:
:INPut[n][:CHANnel[m]]:ATTenuation
syntax:
:INPut[n][:CHANnel[m]]:ATTenuation<wsp><value>[dB] | MIN | DEF | MAX
description:
Sets the attenuation factor (α) for the instrument. The attenuation factor is used, together
with an offset factor (α
) to set the filter attenuation ( α
).
Offset
filter
α
(dB) = α
(dB) + α
(dB)
Offset
(new)
filter (new)
Set the attenuation factor by sending a value (the default units are dB), or by sending MIN,
DEF, or MAX.
parameters:
<value>[dB]
MIN | DEF
The attenuation in dB.
The values where α
= 0dB
filter
MAX
The value where α
is at its greatest.
filter
response:
example:
affects:
none
INP1:ATT 14dB
All attenuator modules
command:
:INPut[n][:CHANnel[m]]:ATTenuation?
syntax:
:INPut[n][:CHANnel[m]]:ATTenuation?<wsp> MIN | DEF | MAX
Returns the current attenuation factor (α), in dB.
description:
α (dB) = α
(dB) + α
(dB)
Offset
filter
parameters:
MIN | DEF | MAX Returns the minimum, default, or maximum value of the attenuation fac-
tor possible.
response:
example:
affects:
4 byte Intel floating point; attenuation in dB.
INP1:ATT? → 14<END>
All attenuator modules
148
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
Signal Conditioning
Measurement Operations & Settings
command:
:INPut[n][:CHANnel[m]]:OFFSet
:INPut[n][:CHANnel[m]]:OFFSet<wsp><value>[dB] | MIN | DEF | MAX
Sets the offset factor (α ) for the instrument. This factor does not affect the filter atten-
syntax:
description:
Offset
uation ( α
). It is used to offset the attenuation factor values. This offset factor is used,
filter
with the attenuation factor, to set the attenuation of the filter. In this way it is possible to
compensate for external losses.
α
(dB) = α
(dB) + α
(dB)
Offset (new)
(new)
filter
Set the offset factor by sending a value (the default units are dB), or by sending MIN, DEF, or
MAX.
parameters:
<value>[dB]
MIN
The offset factor (α
) in dB.
Offset
Sets the minimum value for α
Sets the default value for α
= - 200dB.
Offset
Offset
DEF
= 0dB.
Offset
MAX
Sets the maximum value for α
= + 200dB.
response:
example:
affects:
none
INP1:OFFS 2dB
All attenuator modules
command:
:INPut[n][:CHANnel[m]]:OFFSet?
syntax:
:INPut[n][:CHANnel[m]]:OFFSet?<wsp>MIN | DEF | MAX
Returns the current value of the offset factor (α ), in dB.
description:
parameters:
response:
example:
affects:
Offset
MIN | DEF | MAX Returns the minimum, default, or maximum value of the offset factor.
4 byte Intel floating point; offset in dB.
INP1:OFFS? → 2<END>
All attenuator modules
command:
:INPut[n][:CHANnel[m]]:OFFSet:DISPlay
:INPut[n][:CHANnel[m]]:OFFSet:DISPlay
syntax:
description:
Sets the offset factor (α
) such that the attenuation factor is zero.
Offset
α
(dB) = α
(dB) - α
(dB) = - α
(dB)
filter
Offset (new)
Offset (old)
(old)
parameters:
response:
example:
affects:
none
none
INP1:OFFS:DISP
All attenuator modules
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
149
Download from Www.Somanuals.com. All Manuals Search And Download.
Measurement Operations & Settings
Signal Conditioning
command:
:INPut[n][:CHANnel[m]]:OFFSet:POWermeter
:INPut[n][:CHANnel[m]]:OFFSet:POWermeter<wsp><slot>,<channel>
Sets the offset factor (α ) to the difference between a power value measured by another
syntax:
description:
Offset
powermeter (hosted by the same mainframe) (P ) and the power value measured by the
ext
attenuator module’s monitor diode (P ).
att
α
(dB) = P (dBm) - P (dBm)
att ext
Offset
parameters:
<slot>
Slot number of the external powermeter.
<channel> Channel number of the external powermeter.
response:
example:
affects:
none
INP1:OFFS:POW 4,2
Attenuator modules with power control.
command:
:INPut[n][:CHANnel[m]]:ATTenuation:SPEed
syntax:
:INPut[n][:CHANnel[m]]:ATTenuation:SPEed<wsp><value> | MIN | MAX | DEF
description:
Sets the filter transition speed; the speed at which the module moves from one attenuation to
another (in dBs).
parameters:
<value>
The filter transition speed in dB/s.
MIN | MAX | DEF Sets the filter transition speed to the module limits, or the module de-
fault.
response:
example:
affects:
none
INP1:ATT:SPE 2
All attenuator modules.
command:
:INPut[n][:CHANnel[m]]:ATTenuation:SPEed?
syntax:
:INPut[n][:CHANnel[m]]:ATTenuation:SPEed?<wsp> MIN | MAX | DEF
Without the optional parameter, queries the transition speed of the filter.
MIN | MAX | DEF Queries the transition speed limits, or the module default.
4 byte Intel floating point; transition speed in dB/s.
INP1:ATT:SPE? → 2<END>
description:
parameters:
response:
example:
affects:
All attenuator modules.
150
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
Signal Conditioning
Measurement Operations & Settings
command:
:INPut[n][:CHANnel[m]]:WAVelength
syntax:
:INPut[n][:CHANnel[m]]:WAVelength<wsp><value>[PM | NM | UM| MM | M] | MIN |
MAX | DEF
description:
Sets the attenuator module’s operating wavelength.
This value is used to compensate for the wavelength dependence of the filter, and to calcu-
late a wavelegth dependent offset from the user offset table (if enabled).
parameters:
<value>
The wavelength in meters (if you do not specify a unit).
MIN | MAX | DEF Sets the wavelength to the module limits, or the module default.
response:
example:
affects:
none
INP1:WAV +1.55000000E-006
All attenuator modules.
command:
:INPut[n][:CHANnel[m]]:WAVelength?
syntax:
:INPut[n][:CHANnel[m]]:WAVelength?<wsp>MIN | MAX | DEF
Without the optional parameter, queries the operating wavelength of the attenuator.
MIN | MAX | DEF Queries the operating wavelength limits, or the module default.
4 byte Intel floating point; wavelength in m.
description:
parameters:
response:
example:
affects:
INP1:WAV → +1.55000000E-006<END>
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 Agilent 8156A mainframe.
parameters:
OFF or 0
ON or 1
response:
example:
affects:
none
OUTP1:APMode OFF
All attenuator modules.
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
151
Download from Www.Somanuals.com. All Manuals Search And Download.
Measurement Operations & Settings
Signal Conditioning
command:
:OUTPutn[:CHANnel[m]]:APMode?
:OUTPutn[:CHANnel[m]]:APMode?
syntax:
description:
Queries whether the user has amended the power value or the attenuation value.
This use of this command is optional.
Included for compatibility with Agilent 8156A mainframe.
parameters:
response:
none
boolean 0 User has amended the attenuation value.
1 User has amended the power value.
OUTP1:APMode? → 0<END>
example:
affects:
All attenuator modules.
command:
syntax:
:OUTPutn[:CHANnel[m]]:POWer
:OUTPutn[:CHANnel[m]]:POWer<wsp><value>[PW | NW | UW | MW | W | DBM ] | MIN | MAX |
DEF
description:
Sets the output power value (P ).
If your attenuator module does not include the power control feature, the new filter attenua-
tion (α
) is calculated from the reference power (P ) :
filter (new)
ref
P
(dBm) = P (dBm) - α
(dB) - P
(dB)
Offset
set(new)
ref
filter (new)
If your attenuator module includes the power control feature, the filter attenuation is changed
until the set power (measured by the module’s internal power meter) has been reached.
P
(dBm) = P
(dBm) - P
(dB)
set(new)
att(new)
offset
If the set power cannot be achieved ExP (indicating ’Excessive Power’ ) is displayed, and the
parameters:
<value>
Desired output power (if unit not specified current unit is used).
MIN | MAX | DEF Sets the output power to the module limits, or the module default.
response:
example:
affects:
none
OUTP1:POW 12
All attenuator modules.
command:
:OUTPutn[:CHANnel[m]]:POWer?
syntax:
:OUTPutn[:CHANnel[m]]:POWer<wsp>MIN | MAX | DEF
Without the optional parameter, queries the output power value.
MIN | MAX | DEF Queries the output power module limits, or the module default.
4 byte Intel floating point; output power in current power unit.
OUTP1:POW? → 12<END>
description:
parameters:
response:
example:
affects:
All attenuator modules.
152
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
Signal Conditioning
Measurement Operations & Settings
command:
:OUTPutn[:CHANnel[m]]:POWer:REFerence
syntax:
:OUTPutn[:CHANnel[m]]:POWer:REFerence<wsp><value>[PW | NW | UW | MW | W |
DBM ] | MIN | MAX | DEF
description:
Sets the reference power (P ). The reference power is used to calculate the filter attenua-
ref
tion ( α
) from the output power (P ) . A change to the reference power does not affect
filter
the filter attenuation.
P
(dBm) = P
(dBm - α
(dB) - P
(dB)
Offset
set(new)
ref (new)
)
filter
parameters:
<value>
Desired reference power (if unit not specified current unit is used).
MIN | MAX | DEF Sets the reference power to the module limits, or the module default.
response:
example:
affects:
none
OUTP1:POW:REF 6dBm
Attenuator modules without power control.
command:
:OUTPutn[:CHANnel[m]]:POWer:REFerence?
syntax:
:OUTPutn[:CHANnel[m]]:POWer:REFerence?<wsp>MIN | MAX | DEF
Without the optional parameter, queries the reference power value.
MIN|MAX|DEF Queries the reference power limits, or the module default.
4 byte Intel floating point; reference power in current power unit.
OUTP1:POW:REF? → 6<END>
description:
parameters:
response:
example:
affects:
Attenuator modules without power control.
command:
:OUTPutn[:CHANnel[m]]:POWer:REFerence:POWermeter
syntax:
:OUTPutn[:CHANnel[m]]:POWer:REFerence:POWer<wsp><slot>,<channel>
description:
Copies the power value (P ) from an external powermeter module (hosted by the same
ext
mainframe) to the attenuator module’s reference power parameter (P ):
ref
P
(dBm) = P (dBm) + α
(dB)
filter
ref
ext
parameters:
<slot>
Slot number of the powermeter.
<channel>
none
Channel number of the powermeter.
response:
example:
affects:
OUTP1:POW:REF:POW 4,2
Attenuator modules without power control.
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
153
Download from Www.Somanuals.com. All Manuals Search And Download.
Measurement Operations & Settings
Signal Conditioning
command:
:OUTPutn[:CHANnel[m]]:POWer:OFFSet
:OUTPutn[:CHANnel[m]]:POWer:OFFSet<wsp><value>[DB] | MIN | MAX | DEF
Sets a power offset (P ). This factor is used to offset the power value. It does not affect
syntax:
description:
offset
the filter, nor does it change the power output at the attenuator module.
P
(dBm) = P (dBm) - P (dB)
set(new)
att
offset(new)
If the wavelength offset table is enabled, the corresponding λ offset is added to this offset.
<value> The power offset required, in dB
parameters:
MIN | MAX | DEF Queries the module limits, or the default.
response:
example:
affects:
none
OUTP1:POW:OFFS 2
Attenuator modules with power control.
command:
:OUTPutn[:CHANnel[m]]:POWer:OFFSet?
syntax:
:OUTPutn[:CHANnel[m]]:POWer:OFFSet? <wsp>MIN | MAX| DEF
Without the optional parameter, queries the power offset value.
MIN | MAX | REF Queries the power offset limits, or the module default.
4 byte Intel floating point; power offset in current power units.
OUTP1:POW:OFFS? → 2<END>
description:
parameters:
response:
example:
affects:
Attenuator modules with power control.
command:
:OUTPutn[:CHANnel[m]]:POWer:OFFSet:POWermeter
syntax:
:OUTPutn[:CHANnel[m]]:POWer:OFFSet:POWermeter<wsp><slot>,<channel>
description:
Calculates the power offset by subtracting the power value measured by another powerme-
ter (hosted by the same mainframe) from the power value measured by the attenuator’s inte-
grated powermeter, and stores it as P
.
offset
P
(dBm) = P (dBm) - P (dBm) + P
(dB)
offset ( λ )
offset(new)
att
ext
parameters:
<slot>
Slot number of the external powermeter.
Channel number of the external powermeter.
<channel>
none
response:
example:
affects:
OUTP1:POW:OFFS:POW 4,4
Attenuator modules with power control.
154
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
Signal Conditioning
Measurement Operations & Settings
command:
:OUTPutn[:CHANnel[m]]:POWer:CONTRol
syntax:
:OUTPutn[:CHANnel[m]]:POWer:CONTRol<wsp>OFF(0) | ON(1)
description:
Sets whether the power control mode is on or off.
If power control is enabled, the attenuator automatically compensates for changes to
input power.
parameters:
OFF or 0
ON or 1
Output power follows changes to input power.
The filter position automatically adjusts to compensate for changes to input
power, so maintaining the output power set by the user.
response:
example:
affects:
none
OUTP1:POW:CONTR ON
Attenuator modules with power control.
command:
:OUTPutn[:CHANnel[m]]:POWer:CONTRol?
:OUTPutn[:CHANnel[m]]:POWer:CONTRol?
Queries whether the power control mode is on or off.
none
syntax:
description:
parameters:
response:
boolean 0 The power control mode is off
1 The power control mode is on.
OUTP1:POW:CONTR? → 0<END>
example:
affects:
Attenuator modules with power control.
command:
:OUTPutn[:CHANnel[m]]:POWer:UNit
syntax:
:OUTPutn[:CHANnel[m]]:POWer:UNit<wsp>DBM(0) | WATT(1)
Sets whether the power unit used is dBm or Watts.
description:
This setting affects P , P (if available), and P
set ref
act
parameters:
DBM (or 0) Sets the power unit to dBm
WATT (or 1) Sets the power unit to W
none
response:
example:
affects:
OUTP1:POW:UN DBM
All attenuator modules.
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
155
Download from Www.Somanuals.com. All Manuals Search And Download.
Measurement Operations & Settings
Signal Conditioning
command:
:OUTPutn[:CHANnel[m]]:POWer:UNit?
syntax:
:OUTPutn[:CHANnel[m]]:POWer:UNit?
Queries whether the power unit is dBm or W
none
description:
parameters:
response:
boolean 0 The power unit is dBm
1 The power unit is W.
OUTP1:POW:UN? → 0<END>
All attenuator modules.
example:
affects:
command:
:OUTPutn[:CHANnel[m]]:[STATe]
syntax:
:OUTPutn[:CHANnel[m]]:[STATe]<wsp>OFF(0) | ON(1)
Sets the state of the shutter.
description:
parameters:
OFF or 0
Shutter closed.
Shutter open.
ON or 1
none
response:
example:
affects:
OUTP1:STAT OFF
All attenuator modules.
command:
:OUTPutn[:CHANnel[m]]:[STATe]?
:OUTPutn[:CHANnel[m]]:[STATe]?
Queries the state of the shutter.
none
syntax:
description:
parameters:
response:
boolean 0 The shutter is open.
1 The shutter is closed.
OUTP1:STAT? → 0<END>
All attenuator modules.
example:
affects:
command:
:OUTPutn[:CHANnel[m]]:STATe:APOWeron
syntax:
:OUTPutn[:CHANnel[m]]:STATe:APOWeron<wsp>OFF(0) | ON(1)
Sets the state of the shutter when the mainframe is turned on.
description:
parameters:
OFF or 0
Shutter closed after mainframe power on.
Shutter open after mainframe power on.
ON or 1
none
response:
example:
affects:
OUTP1:APOW OFF
All attenuator modules.
156
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
Signal Conditioning
Measurement Operations & Settings
command:
:OUTPutn[:CHANnel[m]]:STATe:APOWeron?
:OUTPutn[:CHANnel[m]]:STATe:APOWeron?
Queries the state of the shutter at power on.
none
syntax:
description:
parameters:
response:
boolean 0 The shutter is open after mainframe power on.
1 The shutter is closed after mainframe power on.
OUTP1:APOW? → 0<END>
example:
affects:
All attenuator modules.
command:
:OUTPutn[:CHANnel[m]]:ATIMe
syntax:
:OUTPutn[:CHANnel[m]]:ATIMe<wsp><value>[ NS | US | MS| S ]
description:
Sets the powermeter averaging time, which can, if the attenuator’s power contol feature is
activated, affect how the attenuator compensates for changes to input power.
parameters:
response:
example:
affects:
<value>
none
The averaging time (in seconds if no unit specified).
OUTP1:ATIM 1s
Attenuator modules with power control.
command:
:OUTPutn]:CHANnel[m]]:ATIMe?
:OUTPutn[:CHANnel[m]]:ATIMe?
Queries the powermeter averaging time.
none
syntax:
description:
parameters:
response:
example:
affects:
4 byte Intel floating point; the averaging time in seconds
OUTP1:ATIM? → 1<END>
Attenuator modules with power control.
command:
:OUTPutn[:CHANnel[m]]:CORRection:COLLection:ZERO
syntax:
:OUTPutn[:CHANnel[m]]:CORRection:COLLection:ZERO
description:
parameters:
response:
example:
affects:
Zeros the electrical offsets of the attenuator’s integrated powermeter.
none
none
OUTP1:CORR:COLL:ZERO
Attenuator modules with power control.
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
157
Download from Www.Somanuals.com. All Manuals Search And Download.
Measurement Operations & Settings
Signal Conditioning
command:
:OUTPutn[:CHANnel[m]]:CORRection:COLLection:ZERO:ALL
syntax:
:OUTPutn[:CHANnel[m]]:CORRection:COLLection:ZERO:ALL
description:
parameters:
response:
example:
affects:
Zero all available powermeter channels in the mainframe.
none
none
OUTP1:CORR:COLL:ZERO:ALL
Powermeter modules; attenuator modules with power control, and return loss modules.
command:
:OUTPutn[:CHANnel[m]]:CORRection:COLLection:ZERO?
:OUTPutn[:CHANnel[m]]:CORRection:COLLection:ZERO?
syntax:
description:
Queries the status of the last :OUTPutn[:CHANnel[m]]:CORRection:COLLection:ZERO opera-
tion.
parameters:
response:
example:
affects:
none
integer
0 = OK, otherwise not OK.
OUTP:CORR:COLL:ZER0? → 0<END>
Attenuator modules with power control.
158
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
Signal Conditioning
Measurement Operations & Settings
The table of wavelength-dependent offsets
When enabled, the attenuator uses its λ offset table to compensate for
wavelength dependent losses in the test set-up. This table contains, for
each wavelength specified, the additional power offset to be applied.
•
If the attenuator module is set to a wavelength corresponding to an entry in its
λ offset table, the stored offset is added to the global power offset.
•
If the attenuator module is set to a wavelength between entries in its λ offset
table, linear interpolation is used to calculate the appropriate offset to add to the
global power offset.
•
•
If the attenuator module is set to a wavelength beyond the range of the entries
in its λ offset table, the offset stored for the nearest wavelength is added to the
global power offset.
Whether an exact, interpolated, or extrapolated offset value is applied, the algo-
Figure 6 Extrapolation and interpolation of attenuator module λ offset table
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
159
Download from Www.Somanuals.com. All Manuals Search And Download.
Measurement Operations & Settings
Signal Conditioning
command:
:CONFigure[n][:CHANnel[m]]:OFFSet:WAVelength:STATe
:CONFigure[n]][:CHANnel[m]]:OFFSet:WAVelength:STATe<wsp>OFF(0) | ON(1)
syntax:
description:
Specifies whether the attenuator uses its λ offset table to compensate for wavelength de-
pendent losses in the the test set-up. This table contains, for each wavelength specified, the
additional power offset to be applied.
This command does not affect the module’s internal enviromental temperature and optical
wavelength compensation, which remain active.
parameters:
OFF or 0
ON or 1
The offset table is not used to compensate for wavelength dependent losses.
The attenuator adds the appropriate value from its λ offset table to the global
power offset.
response:
example:
affects:
none
CONF1:OFFS:WAV:STAT ON
All attenuator modules.
command:
:CONFigure[n][:CHANnel[m]]:OFFSet:WAVelength:STATe?
:CONFigure[n]][:CHANnel[m]]:OFFSet:WAVelength:STATe?
Queries whether the attenuator uses power values from its λ offset table .
none
syntax:
description:
parameters:
response:
boolean 0 The offset table is not used.
1 The attenuator uses its λ offset table.
CONF1:OFFS:WAV:STAT? → 0<END>
All attenuator modules.
example:
affects:
160
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
Signal Conditioning
Measurement Operations & Settings
command:
:CONFigure[n][:CHANnel[m]]:OFFSet:WAVelength:VALue
syntax:
:CONFigure[n]][:CHANnel[m]]:OFFSet:WAVelength:VALue<wsp><lambda>[PM | NM | UM | MM|
M],<offset[DB]> | TOREF
description:
Adds a value pair (wavelength; offset) to the offset table, or overwrites an existing value pair.
The offset table entries are ordered from shortest to longest wavelength.
<lambda> The wavelength for the offset table entry, in m
parameters:
<offset>
The power offset to be applied at <lambda>.
To query the current power value measured by attenuator with power control
TOREF
Calculates the difference between the power measured by an external power-
meter (hosted in the same mainframe) and the power measured by the attenu-
ator module’s integrated powermeter, and stores it as the offset.
P
(dB) = P (dBm) - P (dBm)
att ext
Offset ( λ )
(Attenuator modules with power control only).
response:
example:
affects:
none
CONF1:OFFS:WAV:VAL +1.55000000E-006,TOREF
All attenuator modules (TOREF applicable to attenuator modules with power control only).
command:
:CONFigure[n][:CHANnel[m]]:OFFSet:WAVelength:REFerence
syntax:
:CONFigure[n]][:CHANnel[m]]:OFFSet:WAVelength:REFerence<wsp><slot>,<channel>
description:
Specifies the slot and channel of the external powermeter (hosted in the same mainframe as
the attenuator module) used by TOREF.
parameters:
<slot>
Slot number of the powermeter.
<channel> Channel number of the powermeter.
none
response:
example:
affects:
CONF1:OFFS:WAV:REF 4,2
Attenuator modules with power control.
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
161
Download from Www.Somanuals.com. All Manuals Search And Download.
Measurement Operations & Settings
Signal Conditioning
command:
:CONFigure[n][:CHANnel[m]]:OFFSet:WAVelength:REFerence?
:CONFigure[n]][:CHANnel[m]]:OFFSet:WAVelength:REFerence?
syntax:
description:
Queries the currently selected slot and channel of the external powermeter (hosted in the
same mainframe as the attenuator module) used by TOREF.
none
parameters:
response:
example:
affects:
the slot and channel of the external powermeter as integer values.
CONF1:OFFS:WAV:REF? → +2,+1<END>
Attenuator modules with power control.
command:
:CONFigure[n][:CHANnel[m]]:OFFSet:WAVelength:VALue:WAVelength?
syntax:
:CONFigure[n]][:CHANnel[m]]:OFFSet:WAVelength:VALue:WAVelength?<wsp><index>
description:
Queries a wavelength value from its position, or index, in the offset table. Offset table entries
are ordered from shortest to longest wavelength. The first index number = 1.
parameters:
response:
example:
affects:
<index>
The position of the wavelength value in the offset table.
4 byte Intel floating point; the wavelength in meters
CONF1:OFFS:WAV:VAL:WAV? 1 → +1.55000000E-006<END>
All attenuator modules.
command:
syntax:
:CONFigure[n][:CHANnel[m]]:OFFSet:WAVelength:VALue:OFFSet?
:CONFigure[n]][:CHANnel[m]]:OFFSet:WAVelength:VALue:OFFSet?<wsp><index | wavelength [PM |
NM | UM | MM| M],>
description:
Queries an offset value from the position, or index, of the associated wavelength in the offset
table. Offset table entries are ordered from shortest to longest wavelength. The first index
number =1.
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
4 byte Intel floating point; the offset
response:
example:
affects:
CONF1:OFFS:WAV:VAL:OFFS? 1 → 2
All attenuator modules.
162
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
Signal Conditioning
Measurement Operations & Settings
command:
:CONFigure[n][:CHANnel[m]]:OFFSet:WAVelength:VALue:PAIR?
syntax:
:CONFigure[n]][:CHANnel[m]]:OFFSet:WAVelength:VALue:PAIR?<wsp><index | wavelength[PM | NM |
UM | MM| M],>
description:
Queries an offset value pair (wavelength:offset) from the position, or index, of the associated
wavelength in the offset table. Offset table entries are ordered from shortest to longest wave-
length.
Or: Queries the offset value pair (wavelength:offset) applied for the specified wavelength.
parameters:
<index>
The position of the wavelength; offset value pair in the offset table.
<wavelength> The wavelength for the offset table entry, in m
char$ in SCPI block format (Intel byte order); wavelength:offset
CONF1:OFFS:WAV:VAL:PAIR? 1 → "+1.55000000E-006:2"
All attenuator modules.
response:
example:
affects:
command:
syntax:
:CONFigure[n][:CHANnel[m]]:OFFSet:WAVelength:VALue:DELete
:CONFigure[n]][:CHANnel[m]]:OFFSet:WAVelength:VALue:DELete<wsp><index | wavelength[PM | NM
| UM | MM| M],>
description:
Deletes an offset value pair (wavelength:offset) from the position, or index, of the associated
wavelength in the offset table. Offset table entries are ordered from shortest to longest wave-
length.
Or: Deletes the offset value pair (wavelength:offset) associated with the specified wavelength.
Deleting a value pair decrements the index value of every subsequent value pair by 1. When us-
ing this command, you may prefer to work from large to small index values.
NOTE
parameters:
<index>
The position of the wavelength:offset value pair in the offset table.
<wavelength> The wavelength for the offset table entry, in m
response:
example:
affects:
none
CONF1:OFFS:WAV:VAL:DEL 1
All attenuator modules.
command:
:CONFigure[n][:CHANnel[m]]:OFFSet:WAVelength:VALue:DELete:ALL
syntax:
:CONFigure[n]][:CHANnel[m]]:OFFSet:WAVelength:VALue:DELete:ALL
CAUTION
description:
parameters:
response:
example:
affects:
This command clears the offset table!
Deletes every value pair (wavelength:offset) from the offset table.
none
none
CONF1:OFFS:WAV:VAL:DEL:ALL
All attenuator modules.
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
163
Download from Www.Somanuals.com. All Manuals Search And Download.
Measurement Operations & Settings
Signal Conditioning
command:
:CONFigure[n][:CHANnel[m]]:OFFSet:WAVelength:TABle?
:CONFigure[n]][:CHANnel[m]]:OFFSet:WAVelength:TABle?
Queries the complete the offset table.
none
syntax:
description:
parameters:
response:
SCPI binary block format format (Intel byte order); wavelength:offset pairs in ascending
order.
Each value pair is transferred as 12 bytes; 8 bytes represent the wavelength, 4 bytes rep-
resent the offset.
example:
affects:
CONF1:OFFS:WAV:TAB? → binary block interpreted as, for example:
1.55e-6 | 12 | 1.7e-6 |3.4 |.....
All attenuator modules.
command:
:CONFigure[n][:CHANnel[m]]:OFFSet:WAVelength:TABle:SIZE?
:CONFigure[n]][:CHANnel[m]]:OFFSet:WAVelength:TABle:SIZE?<wsp>MAX | MIN
Without optional parameter, queries the size of the offset table.
syntax:
description:
parameters:
MAX
Queries the maximum size of the offset table.
(available flash memory → 1000 entries)
MIN
Queries the minimum size of the offset table. (should → 0)
response:
example:
affects:
4 byte unsigned integer; offset table size.
CONF1:OFFS:WAV:TAB:SIZE? → 50
All attenuator modules.
164
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
Signal Conditioning
Measurement Operations & Settings
Compatibility of the 81560A/1A/6A/7A
modular attenuator family to the 8156A
attenuator
The 81560A/1A/6A/7A modular attenuator family is intended to be SCPI
compatible with the 8156A attenuator but, because the modular attenuator
family is part of a platform concept, there are some compatibility
limitations. This section describes the differences between the SCPI
syntax and the command semantic and how to deal with them.
The page numbers in brackets refer to pages in the Agilent Technologies
8156A Attenuator Operating and Programming Guide, Second Edition, May
2000 with part number 08156-91011:E0500.
NOTE
Slot Numbers
INPUT and OUPUT SCPI commands (page 106-114) are used to access the
functionality of the 8156A Attenuator. The 816xA/B mainframes are able
to host a number of modules, so a slot identifier is needed. This slot
identifier was not required by the 8156A attenuator. Simply substitute
INPutn for INPut, and OUTPutn for OUTPut, where n is the slot number of
your attenuator module.
Example1: Setting the attenuation
8156A:INP:ATT 10 dB
8156x:INP2:ATT 10 dB
(when the attenuator is hosted in Slot 2)
Example2: Setting the output power
8156A:OUTP:POW 10 dBm
8156x:OUTP2:POW 10 dBm
(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:
-303,"Module slot empty or slot / channel invalid"
-301,"Module doesn't support this command (StatCmdUnknown)"
TIP: Query the SCPI error queue using SYST:ERR?
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
165
Download from Www.Somanuals.com. All Manuals Search And Download.
Measurement Operations & Settings
Signal Conditioning
TIP: You can use INPut commands without a slot number if the
81560A/1A/6A/7A module is hosted by Slot 1. An INPut command is
applied to Slot 1 by default.
Command Semantic
All the INPut and OUTPut commands applicable to the 8156A attenuator
are also supported by the 81560A/1A/6A/7A modular attenuator family.
In addition, the 81560A/1A/6A/7A modular attenuator family supports
new commands to access its new features. To support these new features,
and improve the usability of the instrument, the meaning (the semantic) of
some existing commands has changed. This section lists all commands
already available to the 8156A attenuator, notes whether the semantic of
the command has changed, and where applicable, suggests how to handle
the change.
Table 7 Comparison of command semantics beween 8156A attenuator and 8156xA modular attenuator family.
Command
Comment
No change.
INPut:ATTenuation
INPut:ATTenuation?
INPut:LCMode
No change.
No longer supported. Use the wavelength dependent offset command.
No longer supported. Use the wavelength dependent offset command.
INPut:LCMode?
INPut:OFFSet
No change.
No change.
No change.
No change.
INPut:OFFSet?
INPut:OFFSet:DISPlay
INPut:WAVelength
OUTPut:APMode
The 8156A uses this command to calculate a base power level while the instru-
ment switches to another mode. This behavior is replaced by a mechanism that
is easier to use.
To calculate a power level at the device under test, formerly known as through
power, the 81560A and 81561A attenuator modules use a reference power. This
reference power can be modified either via the user interface or by using the
SCPI command OUTPut:POWer:REFerence. The power is calculated from the at-
tenuation and the reference power using this formula:
P
(dBm) = P (dBm) - α (dB)
ref
set
The 81566A and 81567A attenuator modules do not need a base power level be-
cause they are able to measure the output power directly.
Despite these new features, the 8156x modular attenuator family supports this
command, but only to address compatibility issues. The command only sets an
internal flag, which can be read using OUTput:APMode? You are free to choose
between adjusting the output power or adjusting the attenuation factor.
166
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
Signal Conditioning
Measurement Operations & Settings
Table 7 Comparison of command semantics beween 8156A attenuator and 8156xA modular attenuator family.
Command
Comment
It is now possible to adjust both power and attenuation without changing the
mode, so this command is supported only to address compatibility issues. This
query returns whether power (1) or attenuation (0) was changed last. All other
actions have no effect on this internal flag.
OUTPut:APMode?
Except that the base power level is determined in another way (see OUTPut:AP
Mode), there is no change to the semantic of this command.
OUTPut:POWer
No change.
No change.
No change.
No change.
No change.
OUTPut:POWer?
OUTPut:STATe
OUTPut:STATe?
OUTPut:STATe:APOWeron
OUTPut:STATe:APOWeron?
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?
IEEE Commands
Every SCPI compatible measurement instrument implements a subset of
the IEEE SCPI command set. The 8156A attenuator and the
81560A/1A/6A/7A attenuator family use almost the same subset. The
following IEEE commands are available when using the 8156A but not
available when using the 81560A/1A/6A/7A modules (page 93ff):
*RCLRecover parameter setup
*SAVSave parameter setup
*SRE and *SRE?Status request register
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
167
Download from Www.Somanuals.com. All Manuals Search And Download.
Measurement Operations & Settings
Signal Conditioning
Status Commands
The instrument status model can be controlled, and its current state
queried, using commands from the SCPI STATus subtree. All the STATus
commands available for the 8156A attenuator are supported by the
81560A/1A/6A/7A modular attenuator familiy except:
STATus:OPERation:PTRansition
STATus:OPERation:NTRansition
STATus:QUEStionable:PTRansition
STATus:QUEStionable:NTRansition
There are new status bits available to query the current modular
attenuator state.
User Calibration Data
The user calibration mode of the 8156A overrides the attenuator’s built-in
wavelength calibration table, so allowing user defined wavelength
compensation. Since the 81560A/1A/6A/7A modular attenuator family
features an improved factory calibration process, so this user calibration
feature (page 123) is not supported.
The 81560A/1A/6A/7A modular attenuator family includes a user
configurable offset function. If you enable this feature, the module’s
internal wavelength compensation remains active and you are able to
compensate for additional external wavelength-dependent losses within
the measurement setup by creating a wavelength/offset table. For
additional information, refer to our Application Note "Variable Optical
Attenuator in BER Test Applications", part number 5988-3159EN.
168
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
Signal Routing
Measurement Operations & Settings
Signal Routing
The commands in this section allow you to control Agilent 8159x Optical
Switch modules
command:
:ROUTe[n][:CHANnel[m]]
syntax:
:ROUTe[n]:[CHANnel[m]]<wsp><channel_list>
description:
Sets the channel route between two ports.
When you use switches with dependent connections (e.g. the 2x2 switch), it is possible that
one route configuration automatically changes another connection!
NOTE
parameters:
n:
the slot number of the switch module
m:
the switch channel within the selected switch module.
e.g. for dual 1 x 2 module m = 1 for switch 1; m = 2 for switch 2
channel_list the route between left and right ports.
channel_list format: [A....Z],[1....n]
response:
example:
affects:
If an invalid route is selected the following error message is returned - "StatParamError"
rout3:chan1 A,2 (module in slot 3,channel 1, connect port A with port 2)
All switch modules
command:
:ROUTe[n][:CHANnel[m]]?
syntax:
:ROUTe[n]:[CHANnel[m]]<wsp><channel_list>
description:
parameters:
Queries the current channel route of the switch for a specific module and switch channel.
n:
the slot number of the switch module
m:
the switch channel within the selected switch module. Default value is 1.
response:
[A.....Z],[1.....n];[A.....Z],[1.....n] as a text string.
"," separates input and output ports of a specific connection.
";" separates parallel connections (as used in 2x2 switch).
example:
affects:
rout3:chan1? → A,1 simple 1xN switch
rout2:chan1? → A,2;B,1 (2x2 crossover switch in crossover config).
All switch modules
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
169
Download from Www.Somanuals.com. All Manuals Search And Download.
Measurement Operations & Settings
Signal Routing
command:
:ROUTe[n][:CHANnel[m]]:CONFig?
:ROUTe[n]:[CHANnel[m]]:CONFig?
syntax:
description:
Queries the switch configuration of the instrument. For each channel, the minimum and
maximum channel number of each port is given.
NOTE
parameters:
response:
none
<j>,<k>;<l>,<m> as text string where:
<j> is the first port character on the left
<k> is the last port character on the left
<l> is the minmimum port number on the right
<m> is the maximum port number on the right
example:
affects:
rout2:conf? → A,B;1,2 (2 left and 2 right ports)
All switch modules
command:
:ROUTe[n][:CHANnel[m]]:CONFig:ROUTe?
:ROUTe[n]:[CHANnel[m]]:CONFig:ROUTe?
Queries the allowed switch routes of an instrument.
syntax:
description:
NOTE
parameters:
response:
none
[A.....Z],[1.....n];[A.....Z],[1.....n].[A.....Z],[1.....n] as a text string.
"," separates input and output ports of a single connection.
";" separates parallel connections
"." separates possible switch states
example:
affects:
rout2:conf:rout? → 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)
All switch modules
170
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
Triggering - The TRIGger Subsystem
Measurement Operations & Settings
Triggering - The TRIGger
Subsystem
The TRIGger Subsystem allows you to configure how the instrument
reacts to incoming or outgoing triggers.
Table 8 Triggering and Power Measurements
Hardware
Triggering
Trigger Rearming
Software Triggering
Data Acquisition Functions
sens:func:stat
trig:inp
trig:inp:rearm
init:imm
init:cont
MINMax
LOGGing|STABility
IGNore
-
One power mea- Automatically performs power
surement is per- measurements.
formed.
Automatically performs power
measurements until the func-
tion is finished.
SMEasure
CMEasure
ON
ON
Every hardware trigger starts a new power measure- Every hardware trigger starts a
ment.
new power measurement until
the function is finished.
The first hardware trigger starts
the function. Subsequent pow-
er measurements are automati-
cally performed until the
function is finished.
SMEasure
CMEasure
OFF
OFF
The first hardware trigger starts a new power mea- Every hardware trigger starts a
surement. Further hardware triggers are ignored until new power measurement until
you send trig:inp:rearm again.
the function is finished.
The first hardware trigger starts
the function. Subsequent pow-
er measurements are automati-
cally performed until the
function is finished.
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
171
Download from Www.Somanuals.com. All Manuals Search And Download.
Measurement Operations & Settings
Triggering - The TRIGger Subsystem
Table 9 Generating Output Triggers from Power Measurements
Hardware
Triggering
Trigger Rearming
Software Triggering
Data Acquisition Functions
sens:func:stat
trig:outp
trig:outp:rearm
init:imm
init:cont
MINMax
LOGGing|STABility
DISabled
AVGover
-
An output trigger will never be generated.
ON
An output trigger is generated for every new power measurement when the aver-
aging time period finishes.
Applies for all subsequent
data acquisition functions.
MEASure
AVGover
ON
An output trigger is generated for every new power measurement when the aver-
aging time period begins.
Applies for all subsequent
data
acquisition functions.
OFF
An output trigger is generated when the averaging An output trigger is generat-
time period of the first power measurement finish- ed for every new power mea-
es. A further hardware output trigger cannot be
generated until you send trig:outp:rearm.
surement when the
averaging time period finish-
es. Applies for all subsequent
data acquisition functions.
MEASure
OFF
An output trigger is generated when the averaging An output trigger is generat-
time period of the first power measurement begins. ed for every new power mea-
A further hardware output trigger cannot be gener- surement when the
ated until you send trig:outp:rearm.
averaging time period begins.
Applies for all subsequent
data acquisition functions.
command:
:TRIGger
syntax:
:TRIGger<wsp>NODEA|1|NODEB|2
Generates a hardware trigger.
description:
parameters:
1 or NODEA:
2 or NODEB:
Is identical to a trigger at the Input Trigger Connector.
Generates trigger at the Output Trigger Connector.
A hardware trigger cannot be effective in the DISabled triggering mode but can be
effective in DEFault, PASSthrough or LOOPback triggering modes, see
NOTE
NOTE
response:
example:
none
trig 1
172
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
Triggering - The TRIGger Subsystem
Measurement Operations & Settings
command:
:TRIGger[n][:CHANnel[m]]:INPut
syntax:
:TRIGger[n][:CHANnel[m]]:INPut<wsp><trigger response>
description:
parameters:
Sets the incoming trigger response and arms the module.
IGNore:
Ignore incoming trigger.
SMEasure:
Start a single measurement. If a measurement function is active, see
performed and the result is stored in the data array, see
Start a complete measurement. If a measurement function is active,
measurement function is performed.
CMEasure:
NEXTstep:
SWStart:
Perform next step of a stepped sweep.
Start a sweep cycle.
You must prearm a wavelength sweep or a measurement function before an action
can be triggered:
NOTE
First, set the incoming trigger response.
Then:
• prearm a wavelength sweep using
wavelength of the tunable laser module is set to the start wavelength of the
sweep.
• or prearm a measurement function using
NOTE: If a trigger signal arrives at the Input Trigger Connector at the same time
first measurement value is invalid. You should always discard the first
measurement value in this case.
The module performs the appropriate action when it is triggered.
response:
example:
affects:
none
trig1:inp ign
All Agilent 8163A/B series power meter modules, Agilent 8161x series return loss modules,
and attenuators with power control.
If you use the Agilent 816x VXIplug&play Instrument Driver, you can trigger power measure-
ments using HP 8153A Series power meters.
NOTE
dual sensors:
Can only be sent to master channel, slave channel is also affected.
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
173
Download from Www.Somanuals.com. All Manuals Search And Download.
Measurement Operations & Settings
Triggering - The TRIGger Subsystem
command:
:TRIGger[n][:CHANnel[m]]:INPut?
syntax:
:TRIGger[n][:CHANnel[m]]:INPut?
Returns the incoming trigger response.
none
description:
parameters:
response:
IGNore:
Ignore incoming trigger.
SMEasure:
Start a single measurement. If a measurement function is active, see
performed and the result is stored in the data array, see
Start a complete measurement. If a measurement function is active, see
surement function is performed.
CMEasure:
NEXTstep:
SWStart:
Perform next step of a stepped sweep.
Start a sweep.
example:
affects:
trig1:inp? → ign<END>
All tunable laser modules, power meters, and return loss modules, and attenuators with
power control.
dual sensors:
Can only be sent to master channel, slave channel parameters are identical.
command:
:TRIGger[n][:CHANnel[m]]:INPut:REARm
syntax:
:TRIGger[n][:CHANnel[m]]:INPut:REARm<wsp>OFF|ON|0|1
Sets the arming response of a channel to an incoming trigger.
description:
NOTE
measurements.
parameters:
A boolean value:
OFF or 0: trigger rearming disabled
ON or 1: trigger rearming enabled (default)
If you return to Local control, all modules return to the default setting.
NOTE
response:
example:
none
trig1:inp:rearm 0
affects:
All Agilent 8163A/B series power meter modules, and Agilent 8161x series return loss mod-
ules.
dual sensors:
Can only be sent to master channel, slave channel is also affected.
174
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
Triggering - The TRIGger Subsystem
Measurement Operations & Settings
command:
:TRIGger[n][:CHANnel[m]]:INPut:REARm?
:TRIGger[n][:CHANnel[m]]:INPut:REARm?
syntax:
description:
parameters:
response:
Returns the arming response of a channel to an incoming trigger.
none
A boolean value:
0: trigger rearming disabled
1: trigger rearming enabled (default)
example:
affects:
trig1:inp:rearm? → 0<END>
All Agilent 8163A/B series power meter modules, and Agilent 8161x series return loss mod-
ules.
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>
Sets the number of incoming triggers received before data logging begins.
<value> - an integer value. (maximum possible value is 1e+9)
none
description:
parameters:
response:
example:
affects:
trig1:offs 5
All Agilent 81636B and 81637B series power meter modules.
command:
:TRIGger[n][:CHANnel[m]]:OFFSet?
:TRIGger[n][:CHANnel[m]]:OFFSet?
Returns the number of incoming triggers received before data logging begins.
none
syntax:
description:
parameters:
response:
example:
affects:
an integer value.
trig1:offs? → 5<END>
All Agilent 81636B and 81637B series power meter modules.
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
175
Download from Www.Somanuals.com. All Manuals Search And Download.
Measurement Operations & Settings
Triggering - The TRIGger Subsystem
command:
:TRIGger[n][:CHANnel[m]]:OUTPut
:TRIGger[n][:CHANnel[m]]:OUTPut
Specifies when an output trigger is generated and arms the module.
syntax:
description:
parameters:
DISabled:
Never.
AVGover:
When averaging time period finishes.
When averaging time period begins.
For every leading edge of a digitally-modulated (TTL) signal
When a sweep step finishes.
When sweep cycle finishes.
When a sweep cycle starts.
MEASure:
MODulation:
STFinished:
SWFinished:
SWSTarted:
response:
example:
affects:
none
trig1:outp dis
All tunable laser modules, Agilent 8163A/B series power meters, and Agilent 8161x series
return loss modules.
dual sensors:
Can only be sent to master channel, slave channel is also affected.
NOTE
command:
:TRIGger[n][:CHANnel[m]]:OUTPut?
:TRIGger[n][:CHANnel[m]]:OUTPut?
Returns the condition that causes an output trigger.
none
syntax:
description:
parameters:
response:
DISabled:
Never.
AVGover:
When averaging time period finishes.
When averaging time period begins.
For every leading edge of a digitally-modulated (TTL) signal
When a sweep step finishes.
When sweep cycle finishes.
When a sweep cycle starts.
MEASure:
MODulation:
STFinished:
SWFinished:
SWSTarted:
example:
affects:
trig1:outp? → dis<END>
All tunable laser modules, Agilent 8163A/B series power meters, and Agilent 8161x series
return loss modules.
dual sensors:
Can only be sent to master channel, slave channel parameters are identical.
176
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
Triggering - The TRIGger Subsystem
Measurement Operations & Settings
command:
:TRIGger[n][:CHANnel[m]]:OUTPut:REARm
:TRIGger[n][:CHANnel[m]]:OUTPut:REARm<wsp>OFF|ON|0|1
syntax:
description:
Sets the arming response of a channel to an outgoing trigger.
output triggers using power measurements.
NOTE
parameters:
NOTE
A boolean value:
OFF or 0: trigger rearming disabled
ON or 1: trigger rearming enabled (default)
If you return to Local control, all modules return to the default setting.
response:
example:
affects:
none
trig1:outp:rearm 1
All Agilent 8163A/B series power meters, and Agilent 8161x series return loss modules.
Can only be sent to master channel, slave channel is also affected.
dual sensors:
command:
:TRIGger[n][:CHANnel[m]]:OUTPut:REARm?
:TRIGger[n][:CHANnel[m]]:OUTPut:REARm?
Returns the arming response of a channel to an outgoing trigger.
none
syntax:
description:
parameters:
response:
A boolean value:
0: trigger rearming disabled (default)
1: trigger rearming enabled.
example:
trig1:outp:rearm? → 0<END>
affects:
All Agilent 8163A/B series power meters, and Agilent 8161x series return loss modules.
Can only be sent to master channel, slave channel parameters are identical.
dual sensors:
command:
:TRIGger:CONFiguration
syntax:
:TRIGger:CONFiguration<wsp><triggering mode>
description:
parameters:
Sets the hardware trigger configuration with regard to Output and Input Trigger Connectors.
0 or DISabled:
1 or DEFault:
Trigger connectors are disabled.
The Input Trigger Connector is activated, the incoming trigger response
mines how each slot responds to an incoming trigger, all slot events
Output Trigger Connector.
2 or PASSthrough: The same as DEFault but a trigger at the Input Trigger Connector gener-
ates a trigger at the Output Trigger Connector automatically.
3 or LOOPback:
The same as DEFault but a trigger at the Output Trigger Connector gen-
erates a trigger at the Input Trigger Connector automatically.
response:
example:
none
trig:conf dis
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
177
Download from Www.Somanuals.com. All Manuals Search And Download.
Measurement Operations & Settings
Triggering - The TRIGger Subsystem
command:
:TRIGger:CONFiguration?
syntax:
:TRIGger:CONFiguration?
Returns the hardware trigger configuration.
none
description:
parameters:
response:
DIS:
Trigger connectors are disabled.
DEF:
The Input Trigger Connector is activated, the incoming trigger response for
each slot responds to an incoming trigger, all slot events (see
ger Connector.
PASS:
The same as DEFault but a trigger at the Input Trigger Connector generates a
trigger at the Output Trigger Connector automatically.
LOOP:
The same as DEFault but a trigger at the Output Trigger Connector generates a
trigger at the Input Trigger Connector automatically.
CUSTOM:
A custom configuration is active using either the command
example:
trig:conf? → DEF<END>
command:
:TRIGger:CONFiguration:FPEDal
syntax:
:TRIGger:CONFiguration:FPEDal<wsp>OFF|ON|0|1
Enables or disables the Input Trigger connector to be triggered using a Foot Pedal.
description:
parameters:
A boolean value:
OFF or 0: foot pedal disabled (default)
ON or 1: foot pedal enabled
response:
example:
none
trig:conf? → DEF<END>
command:
:TRIGger:CONFiguration:FPEDal?
syntax:
:TRIGger:CONFiguration:FPEDal?
description:
parameters:
response:
Returns whether the Input Trigger connector can be triggered using a Foot Pedal.
none
A boolean value:
0: foot pedal disabled
1: foot pedal enabled
example:
trig:conf? → DEF<END>
178
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
Triggering - The TRIGger Subsystem
Measurement Operations & Settings
Extended Trigger Configuration
This section includes information for advanced users about how to
customize your use of the trigger system.
You can configure the ouputs and inputs from two nodes, Node A and
Node B. You can configure these nodes to be triggered by certain events
and for these nodes to trigger particular actions.
command:
:TRIGger
:TRIGger<wsp>NODEA|1|NODEB|2
syntax:
description:
parameters:
Generates a hardware trigger.
1 or NODEA:
2 or NODEB:
Generates trigger at Node A.
Generates trigger at Node B.
NOTE
response:
example:
none
trig 1
command:
syntax:
:TRIGger:CONFiguration:EXTended
:TRIGger:CONFiguration:EXTended<wsp><Node A Input Config.>,
<Node B Input Config.>,<Output Matrix Config.>
description:
parameters:
Sets the extended hardware trigger configuration.
Node A Input Configuration:
Node B Input Configuration:
Output Matrix Configuration:
A 32-bit unsigned integer, see below.
A 32-bit unsigned integer, see below.
A 32-bit unsigned integer, see below.
response:
example:
none
trig:conf:ext 0,0,0
command:
:TRIGger:CONFiguration:EXTended?
syntax:
:TRIGger:CONFiguration:EXTended?
description:
parameters:
response:
Returns the extended hardware trigger configuration.
none
Node A Input Configuration:
Node B Input Configuration:
Output Matrix Configuration:
A 32-bit unsigned integer, see below.
A 32-bit unsigned integer, see below.
A 32-bit unsigned integer, see below.
example:
trig:conf:ext? → +0,+0,+0<END>
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
179
Download from Www.Somanuals.com. All Manuals Search And Download.
Measurement Operations & Settings
Triggering - The TRIGger Subsystem
:trig 1
Node A Input
Configuration
0
Slot 0 Event
0
Output Matrix
Configuration
Node A
0
0
0
Slot 17 Event
Input Trigger
Connector
Node B
0
Trigger Slot 0
Trigger Slot 1
0
:trig 2
0
Trigger Slot 16
Trigger Slot 17
Node B Input
Configuration
0
Output
Slot 0 Event
0
0
0
Trigger
Connector
0
Slot 17 Event
Input Trigger
Connector
Node A
Node B
0
0
Bits set in Node A/B Input Configuration determine the conditions that can cause a trigger at
Node A/B.
Bits set in Output Matrix Configuration determine whether Node A OR Node B triggers particular
module slots or generates an output trigger at the Output Trigger Connector.
“:TRIGger[n][:CHANnel[m]]:OUTPut” explains how slot events can generate triggers.
“:TRIGger[n][:CHANnel[m]]: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
180
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
Triggering - The TRIGger Subsystem
Measurement Operations & Settings
Node A Input Configuration
This 32-bit unsigned integer determines how inputs to Node A are generated.
Bit
Mnemonic
Hexadecimal
31
30
Logic: 0 for OR, 1 for AND
Input Trigger Connector: 0 - Inactive, 1 - Trigger at Input Trigger Connector can trigger #H40000000
Node A
#H80000000
29
Node B: 0 - Inactive, 1 - Trigger at Node B can trigger Node A
#H20000000
0
18-28 Not used.
17
16
Slot 17: 0 - Inactive, 1 - Event at slot 17 can trigger Node A
Slot 16: 0 - Inactive, 1 - Event at slot 16 can trigger Node A
#H20000
#H10000
2
1
0
Slot 2: 0 - Inactive, 1 - Event at slot 2 can trigger Node A
Slot 1: 0 - Inactive, 1 - Event at slot 1 can trigger Node A
Slot 0: 0 - Inactive, 1 - Event at slot 0 can trigger Node A
ate triggers.
#H4
#H2
#H1
Node B Input Configuration
This 32-bit unsigned integer determines how inputs to Node B are generated.
Bit
Mnemonic
Hexadecimal
31
30
Logic: 0 for OR, 1 for AND
Input Trigger Connector: 0 - Inactive, 1 - Trigger at Input Trigger Connector can trigger #H40000000
Node B
#H80000000
29
Node A: 0 - Inactive, 1 - Trigger at Node A can trigger Node B
#H20000000
0
18-28 Not used.
17
16
Slot 17: 0 - Inactive, 1 - Event at slot 17 can trigger Node B
Slot 16: 0 - Inactive, 1 - Event at slot 16 can trigger Node B
#H20000
#H10000
2
1
0
Slot 2: 0 - Inactive, 1 - Event at slot 2 can trigger Node B
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
#H4
#H2
#H1
ate triggers.
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
181
Download from Www.Somanuals.com. All Manuals Search And Download.
Measurement Operations & Settings
Triggering - The TRIGger Subsystem
Output Matrix Configuration
This 32-bit unsigned integer lets you choose Node A OR Node B to trigger each of the following:
• the Output Trigger Connector or
• individual module slots.
Bit
Mnemonic
Hexadecimal
31
30
Not used
0
Output Trigger Connector: 0 - a trigger at Node A is switched to the Output Trigger Con- #H40000000
nector, 1 - a trigger at Node B is switched to theOutput Trigger Connector
18-29 Not used
17
16
Slot 17: 0 - Node A triggers slot 17, 1 - Node B triggers slot 17
Slot 16: 0 - Node A triggers slot 16, 1 - Node B triggers slot 16
0
#H20000
#H10000
2
1
0
Slot 2: 0 - Node A triggers slot 2, 1 - Node B triggers slot 2
Slot 1: 0 - Node A triggers slot 1, 1 - Node B triggers slot 1
Slot 0: 0 - Node A triggers slot 0, 1 - Node B triggers slot 0
#H4
#H2
coming trigger.
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 Agilent 81689A modules
in slots 1 and 2. The example below presumes you set up identical stepped
sweeps for both modules, for example, by pressing PRESET.
Tunable Tunable
Laser
Laser
Figure 8 Setup for Extended Trigger Configuration Example
182
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
Triggering - The TRIGger Subsystem
Measurement Operations & Settings
trig:conf:ext #H2,#H0,#H0
trig2:outp dis
trig2:inp next
sour2:wav:swe star
trig1:outp stf
trig1:inp ign
sour1:wav:swe star
trig:conf:ext #H2,#H0,#H0 is described by Figure 4-1 and sets one bit:
•
for Node A Input Configuration:
• Bit 1 - an event at slot 1 can trigger Node A. As trig1:outp stf is set, Node A
can be triggered if a sweep step finishes for a tunable laser module installed
in slot 1.
The following explanation explains the sequence with which actions are
triggered.
1
sour2:wav:swe star arms the sweep for for the tunable laser module in slot 2.
Because trig2:inp next is set, the module waits for a trigger until it performs the
first step of the sweep.
2
sour1:wav:swe star commands the tunable laser module in slot 1 to
start sweeping. Because trig1:inp ign is set, the module performs a
sweep as normal.
3
4
When the module in slot 1 finishes a step, because trig1:outp stf is set,
Node A is triggered.
Node A triggers all modules because the Output Matrix Configuration is
set to zero. 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.
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
183
Download from Www.Somanuals.com. All Manuals Search And Download.
Measurement Operations & Settings
Triggering - The TRIGger Subsystem
184
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
Mass Storage, Display, and Print Functions
Display Operations – The DISPlay Subsystem
Display Operations – The
DISPlay Subsystem
The DISPlay subsystem lets you control what you see on the instrument’s
display.
command:
:DISPlay:CONTrast
:DISPlay:CONTrast<wsp><value>
syntax:
description:
parameters:
response:
example:
affects:
Controls the contrast of the display.
An integer value in the range 0 to 100
none
disp:cont 50
Agilent 8163B Lightwave Multimeter and 8166B Lightwave Multichannel System
command:
:DISPlay:CONTrast?
syntax:
:DISPlay:CONTrast?
description:
parameters:
response:
example:
affects:
Queries the contrast of the display.
none
An integer value in the range 0 to 100
disp:cont? → +50<END>
Agilent 8163B Lightwave Multimeter and 8166B Lightwave Multichannel System
command:
:DISPlay:BRIGhtness
syntax:
:DISPlay:BRIGhtness<wsp><value>
Controls the brightness of the display.
An integer value in the range 0 to 100
none
description:
parameters:
response:
example:
affects:
disp:brig 75
Agilent 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)
186
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
Display Operations – The DISPlay Subsystem
Mass Storage, Display, and Print Functions
command:
:DISPlay:BRIGhtness?
syntax:
:DISPlay:BRIGhtness?
description:
parameters:
response:
example:
affects:
Queries the brightness of the display.
none
An integer value in the range 0 to 100
disp:brig? → +75<END>
Agilent 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)
command:
:DISPlay:ENABle
syntax:
:DISPlay:ENABle<wsp>ON|OFF|1|0
description:
Enables or disables the display.
The display is cleared, and an appropriate message displayed. This setting may improve
sweep performance.
parameters:
A boolean value:
OFF or boolean 0 – switch off the display
ON or boolean 1 – switch on the display
If you press [LOCAL] softkey, the display is enabled automatically.
NOTE
response:
example:
none
disp:enab 1
command:
:DISPlay:ENABle?
:DISPlay:ENABle?
Queries the state of the display.
none
syntax:
description:
parameters:
response:
A boolean value:
0 – the display is turned off
1 – the display is turned on
example:
disp:enab? → 1<END>
command:
:DISPlay:LOCKout
syntax:
:DISPlay:LOCKout<wsp>ON|OFF|1|0
Enables or Disables local operation.
description:
parameters:
A boolean value:
OFF or boolean 0 – local operation is disabled
ON or boolean 1 – local operation is enabled.
response:
example:
none
disp:lock 1<END>
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
187
Download from Www.Somanuals.com. All Manuals Search And Download.
Mass Storage, Display, and Print Functions
Display Operations – The DISPlay Subsystem
command:
:DISPlay:LOCKout?
syntax:
:DISPlay:LOCKout?
description:
parameters:
response:
Queries whether local operation is locked out.
none
A boolean value:
0 – local operation is disabled
1 – local operation is enabled.
example:
disp:lock → 1<END>
188
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
6
VISA Programming Examples
These programming examples are implemented using MS Developer
Studio. Regardless of the programming environment you use, keep the
following in mind:
• The resultant application is a "console application"
• Make sure the header files visa.h and visatype.h are included.
• Make sure the library path includes visa32.lib
• Ensure that the PATH environment variable allows loading visa32.dll
.
The programming examples do not cover the full command set for the
instruments. 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.
Never use VISA calls and the Agilent 816x VXIplug&play Instrument Driver
in the same program.
NOTE
TIP: Additional programming examples are provided on the Support Disk
CD-ROM 08164-90BC4
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
189
Download from Www.Somanuals.com. All Manuals Search And Download.
VISA Programming Examples
How to Use VISA Calls
How to Use VISA Calls
The following example demonstrates how to communicate using VISA
calls. Also, the use of instrument identification commands is
demonstrated.
#include <stdio.h>
#include <stdlib.h>
#include <visa.h>
/* This function checks and displays errors, using the error query of
the instrument;
Call this function after every command to make sure your commands
are correct */
void checkError(ViSession session, ViStatus err_status )
{
ViStatus error;
ViChar errMsg[256];
/* queries what kind of error occurred */
error = viQueryf(session,"%s\n","%t","SYST:ERR?",errMsg);
/*if this command times out, a system error is probable;
check the GPIB bus communication */
if (error == VI_ERROR_TMO)
{
printf("System Error!\n") ;
exit(1);
}
else
{
/* display the error number and the error message */
if(errMsg[0] != '+')
printf("error:%ld --> %s\n", err_status,errMsg) ;
}
}
void main (void)
{
ViStatus
ViSession
ViSession
errStatus;
defaultRM;
vi;
/*return error code from visa call */
/*default visa resource manager variable*/
/*current session handle */
ViChar
replyBuf[256]; /*buffer holding answers from the
instrument*/
ViChar
c;
190
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
How to Use VISA Calls
VISA Programming Examples
/* Initialize visa resource manger */
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; the VI_NULL
parameters 3,4
are mandatory and not used for VISA 1.0*/
errStatus = viOpen (defaultRM, "GPIB::20::INSTR",
VI_NULL,VI_NULL,&vi);
if(errStatus < VI_SUCCESS)
{ printf("Failed to open instrument\n");
exit(errStatus);
}
/* set timeout to 20 sec; this should work for all commands except
for zeroing or READ commands with averaging times greater than the
timeout */
errStatus = viSetAttribute(vi,VI_ATTR_TMO_VALUE,20000);
checkError(vi,errStatus);
/* get the identification string of the instrument mainframe*/
errStatus = viQueryf(vi,"%s\n","%t","*IDN?",replyBuf);
if(errStatus < VI_SUCCESS)
{ checkError(vi,errStatus); }
else printf("%s",replyBuf);
/* identify the installed modules */
errStatus = viQueryf(vi,"%s\n","%t","*OPT?",replyBuf);
if(errStatus < VI_SUCCESS)
{ checkError(vi,errStatus); }
else printf("%s",replyBuf);
/* 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);
}
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
191
Download from Www.Somanuals.com. All Manuals Search And Download.
VISA Programming Examples
How to Set up a Fixed Laser Source
How to Set up a Fixed Laser
Source
This example sets up a fixed laser source.
Install a Laser Source in Slot 2, before executing this example.
#include <stdio.h>
#include <stdlib.h>
#include <visa.h>
/* function prototypes for this examples */
/* function for simple error handling explained in example 1 */
void checkError(ViSession session, ViStatus err_status );
void main (void)
{
ViStatus
errStatus;
/* returned error code from visa call */
/* default visa resource manager
ViSession
variable*/
defaultRM;
ViSession
ViChar
vi;
c;
/* current session handle */
/* used in the keyboard wait loop */
/* wavelength of the laser source */
ViReal32 wavelength;
/* initialize 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;*/
errStatus = viOpen (defaultRM, "GPIB::20::INSTR",
VI_NULL,VI_NULL,&vi);
if(errStatus < VI_SUCCESS)
{
printf("Failed to open instrument\n");
exit(errStatus);
}
/*set timeout to 20 sec; this should work for all commands except
zeroing */
192
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
How to Set up a Fixed Laser Source
VISA Programming Examples
errStatus = viSetAttribute(vi,VI_ATTR_TMO_VALUE,20000);
if (errStatus < VI_SUCCESS) checkError(vi,errStatus);
/* first get the wavelength of the laser source; to address the
second channel of a dual laser source use "CHAN2" instead of
"CHAN1"*/
errStatus =
viQueryf(vi,"%s","%f","SOURCE2:CHAN1:WAV?\n",&wavelength);
if (errStatus < VI_SUCCESS) checkError(vi,errStatus);
else
{ printf("Source Wavelength:%g\n",wavelength); }
/* to receive the maximum power the attenuation must be set to
zero */
errStatus = viPrintf(vi,"SOURCE2:CHAN1:ATT 0\n");
if (errStatus < VI_SUCCESS) checkError(vi,errStatus);
/* turn off amplitude modulation */
errStatus = viPrintf(vi,"SOURCE2:CHAN1:AM:STATE 0\n");
if (errStatus < VI_SUCCESS) checkError(vi,errStatus);
/* turn the laser on */
errStatus = viPrintf(vi,"SOURCE2:CHAN1:POW:STATE 1\n");
if (errStatus < VI_SUCCESS) checkError(vi,errStatus);
/* loop, until a key is pressed */
while(!scanf("%c",&c));
/* 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 )
{
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
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
193
Download from Www.Somanuals.com. All Manuals Search And Download.
VISA Programming Examples
How to Set up a Fixed Laser Source
{
/* only errors should be displayed */
if(errMsg[0] != '+')
printf("error:%ld --> %s\n", err_status,errMsg) ;
}
}
194
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
How to Measure Power using FETCh and READ
VISA Programming Examples
How to Measure Power using
FETCh and READ
The example shows the difference between a "FETCh" and a "READ"
command.
Install a power meter in Slot 1, before executing this example.
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <visa.h>
/* function prototypes for this examples */
/* function for a simple error handling explained in example 1 */
void checkError(ViSession session, ViStatus err_status );
void main (void)
{
ViStatus
errStatus;
/* returned error code from visa call */
/* default visa resource manager
ViSession
defaultRM;
variable */
ViSession
vi;
/* current session handle */
ViChar
replyBuf[256]; /* buffer holding answers of the
instrument*/
ViChar
ViChar
ViReal64
ViInt32
compBuf[256]; /* buffer used for comparsion */
c;
averagingTime; /* averaging time */
i; /* loop counter */
/* used in the keyboard wait loop */
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);
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
195
Download from Www.Somanuals.com. All Manuals Search And Download.
VISA Programming Examples
How to Measure Power using FETCh and READ
}
/*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);
/* make sure that the reference is not used */
errStatus = viPrintf(vi,"SENS1:CHAN1:POW:REF:STATE 0\n");
if (errStatus < VI_SUCCESS) checkError(vi,errStatus);
/* clear the error queue */
errStatus = viPrintf(vi,"*CLS\n");
if (errStatus < VI_SUCCESS) checkError(vi,errStatus);
/* turn auto range on */
errStatus = viPrintf(vi,"SENS1:CHAN1:POW:RANGE:AUTO 1\n");
if (errStatus < VI_SUCCESS) checkError(vi,errStatus);
/* change the power unit to watt */
errStatus = viPrintf(vi,"SENS1:CHAN1:POW:UNIT W\n");
if (errStatus < VI_SUCCESS) checkError(vi,errStatus);
/*set the averaging time for measuring to 0.5s*/
averagingTime = 0.5;
errStatus = viPrintf(vi,"SENS1:CHAN1:POW:ATIME
%f\n",averagingTime);
if (errStatus < VI_SUCCESS) checkError(vi,errStatus);
/* turn continous measuring off */
errStatus = 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);
/* 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);
/* two consecutive values are compared; if they are equal it will be
marked; because no evaluation is triggered, all values will be the same
*/
if(i)
196
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
How to Measure Power using FETCh and READ
VISA Programming Examples
{ if(!strcmp(compBuf,replyBuf))
{ printf("Same:%s\n",replyBuf); }
else printf("New:%s\n",replyBuf);
}
else printf("First:%s\n",replyBuf);
strcpy(compBuf,replyBuf);
}
/* now the read command is used in the same manner to
demonstrate the difference between fetch and read */
/* read also 10 values, compare them and display the result; */
for (i = 0; i < 10; i++)
{
/* In comparision to the "FETCH" command, the "READ" command
implies
triggering a measurement. Make sure the timeout set is
greater than the adjusted averaging time, so that the READ command
will not time out; */
/* send the read command */
errStatus = viQueryf(vi,"READ1:CHAN1:POW?\n","%t",replyBuf);
checkError(vi,errStatus);
if(i)
{
if(!strcmp(compBuf,replyBuf)) printf("Same:%s",replyBuf);
else printf("New :%s",replyBuf);
}
else printf("\nFirst:%s",replyBuf);
/*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;
ViChar errMsg[256];
error = viQueryf(session,"SYST:ERR?\n","%t",errMsg);
if (error == VI_ERROR_TMO)
{
printf("System Error!\n") ;
exit(1);
}
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
197
Download from Www.Somanuals.com. All Manuals Search And Download.
VISA Programming Examples
How to Measure Power using FETCh and READ
else
{
/* only errors should be displayed */
if(errMsg[0] != '+')
printf("error:%ld --> %s\n", err_status,errMsg) ;
}
}
198
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
How to Co-ordinate Two Modules
VISA Programming Examples
How to Co-ordinate Two
Modules
This example shows the interaction of two modules in the same frame.
Install a Power Sensor in Slot 1 and a Laser Source in Slot 2 and connect
the Laser Source output to the Power Sensor input, before executing this
example.
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <visa.h>
/* function prototypes for this examples */
/* function for a simple error handling explained in example 1 */
void checkError(ViSession session, ViStatus err_status );
void main (void)
{
ViStatus
errStatus;
defaultRM;
/* returned error code from visa call */
/* default visa resource manager variable
ViSession
*/
ViSession
ViChar
vi;
/* current session handle */
replyBuf[256]; /* buffer holding answers of the
instrument */
ViChar
c;
i;
cmdDone;
/* used in the keyboard wait loop */
/* loop counter */
ViInt32
ViInt32
/* return value for OPC command */
/* 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; */
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
199
Download from Www.Somanuals.com. All Manuals Search And Download.
VISA Programming Examples
How to Co-ordinate Two Modules
errStatus = viOpen (defaultRM, "GPIB::20::INSTR",
VI_NULL,VI_NULL,&vi);
if(errStatus < VI_SUCCESS)
{
printf("Failed to open instrument\n");
exit(errStatus);
}
/* 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 */
errStatus = viPrintf(vi,"*CLS\n");
checkError(vi,errStatus);
/* read the wavelength from the laser source */
errStatus = viQueryf(vi,"SOURCE2:CHAN1:WAV?\n","%s",replyBuf);
checkError(vi,errStatus);
/* feed the source wavelength into the power meter making
sure to measure the maximum power of the source */
errStatus = viPrintf(vi,"SENS1:CHAN1:POW:WAV %s\n",replyBuf);
checkError(vi,errStatus);
/* turn auto range on */
errStatus = viPrintf(vi,"SENS1:CHAN1:POW:RANGE:AUTO 1\n");
checkError(vi,errStatus);
/* change the power unit of the power meter to dBm */
errStatus = viPrintf(vi,"SENS1:CHAN1:POW:UNIT 0\n");
checkError(vi,errStatus);
/*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);
/* set the reference mode to the internal one,
which is now the last displayed value */
200
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
How to Co-ordinate Two Modules
VISA Programming Examples
errStatus = viPrintf(vi,"SENS1:CHAN1:POW:REF:STATE:RATIO
TOREF,0\n");
checkError(vi,errStatus);
/* set reference measuremant state to absolute units */
errStatus = viPrintf(vi,"SENS1:CHAN1:POW:REF:STAT 1\n");
checkError(vi,errStatus);
/* turn laser on */
errStatus = viPrintf(vi,"SOURCE2:CHAN1:POW:STATE 1\n");
checkError(vi,errStatus);
/*ask for command completion */
do
{
errStatus = 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");
checkError(vi,errStatus);
/*
read 30 values and display the result; after ten measurements
the source output will be halved by making use of the
attenuation;
after an other ten measurements the source output will be
halved
a second time;
because of the display to reference command and using the
reference, the value printed should be more or less equal to the
adjusted source attenuation */
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);
if(i == 10)
{
/* reduce the output power for 3.0 dB */
errStatus = viPrintf(vi,"SOURCE2:CHAN1:POW:ATT 3.0\n");
checkError(vi,errStatus);
}
if(i == 20)
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
201
Download from Www.Somanuals.com. All Manuals Search And Download.
VISA Programming Examples
How to Co-ordinate Two Modules
{
/* reduce the output power for 6.0 dB */
errStatus = viPrintf(vi,"SOURCE2:CHAN1:POW:ATT 6.0\n");
checkError(vi,errStatus);
}
}
/* loop, until a key is pressed */
while(!scanf("%c",&c));
/* 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 )
{
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 */
if(errMsg[0] != '+')
printf("error:%ld --> %s\n", err_status,errMsg) ;
}
}
202
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
How Power Varies with Wavelength
VISA Programming Examples
How Power Varies with
Wavelength
This example shows how the measured power depends on wavelength.
Install a Power Sensor in Slot 1 and a Tunable Laser Source in Slot 2 and
connect the Tunable Laser Source output to the Power Sensor input,
before executing this example.
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <visa.h>
/* function prototypes for this examples*/
/* function for a simple error handling explained in example 1 */
void checkError(ViSession session, ViStatus err_status );
void main (void)
{
ViStatus
errStatus;
/* returned error code from visa call */
/* default visa resource manager
ViSession
variable*/
defaultRM;
ViSession
vi;
/* current session handle */
ViChar
replyBuf[256]; /*buffer holding answers of the
instrument */
ViChar
c;
/* used in the keyboard wait loop */
/* used to hold the wavelength of the
ViReal64
wavelength;
tunable laser source */
ViReal64 wavelength_max;
/*used to hold the maximum
wavelength of the tunable laser source*/
ViInt32
ViInt32
i;
/* loop counter */
cmdDone;
/* return value for OPC command */
errStatus = viOpenDefaultRM (&defaultRM);
if(errStatus < VI_SUCCESS)
{
printf("Failed to open VISA Resource manager\n");
exit(errStatus);
}
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
203
Download from Www.Somanuals.com. All Manuals Search And Download.
VISA Programming Examples
How Power Varies with Wavelength
errStatus = viOpen (defaultRM, "GPIB::20::INSTR",
VI_NULL,VI_NULL,&vi);
if(errStatus < VI_SUCCESS)
{
printf("Failed to open instrument\n");
exit(errStatus);
}
/*set timeout to 20 sec; this should work for all commands
except zeroing */
errStatus = viSetAttribute(vi,VI_ATTR_TMO_VALUE,20000);
checkError(vi,errStatus);
errStatus = viPrintf(vi,"*CLS\n");
checkError(vi,errStatus);
/* read the minimum wavelength from the tunable laser source*/
errStatus = viQueryf(vi,"SOURCE2:WAV? MIN\n","%s",replyBuf);
checkError(vi,errStatus);
/* save this wavelength */
wavelength = atof(replyBuf);
/* set the minimum wavelength as initial wavelength in the tunable
laser source */
errStatus = viPrintf(vi,"SOURCE2:WAV %s\n",replyBuf);
checkError(vi,errStatus);
/* 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 */
wavelength_max = atof(replyBuf);
/* change the power unit of the power meter to dbm */
errStatus = viPrintf(vi,"SENS1:CHAN1:POW:UNIT DBM\n");
checkError(vi,errStatus);
204
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
How Power Varies with Wavelength
VISA Programming Examples
/* read the default power from the tunable laser source */
errStatus = viQueryf(vi,"SOURCE2:POW? DEF\n","%s",replyBuf);
checkError(vi,errStatus);
/* set the default power */
errStatus = viPrintf(vi,"SOURCE2:POW %s\n",replyBuf);
checkError(vi,errStatus);
/* turn auto range on*/
errStatus = viPrintf(vi,"SENS1:CHAN1:POW:RANGE:AUTO 1\n");
checkError(vi,errStatus);
/*set the averaging time for measuring to 20ms*/
errStatus = viPrintf(vi,"SENS1:CHAN1:POW:ATIME 0.02\n");
checkError(vi,errStatus);
/* turn laser on */
errStatus = viPrintf(vi,"SOURCE2:POW:STATE 1\n");
checkError(vi,errStatus);
/* increase the wavelength of the tunable laser source 10 nm
until the maximum is reached.
read the results from the power meter and display it */
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 */
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*/
errStatus = viPrintf(vi,"SOURCE2:WAV %g\n",wavelength);
/*
poll the instrument for completion of this command
because adjusting a new wavelength takes some time
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
205
Download from Www.Somanuals.com. All Manuals Search And Download.
VISA Programming Examples
How Power Varies with Wavelength
*/
do
{
errStatus = viQueryf(vi,"*OPC?\n","%d",&cmdDone);
checkError(vi,errStatus);
} while (!cmdDone);
}
/* loop, until a key is pressed */
while(!scanf("%c",&c));
/* 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
{
/* only errors should be displayed */
if(errMsg[0] != '+')
printf("error:%ld --> %s\n", err_status,errMsg) ;
}
}
206
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
How to Log Results
VISA Programming Examples
How to Log Results
This example demonstrates how to use logging functions.
Install a Power Sensor in Slot 1, before executing this example.
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <visa.h>
#define MAX_LOG_VALUES 4000 /* max number of values the
instrument is able to log */
#define HEADER_SIZE
7
/* includes 6 bytes header and 1 CR */
/* function prototypes for this examples/*
/* function for a simple error handling explained in example 1 */
void
checkError(ViStatus session, ViStatus err_status );
/* initialize the visa interface */
ViStatus InitVisa ( ViSession *iHandle);
/*globals*/
static unsigned char logBuffer[MAX_LOG_VALUES * sizeof(ViReal64) +
HEADER_SIZE];
/*array for the float results */
static ViReal32 logResults[MAX_LOG_VALUES];
void main (void)
{
ViStatus
errStatus;
vi;
/* returned error code from visa call */
/* current session handle */
ViSession
ViChar
replyBuf[256]; /* buffer holding answers from the
instrument */
ViChar
c;
/* used in the keyboard wait loop */
ViInt32
slot;
/* slot number where the power meter is
plugged */
ViInt32
ViInt32
ViInt32
chan;
/* channel to be logged */
/* loop counter */
i;
noOfValues;
/* number of values to be logged*/
ViReal64
*/
averagingTime; /* aveaging time used in a logging cycle
ViPChar
replySubStr; /* pointer to a substring of the
instruments reply */
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
207
Download from Www.Somanuals.com. All Manuals Search And Download.
VISA Programming Examples
How to Log Results
ViInt32
data
noOfDigits;
retCnt;
/*number of digits, specifing the amount
/* returns the number of bytes read
to be read */
ViUInt32
calling viRead */
errStatus = InitVisa(&vi);
if(errStatus < VI_SUCCESS)
{
exit(errStatus);
}
/* clear instrument error queue */
errStatus = viPrintf(vi,"*CLS\n");
checkError(vi,errStatus);
/* turn auto range on */
errStatus = viPrintf(vi,"SENS1:CHAN1:POW:RANGE:AUTO 1\n");
checkError(vi,errStatus);
/* send the command sequence for continuous logging */
slot = 1;
chan = 1;
noOfValues = 100;
/* log 100 values */
averagingTime = 0.02; /* set averaging time to 20ms */
viPrintf(vi,"SENS%1d:CHAN%1d:FUNC:PAR:LOGG %d,%f\n",
slot,
chan,
noOfValues,
averagingTime);
checkError(vi,errStatus);
/* 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
*/
do
{
errStatus =
viQueryf(vi,"SENS%1d:CHAN%1d:FUNC:STATE?\n","%t",slot,chan,replyBuf
);
/* if an error occurs break the loop */
if (errStatus < VI_SUCCESS)
{
checkError(vi,errStatus);
208
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
How to Log Results
VISA Programming Examples
break;
}
/* 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 */
/* The instrument returns the logging result in the following format:
#xyyyffff...; the first digits after the hash denotes the number of ascii
digits following (y) ; y specifies the number of binary data following;
"ffff" represent the 32Bit floats as log result. */
/* get the result */
errStatus =
viPrintf(vi,"SENS%1d:CHAN%1d:FUNC:RES?\n",slot,chan);
/* only query an error, if there is one, else the query will be
interrupted ! */
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
{
noOfDigits = logBuffer[1] -'0';
memcpy( logResults, &logBuffer[2 + noOfDigits ],
MAX_LOG_VALUES * sizeof(ViReal32));
}
/* stop logging */
viPrintf(vi,"SENS%1d:CHAN%1d:FUNC:STAT
LOGG,STOP\n",slot,chan);
checkError(vi,errStatus);
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
209
Download from Www.Somanuals.com. All Manuals Search And Download.
VISA Programming Examples
How to Log Results
/* display the values using %g, a float format specifier, you may
also use %e or %f */
for ( i = 0; i < noOfValues; i++)
printf("\t%g\n",logResults[i]);
/* loop, until a key is pressed */
while(!scanf("%c",&c));
/* close the session */
viClose(vi);
}
void checkError(ViStatus 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 */
if(errMsg[0] != '+')
{
printf("error:%ld --> %s\n", err_status,errMsg) ;
if
((!strncmp(errMsg,
"-303,\"Module slot empty or slot / channel invalid\"",
strlen("-303,\"Module slot empty or slot / channel invalid\"")))
||
(!strncmp(errMsg,
"-301,\"Module doesn't support this command
(StatCmdUnknown)\"",
strlen(
"-301,\"Module doesn't support this command
(StatCmdUnknown)\""))))
{
printf("No power meter in slot 1 so exiting\n\n");
exit(1);
}
}
}
}
ViStatus InitVisa ( ViSession *iHandle)
210
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
How to Log Results
VISA Programming Examples
{
ViStatus
errStatus;
/* returned error code from visa call */
/* default visa resource manager variable
ViSession defaultRM;
*/
/* First get initialized the visa library (see example 1) */
errStatus = viOpenDefaultRM (&defaultRM);
if (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;
}
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
211
Download from Www.Somanuals.com. All Manuals Search And Download.
VISA Programming Examples
How to Log Results
212
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
7
The Agilent 816x VXIplug&play Instrument
Driver
This chapter gives you extra information about installing and getting
started with the Agilent 816x VXIplug&play instrument driver.
There are details about opening and closing an instrument session, data
types and constants used, error handling, and the programming
environments supported.
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
213
Download from Www.Somanuals.com. All Manuals Search And Download.
The Agilent 816x VXIplug&play Instrument Driver
Installing the Agilent 816x Instrument Driver
Installing the Agilent 816x
Instrument Driver
The Agilent 816x VXIplug&play Instrument Driver comes as a self-
extracting archive with an installation wizard. The installation wizard
extracts all the files to preset destinations, asking you appropriate
questions as it does so.
You install the driver by running the executable hp816x.exe.
1 Run hp816x.exe,
The welcome screen for the InstallShield Wizard used to install the
Agilent 816x VXIplug&play Instrument Driver is displayed.
2 Press Next> to continue.
Specify the folder to which files will be saved.
3 Press Next> to continue.
Files are copied and extracted.
If necessary, a dialog requests your premission to overwrite existing
files.
The vesrion number of the instrument driver is displayed.
You may now elect to skip installation at this PC. Copy the extracted
disk images to floppy, and use them to install the instrument driver at
another PC.
4 Press OK> to continue.
If you are not an administrator, you see a VXIplug&play window, and a
message telling you that if you proceed with the installation, some
information will NOT be visible to all users. This means that any
program menu options will only be available to the user that performed
the installation. If you are the administrator all program menu options
will be visible for all users.
214
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
Installing the Agilent 816x Instrument Driver
The Agilent 816x VXIplug&play Instrument Driver
press No and contact your administrator.
Figure 9 Non-Administrator Installation Pop-Up Box
If Agilent 816x VXIplug&play Instrument Driver is already installed on your
system, you see a message asking you if you want to uninstall the old
version.
NOTE
Press Yes, if required, then wait until you see a message telling you that
the uninstall has been successful. You may be asked for permission to
remove shared files.
Then press OK to continue.
programs that you have running.
Figure 10 Welcome Screen
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
215
Download from Www.Somanuals.com. All Manuals Search And Download.
The Agilent 816x VXIplug&play Instrument Driver
Installing the Agilent 816x Instrument Driver
6 Close these programs and press Next> to continue. Then, you see a
message informing you if VISA is installed on your PC.
If you do not have VISA installed, press Cancel to temporarily exit this
installation procedure; install VISA on your PC, then run hp816x.exe again.
NOTE
If you have VISA installed, press Next> to continue. You see a window
that requests you to choose your Setup.
7 You can choose a Typical, Compact, or Custom Setup. Choose a setup
option and press Next> to continue.
If you choose the Custom Setup, you may choose the options you want to
NOTE
• VxiPnP Driver, you may choose to install the Agilent 816x VXIplug&play
instrument driver.
• Examples, you may choose to install Visual Basic, Visual C, LabView,
Agilent VEE and VISA programming examples.
• Help Files, you may choose to install the help file.
Figure 11 Customizing Your Setup
Select the components you want to install.
216
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
Installing the Agilent 816x Instrument Driver
The Agilent 816x VXIplug&play Instrument Driver
8 Press Next> to continue.
Specify the program folder required; the default choice is VXIPNP.
9 Press Next> to continue.
Review the settings that you have specified.
If you want to review or change any settings press Back>
10 Press Next> to continue.
The instrument driver is installed.
Figure 12 Program Folder Item Options
You may elect to:
• Automatically launch the Readme file, which provides the instrument
driver’s version history
• Include a help icon in your program folder, which launches on-line
documentation for the instrument driver
11 Press Finish to complete installation
If you elected to automatically launch the Readme file, it is displayed.
A webpage explaining how to get started with the Agilent 816x
VXIplug&play Instrument Driver using Agilent VEE or LabView appears.
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
217
Download from Www.Somanuals.com. All Manuals Search And Download.
The Agilent 816x VXIplug&play Instrument Driver
Using Visual Programming Environments
Using Visual Programming
Environments
Getting Started with Agilent VEE
Agilent Technologies Visual Engineering Environment (Agilent VEE) is a
visual programming language optimized for instrument control
applications. To develop programs in Agilent VEE, you connect graphical
‘objects’ instead of writing lines of code. These programs resemble easy-
to-understand block diagrams with lines.
Agilent VEE allows you to leverage your investment in textual languages
by integrating with languages such as C, C++, Visual Basic, FORTRAN,
Pascal, and Agilent BASIC.
Agilent VEE controls GPIB, VXI, Serial, PC Plug-in, and LAN instruments
directly over the interfaces or by using instrument drivers.
Agilent VEE supports VXIplug&play drivers in the WIN, WIN95, WINNT,
and Agilent-UX frameworks. In addition, versions 3.2 and above of Agilent
VEE support the graphical Function Panel interface, providing a function
tree of the hierarchy of the driver.
This appendix assumes that you are using Windows 95. If you are using
Windows NT, please replace every reference to win95 with winnt.
Windows 95 and Windows NT are registered trademarks of Microsoft
corporation.
NOTE
Agilent VEE automatically calls the initialize and close functions to
perform automatic error checking.
GPIB Interfacing in Agilent VEE
Agilent VEE supports interfacing with an instrument from a GPIB card.
Before you can do this, you must do the following:
1 Select Instrument Manager from the I/O menu.
218
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
Using Visual Programming Environments
The Agilent 816x VXIplug&play Instrument Driver
2 Double-click on the Add button to bring up the Device Configuration
Figure 13 Device Configuration
3 Enter the following information:
• Name: enter hp816X.
• Interface: GPIB
• Address: Enter the GPIB address of your GPIB interface board (the
default is 7). Append the GPIB address of your instrument (the
default is 20).
To find out or change the instrument’s GPIB address, press the Config
hardkey on the instrument’s front panel and choose GPIB address. The
instrument’s GPIB address appears, you may edit it if you wish.
NOTE
• Gateway: This host.
4 Press Advanced I/O Config ..., the Advanced Device Configuration box
Figure 14 Advanced Device Configuration - Plug&play Driver
5 Select hp816X from the Plug&play Driver Name drop-down list.
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
219
Download from Www.Somanuals.com. All Manuals Search And Download.
The Agilent 816x VXIplug&play Instrument Driver
Using Visual Programming Environments
If you do not see this driver in the list, the driver has not installed properly.
If you do not see this driver in the list, the driver has not installed properly.
NOTE
6 Enter the Parameters to the init() call by entering GPIB::xx::INSTR where
xx is your instrument’s GPIB address.
20 is the default GPIB address for your instrument.
NOTE
7 Select whether to Perform Reset or to Perform Identification Query
whenever Agilent VEE opens the instrument for interaction.
8 Confirm the selections pressing the OK button.
9 Return to the Instrument Manager screen and press the Save Config to
save the configuration.
220
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
Using Visual Programming Environments
The Agilent 816x VXIplug&play Instrument Driver
Getting Started with LabView
The 32-bit Agilent 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.
After installing the Agilent 816x instrument driver, the driver must be
converted for use with LabView.
1 To convert the driver follow these steps:
a
b
c
If you are updating from a previously installed driver, perfrorm the following
three steps:
Locate the LabView program folder. By default, this is <drive>:Program
Files\National Instruments\LabView.
This folder contains a subfolder named instr.lib.
2 Run LabView.
3 On the first window that appears, click on the Solution Wizards button.
4 The LabView Solution Wizard window appears, click on the Launch
Wizard… button.
5 The Welcome to Instrument Wizard! window appears, click on the Next
> button.
6 The Search for Instruments… window appears, click on the Next >
button. Check that the options are the same as displayed in the figure
below:
Figure 15 Search for GPIB Instruments
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
221
Download from Www.Somanuals.com. All Manuals Search And Download.
The Agilent 816x VXIplug&play Instrument Driver
Using Visual Programming Environments
7 Click on the Next > button.
8 The Identify Found Instruments… window appears, click on the Next >
button.
9 The Update VXI Plug and Play Drivers window appears, select HP816X,
and click on the Convert button.
10 The Manage Instrument Drivers window appears, click on the Finish
button.
11 The first window appears again, click on the New VI button.
12 Select File and then select Convert CVI FP file.
13 The Select a CVI Function Panel file window appears, locate the
hp816x.fp file, which is normally installed into the path
<drive>:VXIPNP\winXX\hp816x, where XX stands for NT, or 95.
14 Press Open.
15 The CVI Function Panel Converter window appears.
16 Click on Browse… and browse to the following Destination Directory:
\LabView\instr.lib\hp816x\hp816x.llb
17 Press Save.
18 Press Options…, the FP Conversion Options window appears. Check
that the options are the same as displayed in the figure below:.
Figure 16 FP Conversion Options Box
222
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
Using Visual Programming Environments
The Agilent 816x VXIplug&play Instrument Driver
You must check the Add Front Panel Controls for Size of Array Parameters
box. There will be a front panel control created for each VI that requires
you to assign the array size.
NOTE
19 Press OK. The CVI Function Panel Converter window appears.
20 Press OK.
21 The Select a library window appears. Browse to
<drive>:\vxipnp\winXX\Bin, where XX stands for NT, or 95, select
hp816x_32.dll and click on Open.
22 The CVI Conversion Status window is displayed until the conversion is
completed.
You must use the 32-bit version of the Agilent 816x VXIplug&play
Instrument Driver with LabView 5.0.
NOTE
NOTE
LabView is a trademark of National Instruments Corporation.
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
223
Download from Www.Somanuals.com. All Manuals Search And Download.
The Agilent 816x VXIplug&play Instrument Driver
Using Visual Programming Environments
Getting Started with LabWindows
The 32-bit Agilent 816x VXIplug&play Instrument Driver can be used with
LabWindows 4.0 and above. LabWindows 4.0 is a 32-bit version of
LabWindows which runs on Windows 95 and Windows NT.
To access the functions of the Agilent 816x VXIplug&play Instrument
Driver from within LabWindows, select INSTRUMENT from the main menu,
and then select the LOAD... submenu item.
In the file selection dialog box which appears, select hp816x.fp and click on
the 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
224
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
Features of the Agilent 816x Instrument Driver
The Agilent 816x VXIplug&play Instrument Driver
Features of the Agilent 816x
Instrument Driver
The Agilent 816x VXIplug&play instrument driver conforms to all aspects
of the VXIplug&play driver standard which apply to conventional rack and
stack instruments.
The following features are available:
• The Agilent 816x VXIplug&play Instrument Driver conforms with the VXI-
plug&play standard.
• There is one exception as the Agilent 816x driver does not have a soft
front panel or a knowledge-based file.
• The Agilent 816x VXIplug&play Instrument Driver is built on top of VISA,
and uses the services provided.
• VISA supports GPIB and VXI protocols. The driver can be used with any
GPIB card for which the manufacturer has provided a VISA DLL.
• The Agilent 816x VXIplug&play Instrument Driver includes a Function
Panel (.fp) file.
• The .fp file allows the driver to be used with visual programming environ-
ments such as Agilent VEE, LabWindows, and LabView.
• The Agilent 816x VXIplug&play Instrument Driver includes a comprehen-
sive on-line help file which complements the instrument manual.
• The help file contains application programming examples, a cross-refer-
ence between instrument commands and driver functions, and detailed
documentation of each function with examples.
• The Agilent 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.
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.
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
225
Download from Www.Somanuals.com. All Manuals Search And Download.
The Agilent 816x VXIplug&play Instrument Driver
Directory Structure
Directory Structure
The setup program which installs the Agilent 816x instrument driver
creates the VXIPNP directory if it does not already exist. The structures for
the Windows NT and Windows 95 vxipnp subdirectory tree are shown in
Figure 17 Windows 95 and Windows NT VXIPNP Directory Structure
In the directory example, hp816x is a directory containing the instrument
driver. There would be a directory for each instrument driver.
226
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
Opening an Instrument Session
The Agilent 816x VXIplug&play Instrument Driver
Opening an Instrument Session
To control an instrument from a program, you must open a communication
path between the computer/controller and the instrument. This path is
known as an instrument session, and is opened with the function
ViStatus hp816x_init( ViRsrc InstrDesc, ViBoolean id_query, ViBoolean reset,
ViPSession instrumentHandle );
Instruments are assigned a handle when the instrument session is
opened. The handle, which is a pointer to the instrument, is the first
parameter passed in all subsequent calls to driver functions.
The parameters of the function hp816x_init include:
•
•
ViRsrc InstrDesc: the address of the instrument
ViBoolean id_query: a Boolean flag which indicates if in-system verifica-
tion should be performed.
Passing VI_TRUE (1) will perform an in-system verification; passing
VI_FALSE (0) will not.
If you set id_query to false, you can use the generic functions of the in-
strument driver with other instruments.
•
•
ViBoolean reset: a Boolean flag which indicates if the instrument should
be reset when it is opened.
Passing VI_TRUE (1) will perform a reset when the session is opened;
passing VI_FALSE (0) will not perform a reset,
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
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
227
Download from Www.Somanuals.com. All Manuals Search And Download.
The Agilent 816x VXIplug&play Instrument Driver
Closing an Instrument Session
Closing an Instrument Session
Sessions (instrumentHandle) opened with the hp816x_init() function are
closed with the function:
hp816x_close( ViSession instrumentHandle);
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.
228
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
VISA Data Types and Selected Constant Definitions
The Agilent 816x VXIplug&play Instrument Driver
VISA Data Types and Selected
Constant Definitions
The driver functions use VISA data types. VISA data types are identified by
the Vi prefix in the data type name (for example, ViInt16, ViUInt16, ViChar).
The file visatype.h contains a complete listing of the VISA data types,
function call casts and some of the common constants.
You can find a partial list of the type definitions and constant definitions
for the visatype.h in the Agilent 816x VXIplug&play Instrument Driver
Online Help.
NOTE
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
229
Download from Www.Somanuals.com. All Manuals Search And Download.
The Agilent 816x VXIplug&play Instrument Driver
Error Handling
Error Handling
Events and errors within a instrument control program can be detected by
polling (querying) the instrument. Polling is used in application
development environments (ADEs) that do not support asynchronous
activities where callbacks can be used.
Programs can set up and use polling as shown below.
1 Declare a variable to contain the function completion code.
ViStatus errStatus;
Every driver function returns the completion code ViStatus.
If the function executes with no I/O errors, driver errors, or instrument
errors, ViStatus is 0 (VI_SUCCESS).
If an error occurs, ViStatus is a negative error code.
Warnings are positive error codes, and indicate the operation
succeeded but special conditions exist.
2 Enable automatic instrument error checking following each function
call.
hp816x_errorQueryDetect
(instrumentHandle, VI_TRUE);
When enabled, the driver queries the instrument for an error condition
before returning from the function.
an error was detected (hp816x_INSTR_ERROR_DETECTED).
3 Check for an error (or event) after each function.
errStatus = hp816x_cmd(instrumentHandle, "SENS1:POW:RANG");
check(instrumentHandle, errStatus);
After the function executes, errStatus contains the completion code.
The completion code and instrument ID are passed to an error checking
routine. In the above statement, the routine is called 'check'.
4 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.
230
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
Error Handling
The Agilent 816x VXIplug&play Instrument Driver
void check (ViSession instrumentHandle, ViStatus errStatus)
{
/* variables for error code and message */
ViInt32 inst_err;
ViChar err_message[256];
/* VI_SUCCESS is 0 and is defined in VISATYPE.h */
if(VI_SUCCESS > errStatus)
{
/* hp816x_INSTR_ERROR_DETECTED defined in hp816x.h */
if(hp816x_INSTR_ERROR_DETECTED == errStatus)
{
/* query the instrument for the error */
hp816x_error_query(instrumentHandle, &inst_err, err_message);
/* display the error */
printf("Instrument Error : %ld, %s\n", inst_err, err_message);
}
else /* driver error */
{
/* get the driver error message */
hp816x_error_message(instrumentHandle, errStatus,
err_message);
/* 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;
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
231
Download from Www.Somanuals.com. All Manuals Search And Download.
The Agilent 816x VXIplug&play Instrument Driver
Introduction to Programming
Introduction to Programming
Example Programs
VISA-Specific Information
The following information is useful if you are using the driver with a
version of VISA.
Instrument Addresses
When you are using Agilent VXIplug&play instrument drivers, you should
enter the instrument addresses using only upper case letters. This is to
ensure maximum portability.
For example, use GPIB0::22 rather than gpib0::22.
Callbacks
Callbacks are not supported by this driver.
Development Environments
These sections contains suggestions as to how you can use hp816x_32.dll
within various application development environments.
Microsoft Visual C++ 4.0 (or higher) and Borland C++
4.5 (or higher)
Please refer to your Microsoft Visual C++ or Borland C++ manuals for
information on linking and calling DLLs.
232
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
Introduction to Programming
The Agilent 816x VXIplug&play Instrument Driver
Microsoft Visual Basic 4.0 (or higher)
Please refer to your Microsoft Visual Basic manual for information on
calling DLLs.
The BASIC include file is hp816x.bas. You can find this file in the directory
~vxipnp\win95\include, where ~ is the directory in the VXIPNP variable.
By default, ~ is equivalent to C:\. This means that the file is in
C:\vxipnp\win95\include.
You may also need to include the file visa.bas. visa.bas is provided with your
VISA DLL.
Agilent VEE 5.01 (or higher)
Your copy of Agilent VEE for Windows contains a document titled Using
VXIplug&play drivers with Agilent VEE for Windows. This document
contains the detailed information you need for Agilent VEE applications.
LabWindows CVI/ (R) 4.0 (or higher)
The Agilent 816x VXIplug&play Instrument Driver is supplied as a Dynamic
Link Library (.DLL) file.
There are several advantages to using the .DLL form of the driver, including
those listed below:
• transportability across different computer platforms,
• a higher level of support for the compiled driver from Agilent
Technologies,
• a faster load time for your project.
LabWindows/CVI (R) will attempt by default to load the source version of
the instrument driver. To load the DLL, you must include the file hp816x.fp
in your project. hp816x.fp can be found in the directory vxipnp\win95\hp816x.
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 ~vxipnp\win95\include is added to the include paths (CVI
Project Option menu).
~ is the directory in the VXIPNP variable. By default, ~ is equivalent to C:\.
This means that the file is in C:\vxipnp\win95\include.
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
233
Download from Www.Somanuals.com. All Manuals Search And Download.
The Agilent 816x VXIplug&play Instrument Driver
Online Information
Online Information
The latest copy of this driver can be downloaded via:
http://www.agilent.com/comms/comp-test
If you do not have web access, use the version of hp816x.exe on your OCT
Support CD, or contact your Agilent Technologies supplier.
234
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
Lambda Scan Applications
The Agilent 816x VXIplug&play Instrument Driver
Lambda Scan Applications
These functions combine multiple SCPI commands into a single, functional
operation. They are designed to allow quick and easy access to common
instrument command sequences.
These application functions allow you to perform one of the following
applications:
• A Lambda Scan - a Lambda Logging operation where an Agilent
8164A/B Lightwave Measurement System with a back-loadable
Tunable Laser module and up to four Power Meters installed, performs
a wavelength sweep where the Tunable Laser module and Power
Meters are coordinated with each other.
• A Multi Frame Lambda Scan - a Lambda Logging operation where an
Agilent 8164A/B Lightwave Measurement System with a back-loadable
Tunable Laser module performs a wavelength sweep and the Tunable
Laser module is coordinated with Power Meters that are installed in the
mainframe and in other mainframes. These mainframes must be
connected to the GPIB bus and have their Input Trigger Connector
connected to the Output Trigger Connector of the Agilent 8164A/B
Lightwave Measurement System mainframe.
The following two functions apply to both Lambda Scan and Multi Frame
Lambda Scan applications:
• The Set Lambda Scan Wavelength
(hp816x_set_LambdaScan_wavelength) function allows you to use a
different wavelength than 1550 nm during a Lambda Scan operation. All
Power Meters taking part in the Lambda Scan operation will be set to
the chosen wavelength.
• The Enable High Sweep Speed (hp816x_enableHighSweepSpeed)
function enables/disables the highest available sweep speed (40
nanometers per second) for Lambda Scan operations. The Lambda Scan
operation chooses the highest possible sweep speed for the chosen
step size.
• If you choose Enable, the highest sweep speed possible will be used.
This may lead to less accurate measurements.
• If you choose Disable, the highest sweep speed will not be used.
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
235
Download from Www.Somanuals.com. All Manuals Search And Download.
The Agilent 816x VXIplug&play Instrument Driver
Lambda Scan Applications
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.
The advantage of spacing all measurements equally is that presenting
results through use of a spreadsheet is greatly simplified. The operation
returns one wavelength array and a power array for each power meter
channel.
The disadvantage of using equally spaced datapoints is that the linear
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 18 Equally Spaced Datapoints
236
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
Lambda Scan Applications
The Agilent 816x VXIplug&play Instrument Driver
How to Perform a Lambda Scan Application
Figure 19 Lambda Scan Operation Setup
The Prepare Lambda Scan Function
The Prepare Lambda Scan (hp816x_prepareLambdaScan) function
prepares a Lambda Scan operation.
The Prepare Lambda Scan (hp816x_prepareLambdaScan) function must
be called before a Lambda Scan operation is executed. Use the return
values of this function (Number of Datapoints and Number of Power
Arrays) to allocate arrays for the Execute Lambda Scan
(hp816x_executeLambdaScan) function.
To obtain a higher precision, the Tunable Laser Source is set 1 nm before
the Start Wavelength, this means, you have to choose a Start Wavelength
1 nm greater than the minimum possible wavelength. Also, the wavelength
sweep is actually started 90 pm before the Start Wavelength and ends 90
pm after the Stop Wavelength, this means, you have to choose a Stop
Wavelength 90 pm less than the maximum possible wavelength.
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.
If one of the following circumstances occurs, the "parameter mismatch"
error will be returned:
1 If one Power Meter is out of the specification at 1550 nm, the error
"powermeter wavelength does not span 1550nm" will be returned. For
example, the HP 81530A Power Sensor and the HP 81520A Optical Head
are out of specification at 1550 nm. Remove the Power Meter that is out
of specification at 1550 nm from the mainframe.
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
237
Download from Www.Somanuals.com. All Manuals Search And Download.
The Agilent 816x VXIplug&play Instrument Driver
Lambda Scan Applications
2 If the Step Size is too small and results in a trigger frequency that is to
high for the installed Power Meters, the error "could not calculate a
sweep speed!" will be returned. Increase the Step Size.
3 If the chosen wavelength range is too large and Step Size is too small,
the error "too many datapoints to log!" will be returned. In this case,
reduce the wavelength range and/or increase the Step Size.
The Get Lambda Scan Parameters Function
The Get Lambda Scan Parameters
(hp816x_getLambdaScanParameters_Q) function returns all parameters
that the Prepare Lambda Scan (hp816x_prepareLambdaScan) function
adjusts or automatically calculates.
The Execute Lambda Scan Function
The Execute Lambda Scan (hp816x_executeLambdaScan) function runs
and returns the results of a Lambda Scan operation.
That is, it executes an operation where a Agilent 8164A/B Lightwave
Measurement System with a back-loadable Tunable Laser module and up
to four Power Sensors installed, performs a wavelength sweep where the
Tunable Laser module and Power Sensors are coordinated with each
other.
The Prepare Lambda Scan (hp816x_prepareLambdaScan) function must
be called before a Lambda Scan operation is executed. Use the return
values of this function (Number of Datapoints and Number of Power
Arrays) to allocate arrays for the Execute Lambda Scan
(hp816x_executeLambdaScan) function.
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
details.
238
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
Lambda Scan Applications
The Agilent 816x VXIplug&play Instrument Driver
How to Perform a Multi-Frame Lambda
Scan Application
Power Power Power
Trigger
8164A or B
Sensor Sensor Sensor
Cable
Output Trigger
Connector
Tunable Laser
GPIB
Cable
Power Power Power Power Power Power
Sensor Sensor Sensor Sensor Sensor Sensor
8166A or B
Input
Trigger
Connector
Power Power Power Power Power Power Power
Sensor Sensor Sensor Sensor Sensor Sensor Sensor
Input Trigger
Connector
Power Power
Sensor Sensor
8163A or B
To Con trol le r
Figure 20 Multi Frame Lambda Scan Operation Setup
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
239
Download from Www.Somanuals.com. All Manuals Search And Download.
The Agilent 816x VXIplug&play Instrument Driver
Lambda Scan Applications
The Equally Spaced Datapoints Function
The Equally Spaced Datapoints (hp816x_returnEquidistantData) function
allows you to select whether you the results will be equally spaced by
performing a linear interpolation on the wavelength point and power
details.
This function is used because Lambda Scan functions make use of Lambda
Logging to log the exact wavelength that measurements were triggered at.
This results in Lambda Array wavelength points that are not equally
spaced.
Lambda Logging is not available if your Tunable Laser module firmware
revision is lower than 2.0.
NOTE
Equally Spaced Datapoints is enabled as a default.
The Register Mainframe Function
Use the Register Mainframe (hp816x_registerMainframe) function to
register your mainframe as a participant in a Multi Frame Lambda Scan
operation. The mainframe must be connected to the GPIB bus and have
their Input Trigger Connector connected to the Output Trigger Connector
of the Agilent 8164A/B Lightwave Measurement System mainframe that
the Tunable Laser module is installed in.
The Unregister Mainframe Function
Use the Unregister Mainframe function (hp816x_unregisterMainframe) to
remove a mainframe from a Multi Frame Lambda Scan operation and clear
the driver's internal data structures.
If you use LabView 5.0 the following items should be noted:
• All multi frame functions are not re-entrant, if the driver is running and
initialized more than once, results may be unpredictable.
• To avoid wrong results, call the Unregister Mainframe function prior to
the Initialize function (hp816x_init). This is especially necessary during
program debugging, if the Close function (hp816x_close) is not called.
240
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
Lambda Scan Applications
The Agilent 816x VXIplug&play Instrument Driver
The Prepare Multi Frame Lambda Scan Function
The Prepare Multi Frame Lambda Scan (hp816x_prepareMfLambdaScan)
function prepares a Lambda Scan operation for multiple Mainframes.
That is, it prepares an operation where a Agilent 8164A/B Lightwave
Measurement System with a back-loadable Tunable Laser module and up
to 100 Power Meter Channels located in different Mainframes are
installed. The function performs a wavelength sweep where the Tunable
Laser module and Power Sensors are co-ordinated with each other.
The Prepare Multi Frame Lambda Scan (hp816x_prepareMfLambdaScan)
function must be called before a Multi Frame Lambda Scan is executed.
Use the return values of this function (Number of Datapoints and Number
of Power Arrays) to allocate arrays for the Execute Multi Frame Lambda
Scan (hp816x_executeMfLambdaScan) function.
The function scans all mainframes to find back-loadable Tunable Laser
Sources. The function scans each mainframe in the order that they were
originally registered by the Register Mainframe function
(hp816x_registerMainframe). The first back-loadable Tunable Laser
Source found will perform the sweep operation.
To obtain a higher precision, the Tunable Laser Source is set 1 nm before
the Start Wavelength, this means, you have to choose a Start Wavelength
1 nm greater than the minimum possible wavelength. Also, the wavelength
sweep is actually started 90 pm before the Start Wavelength and ends 90
pm after the Stop Wavelength, this means, you have to choose a Stop
Wavelength 90 pm less than the maximum possible wavelength.
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. All mainframes must be
connected to the GPIB bus and have their Input Trigger Connector
connected to the Output Trigger Connector of the Agilent 8164A/B
Lightwave Measurement System mainframe that the Tunable Laser
module is installed in.
If one of the following circumstances occurs, the "parameter mismatch"
error will be returned:
1 If one Power Meter is out of the specification at 1550 nm, the error
"powermeter wavelength does not span 1550nm" will be returned. For
example, the HP 81530A Power Sensor and the HP 81520A Optical Head
are out of specification at 1550 nm. Remove the Power Meter that is out
of specification at 1550 nm from the mainframe.
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
241
Download from Www.Somanuals.com. All Manuals Search And Download.
The Agilent 816x VXIplug&play Instrument Driver
Lambda Scan Applications
2 If the Step Size is too small and results in a trigger frequency that is to
high for the installed Power Meters, the error "could not calculate a
sweep speed!" will be returned. Increase the Step Size.
3 If the chosen wavelength range is too large and Step Size is too small,
the error "too many datapoints to log!" will be returned. In this case,
reduce the wavelength range and/or increase the Step Size.
The Get MF Lambda Scan Parameters Function
The Get MF Lambda Scan Parameters
(hp816x_getMFLambdaScanParameters_Q) function returns all
parameters that the Prepare Multi Frame Lambda Scan
(hp816x_prepareMfLambdaScan) function adjusts or automatically
calculates.
The Execute Multi Frame Lambda Scan Function
The Execute Multi Frame Lambda Scan (hp816x_executeMfLambdaScan)
function runs a Lambda Scan operation and returns an array that contains
the wavelength values at which power measurements are made.
That is, it executes an operation where a Agilent 8164A/B Lightwave
Measurement System with a back-loadable Tunable Laser module and up
to 100 Power Sensors installed, performs a wavelength sweep where the
Tunable Laser module and Power Sensors are coordinated with each
other.
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.
The Get Lambda Scan Result Function
The Get Lambda Scan Result (hp816x_getLambdaScanResult) function
returns for a given Power Meter channel a power value array and a
wavelength value array.
These arrays contains the results of the last Multi Frame Lambda Scan
operation.
242
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
Lambda Scan Applications
The Agilent 816x VXIplug&play Instrument Driver
The Get Number of PWM Channels Function
The Get Number of PWM Channels
(hp816x_getNoOfRegPWMChannnels_Q) function returns the number of
Power Meter channels in a test setup.
Only Power Meters whose mainframe was registered using the Register
Mainframe (hp816x_registerMainframe) function are counted.
The Get Channel Location Function
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.
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
243
Download from Www.Somanuals.com. All Manuals Search And Download.
The Agilent 816x VXIplug&play Instrument Driver
Lambda Scan Applications
244
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
9
Error Codes
This chapter gives information about error codes used with the
Agilent 8163A/B Lightwave Multimeter, the Agilent 8164A/B Lightwave
Measurement System, and the Agilent 8166A/B Lightwave Multichannel
System.
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
257
Download from Www.Somanuals.com. All Manuals Search And Download.
Error Codes
GPIB Error Strings
GPIB Error Strings
Error strings in the range -100 to -183 are defined by the SCPI standard,
downloadable from: http://www.scpiconsortium.org/scpistandard.htm
String descriptions taken from this standard (VERSION 1999.0 May, 1999),
whether in whole or in part, are enclosed by [ ].
Table 18 Overview for Supported Strings
Error
New/Old/Standard Number String
Note:
Error strings in the range -100 to -183 are defined by the SCPI standard,
downloadable from: http://www.scpiconsortium.org/scpistandard.htm
String descriptions taken from this standard (VERSION 1999.0 May, 1999),
whether in whole or in part, are enclosed by [ ] in this table.
-100 to -199 Command Errors
"Command Error"
Standard
-100
-101
[This is the generic syntax error used when a more specific error cannot be
detected. This code indicates only that a Command Error as defined in IEEE
488.2,11.5.1.1.4 has occurred.]
"Invalid character"
Standard
[A syntactic element contains a character which is invalid for that type; for
example, a header containing an ampersand, SETUP&. This error might be
used in place of error -114 and perhaps some others.]
"Syntax error"
Standard
Standard
Standard
-102
-103
-104
[An unrecognized command or data type was encountered; for example, a
string was received when the device does not accept strings.]
"Invalid separator"
[The parser was expecting a separator and encountered an illegal charac-
ter; for example, the semicolon was omitted after a program message unit]
"Data type error"
[The parser recognized a data element different than one allowed; for ex-
ample,numeric or string data was expected but block data was encoun-
tered.]
Standard
Standard
-105
-108
"GET not allowed"
[A Group Execute Trigger was received within a program message (see
IEEE488.2, 7.7).]
"Parameter not allowed"
[More parameters were received than expected for the header]
258
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
GPIB Error Strings
Error Codes
Table 18 Overview for Supported Strings
Error
New/Old/Standard Number String
"Missing parameter"
Standard
-109
[Fewer parameters were recieved than required for the header]
Standard
-112
"Program mnemonic too long"
[The header contains more than twelve characters (see IEEE 488.2,
7.6.1.4.1).]
"Undefined header"
Standard
Standard
-113
-120
[The header is syntactically correct, but it is undefined for this specific de-
vice; for example, *XYZ is not defined for any device.]
"Numeric data error"
[This error, as well as errors -121 through -129, are generated when pars-
ing a data element which appears to be numeric, including the nondecimal
numeric types. This error message is used if the device cannot detect a
more specific error.]
"Invalid character in number"
Standard
Standard
Standard
Standard
Standard
-121
-123
-124
-128
-131
[An invalid character for the data type being parsed was encountered; for
example, an alpha in a decimal numeric]
"Exponent too large"
[The magnitude of the exponent was larger than 32000 (see IEEE
488.2,7.7.2.4.1).]
"Too many digits"
[The mantissa of a decimal numeric data element contained more than 255
digits excluding leading zeros (see IEEE 488.2, 7.7.2.4.1).]
"Numeric data not allowed"
[A legal numeric data element was received, but the device does not ac-
cept one in this position for the header.]
"Invalid suffix"
[The suffix does not follow the syntax described in IEEE 488.2, 7.7.3.2, or
thesuffix is inappropriate for this device.]
Standard
Standard
-134
-138
“Suffix too long”
[The suffix contained more than 12 characters (see IEEE 488.2, 7.7.3.4).]
“Suffix not allowed”
[A suffix was encountered after a numeric element which does not allow
suffixes.]
“Invalid character data”
Standard
Standard
-141
-148
[Either the character data element contains an invalid character or the par-
ticular element received is not valid for the header.]
“Character data not allowed”
[A legal character data element was encountered where prohibited by the
device.]
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
259
Download from Www.Somanuals.com. All Manuals Search And Download.
Error Codes
GPIB Error Strings
Table 18 Overview for Supported Strings
Error
New/Old/Standard Number String
“String data error”
Standard
-150
[This error, as well as errors -151 through -159, are generated when pars-
ing a string data element. This error message is used when the device can-
not detect a more specific error.]
“Invalid string data”
Standard
-151
[A string data element was expected, but was invalid for some reason (see
IEEE 488.2, 7.7.5.2); for example, an END message was received before the
terminal quote character.]
“String data not allowed”
Standard
Standard
-158
-161
[A string data element was encountered but was not allowed by the de-
vice at this point in parsing.]
“Invalid block data”
[A block data element was expected, but was invalid for some reason (see
IEEE 488.2, 7.7.6.2); for example, an END message was received before the
length was satisfied.]
“Block data not allowed”
Standard
Standard
-168
-170
[A legal block data element was encountered but was not allowed by the
device at this point in parsing.]
“Expression error”
[This error, as well as errors -171 through -179, are generated when pars-
ing an expression data element. This particular error message is used
when the device cannot detect a more specific error.]
“Invalid expression”
Standard
Standard
Standard
Standard
-171
-178
-181
-183
[The expression data element was invalid (see IEEE 488.2, 7.7.7.2); for ex-
ample, unmatched parentheses or an illegal character.]
“Expression data not allowed”
[A legal expression data was encountered but was not allowed by the de-
vice at this point in parsing.]
“Invalid outside macro definition”
[Indicates that a macro parameter placeholder ($<number) was encoun-
tered outside of a macro definition.]
“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).]
260
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
GPIB Error Strings
Error Codes
Table 18 Overview for Supported Strings
Error
New/Old/Standard Number String
“Subop out of range”
New
-185
Description:
Suboperations are parameters that are passed to refine the destination of
a command. They are used to address slots, channels, laser selections and
GPIB/SCPI register levels. This error is generated if the parameter is not
valid in the current context or system configuration.
Example:
This error occurs if the user queries the status of a summary register and
passes an invalid status level (also see "Status for 816x" on page 28 pro-
grammer's guide).
Note:
Incorrect slots and channels addresses are handled by error code -301
-200 to -299 Execution Errors
“Execution error (StatExecError)"
Standard
-200
Description:
This error occurs when the current function, instrument or module state
(or status) prevents the execution of a command. This is a generic error
which can for a number of reasons.
Example:
When a powermeter has finished a logging application and data is avail-
able, the user is not able to reconfigure the logging application parame-
ters. First, the user must stop the logging application.
"Please be patient - GPIB currently locked out"
New
-201
Description:
Some operations block the complete system. Since no sensible measure-
ments are possible while this is true, the GPIB is locked out.
Example:
When ARA, Lambda zeroing or zeroing is executing on a TLS module, the
GPIB is not accessible.
“Powermeter not running (StatMeterNotRunning)"
New
-205
Description:
Some command and actions may stop the data aquisition unit of a power-
meter. If a command fetches data, there may be no measurement values
and this error is generated. Please check module state and repeat opera-
tion.
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
261
Download from Www.Somanuals.com. All Manuals Search And Download.
Error Codes
GPIB Error Strings
Table 18 Overview for Supported Strings
Error
New/Old/Standard Number String
“Trigger ignored”
Old
-211
Description:
A trigger has been detected but ignored because of timing contraints. (For
Example: average time to large).
“Arm ignored”
Old
-212
Description:
The user can set the automatic re-arming option for input and output trig-
this error occurs, the device ignores the setting because the current mod-
ule status does not allow the change of trigger settings.
“Init ignored”
Old
-213
Description:
measurement cycle. The continuous measurement must be DISABLED.
This error code is generated if the powermeter is still in cont. measure-
ment mode.
"Parameter error (StatParmError)”
Old
Old
Old
-220
-220
-220
Description:
The user has passed a parameter that cannot be changed in this way. The
device cannot detect one of the following more specific errors:
-220, "Parameter error (StatParmOutOfRange)"
Description:
The user has passed a parameter that exceeds the valid range for this pa-
rameter.
"Parameter error (StatParmIllegalVal)"
Description:
The user has passed a parameter that does not match a value in a list of
possible values.
262
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
GPIB Error Strings
Error Codes
Table 18 Overview for Supported Strings
Error
New/Old/Standard Number String
"Settings conflict (StatParmInconsistent)"
Old
-221
Description:
The user has passed a parameter that conflicts with other already config-
ured parameters.
Example:
There are constrains for TLS sweep parameters: this error is generated
when lambda step size exceeds the difference between start and stop
wavelength.
If error -221 is returned after you try to start a wavelength sweep, one of
the following cases of sweep parameter inconsistency has occurred:
Continuous Sweep mode AND l Start is less than l Stop.
Continuous Sweep mode AND Sweep Time is too short. Adjust Sweep
Speed, l Start, or l Stop.
Continuous Sweep mode AND Sweep Time is too long. Adjust Sweep
Speed, l Start, or l Stop.
Continuous Sweep mode AND Trigger Frequency is too high. Adjust Step
Size. Trigger Frequency is the Sweep Speed divided by the Step Size.
Stepped Sweep mode AND Lambda Logging Enabled.
Continuous Sweep mode AND Lambda Logging Enabled AND Output trig-
ger mode not set to STFinished (Step finished).
Continuous Sweep mode AND Lambda Logging is Enabled AND Modula-
tion Source is not set to OFF.
Continuous Sweep mode AND Lambda Logging is Enabled AND Sweep Cy-
cles is not set to 1.
Continuous Sweep mode AND Coherence Control is Enabled.
"Data out of range (StatParmTooLarge)"
Description:
Standard
Standard
-222
-222
The user has passed a continuous parameter that is too large.
Example:
Wavelength 1800nm when maximum wavelength is 1700nm.
"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.
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
263
Download from Www.Somanuals.com. All Manuals Search And Download.
Error Codes
GPIB Error Strings
Table 18 Overview for Supported Strings
Error
New/Old/Standard Number String
“Too much data”
Standard
-223
Description:
A function returns more data or the user requests more data than the
application is able to handle.
Example:
A tunable laser source produces more data when lambda values of a
sweep are stored than the 816x instrument is able to handle. Use the new
SENSE:FUNC:RES:BLOCK? command to split the data aquisition into
multiple parts.
“Illegal parameter value”
Standard
New
-224
-225
[Used where exact value, from a list of possibles, was expected.]
"Out of memory"
Description:
The request application or function cannot be executed because the in-
strument runs out of memory.
"Data questionable (StatValNYetAcc)"
Old
-231
Description:
The data that is retured is not accurate or reliable. The user should repeat
the operation. The reason for this error is unspecific.
Example:
A powermeter configured a long average time has not completed its cur-
rent measurement cycle when the user queries the current power.
"Data questionable (StatRangeTooLow)"
Old
Old
-231
-261
Description:
As -231 (StatValNYetAcc) but for a more specific reason: The powermeter
readout data is not reliable because the currently set (manual) range does
not correspond with the input power.
"Math error in expression (StatUnitCalculationError)"
Description:
This may occur when the user attempts to transform data in a way that is
currently not possible.
Example:
When a powermeter is measuring very small powe values in dBm (such as
noise power), negative power values in Watt may also be present (such as
when the powermeter calibration wavelength does not correspond to the
wavelength of input signal). The instrument cannot transform negative
Watt values to dBm because the logarithm of a negative value is not de-
fined.
264
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
GPIB Error Strings
Error Codes
Table 18 Overview for Supported Strings
Error
New/Old/Standard Number String
“Macro execution error”
Standard
-272
[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.)]
“Illegal macro label”
Standard
-273
[Indicates that the macro label defined in the *DMC command was a legal
string syntax, but could not be accepted by the device (see IEEE 488.2,
10.7.3 and 10.7.6.2); for example, the label was too long, the same as a
common command header, or contained invalid header syntax.]
“Macro recursion error”
Standard
Standard
-276
-277
[Indicates that a syntactically legal macro program data sequence could
not be executed because the device found it to be recursive (see IEEE
488.2, 10.7.6.6).]
“Macro redefinition not allowed”
[Indicates that a syntactically legal macro label in the *DMC command
could not be executed because the macro label was already defined (see
IEEE 488.2,10.7.6.4).]
“Macro header not found”
Standard
Old
-278
-284
[Indicates that a syntactically legal macro label in the *GMC? query
could not be executed because the header was not previously defined.]
"Function currently running (StatModuleBusy)"
Description:
This error is generated when a function is currently running on a module
so that it cannot process another commands.
Example:
When a powermeter is running a logging application, you are not able to
configure the logging application parameters (also see -200).
"No function currently running"
Old
-286
Description:
This error is generated when a user tries to execute a command which re-
quires a particular set of data that is not available.
Example:
Application data is necessary to execute SENSE:FUNC:RES?. If no suitable
function has completed, there is no data and this error is generated. (also
see -200).
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
265
Download from Www.Somanuals.com. All Manuals Search And Download.
Error Codes
GPIB Error Strings
Table 18 Overview for Supported Strings
Error
New/Old/Standard Number String
“Application currently running - no GPIB support”
New
-290
Description:
The instrument has built-in applications that have no GPIB support ( such
as Logging,Stability,PACT).
Example
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)
“Internal error (StatVals Lost)”
“Internal error (StatInternalError)”
Description
Old
-300
These are generic device-dependent errors used when the instrument can-
not detect more specific errors.
"Module doesn't support this command (StatCmdUnknown)"
New
-301
Description:
The addressed module does not support the SCPI command.
Example:
When a command from the SENSe SCPI tree is sent to a fixed or tunable
laser source.
"Internal timeout error (StatTimedOut)"
New
New
New
-302
-303
-304
Description:
A command has not returned in the expected time.
"Module slot empty or slot / channel invalid"
Description:
The user has send a command to an empty slot.
"Command was aborted (StatAborted)"
Description:
The command has been interrupted by another event.
266
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
GPIB Error Strings
Error Codes
Table 18 Overview for Supported Strings
Error
New/Old/Standard Number String
"Internal messaging error (StatCmdError)"
"Internal messaging error (StatCmdNotAllowed)"
"Internal messaging error (StatWrongLength)"
"Internal messaging error (StatWrongReceiver)"
"Internal messaging error (StatBufAllocError)"
"Internal messaging error (StatDPRamFull)"; }
"Internal messaging error (StatSemError)"
Description:
New
-305
An error has occured in the instrument communication system. Please re-
port this error with a description of the circumstances that generated the
error and the configuration of the system.
"Channel doesn't support this command (StatCmdUnknownForSlave)"
New
-306
-307
-310
Description:
Slave channels have limited functionality. The module supports this com-
mand, but the command must be sent to the master channel.
"Channel without head connection (StatHeadless)"
New
Description:
The channel supports this command, but it cannot be executed because
the optical measurement head is not plugged into the interface module.
“System error”
Standard
[Indicates that some error, termed “system error” by the device, has oc-
curred. This code is device-dependent.]
“Out of memory”
Standard
New
-321
-322
[An internal operation needed more memory than was available.]
"Flash programming error (StatFlashEraseFailed)"
"Flash programming error (StatFlashWriteFailed)"
"Flash programming error (StatFlashDataCntError)"
"Flash programming error (StatFlashDPAlgoFailed)"
Description:
An error has occured in a module. Please report this error with a descrip-
tion of the circumstances that generated the error and the configuration of
the system.
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
267
Download from Www.Somanuals.com. All Manuals Search And Download.
Error Codes
GPIB Error Strings
Table 18 Overview for Supported Strings
Error
New/Old/Standard Number String
"Flash programming error (StatUserCalTable Empty)"
New
-323
It is not possible to activate the offset (l) functionality when the offset ta-
ble is empty
"Flash programming error (StatUserCalTable Full)"
The offset (l) table is full and no more ? can be stored
"Flash programming error (StatUserCalActive)"
It is not possible to program the offset (l) table when the offset (l) feature
is activated. Deactivate first.
“Self-test failed”
Old
-330
Description:
You have started the self test, but the module has detected an error while
executing it
"Printing error (StatPrintError)"
New
New
-340
-341
Description:
An unspecified problem occurred while communicating with the printer.
"Printing error - paper out (StatPaperOut)"
Description:
The instrument cannot print because there is no paper in the connected
printer.
"Printing error - offline (StatOffline)"
New
-342
-350
Description:
The instrument cannot print because the connected printer is offline.
“Queue overflow”
Standard
[A specific code entered into the queue in lieu of the code that caused the
error. This code indicates that there is no room in the queue and an error
occurred but was not recorded.]
-400 to -499 Query Errors
“Query error”
Standard
-400
[This is the generic query error for devices that cannot detect more specif-
ic 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.]
“Query INTERRUPTED”
Standard
-410
[Indicates that a condition causing an INTERRUPTED Query error occurred
(see IEEE 488.2, 6.3.2.3); for example, a query followed by DAB or GET be-
fore a response was completely sent.]
268
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
GPIB Error Strings
Error Codes
Table 18 Overview for Supported Strings
Error
New/Old/Standard Number String
“Query UNTERMINATED”
Standard
Standard
Standard
-420
-430
-440
[Indicates that a condition causing an UNTERMINATED Query error oc-
curred (see IEEE 488.2, 6.3.2.2); for example, the device was addressed to
talk and an incomplete program message was received.]
“Query DEADLOCKED”
[Indicates that a condition causing an DEADLOCKED Query error occurred
(see IEEE 488.2, 6.3.1.7); for example, both input buffer and output buffer
are full and the device cannot continue.]
“Query UNTERMINATED after indef resp”
[Indicates that a query was received in the same program message after
an query requesting an indefinite response was executed (see IEEE 488.2,
6.5.7.5).]
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
269
Download from Www.Somanuals.com. All Manuals Search And Download.
Error Codes
GPIB Error Strings
Table 19 Overview for Unsupported Strings
Error
New/Old/Standard Number String
all positive errors
“Command header error”
Old
Old
Old
Old
Old
Old
Old
Old
Old
Old
Old
Old
Old
Old
Old
Old
Old
Old
Old
Old
Old
Old
Old
Old
Old
Old
Old
Old
-110
-111
-114
-130
-140
-144
-160
-201
-202
-210
-214
-215
-230
-240
-241
-260
-280
-281
-282
-283
-285
-286
-311
-312
-313
-314
-315
“Header seperator error”
“Header suffix out of range”
“Suffix error”
“Character data error”
“Character data too long”
“Block data error”
“Invalid while in local”
“Settings lost due to ???”
“Trigger error”
“Trigger deadlock”
“Arm deadlock”
“Data corrupt or stale”
“Hardware error”
“Hardware missing”
“Expression error”
“Program error”
“Cannot create program”
“Illegal program name”
“Illegal variable name”
“Program syntax error”
“Program runtime error”
“Memory error” [checksum or parity]
“Protect user data memory lost”
“Calibration memory lost”
“Save/Recall Memory lost”
“Configuration memory lost”
270
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
8
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.
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
245
Download from Www.Somanuals.com. All Manuals Search And Download.
GPIB Command Compatibility List
Compatibility Issues
Compatibility Issues
For each table entry in this chapter, it is noted whether the compatibility
change affects either:
• the HP 8153A Lightwave Multimeter - 8153,
• the HP 8167B/8D/8E/8F Tunable Laser Source - 8167/8, or
• both of these instruments - Both.
GPIB Bus Compatibility
These commands are incompatible.
Table 10 Incompatible GPIB Bus Commands
Command
Change
Affects
Both
LLO - local lockout
DCL - device clear
GET - group execute trigger
Both
Both
246
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
Removed Command
GPIB Command Compatibility List
Removed Command
replacement.
Table 11 Removed Commands
Command
*SRE/?
*TRG
Change
Affects
Both
No support for this command/query.
No support for triggered commands.
8153
ABORt
This command is not supported; in every
case, the bus is blocked during command
execution.
8153
STATus:OPERation:
NTRansition/?
These status model features are not sup- 8153
ported.
STATus:OPERation:
PTRansition/?
STATus:QUEStionable:
NTRansition/?
STATus:QUEStionable:
PTRansition/?
SYSTem:BEEPer:STATe/? Beeper access is not supplied.
8153
*SAV
*RCL
User interface or GPIB settings cannot be 8167/8
stored or recalled.
BDATA?
Memory card access is not provided.
8167/8
DOSMODE/?
TRACe:CATalog?
TRACE:DATA?
TRACE:POINts?
The TRACe tree is not supported; the
CC_UNCAL curve does not exist.
8167/8
WAVEACT
Alignment to external wavemeter is not
supported.
8167/8
8167/8
misc 200
Risetime control is not supported yet.
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
249
Download from Www.Somanuals.com. All Manuals Search And Download.
GPIB Command Compatibility List
Obsolete Commands
Obsolete Commands
Table 12 Obsolete Commands
Old Command
New Command
Affects
8153
DISPlay:STATe/?
DISPlay:ENABle/?
PROGram command tree
SENSe:FUNCtion command tree.
Some commands from the PROGram com-
mand tree have not been replaced.
The HP 8153A application interface on the
GPIB is not supported.
8153
Stability/Logging and Min/Max are avail-
able via a new interface.
Return Loss Module
Commands
The commands for the return loss modules 8153
will be completely different than those for
the HP 8153A.
250
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
Changed Parameter Syntax and Semantics
GPIB Command Compatibility List
Changed Parameter Syntax and
Semantics
changed.
Table 13 Commands with Different Parameters or Syntax
Command
Change
Affects
SOUR:AM:FREQ/?
This command does not accept the value 8153
CW, instead use SOUR:AM:STAT ON|OFF
to switch from and to CW mode.
The commands accepts floating point val-
ues.
DISP:BRIG
This command now supports integers be- 8153
tween 1 and 100, instead of float values be-
tween 1 and 0.
SENS:CORR:COLL:ZERO? This command returns the last zero state, 8153
instead of the last remote zero state.
SENS:POW:REF
Accepts TOMODule and TOREF for the first 8153
parameter, instead of accepting TOA|TOB
as the HP 8153A does. The numbers 0|1|2
cannot be used, only the strings above.
SENS:POW:REF:STAT:RAT Accepts TOREF,0 or values for slot,chan-
nel, instead of accepting TOA|TOB as the
HP 8153A does. The numbers have a differ-
ent meaning.
8153
SYST:DATe
SYST:DATe from HP 8167/8 is not support- 8167/8
ed, but SYST:DATe from HP 8153 is sup-
ported.
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
251
Download from Www.Somanuals.com. All Manuals Search And Download.
GPIB Command Compatibility List
Changed Query Result Values
Changed Query Result Values
old instruments.
Table 14 Queries with Different Result Values
Command
Change
Affects
*IDN?
Returns new instrument and module identifi- Both
ers.
*OPT?
*TST
Returns new module options.
Both
Both
Selftest result codes are completely new.
0 still means passed.
A head adapter is not overwritten with the 8153
head when it is inserted.
SENS:POW:UNIT?
SOUR:POW:WAV?
Returns W|DBM not a number.
8153
Returns LOW|UPP|BOTH|EXT and not the 8153
wavelength; use SOUR:WAV? to query the
wavelength. SOUR:WAV:FIXED1? returns
the wavelength of the first laser and
SOUR:WAV:FIXED2? returns the wave-
length of the second laser. For the
HP 8153A, SOUR:POW:WAV? returned the
wavelength of the active laser.
SYSTem:ERRor?
Same functionality but different numbers
and errors are returned for instrument spe-
cific errors.
8153
SOURce:AM:SOURce?
Returns different enum values than the
HP 8167/8.
8167/8
252
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
Timing Behavior
GPIB Command Compatibility List
Timing Behavior
Table 15 Timing Behavior Changes
Change
Affects
Command execution may be different.
Both
In all mainframes and modules firmware revisions before 3.x GPIB will Both
block during command execution, except when executing functions,
such as logging and sweep, that don’t tolerate blocking. This is
identical to the behavior of the 8167/8. A side effect of this is that
*OPC? always returns 1.
In later firmware revisions GPIB only blocks if a command can't be
processed because of a pending command. 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 reset after the averaging time is over; there
is no sliding behavior.
8153
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
253
Download from Www.Somanuals.com. All Manuals Search And Download.
GPIB Command Compatibility List
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 Agilent 8163A/B and 8164A/B; instead of timing out for every error,
detail the new errors
The error queue is written to as before.
Table 16 Error Handling Changes
Expected Return Value Returned Value
Affects
8153
8153
8153
8153
8153
FLOAT(32/64)
(U)INT(16/32)
Block
FLT/DBL_MAX
(U)INT(16/32)_MAX
" "
Boolean Value
Enum
0
Time out
Table 17 Specific Errors
Command
Change
Affects
FETCh:POWer? - without Returns the last valid value instead of timing 8153
using a preceding trigger out.
No error is generated.
254
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
GPIB Command Compatibility List
Instrument Status Settings
Instrument Status Settings
The trigger configuration automatically overrides other instrument setting
and control capabilities. This applies to both the HP 8153A and HP 8167/8.
256
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
Index
Power Meter
B
I
Identification 59
Power meter
C
Compatibility 246
Q
Contrast 186
Interface
R
Coordination of modules
example 199
L
D
LabView 221
Register
LabWindows 224
Date 76
Lambda scan
mult-frame 241
Display
LCD 187
Lockout 187
Reset 61
Return Loss
Laser
state 127
E
LCD 187
S
Error strings
GPIB 258
Self-test 62
Event register
M
Measurement
start 88
F
O
Fixed Laser Source
Options 60
Start
G
laser 127
measurement 88
H
P
Power measurement
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Sixth Edition
271
Download from Www.Somanuals.com. All Manuals Search And Download.
Stop
laser 127
Subsystem
DISPlay 186
FETCh 87
INITiate 88
LOCK 80
READ 91
SENSe 92
SLOT 81
SOURce 113
SPECial 84
STATus 64
SYSTem 76
TRIGger 171
T
Test 62
Time 78
U
Units 25
V
Visa calls
W
Wait 63
272
Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Sixth Edition
Download from Www.Somanuals.com. All Manuals Search And Download.
Download from Www.Somanuals.com. All Manuals Search And Download.
www.agilent.com
Agilent Technologies, Deutschland
GmbH 2002-2005
Printed in Germany January 2005
Fifth edition, January 2005
08164-90B64
Agilent Technologies
Download from Www.Somanuals.com. All Manuals Search And Download.
|