Programming
Guide
Keysight N777xC Series
Tunable Laser Family
N7776C Tunable Laser Source
N7778C Tunable Laser Source
N7779C Tunable Laser Source
Страница 1: ...Programming Guide Keysight N777xC Series Tunable Laser Family N7776C Tunable Laser Source N7778C Tunable Laser Source N7779C Tunable Laser Source...
Страница 2: ...ire 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...
Страница 3: ...ature 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...
Страница 4: ...nadian 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...
Страница 5: ...ion 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 p...
Страница 6: ......
Страница 7: ...age 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 Quer...
Страница 8: ...Behaviour Settings The SYSTem Subsystem 41 System Communicate The SYST COMMunicate sub tree 45 4 Measurement Operations Settings Root Layer Command 60 Signal Generation The SOURce Subsystem 63 Config...
Страница 9: ...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 giv...
Страница 10: ...onses 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 0A16 If no query is received...
Страница 11: ...t N777xC Series Tunable Laser Family 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 th...
Страница 12: ...rds 1500NM 1 5UM and 1 5E 6M are all equivalent If you do not specify a unit then the default unit is assumed The default unit for the commands are given with command description in the next chapter S...
Страница 13: ...etween square brackets show optional information that you can include with the message The bar shows an either or choice of data for example a b means either a or b but not both simultaneously Extra s...
Страница 14: ...urns a string it is always included in When a register value is given or returned for example ESE the decimal values for the single bits are added For example a value of nine means that bit 0 and bit...
Страница 15: ...dentified by a slot number and a channel number For commands that require you to specify a channel the slot number is represented by n in a command and the channel number is represented by m The slot...
Страница 16: ...y Table 3 on page 16 provides a summary of the common commands Table 3 Common Command Summary Command Parameter Function Page CLS Clear Status Command page 28 ESE Standard Event Status Enable Command...
Страница 17: ...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 affec...
Страница 18: ...mily Programming Guide 1 Introduction to Programming 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...
Страница 19: ...e 2 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 in...
Страница 20: ...es the subnodes and the included commands Table 4 Command Summary Command Page CONFigure Subsystem CONFigure MEASurement SETTing ACTual Page 83 CONFigure MEASurement SETTing NUMBer Page 83 CONFigure M...
Страница 21: ...WAVelength SWEep CYCLes Page 69 SOURce0 WAVelength SWEep DWELl Page 70 SOURce0 WAVelength SWEep FLAG Page 71 SOURce0 WAVelength SWEep DWELl Page 70 SOURce0 WAVelength SWEep LLOGging Page 71 SOURce0 WA...
Страница 22: ...Page 79 SOURce0 WAVelength SWEep STEP WIDTh Page 79 SOURce0 POWer LEVel IMMediate AMPLitude Page 80 SOURce0 POWer STATe Page 80 SOURce0 POWer STATe Page 81 SOURce0 POWer UNIT Page 81 SOURce0 POWer UNI...
Страница 23: ...40 Command Page SYSTem Subsystem SYSTem DATE Page 41 SYSTem DATE Page 41 SYSTem HELP HEADers Page 41 SYSTem HELP ERRors Page 42 SYSTem TIME Page 42 SYSTem PRESet Page 43 SYSTem TIME Page 43 SYSTem ERR...
Страница 24: ...ge 50 SYSTem COMMunicate ETHernet NSERver CURRent Page 50 SYSTem COMMunicate ETHernet IDN Page 50 SYSTem COMMunicate ETHernet IPADdress Page 50 SYSTem COMMunicate ETHernet IPADdress Page 51 SYSTem COM...
Страница 25: ...em COMMunicate ETHernet RESTart Page 55 SYSTem COMMunicate ETHernet SAVE Page 56 SYSTem COMMunicate ETHernet SMASk Page 56 SYSTem COMMunicate ETHernet SMASk Page 56 SYSTem COMMunicate ETHernet SMASk C...
Страница 26: ......
Страница 27: ...41 System Communicate The SYST COMMunicate sub tree 45 This chapter gives descriptions of commands that you can use when setting up your instrument The commands are split into the following separate s...
Страница 28: ...tus 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 25...
Страница 29: ...on this register Parameters none Response The bit value for the register a 16 bit signed integer value Example ESE 255 Command ESR Syntax ESR Description The standard Event Status Register query ESR...
Страница 30: ...IDN Keysight Technologies N7776C N71130PP02 V1 000 Command OPC Syntax OPC Description Generates the OPC message in the standard event status register when all pending overlapped operations have been...
Страница 31: ...or not recognised two spaces are inserted instead of the module s part number See the example below where slots 1 and 4 are empty Example OPT N7776C Command RST Syntax RST Description The ReSeT comma...
Страница 32: ...Not used 0 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 fa...
Страница 33: ...uting 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 blo...
Страница 34: ...Status Event Summary Register OSESR 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 0 Summary Example stat oper 0...
Страница 35: ...affect bit 7 of the Status Byte Parameters 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 OPE...
Страница 36: ...er has been switched on Decimal Value 256 128 64 32 16 8 4 2 1 Example stat0 oper 0 Command STATus0 OPERation CONDition Syntax STATus0 OPERation CONDition Description Returns the Operational Slot Stat...
Страница 37: ...1 enables the corresponding bit in the OSSER and 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 STATus0 OPER...
Страница 38: ...ATus QUEStionable CONDition Description Returns the Questionable Status Condition Summary Register Parameters none Response The sum of the results for the Questionable Status Condition Summary Registe...
Страница 39: ...stat ques enab 128 Command STATus0 QUEStionable EVENt Syntax STATus0 QUEStionable EVENt Description Returns the questionable status of slot n the Questionable Slot Status Event Register QSSER Paramet...
Страница 40: ...wsp value Description Sets the bits in the Questionable Slot Status Enable Mask QSSEM for slot n that enable the contents of the Questionable Slot Status Register QSSR for the laser module to affect t...
Страница 41: ...s internal date Parameters the first value is the year four digits the second value is the month and the third value is the day Response none Example syst date 2019 10 12 Command SYSTem DATE Syntax S...
Страница 42: ...ommand 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 n...
Страница 43: ...Response The time in the 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...
Страница 44: ...em 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 2019 0 Command SYSTem RE...
Страница 45: ...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 in...
Страница 46: ...cate 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 Pa...
Страница 47: ...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...
Страница 48: ...nname 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 CO...
Страница 49: ...N7776C 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 N7776C 0PP03...
Страница 50: ...URRent 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...
Страница 51: ...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...
Страница 52: ...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 Comma...
Страница 53: ...of up to 260 characters Example syst comm eth desc Keysight N777xC 42321 Command SYSTem COMMunicate ETHernet DESCription Syntax SYSTem COMMunicate ETHernet DESCription Description Set the desired mDN...
Страница 54: ...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 IPADdres...
Страница 55: ...rnet 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 command DHCP On AutoIP On NTP Off Whit...
Страница 56: ...ne 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 s...
Страница 57: ...de 57 Instrument Setup and Status 3 Command SYSTem COMMunicate ETHernet SMASk CURRent Syntax SYSTem COMMunicate ETHernet SMASk CURRent Description Get the currently used subnet mask Parameters None Re...
Страница 58: ......
Страница 59: ...you are setting up or performing measurements The commands are split up into the following subsystems Root layer commands that take power measurements configures triggering and return information abo...
Страница 60: ...switch the lock on Lasers are switched off immediately when you switch the lock on Parameters A boolean value 0 or OFF switch lock off 1 or ON switch lock on value is the four figure lock password Re...
Страница 61: ...n slot 1 Command SLOT n IDN Syntax SLOT n IDN Description Returns information about the device Parameters None Response MMMMMMMM mmmm ssssssss rrrrrrrrrr manufacturer instrument model number for examp...
Страница 62: ...ommand SLOT n TST Syntax SLOT n TST Description Returns the latest selftest results for a device for compatibility reasons Parameters None Response Returns 0 Example slot0 tst 0 Command SPECial REBoot...
Страница 63: ...inimum linewidth Parameters Optional MIN returns the minimum programmable value 1 MAX returns the maximum programmable value 100 DEF returns the default preset RST value Response Returns the currently...
Страница 64: ...iption Selects the type or source of the modulation of the laser output Parameters COHCtrl or 1 coherence control WVLLocking or 5 wavelength locking Response None Example sour0 am sour COHC Affects Co...
Страница 65: ...f the lambda logging operation see WAVelength SWEep LLOGging Each binary block is an 8 byte long double in Intel byte order PMAX Returns a binary stream that contains the maximum power the laser can p...
Страница 66: ...ax SOURce0 WAVelength CORRection ZERO Description Executes a wavelength zero Parameters None Response None Example sour0 wav corr zero Affects All N777xC tunable laser sources Command SOURce0 WAVeleng...
Страница 67: ...s the frequency difference as a float value in Hz Example sour0 wav freq 1 00000000E 013 Affects All N777xC tunable laser sources Command SOURce0 WAVelength REFerence Syntax SOURce0 WAVelength REFeren...
Страница 68: ...rings Message Description 368 LambdaStop LambdaStart start wavelength must be smaller than stop wavelength 369 sweepTime min the total time of the sweep is too small 370 sweepTime max the total time o...
Страница 69: ...s running Parameters The number of cycles is an integer value Also allowed are MIN minimum programmable value MAX maximum programmable value DEF This is not the preset RST default value but is half th...
Страница 70: ...lowed are MIN minimum programmable value MAX maximum programmable value DEF This is not the preset RST default value but is half the sum of the minimum programmable value and the maximum programmable...
Страница 71: ...of the sweep cycle regardless Sweep state Flag start 0 sweep waiting for trigger 1 trigger first cycle start moving back do some postprocessing logging data available 2 sweep waiting for next trigger...
Страница 72: ...OFF 1 or ON switch lambda logging off switch lambda logging on Response None Example sour0 wav swe llog 1 Affects All tunable laser modules that support continuous sweep Command SOURce0 WAVelength SW...
Страница 73: ...p PMAX wsp start wavelength stop wavelength Description Returns the power to the highest permissible power for the selected wavelength sweep Parameters start wavelength stop wavelength The wavelength...
Страница 74: ...at Syntax SOURce0 WAVelength SWEep REPeat Description Returns the repeat mode Parameters None Response ONEWay TWOWay Every stepped or continuous sweep cycle starts at the start wavelength of the sweep...
Страница 75: ...value in meters per second m s Response none Example sour0 wav swe spe 10nm s Affects All tunable laser modules that support continuous sweeps Command SOURce0 WAVelength SWEep SPEed Syntax SOURce0 WAV...
Страница 76: ...ble This value is sweep speed dependent MAX Returns the maximum start wavelength available This value is sweep speed dependent Response The wavelength at which the sweep starts as a float value in met...
Страница 77: ...STATe Syntax SOURce0 WAVelength SWEep STATe wsp STOP 0 STARt 1 PAUSe 2 CONTinue 3 Description Stops starts pauses or continues a wavelength sweep Parameters 0 or STOP 1 or STARt 2 or PAUSe 3 or CONTi...
Страница 78: ...Sweep paused Example sour0 wav swe 0 Affects All N777xC tunable laser sources Command SOURce0 WAVelength SWEep STEP NEXT Syntax SOURce0 WAVelength SWEep STEP NEXT Description Performs the next sweep...
Страница 79: ...MIN Sets the minimum step width available MAX Sets the maximum step width available Response None Example sour0 wav swe step 5nm Affects All N777xC tunable laser sources Command SOURce0 WAVelength SWE...
Страница 80: ...ammable level Response None Example sour0 pow 5mW Affects All N777xC tunable laser sources Command SOURce0 POWer LEVel IMMediate AMPLitude Syntax SOURce0 POWer LEVel IMMediate AMPLitude wsp MIN DEF MA...
Страница 81: ...rameters None Response A boolean value 0 Laser Off 1 Laser On Example sour0 pow stat 1 Affects All N777xC tunable laser sources Command SOURce0 POWer UNIT Syntax SOURce0 POWer UNIT wsp DBM 0 Watt 1 De...
Страница 82: ...82 Keysight N777xC Series Tunable Laser Family Programming Guide 4 Measurement Operations Settings Response none Example sour0 pow unit 0 Affects All N777xC tunable laser sources...
Страница 83: ...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 Exam...
Страница 84: ...ecall 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 se...
Страница 85: ...Guide 85 Measurement Operations Settings 4 Command CONFigure MEASurement SETTing ERASe Syntax CONFigure MEASurement SETTing ERASe Description Erase a setting from memory Parameters Integer Response No...
Страница 86: ...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 88 fo...
Страница 87: ...le Example trig0 inp ign Affects All tunable laser modules Command TRIGger n OUTPut Syntax TRIGger n OUTPut Description Specifies when an output trigger is generated and arms the module Parameters DIS...
Страница 88: ...er at the Input Trigger Connector generates a trigger at the Output Trigger Connector automatically No triggers from the instrument at the output The same as PASSthrough This is included for compatibi...
Страница 89: ...eysight N777xC Series Tunable Laser Family Programming Guide 5 Error Codes Error Strings 90 This chapter gives information about error codes used with the N777xC series tunable laser source instrument...
Страница 90: ...xample a header containing an ampersand SETUP This error might be used in place of error 114 and perhaps some others 102 Syntax error An unrecognized command or data type was encountered for example a...
Страница 91: ...n a decimal numeric 123 Exponent too large The magnitude of the exponent was larger than 32000 see IEEE 488 2 7 7 2 4 1 124 Too many digits The mantissa of a decimal numeric data element contained mor...
Страница 92: ...ple an END message was received before the length was 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 Exp...
Страница 93: ...s not able to reconfigure 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 op...
Страница 94: ...weep 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...
Страница 95: ...ment 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...
Страница 96: ...e 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 dev...
Страница 97: ...6 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 emp...
Страница 98: ...t 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...
Страница 99: ...ncomplete 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...
Страница 100: ...This information is subject to change without notice Keysight Technologies 2019 Edition 1 0 December 2019 www keysight com...
