Keysight N774 C Series, Programming Manual

Page 1: ...Programming Guide Keysight N774xC Series Multiport Power Meter N7744C 4 port Optical Power Meter N7745C 8 port Optical Power Meter ...

Page 2: ...uire ments 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 tech...

Page 3: ...erature range Temperature The instrument should be protected from temperature extremes and changes in temperature that may cause condensation within it The operating temperature is from 5 C to 40 C The storage temperature is from 40 C to 70 C Before Applying Power Verify that all safety precautions are taken The power cable inlet of the instrument serves as a device to disconnect from the mains in...

Page 4: ...anadian and United States of America standards respectively The RCM mark is a registered trademark of the Australian Communications and Media Authority The KC mark is the Korean certification mark This equipment is Class A suitable for professional use and is for use in electromagnetic environments outside of the home The recycling symbol indicates the general ease with which the instrument can be...

Page 5: ...ation of Conformity 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...

Page 6: ......

Page 7: ...sage 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 12 Common Commands 15 Common Command Summary 15 Common Status Information 16 2 Command Summary Command Summary 20 3 Instrument Setup and Status IEEE Common Commands 28 Status Reporting The S...

Page 8: ...ubsystem 42 System Communicate The SYST COMMunicate sub tree 46 4 Measurement Operations Settings 5 Error Codes CONFigure Subsystem Commands 60 FETCh Subsystem Commands 63 INITiate Subsystem Commands 66 READ Subsystem Commands 68 Measurement Functions The SENSe Subsystem 70 Triggering The TRIGger Subsystem 90 Error Strings 96 ...

Page 9: ...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 The information in these chapters is specific to the N774xC multiport power meter instruments ...

Page 10: ...ponses 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 hex 0A If no query is received or if 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 The Error Queue The er...

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

Page 12: ...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 com...

Page 13: ...hows an either or choice of data for example a b means either a or b but not both simultaneously Extra spaces are ignored so spaces can be inserted to improve readability Units Where units are given with a command usually only the base units are specified The full sets of units are given in the table below Table 2 Units and allowed Mnemonics string is ascii data A string is contained between doubl...

Page 14: ...real values A string is contained between double quotes or single quotes 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 t...

Page 15: ...ry Table 3 on page 15 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 ...

Page 16: ...e Event Status Bit ESB of the Status Byte 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 0 1 2 3 4 5 6 7 STB return...

Page 17: ...ter Programming Guide 17 Introduction to Programming 1 The questionable and operation status systems set the Operational Status Bit OSB and the Questionable Status Bit QSB NOTE Unused bits in any of the registers change to 0 when you read them ...

Page 18: ......

Page 19: ...uide 2 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: ...odes and the included commands Table 4 Command Summary Command Page CONFigure Subsystem CONFigure MEASurement SETTing ACTual Page 60 CONFigure MEASurement SETTing NUMBer Page 60 CONFigure MEASurement SETTing PRESet Page 60 CONFigure MEASurement SETTing CANCel Page 61 CONFigure MEASurement SETTing RECall Page 61 CONFigure MEASurement SETTing SAVE Page 61 CONFigure MEASurement SETTing ERASe Page 62 ...

Page 21: ... n POWer ALL CSV Page 68 READ n POWer ALL CONFig Page 69 READ n POWer Page 69 Command Page SENSe Subsystem SENSe n CORRection Page 70 SENSe n CORRection Page 70 SENSe n CORRection COLLect ZERO Page 70 SENSe n CORRection COLLect ZERO Page 71 SENSe CORRection COLLect ZERO ALL Page 71 SENSe CORRection COLLect ZERO ALL Page 71 SENSe n CORRection COLLect ZERO QUAD Page 72 SENSe n CORRection COLLect ZER...

Page 22: ...Sult BUFA Page 78 SENSe n FUNCtion RESult BUFB Page 79 SENSe n FUNCtion RESult BLOCk Page 79 SENSe n FUNCtion RESult INDex Page 80 SENSe n FUNCtion RESult MAXBlocksize Page 80 SENSe n FUNCtion STATe Page 80 SENSe n FUNCtion STATe Page 81 SENSe n POWer GAIN AUTO Page 81 SENSe n POWer GAIN AUTO Page 82 SENSe n POWer ATIMe Page 82 SENSe n POWer ATIMe Page 82 SENSe n POWer RANGe AUTO Page 83 SENSe n P...

Page 23: ...NSe n POWer WAVelength Page 89 Command Page STATus Subsystem STATus OPERation EVENt Page 34 STATus OPERation CONDition Page 34 STATus n OPERation EVENt Page 36 STATus OPERation ENABle Page 35 STATus OPERation ENABle Page 35 STATus n OPERation CONDition Page 36 STATus n OPERation ENABle Page 37 STATus n OPERation ENABle Page 37 STATus PRESet Page 37 STATus QUEStionable EVENt Page 37 STATus QUEStion...

Page 24: ...SYSTem ERRor NEXT Page 44 SYSTem ERRor COUNt Page 44 SYSTem VERSion Page 45 SYSTem REBoot Page 45 SYSTem COMMunicate ETHernet AUTOip ENABle Page 46 SYSTem COMMunicate ETHernet AUTOip ENABle Page 47 SYSTem COMMunicate ETHernet CANCel Page 47 SYSTem COMMunicate ETHernet DGATeway Page 47 SYSTem COMMunicate ETHernet DGATeway Page 47 SYSTem COMMunicate ETHernet DGATeway CURRent Page 48 SYSTem COMMunica...

Page 25: ... Page 52 SYSTem COMMunicate ETHernet MACaddress Page 52 SYSTem COMMunicate ETHernet NTP ENABle Page 53 SYSTem COMMunicate ETHernet NTP ENABle Page 53 SYSTem COMMunicate ETHernet NTP SERVer Page 53 SYSTem COMMunicate ETHernet NTP SERVer Page 53 SYSTem COMMunicate ETHernet DESCription Page 54 SYSTem COMMunicate ETHernet DESCription Page 54 SYSTem COMMunicate ETHernet WHITEList ENABle Page 54 SYSTem ...

Page 26: ... SMASk CURRent Page 58 Command Page TRIGger Subsystem TRIGger Page 90 TRIGger n DELay Page 90 TRIGger n DELay Page 90 TRIGger n INPut Page 91 TRIGger n INPut Page 91 TRIGger n INPut EDGe Page 92 TRIGger n INPut EDGe Page 92 TRIGger n OFFSet Page 92 TRIGger n OUTPut Page 93 TRIGger n OFFSet Page 93 TRIGger n OUTPut Page 93 TRIGger CONFiguration Page 94 TRIGger CONFiguration Page 94 Command Page ...

Page 27: ... 42 System Communicate The SYST COMMunicate sub tree 46 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 15 STATus subsystem commands that relate to the status model SYSTem subsystem commands that control the serial interfac...

Page 28: ...Event Status Register the Standard Operation Status Register and any other registers that are summarized in the status byte Parameters none Response none Example CLS Command ESE Syntax ESE wsp value 0 value 255 Description The standard Event Status Enable command ESE sets bits in the Standard Event Status Enable Mask SESEM that enable the corresponding bits in the standard event status register SE...

Page 29: ...formation on this register Parameters none Response The bit value for the register a 8 bit 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 8 bit integer value Bit Mnemonic Decimal ...

Page 30: ...eters none Response The instrument identification For example MMMMMMMM mmmm ssssssss rrrrrrrrrr manufacturer for example Keysight Technologies instrument model number for example N7745C serial number firmware revision level Example IDN Keysight Technologies N7745C DE42100168 Command OPC Syntax OPC Description Generates the OPC message in the standard event status register when all pending overlapp...

Page 31: ...yntax OPT Description The OPTions query OPT returns the options installed in your instrument Parameters none Response Returns the part number of all installed options separated by commas Slots are listed starting with the lowest slot number that is slot 1 Example OPT N7752A 002 N7752A 002 N7752A 001 N7752A 001 Command RST Syntax RST Description The ReSeT command RST sets the mainframe and all modu...

Page 32: ...ilable MAV 16 3 Questionable Status QSB 8 2 Not used 4 1 Not used 2 0 Not used 1 Example STB 32 Command TST Syntax TST Description The self TeST query TST makes the instrument perform a self test and place the results of the test in the output queue If the self test fails the results are also put in the error queue We recommend that you read self test results from the error queue No further comman...

Page 33: ...The WAIt command prevents the instrument from executing any further commands until the current command has finished executing Some module firmware includes commands that set a StatNOPC flag during execution to indicate that the module is busy WAI blocks commands until every module hosted by the instrument is no longer busy All pending operations are completed during the wait period Parameters none...

Page 34: ...nels a 16 bit unsigned integer value where 0 value 65535 Bits Mnemonics Decimal Value N7744C N7745C 9 15 Not used Not used 8 Not used Channel 8 Summary 256 7 Not used Channel 7 Summary 128 6 Not used Channel 6 Summary 64 5 Not used Channel 5 Summary 32 4 Channel 4 Summary Channel 4 Summary 16 3 Channel 3 Summary Channel 3 Summary 8 2 Channel 2 Summary Channel 2 Summary 4 1 Channel 1 Summary Channe...

Page 35: ...mary Channel 2 Summary 4 1 Channel 1 Summary Channel 1 Summary 2 0 Not used Not used 1 Example stat oper cond 0 Command STATus OPERation ENABle Syntax STATus OPERation ENABle wsp value Description Sets the bits in the Operational Status Enable Summary Mask OSESM that enable the contents of the OSESR to affect the Status Byte STB Setting a bit in this register to 1 enables the corresponding bit in ...

Page 36: ...one Response The results for the individual slot events a 16 bit unsigned integer value where 0 value 65535 Bit 4 15 3 1 2 Mnemonic Not used Channel n Zeroing ongoing Not used Decimal Value 8 Example stat0 oper 0 Command STATus n OPERation CONDition Syntax STATus n OPERation CONDition Description Returns the Operational Slot Status Condition Register of slot n Parameters none Response The results ...

Page 37: ...e OSESR Parameters The bit value for the OSSEM as a 16 bit unsigned integer value 0 65535 Response none Example stat0 oper enab 128 Command STATus n OPERation ENABle Syntax STATus n OPERation ENABle Description Returns the OSSEM of slot n Parameters none Response 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 P...

Page 38: ...Summary 16 3 Channel 3 Summary Channel 3 Summary 8 2 Channel 2 Summary Channel 2 Summary 4 1 Channel 1 Summary Channel 1 Summary 2 0 Not used Not used 1 Example stat ques 0 Command STATus QUEStionable CONDition Syntax STATus QUEStionable CONDition Description Returns the Questionable Status Condition Summary Register Parameters none Response The sum of the results for the Questionable Status Condi...

Page 39: ... the Questionable Status Enable Summary Mask QSESM that enable the contents of the QSESR to affect the Status Byte STB Setting a bit in this register to 1 enables the corresponding bit in the QSESR to affect bit 3 of the Status Byte Parameters The bit value for the questionable enable mask as a 16 bit unsigned integer value 0 65535 The default value is 65535 Response none Example stat ques enab 12...

Page 40: ...t 2 15 1 0 Mnemonic Not used Channel n A Zeroing operation has failed Not used Decimal Value 2 Every nth bit is the summary of slot n Example stat0 oper 0 Command STATus n QUEStionable CONDition Syntax STATus n QUEStionable CONDition Description Returns the Questionable Slot Status Condition Register for slot n Parameters none Response The results for the individual slot events a 16 bit unsigned i...

Page 41: ...tus Register QSSR for slot n to affect the QSESR Setting a bit in this register to 1 enables the corresponding bit in the QSSER for slot n to affect bit n of the QSESR Parameters The bit value for the QSSEM as a 16 bit unsigned integer value 0 65535 Response none Example stat0 ques enab 128 Command STATus n QUEStionable ENABle Syntax STATus n QUEStionable ENABle Description Returns the QSSEM for s...

Page 42: ... year month day Description Sets the instrument s internal date Parameters The date in the format year month day Response none Example syst date 2019 10 12 Command SYSTem DATE Syntax SYSTem DATE Description Returns the instrument s internal date Parameters none Response The date in the format year month day Example syst date 2019 10 12 Command SYSTem HELP HEADers Syntax SYSTem HELP HEADers Descrip...

Page 43: ... This command has the same function as the Preset hardkey Pressing the LAN Reset Button for a short time has the same effect Long pressing of the LAN Reset Button resets the LAN parameter The following are not affected by this command the interface address the output and error queues the Service Request Enable register SRE the Status Byte STB the Standard Event Status Enable Mask SESEM and the Sta...

Page 44: ...he format hour minute second Hours are counted 0 23 24 hour time format Example syst time 20 15 30 Command SYSTem ERRor NEXT Syntax SYSTem ERRor NEXT Description Returns the next error from the error queue Parameters none Response The number of the latest error and its meaning Note Every connection uses its own error queue Example syst err 113 Undefined header Command SYSTem ERRor COUNt Syntax SYS...

Page 45: ...Tem VERSion Syntax SYSTem VERSion Description 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 ...

Page 46: ... been assigned MAC address The Media Access Control MAC number is a unique number associated with each network adapter NOTE The instrument does not close open connections when restarting the network interface SYSTem COMMunicate ETHernet RESTart This means the number of possible connections is reduced by the number of previously open connections However the instrument does make sure connections are...

Page 47: ...icate ETHernet CANCel Syntax SYSTem COMMunicate ETHernet CANCel Description Undo all changes to the network parameters that have been made since the last save reboot or syst comm eth restart command Parameters None Response None Example SYST COMM ETH CANC Command SYSTem COMMunicate ETHernet DGATeway Syntax SYSTem COMMunicate ETHernet DGATeway Description Set the default gateway Parameters string U...

Page 48: ...t gateway Parameters None Response String Example syst comm eth dgat curr 192 168 101 11 Command SYSTem COMMunicate ETHernet DHCP ENABle Syntax SYSTem COMMunicate ETHernet DHCP ENABle Description Check whether DHCP is enabled or disabled Parameters None Response Boolean 0 1 Example syst comm eth dhcp enab 1 Command SYSTem COMMunicate ETHernet DHCP ENABle Syntax SYSTem COMMunicate ETHernet DHCP ENA...

Page 49: ...inname Syntax SYSTem COMMunicate ETHernet DOMainname Description Set the domain name used if DHCP is disabled Parameters String Response 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 cu...

Page 50: ...st N7745C Command SYSTem COMMunicate ETHernet HOSTname Syntax SYSTem COMMunicate ETHernet HOSTname Description Get the host name Parameters None Response String Example syst comm eth host K N7745C 0PP03 Command SYSTem COMMunicate ETHernet HOSTname CURRent Syntax SYSTem COMMunicate ETHernet HOSTname CURRent Description Get the current host name Parameters None Response String Example syst comm eth ...

Page 51: ...CURRent Description Get the DNS server addresses assigned from your DHCP sever this is only valide if DHCP is available and enabled Parameters None Response IP Address String Example syst comm eth nser curr 10 127 72 11 10 127 90 11 Command SYSTem COMMunicate ETHernet IDN Syntax SYSTem COMMunicate ETHernet IDN Description The LAN LED on the front panel of the instrument flashes for identification ...

Page 52: ...e manually set IP address of the system Parameters None Response String Example syst comm eth ipad 192 132 13 2 Command SYSTem COMMunicate ETHernet IPADdress CURRent Syntax SYSTem COMMunicate ETHernet IPADdress CURRent Description 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 ...

Page 53: ...nt s use of NTP The acronym NTP stands for Network Time Protocol a protocol for clock synchronization between computer systems Parameters Boolean 0 1 Response None Example syst comm eth ntp enab 1 Command SYSTem COMMunicate ETHernet NTP SERVer Syntax SYSTem COMMunicate ETHernet NTP SERVer Description Get the defined Network Time Protocol NTP server for clock synchronization Parameters None Respons...

Page 54: ...ng of up to 260 characters Example syst comm eth desc Keysight N7745C 42321 Command SYSTem COMMunicate ETHernet DESCription Syntax SYSTem COMMunicate ETHernet DESCription Description Set the desired mDNS service name Parameters 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 COMM...

Page 55: ... of permitted client which could control this instrument Parameters None Response IP Address String Example syst comm eth whitel1 ipad 192 168 0 2 Command SYSTem COMMunicate ETHernet WHITEList IPADdress Syntax SYSTem COMMunicate ETHernet WHITEList IPADdress Description Define an entry in the device access IP whitelist up to 10 IP Addresses of permitted client which could control this instrument Pa...

Page 56: ...ernet RESet Description Press the LAN Reset Button for a long time has the same effect Pressing the LAN Reset Button for a short time is the same as system preset 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 a blank password Parameters None Response None Example syst co...

Page 57: ...one Example syst comm eth save Command SYSTem COMMunicate ETHernet SMASk Syntax SYSTem COMMunicate ETHernet SMASk Description Get the subnet mask Parameters None Response String Example syst comm eth smas 255 255 255 0 Command SYSTem COMMunicate ETHernet SMASk Syntax SYSTem COMMunicate ETHernet SMASk Description Set the subnet mask Parameters String Up to four groups of up to 3 digits groups separ...

Page 58: ... Guide 3 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 ...

Page 59: ...system 90 This chapter gives descriptions of commands that you can use when you are setting up or performing measurements The commands are split up into the following subsystems CONFigure subsystem commands that control all instruments FETCh INITiate and READ subsystems let you control measurement parameters for the power meter SENSe subsystem commands that control Power Sensors Optical Head Inter...

Page 60: ...ed 0 is returned if the FLASH setting has been deleted using CONFigure MEASurement SETTing ERASe since the last recall or store 1 is returned if the setting was changed but has not been saved yet Example conf meas sett act 2 Affects All instruments Command CONFigure MEASurement SETTing NUMBer Syntax CONFigure MEASurement SETTing NUMBer Description Get the number of settings In addition to the sett...

Page 61: ... recall Parameters None Response None Example conf meas sett canc Affects All instruments Command CONFigure MEASurement SETTing RECall Syntax CONFigure MEASurement SETTing RECall Description 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 Des...

Page 62: ...ing Guide 4 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 ...

Page 63: ...ue 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 fetc1 pow 6 73370400E 04 Affects N7744C and N7745C Command FETCh n POWer ALL Syntax FETCh n POWer ALL Description Reads all current power meter values It does not provide its own triggering and so must be used with either continuous software triggering or a directly prece...

Page 64: ...00E 06 1 34789100E 06 1 37456900E 06 Affects N7744C and N7745C Command FETCh n POWer ALL CONFig Syntax FETCh n POWer ALL CONFig Description Returns the slot and channel numbers for all available power meter channels Use this command to match returned power values to the appropriate slot and channel number Parameters None Response A binary block Intel byte order consisting of 2 byte unsigned intege...

Page 65: ...OWer MIN Syntax FETCh n POWer MIN Description Returns the minimum power value since the reset Parameters None Response 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...

Page 66: ...one full trigger cycle that is one measurement is made for selected n In logging mode it triggers all channels independent from n Parameters None Response None Example init1 imm init2 imm Affects N7744C and N7745C Command INITiate n CHANnel m CONTinuous Syntax INITiate n CHANnel m CONTinuous wsp boolean Description Sets the software trigger system to continuous measurement mode Parameters A boolea...

Page 67: ...INITiate n CHANnel m CONTinuous Syntax INITiate n CHANnel m CONTinuous Description 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 ...

Page 68: ...n 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 Command READ n POWer ALL CSV Syntax READ n POWer ALL CSV Description Reads all available power channels It provides its own software triggering and does not need a triggering command Parameters None Response 4...

Page 69: ...rpreted as 1 1 2 1 3 1 4 1 This 16 byte block means that there are four power meters present Affects N7744C and N7745C Command READ n POWer Syntax READ n POWer Description Reads the current power meter value It provides its own software triggering and does not need a triggering command If the software trigger system operates continuously this command is identical to FETCh n POWer If the software t...

Page 70: ...If no unit type is specified decibels dB is implied Response None Example sens1 corr 10DB Affects All power meters Command SENSe n CORRection Syntax SENSe n CORRection Description Returns the calibration factor for a module Parameters None Response The calibration factor as a float value Units are in dB although no units are returned in the response message Example sens1 corr 1 00000000E 000 Affec...

Page 71: ... errors any other number remote zeroing failed Example sens1 corr coll zero 0 Affects All power meters Command SENSe CORRection COLLect ZERO ALL Syntax SENSe CORRection COLLect ZERO ALL Description Zeros the electrical offsets for all power meter channels NOTE Cover the optical inputs or switch the input source off before starting Parameters Response None Example sens corr coll zero all Affects Al...

Page 72: ...ERO QUAD Syntax SENSe n CORRection COLLect ZERO QUAD Description Zeros the electrical offsets for all 4 power meter channels of the selected quad if n is between 1 and 4 then the first quad is zeroed if n is between 5 and 8 then the second quad is zeroed NOTE Cover the Optical Inputs or switch the input source off before starting Parameters None Response None Example sens1 corr coll zero quad Affe...

Page 73: ...l zero quad 272 272 decimal 0x110 This means zeroing failed on channels 6 and 7 All other channels were successful Example sens1 chan corr coll zero quad 0 Affects All power meters Command SENSe n FUNCtion LOOP Syntax SENSe n FUNCtion LOOP wsp value Description Sets the number of logging loops Parameters Number of Loops an integer value 0 Endless Streaming 1 1 Default 2 2 For 2 Million Points with...

Page 74: ...guration problem string Sum of pre trigger and data points is higher than 1048576 No threshold triggering in relative mode allowed Parameters None Response Returns whether the currently settings are consistent A string with a detailed description of a configuration problem or OK if the sweep os configured correctly The responses shown below are all the possible configuration problem strings 0 OK S...

Page 75: ...formation on accessing the results of a data acquisition function NOTE Before using this command ensure to stop logging for all available channel Details can be found in the Application Note Transient Optical Power Measurements with the N7744A and N7745A http literature cdn keysight com litweb pdf 5990 3710EN pdf Response None Example sens1 func par logg 64 1ms Affects All power meters Command SEN...

Page 76: ... FUNCtion RESult for information on accessing the results of a data acquisition function See Trigger Subsystem Commands for information on how triggering affects data acquisition functions Response None Example sens1 func par logg 64 1ms Affects All power meters Command SENSe n FUNCtion PARameter MINMax Syntax SENSe n FUNCtion PARameter MINMax Description Returns the MinMax mode and the number of ...

Page 77: ...s in seconds If you specify no units in your command seconds are used as the default See SENSe n FUNCtion PARameter STABility on page 100 for information on starting stopping a data acquisition function See SENSe n FUNCtion RESult on page 100 for information on accessing the results of a data acquisition function Response None Example sens1 func par stab 1s 0 1s 0 1s Affects All power meters Comma...

Page 78: ...tion function Affects All power meters Command SENSe n FUNCtion RESult BLOCk Syntax SENSe n FUNCtion RESult BLOCk wsp offset of data points Description Returns a specific binary block Intel byte order from the data array for the last data acquisition function Parameters offset A zero based offset the number of data points to ignore data points The number of data points not bytes to return Response...

Page 79: ...The last data acquisition function s data array as a binary block For Logging and Stability Data Acquisition functions one measurement value is a 4 byte little endian IEEE 754 single precision value Example sens1 func res bufb 255 Affects All power meters Command SENSe n FUNCtion RESult BLOCk Syntax SENSe n FUNCtion RESult BLOCk wsp offset of data points Description Returns a specific binary block...

Page 80: ...cation requires more data points please use SENSe n FUNCtion RESult BLOCk instead of SENSe n FUNCtion RESult Parameters None Response An integer value number of data points See Data Types for more information on Binary Blocks Example sens1 func res maxb 204050 Affects All power meters Command SENSe n FUNCtion STATe Syntax SENSe n FUNCtion STATe wsp LOGGing STABility MINMax STOP STARt Description E...

Page 81: ... SENSe n POWer GAIN AUTO wsp value Description Set the Auto Gain Parameters 0 Auto Gain Off This is the position for best transient response 1 Auto Gain On Default This is the Position for best dynamic Auto gain only works for averaging times 10us For shorter averaging times the auto gain is always disabled The Auto Gain setting works also in the logging and stability modes where it also increases...

Page 82: ...best dynamic Example sens1 pow gain auto 1 Affects All power meters Command SENSe n POWer ATIMe Syntax SENSe n POWer ATIMe wsp averaging time NS US MS S Description Sets the averaging time Parameters The averaging time as a float value in seconds If you specify no units in your command seconds are used as the default NONE For N774xC power meters the internal granularity of the averaging time is 1u...

Page 83: ...by the sens n pow rang command Automatic ranging while other commands are sent to power meters has lead to timing conflicts in some configurations Automation programs can often better control the range directly Parameters A boolean value 0 or OFF automatic ranging disabled 1 or ON automatic ranging enabled Response None Example sens1 pow rang auto 1 Affects All power meters Command SENSe n POWer R...

Page 84: ...9 uW Parameters The range as a float value in dBm The number is rounded to the closest multiple of 10 because the range changes at 10 dBm intervals Units are in dBm Response None Example sens1 pow rang 20DBM Affects All power meters Command SENSe n POWer RANGe Syntax SENSe n POWer RANGe Description Returns the range setting for the channel Parameters None Response The range setting as a float valu...

Page 85: ... the last reference value entered for the selected reference mode Response None Example sens1 pow ref tomod 40DB Affects All power meters Command SENSe n POWer REFerence Syntax SENSe n POWer REFerence wsp TOMODule TOREF Description Returns the channels reference value Parameters TOMODule TOREF Returns the reference value in dB used if you choose measurement relative to another channel Returns the ...

Page 86: ... All power meters Command SENSe n POWer REFerence STATe Syntax SENSe n POWer REFerence STATe Parameters None Response A boolean value 0 absolute 1 relative Example sens1 pow ref stat 1 Affects All power meters Command SENSe n POWer REFerence STATe RATio Syntax SENSe n POWer REFerence STATe RATio wsp slot number 255 TOREF channel number Description Selects the reference for the channel Parameters S...

Page 87: ... meters Command SENSe n POWer REFerence STATe RATio Syntax SENSe n POWer REFerence STATe RATio Description Returns the reference setting for the channel Parameters None Response Results are displayed relative to an absolute reference or to the current power reading from another channel Example sens1 pow ref stat rat 255 0 sens1 pow ref stat rat 2 1 results are displayed relative to an absolute ref...

Page 88: ...escription Gets the current sensor power units for all channels Parameters None Response Example sens pow unit all csv 1 0 1 1 1 1 1 1 Affects All power meters Command SENSe n POWer WAVelength ALL Syntax SENSe n POWer WAVelength ALL wsp value MIN MAX DEF PM NM UM MM M Description Sets the sensor wavelength Frequent use of this command can conflict with the timing of autoranging in some configurati...

Page 89: ...ower meters Command SENSe n POWer WAVelength Syntax SENSe n POWer WAVelength wsp MIN MAX DEF Description Gets the current sensor wavelength Parameters None Response 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 ...

Page 90: ...rigger Connector A hardware trigger cannot be effective in the DISabled triggering mode but can be effective in DEFault PASSthrough or LOOPback triggering modes see TRIGger CONFiguration on page 94 for information on triggering modes Response None Example trig 1 Command TRIGger n DELay Syntax TRIGger n DELay Description Returns factor for delay Effective trigger delay time factor 32 Mhz Parameters...

Page 91: ...se multiple cycles 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 Example trig0 inp IGN Affects All power meters Command TRIGger n INPut Syntax TRIGger n INPut wsp trigger response Description Sets the incoming trigger response and arms the module Parameters IGNore SMEasure CMEasure MMEasure PREtrigger ...

Page 92: ...LLing trigger on the low edge of the BNC TTL input Example TRIG INP EDG RIS Affects All power meters Command TRIGger n INPut EDGe Syntax TRIGger n INPut EDGe Description Sets the trigger edge detection of the BNC TTL input Parameters 0 or RISing trigger on the high edge of the BNC TTL input 1 or FALLing trigger on the low edge of the BNC TTL input Response None Example TRIGg INP EDG RIS Affects Al...

Page 93: ... an integer value maximum possible value is 2147483647 Response None Example trig1 offs 5 Affects All power meters Command TRIGger n OUTPut Syntax TRIGger n OUTPut Description Returns the condition that causes an output trigger Parameters none Response DISabled AVGover MEASure Never When averaging time period finishes When averaging time period begins Example trig1 outp DIS Affects All power meter...

Page 94: ... trigger at the Output Trigger Connector automatically No triggers from the instrument at the output The same as PASSthrough This is included for compatibility reasons Example trig conf DEF Affects All power meters Command TRIGger CONFiguration Syntax TRIGger CONFiguration Description Sets the hardware trigger configuration with regard to Output and Input Trigger Connectors Parameters 0 or DISable...

Page 95: ...eysight N774xC Series Multiport Power Meter Programming Guide 5 Error Codes Error Strings 96 This chapter gives information about error codes used with the N774xC series multiport power meter instruments ...

Page 96: ...me others 102 Syntax error An unrecognized command or data type was encountered for example a string was received when the device does not accept strings 103 Invalid separator The parser was expecting a separator and encountered an illegal character for example the semicolon was omitted after a program message unit 104 Data type error The parser recognized a data element different than one allowed...

Page 97: ...88 2 7 7 2 4 1 124 Too many digits The mantissa of a decimal numeric data element contained more than 255 digits excluding leading zeros see IEEE 488 2 7 7 2 4 1 128 Numeric data not allowed A legal numeric data element was received but the device does not accept one in this position for the header 130 Suffix error 131 Invalid suffix The suffix does not follow the syntax described in IEEE 488 2 7 ...

Page 98: ... satisfied 168 Block data not allowed A legal block data element was encountered but was not allowed by the device at this point in parsing 170 Expression error This error as well as errors 171 through 179 are generated when parsing an expression data element This particular error message is used when the device cannot detect a more specific error 171 Invalid expression The expression data element...

Page 99: ...the logging application parameters First the user must stop the logging application 201 Invalid while in local Please be patient GPIB currently locked out Description Some operations block the complete system Since no sensible measurements are possible while this is true the GPIB is locked out Example When ARA Lambda zeroing or zeroing is executing on a TLS module the GPIB is not accessible 202 Se...

Page 100: ... sweep one of the following cases of sweep parameter inconsistency has occurred Continuous Sweep mode AND l Start is less than l Stop Continuous Sweep mode AND Sweep Time is too short Adjust Sweep Speed l Start or l Stop Continuous Sweep mode AND Sweep Time is too long Adjust Sweep Speed l Start or l Stop Continuous Sweep mode AND Trigger Frequency is too high Adjust Step Size Trigger Frequency is...

Page 101: ...rument runs out of memory 226 Lists not same length 230 Data corrupt or stale 231 Data questionable StatValNYetAcc Description The data that is retured is not accurate or reliable The user should repeat the operation The reason for this error is unspecific Example A powermeter configured a long average time has not completed its current measurement cycle when the user queries the current power 231...

Page 102: ...ome error in the macro definition see IEEE 488 2 10 7 6 3 273 Illegal macro label Indicates that the macro label defined in the DMC command was a legal string syntax but could not be accepted by the device see IEEE 488 2 10 7 3 and 10 7 6 2 for example the label was too long the same as a common command header or contained invalid header syntax 274 Macro parameter error 275 Macro definition too lo...

Page 103: ...286 Program runtime error 290 Memory use error 291 Out of memory 292 Referenced name does not exist 293 Referenced name already exists 294 Incompatible type 300 Device specific error 303 Module slot empty or slot channel invalid Description The user has send a command to an empty slot 310 System error Indicates that some error termed system error by the device has occurred This code is device depe...

Page 104: ...out error 368 LambdaStop LambdaStart 369 sweepTime min 370 sweepTime max 371 triggerFreq max 372 step min 373 triggerNum max 374 LambdaLogging On AND Modulation On AND ModulationSource CoherenceControl 375 LambdaLogging On AND TriggerOut StepFinished 376 Lambda logging in stepped mode 377 step not multiple of 0 1pm 378 triggerFreq min 400 Query error This is the generic query error for devices tha...

Page 105: ... incomplete program message was received 430 Query DEADLOCKED Indicates that a condition causing an DEADLOCKED Query error occurred see IEEE 488 2 6 3 1 7 for example both input buffer and output buffer are full and the device cannot continue 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 ...

Page 106: ...This information is subject to change without notice Keysight Technologies 2019 Edition 1 0 December 2019 www keysight com ...