Keysight Technologies 8163A/B Скачать руководство пользователя страница 17

Страница: 17 / 306

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

Introduction to Programming

Data Types

With the commands you give parameters to the instrument and receive

response values from the instrument. Unless explicitly specified these data

are given in ASCII format. The following types of data are used:
•

Boolean

data may only have the values 0 or 1.

•

Integer

range is given for each individual command.

•

Float

variables may be given in decimal or exponential writing (0.123 or

123E-3).

All

Float

values conform to the 32 bit IEEE Standard, that is, all

Float

values are returned as 32-bit real values.

• A

string

is contained between double quotes (

...

) or single quotes

(

‘

...

’

). When the instrument returns a string, it is always included in " "

and terminated by

<END>

• 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>

”, terminated by

<END>

; <

> represents the

number of digits, <

Len>

represents the number of bytes, and <

Block>

the data block. For example, for a

Binary Block

with 1 digit and 6 bytes

this is:

#16TRACES<END>

. The block represents an array of numbers.

Each number has the byte ordering least significant byte first, also

called LSBfirst, little-endian or Intel byte ordering.

NOTE

Some programming environments, like VEE, support reading these binary blocks

directly, including selection of byte ordering. Other convenient ways can be

using the 816x VXI Plug&Play driver, or using the 816x Lightwave Command Set

together with the Keysight Command Expert for generating SCPI code. If the

VISA COM interface is used, then its IFormattedIO488 interface is very

convenient, setting the property InstrumentBigEndian to "false" and using the

READIEEEBlock method.

NOTE

Note that within your program, calculations with wavelengths may require

double-precision 64-bit floats to provide the desired resolution.

Содержание 8163A/B

Страница 1: ...Programming Guide 8163A B Lightwave Multimeter 8164A B Lightwave Measurement System 8166A B Lightwave Multichannel System...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 44: ......

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 228: ......

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 254: ......

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 298: ...Error Internal messaging error StatCmdNotAllowed Internal messaging error StatWrongLength Internal messaging error StatWrongReceiver Internal messaging error StatBufAllocError Internal messaging error...

Страница 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...

Страница 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...

Страница 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...

Страница 302: ......

Страница 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...

Страница 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...

Страница 305: ......

Страница 306: ...This information is subject to change without notice Keysight Technologies 2016 Edition 2 0 June 2016 www keysight com...

Результаты поиска

Содержание 8163A/B

Отзывы:

Похожие инструкции для 8163A/B

Бренды по названию

Популярные бренды

Keysight Technologies 8163A/B, Руководство по программированию

Результаты поиска

Содержание 8163A/B

Отзывы:

Похожие инструкции для 8163A/B

Бренды по названию

Популярные бренды