Keysight Technologies N778 C Series Programming Manual Download Page 9

Page: 9 / 102

Keysight N778xC Series Polarization Instruments
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. The information in these chapters is specific to the

N778xC polarization instruments.

Summary of Contents for N778 C Series

Page 1: ...Programming Guide Keysight N778xC Series Polarization Instruments N7781C Polarization Analyzer N7785C Synchronous Scrambler N7786C Polarization Synthesizer N7788C Optical Component Analyzer ...

Page 2: ...re 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 techni...

Page 3: ...perature 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 i...

Page 4: ... Canadian 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 ...

Page 5: ...ration 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 no...

Page 6: ......

Page 7: ...orks 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 Interface Instrument Behaviour Settings The SYSTem Subsyst...

Page 8: ...Operations Settings Configure Subsystem Commands 52 Triggering The TRIGger Subsystem 55 5 Polarization Commands Polarization Analyzer Commands 62 Polarization Synchronous Scrambler Commands 77 Polarization Synthesizer Polarization Component Analyzer Commands 89 6 Error Codes Error Strings 92 ...

Page 9: ...mming 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 N778xC polarization instruments ...

Page 10: ...esponses 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 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: ... N778xC Series Polarization Instruments 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: ...t 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 c...

Page 13: ... shows 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 dou...

Page 14: ...ined between double quotes or single quotes When the instrument returns a string it is always included in When a register value is given or returned for example ESE the decimal values for the single bits are added For example a value of nine means that bit 0 and bit 3 are set Larger blocks of data are given as Binary Blocks preceded by H Len Block H represents the number of digits Len represents t...

Page 15: ...mary 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 Complet...

Page 16: ...ure 1 shows how the Standard Event Status Enable Mask SESEM and the Standard Event Status Register SESR determine the Event Status Bit ESB of the Status Byte Figure 1 The Event Status Bit The SESR contains the information about events that are not slot specific 0 1 2 3 4 5 6 7 STB returns the Status Byte Register Status OSB ESB QSB ESR returns the Standard Event Status Register 0 0 1 0 1 2 3 4 5 6...

Page 17: ... 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 NOTE Unused bits in any of the registers change to 0 when you read them ...

Page 18: ......

Page 19: ...ng Guide 2 Command Summary Command Summary 20 This chapter lists commands relating to the N778xC series polarization instruments Each of these summaries contains a page reference for more detailed information about the particular command later in this manual ...

Page 20: ...he subnodes and the included commands Table 4 Command Summary Command Page CONFigure Subsystem CONFigure MEASurement SETTing ACTual Page 52 CONFigure MEASurement SETTing NUMBer Page 52 CONFigure MEASurement SETTing PRESet Page 52 CONFigure MEASurement SETTing CANCel Page 53 CONFigure MEASurement SETTing RECall Page 53 CONFigure MEASurement SETTing SAVE Page 53 CONFigure MEASurement SETTing ERASe P...

Page 21: ...STARt Page 67 POLarimeter SWEep STATe Page 67 POLarimeter SWEep GET Page 68 POLarimeter FUNCtion RESult Page 68 POLarimeter SWEep GET INDex Page 68 POLarimeter SWEep SAMPles Page 69 POLarimeter SWEep SAMPles CURRent Page 69 POLarimeter SWEep SAMPles Page 69 POLarimeter SWEep RATe Page 70 POLarimeter SWEep RATe Page 70 POLarimeter SWEep SRATe Page 70 POLarimeter SWEep SRATe Page 70 POLarimeter SWEe...

Page 22: ...FSet Page 75 POLarimeter TRIGger OFFSet Page 75 POLarimeter TRIGger INPut Page 76 POLarimeter TRIGger OUTPut Page 76 POLarimeter TRIGger OUTPut Page 76 Command Page Polarization Synchronous Scrambler Commands PCONtroller STOP Page 77 PCONtroller WPLAtes Page 77 PCONtroller WPLAtes Page 77 PCONtroller SEQuence LENGth Page 78 PCONtroller SEQuence LENGth Page 78 PCONtroller SEQuence RRATe Page 78 PCO...

Page 23: ...ler ENABle Page 83 PCONtroller STAGe stage DEGree Page 84 PCONtroller STAGe stage DEGree Page 84 PCONtroller STARt Page 84 PCONtroller REPetition Page 85 PCONtroller LOAD DATA Page 85 PCONtroller SAVE ARB Page 86 PCONtroller LOAD ARB Page 86 PCONtroller GEN RANDom Page 86 PCONtroller GEN SCRAmble Page 87 PCONtroller SWITch Page 87 PCONtroller SWITch Page 87 Command Page Polarization Synthesizer Po...

Page 24: ...SYSTem COMMunicate ETHernet AUTOip ENABle Page 39 SYSTem COMMunicate ETHernet CANCel Page 39 SYSTem COMMunicate ETHernet DGATeway Page 39 SYSTem COMMunicate ETHernet DGATeway Page 39 SYSTem COMMunicate ETHernet DGATeway CURRent Page 40 SYSTem COMMunicate ETHernet DHCP ENABle Page 40 SYSTem COMMunicate ETHernet DHCP ENABle Page 40 SYSTem COMMunicate ETHernet DOMainname Page 41 SYSTem COMMunicate ET...

Page 25: ...ate ETHernet NTP SERVer Page 45 SYSTem COMMunicate ETHernet NTP SERVer Page 45 SYSTem COMMunicate ETHernet DESCription Page 46 SYSTem COMMunicate ETHernet DESCription Page 46 SYSTem COMMunicate ETHernet WHITEList ENABle Page 46 SYSTem COMMunicate ETHernet WHITEList ENABle Page 47 SYSTem COMMunicate ETHernet WHITEList IPADdress Page 47 SYSTem COMMunicate ETHernet WHITEList IPADdress Page 47 SYSTem ...

Page 26: ...er Page 55 TRIGger n DELay Page 55 TRIGger n DELay Page 55 TRIGger n INPut Page 56 TRIGger n INPut Page 56 TRIGger n INPut EDGe Page 57 TRIGger n INPut EDGe Page 57 TRIGger n OFFSet Page 58 TRIGger n OFFSet Page 57 TRIGger n OUTPut Page 58 TRIGger n OUTPut Page 58 TRIGger CONFiguration Page 59 TRIGger CONFiguration Page 59 ...

Page 27: ...ate The SYST COMMunicate sub tree 38 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 interface and internal data...

Page 28: ...ent 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 SESR...

Page 29: ...ion on this register Parameters none Response The bit value for the register a 16 bit signed integer value Example ESE 255 Command ESR Syntax ESR Description The standard Event Status Register query ESR returns the contents of the Standard Event Status Register The register is cleared after being read parameters none response The bit value for the register a 16 bit signed integer value Bit Mnemoni...

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

Page 31: ...ntax 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 modul...

Page 32: ...ailable MAV 16 3 Questionable Status QSB 8 2 Not used 0 1 Not used 0 0 Not used 0 Example STB 128 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 comm...

Page 33: ...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 the GPIB bus to all commands until every module hosted by the instrument is no longer busy All pending operations are completed during the wait period Para...

Page 34: ...sp 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 Descr...

Page 35: ...ument to the standard settings 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...

Page 36: ...0 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 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 Command S...

Page 37: ...rogramming Guide 37 Instrument Setup and Status 3 Parameters none Response The revision year and number Example syst vers 1999 Command SYSTem REBoot Syntax SYSTem REBoot Description Reboots the instrument Parameters none Response None Example syst reb ...

Page 38: ...as 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 a...

Page 39: ...unicate 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...

Page 40: ...ult 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 E...

Page 41: ...Mainname 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 ...

Page 42: ...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 END 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 ...

Page 43: ...r 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 identificatio...

Page 44: ...the 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 MACaddres...

Page 45: ...ent 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 Respon...

Page 46: ...ing of up to 260 characters Example syst comm eth desc Keysight N778xC 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 N778xC 42321 Command SYSTem COMMunicate ETHernet WHITEList ENABle Syntax SYSTem COM...

Page 47: ...es 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 ...

Page 48: ...Hernet 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 blank no password Parameters None Response None Example syst ...

Page 49: ... None 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 sep...

Page 50: ...ng 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 51: ...ommands 52 Triggering The TRIGger Subsystem 55 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 TRIGger subsystem commands that control triggering ...

Page 52: ...tored 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 s...

Page 53: ...r 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 De...

Page 54: ...mming 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 55: ...e effective in DEFault PASSthrough or LOOPback triggering modes see TRIGger CONFiguration on page 59 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 None Response Factor Example trig1 del 0 Command TRIGger n DELay Syntax TRIGger n DELay wsp valu...

Page 56: ...d maximum threshold values If you don t want both limit you can write NAN instead of number Example trig0 inp IGN Affects All modules 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 THReshold Ignore incoming trigger Start a single measurement If a measureme...

Page 57: ...e TRIG INP EDG RIS Affects All modules 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 All modules Command TRIGger n OFFSet Syntax TRIGger n OFFSet Des...

Page 58: ...mand 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 trig0 outp dis Affects All modules Command TRIGger n OUTPut Syntax TRIGger n OUTPut Description Specifies when an output trigger is generated and arms the m...

Page 59: ... All modules SCR and POL are only available at the N7786C and N7788C which have a build in polarization scrambler and polarimeter Command TRIGger CONFiguration Syntax TRIGger CONFiguration Description Sets the hardware trigger configuration with regard to Output and Input Trigger Connectors Parameters 0 or DISabled 1 or DEFault 2 or PASSthrough 3 or LOOPback 4 or SCRambler2polarimeter 5 or POLarim...

Page 60: ......

Page 61: ...ogramming Guide 5 Polarization Commands Polarization Analyzer Commands 62 Polarization Synchronous Scrambler Commands 77 Polarization Synthesizer Polarization Component Analyzer Commands 89 This chapter provides description of the polarization commands ...

Page 62: ...6273017E 06 Affects N7781C N7786C N7788C Command POLarimeter SOP FETCh Syntax POLarimeter SOP FETCh Description Returns the S0 S1 S2 and S3 stokes parameter from last measurement The normalized Stokes parameter are obtained by dividing the Stokes parameters by the total optical power s1 S1 S0 s2 S2 S0 s3 S3 S0 Parameters None Response Comma separated values Example POLarimeter SOP FETCH 1 53819801...

Page 63: ...e POL POW FETC 1 53759156E 05 Affects N7781C N7786C N7788C Command POLarimeter POWer UNIT Syntax POLarimeter POWer UNIT wsp DBM 0 Watt 1 Description Sets the power unit Parameters 0 or DBM dBm 1 or Watt Watts Example POL POW UNIT 1 Affects N7781C N7786C N7788C Command POLarimeter POWer UNIT Syntax POLarimeter POWer UNIT Description Returns the power unit Parameters None Response 0 dBm 1 Watt Examp...

Page 64: ...l MINimum Returns the minimum wavelength MAXimum Returns the maximum wavelength DEFault Returns default wavelength Response The wavelength as a float value in meters Example pol wav 1 550E 06 Affects N7781C N7786C N7788C Command POLarimeter GAIN Syntax POLarimeter GAIN wsp gain level Description 0 5 High Bandwith about 250kHz 6 7 Medium Bandwith about 100kHz 8 9 Slow Bandwith about 10kHz NOTE Use ...

Page 65: ...meter AGFLag Description Enable or disable auto gain NOTE Auto Gain is disabled when setting manual Gain with the POL GAIN command NOTE Auto gain setting is ignored in Logging Sweep and Stabilizer Mode Parameters 0 auto gain off 1 auto gain on Example pol agfl 1 Affects N7781C N7786C N7788C Command POLarimeter AGFLag Syntax POLarimeter AGFLag Description Returns the auto gain flag Parameters A boo...

Page 66: ...des That means dark current is measured and will be subtracted from future measurements Parameters None Example pol zero Affects N7781C N7786C N7788C Command POLarimeter ZERO Syntax POLarimeter ZERO Description Returns zero result Parameters None Response 0 last zero was successfull 1 last zero failed too much light for example Example pol zero Affects N7781C N7786C N7788C Command POLarimeter SWEe...

Page 67: ...loop Affects N7781C N7786C N7788C Command POLarimeter SWEep STARt Syntax POLarimeter SWEep STARt wsp SOP SOPCONTINUOUS Description This command starts the polarimeter logging Parameters None Starts logging as configured SOP Starts logging and sets loop to 1 SOPCONTINUOUS Starts logging and sets loop to 0 endless logging Example pol swe star sop Affects N7781C N7786C N7788C Command POLarimeter SWEe...

Page 68: ...GET wsp SOP NORMalized Description This command returns the measurement result as float binblock Parameters None returns 4 dimensional array with S0 S1 S2 S3 SOP returns 4 dimensional array with S0 S1 S2 S3 NORMalized returns 3 dimensional array with S1 S2 S3 Response float binblock Example pol swe get sop Affects N7781C N7786C N7788C Command POLarimeter FUNCtion RESult Syntax POLarimeter FUNCtion...

Page 69: ...ple pol swe samp 1000 Affects N7781C N7786C N7788C Command POLarimeter SWEep SAMPles Syntax POLarimeter SWEep SAMPles Description This command gets the number of samples logging count Parameters None Response Interger Example pol swe samp 1000 Affects N7781C N7786C N7788C Command POLarimeter SWEep SAMPles CURRent Syntax POLarimeter SWEep SAMPles CURRent Description This command gets the number of ...

Page 70: ...ep rate in nm s If you do not pass unit assumption is m s Example pol swe rat 40nm s Affects N7781C N7786C N7788C Command POLarimeter SWEep RATe Syntax POLarimeter SWEep RATe Description This command returns the sweep rate in m s Parameters None Response Float sweep rate Example pol swe rat 4 00000000E 08 Affects N7781C N7786C N7788C Command POLarimeter SWEep SRATe Syntax POLarimeter SWEep SRATe w...

Page 71: ...e srat 1e 06 1e 06 Affects N7781C N7786C N7788C Command POLarimeter SWEep LPRange Syntax POLarimeter SWEep LPRange Description Returns how well the ADC range was used for the last peak power If this value is below 0 5 the measurement sweep should be repeated with a higher amplifier gain setting If the Value is 1 0 then there is an increasing Risk of Overflow Select a lower amplifier setting in thi...

Page 72: ...0000000E 12 Affects N7781C N7786C N7788C Command POLarimeter SWEep TRIGger PRE SAMPles Syntax POLarimeter SWEep TRIGger PRE SAMPles Description Sets the number of pre samples That means samples before trigger event Numbers of pre samples and post samples have to be smaller than 1048576 Parameters Number of pre samples Example pol swe trig pre samp 1000 Affects N7781C N7786C N7788C Command POLarime...

Page 73: ...ommand POLarimeter SWEep TRIGger POST SAMPles Syntax POLarimeter SWEep TRIGger POST SAMPles Description Returns the number of post samples Parameters None Response Number of post samples Example pol swe trig post samp 2000 Affects N7781C N7786C N7788C Command POLarimeter SWEep CONTinuous SACCuracy Syntax POLarimeter SWEep CONTinuous SACCuracy Description Sets the SOP accuracy in rad used in the co...

Page 74: ...RIGGER_TTLHIGH Specified numbers of samples are logged before rising edge on BNC input PRETRIGGER_TTLLOW Specified numbers of samples are logged before falling edge on BNC input SMEasure One sample for every trigger will be logged CMEasure One trigger excutes one loop with specified number of samples MMEasure One trigger executes specified number of loops with specified number of samples THReshold...

Page 75: ...Factor Example pol trig del 0 Affects N7781C N7786C N7788C Command POLarimeter TRIGger OFFSet Syntax POLarimeter TRIGger OFFSet Description Defines number of triggers which will be ignored before first trigger event Parameters Trigger offset integer Example pol trig offs 10 Affects N7781C N7786C N7788C Command POLarimeter TRIGger OFFSet Syntax POLarimeter TRIGger OFFSet Description Returns number ...

Page 76: ...8C Command POLarimeter TRIGger OUTPut Syntax POLarimeter TRIGger OUTPut Description Defines trigger output Parameters DISabled no trigger at output BNC AVGover trigger when averaging starts at output BNC MEASure trigger when measuring starts at output BNC Example pol trig outp dis Affects N7781C N7786C N7788C Command POLarimeter TRIGger OUTPut Syntax POLarimeter TRIGger OUTPut Description Returns ...

Page 77: ...rientation Waveplate 1 Retardation Waveplate 1 Orientation Waveplate 2 Retardation Waveplate 2 Orientation Waveplate 3 Retardation Waveplate 3 Orientation Waveplate 4 Retardation Waveplate 4 Orientation Waveplate 5 Retardation Waveplate 5 Orientation Waveplate 6 Retardation Waveplate 6 The orientation is given in rad the retardation is given in fractions of Lambda A retardation of 0 25 corresponds...

Page 78: ...Ntroller SEQuence LENGth wsp length Description Set the polarization controller sequence length Parameters Integer value 0 100000 Response None Example PCONtroller SEQuence LENGth 5 Affects N7785C N7786C N7788C Command PCONtroller SEQuence LENGth Syntax PCONtroller SEQuence LENGth Description Get the polarization controller sequence length Parameters None Response Int value Example PCONtroller SEQ...

Page 79: ...escription Sets the sequence mode A sequence consist of the number of datapoints multiplied by the repetition repetition 0 means endless 0 Sequence will automatically start and restart when reaching the end 1 Sequence will automatically start and run only once like repetition 1 2 Sequence will start when a low high transition is detected on the BNC input When reaching the end of the sequence it wi...

Page 80: ...ger Parameters None Response Integer value Example PCONtroller SEQuence SMODe 0 Affects N7785C N7786C N7788C Command PCONtroller SEQuence DCOMpensation Syntax PCONtroller SEQuence DCOMpensation wsp value Description Set the polarization controller drift compensation 0 drift compensation is OFF dynamic correction is inactive 1 drift compensation is ON dynamic correction is active DEFAULT Parameters...

Page 81: ...e 0 32766 1 means 1 32 us Example PCONtroller SEQuence HOLDoff 1 Affects N7785C N7786C N7788C Command PCONtroller SEQuence Syntax PCONtroller SEQuence wsp 488 2 Binary Block Description Sets the polarization controller sequence using waveplate positions and retardations The parameter list is a series of floating point values Each waveplate is controlled by two float values Orientation in rad and R...

Page 82: ...at values The order is given by Orientation Waveplate 1 Retardation Waveplate 1 Orientation Waveplate 2 Retardation Waveplate 2 Orientation Waveplate 3 Retardation Waveplate 3 Orientation Waveplate 4 Retardation Waveplate 4 Orientation Waveplate 5 Retardation Waveplate 5 Orientation Waveplate 6 Retardation Waveplate 6 Parameters None Response 488 2 Binary Block real32 double Example PCONtroller SE...

Page 83: ...ABle Syntax PCONtroller SCRambler ENABle Description Enables 1 or disables 0 the Scrambler same function like PCONtroller STARt and PCONtroller STOP Parameters Integer value 1 Polcontroller is running 0 Polcontroller is disables Response None Example PCONtroller SCRambler ENABle 1 Affects N7785C N7786C N7788C Command PCONtroller SCRambler ENABle Syntax PCONtroller SCRambler ENABle Description Retu...

Page 84: ...le pcon stag1 deg 75 4 Affects N7785C N7786C N7788C Command PCONtroller STAGe stage DEGree Syntax PCONtroller STAGe stage DEGree Description Get the orientation for each waveplate lambda 4 plate Parameters stage integer value from 1 to 6 Response Float value Example PCON STAG5 DEG 2 30000000E 01 Affects N7785C N7786C N7788C Command PCONtroller STARt Syntax PCONtroller STARt Description Start the p...

Page 85: ...Ntroller REPetition Syntax PCONtroller REPetition Description Get the polarization controller repetition Parameters None Response Integer value between 0 to 2147483647 Example pcon rep 10 Affects N7785C N7786C N7788C Command PCONtroller LOAD DATA Syntax PCONtroller LOAD DATA wsp filename Description Loads a specified arb segment from the internal memory Parameters Quoted string filename Response s...

Page 86: ... PCONtroller LOAD ARB Description Load an arbitrary waveform Parameters None Response Status message load x datapoints Error message Error on dataload Example pcon load arb load 4 datapoints Affects N7785C N7786C N7788C Command PCONtroller GEN RANDom Syntax PCONtroller GEN RANDom datapoints stepwidth Description Generate a random walk sequence with a maximum stepwidth Parameters datapoints integer...

Page 87: ... is finished Example PCONtroller GEN SCRAmble 300 GEN DONE Affects N7785C N7786C N7788C Command PCONtroller SWITch Syntax PCONtroller SWITch Description Sets the optical switch in the N7788C Parameters Integer value 0 optical Scrambler Input signal will be routed to the internal polarimerer 1 optical Scrambler Input signal will be routed to the Scrambler Output Response None Example pcon swit 1 Af...

Page 88: ...ts Programming Guide 5 Polarization Commands Response Integer value 0 optical Scrambler Input signal will be routed to the internal polarimerer 1 optical Scrambler Input signal will be routed to the Scrambler Output Example pcon swit 0 Affects N7788C ...

Page 89: ...de For best results check the Leveling of the Polarimeter Look at the POL SWE LPR command Maximum Speed is at Gain 0 to 5 Even Gains have Factors of 10 and odd Gains Factors of 8 Choose what fits better NOTE If the stabilizer function is active then most other Commands to Scrambler and Polarimeter including Zeroing are blocked NOTE An On Startup Stabilize Mode where stabilizing is automatically on...

Page 90: ...zer STABilize 1 To activate stabilization STABILIZER SOP 0 0 0 A To enter the feedback parameter A TRIG 1To trigger the next stabilization dithering step The last 2 steps should be repeated with updated values Repetition rates of 10 to 20 Hz are fine The stabilizer will work to minimize the parameter A which should be a positive real number The feedback parameter can be scaled to improve the conve...

Page 91: ...ysight N778xC Series Polarization Instruments Programming Guide 6 Error Codes Error Strings 92 This chapter gives information about error codes used with the N778xC series tunable laser source instruments ...

Page 92: ...r example 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 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 af...

Page 93: ...a in 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 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...

Page 94: ...xample 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 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 ...

Page 95: ...r is 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 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 ...

Page 96: ...h 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 i...

Page 97: ...trument 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 23...

Page 98: ...some 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 l...

Page 99: ... 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 dep...

Page 100: ...e 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 t...

Page 101: ...an 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 wa...

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

Search results

Summary of Contents for N778 C Series

Reviews:

Related manuals for N778 C Series

Brands by name

Popular brands

Keysight Technologies N778 C Series, Programming Manual

Search results

Summary of Contents for N778 C Series

Reviews:

Related manuals for N778 C Series

Brands by name

Popular brands