- DL manuals
- Keithley
- Switch
- 3700 series
- Reference Manual
Keithley 3700 series Reference Manual - page 41
Series 3700 System Switch/Multimeter Reference Manual
Section 2: TSP Programming Fundamentals
Document Number: 3700S-901-01 Rev. A / August 2007
2-21
NOTE A modified user script can be loaded back into the Series 3700 using the same name or a
new name.
The following command returns a catalog listing of the user scripts stored in the Series 3700:
script.user.catalog()
Example: Retrieve the catalog listing for user scripts:
name in script.user.catalog() do
print (name)
end
The following function retrieves a script listing. The script chunk is returned, along with the shell
keywords (loadscript or loadandrunscript, and endscript):
myscript.list()
Where: myscript is the user-defined name of the script.
Example:
Retrieve the listing for a saved script named ―test7‖:
userscriptlist = test7.list()
print (userscriptlist)
Deleting a script from nonvolatile memory
Replacing, changing or deleting a script from the run-time environment does not remove the
script from nonvolatile memory. A script can be permanently removed from nonvolatile memory
using either of the following commands:
script.delete("name")
script.user.delete("name")
Where: name is the user-defined name of the script.
Example:
Delete a user script named ―test8‖ from nonvolatile memory:
script.delete("test8")
Restoring a script in the run-time environment
A script is inherently a global variable and can be replaced by assigning a new value or by
loading a new script with the same name. It can also be removed from the run-time environment
by assigning it the nil value. A script can be restored from nonvolatile memory back into the run-
time environment using either of the following commands:
script.restore("name")
Summary of 3700 series
Page 1
Www.Keithley.Com a g r e a t e r m e a s u r e o f c o n f i d e n c e series 3700 system switch/multimeter reference manual 3700s-901-01 rev. A / august 2007 www.Keithley.Com a g r e a t e r m e a s u r e o f c o n f i d e n c e series 3700 system switch/multimeter reference manual 3700s-901-01 rev...
Page 2: Warranty
A g r e a t e r m e a s u r e o f c o n f i d e n c e keithley instruments, inc. Corporate headquarters • 28775 aurora road • cleveland, ohio 44139 440-248-0400 • fax: 440-248-6168 • 1-888-keithley (1-888-534-8453) • www.Keithley.Com 3/07 warranty keithley instruments, inc. Warrants this product to ...
Page 3
System switch/multimeter reference manual ©2007, keithley instruments, inc. All rights reserved. Cleveland, ohio, u.S.A. Document number: 3700s-901-01 rev. A / august 2007 series 3700
Page 4: Manual Print History
Manual print history the print history shown below lists the printing dates of all revisions and addenda created for this manual. The revision level letter increases alphabetically as the manual undergoes subsequent updates. Addenda, which are released between revisions, contain important change inf...
Page 5: Safety Precautions
Safety precautions 06/07 the following safety precautions should be observed before using this product and any associated instrumentation. Although some instruments and accessories would normally be used with non-hazardous voltages, there are situations where hazardous conditions may be present. Thi...
Page 6
When installing equipment where access to the main power cord is restricted, such as rack mounting, a separate main input power disconnect device must be provided in close proximity to the equipment and within easy reach of the operator. For maximum safety, do not touch the product, test cables, or ...
Page 7: Table Of Contents
Table of contents introduction 1-1 overview ...................................................................................................................... 1-1 measure and switching capabilities ................................................................................. 1-2 warranty inf...
Page 8
Contents series 3700 system switch/multimeter reference manual ii document number: 3700s-901-01 rev. A / august 2007 differences: remote vs. Local state ............................................................................ 2-22 remote state .......................................................
Page 9
Series 3700 system switch/multimeter reference manual contents document number: 3700s-901-01 rev. A / august 2007 iii math ............................................................................................................................ 5-3 mx+b ..............................................
Page 10
Contents series 3700 system switch/multimeter reference manual iv document number: 3700s-901-01 rev. A / august 2007 status model 8-1 status register sets ...................................................................................................... 8-1 negative and positive transition regis...
Page 11
Series 3700 system switch/multimeter reference manual contents document number: 3700s-901-01 rev. A / august 2007 v channel functions and attributes ................................................................................. 9-16 delay function ....................................................
Page 12
Contents series 3700 system switch/multimeter reference manual vi document number: 3700s-901-01 rev. A / august 2007 warmup period ............................................................................................................. 10-2 line power ..............................................
Page 13
Series 3700 system switch/multimeter reference manual contents document number: 3700s-901-01 rev. A / august 2007 vii error codes 13-1 introduction ................................................................................................................ 13-1 error summary .......................
Page 15: List Of Figures
List of figures figure 1-1: dmm measurement capabilities ......................................................................... 1-2 figure 2-1: tsp test script example ..................................................................................... 2-5 figure 2-2: programming model for scrip...
Page 16
List of figures series 3700 system switch/multimeter reference manual x document number: 3700s-901-01 rev. A / august 2007 figure 8-8: 16-bit status register .......................................................................................... 8-8 figure 8-9: status byte and service request (sr...
Page 17: Overview
If you have any questions after reviewing this information, please contact your local keithley instruments representative or call one of our applications engineers at 1-888-keithley (1-888-534-8453). You can also contact us through our website at www.Keithley.Com. In this section: overview ............
Page 18: Warranty Information
Section 1: introduction series 3700 system switch/multimeter reference manual 1-2 document number: 3700s-901-01 rev. A / august 2007 measure and switching capabilities the basic measurement capabilities of series 3700 systems are summarized in the following figure. Figure 1-1: dmm measurement capabi...
Page 19: Safety Symbols And Terms
Series 3700 system switch/multimeter reference manual section 1: introduction document number: 3700s-901-01 rev. A / august 2007 1-3 note if the series 3700 is in remote mode, press the exit keyonce to place the unit in local mode. 1. When in local mode, press the menu key. 2. Scroll to the system-i...
Page 21
Conventional instrumentation responds to command messages sent to the instrument. Each command message contains one or more commands that the instrument executes in order. To conduct a test, a computer controller is programmed to send a sequence of commands to an instrument. The controller orchestra...
Page 22: Run-Time Environment
Section 2: tsp programming fundamentals series 3700 system switch/multimeter reference manual 2-2 document number: 3700s-901-01 rev. A / august 2007 in this manual we will refer to lua as the "test script language" or "tsl." the tsp runs portions of tsl code called "chunks." most messages sent to th...
Page 23: Scripts
Series 3700 system switch/multimeter reference manual section 2: tsp programming fundamentals document number: 3700s-901-01 rev. A / august 2007 2-3 the following chunk is an example that generates an output response message: x = 10 print(x) 1.000000000e+001 note the output (indicated by the ) may v...
Page 24: Programming Overview
Section 2: tsp programming fundamentals series 3700 system switch/multimeter reference manual 2-4 document number: 3700s-901-01 rev. A / august 2007 named script key points: different script names may be created using loadscript. A new script is sent with the same name will overwrite (replace) previ...
Page 25
Series 3700 system switch/multimeter reference manual section 2: tsp programming fundamentals document number: 3700s-901-01 rev. A / august 2007 2-5 format.Asciiprecision = 10 format.Data = format.Ascii scripted chunk in a script environment, the chunk is the entire listing of test programming code....
Page 26
Section 2: tsp programming fundamentals series 3700 system switch/multimeter reference manual 2-6 document number: 3700s-901-01 rev. A / august 2007 run-time environment the run-time environment is a collection of global variables (scripts) the user has created. After scripts are placed into the run...
Page 27
Series 3700 system switch/multimeter reference manual section 2: tsp programming fundamentals document number: 3700s-901-01 rev. A / august 2007 2-7 programming model for scripts user-created scripts can be stored in nonvolatile memory. When the series 3700 is turned on, all user script functions ar...
Page 28: System Connections
Section 2: tsp programming fundamentals series 3700 system switch/multimeter reference manual 2-8 document number: 3700s-901-01 rev. A / august 2007 system connections up to 64 tsp instruments can be used in a test system. The host interface for the test system can be the gpib, ethernet, or usb. For...
Page 29
Series 3700 system switch/multimeter reference manual section 2: tsp programming fundamentals document number: 3700s-901-01 rev. A / august 2007 2-9 gpib interface connection use a shielded ieee-488 cable such as the keithley instruments model 7007 to connect the series 3700 ieee-488 connector to th...
Page 30: Using Test Script Builder
Section 2: tsp programming fundamentals series 3700 system switch/multimeter reference manual 2-10 document number: 3700s-901-01 rev. A / august 2007 standard rj-45 (ethernet) interface connection the series 3700 uses a standard ethernet connection configuration. It is designed for a 10/100basetx ne...
Page 31
Series 3700 system switch/multimeter reference manual section 2: tsp programming fundamentals document number: 3700s-901-01 rev. A / august 2007 2-11 the following figure shows an example of the test script builder. As shown, the workspace is divided into three window panes: project navigator (on pa...
Page 32: Measure Voltage
Section 2: tsp programming fundamentals series 3700 system switch/multimeter reference manual 2-12 document number: 3700s-901-01 rev. A / august 2007 script editor the script chunk is written and/or modified in the script editor. Notice that there is a tab available for each opened script file. A sc...
Page 33: User Scripts
Series 3700 system switch/multimeter reference manual section 2: tsp programming fundamentals document number: 3700s-901-01 rev. A / august 2007 2-13 command description data=digio.Readbit(4) reads print(data) pc display user-defined messages the operator can define and display messages on the front...
Page 34
Section 2: tsp programming fundamentals series 3700 system switch/multimeter reference manual 2-14 document number: 3700s-901-01 rev. A / august 2007 user’s program script example loadscript voltage = { } reset() for j = 3001,3010 do channel.Exclusiveclose(„3911‟ ..J) voltage[j] = dmm.Measure() prin...
Page 35
Series 3700 system switch/multimeter reference manual section 2: tsp programming fundamentals document number: 3700s-901-01 rev. A / august 2007 2-15 user’s program script example loadscript dmm.Reset(„all‟) function mydcv(speed) dmm.Func = „dcvolts‟ dmm.Nplc = speed dmm.Range = 10 reading = dmm.Mea...
Page 36
Section 2: tsp programming fundamentals series 3700 system switch/multimeter reference manual 2-16 document number: 3700s-901-01 rev. A / august 2007 ......Range_value = 100 ...End -- prompt operator to set (input) measurements speed ...Speed = display.Prompt(„0.00‟, „ nplc‟, „ enter measure speed‟,...
Page 37
Series 3700 system switch/multimeter reference manual section 2: tsp programming fundamentals document number: 3700s-901-01 rev. A / august 2007 2-17 the loadscript shell command loads the script into the run-time environment. The script can be assigned a name or it can be left nameless. If assignin...
Page 38
Section 2: tsp programming fundamentals series 3700 system switch/multimeter reference manual 2-18 document number: 3700s-901-01 rev. A / august 2007 examples: 1. Assume a script named ―test1‖ has been created and loaded. The following command saves the script in nonvolatile memory: test1.Save() 2. ...
Page 39
Series 3700 system switch/multimeter reference manual section 2: tsp programming fundamentals document number: 3700s-901-01 rev. A / august 2007 2-19 autorun scripts when a saved script is set to autorun, it will automatically load and run when the series 3700 is turned on. Any number of scripts can...
Page 40
Section 2: tsp programming fundamentals series 3700 system switch/multimeter reference manual 2-20 document number: 3700s-901-01 rev. A / august 2007 displayname: is the name to be added to (or deleted from) the user menu. Script: is the name of the script. It does not matter what order the items ar...
Page 41
Series 3700 system switch/multimeter reference manual section 2: tsp programming fundamentals document number: 3700s-901-01 rev. A / august 2007 2-21 note a modified user script can be loaded back into the series 3700 using the same name or a new name. The following command returns a catalog listing...
Page 42
Section 2: tsp programming fundamentals series 3700 system switch/multimeter reference manual 2-22 document number: 3700s-901-01 rev. A / august 2007 script.User.Restore("name") where: name is the user-defined name of the script to be restored. Example: restore a user script named ―test9‖ from nonvo...
Page 43
Series 3700 system switch/multimeter reference manual section 2: tsp programming fundamentals document number: 3700s-901-01 rev. A / august 2007 2-23 stand-alone system a script can be run from the front panel of any node (instrument) in the system. When a script is run, all nodes in the system go i...
Page 44
Section 2: tsp programming fundamentals series 3700 system switch/multimeter reference manual 2-24 document number: 3700s-901-01 rev. A / august 2007 variables and types tsl has six basic types; nil, boolean, number, string, function, and table. Tsl is a dynamically typed language, which means varia...
Page 45
Series 3700 system switch/multimeter reference manual section 2: tsp programming fundamentals document number: 3700s-901-01 rev. A / august 2007 2-25 ~= ........................................................................................................ (not equal) == ..............................
Page 46
Section 2: tsp programming fundamentals series 3700 system switch/multimeter reference manual 2-26 document number: 3700s-901-01 rev. A / august 2007 5 -1 0.66666 tables/arrays tsl makes extensive use of the data type ―table,‖ which is essentially a very flexible array-like data type. Define a table...
Page 47
Series 3700 system switch/multimeter reference manual section 2: tsp programming fundamentals document number: 3700s-901-01 rev. A / august 2007 2-27 print(circle["clr"]) index using a string; print the clr property. Print(circle["diam"]) index using a string; print the diam property. Circle["setdia...
Page 48
Section 2: tsp programming fundamentals series 3700 system switch/multimeter reference manual 2-28 document number: 3700s-901-01 rev. A / august 2007 logical operators the logical operators are and, or, and not. Like control structures, all logical operators consider false and nil as false and anyth...
Page 49
Series 3700 system switch/multimeter reference manual section 2: tsp programming fundamentals document number: 3700s-901-01 rev. A / august 2007 2-29 print(not nil) print(not false) print(not 0) print(not not nil) output of code above: true true false false concatenation tsl denotes the string con c...
Page 50
Section 2: tsp programming fundamentals series 3700 system switch/multimeter reference manual 2-30 document number: 3700s-901-01 rev. A / august 2007 x = 1 y = 2 if (x and y) then print("' if ' expression 2 was not false.") end this is if expression 2. If (x or y) then print("' if ' expression 3 was...
Page 51
Series 3700 system switch/multimeter reference manual section 2: tsp programming fundamentals document number: 3700s-901-01 rev. A / august 2007 2-31 -- -------------------------------- for loop ----------------------- -- print("counting from one to three:") for element = 1, 3 do print(element, list...
Page 52
Section 2: tsp programming fundamentals series 3700 system switch/multimeter reference manual 2-32 document number: 3700s-901-01 rev. A / august 2007 2 two 3 three counting from one to four, in steps of two: 1 one 3 three counting elements in list on numeric index 1 one 2 two 3 three 4 four 5 five 6...
Page 53
Series 3700 system switch/multimeter reference manual section 2: tsp programming fundamentals document number: 3700s-901-01 rev. A / august 2007 2-33 base library functions print(x) prints the argument x to the active host interface, using the tostring() function to convert x to a string. Collectgar...
Page 54
Section 2: tsp programming fundamentals series 3700 system switch/multimeter reference manual 2-34 document number: 3700s-901-01 rev. A / august 2007 string.Char(i1, i1, …) receives 0 or more integers. Returns a string with length equal to the number of arguments, in which each character has the int...
Page 55
Series 3700 system switch/multimeter reference manual section 2: tsp programming fundamentals document number: 3700s-901-01 rev. A / august 2007 2-35 math.Floor(x) returns the largest floating-point number not greater than x whose value is an exact mathematical integer. Math.Log(x) returns the natur...
Page 57: Front Panel Introduction
In this section: front panel introduction ................................................................................... 3-1 display ........................................................................................................... 3-3 front panel keys ....................................
Page 58
Section 3: using the front panel series 3700 system switch/multimeter reference manual 3-2 document number: 3700s-901-01 rev. A / august 2007 figure 3-2: model 3706-s system switch (no dmm) note if your model does not have a front panel, please refer to the reference manual for information on how to...
Page 59: Display
Series 3700 system switch/multimeter reference manual section 3: using the front panel document number: 3700s-901-01 rev. A / august 2007 3-3 figure 3-3: model 3706-nfp system switch/multimeter figure 3-4: model 3706-snfp system switch (no dmm) display the series 3700 display provides visual informa...
Page 60
Section 3: using the front panel series 3700 system switch/multimeter reference manual 3-4 document number: 3700s-901-01 rev. A / august 2007 note attribute lists, as well as menu lists, that are larger than the display, can be accessed by turning the wheel (6). Displayed arrows (5) indicate additio...
Page 61
Series 3700 system switch/multimeter reference manual section 3: using the front panel document number: 3700s-901-01 rev. A / august 2007 3-5 the bottom line of the display (4) contains the attribute symbols. The symbols that appear are dependent on whether the attribute exists for the selected func...
Page 62: Front Panel Keys
Section 3: using the front panel series 3700 system switch/multimeter reference manual 3-6 document number: 3700s-901-01 rev. A / august 2007 see the following figure for a menu example. In the example, the main menu is displayed. Turn the wheel (6) or press the cursor keys, to scroll through the av...
Page 63
Series 3700 system switch/multimeter reference manual section 3: using the front panel document number: 3700s-901-01 rev. A / august 2007 3-7 config key use this key to access the an attribute menu that enables you to configure channels, channel patterns, dmm functions, or settings, reading buffer, ...
Page 64
Section 3: using the front panel series 3700 system switch/multimeter reference manual 3-8 document number: 3700s-901-01 rev. A / august 2007 label: this menu item sets the label associated with the channels specified. Related icl command: channel.Setlabel (on page 9-45). From the front panel, the l...
Page 65
Series 3700 system switch/multimeter reference manual section 3: using the front panel document number: 3700s-901-01 rev. A / august 2007 3-9 view: this menu item shows the channels associated with the pattern. Note that if no patterns exist in the system when the patt key is pressed, then this will...
Page 66
Section 3: using the front panel series 3700 system switch/multimeter reference manual 3-10 document number: 3700s-901-01 rev. A / august 2007 scan key if a scan list is present, this key opens the scan action menu that contains the following menu items: note use the insert key to create and add the...
Page 67
Series 3700 system switch/multimeter reference manual section 3: using the front panel document number: 3700s-901-01 rev. A / august 2007 3-11 dmm key opens the dmm action menu that contains the following menu items: measure: this menu item takes measurements on the digital multimeter (dmm) without ...
Page 68
Section 3: using the front panel series 3700 system switch/multimeter reference manual 3-12 document number: 3700s-901-01 rev. A / august 2007 dbref configures the db reference setting for the dmm in volts. Related icl command: dmm.Dbreference (on page 9-84) digits configures the display digits sett...
Page 69
Series 3700 system switch/multimeter reference manual section 3: using the front panel document number: 3700s-901-01 rev. A / august 2007 3-13 math selecting the math menu item opens the math menu. Items contained in this menu are as follows: enable: enable or disable math operation on measurements....
Page 70
Section 3: using the front panel series 3700 system switch/multimeter reference manual 3-14 document number: 3700s-901-01 rev. A / august 2007 thermo selecting the thermo menu item opens the thermo menu. Items contained in this menu are as follows: ref junction: allows selection of the reference jun...
Page 71
Series 3700 system switch/multimeter reference manual section 3: using the front panel document number: 3700s-901-01 rev. A / august 2007 3-15 limit key pressing this key will cycle through the four combinations of limit state settings (limit1 and limit2 off, limit1 on and limit2 off, limit1 off and...
Page 72
Section 3: using the front panel series 3700 system switch/multimeter reference manual 3-16 document number: 3700s-901-01 rev. A / august 2007 filter key pressing this key enables/disables filter for selected function. When the filter is enabled, the filt annunciator will light. Also see filter (on ...
Page 73
Series 3700 system switch/multimeter reference manual section 3: using the front panel document number: 3700s-901-01 rev. A / august 2007 3-17 insert key pressing this key appends the present channel to the scan list. Delete key pressing this key deletes the present channel (including function) from...
Page 74
Section 3: using the front panel series 3700 system switch/multimeter reference manual 3-18 document number: 3700s-901-01 rev. A / august 2007 range, multifunction keys, and wheel range keys ▲▼ selects the next higher or lower measurement range for the selected function when on measurement display. ...
Page 75
Series 3700 system switch/multimeter reference manual section 3: using the front panel document number: 3700s-901-01 rev. A / august 2007 3-19 open key opens selected channels or channel pattern. Close key closes specified channels or channel pattern. Store key opens the rd buff action menu. This me...
Page 76
Section 3: using the front panel series 3700 system switch/multimeter reference manual 3-20 document number: 3700s-901-01 rev. A / august 2007 function key this key select the active function by cycling through the following list as listed. Each press of the func key has the dmm and configured to th...
Page 77: Range
In this section: range ............................................................................................................. 4-1 digits icl programming ................................................................................... 4-3 rate ..................................................
Page 78
Section 4: range, digits, rate, bandwidth, and filter series 3700 system switch/multimeter reference manual 4-2 document number: 3700s-901-01 rev. A / august 2007 function ranges maximum reading cnt (continuity) 1k threshold adjustable 1 to 1000 csΩ (common-side ohm) 1 , 10 , 100 , 1k , 10k , 100k ,...
Page 79: Digits Icl Programming
Series 3700 system switch/multimeter reference manual section 4: range, digits, rate, bandwidth, and filter document number: 3700s-901-01 rev. A / august 2007 4-3 scanning each channel of scan configuration can be associated with a unique dmm configuration (which includes a range setting). When a sc...
Page 80: Rate
Section 4: range, digits, rate, bandwidth, and filter series 3700 system switch/multimeter reference manual 4-4 document number: 3700s-901-01 rev. A / august 2007 setting digits even though the parameters for the dmm.Displaydigits attribute (see dmm.Displaydigits for remote control or digits under t...
Page 81
Series 3700 system switch/multimeter reference manual section 4: range, digits, rate, bandwidth, and filter document number: 3700s-901-01 rev. A / august 2007 4-5 the front panel rate settings for all but the ac functions are explained as follows: fast sets integration time to 0.1 plc. Use fast if s...
Page 82: Bandwidth
Section 4: range, digits, rate, bandwidth, and filter series 3700 system switch/multimeter reference manual 4-6 document number: 3700s-901-01 rev. A / august 2007 bandwidth there are three bandwidth settings for acv and aci measurements. The rate setting determines the bandwidth setting as follows: ...
Page 83
Series 3700 system switch/multimeter reference manual section 4: range, digits, rate, bandwidth, and filter document number: 3700s-901-01 rev. A / august 2007 4-7 filter characteristics in general, the digital filter places a specified number of a/d conversions "filter count" into a memory stack. Th...
Page 84
Section 4: range, digits, rate, bandwidth, and filter series 3700 system switch/multimeter reference manual 4-8 document number: 3700s-901-01 rev. A / august 2007 figure 4-3: repeating average filter digital filter window the digital filter uses a ―noise‖ window to control filter threshold. As long ...
Page 85
Series 3700 system switch/multimeter reference manual section 4: range, digits, rate, bandwidth, and filter document number: 3700s-901-01 rev. A / august 2007 4-9 figure 4-4: filter window.
Page 87: Relative
In this section: relative .......................................................................................................... 5-1 math ............................................................................................................... 5-3 db commands .................................
Page 88
Section 5: relative, math, and db series 3700 system switch/multimeter reference manual 5-2 document number: 3700s-901-01 rev. A / august 2007 5. Apply the signal to be measured. The relative value will be subtracted from the next reading that is triggered. Pressing rel a second time disables rel. T...
Page 89: Math
Series 3700 system switch/multimeter reference manual section 5: relative, math, and db document number: 3700s-901-01 rev. A / august 2007 5-3 dmm.Reset('active') reset dc volts only. Dmm.Rel.Level=1e-6 set the rel level. Dmm.Rel.Enable = dmm.On enable rel. Dmm.Configure.Set("myconfig") call the con...
Page 90
Section 5: relative, math, and db series 3700 system switch/multimeter reference manual 5-4 document number: 3700s-901-01 rev. A / august 2007 setting mx+b units the attribute for dmm.Math.Mxb.Units must be one character enclosed in single or double quotes. It can be any letter of the alphabet, the ...
Page 91
Series 3700 system switch/multimeter reference manual section 5: relative, math, and db document number: 3700s-901-01 rev. A / august 2007 5-5 value = '\\' dmm.Math.Mxb.Units = value note when sending mxb units remotely, to embed a '\' into a string, precede the '\' with an additional '\'. (see "to ...
Page 92
Section 5: relative, math, and db series 3700 system switch/multimeter reference manual 5-6 document number: 3700s-901-01 rev. A / august 2007 bus example: command description dmm.Math.Percent = 5 set percent to 5 print(dmm.Math.Percent) sends 5 to the pc for display to set a percent value like 5 on...
Page 93: Db Commands
Series 3700 system switch/multimeter reference manual section 5: relative, math, and db document number: 3700s-901-01 rev. A / august 2007 5-7 the displayed units designator for reciprocal readings is ―r.‖ this units designator cannot be changed. Example: assume the normal displayed re ading is 002....
Page 94
Section 5: relative, math, and db series 3700 system switch/multimeter reference manual 5-8 document number: 3700s-901-01 rev. A / august 2007 ref in v v 20log db where: v in : dc or ac input signal. V ref : specified voltage reference level. The instrument will read 0db when the reference voltage l...
Page 95: Buffer Overview
In this section: buffer overview ............................................................................................... 6-1 front panel operation ...................................................................................... 6-1 remote buffer operation .................................
Page 96
Section 6: buffer: data storage and retrieval series 3700 system switch/multimeter reference manual 6-2 document number: 3700s-901-01 rev. A / august 2007 4. Press the enter key. The newly created buffer is automatically selected as the buffer for storing front panel readings. These readings may be ...
Page 97
Series 3700 system switch/multimeter reference manual section 6: buffer: data storage and retrieval document number: 3700s-901-01 rev. A / august 2007 6-3 recalling readings readings stored in the buffer are displayed by pressing the rec key. Turn the wheel or use the ◄ cursor ► keys to cycle throug...
Page 98: Remote Buffer Operation
Section 6: buffer: data storage and retrieval series 3700 system switch/multimeter reference manual 6-4 document number: 3700s-901-01 rev. A / august 2007 1. Press the config key. 2. Press the store key. The rd buffer attr menu will open. 3. Configure the buffers append mode as well as view the coun...
Page 99
Series 3700 system switch/multimeter reference manual section 6: buffer: data storage and retrieval document number: 3700s-901-01 rev. A / august 2007 6-5 all routines that return measurements can return the measurements in a reading buffer. Synchronous measurements return a single value or both a s...
Page 100
Section 6: buffer: data storage and retrieval series 3700 system switch/multimeter reference manual 6-6 document number: 3700s-901-01 rev. A / august 2007 attribute description basetimefractional the fractional portion of the timestamp of when the reading at rb[1] was stored in the reading buffer (i...
Page 101
Series 3700 system switch/multimeter reference manual section 6: buffer: data storage and retrieval document number: 3700s-901-01 rev. A / august 2007 6-7 similarly, the following command line returns 100 channel values from "readingbuffer1:" printbuffer(1, 100, readingbuffer1.Channels) the default ...
Page 102
Section 6: buffer: data storage and retrieval series 3700 system switch/multimeter reference manual 6-8 document number: 3700s-901-01 rev. A / august 2007 recall attribute description relativetimestamps an array (lua table) of timestamps, in seconds, of when each reading occurred relative to the tim...
Page 103
Series 3700 system switch/multimeter reference manual section 6: buffer: data storage and retrieval document number: 3700s-901-01 rev. A / august 2007 6-9 buffer status the buffer reading status attribute can include the status information as a numeric value shown in the following table. To access s...
Page 104
Section 6: buffer: data storage and retrieval series 3700 system switch/multimeter reference manual 6-10 document number: 3700s-901-01 rev. A / august 2007 dynamic buffer programming example the listing below shows a programming example for storing data using a dynamically-allocated buffer named "my...
Page 105
Series 3700 system switch/multimeter reference manual section 6: buffer: data storage and retrieval document number: 3700s-901-01 rev. A / august 2007 6-11 -8.851423860e-002, volts dc, 2.009161500e-001 3.891038895e-002, volts dc, 2.647790700e-001 -7.581630349e-002, volts dc, 3.032140350e-001 -8.2363...
Page 106
Section 6: buffer: data storage and retrieval series 3700 system switch/multimeter reference manual 6-12 document number: 3700s-901-01 rev. A / august 2007 create a buffer with: a capacity for 50 readings append mode measure count to 30 tell the instrument to print the current number of buffer eleme...
Page 107
Series 3700 system switch/multimeter reference manual section 6: buffer: data storage and retrieval document number: 3700s-901-01 rev. A / august 2007 6-13.
Page 109: Scanning Fundamentals
In this section: scanning fundamentals ................................................................................... 7-1 front panel scanning ....................................................................................... 7-7 bus operation scanning ........................................
Page 110
Section 7: scanning series 3700 system switch/multimeter reference manual 7-2 document number: 3700s-901-01 rev. A / august 2007 range example (sequential): 1003:1005 will add channels 1003, 1004, 1005 to the list as three distinct steps with channel 3 added first, channel 4 added second, and channe...
Page 111
Series 3700 system switch/multimeter reference manual section 7: scanning document number: 3700s-901-01 rev. A / august 2007 7-3 slot.Pseudo_3730 or 3730 model 3740 32 channel isolated switch card: slot.Pseudo_3740 or 3740 for example, to set the attribute to "install" the model 3720 pseudocard in s...
Page 112
Section 7: scanning series 3700 system switch/multimeter reference manual 7-4 document number: 3700s-901-01 rev. A / august 2007 trigger model the embedded "scan builder" contains the trigger model gui. The following flowchart, also known as a trigger model, shows the fundamental scan functions of s...
Page 113
Series 3700 system switch/multimeter reference manual section 7: scanning document number: 3700s-901-01 rev. A / august 2007 7-5 trigger model components the individual components of the trigger model are explained in the following paragraphs. Idle when a scan is initiated, operation leaves the idle...
Page 114
Section 7: scanning series 3700 system switch/multimeter reference manual 7-6 document number: 3700s-901-01 rev. A / august 2007 events event detectors monitor an event. They have one input signal, the stimulus, which is the event that they monitor. They have two output signals (see figure below). D...
Page 115: Front Panel Scanning
Series 3700 system switch/multimeter reference manual section 7: scanning document number: 3700s-901-01 rev. A / august 2007 7-7 event blenders each have an associated event detector that can be accessed through script control. Event blenders can only be accessed over the bus (no front panel control...
Page 116
Section 7: scanning series 3700 system switch/multimeter reference manual 7-8 document number: 3700s-901-01 rev. A / august 2007 bypass: this menu item enables or disables bypassing the first item in the scan. Related icl command: scan.Bypass (on page 9-160) mode: this menu item sets the scan.Mode v...
Page 117
Series 3700 system switch/multimeter reference manual section 7: scanning document number: 3700s-901-01 rev. A / august 2007 7-9 step operation when the step key is pressed, the series 3700 leaves the idle state and performs the channel action associated with the first step in the scan list. Measure...
Page 118: Bus Operation Scanning
Section 7: scanning series 3700 system switch/multimeter reference manual 7-10 document number: 3700s-901-01 rev. A / august 2007 bus initiated scan: use an icl command such as scan.Execute, scan.Background, scan.Nobufferbackground, as desired. 3. The channels are scanned in the order they were adde...
Page 119
Series 3700 system switch/multimeter reference manual section 7: scanning document number: 3700s-901-01 rev. A / august 2007 7-11 digio.Trigger[n].Clear (on page 9-49) digio.Trigger[n].Pulsewidth (on page 9-51) digio.Trigger[n].Stimulus (on page 9-51) digio.Trigger[n].Wait (on page 9-52) lan.Trigger...
Page 120
Section 7: scanning series 3700 system switch/multimeter reference manual 7-12 document number: 3700s-901-01 rev. A / august 2007 examples the following examples assume a keithley instruments model 3720 module is installed in slot 3 of a series 3700. Note in the examples, to clear a trigger stimulus...
Page 121
Series 3700 system switch/multimeter reference manual section 7: scanning document number: 3700s-901-01 rev. A / august 2007 7-13 example 2: command list to scan the entire card while measuring dc volts on each channel, and store readings in a buffer called mybuffer (see the description column for o...
Page 122
Section 7: scanning series 3700 system switch/multimeter reference manual 7-14 document number: 3700s-901-01 rev. A / august 2007 example 3: command list to scan the entire card while measuring four-wire ohms using a background scan (see the description column for other specifics). Command descripti...
Page 123: Status Register Sets
The keithley instruments series 3700 system switch/multimeter provides a number of status registers and queues that allow the operator to monitor and manipulate various instrument events. The heart of the status model is the status byte register. This register can be read by the user's test program ...
Page 124: Status Byte And Srq
Section 8: status model series 3700 system switch/multimeter reference manual 8-2 document number: 3700s-901-01 rev. A / august 2007 status byte and srq the status byte register receives the summary bits of the five status register sets, a master summary bit, and two queues. The register sets and qu...
Page 125
Series 3700 system switch/multimeter reference manual section 8: status model document number: 3700s-901-01 rev. A / august 2007 8-3 system summary and status byte the system summary bit (ssb) is received by the status byte (bit 1) from the system summary register (status.System) byte. The summary o...
Page 126: System Summary Registers
Section 8: status model series 3700 system switch/multimeter reference manual 8-4 document number: 3700s-901-01 rev. A / august 2007 system summary registers the system summary registers (system5 through system2) provide summary information through the specific register's extension bit (bit 0). This...
Page 127: Operation Events Registers
Series 3700 system switch/multimeter reference manual section 8: status model document number: 3700s-901-01 rev. A / august 2007 8-5 standard event status register and enable the summary bit of the standard event status register and event status enable provide summary information to bit 5 of the sta...
Page 128: Measurement Event Register
Section 8: status model series 3700 system switch/multimeter reference manual 8-6 document number: 3700s-901-01 rev. A / august 2007 questionable event register the questionable event register provides summary information to questionable summary bit (qsb)(bit 3) of the status byte. Figure 8-6: quest...
Page 129: Status Function Summary
Series 3700 system switch/multimeter reference manual section 8: status model document number: 3700s-901-01 rev. A / august 2007 8-7 status function summary the following functions control and read the various registers. Type function system summary status.Reset status.Node_enable status.Request_ena...
Page 130
Section 8: status model series 3700 system switch/multimeter reference manual 8-8 document number: 3700s-901-01 rev. A / august 2007 commands to reset the status registers and the error queue are listed in the following table. In addition to these commands, any programmable register can be reset by ...
Page 131: Reading Registers
Series 3700 system switch/multimeter reference manual section 8: status model document number: 3700s-901-01 rev. A / august 2007 8-9 status.Standard.Enable = to convert from decimal to binary, use the information shown in the figure above. For example: to set bits b0, b4, b7, and b10, a decimal valu...
Page 132
Section 8: status model series 3700 system switch/multimeter reference manual 8-10 document number: 3700s-901-01 rev. A / august 2007 status byte and service request (srq) service request is controlled by two 8-bit registers; the status byte register and the service request enable register. Figure 8...
Page 133
Series 3700 system switch/multimeter reference manual section 8: status model document number: 3700s-901-01 rev. A / august 2007 8-11 bit b0, measurement summary bit (msb): set summary bit indicates that an enabled measurement event has occurred. Bit b1, system summary bit (ssb): set summary bit ind...
Page 134
Section 8: status model series 3700 system switch/multimeter reference manual 8-12 document number: 3700s-901-01 rev. A / august 2007 service request enable register the generation of a service request is controlled by the service request enable register. This register is programmed by the user and ...
Page 135
Series 3700 system switch/multimeter reference manual section 8: status model document number: 3700s-901-01 rev. A / august 2007 8-13 enable and transition registers in general, there are three types of user-writable registers that are used to configure which bits feed the register summary and when ...
Page 136
Section 8: status model series 3700 system switch/multimeter reference manual 8-14 document number: 3700s-901-01 rev. A / august 2007 the used bits of the system event registers are described as follows: ext: set bit indicates that an extension bit from a another system status register is set. Noden...
Page 137
Series 3700 system switch/multimeter reference manual section 8: status model document number: 3700s-901-01 rev. A / august 2007 8-15 commands bit to set register bits: status.System5.Enable = status.System.Extension_bit status.System5.Enable = status.System.Ext status.System5.Enable = status.System...
Page 138
Section 8: status model series 3700 system switch/multimeter reference manual 8-16 document number: 3700s-901-01 rev. A / august 2007 standard event register the bits used in the standard event register are described as follows: bit b0, operation complete: set bit indicates that all pending selected...
Page 139
Series 3700 system switch/multimeter reference manual section 8: status model document number: 3700s-901-01 rev. A / august 2007 8-17 figure 8-10: standard event register commands to program and read the register are summarized in the table below. Refer to the status.Standard icl command for the att...
Page 140
Section 8: status model series 3700 system switch/multimeter reference manual 8-18 document number: 3700s-901-01 rev. A / august 2007 operation event registers the series 3700 has two register sets associated with operation event status. Commands are summarized in the following table. For example, e...
Page 141
Series 3700 system switch/multimeter reference manual section 8: status model document number: 3700s-901-01 rev. A / august 2007 8-19 commands bit to set register bits: status.Operation.User.* = status.Operation.User.Bit0 status.Operation.User.* = status.Operation.User.Bit1 status.Operation.User.* =...
Page 142: Queues
Section 8: status model series 3700 system switch/multimeter reference manual 8-20 document number: 3700s-901-01 rev. A / august 2007 measurement event registers the series 3700 has one register set associated with measurement event status. As an example, to set the buffer available bit: status.Meas...
Page 143
Series 3700 system switch/multimeter reference manual section 8: status model document number: 3700s-901-01 rev. A / august 2007 8-21 the commands to control the error queue are listed in the following table. When you read a single message in the error queue, the ―oldest‖ message is read and then re...
Page 145: Command Programming Notes
In this section: command programming notes ......................................................................... 9-1 beeper functions and attribute.......................................................................... 9-8 bit functions ...........................................................
Page 146
Section 9: instrument control library (icl) series 3700 system switch/multimeter reference manual 9-2 document number: 3700s-901-01 rev. A / august 2007 x and y the x character is used for functions and attributes to indicate the slot (1 through 6) and y is used to indicate the limit number (1 or 2)...
Page 147
Series 3700 system switch/multimeter reference manual section 9: instrument control library (icl) document number: 3700s-901-01 rev. A / august 2007 9-3 digio.Writeport(15) ....................... ' sets digital i/o lines 1, 2, 3 and 4 high. Digio.Writebit(3, 0) ........................................
Page 148
Section 9: instrument control library (icl) series 3700 system switch/multimeter reference manual 9-4 document number: 3700s-901-01 rev. A / august 2007 variable assignment example: the following command reads the filter type by assigning the attribute to a variable named filtertype: filtertype = dm...
Page 149
Series 3700 system switch/multimeter reference manual section 9: instrument control library (icl) document number: 3700s-901-01 rev. A / august 2007 9-5 logical instruments you would normally refer to all instrumentation within one enclosure or node as a single instrument. From a tsp/icl point of vi...
Page 150
Section 9: instrument control library (icl) series 3700 system switch/multimeter reference manual 9-6 document number: 3700s-901-01 rev. A / august 2007 if the command was channel.Getstate instead of channel.Getcount, then 72 zero or one values would be returned. (a 0 would indicate channel or backp...
Page 151
Series 3700 system switch/multimeter reference manual section 9: instrument control library (icl) document number: 3700s-901-01 rev. A / august 2007 9-7 myconfig,myconfig,myconfig,myconfig,myconfig,myconfig,myconfig,myconfig,myco nfig,myconfig,myconfig,myconfig,myconfig,myconfig,myconfig,myconfig,my...
Page 152
Section 9: instrument control library (icl) series 3700 system switch/multimeter reference manual 9-8 document number: 3700s-901-01 rev. A / august 2007 likewise, changing a dmm configuration to pertain to a function not supported by a channels will cause the channels to be set back to the 'nofuncti...
Page 153: Bit Functions
Series 3700 system switch/multimeter reference manual section 9: instrument control library (icl) document number: 3700s-901-01 rev. A / august 2007 9-9 beeper.Enable also see beeper.Beep (on page 9-9) example enables the beeper and generates a two second, 2400hz beep: beeper.Enable = 1 beeper.Beep(...
Page 154
Section 9: instrument control library (icl) series 3700 system switch/multimeter reference manual 9-10 document number: 3700s-901-01 rev. A / august 2007 the bit.Bitand, bit.Bitor and bit.Bitxor functions in this group perform logic operations on two numbers. The tsp (test script processor) will per...
Page 155
Series 3700 system switch/multimeter reference manual section 9: instrument control library (icl) document number: 3700s-901-01 rev. A / august 2007 9-11 bit.Bitor also see logic and bit operations (on page 9-9) bit.Bitand (on page 9-10) bit.Bitxor (on page 9-11) example performs a bitwise logical o...
Page 156
Section 9: instrument control library (icl) series 3700 system switch/multimeter reference manual 9-12 document number: 3700s-901-01 rev. A / august 2007 bit.Clear also see logic and bit operations (on page 9-9) bit.Get (on page 9-12) bit.Getfield (on page 9-12) bit.Set (on page 9-13) bit.Setfield (...
Page 157
Series 3700 system switch/multimeter reference manual section 9: instrument control library (icl) document number: 3700s-901-01 rev. A / august 2007 9-13 bit.Getfield function returns a field of bits starting at a given index position. Usage value = bit.Getfield(value1, index, width) value1: given n...
Page 158
Section 9: instrument control library (icl) series 3700 system switch/multimeter reference manual 9-14 document number: 3700s-901-01 rev. A / august 2007 bit.Set also see logic and bit operations (on page 9-9) bit.Clear (on page 9-11) bit.Get (on page 9-12) bit.Getfield (on page 9-12) bit.Setfield (...
Page 159
Series 3700 system switch/multimeter reference manual section 9: instrument control library (icl) document number: 3700s-901-01 rev. A / august 2007 9-15 bit.Setfield example the binary equivalent of decimal 15 is 1111. After overwriting it with a decimal 5 (binary 101) at index position 2, the retu...
Page 160
Section 9: instrument control library (icl) series 3700 system switch/multimeter reference manual 9-16 document number: 3700s-901-01 rev. A / august 2007 bit.Toggle remarks this function returns value, which is the result of toggling a bit in value1. Any fractional part of value1 is truncated to mak...
Page 161
Series 3700 system switch/multimeter reference manual section 9: instrument control library (icl) document number: 3700s-901-01 rev. A / august 2007 9-17 s: slot number 9: backplane notation designation (always 9 when referencing a backplane relay) b: bank number x: analog backplane relay number ana...
Page 162
Section 9: instrument control library (icl) series 3700 system switch/multimeter reference manual 9-18 document number: 3700s-901-01 rev. A / august 2007 s: slot number r: row number cc: column number (always use 2 digits) matrix channel examples: reference slot row column 1104 1 1 04 1203 1 2 03 23...
Page 163
Series 3700 system switch/multimeter reference manual section 9: instrument control library (icl) document number: 3700s-901-01 rev. A / august 2007 9-19 channel.Close remarks this function closes specified channels and channel patterns (specified by ch_list). These closures are appended to the alre...
Page 164
Section 9: instrument control library (icl) series 3700 system switch/multimeter reference manual 9-20 document number: 3700s-901-01 rev. A / august 2007 channel.Close also see channel.Exclusiveclose (on page 9-21) channel.Exclusiveslotclose (on page 9-23) channel.Open (on page 9-34) dmm.Close (on p...
Page 165
Series 3700 system switch/multimeter reference manual section 9: instrument control library (icl) document number: 3700s-901-01 rev. A / august 2007 9-21 channel.Connectsequential attribute indicates if the connection rule is sequential or not. Usage to read the connect sequential value: sequential ...
Page 166
Section 9: instrument control library (icl) series 3700 system switch/multimeter reference manual 9-22 document number: 3700s-901-01 rev. A / august 2007 channel.Exclusiveclose remarks this function manipulates the channels and analog backplane relays for switching aspects so only those specified by...
Page 167
Series 3700 system switch/multimeter reference manual section 9: instrument control library (icl) document number: 3700s-901-01 rev. A / august 2007 9-23 channel.Exclusiveclose details for delay time see channel.Setdelay (on page 9-44) for connection options, see channel.Connectrule (on page 9-20) a...
Page 168
Section 9: instrument control library (icl) series 3700 system switch/multimeter reference manual 9-24 document number: 3700s-901-01 rev. A / august 2007 channel.Exclusiveslotclose remarks this function manipulates the channels and analog backplane relays for switching aspects so only those specifie...
Page 169
Series 3700 system switch/multimeter reference manual section 9: instrument control library (icl) document number: 3700s-901-01 rev. A / august 2007 9-25 channel.Exclusiveslotclose details for delay time see channel.Setdelay (on page 9-44) for connection options, see channel.Connectrule (on page 9-2...
Page 170
Section 9: instrument control library (icl) series 3700 system switch/multimeter reference manual 9-26 document number: 3700s-901-01 rev. A / august 2007 channel.Getbackplane remarks the response indicates the analog backplane relays that will be used or affected by: channel.Close (on page 9-18) – u...
Page 171
Series 3700 system switch/multimeter reference manual section 9: instrument control library (icl) document number: 3700s-901-01 rev. A / august 2007 9-27 channel.Getbackplane example to query analog backplane relay(s) specified on channel 2 of slot 2 for switching aspects: abuslist = channel.Getback...
Page 172
Section 9: instrument control library (icl) series 3700 system switch/multimeter reference manual 9-28 document number: 3700s-901-01 rev. A / august 2007 channel.Getclose example to see the channels and analog backplane relays that are closed on slot 5: closedslot5 = channel.Getclose("slot5") to see...
Page 173
Series 3700 system switch/multimeter reference manual section 9: instrument control library (icl) document number: 3700s-901-01 rev. A / august 2007 9-29 channel.Getcount also see query commands (on page 9-5) example to see the close counts for channels 1 to 5 on slot 2: counts = channel.Getcount("2...
Page 174
Section 9: instrument control library (icl) series 3700 system switch/multimeter reference manual 9-30 document number: 3700s-901-01 rev. A / august 2007 channel.Getdelay example to query channels 1 and 3 on slot 5 for their delay time: mydelaytime = channel.Getdelay("5001, 5003") to see the delay o...
Page 175
Series 3700 system switch/multimeter reference manual section 9: instrument control library (icl) document number: 3700s-901-01 rev. A / august 2007 9-31 channel.Getimage example assume channel 3 on slot 2 is configured for a 4-wire application and channel 5 on slot 2 is configured for a 2-wire appl...
Page 176
Section 9: instrument control library (icl) series 3700 system switch/multimeter reference manual 9-32 document number: 3700s-901-01 rev. A / august 2007 channel.Getlabel remarks the parameter ch_list may contain more than one channel in it. If it does, a comma is used to delineate the labels for th...
Page 177
Series 3700 system switch/multimeter reference manual section 9: instrument control library (icl) document number: 3700s-901-01 rev. A / august 2007 9-33 channel.Getpole remarks the parameter string may contain ―slotx‖, where x equals 1 to 6, or ―allslots‖. An error message will be generated for the...
Page 178
Section 9: instrument control library (icl) series 3700 system switch/multimeter reference manual 9-34 document number: 3700s-901-01 rev. A / august 2007 channel.Getstate remarks use this command to query for the state of channels in the system. The response will be a string with a zero or one (comm...
Page 179
Series 3700 system switch/multimeter reference manual section 9: instrument control library (icl) document number: 3700s-901-01 rev. A / august 2007 9-35 channel.Open remarks this function will open the specified channels for switching aspects. The items specified in ch_list may include analog backp...
Page 180
Section 9: instrument control library (icl) series 3700 system switch/multimeter reference manual 9-36 document number: 3700s-901-01 rev. A / august 2007 channel.Open example to open channels 1 to 5 on slot 1, channel 3 on slot 3 and mychans: channel.Open("1001:1005, 3003, mychans") to open all chan...
Page 181
Series 3700 system switch/multimeter reference manual section 9: instrument control library (icl) document number: 3700s-901-01 rev. A / august 2007 9-37 channel.Pattern.Delete remarks an error will be generated if the name does not exist. Also see channel.Pattern.Catalog (on page 9-36) channel.Patt...
Page 182
Section 9: instrument control library (icl) series 3700 system switch/multimeter reference manual 9-38 document number: 3700s-901-01 rev. A / august 2007 channel.Pattern.Setimage function creates a channel pattern and associates it with the specified name. Usage channel.Pattern.Setimage(ch_list, nam...
Page 183
Series 3700 system switch/multimeter reference manual section 9: instrument control library (icl) document number: 3700s-901-01 rev. A / august 2007 9-39 channel.Pattern.Setimage details not persistent through a power cycle. Part of saved setup. The following restrictions exist on the naming of a ch...
Page 184
Section 9: instrument control library (icl) series 3700 system switch/multimeter reference manual 9-40 document number: 3700s-901-01 rev. A / august 2007 channel.Pattern.Setimage example to create a channel pattern called mychans using channels 1 to 10 on slot 3: channel.Pattern.Setimage("3001:3010”...
Page 185
Series 3700 system switch/multimeter reference manual section 9: instrument control library (icl) document number: 3700s-901-01 rev. A / august 2007 9-41 channel.Pattern.Snapshot remarks this command will store the image of closed and opened channels along with analog backplane relays in the system ...
Page 186
Section 9: instrument control library (icl) series 3700 system switch/multimeter reference manual 9-42 document number: 3700s-901-01 rev. A / august 2007 channel.Reset remarks this command resets only the channel aspects for the items specified to factory default settings. For the items specified in...
Page 187
Series 3700 system switch/multimeter reference manual section 9: instrument control library (icl) document number: 3700s-901-01 rev. A / august 2007 9-43 channel.Setbackplane remarks the abuslist parameter must specify the entire list of analog backplane relays needed. The analog backplane relays sp...
Page 188
Section 9: instrument control library (icl) series 3700 system switch/multimeter reference manual 9-44 document number: 3700s-901-01 rev. A / august 2007 channel.Setbackplane also see channel.Close (on page 9-18) channel.Exclusiveclose (on page 9-21) channel.Getbackplane (on page 9-25) channel.Open ...
Page 189
Series 3700 system switch/multimeter reference manual section 9: instrument control library (icl) document number: 3700s-901-01 rev. A / august 2007 9-45 channel.Setdelay example set channels 1 and 3 on slot 5 for a delay time of 50 microseconds: channel.Setdelay("5001, 5003" , 50e-6) to set the cha...
Page 190
Section 9: instrument control library (icl) series 3700 system switch/multimeter reference manual 9-46 document number: 3700s-901-01 rev. A / august 2007 channel.Setlabel example to set the label for channel 1 on slot 1 to ―start‖: channel.Setlabel("1001", "start") to clear the label for channel 1 o...
Page 191
Series 3700 system switch/multimeter reference manual section 9: instrument control library (icl) document number: 3700s-901-01 rev. A / august 2007 9-47 channel.Setpole remarks an error message will be generated for the following reasons: an empty parameter string. The value is an invalid setting f...
Page 192: Delay Function
Section 9: instrument control library (icl) series 3700 system switch/multimeter reference manual 9-48 document number: 3700s-901-01 rev. A / august 2007 delay function this function is used to hold up system operation for a specified period of time. It is typically used to soak a device at a specif...
Page 193
Series 3700 system switch/multimeter reference manual section 9: instrument control library (icl) document number: 3700s-901-01 rev. A / august 2007 9-49 digio.Readbit example assume line 4 is set high, and it is then read: data = digio.Readbit(4) print(data) output: 1.000000e+00 digio.Readport func...
Page 194
Section 9: instrument control library (icl) series 3700 system switch/multimeter reference manual 9-50 document number: 3700s-901-01 rev. A / august 2007 digio.Trigger[n].Clear example clears trigger event on i/o line 2: digio.Trigger[2].Clear() digio.Trigger[n].Mode attribute trigger operation and ...
Page 195
Series 3700 system switch/multimeter reference manual section 9: instrument control library (icl) document number: 3700s-901-01 rev. A / august 2007 9-51 digio.Trigger[n].Pulsewidth attribute the length of time that the trigger line will be asserted for output triggers. N is a digital i/o trigger li...
Page 196
Section 9: instrument control library (icl) series 3700 system switch/multimeter reference manual 9-52 document number: 3700s-901-01 rev. A / august 2007 digio.Trigger[n].Stimulus remarks this attribute selects which event(s) will cause digital output line to assert a trigger. Set this attribute to ...
Page 197
Series 3700 system switch/multimeter reference manual section 9: instrument control library (icl) document number: 3700s-901-01 rev. A / august 2007 9-53 digio.Trigger[n].Wait example waits up to three seconds for a trigger to be detected on trigger line 4, then displays if the trigger was detected:...
Page 198
Section 9: instrument control library (icl) series 3700 system switch/multimeter reference manual 9-54 document number: 3700s-901-01 rev. A / august 2007 digio.Writeprotect usage to read writeprotect mask: mask = digio.Writeprotect to write writeprotect mask: digio.Writeprotect = mask mask: set to t...
Page 199
Series 3700 system switch/multimeter reference manual section 9: instrument control library (icl) document number: 3700s-901-01 rev. A / august 2007 9-55 display.Getannunciators remarks this function returns a bitmap value that indicates which annunciators are turned on. The 16- bit binary equivalen...
Page 200
Section 9: instrument control library (icl) series 3700 system switch/multimeter reference manual 9-56 document number: 3700s-901-01 rev. A / august 2007 display.Getcursor remarks this function switches the display to the user screen, and then returns values to indicate row and column position, and ...
Page 201
Series 3700 system switch/multimeter reference manual section 9: instrument control library (icl) document number: 3700s-901-01 rev. A / august 2007 9-57 display.Getlastkey function retrieves the keycode for the last pressed key. Usage key = display.Getlastkey() remarks this read-only function retur...
Page 202
Section 9: instrument control library (icl) series 3700 system switch/multimeter reference manual 9-58 document number: 3700s-901-01 rev. A / august 2007 display.Gettext function reads the text presently displayed usage there are five ways to use this function: text = display.Gettext() text = displa...
Page 203
Series 3700 system switch/multimeter reference manual section 9: instrument control library (icl) document number: 3700s-901-01 rev. A / august 2007 9-59 display.Inputvalue function displays a formatted input field that the operator can edit. Usage there are four ways to use this function: value = d...
Page 204
Section 9: instrument control library (icl) series 3700 system switch/multimeter reference manual 9-60 document number: 3700s-901-01 rev. A / august 2007 display.Inputvalue remarks (cont.) after sending this command, script execution pauses for the operator to enter a value and press the enter key. ...
Page 205
Series 3700 system switch/multimeter reference manual section 9: instrument control library (icl) document number: 3700s-901-01 rev. A / august 2007 9-61 display.Loadmenu.Add also see display.Loadmenu.Delete (on page 9-61) examples example 1: assume a script with a function named "dut1" has already ...
Page 206
Section 9: instrument control library (icl) series 3700 system switch/multimeter reference manual 9-62 document number: 3700s-901-01 rev. A / august 2007 display.Locallockout remarks setting display.Locallockout to display.Lock prevents the user from interrupting remote operation by pressing the loc...
Page 207
Series 3700 system switch/multimeter reference manual section 9: instrument control library (icl) document number: 3700s-901-01 rev. A / august 2007 9-63 display.Prompt function prompts the user to enter a parameter from the front panel. Usage there are four ways to use this function: value = displa...
Page 208
Section 9: instrument control library (icl) series 3700 system switch/multimeter reference manual 9-64 document number: 3700s-901-01 rev. A / august 2007 display.Prompt remarks (cont.) units: a string that indicates the units (for example, "v" or "a") for the value and help provides a message prompt...
Page 209
Series 3700 system switch/multimeter reference manual section 9: instrument control library (icl) document number: 3700s-901-01 rev. A / august 2007 9-65 display.Sendkey function send keycode that simulates the action of a front panel control being pressed. Usage display.Sendkey(keycode) set keycode...
Page 210
Section 9: instrument control library (icl) series 3700 system switch/multimeter reference manual 9-66 document number: 3700s-901-01 rev. A / august 2007 display.Setcursor function sets the position of the cursor. Usage there are two ways to use this function: display.Setcursor(row, column) display....
Page 211
Series 3700 system switch/multimeter reference manual section 9: instrument control library (icl) document number: 3700s-901-01 rev. A / august 2007 9-67 display.Settext remarks this function selects the user display screen, and displays the given text. The first write to the display after power-on ...
Page 212
Section 9: instrument control library (icl) series 3700 system switch/multimeter reference manual 9-68 document number: 3700s-901-01 rev. A / august 2007 display.Waitkey remarks after sending this function, script execution pauses until a front panel key or the wheel is pressed, or the wheel is turn...
Page 213: Dmm Functions
Series 3700 system switch/multimeter reference manual section 9: instrument control library (icl) document number: 3700s-901-01 rev. A / august 2007 9-69 display.Waitkey example the following code pauses script execution and wait for the operator to press a key or the wheel, or rotate the wheel: key...
Page 214
Section 9: instrument control library (icl) series 3700 system switch/multimeter reference manual 9-70 document number: 3700s-901-01 rev. A / august 2007 dmm.Adjustment.Date example also see usage for setting date. Note for following assume set date to july 4, 2007. To query date and format the resp...
Page 215
Series 3700 system switch/multimeter reference manual section 9: instrument control library (icl) document number: 3700s-901-01 rev. A / august 2007 9-71 dmm.Aperture example to set the aperture to 16.67 milliseconds for dc volts: dmm.Func = "dcvolts" dmm.Aperture = 16.67e-3 dmm.Autodelay attribute ...
Page 216
Section 9: instrument control library (icl) series 3700 system switch/multimeter reference manual 9-72 document number: 3700s-901-01 rev. A / august 2007 dmm.Autodelay example to enable auto delay for dc volts: dmm.Func = "dcvolts" dmm.Autodelay = dmm.On to set auto delay to set once: dmm.Autodelay ...
Page 217
Series 3700 system switch/multimeter reference manual section 9: instrument control library (icl) document number: 3700s-901-01 rev. A / august 2007 9-73 dmm.Autozero attribute indicates the auto zero setting for the dmm. Usage to read the auto zero status: value = dmm.Autozero value: represents the...
Page 218
Section 9: instrument control library (icl) series 3700 system switch/multimeter reference manual 9-74 document number: 3700s-901-01 rev. A / august 2007 dmm.Calibration.Ac remarks use this command to indicate the desired ac calibration step to perform on the dmm. This command will generate an error...
Page 219
Series 3700 system switch/multimeter reference manual section 9: instrument control library (icl) document number: 3700s-901-01 rev. A / august 2007 9-75 dmm.Calibration.Dc function signals the desired dc calibration step on the dmm. Usage dmm.Calibration.Dc(step, value) step: represents the dc cali...
Page 220
Section 9: instrument control library (icl) series 3700 system switch/multimeter reference manual 9-76 document number: 3700s-901-01 rev. A / august 2007 dmm.Calibration.Lock function locks calibration. Usage dmm.Calibration.Lock() remarks use this command to lock unlocked calibration. Once locked, ...
Page 221
Series 3700 system switch/multimeter reference manual section 9: instrument control library (icl) document number: 3700s-901-01 rev. A / august 2007 9-77 dmm.Calibration.Unlock function unlocks calibration. Usage dmm.Calibration.Unlock(password) password: a string representing the password to unlock...
Page 222
Section 9: instrument control library (icl) series 3700 system switch/multimeter reference manual 9-78 document number: 3700s-901-01 rev. A / august 2007 dmm.Close remarks the actions associate with this function includes: opens previously closed channels if they interfere with measurement including...
Page 223
Series 3700 system switch/multimeter reference manual section 9: instrument control library (icl) document number: 3700s-901-01 rev. A / august 2007 9-79 dmm.Close example to close channel 3 on slot 3 and prepare the dmm for measuring temperature at "mytemperature" settings: dmm.Setconfig("3003", "m...
Page 224
Section 9: instrument control library (icl) series 3700 system switch/multimeter reference manual 9-80 document number: 3700s-901-01 rev. A / august 2007 dmm.Configure.Delete function deletes the specified user created dmm configuration from memory. Usage dmm.Configure.Delete(name) name: string cont...
Page 225
Series 3700 system switch/multimeter reference manual section 9: instrument control library (icl) document number: 3700s-901-01 rev. A / august 2007 9-81 dmm.Configure.Query remarks this function will list the settings contained within the specified configuration, myconfig, along with the correspond...
Page 226
Section 9: instrument control library (icl) series 3700 system switch/multimeter reference manual 9-82 document number: 3700s-901-01 rev. A / august 2007 dmm.Configure.Recall function recalls a user or factory dmm configuration. Usage dmm.Configure.Recall(config) config: a string representing the na...
Page 227
Series 3700 system switch/multimeter reference manual section 9: instrument control library (icl) document number: 3700s-901-01 rev. A / august 2007 9-83 dmm.Configure.Set function creates a dmm configuration with the pertinent attributes based on the selected function and associates it with the spe...
Page 228
Section 9: instrument control library (icl) series 3700 system switch/multimeter reference manual 9-84 document number: 3700s-901-01 rev. A / august 2007 dmm.Connect attribute indicates how the dmm relays should be connected to the analog backplane. Usage to read the dmm relay connection setting: va...
Page 229
Series 3700 system switch/multimeter reference manual section 9: instrument control library (icl) document number: 3700s-901-01 rev. A / august 2007 9-85 dmm.Dbreference remarks this is the db reference setting for the dmm and it applies to the selected function as indicated by dmm.Func. Querying th...
Page 230
Section 9: instrument control library (icl) series 3700 system switch/multimeter reference manual 9-86 document number: 3700s-901-01 rev. A / august 2007 dmm.Drycircuit attribute indicates the dry circuit setting for the selected dmm function. Usage to read the dry circuit: value = dmm.Drycircuit va...
Page 231
Series 3700 system switch/multimeter reference manual section 9: instrument control library (icl) document number: 3700s-901-01 rev. A / august 2007 9-87 dmm.Filter.Count also see dmm.Filter.Enable (on page 9-87) dmm.Filter.Type (on page 9-87) example to set the filter count for two-wire ohms to 5: ...
Page 232
Section 9: instrument control library (icl) series 3700 system switch/multimeter reference manual 9-88 document number: 3700s-901-01 rev. A / august 2007 dmm.Filter.Type attribute indicates the filter type for the dmm measurements on selected dmm functions. Usage to read the filter type: value = dmm...
Page 233
Series 3700 system switch/multimeter reference manual section 9: instrument control library (icl) document number: 3700s-901-01 rev. A / august 2007 9-89 dmm.Filter.Window remarks this is the filter window setting for the dmm and it applies to the selected function as indicated by dmm.Func (on page ...
Page 234
Section 9: instrument control library (icl) series 3700 system switch/multimeter reference manual 9-90 document number: 3700s-901-01 rev. A / august 2007 dmm.Fourrtd attribute indicates the type of four-wire rtd being used. Usage to read the 4-wire rtd type: value = dmm.Fourrtd value: represents the...
Page 235
Series 3700 system switch/multimeter reference manual section 9: instrument control library (icl) document number: 3700s-901-01 rev. A / august 2007 9-91 dmm.Func attribute sets or indicates the selected function for the dmm. Usage to read the function: myfunc = dmm.Func myfunc: string indicating th...
Page 236
Section 9: instrument control library (icl) series 3700 system switch/multimeter reference manual 9-92 document number: 3700s-901-01 rev. A / august 2007 dmm.Func details the dmm has a flat view of settings in terms of commands. However, internally, the dmm maintains settings on per function basis. ...
Page 237
Series 3700 system switch/multimeter reference manual section 9: instrument control library (icl) document number: 3700s-901-01 rev. A / august 2007 9-93 dmm.Getconfig remarks use this command to query for dmm configurations associated with channels or channel patterns. The response will be a comma ...
Page 238
Section 9: instrument control library (icl) series 3700 system switch/multimeter reference manual 9-94 document number: 3700s-901-01 rev. A / august 2007 dmm.Inputdivider example to enable the input divider for dc volts: dmm.Func = “dcvolts” dmm.Inputdivider = dmm.On dmm.Limit[y].Autoclear where y =...
Page 239
Series 3700 system switch/multimeter reference manual section 9: instrument control library (icl) document number: 3700s-901-01 rev. A / august 2007 9-95 dmm.Limit[y].Enable where y = 1 or 2 for limit number attribute enable or disable limit y testing. Usage to read the state of limit y: value = dmm...
Page 240
Section 9: instrument control library (icl) series 3700 system switch/multimeter reference manual 9-96 document number: 3700s-901-01 rev. A / august 2007 dmm.Limit[y].High.Fail where y = 1 to 2 for limit number remarks this attribute returns the results of high limit y testing: 0 indicates test pass...
Page 241
Series 3700 system switch/multimeter reference manual section 9: instrument control library (icl) document number: 3700s-901-01 rev. A / august 2007 9-97 dmm.Limit[y].Low.Fail where y = 1 or 2 for limit number remarks this attribute returns the results of low limit y testing: 0 indicates test passed...
Page 242
Section 9: instrument control library (icl) series 3700 system switch/multimeter reference manual 9-98 document number: 3700s-901-01 rev. A / august 2007 dmm.Linesync remarks this attribute is only valid when dmm.Func = ―dcvolts‖, ―dccurrent‖, ―twowireohms‖, ―fourwireohms‖, ―temperature‖, ―continuit...
Page 243
Series 3700 system switch/multimeter reference manual section 9: instrument control library (icl) document number: 3700s-901-01 rev. A / august 2007 9-99 dmm.Makebuffer details (continued) to see readings in buffer: printbuffer(x, y, mybuffer) x and y: represent reading numbers desired to see readin...
Page 244
Section 9: instrument control library (icl) series 3700 system switch/multimeter reference manual 9-100 document number: 3700s-901-01 rev. A / august 2007 dmm.Math.Enable example to enable math operation on measurements: dmm.Math.Enable = dmm.On dmm.Math.Format attribute specifies the math operation...
Page 245
Series 3700 system switch/multimeter reference manual section 9: instrument control library (icl) document number: 3700s-901-01 rev. A / august 2007 9-101 dmm.Math.Format also see dmm.Math.Enable (on page 9-99) dmm.Math.Mxb.Bfactor (on page 9-101) dmm.Math.Mxb.Mfactor (on page 9-101) dmm.Math.Percen...
Page 246
Section 9: instrument control library (icl) series 3700 system switch/multimeter reference manual 9-102 document number: 3700s-901-01 rev. A / august 2007 dmm.Math.Mxb.Units attribute specifies the unit character for the y = mx + b operation. Usage to read unit character for y = mx + b operation: va...
Page 247
Series 3700 system switch/multimeter reference manual section 9: instrument control library (icl) document number: 3700s-901-01 rev. A / august 2007 9-103 dmm.Measure function handles taking measurements on the dmm without using the trigger model. Usage there are two ways to use this function: 1. To...
Page 248
Section 9: instrument control library (icl) series 3700 system switch/multimeter reference manual 9-104 document number: 3700s-901-01 rev. A / august 2007 dmm.Measurecount remarks this attribute controls the number of measurements taken any time a measurement is requested. When using a reading buffe...
Page 249
Series 3700 system switch/multimeter reference manual section 9: instrument control library (icl) document number: 3700s-901-01 rev. A / august 2007 9-105 dmm.Measurewithtime example to perform 100 dc voltage measurements and store then in a buffer, called mybuff, and print the last measurement: myb...
Page 250
Section 9: instrument control library (icl) series 3700 system switch/multimeter reference manual 9-106 document number: 3700s-901-01 rev. A / august 2007 dmm.Offsetcompensation attribute indicates the offset compensation setting for the dmm. Usage to read the offset compensation: value = dmm.Offset...
Page 251
Series 3700 system switch/multimeter reference manual section 9: instrument control library (icl) document number: 3700s-901-01 rev. A / august 2007 9-107 dmm.Open remarks aspects associated with this function include: opening the channels and analog backplane relays for a measuring function. The co...
Page 252
Section 9: instrument control library (icl) series 3700 system switch/multimeter reference manual 9-108 document number: 3700s-901-01 rev. A / august 2007 dmm.Opendetector attribute indicates the state of the thermocouple or four-wire ohms open lead detector being used. Usage to read the open lead d...
Page 253
Series 3700 system switch/multimeter reference manual section 9: instrument control library (icl) document number: 3700s-901-01 rev. A / august 2007 9-109 dmm.Range remarks this attribute is the range setting for the selected function (see dmm.Func) of the dmm. Querying the range when the selected f...
Page 254
Section 9: instrument control library (icl) series 3700 system switch/multimeter reference manual 9-110 document number: 3700s-901-01 rev. A / august 2007 dmm.Refjunction remarks this attribute is only valid when dmm.Func = "temperature". All other configurations generate an error and return nil whe...
Page 255
Series 3700 system switch/multimeter reference manual section 9: instrument control library (icl) document number: 3700s-901-01 rev. A / august 2007 9-111 dmm.Rel.Enable remarks this is the relative measurement control setting for the dmm and it applies to the selected function as indicated by dmm.F...
Page 256
Section 9: instrument control library (icl) series 3700 system switch/multimeter reference manual 9-112 document number: 3700s-901-01 rev. A / august 2007 dmm.Rel.Level example to perform an ac current measurement and use it as the relative offset value: dmm.Func = "accurrent" dmm.Rel.Level = dmm.Me...
Page 257
Series 3700 system switch/multimeter reference manual section 9: instrument control library (icl) document number: 3700s-901-01 rev. A / august 2007 9-113 dmm.Reset example to perform a reset on temperature only: dmm.Func = "temperature" dmm.Reset("active") to perform a reset on all dmm functions: d...
Page 258
Section 9: instrument control library (icl) series 3700 system switch/multimeter reference manual 9-114 document number: 3700s-901-01 rev. A / august 2007 dmm.Rtdbeta attribute indicates the user beta value for user type rtd. Usage to read the user type rtd beta value: value = dmm.Rtdbeta value: rep...
Page 259
Series 3700 system switch/multimeter reference manual section 9: instrument control library (icl) document number: 3700s-901-01 rev. A / august 2007 9-115 dmm.Rtddelta remarks this attribute is only valid when dmm.Func = "temperature". All other configurations generate an error and return nil when q...
Page 260
Section 9: instrument control library (icl) series 3700 system switch/multimeter reference manual 9-116 document number: 3700s-901-01 rev. A / august 2007 dmm.Rtdzero also see dmm.Rtdalpha (on page 9-113) dmm.Rtdbeta (on page 9-113) dmm.Rtddelta (on page 9-114) example to set user zero constant for ...
Page 261
Series 3700 system switch/multimeter reference manual section 9: instrument control library (icl) document number: 3700s-901-01 rev. A / august 2007 9-117 dmm.Setconfig function sets the dmm configuration associated with items specified in parameter list. Usage dmm.Setconfig(ch_list, dmm_config) ch_...
Page 262
Section 9: instrument control library (icl) series 3700 system switch/multimeter reference manual 9-118 document number: 3700s-901-01 rev. A / august 2007 dmm.Simreftemperature attribute indicates the simulated reference temperature for thermocouples. Usage to read the simulated reference temperatur...
Page 263
Series 3700 system switch/multimeter reference manual section 9: instrument control library (icl) document number: 3700s-901-01 rev. A / august 2007 9-119 dmm.Thermistor remarks this attribute is only valid when dmm.Func = "temperature". All other configurations generate an error and return nil when...
Page 264
Section 9: instrument control library (icl) series 3700 system switch/multimeter reference manual 9-120 document number: 3700s-901-01 rev. A / august 2007 dmm.Threertd attribute indicates the type of three-wire rtd being used. Usage to read the 3-wire rtd type: value = dmm.Threertd value: represents...
Page 265
Series 3700 system switch/multimeter reference manual section 9: instrument control library (icl) document number: 3700s-901-01 rev. A / august 2007 9-121 dmm.Threshold remarks this attribute is only valid when dmm.Func is equal to: ―frequency‖ ―period‖ ―continuity‖ all other configurations generate...
Page 266
Section 9: instrument control library (icl) series 3700 system switch/multimeter reference manual 9-122 document number: 3700s-901-01 rev. A / august 2007 dmm.Units attribute indicates the units for voltage and temperature measurements. Usage to read the units: value = dmm.Units value: represents th...
Page 267
Series 3700 system switch/multimeter reference manual section 9: instrument control library (icl) document number: 3700s-901-01 rev. A / august 2007 9-123 errorqueue functions and attributes use the functions and attributes in this group to read the entries in the error/event queue. Errorqueue.Clear...
Page 268
Section 9: instrument control library (icl) series 3700 system switch/multimeter reference manual 9-124 document number: 3700s-901-01 rev. A / august 2007 errorqueue.Next remarks entries are stored in a first-in, first-out (fifo) queue. This function reads the oldest entry and removes it from the qu...
Page 269
Series 3700 system switch/multimeter reference manual section 9: instrument control library (icl) document number: 3700s-901-01 rev. A / august 2007 9-125 eventlog functions and attributes use the functions and attributes in this group to control (read, write, enable, count, etc.,) the event log. Ev...
Page 270
Section 9: instrument control library (icl) series 3700 system switch/multimeter reference manual 9-126 document number: 3700s-901-01 rev. A / august 2007 eventlog.Clear function clears the event log. Usage eventlog.Clear() remarks this attribute erases any messages contained in the event log. Also ...
Page 271: Exit Function
Series 3700 system switch/multimeter reference manual section 9: instrument control library (icl) document number: 3700s-901-01 rev. A / august 2007 9-127 exit function use this function to terminate a script that is presently running. Exit function stops execution of a script. Usage exit() remarks ...
Page 272
Section 9: instrument control library (icl) series 3700 system switch/multimeter reference manual 9-128 document number: 3700s-901-01 rev. A / august 2007 format.Asciiprecision example sets the ascii precision to 7 digits and prints a number: format.Asciiprecision = 7 print(2.5) output: 2.500000e+00...
Page 273
Series 3700 system switch/multimeter reference manual section 9: instrument control library (icl) document number: 3700s-901-01 rev. A / august 2007 9-129 format.Data attribute the data format for data printed using the printnumber and printbuffer functions. Usage to read data format: fmt = format.D...
Page 274: Gpib Attribute
Section 9: instrument control library (icl) series 3700 system switch/multimeter reference manual 9-130 document number: 3700s-901-01 rev. A / august 2007 gpib attribute use the following attribute to set the gpib address. Gpib.Address attribute gpib address. Usage to read the gpib address: address ...
Page 275
Series 3700 system switch/multimeter reference manual section 9: instrument control library (icl) document number: 3700s-901-01 rev. A / august 2007 9-131 makegetter remarks this function creates a function that when called returns the value of the attribute. This function is useful for aliasing att...
Page 276: Icl Lan Commands
Section 9: instrument control library (icl) series 3700 system switch/multimeter reference manual 9-132 document number: 3700s-901-01 rev. A / august 2007 icl lan commands use the functions and attribute in this group to set/read the lan triggers. Lan.Applysettings function reinitializes the lan int...
Page 277
Series 3700 system switch/multimeter reference manual section 9: instrument control library (icl) document number: 3700s-901-01 rev. A / august 2007 9-133 lan.Config.Dns.Address[n] attribute configures dns server ip addresses. Usage to read the ip address: dnsaddress = lan.Config.Dns.Address[index] ...
Page 278
Section 9: instrument control library (icl) series 3700 system switch/multimeter reference manual 9-134 document number: 3700s-901-01 rev. A / august 2007 lan.Config.Dns.Domain remarks this attribute holds the domain to request during dynamic dns registration. Dynamic dns registration works with dhc...
Page 279
Series 3700 system switch/multimeter reference manual section 9: instrument control library (icl) document number: 3700s-901-01 rev. A / august 2007 9-135 lan.Config.Dns.Hostname attribute configures dynamic dns hostname. Usage to read dynamic dns hostname: hostname = lan.Config.Dns.Hostname to writ...
Page 280
Section 9: instrument control library (icl) series 3700 system switch/multimeter reference manual 9-136 document number: 3700s-901-01 rev. A / august 2007 lan.Config.Duplex attribute configures lan duplex mode. Usage to read lan duplex mode: duplex = lan.Config.Duplex to write lan duplex mode: lan.C...
Page 281
Series 3700 system switch/multimeter reference manual section 9: instrument control library (icl) document number: 3700s-901-01 rev. A / august 2007 9-137 lan.Config.Ipaddress attribute configures lan ip address. Usage to read the lan ip address: ipaddress = lan.Config.Ipaddress to write the lan ip ...
Page 282
Section 9: instrument control library (icl) series 3700 system switch/multimeter reference manual 9-138 document number: 3700s-901-01 rev. A / august 2007 lan.Config.Speed attribute configures lan speed. Usage to read lan speed: speed = lan.Config.Speed to write lan speed: lan.Config.Speed = speed s...
Page 283
Series 3700 system switch/multimeter reference manual section 9: instrument control library (icl) document number: 3700s-901-01 rev. A / august 2007 9-139 lan.Lxidomain attribute sets lxi domain. Usage to read the lxi domain: domain = lan.Lxidomain to write the lxi domain: lan.Lxidomain = domain dom...
Page 284
Section 9: instrument control library (icl) series 3700 system switch/multimeter reference manual 9-140 document number: 3700s-901-01 rev. A / august 2007 lan.Status.Dns.Hostname attribute reads present dns fully qualified host name. Usage to read dynamic dns hostname: hostname = lan.Status.Dns.Host...
Page 285
Series 3700 system switch/multimeter reference manual section 9: instrument control library (icl) document number: 3700s-901-01 rev. A / august 2007 9-141 lan.Status.Ipaddress attribute reads present lan ip address. Usage to read the lan ip address: ipaddress = lan.Config.Ipaddress to write the lan ...
Page 286
Section 9: instrument control library (icl) series 3700 system switch/multimeter reference manual 9-142 document number: 3700s-901-01 rev. A / august 2007 lan.Status.Port.Rawsocket attribute reads present lan raw socket connection port number. Usage port = lan.Status.Port.Rawsocket port: raw socket ...
Page 287
Series 3700 system switch/multimeter reference manual section 9: instrument control library (icl) document number: 3700s-901-01 rev. A / august 2007 9-143 lan.Status.Reset example to reset the lan interface: lan.Status.Reset() lan.Status.Speed attribute reads present lan speed. Usage speed = lan.Sta...
Page 288
Section 9: instrument control library (icl) series 3700 system switch/multimeter reference manual 9-144 document number: 3700s-901-01 rev. A / august 2007 lan.Pingenable attribute set or read the lan ping state. Usage to read the lan ping state: pingstate = lan.Pingenable to write the lan ping state...
Page 289
Series 3700 system switch/multimeter reference manual section 9: instrument control library (icl) document number: 3700s-901-01 rev. A / august 2007 9-145 lan.Trigger[n].Clear also see lan.Trigger[n].Assert (on page 9-143) lan.Trigger[n].Overrun (on page 9-146) lan.Trigger[n].Triggersource (on page ...
Page 290
Section 9: instrument control library (icl) series 3700 system switch/multimeter reference manual 9-146 document number: 3700s-901-01 rev. A / august 2007 lan.Trigger[n].Mode example to see the present lan trigger mode of lanevent 1 : print(lan.Trigger[1].Mode) lan.Trigger[n].Pseudostate attribute s...
Page 291
Series 3700 system switch/multimeter reference manual section 9: instrument control library (icl) document number: 3700s-901-01 rev. A / august 2007 9-147 lan.Trigger[n].Stimulus usage to read the trigger source: trigstim = lan.Trigger[n].Stimulus packet: the trigger packet over lan to query for sti...
Page 292: Localnode Attributes
Section 9: instrument control library (icl) series 3700 system switch/multimeter reference manual 9-148 document number: 3700s-901-01 rev. A / august 2007 lan.Trigger[n].Wait function wait for a trigger. Usage triggered = lan.Trigger[n].Wait(timeout) n: the trigger packet over lan to wait for (1 –8)...
Page 293
Series 3700 system switch/multimeter reference manual section 9: instrument control library (icl) document number: 3700s-901-01 rev. A / august 2007 9-149 localnode.Define.* .Max_timers .Max_dio_lines .Max_tsplink_trigs .Max_blenders .Max_blender_inputs .Max_lan_trigs example to read features maximu...
Page 294
Section 9: instrument control library (icl) series 3700 system switch/multimeter reference manual 9-150 document number: 3700s-901-01 rev. A / august 2007 localnode.Prompts attribute prompting mode. Usage to read prompting state: prompting = localnode.Prompts to write prompting state: localnode.Prom...
Page 295
Series 3700 system switch/multimeter reference manual section 9: instrument control library (icl) document number: 3700s-901-01 rev. A / august 2007 9-151 localnode.Reset remarks a system reset includes a channel.Reset('allslots'), dmm.Reset('all'), and a scan.Reset(). In addition: other system sett...
Page 296
Section 9: instrument control library (icl) series 3700 system switch/multimeter reference manual 9-152 document number: 3700s-901-01 rev. A / august 2007 localnode.Settime function set the current time of the system. Usage settime(hour, minute, second) or localnode.Settime(os.Time(year = , month = ...
Page 297
Series 3700 system switch/multimeter reference manual section 9: instrument control library (icl) document number: 3700s-901-01 rev. A / august 2007 9-153 localnode.Setup.Poweron example to set unit to power on with factory default settings: localnode.Setup.Poweron = 0 to query power on state: print...
Page 298
Section 9: instrument control library (icl) series 3700 system switch/multimeter reference manual 9-154 document number: 3700s-901-01 rev. A / august 2007 localnode.Setup.Save function saves the present setup as the user-setup. Usage to save to the internal memory location, send no parameters with f...
Page 299: Opc Function
Series 3700 system switch/multimeter reference manual section 9: instrument control library (icl) document number: 3700s-901-01 rev. A / august 2007 9-155 opc function use this function to set the opc bit in the status register when all overlapped commands are completed. Opc function sets the operat...
Page 300: Reset Function
Section 9: instrument control library (icl) series 3700 system switch/multimeter reference manual 9-156 document number: 3700s-901-01 rev. A / august 2007 printbuffer remarks correct usage when there are no outstanding overlapped commands to acquire data: 1 start_index end_index where n refers to th...
Page 301: Scan Functions
Series 3700 system switch/multimeter reference manual section 9: instrument control library (icl) document number: 3700s-901-01 rev. A / august 2007 9-157 reset remarks this function resets all logical instruments in the system. It is equivalent to iterating over all the logical instruments in the s...
Page 302
Section 9: instrument control library (icl) series 3700 system switch/multimeter reference manual 9-158 document number: 3700s-901-01 rev. A / august 2007 scan.Add remarks use this function to specify additional set of channels and/or channel patterns to scan. These items are appended to the end of ...
Page 303
Series 3700 system switch/multimeter reference manual section 9: instrument control library (icl) document number: 3700s-901-01 rev. A / august 2007 9-159 scan.Add example to clear the old scan list without resetting the entire scan configuration aspects: scan.Create("") to clear the old scan list a...
Page 304
Section 9: instrument control library (icl) series 3700 system switch/multimeter reference manual 9-160 document number: 3700s-901-01 rev. A / august 2007 scan.Background remarks this command specifies the reading buffer to use during scanning and the scan is executed in the background. The reading ...
Page 305
Series 3700 system switch/multimeter reference manual section 9: instrument control library (icl) document number: 3700s-901-01 rev. A / august 2007 9-161 scan.Create function creates a list of channels and/or channel patterns to scan. Usage scan.Create(ch_list, dmm_config) ch_list: a string listing...
Page 306
Section 9: instrument control library (icl) series 3700 system switch/multimeter reference manual 9-162 document number: 3700s-901-01 rev. A / august 2007 scan.Create example to clear the old scan list without resetting the entire scan configuration aspects: scan.Create("") to clear the old scan lis...
Page 307
Series 3700 system switch/multimeter reference manual section 9: instrument control library (icl) document number: 3700s-901-01 rev. A / august 2007 9-163 scan.Execute remarks this command specifies the reading buffer to use during scanning and runs the scan in immediate mode. The reading buffer wil...
Page 308
Section 9: instrument control library (icl) series 3700 system switch/multimeter reference manual 9-164 document number: 3700s-901-01 rev. A / august 2007 scan.Mode attribute use to set or query the scan.Mode value. Usage to read the scan.Mode value: init = scan.Mode init: the present scan.Mode sett...
Page 309
Series 3700 system switch/multimeter reference manual section 9: instrument control library (icl) document number: 3700s-901-01 rev. A / august 2007 9-165 scan.Nobufferbackground function specifies that no reading buffer is used during scanning. Scan is run in background mode. Usage state, scancount...
Page 310
Section 9: instrument control library (icl) series 3700 system switch/multimeter reference manual 9-166 document number: 3700s-901-01 rev. A / august 2007 scan.Nobufferexecute function specifies that no reading buffer is used during scanning. Scan is run in immediate mode. Usage state, scancount, st...
Page 311
Series 3700 system switch/multimeter reference manual section 9: instrument control library (icl) document number: 3700s-901-01 rev. A / august 2007 9-167 scan.Reset remarks this command will only reset the scan aspects of the system to factory default settings. Settings affects are: trigger model g...
Page 312
Section 9: instrument control library (icl) series 3700 system switch/multimeter reference manual 9-168 document number: 3700s-901-01 rev. A / august 2007 scan.State example to see the current scan state: scanstate = scan.State() print(scanstate) or print(scan.State()) scan.Stepcount attribute attri...
Page 313
Series 3700 system switch/multimeter reference manual section 9: instrument control library (icl) document number: 3700s-901-01 rev. A / august 2007 9-169 scan.Trigger.Arm.Stimulus usage to read the trigger stimulus: eventid = scan.Trigger.Arm.Stimulus eventid: present trigger stimulus being used fo...
Page 314
Section 9: instrument control library (icl) series 3700 system switch/multimeter reference manual 9-170 document number: 3700s-901-01 rev. A / august 2007 scan.Trigger.Channel.Set function set the channel event detector to the detected state. Usage scan.Trigger.Channel.Set() remarks this function wi...
Page 315
Series 3700 system switch/multimeter reference manual section 9: instrument control library (icl) document number: 3700s-901-01 rev. A / august 2007 9-171 scan.Trigger.Clear function clear the trigger model. Usage scan.Trigger.Clear() remarks this function will set the channel, measure and sample ev...
Page 316
Section 9: instrument control library (icl) series 3700 system switch/multimeter reference manual 9-172 document number: 3700s-901-01 rev. A / august 2007 scan.Trigger.Measure.Stimulus remarks this attribute selects which event(s) will cause the measure event detector to enter the detected state. Se...
Page 317
Series 3700 system switch/multimeter reference manual section 9: instrument control library (icl) document number: 3700s-901-01 rev. A / august 2007 9-173 scan.Trigger.Sequence.Set remarks this function will set the sequence event detector to the detected state. Example to set the sequence event det...
Page 318
Section 9: instrument control library (icl) series 3700 system switch/multimeter reference manual 9-174 document number: 3700s-901-01 rev. A / august 2007 setup functions and attribute use the functions and attribute in this group to save/recall setups and to set the power-on setup. Setup.Poweron at...
Page 319
Series 3700 system switch/multimeter reference manual section 9: instrument control library (icl) document number: 3700s-901-01 rev. A / august 2007 9-175 setup.Recall example to recall factory default settings: setup.Recall(0) to recall the user-setup (internal): setup.Recall(1) to recall a user sa...
Page 320: Slot[X] Attributes
Section 9: instrument control library (icl) series 3700 system switch/multimeter reference manual 9-176 document number: 3700s-901-01 rev. A / august 2007 setup.Save example to save the present setup as the internal user setup: setup.Save() to save a setup to a file named keithley_3730 on a usb flas...
Page 321
Series 3700 system switch/multimeter reference manual section 9: instrument control library (icl) document number: 3700s-901-01 rev. A / august 2007 9-177 slot[x].Commonsideohms example to query if slot 1 supports common-side 4-wire ohm channels: commonsideohms1 = slot[1].Commonsideohms slot[x].Digi...
Page 322
Section 9: instrument control library (icl) series 3700 system switch/multimeter reference manual 9-178 document number: 3700s-901-01 rev. A / august 2007 slot[x].Endchannel.Voltage attribute the ending channel that supports voltage or 2-wire measurements. Usage end = slot[x].Endchannel.Voltage [x]:...
Page 323
Series 3700 system switch/multimeter reference manual section 9: instrument control library (icl) document number: 3700s-901-01 rev. A / august 2007 9-179 slot[x].Interlock.Override attribute indicates if a card should error on closing backplane relays if interlock is disengaged. Usage to read inter...
Page 324
Section 9: instrument control library (icl) series 3700 system switch/multimeter reference manual 9-180 document number: 3700s-901-01 rev. A / august 2007 slot[x].Interlock.State remarks this attribute will not exist for a slot if a card is not installed or the card installed does not support detect...
Page 325
Series 3700 system switch/multimeter reference manual section 9: instrument control library (icl) document number: 3700s-901-01 rev. A / august 2007 9-181 slot[x].Maxvoltage attribute returns the maximum voltage supported by the card in slot x. Usage maxvolts = slot[x].Maxvoltage [x]: slot number (1...
Page 326
Section 9: instrument control library (icl) series 3700 system switch/multimeter reference manual 9-182 document number: 3700s-901-01 rev. A / august 2007 slot[x].Poles.One attribute indicates if the card supports one-pole. Usage onepole = slot[x].Poles.One [x]: slot number (1 to 6) remarks this att...
Page 327
Series 3700 system switch/multimeter reference manual section 9: instrument control library (icl) document number: 3700s-901-01 rev. A / august 2007 9-183 slot[x].Pseudocard attribute specifies the corresponding pseudocard to implement for the designated slot. Usage to read pseudo card for slot: pse...
Page 328
Section 9: instrument control library (icl) series 3700 system switch/multimeter reference manual 9-184 document number: 3700s-901-01 rev. A / august 2007 slot[x].Startchannel.Amps example to query for starting amps channel on slot 4: startampschan = slot[4].Startchannel.Amps slot[x].Startchannel.Is...
Page 329
Series 3700 system switch/multimeter reference manual section 9: instrument control library (icl) document number: 3700s-901-01 rev. A / august 2007 9-185 slot[x].Thermal.State attribute indicates the thermal state of a card, if supported. Usage value = slot[x].Thermal.State [x]: slot number (1 to 6...
Page 330
Section 9: instrument control library (icl) series 3700 system switch/multimeter reference manual 9-186 document number: 3700s-901-01 rev. A / august 2007 status function and attributes the following provides a brief overview of the status model. Details on the status model are provided in this manu...
Page 331
Series 3700 system switch/multimeter reference manual section 9: instrument control library (icl) document number: 3700s-901-01 rev. A / august 2007 9-187 status.Condition remarks this attribute is used to read the status byte, which is returned as a numeric value. The binary equivalent of the retur...
Page 332
Section 9: instrument control library (icl) series 3700 system switch/multimeter reference manual 9-188 document number: 3700s-901-01 rev. A / august 2007 status.Measurement.* .Condition .Enable .Event .Ntr .Ptr attribute measurement event status register set. Usage to read condition, enable, event,...
Page 333
Series 3700 system switch/multimeter reference manual section 9: instrument control library (icl) document number: 3700s-901-01 rev. A / august 2007 9-189 status.Measurement.* .Condition .Enable .Event .Ntr .Ptr remarks this attribute is used to read or write to the measurement registers. Reading a ...
Page 334
Section 9: instrument control library (icl) series 3700 system switch/multimeter reference manual 9-190 document number: 3700s-901-01 rev. A / august 2007 status.Node_enable attribute status node enable register. Reads status node enable register: nodeenabreg = status.Node_enable writes to system en...
Page 335
Series 3700 system switch/multimeter reference manual section 9: instrument control library (icl) document number: 3700s-901-01 rev. A / august 2007 9-191 status.Node_enable nodeenabreg can also be set to the decimal weight of the bit to be set: to set bit b0 (msb), set nodeenabreg to 1 (20). To set...
Page 336
Section 9: instrument control library (icl) series 3700 system switch/multimeter reference manual 9-192 document number: 3700s-901-01 rev. A / august 2007 status.Operation.* .Condition .Enable .Event .Ntr .Ptr attribute operation event status register set. Usage to read condition, enable, event, ntr...
Page 337
Series 3700 system switch/multimeter reference manual section 9: instrument control library (icl) document number: 3700s-901-01 rev. A / august 2007 9-193 status.Operation.* .Condition .Enable .Event .Ntr .Ptr details this attribute is used to read or write to the operation event registers. Reading ...
Page 338
Section 9: instrument control library (icl) series 3700 system switch/multimeter reference manual 9-194 document number: 3700s-901-01 rev. A / august 2007 status.Operation.User.* .Condition .Enable .Event .Ntr .Ptr attribute operation user event register set. Usage reads condition, enable, event, nt...
Page 339
Series 3700 system switch/multimeter reference manual section 9: instrument control library (icl) document number: 3700s-901-01 rev. A / august 2007 9-195 status.Operation.User.* .Condition .Enable .Event .Ntr .Ptr operreg can also be set to the decimal weight of the bit to be set: to set user bit0,...
Page 340
Section 9: instrument control library (icl) series 3700 system switch/multimeter reference manual 9-196 document number: 3700s-901-01 rev. A / august 2007 status.Questionable.* .Condition .Enable .Event .Ntr .Ptr attribute questionable event status register set. Usage reads condition, enable, event,...
Page 341
Series 3700 system switch/multimeter reference manual section 9: instrument control library (icl) document number: 3700s-901-01 rev. A / august 2007 9-197 status.Questionable.* .Condition .Enable .Event .Ntr .Ptr remarks this attribute is used to read or write to the questionable event registers. Re...
Page 342
Section 9: instrument control library (icl) series 3700 system switch/multimeter reference manual 9-198 document number: 3700s-901-01 rev. A / august 2007 status.Request_enable attribute service request enable register. Usage reads service request enable register: servenabreg = status.Request_enable...
Page 343
Series 3700 system switch/multimeter reference manual section 9: instrument control library (icl) document number: 3700s-901-01 rev. A / august 2007 9-199 status.Request_enable remarks this attribute is used to read or write to the service request enable register. Reading the service request enable ...
Page 344
Section 9: instrument control library (icl) series 3700 system switch/multimeter reference manual 9-200 document number: 3700s-901-01 rev. A / august 2007 status.Standard.* .Condition .Enable .Event attribute standard event register set. Usage reads condition, enable and event registers: standardreg...
Page 345
Series 3700 system switch/multimeter reference manual section 9: instrument control library (icl) document number: 3700s-901-01 rev. A / august 2007 9-201 status.Standard.* .Condition .Enable .Event remarks this attribute is used to read or write to the standard event registers. Reading a status reg...
Page 346
Section 9: instrument control library (icl) series 3700 system switch/multimeter reference manual 9-202 document number: 3700s-901-01 rev. A / august 2007 status.System.* .Condition .Enable .Event attribute tsp-link system data structure register set. Usage to read condition, enable and event regist...
Page 347
Series 3700 system switch/multimeter reference manual section 9: instrument control library (icl) document number: 3700s-901-01 rev. A / august 2007 9-203 status.System.* .Condition .Enable .Event example sets the extension bit of the system enable register: status.System.Enable = status.System.Ext ...
Page 348
Section 9: instrument control library (icl) series 3700 system switch/multimeter reference manual 9-204 document number: 3700s-901-01 rev. A / august 2007 status.System2.* .Condition .Enable .Event also see status.System.* (on page 9-201) status.System3.* (on page 9-204) status.System4.* (on page 9-...
Page 349
Series 3700 system switch/multimeter reference manual section 9: instrument control library (icl) document number: 3700s-901-01 rev. A / august 2007 9-205 status.System3.* .Condition .Enable .Event also see status.System.* (on page 9-201) status.System2.* (on page 9-203) status.System4.* (on page 9-...
Page 350
Section 9: instrument control library (icl) series 3700 system switch/multimeter reference manual 9-206 document number: 3700s-901-01 rev. A / august 2007 status.System4.* .Condition .Enable .Event remarks in an expanded system (tsp- link), this attribute is used to read or write to the system4 node...
Page 351
Series 3700 system switch/multimeter reference manual section 9: instrument control library (icl) document number: 3700s-901-01 rev. A / august 2007 9-207 status.System5.* .Condition .Enable .Event attribute tsp-link system5 data structure register set. Usage to read condition, enable and event regi...
Page 352: Timer Functions
Section 9: instrument control library (icl) series 3700 system switch/multimeter reference manual 9-208 document number: 3700s-901-01 rev. A / august 2007 timer functions use the functions in this group to control the timer. The timer can be used to measure the time it takes to perform various opera...
Page 353: Trigger.Timer
Series 3700 system switch/multimeter reference manual section 9: instrument control library (icl) document number: 3700s-901-01 rev. A / august 2007 9-209 trigger.Timer use the functions in this group to control the trigger timer. Trigger.Timer[n].Clear function clears trigger time[n]. Usage trigger...
Page 354
Section 9: instrument control library (icl) series 3700 system switch/multimeter reference manual 9-210 document number: 3700s-901-01 rev. A / august 2007 trigger.Timer[n].Delay remarks this attribute sets a fixed timer delay. Each time the timer is triggered it will use this delay period. Trigger.T...
Page 355
Series 3700 system switch/multimeter reference manual section 9: instrument control library (icl) document number: 3700s-901-01 rev. A / august 2007 9-211 trigger.Timer[n].Stimulus remarks this attribute selects which event will start the timer. Eventid may be one of the following (existing trigger ...
Page 356: Tsplink.Trigger
Section 9: instrument control library (icl) series 3700 system switch/multimeter reference manual 9-212 document number: 3700s-901-01 rev. A / august 2007 tsplink.Trigger the functions in this group control the tsp-link's trigger event detector. Tsplink.Trigger[n].Assert function simulates the occur...
Page 357
Series 3700 system switch/multimeter reference manual section 9: instrument control library (icl) document number: 3700s-901-01 rev. A / august 2007 9-213 tsplink.Trigger[n].Mode attribute the trigger operation/detection mode. Usage to read trigger operation/detection mode: mode = tsplink.Trigger[n]...
Page 358
Section 9: instrument control library (icl) series 3700 system switch/multimeter reference manual 9-214 document number: 3700s-901-01 rev. A / august 2007 tsplink.Trigger[n].Overrun remarks this attribute is a read-only attribute. It indicates if an event was ignored due to the event detector being ...
Page 359: Trigger Functions
Series 3700 system switch/multimeter reference manual section 9: instrument control library (icl) document number: 3700s-901-01 rev. A / august 2007 9-215 tsplink.Trigger[n].Wait function wait for a trigger. Usage triggered = tsplink.Trigger[n].Wait(timeout) n: (in) the trigger line (1 –3). Timeout:...
Page 360
Section 9: instrument control library (icl) series 3700 system switch/multimeter reference manual 9-216 document number: 3700s-901-01 rev. A / august 2007 trigger.Wait example waits up to 10 seconds for a trigger: triggered = trigger.Wait(10) print(triggered) output: false the above output indicates...
Page 361
Series 3700 system switch/multimeter reference manual section 9: instrument control library (icl) document number: 3700s-901-01 rev. A / august 2007 9-217 trigger.Blender[n].Overrun remarks this attribute is a read-only attribute that indicates if an event was ignored because the event detector was ...
Page 362
Section 9: instrument control library (icl) series 3700 system switch/multimeter reference manual 9-218 document number: 3700s-901-01 rev. A / august 2007 trigger.Blender[n].Wait function this function waits for a blender trigger. Usage triggered = trigger.Blender[n].Wait(timeout) n: (in) the trigge...
Page 363: Userstring Functions
Series 3700 system switch/multimeter reference manual section 9: instrument control library (icl) document number: 3700s-901-01 rev. A / august 2007 9-219 tsplink.Reset function initializes (resets) all nodes (instruments) in the tsp-link system. Usage tsplink.Reset() remarks this function will eras...
Page 364
Section 9: instrument control library (icl) series 3700 system switch/multimeter reference manual 9-220 document number: 3700s-901-01 rev. A / august 2007 userstring.Add example stores user-defined strings in non- volatile memory: userstring.Add("assetnumber", "236") userstring.Add("department", "wi...
Page 365: Upgrade
Series 3700 system switch/multimeter reference manual section 9: instrument control library (icl) document number: 3700s-901-01 rev. A / august 2007 9-221 userstring.Delete also see userstring.Add (on page 9-219) userstring.Catalog (on page 9-220) userstring.Get (on page 9-221) example deletes user-...
Page 366: Waitcomplete Function
Section 9: instrument control library (icl) series 3700 system switch/multimeter reference manual 9-222 document number: 3700s-901-01 rev. A / august 2007 waitcomplete function this function waits for all overlapped commands to complete. Waitcomplete function waits for all overlapped commands to com...
Page 367: Introduction
In this section: introduction ..................................................................................................... 10-1 verification test requirements .......................................................................... 10-2 performing the verification test procedures ...........
Page 368
Section 10: verification series 3700 system switch/multimeter reference manual 10-2 document number: 3700s-901-01 rev. A / august 2007 verification test requirements be sure that you perform the verification tests: under the proper environmental conditions. After the specified warm-up period. Using ...
Page 369
Series 3700 system switch/multimeter reference manual section 10: verification document number: 3700s-901-01 rev. A / august 2007 10-3 note the keithley instruments model 3706-190 backplane connector board is an accessory that can be used to make connections to the calibrator. Additional boards, suc...
Page 370
Section 10: verification series 3700 system switch/multimeter reference manual 10-4 document number: 3700s-901-01 rev. A / august 2007 for example, assume that you are testing the 10k range using an actual 10.03k calibration resistance value. Using series 3700 one-year 10k range accuracy of (60ppm o...
Page 371: Series 3700 Verification
Series 3700 system switch/multimeter reference manual section 10: verification document number: 3700s-901-01 rev. A / august 2007 10-5 connections of the dmm or switch card terminals to circuits higher than cat i can cause damage to the equipment or expose the operator to hazardous voltages when per...
Page 372
Section 10: verification series 3700 system switch/multimeter reference manual 10-6 document number: 3700s-901-01 rev. A / august 2007 6. Source positive and negative full-scale and half-scale voltages for each of the ranges listed below. For each voltage setting, be sure that the reading is within ...
Page 373
Series 3700 system switch/multimeter reference manual section 10: verification document number: 3700s-901-01 rev. A / august 2007 10-7 applied voltage range voltage lower limit upper limit verify dcv 100v 1.00e+02 1.00e+02 9.999540e+01 1.000046e+02 verify dcv 100v 1.00e+02 5.00e+01 4.999740e+01 5.00...
Page 374
Section 10: verification series 3700 system switch/multimeter reference manual 10-8 document number: 3700s-901-01 rev. A / august 2007 5. Repeat steps 3 and 4 for each item in the table. Figure 10-2: acv verification acv verification data use the following values to verify the performance of the ser...
Page 375
Series 3700 system switch/multimeter reference manual section 10: verification document number: 3700s-901-01 rev. A / august 2007 10-9 applied voltage range voltage lower limit upper limit verify acv 300v @ 100khz 3.00e+02 3.00e+02 2.979600e+02 3.020400e+02 verifying dc current 10ua-100ua ranges che...
Page 376
Section 10: verification series 3700 system switch/multimeter reference manual 10-10 document number: 3700s-901-01 rev. A / august 2007 figure 10-3: dc current verification 10ua-100ua ranges dc current verification data 10ua-100ua ranges use the following values to verify the performance of the seri...
Page 377
Series 3700 system switch/multimeter reference manual section 10: verification document number: 3700s-901-01 rev. A / august 2007 10-11 verifying dc current 1ma-3a ranges check dc current accuracy by applying accurate current from the dc current calibrator to the series 3700 analog backplane connect...
Page 378
Section 10: verification series 3700 system switch/multimeter reference manual 10-12 document number: 3700s-901-01 rev. A / august 2007 dc current verification data 1ma to 3a ranges use the following values to verify the performance of the series 3700. Actual values are dependent on published specif...
Page 379
Series 3700 system switch/multimeter reference manual section 10: verification document number: 3700s-901-01 rev. A / august 2007 10-13 7. Install the fluke 5724a amplifier. 8. Source ac current for the 3a range test points summarized in the ac current verification data table. Be sure that the 3a re...
Page 380
Section 10: verification series 3700 system switch/multimeter reference manual 10-14 document number: 3700s-901-01 rev. A / august 2007 applied current range current lower limit upper limit verify ac curr 1ma @ 1khz 1.00e-03 1.00e-03 9.989000e-04 1.001100e-03 verify ac curr 10ma @ 1khz 1.00e-02 1.00...
Page 381
Series 3700 system switch/multimeter reference manual section 10: verification document number: 3700s-901-01 rev. A / august 2007 10-15 frequency verification data use the following values to verify the performance of the series 3700. Actual values are dependent on published specifications (see exam...
Page 382
Section 10: verification series 3700 system switch/multimeter reference manual 10-16 document number: 3700s-901-01 rev. A / august 2007 7. Source the nominal full-scale resistance values for the 100 -10m ranges summarized in the resistance verification table. Recalculate the limits based on the actu...
Page 383
Series 3700 system switch/multimeter reference manual section 10: verification document number: 3700s-901-01 rev. A / august 2007 10-17 to verify normal resistance accuracy: 1. Using shielded, teflon-insulated or equivalent cables in a 2-wire configuration, connect the series 3700 input and sense pi...
Page 384
Section 10: verification series 3700 system switch/multimeter reference manual 10-18 document number: 3700s-901-01 rev. A / august 2007 two-wire resistance verification data use the following values to verify the performance of the series 3700. Actual values are dependent on published specifications...
Page 385
Series 3700 system switch/multimeter reference manual section 10: verification document number: 3700s-901-01 rev. A / august 2007 10-19 8. Source the nominal full-scale resistance values for the 100 -2k ranges summarized in the dry circuit resistance verification table. Verify that the readings are ...
Page 386
Section 10: verification series 3700 system switch/multimeter reference manual 10-20 document number: 3700s-901-01 rev. A / august 2007 3. Select the slow integration rate with the rate key. 4. Set the series 3700 for the 1 range, and make sure the filter is on. Enable oc+ (offset- compensated ohms)...
Page 387
Series 3700 system switch/multimeter reference manual section 10: verification document number: 3700s-901-01 rev. A / august 2007 10-21 verifying zeroes using a four-wire short check the zeroes of various testpoints while the four-wire is connected to the series 3700 analog backplane connector and v...
Page 388
Section 10: verification series 3700 system switch/multimeter reference manual 10-22 document number: 3700s-901-01 rev. A / august 2007 6. Verify the 10 range zero is within specification (see the 4-wire short applied resistance verification table). Figure 10-11: four-wire short diagram 4-wire short...
Page 389: Environmental Conditions
Use the procedures in this section to calibrate the keithley instruments series 3700 system switch/multimeter. Warning the information in this section is intended only for qualified service personnel. Do not attempt these procedures unless you are qualified to do so. All procedures in this section r...
Page 390: Calibration Considerations
Section 11: calibration series 3700 system switch/multimeter reference manual 11-2 document number: 3700s-901-01 rev. A / august 2007 line power the series 3700 requires a line voltage of 100v-240v (±10%), and a line frequency of 50hz or 60hz. Note the line frequency is automatically sensed at power...
Page 391: Calibration
Series 3700 system switch/multimeter reference manual section 11: calibration document number: 3700s-901-01 rev. A / august 2007 11-3 recommended equipment the following table lists the recommended equipment and settings you need for comprehensive, dc-only, and ac-only calibration procedures. Altern...
Page 392
Section 11: calibration series 3700 system switch/multimeter reference manual 11-4 document number: 3700s-901-01 rev. A / august 2007 remote comprehensive calibration procedure note u.U.T. Stands for unit under test. To perform calibration, use the following procedure: step 1. Prepare the series 370...
Page 393
Series 3700 system switch/multimeter reference manual section 11: calibration document number: 3700s-901-01 rev. A / august 2007 11-5 2. Wait during the five minute delay. 3. Perform the following calibration steps (dc cal step 0 through step 5): figure 11-1: four-wire short diagram dc cal step 0: a...
Page 394
Section 11: calibration series 3700 system switch/multimeter reference manual 11-6 document number: 3700s-901-01 rev. A / august 2007 dc cal step 2: open circuit figure 11-2: dc volts verification 1. Remove the 4-wire short from the inputs. 2. Send the following commands: send dmm.Calibration.Dc(2) ...
Page 395
Series 3700 system switch/multimeter reference manual section 11: calibration document number: 3700s-901-01 rev. A / august 2007 11-7 2. Send the following commands: send dmm.Calibration.Dc(4,-10) print("done") send print(errorqueue.Count) dc cal step 5: 100 volt 1. Send the following command: send ...
Page 396
Section 11: calibration series 3700 system switch/multimeter reference manual 11-8 document number: 3700s-901-01 rev. A / august 2007 3. Send the following command: send dmm.Calibration.Dc(6,(resistor value)) print("done") dc cal step 7: 10kohm 1. Send the following command: send dmm.Range = 10e+3 2...
Page 397
Series 3700 system switch/multimeter reference manual section 11: calibration document number: 3700s-901-01 rev. A / august 2007 11-9 dc current calibration make the connections as shown, then perform the following calibration steps (dc cal step 10 through step 14): figure 11-4: dc current verificat...
Page 398
Section 11: calibration series 3700 system switch/multimeter reference manual 11-10 document number: 3700s-901-01 rev. A / august 2007 dc cal step 11: 1ma 1. Send the following command: send dmm.Range = 1e-3 2. Source 1ma. 3. Send the following command: send dmm.Calibration.Dc(11,.001) print("done")...
Page 399
Series 3700 system switch/multimeter reference manual section 11: calibration document number: 3700s-901-01 rev. A / august 2007 11-11 ac volts calibration make the connections as shown below, then perform the following calibration steps (ac cal step 1 through step 10): figure 11-5: acv verification...
Page 400
Section 11: calibration series 3700 system switch/multimeter reference manual 11-12 document number: 3700s-901-01 rev. A / august 2007 3. Send the following command: send dmm.Calibration.Ac(2) print("done") ac cal step 3: 100mv @ 50khz 1. Source 100mv @ 50khz 2. Send the following command: send dmm....
Page 401
Series 3700 system switch/multimeter reference manual section 11: calibration document number: 3700s-901-01 rev. A / august 2007 11-13 2. Send the following command: send dmm.Calibration.Ac(7) print("done") ac cal step 8: 100v @ 1khz 1. Send the following command: send dmm.Range = 100 2. Source 100v...
Page 402
Section 11: calibration series 3700 system switch/multimeter reference manual 11-14 document number: 3700s-901-01 rev. A / august 2007 ac current calibration make the connections as shown, then perform the following calibration steps (ac cal step 11 through step 16): figure 11-6: ac current verifica...
Page 403
Series 3700 system switch/multimeter reference manual section 11: calibration document number: 3700s-901-01 rev. A / august 2007 11-15 ac cal step 13: 10ma @ 1khz 1. Send the following command: send dmm.Range = 10e-3 2. Source 10ma @ 1khz 3. Send the following command: send dmm.Calibration.Ac(13) pr...
Page 404
Section 11: calibration series 3700 system switch/multimeter reference manual 11-16 document number: 3700s-901-01 rev. A / august 2007 frequency calibration make the connections as shown below, then perform the following calibration steps (ac cal step 17 and step 18): ac cal step 17: 1v @ 10hz 1. Se...
Page 405
Series 3700 system switch/multimeter reference manual section 11: calibration document number: 3700s-901-01 rev. A / august 2007 11-17 dmm.Calibration.Save() dmm.Calibration.Lock() dmm.Reset() note calibration is complete after is has been saved and locked..
Page 407: Introduction
In this section: introduction ..................................................................................................... 12-1 fuse replacement ........................................................................................... 12-1 front panel tests ..................................
Page 408: Front Panel Tests
Section 12: maintenance series 3700 system switch/multimeter reference manual 12-2 document number: 3700s-901-01 rev. A / august 2007 figure 12-1: fuse location fuse location rating keithley instruments part number (1) analog backplane fuse 250v, 3a fast blow 5x20mm fu-99-1 (2) instrument fuse 250v ...
Page 409
Series 3700 system switch/multimeter reference manual section 12: maintenance document number: 3700s-901-01 rev. A / august 2007 12-3 2. Turn the wheel to scroll to the display menu item and press the enter key to select. 3. Press the enter key to select test. 4. Select keys or display-patterns and ...
Page 411: Introduction
In this section: introduction ..................................................................................................... 13-1 error summary ................................................................................................ 13-1 error effects on scripts..........................
Page 412: Reading Errors
Section 13: error codes series 3700 system switch/multimeter reference manual 13-2 document number: 3700s-901-01 rev. A / august 2007 reading errors when errors occur, the error messages will be placed in the error queue. Use error queue commands to request error message information. For example, th...
Page 413
Series 3700 system switch/multimeter reference manual section 13: error codes document number: 3700s-901-01 rev. A / august 2007 13-3 error number error level error message -221 recoverable settings conflict -220 recoverable parameter -203 recoverable command protected -200 recoverable execution err...
Page 414
Section 13: error codes series 3700 system switch/multimeter reference manual 13-4 document number: 3700s-901-01 rev. A / august 2007 error number error level error message 1116 recoverable configuration error %s where %s explains why configuration error 1200 recoverable tsplink initialization faile...
Page 415
Series 3700 system switch/multimeter reference manual section 13: error codes document number: 3700s-901-01 rev. A / august 2007 13-5 error number error level error message 2101 fatal could not close socket 2102 recoverable lan configuration already in progress 2103 recoverable lan disabled 2104 rec...
Page 416
Section 13: error codes series 3700 system switch/multimeter reference manual 13-6 document number: 3700s-901-01 rev. A / august 2007 error number error level error message 4904 recoverable icx parameter count mismatch, %s (line #%d) where %s and %d provide more information on error 4905 recoverable...
Page 417
Series 3700 system switch/multimeter reference manual section 13: error codes document number: 3700s-901-01 rev. A / august 2007 13-7 error number error level error message 5518 recoverable slot error, communication error accessing configuration data. 5519 recoverable slot error, timeout error acces...
Page 418
Section 13: error codes series 3700 system switch/multimeter reference manual 13-8 document number: 3700s-901-01 rev. A / august 2007 error number error level error message 5630 recoverable 100 4-w dckt ioff zero error 5631 recoverable 100 4-w dckt ion zero error 5632 recoverable 10 4-w dckt ioff ze...
Page 419
Series 3700 system switch/multimeter reference manual section 13: error codes document number: 3700s-901-01 rev. A / august 2007 13-9 error number error level error message 5666 recoverable 1 aac full scale error 5667 recoverable 3 aac zero error 5668 recoverable 3 aac full scale error 5669 recovera...
Page 420
Section 13: error codes series 3700 system switch/multimeter reference manual 13-10 document number: 3700s-901-01 rev. A / august 2007 error number error level error message 5702 recoverable 1 4-w dckt ioff zero error 5703 recoverable 100 4-w ioff zero error 5704 recoverable 10k 4-w ioff zero error ...
Page 421
Series 3700 system switch/multimeter reference manual section 13: error codes document number: 3700s-901-01 rev. A / august 2007 13-11 error number error level error message 5738 recoverable communication error with dmm in requested operation 5739 recoverable dmm calibration error occurred during pr...
Page 423: Index
Document number: 3700s-901-01 rev. A / august 2007 index - 1 2 2- wire scan process • 7-3 4 4- wire scan process • 7-3 4- wire short applied verification data • 10-22 a ac cal step 1 10mv @ 1khz • 11-11 ac cal step 10 300v @ 1khz • 11-13 ac cal step 11 100ua @ 1khz • 11-14 ac cal step 12 1ma @ 1khz ...
Page 424
Index - 2 document number: 3700s-901-01 rev. A / august 2007 aperture • 3-11 append • 6-4 assigning a value to an attribute • 9-3 attributes • 9-3 auto key • 3-18 auto ranging • 4-3 auto ranging over the front panel • 3-18, 4-2 autodelay • 3-11 autoexec script • 2-19 autorange • 3-11 autorun scripts...
Page 425
Document number: 3700s-901-01 rev. A / august 2007 index - 3 creating a user script • 2-16, 2-19 cursor keys • 3-18 d data store (buffer) commands • 6-4 db commands • 5-7 db configuration • 5-8 db scanning • 5-8 dbref • 3-12 dc cal step 0 a/d mux offset cal • 11-5 dc cal step 1 input short circuit •...
Page 426
Index - 4 document number: 3700s-901-01 rev. A / august 2007 discrete resistance verification data • 10-20 display • 3-1, 3-3 display functions and attributes • 9-54 display key • 3-6 display user- defined messages • 2-13 displaying the unit's s erial number • 1-2 dmm configuration • 9-6 dmm functio...
Page 427
Document number: 3700s-901-01 rev. A / august 2007 index - 5 function keys • 3-1, 3-18 functions • 2-25, 9-2 functions and attributes • 9-2 fuse replacement • 12-1 g gpib address • 2-9 gpib attribute • 9-130 gpib interface connection • 2-9 i icl commands • 7-10 icl lan commands • 3-2, 3-7, 9-132 idl...
Page 428
Index - 6 document number: 3700s-901-01 rev. A / august 2007 mx+b rel • 5-3 n named scripts • 2-3 negative and positive transition registers • 8-1 nonvolatile memory • 2-6 nplc • 3-13 o offsetcomp • 3-13 opc function • 9-155 open all key • 3-18 open key • 3-19 opendetect • 3-13 operation event regis...
Page 429
Document number: 3700s-901-01 rev. A / august 2007 index - 7 read and write to digital i/o port • 2-12 reading an attribute • 9-3 reading buffer designations • 6-5 reading buffers • 6-4, 9-99 reading errors • 13-2 reading registers • 8-9, 8-12 rear panel summary • 2-8, 2-9, 2-10 recall key • 3-19 re...
Page 430
Index - 8 document number: 3700s-901-01 rev. A / august 2007 script management • 2-20 script using a function • 2-14 script using commands and statements only • 2-13 scripted chunk • 2-5 scripts • 2-3 sending commands and statements • 2-12 sequential and non- sequential scans • 7-1 serial polling an...
Page 431
Document number: 3700s-901-01 rev. A / august 2007 index - 9 test summary • 10-4 thermo • 3-14 threshold • 3-14 time and date values • 6-8 timer functions • 9-208 timestamp • 6-3 trig key • 3-17 trigger functions • 9-215 trigger model • 7-4 trigger model components • 7-5 trigger.Blender • 9-216 trig...
Page 432
Index - 10 document number: 3700s-901-01 rev. A / august 2007 x x and y • 9-2.
Page 433: Service Form
12/06 service form model no. Serial no. Date name and telephone no. Company list all control settings, describe problem and check boxes that apply to problem. ❏ intermittent ❏ analog output follows display ❏ particular range or function bad; specify ❏ ieee failure ❏ obvious problem on power-up ❏ bat...
Page 434
12/06 specifications are subject to change without notice. All keithley trademarks and trade names are the property of keithley instruments, inc. All other trademarks and trade names are the property of their respective companies. A g r e a t e r m e a s u r e o f c o n f i d e n c e keithley instru...