Keithley 3700 series Reference Manual

Other manuals for 3700 series: Installation Instructions Manual
Manual is about: System Switch/Multimeter

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