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

Keysight N774 C Series Programming Manual

Multiport power meter
Hide thumbs
Table of Contents

Advertisement

Quick Links

Keysight N774xC Series
Multiport Power Meter
N7744C 4-port Optical Power Meter
N7745C 8-port Optical Power Meter
Programming
Guide

Advertisement

Table of Contents
loading

Related Manuals for Keysight N774 C Series

Summary of Contents for Keysight N774 C Series

  • Page 1 Keysight N774xC Series Multiport Power Meter N7744C 4-port Optical Power Meter N7745C 8-port Optical Power Meter Programming Guide...
  • Page 2 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 N774xC Series Multiport Power Meter 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 N774xC Series Multiport Power Meter 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 N774xC Series Multiport Power Meter Programming Guide...
  • Page 8 4 Measurement Operations & Settings CONFigure Subsystem Commands FETCh Subsystem Commands INITiate Subsystem Commands READ Subsystem Commands Measurement Functions – The SENSe Subsystem Triggering - The TRIGger Subsystem 5 Error Codes Error Strings Keysight N774xC Series Multiport Power Meter Programming Guide...
  • Page 9 Keysight N774xC Series Multiport Power Meter Programming Guide Introduction to Programming Message Queues / 10 Programming and Syntax Diagram Conventions / 12 Common Commands / 15 This chapter provides 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 N774xC Series Multiport Power Meter 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 N774xC Series Multiport Power Meter Programming Guide...

  • Page 12: Programming And Syntax Diagram Conventions

    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 Command and Query Syntax All characters not between angled brackets must be sent exactly as shown. Keysight N774xC Series Multiport Power Meter Programming Guide...
  • Page 13 PM, NM, UM, MM, M decibel MDB, DB second NS, US, MS, S decibel/1mW MDBM, DBM Hertz HZ, KHZ, MHZ, GHZ, THZ Watt Watt PW, NW, UW, MW, Watt meters per second NM/S, UM/S, MM/S, M/S Keysight N774xC Series Multiport Power Meter 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 N774xC Series Multiport Power Meter Programming Guide...

  • Page 15: 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 N774xC Series Multiport Power Meter Programming Guide...

  • Page 16: 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 N774xC Series Multiport Power Meter Programming Guide...
  • Page 17 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 N774xC Series Multiport Power Meter Programming Guide...
  • Page 19 Keysight N774xC Series Multiport Power Meter Programming Guide Command Summary Command Summary / 20 This chapter lists commands relating to the N774xC mulltiport power meter instruments. Each of these summaries contains a page reference for more detailed information about the particular command later in this document.

  • Page 20: Command Summary

    :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 FETCh Subsystem :FETCh[n]:POWer? Page :FETCh[n]:POWer:ALL? Page :FETCh[n]:POWer:ALL:CSV? Page :FETCh[n]:POWer:ALL:CONFig? Page :FETCh[n]:POWer:MAX? Page :FETCh[n]:POWer:MIN? Page :FETCh[n]:POWer:EXTRema:RESet Page Keysight N774xC Series Multiport Power Meter Programming Guide...
  • Page 21 :READ[n]:POWer:ALL:CSV? Page :READ[n]:POWer:ALL:CONFig? Page :READ[n]:POWer? Page Command Page SENSe Subsystem :SENSe[n]:CORRection Page :SENSe[n]:CORRection? Page :SENSe[n]:CORRection:COLLect:ZERO Page :SENSe[n]:CORRection:COLLect:ZERO? Page :SENSe:CORRection:COLLect:ZERO:ALL Page :SENSe:CORRection:COLLect:ZERO:ALL? Page :SENSe[n]:CORRection:COLLect:ZERO:QUAD Page :SENSe[n]:CORRection:COLLect:ZERO:QUAD? Page :SENSe[n]:FUNCtion:LOOP Page :SENSe[n]:FUNCtion:LOOP? Page :SENSe[n]:FUNCtion:PARameter:CHECk? Page Keysight N774xC Series Multiport Power Meter Programming Guide...
  • Page 22 :SENSe[n]:FUNCtion:RESult:INDex? Page :SENSe[n]:FUNCtion:RESult:MAXBlocksize? Page :SENSe[n]:FUNCtion:STATe Page :SENSe[n]:FUNCtion:STATe? Page :SENSe[n]:POWer:GAIN:AUTO Page :SENSe[n]:POWer:GAIN:AUTO? Page :SENSe[n]:POWer:ATIMe Page :SENSe[n]:POWer:ATIMe? Page :SENSe[n]:POWer:RANGe:AUTO Page :SENSe[n]:POWer:RANGe:AUTO? Page :SENSe[n]:POWer:RANGe Page :SENSe[n]:POWer:RANGe? Page :SENSe[n]:POWer:REFerence Page :SENSe[n]:POWer:REFerence? Page :SENSe[n]:POWer:REFerence:DISPlay Page :SENSe[n]:POWer:REFerence:STATe Page Keysight N774xC Series Multiport Power Meter Programming Guide...
  • Page 23 Command Page STATus Subsystem :STATus:OPERation[:EVENt]? Page :STATus:OPERation:CONDition? Page :STATus[n]:OPERation[:EVENt]? Page :STATus:OPERation:ENABle Page :STATus:OPERation:ENABle? Page :STATus[n]:OPERation:CONDition? Page :STATus[n]:OPERation:ENABle Page :STATus[n]:OPERation:ENABle? Page :STATus:PRESet Page :STATus:QUEStionable[:EVENt]? Page :STATus:QUEStionable:CONDition? Page :STATus[n]:QUEStionable[:EVENt]? Page :STATus:QUEStionable:ENABle Page :STATus:QUEStionable:ENABle? Page Keysight N774xC Series Multiport Power Meter Programming Guide...
  • Page 24 :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 :SYSTem:COMMunicate:ETHernet:DGATeway:CURRent? Page :SYSTem:COMMunicate:ETHernet:DHCP:ENABle? Page :SYSTem:COMMunicate:ETHernet:DHCP:ENABle Page :SYSTem:COMMunicate:ETHernet:DOMainname? Page :SYSTem:COMMunicate:ETHernet:DOMainname Page Keysight N774xC Series Multiport Power Meter Programming Guide...
  • Page 25 :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 :SYSTem:COMMunicate:ETHernet:WHITEList#:SMASk? Page :SYSTem:COMMunicate:ETHernet:WHITEList#:SMASk Page :SYSTem:COMMunicate:ETHernet:RESet Page :SYSTem:COMMunicate:ETHernet:RESTart Page :SYSTem:COMMunicate:ETHernet:SAVE Page Keysight N774xC Series Multiport Power Meter Programming Guide...

  • Page 26: Command Summary

    :SYSTem:COMMunicate:ETHernet:SMASk:CURRent? Page Command Page TRIGger Subsystem :TRIGger Page :TRIGger[n]:DELay? Page :TRIGger[n]:DELay Page :TRIGger[n]:INPut Page :TRIGger[n]:INPut? Page :TRIGger[n]:INPut:EDGe? Page :TRIGger[n][:INPut:EDGe Page :TRIGger[n]:OFFSet? Page :TRIGger[n]:OUTPut? Page :TRIGger[n]:OFFSet Page :TRIGger[n]:OUTPut Page :TRIGger:CONFiguration? Page :TRIGger:CONFiguration Page Keysight N774xC Series Multiport Power Meter Programming Guide...
  • Page 27 Keysight N774xC Series Multiport Power Meter Programming Guide Instrument Setup and Status IEEE-Common Commands / 28 Status Reporting – The STATus Subsystem / 34 Interface/Instrument Behaviour Settings – The SYSTem Subsystem / 42 System Communicate - The :SYST:COMMunicate sub tree...

  • Page 28: Ieee-Common Commands

    The register is not changed by the *CLS commands. Parameters: The bit value for the register (a 8-bit integer value): Mnemonic Decimal Value 7 (MSB) Power On Not Used Command Error Execution Error Device Dependent Error Query Error Keysight N774xC Series Multiport Power Meter Programming Guide...
  • Page 29 The bit value for the register (a 8-bit integer value): Mnemonic Decimal Value 7 (MSB) Power On Not used Command Error Execution Error Device Dependent Error Query Error Keysight N774xC Series Multiport Power Meter Programming Guide...
  • Page 30 *IDN? -> Keysight Technologies,N7745C,DE42100168 Command: *OPC Syntax: *OPC Description: Generates the OPC message in the standard event status register when all pending overlapped operations have been completed. Parameters: none Response: none Example: *OPC Keysight N774xC Series Multiport Power Meter Programming Guide...
  • Page 31 The following are not changed: Instrument interface address 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. Keysight N774xC Series Multiport Power Meter Programming Guide...
  • Page 32 After the self-test the instrument is returned to the setting that was active at the time the self-test query was processed. The self-test does not require operator interaction beyond sending the *TST? query. Keysight N774xC Series Multiport Power Meter Programming Guide...
  • Page 33 *WAI blocks 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 N774xC Series Multiport Power Meter Programming Guide...

  • Page 34: Status Reporting - The Status Subsystem

    Channel 2 Summary Channel 2 Summary Channel 1 Summary Channel 1 Summary Not used Not used -> Example: :stat:oper? Command: :STATus:OPERation:CONDition? Syntax: :STATus:OPERation:CONDition? Description: Reads the Operational Status Condition Summary Register. Parameters: none Keysight N774xC Series Multiport Power Meter Programming Guide...

  • Page 35: Status:operation:enable

    The bit value for the OSESM as a 16-bit unsigned integer value (0 .. +65535) The default value is 65535. Response: none Example: :stat:oper:enab 128 Command: :STATus:OPERation:ENABle? Syntax: :STATus:OPERation:ENABle? Description: Returns the OSESM for the OSESR Keysight N774xC Series Multiport Power Meter Programming Guide...

  • Page 36: Status[N]:Operation[:Event]? Page

    Response: The results for the individual slot events (a 16-bit unsigned integer value, where 0 value 65535): Mnemonic Decimal Value 4-15 Not used Channel n: Zeroing ongoing Not used -> Example: :stat0:oper:cond? Keysight N774xC Series Multiport Power Meter Programming Guide...

  • Page 37: Status[N]:Operation:enable

    Description: Presets all bits in all OPERation and QUEStionable status systems to 0. Parameters: none Response: none Example: :stat:pres Command: :STATus:QUEStionable[:EVENt]? Syntax: :STATus:QUEStionable[:EVENt]? Description: Returns the Questionable Status Event Summary Register (QSESR). Keysight N774xC Series Multiport Power Meter Programming Guide...

  • Page 38: Status:questionable:condition

    The sum of the results for the Questionable Status Condition Summary Register as a 16-bit unsigned integer value (0 .. +65535) Bits Mnemonics Decimal Value N7744C N7745C 15-9 Not used Not used Not used Channel 8 Summary Not used Channel 7 Summary Not used Channel 6 Summary Keysight N774xC Series Multiport Power Meter Programming Guide...

  • Page 39: Status:questionable:enable

    Syntax: :STATus:QUEStionable:ENABle? Description: Returns the QSESM for the event register Parameters: none Response: The bit value for the QSEM as a 16-bit unsigned integer value (0 .. +65535) -> Example: :stat:ques:enab? +128 Keysight N774xC Series Multiport Power Meter Programming Guide...

  • Page 40: Status[N]:Questionable[:Event]

    The results for the individual slot events (a 16-bit unsigned integer value, where 0 value 65535): Mnemonic Decimal Value 2-15 Not used Channel n: A Zeroing operation has failed Not used Every nth bit is the summary of slot n. -> Example: :stat0:ques:cond? Keysight N774xC Series Multiport Power Meter Programming Guide...

  • Page 41: Status[N]:Questionable:enable

    Command: :STATus[n]:QUEStionable:ENABle? Syntax: :STATus[n]:QUEStionable:ENABle? Description: Returns the QSSEM for slot n Parameters: none Response: The bit value for the QSSEM as a 16-bit integer value (0 .. +65535) -> Example: :stat0:ques:enab? +128 Keysight N774xC Series Multiport Power Meter Programming Guide...

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

    The date in the format year, month, day -> 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 N774xC Series Multiport Power Meter Programming Guide...

  • Page 43: System:help:errors

    NOTE: This will also erase all saved configurations. To prevent this, use the :CONFigure:MEASurement:SETTing:PRESet 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 N774xC Series Multiport Power Meter Programming Guide...

  • Page 44: System:preset

    Note: Every connection uses its own error queue 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 N774xC Series Multiport Power Meter Programming Guide...

  • Page 45: System:version

    Returns the SCPI revision to which the instrument complies. Parameters: none Response: The revision year and number. −> Example: :syst:vers? 1999.0 Command: :SYSTem:REBoot Syntax: :SYSTem:REBoot Description: Reboots the instrument. Parameters: none Response: None Example: :syst:reb Keysight N774xC Series Multiport Power Meter Programming Guide...

  • Page 46: 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? -> 1 Keysight N774xC Series Multiport Power Meter Programming Guide...

  • Page 47: 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 N774xC Series Multiport Power Meter Programming Guide...

  • Page 48: 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 N774xC Series Multiport Power Meter Programming Guide...

  • Page 49: 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 N774xC Series Multiport Power Meter Programming Guide...

  • Page 50: System:communicate:ethernet:hostname

    Parameters: None Response: String Example: :syst:comm:eth:host:curr? -> "K-N7745C-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 N774xC Series Multiport Power Meter Programming Guide...

  • Page 51: 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 N774xC Series Multiport Power Meter Programming Guide...

  • Page 52: System:communicate:ethernet:ipaddress

    Get the current IP address of the instrument. 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 N774xC Series Multiport Power Meter Programming Guide...

  • Page 53: 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 N774xC Series Multiport Power Meter Programming Guide...

  • Page 54: System:communicate:ethernet:description

    Quoted string of up to 260 characters Response: None Example: :syst:comm:eth:desc "Keysight N7745C - 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 N774xC Series Multiport Power Meter Programming Guide...

  • Page 55: 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 N774xC Series Multiport Power Meter Programming Guide...

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

    This command only works if the instrument has a working network connection at the time the command is issued. If not you either have to wait until the instrument decides on an IP address using AutoIP or reboot the instrument. Keysight N774xC Series Multiport Power Meter Programming Guide...

  • Page 57: 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 N774xC Series Multiport Power Meter Programming Guide...
  • Page 58 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 N774xC Series Multiport Power Meter Programming Guide...
  • Page 59 Keysight N774xC Series Multiport Power Meter Programming Guide Measurement Operations & Settings CONFigure Subsystem Commands / 60 FETCh Subsystem Commands / 63 INITiate Subsystem Commands / 66 READ Subsystem Commands / 68 Measurement Functions – The SENSe Subsystem / 70...

  • Page 60: 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 N774xC Series Multiport Power Meter Programming Guide...
  • Page 61 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 N774xC Series Multiport Power Meter Programming Guide...
  • Page 62 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 N774xC Series Multiport Power Meter Programming Guide...

  • Page 63: Fetch Subsystem Commands

    4-byte Intel float values in a binary block in Intel byte order. The values are ordered by slot. Data values are always in Watt. Example: fetc:pow:all? -> interpreted as +1.33555600E-006|+1.34789100E-006|+1.37456900E-006 Affects: N7744C and N7745C Keysight N774xC Series Multiport Power Meter Programming Guide...
  • Page 64 Slot 1, Channel 1 Slot 2, Channel 1 Slot 3, Channel 1 Slot 4, Channel 1 Affects: N7744C and N7745C Command: :FETCh[n]:POWer:MAX? Syntax: :FETCh[n]:POWer:MAX? Description: Returns the maximum power value since the reset. Parameters: None Keysight N774xC Series Multiport Power Meter Programming Guide...
  • Page 65 Minimum power value Example: fetc1:pow:max? -> +3.47375195E-03 Affects: N7744C and N7745C Command: :FETCh[n]:POWer:EXTRema:RESet Syntax: :FETCh[n]:POWer:EXTRema:RESet Description: Resets the maximum and minimum power values. Parameters: None Response: None Example: fetc1:pow:extr:res Affects: N7744C and N7745C Keysight N774xC Series Multiport Power Meter Programming Guide...

  • Page 66: Initiate Subsystem Commands

    Sets the software trigger system to continuous measurement mode. Parameters: A boolean value: 0 or OFF: do not measure continuously 1 or ON: measure continuously Response: None Example: init2:cont 1 Affects: N7744C and N7745C Keysight N774xC Series Multiport Power Meter Programming Guide...
  • Page 67 Queries whether the software trigger system operates continuously or not. Parameters: None Response: A boolean value: 0 or OFF: do not measure continuously 1 or ON: measure continuously Example: init2:cont? -> 1 Affects: N7744C and N7745C Keysight N774xC Series Multiport Power Meter Programming Guide...

  • Page 68: Read Subsystem Commands

    4-byte Intel float values in a binary block in Intel byte order. The values are ordered by slot. Data values are always in Watt. Example: read:pow:all? -> interpreted as +1.33555600E-006|+1.34789100E-006|+1.37456900E-006 Affects: N7744C and N7745C Keysight N774xC Series Multiport Power Meter Programming Guide...
  • Page 69 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. Example: read1:pow? -> +1.33555600E-006 Affects: N7744C and N7745C Keysight N774xC Series Multiport Power Meter Programming Guide...

  • Page 70: Measurement Functions - The Sense Subsystem

    Affects All power meters Command: :SENSe[n]:CORRection:COLLect:ZERO Syntax: :SENSe[n]:CORRection:COLLect:ZERO Description: Zeros the electrical offsets for a power meter channel. NOTE: Cover the optical inputs or switch the input source off before starting. Parameters: Keysight N774xC Series Multiport Power Meter Programming Guide...
  • Page 71 Returns the status of the most recent zero command for a power meter channel. The result is backed up in the nonvolatile RAM. NOTE: If a channel fails to zero, it continues to use the result of the last successful zeroing. Keysight N774xC Series Multiport Power Meter Programming Guide...
  • Page 72 [n] is between 5 and 8 then the second quad zero result is returned The result is backed up in the nonvolatile RAM. NOTE: If a channel fails to zero, it continues to use the result of the last successful zeroing. Parameters: None Keysight N774xC Series Multiport Power Meter Programming Guide...
  • Page 73 All power meters Command: :SENSe[n]:FUNCtion:LOOP? Syntax: :SENSe[n]:FUNCtion:LOOP? Description: Gets the number of logging loops. For details look at description and example in Using data buffers for simultaneous measurement and upload. Parameters: None Keysight N774xC Series Multiport Power Meter Programming Guide...
  • Page 74 Example: :sens1:func:par:check? → 0,OK Affects All power meters Command: :SENSe[n]:FUNCtion:PARameter:LOGGing Syntax: :SENSe[n]:FUNCtion:PARameter:LOGGing<wsp><data points>, <averaging time>[NS|US|MS|S] Description: Sets the number of data points and the averaging time for the logging data acquisition function. Keysight N774xC Series Multiport Power Meter Programming Guide...
  • Page 75 , as a float value in seconds. Example: :sens1:func:par:logg? → +64,+1.00000000E-001 Affects All power meters Command: :SENSe[n]:FUNCtion:PARameter:MINMax Syntax: :SENSe[n]:FUNCtion:PARameter:MINMax<wsp> CONTinous|WINDow|REFResh,<data points> Description: Sets the MinMax mode and the number of data points for the MinMax data acquisition function. Keysight N774xC Series Multiport Power Meter Programming Guide...
  • Page 76 Example: :sens1:func:par:minm? → WIND,+10 Affects All power meters Command: :SENSe[n]:FUNCtion:PARameter:STABility Syntax: :SENSe[n]:FUNCtion:PARameter:STABility<wsp> <total time>[NS|US|MS|S],<period time>[NS|US|MS|S],<averaging time>[NS|US|MS|S] Description: Sets the total time, period time, and averaging time for the stability data acquisition function. Keysight N774xC Series Multiport Power Meter Programming Guide...
  • Page 77 Total time, delay time, and averaging time are float values in seconds. Example: :sens1:func:par:stab? → +1.00000000E+000, +1.00000000E-001,+1.00000000E-001 Affects All power meters Command: :SENSe[n]:FUNCtion:RESult? Syntax: :SENSe[n]:FUNCtion:RESult? Description: Returns the data array of the last data acquisition function. Parameters: None Keysight N774xC Series Multiport Power Meter Programming Guide...
  • Page 78 This works only for Logging and Stability Data Acquisition in the loop mode, not for the MinMax Data Acquisition. For details look at description and example in :Using data buffers for simultaneous measurement and upload" Parameters: None Keysight N774xC Series Multiport Power Meter Programming Guide...
  • Page 79 For Logging and Stability Data Acquisition functions, one measurement value is a 4 byte little-endian IEEE 754 single precision value. Example: :sens1:func:res:bloc? #5, 2 → interpreted as 7.24079E-04,7.24252E-04 Affects All power meters Keysight N774xC Series Multiport Power Meter Programming Guide...
  • Page 80 See :SENSe[n][:CHANnel[m]]:FUNCtion:PARameter:LOGGing for more information 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. Keysight N774xC Series Multiport Power Meter Programming Guide...
  • Page 81 NOTE: Details are in the Application Note "Transient Optical Power Measurements with the N774x-Series Multiport Power Meter" http://literature.cdn.keysight.com/litweb/pdf/5990-3710EN.pdf NOTE: Disable Auto Gain when modulated Signals are to be measured. In Logging Mode Auto Range is always OFF. Keysight N774xC Series Multiport Power Meter Programming Guide...
  • Page 82 NONE: For N774xC power meters the internal granularity of the averaging time is 1us which allows flexibility. Response: None Example: :sens1:pow:atim 1s Affects All power meters Command: :SENSe[n]:POWer:ATIMe? Syntax: :SENSe[n]:POWer:ATIMe? Description: Returns the averaging time. Parameters: None Keysight N774xC Series Multiport Power Meter Programming Guide...
  • Page 83 Returns whether automatic power ranging is being used by the channel. Parameters: None Response: A boolean value: 0 or OFF: automatic ranging disabled 1 or ON: automatic ranging enabled Example: :sens1:pow:rang:auto? → 1 Affects All power meters Keysight N774xC Series Multiport Power Meter Programming Guide...
  • Page 84 None Response: The range setting as a float value in dBm (-30 to +10). Example: :sens1:pow:rang? → -2.00000000E+001 Affects All power meters Command: :SENSe[n]:POWer:REFerence Syntax: :SENSe[n]:[CHANnel[m]]:POWer:REFerence<wsp>TOMODule|TOREF,<value>PW|NW|UW|MW|Watt|DBM|DB|MDB Description: Sets the channels reference value. Keysight N774xC Series Multiport Power Meter Programming Guide...
  • Page 85 The reference as a float value. Example: :sens1:pow:ref? toref → +1.00000000E-006 Affects All power meters Command: :SENSe[n]:POWer:REFerence:DISPlay Syntax: :SENSe[n]:POWer:REFerence:DISPlay Description: Takes the current measured input power level value as the reference value. "disp to ref" Parameters: None Keysight N774xC Series Multiport Power Meter Programming Guide...

  • Page 86: Sense[N]:Power:reference:state

    255 or TOREF: results are displayed relative to an absolute reference Channel number: an integer value representing the channel number you want to reference Keysight N774xC Series Multiport Power Meter Programming Guide...

  • Page 87: Sense[N]:Power:reference:state:ratio

    Sets the sensor power unit of selected channel or of ALL channels. Parameters: An integer value: 0: dBm 1: Watt or DBM or Watt Response: None Example: :sens1:pow:unit 1 :sens:pow:unit:all 1 Affects All power meters Keysight N774xC Series Multiport Power Meter Programming Guide...

  • Page 88: Sense[N]:Power:unit

    Parameters: The wavelength as a float value in meters. Also allowed are: MIN: minimum programmable value MAX: maximum programmable value DEF: the preset (*RST) default value Keysight N774xC Series Multiport Power Meter Programming Guide...

  • Page 89: Sense[N]:Power:wavelength

    The wavelength as a float value in meters. Also allowed are: MIN: minimum programmable value MAX: maximum programmable value DEF: the preset (*RST) default value Example: :sens1:pow:wav? → +1.55000000E-006 Affects All power meters Keysight N774xC Series Multiport Power Meter Programming Guide...

  • Page 90: Triggering - The Trigger Subsystem

    Example: :trig1:del? → +0 Command: :TRIGger[n]:DELay Syntax: :TRIGger[n]:DELay<wsp><value> Description: Defines factor for delay. Effective trigger delay time = factor/32 Mhz. That means, trigger event is excuted after specified time after input trigger. Keysight N774xC Series Multiport Power Meter Programming Guide...
  • Page 91 Not possible to use multiple cycles. THReshold: Similar to PRE, but the starting event is minimum and maximum threshold values. If you don't want both limit, you can write NAN instead of number. Keysight N774xC Series Multiport Power Meter Programming Guide...
  • Page 92 1 or FALLing: trigger on the low edge of the BNC TTL input Response: None Example: :TRIGg:INP:EDG RIS Affects: All power meters Command: :TRIGger[n]:OFFSet? Syntax: :TRIGger[n]:OFFSet? Description: Returns the number of incoming triggers received before data logging begins. Parameters: None Keysight N774xC Series Multiport Power Meter Programming Guide...
  • Page 93 When averaging time period finishes MEASure: When averaging time period begins -> Example: :trig1:outp? Affects: All power meters Command: :TRIGger[n]:OUTPut Syntax: :TRIGger[n]:OUTPut Description: Specifies when an output trigger is generated and arms the channel. Keysight N774xC Series Multiport Power Meter Programming Guide...
  • Page 94 Connector automatically. No triggers from the instrument at the output. 3 or LOOPback: The same as PASSthrough. This is included for compatibility reasons. Response: none Example: :trig:conf dis Affects All power meters Keysight N774xC Series Multiport Power Meter Programming Guide...
  • Page 95 Keysight N774xC Series Multiport Power Meter Programming Guide Error Codes Error Strings / 96 This chapter gives information about error codes used with the N774xC series multiport power meter instruments.

  • Page 96: Error Strings

    [Fewer parameters were received than required for the header] -110 "Command header error" -111 "Header separator error" -112 "Program mnemonic too long" [The header contains more than twelve characters (see IEEE 488.2, 7.6.1.4.1).] Keysight N774xC Series Multiport Power Meter Programming Guide...
  • Page 97 [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" -148 “Character data not allowed” [A legal character data element was encountered where prohibited by the device.] Keysight N774xC Series Multiport Power Meter Programming Guide...
  • Page 98 [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 N774xC Series Multiport Power Meter Programming Guide...
  • Page 99 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 N774xC Series Multiport Power Meter Programming Guide...
  • Page 100 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 N774xC Series Multiport Power Meter Programming Guide...
  • Page 101 (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 N774xC Series Multiport Power Meter Programming Guide...
  • Page 102 [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 N774xC Series Multiport Power Meter Programming Guide...
  • Page 103 -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 N774xC Series Multiport Power Meter Programming Guide...
  • Page 104 -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 N774xC Series Multiport Power Meter Programming Guide...
  • Page 105 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 N774xC Series Multiport Power Meter Programming Guide...
  • Page 106 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:

N7744cN7745c

Table of Contents