Keysight N7776C, N7778C, N7779C Programming Guide
Keysight N777-C Series
Tunable Laser Family
N7776C Tunable Laser Source
N7778C Tunable Laser Source
N7779C Tunable Laser Source
Programming
Guide
Notices
CAUTION
WARNING
© Keysight Technologies 2021
No part of this manual may be reproduced
in any form or by any means (including
electronic storage and retrieval or translation into a foreign language) without prior
agreement and written consent from
Keysight Technologies as governed by
United States and international copyright
laws.
Manual Part Number
N7770-90C02
Edition
Edition 2.1, February 2021
Keysight Technologies Deutschland GmbH
Herrenberger Strasse 130,
71034 Böblingen, Germany
Technology Licenses
The hardware and/or software described in
this document are furnished under a
license and may be used or copied only in
accordance with the terms of such license.
U.S. Government Rights
The Software is “commercial computer
software,” as defined by Federal Acquisition
Regulation (“FAR”) 2.101. Pursuant to FAR
12.212 and 27.405-3 and Department of
Defense FAR Supplement
(“DFARS”) 227.7202, the U.S. government
acquires commercial computer software
under the same terms by which the
software is customarily provided to the
public. Accordingly, Keysight provides the
Software to U.S. government customers
under its standard commercial license,
which is embodied in its End User License
Agreement (EULA), a copy of which can
be found at:
http://www.keysight.com/find/sweula.
The license set forth in the EULA represents
the exclusive authority by which the U.S.
government may use, modify, distribute, or
disclose the Software. The EULA and the
license set forth therein, does not require
or permit, among other things, that
Keysight: (1) Furnish technical information
related to commercial computer software
or commercial computer software
documentation that is not customarily
provided to the public; or (2) Relinquish to,
or otherwise provide, the government
rights in excess of these rights customarily
provided to the public to use, modify,
reproduce, release, perform, display, or
disclose commercial computer software or
commercial computer software documentation. No additional government requirements beyond those set forth in the EULA
shall apply, except to the extent that those
terms, rights, or licenses are explicitly
required from all providers of commercial
computer software pursuant to the FAR and
the DFARS and are set forth specifically in
writing elsewhere in the EULA. Keysight
shall be under no obligation to update,
revise or otherwise modify the Software.
With respect to any technical data as
defined by FAR 2.101, pursuant to FAR
12.211 and 27.404.2 and DFARS 227.7102,
the U.S. government acquires no greater
than Limited Rights as defined in FAR
27.401 or DFAR 227.7103-5 (c), as
applicable in any technical data.
Warranty
THE MATERIAL CONTAINED IN THIS
DOCUMENT IS PROVIDED "AS IS," AND IS
SUBJECT TO BEING CHANGED, WITHOUT
NOTICE, IN FUTURE EDITIONS. FURTHER,
TO THE MAXIMUM EXTENT PERMITTED BY
APPLICABLE LAW, KEYSIGHT DISCLAIMS
ALL WARRANTIES, EITHER EXPRESS OR
IMPLIED WITH REGARD TO THIS MANUAL
AND ANY INFORMATION CONTAINED
HEREIN, INCLUDING BUT NOT LIMITED TO
THE IMPLIED WARRANTIES OF
MERCHANTABILITY AND FITNESS FOR A
PARTICULAR PURPOSE. KEYSIGHT SHALL
NOT BE LIABLE FOR ERRORS OR FOR
INCIDENTAL OR CONSEQUENTIAL
DAMAGES IN CONNECTION WITH THE
FURNISHING, USE, OR PERFORMANCE OF
THIS DOCUMENT OR ANY INFORMATION
CONTAINED HEREIN. SHOULD KEYSIGHT
AND THE USER HAVE A SEPARATE
WRITTEN AGREEMENT WITH WARRANTY
TERMS COVERING THE MATERIAL IN THIS
DOCUMENT THAT CONFLICT WITH THESE
TERMS, THE WARRANTY TERMS IN THE
SEPARATE AGREEMENT WILL CONTROL.
Safety Notices
A CAUTION notice denotes a hazard.
It calls attention to an operating
procedure, practice, or the like that,
if not correctly performed or adhered
to, could result in damage to the
product or loss of important data.
Do not proceed beyond a CAUTION
notice until the indicated conditions
are fully understood and met.
A WARNING notice denotes a hazard.
It calls attention to an operating
procedure, practice, or the like that,
if not correctly performed or adhered
to, could result in personal injury or
death. Do not proceed beyond a
WARNING notice until the indicated
conditions are fully understood and
met.
2 Keysight N777-C Series Tunable Laser Family Programming Guide
Safety Summary
General This product is a Protection Class 1 instrument (provided with a protective earth terminal)
The following general safety precautions must be observed during all phases of operation
of this instrument. Failure to comply with these precautions or with specific warnings or
operating instructions in the product manuals violates safety standards of design,
manufacture, and intended use of the instrument. Keysight Technologies assumes no
liability for the customer's failure to comply with these requirements. Product manuals
are provided on the Web. Go to www.keysight.com and type in your product number in
the Search field at the top of the page.
and has been manufactured and tested according to international safety standards. The
protective features of this product may be impaired if it is used in a manner not specified
in the operation instructions.
All Light Emitting Diodes (LEDs) used in this product are Class 1 LEDs as per
IEC 60825-1:2014.
Environment Conditions
Tempe rat ure
Before Applying Power
Ground the Instrument
Do Not Operate in an
Explosive Atmosphere
This instrument is intended for indoor use in an Overvoltage Category II, pollution degree
2 environment. It is designed to operate at a maximum relative humidity of 85% RH,
non-condensing and at altitudes of up to 2000 meters. Refer to the specifications tables
for the AC mains voltage requirements and ambient operating temperature range.
The instrument should be protected from temperature extremes and changes in
temperature that may cause condensation within it.
The operating temperature is from 10 °C to +35 °C
The storage temperature is from –40 °C to +70 °C (Option D00, standard front panel)
___________________________ __ –30 °C to +70 °C (Option D01, touchscreen display)
Verify that all safety precautions are taken. The power cable inlet of the instrument serves
as a device to disconnect from the mains in case of hazard. The instrument must be
positioned so that the operator can easily access the power cable inlet. When the
instrument is rack mounted the rack must be provided with an easily accessible mains
switch.
To minimize shock hazard, the instrument chassis and cover must be connected to an
electrical protective earth ground. The instrument must be connected to the AC power
mains through a grounded power cable, with the ground wire firmly connected to an
electrical ground (safety ground) at the power outlet. Any interruption of the protective
(grounding) conductor or disconnection of the protective earth terminal will cause a
potential shock hazard that could result in personal injury.
Do not operate the instrument in the presence of flammable gases or fumes.
Do Not Remove the
Instrument Cover
Keysight N777-C Series Tunable Laser Family Programming Guide 3
Operating personnel must not remove instrument covers. Component replacement and
internal adjustments must be made only by qualified personnel.
Instruments that appear damaged or defective should be made inoperative and secured
against unintended operation until they can be repaired by qualified service personnel.
Instrument Markings
Instrument Marking Description
The instruction manual symbol. The product is marked with this warning symbol when it
is necessary for the user to refer to the instructions in the manual.
Standby supply. Unit is not completely disconnected from AC mains when switch is
off.
The CE mark is a registered trademark of the European Community.
The CSA mark with the 'c' and 'us' subscript indicates the instrument is certified to the
applicable Canadian and United States of America standards respectively.
The RCM mark is a registered trademark of the Australian Communications and Media
Authority
This symbol is a South Korean Class A EMC Declaration, with the product identification
code "R-R-Kst-3E18526".
R - Identification of authorization prefix.
R - Identification of basic certification information.
Kst - Identification of applicant's information
3E18526 - Product identification.
This is a Class A instrument suitable for professional use and in electromagnetic
environment outside of the home.
The recycling symbol indicates the general ease with which the instrument can be
recycled.
China Restricted Substance Product Label. The EPUP (environmental protection use
period) number in the center indicates the time period during which no hazardous
or toxic substances or elements are expected to leak or deteriorate during normal
use and generally reflects the expected useful life of the product.
4 Keysight N777-C Series Tunable Laser Family Programming Guide
South Korean Class A EMC Declaration
ۉࡅ߄έה
ࢇЕ߶הࡈˁ߾۰یࡈଟּࢶࡳԻࢶଢ۽ૡɼձ؇ࡵԻ۰ɼࢽࡈˁ߾۰ی
ࡈଜЕˁࡉࢷળɾۺࢂࡉԮɼݡТЬ
یࡈ ߇ΰחࡵ߶הࡈ ؏ܞݦࢢ߾փ ࢶࡈଞЬ
Information to the user:
This instrument has been conformity assessed for used in business environments. In a
residential environment this equipment may caused radio interference.
This EMC statement applies to the equipment only for use in business environment.
Compliance and Environmental Information
Table 1 Compliance and Environmental Information
Safety Symbol Description
This product complies with WEEE Directive (2002/96/EC) marking requirements.
The affixed label indicates that you must not discard this electrical/electronic
product in domestic household waste.
Product Category: With reference to the equipment types in WEEE Directive Annex I,
this product is classed as a “Monitoring and Control instrumentation” product.
Do not dispose in domestic household waste.
To return unwanted products, contact your local Keysight office, or see
http://about.keysight.com/en/companyinfo/environment/takeback.shtml for more
information.
Declaration of Conformity
Declarations of Conformity for this product and for the Keysight products may be
downloaded from the Web. Go to http://www.keysight.com/go/conformity.
You can then search by product number to find the latest Declaration of Conformity.
Keysight N777-C Series Tunable Laser Family Programming Guide 5
Contents
1 Introduction to Programming
Safety Summary 3
Instrument Markings 4
South Korean Class A EMC Declaration 5
Compliance and Environmental Information 5
Declaration of Conformity 5
Message Queues 10
How the Input Queue Works 10
Clearing the Input Queue 10
The Output Queue 10
The Error Queue 10
Programming and Syntax Diagram Conventions 12
Short Form and Long Form 12
Command and Query Syntax 13
Common Commands 16
Common Command Summary 16
Common Status Information 17
2 Command Summary
Command Summary 20
Keysight N777-C Series Tunable Laser Family Programming Guide 7
Contents
3 Instrument Setup and Status
IEEE-Common Commands 28
Status Reporting – The STATus Subsystem 34
Interface/Instrument Behaviour Settings – The SYSTem
Subsystem 41
System Communicate - The :SYST:COMMunicate sub tree 45
4 Measurement Operations & Settings
Root Layer Command 58
Signal Generation – The SOURce Subsystem 61
Configure Subsystem Commands 81
Triggering - The TRIGger Subsystem 84
5 Error Codes
Error Strings 88
8 Keysight N777-C Series Tunable Laser Family Programming Guide
Keysight N777-C Series Tunable Laser Family
Programming Guide
1 Introduction to
Programming
Message Queues / 10
Programming and Syntax Diagram Conventions / 12
Common Commands / 16
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
N777-C tunable laser source instruments.
1 Introduction to Programming
Message Queues
How the Input Queue Works
Clearing the Input Queue
The Output Queue
The instrument exchanges messages using an input and an output queue.
Error messages are kept in a separate error queue.
The input queue is a FIFO queue (first-in first-out). Incoming bytes are
stored in the input queue. The parser starts if the LF character is received.
Switching the power off, or sending a Device Interface Clear signal, causes
commands that are in the input queue, but have not been executed to be
lost.
The output queue 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 LF (0A
the query has an error, the output queue remains empty.
The Message Available bit (MAV, bit 4) is set in the Status Byte register
whenever there is data in the output queue.
). If no query is received, or if
16
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 If no error has occurred, the error queue contains:
o error"
+ 0, "N
2 After a command such as wav:pow, the error queue now contains:
+ 0, "N
o 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"
10 Keysight N777-C Series Tunable Laser Family Programming Guide
Introduction to Programming 1
If more than 29 errors are put into the queue, the message:
-350, "Queue overflow"
is placed as the last message in the queue.
Keysight N777-C Series Tunable Laser Family Programming Guide 11
1 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).
• You can use any valid number/unit combination.
In other words, 1500NM,1.5UM and 1.5E-6M are all equivalent.
If you do not specify a unit, then the default unit is assumed. The
default unit for the commands are given with command description in
the next chapter.
Short Form and Long Form
The instrument accepts messages in short or long forms.
For example, the message
:STATUS:OPERATION:ENABLE 768
is in long form.
The short form of this message is
:STAT:OPER:ENAB 768
In this manual, the messages are written in a combination of upper and
lower case. Upper case characters are used for the short form of the
message.
For example, the above command would be written
:STATus:OPERation:ENABle
The first colon can be left out for the first command or query in your
message. That is, the example given above could also be sent as
STAT:OPER:ENAB 768
12 Keysight N777-C Series Tunable Laser Family Programming Guide
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 is ascii data. A string is contained between double quotes ("...") or single quotes (‘...’).
value is numeric data in integer (12), decimal (34.5) or exponential format (67.8E-9).
wsp 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 (
a or b, but not both simultaneously.
Extra spaces are ignored, so spaces can be inserted to improve readability.
Introduction to Programming 1
|) shows an either-or choice of data, for example, a|b means either
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
decibel DB MDB, DB
second S NS, US, MS, S
decibel/1mW DBM MDBM, DBM
Keysight N777-C Series Tunable Laser Family Programming Guide 13
1 Introduction to Programming
NOTE
Unit Default Allowed Mnemonics
Hertz HZ HZ, KHZ, MHZ, GHZ, THZ
Watt Watt PW, NW, UW, MW, Watt
meters per second M/S NM/S, UM/S, MM/S, M/S
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 (
‘...’). When the instrument returns a string, it is always included in " ".
(
• 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>”; <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.
The block represents an array of numbers. Each number has the byte
ordering least significant byte first, also called LSBfirst, little-endian or
Intel byte ordering.
"...") or single quotes
Note that within your program, calculations with wavelengths may require
double-precision 64-bit floats to provide the desired resolution.
14 Keysight N777-C Series Tunable Laser Family Programming Guide
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. The
slot number for N777-C is always 0.
Channel numbers are not used for N777-C.
Introduction to Programming 1
Keysight N777-C Series Tunable Laser Family Programming Guide 15
1 Introduction to Programming
NOTE
Common Commands
Common Command Summary
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.
Table 3 on page -16 provides a summary of the common commands.
Table 3 Common Command Summary
Command Parameter Function Page
*CLS Clear Status Command page 28
*ESE Standard Event Status Enable Command page 28
*ESE? Standard Event Status Enable Query page 29
*ESR? Standard Event Status Register Query page 29
*IDN? Identification Query page 30
*OPC Operation Complete Command page 30
*OPC? Operation Complete Query page 30
*OPT? Options Query page 31
*RST Reset Command page 31
*STB? Read Status Byte Query page 32
*TST? Self Test Query page 32
*WAI Wait Command page 33
These commands are described in more detail in IEEE-Common Commands on
page 28.
16 Keysight N777-C Series Tunable Laser Family Programming Guide
Common Status Information
01234567
*STB? returns the Status Byte Register
Status
OSB ESB QSB
*ESR? returns the Standard Event Status Register
001
01234567
Event
100000
Status
Register
01234567
Event
111111
Status
Enable
Mask
*ESE sets the Standard Event Status Enable Mask
&
&
&
&
&
&
&
&
OR
Byte
All bits shown as are unused
0
MAV
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?.
Figure 1 shows how the Standard Event Status Enable Mask (SESEM) and
the Standard Event Status Register (SESR) determine the Event Status Bit
(ESB) of the Status Byte.
Introduction to Programming 1
Figure 1 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.
Keysight N777-C Series Tunable Laser Family Programming Guide 17
1 Introduction to Programming
NOTE
The questionable and operation status systems set the Operational Status
Bit (OSB) and the Questionable Status Bit (QSB).
Unused bits in any of the registers change to 0 when you read them.
18 Keysight N777-C Series Tunable Laser Family Programming Guide
Keysight N777-C Series Tunable Laser Family
Programming Guide
2 Command Summary
Command Summary / 20
This chapter lists commands relating to the N777-C series tunable laser
source instruments.
Each of these summaries contains a page reference for more detailed
information about the particular command later in this manual.
2 Command Summary
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.
Table 4 on page 20 gives an overview of the command tree. You see the
nodes, the subnodes, and the included commands.
Table 4 Command Summary
Command Page
CONFigure Subsystem
:CONFigure:MEASurement:SETTing:ACTual? Page 81
:CONFigure:MEASurement:SETTing:NUMBer? Page 81
:CONFigure:MEASurement:SETTing:PRESet Page 81
20 Keysight N777-C Series Tunable Laser Family Programming Guide
:CONFigure:MEASurement:SETTing:CANCel Page 82
:CONFigure:MEASurement:SETTing:RECall Page 82
:CONFigure:MEASurement:SETTing:SAVE Page 82
:CONFigure:MEASurement:SETTing:ERASe Page 83
Command Page
SOURce Subsystem
:SOURce0:AM:COHCtrl:COHLevel? Page 61
:SOURce0:AM:COHCtrl:COHLevel Page 61
:SOURce0:AM:SOURce? Page 62
:SOURce0:AM:SOURce Page 62
:SOURce0:AM:STATe Page 62
:SOURce0:AM:STATe? Page 63
Command Summary 2
Command Page
:SOURce0:READout:DATA? Page 63
:SOURce0:READout:POINts? Page 63
:SOURce0:WAVelength:CORRection:ARA Page 64
:SOURce0:WAVelength:CORRection:ZERO Page 64
:SOURce0:WAVelength:FREQuency Page 64
:SOURce0:WAVelength:FREQuency? Page 65
:SOURce0:WAVelength:SWEep:CHECkparams? Page 66
:SOURce0:WAVelength:REFerence? Page 65
:SOURce0:WAVelength:REFerence:DISPlay Page 65
:SOURce0:WAVelength:SWEep:CYCLes Page 67
:SOURce0:WAVelength:SWEep:CYCLes? Page 67
:SOURce0:WAVelength:SWEep:DWELl Page 68
:SOURce0:WAVelength:SWEep:FLAG? Page 69
:SOURce0:WAVelength:SWEep:DWELl? Page 68
:SOURce0:WAVelength:SWEep:LLOGging Page 69
:SOURce0:WAVelength:SWEep:LLOGging? Page 70
:SOURce0:WAVelength:SWEep:MODE Page 70
:SOURce0:WAVelength:SWEep:MODE? Page 71
:SOURce0:WAVelength:SWEep:PMAX? Page 71
:SOURce0:WAVelength:SWEep:REPeat Page 71
:SOURce0:WAVelength:SWEep:REPeat? Page 72
:SOURce0:WAVelength:SWEep:SOFTtrigger Page 72
:SOURce0:WAVelength:SWEep:SPEed Page 73
:SOURce0:WAVelength:SWEep:SPEed? Page 73
:SOURce0:WAVelength:SWEep:STARt Page 73
:SOURce0:WAVelength:SWEep:STOP? Page 75
:SOURce0:WAVelength:SWEep:STARt? Page 73
Keysight N777-C Series Tunable Laser Family Programming Guide 21
2 Command Summary
Command Page
:SOURce0:WAVelength:SWEep:STOP Page 74
:SOURce0:WAVelength:SWEep:[STATe] Page 75
:SOURce0:WAVelength:SWEep:[STATe]? Page 76
:SOURce0:WAVelength:SWEep:STEP:PREVious Page 76
:SOURce0:WAVelength:SWEep:STEP:NEXT Page 76
:SOURce0:WAVelength:SWEep:STEP:[WIDTh] Page 77
:SOURce0:POWer[:LEVel][:IMMediate][:AMPLitude]? Page 77
:SOURce0:WAVelength:SWEep:STEP:[WIDTh]? Page 77
:SOURce0:POWer[:LEVel][:IMMediate][:AMPLitude]? Page 78
:SOURce0:POWer:STATe Page 78
:SOURce0:POWer:STATe? Page 79
:SOURce0:POWer:UNIT Page 79
:SOURce0:POWer:UNIT? Page 79
Command Page
STATus Subsystem
:STATus:OPERation[:EVENt]? Page 34
:STATus:OPERation:CONDition? Page 34
:STATus:OPERation:ENABle Page 35
:STATus:OPERation:ENABle? Page 35
:STATu s0: OPER atio n:CONDition? Page 36
:STATus0:OPERation[:EVENt]? Page 35
:STATus0:OPERation:ENABle Page 37
:STATus0:OPERation:ENABle? Page 37
:STATu s:P RESe t Pag e 37
:STATus:QUEStionable[:EVENt]? Page 38
22 Keysight N777-C Series Tunable Laser Family Programming Guide
Command Summary 2
Command Page
:STATus:QUEStionable:CONDition? Page 38
:STATus:QUEStionable:ENABle Page 38
:STATus:QUEStionable:ENABle? Page 39
:STATus0:QUEStionable[:EVENt]? Page 39
:STATus0:QUEStionable:CONDition? Page 39
:STATus0:QUEStionable:ENABle Page 40
:STATus0:QUEStionable:ENABle? Page 40
Command Page
SYSTem Subsystem
:SYSTem:DATE Page 41
:SYSTem:DATE? Page 41
:SYSTem:HELP:HEADers? Page 41
:SYSTem:HELP:ERRors? Page 42
:SYSTem:TIME Page 42
:SYSTem:PRESet Page 43
:SYSTem:TIME? Page 43
:SYSTem:ERRor[:NEXT]? Page 43
:SYSTem:ERRor:COUNt? Page 43
:SYSTem:VERSion? Page 44
:SYSTem:REBoot Page 44
:SYSTem:COMMunicate:ETHernet:AUTOip:ENABle? Page 45
:SYSTem:COMMunicate:ETHernet:AUTOip:ENABle Page 46
:SYSTem:COMMunicate:ETHernet:CANCel Page 46
:SYSTem:COMMunicate:ETHernet:DGATeway Page 46
:SYSTem:COMMunicate:ETHernet:DGATeway? Page 46
Keysight N777-C Series Tunable Laser Family Programming Guide 23
2 Command Summary
Command Page
:SYSTem:COMMunicate:ETHernet:DGATeway:CURRent? Page 47
:SYSTem:COMMunicate:ETHernet:DHCP:ENABle? Page 47
:SYSTem:COMMunicate:ETHernet:DHCP:ENABle Page 47
:SYSTem:COMMunicate:ETHernet:DOMainname? Page 48
:SYSTem:COMMunicate:ETHernet:DOMainname Page 48
:SYSTem:COMMunicate:ETHernet:DOMainname:CURRent? Page 48
:SYSTem:COMMunicate:ETHernet:HOSTname Page 48
:SYSTem:COMMunicate:ETHernet:HOSTname? Page 49
:SYSTem:COMMunicate:ETHernet:HOSTname:CURRent? Page 49
:SYSTem:COMMunicate:ETHernet:NSERver? Page 49
:SYSTem:COMMunicate:ETHernet:NSERver Page 50
:SYSTem:COMMunicate:ETHernet:NSERver:CURRent? Page 50
:SYSTem:COMMunicate:ETHernet:IDN Page 50
24 Keysight N777-C Series Tunable Laser Family Programming Guide
:SYSTem:COMMunicate:ETHernet:IPADdress Page 50
:SYSTem:COMMunicate:ETHernet:IPADdress? Page 51
:SYSTem:COMMunicate:ETHernet:IPADdress:CURRent? Page 51
:SYSTem:COMMunicate:ETHernet:MACaddress? Page 51
:SYSTem:COMMunicate:ETHernet:NTP:ENABle? Page 52
:SYSTem:COMMunicate:ETHernet:NTP:ENABle Page 52
:SYSTem:COMMunicate:ETHernet:NTP:SERVer? Page 52
:SYSTem:COMMunicate:ETHernet:NTP:SERVer Page 52
:SYSTem:COMMunicate:ETHernet:DESCription? Page 53
:SYSTem:COMMunicate:ETHernet:DESCription Page 53
::SYSTem:COMMunicate:ETHernet:RESet Page 53
:SYSTem:COMMunicate:ETHernet:RESTart Page 54
:SYSTem:COMMunicate:ETHernet:SAVE Page 54
Command Summary 2
Command Page
:SYSTem:COMMunicate:ETHernet:SMASk? Page 54
:SYSTem:COMMunicate:ETHernet:SMASk Page 55
:SYSTem:COMMunicate:ETHernet:SMASk:CURRent? Page 55
Command Page
TRIGger Subsystem
:TRIGger Page 84
:TRIGger[n]:INPut Page 84
:TRIGger[n]:INPut? Page 85
:TRIGger[n]:OUTPut? Page 85
:TRIGger[n]:OUTPut Page 85
:TRIGger:CONFiguration Page 86
:TRIGger:CONFiguration? Page 86
Keysight N777-C Series Tunable Laser Family Programming Guide 25
Keysight N777-C Series Tunable Laser Family
Programming Guide
3 Instrument Setup and
Status
IEEE-Common Commands / 28
Status Reporting – The STATus Subsystem / 34
Interface/Instrument Behaviour Settings – The SYSTem Subsystem / 41
System Communicate - The :SYST:COMMunicate sub tree / 45
This chapter gives descriptions of commands that you can use when
setting up your instrument. The commands are split into the following
separate subsytems:
• IEEE specific commands that were introduced in Common Commands on
page 16.
• STATus subsystem commands that relate to the status model.
• SYSTem subsystem commands that control the serial interface and
internal data.
3 Instrument Setup and Status
IEEE-Common Commands
Command: *CLS
Syntax: *CLS
Common Commands on page 16 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.
Description: The Clear Status (*CLS) command clears the status byte by emptying the error queue and clearing all the event registers
Parameters: none
Response: none
Example: *CLS
(SESR) including the Data Questionable Event Register, the Standard Event Status Register, the Standard Operation Status
Register and any other registers that are summarized in the status byte.
Command: *ESE
Syntax: *ESE<wsp><value>
Description: The standard Event Status Enable command (*ESE) sets bits in the Standard Event Status Enable Mask (SESEM) that enable
Parameters: The bit value for the register (a 16-bit signed integer value):
0 ≤ value ≤ 255
the corresponding bits in the standard event status register (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.
Bit Mnemonic Decimal Value
7 (MSB) Power On 128
6Not Used 64
5 Command Error 32
4 Execution Error 16
3 Device Dependent Error 8
2Query Error 4
28 Keysight N777-C Series Tunable Laser Family Programming Guide
1Not Used 2
0 (LSB) Operation Complete 1
Response: none
Example: *ESE 255
Command: *ESE?
Syntax: *ESE?
Instrument Setup and Status 3
Description: The standard Event Status Enable query *ESE? returns the contents of the Standard Event Status Enable Mask (see *ESE
for information on this register).
Parameters: none
Response: The bit value for the register (a 16-bit signed integer value).
Example: *ESE? −> +255
Command: *ESR?
Syntax: *ESR?
Description: The standard Event Status Register query *ESR? returns the contents of the Standard Event Status Register. The register
is cleared after being read.
parameters none
response The bit value for the register (a 16-bit signed integer value):
Bit Mnemonic Decimal Value
7 (MSB) Power On 128
6Not used 64
5 Command Error 32
4 Execution Error 16
3 Device Dependent Error 8
2Query Error 4
Keysight N777-C Series Tunable Laser Family Programming Guide 29
3 Instrument Setup and Status
1Not used 2
0 (LSB) Operation Complete 1
Example: *ESR? -> +128
Command: *IDN?
Syntax: *IDN?
Description: The IDeNtification query *IDN? gets the instrument identification over the interface.
Parameters: none
Response: The identification, for example:
MMMMMMMM
mmmm
ssssssss
rrrrrrrrrr
Example: *IDN? -> Keysight Technologies,N7776C,N71130PP02,V1.000
manufacturer, for example Keysight Technologies
instrument model number (for example N7776C)
serial number
firmware revision level
Command: *OPC
Syntax: *OPC
Description: Generates the OPC message in the standard event status register when all pending overlapped operations have been
Parameters: none
Response: none
Example: *OPC
Command: *OPC?
Syntax: *OPC?
Description: The OPeration Complete query *OPC? parses all program message units in the input queue, sets the operation complete bit
completed.
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.
Taking advantage 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.
30 Keysight N777-C Series Tunable Laser Family Programming Guide
Loading...