3700S-901 (B - Mar 2008)(FtCr).qxd 7/31/08 11:50 AM Page 1 www.keithley.com www.keithley.com Series 3700 System Switch/Multimeter Series 3700 System Switch/Multimeter Reference Manual Reference Manual 3700S-901-01 Rev. C / July 2008 3700S-901-01 Rev.
WARRANTY Keithley Instruments, Inc. warrants this product to be free from defects in material and workmanship for a period of one (1) year from date of shipment. Keithley Instruments, Inc. warrants the following items for 90 days from the date of shipment: probes, cables, software, rechargeable batteries, diskettes, and documentation. During the warranty period, Keithley Instruments will, at its option, either repair or replace any product that proves to be defective.
Series 3700 System Switch/Multimeter Reference Manual ©2008, Keithley Instruments, Inc. Cleveland, Ohio, U.S.A. All rights reserved. Any unauthorized reproduction, photocopy, or use the information herein, in whole or in part, without the prior written approval of Keithley Instruments, Inc. is strictly prohibited. TSPTM, TSP-LinkTM, and TSP-NetTM are trademarks of Keithley Instruments, Inc. All Keithley Instruments product names are trademarks or registered trademarks of Keithley Instruments, Inc.
Safety Precautions 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. This product is intended for use by qualified personnel who recognize shock hazards and are familiar with the safety precautions required to avoid possible injury.
voltage being measured. The instrument and accessories must be used in accordance with its specifications and operating instructions, or the safety of the equipment may be impaired. Do not exceed the maximum signal levels of the instruments and accessories, as defined in the specifications and operating information, and as shown on the instrument or test fixture panels, or switching card. When fuses are used in a product, replace with the same type and rating for continued protection against fire hazard.
Table of Contents Introduction ............................................................................................................................... 1-1 Contact information ............................................................................................................................. 1-1 Overview .............................................................................................................................................. 1-1 Measure and switching capabilities ........
Table of Contents Series 3700 System Switch/Multimeter Reference Manual Loading a script from the Series 3700 front panel ...................................................................................... 2-28 Saving a script from the Series 3700 front panel ....................................................................................... 2-29 Modifying a user script ...............................................................................................................................
Series 3700 System Switch/Multimeter Reference Manual Table of Contents POWER switch .......................................................................................................................................... 4-17 RESET switch ............................................................................................................................................ 4-17 Operation keys ..........................................................................................................
Table of Contents Series 3700 System Switch/Multimeter Reference Manual Filter ..................................................................................................................................................... 5-8 Filter characteristics ..................................................................................................................................... 5-8 Digital filter window ..............................................................................................
Series 3700 System Switch/Multimeter Reference Manual Table of Contents Trigger model components .......................................................................................................................... 8-5 Scan and step counts .......................................................................................................................... 8-7 Basic scan procedure ....................................................................................................................
Table of Contents Series 3700 System Switch/Multimeter Reference Manual Configuring and enabling IEEE-1588 ................................................................................................ 11-3 Scheduling alarms ..................................................................................................................................... 11-5 Monitoring alarms with LAN triggers and LXI event log .................................................................... 11-6 LXI event log .
Series 3700 System Switch/Multimeter Reference Manual Table of Contents Instrument Control Library (ICL) ........................................................................................... 13-1 Command programming notes .......................................................................................................... 13-1 Wild characters ..........................................................................................................................................
Table of Contents Series 3700 System Switch/Multimeter Reference Manual Verification............................................................................................................................... 14-1 Introduction ........................................................................................................................................ 14-1 Verification test requirements ...........................................................................................................
Series 3700 System Switch/Multimeter Reference Manual Table of Contents Maintenance ............................................................................................................................ 16-1 Introduction ........................................................................................................................................ 16-1 Fuse replacement ............................................................................................................................
List of Figures Figure 1-1: DMM measurement capabilities ................................................................................................. 1-2 Figure 2-1: TSP test script example ............................................................................................................. 2-7 Figure 2-2: Programming model for scripts .................................................................................................. 2-9 Figure 2-3: Rear panel features ..........................
List of Figures Series 3700 System Switch/Multimeter Reference Manual Figure 8-8: Either edge input trigger ........................................................................................................... 8-23 Figure 8-9: Either edge output trigger ......................................................................................................... 8-24 Figure 8-10: SynchronousM input trigger ...................................................................................................
Series 3700 System Switch/Multimeter Reference Manual List of Figures Figure 14-5: DC current verification 3A range diagram ............................................................................ 14-14 Figure 14-6: AC current verification 1mA to 1A range .............................................................................. 14-16 Figure 14-7: AC current verification 3A range ..........................................................................................
Section 1 Introduction In this section: Contact information ........................................................... 1-1 Overview ........................................................................... 1-1 Warranty information .........................................................
Section 1: Introduction Series 3700 System Switch/Multimeter Reference Manual Measure and switching capabilities The basic measurement capabilities of Series 3700 systems are summarized in the following figure. Figure 1-1: DMM measurement capabilities Warranty information Detailed warranty information is located at the front of this manual. Should your Series 3700 require warranty service, contact the Keithley Instruments representative or authorized repair facility in your area for further information.
Series 3700 System Switch/Multimeter Reference Manual WARNING Section 1: Introduction Before removing (or installing) switching modules, make sure you turn off the Series 3700 and disconnect the line cord. Also, remove any other external power connected to the instrument or switching module(s). Failure to disconnect power before removing (or installing) switching modules may result in personal injury or death due to electric shock.
Section 2 TSP Programming Fundamentals In this section: Introduction ....................................................................... 2-1 Test Script Processor (TSPTM) ........................................ 2-2 Run-time environment ....................................................... 2-3 Queries ............................................................................. 2-3 Scripts ............................................................................... 2-4 Named scripts ...............
Section 2: TSP Programming Fundamentals Series 3700 System Switch/Multimeter Reference Manual Test Script Processor (TSPTM) The Test Script Processor (TSP) is a scripting engine that runs inside the instrument. It is capable of running code written in a scripting language called Lua (http://www.lua.org). This makes the instrument fully capable of interpreting and executing code in a way that is similar to Visual Basic (VB) or Java, rather than only responding to single-line commands.
Series 3700 System Switch/Multimeter Reference Manual Section 2: TSP Programming Fundamentals Run-time environment A feature of all scripting environments is the run-time environment. In the TSPTM, the run-time environment is simply a temporary collection of global variables. A global variable can be used to remember a value as long as the unit is powered on and the variable is not assigned a new value.
Section 2: TSP Programming Fundamentals Series 3700 System Switch/Multimeter Reference Manual Scripts When taking advantage of the TSPTM to perform more complicated sequences of commands, especially sequences utilizing advanced scripting features such as looping and branching, sending the entire sequence in one message is very cumbersome. Use the loadscript and endscript messages to collect a sequence of commands into one chunk. The loadscript message marks the beginning of a script.
Series 3700 System Switch/Multimeter Reference Manual Section 2: TSP Programming Fundamentals Named scripts The loadscript message can also be used to create named scripts. Loading a named script does not replace the anonymous script. Instead, a global variable in the run-time environment is temporarily created to store the script. Because the script is stored in a global variable, the name of the script must be a legal TSL variable name.
Section 2: TSP Programming Fundamentals Series 3700 System Switch/Multimeter Reference Manual Programming overview Chunk defined A chunk is a single programming statement or a sequence of statements that are executed sequentially (that is, sent to Lua as a single line). There are nonscripted and scripted chunks.
Series 3700 System Switch/Multimeter Reference Manual Section 2: TSP Programming Fundamentals Script defined The Series 3700 utilizes a Test Script Processor (TSP) to process and run individual chunks or scripts. A script is a collection of instrument control commands and programming statements. The TSP test script example (on page 2-7) shows an example of how to create and load a script.
Section 2: TSP Programming Fundamentals Series 3700 System Switch/Multimeter Reference Manual Run-time environment The run-time environment is a collection of global variables (scripts) that you have created. After scripts are placed into the run-time environment, they are then ready to be run and/or managed.
Series 3700 System Switch/Multimeter Reference Manual Section 2: TSP Programming Fundamentals Programming model for scripts User-created scripts can be stored in nonvolatile memory. When the Series 3700 is turned on, all user script functions are recalled into the run-time environment from nonvolatile memory. If any user scripts have been programmed to run automatically, they will run after all the scripts are loaded.
Section 2: TSP Programming Fundamentals Series 3700 System Switch/Multimeter Reference Manual Installing the TSPTM software To install the TSP software: 1. Close all programs. 2. Place the CD (Keithley Instruments part number KTS-850B01 or greater) into your CD-ROM drive. 3. Follow the on-screen instructions. If your web browser does not start automatically and display a screen with software installation links, open the installation file (index.html) found on the CD to initiate automatic installation.
Series 3700 System Switch/Multimeter Reference Manual Item Description 4 Instrument fuse 5 Power connector 6 Digital I/O port 7 GPIB connector 8 Ethernet connector 9 USB connector 10 Analog backplane connector Section 2: TSP Programming Fundamentals GPIB interface connection Use a shielded IEEE-488 cable to connect the Series 3700 IEEE-488 connector to the GPIB connector on the control computer. Connect one end of the cable to the host computer and the other end to Series 3700.
Section 2: TSP Programming Fundamentals Series 3700 System Switch/Multimeter Reference Manual GPIB address At the factory, the GPIB is set to address value 16. The address value can be set to any address value between 0 and 30. However, the address cannot conflict with the address assigned to other instruments in the system. Change the GPIB address from the GPIB menu. To access the menu, press the MENU key and select GPIB. The GPIB address is saved in nonvolatile memory.
Series 3700 System Switch/Multimeter Reference Manual Section 2: TSP Programming Fundamentals USB connection Connect a computer controller to the Series 3700 rear panel USB (from host) connector (connect USB flash drive devices to the Series 3700 front panel USB). Refer to Rear panel summary (on page 2-10) for connector location. NOTE For your Series 3700 to be recognized by your computer over the USB interface, the proper driver must be installed.
Section 2: TSP Programming Fundamentals Series 3700 System Switch/Multimeter Reference Manual Figure 2-5: Using Test Script Builder (TSB) Project Navigator The Project Navigator resides in the window pane on the left side of the workspace. The navigator consists of project folders and the script files (.tsp) created for each project. Each project folder can have one or more script files.
Series 3700 System Switch/Multimeter Reference Manual Section 2: TSP Programming Fundamentals Programming interaction Up to seven tabs can be displayed in the lower pane of the workspace (the script editor) to provide programming interaction between the Test Script Builder and the Series 3700. The instrument console shown in Using Test Script Builder (TSB) (on page 2-13) is used to send commands to the connected Series 3700.
Section 2: TSP Programming Fundamentals Series 3700 System Switch/Multimeter Reference Manual Read and write to the digital I/O port The digital I/O port of the Series 3700 is used to control external circuitry (such as a component handler for binning operations). The I/O port has 14 input/output bits (lines) that can be at TTL logic state 1 (high) or 0 (low). See the pinout in the graphic in Rear panel summary (on page 2-10) for the Digital I/O port for additional information.
Series 3700 System Switch/Multimeter Reference Manual Section 2: TSP Programming Fundamentals Script examples Script using commands and statements only The following script closes Channels 1-10 on Slot 3 and measures voltage on each channel. The ten voltage readings are returned to the host computer, as well as being stored in a voltage table on the instrument, using the channel numbers as keys to index the table.
Section 2: TSP Programming Fundamentals Series 3700 System Switch/Multimeter Reference Manual Script using a function TSL facilitates grouping commands and statements using the function keyword. Therefore, a script can also consist of one or more functions. Once a script has been run, the host computer can then call a function in the script directly.
Series 3700 System Switch/Multimeter Reference Manual Section 2: TSP Programming Fundamentals Interactive script An interactive script prompts the operator (on the Series 3700 display) to input test parameters (using the Series 3700 front panel). The chunk fragment in the following table uses display messages to prompt the operator to select a measure function (DCV or 2-wire) and a range based on function, and to input the measurement speed.
Section 2: TSP Programming Fundamentals Series 3700 System Switch/Multimeter Reference Manual Creating a user script To create a script and load it, the test program (chunk) must be framed by the following shell commands: loadscript or loadandrunscript, and endscript. Load only The following scripts will load only into the run-time environment of the Series 3700.
Series 3700 System Switch/Multimeter Reference Manual Section 2: TSP Programming Fundamentals A script saved in nonvolatile memory named autoexec has special properties that cause it to run automatically after the Series 3700 is powered on and all autorun scripts have been executed. For details, see Autoexec script (on page 2-26) and Autorun scripts (on page 2-26). loadandrunscript loadsandrunscript name Where: name is the user-assigned name for the script.
Section 2: TSP Programming Fundamentals Series 3700 System Switch/Multimeter Reference Manual Get or change the name attribute of a script The following commands are used to get or change the name attribute of a script: val = myscript.name -- read the name of myscript myscript.name = val -- change the name of myscript Where: myscript is the script val is the name of the script This attribute may optionally be initialized when the script is created. See Loading a user script (on page 2-24) (script.
Series 3700 System Switch/Multimeter Reference Manual Section 2: TSP Programming Fundamentals Saving a named script Only a named script can be saved in nonvolatile memory of the Series 3700. After creating and loading a named script, use one of the following commands to save it. myscript.save() -- To save script in internal memory myscript.save('filename') -- To save script on flash drive Where: myscript is the user-defined name of the script.
Section 2: TSP Programming Fundamentals Series 3700 System Switch/Multimeter Reference Manual The anonymous script may be saved to the flash drive without setting the name attribute. For example, to save the anonymous script on the flash drive as "MyAnonTest.tsp": script.anonymous.save('/usb1/MyAnonTest.tsp') Loading this file ('MyAnonTest.tsp') back into the unit from the flash drive will cause an existing anonymous script to be overwritten.
Series 3700 System Switch/Multimeter Reference Manual Section 2: TSP Programming Fundamentals To execute the myuserlist script: script.user.scripts.myuserlist() mylist() Running a user script Running an unnamed script There can only be one unnamed (anonymous) script in the run-time environment. If another anonymous script is created and loaded, the previous anonymous script will be removed from the run-time environment. On the front panel, an unnamed script appears as .
Section 2: TSP Programming Fundamentals Series 3700 System Switch/Multimeter Reference Manual 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 be set to autorun. The run order for these scripts is arbitrary, so make sure the run order is not important. To set a script for autorun, set one of the following autorun attributes to "yes." Setting it to "no" disables autorun. myscript.autorun script.user.
Series 3700 System Switch/Multimeter Reference Manual Section 2: TSP Programming Fundamentals Running a user script from the Series 3700 front panel Use the following commands to enter or delete a name in the User menu option from the LOAD key: display.loadmenu.add(displayname, chunk) display.loadmenu.delete(displayname) Where: displayname is the name to be added to (or deleted from) the User menu. chunk is the name of the chunk (Lua executable code).
Section 2: TSP Programming Fundamentals Series 3700 System Switch/Multimeter Reference Manual Loading a script from the Series 3700 front panel To load a script from a USB flash drive: 1. Press the MENU key to open the main menu. 2. Select the SCRIPT option. 3. Select the LOAD option. A menu is displayed that includes the USB option. 4. Select the USB option. A menu is displayed that lists the .tsp files and directories on the flash drive.
Series 3700 System Switch/Multimeter Reference Manual Section 2: TSP Programming Fundamentals Saving a script from the Series 3700 front panel To save a script to internal memory or a USB flash drive: 1. Press the MENU key to bring up the Main Menu. 2. Select the SCRIPT option. 3. Select the SAVE option to bring up a menu listing the scripts available to save from the script.user.scripts table. This may take several seconds before displaying. 4. Select the script that you want to save.
Section 2: TSP Programming Fundamentals Series 3700 System Switch/Multimeter Reference Manual Script management Retrieving a user script You can retrieve the source code contained in a user script from nonvolatile memory, which can then be modified and saved as a user script under the same name or a new name. NOTE You can load a modified user script into the Series 3700 using the same name or a new name.
Series 3700 System Switch/Multimeter Reference Manual Section 2: TSP Programming Fundamentals Deleting a script from the system To completely remove a script from the system, all references to the script will need to be deleted from the run-time environment. A script may be removed from the run-time environment by assigning it to nil.
Section 2: TSP Programming Fundamentals Series 3700 System Switch/Multimeter Reference Manual Differences: Remote versus local state The Series 3700 can be in either the local state or the remote state. When it is in the local state (REM annunciator off), the instrument is operated using the front panel controls. When it is in the remote state (REM annunciator on), instrument operation is controlled by the computer. When the instrument is powered-on, it is in the local state.
Series 3700 System Switch/Multimeter Reference Manual Section 2: TSP Programming Fundamentals 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 into remote operation (REM annunciators turn on). The node running the script becomes the primary node and can control all of the other nodes, which become its subordinates.
Section 2: TSP Programming Fundamentals Series 3700 System Switch/Multimeter Reference Manual Variables and types TSL has six basic types: nil, boolean, number, string, function, and table. TSL is a dynamically typed language, which means variables do not need to be declared as a specific type. Instead, variables assume a type when a value is assigned to them. Therefore, each value carries its own type. If a variable has not been assigned a value, the variable defaults to the type nil.
Series 3700 System Switch/Multimeter Reference Manual Section 2: TSP Programming Fundamentals Relational operators: < (less than) > (greater than) <= (less than or equal) >= (greater than or equal) ~= (not equal) == (equal) Logical operators: and or not Functions TSL allows you to define functions which can take a pre-defined number of parameters and return multiple parameters.
Section 2: TSP Programming Fundamentals Series 3700 System Switch/Multimeter Reference Manual This function returns multiple parameters (sum, difference, and ratio of the two numbers passed to it): function sum_diff_ratio(parameter1, parameter2) psum = parameter1 + parameter2 pdif = parameter1 – parameter2 prat = parameter1 / parameter2 return psum, pdif, prat end sum, diff, ratio = sum_diff_ratio(2,3) print(sum) print(diff) print(ratio) The function's output is: 7 12 5 -1 0.
Series 3700 System Switch/Multimeter Reference Manual Section 2: TSP Programming Fundamentals Tables can be indexed using element names instead of numeric indices. Because functions are first-class variables, tables can be used to create "pseudoclasses." Classes are often used in object-oriented programming. Below is a table used to create a circle pseudoclass.
Section 2: TSP Programming Fundamentals Series 3700 System Switch/Multimeter Reference Manual or All operators are left associative, except for "^" (exponentiation) and "..", which are right associative. Therefore, the following expressions on the left are equivalent to those on the right: a+i < b/2+1 (a+i)< ((b/2)+1) 5+x^2*8 5+((x^2)*8) a < y and y <= z (a < y) and (y <= z) -x^2 -(x^2) x^y^z x^(y^z) Logical operators The logical operators are and, or, and not.
Series 3700 System Switch/Multimeter Reference Manual Section 2: TSP Programming Fundamentals For example, it sets x to a default value v when x is not set (provided that x is not set to false).
Section 2: TSP Programming Fundamentals Series 3700 System Switch/Multimeter Reference Manual Branching TSL uses the if keyword to do conditional branching. ---------------- IF blocks ----------------- This is if expression 1. Zero is true in Lua language; this is a contrast to C language, where 0 evaluates false. In TSL, nil is false and everything else is true. if 0 then print("Zero is true!") else print("Zero is false.") end x = 1 y = 2 -- This is if expression 2.
Series 3700 System Switch/Multimeter Reference Manual Section 2: TSP Programming Fundamentals Output of code above: Zero ' if ' if ' if x is is true! ' expression ' expression ' expression not equal to 2 was not false. 3 was not false. 4 was false. 10, and y is not less than 2. Loop control TSL has familiar constructs for doing things repetitively or until an expression evaluates to false.
Section 2: TSP Programming Fundamentals Series 3700 System Switch/Multimeter Reference Manual ---------------- REPEAT loop ---------------print("Counting elements in list") print("using repeat") element = 1 repeat print(element, list[element]) element = element + 1 until not list[element] Output of code above: Counting from one 1 One 2 Two 3 Three Counting from one in steps of two: 1 One 3 Three Counting elements on numeric index 1 One 2 Two 3 Three 4 Four 5 Five 6 Six Counting elements using repeat 1 One
Series 3700 System Switch/Multimeter Reference Manual Section 2: TSP Programming Fundamentals Base library functions print(x) Prints the argument x to the active host interface, using the tostring() function to convert x to a string. collectgarbage([limit]) Sets the garbage-collection threshold to the given limit (in Kbytes) and checks it against the byte counter. If the new threshold is smaller than the byte counter, then TSL immediately runs the garbage collector.
Section 2: TSP Programming Fundamentals Series 3700 System Switch/Multimeter Reference Manual String library functions This library provides generic functions for string manipulation, such as finding and extracting substrings. When indexing a string in TSL, the first character is at position 1 (not 0 as in ANSI C). Indices may be negative and are interpreted as indexing backward from the end of the string. Thus, the last character is at position 1, and so on.
Series 3700 System Switch/Multimeter Reference Manual Section 2: TSP Programming Fundamentals Math library functions This library is an interface to most of the functions of the ANSI C math library. All trigonometric functions work in radians. The functions math.deg() and math.rad() convert between radians and degrees. Function Definition math.abs(x) Returns the absolute value of the argument x. math.acos(x) Returns the principal value of the trigonometric arc cosine function of x. math.
Section 2: TSP Programming Fundamentals Series 3700 System Switch/Multimeter Reference Manual Function Definition math.frexp() Splits x into a fraction f and exponent n, such that f is 0.0 or 0.5 <= | f | <= 1.0, and f * 2n is equal to x. Both f and n are returned: f,n = math.frexp(x). math.ldexp(x, n) Returns the inverse of the math.frexp() function; it computes the value x * 2n. math.random([x],[ y]) When called without an argument, returns a pseudo-random real number in the range [0, 1].
Section 3 TSP Advanced Features In this section: Introduction ....................................................................... 3-1 Using groups to manage nodes on TSP-LinkTM network . 3-4 Running parallel test scripts .............................................. 3-6 Using the data queue for real-time communication ........... 3-8 Copying test scripts across the TSP-LinkTM network ....... 3-8 Removing stale values from the reading buffer .................
Section 3: TSP Advanced Features Series 3700 System Switch/Multimeter Reference Manual Figure 3-1: Multiple TSP-Link networks 3-2 3700S-901-01 Rev.
Series 3700 System Switch/Multimeter Reference Manual Section 3: TSP Advanced Features The second method to run parallel test scripts is to use groups with a single TSP-Link network. A group consists of one or more nodes with the same group number. Each group on the TSP-Link network can run different test scripts at the same time (in parallel). The following figure displays a TSP-Link network with groups. This method requires one TSP-Link network and a single GPIB connection to the PC.
Section 3: TSP Advanced Features Series 3700 System Switch/Multimeter Reference Manual The following table describes the functions of a single TSP-Link network. Each group in this example runs multiple test scripts at the same time or in parallel (see the previous figure).
Series 3700 System Switch/Multimeter Reference Manual Section 3: TSP Advanced Features Master node overview The master node is always the node that coordinates activity on the TSP-Link network. All nodes assigned to group 0 belong to the same group as the master node.
Section 3: TSP Advanced Features Series 3700 System Switch/Multimeter Reference Manual Reassigning groups Use the following code to change group assignment. You can add or remove a node to a group at anytime. -- Assigns the node to a different group. node[N].tsplink.group = G Running parallel test scripts You can issue the execute command from the master node to initiate test script and TSL code on a remote node. The execute command places the remote node in the overlapped operation state.
Series 3700 System Switch/Multimeter Reference Manual Section 3: TSP Advanced Features Coordinating overlapped operations in remote groups Errors occur if you send a command to a node in a remote group running an overlapped operation. All nodes in a group must be in the overlapped idle state before the master node can send a command to the group.
Section 3: TSP Advanced Features Series 3700 System Switch/Multimeter Reference Manual Using the data queue for real-time communication You cannot access the reading buffers or global variables from any node in a remote group while a node in that group is performing an overlapped operation. You can use the data queue to retrieve data from any node in a group performing an overlapped operation. In addition, the master node and the group leaders can use the data queue as a way to coordinate activities.
Series 3700 System Switch/Multimeter Reference Manual Section 3: TSP Advanced Features Removing stale values from the reading buffer The node that acquires the data stores the data for the reading buffer. To optimize data access, all nodes can cache data from the node that stores the reading buffer data. Running TSL code remotely can return stale values from the reading buffer to the cached data.
Section 3: TSP Advanced Features Series 3700 System Switch/Multimeter Reference Manual Commands related to TSP advanced features dataqueue.add() Function Store an item of data in the data queue. Usage success = dataqueue.add(value[, timeout]) value: The data item to add. timeout: Maximum amount of time in seconds to wait for room in the queue if it is full. success: Success indication. Remarks This function will add one entry to the data queue.
Series 3700 System Switch/Multimeter Reference Manual Section 3: TSP Advanced Features dataqueue.count Remarks This attribute is a read-only attribute that indicates how many entries are in the data queue. dataqueue.next() Function Retrieve an entry from the data queue. Usage value = dataqueue.next([timeout]) timeout: Maximum amount of time in seconds to wait for data if the queue is empty. value: The next entry from the data queue.
Section 3: TSP Advanced Features Series 3700 System Switch/Multimeter Reference Manual localnode.getglobal() Remarks This function will return the value of the given global variable. This function is provided to allow code running on a remote master node to retrieve values of variables from that node. This function should not be used to retrieve the value of a global variable on the local node when using the local node as the master. Accessing the variable directly is far more efficient.
Series 3700 System Switch/Multimeter Reference Manual Section 3: TSP Advanced Features tsplink.trigger[N].assert() Function Simulates the occurrence of the trigger and generates the corresponding event id. Usage tsplink.trigger[N].assert() N: The trigger line to assert (1–3). Remarks This function will generate a trigger pulse on the given TSP-LinkTM trigger line. Also see tsplink.trigger[N].clear() (on page 3-13) tsplink.trigger[N].mode (on page 3-13) tsplink.trigger[N].
Section 3: TSP Advanced Features Series 3700 System Switch/Multimeter Reference Manual tsplink.trigger[N].mode Remarks This attribute controls the mode in which the trigger event detector as well as the output trigger generator will operate on the given trigger line. mode can be one of the following values: tsplink.TRIG_BYPASS Allow direct control of the line. tsplink.TRIG_EITHER Detect rising or falling edge triggers as input. Assert a TTL-low pulse for output. tsplink.
Series 3700 System Switch/Multimeter Reference Manual Section 3: TSP Advanced Features tsplink.trigger[N].mode Also see tsplink.trigger[N].assert (on page 3-12) tsplink.trigger[N].clear() (on page 3-13) tsplink.trigger[N].overrun (on page 3-15) tsplink.trigger[N].release() (on page 3-15) tsplink.trigger[N].stimulus (on page 13-298) tsplink.trigger[N].wait() (on page 3-15) tsplink.trigger[N].overrun Attribute Event detector overrun status. Usage overrun = tsplink.trigger[N].
Section 3: TSP Advanced Features Series 3700 System Switch/Multimeter Reference Manual tsplink.trigger[N].wait() Function Wait for a trigger. Usage triggered = tsplink.trigger[N].wait(timeout) N: The trigger line (1–3). timeout: Maximum amount of time in seconds to wait for the trigger. triggered: Trigger detection indication. Remarks This function will wait for an input trigger. If one or more trigger events were detected since the last time tsplink.trigger[N].wait() or tsplink.trigger[N].
Section 4 Using the Front Panel In this section: Front panel introduction .................................................... 4-1 Display .............................................................................. 4-4 Special keys and power switch ....................................... 4-11 Operation keys ................................................................ 4-17 Range keys, cursor keys, and navigation wheel ............. 4-32 Action keys .....................................................
Section 4: Using the Front Panel NOTE Series 3700 System Switch/Multimeter Reference Manual Only widths of one are supported by the front panel when reading or writing to a Digital I/O channel.
Series 3700 System Switch/Multimeter Reference Manual NOTE Section 4: Using the Front Panel To see current settings for LAN, see the applicable lan.status.* commands (for example, to see the present IP address of the Series 3700, send the following command: lan.status.ipaddress (on page 13-201). Figure 4-3: Model 3706-NFP System Switch/Multimeter Figure 4-4: Model 3706-SNFP System Switch (no DMM) 3700S-901-01 Rev.
Section 4: Using the Front Panel Series 3700 System Switch/Multimeter Reference Manual Display The Series 3700 display provides visual information on the present active channel, including the channel selected (or range or pattern), channel state, last DMM measurement reading (where applicable), DMM settings (where applicable), and error indications.
Series 3700 System Switch/Multimeter Reference Manual Section 4: Using the Front Panel See the following figure (labeled "Active channel display example") for an active channel example. The 4W and AUTO range annunciators are lit (1). Also, the active channel is 1004 (Slot 1, Channel 004) (2). The present state of the channel is open and it has two poles (3).
Section 4: Using the Front Panel Series 3700 System Switch/Multimeter Reference Manual Annunciator Description REL Relative enabled for selected DMM function. REM Instrument in bus remote mode or web interface control mode (all interfaces, LAN, GPIB, or USB). SRQ Service request over GPIB. TALK Instrument addressed to talk over GPIB bus. TRIG ON when the front panel has requested a reading from the DMM. OFF when the reading is finished.
Series 3700 System Switch/Multimeter Reference Manual Section 4: Using the Front Panel Front panel DMM attribute Symbol Values internal reference junction RJ_INT N/A external reference junction RJ_EXT N/A NOTE To access the main menu, press the MENU key. See the following figure for a menu example. In the example, the MAIN MENU is displayed. Turn the navigation wheel (6) or press the CURSOR keys to scroll through the available menu items.
Section 4: Using the Front Panel Series 3700 System Switch/Multimeter Reference Manual Channel type indication When selecting channels, the following information is displayed, which indicates the channel type on the front panel. For switch channels, the name of the assigned DMM configuration (for example, “nofunction”, “dcvolts”, “my4wire”, and so on) is displayed and below it, the channel state (for example, OPN or CLS, along with 2 or 4 for pole setting) is displayed.
Series 3700 System Switch/Multimeter Reference Manual Section 4: Using the Front Panel Using the front panel with non-switch channels To read a value from the main front panel screen, select the channel and press TRIG. To see a digital I/O channel in hex format (instead of normal binary) use CONFIG+TRIG. A star symbol (*) or exclamation point symbol (!) may appear after the reading. The meaning of the symbol depends on channel type.
Section 4: Using the Front Panel Front Panel Channel Setting Totalizer mode settings DAC mode settings 4-10 Series 3700 System Switch/Multimeter Reference Manual Symbol Definition Symbol meaning I (uppercase "i") Digital input mode Used with 6-character label O Digital output mode Used with 6-character label P Digital output protected mode Used with 6-character label Rise Ed Totalizer rising edge mode Used with 12-character label or no label Fall Ed Totalizer falling edge mode Used wi
Series 3700 System Switch/Multimeter Reference Manual Front Panel Channel Setting DAC output enable settings Section 4: Using the Front Panel Symbol Definition Symbol meaning pI2 Protected current function 2 mode Used with 12-character label or no label Off Output enable is disabled Used with 6 or 12 character label On Output enable is enabled Used with 6 or 12 character label Special keys and power switch CONFIG key Press the CONFIG key to access an attribute menu that enables you to config
Section 4: Using the Front Panel Series 3700 System Switch/Multimeter Reference Manual The CHAN ATTR menu contains: LABEL: Sets the label associated with the specified channel. From the front panel, the label can be up to 12 characters. Remotely, the label may be up to 20 characters. This option will not be displayed if multiple channels are selected. Related ICL command: channel.setlabel() (on page 13-74). BACKPLANE: Opens the BACKPLANE menu.
Series 3700 System Switch/Multimeter Reference Manual Section 4: Using the Front Panel MODE Sets the mode attribute on a channel. Select one of the following options: INPUT OUTPUT OUTPUT_PROTECTED Related ICL command: channel.setmode() (on page 13-77). MATCH Sets the match value on a channel. Enter the value as 8-bit binary. Related ICL command: channel.setmatch() (on page 13-76). MATCH_TYPE Sets the match type on a channel.
Section 4: Using the Front Panel Series 3700 System Switch/Multimeter Reference Manual MODE Sets the mode attribute on a channel. Select one of the following options: EDGE. Indicates the edge for the Totalizer channel to increment its count. Select from one of the following options: FALLING RISING THRESHOLD. Indicates the threshold range. Select from one of the following options: TTL NON_TTL RESET. Indicates if the count value gets reset after being read.
Series 3700 System Switch/Multimeter Reference Manual Section 4: Using the Front Panel POWER Sets the power state attribute on a channel. Select one of the following options: ENABLE DISABLE Related ICL command: channel.setpowerstate() (on page 13-80) CONFIG CHAN key - DAC channel type Press the CONFIG CHAN key to open the DAC ATTR menu. The DAC ATTR menu is not available when a range of channels is selected.
Section 4: Using the Front Panel Series 3700 System Switch/Multimeter Reference Manual MODE Sets the mode attribute on a channel. Select one of the following options: FUNCTION. Sets the desired function for a channel. Select one of the following options: VOLTAGE CURRENT_1 CURRENT_2 PROTECT. Indicates if the protection mode for a channel is enabled. Select one of the following options: AUTO OFF Related ICL command: channel.setmode() (on page 13-77). OUTPUT Sets the output enable attribute on a channel.
Series 3700 System Switch/Multimeter Reference Manual Section 4: Using the Front Panel POWER switch Press this switch to turn the Series 3700 on (I). Press it again to turn the Series 3700 off (O). RESET switch Use the RESET switch to restore the Series 3700 factory default LAN settings. Refer to the LAN functions and attributes (on page 13-190) (lan.config.x, where x represents the specific command) for factory default information.
Section 4: Using the Front Panel Series 3700 System Switch/Multimeter Reference Manual READ Displays a value from a channel as 8-bit binary. This menu option does not appear if a range of channels is selected. Related ICL command: channel.read() (on page 13-67). NOTE Only widths of one are supported by the front panel when reading or writing to a Digital I/O channel. WRITE Writes a value to a channel. Enter the value as 8-bit binary. Related ICL command: channel.write() (on page 13-83).
Series 3700 System Switch/Multimeter Reference Manual Section 4: Using the Front Panel RESET Restores the factory default settings of selected channels or all channels. Related ICL command: channel.reset() (on page 13-68). CHAN key - DAC channel type Press the CHAN key to open the DAC ACTION menu. Unless noted, the menu option supports a range of selected channels.
Section 4: Using the Front Panel Series 3700 System Switch/Multimeter Reference Manual RESET_STATE Resets the channel state. Related ICL command: channel.resetstatelatch() (on page 13-70). RESET Restores the factory default settings of selected channels or all channels. Related ICL command: channel.reset() (on page 13-68). DELETE key Press the DELETE key to delete the first occurrence of the selected channel(s) or channel pattern (including function) from the scan list.
Series 3700 System Switch/Multimeter Reference Manual Section 4: Using the Front Panel DMM key Press the DMM key to open the DMM ACTION menu. The DMM ACTION menu contains the following items: MEASURE: Takes measurements on the digital multimeter (DMM) without using the trigger model. Related ICL command: dmm.measure() (on page 13-150). COUNT: Indicates the number of measurements to take when a measurement is requested. Related ICL command: dmm.measurecount (on page 13-151).
Section 4: Using the Front Panel Series 3700 System Switch/Multimeter Reference Manual AUTODELAY Configures the auto delay setting for the active DMM function. Related ICL command: dmm.autodelay (on page 13-112). AUTORANGE Configures the auto range setting for the DMM. Related ICL command: dmm.autorange (on page 13-113). AUTOZERO Configures the auto zero setting for the DMM. Related ICL command: dmm.autozero (on page 13-114). DBREF Configures the DB reference setting for the DMM in volts.
Series 3700 System Switch/Multimeter Reference Manual Section 4: Using the Front Panel INPUTDIV Enables or disables the 10M input divider. Related ICL command: dmm.inputdivider (on page 13-140). LIMIT Opens the LIMIT menu for the selected DMM function. See LIMIT key configuration (on page 4-27). LINESYNC Enables or disables line sync during measurements. Related ICL command: dmm.linesync (on page 13-144). MATH Selecting the MATH menu item opens the MATH MENU.
Section 4: Using the Front Panel Series 3700 System Switch/Multimeter Reference Manual OPENDETECT Configures the state of the thermocouple or 4-wire ohms open detector that is being used. Related ICL command: dmm.opendetector (on page 13-155). RANGE Configures the range of DMM for the selected function for one channel type. For more information, see Range (on page 5-1). Related ICL command: dmm.range (on page 13-156). REL Opens the REL menu for the selected DMM function.
Series 3700 System Switch/Multimeter Reference Manual Section 4: Using the Front Panel UNITS Configures the units for voltage and temperature measurements. Related ICL command: dmm.units (on page 13-174). ENTER key Press the ENTER key to accept the current selection or bring up the next menu options. NOTE Pressing the navigation wheel performs the same function as the ENTER key. EXIT key Press the EXIT key to: Cancel the selection and to return to the previous menu display. Exit remote operation.
Section 4: Using the Front Panel Series 3700 System Switch/Multimeter Reference Manual FUNCtion key Each press of the FUNC key immediately configures the DMM for the next function in the list: dcvolts: DC voltage acvolts: AC voltage dccurrent: DC current accurrent: AC current twowireohms: 2-wire ohm (resistance) fourwireohms: 4-wire ohm (resistance) commonsideohms: Common-side ohm (resistance) frequency: Frequency period: Period continuity: Continuity temperature: Temperature For example, if the DMM funct
Series 3700 System Switch/Multimeter Reference Manual Section 4: Using the Front Panel LIMIT key Press the LIMIT key to cycle through the four combinations of limit state settings: Limit1 and Limit2 off Limit1 on and Limit2 off Limit1 off and Limit2 on Limit1 and Limit2 on LIMIT key configuration Pressing the CONFIG key and then the LIMIT key opens the LIMIT menu. Select LIMIT 1 or LIMIT 2 to open the desired LIMIT 1 or LIMIT 2 menu.
Section 4: Using the Front Panel Series 3700 System Switch/Multimeter Reference Manual MENU key Press the MENU key to open the MAIN menu. The MAIN menu contains the following items: SCRIPT: Opens the SCRIPT menu that contains LOAD and SAVE menu items. SETUP: Opens the SETUP menu that contains SAVE, RECALL, POWERON, and RESET menu items. GPIB: Opens the GPIB menu that contains ADDRESS and ENABLE menu items. LAN: Opens the LAN menu that contains STATUS, CONFIG, APPLY, RESET, and ENABLE menu items.
Series 3700 System Switch/Multimeter Reference Manual Section 4: Using the Front Panel PATT key Press the PATT key to open the PATTERN ACTION menu. If you press the PATT key, but no patterns have been created or if the unit is powered up with the factory default settings, the only option that is displayed is CREATE. If you press the PATT key after creating channel patterns, the name of an existing pattern blinks, and you are in pattern selection mode.
Section 4: Using the Front Panel Series 3700 System Switch/Multimeter Reference Manual PATT key configuration Press the CONFIG key and then the PATT key to open the PATTERN ATTRibute menu. The PATTERN ATTRibute menu contains the following item: DMM_CONFIG: Sets the DMM configuration associated with the specified channel pattern. Use the navigation wheel to scroll through the available DMM configurations. Related ICL command: dmm.setconfig() (on page 13168).
Series 3700 System Switch/Multimeter Reference Manual Section 4: Using the Front Panel SCAN key If the scan list is present, press the SCAN key to open the SCAN ACTION menu. The SCAN ACTION menu contains the following items: NOTE Use the INSERT key to create and add the present active channel to the scan list. BACKGROUND: Runs the scan. Related ICL command: scan.background() (on page 13-232). CREATE: Displays following message: Use key.
Section 4: Using the Front Panel Series 3700 System Switch/Multimeter Reference Manual MODE: Sets the scan.mode value to one of the following: OPEN_ALL, which is equivalent to scan.MODE_OPEN_ALL or 0 (default setting) OPEN_SELECT, which is equivalent to scan.MODE_OPEN_SELECTIVE or 1 FIXED_ABR, which is equivalent to scan.MODE_FIXED_ABR or 2 Related ICL command: scan.mode() (on page 13-239) MEAS_CNT: Sets the measure count value. Related ICL command: scan.
Series 3700 System Switch/Multimeter Reference Manual Section 4: Using the Front Panel Navigation wheel Turn the navigation wheel to scroll to the desired menu option or to change the value of the selected numeric parameter. Pressing the navigation wheel has the same functionality as pressing the ENTER key. See ENTER key (on page 4-25) for more information.
Section 4: Using the Front Panel Series 3700 System Switch/Multimeter Reference Manual OPEN key Press the OPEN key to open selected channels or channel patterns. RATE key Press the RATE key to set the measurement speed (fast, medium, or slow) for the active or selected function. For more information, see Rate (on page 5-5). RECall key Press the RECall key to display stored readings and buffer statistics for selected reading buffer.
Series 3700 System Switch/Multimeter Reference Manual Section 4: Using the Front Panel STORE key Press the STORE key to open the RD BUFF ACTION menu or menu. For more information, see Buffer: Data Storage and Retrieval (on page 7-1). The RD BUFF ACTION menu contains the following items: CREATE: Allows creation of a reading buffer. When a new buffer is created, you can enter the name and set the number of readings to store.
Section 5 Range, Digits, Rate, Bandwidth, and Filter In this section: Range ............................................................................... 5-1 Digits ICL programming .................................................... 5-4 Rate .................................................................................. 5-5 Bandwidth ......................................................................... 5-7 Filter ..................................................................................
Section 5: Range, Digits, Rate, Bandwidth, and Filter Series 3700 System Switch/Multimeter Reference Manual Function Ranges Maximum reading TMP (temperature) -200°C to 1820°C Sensor dependent FREQ (frequency) 100mV, 1V, 10V, 100V, 300V 3Hz to 500kHz PER (period) 100mV, 1V, 10V, 100V, 300V 2µs to 333ms CNT (continuity) 1k Threshold adjustable 1 1000 CSΩ (common-side ohm) to 1 , 10 , 100 , 1k , 10k , 100k , 1M , 10M , 100M 120M Temperature There is no range selection for temperature measur
Series 3700 System Switch/Multimeter Reference Manual Section 5: Range, Digits, Rate, Bandwidth, and Filter Auto ranging over the front panel To enable auto range, press the AUTO key. The AUTO indicator turns on when auto ranging is selected. While auto ranging is enabled, the instrument automatically selects the best range to measure the applied signal. Auto ranging should not be used when optimum speed is required. NOTE The AUTO key has no effect on temperature measurements.
Section 5: Range, Digits, Rate, Bandwidth, and Filter Series 3700 System Switch/Multimeter Reference Manual Selecting an auto range Auto range is enabled by setting the dmm.autorange attribute (see dmm.autorange (on page 13-113)) to either dmm.ON or 1. When auto range is enabled, the range is changed automatically for the selected range value. When auto range is disabled, the instrument remains at the selected range. To disable auto range, either set the dmm.autorange attribute to dmm.
Series 3700 System Switch/Multimeter Reference Manual Section 5: Range, Digits, Rate, Bandwidth, and Filter Rate The RATE key sets the integration time (measurement speed) of the A/D converter. This controls how long the input signal is measured (also known as aperture). The integration time affects the amount of reading noise, as well as the ultimate reading rate of the instrument. The integration time is specified in parameters based on a number of power line cycles (NPLC), where 1 PLC for 60Hz is 16.
Section 5: Range, Digits, Rate, Bandwidth, and Filter Series 3700 System Switch/Multimeter Reference Manual 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 speed is of primary importance (at the expense of increased reading noise and fewer usable digits). MEDium sets integration time to 1 PLC. Use MEDium when a compromise between noise performance and speed is acceptable. SLOW sets integration time to 5 PLC.
Series 3700 System Switch/Multimeter Reference Manual Section 5: Range, Digits, Rate, Bandwidth, and Filter Setting Rate from the front panel The RATE key is used to set measurement speed from the front panel. Press the RATE key until the desired speed message is displayed. The second line of the display will contain the NPLC setting. Alternatively, use the NPLC option under the function attribute menu (press CONFIG > DMM keys to display).
Section 5: Range, Digits, Rate, Bandwidth, and Filter Series 3700 System Switch/Multimeter Reference Manual In the FAST bandwidth (300Hz to 300kHz), the output of the analog RMS converter (nearly pure DC at these frequencies) is measured at 1 PLC (16.6ms). For remote programming, the integration rate can be set from 0.0005PLC to 12PLC or 15PLC. To achieve the best accuracy for ACV and ACI measurements, use the bandwidth setting that best reflects the frequency of the input signal.
Series 3700 System Switch/Multimeter Reference Manual Section 5: Range, Digits, Rate, Bandwidth, and Filter Moving average filter The moving average filter uses a first-in first-out stack, where the newest reading conversion replaces the oldest. An average of the stacked reading conversions yields a filtered reading. After the specified number of reading conversions ("Filter count") fill the stack, the moving filter gives a new reading for every new conversion.
Section 5: Range, Digits, Rate, Bandwidth, and Filter Series 3700 System Switch/Multimeter Reference Manual Digital filter window The digital filter uses a "noise" window to control the filter threshold. As long as the input signal remains within the selected window, A/D conversions continue to be placed in the stack. If the signal changes to a value outside the window, the filter resets and starts processing again, starting with a new initial conversion value from the A/D converter.
Series 3700 System Switch/Multimeter Reference Manual Section 5: Range, Digits, Rate, Bandwidth, and Filter Figure 5-4: Filter window 3700S-901-01 Rev.
Section 5: Range, Digits, Rate, Bandwidth, and Filter Series 3700 System Switch/Multimeter Reference Manual For both front panel and remote programming, the window can be set to any value from 0.0% to 10%, where 0.0% represents no window being applied. For voltage, current, and resistance, the filter window is expressed as a percent of range. For example, on the 10V range, a 10% window means that the filter window is ±1V.
Section 6 Relative, Math, and dB In this section: Relative ............................................................................. 6-1 Math calculations .............................................................. 6-3 dB commands ................................................................. 6-10 Relative Use the REL (relative) function to null offsets or subtract a baseline reading from present and future readings.
Section 6: Relative, Math, and dB Series 3700 System Switch/Multimeter Reference Manual Basic front panel REL procedure 1. Select the desired measurement function and an appropriate range setting. 2. Apply the signal you want to REL to a switching channel input or to the Series 3700 inputs. 3. If you are using a switching module, close the input channel. (see Operation keys (on page 4-17) for basic information about the front panel graphical user interface). 4. Press the REL key to acquire the REL value.
Series 3700 System Switch/Multimeter Reference Manual Section 6: Relative, Math, and dB Scanning When a scan is configured, each channel can have its own unique REL value. For remote programming, the parameter is used to configure channels for a scan. For example: To attach a 1µV REL level to a desired configuration, send the following commands: -- Select DC volts function. dmm.func = 'dcvolts' -- Reset DC volts only. dmm.reset('active') -- Set the rel level. dmm.rel.level=1e-6 -- Enable REL.
Section 6: Relative, Math, and dB Series 3700 System Switch/Multimeter Reference Manual mX+b This math operation lets you manipulate normal display readings (X) mathematically according to the following calculation: Y = mX + b Where: X is the normal display reading. m and b are the user-entered constants for scale factor and offset. Y is the displayed result. Use dmm.math.mxb.bfactor (on page 13-148) and dmm.math.mxb.mfactor (on page 13-149) to set the b and m factor for mX+b.
Series 3700 System Switch/Multimeter Reference Manual Section 6: Relative, Math, and dB To set mX+B units from the front panel: NOTE The following procedure sets MXBUNITS. You can change the other MATH menu options (BFACTOR and MFACTOR) by changing the b and m values. 1. Press the CONFIG key. 2. Press the DMM key. 3. Turn the navigation wheel to highlight the MATH menu item. 4. With MATH highlighted, press the ENTER key. The MATH MENU opens. 5. Select the MXBUNITS menu item. 6.
Section 6: Relative, Math, and dB Series 3700 System Switch/Multimeter Reference Manual Percent This math function determines percent deviation from a specified reference value. The percent calculation is performed as follows: Where: Input: The normal measurement (if using REL, it will be the REL'ed value) Reference: The user-entered constant (dmm.math.percent) Percent: The result NOTE The REL'ed reading of the input signal (if using REL) is used by the percent calculation.
Series 3700 System Switch/Multimeter Reference Manual Section 6: Relative, Math, and dB To set a percent value from a remote interface, send the following commands: -- Set percent to 5 dmm.math.percent = 5 -- Sends 5 to the PC for display print(dmm.math.percent) To set a percent value on the front panel: 1. Open the function attribute menu: Press the CONFIG key. Press the DMM key. 2. Turn the navigation wheel to highlight the MATH menu item. 3. With MATH highlighted, press the ENTER key.
Section 6: Relative, Math, and dB Series 3700 System Switch/Multimeter Reference Manual Where: X is the normal input reading The displayed units designator for reciprocal readings is "R." You cannot change this units designator. Example: Assume the normal displayed reading is 002.5000Ω. The reciprocal of resistance is conductance. When the reciprocal math function is enabled, the following conductance reading will be displayed: 0.
Series 3700 System Switch/Multimeter Reference Manual Section 6: Relative, Math, and dB Scanning When a scan is configured, each channel can have its own unique math setup. For remote programming, the parameter is used to configure channels for a scan. Example: To perform the reciprocal math operation on DC volt measurements, send the following commands: -- Select DC volts function. dmm.func = 'dcvolts' -- Reset DC volts only. dmm.
Section 6: Relative, Math, and dB Series 3700 System Switch/Multimeter Reference Manual dB commands Expressing DC or AC voltage in dB makes it possible to compress a large range of measurements into a much smaller scope. The relationship between dB and voltage is defined by the following equation: Where: VIN: DC or AC input signal. VREF: Specified voltage reference level. The instrument will read 0dB when the reference voltage level is applied to the input.
Series 3700 System Switch/Multimeter Reference Manual Section 6: Relative, Math, and dB dB scanning Each channel in a scan may be configured to use dB. Create a configuration that has the dB enabled for units for the desired function by using the dmm.configure.set command. Once the configuration exists, use the dmm.setconfig() (on page 13-168) command to connect the configuration to the desired channels. Now the channels can be added to scanning (see scan.create() (on page 13-234) and scan.
Section 7 Buffer: Data Storage and Retrieval In this section: Buffer overview ................................................................. 7-1 Front panel operation ........................................................ 7-2 Remote buffer operation ................................................... 7-7 Buffer overview The Keithley Instruments Series 3700 System Switch/Multimeter uses synchronous reading acquisitions to take readings for a dynamically-created reading buffer.
Section 7: Buffer: Data Storage and Retrieval Series 3700 System Switch/Multimeter Reference Manual Front panel operation In the following procedures, pressing in the navigation wheel (as a button) will perform the same function as pressing the ENTER key. Also, you can turn the navigation wheel instead of using the CURSOR keys.
Series 3700 System Switch/Multimeter Reference Manual Section 7: Buffer: Data Storage and Retrieval Selecting a reading buffer You can only select an existing reading buffer. If necessary, create it first. See Creating and selecting a reading buffer (on page 7-2) for more information. NOTE When you create a new reading buffer from the front panel, it is automatically selected. To select a reading buffer: 1. Set up the Series 3700 to take measurements. 2. Press the STORE key. 3.
Section 7: Buffer: Data Storage and Retrieval Series 3700 System Switch/Multimeter Reference Manual To save readings to a USB flash drive: 1. Select a non-empty reading buffer. 2. Press the STORE key. The [BUFFER NAME] MENU is displayed. 3. Select the SAVE menu item, and press the ENTER key. The SAVE RD BUFFER menu is displayed. 4. Press the ENTER key when USB is highlighted. 5.
Series 3700 System Switch/Multimeter Reference Manual Section 7: Buffer: Data Storage and Retrieval Deleting a reading buffer To delete a reading buffer: 1. Select the reading buffer you want to delete. 2. Press the STORE key. The [BUFFER NAME] MENU is displayed. 3. Select the DELETE menu item, and press the ENTER key. 4. At the prompt, select YES or NO and press the ENTER key. If you select YES, the RD BUFF ACTION MENU is displayed. If you select NO, the [BUFFER NAME] MENU is displayed.
Section 7: Buffer: Data Storage and Retrieval Series 3700 System Switch/Multimeter Reference Manual Channel display The returned value provides different information, based on what is opened or closed when the reading is acquired: If no channel or channel pattern is closed when the reading is acquired, "None" is displayed. If only a single channel or backplane relay is closed, the channel number is displayed (for example, 5003 or 5915).
Series 3700 System Switch/Multimeter Reference Manual Section 7: Buffer: Data Storage and Retrieval Appending readings When the buffer append mode is disabled, the buffer is cleared (readings lost) before a new storage operation starts. When buffer append mode is enabled, the buffer is not cleared and each subsequent storage operation appends the readings to the buffer. When the buffer is filled to capacity, the storage process stops. The readings must be cleared before the next storage operation starts.
Section 7: Buffer: Data Storage and Retrieval Series 3700 System Switch/Multimeter Reference Manual Data store (buffer) commands The following commands are associated with data store operation: dmm.makebuffer() (on page 7-8) dmm.savebuffer() (on page 7-10) To delete a dynamically allocated buffer, use the command mybuffer = nil. Command Description dmm.buffer.catalog() An iterator that can act on all reading buffer names in the system. dmm.buffer.
Series 3700 System Switch/Multimeter Reference Manual Section 7: Buffer: Data Storage and Retrieval dmm.makebuffer() Function Creates a user buffer for storing readings. Usage mybuffer = dmm.makebuffer(buffersize) buffersize: Maximum number of readings that can be stored. Remarks These reading buffers are allocated dynamically. This function creates the buffers where buffersize indicates the maximum number of readings the buffer can store. These buffers can be deleted by setting mybuffer to nil.
Section 7: Buffer: Data Storage and Retrieval Series 3700 System Switch/Multimeter Reference Manual dmm.makebuffer() Details, continued To see readings in buffer: printbuffer(x, y, mybuffer) x and y: represent reading numbers desired To see readings, channels, and units: printbuffer(x, y, mybuffer, mybuffer.channels, mybuffer.units) x and y: represent reading numbers desired To see time stamps in buffer: mybuffer.collecttimestamps = 1 print(x, y, mybuffer, mybuffer.
Series 3700 System Switch/Multimeter Reference Manual Section 7: Buffer: Data Storage and Retrieval dmm.savebuffer() Usage dmm.savebuffer('', '', time_format) reading buffer name: The name of a previously created DMM reading buffer, specified as a string. Do not pass the reading buffer name without quotes because this generates a data type error. For example, if the reading buffer is mybuffer, then the buffer name should be specified as "mybuffer" and not mybuffer.
Section 7: Buffer: Data Storage and Retrieval Series 3700 System Switch/Multimeter Reference Manual dmm.savebuffer() Example To save readings from valid DMM buffer named mybuffer with default time information to a file named mydata.csv on the USB flash drive: dmm.savebuffer('mybuffer', '/usb1/mydata.csv') To save readings from mybuffer with relative time stamps to a file named mydatarel.csv on the USB flash drive: dmm.savebuffer('mybuffer', '/usb1/mydatarel.csv', dmm.buffer.
Series 3700 System Switch/Multimeter Reference Manual Section 7: Buffer: Data Storage and Retrieval Attribute Description appendmode When off, a new measurement to this buffer will clear the previous contents before storing the new measurement. When on, the first new measurement will be stored at what was formerly rb[n+1]. This attribute is initialized to off when the buffer is created over the bus.
Section 7: Buffer: Data Storage and Retrieval Series 3700 System Switch/Multimeter Reference Manual Command Description readingbuffer.collectchannels = 1 Enable channel storage. readingbuffer.appendmode = 1 Enable the buffer append mode. readingbuffer.collecttimestamps = 0 Disable time stamp storage. Refer to the following for buffer read-only attribute programming examples. In the example, the buffer is named readingbuffer. Command Description number = readingbuffer.
Series 3700 System Switch/Multimeter Reference Manual Section 7: Buffer: Data Storage and Retrieval Recall attribute Description channels An array (a Lua table) of strings indicating the channel or channel pattern associated with the measurement. The returned value provides different information, based on what was opened or closed when the reading was acquired: If no channel or channel pattern is closed when the reading was acquired, "None" is displayed.
Section 7: Buffer: Data Storage and Retrieval Series 3700 System Switch/Multimeter Reference Manual Recall attribute Description timestamps An array (a Lua table) of strings, indicating the time stamp of the reading formatted in month, day, year, hours, minutes, seconds, and fractional seconds. fractionalseconds An array (a Lua table) of the fractional portion of the time stamps, in seconds, of when each reading occurred. These are absolute fractional times.
Series 3700 System Switch/Multimeter Reference Manual Section 7: Buffer: Data Storage and Retrieval Bit Name Hex value ICL B0 Low limit 1 0x01 dmm.buffer.LIMIT1_LOW_BIT B1 High limit 1 0x02 dmm.buffer.LIMIT1_HIGH_BIT B2 Low limit 2 0x04 dmm.buffer.LIMIT2_LOW_BIT B3 High limit 2 0x08 dmm.buffer.LIMIT2_HIGH_BIT B6 Measure overflow 0x40 dmm.buffer.MEAS_OVERFLOW_BIT B7 Measure connect question 0x80 dmm.buffer.
Section 7: Buffer: Data Storage and Retrieval Series 3700 System Switch/Multimeter Reference Manual Dynamic buffer programming example The programming example below shows how to store data using a dynamicallyallocated buffer named mybuff. -- Reset the DMM. dmm.reset('all') -- Create a buffer named mybuffer and allocate space for 100,000 readings. mybuffer = dmm.makebuffer(100000) -- Enable append buffer mode. mybuffer.appendmode = 1 -- Set count to 1. dmm.
Series 3700 System Switch/Multimeter Reference Manual Section 7: Buffer: Data Storage and Retrieval Buffer for...do loops The following examples illustrate the use of for...do loops with respect to recalling buffer data from a reading buffer called mybuffer. The following code may be sent as one command line or as part of a script. Sample outputs follow the line of code. Also see the printbuffer() (on page 13-221) ICL command. NOTE Buffer mybuffer has time stamp collection enabled in the example below.
Section 7: Buffer: Data Storage and Retrieval Series 3700 System Switch/Multimeter Reference Manual The following loop uses the print command instead of the printbuffer command. This loop shows the same information described in the previous example (reading, units, and relative time stamps for all readings stored in the buffer).
Series 3700 System Switch/Multimeter Reference Manual Section 7: Buffer: Data Storage and Retrieval The sample output from the above code has six comma-delimited entries per line (reading, channel, reading, channel, reading, channel): 3.181298825e-002, 2001+, -5.602844334e-002, 2002+, -7.811298360e-002, 2003+ 3.228547367e-002, 2001+, -5.299202901e-002, 2002+, -8.676257870e-002, 2003+ 3.736769697e-002, 2001+, -3.247188344e-002, 2002+, -5.106155438e-002, 2003+ -6.473406636e-002, 2001+, -9.
Section 7: Buffer: Data Storage and Retrieval Series 3700 System Switch/Multimeter Reference Manual Example: Create a buffer with: A capacity for 50 readings Append mode enabled Measure count to 30 Tell the instrument to print the current number of buffer elements stored and take readings to store in the buffer. The following occurs: 1. The first time the measurement is called, the buffer is empty (no readings) so it stores 30 readings. 2.
Series 3700 System Switch/Multimeter Reference Manual Section 7: Buffer: Data Storage and Retrieval -- Show the current number of readings in the buffer, and then measure and store readings in the buffer (third pass). -- Output from the print command: -- 5.000000000e+001 -- nil -- 4915, Attempting to store past capacity of reading buffer print(buf.n, dmm.measure(buf)) 3700S-901-01 Rev.
Section 8 Scanning In this section: Scanning fundamentals..................................................... 8-1 Scan and step counts........................................................ 8-7 Basic scan procedure........................................................ 8-7 Front panel scanning....................................................... 8-10 Bus operation scanning................................................... 8-12 Hardware trigger modes..................................................
Section 8: Scanning Series 3700 System Switch/Multimeter Reference Manual Channel assignments Each switching module has a certain number of channels. For example, the Model 3720 switching module has 60 channels (1 through 60). When you encounter a 1- to 3-digit channel number in this manual, the switching module channel is the point of discussion. A 4-digit channel number includes the slot number followed by the 3-digit channel number.
Series 3700 System Switch/Multimeter Reference Manual Section 8: Scanning Event blenders Advanced event handling requires a way to wait for one of several events (or all of several events). An event blender provides for this combining or blending of events. An event blender can combine up to four events in either an "or" mode or an "and" mode. When in "or" mode, any one of the input events will cause an output event to be generated.
Section 8: Scanning Series 3700 System Switch/Multimeter Reference Manual Trigger model The following flowchart represents a trigger model implemented in the Series 3700. The trigger model is used during a scan only. For front panel operation, you use the SCAN and STEP keys to perform scan actions. For remote operation, you use the scan functions and attributes commands, for example, scan.execute() and scan.mode. Figure 8-2: Trigger model 8-4 3700S-901-01 Rev.
Series 3700 System Switch/Multimeter Reference Manual Section 8: Scanning The Series 3700 trigger model has the following events and associated ICL command attributes. These events, along with other events in the system, may be used to configure various stimulus settings. For example, the channel ready event (scan.trigger.EVENT_CHANNEL_READY) may be set to pulse digital I/O line 3 when it gets generated. The command message for this would be: digio.trigger[3].stimulus = scan.trigger.
Section 8: Scanning Series 3700 System Switch/Multimeter Reference Manual Triggers The following four action triggers are associated with the trigger model operation: Arm Action Trigger Channel Action Trigger (this trigger may be bypassed for the first channel of the first scan count) Sequence Action Trigger Measure Action Trigger STEP operation: When the trigger event is detected, a channel is closed and a measurement may be taken, if it is configured for one.
Series 3700 System Switch/Multimeter Reference Manual Section 8: Scanning Stimulus Description Measure Action Trigger Affects the "Wait Measure Trigger" block of the trigger model. This trigger is associated with the ICL scan.trigger.measure.stimulus (on page 13-247). Scan and step counts When running a scan, it may be necessary to determine the scan progress. Use scan and step count to determine the point in the scan table being executed.
Section 8: Scanning Series 3700 System Switch/Multimeter Reference Manual 5. The trigger model leaves the idle state and opens channels involved in scanning, along with channels that would interfere with scanning, such as AMP channels, analog backplane relays 1 and 2 on all slots, common-side ohm backplane channels, and other channels in banks involved in scanning.
Series 3700 System Switch/Multimeter Reference Manual Section 8: Scanning Buffer To recall scanned readings stored in the buffer, press the REC key and turn the navigation wheel to navigate through the buffer. See Recalling readings (on page 7-5) for details on recalling buffer readings. When finished, make sure to exit from buffer recall (press the EXIT key). Also see Buffer: Data Storage and Retrieval (on page 7-1).
Section 8: Scanning Series 3700 System Switch/Multimeter Reference Manual The ICL commands to simulate this example follow. Assume the Model 3720 is in Slot 3: -- Configure Channels 1 to 60 to measure DC volts. dmm.setconfig('slot3', 'dcvolts') -- Create a scan list, channels measuring DC volts. scan.create('slot3') -- View the scan list, 60 channels measuring DC volts. print(scan.list()) -- Change Channels 1 to 30 to 4-wire ohms. dmm.
Series 3700 System Switch/Multimeter Reference Manual Section 8: Scanning When removing channels, channel patterns will not be checked to determine if the channel being removed is associated with its image. To remove a channel pattern in a scan list, select the channel pattern to be removed, and then press the DELETE key.
Section 8: Scanning Series 3700 System Switch/Multimeter Reference Manual Bus operation scanning ICL commands The following list contains ICL commands associated with triggers and bus operation scanning: trigger.blender[N].clear() (on page 13-287) trigger.blender[N].orenable (on page 13-287) trigger.blender[N].overrun (on page 13-288) trigger.blender[N].stimulus[M] (on page 13-288) trigger.blender[N].wait() (on page 13-289) trigger.timer[N].clear (on page 13-290) trigger.timer[N].
Series 3700 System Switch/Multimeter Reference Manual Section 8: Scanning scan.measurecount (on page 13-238) scan.mode() (on page 13-239) scan.nobufferbackground() (on page 13-240) scan.reset() (on page 13-242) scan.scancount (on page 13-242) scan.state() (on page 13-243) scan.trigger.arm.clear() (on page 13-244) scan.trigger.arm.set() (on page 13-244) scan.trigger.arm.stimulus (on page 13-244) scan.trigger.channel.clear() (on page 13-245) scan.trigger.channel.set() (on page 13-245) scan.trigger.channel.
Section 8: Scanning Series 3700 System Switch/Multimeter Reference Manual Scanning 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 after setting, set the stimulus to 0, which returns the stimulus setting back to its factory default value, which may or may not be 0.
Series 3700 System Switch/Multimeter Reference Manual Section 8: Scanning -- Set up digital I/O line 1 to detect a falling edge trigger. digio.trigger[1].mode = digio.TRIG_FALLING -- Set each channel so it closes with a digio 1 event trigger. scan.trigger.channel.stimulus = digio.trigger[1].EVENT_ID -- Set bypass to off so that first channel needs to see trigger before closing. scan.bypass = scan.OFF -- Create scan for Channels 1 to 60 on the card installed in Slot 3. scan.
Section 8: Scanning Series 3700 System Switch/Multimeter Reference Manual -- Set bypass to ON so first channel closes without taking a measurement. scan.bypass = scan.ON -- Make buffer named "mybuffer" and configure it to store up to 1000 readings. mybuffer = dmm.makebuffer(1000) -- Initiate the scan to execute in the background and save readings to a buffer called "mybuffer." scan.background(mybuffer) Example 4: Optimizing scanning for speed.
Series 3700 System Switch/Multimeter Reference Manual Section 8: Scanning -- Assign that configuration to Channels 1 to 60 on Slot 1. dmm.setconfig( '1001:1060' , 'mydcvolts') -- Set the scan mode to fixed ABR. scan.mode=scan.MODE_FIXED_ABR -- Create a scan list of Channels 1 to 60 on Slot 1. scan.create('1001:1060') -- Set the scan count to 10. scan.scancount=10 -- Scan in the foreground. scan.execute(reading_buffer) -- Write the data out to a file on a USB flash drive. dmm.
Section 8: Scanning Series 3700 System Switch/Multimeter Reference Manual -- Set up digital I/O Line 1 to detect a falling edge trigger. digio.trigger[1].mode = digio.TRIG_FALLING -- Set each channel so it closes with a digio 1 event trigger. scan.trigger.channel.stimulus = digio.trigger[1].EVENT_ID -- Set bypass to OFF so that the first channel needs to see the trigger before closing. scan.bypass = scan.
Series 3700 System Switch/Multimeter Reference Manual Trigger mode Output Section 8: Scanning Input Unasserted Asserted Detects Rising A High Low Rising RisingM Low High None Synchronous High Low Falling latching Notes Behaves similar to SynchronousA Trigger overrun detection is disabled To mirror the SynchronousA trigger mode, set the pulse duration to 1µs or any small nonzero value SynchronousA High High Falling Low Rising Ignores the pulse duration latching SynchronousM Hig
Section 8: Scanning Series 3700 System Switch/Multimeter Reference Manual Falling edge trigger mode The falling edge trigger mode generates low pulses and detects all falling edges. The following graphic illustrates the characteristics for the falling edge input trigger. Figure 8-3: Falling edge input trigger Input characteristics: Detects all falling edges as input triggers Figure 8-4: Falling edge output trigger 8-20 3700S-901-01 Rev.
Series 3700 System Switch/Multimeter Reference Manual Section 8: Scanning Output characteristics: The trigger.assert command generates a low pulse for the programmed pulse duration. Rising edge master trigger mode (version 1.4.0 or higher) Use the rising edge master trigger mode (RisingM) to synchronize with non-Keithley Instruments that require a high pulse. Input trigger detection is not available in this trigger mode. You can use the RisingM trigger mode to generate rising edge pulses.
Section 8: Scanning Series 3700 System Switch/Multimeter Reference Manual Rising edge acceptor trigger mode (version 1.4.0 or higher) The rising edge acceptor trigger mode (RisingA) generates a low pulse and detects rising edge pulses. The following graphic displays the RisingA input trigger. Figure 8-6: RisingA input trigger Input characteristics: All rising edges generate an input event. Figure 8-7: RisingA output trigger 8-22 3700S-901-01 Rev.
Series 3700 System Switch/Multimeter Reference Manual Section 8: Scanning Output characteristics: The trigger.assert command generates a low pulse that is similar to the falling edge trigger mode. Either edge trigger mode The either edge trigger mode generates a low pulse and detects both rising and falling edges. Figure 8-8: Either edge input trigger 3700S-901-01 Rev.
Section 8: Scanning Series 3700 System Switch/Multimeter Reference Manual Input characteristics: All rising or falling edges generate an input trigger event Figure 8-9: Either edge output trigger Output characteristics: The trigger.assert command generates a low pulse that is similar to the falling edge trigger mode.
Series 3700 System Switch/Multimeter Reference Manual Section 8: Scanning Synchronous master trigger mode Use the synchronous master trigger mode (SynchronousM) to generate falling edge output triggers, to detect the rising edge input triggers, and to initiate an action on one or more external nodes with the same trigger line. In this mode, the output trigger consists of a low pulse.
Section 8: Scanning Series 3700 System Switch/Multimeter Reference Manual Input characteristics: All rising edges are input triggers. When all external drives release the physical line, the rising edge is detected as an input trigger. A rising edge cannot be detected until all external drives release the line and the line floats high. Figure 8-11: SynchronousM output trigger Output characteristics: The trigger.
Series 3700 System Switch/Multimeter Reference Manual Section 8: Scanning Synchronous acceptor trigger mode Use the synchronous acceptor trigger mode (SynchronousA) in conjunction with the SynchronousM trigger mode. The role of the internal and external drives are reversed in the SynchronousA trigger mode.
Section 8: Scanning Series 3700 System Switch/Multimeter Reference Manual Synchronous trigger mode The synchronous trigger mode is a combination of SynchronousA and SynchronousM trigger modes. Use the synchronous trigger mode for backwards firmware compatibility. The SynchronousA and SynchronousM trigger modes provide additional flexibility. It is recommended that you use SynchronousA and SynchronousM for firmware v1.4.0 or higher, and use the synchronous trigger mode for firmware prior to v1.4.0.
Series 3700 System Switch/Multimeter Reference Manual Section 8: Scanning Input characteristics: The falling edge generates an input event and latches the internal drive low. Figure 8-15: Synchronous output trigger Output characteristics: The trigger.assert command generates a low pulse for the programmed pulse duration If the line is latched low, a falling edge does not occur. When the trigger.
Section 9 Files In this section: File formats ....................................................................... 9-1 Default file extensions ....................................................... 9-1 File system navigation....................................................... 9-2 File I/O .............................................................................. 9-3 Script examples ................................................................ 9-4 Command table entries .........................
Section 9: Files Series 3700 System Switch/Multimeter Reference Manual File system navigation The Lua FS library provides the command set necessary to navigate the file system and list the available files on a flash drive. The instrument encapsulates this command set as an fs logical instrument, so that the file system of any given node is available to the entire TSP-LinkTM system. For example, the command node[5].fs.readdir(".") can be used to read the contents of the current working directory on Node 5.
Series 3700 System Switch/Multimeter Reference Manual Section 9: Files File I/O Lua supports file I/O with its io library commands. A subset of these commands is supported for use with Series 3700 instruments. As with Lua FS, these commands are encapsulated as an io logical instrument so that the files on any given node are accessible to the entire TSP-LinkTM system. Lua organizes its file I/O commands into two groups: Commands that reside in the io table, for example: io.open, io.close, io.input, and io.
Section 9: Files Series 3700 System Switch/Multimeter Reference Manual io.type (on page 9-14) (supported on the local node only when the Series 3700 is a master) The following standard I/O commands are not supported at this time: file:lines file:setvbuf io.lines io.popen io.tmpfile Script examples The following script will open three different files to help illustrate the differences between the io commands and file descriptor commands.
Series 3700 System Switch/Multimeter Reference Manual Section 9: Files loadscript file_io_test -- get the current date and time date_time = os.date('%c', os.time()) -- open the three files for writing myfile1, myfile1_err, myfile1_errnum = io.open('/usb1/myfile_io1', 'w') myfile2, myfile2_err, myfile2_errnum = io.open('/usb1/myfile_io2', 'w') myfile3, myfile3_err, myfile3_errnum = io.open('/usb1/myfile_io3', 'w') if (io.type(myfile1) == 'file') then if (io.type(myfile2) == 'file') then if (io.
Section 9: Files Series 3700 System Switch/Multimeter Reference Manual print('error number is ' .. myfile3_errnum) end else print('myfile2 did not open for write') print('error string is ' .. myfile2_err) print('error number is ' .. myfile2_errnum) end else print('myfile1 did not open for write') print('error string is ' .. myfile1_err) print('error number is ' .. myfile1_errnum) end -- open the 3 files again for reading myfile1, myfile1_err, myfile1_errnum = io.
Series 3700 System Switch/Multimeter Reference Manual Section 9: Files print('error string is ' .. myfile2_err) print('error number is ' .. myfile2_errnum) end else print('myfile1 did not open for read') print('error string is ' .. myfile1_err) print('error number is ' ..
Section 9: Files Series 3700 System Switch/Multimeter Reference Manual loadscript filetest -- script to write 2 lines to a file -- append 2 lines to the same file -- read the entire file contents and print them -- open the file for writing myfile = io.open('/usb1/myfiletest', 'w') if io.type(myfile) == 'file' then myfile:write('This is my first line WRITING\n') myfile:write('This is my next line WRITING\n') myfile:close() -- open the file for appending myfile = io.open('/usb1/myfiletest', 'a') if io.
Series 3700 System Switch/Multimeter Reference Manual Section 9: Files Command table entries fs.chdir() Function Sets the current working directory. Usage fs.chdir(path) path: The new working directory path (absolute or relative). Remarks An error is logged to the error queue if the given path does not exist. fs.cwd() Function Returns the absolute path of the current working directory. Usage path = fs.cwd() path: The absolute path of the current working directory. fs.
Section 9: Files Series 3700 System Switch/Multimeter Reference Manual fs.readdir() Function Returns a list of all the file system entries within a specified directory. Usage files = fs.readdir(path) files: A list containing the names of all the file system entries that reside in the specified directory. path: The directory path. This path may be absolute or relative to the current working directory. Remarks This command is non-recursive (that is, entries in subfolders are not returned).
Series 3700 System Switch/Multimeter Reference Manual Section 9: Files file:read() Function Reads data from a file. Usage data = file:read(format) data: The data read from the file. The number of return values matches the number of values in format. file: The descriptor of the file to read. format: A string or number indicating the type of data to be read. Any number of format parameters may be passed to this command, each corresponding to a returned data value.
Section 9: Files Series 3700 System Switch/Multimeter Reference Manual file:write() Function Buffer data until a flush (file:flush() (on page 9-10) or io.flush() (on page 9-12)) or close (file:close() (on page 9-10) or io.close() (on page 9-12)) operation is performed. NOTE Usage Data may be lost if the file is not flushed or closed before the application ends. A write function buffers the data until a flush or close operation is requested. file:write(data) file: The descriptor of the file.
Series 3700 System Switch/Multimeter Reference Manual Section 9: Files io.input() Remarks Any error encountered is logged to the error queue. The remotely-accessible version of this command does not accept a file descriptor parameter. io.open() Function Opens a file for later access. Usage file, err, errnum = io.open(path, mode) file: The descriptor of the opened file. err: A string with an error message an error occurred. errnum: Number representing the error number.
Section 9: Files Series 3700 System Switch/Multimeter Reference Manual io.read() Function Reads data from the default input file. Usage data = io.read(format) data: The data read from the file. The number of return values matches the number of values in format. format: A string or number indicating the type of data to be read. Any number of format parameters may be passed to this command, each corresponding to a returned data value. Optional; default is "*l".
Section 10 TSP-Net In this section: Overview ......................................................................... 10-1 TSP-NetTM Capabilities .................................................. 10-1 Using TSP-NetTM with any Ethernet-enabled device ..... 10-2 Using TSP-NetTM vs. TSP-LinkTM for communication with TSP-enabled devices ......................................................
Section 10: TSP-Net Series 3700 System Switch/Multimeter Reference Manual Using TSP-NetTM with any Ethernet-enabled device NOTE Refer to the Instrument Control Library (ICL) (on page 12-1) for more details on the commands presented in this section. To communicate to a remote Ethernet-enabled device from the Series 3700, perform the following steps: 1. Connect to the remote device through the LAN port. Use an Ethernet crossover cable to connect directly from the Series 3700 to an Ethernet-enabled device.
Series 3700 System Switch/Multimeter Reference Manual Section 10: TSP-Net Example script The following example demonstrates how to connect to a remote non-TSPTMenabled device, and send and receive data from this device: -- Disconnect all existing TSP-NetTM connections. tspnet.reset() -- Set tspnet timeout to 5 seconds. tspnet.timeout = 5 -- Establish connection to another device with IP address 192.168.1.51 at port 1394. id_instr = tspnet.connect("192.168.1.
Section 10: TSP-Net Series 3700 System Switch/Multimeter Reference Manual Using TSP-NetTM vs. TSP-LinkTM for communication with TSP-enabled devices TSP-Link is the preferred communication method when communicating between the Series 3700 and another TSPTM-enabled instrument. Using TSP-Link has certain advantages over using TSP-Net, including: Error checking: When connected to a TSP-enabled device, all errors that occur on the remote device are transferred to the error queue of the Series 3700.
Series 3700 System Switch/Multimeter Reference Manual Section 10: TSP-Net Instrument Control Library (ICL) - General device control tspnet.connect() Function Device connection. Usage To connect to any remote device on the LAN: = tspnet.connect([, [, ]]) To connect to a TSP-enabled remote device on the LAN: = tspnet.
Section 10: TSP-Net Series 3700 System Switch/Multimeter Reference Manual tspnet.connect() Example To connect to a TSP-enabled device: mytspdevice = tspnet.connect('10.80.64.216') To connect to a non-TSP-enabled device: mydevice = tspnet.connect("192.168.1.51",1394, "*rst\r\n") tspnet.idn() Function Retrieves response of remote device to '*IDN?' Usage = tspnet.
Series 3700 System Switch/Multimeter Reference Manual Section 10: TSP-Net tspnet.execute() Remarks This command sends the command string to the connection device. A termination is added to the command string when it is sent to the device (see tspnet.termination() (on page 10-11)). Optionally, when a format string is specified, the command waits for a string from the device.
Section 10: TSP-Net Series 3700 System Switch/Multimeter Reference Manual tspnet.write() Remarks The tspnet.write() command sends the command string to the connection device. It does not wait for command completion on the remote device. The Series 3700 sends the input string to the remote device exactly as indicated. The input string must contain any necessary new lines, termination, or other indicators.
Series 3700 System Switch/Multimeter Reference Manual Section 10: TSP-Net tspnet.read() Remarks This command reads available data from the device (as indicated by the format string) and returns the number of arguments (as indicated by the format string).
Section 10: TSP-Net Series 3700 System Switch/Multimeter Reference Manual tspnet.readavailable() Example x = tspnet.readavailable(mydevice) tspnet.clear() Function Device read clear buffer. Usage tspnet.clear() connection id: Integer value used as a handle for other tspnet commands Remarks This command clears any pending output data available from the device. No data is returned to the caller. No data is processed. Errors: Invalid Specified Connection Example tspnet.
Series 3700 System Switch/Multimeter Reference Manual Section 10: TSP-Net tspnet.reset() Remarks This command disconnects the all devices currently connected. For Keithley Instruments TSPTM devices, this results in any remotely running commands or scripts being terminated. Errors: Example tspnet.reset() tspnet.termination() Function Device line termination. Usage = tspnet.
Section 10: TSP-Net Series 3700 System Switch/Multimeter Reference Manual tspnet.timeout Remarks This setting sets the duration the tspnet.connnect, tspnet.read, and tspnet.execute commands will wait for a response. The time is specified in seconds. The default value is 5.0 seconds. The timeout may contain fractional seconds but is only accurate to the nearest 10mS. The timeout may be between 0.0 and 30 seconds. Errors: Invalid Timeout Example tspnet.timeout = 10.
Series 3700 System Switch/Multimeter Reference Manual Section 10: TSP-Net tspnet.tsp.rbtablecopy() Function Copies a reading buffer synchronous table from a device. Usage = tspnet.tsp.
Section 10: TSP-Net Series 3700 System Switch/Multimeter Reference Manual tspnet.tsp.abort() Function Aborts device execution. Usage tspnet.tsp.abort() connection id: Integer value used as a handle for other tspnet commands Remarks This convenience command simply sends an "abort" string to a device. Errors: Invalid Specified Connection Connection Not Available Write Failed Example tspnet.tsp.abort() tspnet.tsp.abortonconnect Attribute Abort on connect. Usage tspnet.tsp.
Section 11 LXI Class B Triggering (IEEE-1588) In this section: Introduction to IEEE-1588 based triggering .................... 11-1 IEEE-1588 implementation in the Series 3700 ................ 11-1 Correlating PTP to Coordinated Universal Time (UTC)... 11-2 Configuring and enabling IEEE-1588 .............................. 11-3 Monitoring alarms with LAN triggers and LXI event log...
Section 11: LXI Class B Triggering (IEEE-1588) Series 3700 System Switch/Multimeter Reference Manual At periodic intervals, the master clock synchronizes to all slave clocks through time-stamped messages over the PTP port. This allows IEEE-1588 to maintain time synchronization between multiple devices on a network. Program the synchronization interval in the Series 3700 using ptp.syncinterval (on page 13-229). The default synchronization interval is two seconds.
Series 3700 System Switch/Multimeter Reference Manual Section 11: LXI Class B Triggering (IEEE-1588) You can avoid confusion by setting the time on the Series 3700 to UTC time instead of local time. Manage the conversion from UTC to local time in your software application. For example, assume local time is Eastern Standard Time in the United States (EST), which is equivalent to GMT-5 (hours). Therefore, if the current local time is 3:00PM, the UTC time is 8:00PM.
Section 11: LXI Class B Triggering (IEEE-1588) Series 3700 System Switch/Multimeter Reference Manual Use ptp.enable() (on page 13-227) to enable IEEE-1588 on the Series 3700. The IEEE-1588 protocol then determines the master clock. The IEEE-1588 indicator on the front panel of the Series 3700 updates to display the IEEE-1588 status. If the indicator is off, then IEEE-1588 is disabled or the device is not connected to a working network. If the network is not working, then the LAN indicator also blinks.
Series 3700 System Switch/Multimeter Reference Manual Section 11: LXI Class B Triggering (IEEE-1588) Scheduling alarms You can schedule alarms to request the Series 3700 to perform actions at a specific time and date or at a specific time interval. You can schedule alarms in UTC or PTP time; however, it is important to be consistent in defining the alarms using the same time format whether UTC or PTP.
Section 11: LXI Class B Triggering (IEEE-1588) Series 3700 System Switch/Multimeter Reference Manual You can also schedule alarms to occur at a fractional second using either PTP or UTC format with schedule.alarm[x].fractionalseconds (on page 13250). After defining the alarm, configure the number of times you would like to repeat this alarm using schedule.alarm[x].repetition (on page 13-251). Use schedule.alarm[x].
Series 3700 System Switch/Multimeter Reference Manual Section 11: LXI Class B Triggering (IEEE-1588) LXI event log The LXI event log of a Series 3700 monitors all LAN triggers that the instrument receives or generates. The LXI event log has nine comma-delimited fields. Below is an example entry to a LXI event log and a description of the log fields in order of appearance. "17:26:35.690 10 Oct 2007, LAN0, 192.168.1.102, LXI, 0, 1192037132, 1192037155.
Section 11: LXI Class B Triggering (IEEE-1588) Series 3700 System Switch/Multimeter Reference Manual Scheduling alarms on a stand-alone Series 3700 To configure a single Series 3700 to perform an event at a particular date and time, you must schedule alarms, but you do not need to enable IEEE-1588. Therefore, you can send these commands over any remote interface and not just LAN. To initiate a specific action at the firing of the alarm, you must use the event identifier for the scheduled alarm, schedule.
Series 3700 System Switch/Multimeter Reference Manual Section 11: LXI Class B Triggering (IEEE-1588) Synchronizing multiple Series 3700 instruments NOTE Synchronization only occurs between instruments within the same PTP subdomain. Use ptp.subdomain to set the subdomain name. Refer to Configuring and enabling IEEE-1588 (on page 11-3) for further details.
Section 11: LXI Class B Triggering (IEEE-1588) Series 3700 System Switch/Multimeter Reference Manual The following is an example that demonstrates scheduling an alarm to execute a scan on the Series 3700 and output a trigger from the Series 3700 to another device: -- configure a switch with DMM scan operation on a Series 3700 reset() scan.reset() buffer=dmm.makebuffer(100) dmm.autodelay=dmm.OFF dmm.range=10 dmm.autozero=dmm.OFF dmm.nplc=.0005 dmm.measurecount=1 dmm.configure.set('mydcvolts') dmm.
Section 12 Status Model In this section: Status register sets ......................................................... 12-1 Status byte and SRQ ...................................................... 12-2 System summary and status byte ................................... 12-3 System summary registers .............................................. 12-4 Standard event status register and enable...................... 12-5 Operation events registers ..............................................
Section 12: Status Model Series 3700 System Switch/Multimeter Reference Manual Negative and positive transition registers Negative-transition register (NTR): When a bit in an NTR is set by the user, the corresponding bit in the event register will set when the corresponding bit in the condition register transitions from 1 to 0.
Series 3700 System Switch/Multimeter Reference Manual Section 12: Status Model 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 of system summary register (status.system) receives its extension bit (Bit 0) from the system summary register 2 (status.system2). Figure 12-2: Status byte and system summary register 3700S-901-01 Rev.
Section 12: Status Model Series 3700 System Switch/Multimeter Reference Manual System summary registers The system summary registers (system5 through system2) provide summary information through the specific register's extension bit (Bit 0). This in turn is provided to the system summary register (system) extension bit (Bit 0). Figure 12-3: System summary registers 12-4 3700S-901-01 Rev.
Series 3700 System Switch/Multimeter Reference Manual Section 12: Status Model 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 status byte (Status byte and SRQ (on page 12-2)). Figure 12-4: Standard event registers and event status enable 3700S-901-01 Rev.
Section 12: Status Model Series 3700 System Switch/Multimeter Reference Manual Operation events registers The summary bit of the operation status user register provides the user bit (USER) (Bit 12) to the operation status register. The summary bit of the operation status register provides the operation summary bit (OSB) (Bit 7) of the status byte. Figure 12-5: Operation event registers 12-6 3700S-901-01 Rev.
Series 3700 System Switch/Multimeter Reference Manual Section 12: Status Model Questionable event register The questionable event register provides summary information to questionable summary bit (QSB) (Bit 3) of the status byte. Figure 12-6: Questionable event register 3700S-901-01 Rev.
Section 12: Status Model Series 3700 System Switch/Multimeter Reference Manual Measurement event register (measurement) The measurement event register (measurement) provides summary information to the status byte's measurement summary bit (MSB) (Bit 0). Figure 12-7: Measurement event register Status function summary The following functions control and read the various registers. NOTE * = .ntr, .ptr, .enable, .event, and .condition. The first three (.ntr, .ptr, and .
Series 3700 System Switch/Multimeter Reference Manual Section 12: Status Model Type Function Questionable event status.questionable.* Standard event status.standard.enable System event status.system.enable status.system2.enable status.system3.enable status.system4.enable status.system5.enable Clearing registers and queues When the Series 3700 is turned on, various register status elements will be set as follows: The power on (PON) bit in the status.operation.condition register is set.
Section 12: Status Model Series 3700 System Switch/Multimeter Reference Manual Programming enable and transition registers The only registers that can be programmed by the user are the enable and transition registers. All other registers in the status structure are read-only registers.
Series 3700 System Switch/Multimeter Reference Manual Section 12: Status Model Reading registers Any register in the status structure can be read by either sending the common command query (where applicable), or by including the script command for that register in either the print() or print(tostring()) command. The print() command returns a numeric value, while the print(tostring()) command returns the string equivalent.
Section 12: Status Model Series 3700 System Switch/Multimeter Reference Manual 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 12-9: Status byte and service request (SRQ) 12-12 3700S-901-01 Rev.
Series 3700 System Switch/Multimeter Reference Manual Section 12: Status Model Status byte register The summary messages from the status registers and queues are used to set or clear the appropriate bits (B0, B1, B2, B3, B4, B5, and B7) of the status byte register. These summary bits do not latch, and their states (0 or 1) are solely dependent on the summary messages (0 or 1). For example, if the standard event register is read, its register will clear.
Section 12: Status Model Series 3700 System Switch/Multimeter Reference Manual Serial polling and SRQ Any enabled event summary bit that goes from 0 to 1 sets bit B6 and generates an SRQ (service request). In your test program, you can periodically read the status byte to check if an SRQ has occurred and what caused it. If an SRQ occurs, the program can, for example, branch to an appropriate subroutine that will service the request. SRQs can be managed by the serial poll sequence of the Series 3700.
Series 3700 System Switch/Multimeter Reference Manual Section 12: Status Model Status byte and service request commands The commands to program and read the status byte register and service request enable register are listed below. Note that the table includes both common commands and their script command equivalents. For details on programming and reading registers, see Programming enable and transition registers (on page 12-10) and Reading registers (on page 12-11).
Section 12: Status Model Series 3700 System Switch/Multimeter Reference Manual Controlling node and SRQ enable registers For the attributes to control system node and SRQ enable bits and read associated registers, refer to: status.request_enable (on page 13-276) status.request_event (on page 13-278) status.node_enable (on page 13-267) status.
Series 3700 System Switch/Multimeter Reference Manual Section 12: Status Model 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: Indicates a bit on TSP-Link node n has been set (n = 1 to 64). System summary event commands appear in the following table: Commands Bit To set register bits: status.system.enable = status.system.EXTENSION_BIT B0 status.system.enable = status.system.
Section 12: Status Model Series 3700 System Switch/Multimeter Reference Manual Commands Bit To read registers: print(status.system4.enable) print(status.system4.condition) print(status.system4.event) To set register bits: status.system5.enable = status.system.EXTENSION_BIT B0 status.system5.enable = status.system.EXT B0 status.system5.enable = status.system.NODEn Bn To read registers: print(status.system5.enable) print(status.system5.condition) print(status.system5.
Series 3700 System Switch/Multimeter Reference Manual Section 12: Status Model 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 device operations are completed and the Series 3700 is ready to accept new commands. The bit is set in response to an *OPC command. The ICL function opc() (on page 13-220) can be used in place of the *OPC command. Bit B1: Not used.
Section 12: Status Model Series 3700 System Switch/Multimeter Reference Manual Figure 12-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 attributes to control bits. Commands Description *ESR? Read standard event status register. or print(status.standard.event) *ESE or Program the event status enable register: = 0 to 255 status.standard.enable = Refer to the status.
Series 3700 System Switch/Multimeter Reference Manual Section 12: Status Model Operation event registers The Series 3700 has two register sets associated with operation event status. Commands are summarized in the following table. For example, either of the following commands will set the CAL enable bit: status.operation.enable = status.operation.CAL status.operation.
Section 12: Status Model Series 3700 System Switch/Multimeter Reference Manual Commands Bit status.operation.user.* = status.operation.user.BIT1 B1 status.operation.user.* = status.operation.user.BIT2 B2 status.operation.user.* = status.operation.user.BIT3 B3 status.operation.user.* = status.operation.user.BIT4 B4 status.operation.user.* = status.operation.user.BIT5 B5 status.operation.user.* = status.operation.user.BIT6 B6 status.operation.user.* = status.operation.user.BIT7 B7 status.
Series 3700 System Switch/Multimeter Reference Manual Section 12: Status Model Questionable event registers The Series 3700 has five registers associated with questionable event status. For example, to set the CAL enable bit, use either of the following commands: status.questionable.enable = status.questionable.CAL status.questionable.enable = 256 The following command will request the questionable enable register value: print(status.questionable.
Section 12: Status Model Series 3700 System Switch/Multimeter Reference Manual Commands Bit To read registers: print(status.questionable.user.*) Where * = .ntr, .ptr, .enable, .event, and .condition NOTE The first three (.ntr, .ptr, and .enable) are read/write, while the last two (.event and .condition) are read only. print(status.questionable.user.condition) print(status.questionable.user.event) Measurement event registers The Series 3700 has five registers associated with measurement event status.
Series 3700 System Switch/Multimeter Reference Manual Section 12: Status Model Commands Bit To read registers: print(status.measurement.*) Where * = .ntr, .ptr, .enable, .event, and .condition NOTE The first three (.ntr, .ptr, and .enable) are read/write, while the last two (.event and .condition) are read only. print(status.measurement.condition) print(status.measurement.
Section 12: Status Model Series 3700 System Switch/Multimeter Reference Manual Error queue The error queue holds error and status messages. When an error or status event occurs, a message that defines the error or status is placed in the error queue and the error available (EAV) bit in the status byte register is set. An error or status message is cleared from the error queue when it is read. The error queue is considered cleared when it is empty.
Section 13 Instrument Control Library (ICL) In this section: Command programming notes ........................................ 13-1 ICL command list .......................................................... 13-11 Command programming notes Wild characters For the following command reference, it is necessary to understand the following conventions. Many commands are expressed in a generic form using wild characters. A wild character indicates a channel, function, or trigger line.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual [N] The N character, enclosed by brackets ([ ]), is used in functions and attributes for the digital I/O line (1 to 14). For example, the function to assert an output trigger is generically expressed as follows: digio.trigger[N].assert To program the Series 3700 to assert an output trigger on trigger line 5, the following command statement is sent to the instrument: digio.trigger[5].
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) The results of a function call are used by assigning the return values to variables and accessing those variables. The following code will measure voltage and return the reading: dmm.func = 'dcvolts' reading = dmm.measure() print(reading) Output: 2.360000e+00 The above output indicates that the voltage reading is 2.36V. Attributes An attribute is a characteristic of an instrument feature or operation.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual Reading an attribute Reading an attribute is accomplished by passing it to a function call as a parameter or by assigning it to another variable. Parameter passing example: The following command reads the filter type for the DMM by passing the attribute to the print function, which outputs a value: print(dmm.filter.type) Output: 0.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) TSP-LinkTM nodes Each instrument or enclosure attached to the TSP-Link bus must be uniquely identified. This identification is called a TSP-Link node number, and the enclosures are called nodes. Each node must be assigned a unique node number. In relation to Test Script Processor (TSPTM), nodes look like tables.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual Logical instruments also look like TSP tables. In addition to the logical instrument-specific attributes and the commands to which they respond, there are a few attributes that provide information about the logical instrument. These attributes are listed below: name: A string that represents the logical instrument's name. For example, dmm.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) If the command was channel.getstate instead of channel.getcount, then 72 zero (0) or one (1) values would be returned (a 0 would indicate that the channel or backplane is open; a 1 would indicate that it is closed). The first 60 values are for Channels 1 to 60 (starting at 1 and increasing to 60). The last 12 values are the backplane relays (starting with Bank 1, Relay 1, increasing to Bank 2, Relay 6).
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual DMM configuration When a DMM configuration is updated, the instrument will go through all switch channels in the system to find ones that have the updated configuration assigned as its DMM configuration attribute setting. For each one found, it will verify that the new configuration attribute settings are still valid for that channel.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) The output will be 60 comma-delimited myconfig strings, as follows: myconfig,myconfig,myconfig,myconfig,myconfig,myconfig,mycon fig,myconfig,myconfig,myconfig,myconfig,myconfig,myconfi g,myconfig,myconfig,myconfig,myconfig,myconfig,myconfig, myconfig,myconfig,myconfig,myconfig,myconfig,myconfig,my config,myconfig,myconfig,myconfig,myconfig,myconfig,myco nfig,myconfig,myconfig,myconfig,myconfig,myconfig,mycon
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual If you now associate 'myconfig' with a 2-wire temperature function, 'myconfig' stays on Channels 1 to 30, but because Channels 31 to 60 are no longer paired, they are set back to a default DMM configuration setting of 'nofunction' because the unit has no way of knowing what configuration is desired on those channels.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) ICL command list This section provides a listing of Instrument Control Library commands and basic functional group usage. dataqueue.count (on page 3-10) dataqueue.next() (on page 3-11) delay functions delay() (on page 13-86) beeper functions and attributes beeper.beep() (on page 13-16) beeper.enable (on page 13-16) bit functions bit.bitand() (on page 13-17) bit.bitor() (on page 13-18) bit.
Section 13: Instrument Control Library (ICL) dmm.calibration.save() (on page 13-122) dmm.calibration.unlock() (on page 13122) dmm.calibration.verifydate (on page 13123) dmm.close() (on page 13-123) dmm.configure.catalog() (on page 13125) dmm.configure.delete() (on page 13-125) dmm.configure.query() (on page 13-126) dmm.configure.recall() (on page 13-128) dmm.configure.set() (on page 13-129) dmm.connect (on page 13-130) dmm.dbreference (on page 13-131) dmm.detectorbandwidth (on page 13-132) dmm.
Series 3700 System Switch/Multimeter Reference Manual lan.config.subnetmask (on page 13-197) lan.lxidomain (on page 13-197) lan.pingenable (on page 13-198) lan.status.dns.address[N] (on page 13199) lan.status.dns.hostname (on page 13200) lan.status.duplex (on page 13-200) lan.status.gateway (on page 13-200) lan.status.ipaddress (on page 13-201) lan.status.macaddress (on page 13-201) lan.status.port.dst (on page 13-201) lan.status.port.rawsocket (on page 13202) lan.status.port.telnet (on page 13-202) lan.
Section 13: Instrument Control Library (ICL) 13-248) scan.trigger.sequence.stimulus (on page 13-249) schedule functions and attributes schedule.alarm[x].enable (on page 13250) schedule.alarm[x].EVENT_ID (on page 13250) schedule.alarm[x].fractionalseconds (on page 13-250) schedule.alarm[x].period (on page 13251) schedule.alarm[x].ptpseconds (on page 13-251) schedule.alarm[x].repetition (on page 13-251) schedule.alarm[x].seconds (on page 13251) schedule.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) tspnet functions and attributes tspnet.clear() (on page 10-10) tspnet.connect() (on page 10-5) tspnet.disconnect() (on page 10-10) tspnet.execute() (on page 10-6) tspnet.idn() (on page 10-6) tspnet.read() (on page 10-8) tspnet.readavailable() (on page 10-9) tspnet.reset() (on page 10-10) tspnet.termination() (on page 10-11) tspnet.timeout (on page 10-11) tspnet.tsp.abort() (on page 10-13) tspnet.tsp.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual beeper functions and attributes The beeper generates a beep tone. It is typically used to announce the start and/or completion of a test or operation. beeper.beep() Function Generates a beep tone. Usage beeper.beep(duration, frequency) duration: Set from 0.1 to 100 (seconds). frequency: Set to 453, 621, 987, or 2400 (Hz). Remarks There are four beeper frequencies: 453Hz, 621Hz, 987Hz, and 2400Hz.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) bit functions Logic and bit operations The bit functions are used to perform bitwise logic operations on two given numbers, and bit operations on one given number. Logic and bit operations truncate the fractional part of given numbers to make them integers. NOTE The Test Script Processor (TSPTM) stores all numbers internally as single precision IEEE-754 floating point values.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual bit.bitand() Also see Logic and bit operations (on page 13-17) bit.bitor() (on page 13-18) bit.bitxor() (on page 13-18) Example AND'ing decimal 10 (binary 1010) with decimal 9 (binary 1001) will return a value of decimal 8 (binary 1000): value = bit.bitand(10, 9) print(value) Output: 8.000000e+00 bit.bitor() Function Performs a bitwise logical OR operation on two numbers. Usage value = bit.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) bit.bitxor() Details Logic and bit operations (on page 13-17) bit.bitor() (on page 13-18) Example Performs a bitwise logical exclusive OR operation on decimal 10 (binary 1010) with decimal 9 (binary 1001); will return a value of decimal 3 (binary 0011): value = bit.bitxor(10, 9) print(value) Output: 3.000000e+00 bit.clear() Function Clears a bit at a given index position. Usage value = bit.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual bit.get() Remarks This function returns the value of the bit in value1 at the given index. This is the same as returning value1 with all other non-indexed bits set to zero. Prior to retrieving the indexed bit, any fractional part of the given number will be truncated to make it an integer. The least significant bit of the given number has an index of 1 and the most significant bit has an index of 32.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) bit.getfield() Also see Logic and bit operations (on page 13-17) bit.clear() (on page 13-19) bit.get() (on page 13-19) bit.set() (on page 13-21) bit.setfield() (on page 13-21) bit.test() (on page 13-22) bit.toggle() (on page 13-23) Example The binary equivalent of decimal 13 is 1101. The field at index 2 and width 3 consists of the binary bits 110.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual bit.setfield() Function Overwrites a bit field at a given index position. Usage value = bit.setfield(value1, index, width, fieldvalue) value1: Given number. index: Index position of the least significant bit of the field; 1 to (33 - width ). width: Field width number of bits in the field; 1 to 24. fieldvalue: Value to write to the field. value: Returned value of the new number.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) bit.test() Remarks This function returns value, which is the result of the tested bit. The least significant bit of the given number is at index 1. The most significant bit is at index 32. Any fractional part of value1 will be truncated to make it an integer. If the indexed bit for value1 is set to 0, the returned value will be false.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual bit.toggle() Also see Logic and bit operations (on page 13-17) bit.clear() (on page 13-19) bit.get() (on page 13-19) bit.getfield() (on page 13-20) bit.set() (on page 13-21) bit.setfield() (on page 13-21) bit.test() (on page 13-22) Example The binary equivalent of decimal 10 is 1010. Toggling the bit at index position 3 will return a decimal value of 14 (binary 1110). value = bit.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) There are three different notations used to control relays: Backplane relay notation, MUX (multiplexer) channel notation, and Matrix card notation.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual Figure 13-2: Multiplexer card display 13-26 3700S-901-01 Rev.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) To control channels using matrix card notation, use SRCC, where: 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 2305 2 3 05 3112 3 1 12 6101 6 1 01 Figure 13-3: Matrix card display 3700S-901-01 Rev.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual Using channel.*() ICL commands Unless otherwise noted, channel.*() Instrument Control Library (ICL) commands use the channel list and return the value syntax described below. The channel list is specified according to the syntax presented in the channel list legend. Not all ICL commands support the fully described syntax. Any exclusions are noted in a specific command's documentation.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) Error Message Description invalid label or pattern name A string was found in the channel list that does not specify any known label or pattern name. no patterns accepted A pattern was specified for an ICL command that does not support patterns as input. no multiple channels accepted Multiple channels were specified for an ICL command that acts only on a single channel.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual Return value The return value is a string containing a list of comma-delimited individual return items. The channel list argument of the ICL command determines the number and order of these returned items. When the channel list parameter for this function is 'slotX', the response first lists the channels starting from lowest to highest.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) channel.calibration.adjustcount() Example To query for the adjustment count: CalCount = channel.calibration.adjustcount("1010") channel.calibration.adjustdate() Function Sets or gets the adjustment date in UTC format (number of seconds since January 1, 1970) on the unlocked channel. Usage mydate = channel.calibration.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual channel.calibration.lock() Remarks This command locks calibration on the card being calibrated, but does not save calibration data (which is lost if it is not saved before locking). Once locked, you must unlock calibration to perform it again. Only one card can be calibrated at a time. Therefore, the lock function works only on the currently unlocked card.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) channel.calibration.save() Remarks Only one card can be calibrated at a time. Therefore, the save function works only on the currently unlocked card. An error is generated if this command is issued when calibration is already locked. The system must receive this command before the channel.calibration.lock() (on page 13-31) command or the data will be lost.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual channel.calibration.step() Remarks The specified channel must be on the unlocked slot. Only DAC and totalizer channels can be calibrated. It is best to calibrate a single channel sequentially to completion before changing channels. The card assumes that the given voltage or current value is exactly what it is sourcing for the given step.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) channel.calibration.unlock() Remarks There is only one password per card. Therefore, the only acceptable values for channel list are slot1, slot2, and so on. Otherwise, an error is generated. An error is generated if the password that is entered does not match the one that was saved with channel.calibration.password() (on page 13-32).
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual channel.calibration.verifydate() Example To query the number of seconds since January 1, 1970: CalDate = channel.calibration.verifydate() To set the calibration verification date on Slot 1 based on the current date of the system: channel.calibration.verifydate(os.time()) To set the calibration verification date on Slot 1 as July 4, 2006: channel.calibration.verifydate(os.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) channel.clearforbidden() Example To clear Channels 2, 4, 6, and 8 of Slot 2 from being forbidden to close: channel.clearforbidden('2002,2004,2006,2008') To clear all channels from being forbidden to close: channel.clearforbidden('allslots') channel.close() Function Closes specified items in channel list parameter without opening any channels. Usage channel.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual channel.close() Actions associated with this function include: Parse the parameter. Close the specified items in ch_list. Incur the settling time and user delay. Command completes. An error is generated if: Syntax error exists in parameter string. An empty parameter string is specified, or a parameter string containing only spaces exists.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) channel.close() Example To close Channels 1 to 5 on Slot 1, Channel 3 on Slot 3, and mychans: channel.close('1001:1005, 3003, mychans') To close Channel 1 on Slot 2 and analog backplane relay 3 in Bank 1 on Slot 2: channel.close('2001, 2913') channel.connectrule Attribute Indicates the connection rule for closing and opening channels in the system. Usage To read the connect rule: rule = channel.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual channel.connectrule Remarks, continued With no connection rule (set to channel.OFF), the instrument attempts to simultaneously open and close switch channels in order to minimize the command execution time. This results in faster performance at the expense of guaranteed switch position. During the operation, multiple switch channels may simultaneously be in the close position.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) channel.connectsequential Example Set connect sequential to ON: channel.connectsequential = channel.ON channel.exclusiveclose() Function Closes the specified items so they are exclusively closed. Usage channel.exclusiveclose() ch_list: A string listing the channels and channel patterns to exclusively close.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual channel.exclusiveclose() Remarks, continued An error is generated if Syntax error in parameter string. The parameter string contains 'slotX', where X = 1 to 6, or 'allslots'. A specified channel or channel pattern is invalid. Channel number does not exist for slot specified. Slot is empty. Channel pattern does not exist. A forbidden item is specified.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) channel.exclusiveclose() Example To only have Channel 3 on Slot 3 closed along with its associated analog backplane relay 3 in Bank 1 on Slot 3: channel.setbackplane('3003','3913') channel.exclusiveclose('3003') To eliminate the need for channel.setbackplane: channel.exclusiveclose('3003, 3913') channel.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual channel.exclusiveslotclose() Remarks, continued An error is generated if: Syntax error in parameter string exists. An empty parameter string is specified, or parameter string with just spaces or a channel pattern that emulates an openall scenario exists. The parameter string contains 'slotX', where X = 1 to 6, or 'allslots'. A specified channel or channel pattern is invalid.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) channel.exclusiveslotclose() Example To have Channel 3 only closed on Slot 3 without affecting any other slot: channel.exclusiveslotclose('3003') To only have Channel 5 closed on Slots 1 and 2 without affecting any other slot: channel.exclusiveslotclose('1005, 2005') To only open channels on slots of channels in channel pattern MyRoute: channel.exclusiveslotclose('MyRoute') channel.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual channel.getbackplane() Remarks, continued An error is generated if: An empty parameter string is specified. An empty slot is specified. A specified channel does not exist for the card installed in a slot. A channel pattern is specified in parameter list. A syntax error exists in the parameter list. A specified channel does not have analog backplane relays associated with it like digital I/O.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) channel.getclose() Remarks The returned string lists the closed channels. If more than one channel is closed, they are comma delimited in the string. If ch_list equals 'slotX' where X is 1 to 6, the response indicates the channels that are closed on that specific slot, along with any backplane relays.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual channel.getclose() Example To see the channels and analog backplane relays that are closed on Slot 5: ClosedSlot5 = channel.getclose('slot5') To see all channels and analog backplane relays that are closed in a system: AllClosed = channel.getclose('allslots') To see all channels closed within a pattern called 'mychans': ClosedMyChans = channel.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) channel.getcount() Remarks, continued If an error is detected, a nil value is returned. No partial list of close counts is returned. When the channel list parameter for this function is 'slotX', the response first lists the channels starting from lowest to highest. After the channels, backplane relays are listed starting with lowest bank first and increasing to the highest.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual channel.getdelay() Remarks The parameter string may contain 'slotX', where X equals 1 to 6, or 'allslots'. An error message will be generated for the following reasons: An empty parameter string is specified. The specified channel does not exist. Slot is empty. The specified channel does not exist for card installed in slot. Parameter syntax error such as incorrect format for ch_list.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) channel.getforbidden() Remarks The ch_list parameter indicates the scope of channels to check and may include: 'allslots' or 'slotX' (where X equals 1 to 6). Channel ranges or individual channels. Analog backplane relays. Channel pattern(s). If there are no channels in the scope of the channel list that are on the forbidden list, the string returned will be empty or nil.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual channel.getimage() Details To just query for the analog backplane relays associated with a channel, use channel.getbackplane() (on page 13-45). Also see channel.pattern.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) channel.getlabel() Remarks The parameter ch_list can contain more than one channel. If it does, a comma is used to delineate the labels for the channels. The return string lists the labels in the same order that the channels were specified. The parameter string can contain 'slotX', where X equals 1 to 6, or 'allslots'. It can also contain a label.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual channel.getmatch() Example Query the match value set to digital I/O Channel 1, Slot 1: print(channel.getmatch("1001")) channel.getmatchtype() Function Gets the match type. Usage = channel.getmatchtype() match_type: Return string listing the comma-delimited states for channels in ch_list.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) channel.getoutputenable() Example Query the state of the first DAC channel on a card in Slot 1: print(channel.getoutputenable("1010")) channel.getpole() Function Queries the pole settings for the specified channels. Usage poles = channel.getpole() ch_list: A string listing the channels to query for their pole setting.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual channel.getpowerstate() Function Gets the current power state attribute for a channel. Usage = channel.getpowerstate () state: Return string of a comma-delimited list of power states. ch_list: String specifying the channels to query, using normal channel list syntax.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) channel.getstate() Remarks Use this command to query for the state of channels in the system. Each bit in the state represents a different indicator. Therefore, multiple indicators can be present (there values are OR‟ed bitwise). Any state or state latch commands behave in this manner. Different channel types support different state information (indicators).
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual channel.getstate() Example To query the state of the first 20 channels on Slot 4: MyState = channel.getstate('4001:4020') To see the state of channels and analog backplane relays in channel pattern called 'mypath': MyPathList = channel.pattern.getimage('mypath') print(MyPathList) print(channel.getstate(MyPathList)) or MyPathState = channel.getstate('mypath') Although the channel.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) channel.gettype() Remarks The channel type is defined by the physical hardware of the card where the channel resides. The following are valid channel types: channel.TYPE_SWITCH channel.TYPE_BACKPLANE channel.TYPE_DAC channel.TYPE_DIGITAL channel.TYPE_TOTALIZER Consult the card-specific documentation for more information on the channel types available for a given card.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual channel.open() Remarks This function opens the specified channels for switching aspects. The items specified in ch_list can include analog backplane relays. For the items specified to open, the channels associated with them open along with the associated analog backplane relays for each.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) channel.open() Details For delay time, see channel.setdelay() (on page 13-72) For forbidden channels, see channel.setforbidden() (on page 13-73) For analog backplane relays with channels, see channel.setbackplane() (on page 1370) For channels associated with a channel, see channel.getimage() (on page 13-51) For channels associated with a channel pattern, see channel.pattern.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual channel.pattern.catalog() Example To delete all user created channel patterns: for name in channel.pattern.catalog() do channel.pattern.delete(name) end To print all user created channel patterns: for name in channel.pattern.catalog() do print(name) end To print the names and items associated with all user created channel patterns: for name in channel.pattern.catalog() do print(name .. " = " .. channel.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) channel.pattern.getimage() Remarks A nil response will be generated if: The channel pattern does not exist. A channel is specified. An analog backplane relay is specified. The returned string lists the channels in the SCCC or SRCC format (even if a channel pattern was used to create it).
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual channel.pattern.setimage() Remarks If the name specified is being used for an existing channel pattern, that pattern is overwritten with the new pattern channel image if no errors occur. The previous image associated with the name is lost. The DMM configuration associated with the pattern remains unchanged in this scenario. An error is generated if The name parameter already exists as a label.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) channel.pattern.setimage() Details Channel patterns are not persistent through a power cycle and are stored when a setup.save() (on page 13-254) command is executed. Use setup.recall() (on page 13-253) to restore them. The following restrictions exist when naming a channel pattern: The name must contain only letters, numbers, or underscore. The name must start with a letter. The name is case sensitive.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual channel.pattern.setimage() Example To create a channel pattern called mychans using Channels 1 to 10 on Slot 3: channel.pattern.setimage('3001:3010', 'mychans') To add analog backplane relay 1 of Bank 1 on Slot 3 to mychans: OldList = channel.pattern.getimage('mychans') NewList = OldList .. ',3911' channel.pattern.delete('mychans') channel.pattern.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) channel.pattern.snapshot() Remarks This command stores the image of closed and opened channels, along with analog backplane relays in the system, and associates them with the name parameter in persistent memory. If the name specified is being used for an existing channel pattern, that pattern is overwritten with the new pattern channel image if no errors occur.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual channel.read() Remarks The width parameter is optional and defaults to 1. The reading buffer parameter is optional. A width does not have to be specified in order to specify a reading buffer. However, if both are specified, the width must be first in the argument list. For digital I/O channels, only a width of 1, 2, 3, or 4 is supported.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) channel.reset() Remarks This command resets only the channel aspects for the items specified to factory default settings. For the items specified in the parameter list (ch_list) the following actions occur: For closed channels or analog backplane relays, they open. For channels, the poles reset to 2 and paired channels are changed to match. Additional user delay is set to 0.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual channel.reset() Also see dmm.reset() (on page 13-161) reset() (on page 13-230) scan.reset() (on page 13-242) channel functions and attributes (on page 13-24) Example To perform a reset on all channels in the system: channel.reset('allslots') To reset channels on Slot 1 only: channel.reset('slot1') To reset only Channels 1 to 5 on Slot 3: channel.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) channel.setbackplane() Usage channel.setbackplane(, abuslist) ch_list: A string listing the channels to change. abuslist: A string listing analog backplane relays to set for channels in ch_list. Remarks The abuslist parameter must specify the entire list of analog backplane relays needed. The analog backplane relays specified in the abuslist parameter are used or affected by: channel.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual channel.setbackplane() Remarks, continued An error is generated if: An empty slot is specified. A specified channel or analog backplane relay does not exist for the card installed in a slot. A syntax error exists in either of the parameters. An empty parameter string is received for ch_list. An empty string is okay for abuslist. A parameter string of just spaces is treated like an empty string.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) channel.setdelay() Function Sets additional delay time for channels specified in ch_list. Usage channel.setdelay(, value) ch_list: A string listing channels to modify their delay time. Value: Desired delay time for items in ch_list. Minimum is 0 seconds. Remarks An error message will be generated for the following reasons: An empty parameter string is specified.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual channel.setforbidden() Function Prevents the closing of specified channels. Usage channel.setforbidden() ch_list: A string listing the channels to make forbidden to close. Remarks The ch_list parameter indicates the scope of channels affected and may include: allslots or 'slotX' (where X equals 1 to 6). Channel ranges or individual channels Analog backplane relays.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) channel.setlabel() Remarks This command sets the label of the specified channel in ch_list to the value specified in the label parameter. To clear label use the command with the label parameter equaling an empty string "" or a string with a space as the first character.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual 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 on Slot 1 back to '1001' channel.setlabel('1001', '') or channel.setlabel('1001', ' ') channel.setmatch() Function Sets the match value on a channel. Usage channel.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) channel.setmatchtype() Remarks There are four types of match values: channel.MATCH_EXACT channel.MATCH_ANY channel.MATCH_NOT_EXACT channel.MATCH_NONE For an EXACT match, the state match indicator only becomes TRUE when the match value AND match mask value EQUAL the channel read value.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual channel.setmode() Remarks Different channel types contain additional configurable settings. These settings are grouped together by channel type as described in the following paragraphs. For digital I/O channels, the mode indicates the direction of the channel (input or output). The following modes are supported: channel.MODE_INPUT (default) channel.MODE_OUTPUT channel.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) channel.setoutputenable() Function Sets the output enable attribute on a channel. Usage channel.setoutputenable(, ) ch_list: String specifying the channels to set, using normal channel list syntax. state: A value representing the desired state of the channel‟s output. Remarks Channels with output OFF consume less power.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual channel.setpole() Remarks An error message is generated for the following reasons: An empty parameter string is specified. The value parameter is an invalid setting for the specified channel. The specified channel does not exist for the card installed in a slot. The channel is for an empty slot. The value parameter is invalid for command – parameter out of range error.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) channel.setpowerstate() Function Sets the power state attribute on a channel. Usage channel.setpowerstate(, ) ch_list: String specifying the channels to query, using normal channel list syntax. state: A value representing the desired channel‟s power state. Remarks Channels with an OFF power state consume less power.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual channel.setstatelatch() Remarks Each indicator is represented by a bit in the mask. For non-latching applications, the state indicator clears automatically when the causing condition clears itself. For latching applications, the condition is cleared using the channel.resetstate() command. When using the trigger module, events are always non-latching (or pulse oriented).
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) channel.trigger[N].set() Function Sets the channel status trigger module to watch the state of a specific channel. Usage channel.trigger[N].set(, ) ch_list: String specifying the channels to query, using normal channel list syntax. state_match: Value of the state indicators which are to be matched.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual channel.write() Function Writes a value to a channel. Usage channel.write(, , []) ch_list: String specifying channels to write, using normal channel list syntax. value: The value to be written to the channel. width: Optional value that specifies the channel width of the write. Remarks For widths greater than 1, the specified channel occupies the least significant byte.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) dataqueue functions and attributes Use the dataqueue commands to share data between test scripts running in parallel, and to access data from a remote group or a local node on a TSP-Link network at any time. You can access data from the data queue even if a remote group or a node has overlapped operations in process. dataqueue.add() Function Store an item of data in the data queue.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual dataqueue.count Attribute The number of entries currently stored in the data queue. Usage count = dataqueue.count count: Number of entries in the data queue. Remarks This attribute is a read-only attribute that indicates how many entries are in the data queue. dataqueue.next() Function Retrieve an entry from the data queue. Usage value = dataqueue.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) digio functions and attributes Use the functions and attributes in this group to control read/write and trigger operations for the digital I/O port. NOTE The digital I/O lines can be used for both input and output. If a line is being driven low, then a "0" value will be read by a command for that line. You must write a "1" to all digital I/O lines that are to be used as inputs. digio.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual digio.readport() Example Assume lines 2, 4, 6 and 8 are set high, and the I/O port is then read: data = digio.readport() print(data) Output: 1.700000e+02 (binary 10101010) digio.trigger[N].assert() Function Asserts a trigger on one of the digital I/O lines. Usage digio.trigger[N].assert() N: Digital I/O trigger line: 1 to 14 Remarks The set pulsewidth determines how long the trigger is asserted.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) digio.trigger[N].mode Usage To read the trigger mode: tmode = digio.trigger[N].mode To write the trigger mode: digio.trigger[N].mode = tmode N: Digital I/O trigger line 1 to 14 Set tmode to one of the following values: digio.TRIG_BYPASS or 0: Allow direct control of the line. digio.TRIG_FALLING or 1: Detect falling edge triggers as input. Assert a TTL-low pulse for output. digio.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual digio.trigger[N].overrun Attribute Event detector overrun status. Usage overrun = digio.trigger[N].overrun overrun: Trigger overrun state. N: Digital I/O trigger line: 1 to 14 Remarks This attribute is a read-only attribute that indicates if an event was ignored because the event detector was already in the detected state when the event occurred.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) digio.trigger[N].release() Example Releases trigger line 4: digio.trigger[4].release() digio.trigger[N].stimulus Attribute Event to cause this trigger to assert. Usage triggerstimulus = digio.trigger[N].stimulus - or - digio.trigger[N].stimulus = triggerstimulus N: Digital I/O trigger line: 1 to 14 triggerstimulus: The event identifier for the triggering event.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual digio.trigger[N].wait() Function Waits for a trigger. Usage triggered = digio.trigger[N].wait(timeout) N: Digital I/O trigger line: 1 to 14 timeout: Set timeout in seconds. triggered: Returns `true' if a trigger was detected, or `false' if no triggers were detected during the timeout period. Remarks This function will wait up to timeout seconds for an input trigger.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) digio.writeport() The binary representation of data indicates the output pattern to be written to the I/O port. For example, a data value of 170 has a binary equivalent of 00000010101010. Lines 2, 4, 6 and 8 are set high (1), and the other 10 lines are set low (0). Remarks Write protected lines will not be changed (see digio.writeprotect() (on page 13-93)).
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual display.clear() Remarks This function will switch to the user screen and then clear the display. The display.clear(), display.setcursor() (on page 13-105), and display.settext() (on page 13-106) functions are overlapped, non-blocking commands. That is, the script will NOT wait for one of these commands to complete. These non-blocking functions do not immediately update the display.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) display.getannunciators() Remarks This function returns a bitmap value that indicates which annunciators are turned on. The 16- bit binary equivalent of the returned value is the bitmap. For example, assume the returned value is 1028. The binary equivalent for this value is as follows: 0000010000000100 The above bitmap indicates that bits 3 and 11 are set.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual display.getcursor() Function Reads the present position of the cursor for the user display. Usage row, column, style = display.getcursor() row: Returns the row for the present cursor position. column: Returns the column for the present cursor position. style: Returns the cursor style.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) display.getlastkey() Remarks This read-only function returns the key code for the last pressed key. key returns one of the following values: Key List Value Key List Value display.KEY_RIGHT 103 display.KEY_INSERT 78 display.KEY_LEFT 104 display.KEY_OPENALL 79 display.WHEEL_LEFT 107 display.KEY_CONFIG 80 display.WHEEL_RIGHT 114 display.KEY_RANGEDOW N 81 display.KEY_RANGEUP 65 display.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual display.gettext() Function Reads the text presently displayed Usage There are five ways to use this function: text = display.gettext() text = display.gettext(embellished) text = display.gettext(embellished, row) text = display.gettext(embellished, row, column_start) text = display.gettext(embellished, row, column_start, column_end) embellished Set to false to return text as a simple character string.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) display.inputvalue() Function Displays a formatted input field that the operator can edit. Usage There are four ways to use this function: value = display.inputvalue(format) value = display.inputvalue(format, default) value = display.inputvalue(format, default, min) value = display.inputvalue(format, default, min, max) format: Define format string for the input field using `0's, the decimal point (.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual display.inputvalue() Remarks (cont.) After sending this command, script execution pauses for the operator to enter a value and press the ENTER key. If limits are used, the operator will not be able to input values outside the minimum and maximum limits.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) display.loadmenu.add() Remarks This function adds an entry to the USER TESTS submenu of the LOAD TEST menu. If the given item is subsequently selected using the front panel, the chunk will be executed when the RUN key is pressed. The chunk can be made up of scripts, functions, variables, and commands. With memory set to display.SAVE, commands are saved with the chunk in nonvolatile memory.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual display.locallockout Attribute LOCAL key disabled. Usage To read state of lockout: lockout = display.locallockout To write state of lockout: display.locallockout = lockout Set lockout to one of the following values: Unlocks LOCAL key: 0 or display.UNLOCK Locks out LOCAL key: 1 or display.LOCK Remarks Setting display.locallockout to display.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) display.prompt() Function Prompts the user to enter a parameter from the front panel. Usage There are four ways to use this function: value = display.prompt(format, units, help) value = display.prompt(format, units, help, default) value = display.prompt(format, units, help, default, min) value = display.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual 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 on the bottom line. You can also specify minimum and maximum limits for the input field. When NOT using the "+" sign for the value field, the minimum limit cannot be set to less than zero.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) display.screen Example Selects the user display: display.screen = display.USER display.sendkey() Function Send key code that simulates the action of a front panel control being pressed. Usage display.sendkey(keycode) Set key code to one of the values shown below: Key List Value Key List Value display.KEY_RIGHT 103 display.KEY_INSERT 78 display.KEY_LEFT 104 display.KEY_OPENALL 79 display.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual display.setcursor() Function Sets the position of the cursor. Usage There are two ways to use this function: display.setcursor(row, column) display.setcursor(row, column, style) row: Set row number for the cursor (1 or 2). column: Set the column number for the cursor. For row 1, the column can be set from 1 to 20. For row 2, the column can be set from 1 to 32.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) display.settext() Remarks This function selects the user display screen, and displays the given text. The first write to the display after power-on will clear the user screen. The text starts at the present cursor position. After the text is displayed, the cursor will be located after the last character in the display message. Top line text will not wrap to the bottom line of the display automatically.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual display.waitkey() Remarks After sending this function, script execution pauses until a front panel key or the navigation wheel is pressed, or the navigation wheel is turned to the right or left. After pressing a control or turning the navigation wheel, the key code value for that key will be returned. The chart shown below lists the key code value for each front panel control.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) display.waitkey() Example The following code pauses script execution and wait for the operator to press a key or the navigation wheel, or rotate the navigation wheel: key = display.waitkey() print(key) 8.600000e+01 The above output (8.600000e+01, or 86) indicates that the STEP key was pressed.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual 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 response as mm/dd/yyyy: print(os.date("%m/%d/%Y", dmm.adjustment.date)) 07/04/2007 To query date and format the response as mm/dd/yy: print(os.date("%x", dmm.adjustment.date)) 07/04/07 dmm.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) dmm.aperture Also see dmm.func (on page 13-137) dmm.nplc (on page 13-152) Example To set the aperture to 16.67 milliseconds for DC volts: dmm.func = "dcvolts" dmm.aperture = 16.67e-3 dmm.appendbuffer() Function Appends data from reading buffer to USB flash drive. Usage dmm.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual dmm.appendbuffer() Remarks The first parameter (reading buffer name) represents the reading buffer to be saved. The second (filename) is the filename of file to append reading buffer data to on USB flash drive. The third parameter is optional and indicates how the date and time information from the buffer should be saved.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) dmm.autodelay Attribute Indicates the auto delay setting for the active DMM function. Usage To read the autodelay setting: value = dmm.autodelay value: Represents the present auto delay setting To write the autodelay setting: dmm.autodelay = value value: Represents the desired auto delay. Set to one of the following: dmm.ON or 1 to enable auto delay dmm.OFF or 0 to disable auto delay dmm.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual dmm.autorange Attribute Indicates the auto range setting for the active DMM function. Usage To read the auto range: value = dmm.autorange value: Represents the present auto range setting (1 = ON, 0 = OFF). To write the auto range: dmm.autorange = value value: Represents the desired auto range setting. Use one of the following: dmm.ON or 1: Enables auto ranging. dmm.OFF or 0: Disables auto ranging.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) dmm.autozero Remarks This is the auto zero setting for the DMM. It applies to the selected function as indicated by dmm.func (on page 13-137). Querying the auto zero when the selected function does not have an auto zero setting associated with it will cause nil to be returned. An error is generated if command is received when dmm.func = "nofunction". Also, an error will be generated if the value is invalid.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual dmm.buffer.catalog() Also see dmm.buffer.info (on page 13-116) Example To print all user-created local reading buffers in the system: for name in dmm.buffer.catalog() do print(name) end dmm.buffer.info() Function Returns the size and capacity of the reading buffer parameter. Usage size, capacity = dmm.buffer.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) dmm.buffer.info() Example Assume the system has the following reading buffers created: buf1, buf2, buf3, buf4, and buf5. Now, query the system for the size and capacity of each reading buffer without formatting the results. for n in dmm.buffer.catalog() do print(dmm.buffer.info(n)) end Output results: 0.000000000e+000 2.000000000e+003 0.000000000e+000 4.000000000e+003 0.000000000e+000 5.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual dmm.buffer.maxcapacity Remarks Use this attribute to determine what the system maximum capacity for reading buffer storage is. This value represents the total system reading buffer storage size. A single reading buffer may be created (dmm.makebuffer() (on page 7-8) with this as its size or several reading buffers may be created in the system that are smaller in size.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) dmm.calibration.ac() Function Signals the desired AC calibration step on the DMM. Usage dmm.calibration.ac(step, value) step: Represents the AC calibration step to perform value Represents the associated value for this functions step. This is an optional parameter. Only use if calibration step has a value associated. If no value is needed, use dmm.calibration.ac(step).
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual dmm.calibration.ac() Details, continued AC current calibration dmm.calibration.ac(11) ' AC cal step 11 (100uA 1kHz step) dmm.calibration.ac(12) ' AC cal step 12 (1mA 1kHz step) dmm.calibration.ac(13) ' AC cal step 13 (10mA 1kHz step) dmm.calibration.ac(14) ' AC cal step 14 (100mA 1kHz step) dmm.calibration.ac(15) ' AC cal step 15 (1A 1kHz step) dmm.calibration.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) dmm.calibration.dc() Details DC volts calibration dmm.calibration.dc(1) ‘ DC cal step 1 (4 wire short circuit step) dmm.calibration.dc(2) ‘ DC cal step 2 (open circuit step) dmm.calibration.dc(3, ) ‘ DC cal step 3 (+10V step, 9 < value < 11) dmm.calibration.dc(4, ) ‘ DC cal step 4 (-10V step, -11 < value < -9) dmm.calibration.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual dmm.calibration.lock() Function Locks calibration. Usage dmm.calibration.lock() Remarks Use this command to lock an unlocked calibration. Once locked, calibration will need to be unlocked to be performed again. An error will be generated if this command is issued when calibration is already locked. This function locks calibration but does not save calibration data.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) dmm.calibration.unlock() Function Unlocks calibration. Usage dmm.calibration.unlock(password) password: A string representing the password to unlock calibration. Remarks Use this command to unlock calibration (if locked). An error will be generated if the password does not match the one saved. The default password from the factory is "KI003706". This may be changed with dmm.calibration.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual dmm.close() Remarks The actions associate with this function includes: Opens previously closed channels if they interfere with measurement including analog backplane relays 1, 2, and common-side ohms on all slots, if needed. The opening and closing of channels mimics that of channel.exclusiveslotclose() (on page 13-43). Therefore, when using a for-loop with dmm.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) dmm.close() Also see channel.exclusiveslotclose() (on page 13-43) channel.getclose() (on page 13-46) channel.getstate() (on page 13-56) dmm.open() (on page 13-154) Example To close Channel 3 on Slot 3 and prepare the DMM for measuring temperature at 'mytemperature' settings: dmm.setconfig('3003', 'mytemperature') dmm.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual dmm.configure.delete() Remarks The function will delete the specified DMM configuration from memory. An error will be generated if the name specified does not exist as a user configuration. After executing this command, the specified name will no longer exist as a valid configuration. Deleting an existing DMM configuration invalidates an existing scan list. Also see dmm.configure.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) dmm.configure.query() Remarks This function will list the settings contained within the specified configuration, myconfig, along with the corresponding DMM attributes contained within that configuration. A nil response is generated if the specified configuration does not exist, along with an error message stating the referenced name does not exist. The second parameter, myseparator, is optional.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual dmm.configure.query() Example To see the DMM attributes within MyDcv separated by commas: MyDcvItems = dmm.configure.query("MyDcv") print(MyDcvItems) To see the DMM attributes within MyDcv separated by newlines: MyDcvItems = dmm.configure.query("MyDcv", "\n") print(MyDcvItems) To see the factory default settings for DC volts separated by newlines: FactoryDCV = dmm.configure.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) dmm.configure.recall() Remarks This command will recall a saved DMM configuration from memory. The DMM attributes associated with that configuration will be updated to reflect the settings in the configuration. The ones not pertinent will not be changed. The function associated with the configuration will become the active one. The previous values of those being updated will be lost.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual dmm.configure.set() Remarks If the configuration specified is being used for an existing DMM configuration, then that configuration will be overwritten with the new configuration settings, if no errors occur. The previous configuration associated with config will be lost. All channels that have this configuration as their associated DMM configurations now will start using the new attribute settings.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) dmm.connect Usage To read the DMM relay connection setting: value = dmm.connect value: Represents the present DMM relay connection setting To write the DMM relay connection setting: dmm.connect = value value: Represents the desired DMM relay connection setting where value is: dmm.CONNECT_NONE or 0 to have no relays connected dmm.CONNECT_ALL or 7 to have all relays connected (default value) dmm.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual 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 this setting when the selected function does not support it will cause nil to be returned. Command only applies when dmm.func = "dcvolts" or "acvolts". For all other functions an error will be generated if this command is received.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) dmm.displaydigits Attribute Indicates the display digits setting for the selected DMM function. Usage To read the display digits setting: value = dmm.displaydigits value: Represents the present display digits setting. To write the display digits setting: dmm.displaydigits = value value: Represents the desired display digits setting. Set to one of the following: dmm.DIGITS_7_5 or 7 to enable 7.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual dmm.drycircuit Remarks This is the dry circuit setting for the DMM and it applies to the selected function as indicated by dmm.func. Querying the setting when the selected function does not support it will cause nil to be returned. This command only applies when dmm.func = "fourwireohms" or "commonsideohms". All other function settings will generate an error if the command is received.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) dmm.filter.enable Attribute Enables or disables filtered measurements for the selected DMM function. Usage To read the filter enable: value = dmm.filter.enable value: Represents the present filter enable setting To write the filter enable: dmm.filter.enable = value value: Represents the desired filter enable setting. Use one of the following: dmm.ON or 1 to enable filter measurements dmm.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual dmm.filter.type Remarks This is the filter type setting for the DMM and it applies to the selected function as indicated by dmm.func (on page 13-137). Querying the setting when the selected function does not support it will cause nil to be returned. There are two averaging filter types to choose from: Repeating and moving.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) dmm.filter.window Also see dmm.filter.enable (on page 13-134), dmm.filter.count (on page 13-134), dmm.filter.type (on page 13-135). Example To set the filter window for 2-wire ohms to 0.25: dmm.func = "twowireohms" dmm.filter.window = 0.25 dmm.fourrtd Attribute Indicates the type of 4-wire RTD being used. Usage To read the 4-wire RTD type: value = dmm.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual dmm.func Attribute Sets or indicates the selected function for the DMM. Usage To read the function: myfunc = dmm.func myfunc: string indicating the presently selected DMM function To write the function: dmm.func = myfunc myfunc: string representing the desired active DMM function Set myfunc to one of the following: "dcvolts" or dmm.DC_VOLTS "acvolts", or dmm.AC_VOLTS "dccurrent" or dmm.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) 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. Therefore, to see a setting for a particular function, you need to change to that function with this command (dmm.func) and then write or read the desired setting. For example, to see the NPLC setting for DC volts: dmm.func = "dcvolts" dcv_nplc = dmm.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual dmm.getconfig() Remarks Use this command to query for DMM configurations associated with channels or channel patterns. The response will be a comma-delimited string listing the configurations in the same order as specified in ch_list. The configurations listed in the response indicate how the DMM will be configured when the corresponding channel or channel pattern is closed with the dmm.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) dmm.inputdivider Remarks This attribute is only valid when dmm.func = "dcvolts". All other functions generate an error and return nil when queried. Changing functions with dmm.func (on page 13-137) will reflect the 10M ohm input divider for that function. The factory default and dmm.reset() (on page 13-161) function value is dmm.OFF. Example To enable the input divider for DC volts: dmm.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual dmm.limit[Y].clear() Example where Y = 1 or 2 for limit number To clear the test results for both the high and low limit 2: dmm.limit[2].clear() 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.limit[Y].enable To write the state of limit Y: dmm.limit[Y].enable = value Set value to: dmm.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) dmm.limit[Y].high.fail Attribute Query for the high test results of limit Y. Usage To read the high fail indication of limit Y: where Y = 1 to 2 for limit number value = dmm.limit[Y].high.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual dmm.limit[Y].low.fail Remarks where Y = 1 or 2 for limit number This attribute returns the results of low limit Y testing: 0 indicates test passed – measurement within the low limit 1 indicates test failed – measurement has exceeded low limit A failed indication does indicate the low limit caused the failure. You may read the measurement event register of the status model to see fail indication as well.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) dmm.linesync Usage To read the linesync state: value = dmm.linesync To write the linesync state: dmm.linesync = value value: Set to one of the following: dmm.ON or 1 to enable line sync dmm.OFF or 0 to disable line sync Remarks This attribute is only valid when dmm.func = "dcvolts", "dccurrent", "twowireohms", "fourwireohms", "temperature", "continuity", and "commonsideohms.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual dmm.makebuffer() Details Once a buffer is created, the attributes are: mybuffer.appendmode = 1 (ON) or 0 (OFF) – default 0 over a bus interface, but 1 for ones created on the front panel mybuffer.basetimeseconds returns the seconds for reading buffer entry 1 (read-only attribute). mybuffer.basetimefractional returns the seconds and fractional seconds for reading buffer entry 1 (read-only attribute).
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) dmm.makebuffer() Also see Reading buffers (on page 7-12) for more information on reading buffer aspects in the system Example To create a user reading buffer named mybuffer2, with a capacity of 300: mybuffer2 = dmm.makebuffer(300) To delete mybuffer2: mybuffer2 = nil dmm.math.enable Attribute Enable or disable math operation on measurements. Usage To read the math operation state: value = dmm.math.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual dmm.math.format Remarks To have no math operation performed on the measurements, set this attribute to dmm.MATH_NONE. Having this equal dmm.MATH_NONE and enabling math operation (dmm.math.enable), the equivalent effect is disabling math operation. Use a setting of dmm.MATH_MXB to have Y = mX + b where X is the normal measurement m is user entered constant for scale factor (dmm.math.mxb.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) dmm.math.mxb.bfactor Attribute Specifies the offset for the y = mx + b operation. Usage To read the offset for the y = mx + b operation: value = dmm.math.mxb.bfactor To write the offset for the y = mx + b operation: dmm.math.mxb.bfactor = value value: Valid range is -4294967295 to +4294967295 Remarks This attribute specifies the offset (b) for an mx + b operation. Also see dmm.math.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual dmm.math.mxb.units Also see dmm.math.format (on page 13-147) Example To set the units for mx +b operation to 'Q': dmm.math.mxb.units = 'Q' dmm.math.percent Attribute Specifies the constant to use for the percent operation. Usage To read the constant for the percent operation: value = dmm.math.percent To write the constant for the percent operation: dmm.math.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) dmm.measure() Remarks This function returns only the last actual measurement as reading. To use the additional information acquired while making a measurement, a reading buffer must be used.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual dmm.measurewithtime() Function Handles taking measurements on the DMM without using the trigger model and returns the reading along with time information. Usage There are two ways to use this function: To return the last reading of the measurement process taken and accounted for by dmm.measurecount: reading, seconds, fractional = dmm.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) dmm.nplc Attribute Indicates the integration rate in line cycles for the DMM. Usage To read the integration rate: value = dmm.nplc value: Represents the present integration rate in line cycles To write the integration rate: dmm.nplc = value value: Represents the desired integration in line cycles: 60 Hertz: 0.0005 to 15 50 Hertz: 0.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual dmm.offsetcompensation Attribute Indicates the offset compensation setting for the DMM. Usage To read the offset compensation: value = dmm.offsetcompensation value: Represents the present offset compensation setting. To write the offset compensation: dmm.offsetcompensation = value value: Represents the desired offset compensation setting. Set to one of the following: dmm.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) dmm.open() Remarks Aspects associated with this function include: Opening the channels and analog backplane relays for a measuring function. The configuration (see dmm.getconfig() (on page 13-139)) associated with the specified channel dictates whether a paired channel is open or not. For channel patterns, the channels associated with it will be opened.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual dmm.opendetector Attribute Indicates the state of the temperature or 4-wire ohms open lead detector being used. Usage To read the open lead detector state: value = dmm.opendetector value: Represents the present open detector state To write the open lead detector state: dmm.opendetector = value value: Represents the desired open detector state. Set to one of the following: dmm.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) dmm.range Remarks This attribute is the range setting for the selected function (see dmm.func (on page 13137)) of the DMM. Querying the range when the selected function does not have a range associated with it will cause nil to be returned. The range will be selected based on which one best suits the expected measure value (value parameter). The command is applicable when dmm.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual dmm.refjunction Attribute Indicates the type of the thermocouple reference junction. Usage To read the reference junction type: value = dmm.refjunction value: Represents the present reference junction type. To write the reference junction type: dmm.refjunction = value value: Represents the desired reference junction type. Use one of the following values: dmm.REF_JUNCTION_SIMULATED or 0 dmm.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) dmm.rel.acquire() Remarks This function triggers the DMM to take a new measurement for the selected function. This measurement will then be stored as the new REL level setting. This function will return the acquired reading or nil, if an error occurred. An error will be generated if the active function does not support a REL level setting or the DMM is unable to take the measurement.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual 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.func (on page 13-137). Querying the setting when the selected function does not support it will cause nil to be returned. When relative measurements are enabled, all subsequent measured readings will be offset by the specified relative offset (see dmm.rel.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) dmm.rel.level Remarks This is the relative offset level setting for the DMM. It applies to the selected function as indicated by dmm.func (on page 13-137). Querying the setting when the selected function does not support it will cause nil to be returned. When relative measurements are enabled (see dmm.rel.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual dmm.reset() Remarks When the parameter equals "active", this command will only reset the DMM aspects of the system for the active function only. Settings affects are: Active dmm function (dmm.func (on page 13-137)) has its pertinent attributes reset to factory default values. Other functions are unchanged. DMM configurations (dmm.setconfig() (on page 13-168) and dmm.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) dmm.rtdalpha Remarks This attribute is only valid when dmm.func = "temperature". All other configurations generate an error and return nil when queried. Errors are also generated if the parameter value is out of range. The valid range for user alpha is 0 to 0.01. For temperature, this setting is used when the transducer type is set to 3 or 4wire RTD.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual dmm.rtdbeta Remarks This attribute is only valid when dmm.func = "temperature". All other configurations generate an error and return nil when queried. Also, get errors if parameter value out of range. The valid range for user beta is 0 to 1.0. For temperature, this setting is used when the transducer type is set to 3 or 4-wire RTD.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) dmm.rtddelta Remarks This attribute is only valid when dmm.func = "temperature". All other configurations generate an error and return nil when queried. Also, get errors if parameter value out of range. The valid range for user delta is 0 to 5. For temperature, this setting is used when the transducer type is set to 3 or 4-wire RTD.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual dmm.rtdzero Remarks This attribute is only valid when dmm.func = "temperature". All other configurations generate an error and return nil when queried. Errors will also be generated if the parameter value is out of range. The valid range for user zero is 0 to 10000. For temperature, this setting is used when the transducer type is set to 3 or 4wire RTD.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) dmm.savebuffer() Usage dmm.savebuffer('', '', time_format) reading buffer name: The name of a previously created DMM reading buffer, specified as a string. Do not pass the reading buffer name without quotes because this generates a data type error. For example, if the reading buffer is mybuffer, then the buffer name should be specified as "mybuffer" and not mybuffer.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual dmm.savebuffer() Example To save readings from valid DMM buffer named mybuffer with default time information to a file named mydata.csv on the USB flash drive: dmm.savebuffer('mybuffer', '/usb1/mydata.csv') To save readings from mybuffer with relative time stamps to a file named mydatarel.csv on the USB flash drive: dmm.savebuffer('mybuffer', '/usb1/mydatarel.csv', dmm.buffer.SAVE_RELATIVE_TIME) dmm.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) dmm.setconfig() Remarks This command will associate the specified DMM configuration (dmm_config) with the items specified in the parameter channel list (ch_list). The configuration being assigned determines whether analog backplane relay 1 or 2 get used, based on the function associated with the configuration when being assigned to a channel.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual dmm.simreftemperature Attribute Indicates the simulated reference temperature for thermocouples. Usage To read the simulated reference temperature: value = dmm.simreftemperature value: Represents the present simulated reference temperature To write the simulated reference temperature: dmm.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) dmm.thermistor Remarks This attribute is only valid when dmm.func = "temperature". All other configurations generate an error and return nil when queried. When the function is temperature, the thermistor attribute is only used when the transducer type is set for thermistor. For all other transducer types, the setting will be updated but not used until thermistor is selected for the transducer type.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual dmm.thermocouple Remarks This attribute is only valid when dmm.func = "temperature". All other configurations generate an error and return nil when queried. When the function is temperature, the thermocouple attribute is only used when the transducer type is thermocouples (see dmm.transducer (on page 13-173) attribute).
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) dmm.threertd Example To set the type of three-wire RTD for PT3916: dmm.func = "temperature" dmm.transducer = dmm.TEMP_THREERTD dmm.threertd = dmm.RTD_PT3916 dmm.threshold Attribute Indicates the threshold range. Usage To read the threshold setting: value = dmm.threshold value: Represents the present threshold setting. To write the threshold setting: dmm.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual dmm.transducer Attribute Indicates the transducer type. Usage To read the transducer type: value = dmm.transducer value: Represents the present transducer type. To write the transducer type: dmm.transducer = value value: Represents the desired transducer type. For value, use one of the following: dmm.TEMP_THERMOCOUPLE or 1 dmm.TEMP_THERMISTOR or 2 dmm.TEMP_THREERTD or 3 dmm.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) dmm.units Usage To read the units: value = dmm.units value: Represents the present units. To write the units: dmm.units = value value: Represents the desired units. For value, use one of the following: dmm.UNITS_VOLTS or 0 dmm.UNITS_DECIBELS or 1 dmm.UNITS_CELSIUS or 2 dmm.UNITS_KELVIN or 3 dmm.UNITS_FAHRENHEIT or 4 Remarks This attribute is only valid when dmm.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual errorqueue functions and attributes Use the functions and attributes in this group to read the entries in the error queue. errorqueue.clear() Function Clears all entries out of the error queue. Usage errorqueue.clear() Remarks This function removes all entries from the error queue. Details See Error and status messages (on page 17-1) and Status Model (on page 12-1). Also see errorqueue.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) 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 queue. Error codes and messages are listed in order. If there are no entries in the queue, code 0, "Queue Is Empty" is returned. Returned severity levels include the following: 0 Informational: Indicates no error: "Queue is Empty".
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual Field # Field Value Field Description 1 “17:26:35.690 10 Oct 2007” Formatted UTC time in 24-hour format including fractional seconds. 2 “LAN0” Event identifier. NOTE This event identifier is zero-based (LAN0LAN7). When specifying the LAN trigger using lan.trigger[N], the minimum value for N is 1. Therefore LAN0 to LAN 7 corresponds to lan.trigger[1] through lan.trigger[8], respectively. 3 “192.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) eventlog.clear() Also see LXI event log (on page 11-7) eventlog.enable (on page 13-179) eventlog.count (on page 13-179) eventlog.next() (on page 13-180) eventlog.all() (on page 13-178) eventlog.count Attribute Reads the number of events contained in the event log. Usage To read the number of events: N = eventlog.count N: The number of events contained in the event log.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual eventlog.enable Also see LXI event log (on page 11-7) eventlog.count (on page 13-179) eventlog.clear() (on page 13-178) eventlog.next() (on page 13-180) eventlog.all() (on page 13-178) Example To display the present status of the Series 3700 event log: print(eventlog.enable ) eventlog.next() Function Returns the oldest message from the event log and removes it. Usage eventlog.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) file functions Use the file commands when you need to manipulate file input or output with Series 3700 instruments. These commands reside in the file descriptors and operate exclusively on the file with which they are associated. file:close() Function Closes a file after flushing any data that was written to it with io.write() (on page 9-14) or file:write() (on page 9-11).
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual file:read() Remarks The format parameters may be any of the following: "*n": Return a number. "*a": Return the whole file, starting at the current position; return the empty string at the end of the file. "*l": Return the next line, skipping the end of line; return nil at the end of file. n: Return a string with up to n characters; return an empty string if n is zero; return nil at the end of file.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) file:write() Remarks Any error encountered is logged to the error queue. This command is not remotely accessible. format attributes Use the format attributes to configure the output formats used by the printnumber() (on page 13-222) and printbuffer() (on page 13-221) functions.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual format.byteorder Attribute The binary byte order for data printed using the printnumber and printbuffer functions. Usage To read byte order: order = format.byteorder To write byte order: format.byteorder = order Set order to one of the following values: 0 or format.NORMAL Most significant byte first. 0 or format.BIGENDIAN Most significant byte first. 0 or format.NETWORK Most significant byte first.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) format.data Usage To read data format: fmt = format.data To write data format: format.data = fmt fmt: Set to one of the following values: 1 or format.ASCII ASCII format. 2 or format.SREAL Single precision IEEE-754 binary format. 2 or format.REAL32 Single precision IEEE-754 binary format. 3 or format.REAL Double precision IEEE-754 binary format. 3 or format.REAL64 Double precision IEEE-754 binary format.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual fs functions Use the fs commands to navigate the file system and list the available files on a flash drive. These commands are part of the Lua FS library. fs.chdir() Function Sets the current working directory. Usage fs.chdir(path) path: The new working directory path (absolute or relative). Remarks An error is logged to the error queue if the given path does not exist. fs.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) fs.readdir() Function Returns a list of all the file system entries within a specified directory. Usage files = fs.readdir(path) files: A list containing the names of all the file system entries that reside in the specified directory. path: The directory path. This path may be absolute or relative to the current working directory.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual gpib.address Example To set the GPIB address of the Series 3700 to 26 and then read the address: gpib.address = 26 address = gpib.address print(address) 2.600000e+01 io functions Use the io commands when you need to manipulate file input or output with Series 3700 instruments.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) io.open() Function Opens a file for later access. Usage file, err, errnum = io.open(path, mode) file: The descriptor of the opened file. err: A string with an error message an error occurred. errnum: Number representing the error number. path: The path of the file to open. This path may be absolute or relative to the current working directory. mode: A string representing the intended access mode.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual io.read() Remarks The format parameters may be any of the following: "*n": Return a number. "*a": Return the whole file, starting at the current position; return an empty string at the end of file. "*l": Return the next line, skipping the end of line; return nil at the end of file. n: Return a string with up to n characters; return an empty string if n is zero; return nil at the end of file.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) lan.applysettings() Remarks Example This function disconnects from the LAN interface and reinitializes the LAN with the current configuration settings. This function initiates an overlapped operation. LAN configuration could be a lengthy operation. Although the function returns immediately, the LAN initialization will continue to run in the background.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual lan.config.dns.address[index] Usage To read the IP address: dnsaddress = lan.config.dns.address[index] To write the IP address: lan.config.dns.address[index] = dnsaddress index: Entry index (1 or 2) dnsaddress: DNS server IP address. Remarks This attribute is an array of DNS server addresses.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) lan.config.dns.domain Remarks This attribute holds the domain to request during dynamic DNS registration. Dynamic DNS registration works with DHCP to register the domain specified in this attribute with the DNS server. NOTE Also see The length of the fully qualified host name (combined length of the domain and hostname with separator character) must be less than or equal to 255 characters.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual lan.config.dns.hostname Attribute Configures Dynamic DNS hostname. Usage To read Dynamic DNS hostname: hostname = lan.config.dns.hostname To write Dynamic DNS hostname: lan.config.dns.hostname = hostname hostname: Hostname to use for dynamic DNS registration.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) lan.config.duplex Attribute Configures LAN duplex mode. Usage To read LAN duplex mode: duplex = lan.config.duplex To write LAN duplex mode: lan.config.duplex = duplex duplex: LAN duplex setting can be one of the following values: lan.FULL or 1: Selects full-duplex operation. lan.HALF or 0: Selects half-duplex operation.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual lan.config.ipaddress Attribute Configures LAN IP address. Usage To read the LAN IP address: ipaddress = lan.config.ipaddress To write the LAN IP address: lan.config.ipaddress = ipaddress ipaddress: LAN IP address. Remarks This attribute specifies the LAN IP address to use when the manual configuration method is used to configure the LAN. This setting is ignored when DLLA or DHCP is used.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) lan.config.speed Attribute Configures LAN speed. Usage To read LAN speed: speed = lan.config.speed To write LAN speed: lan.config.speed = speed speed: Lan speed setting in Mbps. Setting can be either 10 or 100. Remarks This attribute selects the transmission speed used by the LAN interface when lan.config.autonegotiate (on page 13-191) is disabled. When lan.config.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual lan.lxidomain Attribute Sets LXI domain. Usage To read the LXI domain: domain = lan.lxidomain To write the LXI domain: lan.lxidomain = domain domain: The LXI domain number (0–255, default = 0). Remarks This attribute is used to set the LXI domain. It must be a number between 0 and 255. The default value is 0. All outgoing LXI packets will be generated with this domain number.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) lan.restoredefaults() Remarks This function restores all LAN to their default values. The following list details what settings are restored. lan.autoconnect: lan.DISABLE lan.config.autonegotiate: lan.ENABLE lan.config.dns.address[N]: 0.0.0.0 lan.config.dns.domain: "" lan.config.dns.dynamic: lan.ENABLE lan.config.dns.hostname: "" lan.config.dns.verify: lan.ENABLE lan.config.duplex: lan.FULL lan.config.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual lan.status.dns.address[N] Details NOTE Unused or disabled entries will be returned as "0.0.0.0" when read. dnsaddress returned is a string specifying the DNS server‟s IP address in dotted decimal notation. NOTE Although only two address may be manually specified, the unit will use up to three DNS server addresses. If two are specified here, only one given by a DHCP server will be used.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) lan.status.gateway Attribute Reads present LAN default gateway address. Usage gatewayaddress = lan.status.gateway gatewayaddress: LAN default gateway address. Remarks This attribute indicates the default gateway IP address setting currently in effect. Also see lan.config.gateway (on page 13-195) Example To display present gateway address: print(lan.status.gateway) lan.status.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual lan.status.port.dst Remarks This attribute holds the TCP port number used to reset all other LAN socket connections. Example To display the Series 3700 DST port number: print(lan.status.port.dst) 5.030000000e+003 lan.status.port.rawsocket Attribute Reads present LAN raw socket connection port number. Usage port = lan.status.port.rawsocket port: Raw socket port number.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) lan.status.reset() Function Resets the LAN interface. Usage lan.status.reset() Remarks This function performs a lan.restoredefaults() (on page 13-198) followed by a lan.applysettings() (on page 13-190). To restore the LAN settings without applying them, use lan.restoredefaults(). Example To reset the LAN interface: lan.status.reset() lan.status.speed Attribute Reads present LAN speed.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual lan.trigger[N].assert() Example To create a trigger with LAN packet 5: lan.trigger[5].assert() lan.trigger[N].clear() Function Clear the event detector for a trigger. Usage lan.trigger[N].clear() N: The trigger packet over LAN to clear (1–8). Remarks A trigger‟s event detector remembers if an event has been detected since the last lan.trigger[packet].wait call.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) lan.trigger[N].ipaddress Attribute Specify the address (in dotted decimal) of UDP or TCP listeners. Set to 0.0.0.0 for MULTICAST. Usage lan.trigger[N].ipaddress = dotted decimal (ddd.ddd.ddd.ddd) Example lan.trigger[3].protocol=lan.TCP lan.trigger[3].ipaddress=”192.168.1.100” lan.trigger[3].connect() lan.trigger[N].mode Attribute Sets the trigger operation/detection mode.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual lan.trigger[N].mode Remarks This attribute controls the mode in which the trigger event detector, as well as the output trigger generator, will operate on the given trigger. These settings are intended to provide behavior similar to the digital I/O triggers. When setting, mode can be one of the following values: lan.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) lan.trigger[N].overrun Also see lan.trigger[N].assert() (on page 13-203) lan.trigger[N].clear() (on page 13-204) lan.trigger[N].stimulus (on page 13-208) lan.trigger[N].wait() (on page 13-209) Example To check the overrun status of a trigger with LAN packet 5: overrun = lan.trigger[5].overrun lan.trigger[N].protocol Attribute Sets LAN protocol to use for sending trigger messages.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual lan.trigger[N].pseudostate Example To display the present simulated line state for the LAN event 1: print(lan.trigger[1].pseudostate) lan.trigger[N].stimulus Attribute Event to cause this trigger to assert. Usage To read the trigger stimulus: trigstim = lan.trigger[N].stimulus packet: The trigger packet over LAN to query for stimulus setting.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) lan.trigger[N].stimulus Also see lan.trigger[N].assert() (on page 13-203) lan.trigger[N].clear() (on page 13-204) lan.trigger[N].overrun (on page 13-206) lan.trigger[N].wait() (on page 13-209) Example To use timer 1 trigger event as the source for LAN packet 5 trigger stimulus: lan.trigger[5].stimulus = trigger.timer[1].EVENT_ID lan.trigger[N].wait() Function Wait for a trigger.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual localnode functions and attributes Use the attributes in this group to set the power line frequency, control (on/off) prompting, and control (hide/show) error messages on the display. localnode.define.* .MAX_TIMERS .MAX_DIO_LINES .MAX_TSPLINK_TRIGS .MAX_BLENDERS .MAX_BLENDER_INPUTS .MAX_LAN_TRIGS Attribute Indicates the maximum number available for each feature.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) localnode.execute() Remarks This function will execute the given TSL code. NOTE This command cannot actually be used on the local node. It is provided for the sole purpose of executing scripts on this node from a remote master node. The localnode prefix to the command is an artifact of command organization and how remote commands are shared between nodes. localnode.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual localnode.model Example To print model number: print(localnode.model) Output: 3706 localnode.password Attribute The remote access password. Usage localnode.password = "password" Remarks This attribute holds the remote access password. When password usage is enabled, this password must be supplied to change the configuration or control a unit from a web page or a remote command interface.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) localnode.prompts Usage To read prompting state: prompting = localnode.prompts To write prompting state: localnode.prompts = prompting prompting: Set to 0 to disable or 1 to enable. Remarks This attribute controls prompting. When it is set to 1, prompts are issued after each command message is processed by the instrument. When it is set to 0, prompts are not issued.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual localnode.reset() Remarks A system reset includes a channel.reset('allslots'), dmm.reset('all'), and a scan.reset(). In addition: Other system settings are restored back to factory default settings. Existing channel patterns and DMM configurations are deleted. All channels and backplane relays open. The dmm function is "dcvolts". User-created reading buffers are deleted. Also see channel.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) localnode.setglobal() Remarks This function will assign the given value to a global variable. This function is provided to assign values to variables from a remote master node. This function should not be used to assign values to global variables on the local node when using the local node as the master, assigning the value directly is far more efficient.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual localnode.setup.poweron Remarks Setting this attribute to 0 causes the unit to power up to the factory default (reset) setup. A setting of 1 causes the unit to power up using a user setup that was previously saved internally. Example To set unit to power on with factory default settings: localnode.setup.poweron = 0 To query power on state: print(localnode.setup.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) localnode.setup.save() Usage To save to the internal memory location, send no parameters with function: localnode.setup.save() To save to the USB flash drive: localnode.setup.save(location) location: Setup location to save. Use the format "/usb1/" where is the name of the desired file contained on a USB flash drive. The location must include the /usb1/.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual makegetter functions Use the functions in this group to set and retrieve a value for an attribute. makegetter() Function Creates a function to get the value of an attribute. Usage getter = makegetter(table, attributename) table: Read-only table were the attribute is located. attributename: The string name of the attribute. getter: Function that returns the value of the given attribute.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) memory functions memory.available() Function Indicates the memory available in the system. Usage mem_avail = memory_available() mem_avail: Comma-delimited string with percentages for available memory.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual memory.used() Usage mem_avail = memory_available() mem_avail: Comma-delimited string with percentages for available memory.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) opc() Remarks This function will cause the Operation Complete bit in the standard event status register to be set when all previously started local overlapped commands are complete. Note that each node will independently set their Operation Complete bits in their own status models. Any nodes not actively performing overlapped commands will set their bits immediately.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual printbuffer() Remarks Correct usage when there are no outstanding overlapped commands to acquire data: 1 <= start_index <= end_index <= n Where n refers to the index of the last entry in the tables to be printed. If end_index < start_index or n < start_index , no data will be printed. If start_index < 1, 1 will be used as the first index. If n < end_index , n will be used as the last index.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) printnumber() This function will print the given numbers using the data format specified by format.data and other associated attributes. Remarks At least one number must be given. There is an upper limit that is dictated by the output format and the maximum output message length. All values will be written in a single message. Care must be taken not to exceed the maximum output message length.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual ptp.ds.current() Details The fields are: Steps removed – the number of steps to reach a master.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) ptp.ds.foreignmaster() Function Read-only string describing information about any “foreign” clocks the instrument knows about. Usage ptp.ds.foreignmaster() Example print(ptp.ds.foreignmaster()) Empty. ptp.ds.globaltime() Function Read-only string describing global properties such as UTC offset. Usage ptp.ds.globaltime() Example print(ptp.ds.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual ptp.ds.parent() Example print(ptp.ds.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) ptp.ds.portconfig() Example print(ptp.ds.portconfig()) Last Sync Event Seq: 22 Last General Event Seq: 0 Port Communication: 1 Event Port Address: 319 General Port Address: 320 Port Id Field: 1 Burst Enabled: 0 Subdomain Address: 224 0 1 129 Port UUID: 00 60 0c 01 83 ee Random Number r: 29 Random Number q: 12 Sync Counter: 20 Number of Bursts: 6 Burst Counter: 0 ptp.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual ptp.portstate Remarks ptp.INITIALIZING (0) ptp.FAULTY (1) ptp.DISABLE (2) ptp.LISTENING (3) ptp.PRE_MASTER (4) ptp.MASTER (5) ptp.PASSIVE (6) ptp.UNCALIBRATED (7) ptp.SLAVE (8) ptp.UNKNOWN (9) Example print(ptp.portstate) ptp.preferredmaster.enable() Function Indicates to 1588 if this unit wants to be a master (if all other qualifiers are equal). NOTE: This value is not persisted through a power cycle.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) ptp.syncinterval Attribute Defines the interval between synchronization messages from the master. This must be set to the same value for all instruments participating in 1588 (for a given subdomain), both master and slave. Usage ptp.syncinterval = [0,1,3,4,6] 0: 1 sec 1: 2 sec 3: 8 sec 4: 16 sec 6: 64 sec Remarks ptp.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual reset functions Use this function to return all logical instruments to the default settings. reset() Function Resets the logical instruments to the default settings. Usage reset() Remarks This function resets all logical instruments in the system. It is equivalent to iterating over all the logical instruments in the system and calling the reset method of each.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) scan.add() Remarks Use this function to specify additional channels and channel patterns to scan. These items are appended to the end of the existing scan list that was specified by the scan.create() (on page 13-234) command. The items in ch_list are appended and scanned in the order specified in the parameter list. Specifying a channel list results in multiple steps being added to the scan.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual scan.addwrite() Function Writes a specified value to a channel at the added step in the scan. Usage scan.addwrite(, , []) ch_list: String specifying channels to add, using normal channel list syntax. write_value: The value to write to the channel for this scan step. width: Optional value that specifies the width of the channel write. Remarks scan.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) scan.background() Remarks This command may specify the reading buffer to use during scanning and the scan is executed in the background. The reading buffer, if specified, will store the readings and accompanying attributes desired for the scan. This command starts the scan. Prior to using this command use scan.create and scan.add to setup scan elements. Because scan is running in the background, use scan.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual scan.bypass Attribute Indicates whether the first channel of the scan should wait for the channel stimulus event to be satisfied before closing Usage To read the bypass state: bypass = scan.bypass To write the state of the bypass: scan.bypass = bypass bypass: The state of the bypass. Set bypass to one of the following values: scan.OFF or 0: Bypass disabled scan.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) scan.create() Remarks Use this function to replace an existing list of channels and/or channel patterns to scan. The existing scan list is lost after this command. These items purge the old list and start a new scan list. The items in ch_list will be scanned in the order specified in the parameter list. If the optional dmm_config parameter is not specified, the configuration (dmm.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual scan.create() Example To clear the old scan list without resetting the entire scan configuration aspects: scan.create("") To clear the old scan list and to create a new scan list with Channels 1 to 10 on Slot 3 with myDCV, a user DC volts configuration, on all 10 channels and then my2wire, a user 2-wire ohms configuration, on all 10 channels: scan.create('3001:3010', 'myDCV') scan.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) scan.execute() Remarks This command may specify the reading buffer to use during scanning and runs the scan in immediate mode. The reading buffer, if specified, will store the readings and accompanying attributes desired for the scan. This command starts the scan. Prior to using this command use scan.create() (on page 13-234) and scan.add() (on page 13230) to setup scan elements.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual scan.list() Remarks This command will list out the existing scan list. If the scan list is empty, then the string "Empty Scan" is returned. Otherwise, the string will list each step in the scan along with its information for step, open, close, measure configuration, and count. For example, an existing scan list may appear as follows: Init) OPEN...
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) scan.measurecount Attribute Set or query the measure count value for scanning. Usage To read the count: count = scan.measurecount count: Present measure count value being used To write the count: scan.measurecount = count count: Value to set the measure count. Valid range: 1 to 450000. Remarks This attribute sets the measure count in the trigger model.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual scan.mode Remarks This attribute, when set to scan.MODE_OPEN_ALL, indicates an openall on all slots should be performed before a scan starts. Otherwise, when scan.MODE_OPEN_SELECTIVE, an intelligent open takes place as follows: If all steps being scanned have a function value of "nofunction" with their DMM configuration then: Open all channels and backplane relays involved in scanning.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) scan.nobufferbackground() Remarks This command executes the scan in the background. No reading buffer will be used and an error will be generated if one is specified. This command starts the scan. Prior to using this command use scan.create() (on page 13-234) and scan.add() (on page 13-230) to setup scan elements. Because scan is running in the background, use scan.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual scan.nobufferexecute() Also see scan.add() (on page 13-230) scan.background() (on page 13-232) scan.create() (on page 13-234) scan.execute() (on page 13-236) (see this command to run a scan with a reading buffer) scan.list() (on page 13-237) scan.nobufferbackground() (on page 13-240) scan.state() (on page 13-243) Example To start a scan in immediate mode without using a reading buffer: scan.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) scan.scancount Attribute Set or query the scan count value. Usage To read the count: count = scan.scancount count: Present scan count value being used To write the count: scan.scancount = count count: Value to set the scan count. Valid range: 1 to 32000. Remarks This attribute sets the scan count in the trigger model.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual scan.stepcount Attribute Attribute to query to see number of steps in the present scan. Usage To read the number of steps in the present scan: ScanStepCount = scan.stepcount Remarks This is a read only attribute. It is set by the number of steps in the present scan when the scan was created and/or steps added. Also see scan.add() (on page 13-230) Example To see the current scan state: print(scan.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) scan.trigger.arm.stimulus Remarks This attribute selects which event(s) will cause the arm event detector to enter the detected state. Set this attribute to 0 to bypass waiting for an event. eventid may be one of the following (existing trigger event IDs): digio.trigger[N].EVENT_ID: An edge (either rising, falling, or either based on the configuration of the line) on the digital input line. display.trigger.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual scan.trigger.channel.set() Function Set the channel event detector to the detected state. Usage scan.trigger.channel.set() Remarks This function will set the channel event detector of the trigger model to the detected state. Example scan.trigger.channel.set() scan.trigger.channel.stimulus Attribute Channel event detector stimulus selection. Usage To read the trigger stimulus: eventid = scan.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) scan.trigger.channel.stimulus Example To set trigger stimulus of the channel event detector to scan start event: scan.trigger.channel.stimulus = scan.trigger.EVENT_SCAN_START scan.trigger.clear() Function Clear the trigger model. Usage scan.trigger.clear() Remarks This function will set the channel, measure and sequence event detectors of the trigger model to the undetected state.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual scan.trigger.measure.stimulus Remarks This attribute selects which event(s) will cause the measure event detector to enter the detected state. Set this attribute to 0 to bypass waiting for an event. eventid may be one of the following (existing trigger event IDs): digio.trigger[N].EVENT_ID: An edge (either rising, falling, or either based on the configuration of the line) on the digital input line. display.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) scan.trigger.sequence.set() Usage scan.trigger.sequence.set() Remarks This function will set the sequence event detector to the detected state. Example To set the sequence event detector to the detected state: scan.trigger.sequence.set() scan.trigger.sequence.stimulus Attribute Sequence event detector trigger stimulus selection. Usage To read the trigger stimulus: eventid = scan.trigger.sequence.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual scan.trigger.sequence.stimulus Also see scan.trigger.measure.stimulus (on page 13-247) Example To set trigger stimulus of the sequence event detector to channel ready event: scan.trigger.sequence.stimulus = scan.trigger.EVENT_CHAN_READY schedule functions and attributes Use these functions to configure the scheduled alarm events. These events are generated at times defined by these ICLs.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) schedule.alarm[x].fractionalseconds Example Create an alarm to occur 60.25 seconds from current time in UTC seconds sec,ns = os.time() schedule.alarm[1].seconds = sec + 60 schedule.alarm[1].fractionalseconds = ns + 0.5 schedule.alarm[x].period Attribute The time, in seconds, between adjacent firings of the alarm. Usage schedule.alarm[x].period Example Set period of 0.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual schedule.alarm[x].seconds Example Create an alarm to occur on March 15, 2008 at 10AM in UTC seconds: local l_myTime l_myTime = os.time{year = 2008, month = 3, day = 15, hour = 10} schedule.alarm[1].seconds = l_myTime schedule.disable() Function Disable all alarms. Usage schedule.disable() Example schedule.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) setup.cards() Example To query the cards of the internal saved setup: CardModels = setup.cards() print(CardModels) Output: 3722,0,0,0,0,0 To query the cards associated with mysetup.set on thumb drive: print(setup.card('/usb1/mysetup.set')) --> 0,3723,3722,3720,0,0 setup.poweron Attribute The setup to recall when the unit is turned on. Usage To read the power-on setup: n = setup.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual setup.recall() Example To recall factory default settings: setup.recall(0) To recall the user-setup (internal): setup.recall(1) To recall a user saved setup stored in a file named KEITHLEY_3730 on a USB flash drive: setup.recall("/usb1/KEITHLEY_3730.set") setup.save() Function Saves the present setup as a user-setup.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) slot[X] attributes The attributes in this group indicate whether a card in slot X (where X = 1 to 6) supports different features such as pole settings, voltage or 2-wire measurements, etc.,. To query an attribute, use the print command sending the attribute as an argument. For example: print(slot[1].
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual slot[X].endchannel.amps Example To query for ending amps channel on Slot 4: EndAmpsChan = slot[4].endchannel.amps slot[X].endchannel.analogoutput Attribute The ending channel that supports a digital analog output (DAC). Usage end = slot[X].endchannel.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) slot[X].endchannel.totalizer Attribute The ending channel that supports a totalizer. Usage end = slot[X].endchannel.totalizer [X]: Slot number (1 to 6) Remarks This attribute does not exist for a slot if a card is not installed or the card installed does not support totalizer channels. In these cases, the return value is nil. If supported, the return value is a number representing the ending channel.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual slot[X].interlock.override Attribute Indicates if a card should error on closing backplane relays if interlock is disengaged. Usage To read interlock override setting: value = slot[X].interlock.override [X]: Slot number (1 to 6) To write interlock override setting: slot[X].interlock.override = value [X]: Slot number (1 to 6) value: Represents the desired state of the interlock override.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) slot[X].interlock.state Example To query the interlock state on Slot 3: print(slot[3].interlock.state) slot[X].isolated Attribute Indicates whether a card in slot X supports isolated channels or not. Usage isolated_chans = slot[X].isolated [X]: Slot number (1 to 6) Remarks This attribute will not exist for a slot if a card is not installed or the card installed does not support isolated channels.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual slot[X].multiplexer Remarks This attribute will not exist for a slot if a card is not installed or the card installed does not support multiplexer channels. In these cases, the return value will be nil. If multiplexer channels are supported, the returned value will be 1. Example To query if Slot 1 supports multiplexer channels: MuxChan1 = slot[1].multiplexer slot[X].poles.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) slot[X].pseudocard Attribute Specifies the corresponding pseudo card to implement for the designated slot. Usage To read pseudo card for slot: pseudocard = slot[X].pseudocard [X]: Slot number (1 to 6) To write pseudo card for slot: slot[X].pseudocard = pseudocard [X]: Slot number (1 to 6) Set pseudocard to one of the following values slot.PSEUDO_NONE or 0 for no pseudocard selection slot.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual slot[X].startchannel.amps Attribute The starting channel that supports amps measurements. Usage start = slot[X].startchannel.amps [X]: Slot number (1 to 6) Remarks This attribute will not exist for a slot if a card is not installed or the card installed does not support amps channels. In these cases, the return value will be nil.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) slot[X].startchannel.totalizer Attribute The starting channel that supports a totalizer. Usage start = slot[X].startchannel.totalizer [X]: Slot number (1 to 6) Remarks This attribute does not exist for a slot if a card is not installed or the card installed does not support totalizer channels. In these cases, the return value is nil.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual slot[X].thermal.state Remarks This attribute will not exist for a slot if a card is not installed or the card installed does not support thermal state detection. In these cases, the return value will be nil. Use this attribute to query the thermal state only if the card supports detecting thermal state. Example To query the thermal state on Slot 3: print(slot[3].thermal.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) status.condition Attribute Status byte register. Usage Reads the status byte register: statbyte = status.condition Remarks This attribute is used to read the status byte, which is returned as a numeric value. The binary equivalent of the returned value indicates which register bits are set. The least significant bit of the binary number is bit 0, and the most significant bit is bit 7.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual status.measurement.* .condition .enable .event .ntr .ptr Attribute Measurement event status register set. Usage To read condition, enable, event, NTR and PTR registers: measreg = status.measurement.condition measreg = status.measurement.enable measreg = status.measurement.event measreg = status.measurement.ntr measreg = status.measurement.ptr To write to enable, NTR, and PTR registers: status.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) status.measurement.* Remarks .condition .enable .event .ntr .ptr These attributes are used to read or write to the measurement registers. Reading a status register returns a value. The binary equivalent of the returned value indicates which register bits are set. The least significant bit of the binary number is bit 0, and the most significant bit is bit 15.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual status.node_enable Attribute Status node enable register. Reads status node enable register: nodeenabreg = status.node_enable Writes to system enable register: status.node_enable = nodeenabreg Set nodeenabreg to one of the following values: To clear all bits: 0 To set (enables) MSB bit (B0): status.MEASUREMENT_SUMMARY_BIT - or - status.MSB To set (enables) EAV bit (B2): status.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) 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 bit B2 (EAV), set nodeenabreg to 4 (22). To set bit B7 (OSB), set nodeenabreg to 128 (27). To set more than one bit of the register, set nodeenabreg to the sum of their decimal weights. For example, to set bits B0 and B7, set nodeenabreg to 129 (1 + 128).
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual status.node_event Example Reads the status node event register: nodeeventreg = status. node_event print(nodeeventreg ) Output: 1.29000e+02 The above output indicates that bits B0 (MSB) and B7 (OSB) are set. status.operation.* .condition .enable .event .ntr .ptr Attribute Operation event status register set. Usage To read condition, enable, event, NTR and PTR registers: operreg = status.operation.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) status.operation.* Remarks .condition .enable .event .ntr .ptr operreg can also be set to the decimal weight of the bit to be set. To set bit B0 (CAL), set operreg to 1 (20). To set bit B4 (MEAS), set operreg to 16 (24). To set bit B11 (PRMPTS), set operreg to 2048 (211). To set bit B12 (USER), set operreg to 4096 (212). To set bit B14 (PROG), set operreg to 16384 (214).
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual status.operation.user.* .condition .enable .event .ntr .ptr Attribute Operation user event register set. Usage Reads condition, enable, event, NTR and PTR registers: operreg = status.operation.user.condition operreg = status.operation.user.enable operreg = status.operation.user.event operreg = status.operation.user.ntr operreg = status.operation.user.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) 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 bit X where X = 1 to 14, set operreg to 2X. For example: To set user BIT0, set operreg to 1 (20). To set user BIT4, set operreg to 16 (24). To set user BIT11, set operreg to 2048 (211).
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual status.questionable.* .condition .enable .event .ntr .ptr Attribute Questionable event status register set. Usage To read condition, enable, event, NTR, and PTR registers: quesreg = status.questionable.condition quesreg = status.questionable.enable quesreg = status.questionable.event quesreg = status.questionable.ntr quesreg = status.questionable.ptr To write to enable, NTR and PTR registers: status.
Series 3700 System Switch/Multimeter Reference Manual status.questionable.* Remarks Section 13: Instrument Control Library (ICL) .condition .enable .event .ntr .ptr These attributes are used to read or write to the questionable status registers. Reading a status register returns a value. The binary equivalent of the returned value indicates which register bits are set. The least significant bit of the binary number is bit 0, and the most significant bit is bit 15.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual status.questionable.* Details .condition .enable .event .ntr .ptr quesreg can be set to the decimal weight of the bit to be set: To set bit B1 (S1INL), set quesreg to 1 (21). To set bit B2 (S2INL), set quesreg to 4 (22). To set bit B3 (S3INL), set quesreg to 8 (23). To set bit B4 (S4INL), set quesreg to 16 (24). To set bit B5 (S5INL), set quesreg to 32 (25). To set bit B6 (S6INL), set quesreg to 64 (26).
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) status.request_enable Attribute Service request enable register. Usage Reads service request enable register: servenabreg = status.request_enable Writes to system enable register: status.request_enable = servenabreg Set servenabreg to one of the following values: 0 Clears all bits. To set (enables) MSB bit (B0): status.MEASUREMENT_SUMMARY_BIT - or - status.MSB To set (enables) SSB bit (B1): status.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual status.request_enable Remarks This attribute is used to read or write to the service request enable register. Reading the service request enable status register returns a value. The binary equivalent of the returned value indicates which register bits are set. The least significant bit of the binary number is bit 0, and the most significant bit is bit 7.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) status.standard.* .condition .enable .event Attribute Standard event register set. Usage Reads condition, enable and event registers: standardreg = status.standard.condition standardreg = status.standard.enable standardreg = status.standard.event Writes to enable register: status.standard.enable = standardreg Set standardreg to one of the following values: 0 Clears all bits.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual status.standard.* Remarks .condition .enable .event These attributes are used to read or write to the standard status registers. Reading a status register returns a value. The binary equivalent of the returned value indicates which register bits are set. The least significant bit of the binary number is bit 0, and the most significant bit is bit 7.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) status.system.* .condition .enable .event Attribute TSP-LinkTM system data structure register set. Usage To read condition, enable and event registers: enablereg = status.system.condition enablereg = status.system.enable enablereg = status.system.event To write to enable register: status.system.enable = enablereg Set enablereg to one of the following values: 0 Clears all bits.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual status.system2.* .condition .enable .event Attribute TSP-LinkTM system2 data structure register set. Usage Reads condition, enable and event registers: enablereg = status.system2.condition enablereg = status.system2.enable enablereg = status.system2.event Writes to enable register: status.system2.enable = enablereg Set enablereg to one of the following values: 0 Clears all bits.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) status.system3.* .condition .enable .event Attribute TSP-LinkTM system3 data structure register set. Usage To read condition, enable and event registers: enablereg = status.system3.condition enablereg = status.system3.enable enablereg = status.system3.event To write to enable register: status.system3.enable = enablereg Set enablereg to one of the following values: 0 Clears all bits.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual status.system3.* Example .condition .enable .event Sets the extension bit of the system3 enable register: status.system3.enable = status.system3.EXT status.system4.* .condition .enable .event Attribute TSP-LinkTM system4 data structure register set. Usage To read condition, enable and event registers: enablereg = status.system4.condition enablereg = status.system4.enable enablereg = status.system4.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) status.system4.* Also see .condition .enable .event status.system.* (on page 13-280) status.system2.* (on page 13-281) status.system3.* (on page 13-282) status.system5.* (on page 13-285) Example Sets the extension bit of the system4 enable register: status.system4.enable = status.system4.EXT status.system5.* .condition .enable .event Attribute TSP-LinkTM system5 data structure register set.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual status.system5.* Remarks .condition .enable .event In an expanded system (TSP-Link), this attribute is used to read or write to the system5 node registers. Reading a system5 node register returns a numeric value whose binary equivalent indicates which register bits are set.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) timer.measure.t() Remarks This function will return the elapsed time in seconds since the timer was reset. The returned resolution for time depends on how long it has been since the timer was reset. It starts with 1 s resolution and starts to lose resolution after about 2.8 minutes. Also see timer.reset() (on page 13-287) Example Resets the timer and then measures the time since the reset: timer.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual trigger.blender[N].orenable Attribute Set orenable attribute for the blender. Usage To read the trigger blender orenable mode: orenable = trigger.blender[N].orenable To write the trigger blender orenable mode: trigger.blender[N].orenable = orenable orenable: The desired orenable mode (true/false) N: The trigger blender (1–2).
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) trigger.blender[N].stimulus[M] Remarks This attribute selects which events will trigger the blender. There are 4 acceptors that can each select a different event. eventid may be one of the following (existing trigger event IDs): digio.trigger[N].EVENT_ID: An edge (either rising, falling, or either based on the configuration of the line) on the digital input line. display.trigger.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual trigger.clear() Remarks The trigger event detector remembers if an event has been detected since the last trigger.wait() (on page 13-290) call. This function clears the trigger's event detector and discards the previous history of command interface trigger events. Also see trigger.wait() (on page 13-290) trigger.wait() Function Wait for a trigger event. Usage triggered = trigger.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) trigger.timer[N].count Attribute Retrigger count. Usage To read: count = trigger.timer[N].count To write: trigger.timer[N].count = count N: is a trigger timer value (from 1–4). count: Repeat trigger count. Remarks This attribute sets the number of times the timer will trigger an event.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual trigger.timer[N].delaylist Remarks This attribute sets an array of timer delays. Each time the timer is triggered it will use the next delay period from the array. After all elements in the array have been used, the last element will be used for subsequent triggers. trigger.timer[N].overrun Attribute Event detector overrun status. Usage overrun = trigger.timer[N].
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) trigger.timer[N].stimulus Remarks This attribute selects which event will start the timer. eventid may be one of the following (existing trigger event IDs): digio.trigger[N].EVENT_ID: An edge (either rising, falling, or either based on the configuration of the line) on the digital input line. display.trigger.EVENT_ID: The trigger key on the front panel is pressed. trigger.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual tsplink functions and attributes Use the function and attributes in this group to assign node numbers to Series 3700 instruments and initialize the TSP-LinkTM system. tsplink.group Attribute The group number of a TSP-LinkTM node. Usage groupnumber = tsplink.group tsplink.group = groupnumber groupnumber: The TSP-Link group number for the node.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) tsplink.reset() Remarks This function will erase all knowledge of other nodes connected on the TSP-LinkTM and will regenerate the system configuration. This function must be called at least once before any remote nodes can be accessed. If the node number for any instrument is changed, the TSP-Link must again be initialized. tsplink.state Attribute TSP-LinkTM online state. Usage state = tsplink.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual tsplink.trigger[N].clear() Remarks A trigger‟s event detector remembers if an event has been detected since the last tsplink.trigger[N].wait call. This function clears a trigger‟s event detector and discards the previous history of the trigger line. Also see tsplink.trigger[N].mode (on page 3-13) tsplink.trigger[N].overrun (on page 3-15) tsplink.trigger[N].release() (on page 3-15) tsplink.trigger[N].
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) tsplink.trigger[N].mode Remarks This attribute controls the mode in which the trigger event detector as well as the output trigger generator will operate on the given trigger line. mode can be one of the following values: tsplink.TRIG_BYPASS Allow direct control of the line. tsplink.TRIG_EITHER Detect rising or falling edge triggers as input. Assert a TTL-low pulse for output. tsplink.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual tsplink.trigger[N].mode Also see tsplink.trigger[N].assert (on page 3-12) tsplink.trigger[N].clear() (on page 3-13) tsplink.trigger[N].overrun (on page 3-15) tsplink.trigger[N].release() (on page 3-15) tsplink.trigger[N].stimulus (on page 13-298) tsplink.trigger[N].wait() (on page 3-15) tsplink.trigger[N].overrun Attribute Event detector overrun status. Usage overrun = tsplink.trigger[N].
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) tsplink.trigger[N].stimulus Attribute Event to cause this trigger to assert. Usage tsplink.trigger[N].stimulus() N: The trigger line (1–3). Remarks This attribute selects which event will cause the synchronization line to assert a trigger. eventid may be one of the following (existing trigger event IDs): digio.trigger[N].
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual tspnet functions and attributes Use the tspnet commands to control, identify, and communicate with TSPTM devices. You can use these commands with Keithley Instruments and nonKeithley Intruments devices. tspnet.clear() Function Device read clear buffer. Usage tspnet.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) tspnet.connect() Remarks This command connects a device to another device by way of the LAN interface (using the optionally-specified port number). The default port number is 5025. If the port number is 23, the interface will use the Telnet protocol (and set appropriate termination characters) to communicate with the device.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual tspnet.execute() Function Executes a command string on the remote device. Usage [variable =] tspnet.execute(, , []) connection id: Integer value used as a handle for other tspnet commands command string: Command to send to instrument. format string: Definition of format string for the input field using zeros (0), the decimal point (.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) tspnet.idn() Function Retrieves response of remote device to '*IDN?' Usage = tspnet.idn() idn_string: Response as a string type connection id: Integer value used as a handle for other tspnet commands Remarks Sends the '*idn?' string to the remote device and retrieves its response.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual tspnet.read() Remarks This command reads available data from the device (as indicated by the format string) and returns the number of arguments (as indicated by the format string).
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) tspnet.readavailable() Example x = tspnet.readavailable(mydevice) tspnet.reset() Function Device all disconnection. Usage tspnet.reset() Remarks This command disconnects the all devices currently connected. For Keithley Instruments TSPTM devices, this results in any remotely running commands or scripts being terminated. Errors: Example tspnet.reset() tspnet.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual tspnet.timeout Attribute Sets timeout value for tspnet.connect(), tspnet.execute(), and tspnet.read() commands. Usage tspnet.timeout [= ] seconds value: Value in seconds Remarks This setting sets the duration the tspnet.connnect, tspnet.read, and tspnet.execute commands will wait for a response. The time is specified in seconds. The default value is 5.0 seconds.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) tspnet.tsp.abortonconnect Remarks This setting determines if the Series 3700 sends abort() when it attempts to connect using tspnet.connect() (on page 10-5) to a TSPTM-enabled device. The default value is tspnet.TRUE (or non-zero). Sending the abort() command on connection causes any other active interfaces being used on that device to close to ensure you have obtained access to the remote device.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual tspnet.tsp.rbtablecopy() Example table = tspnet.tsp.rbtablecopy(mytspdevice, 'myremotebuffername.readings', 1, 3) print(table[1], table[2], table[3]) Output: 4.5653423423e-1 4.5267523423e-1 4.5753543423e-1 times = tspnet.tsp.rbtablecopy(mytspdevice, 'myremotebuffername.timestamps', 1, 3) print(times) Output 01/01/2008 10:10:10.0000013,01/01/2008 10:10:10.0000233,01/01/2008 10:10:10.0000576 tspnet.tsp.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) tspnet.write() Function Write strings to remote device. Usage tspnet.write(, ) connection id: Integer value used as a handle for other tspnet commands input string: String type used for writing to the remote instrument Remarks The tspnet.write() command sends the command string to the connection device. It does not wait for command completion on the remote device.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual userstring functions Use the functions in this group to store/retrieve user-defined strings in nonvolatile memory. userstring.add() Function Adds a user-defined string to non- volatile memory. Usage userstring.add(name, value) name: The name for the string. value: The string to associate with the name.
Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL) userstring.catalog() Example To delete all user strings in non- volatile memory: for name in userstring.catalog() do userstring.delete(name) end To print all user string name value pairs in nonvolatile memory: for name in userstring.catalog() do print(name .. " = " .. userstring.
Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual userstring.get() Also see userstring.add() (on page 13-310) userstring.catalog() (on page 13-310) userstring.delete() (on page 13-311) Example Retrieves the value for a user string from nonvolatile memory: value = userstring.get("assetnumber") print(value) Output: 236 waitcomplete functions This function waits for all overlapped commands to complete.
Section 14 Verification In this section: Introduction ..................................................................... 14-1 Verification test requirements .......................................... 14-2 Performing the verification test procedures ..................... 14-5 Series 3700 verification tests ..........................................
Section 14: Verification NOTE Series 3700 System Switch/Multimeter Reference Manual If the instrument is still under warranty and its performance is outside specified limits, contact your Keithley Instruments representative or the factory to determine the correct course of action.
Series 3700 System Switch/Multimeter Reference Manual Section 14: Verification Line power The Series 3700 requires a line voltage of 100V to 240V (±10%), and a line frequency of 50Hz or 60Hz. NOTE The instrument automatically senses the line frequency at power-up. Recommended test equipment The following table summarizes recommended verification equipment. You can use alternate equipment if that equipment has specifications equal to or greater than those listed in the table.
Section 14: Verification Series 3700 System Switch/Multimeter Reference Manual Verification limits The verification limits stated in this section have been calculated using only the Series 3700 one-year accuracy specifications, and they do not include test equipment uncertainty. If a particular measurement falls outside the allowable range, recalculate new limits based both on the Series 3700 specifications and corresponding test equipment specifications.
Series 3700 System Switch/Multimeter Reference Manual Section 14: Verification Restoring factory defaults To restore the instrument to its factory front panel (bench) defaults before performing the verification procedures: 1. Press the MENU key. 2. Turn the navigation wheel to highlight SETUP and then press the ENTER key. 3. Turn the navigation wheel to highlight RESET and then press the ENTER key.
Section 14: Verification Series 3700 System Switch/Multimeter Reference Manual Test considerations When performing the verification procedures: Be sure to restore factory front panel defaults as outlined in Restoring factory defaults (on page 14-5). Make sure that the test equipment is properly warmed up and connected to the Series 3700 terminals. Be sure the test equipment is set up for the proper function and range.
Series 3700 System Switch/Multimeter Reference Manual Section 14: Verification To verify DC voltage accuracy: NOTE Use shielded, low-thermal connections when testing the 100mV and 1V ranges to avoid errors caused by noise or thermal effects. Connect the shield to the calibrator‟s output LO terminal. 1. Connect the Series 3700 HI and LO INPUT pins to the DC voltage calibrator as shown in the "DC voltage verification" below. 2. Select the DC volts function. 3. Set the Series 3700 to the 100mV range. 4.
Section 14: Verification Series 3700 System Switch/Multimeter Reference Manual Connect to the Fluke 5700A Calibrator 14-8 Description Range (V) Test point (V) Lower limit (V) Upper limit (V) Verify DCV 100mV 1.00E-01 5.00E-02 4.999760E-02 5.000240E-02 Verify DCV 100mV 1.00E-01 -5.00E-02 -5.000240E-02 -4.999760E-02 Verify DCV 100mV 1.00E-01 -1.00E-01 -1.000039E-01 -9.999610E-02 Rel Series 3700 1.00E+00 0.00E+00 N/A N/A Verify DCV 1V 1.00E+00 1.00E+00 9.999680E-01 1.
Series 3700 System Switch/Multimeter Reference Manual Section 14: Verification Connect to the Fluke 5700A Calibrator Description Range (V) Test point (V) Lower limit (V) Upper limit (V) Verify DCV 300V 3.00E+02 3.00E+02 2.999862E+02 3.000138E+02 Verify DCV 300V 3.00E+02 1.50E+02 1.499922E+02 1.500078E+02 Verify DCV 300V 3.00E+02 0.00E+00 -1.800000E-03 1.800000E-03 Verify DCV 300V 3.00E+02 -1.50E+02 -1.500078E+02 1.499922E+02 Verify DCV 300V 3.00E+02 -3.00E+02 -3.000138E+02 2.
Section 14: Verification Series 3700 System Switch/Multimeter Reference Manual Figure 14-2: AC voltage verification ACV verification data Use the following values to verify the performance of the Series 3700. Actual values depend on published specifications (see Example reading limit calculation (on page 14-4)). Connect to the Fluke 5700A calibrator 14-10 Description Range (V) Test point (V) Lower limit (V) Upper limit (V) Verify ACV 100mV @ 20Hz 1.00E-01 1.00E-01 9.897000E-02 1.
Series 3700 System Switch/Multimeter Reference Manual Section 14: Verification Connect to the Fluke 5700A calibrator Description Range (V) Test point (V) Lower limit (V) Upper limit (V) Verify ACV 10V @ 100kHz 1.00E+01 1.00E+01 9.932000E+00 1.006800E+01 Verify ACV 100V @ 1kHz 1.00E+02 1.00E+02 9.992000E+01 1.000800E+02 Verify ACV 100V @ 50kHz 1.00E+02 1.00E+02 9.984000E+01 1.001600E+02 Verify ACV 100V @ 100kHz 1.00E+02 1.00E+02 9.932000E+01 1.006800E+02 Verify ACV 300V @ 1kHz 3.
Section 14: Verification Series 3700 System Switch/Multimeter Reference Manual 5. Set the calibrator to source zero current and rel both the Series 3700 and the HP3458A. 6. Source DC current for each of the test points summarized in the DC voltage verification data (on page 14-7) table. For each setting, be sure that the reading is within stated limits.
Series 3700 System Switch/Multimeter Reference Manual Section 14: Verification Connect HP3458A in series with 5700 calibrator Description Range (A) Test point(A) Lower limit (A) Upper limit (A) Verify 100µA Zero 1.00E-04 0.00E+00 -3.000000E-09 3.000000E-09 Verify DC Curr 100µA 1.00E-04 1.00E-04 9.994910E-05 1.000509E-04 Verify DC Curr 100µA 1.00E-04 -1.00E-04 -1.000509E-04 -9.
Section 14: Verification Series 3700 System Switch/Multimeter Reference Manual Figure 14-5: DC current verification 3A range diagram DC current verification data 1mA to 3A ranges Use the following values to verify the performance of the Series 3700. Actual values depend on published specifications (see Example reading limit calculation (on page 14-4)). Remove HP3458A, only connect the 5700 14-14 Description Range (A) Test point (A) Lower limit (A) Upper limit (A) Verify 1mA Zero 1.00E-03 0.
Series 3700 System Switch/Multimeter Reference Manual Section 14: Verification Remove HP3458A, only connect the 5700 Description Range (A) Test point (A) Lower limit (A) Upper limit (A) Verify DC Curr 1A 1.00E+00 -1.00E+00 -1.000810E+00 -9.991900E-01 Connect to the Fluke 5725A amplifier Description Range (A) Test point (A) Lower limit (A) Upper limit (A) Verify DC Curr 3A 3.00E+00 3.00E+00 2.996355E+00 3.003645E+00 Verify DC Curr 3A 3.00E+00 -3.00E+00 -3.003645E+00 2.
Section 14: Verification Series 3700 System Switch/Multimeter Reference Manual Figure 14-6: AC current verification 1mA to 1A range Figure 14-7: AC current verification 3A range AC current verification data 1mA to 1A ranges Use the following values to verify the performance of the Series 3700. Actual values depend on published specifications (see Example reading limit calculation (on page 14-4)).
Series 3700 System Switch/Multimeter Reference Manual Section 14: Verification Connect to the Fluke 5700A calibrator Description Range (A) Test point (A) Lower limit (A) Upper limit (A) Verify AC Curr 1mA @ 1kHz 1.00E-03 1.00E-03 9.989000E-04 1.001100E-03 Verify AC Curr 1mA @ 5kHz 1.00E-03 1.00E-03 9.989000E-04 1.001100E-03 Verify AC Curr 10mA @ 40Hz 1.00E-02 1.00E-02 9.989000E-03 1.001100E-02 Verify AC Curr 10mA @ 1kHz 1.00E-02 1.00E-02 9.989000E-03 1.
Section 14: Verification Series 3700 System Switch/Multimeter Reference Manual Verifying frequency To verify the Series 3700 frequency function: 1. Connect the Agilent 33220A function generator to the Series 3700 INPUT pins. 2. Set the function generator to output a 1kHz, 5V RMS sine wave. 3. Select the Series 3700 frequency function by pressing the FREQ key. 4.
Series 3700 System Switch/Multimeter Reference Manual Section 14: Verification Verifying 4-wire resistance Check the normal resistance function by connecting accurate resistance values to the Series 3700 analog backplane connector and verifying that the displayed readings fall within specified limits. CAUTION Do not exceed 300V peak between INPUT HI and INPUT LO because instrument damage may occur. To verify 4-wire resistance accuracy: 1.
Section 14: Verification Series 3700 System Switch/Multimeter Reference Manual 4-wire resistance verification data Use the following values to verify the performance of the Series 3700. Actual values depend on published specifications (see Calculating resistance reading limits (on page 14-4)). Connect to the Fluke 5700A calibrator Description Range (Ohms) Test point (Ohms) Lower limit (Ohms) Upper limit (Ohms) Verify 4W Res 100 Ohm * 1.00E+02 1.00E+02 9.999310E+01 1.
Series 3700 System Switch/Multimeter Reference Manual Section 14: Verification Verifying 2-wire resistance Check the normal resistance function by connecting accurate resistance values to the Series 3700 analog backplane connector and verifying that the displayed readings fall within specified limits. CAUTION Do not exceed 300V peak between INPUT HI and INPUT LO because instrument damage may occur. To verify normal resistance accuracy: 1.
Section 14: Verification Series 3700 System Switch/Multimeter Reference Manual Description Range (Ohms) Test point (Ohms) Lower limit (Ohms) Upper limit (Ohms) Verify 2W Res 100k Ohm 1.00E+05 1.00E+05 9.999360E+04 1.000064E+05 Verify 2W Res 1M Ohm 1.00E+06 1.00E+06 9.999360E+05 1.000064E+06 Verify 2W Res 10M Ohm 1.00E+07 1.00E+07 9.995900E+06 1.000410E+07 Verify 2W Res 100M Ohm 1.00E+08 1.00E+08 9.979700E+07 1.
Series 3700 System Switch/Multimeter Reference Manual Section 14: Verification Figure 14-11: Resistance verification Dry circuit resistance verification data Use the following values to verify the performance of the Series 3700. Actual values depend on published specifications (see Calculating resistance reading limits (on page 14-4)). Description Range (Ohms) Test point (Ohms) Lower limit (Ohms) Upper limit (Ohms) Verify Dry Circuit 100 Ohm * 1.00E+02 1.00E+02 9.997800E+01 1.
Section 14: Verification Series 3700 System Switch/Multimeter Reference Manual Verifying 1-OHM and 10-OHM resistance ranges Check the normal resistance function by connecting accurate resistance values to the Series 3700 analog backplane connector and verifying that the displayed readings fall within specified limits. CAUTION Do not exceed 300V peak between INPUT HI and INPUT LO because instrument damage may occur. To verify normal resistance accuracy: 1.
Series 3700 System Switch/Multimeter Reference Manual Section 14: Verification 1 Ohm discrete resistor applied Description Range (Ohms) Test point (Ohms) Lower limit (Ohms) Upper limit (Ohms) Verify Res 1 Ohm * 1.00E+00 1.00E+00 9.998600E-01 1.000140E+00 Verify Dry Circuit 1 Ohm * 1.00E+00 1.00E+00 9.998500E-01 1.000150E+00 10 Ohm discrete resistor applied Description Range (Ohms) Test point (Ohms) Lower limit (Ohms) Upper limit (Ohms) Verify Res 10 Ohm * 1.00E+01 1.00E+01 9.
Section 14: Verification Series 3700 System Switch/Multimeter Reference Manual To verify resistance using the 4-wire short: 1. With the 4-wire short still applied, select the Series 3700 4-wire resistance function. 2. Select the SLOW integration rate with the RATE key. 3. Set the Series 3700 for the 1 range, and make sure the FILTER is on. Enable OC+ (offset-compensated ohms). Use OC+ for 1 and 10 range verification. 4.
Series 3700 System Switch/Multimeter Reference Manual Section 14: Verification Description Range (Ohms) Test point (Ohms) Lower limit (Ohms) Upper limit (Ohms) Verify Zeros 1 Ohm * 1.00E+00 0.00E+00 -8.000000E-05 8.000000E-05 Verify Zeros 10 Ohm * 1.00E+01 0.00E+00 -9.000000E-05 9.000000E-05 NOTE The asterisk (*) designates the ranges that offset compensation is being used. This completes the verification procedure. 3700S-901-01 Rev.
Section 15 Calibration In this section: Overview ......................................................................... 15-1 Environmental conditions ................................................ 15-2 Calibration considerations ............................................... 15-3 Calibration ....................................................................... 15-4 Remote calibration procedure .........................................
Section 15: Calibration Series 3700 System Switch/Multimeter Reference Manual Environmental conditions Conduct the verification procedures in a location that has: An ambient temperature of 18°C to 28°C (65°F to 82°F) A relative humidity of less than 80%, unless otherwise noted Warmup period NOTE At the factory, units are calibrated without any switch cards installed and all slots are covered with blank slot covers. The slot covers come installed on the unit when it is shipped.
Series 3700 System Switch/Multimeter Reference Manual Section 15: Calibration Calibration considerations When performing the calibration procedures: Make sure that the equipment is properly warmed up and connected to the appropriate input jacks. Make sure the calibrator is in OPERATE mode before you complete each calibration step. Always let the source signal settle before calibrating each point. If an error occurs during calibration, the Series 3700 will generate an appropriate error message.
Section 15: Calibration Series 3700 System Switch/Multimeter Reference Manual Manufacturer Model Description Used for: Uncertainty Fluke 5700 Calibrator All DCV, ACV, DCI, ACI, and Resistance See NOTE. N/A N/A 4-wire short DCV, resistance zeros N/A Agilent 33220 A Function generator For frequency factory cal only See NOTE. NOTE Refer to the manufacturer's specifications to calculate the uncertainty, which will vary for each test point.
Series 3700 System Switch/Multimeter Reference Manual Section 15: Calibration Make sure to enter the correct date and time using the 24-hour clock. If the date is incorrect, it will not save the proper date when calibration is saved. For additional information about this command, see localnode.settime() (on page 13-215). Remote calibration procedure To perform calibration, use the following procedure: 1.
Section 15: Calibration Series 3700 System Switch/Multimeter Reference Manual DC volts calibration 1. Install the 4-wire short on the analog backplane connector inputs of the Series 3700. 2. Allow the unit to settle for five minutes. 3. Perform the following calibration steps (DC Cal Step 0 through Step 5): Figure 15-1: 4-wire short diagram DC Cal Step 0: A/D MUX Offset Cal (factory cal only) Send the following commands: SEND dmm.calibration.dc(0) print("done") SEND print(errorqueue.
Series 3700 System Switch/Multimeter Reference Manual Section 15: Calibration DC Cal Step 3: +10 Volt Figure 15-2: DC voltage calibration 1. Connect a cable between the calibrator and the Series 3700. 2. Allow the unit to settle for 30 seconds. 3. Send the following command: SEND dmm.range = 10 4. Source +10V. 5. Send the following commands: SEND dmm.calibration.dc(3,10) print("done") SEND print(errorqueue.count) DC Cal Step 4: -10 Volt 1. Source -10V. 2. Send the following commands: SEND dmm.
Section 15: Calibration Series 3700 System Switch/Multimeter Reference Manual Resistance calibration Perform the following calibration steps (DC Cal Step 6 through Step 9): Figure 15-3: Resistance calibration DC Cal Step 6: 100 Ohm 1. Send the following commands: SEND dmm.func = dmm.four_wire_ohms SEND dmm.range = 100 2. Source 100 Ohms, and then read the resistor value from the calibrator. 3. Send the following command: SEND dmm.calibration.dc(6,(resistor value)) print("done") DC Cal Step 7: 10k Ohm 1.
Series 3700 System Switch/Multimeter Reference Manual Section 15: Calibration DC Cal Step 8: 100k Ohm 1. Send the following command: SEND dmm.range = 100e+3 2. Source 100k Ohm, and then read the resistor value from the calibrator. 3. Send the following command: SEND dmm.calibration.dc(8, (resistor value)) print("done") DC Cal Step 9: 1M Ohm 1. Send the following command: SEND dmm.range = 1e+6 2. Source 1M Ohm then read the resistor value from the calibrator. 3. Send the following command: SEND dmm.
Section 15: Calibration Series 3700 System Switch/Multimeter Reference Manual DC Cal Step 10: 100µA 1. Send the following commands: SEND dmm.func = dmm.dc_current SEND dmm.range = 100e-6 2. Source 100µA. 3. Send the following commands: SEND dmm.calibration.dc(10,.0001) print("done") 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") DC Cal Step 12: 10mA 1.
Series 3700 System Switch/Multimeter Reference Manual Section 15: Calibration AC volts calibration Make the connections as shown below, then perform the following calibration steps (AC Cal Step 1 through Step 10): Figure 15-5: AC voltage calibration AC Cal Step 1: 10mV @ 1kHz 1. Send the following commands: SEND dmm.func = dmm.ac_volts SEND dmm.range = 10e-3 2. Source 10mV @ 1kHz. 3. Send the following command: SEND dmm.calibration.ac(1) print("done") AC Cal Step 2: 100mV @ 1kHz 1.
Section 15: Calibration Series 3700 System Switch/Multimeter Reference Manual AC Cal Step 4: 1V @ 1kHz 1. Send the following command: SEND dmm.range = 1 2. Source 1V @ 1kHz. 3. Send the following command: SEND dmm.calibration.ac(4) print("done") AC Cal Step 5: 1V @ 50kHz 1. Source 1V @ 50kHz. 2. Send the following command: SEND dmm.calibration.ac(5) print("done") AC Cal Step 6: 10V @ 1kHz 1. Send the following command: SEND dmm.range = 10 2. Source 10V @ 1kHz. 3. Send the following command: SEND dmm.
Series 3700 System Switch/Multimeter Reference Manual Section 15: Calibration AC Cal Step 10: 300V @ 1kHz 1. Send the following command: SEND dmm.range = 300 2. Source 300V @ 1kHz 3. Send the following command: SEND dmm.calibration.ac(10) print("done") AC current calibration Make the connections as shown, then perform the following calibration steps (AC Cal Step 11 through Step 16): Figure 15-6: AC current calibration 1mA to 1A range AC Cal Step 11: 100µA @ 1kHz 1. Send the following commands: SEND dmm.
Section 15: Calibration Series 3700 System Switch/Multimeter Reference Manual 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) print("done") AC Cal Step 14: 100mA @ 1kHz 1. Send the following command: SEND dmm.range = 100e-3 2. Source 100mA @ 1kHz. 3. Send the following command: SEND dmm.calibration.ac(14) print("done") AC Cal Step 15: 1A @ 1kHz 1. Send the following command: SEND dmm.
Series 3700 System Switch/Multimeter Reference Manual Section 15: Calibration Frequency calibration Make the connections as shown below, then perform the following calibration steps (AC Cal Step 17 and Step 18): Figure 15-7: Low frequency calibration AC Cal Step 17: 1V @ 10Hz (factory cal only) 1. Send the following commands: SEND dmm.func = dmm.ac_volts SEND dmm.range = 1 2. Source 1V @ 10Hz. 3. Send the following command: SEND dmm.calibration.
Section 15: Calibration Series 3700 System Switch/Multimeter Reference Manual 1. Source 1V @ 1kHz 2. Send the following command: SEND dmm.calibration.ac(18,1000) print("done") Save calibration Program today's date, cal due date, and SN, and save the calibration constants in EEPROM (electrically erasable programmable read-only memory) by sending the following commands: dmm.adjustment.date=os.time() dmm.calibration.save() dmm.calibration.verifydate=dmm.adjustment.date dmm.calibration.lock() dmm.
Section 16 Maintenance In this section: Introduction ..................................................................... 16-1 Fuse replacement ........................................................... 16-1 Front panel tests ............................................................. 16-3 Introduction The information in this section deals with routine maintenance of Keithley Instruments Series 3700 System Switch Multimeter instruments that can be performed by the operator.
Section 16: Maintenance WARNING Series 3700 System Switch/Multimeter Reference Manual Disconnect all external power from the equipment and the line cord before performing any maintenance on the Series 3700. Failure to disconnect all power may expose you to hazardous voltages, that if contacted, could cause personal injury or death. Use appropriate safety precautions when working with hazardous voltages.
Series 3700 System Switch/Multimeter Reference Manual Section 16: Maintenance Front panel tests There are two front panel tests: One to test the functionality of the front panel keys and one to test the display. Test procedure The front panel keys test lets you check the functionality of each front panel key. To run the front panel keys test: 1. Display the MAIN MENU by pressing the MENU key. 2. Turn the navigation wheel to scroll to the DISPLAY menu item and press the ENTER key to select. 3.
Section 17 Error and status messages In this section: Introduction ..................................................................... 17-1 Error summary ................................................................ 17-1 Error effects on scripts .................................................... 17-1 Reading errors ................................................................ 17-2 Error and status message list ..........................................
Section 17: Error and status messages Series 3700 System Switch/Multimeter Reference Manual 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, the following commands request the next complete error information from the error queue and returns the message portion of the error: errorcode, message, severity, node = errorqueue.
Series 3700 System Switch/Multimeter Reference Manual Section 17: Error and status messages Error number Error level Error message -203 RECOVERABLE Command protected -200 RECOVERABLE Execution error -154 RECOVERABLE String too long -151 RECOVERABLE Invalid string data -144 RECOVERABLE Character data too long -141 RECOVERABLE Invalid character data -140 RECOVERABLE Character data error -121 RECOVERABLE Invalid character in number -120 RECOVERABLE Numeric data -109 RECOVERABLE
Section 17: Error and status messages 17-4 Series 3700 System Switch/Multimeter Reference Manual Error number Error level Error message 1116 RECOVERABLE Configuration error %s, where %s explains why configuration error 1200 RECOVERABLE TSP-Link initialization failed 1201 RECOVERABLE TSP-Link initialization failed 1202 RECOVERABLE TSP-Link initialization failed 1203 RECOVERABLE TSP-Link initialization failed (possible loop in node chain) 1204 RECOVERABLE TSP-Link initialization failed
Series 3700 System Switch/Multimeter Reference Manual Section 17: Error and status messages Error number Error level Error message 1801 RECOVERABLE Invalid digital I/O line 1802 RECOVERABLE Digital bit in parameter write protected 2100 FATAL Could not open socket 2101 FATAL Could not close socket 2102 RECOVERABLE LAN configuration already in progress 2103 RECOVERABLE LAN disabled 2104 RECOVERABLE Socket error 2105 RECOVERABLE Unreachable gateway 2106 RECOVERABLE Could not acqu
Section 17: Error and status messages 17-6 Series 3700 System Switch/Multimeter Reference Manual Error number Error level Error message 2218 RECOVERABLE Disk full 2219 RECOVERABLE File corrupt 2220 RECOVERABLE File already exists 2221 RECOVERABLE File seek error 2222 RECOVERABLE End-of-file error 2223 RECOVERABLE Directory not empty 2300 RECOVERABLE Upgrade found not upgradable 2301 RECOVERABLE Upgrade uncompress failed 2302 RECOVERABLE Upgrade device not ready 2303 RECOVER
Series 3700 System Switch/Multimeter Reference Manual Section 17: Error and status messages Error number Error level Error message 4900 RECOVERABLE Reading buffer index %d is invalid, where %d represents a number 4901 RECOVERABLE The maximum index for this buffer is %d, where %d represents a number 4902 RECOVERABLE Reading buffers must be able to contain at least one element 4903 RECOVERABLE Reading buffer expired 4904 RECOVERABLE ICX parameter count mismatch, %s (Line #%d), where %s and
Section 17: Error and status messages 17-8 Series 3700 System Switch/Multimeter Reference Manual Error number Error level Error message 5513 RECOVERABLE Not enough total power to complete requested card operation 5514 RECOVERABLE Not enough bank power to complete requested card operation 5515 RECOVERABLE Not enough slot power to complete requested card operation 5516 RECOVERABLE Slot empty, no configuration data exist 5517 RECOVERABLE Slot error, configuration data not found 5518 RECOV
Series 3700 System Switch/Multimeter Reference Manual Section 17: Error and status messages Error number Error level Error message 5620 RECOVERABLE 10M 4-w full scale error 5621 RECOVERABLE 10m adc zero error 5622 RECOVERABLE 100m adc zero error 5623 RECOVERABLE 10m adc full scale error 5624 RECOVERABLE 100m adc full scale error 5625 RECOVERABLE 1 adc full scale error 5626 RECOVERABLE 2k 4-w dckt Ioff zero error 5627 RECOVERABLE 2k 4-w dckt Ion zero error 5628 RECOVERABLE 1k 4
Section 17: Error and status messages 17-10 Series 3700 System Switch/Multimeter Reference Manual Error number Error level Error message 5653 RECOVERABLE 1 vac zero error 5654 RECOVERABLE 1 vac full scale error 5655 RECOVERABLE 1 vac noise error 5656 RECOVERABLE 10 vac zero error 5657 RECOVERABLE 10 vac full scale error 5658 RECOVERABLE 10 vac noise error 5659 RECOVERABLE 100 vac zero error 5660 RECOVERABLE 100 vac full scale error 5661 RECOVERABLE 300 vac zero error 5662 R
Series 3700 System Switch/Multimeter Reference Manual Section 17: Error and status messages Error number Error level Error message 5686 RECOVERABLE 1k 4-w dckt Ion full scale error 5687 RECOVERABLE 10 4-w zero error 5688 RECOVERABLE 10 4-w Ioff zero error 5689 RECOVERABLE 1m aac full scale error 5690 RECOVERABLE 1m aac zero error 5691 RECOVERABLE 10m aac full scale error 5692 RECOVERABLE 10m aac zero error 5693 RECOVERABLE 100m aac full scale error 5694 RECOVERABLE 100m aac ze
Section 17: Error and status messages 17-12 Series 3700 System Switch/Multimeter Reference Manual Error number Error level Error message 5719 RECOVERABLE 1k TRTD SLO Ion full scale error 5720 RECOVERABLE 1k TRTD SLO Ioff full scale error 5721 RECOVERABLE 10k TRTD HI Ion full scale error 5722 RECOVERABLE 10k TRTD HI Ioff full scale error 5723 RECOVERABLE 10k TRTD SLO Ion full scale error 5724 RECOVERABLE 10k TRTD SLO Ioff full scale error 5725 RECOVERABLE 100k TRTD HI Ion full scale
Appendix A IEEE-1588 Glossary of Terms In this appendix: Boundary clock ................................................................. A-1 Epoch ............................................................................... A-1 Grandmaster clock ........................................................... A-1 Master clock ..................................................................... A-2 PTP .................................................................................. A-2 PTP port ...........
Appendix A: IEEE-1588 Glossary of Terms Series 3700 System Switch/Multimeter Reference Manual Master clock Within a region (on the same subnetwork), the master clock is the clock that serves as a primary source of time. Definition derived from NIST website (http://ieee1588.nist.gov). PTP Precision Time Protocol, synonymous with IEEE-1588. Definition derived from NIST website (http://ieee1588.nist.gov).
Index AC voltage 1 1-OHM and 10-OHM resistance ranges, verifying • 14-24 2 verifying • 14-9 AC volts calibration • 15-11 acceptor trigger mode • 8-22, 8-27 2-wire resistance verification data • 1421 verifying • 14-21 4 access recall attributes example • 716 action keys action keys • 4-34 CLOSE • 4-33 4-wire resistance verification data • 1420 short applied verification data • 14-26 short, verifying zeros • 14-25 verifying • 14-19 A OPEN • 4-34 OPEN ALL • 4-33 RATE • 4-34 RECall • 4-34 STORE • 4-35
Index Series 3700 System Switch/Multimeter Reference Manual assigning a value to an attribute • 13-3 buffer • 8-9 configuration (front panel) • 7-6 assigning groups • 3-5 data store commands • 7-8 attributes • 13-2, 13-3 for...
Series 3700 System Switch/Multimeter Reference Manual Index configuration • 4-11 programming notes • 13-1 queries • 2-3 channel assignments • 8-2 table entries • 9-9 display • 4-4, 7-6 TSP advanced features • 3-10 existing scan • 8-9 concatenation • 2-39 functions and attributes • 13-11, 13-24 CONFIG key • 4-11 configuration range • 5-3 configuration • 4-11, 6-10, 13-8 scanning limitations • 4-1 configuration (front panel) • 7-6 type indications • 4-8 connection Channel Action Trigger • 8-6 line
Index Series 3700 System Switch/Multimeter Reference Manual date values • 7-16 filter types • 5-8 dB filter window • 5-10 channel type indication • 4-8 I/O channel indication • 4-8 configuration • 6-10 DIGITS • 4-22 DBREF • 4-22 digits ICL programming • 5-4 non-switch channels • 4-9 digits, setting • 5-4 scanning • 6-11 discrete resistance verification data • 14-24 DBREF • 4-22 display • 4-4, 7-6 DC unit serial number • 1-3 voltage verification data • 14-7 user-defined messages • 2-16 volts c
Series 3700 System Switch/Multimeter Reference Manual Index 11-7 dynamically-allocated buffers • 7-17 examples E access recall attributes example • 7-16 either edge trigger mode • 8-23 ENTER key • 4-25 dynamic buffer programming example • 7-18 environmental conditions • 14-2 epoch • A-1 exceeding reading buffer capacity • 7-21 equipment new configuration • 13-8 recommended • 15-3 passing parameter • 13-4 recommended test • 14-3 reading limit calculation • 14-4 error effects, scripts • 17-1
Index Series 3700 System Switch/Multimeter Reference Manual key configuration • 4-22, 4-25 filter, digital • 5-8 characteristics • 5-8 overview • 5-8 G general bus command sequence • 12-14 GPIB address • 2-12 repeating average • 5-9 attributes • 13-12, 13-187 foreground scan execution • 8-3 interface connection • 2-11 format attributes • 13-12, 13-183 grandmaster clock • A-1 frequency calibration • 15-15 groups assigning • 3-5 verification data • 14-18 coordinating remote • 3-7 verifying • 14-1
Series 3700 System Switch/Multimeter Reference Manual Index introduction • 11-1 MENU • 4-28 INPUTDIV • 4-23 OPEN • 4-34 INSERT key • 4-26 OPEN ALL • 4-33 instruments, synchronizing multiple • 11-9 PATT • 4-29 RANGE • 4-33 interactive script • 2-19 RATE • 4-34 interface connection • 2-12 RECall • 4-34 K REL • 4-30 key configuration • 4-21 RUN • 4-30 keys SCAN • 4-31 action keys • 4-34 SLOT • 4-32 AUTO • 4-32 STORE • 4-35 CHAN • See CHAN key TRIG • 4-32 CLOSE • 4-33 L CONFIG • 4-11 LAN
Index Series 3700 System Switch/Multimeter Reference Manual localnode functions and attributes • 13-13, 13-210 voltage • 2-15 Measure Action Trigger • 8-6 logical measurement instruments • 13-5 event registers • 12-24 operators • 2-38 maximum readings • 5-1 logical operations • 2-38 ranges • 5-1 loop control • 2-41 LXI event log • 11-7 Measurement event register (measurement) • 12-8 memory functions • 13-13, 13-219 LXI Class B triggering (IEEE1588) • 11-1 nonvolatile • 2-8 M MENU key • 4-28 mainte
Series 3700 System Switch/Multimeter Reference Manual Index navigation wheel • 4-33 INSERT • 4-26 negative transition registers • 12-2 key • 4-21 new configuration example, DMM • 13-8 LIMIT • 4-27 LOAD • 4-27 node MENU • 4-28 master overview • 3-5 PATT • 4-29 TSP-Link • 13-5 RECall • 4-34 node enable registers, controlling • 12-16 REL • 4-30 non-scripted chunks, sending • 2-15 RUN • 4-30 nonvolatile memory • 2-8 SCAN • 4-31 NPLC • 4-23 SLOT • 4-32 O TRIG • 4-32 OFFSETCOMP • 4-23 operation
Index Series 3700 System Switch/Multimeter Reference Manual key • 4-29 selecting manual • 5-3 percent • 6-6 RANGE • 4-24 positive transition registers • 12-2 RANGE keys • 4-32, 4-33 POWER switch • 4-17 RATE key • 4-34, 5-5 Precedence • 2-37 reading buffer • 7-12 primary node • 2-33 capacity, exceeding • 7-21 print functions • 13-13, 13-221 creating • 7-2 programming deleting • 7-5 enable registers • 12-10 described • 7-12 interaction • 2-15 designations • 7-12 script model • 2-9 remov
Series 3700 System Switch/Multimeter Reference Manual negative transition • 12-2 Index resistance ranges (1-OHM and 10OHM), verifying • 14-24 operation events • 12-6, 12-21 rising edge positive transition • 12-2 acceptor trigger mode • 8-22 questionable events • 12-7, 1223 master trigger mode • 8-21 registers, system summary • 12-4 REL trigger mode • 8-21, 8-22 RJ-45 buffer operation • 7-7 Ethernet interface connection • 2-12 function • 6-1 RUN key • 4-30 key • 4-30 run-time environment key config
Index Series 3700 System Switch/Multimeter Reference Manual math setup • 6-9 saving • 2-22, 2-23, 2-29 REL value • 6-3 Script Editor • 2-14 schedule functions and attributes • 13-14, 13-250 statements, using • 2-17 Script Editor • 2-14 test scripts across the TSP-Link network • 3-8 scripts unnamed • 2-25 autoexec • 2-26 user • 2-16, 2-20, 2-21, 2-22, 224, 2-25, 2-27, 2-29, 2-30 automatically run • 2-25 Sequence Action Trigger • 8-6 autorun scripts • 2-26 serial number • 1-3 commands, using • 2
Series 3700 System Switch/Multimeter Reference Manual Ethernet interface connection • 2-12 Index synchronization multiple instruments • 11-9 event register • 12-19 synchronous event status register • 12-5 acceptor trigger mode • 8-27 libraries • 2-42 master trigger mode • 8-25 standard libraries • 2-42 trigger mode • 8-28 state • 3-9 triggering modes, understanding • 8-24 local • 2-32 remote • 2-32 system connections • 2-10 status byte and system summary • 12-3 system summary register • 12-13 and
Index Series 3700 System Switch/Multimeter Reference Manual test scripts across the TSP-Link network • 3-8 TSL reference • See Test Script Language Reference THERMO • 4-24 TSP THRESHOLD • 4-24 advanced features • 3-1 time installing software • 2-10 stamp • 7-5 values • 7-16 programming levels • 2-8 TSP-Link timer functions • 13-14, 13-286 communicating between TSPenabled instruments • 10-4 totalizer nodes • 13-5 channel type indication • 4-8 system • 2-32 TRIG key • 4-32 trigger functions and
Series 3700 System Switch/Multimeter Reference Manual Index modifying • 2-29 nonvolatile memory • 2-16 retrieving • 2-30 running • 2-25 running from front panel • 2-27 writing and loading • 2-16 userstring functions • 3-4, 13-15, 13-310 V variables • 2-34 verification instrument address • 14-2 limits • 14-4 test procedures • 14-5, 14-6 test requirements • 14-2 W waitcomplete functions • 13-15, 13312 warm-up • 14-2 wheel, navigation • 4-33 wild characters • 13-1 3700S-901-01 Rev.
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.
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 Instruments, Inc. Corporate Headquarters • 28775 Aurora Road • Cleveland, Ohio 44139 • 440-248-0400 • Fax: 440-248-6168 • 1-888-KEITHLEY • www.keithley.