Keysight N777 C Series Programming Manual
  1. Manuals
  2. Brands
  3. Keysight Manuals
  4. Measuring Instruments
  5. N777 C Series
  6. Programming manual

Keysight N777 C Series Programming Manual

Tunable laser source
Hide thumbs
Table of Contents

Advertisement

Quick Links

Keysight N777xC Series
Tunable Laser Family
N7776C Tunable Laser Source
N7778C Tunable Laser Source
N7779C Tunable Laser Source
Programming
Guide

Advertisement

Table of Contents
loading

Related Manuals for Keysight N777 C Series

Summary of Contents for Keysight N777 C Series

  • Page 1 Keysight N777xC Series Tunable Laser Family N7776C Tunable Laser Source N7778C Tunable Laser Source N7779C Tunable Laser Source Programming Guide...

  • Page 2: Command Summary

    HEREIN, INCLUDING BUT NOT LIMITED TO http://www.keysight.com/find/sweula. THE IMPLIED WARRANTIES OF The license set forth in the EULA represents MERCHANTABILITY AND FITNESS FOR A the exclusive authority by which the U.S. PARTICULAR PURPOSE. KEYSIGHT SHALL Keysight N777xC Series Tunable Laser Family Programming Guide...

  • Page 3: Safety Summary

    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.

  • Page 4: Instrument Markings

    Keysight N777xC Series Tunable Laser Family Programming Guide...

  • Page 5: Compliance And Environmental 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.

  • Page 7: Table Of Contents

    Short Form and Long Form Command and Query Syntax Common Commands Common Command Summary Common Status Information 2 Command Summary Command Summary 3 Instrument Setup and Status IEEE-Common Commands Status Reporting – The STATus Subsystem Keysight N777xC Series Tunable Laser Family Programming Guide...
  • Page 8 System Communicate - The :SYST:COMMunicate sub tree 4 Measurement Operations & Settings Root Layer Command Signal Generation – The SOURce Subsystem Configure Subsystem Commands Triggering - The TRIGger Subsystem 5 Error Codes Error Strings Keysight N777xC Series Tunable Laser Family Programming Guide...
  • Page 9 Keysight N777xC Series Tunable Laser Family Programming Guide 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.

  • Page 10: Message Queues

    , the error queue now contains: o error" + 0, "N -113, "Undefined header" If the command is immediately repeated, the error queue now contains: o error" + 0, "N -113, "Undefined header" -113, "Undefined header" Keysight N777xC Series Tunable Laser Family Programming Guide...
  • Page 11 Introduction to Programming 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 N777xC Series Tunable Laser Family Programming Guide...

  • Page 12: Programming And Syntax Diagram Conventions

    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 Keysight N777xC Series Tunable Laser Family Programming Guide...

  • Page 13: Command And Query Syntax

    The full sets of units are given in the table below. Table 2 Units and allowed Mnemonics Unit Default Allowed Mnemonics meters PM, NM, UM, MM, M decibel MDB, DB second NS, US, MS, S decibel/1mW MDBM, DBM Keysight N777xC Series Tunable Laser Family Programming Guide...
  • Page 14 LSBfirst, little-endian or Intel byte ordering. Note that within your program, calculations with wavelengths may require NOTE double-precision 64-bit floats to provide the desired resolution. Keysight N777xC Series Tunable Laser Family Programming Guide...
  • Page 15 [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 N777xC is always 0. Channel numbers are not used for N777xC. Keysight N777xC Series Tunable Laser Family Programming Guide...

  • Page 16: Common Commands

    *RST Reset Command page *STB? Read Status Byte Query page *TST? Self Test Query page *WAI Wait Command page These commands are described in more detail in IEEE-Common Commands NOTE page 28. Keysight N777xC Series Tunable Laser Family Programming Guide...

  • Page 17: Common Status Information

    Status Byte. If you set a bit of the SESEM to zero, the corresponding event cannot affect the ESB. The default is for all the bits of the SESEM to be set to 0. Keysight N777xC Series Tunable Laser Family Programming Guide...
  • Page 18 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. NOTE Keysight N777xC Series Tunable Laser Family Programming Guide...
  • Page 19 Keysight N777xC Series Tunable Laser Family Programming Guide Command Summary Command Summary / 20 This chapter lists commands relating to the N777xC 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.

  • Page 20: Command Summary

    CONFigure Subsystem :CONFigure:MEASurement:SETTing:ACTual? Page :CONFigure:MEASurement:SETTing:NUMBer? Page :CONFigure:MEASurement:SETTing:PRESet Page :CONFigure:MEASurement:SETTing:CANCel Page :CONFigure:MEASurement:SETTing:RECall Page :CONFigure:MEASurement:SETTing:SAVE Page :CONFigure:MEASurement:SETTing:ERASe Page Command Page SOURce Subsystem :SOURce0:AM:COHCtrl:COHLevel? Page :SOURce0:AM:COHCtrl:COHLevel Page :SOURce0:AM:SOURce? Page :SOURce0:AM:SOURce Page :SOURce0:AM:STATe Page :SOURce0:AM:STATe? Page Keysight N777xC Series Tunable Laser Family Programming Guide...
  • Page 21 :SOURce0:WAVelength:SWEep:DWELl Page :SOURce0:WAVelength:SWEep:FLAG? Page :SOURce0:WAVelength:SWEep:DWELl? Page :SOURce0:WAVelength:SWEep:LLOGging Page :SOURce0:WAVelength:SWEep:LLOGging? Page :SOURce0:WAVelength:SWEep:MODE Page :SOURce0:WAVelength:SWEep:MODE? Page :SOURce0:WAVelength:SWEep:PMAX? Page :SOURce0:WAVelength:SWEep:REPeat Page :SOURce0:WAVelength:SWEep:REPeat? Page :SOURce0:WAVelength:SWEep:SOFTtrigger Page :SOURce0:WAVelength:SWEep:SPEed Page :SOURce0:WAVelength:SWEep:SPEed? Page :SOURce0:WAVelength:SWEep:STARt Page :SOURce0:WAVelength:SWEep:STOP? Page :SOURce0:WAVelength:SWEep:STARt? Page Keysight N777xC Series Tunable Laser Family Programming Guide...
  • Page 22 :SOURce0:POWer:STATe Page :SOURce0:POWer:STATe? Page :SOURce0:POWer:UNIT Page :SOURce0:POWer:UNIT? Page Command Page STATus Subsystem :STATus:OPERation[:EVENt]? Page :STATus:OPERation:CONDition? Page :STATus:OPERation:ENABle Page :STATus:OPERation:ENABle? Page :STATus0:OPERation:CONDition? Page :STATus0:OPERation[:EVENt]? Page :STATus0:OPERation:ENABle Page :STATus0:OPERation:ENABle? Page :STATus:PRESet Page :STATus:QUEStionable[:EVENt]? Page Keysight N777xC Series Tunable Laser Family Programming Guide...
  • Page 23 :SYSTem:DATE Page :SYSTem:DATE? Page :SYSTem:HELP:HEADers? Page :SYSTem:HELP:ERRors? Page :SYSTem:TIME Page :SYSTem:PRESet Page :SYSTem:TIME? Page :SYSTem:ERRor[:NEXT]? Page :SYSTem:ERRor:COUNt? Page :SYSTem:VERSion? Page :SYSTem:REBoot Page :SYSTem:COMMunicate:ETHernet:AUTOip:ENABle? Page :SYSTem:COMMunicate:ETHernet:AUTOip:ENABle Page :SYSTem:COMMunicate:ETHernet:CANCel Page :SYSTem:COMMunicate:ETHernet:DGATeway Page :SYSTem:COMMunicate:ETHernet:DGATeway? Page Keysight N777xC Series Tunable Laser Family Programming Guide...
  • Page 24 :SYSTem:COMMunicate:ETHernet:NSERver:CURRent? Page :SYSTem:COMMunicate:ETHernet:IDN Page :SYSTem:COMMunicate:ETHernet:IPADdress Page :SYSTem:COMMunicate:ETHernet:IPADdress? Page :SYSTem:COMMunicate:ETHernet:IPADdress:CURRent? Page :SYSTem:COMMunicate:ETHernet:MACaddress? Page :SYSTem:COMMunicate:ETHernet:NTP:ENABle? Page :SYSTem:COMMunicate:ETHernet:NTP:ENABle Page :SYSTem:COMMunicate:ETHernet:NTP:SERVer? Page :SYSTem:COMMunicate:ETHernet:NTP:SERVer Page :SYSTem:COMMunicate:ETHernet:DESCription? Page :SYSTem:COMMunicate:ETHernet:DESCription Page :SYSTem:COMMunicate:ETHernet:WHITEList:ENABle? Page :SYSTem:COMMunicate:ETHernet:WHITEList:ENABle Page :SYSTem:COMMunicate:ETHernet:WHITEList#:IPADdress? Page :SYSTem:COMMunicate:ETHernet:WHITEList#:IPADdress Page Keysight N777xC Series Tunable Laser Family Programming Guide...
  • Page 25 :SYSTem:COMMunicate:ETHernet:WHITEList#:SMASk Page ::SYSTem:COMMunicate:ETHernet:RESet Page :SYSTem:COMMunicate:ETHernet:RESTart Page :SYSTem:COMMunicate:ETHernet:SAVE Page :SYSTem:COMMunicate:ETHernet:SMASk? Page :SYSTem:COMMunicate:ETHernet:SMASk Page :SYSTem:COMMunicate:ETHernet:SMASk:CURRent? Page Command Page TRIGger Subsystem :TRIGger Page :TRIGger[n]:INPut Page :TRIGger[n]:INPut? Page :TRIGger[n]:OUTPut? Page :TRIGger[n]:OUTPut Page :TRIGger:CONFiguration Page :TRIGger:CONFiguration? Page Keysight N777xC Series Tunable Laser Family Programming Guide...
  • Page 27 Keysight N777xC Series Tunable Laser Family Programming Guide 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...

  • Page 28: Ieee-Common Commands

    The register is not changed by the *RST and *CLS commands. Parameters: The bit value for the register (a 16-bit signed integer value): Mnemonic Decimal Value 7 (MSB) Power On Not Used Command Error Execution Error Device Dependent Error Query Error Keysight N777xC Series Tunable Laser Family Programming Guide...
  • Page 29 The bit value for the register (a 16-bit signed integer value): Mnemonic Decimal Value 7 (MSB) Power On Not used Command Error Execution Error Device Dependent Error Query Error Keysight N777xC Series Tunable Laser Family Programming Guide...
  • Page 30 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. Keysight N777xC Series Tunable Laser Family Programming Guide...
  • Page 31 Service request enable register (SRE) Standard Event Status Enable Mask (SESEM) To prevent this, use the CONFigure:MEASurement:SETTing:PRESet command to keep the previously stored settings in non-volatile RAM. Parameters: none Response: none Example: *RST Keysight N777xC Series Tunable Laser Family Programming Guide...
  • Page 32 The self-test does not require operator interaction beyond sending the *TST? query. Parameters: none Response: Selftest failed A value of zero indicates no errors. -> Example: *TST? Keysight N777xC Series Tunable Laser Family Programming Guide...
  • Page 33 *WAI blocks all commands until every module hosted by the instrument is no longer busy. All pending operations, are completed during the wait period. Parameters: none Response: none Example: *WAI Keysight N777xC Series Tunable Laser Family Programming Guide...

  • Page 34: Status Reporting - The Status Subsystem

    Parameters: none ≤ ≤ Response: The sum of the results for the module (a 16-bit unsigned integer value, where 0 value 65535): Bits 15 - 1 Not used Summary -> Example: :stat:oper:cond? Keysight N777xC Series Tunable Laser Family Programming Guide...
  • Page 35 The bit value for the operation enable mask as a 16-bit unsigned integer value (0 .. +65535) -> Example: :stat:oper:enab? +128 Command: :STATus0:OPERation[:EVENt]? Syntax: :STATus0:OPERation[:EVENt]? Description: Returns the Operational Slot Status Event Register (OSSER) of the laser module. Parameters: none Keysight N777xC Series Tunable Laser Family Programming Guide...
  • Page 36 65535): Mnemonic Decimal Value 8-16 Not used Not used Not used Not used Shutter open Zeroing ongoing Not used Coherence Control is switched on Laser is switched on -> Example: :stat0:oper:cond? Keysight N777xC Series Tunable Laser Family Programming Guide...
  • Page 37 The bit value for the OSSEM as a 16-bit unsigned integer value (0 .. +65535) Example: :stat0:oper:enab? -> +128 Command: :STATus:PRESet Syntax: :STATus:PRESet Description: Presets all bits in all OPERation and QUEStionable status systems to 0. Parameters: none Response: none Example: :stat:pres Keysight N777xC Series Tunable Laser Family Programming Guide...

  • Page 38: Status:questionable:condition

    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. Keysight N777xC Series Tunable Laser Family Programming Guide...

  • Page 39: Status:questionable:enable

    Slot n: Excessive Value has occurred Every nth bit is the summary of the laser module. -> Example: :stat0:oper? Command: :STATus0:QUEStionable:CONDition? Syntax: :STATus0:QUEStionable:CONDition? Description: Returns the Questionable Slot Status Condition Register for the laser module. Parameters: none Keysight N777xC Series Tunable Laser Family Programming Guide...

  • Page 40: Status0:Questionable:enable

    :STATus0:QUEStionable:ENABle? Syntax: :STATus0:QUEStionable:ENABle? Description: Returns the QSSEM for slot n Parameters: none Response: The bit value for the QSSEM as a 16-bit unsigned integer value (0 .. +65535) -> Example: :stat0:ques:enab? +128 Keysight N777xC Series Tunable Laser Family Programming Guide...

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

    The date in the format year, month, day (16-bit signed integer values) -> Example: :syst:date? +2019,+10,+12 Command: :SYSTem:HELP:HEADers? Syntax: :SYSTem:HELP:HEADers? Description: Returns a list of commands. Parameters: none Response: Returns a list of commands Example: :syst:help:head? -> Returns a list of all commands Keysight N777xC Series Tunable Laser Family Programming Guide...

  • Page 42: System:help:errors

    NOTE: This will also erase all saved configurations. To prevent this, use :CONFigure:MEASurement:SETTing:PRESet on page 83 command to keep previous stored settings in the NVRAM. Parameters: none Response: none Example: :SYST:PRES Command: :SYSTem:TIME Syntax: :SYSTem:TIME<wsp><hour>,<minute>,<second> Description: Sets the instrument’s internal time. Keysight N777xC Series Tunable Laser Family Programming Guide...

  • Page 43: System:preset

    The number of the latest error, and its meaning. Example: :syst:err? -> -113,"Undefined header" Command: :SYSTem:ERRor:COUNt? Syntax: :SYSTem:ERRor:COUNt? Description: Returns the total no. of errors. Parameters: none Response: The total count of errors. Example: :syst:err:coun? -> 20 Keysight N777xC Series Tunable Laser Family Programming Guide...

  • Page 44: System:version

    Returns the SCPI revision to which the instrument complies. Parameters: none Response: The revision year and number. −> Example: :syst:vers? 2019.0 Command: :SYSTem:REBoot Syntax: :SYSTem:REBoot Description: Reboots the instrument. Parameters: none Response: None Example: :syst:reb Keysight N777xC Series Tunable Laser Family Programming Guide...

  • Page 45: System Communicate - The :Syst:communicate Sub Tree

    The Media Access Control (MAC) number is a unique number associated with each network adapter. Command: :SYSTem:COMMunicate:ETHernet:AUTOip:ENABle? Syntax: :SYSTem:COMMunicate:ETHernet:AUTOip:ENABle? Description: Check whether Automatic IP addressing is enabled or disabled. Parameters: None Response: Boolean (0 | 1) Example: :SYST:COMM:ETH:AUTO:ENAB? Keysight N777xC Series Tunable Laser Family Programming Guide...

  • Page 46: System:communicate:ethernet:autoip:enable

    (Up to four groups of up to 3 digits, groups separated by ".". Groups with leading zeros are interpreted as octal numbers.) Response: None Example: :syst:comm:eth:dgat “192.168.101.11“ Command: :SYSTem:COMMunicate:ETHernet:DGATeway? Syntax: :SYSTem:COMMunicate:ETHernet:DGATeway? Description: Get the default gateway. Keysight N777xC Series Tunable Laser Family Programming Guide...

  • Page 47: System:communicate:ethernet:dgateway:current

    Response: Boolean (0 | 1) Example: :syst:comm:eth:dhcp:enab? -> 1 Command: :SYSTem:COMMunicate:ETHernet:DHCP:ENABle Syntax: :SYSTem:COMMunicate:ETHernet:DHCP:ENABle Description: Enable or disable DHCP Parameters: Boolean (0 | 1 | off | on) Response: None Example: :syst:comm:eth:dhcp:enab on Keysight N777xC Series Tunable Laser Family Programming Guide...

  • Page 48: System:communicate:ethernet:domainname

    None Example: :syst:comm:eth:dom “.companyname.com” Command: :SYSTem:COMMunicate:ETHernet:DOMainname:CURRent? Syntax: :SYSTem:COMMunicate:ETHernet:DOMainname:CURRent? Description: Get the currently used domain name. Parameters: None Response: String Example: :syst:comm:eth:dom:curr? -> “.companyame.com” Command: :SYSTem:COMMunicate:ETHernet:HOSTname Syntax: :SYSTem:COMMunicate:ETHernet:HOSTname Description: Set the host name. Keysight N777xC Series Tunable Laser Family Programming Guide...

  • Page 49: System:communicate:ethernet:hostname

    Parameters: None Response: String Example: :syst:comm:eth:host:curr? -> "K-N7776C-12345" Command: :SYSTem:COMMunicate:ETHernet:NSERver? Syntax: :SYSTem:COMMunicate:ETHernet:NSERver? Description: Get the defined (DNS) nameserver for name resolution. Parameters: None Response: IP Address String Example: :syst:comm:eth:nser? -> "1.1.1.1", "2.2.2.2" Keysight N777xC Series Tunable Laser Family Programming Guide...

  • Page 50: System:communicate:ethernet:nserver

    Parameters: Boolean (0 | 1 | off | on) Response: None Example: :syst:comm:eth:idn 1 Command: :SYSTem:COMMunicate:ETHernet:IPADdress Syntax: :SYSTem:COMMunicate:ETHernet:IPADdress Description: Set the IP address of the system manually (used if DHCP is disabled). Keysight N777xC Series Tunable Laser Family Programming Guide...

  • Page 51: System:communicate:ethernet:ipaddress

    Parameters: None Response: String Example: :syst:comm:eth:ipad:curr? -> “192.132.13.2” Command: :SYSTem:COMMunicate:ETHernet:MACaddress? Syntax: :SYSTem:COMMunicate:ETHernet:MACaddress? Description: Get the MAC address of the network adapter. Parameters: None Response: String (hexadecimal value). Example: :syst:comm:eth:mac? -> "00-07-E0-14-AE- 08" Keysight N777xC Series Tunable Laser Family Programming Guide...

  • Page 52: System:communicate:ethernet:ntp:enable

    Get the defined Network Time Protocol (NTP) server for clock synchronization. Parameters: None Response: Address String Example: :syst:comm:eth:ntp:serv? -> "pool.ntp.org" Command: :SYSTem:COMMunicate:ETHernet:NTP:SERVer Syntax: :SYSTem:COMMunicate:ETHernet:NTP:SERVer Description: Get the defined Network Time Protocol (NTP) server for clock synchronization. Keysight N777xC Series Tunable Laser Family Programming Guide...

  • Page 53: System:communicate:ethernet:description

    Quoted string of up to 260 characters Response: None Example: :syst:comm:eth:desc "Keysight N777xC - 42321" Command: :SYSTem:COMMunicate:ETHernet:WHITEList:ENABle? Syntax: :SYSTem:COMMunicate:ETHernet:WHITEList:ENABle? Description: Get the deive access IP whitelist status Parameters: None Response: Boolean (0 | 1) Example: :syst:comm:eth:whitel:enab? +0 Keysight N777xC Series Tunable Laser Family Programming Guide...

  • Page 54: System:communicate:ethernet:whitelist:enable

    Response: None Example: :syst:comm:eth:whitel1:ipad "192.168.0.2" Command: :SYSTem:COMMunicate:ETHernet:WHITEList#:SMASk? Syntax: :SYSTem:COMMunicate:ETHernet:WHITEList#:SMASk? Description: Get an entry in the device access ip whitelist (up to 10 IP Addresses) of permitted client which could control this instrument. Keysight N777xC Series Tunable Laser Family Programming Guide...

  • Page 55: System:communicate:ethernet:whitelist#:Smask

    Pressing the "LAN Reset" button for a short time is the same as system:preset command. DHCP On AutoIP On NTP Off Whitelist Off Hostname is a concatenation of product number and serial number. The password for the web based LAN configuration interface is reset to ‘keysight’. Parameters: None Response: None Example:...

  • Page 56: System:communicate:ethernet:save

    Set the subnet mask. Parameters: String (Up to four groups of up to 3 digits, groups separated by ".". Groups with leading zeroes are interpreted as octal numbers.) Response: None Example: :syst:comm:eth:smas “255.255.255.0“ Keysight N777xC Series Tunable Laser Family Programming Guide...

  • Page 57: System:communicate:ethernet:smask:current

    Instrument Setup and Status Command: :SYSTem:COMMunicate:ETHernet:SMASk:CURRent? Syntax: :SYSTem:COMMunicate:ETHernet:SMASk:CURRent? Description: Get the currently used subnet mask. Parameters: None Response: String Example: :syst:comm:eth:smas:curr? -> “255.255.255.0” Keysight N777xC Series Tunable Laser Family Programming Guide...

  • Page 59: Trigger Subsystem

    Keysight N777xC Series Tunable Laser Family Programming Guide Measurement Operations & Settings Root Layer Command / 60 Signal Generation – The SOURce Subsystem / 63 Configure Subsystem Commands / 83 Triggering - The TRIGger Subsystem / 86 This chapter gives descriptions of commands that you can use when you are setting up or performing measurements.

  • Page 60: Root Layer Command

    :lock 1,1234 - 1234 is the default password Command: :LOCK? Syntax: :LOCK? Description: Queries the current state of the lock. Parameters: none Response: A boolean value: 0: lock is switched off 1: lock is switched on -> Example: :lock? Keysight N777xC Series Tunable Laser Family Programming Guide...
  • Page 61 30 for information on mainframe identity strings, :SLOT[n]:IDN? on page 61 for information on module identity strings. Command: :SLOT[n]:OPTions? Syntax: :SLOT[n]:OPTions? Description: Returns information about device's options. Parameters: None Response: A string. Example: :slot0:opt? -> 216 Keysight N777xC Series Tunable Laser Family Programming Guide...
  • Page 62 Returns the latest selftest results for a device for compatibility reasons. Parameters: None Response: Returns +0 Example: :slot0:tst? -> +0 Command: :SPECial:REBoot Syntax: :SPECial:REBoot Description: Reboots the device. Parameters: none Response: none Example: :spec:reb Keysight N777xC Series Tunable Laser Family Programming Guide...

  • Page 63: Signal Generation - The Source Subsystem

    The excursion level as a percentage of its maximum value. Also allowed: MIN: minimum programmable value (1%) MAX: maximum programmable value (100%) DEF: default preset (*RST) value. Response: None Example: :sour0:am:cohc:cohl 50 Affects: N7778C and N7779C Keysight N777xC Series Tunable Laser Family Programming Guide...
  • Page 64 Enables and disables amplitude modulation of the laser output. Parameters: A boolean value: OFF or 0: amplitude modulation disabled (default) ON or 1: amplitude modulation enabled. Response: None Example: :sour0:am:stat 0 Affects: All N777xC laser sources Keysight N777xC Series Tunable Laser Family Programming Guide...
  • Page 65 Returns the number of datapoints that the :READout:DATA? command will return. • Parameters: LLOGging: Returns the number of wavelength steps for a lambda logging operation. • PMAX: Returns the number of datapoints (each datapoint contains a value for wavelength and power). Keysight N777xC Series Tunable Laser Family Programming Guide...
  • Page 66 The output wavelength[l] is set from the base wavelength (l0) and the frequency offset (df). The formula for calculating the output wavelength is: where c is the speed of light in a vacuum (2.990 x 108 ms-1) Keysight N777xC Series Tunable Laser Family Programming Guide...
  • Page 67 All N777xC tunable laser sources Command: :SOURce0:WAVelength:REFerence:DISPlay Syntax: :SOURce0:WAVelength:REFerence:DISPlay Description: Sets the reference wavelength to the value of the output wavelength (l -> l0), that is, sets the frequency offset (df) to zero. Parameters: None Keysight N777xC Series Tunable Laser Family Programming Guide...
  • Page 68 376,Lambda logging in stepped mode lambda logging can only be done in continuous sweep mode 377,step not multiple of <x> the step size must be a multiple of the smallest possible step size Keysight N777xC Series Tunable Laser Family Programming Guide...
  • Page 69 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. Keysight N777xC Series Tunable Laser Family Programming Guide...
  • Page 70 DEF: This is not the preset (*RST) default value but is half the sum of, the minimum programmable value and the maximum programmable value Response: The dwell time in seconds. Example: :sour0:wav:swe:dwel? -> +5.00000000E-001 Affects: All N777xC tunable laser sources Keysight N777xC Series Tunable Laser Family Programming Guide...
  • Page 71 Set :AM:STATe[l] to OFF 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. Keysight N777xC Series Tunable Laser Family Programming Guide...
  • Page 72 All tunable laser modules that support continuous sweeps. Command: :SOURce0:WAVelength:SWEep:MODE Syntax: :SOURce0:WAVelength:SWEep:MODE<wsp><mode> Description: Sets the sweep mode. Cannot be set while a sweep is running. Parameters: STEPped: Stepped sweep mode MANual: Manual sweep mode CONTinuous: Continuous sweep mode Keysight N777xC Series Tunable Laser Family Programming Guide...
  • Page 73 All N777xC tunable laser sources Command: :SOURce0:WAVelength:SWEep:REPeat Syntax: :SOURce0:WAVelength:SWEep:REPeat<wsp><mode> Description: Sets the repeat mode. Applies in stepped-sweep and manual sweep modes. The N7776C, N7777C and N7778C also support TWOWay mode in continuous sweep mode. Keysight N777xC Series Tunable Laser Family Programming Guide...
  • Page 74 All N777xC tunable laser sources Command: :SOURce0:WAVelength:SWEep:SOFTtrigger Syntax: :SOURce0:WAVelength:SWEep:SOFTtrigger Description: Softtrigger does the same as a normal (hardware) trigger at the backplane. Usage: - Trigger input configuration: Start Sweep - Start Sweep - SoftTrigger Parameters: None Keysight N777xC Series Tunable Laser Family Programming Guide...
  • Page 75 Example: :sour0:wav:swe:spe? +8.00000000e-08 Affects: All tunable laser modules that support continuous sweeps. Command: :SOURce0:WAVelength:SWEep:STARt Syntax: :SOURce0:WAVelength:SWEep:STARt<wsp><startvalue>[PM|NM|UM|MM|M|MIN|MAX] Description: Sets the starting point of the sweep. Cannot be set while a sweep is running. Keysight N777xC Series Tunable Laser Family Programming Guide...
  • Page 76 If you specify no units in your command, meters are used as the default. MIN Sets the minimum stop wavelength available. This value is sweep speed and mode dependent. MAX Sets the maximum stop wavelength available. This value is sweep speed and mode dependent. Keysight N777xC Series Tunable Laser Family Programming Guide...
  • Page 77 <=1048576 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 off. Keysight N777xC Series Tunable Laser Family Programming Guide...
  • Page 78 None Example: :sour0:wav:swe:step:next Affects: All N777xC tunable laser sources Command: :SOURce0:WAVelength:SWEep:STEP:PREVious Syntax: :SOURce0:WAVelength:SWEep:STEP:PREVious Description: Performs one sweep step backwards in stepped sweep if it is paused or in manual sweep Parameters: None Keysight N777xC Series Tunable Laser Family Programming Guide...
  • Page 79 Response: The sweep step as a float value in meters. -> Example: :sour0:wav:swe:step? +5.00000000E-009 Affects: All N777xC tunable laser sources Command: :SOURce0:POWer[:LEVel][:IMMediate][:AMPLitude] Syntax: :SOURce0:POWer[:LEVel][:IMMediate][:AMPLitude]<wsp><value>[PW|NW|UW|MW|Watt|DBM]|MIN|MAX Description: Sets the power of the laser output. Keysight N777xC Series Tunable Laser Family Programming Guide...
  • Page 80 :sour0:pow? -> +8.00000000E-004 Affects: All N777xC tunable laser sources Command: :SOURce0:POWer:STATe Syntax: :SOURce0:POWer:STATe<wsp><boolean> Description: Switches the laser of the chosen source on or off. Parameters: A boolean value: 0: Laser Off 1: Laser On Keysight N777xC Series Tunable Laser Family Programming Guide...
  • Page 81 0 or DBM: dBm (default) 1 or W: Watts Response: None Example: :sour0:pow:unit w Affects: All N777xC tunable laser sources Command: :SOURce0:POWer:UNIT? Syntax: :SOURce0:POWer:UNIT<wsp>DBM|0|Watt|1 Description: Return the current power units Parameters: Watts Keysight N777xC Series Tunable Laser Family Programming Guide...
  • Page 82 Measurement Operations & Settings Response: none Example: :sour0:pow:unit? -> 0 Affects: All N777xC tunable laser sources Keysight N777xC Series Tunable Laser Family Programming Guide...

  • Page 83: Configure Subsystem Commands

    Description: Resets the setting values in the working memory. In contrast to the *RST and System:Preset commands, the previous stored settings remain in nonvolatile RAM and can be recalled again. Parameters: None Keysight N777xC Series Tunable Laser Family Programming Guide...
  • Page 84 Recall a setting from FLASH memory Parameters: Integer Response: None Example: :conf:meas:sett:rec 1 Affects: All instruments Command: :CONFigure:MEASurement:SETTing:SAVE Syntax: :CONFigure:MEASurement:SETTing:SAVE Description: Recall a setting from FLASH memory Parameters: Integer Response: None Example: :conf:meas:sett:save 1 Affects: All instruments Keysight N777xC Series Tunable Laser Family Programming Guide...
  • Page 85 Measurement Operations & Settings Command: :CONFigure:MEASurement:SETTing:ERASe Syntax: :CONFigure:MEASurement:SETTing:ERASe Description: Erase a setting from memory Parameters: Integer Response: None Example: :conf:meas:sett:eras 1 Affects: All instruments Keysight N777xC Series Tunable Laser Family Programming Guide...

  • Page 86: Triggering - The Trigger Subsystem

    Sets the incoming trigger response and arms the module. Parameters: IGNore: Ignore incoming trigger. NEXTstep: Perform next step of a stepped sweep. SWStart: Start a sweep cycle. Response: None Example: :trig0:inp ign Affects: All tunable laser modules Keysight N777xC Series Tunable Laser Family Programming Guide...

  • Page 87: Trigger[N]:Input

    When sweep cycle finishes. SWSTarted: When a sweep cycle starts. Response: None Example: :trig0:outp dis Affects: All tunable laser modules Command: :TRIGger[n]:OUTPut? Syntax: :TRIGger[n]:OUTPut? Description: Returns the condition that causes an output trigger. Parameters: none Keysight N777xC Series Tunable Laser Family Programming Guide...

  • Page 88: Trigger:configuration

    A trigger at the Input Trigger Connector generates a trigger at the Output Trigger Connector automatically. No triggers from the instrument at the output. 3 or LOOPback: The same as PASSthrough. This is included for compatibility reasons. -> Example: :trig:conf? affects All modules Keysight N777xC Series Tunable Laser Family Programming Guide...
  • Page 89 Keysight N777xC Series Tunable Laser Family Programming Guide Error Codes Error Strings / 90 This chapter gives information about error codes used with the N777xC series tunable laser source instruments.

  • Page 90: Error Strings

    "Parameter not allowed" [More parameters were received than expected for the header] -109 "Missing parameter" [Fewer parameters were received than required for the header] -110 "Command header error" -111 "Header separator error" Keysight N777xC Series Tunable Laser Family Programming Guide...
  • Page 91 "Character data error" -141 “Invalid character data” [Either the character data element contains an invalid character or the particular element received is not valid for the header.] -144 "Character data too long" Keysight N777xC Series Tunable Laser Family Programming Guide...
  • Page 92 [Indicates that a macro parameter placeholder ($<number) was encountered outside of a macro definition.] -183 “Invalid inside macro definition” [Indicates that the program message unit sequence, sent with a *DDT or *DMC command, is syntactically invalid (see IEEE 488.2, 10.7.6.3).] -184 "Macro parameter error" Keysight N777xC Series Tunable Laser Family Programming Guide...
  • Page 93 The INIT:IMM command initiates a trigger and completes a full measurement cycle. The continuous measurement must be DISABLED. This error code is generated if the module is still in cont. measurement mode. Keysight N777xC Series Tunable Laser Family Programming Guide...
  • Page 94 Wavelength 1800nm when maximum wavelength is 1700nm. -222 "Data out of range (StatParmTooSmall)" Description: The user has passed a continuous parameter that is too small. Example: Wavelength 700nm when minimum wavelength is 800nm. Keysight N777xC Series Tunable Laser Family Programming Guide...
  • Page 95 (manual) range does not correspond with the input power. -240 "Hardware error" -241 "Hardware missing" -250 "Mass storage error" -251 "Missing mass storage" -252 "Missing media" -253 "Corrupt media" -254 "Media full" -255 "Directory full" -256 "File name not found" Keysight N777xC Series Tunable Laser Family Programming Guide...
  • Page 96 [Indicates that a syntactically legal macro label in the *GMC? query could not be executed because the header was not previously defined.] -280 "Program error" -281 "Cannot create program" -282 "Illegal program name" Keysight N777xC Series Tunable Laser Family Programming Guide...
  • Page 97 -312 "PUD memory lost" -313 "Calibration memory lost" -314 "Save/recall memory lost" -315 "Configuration memory lost" -320 "Storage fault" -321 “Out of memory” [An internal operation needed more memory than was available.] Keysight N777xC Series Tunable Laser Family Programming Guide...
  • Page 98 -410 “Query INTERRUPTED” [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 before a response was completely sent.] Keysight N777xC Series Tunable Laser Family Programming Guide...
  • Page 99 6.3.1.7); for example, both input buffer and output buffer are full and the device cannot continue.] -440 “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).] Keysight N777xC Series Tunable Laser Family Programming Guide...
  • Page 100 This information is subject to change without notice. © Keysight Technologies 2019 Edition 1.0, December 2019 www.keysight.com...

This manual is also suitable for:

N7776cN7778cN7779c

Table of Contents