Keysight Technologies 8163A/B Programming Manual Download Page 267

Page: 267 / 306

8163A/B, 8164A/B & 8166A/B Mainframes Programming Guide

267

The Keysight 816x VXIplug&play Instrument Driver

VISA Data Types and Selected Constant Definitions

The driver functions use VISA data types. VISA data types are identified by

the Vi prefix in the data type name (for example, ViInt16, ViUInt16, ViChar).

The file

visatype.h

contains a complete listing of the VISA data types,

function call casts and some of the common constants.

NOTE

You can find a partial list of the type definitions and constant definitions for the

visatype.h

in the Keysight 816x VXI

plug&play

Instrument Driver Online Help.

Summary of Contents for 8163A/B

Page 1: ...Programming Guide 8163A B Lightwave Multimeter 8164A B Lightwave Measurement System 8166A B Lightwave Multichannel System...

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

Page 3: ...Clearing the Input Queue 13 The Output Queue 13 The Error Queue 14 Programming and Syntax Diagram Conventions 15 Short Form and Long Form 15 Command and Query Syntax 15 Common Commands 20 Common Comm...

Page 4: ...ysight 81619A Master and Slave Channels 86 Signal Generation The SOURce Subsystem 122 Signal Conditioning 182 The INPut and OUTput commands 182 The table of wavelength dependent offsets 196 Compatibil...

Page 5: ...ght 816x Instrument Driver 256 Using Visual Programming Environments 257 Getting Started with Keysight VEE 257 GPIB Interfacing in Keysight VEE 258 Getting Started with LabView 260 Getting Started wit...

Page 6: ...Lambda Scan Application 277 8 GPIB Command Compatibility List Compatibility Issues 282 GPIB Bus Compatibility 282 Status Model 282 Preset Defaults 282 Removed Command 283 Obsolete Commands 284 Changed...

Page 7: ...This chapter gives general information on how to control your instrument remotely Descriptions for the actual commands for the instruments are given in the following chapters The information in these...

Page 8: ...s IEEE Standard 488 2 1992 IEEE Standard Codes Formats Protocols and Common Commands For Use with ANSI IEEE Std 488 1 1987 To obtain a copy of either of these last two documents look at http standards...

Page 9: ...B address is 20 Mnemonic Function SH1 Complete source handshake capability AH1 Complete acceptor handshake capability T6 Basic talker serial poll no talk only mode unaddressed to talk if addressed to...

Page 10: ...lnet 10 are possible The ports for socket and telnet connections cannot be modified Please note the following points We recommend you use socket connections for applications Can be configured in Keysi...

Page 11: ...cess it using raw sockets that is through directly using sockets When using sockets VISA and raw there are some extra points to be aware of Always append a newline to your command or query Don t use i...

Page 12: ...If the instrument is in remote control a screen resembling Figure 1 on page 12 will appear Press Local if you wish to return the instrument to local control Figure 1 Remote Control NOTE If your 8163A...

Page 13: ...n EOI End Or Identify sent with any character is put into the input queue as the character followed by a line feed LF 0A16 If EOI is sent with a LF only one LF is put into the input queue 4 The parser...

Page 14: ...have occurred For example 1 If no error has occurred the error queue contains 0 No error 2 After a command such as wav pow the error queue now contains 0 No error 113 Undefined header 3 If the command...

Page 15: ...f 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 me...

Page 16: ...n 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...

Page 17: ...eans that bit 0 and bit 3 are set Larger blocks of data are given as Binary Blocks preceded by H Len Block terminated by END H represents the number of digits Len represents the number of bytes and Bl...

Page 18: ...from one to seventeen for the 8166A B These numbers are displayed on the front panel beside each module slot Channel numbers apply to modules that have two inputs outputs for example the Keysight 8163...

Page 19: ...cify a slot or channel number the lowest possible number is used as the default value This means Slot 1 for the 8163A B and 8166A B mainframes Slot 0 for the 8164A B mainframe Channel 1 for all channe...

Page 20: ...le 3 on page 20 provides a summary of the common commands Table 3 Common Command Summary Command Parameter Function Page CLS Clear Status Command page 47 ESE Standard Event Status Enable Command page...

Page 21: ...The Event Status Bit The SESR contains the information about events that are not slot specific For details of the function of each bit of the SESR see Standard Event Status Register on page 28 The SE...

Page 22: ...nable and operation status systems set the Operational Status Bit OSB and the Questionable Status Bit QSB These status systems are described in The Status Model on page 23 and Status Reporting The STA...

Page 23: ...tion register that is when a bit changes from 0 1 The contents of this register are cleared when it is read The contents of any higher level registers are affected with regard to the appropriate bit T...

Page 24: ...Register see below If you set a bit of the OSESM QSESM to zero the occurence of the corresponding event for this particular module slot cannot affect the Operational Questionable Status Event Register...

Page 25: ...ESM QSESM to zero the corresponding module slot cannot affect the OSB QSB The default is for all the bits of the OSESM QSESM to be set to 0 The Operational Questionable Status Enable Summary Mask for...

Page 26: ...for 8166A B The status system for the 8166A B Lightwave Multichannel System returns the status of 17 module slots The Operational Questionable Status Summary Registers consists of two levels as descr...

Page 27: ...the Level 0 summary register as described in Figure 4 Bit 0 of the Level 0 summary registers represents the summary of the status of module slots 15 16 and 17 The Level 1 summary registers contain an...

Page 28: ...dependent error has been detected Bit 4 is set if an execution error has been detected Bit 5 is set if a command error has been detected Bit 6 is always 0 no service request Bit 7 is set for the firs...

Page 29: ...are set if the wavelength offset table is enabled see page 56 All other bits are unused and therefore set to 0 Questionable Slot Status Register Bit 0 is set if excessive power is set by the user for...

Page 30: ...CLS clears the status byte and SESR and removes any entries from the error queue RST clears the error queue loads the default setting and restarts communication NOTE RST does NOT touch the STB or SES...

Page 31: ...he instrument specific commands relating to the 8163A B Lightwave Multimeter the 8164A B Lightwave Measurement System and the 8166A B Lightwave Multichannel System with a single line description Each...

Page 32: ...ommand and a query are both available the command ends So disp brig means that disp brig and disp brig are both available Command Description Page CONFigure n CHANnel m OFFSet WAVelength REFerence Set...

Page 33: ...e current state of the lock page 80 INPUT n CHANnel m ATTenuation Sets or returns the attenuation factor for the instrument page 182 OFFset Sets or returns the offset factor for the instrument page 18...

Page 34: ...er value from power meter to attenuator module ref power parameter page 189 POWer UNit Sets or queries power unit used dBm or W page 192 STATe Sets a source s or attenuators output terminals to open o...

Page 35: ...r the last power meter data acquisition function page 101 RESult MAXBlocksize Returns the maximum block size for power meter data acquisition functions page 102 RESult MONitor For return loss module r...

Page 36: ...tion COLLect TERMination Starts the calibration and saves the calibration values for a defined termination reference measurement for the currently selected source page 118 CALibration TERMination Quer...

Page 37: ...returns the coherence level page 128 SOURce n CHANnel m FM SOURce l Sets or returns the type of frequency modulaion employed specifically Stimulated Brillouin Scattering SBS control page 129 STATe l T...

Page 38: ...produce at each wavelength page 155 SOURce n CHANnel m WAVelength CW l FIXED Sets the absolute wavelength of a source page 155 CW l FIXED l Returns the absolute wavelength of a source page 156 FREQuen...

Page 39: ...mmands 2 ZERO AUTO Forces an auto lamda zero This is quicker than the equilavent manual process page 162 SOURce n CHANnel m WAVelength REFerence DISPlay Sets the reference wavelength of a source to th...

Page 40: ...MODE Sets or returns the sweep mode page 171 PMAX Returns the highest permissible power for a wavelength sweep page 171 REPeat Sets or returns the repeat mode page 173 SOFTtrigger Sends a soft trigge...

Page 41: ...f the 8166A B Lightwave Multichannel System page 58 STATusn OPERation EVENt Returns the Operational Slot Status Event Register for slot n page 59 CONDition Returns the Operational Slot Status Conditio...

Page 42: ...B address page 71 ETHernet MACaddress Get the MAC address of the network adapter page 72 ETHernet IPADdress CURRent Get the current IP address of the instrument page 72 ETHernet SMASk CURRent Get the...

Page 43: ...gger connector to be triggered using a Foot Pedal or returns whether the Input Trigger connector can be triggered using a Foot Pedal page 215 TRIGger n CHANnel m INPut Sets or returns the incoming tri...

Page 44: ......

Page 45: ...The SYSTem Subsystem 68 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...

Page 46: ...ing Guide 3 Instrument Setup and Status IEEE Common Commands Common Commands on page 20 gave a brief introduction to the IEEE common commands which can be used with the instruments This section gives...

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

Page 48: ...ster parameters none response The bit value for the register a 16 bit signed integer value example ESE 21 END command ESR syntax ESR description The standard Event Status Register query ESR returns th...

Page 49: ...8163A B 8164A B 8166A B Mainframes Programming Guide 49 Instrument Setup and Status 3 1 Not used 0 0 LSB Operation Complete 1 example ESR 21 END...

Page 50: ...nformation on module identity strings and SLOT n HEAD n IDN on page 82 for information on optical head identity strings command OPC syntax OPC description The instrument parses and executes all progra...

Page 51: ...loop to query until the instrument returns 1 can lead to useful gains in program execution efficiency The following actions cancel the OPC query and put the instrument into Operation Complete Command...

Page 52: ...reset command The following are not changed GPIB interface state Instrument interface address Output queue Service request enable register SRE Standard Event Status Enable Mask SESEM parameters none r...

Page 53: ...nd sending the TST query parameters none response The sum of the results for the individual tests a 32 bit signed integer value where 0 value 4294967296 Bits Mnemonic Decimal Value 31 Selftest failed...

Page 54: ...ommand WAI syntax WAI description The WAIt command prevents the instrument from executing any further commands until the current command has finished executing Some module firmware includes commands t...

Page 55: ...Decimal Value 8163A B 8164A B 8166A B 15 Not used Not used Not used 0 14 Not used Not used Slot 14 Summary 16384 13 Not used Not used Slot 13 Summary 8192 12 Not used Not used Slot 12 Summary 4096 11...

Page 56: ...sed Not used Slot 14 Summary 16384 13 Not used Not used Slot 13 Summary 8192 12 Not used Not used Slot 12 Summary 4096 11 Not used Not used Slot 11 Summary 2048 10 Not used Not used Slot 10 Summary 10...

Page 57: ...default value is 0 response none example stat oper enab 128 command STATus OPERation ENABle LEVel0 syntax STATus OPERation ENABle LEVel0 description Returns the OSESM for the OSESR parameters none res...

Page 58: ...signed integer value where 0 value 32767 Bits Mnemonics Decimal Value 8166A B 15 4 Not used 0 3 Slot 17 Summary 8 2 Slot 16 Summary 4 1 Slot 15 Summary 2 0 Not used 0 example stat oper cond level1 0 E...

Page 59: ...level1 128 END command STATusn OPERation EVENt syntax STATusn OPERation EVENt description Returns the Operational Slot Status Event Register OSSER of slot n parameters none response The results for th...

Page 60: ...gth dependent offset Bit 5 states if the feature is enabled or disabled Bits 6 and 7 are decoded as shown below to say whether the attenuator uses saved interpolated or extrapolated values Type Bit 5...

Page 61: ...EM of slot n parameters none response The bit value for the OSSEM as a 16 bit signed integer value 0 32767 example stat oper enab 128 END command STATus PRESet syntax STATus PRESet description Presets...

Page 62: ...t used Slot 14 Summary 16384 13 Not used Not used Slot 13 Summary 8192 12 Not used Not used Slot 12 Summary 4096 11 Not used Not used Slot 11 Summary 2048 10 Not used Not used Slot 10 Summary 1024 9 N...

Page 63: ...used 0 14 Not used Not used Slot 14 Summary 16384 13 Not used Not used Slot 13 Summary 8192 12 Not used Not used Slot 12 Summary 4096 11 Not used Not used Slot 11 Summary 2048 10 Not used Not used Slo...

Page 64: ...default value is 0 response none example stat ques enab 128 command STATus QUEStionable ENABle LEVel0 syntax STATus QUEStionable ENABle LEVel0 description Returns the QSESM for the event register para...

Page 65: ...0 3 Slot 17 Summary 8 2 Slot 16 Summary 4 1 Slot 15 Summary 2 0 Not used 0 example stat ques cond level1 0 END command STATus QUEStionable ENABle LEVel1 syntax STATus QUEStionable ENABle LEVel1 wsp v...

Page 66: ...slot events a 16 bit signed integer value where 0 value 32767 Bit 11 15 10 9 8 7 6 5 4 3 2 1 0 Mnemonic Not Used Slot n Lambda zeroing has been recommended Slot n Beam Path Protection on shutter off S...

Page 67: ...16 8 4 2 1 Every nth bit is the summary of slot n example stat1 ques cond 0 END command STATusn QUEStionable ENABle syntax STATusn QUEStionable ENABle wsp value description Sets the bits in the Questi...

Page 68: ...e 1999 1 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 16 bit signed integer values exampl...

Page 69: ...function as the Preset hardkey The following are not affected by this command the GPIB interface state the backlight and contrast of the display the interface address the output and error queues the...

Page 70: ...internal time parameters none response The time in the format hour minute second Hours are counted 0 23 16 bit signed integer values example syst time 20 15 30 END command SYSTem VERSion syntax SYSTem...

Page 71: ...ddress 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 COMM...

Page 72: ...Municate ETHernet MACaddress syntax SYSTem COMMunicate ETHernet MACaddress description Get the MAC address of the network adapter parameters none response response string hexadecimal value without a p...

Page 73: ...s curr 255 255 255 0 END command SYSTem COMMunicate ETHernet HOSTname CURRent syntax SYSTem COMMunicate ETHernet HOSTname CURRent description Get the current host name parameters none response string...

Page 74: ...cters example syst comm eth dgat curr 192 168 101 11 END command SYSTem COMMunicate ETHernet DHCP ENABle syntax SYSTem COMMunicate ETHernet DHCP ENABle description Enable or disable DHCP parameters bo...

Page 75: ...an empty host name the host name will be set to its default value response none example syst comm eth host my8163B command SYSTem COMMunicate ETHernet HOSTname syntax SYSTem COMMunicate ETHernet HOST...

Page 76: ...ample syst comm eth ipad 192 132 13 2 END command SYSTem COMMunicate ETHernet DOMainname syntax SYSTem COMMunicate ETHernet DOMainname description Set the domain name used if DHCP is disabled paramete...

Page 77: ...example syst comm eth smas 255 255 255 0 command SYSTem COMMunicate ETHernet SMASk syntax SYSTem COMMunicate ETHernet SMASk description Get the subnet mask parameters none response string example sys...

Page 78: ...at 192 168 101 11 END command SYSTem COMMunicate ETHernet RESTart syntax SYSTem COMMunicate ETHernet RESTart description Restart the system s network interface with the new parameters This command onl...

Page 79: ...ing measurements The commands are split up into the following subsystems Root layer commands that take power measurements configures triggering and return information about the mainframe and it s slot...

Page 80: ...1 head2 empt command LOCK syntax LOCK wsp boolean value description Switches the lock off and on High power lasers cannot be switched on if you switch the lock on High power lasers are switched off im...

Page 81: ...r example Keysight Technologies instrument model number for example 81533B serial number date of firmware revision example slot1 idn HEWLETT PACKARD 81533B 3411G06054 07 Aug 98 END Depending on the da...

Page 82: ...dent of module type command SLOT n HEAD n EMPTy syntax SLOT n HEAD n EMPTy description Queries whether an optical head is connected parameters none response A boolean value 0 there is a module in the...

Page 83: ...on module identity strings command SLOT n HEAD m OPTions syntax SLOT n HEAD m OPTions description Returns information about an optical head s options parameters none response A string example slot1 h...

Page 84: ...ibrated module in binary format response Wavelength Response table as a binary block response format One 8 byte long wavelength calibration value pair consisting of a 4 byte long float for wavelength...

Page 85: ...ngth and response factor n ASCII code 10 separate value pairs example slot1 head1 wav resp csv 1200e 6 2 019 n 1210e 6 1 956 n affects Attenuator with power control all powermeters return loss modules...

Page 86: ...nel In these cases you may only set parameters for the slave channel by setting master channel parameters The commands listed in Table 6 can only be configured using the master channel Table 5 Command...

Page 87: ...e n CHANnel m CONFig ROUTe page 207 SENSe n CHANnel m CORRection LOSS INPut MAGNitude page 94 SENSe n CHANnel m CORRection COLLect ZERO page 95 SENSe n CHANnel m CORRection COLLect ZERO ALL page 95 SE...

Page 88: ...lue 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 END affects All power meters return loss modul...

Page 89: ...value if there is no subsequent software trigger parameters none response The current value as a float value in W or dBm example fetc1 mon 6 73370400E 00 END affects All return loss modules command IN...

Page 90: ...B 8166A B Mainframes Programming Guide 4 Measurement Operations Settings example init2 cont 1 affects All power meters return loss modules dual sensors Can only be sent to master channel slave channel...

Page 91: ...CHANnel m POWer DC ALL description Reads all available power meter channels It provides its own software triggering and does not need a triggering command The power meters must be running for this co...

Page 92: ...ects All power meters v3 0x firmware or later dual sensors command READ n CHANnel m SCALar POWer DC syntax READ n CHANnel m SCALar POWer DC description Reads the current power meter value or for a ret...

Page 93: ...iate n CHANnel m IMMediate on page 89 and then reading the power meter value The return loss module must be running for this command to be effective parameters none response The current power meter re...

Page 94: ...lave channels are independent command SENSe n CHANnel m CORRection LOSS INPut MAGNitude syntax SENSe n CHANnel m CORRection LOSS INPUT MAGNitude description Returns the calibration factor for a module...

Page 95: ...ber zero succeeded without errors zero not done zero failed zero absorbed remote zeroing failed the number is the error code returned from the operation example sens1 corr coll zero 0 END affects All...

Page 96: ...e logging function sets some parameters including hidden parameters for the stability and MinMax functions and vice versa You must use the SENSe n CHANnel m FUNCtion PARameter LOGGing on page 97 comma...

Page 97: ...mand seconds are used as the default See SENSe n CHANnel m FUNCtion STATe on page 104 for information on starting stopping a data acquisition function See SENSe n CHANnel m FUNCtion RESult on page 100...

Page 98: ...ode and the number of data points for the MinMax data acquisition function parameters CONTinous WINDow REFResh continuous MinMax mode window MinMax mode refresh MinMax mode Data Points is the number o...

Page 99: ...ameters including hidden parameters for the logging and MinMax functions and vice versa You must use the SENSe n CHANnel m FUNCtion PARameter STABility on page 99 command to set parameters before you...

Page 100: ...ter channel slave channel is also affected command SENSe n CHANnel m FUNCtion PARameter STABility syntax SENSe n CHANnel m FUNCtion PARameter STABility description Returns the total time period time a...

Page 101: ...nctions the data array contains power values For the MinMax Data Acquisition function the data array contains return loss values command SENSe n CHANnel m FUNCtion RESult BLOCk syntax SENSe n CHANnel...

Page 102: ...ock size for a single GPIB transfer for power meter data acquisition functions If your application requires more data points please use SENSe n CHANnel m FUNCtion RESult BLOCk instead of SENSe n CHANn...

Page 103: ...rmation on logging using VISA calls There are some tips about how to use float format specifiers to convert the binary blocks into float values If you use LabView or Keysight VEE we recommend using th...

Page 104: ...LOGGing on page 97 for more information on the logging data acquisition function Stop any function before you try to set up a new function Some parameters cannot be set until you stop the function re...

Page 105: ...urn loss modules command SENSe n CHANnel m FUNCtion THReshold syntax SENSe n CHANnel m FUNCtion THReshold description Returns the start mode and the threshold value parameters none response ABOV BEL I...

Page 106: ...and SENSe n CHANnel m POWer RANGe UPPer syntax SENSe n CHANnel m POWer RANGe UPPer wsp value DBM description Sets the power range for the module For a return loss module sets the power range of the re...

Page 107: ...A B 8166A B Mainframes Programming Guide 107 Measurement Operations Settings 4 example sens1 pow rang 20DBM affects All power meters and return loss modules dual sensors Master and slave channels are...

Page 108: ...r UPPer wsp value DBM description Sets the power range for a retun loss module s monitor diode The range changes at 10 dBm intervals The corresponding ranges for linear measurements measurements in Wa...

Page 109: ...ly determined by the instrument Otherwise it must be set by the sensn pow rang command Automatic ranging while other commands are sent to power meters has lead to timing conflicts in some configuratio...

Page 110: ...at value You must append a unit type dB if you use TOMODule or Watts or dBm if you use TOREF The two reference values are completely independent When you change the reference mode using the command SE...

Page 111: ...164A B 8166A B Mainframes Programming Guide 111 Measurement Operations Settings 4 example sens1 pow ref toref 1 00000000E 006 END affects All power meters dual sensors Master and slave channels are in...

Page 112: ...Se n CHANnel m POWer REFerence STATe syntax SENSe n CHANnel m POWer REFerence STATe wsp boolean description Sets the measurement units to relative or absolute units parameters A boolean value 0 or OFF...

Page 113: ...63A B 8164A B 8166A B Mainframes Programming Guide 113 Measurement Operations Settings 4 example sens1 pow ref stat 1 END affects All power meters dual sensors Master and slave channels are independen...

Page 114: ...or the second value If you want to use an absolute reference use TOREF as the first parameter and any integer value as the second parameter response none examples sens1 pow ref stat rat 2 1 sens1 pow...

Page 115: ...POWer UNIT description Inquires the current sensor power unit parameters none response An integer value 0 Current power units are dBm 1 Current power units are Watts example sens1 pow unit 1 END affec...

Page 116: ...inimum programmable value MAX maximum programmable value DEF This is not the preset RST default value but is half the sum of the minimum programmable value and the maximum programmable value response...

Page 117: ...ntax SENSe n CHANnel m RETurnloss CALibration FACTory description For all sources overwrites the current calibration values with the factory set calibration settings See SENSe n CHANnel m RETurnloss C...

Page 118: ...ination reference measurement See SENSe n CHANnel m RETurnloss CORRection REFLectance l on page 121 for information on setting the return loss value of your reference reflector parameters none respons...

Page 119: ...x SENSe n CHANnel m RETurnloss CALibration VALues description Returns the the current calibration values 1 monitor diode reference power 2 return loss diode reference power 3 monitor diode parasitics...

Page 120: ...2 parameters Sets the front panel delta as a float value in dB response none example sens1 ret corr fpd 0 08DB affects All return loss modules command SENSe n CHANnel m RETurnloss CORRection FPDelta...

Page 121: ...meters Sets the Return Loss Reference as a float value in dB response none example sens1 ret corr refl 0 18DB affects All return loss modules command SENSe n CHANnel m RETurnloss CORRection REFLectanc...

Page 122: ...ble laser modules with BNC ouput connector except 81602A 81606A 81607A 81608A 81609A command OUTPut n CHANnel m CONNection syntax OUTPut n CHANnel m CONNection description Returns the analog output pa...

Page 123: ...t is Regulated example output0 path HIGH END affects Tunable laser modules with two outputs command OUTPut n CHANnel m STATe syntax OUTPut n CHANnel m STATe wsp OFF ON 0 1 description Switches the las...

Page 124: ...ency of the amplitude modulation of the laser output parameters The frequency as a float value in Hz Also allowed are MIN minimum programmable value MAX maximum programmable value DEF This is not the...

Page 125: ...lf the sum of the minimum modulation frequency and the maximum modulation frequency Use l to query the modulation frequency of the upper or lower wavelength laser source of a dual wavelength laser sou...

Page 126: ...ength source The upper wavelength source is denoted by 2 response none example sour2 am sour int affects Internal digital modulation is available with fixed wavelength laser sources Fabry Perot DFB la...

Page 127: ...per or lower wavelength laser source of a dual wavelength laser source or a return loss module with an internal dual wavelength laser source The default value of l is 1 the lower wavelength source The...

Page 128: ...rl COHLevel l syntax SOURce n CHANnel m AM COHCtrl COHLevel l wsp value MIN MAX DEF description Sets the level of coherence when using coherence control on an arbitrary scale from 1 to 99 98 A 100 coh...

Page 129: ...tput Currently only parameter strings that select SBS Control are valid Enable frequency modulation before issuing this command Refer to SOURce n CHANnel m FM STATe l on page 130 parameters 0 SBSCtrl...

Page 130: ...ON or 1 enable frequency modulation response none example sour2 fm state 1 affects Keysight 81960A 81980A 81940A 81989A 81949A compact tunable lasers command SOURce n CHANnel m FM STATe l syntax SOURc...

Page 131: ...reset RST value response none example sour2 fm sbsc freq 4000Hz affects Keysight 81960A 81980A 81940A 81989A 81949A compact tunable lasers command SOURce n CHANnel m FM SBSCtrl FREQuency l syntax SOUR...

Page 132: ...tunable lasers command SOURce n CHANnel m FM SBSCtrl Level l syntax SOURce n CHANnel m FM SBSCtrl LEVel l wsp MIN MAX DEF description Queries the currently set excursion level of the SBS Control frequ...

Page 133: ...um programmable value MAX maximum programmable value DEF default value response None example sour1 freq 188THz affects 81950A Notes Only available in Auto Mode command SOURce n CHANnel m FREQuency syn...

Page 134: ...value MAX maximum programmable value DEF default value response None example sour1 freq ref 193 1THz affects 81950A Notes Only available in Grid Mode command SOURce n CHANnel m FREQuency REFerence syn...

Page 135: ...ammable value MAX maximum programmable value DEF default value response None example sour1 freq grid 50e9 affects 81950A Notes Only available in Grid Mode command SOURce n CHANnel m FREQuency GRID syn...

Page 136: ...r1 freq chan 20 affects 81950A Notes Only available in Grid Mode The minimum maximum and default value depend on the current reference frequency and grid spacing values command SOURce n CHANnel m FREQ...

Page 137: ...value MAX maximum programmable value DEF default value response None example sour1 freq offs 0 1e9 affects 81950A Notes Only available in Grid Mode command SOURce n CHANnel m FREQuency OFFSet syntax...

Page 138: ...ponse None example sour4 freq togr 188 5thz affects 81950A Notes Only available in Grid Mode The frequency offset is neither changed nor taken into account when calculating the nearest channel command...

Page 139: ...81950A Notes This query is equivalent to SOURce n CHANnel m WAVelength AUTO command SOURce n CHANnel m MODout syntax SOURce n CHANnel m MODout wsp FRQ FRQRDY 0 1 description Sets the modulation output...

Page 140: ...this case the output is kept low when no optical signal is output for example while the laser is settling after a change of wavelength example sour0 mod 0 END affects All tunable laser sources with BN...

Page 141: ...modu int 0 affects 81950A Notes command SOURce n CHANnel m MODUlation INTernal SBSControl LEVel syntax SOURce n CHANnel m MODUlation INTernal SBSControl LEVel wsp value HZ KHZ MHZ GHZ THZ MIN MAX DEF...

Page 142: ...m programmable value MAX maximum programmable value DEF default value response The current modulation frequency value or the minimum maximum or default modulation frequency value in Hz example sour1 m...

Page 143: ...se 0 1 on off example sour1 modu ext 1 affects 81950A only Notes command SOURce n CHANnel m MODUlation EXTernal AM LEVel syntax SOURce n CHANnel m MODUlation EXTernal AM LEVel wsp value MIN MAX DEF de...

Page 144: ...ODUlation EXTernal AM LEVel wsp MIN MAX DEF description Returns the amplitude modulation level in parameters Optional MIN minimum programmable value MAX maximum programmable value DEF default value re...

Page 145: ...and the laser output power see SOURce n CHANnel m POWer LEVel IMMediate AMPLitude l on page 148 In this respect this command does not conform to the SCPI standard The SCPI standard requires that enter...

Page 146: ...al Attenuation Mode In Automatic Attenuation Mode you specify the output power In Manual Attenuation Mode you must specify both the laser output power and the attenuation level parameters OFF or 0 ON...

Page 147: ...s the attenuator to dark position Dark position blocks all light from the laser You can use this as an alternative to disabling the laser the advantage of doing this is that you avoid the laser rise t...

Page 148: ...culate the output power see SOURce n CHANnel m POWer ATTenuation l on page 145 The values for the output power that you set in the Power Mode and the laser output power that you set in the Attenuation...

Page 149: ...late the output power see SOURce n CHANnel m POWer ATTenuation l on page 145 The values for the output power that you set in the Power Mode and the laser output power that you set in the Attenuation M...

Page 150: ...is 10ns affects Fixed wavelength laser sources Fabry Perot DFB lasers return loss modules containing an internal source and tunable lasers except 81602A 81606A 81607A 81608A and 81609A command SOURce...

Page 151: ...x SOURce n CHANnel m POWer STATe description Queries the laser state of the chosen source parameters none response A boolean value 0 Laser Off 1 Laser On example sour2 pow stat 1 END affects All laser...

Page 152: ...UPPer or 2 BOTH or 3 External The lower wavelength source The upper wavelength source Both wavelength sources response none example sour2 pow wav upp affects All dual wavelength laser source modules a...

Page 153: ...ANnel m READout DATA BLOCk wsp LLOGging PMAX offset of data points description Returns a specified binary block from either a lambda logging operation or maximum power at wavelength characteristic par...

Page 154: ...mming Guide 4 Measurement Operations Settings parameters none response The maximum number of data points not bytes in the transferred block as an integer value example sour0 read data maxb 120 END aff...

Page 155: ...FIXED l syntax SOURce n CHANnel m WAVelength CW l FIXED l wsp value PM NM UM MM M description Sets the absolute wavelength of the output parameters Any wavelength in the specified range see the speci...

Page 156: ...elength as a float value in meters example sour0 wav 1 5672030E 006 END sour0 wav min 1 5500000E 006 END sour2 wav fixed2 1 61544494E 006 END Returns the current wavelength value for a tunable laser m...

Page 157: ...Mode Auto Mode off ON or 1 Auto Mode response none example sour1 wav auto on affects 81950A Notes This command is equivalent to SOURce n CHANnel m FREQuency AUTO command SOURce n CHANnel m WAVelength...

Page 158: ...ns Settings command SOURce n CHANnel m WAVelength CORRection ARA syntax SOURce n CHANnel m WAVelength CORRection ARA description Realigns the laser cavity parameters none response none example sour0 w...

Page 159: ...uption from the auto lambda zeroing or settling When Auto Calibration is disabled it is possible to operate the TLS at a temperature that differs more than 4 4 K from the last Lambda Zeroing temperatu...

Page 160: ...Measurement Operations Settings response 0 Autocalibration disabled 1 Autocalibration enabled example sour0 wav corr aut 1 affects All tunable laser modules except 81649A 81689A B and 81980A 81940A 8...

Page 161: ...elength CORRection ZERO ALL description Executes a wavelength zero on every tunable laser source in a mainframe parameters none response none example sour2 wav corr zero all affects All tunable laser...

Page 162: ...ro syntax SOURce n CHANnel m WAVelength CORRection ZERO TEMPerature LASTzero description Reports the temperature at which the last auto lamda zero took place parameters none response float value tempe...

Page 163: ...urce or a return loss module with an internal dual wavelength laser source The default value of l is 1 the lower wavelength source The upper wavelength source is denoted by 2 parameters The frequency...

Page 164: ...The wavelength as a float value in meters example sour2 wav ref 1 5500000E 006 END affects All tunable laser and DFB modules command SOURce n CHANnel m WAVelength REFerence DISPlay syntax SOURce n CHA...

Page 165: ...al time of the sweep is too large 371 triggerFreq max the trigger frequency calculated from sweep speed divided by sweep step is too large 372 step min step size too small 373 triggerNum max the numbe...

Page 166: ...the minimum programmable value and the maximum programmable value 0 cycles continuously response none example wav swe cycl 3 affects All tunable laser modules except 81950A command SOURce n CHANnel m...

Page 167: ...preset RST default value but is half the sum of the minimum programmable value and the maximum programmable value response none example wav swe dwel 500ms affects All tunable laser modules except 819...

Page 168: ...iggers this number is required to configure a triggering data acquisition function on a power meter The number returned by this function can be used to configure a Power Meter for coordinated measurem...

Page 169: ...able an odd number when waiting for a trigger an even number when logging data may be read If the trigger input isn t configured to start a sweep cycle the flag is increased by two when the logging da...

Page 170: ...be returned and Lambda Logging will automatically be turned off Lambda logging is disabled at the end of a sweep Generally a continuous sweep can only be started if the trigger frequency derived from...

Page 171: ...ommand SOURce n CHANnel m WAVelength SWEep MODE syntax SOURce n CHANnel m WAVelength SWEep MODE description Returns the sweep mode parameters none response STEP MAN CONT Stepped sweep mode Manual swee...

Page 172: ...ramming Guide 4 Measurement Operations Settings response The highest permissible power for the selected wavelength sweep as a float value example wav swe pmax 1540nm 1550nm 3 5500000E 004 END affects...

Page 173: ...using SOURce n CHANnel m WAVelength SWEep STARt on page 175 and SOURce n CHANnel m WAVelength SWEep STOP on page 176 respectively response none example wav swe rep twow affects All tunable laser modul...

Page 174: ...e response none example sour0 wav sweep soft affects All tunable laser modules except 81649A Keysight 81689A B 81949A 81989 and 81950A command SOURce n CHANnel m WAVelength SWEep SPEed syntax SOURce n...

Page 175: ...weep starts as a float value If you specify no units in your command meters are used as the default response none example wav swe star 1500nm affects All tunable laser modules except 81950A command SO...

Page 176: ...dules except 81950A command SOURce n CHANnel m WAVelength SWEep STOP syntax SOURce n CHANnel m WAVelength SWEep STOP wsp MIN MAX description Returns the end point of the sweep parameters optional MIN...

Page 177: ...nel m AM STATe l on page 127 simultaneously a sweep cannot be started Generally a continuous sweep can only be started if the trigger frequency derived from the sweep speed and sweep step is 40kHz or...

Page 178: ...WAVelength SWEep STEP NEXT syntax SOURce n CHANnel m WAVelength SWEep STEP NEXT description Performs the next sweep step in stepped sweep if it is paused or in manual sweep parameters none response n...

Page 179: ...h syntax SOURce n CHANnel m WAVelength SWEep STEP WIDTh wsp MIN MAX description Returns the width of the sweep step parameters optional MIN Returns the minimum step width available MAX Returns the max...

Page 180: ...ANsmitter OPOint laser 1 2 syntax SOURce SlotNr TRANsmitter OPOint laser 1 2 data description Sets the operating point for one of the reference transmitter s two laser diodes You can also set the mini...

Page 181: ...e check status of the transmitter reference module parameters none response A value ranging from 0 0 recalibration necessary to 1 0 Values near 1 0 indicate the current temperature is close to the tem...

Page 182: ...lter new dB a Offset dB Set the attenuation factor by sending a value the default units are dB or by sending MIN DEF or MAX parameters value dB MIN DEF MAX The attenuation in dB The values where a fil...

Page 183: ...parameters value dB MIN DEF MAX The offset factor a Offset in dB Sets the minimum value for a Offset 200dB Sets the default value for a Offset 0dB Sets the maximum value for a Offset 200dB response no...

Page 184: ...al powermeter response none example INP1 OFFS POW 4 2 affects Attenuator modules with power control command INPut n CHANnel m ATTenuation SPEed syntax INPut n CHANnel m ATTenuation SPEed wsp value MIN...

Page 185: ...in meters if you do not specify a unit Sets the wavelength to the module limits or the module default response none example INP1 WAV 1 55000000E 006 affects All attenuator modules command INPut n CHA...

Page 186: ...186 8163A B 8164A B 8166A B Mainframes Programming Guide 4 Measurement Operations Settings parameters OFF or 0 ON or 1 response none example OUTP1 APMode OFF affects All attenuator modules...

Page 187: ...ed from the reference power Pref Pset new dBm Pref dBm a filter new dB P Offset dB If your attenuator module includes the power control feature the filter attenuation is changed until the set power me...

Page 188: ...B 8164A B 8166A B Mainframes Programming Guide 4 Measurement Operations Settings response 4 byte Intel floating point output power in current power unit example OUTP1 POW 12 END affects All attenuato...

Page 189: ...t power control command OUTPutn CHANnel m POWer REFerence syntax OUTPutn CHANnel m POWer REFerence wsp MIN MAX DEF description Without the optional parameter queries the reference power value paramete...

Page 190: ...command OUTPutn CHANnel m POWer OFFSet syntax OUTPutn CHANnel m POWer OFFSet wsp MIN MAX DEF description Without the optional parameter queries the power offset value parameters MIN MAX REF Queries th...

Page 191: ...o input power parameters OFF or 0 ON or 1 Output power follows changes to input power The filter position automatically adjusts to compensate for changes to input power so maintaining the output power...

Page 192: ...yntax OUTPutn CHANnel m POWer UNit wsp DBM 0 WATT 1 description Sets whether the power unit used is dBm or Watts This setting affects Pset Pref if available and Pact parameters DBM or 0 WATT or 1 Sets...

Page 193: ...STATe wsp OFF 0 ON 1 description Sets the state of the shutter parameters OFF or 0 ON or 1 Shutter closed Shutter open response none example OUTP1 STAT OFF affects All attenuator modules and 81950A c...

Page 194: ...mainframe power on 1 The shutter is closed after mainframe power on example OUTP1 APOW 0 END affects All attenuator modules command OUTPutn CHANnel m ATIMe syntax OUTPutn CHANnel m ATIMe wsp value NS...

Page 195: ...odules with power control command OUTPutn CHANnel m CORRection COLLection ZERO ALL syntax OUTPutn CHANnel m CORRection COLLection ZERO ALL description Zero all available powermeter channels in the mai...

Page 196: ...tored offset is added to the global power offset If the attenuator module is set to a wavelength between entries in its offset table linear interpolation is used to calculate the appropriate offset to...

Page 197: ...ntal temperature and optical wavelength compensation which remain active parameters OFF or 0 ON or 1 The offset table is not used to compensate for wavelength dependent losses The attenuator adds the...

Page 198: ...sured by an external powermeter hosted in the same mainframe and the power measured by the attenuator module s integrated powermeter and stores it as the offset P Offset dB P att dBm P ext dBm See CON...

Page 199: ...ries a wavelength value from its position or index in the offset table Offset table entries are ordered from shortest to longest wavelength The first index number 1 parameters index The position of th...

Page 200: ...response char in SCPI block format Intel byte order wavelength offset example CONF1 OFFS WAV VAL PAIR 1 1 55000000E 006 2 affects All attenuator modules command CONFigure n CHANnel m OFFSet WAVelengt...

Page 201: ...cription Queries the complete the offset table parameters none response SCPI binary block format format Intel byte order wavelength offset pairs in ascending order Each value pair is transferred as 12...

Page 202: ...le to host a number of modules so a slot identifier is needed This slot identifier was not required by the 8156A attenuator Simply substitute INPutn for INPut and OUTPutn for OUTPut where n is the slo...

Page 203: ...supports new commands to access its new features To support these new features and improve the usability of the instrument the meaning the semantic of some existing commands has changed This section...

Page 204: ...P set dBm P ref dBm dB The 81566A and 81567A attenuator modules do not need a base power level because they are able to measure the output power directly Despite these new features the 8156x modular...

Page 205: ...n PTRansition STATus OPERation NTRansition STATus QUEStionable PTRansition STATus QUEStionable NTRansition There are new status bits available to query the current modular attenuator state User Calibr...

Page 206: ...the route between left and right ports channel_list format A Z 1 n response If an invalid route is selected the following error message is returned StatParamError example rout3 chan1 A 2 module in sl...

Page 207: ...ber on the right m is the maximum port number on the right example rout2 conf A B 1 2 2 left and 2 right ports affects All switch modules command ROUTe n CHANnel m CONFig ROUTe syntax ROUTe n CHANnel...

Page 208: ...performs power measurements until the function is finished SMEasure ON Every hardware trigger starts a new power measurement Every hardware trigger starts a new power measurement until the function is...

Page 209: ...r hardware output trigger cannot be generated until you send trig outp rearm An output trigger is generated for every new power measurement when the averaging time period finishes Applies for all subs...

Page 210: ...eep cycle You must prearm a wavelength sweep or a measurement function before an action can be triggered First set the incoming trigger response Then prearm a wavelength sweep using SOURce n CHANnel m...

Page 211: ...a stepped sweep Start a sweep example trig1 inp ign END affects All tunable laser modules except 81950A power meters and return loss modules and attenuators with power control dual sensors Can only be...

Page 212: ...rs Can only be sent to master channel slave channel parameters are identical command TRIGger n CHANnel m OFFSet syntax TRIGger n CHANnel m OFFSet value description Sets the number of incoming triggers...

Page 213: ...s modules dual sensors Can only be sent to master channel slave channel is also affected In continuous mode wav swe step widt is used for triggering see SOURce n CHANnel m WAVelength SWEep STEP WIDTh...

Page 214: ...response none example trig1 outp rearm 1 affects All power meters and return loss modules dual sensors Can only be sent to master channel slave channel is also affected command TRIGger n CHANnel m OU...

Page 215: ...escription Returns the hardware trigger configuration parameters none response DIS DEF PASS LOOP CUSTOM Trigger connectors are disabled The Input Trigger Connector is activated the incoming trigger re...

Page 216: ...isabled default ON or 1 foot pedal enabled response none example trig conf DEF END command TRIGger CONF FPEDal syntax TRIGger CONF FPEDal description Returns whether the Input Trigger connector can be...

Page 217: ...meters 1 or NODEA 2 or NODEB Generates trigger at Node A Generates trigger at Node B Use TRIGger CONF EXTended on page 217 to configure Node A and Node B TRIGger on page 209 describes the TRIGger comm...

Page 218: ...ment Operations Settings parameters none response Node A Input Configuration Node B Input Configuration Output Matrix Configuration A 32 bit signed integer see below A 32 bit signed integer see below...

Page 219: ...nector Node A Configuration AND OR Output Matrix 0 0 0 0 0 Configuration Connector 0 0 0 0 0 0 0 0 Bits set in Node A B Input Configuration determine the conditions that can cause a trigger at Bits se...

Page 220: ...n CHANnel m OUTPut on page 213 explains how slot events can generate triggers Hexadecimal H80000000 H40000000 H20000000 0 H20000 H10000 H4 H2 H1 Node B Input Configuration This 32 bit unsigned intege...

Page 221: ...signed integer lets you choose Node A OR Node B to trigger each of the following the Output Trigger Connector or individual module slots Bit 31 30 18 29 17 16 2 1 0 Mnemonic Not used Output Trigger Co...

Page 222: ...ered 1 sour2 wav swe star arms the sweep for for the tunable laser module in slot 2 Because trig2 inp next is set the module waits for a trigger until it performs the first step of the sweep 2 sour1 w...

Page 223: ...ainframes Programming Guide 5 Mass Storage Display and Print Functions Display Operations The DISPlay Subsystem 224 This chapter gives descriptions of commands that you can use when you want to change...

Page 224: ...ay CONTrast wsp value description Controls the contrast of the display parameters An integer value in the range 0 to 100 response none example disp cont 50 affects 8163B Lightwave Multimeter and 8166B...

Page 225: ...163B Lightwave Multimeter and 8166B Lightwave Multichannel System 8164A Lightwave Measurement System only checks if the value equals 0 0 display off other values display on command DISPlay BRIGhtness...

Page 226: ...ep performance parameters A boolean value OFF or boolean 0 switch off the display ON or boolean 1 switch on the display If you press LOCAL softkey the display is enabled automatically response none ex...

Page 227: ...boolean 0 local operation is disabled ON or boolean 1 local operation is enabled response none example disp lock 1 END command DISPlay LOCKout syntax DISPlay LOCKout description Queries whether local...

Page 228: ......

Page 229: ...application is a console application Make sure the header files visa h and visatype h are included Make sure the library path includes visa32 lib Ensure that the PATH environment variable allows load...

Page 230: ...rrect void checkError ViSession session ViStatus err_status ViStatus error ViChar errMsg 256 queries what kind of error occurred error viQueryf session s n t SYST ERR errMsg if this command times out...

Page 231: ...l commands except for zeroing or READ commands with averaging times greater than the timeout errStatus viSetAttribute vi VI_ATTR_TMO_VALUE 20000 checkError vi errStatus get the identification string o...

Page 232: ...tus err_status void main void ViStatus errStatus returned error code from visa call ViSession defaultRM default visa resource manager variable ViSession vi current session handle ViChar c used in the...

Page 233: ...aximum power the attenuation must be set to zero errStatus viPrintf vi SOURCE2 CHAN1 ATT 0 n if errStatus VI_SUCCESS checkError vi errStatus turn off amplitude modulation errStatus viPrintf vi SOURCE2...

Page 234: ...234 8163A B 8164A B 8166A B Mainframes Programming Guide 6 VISA Programming Examples exit 1 else only errors should be displayed if errMsg 0 printf error ld s n err_status errMsg...

Page 235: ...ion ViStatus err_status void main void ViStatus errStatus returned error code from visa call ViSession defaultRM default visa resource manager variable ViSession vi current session handle ViChar reply...

Page 236: ...SUCCESS checkError vi errStatus change the power unit to watt errStatus viPrintf vi SENS1 CHAN1 POW UNIT W n if errStatus VI_SUCCESS checkError vi errStatus set the averaging time for measuring to 0 5...

Page 237: ...compare them and display the result for i 0 i 10 i In comparision to the FETCH command the READ command implies triggering a measurement Make sure the timeout set is greater than the adjusted averagin...

Page 238: ...gramming Guide 6 VISA Programming Examples ViChar errMsg 256 error viQueryf session SYST ERR n t errMsg if error VI_ERROR_TMO printf System Error n exit 1 else only errors should be displayed if errMs...

Page 239: ...r a simple error handling explained in example 1 void checkError ViSession session ViStatus err_status void main void ViStatus errStatus returned error code from visa call ViSession defaultRM default...

Page 240: ...E2 CHAN1 WAV n s replyBuf checkError vi errStatus feed the source wavelength into the power meter making sure to measure the maximum power of the source errStatus viPrintf vi SENS1 CHAN1 POW WAV s n r...

Page 241: ...eryf vi OPC n d cmdDone checkError vi errStatus while cmdDone set the power meter reference to the displayed value display to reference errStatus viPrintf vi SENS1 CHAN1 POW REF DISP n checkError vi e...

Page 242: ...vi SOURCE2 CHAN1 POW ATT 6 0 n checkError vi errStatus loop until a key is pressed while scanf c c turn the laser off errStatus viPrintf vi SOURCE2 CHAN1 POW STATE 0 n if errStatus VI_SUCCESS checkEr...

Page 243: ...8163A B 8164A B 8166A B Mainframes Programming Guide 243 VISA Programming Examples 6 if errMsg 0 printf error ld s n err_status errMsg...

Page 244: ...xplained in example 1 void checkError ViSession session ViStatus err_status void main void ViStatus errStatus returned error code from visa call ViSession defaultRM default visa resource manager varia...

Page 245: ...the minimum wavelength from the tunable laser source errStatus viQueryf vi SOURCE2 WAV MIN n s replyBuf checkError vi errStatus save this wavelength wavelength atof replyBuf set the minimum wavelength...

Page 246: ...lyBuf checkError vi errStatus turn auto range on errStatus viPrintf vi SENS1 CHAN1 POW RANGE AUTO 1 n checkError vi errStatus set the averaging time for measuring to 20ms errStatus viPrintf vi SENS1 C...

Page 247: ...ment for completion of this command because adjusting a new wavelength takes some time do errStatus viQueryf vi OPC n d cmdDone checkError vi errStatus while cmdDone loop until a key is pressed while...

Page 248: ...248 8163A B 8164A B 8166A B Mainframes Programming Guide 6 VISA Programming Examples only errors should be displayed if errMsg 0 printf error ld s n err_status errMsg...

Page 249: ...s function for a simple error handling explained in example 1 void checkError ViStatus session ViStatus err_status initialize the visa interface ViStatus InitVisa ViSession iHandle globals static unsi...

Page 250: ...errStatus clear instrument error queue errStatus viPrintf vi CLS n checkError vi errStatus turn auto range on errStatus viPrintf vi SENS1 CHAN1 POW RANGE AUTO 1 n checkError vi errStatus send the comm...

Page 251: ...continue polling The instrument returns the logging result in the following format xyyyffff the first digits after the hash denotes the number of ascii digits following y y specifies the number of bin...

Page 252: ...you may also use e or f for i 0 i noOfValues i printf t g n logResults i loop until a key is pressed while scanf c c close the session viClose vi void checkError ViStatus session ViStatus err_status...

Page 253: ...nitVisa ViSession iHandle ViStatus errStatus returned error code from visa call ViSession defaultRM default visa resource manager variable First get initialized the visa library see example 1 errStatu...

Page 254: ......

Page 255: ...y Structure 264 Opening an Instrument Session 265 Closing an Instrument Session 266 VISA Data Types and Selected Constant Definitions 267 Error Handling 268 Introduction to Programming 270 Online Info...

Page 256: ...o The archive can be downloaded and installed using the N7700A Package Manager or downloaded directly from the Keysight website or CD Note that VISA should first be installed on the PC for example usi...

Page 257: ...ams in Keysight VEE you connect graphical objects instead of writing lines of code These programs resemble easy to understand block diagrams with lines Keysight VEE allows you to leverage your investm...

Page 258: ...8 Figure 9 Device Configuration 3 Enter the following information Name enter hp816X Interface GPIB Address Enter the GPIB address of your GPIB interface board the default is 7 Append the GPIB address...

Page 259: ...r the Parameters to the init call by entering GPIB xx INSTR where xx is your instrument s GPIB address 7 Select whether to Perform Reset or to Perform Identification Query whenever Keysight VEE opens...

Page 260: ...abVIEW supports use of the VXI Plug Play style drivers with wrapper files that can be generated for the corresponding driver and LabVIEW versions with the Instrument Driver Import Wizard utility avail...

Page 261: ...ogramming Guide 261 The Keysight 816x VXIplug play Instrument Driver 7 NOTE You must use the 32 bit version of Labview with the Keysight 816x VXIplug play Instrument Driver NOTE LabView is a trademark...

Page 262: ...and Windows NT To access the functions of the Keysight 816x VXIplug play Instrument Driver from within LabWindows select INSTRUMENT from the main menu and then select the LOAD submenu item In the file...

Page 263: ...rd for which the manufacturer has provided a VISA DLL The Keysight 816x VXIplug play Instrument Driver includes a Function Panel fp file The fp file allows the driver to be used with visual programmin...

Page 264: ...ument driver usually uses the directory C Program Files x86 IVI Foundation which is used by the VISA installation The structures for the IVI Foundation subdirectory tree are shown in Figure 12 on page...

Page 265: ...e parameters of the function hp816x_init include ViRsrc InstrDesc the address of the instrument ViBoolean id_query a Boolean flag which indicates if in system verification should be performed Passing...

Page 266: ...hp816x_init function are closed with the function hp816x_close ViSession instrumentHandle When no further communication with an instrument is required the session must be explicitly closed hp816x_clo...

Page 267: ...s VISA data types are identified by the Vi prefix in the data type name for example ViInt16 ViUInt16 ViChar The file visatype h contains a complete listing of the VISA data types function call casts a...

Page 268: ...indicate the operation succeeded but special conditions exist 2 Enable automatic instrument error checking following each function call hp816x_errorQueryDetect instrumentHandle VI_TRUE When enabled t...

Page 269: ...ED defined in hp816x h if hp816x_INSTR_ERROR_DETECTED errStatus query the instrument for the error hp816x_error_query instrumentHandle inst_err err_mes sage display the error printf Instrument Error l...

Page 270: ...GPIB0 22 rather than gpib0 22 Callbacks Callbacks are not supported by this driver Development Environments These sections contains suggestions as to how you can use hp816x_32 dll within various appli...

Page 271: ...ability across different computer platforms a higher level of support for the compiled driver from Keysight Technologies a faster load time for your project LabWindows CVI R will attempt by default to...

Page 272: ...on The latest copy of this driver can be downloaded via www keysight com find octfirmware or using the N7700A Package Manager from www keysight com find n7700 If you do not have web access the 816x dr...

Page 273: ...put trigger connector of the laser mainframe The Multiframe LambdaScan also provides more flexibility in configuring the measurement parameters The N774x series multi port power meters are also suppor...

Page 274: ...ength array and a power array for each power meter channel The disadvantage of using equally spaced datapoints is that the linear interpolation is analogous to the use of a low pass filter Figure 13 o...

Page 275: ...ys for the Execute Lambda Scan hp816x_executeLambdaScan function To obtain a higher precision the Tunable Laser Source is set 1 nm before the Start Wavelength this means you have to choose a Start Wav...

Page 276: ...increase the Step Size The Get Lambda Scan Parameters Function The Get Lambda Scan Parameters hp816x_getLambdaScanParameters_Q function returns all parameters that the Prepare Lambda Scan hp816x_prepa...

Page 277: ...the results will be equally spaced by performing a linear interpolation on the wavelength point and power measurement data see Equally Spaced Datapoints on page 273 for more details This function is u...

Page 278: ...prior to the Initialize function hp816x_init This is especially necessary during program debugging if the Close function hp816x_close is not called The Prepare Multi Frame Lambda Scan Function The Pre...

Page 279: ...r example the HP 81530A Power Sensor and the HP 81520A Optical Head are out of specification at 1550 nm Remove the Power Meter that is out of specification at 1550 nm from the mainframe 2 If the Step...

Page 280: ...operation The Get Number of PWM Channels Function The Get Number of PWM Channels hp816x_getNoOfRegPWMChannnels_Q function returns the number of Power Meter channels in a test setup Only Power Meters...

Page 281: ...l 282 Preset Defaults 282 Removed Command 283 Obsolete Commands 284 Changed Parameter Syntax and Semantics 285 Changed Query Result Values 286 Timing Behavior 287 Error Handling 288 Command Order 288...

Page 282: ...ultimeter 8153 the HP 8167B 8D 8E 8F Tunable Laser Source 8167 8 or both of these instruments Both GPIB Bus Compatibility These commands are incompatible Table 10 Incompatible GPIB Bus Command s Statu...

Page 283: ...command execution 8153 STATus OPERation NTRansition STATus OPERation PTRansition STATus QUEStionable NTRansition STATus QUEStionable PTRansition These status model features are not supported 8153 SYST...

Page 284: ...ew Command Affects DISPlay STATe DISPlay ENABle 8153 PROGram command tree SENSe FUNCtion command tree Some commands from the PROGram command tree have not been replaced The HP 8153A application interf...

Page 285: ...es 8153 DISP BRIG This command now supports integers between 1 and 100 instead of float values between 1 and 0 8153 SENS CORR COLL ZERO This command returns the last zero state instead of the last rem...

Page 286: ...still means passed Both A head adapter is not overwritten with the head when it is inserted 8153 SENS POW UNIT Returns W DBM not a number 8153 SOUR POW WAV Returns LOW UPP BOTH EXT and not the wavele...

Page 287: ...mand execution except when executing functions such as logging and sweep that don t tolerate blocking This is identical to the behavior of the 8167 8 A side effect of this is that OPC always returns 1...

Page 288: ...ble 16 on page 288 and Table 17 on page 288 detail the new errors The error queue is written to as before Table 16 Error Handling Changes Table 17 Specific Errors Command Order It is not yet known if...

Page 289: ...Programming Guide 9 Error Codes GPIB Error Strings 290 This chapter gives information about error codes used with the 8163A B Lightwave Multimeter the 8164A B Lightwave Measurement System and the 816...

Page 290: ...is code indicates only that a Command Error as defined in IEEE 488 2 11 5 1 1 4 has occurred Standard 101 Invalid character A syntactic element contains a character which is invalid for that type for...

Page 291: ...ent too large The magnitude of the exponent was larger than 32000 see IEEE 488 2 7 7 2 4 1 Standard 124 Too many digits The mantissa of a decimal numeric data element contained more than 255 digits ex...

Page 292: ...andard 168 Block data not allowed A legal block data element was encountered but was not allowed by the device at this point in parsing Standard 170 Expression error This error as well as errors 171 t...

Page 293: ...is available the user is not able to reconfigure the logging application parameters First the user must stop the logging application New 201 Please be patient GPIB currently locked out Description Som...

Page 294: ...t mode Old 220 Parameter error StatParmError Description The user has passed a parameter that cannot be changed in this way The device cannot detect one of the following more specific errors Old 220 2...

Page 295: ...d AND Output trigger mode not set to STFinished Step finished Continuous Sweep mode AND Lambda Logging is Enabled AND Modulation Source is not set to OFF Continuous Sweep mode AND Lambda Logging is En...

Page 296: ...average time has not completed its current measurement cycle when the user queries the current power Old 231 Data questionable StatRangeTooLow Description As 231 StatValNYetAcc but for a more specific...

Page 297: ...not previously defined Old 284 Function currently running StatModuleBusy Description This error is generated when a function is currently running on a module so that it cannot process another command...

Page 298: ...Error Internal messaging error StatCmdNotAllowed Internal messaging error StatWrongLength Internal messaging error StatWrongReceiver Internal messaging error StatBufAllocError Internal messaging error...

Page 299: ...table when the offset feature is activated Deactivate first Old 330 Self test failed Description You have started the self test but the module has detected an error while executing it New 340 Printing...

Page 300: ...ery 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 Stan...

Page 301: ...sing Old 260 Expression error Old 280 Program error Old 281 Cannot create program Old 282 Illegal program name Old 283 Illegal variable name Old 285 Program syntax error Old 286 Program runtime error...

Page 302: ......

Page 303: ...89 Input queue 13 Installed options 51 Instrument addresses 270 Instrument Behaviour Settings 68 Instrument driver 263 Instrument driver installation 256 Interface behaviour settings 68 K Keysight VE...

Page 304: ...SLOT subsystem 81 SOURce subsystem 122 SPECial subsystem 85 Start laser 151 measurement 89 power meter measurement 89 Status Byte 52 Status Command Summary 30 Status Information 21 Status Reporting 55...

Page 305: ......

Page 306: ...This information is subject to change without notice Keysight Technologies 2016 Edition 2 0 June 2016 www keysight com...

Search results

Summary of Contents for 8163A/B

Reviews:

Related manuals for 8163A/B

Brands by name

Popular brands

Keysight Technologies 8163A/B, Programming Manual

Search results

Summary of Contents for 8163A/B

Reviews:

Related manuals for 8163A/B

Brands by name

Popular brands