Keithley 3700A Series Reference Manual

Keithley 3700A Series Reference Manual

System switch/multimeter
Hide thumbs Also See for 3700A Series:
Table of Contents

Advertisement

Quick Links

tek.com/keithley
Series 3700A
System Switch/Multimeter
Reference Manual
3700AS-901-01 Rev. D / July 2018
*P3700AS-901-01D*
3700AS-901-01D

Advertisement

Table of Contents
loading

Summary of Contents for Keithley 3700A Series

  • Page 1 Series 3700A System Switch/Multimeter Reference Manual 3700AS-901-01 Rev. D / July 2018 *P3700AS-901-01D* 3700AS-901-01D...
  • Page 2 Cleveland, Ohio, U.S.A. All rights reserved. Any unauthorized reproduction, photocopy, or use of the information herein, in whole or in part, without the prior written approval of Keithley Instruments, LLC, is strictly prohibited. These are the original instructions in English. ®...
  • Page 3 Keithley products are designed for use with electrical signals that are measurement, control, and data I/O connections, with low transient overvoltages, and must not be directly connected to mains voltage or to voltage sources with high transient overvoltages.
  • Page 4 (note that selected parts should be purchased only through Keithley to maintain accuracy and functionality of the product). If you are unsure about the applicability of a replacement component, call a Keithley office for information.
  • Page 5: Table Of Contents

    USB communications ........................ 2-6 GPIB setup ..........................2-11 LAN communications ......................2-16 Supplied software ........................2-18 Keithley I/O layer ........................2-21 Addressing instruments with VISA ..................2-25 Digital I/O ........................... 2-28 Port configuration ........................2-29 Digital I/O configuration ......................2-30 Controlling digital I/O lines.......................
  • Page 6 Table of contents Series 3700A System Switch/Multimeter Reference Manual Front-panel key menu options ....................3-13 Configuration menu options ....................3-15 Using the front panel with non-switch channels ..............3-22 Rear panel summary ......................3-24 Rear panel connection details ....................3-24 Saved setups ........................
  • Page 7 Series 3700A System Switch/Multimeter Reference Manual Table of contents Current measurement procedure through remote commands ..........4-16 Resistance measurements ....................4-16 DMM resistance measurement methods ................. 4-16 Settings available for resistance measurements ..............4-17 Autodelay and autorange settings ................... 4-18 Resistance measurement connections ...................
  • Page 8 Table of contents Series 3700A System Switch/Multimeter Reference Manual Basic scan procedure ......................5-26 Remote interface scanning ..................... 5-30 Hardware trigger modes ......................5-31 Understanding synchronous triggering modes ................ 5-35 Events ............................. 5-39 LXI Class B and C triggering (IEEE-1588) ................5-40 Reading buffers ......................
  • Page 9 Series 3700A System Switch/Multimeter Reference Manual Table of contents Calculating AC characteristics accuracy ................. 8-20 Calculating dB characteristics accuracy .................. 8-21 Additional derating factors ....................... 8-21 Understanding Precision Time Protocol (PTP) ..............8-22 Introduction to TSP operation ................... 9-1 Introduction to TSP operation ....................9-1 Controlling the instrument by sending individual command messages ........
  • Page 10 Table of contents Series 3700A System Switch/Multimeter Reference Manual Fundamentals of programming for TSP ................10-15 Introduction ........................... 10-15 What is Lua? ......................... 10-15 Lua basics ..........................10-15 Standard libraries ........................10-29 Programming example: Script with a for loop ................ 10-33 Using Test Script Builder (TSB) ..................
  • Page 11 Series 3700A System Switch/Multimeter Reference Manual Table of contents TSP-Net ........................... 10-62 TSP-Net capabilities ......................10-62 Using TSP-Net with any ethernet-enabled device ..............10-63 Using TSP-Net with any ethernet-enabled instrument ............10-64 TSP-Net compared to TSP-Link to communicate with TSP-enabled devices ....... 10-66 TSP-Net instrument commands: General device control ............
  • Page 12 Table of contents Series 3700A System Switch/Multimeter Reference Manual channel.calibration.adjustcount() ................... 11-38 channel.calibration.adjustdate() .................... 11-38 channel.calibration.lock() ...................... 11-40 channel.calibration.password() ....................11-40 channel.calibration.save() ..................... 11-41 channel.calibration.step() ...................... 11-42 channel.calibration.unlock()....................11-44 channel.calibration.verifydate() ..................... 11-45 channel.clearforbidden() ....................... 11-46 channel.close() ........................11-46 channel.connectrule ......................11-48 channel.connectsequential ....................
  • Page 13 Series 3700A System Switch/Multimeter Reference Manual Table of contents comm.lan.vxi11.enable ....................... 11-108 comm.lan.web.enable ......................11-109 createconfigscript() ......................11-110 dataqueue.add() ........................11-110 dataqueue.CAPACITY ......................11-111 dataqueue.clear() ........................ 11-112 dataqueue.count ......................... 11-113 dataqueue.next() ......................... 11-114 delay() ..........................11-115 digio.readbit() ........................11-115 digio.readport() ........................11-116 digio.trigger[N].assert() ......................
  • Page 14 Table of contents Series 3700A System Switch/Multimeter Reference Manual dmm.configure.catalog() ..................... 11-161 dmm.configure.delete() ....................... 11-162 dmm.configure.query() ......................11-163 dmm.configure.recall() ......................11-165 dmm.configure.set() ......................11-166 dmm.connect ........................11-168 dmm.dbreference ........................ 11-170 dmm.detectorbandwidth ...................... 11-171 dmm.displaydigits ........................ 11-172 dmm.drycircuit ........................11-173 dmm.filter.count ........................11-174 dmm.filter.enable .........................
  • Page 15 Series 3700A System Switch/Multimeter Reference Manual Table of contents errorqueue.count ......................... 11-235 errorqueue.next() ........................ 11-236 eventlog.all() ........................11-237 eventlog.clear() ........................11-238 eventlog.count ........................11-238 eventlog.enable ........................11-239 eventlog.next() ........................11-240 eventlog.overwritemethod ....................11-241 exit() ............................ 11-241 fileVar:close() ........................11-242 fileVar:flush() ........................11-242 fileVar:read() ........................
  • Page 16 Table of contents Series 3700A System Switch/Multimeter Reference Manual lan.trigger[N].clear() ......................11-273 lan.trigger[N].connect() ......................11-274 lan.trigger[N].connected ...................... 11-275 lan.trigger[N].disconnect() ....................11-276 lan.trigger[N].EVENT_ID ..................... 11-276 lan.trigger[N].ipaddress ....................... 11-277 lan.trigger[N].mode ......................11-277 lan.trigger[N].overrun ......................11-278 lan.trigger[N].protocol ......................11-279 lan.trigger[N].pseudostate ....................11-280 lan.trigger[N].stimulus ......................11-280 lan.trigger[N].wait() ......................
  • Page 17 Series 3700A System Switch/Multimeter Reference Manual Table of contents scan.stepcount ........................11-327 scan.trigger.arm.clear() ....................... 11-327 scan.trigger.arm.set() ......................11-328 scan.trigger.arm.stimulus ....................11-328 scan.trigger.channel.clear() ....................11-330 scan.trigger.channel.set() ....................11-330 scan.trigger.channel.stimulus ....................11-331 scan.trigger.clear() ......................11-332 scan.trigger.measure.clear() ....................11-333 scan.trigger.measure.set() ....................11-333 scan.trigger.measure.stimulus .................... 11-334 scan.trigger.sequence.clear() ....................
  • Page 18 Table of contents Series 3700A System Switch/Multimeter Reference Manual slot[slot].thermal.state ......................11-373 status.condition ........................11-373 status.measurement.* ......................11-375 status.node_enable ......................11-377 status.node_event ....................... 11-379 status.operation.* ........................ 11-381 status.operation.user.* ......................11-383 status.questionable.* ......................11-385 status.request_enable ......................11-387 status.request_event ......................11-389 status.reset() ........................11-391 status.standard.* .........................
  • Page 19 Series 3700A System Switch/Multimeter Reference Manual Table of contents tspnet.disconnect() ......................11-436 tspnet.execute() ........................11-436 tspnet.idn() .......................... 11-437 tspnet.read() ........................11-438 tspnet.readavailable() ......................11-439 tspnet.reset() ........................11-440 tspnet.termination() ......................11-440 tspnet.timeout ........................11-441 tspnet.tsp.abort() ......................... 11-442 tspnet.tsp.abortonconnect ....................11-442 tspnet.tsp.rbtablecopy() ....................... 11-443 tspnet.tsp.runscript() ......................
  • Page 20 Table of contents Series 3700A System Switch/Multimeter Reference Manual How do I find the serial number and firmware version? ............. 13-3 Why can't the Series 3700A read my USB flash drive? ............. 13-3 Next steps ........................14-1 Additional Series 3700A information .................. 14-1 LAN concepts and settings ..................A-1 Overview ..........................
  • Page 21 Series 3700A System Switch/Multimeter Reference Manual Table of contents Status model diagrams ......................C-3 Status Byte Register overview ....................C-3 Measurement summary bit (Measurement event register) ............C-4 System summary bit (System register) ..................C-5 Standard Event Register ......................C-7 Error available bit (Error or Event queue) ..................
  • Page 22: Introduction

    If you have any questions after you review the information in this documentation, please contact your local Keithley Instruments office, sales partner, or distributor. You can also call the corporate headquarters of Keithley Instruments (toll-free inside the U.S. and Canada only) at 1-800-935-5595, or from outside the U.S.
  • Page 23: Product Documentation, Drivers, And Software

    Quick Start Guide: Provides unpacking instructions, describes basic connections, and reviews basic operation information. If you are new to Keithley Instruments equipment, refer to the Quick Start Guide to take the steps needed to unpack, set up, and verify operation.
  • Page 24: Capabilities And Features

    Series 3700A System Switch/Multimeter Reference Manual Section 1: Introduction Capabilities and features The Series 3700A System Switch/Multimeter is comprised of four versions of the Model 3706A system switch mainframe and a series of plug-in switch and control cards. Series 3700A available models Model Description 3706A...
  • Page 25: Measuring Capabilities

    Section 1: Introduction Series 3700A System Switch/Multimeter Reference Manual Measuring capabilities The basic measurement capabilities of Series 3700A systems are summarized in the following figure. Figure 1: DMM measurement capabilities Displaying the instrument's serial number The instrument serial number is on a label on the rear panel of the instrument. You can also access the serial number from the front panel using the front-panel keys and menus.
  • Page 26 Section 2 Installation In this section: Dimensions ................2-1 Weight ..................2-3 Rack-mounting instructions ............2-3 Remote communications interfaces ......... 2-6 Digital I/O ................2-28 Starting up your instrument ............ 2-33 Dimensions The following figures show the dimensions of the Series 3700A. Figure 2: Model 3706A height and front-panel width...
  • Page 27 Section 2: Installation Series 3700A System Switch/Multimeter Reference Manual Figure 3: Model 3706A depth and rear-panel width Figure 4: Model 3706A dimensions for rear-support mounting with Model 4299-10 3700AS-901-01 Rev. D/June 2018...
  • Page 28: Installation

    Series 3700A System Switch/Multimeter Reference Manual Section 2: Installation Weight The weights of the Series 3700A, plug-in cards, and the screw terminal adapter are provided in the following table. Component Weight Model 3706A mainframe 6.12 kg (13.5 lb) Plug-in card, average 1.36 kg (3 lb) Screw terminal adapter, average 0.45 kg (1 lb)
  • Page 29: Prepare The Series 3700A For Rack-Mount Installation

    Section 2: Installation Series 3700A System Switch/Multimeter Reference Manual Prepare the Series 3700A for rack-mount installation Before installing the instrument, disconnect all external power from the equipment and disconnect the line cord. Failure to disconnect all power may expose you to hazardous voltages, which, if contacted, could cause personal injury or death.
  • Page 30: Install The Series 3700A

    Series 3700A System Switch/Multimeter Reference Manual Section 2: Installation Install the Series 3700A To install the Series 3700A in the rack: If the Series 3700A mainframe has more than two plug-in cards installed, you must use the optional Model 4288-10 Rear Support Mount Kit in a fixed installation. 1.
  • Page 31: Remote Communications Interfaces

    Microsoft Windows 2000, Windows XP, Windows Vista, and Windows 7 operating systems. It also describes the I/O software, drivers, and application software that can be used with Keithley’s instruments. Supported remote interfaces The Series 3700A supports the following remote interfaces: •...
  • Page 32 This requires that you determine the parameters. You can gather this information by running a utility that automatically detects all instruments connected to the computer. If you installed the Keithley I/O Layer, the Keithley Configuration Panel is available from the ®...
  • Page 33 Section 2: Installation Series 3700A System Switch/Multimeter Reference Manual Figure 8: Select Communication Bus dialog box 4. Select USB. 5. Click Next. The Select Instrument Driver dialog box is displayed. Figure 9: Select Instrument Driver dialog box 3700AS-901-01 Rev. D/June 2018...
  • Page 34 Series 3700A System Switch/Multimeter Reference Manual Section 2: Installation 6. Select Auto-detect Instrument Driver - Model. 7. Click Next. The Configure USB Instrument dialog box is displayed with the detected instrument VISA resource string displayed. Figure 10: Configure USB Instrument dialog box 8.
  • Page 35 Series 3700A System Switch/Multimeter Reference Manual 12. Save the configuration. From the Configuration Utility, select File > Save. 13. In the Keithley Communicator, select File > Open Instrument to open the instrument you just named. Figure 12: Keithley Communicator Open an Instrument 14.
  • Page 36: Gpib Setup

    Install the GPIB driver software Check the documentation for your GPIB controller for information about where to acquire drivers. Keithley Instruments also recommends that you check the website of the GPIB controller for the latest version of drivers or software.
  • Page 37 They directly call the GPIB driver support libraries. For the KPCI-488LPA and KUSB-488B GPIB controller from Keithley Instruments, the configuration utility is called the KI-488 Diagnostic Tool. It is available from the Windows Start menu at Keithley Instruments > KI-488 > KI-488 Diagnostic Tool.
  • Page 38 If you want to use the GPIB controller with instrument driver (such as VXIPnP or IVI) or high-level software, you must also install I/O software, which installs the VISA layer. See How to install the Keithley I/O Layer. Terminator When receiving data over the GPIB, the instrument terminates messages on any line feed character or any data byte with EOI asserted (line feed with EOI asserted is also valid).
  • Page 39 Section 2: Installation Series 3700A System Switch/Multimeter Reference Manual The remote enable (REN) command is sent to the Series 3700A by the controller to set up the instrument for remote operation. Generally, the instrument should be placed in the remote mode before you attempt to program it over the bus.
  • Page 40 Keithley Instruments > KI-488 > KI-488 Diagnostic Tool. For the KUSB-488A GPIB controller from Keithley Instruments, the configuration utility is called GPIB Configuration. It is available from the Windows Start Menu at Keithley Instruments > GPIB-488 > GPIB Configuration. For National Instruments (NI ) GPIB controllers, you can use NI-MAX.
  • Page 41: Lan Communications

    Section 2: Installation Series 3700A System Switch/Multimeter Reference Manual TALK This indicator is on when the instrument is in the talker active state. Place the instrument in the talk state by addressing it to talk with the correct talk command. TALK is off when the instrument is in the talker idle state.
  • Page 42 Series 3700A System Switch/Multimeter Reference Manual Section 2: Installation Overview of LAN instruments When ethernet ports became standard on computers, it was logical that instrumentation would follow. The VXI-11 protocol, which was standardized on in the early 1990s, is the standard used to emulate GPIB over ethernet.
  • Page 43: Supplied Software

    2. Straight-through LAN cable or crossover LAN cable 3. Ethernet port (located on the host computer) Supplied software The majority of software applications and all instrument drivers from Keithley Instruments depend on some, or all, of the following software components: •...
  • Page 44 Section 2: Installation Instrument driver types There are several different styles of instrument drivers. Keithley Instruments provides three different instrument drivers for the Series 3700A: A native LabVIEW driver, an IVI-C driver, and an IVI-COM driver. You need to pick the style that best suits the application development environment (ADE) that you are using.
  • Page 45 , you can also go to the National Instruments website and search their instrument driver database. Instrument driver examples All Keithley drivers come with examples written in several programming languages that show you how to do the most common things with the instruments. ®...
  • Page 46: Keithley I/O Layer

    Keithley I/O layer The Keithley I/O Layer (KIOL) is a software package that contains several utilities and drivers. It is mainly used as a supplement to IVI drivers or application software like Test Script Builder (TSB). The KIOL contains: •...
  • Page 47 If you do not have NI software installed, to use Keithley drivers or application software, you must install the KIOL. This installs a valid, licensed copy of the NI-VISA runtime to use with Keithley drivers or application software. KIOL installs a valid license for the NI-VISA Run-Time Engine only (not the full version of NI-VISA).
  • Page 48 VISA to malfunction. The recommended way to resolve this situation is to perform the following steps: 1. Exit the Keithley I/O Layer software when the warning message is displayed. Make note of the VISA vendor in the warning message (if any).
  • Page 49 8. If the pre-existing version of VISA was supplied by a vendor other than Tektronix or Keysight, we recommend that you do not reinstall it, because this will likely cause the Keithley I/O Layer software to malfunction.
  • Page 50: Addressing Instruments With Visa

    The following sections describe the resource strings for some of the communication types that Keithley supports. Any field that has [] (square brackets) around it is optional and will revert to a default value. Addressing instruments through the LAN VISA supports two different LAN protocols, each of which has a different resource string.
  • Page 51 Section 2: Installation Series 3700A System Switch/Multimeter Reference Manual Addressing instruments through GPIB There are two different resource classes in VISA for the GPIB bus. INSTR is the basic class that everyone uses. It allows application software to send and receive data and commands without dealing with some low level GPIB nuances.
  • Page 52 Series 3700A System Switch/Multimeter Reference Manual Section 2: Installation /* Send an *IDN? string to the device */ checkErr(viPrintf(vi, "*IDN?\n")); ViUInt16 status = 0; checkErr(viReadSTB(vi, &status)); printf("ReadSTB = %X\n", status); } while(status == 0); /* Read results */ checkErr(viScanf(vi, "%t", &buf)); /* Print results */ printf ("Instrument identification string: %s\n", buf);...
  • Page 53: Digital I/O

    Section 2: Installation Series 3700A System Switch/Multimeter Reference Manual VISA-COM sample code This example gets the instrument identification string using VISA-COM in C#. The first thing to do is add a reference to the VISA-COM interop DLL, which is usually located at C:\Program Files\IVI Foundation\VISA\VisaCom\Primary Interop Assemblies\Ivi.Visa.Interop.dll.
  • Page 54: Port Configuration

    Pin reserved for future use V EXT Connecting cables Use a cable equipped with a standard male DB-25 connector (Keithley Instruments part number CA-126-1). Vext The Series 3700A digital I/O provides flyback diode pins named Vext. When connected, Vext can clamp external inductive circuitry (for example, relay drive coils) from +5 V to +33 V.
  • Page 55: Digital I/O Configuration

    Section 2: Installation Series 3700A System Switch/Multimeter Reference Manual Digital I/O configuration The following figure shows the basic configuration of the digital I/O port. Writing a 1 to a line sets that line high (~ +5 V). Writing a 0 to a line sets that line low (~0 V). Note that an external device pulls an I/O line low by shorting it to ground.
  • Page 56 Series 3700A System Switch/Multimeter Reference Manual Section 2: Installation To write-protect specific digital I/O lines to prevent their values from being changed: 1. Press the MENU key, then select DIGIO, and then press the ENTER key or the navigation wheel 2.
  • Page 57: Tsp-Link Trigger Lines

    Section 2: Installation Series 3700A System Switch/Multimeter Reference Manual The digital I/O lines can be used for both input and output. You must write a 1 to all digital I/O lines that are to be used as inputs. Remote digital I/O commands Command Description digio.readbit(bit)
  • Page 58: Starting Up Your Instrument

    Series 3700A System Switch/Multimeter Reference Manual Section 2: Installation The TSP-Link trigger lines can be used for both input and output. You must write a 1 to all TSP-Link trigger lines that are used as inputs. Remote trigger line commands Command Description tsplink.readbit(bit)
  • Page 59 Section 2: Installation Series 3700A System Switch/Multimeter Reference Manual To turn a Series 3700A on and off: 1. Before plugging in the power cord, make sure that the front panel POWER switch is in the off (O) position. 2. Connect the Series 3700A redundant protective earth (safety ground) on the rear panel.
  • Page 60: Instrument Description

    Section 3 Instrument description In this section: Front panel operation ............... 3-1 Rear panel summary .............. 3-24 Saved setups ................. 3-30 Save the present configuration ..........3-33 Using the web interface ............3-36 Front panel operation The Series 3700A includes several models that support different features. The following figures show the front panels of each of the models.
  • Page 61: The Usb Port

    Section 3: Instrument description Series 3700A System Switch/Multimeter Reference Manual Figure 20: Models 3706A-NFP (with DMM) and 3706A-SNFP (no DMM) front panel (1) The USB port Use the front-panel USB port to connect a USB flash drive. The USB flash drive can be used to store reading buffer data, scripts, and user setup options.
  • Page 62 Series 3700A System Switch/Multimeter Reference Manual Section 3: Instrument description Series 3700A display during operation Active channel (slot 1, channel 004). Channel state (open, 2-pole operation). Present state of the DMM attributes for displayed channel: ▪ The 4-WΩ and autorange are enabled ▪...
  • Page 63: The Navigation Wheel

    Section 3: Instrument description Series 3700A System Switch/Multimeter Reference Manual The bottom left line of the display contains the DMM attribute symbols. The symbols that appear are dependent on whether the attribute exists for the selected function. The following table indicates the DMM attribute symbols that may appear on the front panel.
  • Page 64: The Status Lights

    Series 3700A System Switch/Multimeter Reference Manual Section 3: Instrument description (5) The status lights The Series 3700A has three status lights on the front panel. The 1588 status light indicates 1588 operation. If this light is off, the 1588 feature is disabled or improperly configured.
  • Page 65 Section 3: Instrument description Series 3700A System Switch/Multimeter Reference Manual Channel keys OPEN ALL Opens all closed channels. STEP Use to walk through a scan list by closing and opening the channels contained in a single step with each press of the key. CLOSE You can use the front-panel CLOSE and OPEN keys to perform either switch only operations or and OPEN...
  • Page 66 Series 3700A System Switch/Multimeter Reference Manual Section 3: Instrument description General function keys STORE Selects, clears, and saves reading buffer data and creates and deletes reading buffers. Recalls stored readings for the selected reading buffer. Use the CURSOR keys or turn the navigation wheel to scroll through the buffer.
  • Page 67: Menu Overview

    Section 3: Instrument description Series 3700A System Switch/Multimeter Reference Manual Menu overview The following topics describe how to work with the front panel menus. Menu navigation To navigate through the menus and submenus, the Series 3700A must not be in edit mode (the EDIT indicator is not illuminated).
  • Page 68 Series 3700A System Switch/Multimeter Reference Manual Section 3: Instrument description Main menu The main menu structure is summarized in the following figure and table. For other menu items, see Configuration menus (on page 3-11). Figure 23: Main menu tree 3700AS-901-01 Rev. D/June 2018...
  • Page 69 Section 3: Instrument description Series 3700A System Switch/Multimeter Reference Manual The following table contains descriptions of the main menu options and cross-references to related information. To access a menu option, press the MENU key, turn the navigation wheel to move the cursor to select an item, and press the navigation wheel .
  • Page 70 Series 3700A System Switch/Multimeter Reference Manual Section 3: Instrument description Configuration menus The configuration menu structure is summarized in the following figure and table. For directions on navigating the menu, see Menu navigation (on page 3-8). For other menu items, see Main menu page 3-9).
  • Page 71 Section 3: Instrument description Series 3700A System Switch/Multimeter Reference Manual Press the EXIT key to return to a previous menu. The following table contains descriptions of the configuration menus and cross-references to related information. To select a menu, press the CONFIG key and then the front-panel key associated with the menu.
  • Page 72: Front-Panel Key Menu Options

    Series 3700A System Switch/Multimeter Reference Manual Section 3: Instrument description Front-panel key menu options The menus that can be accessed from the front panel of the instrument allow you to set up and run the instrument. LOAD TEST menu options Allows you to run scripts and code from the front panel that you created through the communication interface, or configuration scripts created by pressing the front-panel MENU key, then selecting SCRIPT >...
  • Page 73 Section 3: Instrument description Series 3700A System Switch/Multimeter Reference Manual TOTALIZER channel options include: • READ: Displays a value from a channel as a number between 0 and 65535. This menu option does not appear if a range of channels is selected. Related command: channel.read() (on page 11-83).
  • Page 74: Configuration Menu Options

    Series 3700A System Switch/Multimeter Reference Manual Section 3: Instrument description SCAN ACTION menu options Allows you to work with the scan lists from the front panel. You must have a scan list created before using this option. See Basic scan procedure (on page 5-26) for information.
  • Page 75 Section 3: Instrument description Series 3700A System Switch/Multimeter Reference Manual CONFIG CHAN key - SWITCH channel type Press the CONFIG key and then the CHAN key to open the CHANNEL ATTR menu. If you press the CHAN key when a pattern is selected, the instrument goes into channel selection mode. When changing attribute settings for a range of channels, the menu option for the first channel specified in the range is highlighted.
  • Page 76 Series 3700A System Switch/Multimeter Reference Manual Section 3: Instrument description MATCH: Sets the match value on a channel. Enter the value as 8-bit binary. Related command: channel.setmatch() (on page 11-92). MATCH-TYPE: Sets the match type on a channel. Select EXACT, ANY, NOT_EXACT, or NONE. Related command: channel.setmatchtype() (on page 11-93).
  • Page 77 Section 3: Instrument description Series 3700A System Switch/Multimeter Reference Manual Therefore, to see the following options, select a single DAC channel. If the DAC channel has power set to DISABLE, the menu choices change to only show the option to change the power setting, until the power is set to ENABLE.
  • Page 78 Series 3700A System Switch/Multimeter Reference Manual Section 3: Instrument description • BYPASS: Enables or disables bypassing the first item in the scan. Related command: scan.bypass (on page 11-314). • 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) ▪...
  • Page 79 Section 3: Instrument description Series 3700A System Switch/Multimeter Reference Manual LIMIT: Opens the LIMIT menu for the selected DMM function. See LIMIT key configuration (on page 3-21). LINESYNC: Enables or disables line sync during measurements. Related command: dmm.linesync (on page 11-195). MATH: Selecting the MATH menu item opens the MATH MENU.
  • Page 80 Series 3700A System Switch/Multimeter Reference Manual Section 3: Instrument description THRESHOLD: Configures the threshold range. Related command: dmm.threshold (on page 11-232). UNITS: Configures the units for voltage and temperature measurements. Related command: dmm.units (on page 11-234). 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 LIMIT 1 or LIMIT 2 menu.
  • Page 81: Using The Front Panel With Non-Switch Channels

    Section 3: Instrument description Series 3700A System Switch/Multimeter Reference Manual FUNC key configuration Press the CONFIG key and then the FUNC key to display a menu that allows you to scroll through the available DMM functions. Turn the navigation wheel or press the CURSOR keys to scroll through available functions.
  • Page 82 Series 3700A System Switch/Multimeter Reference Manual Section 3: Instrument description Front-panel Symbol Definition Symbol meaning channel setting XXXXXX Channel label First 6 characters of label Used with single letter symbols XXXXXXXXXXXX First 12 characters of label Used with the non-single letter symbols DIG IN Digital I/O mode...
  • Page 83: Rear Panel Summary

    (on page 7-1) for details. Slots Use any of the six slots of the Keithley Instruments Series 3700A for switching cards. If a slot does not contain a card, make sure that you cover the slot with a slot cover.
  • Page 84 Series 3700A System Switch/Multimeter Reference Manual Section 3: Instrument description For complete information about Series 3700A switching cards, refer to the Series 3700A Switch and Control Cards Reference Manual (Keithley part number 3700AS-909-01), available for download from the Keithley Product Support web page (https://www.tek.com/product-support).
  • Page 85 To avoid possible mechanical damage, stack no more than three connectors on any one instrument. To minimize interference caused by electromagnetic radiation, use only shielded GPIB cables. Contact Keithley Instruments for shielded cables. 3-26 3700AS-901-01 Rev. D/June 2018...
  • Page 86 Series 3700A System Switch/Multimeter Reference Manual Section 3: Instrument description Figure 29: Series 3700A multiple parallel connections To connect the Series 3700A to the IEEE-488 bus, line up the cable connector with the connector located on the rear panel. Install and tighten the screws securely, making sure not to overtighten them (the following figure shows the location of the connections).
  • Page 87 Section 3: Instrument description Series 3700A System Switch/Multimeter Reference Manual The figure below shows the location of the ethernet connector on the Series 3700A rear panel. Figure 31: Series 3700A ethernet connection LAN status LEDs The figure below illustrates the two status light emitting diodes (LED) that are on the LAN port of the instrument.
  • Page 88 Series 3700A System Switch/Multimeter Reference Manual Section 3: Instrument description Analog backplane connector Refer to the following figure for analog backplane connector information. See Connection safety page 3-30) before making any connections. Figure 34: Analog backplane connector The tables below contain pin numbers and descriptions for the analog backplane connector. Description Description Analog backplane 3-HI...
  • Page 89: Saved Setups

    Section 3: Instrument description Series 3700A System Switch/Multimeter Reference Manual Connection safety Connection information for switching cards is intended for qualified service personnel, as described by the types of product users in the Safety precautions. Do not attempt to connect DUT or external circuitry to a switching card unless qualified to do so.
  • Page 90: Saving User Setups

    Series 3700A System Switch/Multimeter Reference Manual Section 3: Instrument description Saving user setups You can save the present Series 3700A setup to internal nonvolatile memory or a USB flash drive. To save a user setup to nonvolatile memory from the front panel: 1.
  • Page 91: Saving User Setups From A Remote Interface

    Section 3: Instrument description Series 3700A System Switch/Multimeter Reference Manual Saving user setups from a remote interface Saving and recalling user setups Use the setup.save() and setup.recall() functions to save and recall user setups. To save and recall user setups using remote commands: The following example saves the present setup as setup 1, and then recalls setup 1: -- Save the present setup to nonvolatile memory.
  • Page 92: Save The Present Configuration

    Series 3700A System Switch/Multimeter Reference Manual Section 3: Instrument description Save the present configuration You can capture the present settings of the instrument using the create configuration script feature. When you run this feature, the configuration script is created and saved. You can run it later to return to that configuration, or set it up to be the autoexec script.
  • Page 93 Section 3: Instrument description Series 3700A System Switch/Multimeter Reference Manual --Auto created configuration script Indicates that this was created with the Create Configuration Script feature --Mon Apr 04 12:34:28 2016 Date and timestamp if string.find(slot[1].idn, "3724") == nil then Code that print("Card installed in slot 1 needs to be a 3724.") verifies that display.clear()
  • Page 94: Create A Configuration Script

    Series 3700A System Switch/Multimeter Reference Manual Section 3: Instrument description Create a configuration script When you run the create configuration script feature, it automatically generates a user script that is saved to a script with a name that you define. Create configuration script is available from the front panel of the instrument, the web interface, and the remote interface.
  • Page 95: Using The Web Interface

    Section 3: Instrument description Series 3700A System Switch/Multimeter Reference Manual Using the web interface ® The Series 3700A web interface can be used with your choice of web browsers, including Microsoft ® ® ® ® ® Internet Explorer , Mozilla Firefox , Google Chrome , and Apple...
  • Page 96: Log In To The Instrument

    Series 3700A System Switch/Multimeter Reference Manual Section 3: Instrument description Log in to the instrument The web interface has both interactive and read-only pages. These pages are always listed in the navigation panel on the left side of the web interface. You can review information on any of the pages without logging in, but to change information, you must log in.
  • Page 97 Section 3: Instrument description Series 3700A System Switch/Multimeter Reference Manual Figure 38: Series 3700A web interface cards page Open and close slots from the card pages You can open and close channels from the card pages in several ways. The simplest method is to click a connection. The channel changes state to open or closed. When the channel is open, the connection will look similar to one of the following graphics (the actual item on the web interface depends on the installed card): Figure 39: Web interface open channel...
  • Page 98 Series 3700A System Switch/Multimeter Reference Manual Section 3: Instrument description To specify the type of close, select a Channel Action Type from the box in the upper right before closing a channel. The options are: • Channel Close: Close the selected channel without affecting the state of any other channels. •...
  • Page 99 Section 3: Instrument description Series 3700A System Switch/Multimeter Reference Manual In this dialog box, you can set: • Label: The label for the channel. This is the same as the command channel.setlabel(). • Forbidden: Select this box to set the channel to forbidden. This prevents the channel from being closed from any interface.
  • Page 100 Series 3700A System Switch/Multimeter Reference Manual Section 3: Instrument description Figure 44: Series 3700A channel pattern configuration dialog box 3. Enter a name in the box at the top. 4. From the Channels Available list, select the channels you want to add. You can use Ctrl+click and Shift+click to select multiple channels.
  • Page 101: Scan Builder Page

    Section 3: Instrument description Series 3700A System Switch/Multimeter Reference Manual Reset a slot from the web interface You can reset all the relays in the displayed slot by clicking Reset Slot. When you reset the relays in a slot: • Any closed channels and analog backplane relays open •...
  • Page 102 Series 3700A System Switch/Multimeter Reference Manual Section 3: Instrument description Before setting up a scan list, make sure your channels and channel patterns are configured. See Working with channels (on page 5-13) for detail. If you change the channel configurations or channel patterns after the scan list has been set up, you may not see expected results.
  • Page 103 Section 3: Instrument description Series 3700A System Switch/Multimeter Reference Manual Reset the scan list You can clear the scan list and return scan settings to their factory defaults using scan reset. A scan reset does not affect any settings in the instrument except the scan list and trigger model. The settings that are affected are: •...
  • Page 104 Series 3700A System Switch/Multimeter Reference Manual Section 3: Instrument description Set up simple triggers You can set up triggers to control your scan using the options on the Simple Trigger tab. You can set: • The event that starts the scan •...
  • Page 105 Section 3: Instrument description Series 3700A System Switch/Multimeter Reference Manual Selecting measurement triggers You can also select the trigger to use to take a measurement for each scan step. Immediate: When immediate is selected, the measurement is taken as soon as the channel is closed.
  • Page 106: Dmm Web Page

    Series 3700A System Switch/Multimeter Reference Manual Section 3: Instrument description DMM web page The DMM web page allows you to configure the various DMM functions, create user-defined DMM configurations and reading buffers, and take measurement readings that may or may not be stored in a reading buffer.
  • Page 107: Tsb Embedded

    Section 3: Instrument description Series 3700A System Switch/Multimeter Reference Manual TSB Embedded TSB Embedded is an application that includes a command line interface that you can use to issue TSP commands. It also offers script-building functionality. TSB Embedded resides in the instrument. Script management options Existing scripts are listed in the User Scripts box on the left side of TSB Embedded.
  • Page 108: Unit Page

    Series 3700A System Switch/Multimeter Reference Manual Section 3: Instrument description Unit page Save: Save the setup of the instrument. Recall: Recall the setup of the instrument that was saved with the Save button. Create Config Script: Save the setup of the instrument as a script. To create the script: 1.
  • Page 109: Admin Page

    Section 3: Instrument description Series 3700A System Switch/Multimeter Reference Manual Admin page Through the Admin page, you can change the instrument password and the instrument time. Change the password To change the password for the web interface: 1. In the web interface, from the left navigation, click Admin. A login page is displayed. 2.
  • Page 110 Series 3700A System Switch/Multimeter Reference Manual Section 3: Instrument description Figure 45: Log page The timestamp, event identifier, the IP address, and the domain name identify the incoming and outgoing LXI trigger packets. The following table provides detailed descriptions for the columns in the event log.
  • Page 111 Section 3: Instrument description Series 3700A System Switch/Multimeter Reference Manual Event log descriptions Column title Description Example Receive Time Displays the date and time when the LAN 06:56:28.000 8 May 2008 trigger occurred in UTC, 24-hour time LAN0 = lan.trigger[1] EventID Identifies the lan.trigger[N] that generates an LAN1 = lan.trigger[2]...
  • Page 112: Basic Dmm Operation

    Section 4 Basic DMM operation In this section: DMM measurement capabilities ..........4-1 High-energy circuit safety precautions ........4-2 Performance considerations ............. 4-2 System considerations ............. 4-6 Voltage measurements (DC volts and AC volts) ...... 4-9 Current measurements (DC current and AC current) ..... 4-14 Resistance measurements .............
  • Page 113: High-Energy Circuit Safety Precautions

    Section 4: Basic DMM operation Series 3700A System Switch/Multimeter Reference Manual High-energy circuit safety precautions To optimize safety when measuring voltage in high-energy distribution circuits, read and use the directions in the following warning. Dangerous arcs of an explosive nature in a high-energy circuit can cause severe personal injury or death.
  • Page 114: Autozero

    Series 3700A System Switch/Multimeter Reference Manual Section 4: Basic DMM operation Autozero When the autozero feature is enabled, the Series 3700A periodically measures internal voltages that correspond to offset (zero) and amplifier gain reference points. The Series 3700A includes these measurements when it calculates the reading of the input signal.
  • Page 115: Line Cycle Synchronization

    Section 4: Basic DMM operation Series 3700A System Switch/Multimeter Reference Manual Line cycle synchronization Using line synchronization helps increase common-mode and normal-mode noise rejection. When line cycle synchronization is enabled, measurements are initiated at the first positive-going zero crossing of the power line cycle after the trigger. Line cycle synchronization only applies to the following DMM functions: •...
  • Page 116: Measure Count

    Series 3700A System Switch/Multimeter Reference Manual Section 4: Basic DMM operation You can also use autodelay once to include a delay for only the first measurement in a set of measurements. Each measurement after the first one has no additional delay. To set autodelay from the front panel for the selected function: 1.
  • Page 117: Change The Display Resolution

    Section 4: Basic DMM operation Series 3700A System Switch/Multimeter Reference Manual Change the display resolution You can set the display resolution for measurements that are shown on the front panel of the instrument. You can set the resolution to 3½, 4½, 5½, 6½, or 7½ digits. Display resolution can be set for all functions except "nofunction"...
  • Page 118: Relationship Between Front Panel Settings And Remote Commands

    Series 3700A System Switch/Multimeter Reference Manual Section 4: Basic DMM operation Relationship between front panel settings and remote commands When you change the active DMM function from the front panel, the active function for all other interfaces is changed as well. This is also true for attributes. When you change the active DMM function through a remote interface, the front panel settings are also changed.
  • Page 119: Open And Close Relay Operation

    Section 4: Basic DMM operation Series 3700A System Switch/Multimeter Reference Manual How to save a DMM configuration To create and save a DMM configuration from the front panel: 1. Press DMM. 2. Use the navigation wheel to select SAVE. 3. Press the navigation wheel or press ENTER.
  • Page 120: Voltage Measurements (Dc Volts And Ac Volts)

    Series 3700A System Switch/Multimeter Reference Manual Section 4: Basic DMM operation Example 1: Close channel, make measurement using DMM operation method When you assign a measurement function to a channel and press the Close key, the Close key routes the input signal automatically to the DMM through the appropriate backplane relays. This behavior is referred to as DMM operation.
  • Page 121: Settings Available For Voltage Measurements

    Section 4: Basic DMM operation Series 3700A System Switch/Multimeter Reference Manual Settings available for voltage measurements The following DMM attributes are available for voltage measurements: • aperture (range of 10 µs to 0.250 s for 50 Hz; 8.33 µs to 0.250 s for 60 Hz) •...
  • Page 122: Autodelay And Autorange Settings

    Series 3700A System Switch/Multimeter Reference Manual Section 4: Basic DMM operation Autodelay and autorange settings The following table provides times for autodelay and autorange time for the Series 3700A DMM voltage functions. Function Detector Range and delays bandwidth DC volts Not applicable Range 100 mV...
  • Page 123: Voltage Measurement Procedure From The Front Panel

    Section 4: Basic DMM operation Series 3700A System Switch/Multimeter Reference Manual Figure 48: ACV connection Voltage measurement procedure from the front panel If both the analog backplane connector and a switching module's terminals are connected at the same time, all wiring and connections must be rated to the highest voltage that is connected.
  • Page 124: Voltage Measurement Procedure Remote Commands

    Series 3700A System Switch/Multimeter Reference Manual Section 4: Basic DMM operation 6. Press the TRIG key and observe the display. If the "Overflow" message is displayed, select a higher range until a normal reading is displayed (or press the AUTO key for autoranging). For manual ranging, use the lowest possible range for the best resolution.
  • Page 125: Current Measurements (Dc Current And Ac Current)

    Section 4: Basic DMM operation Series 3700A System Switch/Multimeter Reference Manual Current measurements (DC current and AC current) The Series 3700A can make DC current measurements from 1 pA to 3 A and AC current measurements from 1 mA to 3 A To prevent electric shock, never make or break connections while power is present in the test circuit.
  • Page 126: Autodelay And Autorange Settings

    Series 3700A System Switch/Multimeter Reference Manual Section 4: Basic DMM operation Autodelay and autorange settings The following table provides times for autodelay and autorange time for the Series 3700A DMM current functions. Function Detector Range and delays bandwidth 10 A 100 A 1 mA DC current Not applicable...
  • Page 127: Current Measurement Procedure Through Remote Commands

    Section 4: Basic DMM operation Series 3700A System Switch/Multimeter Reference Manual 7. Press the TRIG key and observe the display. If the "Overflow" message is displayed, select a higher range until a normal reading is displayed (or press the AUTO key for autoranging). For manual ranging, use the lowest possible range for the best resolution.
  • Page 128: Settings Available For Resistance Measurements

    Series 3700A System Switch/Multimeter Reference Manual Section 4: Basic DMM operation Settings available for resistance measurements The following DMM attributes are available for resistance measurements: • aperture (range of 10 µs to 0.250 s for 50 Hz; 8.33 µs to 0.250 s for 60 Hz) •...
  • Page 129: Autodelay And Autorange Settings

    Section 4: Basic DMM operation Series 3700A System Switch/Multimeter Reference Manual Autodelay and autorange settings The following table provides times for autodelay and autorange time for the Series 3700A DMM resistance functions. When measuring resistances that are more than 10 K, cable and Series 3700A card capacitance, along with dielectric absorption, can cause uncertainties, such as low readings.
  • Page 130 Series 3700A System Switch/Multimeter Reference Manual Section 4: Basic DMM operation Figure 49: Two-wire resistance measurements For 4-wire resistance, connect the leads to INPUT HI and LO, and sense 4 HI and LO. Figure 50: Four-wire resistance measurement 3700AS-901-01 Rev. D/June 2018 4-19...
  • Page 131 Section 4: Basic DMM operation Series 3700A System Switch/Multimeter Reference Manual Switching module connections Connections for the switching module are shown below. As shown, each of the 40 channels can be used to perform 2-wire resistance measurements. Figure 51: Two-wire switching module resistance connection For 4-wire resistance measurements, a channel pair is used for each 4-wire measurement, as shown below.
  • Page 132: Resistance Measurements From The Front Panel

    Series 3700A System Switch/Multimeter Reference Manual Section 4: Basic DMM operation Resistance measurements from the front panel Inputs: Do not apply more than 425 V between INPUT HI and LO. Failure to observe this PEAK caution may result in instrument damage. Switching cards: Do not apply more than 300 VDC or 300 V (425 V ) for AC waveforms...
  • Page 133: Resistance Measurements Through Remote Interface

    Section 4: Basic DMM operation Series 3700A System Switch/Multimeter Reference Manual Resistance measurements through remote interface Examples of remote interface measurements setups through the remote interface are shown here. dmm.func = "twowireohms" An automatic delay is applied to each dmm.autodelay = dmm.ON measurement when the DMM is measuring dmm.measurecount = 10 two-wire ohms.
  • Page 134 Series 3700A System Switch/Multimeter Reference Manual Section 4: Basic DMM operation • DMM limit low value (–4294967295 to +4294967295) • line synchronization (dmm.ON or dmm.OFF) • math enable (dmm.ON or dmm.OFF) • math format (dmm.MATH_NONE, dmm.MATH_MXB, dmm.MATH_PERCENT, or dmm.MATH_RECIPROCAL) • math mxb b factor (–4294967295 to +4294967295) •...
  • Page 135: Autodelay And Autorange Settings

    Section 4: Basic DMM operation Series 3700A System Switch/Multimeter Reference Manual Autodelay and autorange settings For the standard RTD values (PT100, D100, F100, PT385, and PT3916), use 1 kΩ. For user-set RTDs, use 1 kΩ or 10 kΩ, depending on the alpha, beta, delta, and R values.
  • Page 136 Series 3700A System Switch/Multimeter Reference Manual Section 4: Basic DMM operation Thermocouple connections Connections for thermocouples are shown below. Thermocouples are color coded to identify the positive (+) and negative (–) leads (see the table). Note that the negative (–) lead for U.S. type T/Cs is red.
  • Page 137 Section 4: Basic DMM operation Series 3700A System Switch/Multimeter Reference Manual The positive lead of the type T thermocouple is made of copper. Therefore, that lead can be connected directly to the input of the switching module (it does not have to be maintained at the simulated reference temperature, in other words, immersed in an ice bath).
  • Page 138: Thermistors

    Series 3700A System Switch/Multimeter Reference Manual Section 4: Basic DMM operation 5. Set THERMO device attributes: ▪ Turn the navigation wheel to scroll to the "THERMO" menu item and press the ENTER key. ▪ Turn the navigation wheel to scroll to the "THERMOCOUPLE" type and press the ENTER key.
  • Page 139 Section 4: Basic DMM operation Series 3700A System Switch/Multimeter Reference Manual Thermistor connections A thermistor can be connected directly to the analog backplane connector or to any of the applicable input channels of a thermistor-capable switching module. Figure 56: Thermistor analog backplane connection Figure 57: Thermistor switching module connection Thermistor measurement from the front panel To configure thermistor measurements from the front panel:...
  • Page 140: Rtds (Resistance Temperature Detectors)

    Series 3700A System Switch/Multimeter Reference Manual Section 4: Basic DMM operation Thermistor measurement through the remote interface This sample remote code configures a thermistor type 2252 and assigns it to a 4-channel scan list. reset() dmm.func=dmm.TEMPERATURE dmm.transducer= dmm.TEMP_THERMISTOR -- or 2 dmm.thermistor=2.252e3 dmm.units=dmm.UNITS_FAHRENHEIT -- or 4...
  • Page 141 Section 4: Basic DMM operation Series 3700A System Switch/Multimeter Reference Manual 3-wire RTD connections Shown below are 3-wire RTD connections to the Series 3700A. For a 3-wire RTD capable 40-channel switching module, paired channels perform the 3-wire measurement. For example, the two input leads of the RTD are connected to a primary channel (1 through 20), while only the LO sense lead is connected to its paired channel (21 through 40).
  • Page 142 Series 3700A System Switch/Multimeter Reference Manual Section 4: Basic DMM operation Figure 60: Four-wire RTD connections Figure 61: Four-wire RTD switching module connections RTD temperature measurement configuration The alpha, beta, delta, and Ω at 0 °C parameters for the five basic RTD types are provided in the table below.
  • Page 143 Section 4: Basic DMM operation Series 3700A System Switch/Multimeter Reference Manual RTD measurement from the front panel To configure 3 or 4-wire RTD measurements from the front panel: 1. If needed, change to the temperature function (TMP is displayed) by pressing the FUNC key. 2.
  • Page 144: Temperature Equations

    Series 3700A System Switch/Multimeter Reference Manual Section 4: Basic DMM operation For example, the following remote commands configure temperature function to a custom RTD and assign it to a 10-channel scan list. reset() dmm.func=dmm.TEMPERATURE -- or 3, or dmm.TEMP_FOURRTD, or 4 dmm.transducer= dmm.TEMP_THREERTD -- dmm.fourrtd also supported dmm.threertd=dmm.RTD_USER...
  • Page 145 Section 4: Basic DMM operation Series 3700A System Switch/Multimeter Reference Manual Type B inverse function polynomial 250 ºC to 700 ºC 700º C to 1,820 ºC (291 µV to 2,431 µV) (2,431 µV to 13,820 µV) 9.842 332 1 × 10 2.131 507 1 1 ×...
  • Page 146 Series 3700A System Switch/Multimeter Reference Manual Section 4: Basic DMM operation Type J inverse function polynomial –210 °C to 0 °C 0 °C to 760 °C 760 °C to 1,200 °C (–8,095 µV to 0 µV) (0 µV to 42,919 µV) (42,919 µV to 69,553 µV) –3.113 581 87 ×...
  • Page 147 Section 4: Basic DMM operation Series 3700A System Switch/Multimeter Reference Manual Type N inverse function polynomial –200 °C to 0 °C (–3,990 µV to 0 °C to 600 °C 600 °C to 1,300 °C 0 µV) (0 µV to 20,613 µV) (20,613 µV to 47,513 µV) 1.972 485 ×...
  • Page 148 Series 3700A System Switch/Multimeter Reference Manual Section 4: Basic DMM operation Type S inverse function polynomial –50 °C to 250 °C (-235 250 °C to 1,200 °C 1,064 °C to 1,664.5 °C 1,664.5 °C to 1,768.1 µV to 1,874 µV) (1,874 µV to (10,332 µV to °C (17,536 µV to...
  • Page 149 2. Compare the A, B, and C constants from the thermistor manufacturer with those used by the Series 3700A (see Thermistor equation (on page 4-38)). Series 3700A specifications are available for download from the Keithley Product Support web page (https://www.tek.com/product-support). 3. Select a thermistor that closely matches the A, B, and C constants in Thermistor equation page 4-38).
  • Page 150 Series 3700A System Switch/Multimeter Reference Manual Section 4: Basic DMM operation Example Calculate the temperature for a Series 44007 thermistor that measures 5 kΩ (R): lnR = ln(5000) = 8.5172 A = 0.001288 B = 0.0002356 C = 9.557e-8 = 1 / {A + (BlnR) + [(C)(lnR) = 1 / {0.001288 + [(0.0002356)(8.5172)] + [(9.557e-8)(8.5172 = 1 / (0.001288 + 0.002007 + 0.000059) = 1 / 0.003354...
  • Page 151 Section 4: Basic DMM operation Series 3700A System Switch/Multimeter Reference Manual Equation for 0 °C to 630 °C temperature range (1 + AT + BT Where: = The calculated resistance of the RTD = The known RTD resistance at 0 °C T = The temperature in °C A = Alpha [1 + (delta/100)] B = –1 (alpha)(delta)(1e-4)
  • Page 152: Frequency And Period Measurements

    Series 3700A System Switch/Multimeter Reference Manual Section 4: Basic DMM operation Example 2 Calculate the resistance of a D100 RTD at –100 °C (T). The following R (Ω at 0 °C), alpha, beta, and delta values are used for the D100 RTD: T = –100 °C R0 (Ω...
  • Page 153: Settings Available For Frequency And Period Measurements

    Section 4: Basic DMM operation Series 3700A System Switch/Multimeter Reference Manual Settings available for frequency and period measurements • aperture (range of 0.01 s to 0.273 s) • autodelay (dmm.AUTODELAY_ONCE, dmm.ON or dmm.OFF) • autozero (dmm.AUTOZERO_ONCE, dmm.ON or dmm.OFF) • display digits (3, 4, 5, 6, or 7) •...
  • Page 154: Gate Time

    Series 3700A System Switch/Multimeter Reference Manual Section 4: Basic DMM operation Gate time The gate time is the amount of time the Series 3700A uses to sample frequency or period readings. The gate time can be set from 0.01 to 0.273 s by setting the DMM aperture attribute. The Series 3700A completes a reading when it receives its first positive zero-crossing after the gate time expires.
  • Page 155: Frequency And Period Measurement Procedure Through Remote Interface

    Section 4: Basic DMM operation Series 3700A System Switch/Multimeter Reference Manual 1. Press the OPENALL key to open all switching channels. 2. Select the CONFIG key, and then select the DMM key. Select the FUNC menu by pressing ENTER. Scroll through the menu until FREQ or PERIOD is displayed, using the navigation wheel or left right arrows.
  • Page 156: Settings Available For Continuity Testing

    Series 3700A System Switch/Multimeter Reference Manual Section 4: Basic DMM operation Settings available for continuity testing • autodelay (dmm.AUTODELAY_ONCE, dmm.ON or dmm.OFF) • display digits (3, 4, 5, 6, or 7) • line synchronization (dmm.ON or dmm.OFF) • math enable (dmm.ON or dmm.OFF) •...
  • Page 157: Continuity Testing Procedure

    Section 4: Basic DMM operation Series 3700A System Switch/Multimeter Reference Manual Connections to test continuity using a switching module are shown below. Because this is a 2-wire ohm measurement, channels 1 through 40 of a 40-channel switching module can be used. Figure 65: Continuity connections using a switching module Continuity testing procedure If the Series 3700A is in remote, place the instrument in local by pressing the LOCAL key (or the...
  • Page 158: Refining Measurements

    Series 3700A System Switch/Multimeter Reference Manual Section 4: Basic DMM operation Limits and digital outputs cannot be used when testing continuity with the continuity (CNT) function. If you need to use these operations, use the 2W function to test continuity. Also see the bus command dmm.threshold (on page 11-232) for more information on threshold attributes.
  • Page 159 Section 4: Basic DMM operation Series 3700A System Switch/Multimeter Reference Manual To set and enable a relative offset through the front panel manually: 1. Select the measurement function and an appropriate range setting. 2. If you are using a switching module, close the input channel (see Front-panel key menu options (on page 3-13) for basic information about the front-panel user interface).
  • Page 160: Math Calculations

    Series 3700A System Switch/Multimeter Reference Manual Section 4: Basic DMM operation Scanning When a scan is configured, each channel can have its own unique relative offset value. For remote programming, the channel list parameter is used to configure channels for a scan. For example: To attach a 1 µV relative offset level to a configuration, send the following commands: -- Select DC volts function.
  • Page 161 Section 4: Basic DMM operation Series 3700A System Switch/Multimeter Reference Manual mx+b The mx+b math operation lets you manipulate normal display readings (x) mathematically based on the following calculation: mx + b = Y Where: • m is a user-defined constant for the scale factor •...
  • Page 162 Series 3700A System Switch/Multimeter Reference Manual Section 4: Basic DMM operation Set mX+b units through the remote interface You can set mX+b units through the remote interface with the command dmm.math.mxb.units. The attribute for dmm.math.mxb.units must be one character enclosed in single or double quotes. It can be any letter of the alphabet, the degrees symbol (°), the micro symbol (µ), or the ohms symbol (Ω).
  • Page 163 Section 4: Basic DMM operation Series 3700A System Switch/Multimeter Reference Manual Percent The percent math function displays measurements as percent deviation from a specified reference constant. The percent calculation is: Where: • Percent = The result • Input = The measurement (if relative offset is being used, this is the relative offset value) Reference = The user-specified constant The result of the percent calculation is positive when the input is more than the reference.
  • Page 164 Series 3700A System Switch/Multimeter Reference Manual Section 4: Basic DMM operation You can use the relative offset used to set the percent as follows: -- Sets percent with relative offset acquire value. dmm.math.percent = dmm.rel.acquire() -- Send the result of relative offset acquire to a computer. print(dmm.math.percent) Reciprocal (1/X) You can set math operation to reciprocal to display the reciprocal of a reading.
  • Page 165: Db Commands

    Section 4: Basic DMM operation Series 3700A System Switch/Multimeter Reference Manual dB commands Expressing DC or AC voltage in decibels (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: : DC or AC input signal.
  • Page 166: Range

    Series 3700A System Switch/Multimeter Reference Manual Section 4: Basic DMM operation Range You can use the range to set an expected measurement value. The instrument will select the range appropriate to measure that value. If you set a range, the autorange feature is automatically disabled. The instrument selects the range to best match the expected measure value for the functions, as shown below.
  • Page 167 Section 4: Basic DMM operation Series 3700A System Switch/Multimeter Reference Manual Select a range from the front panel To change the range for the active DMM function, press the RANGE ▲ or ▼ key. The instrument changes one range value of the active function for each key press. The selected range is displayed in the attribute list on the second line of the front panel display.
  • Page 168: Optimizing Measurement Speed

    Series 3700A System Switch/Multimeter Reference Manual Section 4: Basic DMM operation Scanning Each channel of scan configuration can be associated with a unique digital multimeter (DMM) configuration (which includes a range setting). When a scan completes, the DMM remains in the configuration associated with the last completed measurement step.
  • Page 169 Section 4: Basic DMM operation Series 3700A System Switch/Multimeter Reference Manual You can use unique rate settings for each function when using the front panel or the remote interface. Rate cannot be set for continuity. The continuity rate is fixed at 0.006 PLC. The Series 3700A uses internal references to calculate an accurate and stable reading.
  • Page 170 Series 3700A System Switch/Multimeter Reference Manual Section 4: Basic DMM operation Bandwidth There are three bandwidth settings for AC volt and AC current measurements. The setting determines the bandwidth setting as follows: • SLOW: 3 Hz to 30 Hz • MEDium: 30 Hz to 300 Hz •...
  • Page 171: Optimizing Ac Voltage And Current Measurements

    Section 4: Basic DMM operation Series 3700A System Switch/Multimeter Reference Manual AC voltage and AC current optimize speed Select: • dmm.detectorbandwidth=300 • dmm.autodelays=dmm.OFF • dmm.autozero=dmm.OFF • dmm.autorange=dmm.OFF • dmm.filter=dmm.OFF • dmm.nplc=0.0005 Temperature optimize measurement speed Select: • dmm.transducer=dmm.TEMP_THERMOCOUPLE • dmm.opendetector=dmm.OFF •...
  • Page 172: Optimizing Measurement Accuracy

    Series 3700A System Switch/Multimeter Reference Manual Section 4: Basic DMM operation Optimizing measurement accuracy The following two charts represent root-mean-square (RMS) noise versus aperture time (or NPLC) and reading rate versus aperture time (or NPLC). Refer to these charts when selecting best accuracy at a given reading rate.
  • Page 173 Section 4: Basic DMM operation Series 3700A System Switch/Multimeter Reference Manual DC voltage, DC current, and resistance measurement accuracy To optimize measurement accuracy: • 1 or 5 NPLC, filter off, fixed range. • Use relative offset on DC voltage and 2-wire resistance measurements when appropriate. •...
  • Page 174 Series 3700A System Switch/Multimeter Reference Manual Section 4: Basic DMM operation To minimize pick-up, keep the voltage source and the Series 3700A away from strong AC magnetic sources. The voltage induced due to magnetic flux is proportional to the area of the loop formed by the input leads.
  • Page 175 Section 4: Basic DMM operation Series 3700A System Switch/Multimeter Reference Manual Resistance Optimizing low ohm measurement and speed When measuring resistance of 100 Ω or less, cable, connectors, and Series 3700A switch cards can have thermal offsets, which can result in additional reading uncertainties. Autodelays for 100 Ω...
  • Page 176 Series 3700A System Switch/Multimeter Reference Manual Section 4: Basic DMM operation Dry circuit ohms measurement considerations Dry circuit ohms uses a constant-current source with voltage monitoring that is used to clamp the current source voltage. The current source remains constant as long as the monitoring voltage is less than 20 mV.
  • Page 177 Section 4: Basic DMM operation Series 3700A System Switch/Multimeter Reference Manual Enable or disable dry circuit ohms through the remote interface To enable dry circuit ohms through the remote interface, send the commands: dmm.func = "fourwireohms" dmm.drycircuit = dmm.ON To disable dry circuit ohms through the remote interface, send the command: dmm.drycircuit = dmm.OFF Performing dry circuit ohms measurements Make sure you use four-wire connections to the DUT as detailed in...
  • Page 178 Series 3700A System Switch/Multimeter Reference Manual Section 4: Basic DMM operation Offset-compensated ohms The presence of thermoelectric EMFs (V ) can adversely affect low-resistance measurement accuracy. To overcome these unwanted offset voltages, you can use offset-compensated ohms. Offset-compensated ohms measurements can be performed on the 1 Ω, 10 Ω, 100 Ω, 1 kΩ, and 10 kΩ...
  • Page 179 Section 4: Basic DMM operation Series 3700A System Switch/Multimeter Reference Manual The Series 3700A is in 4-wire ohm mode when 4W is displayed. Offset compensation is active when the OC+ is displayed (OC- is shown in the above figure). 1. Set the Series 3700A for the 4-wire ohm measurement function. 2.
  • Page 180 Series 3700A System Switch/Multimeter Reference Manual Section 4: Basic DMM operation The offset-compensated ohms setting is saved with the measurement function. If you change measurement functions, then return to the previous function, the offset-compensated ohms will be at the same setting it was previously. dmm.offsetcompensation is a common command and is shared with fourwireohms, drycircuit, threertd and fourrtd.
  • Page 181 Section 4: Basic DMM operation Series 3700A System Switch/Multimeter Reference Manual Repeating average filter The repeating filter takes a specified number of conversions, averages them, and yields a filtered reading. It then clears its stack and starts over. This setting is useful when scanning because readings for other channels are not averaged with the present channel.
  • Page 182 Series 3700A System Switch/Multimeter Reference Manual Section 4: Basic DMM operation Figure 74: Filter window 3700AS-901-01 Rev. D/June 2018 4-71...
  • Page 183 If using ºF units, a 20% filter window is calculated as follows: 9/5 x 20 = 36. The filter window for the 20% window is ±36 ºC. Filtering considerations Because channels may have large differences in signal levels, Keithley recommends using the ® following Test Script Processor (TSP ) command with Series 3700 cards: dmm.filter.type = dmm.FILTER_REPEAT_AVE or 1...
  • Page 184: Switching And Scanning

    To install the switching card, refer to instructions in the Series 3700A Quick Start Guide. For detailed information about the Series 3700A switch cards, refer to the Series 3700A Switch and Control Cards Reference Manual (Keithley part number 3700AS-909-01). The switching channels of a Series 3700A have specific settings for switch-only operations and specific settings for switch with DMM operations.
  • Page 185: Maximum Power Usage With Series 3700A Cards

    Empty Slot Maximum power usage with Series 3700A cards The Series 3700A series offers a growing family of high-density and general-purpose plug-in cards that accommodates a broad range of signals at very competitive pricing. The Series 3700A supports applications as diverse as design validation, accelerated stress testing, data acquisition, and functional testing.
  • Page 186: Specifying A Channel

    Series 3700A System Switch/Multimeter Reference Manual Section 5: Switching and scanning Specifying a channel The channels on the cards that you can use with the Series 3700A are referred to by a channel specifier. You will use the specifier to identify channels for use with close and open operations, scans, and channel patterns.
  • Page 187 Section 5: Switching and scanning Series 3700A System Switch/Multimeter Reference Manual Analog backplane relay channel specifiers The channels for slots with analog backplane relays are referred to by their slot, backplane, bank, and relay numbers: • Slot number: The number of the slot. •...
  • Page 188: Close And Open Channel Operations And Commands

    Series 3700A System Switch/Multimeter Reference Manual Section 5: Switching and scanning Close and open channel operations and commands Switching channels have specific settings for switch-only operations and specific settings for switch with DMM operations. For switch-only operation, there are three close methods and one open method.
  • Page 189 Section 5: Switching and scanning Series 3700A System Switch/Multimeter Reference Manual Figure 75: Two-wire function The following figure shows an example of how the channel and its paired channel are connected to the DMM Input and Sense terminals of the Series 3700A for a 4-wire DMM operation. Assume a switching module with 20 channels is installed in Slot 1 of the mainframe, and a 4-wire function, such as 4Ω, is selected.
  • Page 190 Series 3700A System Switch/Multimeter Reference Manual Section 5: Switching and scanning Selecting, closing, and opening channels You can use the channel specifiers to select channels from the front panel, web interface, or over a remote command interface. The methods for closing and opening channels include: •...
  • Page 191 Section 5: Switching and scanning Series 3700A System Switch/Multimeter Reference Manual 7. The display shows the current state of the selected channel in the bottom row . In this example, the channel is open and 2-pole (if you see : followed by a channel specifier, you selected a range; press EXIT to return to the main display and reselect your channel).
  • Page 192 Series 3700A System Switch/Multimeter Reference Manual Section 5: Switching and scanning Figure 79: Web interface cards list 3. To close a channel, click the channel. The display of the channel depends on the card that you have installed. Some examples are shown here. Figure 80: Selecting, closing, and opening a channel from the web interface Figure 81: Selecting, closing, and opening a channel from the web interface 3700AS-901-01 Rev.
  • Page 193 Section 5: Switching and scanning Series 3700A System Switch/Multimeter Reference Manual Figure 82: Close a channel 4. To open a closed channel, click it again. 5. To perform an exclusive close on a channel: Select Exclusive Slot Close in the Channel Action Type box. (Note that the DMM close option shown here is only available for instruments with the DMM feature installed.) Figure 83: Selecting, closing, and opening a channel from the web interface Click a channel to close that channel and open all other channels.
  • Page 194 Series 3700A System Switch/Multimeter Reference Manual Section 5: Switching and scanning Channel list parameter for remote commands The channel list parameter is a string-type parameter that is used when controlling the relays of the Series 3700A using a remote command interface. You can specify a list of individual channels or a range of channels in the channel list parameter.
  • Page 195 Section 5: Switching and scanning Series 3700A System Switch/Multimeter Reference Manual When the response is a comma-delimited string, the individual return items can be identified by iterating through the list using the comma delimiters. For example, the Lua code below will start at the beginning of a string and break the string into individual items at each comma.
  • Page 196: Working With Channels

    Series 3700A System Switch/Multimeter Reference Manual Section 5: Switching and scanning 8. Press the navigation wheel to return to the main display after selecting the user configuration for the channel range. 9. Press the CONFIG key followed by the CHAN key to change other channel attributes for the range.
  • Page 197 Section 5: Switching and scanning Series 3700A System Switch/Multimeter Reference Manual You can set the channel connect rule to be: • BBM (break before make): The instrument ensures that all switch channels open before any switch channels close. It is used to avoid momentary shorting of two voltage sources. This is the default.
  • Page 198 Series 3700A System Switch/Multimeter Reference Manual Section 5: Switching and scanning You incur settling times at each close or open operation. If sequential connection is not selected, action settling times may vary depending on the card type. The total settling time is the sum of the settling times for each specified channel, plus any user delays that have been set for any closed channels.
  • Page 199: Determining The Number Of Relay Closures

    Section 5: Switching and scanning Series 3700A System Switch/Multimeter Reference Manual Determining the number of relay closures The Series 3700A keeps an internal count of the number of times each switching card relay has been closed. The total number of relay closures is stored in nonvolatile memory on the switching card. Use this count to determine when relays require replacement (see the card documentation for information regarding the contact life specifications).
  • Page 200: Channel Attributes

    Series 3700A System Switch/Multimeter Reference Manual Section 5: Switching and scanning For a four-pole operation, the paired channel is not displayed on the front panel. Viewing status from the remote command interface To view a list of closed channels, use the channel.getclose() command. For example: print(channel.getclose("allslots")) To view the close and open status of channels, use the channel.getstate() command.
  • Page 201 Section 5: Switching and scanning Series 3700A System Switch/Multimeter Reference Manual To set additional delay time from the web interface: 1. From the list on the left, select the slot that contains the channel for which you want to set an additional delay.
  • Page 202: Channel Patterns

    Series 3700A System Switch/Multimeter Reference Manual Section 5: Switching and scanning To set up labels from the front panel: 1. Display a channel (you might need to press DISPLAY first). 2. Select the channel for which you want to set labels. 3.
  • Page 203 Section 5: Switching and scanning Series 3700A System Switch/Multimeter Reference Manual Assigning channel pattern attributes A channel pattern has only two attributes: the channel pattern name and a DMM configuration. An error occurs if you attempt to assign or query any channel attributes other than DMM configuration for a channel pattern.
  • Page 204 Series 3700A System Switch/Multimeter Reference Manual Section 5: Switching and scanning When naming the channel pattern, be aware: • The first character of the name must be alphabetic (upper or lower case) • Names are case sensitive • Pattern names must be different than channel labels Performing close and open operations on channel patterns Careless channel pattern operation could create an electric shock hazard that could result in severe injury or death.
  • Page 205: Reset A Channel

    Section 5: Switching and scanning Series 3700A System Switch/Multimeter Reference Manual Reset a channel You can reset a channel to its factory default settings. When you reset a channel: ▪ Any closed channels and analog backplane relays open ▪ The poles of all channels reset to 2-pole operation and paired channels are changed to match ▪...
  • Page 206: Pseudocards Programming Example

    If you use the front panel, key presses determine the order of the scan. The Keithley Instruments Series 3700A can scan channels with up to six Keithley Instruments switching cards installed. Each scan channel can have its own unique setup. Aspects of operation that may be uniquely set for each channel include function, range, rate, AC bandwidth, relative offset (REL), filter, digits, math, offset compensation, temperature transducers, limits, volts dB, and so on.
  • Page 207: Trigger Model

    Section 5: Switching and scanning Series 3700A System Switch/Multimeter Reference Manual Trigger model When you run a scan, the scan sequence follows a trigger model. The trigger model is shown in the following flowchart. In Series 3700A, only scanning operations use the trigger model. Individual open, close, and measure commands do not affect the trigger model.
  • Page 208: Scan And Step Counts

    Series 3700A System Switch/Multimeter Reference Manual Section 5: Switching and scanning Trigger model components The individual components of the trigger model are explained in the following paragraphs. Trigger model events and associated commands The Series 3700A trigger model has the following events and associated command attributes. These events, along with other events in the system, may be used to configure various stimulus settings.
  • Page 209: Basic Scan Procedure

    Section 5: Switching and scanning Series 3700A System Switch/Multimeter Reference Manual For example: • 1003:1005 will add Channels 1003, 1004, and 1005 to the list as three distinct steps, with Channel 3 added first, Channel 4 added second, and Channel 5 added third. •...
  • Page 210 Series 3700A System Switch/Multimeter Reference Manual Section 5: Switching and scanning 8. To abort the scan: ▪ Front panel: Press the EXIT key. ▪ Remote interface: Use the scan.abort() command. Even if the scan is aborted, the DMM remains as configured in the last completed step of a scan that involved measuring and channel states match the aborted state of channels in terms of which are closed and opened.
  • Page 211 Section 5: Switching and scanning Series 3700A System Switch/Multimeter Reference Manual For example, a scan list is comprised of Channels 1 to 60 on a Model 3720 card with the channels configured to measure DC volts. Changing Channels 1 to 30 to be configured for 4-wire ohms measurements causes the scan list to change.
  • Page 212 Series 3700A System Switch/Multimeter Reference Manual Section 5: Switching and scanning Front-panel scanning After channels have been added to the scan list, press the SCAN key to display the SCAN ACTION MENU. If no scan list exists, pressing the SCAN key will briefly display "No Scan List. Use INSERT to add selection."...
  • Page 213: Remote Interface Scanning

    Section 5: Switching and scanning Series 3700A System Switch/Multimeter Reference Manual Include multiple channels in a single scan step Through the remote control interface, you can use scan.addimagestep to combine a list of channels into a scan step. The following example creates five scan steps with the indicated channels. scan.create() scan.addimagestep("1006,1007") scan.addimagestep("1010,1011")
  • Page 214: Hardware Trigger Modes

    (on page 11-336) Hardware trigger modes Use the hardware trigger modes to integrate Keithley Instruments and non-Keithley instruments into an efficient test system. The hardware synchronization lines are classic trigger lines. The Series 3700A contains 14 digital I/O lines and three TSP-Link synchronization lines that you can use for input or output triggering.
  • Page 215 Section 5: Switching and scanning Series 3700A System Switch/Multimeter Reference Manual A trigger overrun generates if an input trigger is received before the previous input trigger processes. To determine if a trigger overrun has occurred, reference the trigger overrun attributes. For additional information on the hardware trigger modes, see TSP commands (on page 11-8).
  • Page 216 Use the rising edge master (RisingM) trigger mode (see the figure titled "RisingM output trigger") 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.
  • Page 217 Section 5: Switching and scanning Series 3700A System Switch/Multimeter Reference Manual Output characteristics: • In addition to trigger events from other trigger objects, the digio.trigger[N].assert() and tsplink.trigger[N].assert() commands generate a low pulse that is similar to the falling edge trigger mode. Figure 89: RisingA output trigger Either edge trigger mode The either edge trigger mode generates a low pulse and detects both rising and falling edges.
  • Page 218: Understanding Synchronous Triggering Modes

    In this mode, the output trigger consists of a low pulse. All non-Keithley instruments attached to the synchronization line in a trigger mode equivalent to SynchronousA must latch the line low during the pulse duration.
  • Page 219 Section 5: Switching and scanning Series 3700A 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 is not detected until all external drives release the line and the line floats high. Figure 92: Synchronous master input trigger Output characteristics: •...
  • Page 220 Series 3700A System Switch/Multimeter Reference Manual Section 5: Switching and scanning Synchronous acceptor trigger mode (SynchronousA) Use the synchronous acceptor trigger mode (SynchronousA) with the SynchronousM trigger mode. The roles of the internal and external drives are reversed in the SynchronousA trigger mode. Input characteristics: •...
  • Page 221 Series 3700A System Switch/Multimeter Reference Manual Synchronous trigger mode The synchronous trigger mode is a combination of SynchronousA and SynchronousM trigger modes. Keithley Instruments recommends using SynchronousA and SynchronousM modes only. Input characteristics: • The falling edge generates an input event and latches the internal drive low.
  • Page 222: Events

    Series 3700A System Switch/Multimeter Reference Manual Section 5: Switching and scanning Events Event detectors monitor an event. They have one input signal (the stimulus), which is the event that they monitor (in some cases, the stimulus is an action in the system, like a timer expiring or a key press).
  • Page 223: Lxi Class B And C Triggering (Ieee-1588)

    Section 5: Switching and scanning Series 3700A System Switch/Multimeter Reference Manual LXI Class B and C triggering (IEEE-1588) Introduction to IEEE-1588 based triggering The Series 3700A uses IEEE-1588 precision time protocol (PTP) to implement synchronized measurements and initiate time-triggered events over the LAN (ethernet) interface. IEEE-1588 is a requirement of the LXI B and C Functional Classes.
  • Page 224 Series 3700A System Switch/Multimeter Reference Manual Section 5: Switching and scanning UTC suffers from discontinuities because of nonperiodic adjustments known as “leap seconds." These adjustments present problems because they can make events that occurred at different periods of time appear to occur at the same time. PTP is a time standard that does not have any discontinuities and has no adjustments for local time (that is, it is not time-zone aware).
  • Page 225 Section 5: Switching and scanning Series 3700A System Switch/Multimeter Reference Manual Use the ptp.enable (on page 11-305) attribute to enable IEEE-1588 on the Series 3700A. The IEEE- 1588 protocol then determines the master clock. The IEEE-1588 indicator on the front panel of the Series 3700A updates to display the IEEE-1588 status.
  • Page 226 Series 3700A System Switch/Multimeter Reference Manual Section 5: Switching and scanning LXI event log The LXI event log of a Series 3700A 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 an LXI event log and a description of the log fields in order of appearance.
  • Page 228: Reading Buffers

    Buffer overview Reading buffers capture measurements, channels or channel patterns, instrument status, and measure functions of the Keithley Instruments Series 3700A. The Series 3700A uses synchronous reading acquisitions to take readings for a dynamically-created reading buffer. The instrument stores the numbered readings that are acquired during the storage process.
  • Page 229: Front-Panel Buffer Operation

    Section 6: Reading buffers Series 3700A System Switch/Multimeter Reference Manual You cannot use top-level command names and reserved words as buffer names. These names are listed in the following table. Top level command names function reset beeper gettimezone return gpib scan break schedule...
  • Page 230 Series 3700A System Switch/Multimeter Reference Manual Section 6: Reading buffers Creating and selecting a reading buffer New reading buffers are automatically selected. To create a new reading buffer: 1. Press the STORE key. 2. Select CREATE from the buffer choices and press the ENTER key. 3.
  • Page 231 Section 6: Reading buffers Series 3700A System Switch/Multimeter Reference Manual Stored readings are lost when the instrument is turned off. To save your stored readings, see Saving readings (on page 6-4). Saving readings When saving readings to a USB flash drive, you must select a non-empty reading buffer. See Selecting a reading buffer (on page 6-3) for more information.
  • Page 232 Series 3700A System Switch/Multimeter Reference Manual Section 6: Reading buffers Recalling readings When recalling readings, you must select a reading buffer that is not empty. See Selecting a reading buffer (on page 6-3) for more information. Readings stored in the buffer are displayed by pressing the REC key. Turn the navigation wheel use the CURSOR keys to cycle through the buffer's contents.
  • Page 233: Remote Buffer Operation

    Section 6: Reading buffers Series 3700A System Switch/Multimeter Reference Manual Buffer configuration (front panel) When configuring the buffer through the front panel, you must select a reading buffer. See Selecting a reading buffer (on page 6-3) for more information. To configure a buffer from the front panel: 1.
  • Page 234 Series 3700A System Switch/Multimeter Reference Manual Section 6: Reading buffers To delete a dynamically allocated buffer, use the command bufferVar = nil. Command Description dmm.appendbuffer() Creates a file on a USB flash drive if it doesn't already exist. If the file already exists on the flash drive, it will be overwritten.
  • Page 235 Section 6: Reading buffers Series 3700A System Switch/Multimeter Reference Manual Reading buffer designations To access the buffer, include the buffer attribute in the respective command. For example, the following commands store five readings from the DMM into a buffer named readingbuffer: -- Sets how many readings to take with the dmm.measure command.
  • Page 236 Series 3700A System Switch/Multimeter Reference Manual Section 6: Reading buffers Buffer read-only attributes Use buffer read-only attributes to access the information contained in an existing buffer. The following attributes are available per reading buffer (for example, rb.basetimeseconds would access basetimeseconds for reading buffer rb, and the number of readings the reading buffer can store is accessed as rb.capacity).
  • Page 237 Section 6: Reading buffers Series 3700A System Switch/Multimeter Reference Manual Buffer reading attributes The table in Buffer recall attributes (on page 6-10) lists the attributes that control which elements are recalled from the buffer. To access specific elements, append the attribute to the buffer designation. For example, the following command line returns 100 readings from readingbuffer1: printbuffer(1, 100, readingbuffer1.readings) Similarly, the following command line returns 100 channel values from readingbuffer1:...
  • Page 238 Series 3700A System Switch/Multimeter Reference Manual Section 6: Reading buffers Recall attribute Description formattedreadings An array (a Lua table) of strings indicating the formatted reading as viewed on the display. ptpseconds An array (a Lua table) of the seconds portion of the timestamp of when the reading was stored.
  • Page 239 Section 6: Reading buffers Series 3700A System Switch/Multimeter Reference Manual Time and date values Time and date values are represented as a number of UTC seconds since 12:00 a.m. Jan. 1, 1970. The os.time() command returns values in this format. Use os.date() to return values in month, day, year, hours, and minutes format, or to access the timestamp table.
  • Page 240 Series 3700A System Switch/Multimeter Reference Manual Section 6: Reading buffers Example 3 To see if the high limit 1 was exceeded during the reading: stat_info = readingbuffer.statuses[3] if (bit.bitand(stat_info, dmm.buffer.LIMIT1_HIGH_BIT) == dmm.buffer.LIMIT1_HIGH_BIT) then print("Limit 1 high exceeded") else print("Limit 1 high okay") Dynamic buffer programming example The programming example below shows how to store data using a dynamically allocated buffer named mybuff.
  • Page 241 Section 6: Reading buffers Series 3700A System Switch/Multimeter Reference Manual Sample comma-delimited output of above code: 3.535493836e-002, Volts DC, 0.000000000e+000 -4.749810696e-002, Volts DC, 5.730966000e-002 -8.893087506e-002, Volts DC, 7.722769500e-002 4.164193198e-002, Volts DC, 1.246876800e-001 -6.900507957e-002, Volts DC, 1.815213600e-001 -8.851423860e-002, Volts DC, 2.009161500e-001 3.891038895e-002, Volts DC, 2.647790700e-001 -7.581630349e-002, Volts DC, 3.032140350e-001 -8.236359060e-002, Volts DC, 3.226125750e-001...
  • Page 242 Series 3700A System Switch/Multimeter Reference Manual Section 6: Reading buffers 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.218081926e-002, 2002+, 3.419026595e-002, 2003+ -3.856921662e-002, 2001+, -6.672781529e-002, 2002+, -7.762540017e-002,...
  • Page 243 Section 6: Reading buffers Series 3700A System Switch/Multimeter Reference Manual The code for the previous example follows: -- Create a buffer named buf and allocate space for 50 readings. buf = dmm.makebuffer(50) -- Enable append buffer mode. buf.appendmode = 1 -- Set count to 30.
  • Page 244: Maintenance

    Section 7 Maintenance In this section: Introduction ................7-1 Fuse replacement ..............7-1 AMPS analog backplane fuse replacement ......7-2 Front panel tests ..............7-3 Displaying the instrument's serial number ........ 7-4 Upgrading the firmware ............7-5 Introduction This section provides maintenance information and procedures that can be done by the operator. Fuse replacement The analog backplane AMPS fuse (see item 1 in Fuse location figure) is accessible from the rear panel, just below the analog backplane connector.
  • Page 245: Amps Analog Backplane Fuse Replacement

    4. Reinstall the fuse holder. If a fuse continues to become damaged, a circuit malfunction exists and must be corrected. Return the instrument to Keithley Instruments for repair. AMPS analog backplane fuse replacement Make sure the instrument is disconnected from the power line and other equipment before replacing the AMPS fuse.
  • Page 246: Front Panel Tests

    Series 3700A System Switch/Multimeter Reference Manual Section 7: Maintenance Front panel tests You can test the functionality of the front panel keys and the display. Test procedure This procedure tests the functionality of each front-panel key and the display. To run the test: 1.
  • Page 247: Display Patterns Test

    Section 7: Maintenance Series 3700A System Switch/Multimeter Reference Manual 6. To test the EXIT (LOCAL) key, press the EXIT (LOCAL) key once. 7. To exit the test, press the EXIT (LOCAL) key twice consecutively. You will exit the test and the instrument returns to the FRONT PANEL TESTS menu.
  • Page 248: Upgrading The Firmware

    Series 3700A System Switch/Multimeter Reference Manual Section 7: Maintenance Upgrading the firmware Use this procedure to upgrade or downgrade the Series 3700A firmware from a USB flash drive using a file. The process should take approximately five minutes, depending on the cards in the system and if a digital multimeter (DMM) is installed.
  • Page 249: Upgrading Or Downgrading Using The Remote Interface

    Section 7: Maintenance Series 3700A System Switch/Multimeter Reference Manual Upgrading or downgrading using the remote interface You can upgrade or revert to a previous version of firmware by sending the remote interface command upgrade.unit() (on page 11-446) or upgrade.previous() (on page 11-446). When you send either of these functions, the instrument searches the USB flash drive in the front-panel USB port for an upgrade or downgrade file.
  • Page 250: Upgrading Or Downgrading Firmware Using Test Script Builder

    Series 3700A System Switch/Multimeter Reference Manual Section 7: Maintenance Upgrading or downgrading firmware using Test Script Builder Do not turn off power or remove the USB flash drive until the upgrade process is complete. You can use Test Script Builder (TSB) to upgrade the firmware of your instrument. To upgrade the firmware using Test Script Builder: 1.
  • Page 252: Theory Of Operation

    Section 8 Theory of operation In this section: Rear panel, backplane, and DMM connect relays schematic ... 8-1 Line cycle synchronization ............8-2 AC voltage measurements and crest factor ......8-5 DMM resistance measurement methods ........8-7 Reference junctions ............... 8-11 Open lead detection ...............
  • Page 253: Line Cycle Synchronization

    Section 8: Theory of operation Series 3700A System Switch/Multimeter Reference Manual Figure 101: Rear panel to backplane to DMM connect relays schematic Line cycle synchronization Synchronizing A/D conversions with the frequency of the power line increases common mode and normal mode noise rejection. When line cycle synchronization is enabled, the measurement is initiated at the first positive-going zero crossing of the power line cycle after the trigger.
  • Page 254 Series 3700A System Switch/Multimeter Reference Manual Section 8: Theory of operation Line synchronization is not available for the AC functions (ACV, ACI, FREQ, or PERIOD). Line synchronization can be enabled for any DC function and any NPLC measurement, increasing NMRR and CMRR.
  • Page 255 Section 8: Theory of operation Series 3700A System Switch/Multimeter Reference Manual Figure 104: 1plc Line Sychronization Block Diagram For Line Synchronization off and <1 PLC, reading rate increases, but measurement uncertainty and noise increases due to the Average AC noise during the S HI phase not canceling with the S LO phase.
  • Page 256: Ac Voltage Measurements And Crest Factor

    Series 3700A System Switch/Multimeter Reference Manual Section 8: Theory of operation AC voltage measurements and crest factor The root-mean-square (RMS) value of any periodic voltage or current is equal to the value of the DC voltage or current which delivers the same power to a resistance as the periodic waveform does. Crest factor is the ratio of the peak value to the RMS value of a particular waveform.
  • Page 257 Section 8: Theory of operation Series 3700A System Switch/Multimeter Reference Manual Figure 107: RMS calculations and crest factor 3700AS-901-01 Rev. D/June 2018...
  • Page 258: Dmm Resistance Measurement Methods

    Series 3700A System Switch/Multimeter Reference Manual Section 8: Theory of operation The Series 3700A is an AC-coupled RMS meter. For an AC waveform with DC content, the DC component is removed before the RMS is calculated. This affects the crest factor because the peak value for the DC-coupled waveform is different than the peak value for the AC-coupled waveform.
  • Page 259: Constant-Current Source Method

    Section 8: Theory of operation Series 3700A System Switch/Multimeter Reference Manual Constant-current source method For the 1 Ω to 1 MΩ ranges, the Series 3700A uses the constant-current method to measure resistance. The Series 3700A sources a constant current (I ) to the device under test (DUT) and SOUR measures the voltage (V...
  • Page 260: Ratiometric Method

    Series 3700A System Switch/Multimeter Reference Manual Section 8: Theory of operation Ratiometric method For the 10 MΩ and 100 MΩ ranges, the ratiometric method is used to measure resistance. Test current for this method is generated by a 6.4 V voltage source through a 10 MΩ reference resistance ), as shown in the figure below.
  • Page 261 Section 8: Theory of operation Series 3700A System Switch/Multimeter Reference Manual includes the voltage drops of the input test leads (Input HI and Input LO). Therefore, the actual MEAS voltage drop across the DUT is V minus the two voltage drops in the test leads. Because MEAS matched inputs are used, the voltage drop is 2 ×...
  • Page 262: Reference Junctions

    Series 3700A System Switch/Multimeter Reference Manual Section 8: Theory of operation Figure 112: Fast Alternating Scan block diagram Reference junctions A reference junction is the cold junction in a thermocouple circuit that is held at a stable, known temperature. The cold junction is where dissimilar wire connections must be made. As long as the temperature of the cold junction is known, the Series 3700A can factor in the reference temperature to calculate the actual temperature reading at the thermocouple.
  • Page 263: Simulated Reference Junction

    Section 8: Theory of operation Series 3700A System Switch/Multimeter Reference Manual The reference junction types supported by the Series 3700A are: • Simulated reference junction • Internal reference junction • External reference junction These reference junctions are explained in the following paragraphs. Simulated reference junction The simulated reference temperature for the Series 3700A can be set from 0 °C to 65 °C.
  • Page 264: Open Lead Detection

    Series 3700A System Switch/Multimeter Reference Manual Section 8: Theory of operation The following code shows how to set up an external reference junction using TSP commands. reset() dmm.func = dmm.TEMPERATURE dmm.transducer = dmm.TEMP_THERMOCOUPLE dmm.thermocouple = dmm.THERMOCOUPLE_K dmm.opendetector = dmm.ON dmm.units = dmm.UNITS_CELSIUS dmm.refjunction = dmm.REF_JUNCTION_EXTERNAL dmm.configure.set("my_temp_k") --Specify the channel the thermocouple is on.
  • Page 265 Section 8: Theory of operation Series 3700A System Switch/Multimeter Reference Manual Figure 113: Simplified normal 4-wire ohm open detection schematic Figure 114: Model 3706A Internal DMM 8-14 3700AS-901-01 Rev. D/June 2018...
  • Page 266: Isour Open Voltage

    Series 3700A System Switch/Multimeter Reference Manual Section 8: Theory of operation ISOUR open voltage 1 Ω through 1 MΩ ranges: A hardware detector detects an open input lead. The hardware detector uses a comparator circuit to monitor the voltage on the ohm I terminal.
  • Page 267: Dmm.opendetector Open Voltage

    Section 8: Theory of operation Series 3700A System Switch/Multimeter Reference Manual dmm.opendetector open voltage With dmm.opendetector = dmm.ON, a separate -1.5 A I SHI and a separate SLO current OPENLEAD source will pulse on and off before the start of each measurement while I remains enabled.
  • Page 268: 4-Wire Dry-Circuit Open Lead Detection

    OPENLEAD 1.0. 4. Additional cable and Series 3700A card capacitance can increase settling times, resulting in additional measurement uncertainty. Keithley Instruments recommend the use of Teflon or other low-dielectric absorption wire insulation for these measurements. 4-wire dry-circuit open lead detection...
  • Page 269: Open Thermocouple Detection

    Section 8: Theory of operation Series 3700A System Switch/Multimeter Reference Manual VMEAS open voltage (dry-circuit) If either Input Sense HI or Sense LO V is outside the enclosed table voltages, the A/D stops in MEAS less than 100 s and returns an overflow reading. Range SHI or SLO high limit open SHI or SLO low limit open lead...
  • Page 270 Series 3700A System Switch/Multimeter Reference Manual Section 8: Theory of operation • open voltage with dmm.opendetector. A hardware detector is used to continuously detect SOUR for open input lead. The hardware detector uses a comparator circuit to monitor the voltage on the ohm I terminal.
  • Page 271: Accuracy Calculations

    Section 8: Theory of operation Series 3700A System Switch/Multimeter Reference Manual Accuracy calculations The following information discusses how to calculate accuracy for both DC and AC characteristics. Calculating DC characteristics accuracy DC characteristics accuracy is calculated as follows: For ≥1 PLC, accuracy = ±(ppm of reading + ppm of range) (ppm = parts per million and 10 ppm = 0.001%) As an example of how to calculate the actual reading limits, assume that you are measuring 5 V on...
  • Page 272: Calculating Db Characteristics Accuracy

    Series 3700A System Switch/Multimeter Reference Manual Section 8: Theory of operation Calculating dB characteristics accuracy The relationship between voltage and dB is as follows: As an example of how to calculate the actual readings limits for dB, with a user-defined VREF of 10 V, you must calculate the voltage accuracy and apply it to the above equation.
  • Page 273: Understanding Precision Time Protocol (Ptp)

    Section 8: Theory of operation Series 3700A System Switch/Multimeter Reference Manual Understanding Precision Time Protocol (PTP) The Precision Time Protocol (PTP) is a time standard that does not have any discontinuities (that is, no leap seconds, time zones, or daylight savings). This is important for computing time deltas between events.
  • Page 274: Introduction To Tsp Operation

    Section 9 Introduction to TSP operation In this section: Introduction to TSP operation ........... 9-1 About TSP commands ............9-21 Introduction to TSP operation ® Instruments that are enabled for Test Script Processor (TSP ) operate like conventional instruments by responding to a sequence of commands sent by the controller. You can send individual commands to the TSP-enabled instrument the same way you would when using any other instrument.
  • Page 275: Queries

    Section 9: Introduction to TSP operation Series 3700A System Switch/Multimeter Reference Manual Example 2 You can use the results of a function-based command directly or assign variables to the results for later access. The following code defines x and prints it. x = math.abs(-100) Output: print(x)
  • Page 276: Data Retrieval Commands

    Series 3700A System Switch/Multimeter Reference Manual Section 9: Introduction to TSP operation Data retrieval commands You can send data retrieval commands that return a comma-delimited string. For example, channel.getcount(channelList) returns a count for each item passed to it through its parameter, channelList.
  • Page 277: Information On Scripting And Programming

    Section 9: Introduction to TSP operation Series 3700A System Switch/Multimeter Reference Manual For example, to print the channel images on this card when it is in slot 2 after a reset, send the following: reset() print(channel.getimage("slot2")) Output from above code: 2001;2002;2003;2004;2005;2006;2007;2008;2009;2010;2011;2012;2013;2014;2015;...
  • Page 278 Series 3700A System Switch/Multimeter Reference Manual Section 9: Introduction to TSP operation File system navigation The Series 3700A can use commands from the Lua fs library to navigate and list files that are available on a flash drive. These Lua commands are in the fs command group in the instrument. The fs commands make the file system of any given node available to the entire TSP-Link ®...
  • Page 279 Section 9: Introduction to TSP operation Series 3700A System Switch/Multimeter Reference Manual 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")
  • Page 280 Series 3700A System Switch/Multimeter Reference Manual Section 9: Introduction to TSP operation else print("myfile1 did not open for write") print("error string is " .. myfile1_err) print("error number is " .. myfile1_errnum) -- Open the three files again for reading. myfile1, myfile1_err, myfile1_errnum = io.open("/usb1/myfile_io1", "r") myfile2, myfile2_err, myfile2_errnum = io.open("/usb1/myfile_io2", "r") myfile3, myfile3_err, myfile3_errnum...
  • Page 281 Section 9: Introduction to TSP operation Series 3700A System Switch/Multimeter Reference Manual After downloading the above script, type file_io_test() to execute the script: file_io_test() The following output is returned after executing the file_io_test() script: contents of myfile1 are: Using io write to myfile1 to io output 11/27/07 07:57:23 file handle to write to myfile1 while myfile3 is output file for io...
  • Page 282 Series 3700A System Switch/Multimeter Reference Manual Section 9: Introduction to TSP operation loadscript filetest -- Script to write two lines to a file. -- Append two lines to the same file. -- Read the entire file contents and print them. -- Open the file for writing.
  • Page 283: Display Operations

    Section 9: Introduction to TSP operation Series 3700A System Switch/Multimeter Reference Manual Display operations Display functions and attributes You will use the display functions and attributes to perform the display operations covered in this section. The following table lists each display function or attribute (in alphabetic order) and cross references it to the section topic where the function or attribute is explained.
  • Page 284 Series 3700A System Switch/Multimeter Reference Manual Section 9: Introduction to TSP operation The display.clear(), display.setcursor(), and display.settext() functions (which are explained in the following paragraphs) are overlapped, nonblocking commands. The script will NOT wait for one of these commands to complete. These nonblocking functions do not immediately update the display.
  • Page 285 Section 9: Introduction to TSP operation Series 3700A System Switch/Multimeter Reference Manual When set to 0, the cursor will not be seen. When set to 1, a display character will blink to indicate its position. The display.getcursor() function returns the present cursor position, and can be used three ways: row, column, style = display.getcursor() row, column = display.getcursor()
  • Page 286 Series 3700A System Switch/Multimeter Reference Manual Section 9: Introduction to TSP operation The following programming example illustrates how to use the $N and $B character codes to display the message “Test in Process” on the top line and the blinking message “Do Not Disturb” on the bottom line: display.clear() display.settext("Test in Process $N$BDo Not Disturb")
  • Page 287 Section 9: Introduction to TSP operation Series 3700A System Switch/Multimeter Reference Manual Sending the command without the row parameter returns both lines of the display. The $N character code will be included to show where the top line ends and the bottom line begins. The $N character code will be returned even if embellished is set to false.
  • Page 288 Series 3700A System Switch/Multimeter Reference Manual Section 9: Introduction to TSP operation Each of these two functions can be used in four ways: display.inputvalue(format) display.inputvalue(format, default) display.inputvalue(format, default, min) display.inputvalue(format, default, min, max) display.prompt(format, units, help) display.prompt(format, units, help, default) display.prompt(format, units, help, default, min) display.prompt(format, units, help, default, min, max) Where:...
  • Page 289 Section 9: Introduction to TSP operation Series 3700A System Switch/Multimeter Reference Manual Example: Interactive script Code Output myFunc = display.menu ("Select function", Prompt operator to select function. "dcvolts twowireohms") if (myFunc == "dcvolts") then myRange = display.menu("Select range", "10 100") if (myRange == "10") then rangeValue = 10 else...
  • Page 290 Series 3700A System Switch/Multimeter Reference Manual Section 9: Introduction to TSP operation Bit identification for indicators REAR LSTN TALK EDIT Annunciator Weighted value* 32768 16384 8192 4096 2048 1024 Binary value SMPL STAR TRIG AUTO MATH FILT Annunciator Weighted value* Binary value * The weighted values are for bits that are set to “1.”...
  • Page 291 Section 9: Introduction to TSP operation Series 3700A System Switch/Multimeter Reference Manual Adding USER TESTS menu entries You can use the following function in either of two ways to add an entry into the USER TESTS menu: display.loadmenu.add(displayname, code) display.loadmenu.add(displayname, code, memory) Where: displayname The name string that is added to the USER TESTS menu.
  • Page 292 Series 3700A System Switch/Multimeter Reference Manual Section 9: Introduction to TSP operation LOAD TEST menu options Allows you to run scripts and code from the front panel that you created through the communication interface, or configuration scripts created by pressing the front-panel MENU key, then selecting SCRIPT >...
  • Page 293 Section 9: Introduction to TSP operation Series 3700A System Switch/Multimeter Reference Manual display.getlastkey() The display.getlastkey() function immediately returns the key code for the last pressed key. The following programming example illustrates how to display the last key pressed: key = display.getlastkey() print(key) The above code will return the key code value (see the following table).
  • Page 294: About Tsp Commands

    Series 3700A System Switch/Multimeter Reference Manual Section 9: Introduction to TSP operation The following programming example illustrates how to prompt the user to press the EXIT (LOCAL) key to abort the script, or any other key to continue it: display.clear() display.setcursor(1, 1) display.settext("Press EXIT to Abort") display.setcursor(2, 1)
  • Page 295 Section 9: Introduction to TSP operation Series 3700A System Switch/Multimeter Reference Manual Bit operations The rest of the functions in this group are used for operations on the bits of a given number. These functions can be used to: ▪ Clear a bit ▪...
  • Page 296: Channel

    Series 3700A System Switch/Multimeter Reference Manual Section 9: Introduction to TSP operation Channel Channel functions and attributes allow you to adjust, select, open, and close channels. You can also set common channel attributes and set up channel patterns. The channel functions and attributes are: channel.calibration.adjustcount() (on page 11-38) channel.calibration.adjustdate()
  • Page 297: Data Queue

    Section 9: Introduction to TSP operation Series 3700A System Switch/Multimeter Reference Manual channel.trigger[N].get() (on page 11-102) channel.trigger[N].set() (on page 11-103) channel.trigger[N].wait() (on page 11-104) channel.write() (on page 11-105) Data queue Use the data queue commands to: • Share data between test scripts running in parallel •...
  • Page 298: Display

    Series 3700A System Switch/Multimeter Reference Manual Section 9: Introduction to TSP operation Display display.clear() (on page 11-126) display.getannunciators() (on page 11-127) display.getcursor() (on page 11-128) display.getlastkey() (on page 11-129) display.gettext() (on page 11-130) display.inputvalue() (on page 11-131) display.loadmenu.add() (on page 11-133) display.loadmenu.catalog() (on page 11-134) display.loadmenu.delete()
  • Page 299: Error Queue

    Section 9: Introduction to TSP operation Series 3700A System Switch/Multimeter Reference Manual dmm.displaydigits (on page 11-172) dmm.drycircuit (on page 11-173) dmm.filter.count (on page 11-174) dmm.filter.enable (on page 11-175) dmm.filter.type (on page 11-176) dmm.filter.window (on page 11-177) dmm.fourrtd (on page 11-178) dmm.func (on page 11-179) dmm.getconfig()
  • Page 300: Event Log

    Series 3700A System Switch/Multimeter Reference Manual Section 9: Introduction to TSP operation Event log You can use the event log to view specific details about LAN triggering events. eventlog.all() (on page 11-237) eventlog.clear() (on page 11-238) eventlog.count (on page 11-238) eventlog.enable (on page 11-239) eventlog.next()
  • Page 301: Gpib

    Section 9: Introduction to TSP operation Series 3700A System Switch/Multimeter Reference Manual ® system, so the io.open(), File descriptors cannot be passed between nodes in a TSP-Link fileVar::read(), and fileVar::write commands are not accessible to the TSP-Link system. However, the default input and output files mentioned above allow for the execution of many file I/O operations without any reference to a file descriptor.
  • Page 302: Lan And Lxi

    Series 3700A System Switch/Multimeter Reference Manual Section 9: Introduction to TSP operation LAN and LXI The LAN commands have options that allow you to review and configure network settings. The lan.config.* commands allow you to configure LAN settings over the remote interface. Note that you must send lan.applysettings() for the configuration settings to take effect.
  • Page 303: Local Node

    Section 9: Introduction to TSP operation Series 3700A System Switch/Multimeter Reference Manual Local node Commands that allow you to set and read from the local node. localnode.define.* (on page 11-283) localnode.description (on page 11-284) localnode.linefreq (on page 11-285) localnode.model (on page 11-286) localnode.password (on page 11-286) localnode.passwordmode...
  • Page 304: Reading Buffer

    Series 3700A System Switch/Multimeter Reference Manual Section 9: Introduction to TSP operation Reading buffer Reading buffers capture measurements, ranges, instrument status, and output states of the instrument. bufferVar.appendmode (on page 11-16) bufferVar.basetimefractional (on page 11-17) bufferVar.basetimeseconds (on page 11-18) bufferVar.cachemode (on page 11-19) bufferVar.capacity (on page 11-19)
  • Page 305: Saved Setups

    Section 9: Introduction to TSP operation Series 3700A System Switch/Multimeter Reference Manual Saved setups Use the saved setups commands to save or restore the configurations to or from the nonvolatile memory of the instrument or an installed USB flash drive. You can use the setup.poweron attribute to specify which setup is recalled when the instrument is turned on.
  • Page 306: Scripting

    Series 3700A System Switch/Multimeter Reference Manual Section 9: Introduction to TSP operation Scripting Scripting helps you combine commands into a block of code that the instrument can run. Scripts help you communicate with the instrument efficiently. These commands describe how to create, load, modify, run, and exit scripts.
  • Page 307: Slot

    Section 9: Introduction to TSP operation Series 3700A System Switch/Multimeter Reference Manual Slot The slot attributes configure and read the settings of the cards in the slots. You can also set up pseudocards. slot[slot].banks.matrix (on page 11-357) slot[slot].columns.matrix (on page 11-358) slot[slot].commonsideohms (on page 11-358) slot[slot].digio...
  • Page 308: Top Level Instrument Controls

    Series 3700A System Switch/Multimeter Reference Manual Section 9: Introduction to TSP operation Top level instrument controls These commands work with other commands to control general instrument functions. They are also used to set and gather instrument information. The beeper commands allow you to enable or disable and sound the instrument beeper. delay() stops instrument operation for a specified period of time.
  • Page 309: Triggering

    Section 9: Introduction to TSP operation Series 3700A System Switch/Multimeter Reference Manual Triggering The triggering commands allow you to set the conditions that the instrument uses to determine when measurements are captured. digio.trigger[N].assert() (on page 11-116) digio.trigger[N].clear() (on page 11-117) digio.trigger[N].EVENT_ID (on page 11-117) digio.trigger[N].mode...
  • Page 310: Tsp-Link

    Series 3700A System Switch/Multimeter Reference Manual Section 9: Introduction to TSP operation TSP-Link These functions and attributes allow you to set up and work with a system that is connected by a ® TSP-Link network. tsplink.group (on page 11-420) tsplink.master (on page 11-421) tsplink.node (on page 11-421)
  • Page 311: Userstrings

    Section 9: Introduction to TSP operation Series 3700A System Switch/Multimeter Reference Manual Userstrings Use the functions in this group to store and retrieve user-defined strings in nonvolatile memory. These strings are stored as key-value pairs. Key-value pairs are associated arrays of data items, where the key is used to index into the array.
  • Page 312: Instrument Programming

    Section 10 Instrument programming In this section: Fundamentals of scripting for TSP ......... 10-1 Fundamentals of programming for TSP ....... 10-15 Using Test Script Builder (TSB) ........... 10-33 Advanced scripting for TSP ..........10-44 TSP-Link system expansion interface ........10-52 Connections .................
  • Page 313: What Is A Script

    Section 10: Instrument programming Series 3700A System Switch/Multimeter Reference Manual What is a script? A script is a collection of instrument control commands and programming statements. Scripts that you create are referred to as user scripts. Your scripts can be interactive. Interactive scripts display messages on the front panel of the instrument that prompt the operator to enter parameters.
  • Page 314: Commands That Cannot Be Used In Scripts

    To manage scripts, you can send messages to the instrument, use your own development tool or program, use Keithley Instruments Test Script Builder (TSB) software, or use TSB Embedded on the instrument's web interface. TSB and TSB Embedded are described below.
  • Page 315 Section 10: Instrument programming Series 3700A System Switch/Multimeter Reference Manual Named scripts A named script is a script with a unique name. You can have as many named scripts as needed in the instrument (within the limits of the memory available to the run-time environment). When a named script is loaded into the run-time environment with the loadscript or loadandrunscript commands, a global variable with the same name is created to reference the script.
  • Page 316 Series 3700A System Switch/Multimeter Reference Manual Section 10: Instrument programming To load a named script by sending commands: 1. Send the command loadscript scriptName, where scriptName is the name of the script. The name must be a legal Lua variable name. 2.
  • Page 317 Section 10: Instrument programming Series 3700A System Switch/Multimeter Reference Manual Run the anonymous script The anonymous script can be run many times without reloading it. It remains in the run-time environment until a new anonymous script is created or until the instrument is turned off. To run the anonymous script, use any one of these commands: •...
  • Page 318 Series 3700A System Switch/Multimeter Reference Manual Section 10: Instrument programming The scriptVar.save() command saves the script to nonvolatile memory, which makes the change persistent through a power cycle. See Save a user script to nonvolatile memory (on page 10- 10) for more detail. Example: Set a script to run automatically test5.autorun = "yes"...
  • Page 319 Section 10: Instrument programming Series 3700A System Switch/Multimeter Reference Manual Retrieve a user script There are several ways to retrieve the source code of a user script: • One line at a time: Use scriptVar.list() to retrieve the source code one line at a time •...
  • Page 320: Working With Scripts In Nonvolatile Memory

    Series 3700A System Switch/Multimeter Reference Manual Section 10: Instrument programming Example: Retrieve the source code as a single string print(test.source) Retrieve the source of a script named "test". Output might look similar to: display.clear() display.settext("This is a test") print("This is a test") Script example: Retrieve the content of scripts This set of examples:...
  • Page 321 Section 10: Instrument programming Series 3700A System Switch/Multimeter Reference Manual Save a user script You can save scripts to nonvolatile memory using commands or TSB Embedded. Only named scripts can be saved to nonvolatile memory. The anonymous script must be named before it can be saved to nonvolatile memory.
  • Page 322: Run A User Script From The Instrument Front Panel

    Series 3700A System Switch/Multimeter Reference Manual Section 10: Instrument programming Run a user script from the instrument front panel From the instrument front panel, you can load and run a user script. To run the code from the front panel and add it to the USER menu: 1.
  • Page 323: Load A Script From The Instrument Front Panel

    Section 10: Instrument programming Series 3700A System Switch/Multimeter Reference Manual Load a script from the instrument front panel You can also load scripts from a USB flash drive to the run-time environment of the instrument. Depending on the content of the TSP file on the drive, the script can be loaded either as an anonymous script without a designated name, or as a named script with a user-defined name.
  • Page 324: Save A Script From The Instrument Front Panel

    Series 3700A System Switch/Multimeter Reference Manual Section 10: Instrument programming To load a script from a USB flash drive: 1. Insert the flash drive into the USB port on the instrument. 2. Press the MENU key. 3. Select the SCRIPT option. 4.
  • Page 325: Interactive Script

    Section 10: Instrument programming Series 3700A System Switch/Multimeter Reference Manual Interactive script An interactive script prompts the operator to input values using the instrument front panel. The following example script uses display messages to prompt the operator to: • Enter the digital I/O line on which to output a trigger •...
  • Page 326: Fundamentals Of Programming For Tsp

    ® The Test Script Processor (TSP ) scripting engine is a Lua interpreter. In TSP-enabled instruments, the Lua programming language has been extended with Keithley-specific instrument control commands. What is Lua? Lua is a programming language that can be used with TSP-enabled instruments. Lua is an efficient language with simple syntax that is easy to learn.
  • Page 327 Section 10: Instrument programming Series 3700A System Switch/Multimeter Reference Manual Function and variable name restrictions You cannot use Lua reserved words and top-level command names for function or variable names. You cannot use the following Lua reserved words for function or variable names. Lua reserved words break function...
  • Page 328 Series 3700A System Switch/Multimeter Reference Manual Section 10: Instrument programming Variable types Variables can be one of the following types. Variable types and values Variable type returned Value Notes "nil" The type of the value nil, whose not declared main property is to be different from any other value;...
  • Page 329 Section 10: Instrument programming Series 3700A System Switch/Multimeter Reference Manual Example: Function function add_two(first_value, function second_value) return first_value + second_value print(add_two(3, 4), type(add_two)) Example: Table atable = {1, 2, 3, 4} Defines a table with four numeric print(atable, type(atable)) elements. print(atable[1]) Note that the "table"...
  • Page 330 Series 3700A System Switch/Multimeter Reference Manual Section 10: Instrument programming To execute a function, substitute appropriate values for parameterX and insert them into a message formatted as: myFunction(valueForParameterX, valueForParameterY) Where valueForParameterX and valueForParameterY represent the values to be passed to the function call for the given parameters.
  • Page 331 Section 10: Instrument programming Series 3700A System Switch/Multimeter Reference Manual The following steps use TSB Embedded. You can also use the loadscript and endscript commands to create the script over the remote interface. See Load a script by sending commands over the remote interface (on page 10-4).
  • Page 332 Series 3700A System Switch/Multimeter Reference Manual Section 10: Instrument programming Operators You can compare and manipulate Lua variables and constants using operators. Arithmetic operators Operator Description addition subtraction multiplication division negation (for example, c = a) exponentiation Relational operators Operator Description <...
  • Page 333 Section 10: Instrument programming Series 3700A System Switch/Multimeter Reference Manual String concatenation String operators Operator Description Concatenates two strings. If either argument is a number, it is coerced to a string (in a reasonable format) before concatenation. Example: Concatenation print(2 .. 3) print("Hello "...
  • Page 334 Series 3700A System Switch/Multimeter Reference Manual Section 10: Instrument programming Conditional branching Lua uses the if, else, elseif, then, and end keywords to do conditional branching. Note that in Lua, nil and false are false and everything else is true. Zero (0) is true in Lua. The syntax of a conditional block is as follows: if expression then block...
  • Page 335 Section 10: Instrument programming Series 3700A System Switch/Multimeter Reference Manual Example: Else and elseif x = 1 y = 2 if x and y then print("'if' expression 2 was not false.") if x or y then print("'if' expression 3 was not false.") if not x then print("'if' expression 4 was not false.") else...
  • Page 336 Series 3700A System Switch/Multimeter Reference Manual Section 10: Instrument programming Example: While list = { This loop exits when list[element] "One", "Two", "Three", "Four", "Five", "Six"} = nil. print("Count list elements on numeric index:") Output: element = 1 Count list elements on while list[element] do numeric index: print(element, list[element])
  • Page 337 Section 10: Instrument programming Series 3700A System Switch/Multimeter Reference Manual For loops There are two variations of for statements supported in Lua: Numeric and generic. In a for loop, the loop expressions are evaluated once, before the loop starts. The output you get from these examples may vary depending on the data format settings of the instrument.
  • Page 338 Series 3700A System Switch/Multimeter Reference Manual Section 10: Instrument programming Break The break statement can be used to terminate the execution of a while, repeat, or for loop, skipping to the next statement after the loop. A break ends the innermost enclosing loop. Return and break statements can only be written as the last statement of a block.
  • Page 339 Section 10: Instrument programming Series 3700A System Switch/Multimeter Reference Manual Example: Break with infinite loop a, b = 0, 1 This example uses a break statement that while true do causes the while loop to exit if the value of a print(a, b) becomes greater than 500.
  • Page 340: Standard Libraries

    Series 3700A System Switch/Multimeter Reference Manual Section 10: Instrument programming Standard libraries In addition to the standard programming constructs described in this document, Lua includes standard libraries that contain useful functions for string manipulation, mathematics, and related ® functions. Test Script Processor (TSP ) scripting engine instruments also include instrument control extension libraries, which provide programming interfaces to the instrumentation that can be accessed by the TSP scripting engine.
  • Page 341 Section 10: Instrument programming Series 3700A System Switch/Multimeter Reference Manual Lua memory management Lua automatically manages memory, which means you do not have to allocate memory for new objects and free it when the objects are no longer needed. Lua occasionally runs a garbage collector to collect all objects that are no longer accessible from Lua.
  • Page 342 Series 3700A System Switch/Multimeter Reference Manual Section 10: Instrument programming String library functions Function Description string.lower(s) Receives a string and returns a copy of this string with all uppercase letters changed to lowercase. All other characters are left unchanged. string.rep(s, n) Returns a string that is the concatenation of n copies of the string s.
  • Page 343 Section 10: Instrument programming Series 3700A System Switch/Multimeter Reference Manual 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.
  • Page 344: Programming Example: Script With A For Loop

    Using Test Script Builder (TSB) Keithley Instruments Test Script Builder (TSB) is a software tool that simplifies building test scripts. You can use TSB to perform the following operations: • Send remote commands and Lua statements •...
  • Page 345 Section 10: Instrument programming Series 3700A System Switch/Multimeter Reference Manual Keithley has created a collection of remote commands specifically for use with Keithley TSP-enabled instruments; for detailed information about those commands, refer to the Command reference page 11-1). You can build scripts from a combination of these commands and Lua programming statements.
  • Page 346: Installing The Tsb Software

    2. Download the Add-in to your computer and double-click it to start installation. 3. Follow the on-screen instructions. Using Test Script Builder (TSB) Keithley Instruments Test Script Builder (TSB) is a software tool that simplifies building test scripts. You can use TSB to perform the following operations: •...
  • Page 347 Section 10: Instrument programming Series 3700A System Switch/Multimeter Reference Manual Keithley has created a collection of remote commands specifically for use with Keithley TSP-enabled instruments; for detailed information about those commands, refer to the "Command reference" section of the documentation for your specific instrument. You can build scripts from a combination of these commands and Lua programming statements.
  • Page 348: Project Navigator

    Series 3700A System Switch/Multimeter Reference Manual Section 10: Instrument programming Project navigator The project navigator consists of project folders and the script files (.tsp) created for each project. Each project folder can have one or more script files. To view the script files in a project folder, click the plus (+) symbol next to the project folder. To hide the folder contents, click the minus () symbol next to the project folder.
  • Page 349: Connecting An Instrument In Tsb

    Section 10: Instrument programming Series 3700A System Switch/Multimeter Reference Manual Connecting an instrument in TSB To connect the Test Script Builder software to an instrument: 1. Click the Open Instrument icon in the script editor toolbar. Figure 122: Opening an instrument connection in TSB 2.
  • Page 350: Creating A New Tsp Project

    Series 3700A System Switch/Multimeter Reference Manual Section 10: Instrument programming Creating a new TSP project ® To create a new Test Script Processor (TSP ) project: 1. On the File menu in the TSP perspective, select New > TSP Project. The New TSP Project dialog box opens.
  • Page 351: Running A Script

    Section 10: Instrument programming Series 3700A System Switch/Multimeter Reference Manual Running a script You can run a script in the Test Script Builder (TSB) software using any of the following methods: • Run a script that is open in the script editor area •...
  • Page 352 Series 3700A System Switch/Multimeter Reference Manual Section 10: Instrument programming Figure 126: Run Configurations dialog box 4. In the Name box, enter the name of your new run configuration. 5. Click the Browse button next the Project box. 6. Select a project from the list of available projects 7.
  • Page 353 Section 10: Instrument programming Series 3700A System Switch/Multimeter Reference Manual The TSP files for the selected project are added to the Available Project Files list on the Main tab. Figure 128: Available files for selected project 8. Select the files you want to add to the run configuration and click Add to add them to the Load Order list.
  • Page 354 Series 3700A System Switch/Multimeter Reference Manual Section 10: Instrument programming 9. Click Apply. 10. Click the Script Attributes tab. 11. Select one of the following: ▪ Load and Execute: If you select this option, which is the default selection, the script automatically loads into the instrument's volatile memory (run-time environment) and executes when you click Run.
  • Page 355: Advanced Scripting For Tsp

    Section 10: Instrument programming Series 3700A System Switch/Multimeter Reference Manual Advanced scripting for TSP The following topics describe advanced information that can help you understand how the Test Script ® Processor (TSP ) scripting engine works. Global variables and the script.user.scripts table When working with script commands, it is helpful to understand how scripts are handled in the instrument.
  • Page 356: Create A Script Using The Script.new() Command

    Series 3700A System Switch/Multimeter Reference Manual Section 10: Instrument programming Figure 131: Global variables and scripts in the runtime environment Create a script using the script.new() command Use the script.new() function to copy an existing script from the local node to a remote node. This enables parallel script execution.
  • Page 357 Section 10: Instrument programming Series 3700A System Switch/Multimeter Reference Manual For example, to set up a two-second beep, you can send the command: beepTwoSec = script.new("beeper.enable = 1 beeper.beep(2, 2400)", "beepTwoSec") To run the new script, send the command: beepTwoSec() When you add beepTwoSec, the global variable and script.user.scripts table entries are made to the run-time environment as shown in the following figure.
  • Page 358 Series 3700A System Switch/Multimeter Reference Manual Section 10: Instrument programming A script will become unnamed if you create a new script with the same name. In this circumstance, the name of the script in the script.user.scripts table is set to an empty string before it is replaced by the new script.
  • Page 359: Restore A Script To The Run-Time Environment

    Section 10: Instrument programming Series 3700A System Switch/Multimeter Reference Manual Restore a script to the run-time environment You can retrieve a script that was removed from the run-time environment but is still saved in nonvolatile memory. To restore a script from nonvolatile memory into the run-time environment, you can use script.restore("scriptName"), where scriptName is the user-defined name of the script to be restored.
  • Page 360: Delete User Scripts From The Instrument

    Series 3700A System Switch/Multimeter Reference Manual Section 10: Instrument programming Figure 135: Rename script For example, to change the name of the script named test2 to be autoexec: test2.name = "autoexec" test2.save() The autoexec script runs automatically when the instrument is turned on. It runs after all the scripts have loaded and any scripts marked as autorun have run.
  • Page 361: Memory Considerations For The Run-Time Environment

    Section 10: Instrument programming Series 3700A System Switch/Multimeter Reference Manual To completely remove a script: 1. Remove the script from the run-time environment. Set any variables that refer to the script to nil or assign the variables a different value. For example, to remove the script "beepTwoSec" from the run-time environment, send the following code: beepTwoSec = nil 2.
  • Page 362 Series 3700A System Switch/Multimeter Reference Manual Section 10: Instrument programming Some suggestions for increasing the available memory: • Turn the instrument off and on. This deletes scripts that have not been saved and reloads only scripts that have been stored in nonvolatile memory. •...
  • Page 363: Tsp-Link System Expansion Interface

    Series 3700A instruments. To prevent damage to the Series 3700A, connected instruments, and the device under test, make sure proper procedures are used. For further information, visit the Keithley Instruments website http://www.tek.com/keithley for application notes on combining two Series 3700A channels.
  • Page 364: Tsp-Link System

    Series 3700A System Switch/Multimeter Reference Manual Section 10: Instrument programming TSP-Link system ® You can use the TSP-Link expansion interface to expand your test system to include up to 32 ® ® addressable TSP enabled instruments that use the TSP-LINK .
  • Page 365: Connections

    Section 10: Instrument programming Series 3700A System Switch/Multimeter Reference Manual Connections Connections for an expanded system are shown in the following figure. As shown, one instrument is optionally connected to the computer using the GPIB or LAN interface. Details about these computer communication connections are described in Remote communications interfaces (on page 2-6).
  • Page 366: Resetting The Tsp-Link Network

    Series 3700A System Switch/Multimeter Reference Manual Section 10: Instrument programming To assign a node number from the front panel of the instrument: 1. Press the MENU key, then select TSPLINK > NODE. 2. Press the navigation wheel and select the node number. 3.
  • Page 367: Using The Expanded System

    Section 10: Instrument programming Series 3700A System Switch/Multimeter Reference Manual An attempted TSP-Link reset operation will fail if any of the following conditions are true: • Two or more instruments in the system have the same node number • There are no other instruments connected to the instrument performing the reset (only if the expected number of nodes was not provided in the reset call) •...
  • Page 368: Using The Reset() Command

    Series 3700A System Switch/Multimeter Reference Manual Section 10: Instrument programming Using the reset() command ® system operations target a single node in the system, but the reset() command Most TSP-Link affects the system as a whole by resetting all nodes to their default settings: -- Reset all nodes in a TSP-Link system to their default state.
  • Page 369: Tsp Advanced Features

    Section 10: Instrument programming Series 3700A System Switch/Multimeter Reference Manual TSP advanced features ® Use the Test Script Processor (TSP ) scripting engine's advanced features to: • Run test scripts simultaneously • Manage resources allocated to test scripts that are running simultaneously •...
  • Page 370: Master Node Overview

    Series 3700A System Switch/Multimeter Reference Manual Section 10: Instrument programming Master node overview You can assign the master node to any group. You can also include other nodes in the group that includes the master. Note that any nodes that are set to group 0 are automatically included in the group that contains the master node, regardless of the group that is assigned to the master node.
  • Page 371: Coordinating Overlapped Operations In Remote Groups

    Section 10: Instrument programming Series 3700A System Switch/Multimeter Reference Manual The following code demonstrates how to run a test script that is defined on the local node. For this example, scriptVar is defined on the local node, which is the node that initiates the code to run on the remote node.
  • Page 372: Using The Data Queue For Real-Time Communication

    Series 3700A System Switch/Multimeter Reference Manual Section 10: Instrument programming Using the data queue for real-time communication Nodes that are running test scripts at the same time can store data in the data queue for real-time communication. Each instrument has an internal data queue that uses the first-in, first-out (FIFO) structure to store data.
  • Page 373: Tsp-Net

    Section 10: Instrument programming Series 3700A System Switch/Multimeter Reference Manual -- Create a reading buffer on a node in a remote group. node[2].tsplink.group = 7 node[2].execute("rbremote = dmm.makebuffer(20) " .. "dmm.measurecount = 20 " .. "dmm.measure(rbremote)") -- Create a variable on the local node to -- access the reading buffer.
  • Page 374: Using Tsp-Net With Any Ethernet-Enabled Device

    Series 3700A System Switch/Multimeter Reference Manual Section 10: Instrument programming Using TSP-Net with any ethernet-enabled device Refer to TSP commands (on page 11-8) for more details about the commands presented in this section. To communicate to a remote ethernet-enabled device from the Series 3700A, perform the following steps: 1.
  • Page 375: Using Tsp-Net With Any Ethernet-Enabled Instrument

    This example produces a return such as: ID is: instrument write/read returns: SUCCESS: Logged in instrument write/read returns: KEITHLEY INSTRUMENTS,MODEL 3700AS,04089762,1.6.3d Using TSP-Net with any ethernet-enabled instrument Refer to TSP command reference (on page 11-1) for details about the commands presented in this section.
  • Page 376 Series 3700A System Switch/Multimeter Reference Manual Section 10: Instrument programming To set up communication to a remote ethernet-enabled device that is not TSP enabled: Send the command: connectionID = tspnet.connect(ipAddress, portNumber, initString) Where: ▪ connectionID is the connection ID that will be used as a handle in all other tspnet function calls. ▪...
  • Page 377: Tsp-Net Compared To Tsp-Link To Communicate With Tsp-Enabled Devices

    This example produces a return such as: ID is: instrument write/read returns: SUCCESS: Logged in instrument write/read returns: KEITHLEY INSTRUMENTS,MODEL 3700AS,04089762,1.6.3d TSP-Net compared to TSP-Link to communicate with TSP-enabled devices ® The TSP-Link network interface is the preferred communication method for most applications where communication occurs between the Series 3700A and another TSP-enabled instrument.
  • Page 378: Tsp-Net Instrument Commands: General Device Control

    Series 3700A System Switch/Multimeter Reference Manual Section 10: Instrument programming TSP-Net instrument commands: General device control The following instrument commands provide general device control: tspnet.clear() (on page 11-434) tspnet.connect() (on page 11-434) tspnet.disconnect() (on page 11-436) tspnet.execute() (on page 11-436) tspnet.idn() (on page 11-437) tspnet.read()
  • Page 379: Example: Using Tspnet Commands

    Section 10: Instrument programming Series 3700A System Switch/Multimeter Reference Manual Example: Using tspnet commands function telnetConnect(ipAddress, userName, password) -- Connect through Telnet to a computer. id = tspnet.connect(ipAddress, 23, "") -- Read the title and login prompt from the computer. print(string.format("from computer-->...
  • Page 380: Tsp Command Reference

    Section 11 TSP command reference In this section: Command programming notes ..........11-1 Using the TSP command reference ........11-4 TSP commands ..............11-8 Command programming notes Placeholder text This manual uses italicized text to represent the parts of remote commands that must be replaced by user specified values.
  • Page 381: Syntax Rules

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual Syntax rules Use these syntax requirements to build well-formed instrument control commands. Instrument commands are case sensitive. Refer to the command reference descriptions for the correct case. The white space in lists of parameters in functions is optional. For example, the following functions are equivalent: digio.writebit(3,0) digio.writebit (3, 0)
  • Page 382 Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference The following errors can occur because of invalid channel list syntax or specification. Error Message Description invalid specified channel The channel is specified with the correct syntax, but does not exist on the card.
  • Page 383: Time And Date Values

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual Time and date values Time and date values are represented as a number of UTC seconds since 12:00 a.m. Jan. 1, 1970. The os.time() command returns values in this format. Use os.date() to return values in month, day, year, hours, and minutes format, or to access the timestamp table.
  • Page 384: Command Name And Standard Parameters Summary

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference Command name and standard parameters summary Each instrument command description starts with the command name, followed by a table with relevant information for each command. Definitions for the numbered items in the figure below are listed following the figure.
  • Page 385: Command Usage

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual 5. Where saved. Indicates where the command settings reside once they are used on an instrument. Options include: ▪ Create configuration script: This command is saved as part of the configuration script if you save the current configuration into a script with the createconfigscript() command or the MENU >...
  • Page 386: Command Details

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference Command details This section lists additional information you need to know to successfully use the remote command. Figure 140: TSP Details description Example section The Example section of the remote command description shows examples of how you can use the command.
  • Page 387: Tsp Commands

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual TSP commands The TSP commands available for the instrument are listed in alphabetic order. beeper.beep() This function generates an audible tone. Type TSP-Link accessible Affected by Where saved Default value Function Usage beeper.beep(duration, frequency)
  • Page 388: Bit.bitand()

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference Example beeper.enable = beeper.ON Enables the beeper and generates a beeper.beep(2, 2400) two-second, 2400 Hz tone. Also see beeper.beep() (on page 11-8) bit.bitand() This function performs a bitwise logical AND operation on two numbers. Type TSP-Link accessible Affected by...
  • Page 389: Bit.bitxor()

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual Details Any fractional parts of value1 and value2 are truncated to make them integers. The returned result is also an integer. Example testResult = bit.bitor(10, 9) Performs a bitwise logical OR operation on decimal 10 (binary 1010) with decimal 9 (binary 1001), which print(testResult) returns a value of decimal 11 (binary 1011).
  • Page 390: Bit.clear()

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference bit.clear() This function clears a bit at a specified index position. Type TSP-Link accessible Affected by Where saved Default value Function Usage result = bit.clear(value, index) result Result of the bit manipulation value Specified number index...
  • Page 391: Bit.getfield()

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual Details This function returns the value of the bit in value at index. This is the same as returning value with all other bits set to zero (0). The least significant bit of value is at index position 1; the most significant bit is at index position 32.
  • Page 392: Bit.set()

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference Example myResult = bit.getfield(13, 2, 3) The binary equivalent of decimal 13 is 1101. The field at index position 2 and width 3 consists of the binary bits 110. The returned value is decimal 6 (binary 110).
  • Page 393: Bit.setfield()

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual bit.setfield() This function overwrites a bit field at a specified index position. Type TSP-Link accessible Affected by Where saved Default value Function Usage result = bit.setfield(value, index, width, fieldValue) result Result of the bit manipulation value...
  • Page 394: Bit.test()

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference bit.test() This function returns the Boolean value (true or false) of a bit at the specified index position. Type TSP-Link accessible Affected by Where saved Default value Function Usage result = bit.test(value, index) result Result of the bit manipulation...
  • Page 395: Buffervar.appendmode

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual Details This function returns result, which is the result of toggling the bit index in value. Any fractional part of value is truncated to make it an integer. The returned value is also an integer. The least significant bit of value is at index position 1;...
  • Page 396: Buffervar.basetimefractional

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference Details Assigning a value to this attribute enables or disables the buffer append mode. This value can only be changed with an empty buffer. Use bufferVar.clear() to empty the buffer. When a buffer is created over a remote interface, the append mode attribute default setting is off (0).
  • Page 397: Buffervar.basetimeseconds

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual Example baseFractional = buffer1.basetimefractional Read the basetimefractional attribute for buffer1 and store it in a variable called baseFractional. Also see bufferVar.clear() (on page 11-21) bufferVar.collecttimestamps (on page 11-24) Reading buffers (on page 6-7, on page 6-1) bufferVar.basetimeseconds When enabled by the bufferVar.collecttimestamps attribute, this attribute represents the nonfractional...
  • Page 398: Buffervar.cachemode

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference bufferVar.cachemode This attribute enables or disables the reading buffer cache (on or off). Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Clearing the buffer cache Not saved 1 (enabled) Instrument reset Recall setup...
  • Page 399: Buffervar.channels

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual Example bufferCapacity = buffer1.capacity Reads the capacity of a reading buffer named buffer1. print(bufferCapacity) Output: 1.00000e+05 The above output indicates that the buffer can hold 100000 readings. Also see Reading buffers (on page 6-7, on page 6-1) bufferVar.channels...
  • Page 400: Buffervar.clear()

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference Example reset() This example creates a reading buffer named testData = dmm.makebuffer(1000) testData, configures the buffer to collect testData.collectchannels = 1 channel data, sets and saves the DMM dmm.nplc = 0.5 configuration, creates a scan list, and then runs the scan.
  • Page 401: Buffervar.clearcache()

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual Example testData = dmm.makebuffer(50) Create a reading buffer named testData and testData.appendmode = 1 enable append mode for it. Take three readings and dmm.measurecount = 3 store them in testData, and then view the dmm.measure(testData) readings.
  • Page 402: Buffervar.collectchannels

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference bufferVar.collectchannels This attribute sets the storage state of channel information with the readings in the buffer. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Instrument reset Create configuration script 1 (enabled) Recall setup...
  • Page 403: Buffervar.collecttimestamps

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual bufferVar.collecttimestamps This attribute sets whether or not timestamp values are stored with the readings in the buffer. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Instrument reset Create configuration script 1 (enabled) Recall setup...
  • Page 404: Buffervar.dates

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference bufferVar.dates When enabled by the bufferVar.collecttimestamps attribute, this attribute contains the dates (month, day, and year) of readings stored in the reading buffer. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Buffer storage settings...
  • Page 405: Buffervar.formattedreadings

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual bufferVar.formattedreadings This attribute contains the stored readings shown as numbers with units and prefixes. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Clearing the buffer USB flash drive using Not applicable Instrument reset dmm.savebuffer or...
  • Page 406: Buffervar.fractionalseconds

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference bufferVar.fractionalseconds This attribute contains the fractional second portion of the timestamp of each reading in the reading buffer. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Buffer storage settings USB flash drive using Not applicable...
  • Page 407: Buffervar.n

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual bufferVar.n This attribute contains the number of readings in the buffer. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Clearing the buffer Not saved Not applicable Reset Recall setup Usage...
  • Page 408: Buffervar.readings

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference Details The ptp seconds information from a reading buffer is only available if the bufferVar.collecttimestamps attribute is set to 1 (default setting). If it is set to 0, you will not be able to access any time information from a reading buffer.
  • Page 409: Buffervar.relativetimestamps

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual Details The readings buffer recall attribute is like an array (a Lua table) of the readings stored in the reading buffer. This array holds the same data that is returned when the reading buffer is accessed directly;...
  • Page 410 Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference bufferVar.relativetimestamps This attribute contains the timestamps, in seconds, when each reading occurred, relative to the timestamp of the first entry in the reading buffer. Type TSP-Link accessible Affected by Where saved Default value Attribute (R)
  • Page 411: Buffervar.seconds

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual bufferVar.seconds This attribute contains the timestamp of a reading in seconds, in UTC format. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Buffer storage settings USB flash drive using Not applicable Clearing the buffer dmm.savebuffer or...
  • Page 412: Buffervar.statuses

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference bufferVar.statuses This attribute contains the status values of readings in the reading buffer. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Clearing the buffer USB flash drive using Not applicable Instrument reset dmm.savebuffer or...
  • Page 413: Buffervar.times

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual Example reset() This example creates a reading buffer named testData = dmm.makebuffer(1000) testData, configures the buffer to collect testData.collectchannels = 1 channel data, sets and saves the DMM dmm.nplc = 0.5 configuration, creates a scan list, and then runs the scan.
  • Page 414: Buffervar.timestampresolution

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference Example reset() This example creates a reading buffer testData = dmm.makebuffer(1000) named testData, configures the buffer to testData.collecttimestamps = 1 collect time and date data, sets and saves dmm.nplc = 0.5 the DMM configuration, creates a scan list, and then runs the scan.
  • Page 415: Buffervar.timestamps

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual bufferVar.timestamps When enabled by the bufferVar.collecttimestamps attribute, this attribute contains the timestamp when each reading saved in the specified reading buffer occurred. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Buffer storage settings...
  • Page 416: Buffervar.units

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference bufferVar.units This attribute contains the unit of measure that is stored with readings in the reading buffer. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Clearing the buffer USB flash drive using Not applicable Instrument reset...
  • Page 417: Channel.calibration.adjustcount()

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual channel.calibration.adjustcount() This function gets the number of times that a card has been adjusted. Type TSP-Link accessible Affected by Where saved Default value Function Usage count = channel.calibration.adjustcount("slotX") count Return value representing the number of times the instrument has been adjusted The slot number ( 1 to 6) Details...
  • Page 418 Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference Details This command can get the adjust date whether calibration is currently locked or unlocked. If the channelList parameter is not specified, it uses the currently unlocked card. This command can only set the adjustment date on a previously unlocked card. The date is not permanently saved until the channel.calibration.save() command is sent.
  • Page 419: Channel.calibration.lock()

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual channel.calibration.lock() This function prevents further calibration on the currently unlocked card. Type TSP-Link accessible Affected by Where saved Default value Function Usage channel.calibration.lock() Details Calibration data is locked during normal operation. To perform calibration, calibration must be unlocked (channel.calibration.unlock()) for the card.
  • Page 420: Channel.calibration.save()

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference Details There is only one password per card. Therefore, channel.calibration.password() works only on the currently unlocked card. Make note of the password, because there is no command to query for the password once it has been set on the instrument.
  • Page 421: Channel.calibration.step()

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual Example channel.calibration.unlock("slot1","KI3706") -- Perform operations to generate the calibration data channel.calibration.save() channel.calibration.lock() Unlock the card calibration for slot 1 using the default password. Use the channel.calibration.step command to generate the calibration data. Save the calibration data for the card in slot 1, if no errors occurred while generating the calibration data.
  • Page 422 Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference 6. Send reading. 7. Set voltage, –12 V to +12 V range, generate positive point 2. 8. Send reading. 9. Set current, 0 mA to +20 mA range, generate point 1. 10.
  • Page 423: Channel.calibration.unlock()

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual channel.calibration.unlock() This function unlocks calibration functionality for a card so that calibration operations can be performed. Type TSP-Link accessible Affected by Where saved Default value Function Usage channel.calibration.unlock("slotX", password) The slot number ( 1 to 6) password The password that unlocks calibration...
  • Page 424: Channel.calibration.verifydate()

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference channel.calibration.verifydate() This function gets or sets the date the calibration was verified in UTC format (number of seconds since January 1, 1970). Type TSP-Link accessible Affected by Where saved Default value Function Usage...
  • Page 425: Channel.clearforbidden()

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual channel.clearforbidden() This function clears the list of channels specified from being forbidden to close. Type TSP-Link accessible Affected by Where saved Default value Function Usage channel.clearforbidden("channelList") channelList The channels to set, using standard channel naming Details The channelList parameter indicates the channels that will no longer be forbidden to close, and may include:...
  • Page 426 Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference Details Channels closed with this command are appended to the already closed channels (no previously closed channels are opened by this command). The channelList parameter can include channels with analog backplane relays. If this is the case, channel.close closes the specified channels and any associated analog backplane relays.
  • Page 427: Channel.connectrule

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual Example channel.close("1001:1005, 3003, Chans") Close channels 1 to 5 on slot 1, channel 3 on slot 3, and the channel pattern or label Chans. channel.close("2001, 2913") Close channel 1 on slot 2 and analog backplane relay 3 in bank 1 on slot 2.
  • Page 428 Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference When the connection rule is set to break before make, the instrument ensures that all switch channels open before any switch channels close. When switch channels are both opened and closed, this command executes not less than the addition of both the open and close settle times of the indicated switch channels.
  • Page 429: Channel.connectsequential

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual channel.connectsequential This attribute controls whether or not channels are closed sequentially. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Instrument reset Create configuration script channel.OFF Recall setup Usage sequential = channel.connectsequential channel.connectsequential = sequential...
  • Page 430: Channel.createspecifier()

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference channel.createspecifier() This function creates a string channel descriptor from a series of card-dependent integer arguments. Type TSP-Link accessible Affected by Where saved Default value Function Usage specifier = channel.createspecifier(slotX, bank, row, column) specifier = channel.createspecifier(slotX, bank, column) specifier = channel.createspecifier(slotX, bank, index) specifier = channel.createspecifier(slotX, index)
  • Page 431: Channel.exclusiveclose()

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual Example 4 cd = createspecifier(1, 911) Creates a channel descriptor on the Model print(cd) 3724 multiplexer card in slot 1, backplane 911. Output: 1911 Also see None channel.exclusiveclose() This function closes the specified channels so that they are the only channels that are closed on the instrument. Type TSP-Link accessible Affected by...
  • Page 432 Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference An error is generated if: • 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 •...
  • Page 433: Channel.exclusiveslotclose()

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual channel.exclusiveslotclose() This function closes the specified channels and channel patterns on the associated slots and opens any channels that are not specified. Type TSP-Link accessible Affected by Where saved Default value Function Usage...
  • Page 434: Channel.getbackplane()

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference Once an error is detected, the command stops processing. Channels open or close only if no errors are found and remain unchanged with any parsing or syntax error. Example channel.exclusiveslotclose("3003") channel.exclusiveslotclose("1005, 2005") channel.pattern.setimage("5007, 5017, 5027, 5915,"...
  • Page 435 Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual The response will be changed by channel.setbackplane(), replacing the analog backplane relays with the new specified list. The response will be cleared if channel.setpole() sets a new pole selection. The analog backplane relays indicated by this response are not used or affected by: •...
  • Page 436 Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference Example channel.setpole("slot5", 4) Assume a Model 3720 in slot 5. channel.setbackplane("slot5", "5911, 5922") Set all channels on the card in slot 5 to be 4- print(channel.getbackplane("slot5")) pole, which makes the card have 30 4-pole channels.
  • Page 437: Channel.getclose()

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual channel.getclose() This function queries for the closed channels indicated by the channel list parameter. Type TSP-Link accessible Affected by Where saved Default value Function Usage closed = channel.getclose("channelList") closed A string listing the channels that are presently closed in the specified channel list parameter channelList...
  • Page 438: Channel.getcount()

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference Example 4 closedRange = channel.getclose("3001:3020") Gets all channels that are closed on channels 1 to 20 on slot 3. Example 5 closedOnes = channel.getclose("3001, 3002, Gets all channels that are closed on 3003, 3005, 3911, 3912") channels 1, 2, 3, 5 and analog backplane relay 1 and 2 in bank 1 on slot 3.
  • Page 439 Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual If channels are specified, the count values are returned in the order in which the channels are specified. If slots are specified, the response lists the channels starting from lowest to highest. Because each slot is processed completely before going to the next, all slot 1 channels and analog backplane relays are listed before slot 2 channels.
  • Page 440: Channel.getdelay()

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference channel.getdelay() This function queries for the additional delay time for the specified channels. Type TSP-Link accessible Affected by Where saved Default value Function Usage delayTimes = channel.getdelay("channelList") delayTimes A comma-delimited string consisting of the delay times (in seconds) for channels specified in channelList channelList A string listing the channels to query for their delay times...
  • Page 441: Channel.getforbidden()

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual Example 2 patternChannels = Gets the delay of the channels in the chans channel.pattern.get("chans") channel pattern if chans does not contain DelayPatternTimes = backplane relays. If it does contain channel.getdelay(patternChannels) backplane relays, you will receive error code 1115, "Parameter error invalid channel type...
  • Page 442: Channel.getimage()

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference Example 2 channel.setforbidden("3003, 3005, 3925") Set channels 3 and 5 and analog backplane Forbidden = relay 5 in bank 2 to forbidden to close on channel.getforbidden("slot3") slot 3. print(Forbidden) Query for the channels and analog backplane relays that are forbidden to close on slot 3.
  • Page 443: Channel.getlabel()

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual Example 1 channel.setpole("2005", 2) Set channel 5 on slot 2 for a 2-wire switch channel.setbackplane("2005", "2911") application. channels = channel.getimage("2005") Associate analog backplane relay 1 in bank 1 print(channels) on slot 2 with channel 5 on slot 2.
  • Page 444: Channel.getmatch()

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference Usage label = channel.getlabel("channelList") label A string listing the comma-delimited labels for items in channelList channelList A string listing the channels to query for the label associated with them Details The channelList parameter can contain more than one channel.
  • Page 445: Channel.getmatchtype()

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual Details If a width greater than 1 is specified with channel.setmatch(), the matchValue contains the additional channel width specified at set time. For example, the value of 65535 with a width of 2 returns 65535.
  • Page 446: Channel.getmode()

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference Details The channel match types are: • 1 for match exactly • 2 for match any • 3 for match not exact • 4 for match none Digital analog converter, backplane, and switch channels are not supported. If these channels are included in a range or slot specifier, they are ignored;...
  • Page 447 Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual For totalizer channels, the following modes are supported: • channel.MODE_RISING_EDGE or 1 • channel.MODE_FALLING_EDGE or 0 • channel.MODE_RISING_TTL_EDGE (default) or 3 • channel.MODE_FALLING_TTL_EDGE or 2 • channel.MODE_RISING_EDGE_READ_RESET or 5 •...
  • Page 448: Channel.getoutputenable()

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference channel.getoutputenable() This function gets the present output enable attribute for a channel. Type TSP-Link accessible Affected by Where saved Default value Function Instrument reset Create configuration script Channel reset Save setup Recall setup Usage...
  • Page 449: Channel.getpole()

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual channel.getpole() This function queries the pole settings for the specified channels. Type TSP-Link accessible Affected by Where saved Default value Function Instrument reset Create configuration script Card dependent, typically 2 Channel reset Save setup Recall setup...
  • Page 450: Channel.getpowerstate()

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference Example channel.reset("slot5") Reset the channels on slot 5 only. channel.setpole("5003, 5007", 4) Set the pole attribute for channels 3 and 7 on polesSlot5 = channel.getpole("5001, 5003, 5005, slot 5 to be 4. 5007") Query channels 1, 3, 5, and 7 on slot 5 for print(polesSlot5)
  • Page 451: Channel.getstate()

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual channel.getstate() This function returns the state indicators of the channels in the instrument. Type TSP-Link accessible Affected by Where saved Default value Function Instrument reset Not saved Channel reset Recall setup Usage state = channel.getstate("channelList")
  • Page 452 Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference Example 1 channel.close("4005, 4007, 4017, 4003") Close channels 5, 7, 17, and 3 on slot 4. State = channel.getstate("4001:4020") Query the state of the first 20 channels on print(State) slot 4.
  • Page 453: Channel.getstatelatch()

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual channel.getstatelatch() This function gets the mask representing the states that would be latched if they occurred. Type TSP-Link accessible Affected by Where saved Default value Function Instrument reset Create configuration script 14 for overload, match, and Channel reset Save setup...
  • Page 454: Channel.gettype()

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference channel.gettype() This function returns the type associated with a channel. Type TSP-Link accessible Affected by Where saved Default value Function Usage type = channel.gettype("channelList") type Returns a comma-delimited list of the type of channels in channelList channelList String specifying the channels to query, using normal channelList syntax Details...
  • Page 455: Channel.open()

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual channel.open() This function opens the specified channels, analog backplane relays, and channel patterns. Type TSP-Link accessible Affected by Where saved Default value Function Usage channel.open("channelList") channelList String listing the channels, analog backplane relays, and channel patterns to open Details This function opens the specified channels based on the switching configuration of the channel.
  • Page 456: Channel.pattern.catalog()

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference Also see channel.close() (on page 11-46) channel.exclusiveclose() (on page 11-52) channel.exclusiveslotclose() (on page 11-54) channel.getclose() (on page 11-58) channel.getdelay() (on page 11-61) channel.pattern.getimage() (on page 11-78) channel.pattern.setimage() (on page 11-79) channel.pattern.snapshot() (on page 11-82) channel.getstate()
  • Page 457: Channel.pattern.delete()

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual channel.pattern.delete() This function deletes a channel pattern. Type TSP-Link accessible Affected by Where saved Default value Function Usage channel.pattern.delete("name") name A string representing the name of the channel pattern to delete Details An error is generated if the name does not exist as a channel pattern.
  • Page 458: Channel.pattern.setimage()

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference Example -- Set up two patterns channel.pattern.setimage("4001:4005", "myPattern") channel.pattern.setimage("2001,2003,2005", "myRoute") -- Print images myImage = channel.pattern.getimage("myPattern") print(myImage) print(channel.pattern.getimage("myRoute")) print(channel.pattern.getimage("myRoute, myPattern")) Using a Model 3721 (or similar model) card in slots 2 and 4, this example creates two channel patterns and then queries these patterns.
  • Page 459 Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual The channel pattern is not created if an error is detected. You can create a channel pattern with an empty channelList parameter. This will create a pattern that has no channels or analog backplane relays associated with it.
  • Page 460 ▪ The pattern name exceeds 19 characters Example 1 channel.pattern.setimage("3001:3010", "Channels") For this example, assume there is a Keithley Model 3721 or similar card in oldList = channel.pattern.getimage("Channels") slot 3. newList = oldList .. ", 3911" channel.pattern.delete("Channels") Create a pattern.
  • Page 461: Channel.pattern.snapshot()

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual channel.pattern.snapshot() This function creates a channel pattern. Type TSP-Link accessible Affected by Where saved Default value Function Instrument reset Create configuration script Not applicable Channel reset Save setup Recall setup Pole setting change Usage channel.pattern.snapshot("name")
  • Page 462: Channel.read()

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference Channels of type DAC, totalizer, and digital I/O are ignored. Channel patterns are stored when you run the createconfigscript() command or setup.save() command. Channel patterns are lost when power is cycled. Use setup.recall() or a script created with createconfigscript() to restore them.
  • Page 463: Channel.reset()

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual Details For digital I/O channels, only a width of 1, 2, 3, or 4 is supported. Any information (bits) greater than the specified width is returned as zero. For example, if channels 1 and 2 are both 255, a reading with a width of 1 returns 255 and a width of 2 with channel 1 returns 65535.
  • Page 464 Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference Details For the items specified in channelList, the following actions occur: • Any closed channels and analog backplane relays open • Any 4-pole channels reset to 2-pole operation and their paired channels are changed to match •...
  • Page 465: Channel.resetstatelatch()

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual channel.resetstatelatch() This function resets the channel state. Type TSP-Link accessible Affected by Where saved Default value Function Usage channel.resetstatelatch("channelList", state) channelList String that specifies the channels that need to have their states reset, using normal channel list syntax state The comma-delimited states for channels in channelList that are to have their...
  • Page 466: Channel.setbackplane()

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference channel.setbackplane() This function specifies the list of analog backplane relays to use with the specified channels when they are used in switching applications. Type TSP-Link accessible Affected by Where saved Default value Function Instrument reset...
  • Page 467 Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual Calling this function on an existing channel involved in scanning invalidates the existing scan list. 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. •...
  • Page 468: Channel.setdelay()

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference Also see channel.close() (on page 11-46) channel.exclusiveclose() (on page 11-52) channel.getbackplane() (on page 11-55) channel.open() (on page 11-76) channel.setpole() (on page 11-96) scan.background() (on page 11-313) scan.execute() (on page 11-317) channel.setdelay() This function sets additional delay time for specified channels.
  • Page 469: Channel.setforbidden()

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual Example 1 channel.setdelay("5001, 5003" , 50e-6) Sets channels 1 and 3 on slot 5 for a delay time of 50 µs. Example 2 channel.setdelay ("slot3", 0) Sets the channels on slot 3 for 0 delay time. Also see channel.getdelay() (on page 11-61)
  • Page 470: Channel.setlabel()

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference Example channel.setforbidden("2002,2004,2006,2008") Marks channels 2, 4, 6, and 8 of slot 2 as forbidden to close. channel.setforbidden("slot3") Marks all channels and analog backplane relays on slot 3 as forbidden to close. Also see channel.clearforbidden() (on page 11-46)
  • Page 471: Channel.setmatch()

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual Example 3 channel.setlabel("3001", " ") Also clears the label for channel 1 slot 3 back to "3001". Also see Channel (on page 9-23) channel.setmatch() This function sets the match value on a digital input or totalizer channel. Type TSP-Link accessible Affected by...
  • Page 472: Channel.setmatchtype()

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference Also see channel.getmatch() (on page 11-65) channel.setmatchtype() This function sets the match type on a channel. Type TSP-Link accessible Affected by Where saved Default value Function Instrument reset Create configuration script channel.MATCH_NONE Channel reset Save setup...
  • Page 473: Channel.setmode()

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual channel.setmode() This function sets the mode of operation of a channel. Type TSP-Link accessible Affected by Where saved Default value Function Instrument reset Create configuration script Digital I/O: 0 (channel.MODE_INPUT) Channel reset Save setup Totalizer: 3...
  • Page 474: Channel.setoutputenable()

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference Changing the mode setting can impact the power consumption of the card. The instrument verifies that power is available before changing the mode. If an insufficient power capability exists, the command generates an error.
  • Page 475: Channel.setpole()

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual For DAC channels, changing the output state to on adds an additional channel delay to channel.setdelay(). Channels with output set to off consume less power. Changing the output setting impacts the power consumption of the card. The instrument verifies that power is available before changing the mode.
  • Page 476 Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference You manipulate the analog backplane relays after setting the pole setting by using the channel.setbackplane() function for channels. For channels, as the pole setting changes, their analog backplane relays, specified by channel.setbackplane(), get cleared. Therefore, after a pole setting change, you need to add the analog backplane relays for the pole setting by using channel.setbackplane().
  • Page 477 Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual Example 2 channel.reset("slot2") Assuming a 3721, reset channels on slot 2 only. channel.setpole(channel.POLES_FOUR) Set channels on slot 2 to 4-pole. channel.close("2001, 2003") Close channels 1 and 3 on slot 2. print(channel.getclose("slot2")) Query slot 2 for closed channels and analog backplane relays.
  • Page 478: Channel.setpowerstate()

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference channel.setpowerstate() This function sets the power state on a channel. Type TSP-Link accessible Affected by Where saved Default value Function Instrument reset Create configuration script Dependent on installed card, but Channel reset Save setup usually 1 (channel.ON)
  • Page 479: Channel.setstatelatch()

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual channel.setstatelatch() This function sets the state indicators to either latching or nonlatching. Type TSP-Link accessible Affected by Where saved Default value Function Instrument reset Create configuration script 14 for overload, match, and Channel reset Save setup overflow...
  • Page 480: Channel.trigger[N].Clear()

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference channel.trigger[N].clear() This function clears any pending events. Type TSP-Link accessible Affected by Where saved Default value Function Usage channel.trigger[N].clear() Number indicating the trigger line to clear (1 to 8) Details This function clears any pending events for the channel trigger specified by N.
  • Page 481: Channel.trigger[N].Get()

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual channel.trigger[N].get() This function gets the channel status trigger information that is used to watch the state of a specific channel. Type TSP-Link accessible Affected by Where saved Default value Function Instrument reset Create configuration script...
  • Page 482: Channel.trigger[N].Set()

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference channel.trigger[N].set() This function sets the channel status trigger model to watch the state of a specific channel. Type TSP-Link accessible Affected by Where saved Default value Function Instrument reset Create configuration script Empty channel list Channel reset...
  • Page 483: Channel.trigger[N].Wait()

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual channel.trigger[N].wait() This function waits for the specified trigger or timeout period, whichever comes first. Type TSP-Link accessible Affected by Where saved Default value Function Usage triggered = channel.trigger[N].wait(timeout) triggered Returns an indication that a trigger occurred Number indicating the channel trigger to wait for (1 to 8) timeout...
  • Page 484: Channel.write()

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference channel.write() This function writes a value to a channel. Type TSP-Link accessible Affected by Where saved Default value Function Usage channel.write("channelList", value) channel.write("channelList", value, width) channelList The channels to set, using standard channel naming value The value to be written to the channel (must be decimal value) width...
  • Page 485: Comm.gpib.enable

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual comm.gpib.enable This attribute describes whether or not communication using the GPIB connection is enabled. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Not applicable Nonvolatile true (enabled) memory Usage state = comm.gpib.enable...
  • Page 486: Comm.lan.rawsockets.enable

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference comm.lan.rawsockets.enable This attribute describes whether or not communication using raw socket is enabled. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Not applicable Nonvolatile true (enabled) memory Usage state = comm.lan.rawsockets.enable...
  • Page 487: Comm.lan.vxi11.Enable

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual Example comm.lan.enable = true Enable all LAN communication with comm.lan.telnet.enable = false instrument, then disable only Telnet over the LAN. Also see comm.lan.enable (on page 11-106) comm.lan.rawsockets.enable (on page 11-107) comm.lan.vxi11.enable (on page 11-108) comm.lan.web.enable...
  • Page 488: Comm.lan.web.enable

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference comm.lan.web.enable This attribute describes whether or not communication using the web interface is enabled. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Not applicable Nonvolatile true (enabled) memory Usage state = comm.lan.web.enable...
  • Page 489: Createconfigscript()

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual createconfigscript() This function creates a setup file that captures most of the present settings of the instrument. Type TSP-Link accessible Affected by Where saved Default value Function Usage createconfigscript("scriptName") scriptName A string that represents the name of the script that will be created Details...
  • Page 490: Dataqueue.capacity

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference Details You cannot use the timeout value when accessing the data queue from a remote node (you can only use the timeout value while adding data to the local data queue). The timeout value is ignored if the data queue is not full.
  • Page 491: Dataqueue.clear()

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual Example MaxCount = dataqueue.CAPACITY This example fills the data queue until it is full while dataqueue.count < MaxCount do and prints the number of items in the queue. dataqueue.add(1) Output: There are 128 items in the data queue...
  • Page 492: Dataqueue.count

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference dataqueue.count This attribute contains the number of items in the data queue. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Not applicable Not applicable Not applicable Usage count = dataqueue.count count...
  • Page 493: Dataqueue.next()

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual dataqueue.next() This function removes the next entry from the data queue. Type TSP-Link accessible Affected by Where saved Default value Function Usage value = dataqueue.next() value = dataqueue.next(timeout) value The next entry in the data queue timeout The number of seconds to wait for data in the queue...
  • Page 494: Delay()

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference delay() This function delays the execution of the commands that follow it. Type TSP-Link accessible Affected by Where saved Default value Function Usage delay(seconds) seconds The number of seconds to delay (0 to 100 ks) Details The instrument delays execution of the commands for at least the specified number of seconds and fractional seconds.
  • Page 495: Digio.readport()

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual digio.readport() This function reads the digital I/O port. Type TSP-Link accessible Affected by Where saved Default value Function Usage data = digio.readport() data The present value of the input lines on the digital I/O port Details The binary equivalent of the returned value indicates the value of the input lines on the I/O port.
  • Page 496: Digio.trigger[N].Clear()

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference digio.trigger[N].clear() This function clears the trigger event on a digital I/O line. Type TSP-Link accessible Affected by Where saved Default value Function Usage digio.trigger[N].clear() Digital I/O trigger line (1 to 14) Details The event detector of a trigger enters the detected state when an event is detected.
  • Page 497: Digio.trigger[N].Mode

    If the programmed state of the line is low, the digio.TRIG_RISING mode behavior is similar to digio.TRIG_RISINGM. This setting should only be used if necessary for compatibility with other Keithley Instruments products. digio.TRIG_EITHER or 3 Detects rising- or falling-edge triggers as input. Asserts a TTL-low pulse for output.
  • Page 498: Digio.trigger[N].Overrun

    Use of either digio.TRIG_SYNCHRONOUSA or digio.TRIG_SYNCHRONOUSM is preferred over digio.TRIG_SYNCHRONOUS, because digio.TRIG_SYNCHRONOUS is provided for compatibility with the digital I/O and TSP-Link triggering on other Keithley Instruments products. To control the line state, set the mode to digio.TRIG_BYPASS and use the digio.writebit() and digio.writeport() commands.
  • Page 499: Digio.trigger[N].Pulsewidth

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual Details If this is true, an event was ignored because the event detector was already in the detected state when the event occurred. This is an indication of the state of the event detector built into the line itself. It does not indicate if an overrun occurred in any other part of the trigger model or in any other detector that is monitoring the event.
  • Page 500: Digio.trigger[N].Release()

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference digio.trigger[N].release() This function releases an indefinite length or latched trigger. Type TSP-Link accessible Affected by Where saved Default value Function Usage digio.trigger[N].release() Digital I/O trigger line (1 to 14) Details Releases a trigger that was asserted with an indefinite pulsewidth time.
  • Page 501: Digio.trigger[N].Stimulus

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual Example digio.trigger[3].mode = 2 digio.trigger[3].pulsewidth = 50e-6 digio.trigger[3].stimulus = digio.trigger[5].EVENT_ID print(digio.trigger[3].mode, digio.trigger[3].pulsewidth, digio.trigger[3].stimulus) digio.trigger[3].reset() print(digio.trigger[3].mode, digio.trigger[3].pulsewidth, digio.trigger[3].stimulus) Set the digital I/O trigger line 3 for a falling edge with a pulsewidth of 50 µs. Use digital I/O line 5 to trigger the event on line 3.
  • Page 502 Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference Trigger event ID Description channel.trigger[N].EVENT_ID A channel trigger event starts the scan. 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.
  • Page 503: Digio.trigger[N].Wait()

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual digio.trigger[N].wait() This function waits for a trigger. Type TSP-Link accessible Affected by Where saved Default value Function Usage triggered = digio.trigger[N].wait(timeout) triggered The value true if a trigger is detected, or false if no triggers are detected during the timeout period Digital I/O trigger line (1 to 14) timeout...
  • Page 504: Digio.writeport()

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference Details If the output line is write-protected using the digio.writeprotect attribute, the command is ignored. The reset() function does not affect the present state of the digital I/O lines. Use the digio.writebit() and digio.writeport() commands to control the output state of the synchronization line when trigger operation is set to digio.TRIG_BYPASS.
  • Page 505: Digio.writeprotect

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual digio.writeprotect This attribute contains the write-protect mask that protects bits from changes from the digio.writebit() and digio.writeport() functions. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Instrument reset Create configuration script Recall setup...
  • Page 506: Display.getannunciators()

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference display.getannunciators() This function reads the annunciators (indicators) that are presently turned on. Type TSP-Link accessible Affected by Where saved Default value Function Usage annunciators = display.getannunciators() annunciators The bitmasked value that shows which indicators are turned on Details This function returns a bitmasked value showing which indicators are turned on.
  • Page 507: Display.getcursor()

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual Example 2 Output: print(display.ANNUNCIATOR_EDIT) 2.56000e+02 print(display.ANNUNCIATOR_TRIGGER) 3.20000e+01 print(display.ANNUNCIATOR_AUTO) 8.00000e+00 Also see bit.bitand() (on page 11-9) display.getcursor() This function reads the present position of the cursor on the front-panel display. Type TSP-Link accessible Affected by...
  • Page 508: Display.getlastkey()

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference Also see display.gettext() (on page 11-130) display.screen (on page 11-138) display.setcursor() (on page 11-140) display.settext() (on page 11-141) display.getlastkey() This function retrieves the key code for the last pressed key. Type TSP-Link accessible Affected by...
  • Page 509: Display.gettext()

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual Example key = display.getlastkey() On the front panel, press the MENU key and print(key) then send the code shown here. This retrieves the key code for the last pressed key. Output: 6.80000e+01 Also see...
  • Page 510: Display.inputvalue()

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference Example 1 display.clear() display.setcursor(1, 1) display.settext("ABCDEFGHIJ$DKLMNOPQRST") display.setcursor(2, 1) display.settext("abcdefghijklm$Bnopqrstuvwxyz$F123456") print(display.gettext()) print(display.gettext(true)) print(display.gettext(false, 2)) print(display.gettext(true, 2, 9)) print(display.gettext(false, 2, 9, 10)) This example shows how to retrieve the display text in multiple ways. The output is: ABCDEFGHIJKLMNOPQRST$Nabcdefghijklmnopqrstuvwxyz123456 $RABCDEFGHIJ$DKLMNOPQRST$N$Rabcdefghijklm$Bnopqrstuvwxyz$F123456 abcdefghijklmnopqrstuvwxyz123456...
  • Page 511 Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual Details The format parameter uses zeros (0), the decimal point, polarity sign, and exponents to define how the input field is formatted. The format parameter can include the options shown in the following table.
  • Page 512: Display.loadmenu.add()

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference display.loadmenu.add() This function adds an entry to the USER TESTS menu, which can be accessed by pressing the LOAD key on the front panel. Type TSP-Link accessible Affected by Where saved Default value Function...
  • Page 513: Display.loadmenu.catalog()

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual Example 2 display.loadmenu.add("Test", "DUT1() beeper.beep(2, 500)", display.SAVE) Assume a script with a function named “DUT1” has already been loaded into the instrument, and the script has not been saved in nonvolatile memory. Now assume you want to add a test named “Test”...
  • Page 514: Display.loadmenu.delete()

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference display.loadmenu.delete() This function removes an entry from the USER TESTS menu, which can be accessed using the LOAD key on the front panel. Type TSP-Link accessible Affected by Where saved Default value Function Usage...
  • Page 515: Display.menu()

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual Example display.locallockout = display.LOCK Disables the front-panel EXIT (LOCAL) key. Also see None display.menu() This function presents a menu on the front-panel display. Type TSP-Link accessible Affected by Where saved Default value Function Usage...
  • Page 516: Display.prompt()

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference display.prompt() This function prompts the user to enter a parameter from the front panel of the instrument. Type TSP-Link accessible Affected by Where saved Default value Function Usage display.prompt("format", "units", "help") display.prompt("format", "units", "help", default) display.prompt("format", "units", "help", default, minimum) display.prompt("format", "units", "help", default, minimum, maximum)
  • Page 517: Display.screen

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual For positive and negative entry (plus sign (+) used for the value field and the exponent field), polarity of a nonzero value or exponent can be toggled by positioning the cursor on the polarity sign and turning the navigation wheel .
  • Page 518: Display.sendkey()

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference display.sendkey() This function sends a code that simulates the action of a front-panel control. Type TSP-Link accessible Affected by Where saved Default value Function Usage display.sendkey(keyCode) keyCode A parameter that specifies the key press to simulate; see Details for more information Details This command simulates pressing a front-panel key or navigation wheel, or turning the navigation...
  • Page 519: Display.setcursor()

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual display.setcursor() This function sets the position of the cursor. Type TSP-Link accessible Affected by Where saved Default value Function Usage display.setcursor(row, column) display.setcursor(row, column, style) The row number for the cursor (1 or 2) column The active column position to set;...
  • Page 520: Display.settext()

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference display.settext() This function displays text on the front-panel user screen. Type TSP-Link accessible Affected by Where saved Default value Function Usage display.settext("text") text Text message to be displayed, with optional character codes Details This function selects the user display screen and displays the given text.
  • Page 521: Display.trigger.event_Id

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual Also see display.clear() (on page 11-126) display.getcursor() (on page 11-128) display.gettext() (on page 11-130) display.screen (on page 11-138) display.setcursor() (on page 11-140) display.trigger.EVENT_ID This constant is the event ID of the event generated when the front-panel TRIG key is pressed. Type TSP-Link accessible Affected by...
  • Page 522 Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference A typical use for this function is to prompt the user to press the EXIT (LOCAL) key to abort the script or press any other key to continue. For example, if the keyCode value 67 is returned (the EXIT (LOCAL) key was pressed), the exit() function can be called to abort the script.
  • Page 523: Dmm.adjustment.count

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual dmm.adjustment.count This attribute indicates the number of times the instrument has been adjusted (calibrated). Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Not applicable Nonvolatile Not applicable memory Usage calibrationCount = dmm.adjustment.count...
  • Page 524: Dmm.aperture

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference Example 2 print(os.date("%m/%d/%Y", dmm.adjustment.date)) Queries the date and formats the response as mm/dd/yyyy: 07/04/2007 Example 3 print(os.date("%x", dmm.adjustment.date)) Queries the date and formats the response as mm/dd/yy: 02/24/09 Also see dmm.adjustment.count (on page 11-144) dmm.calibration.unlock()
  • Page 525: Dmm.appendbuffer()

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual The aperture setting is not available for the functions "continuity" and "nofunction". If you query the aperture when either of these functions is selected, nil is returned. If you write the command when either of these functions is selected, an error is generated.
  • Page 526 Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference Details For options that save more than one item of time information, each item is comma delimited. For example, the default format will be <date>, <time>, and <fractional seconds> for each reading, separated by commas.
  • Page 527: Dmm.autodelay

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual dmm.autodelay This attribute enables or disables the automatic delay that occurs before each measurement. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Yes Function change Create configuration script 2 (dmm.AUTODELAY_ONCE) DMM close Save setup...
  • Page 528: Dmm.autorange

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference Also see Autodelay (on page 4-4) dmm.configure.recall() (on page 11-165) dmm.configure.set() (on page 11-166) dmm.func (on page 11-179) dmm.measurecount (on page 11-206) dmm.autorange This attribute specifies the autorange setting for the active function Type TSP-Link accessible Affected by...
  • Page 529: Dmm.autozero

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual Example 1 dmm.func = "twowireohms" Enable autoranging for 2-wire ohms. dmm.autorange = dmm.ON Example 2 dmm.func = "dcvolts" Set DMM function to be DC volts. dmm.reset("active") Reset only the active DMM function (DC volts). print(dmm.autorange, dmm.range) View the default autorange and range selection.
  • Page 530 Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference An error is generated if: • You try to set dmm.autozero for "continuity" or "nofunction". Error code 1114, "Setting conflicts with function selected," is generated. • You query dmm.autozero for "continuity" or "nofunction". nil is returned with error code 1114, "Setting conflicts with function selected."...
  • Page 531: Dmm.buffer.catalog()

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual dmm.buffer.catalog() This function creates an iterator for the user-created reading buffers. Type TSP-Link accessible Affected by Where saved Default value Function Usage for name in dmm.buffer.catalog() do...end name A string representing the name of a user created DMM reading buffer Details You can access the catalog for the user-created local reading buffers so that you can print the names of all reading buffers in the system.
  • Page 532 Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference dmm.buffer.info() This function returns the size and capacity of the reading buffer parameter. Type TSP-Link accessible Affected by Where saved Default value Function Usage size, capacity = dmm.buffer.info(bufferVar) size Number representing the N (presently stored) attribute of the reading buffer parameter capacity...
  • Page 533: Dmm.buffer.maxcapacity

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual dmm.buffer.maxcapacity This attribute returns the overall maximum capacity for reading buffers in the instrument. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Never Not applicable Not applicable Usage maximumCapacity = dmm.buffer.maxcapacity maximumCapacity...
  • Page 534: Dmm.calibration.ac()

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference Example buf1 = dmm.makebuffer(300000) Create buffers. buf2 = dmm.makebuffer(300000) Reads the used reading buffer capacity for the system. print(dmm.buffer.usedcapacity) 6.000000000e+05 print(dmm.buffer.maxcapacity - 5.000000000e+04 dmm.buffer.usedcapacity) This shows that there is a capacity of 50,000 available for creating additional reading buffers.
  • Page 535: Dmm.calibration.dc()

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual dmm.calibration.dc() This function begins a DC adjustment step on the DMM. Type TSP-Link accessible Affected by Where saved Default value Function Usage dmm.calibration.dc(step) dmm.calibration.dc(step, value) step The DC adjustment step to perform value The value for this adjustment step (if the adjustment step has a value) Details...
  • Page 536: Dmm.calibration.password

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference Example dmm.calibration.save() Save calibration, then lock it. dmm.calibration.lock() Also see dmm.calibration.unlock() (on page 11-158) dmm.calibration.save() (on page 11-157) dmm.calibration.password This attribute sets the password that must be entered before you can unlock calibration. Type TSP-Link accessible Affected by...
  • Page 537: Dmm.calibration.unlock()

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual Details This command saves the calibration constants and adjustment date and increases the adjustment count by 1. The adjustment count is the number of times calibration has been saved. This command does not check for errors in calibration data.
  • Page 538: Dmm.calibration.verifydate

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference dmm.calibration.verifydate This attribute sets or queries the calibration verification date in UTC format (number of seconds since January 1, 1970). Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Not applicable DMM nonvolatile memory...
  • Page 539: Dmm.close()

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual dmm.close() This function closes the specified channel or channel pattern to prepare for a measurement. Type TSP-Link accessible Affected by Where saved Default value Function Usage dmm.close("channelList") channelList A string that lists the channel or channel pattern to close Details When you close a channel or channel pattern: •...
  • Page 540: Dmm.configure.catalog()

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference An error is generated if: • The specified channel or channel pattern is invalid. • The channel number does not exist for the slot specified. • The channel pattern does not exist. •...
  • Page 541: Dmm.configure.delete()

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual Example for name in dmm.configure.catalog() do Prints the names of all user-created DMM print(name) configurations in the instrument. The output will look similar to: TestDcv TestTemperature TestTwoWire This indicates there are three user-created DMM configurations in the instrument with the names TestDCV, TestTemperature, and TestTwoWire.
  • Page 542: Dmm.configure.query()

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference dmm.configure.query() This function lists DMM settings associated with a configuration. Type TSP-Link accessible Affected by Where saved Default value Function Usage config = dmm.configure.query("userConfiguration") config = dmm.configure.query("userConfiguration", "userSeparator") config An output string that represents the DMM attribute settings of userConfiguration userConfiguration...
  • Page 543 Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual DCvConfigItems = dmm.configure.query("DCvConfig", "\n") print(DCvConfigItems) Lists the DMM attributes in DCvConfig separated by new lines. Output: function = dcvolts nplc = 5.000000E-001 aperture = 8.333333E-003 range = 1.000000E+001 auto zero = 0 auto delay = 2 filter enable = 0 filter type = 1...
  • Page 544: Dmm.configure.recall()

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference dmm.configure.recall() This function recalls a user or factory DMM configuration and replaces attributes in the present configuration with attributes from the recalled version. Type TSP-Link accessible Affected by Where saved Default value Function Usage...
  • Page 545: Dmm.configure.set()

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual Example dmm.func = "dcvolts" dmm.reset("active") dmm.nplc = 0.5 dmm.range = 10 dmm.configure.set("TestDcv") dmm.configure.recall("dcvolts") print(dmm.func, dmm.autorange, dmm.range, dmm.nplc) dmm.configure.recall("TestDcv") print(dmm.func, dmm.autorange, dmm.range, dmm.nplc) dmm.setconfig("slot1", "TestDcv") dmm.setconfig("2001:2015", "TestDcv") dmm.setconfig("3005", "TestDcv") Set the DMM to the DC volts function. Reset DC volts back to factory defaults.
  • Page 546 Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference Details This command saves the selected function and its pertinent settings. You can recall this configuration using dmm.configure.recall(). You can also apply the configuration using dmm.setconfig() to channels or channel patterns. dmm.configure.set() stores only pertinent settings.
  • Page 547: Dmm.connect

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual Example dmm.func = "dcvolts" dmm.reset("active") dmm.nplc = 0.5 dmm.range = 10 dmm.configure.set("TestDcv") dmm.configure.recall("dcvolts") print(dmm.func, dmm.autorange, dmm.range, dmm.nplc) dmm.configure.recall("TestDcv") print(dmm.func, dmm.autorange, dmm.range, dmm.nplc) Set the DMM to the DC volts function. Reset DC volts back to factory defaults.
  • Page 548 Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference Details Use of this command is not recommended with the exception of special cases. The default setting should handle most applications. This setting affects all DMM functions. Valid values are shown in the table below. Valid values Value Relays connected...
  • Page 549: Dmm.dbreference

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual dmm.dbreference This attribute defines the decibel (dB) reference setting for the DMM in volts. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Reset Create configuration script 1.000000E+00 DMM reset Save setup...
  • Page 550: Dmm.detectorbandwidth

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference dmm.detectorbandwidth This attribute sets the AC detector bandwidth setting for the DMM in Hertz. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Reset Create configuration script DMM reset Save setup Recall setup...
  • Page 551: Dmm.displaydigits

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual dmm.displaydigits This attribute determines the number of digits that are displayed for measurements on the front panel. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Reset Create configuration script See Details DMM reset...
  • Page 552: Dmm.drycircuit

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference dmm.drycircuit This attribute enables or disables the dry circuit feature of the 4-wire resistance measure function. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) reset Create configuration script 0 (dmm.OFF) DMM reset Save setup...
  • Page 553: Dmm.filter.count

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual dmm.filter.count This attribute sets the filter count setting for the selected DMM function. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Reset Create configuration script DMM reset Save setup Recall setup Usage...
  • Page 554: Dmm.filter.enable

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference dmm.filter.enable This attribute enables or disables the averaging filter for measurements of the selected function. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Reset Create configuration script 0 (dmm.OFF) DMM reset Save setup...
  • Page 555: Dmm.filter.type

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual dmm.filter.type This attribute defines the type of averaging filter that is used for the selected measure function when the measurement filter is enabled. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Reset...
  • Page 556: Dmm.filter.window

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference The filter type setting is saved with the dmm.func function setting, so if you use another function, then return to the previous function, the filter type setting you set previously is retained. Example dmm.func = "twowireohms"...
  • Page 557 Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual Example dmm.func = "twowireohms" Set the filter window for 2-wire ohms to 0.25 dmm.filter.window = 0.25 and enable filtered measurements. dmm.filter.enable = dmm.ON Also see dmm.configure.recall() (on page 11-165) dmm.configure.set() (on page 11-166) dmm.filter.enable...
  • Page 558 Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference Also see dmm.configure.recall() (on page 11-165) dmm.configure.set() (on page 11-166) dmm.func (on page 11-179) dmm.transducer (on page 11-233) dmm.func This attribute selects the active measure function. Type TSP-Link accessible Affected by Where saved Default value...
  • Page 559 Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual Example dmm.func = "temperature" Makes "temperature" the active DMM function. dmm.func = "dcvolts" Check the NPLC setting for DC volts. dcv_nplc = dmm.nplc dmm.func = dmm.DC_VOLTS Example showing how the instrument retains values dmm.nplc = 0.5 for each function.
  • Page 560: Dmm.getconfig()

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference Also see dmm.configure.query() (on page 11-163) dmm.configure.recall() (on page 11-165) dmm.configure.set() (on page 11-166) dmm.getconfig() This function queries for the DMM configurations that are associated with the specified channels or channel patterns.
  • Page 561: Dmm.inputdivider

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual Also see dmm.close() (on page 11-160) dmm.configure.recall() (on page 11-165) dmm.configure.set() (on page 11-166) dmm.setconfig() (on page 11-227) scan.add() (on page 11-309) scan.create() (on page 11-315) dmm.inputdivider This attribute determines when the 10 MΩ input divider is enabled. Type TSP-Link accessible Affected by...
  • Page 562: Dmm.limit[Y].Autoclear

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference dmm.limit[Y].autoclear This attribute indicates if the test result for limit Y should be cleared automatically or not. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Reset Create configuration script 1 (dmm.ON) DMM reset...
  • Page 563: Dmm.limit[Y].Clear()

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual dmm.limit[Y].clear() This function clears the results of the limit test defined by Y. Type TSP-Link accessible Affected by Where saved Default value Function Usage dmm.limit[Y].clear() Limit number: 1 or 2 Details Use this command to clear the test results of limit Y when the limit auto clear option is turned off.
  • Page 564 Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference Details This attribute is valid for all functions except "continuity" and "nofunction". A nil response and an error are generated if the command is received when dmm.func is set to either of these functions.
  • Page 565 Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual dmm.func = "dcvolts" -- set the DMM for DC volts functionality dmm.reset("active") -- reset DC volts to default settings dmm.range = 10 -- set the range to 10 volts dmm.nplc = 0.1 -- set the nplc to 0.1 dmm.limit[1].autoclear = dmm.OFF...
  • Page 566: Dmm.limit[Y].High.fail

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference dmm.limit[Y].high.fail This attribute queries for the high test results of limit Y. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Reset Create configuration script DMM reset Save setup Recall setup Usage...
  • Page 567 Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual dmm.func = "dcvolts" -- set the DMM for DC volts functionality dmm.reset("active") -- reset DC volts to default settings dmm.range = 10 -- set the range to 10 volts dmm.nplc = 0.1 -- set the nplc to 0.1 dmm.limit[1].autoclear = dmm.OFF...
  • Page 568: Dmm.limit[Y].High.value

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference Also see Reading buffers (on page 6-7, on page 6-1) dmm.configure.recall() (on page 11-165) dmm.configure.set() (on page 11-166) dmm.func (on page 11-179) dmm.limit[Y].autoclear (on page 11-183) dmm.limit[Y].high.value This attribute specifies the upper limit for a limit test. Type TSP-Link accessible Affected by...
  • Page 569 Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual dmm.func = "dcvolts" -- set the DMM for DC volts functionality dmm.reset("active") -- reset DC volts to default settings dmm.range = 10 -- set the range to 10 volts dmm.nplc = 0.1 -- set the nplc to 0.1 dmm.limit[1].autoclear = dmm.OFF...
  • Page 570: Dmm.limit[Y].Low.fail

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference dmm.limit[Y].low.fail This attribute queries for the low test results of limit Y. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Reset Create configuration script DMM reset Save setup Recall setup Usage...
  • Page 571 Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual dmm.func = "dcvolts" -- set the DMM for DC volts functionality dmm.reset("active") -- reset DC volts to default settings dmm.range = 10 -- set the range to 10 volts dmm.nplc = 0.1 -- set the nplc to 0.1 dmm.limit[1].autoclear = dmm.OFF...
  • Page 572: Dmm.limit[Y].Low.value

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference dmm.limit[Y].low.value This attribute specifies the lower limit for limit tests. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Reset Create configuration script limit 1: -1.000000E+00 DMM reset Save setup limit 2: -2.000000E+00 Recall setup...
  • Page 573 Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual dmm.func = "dcvolts" -- set the DMM for DC volts functionality dmm.reset("active") -- reset DC volts to default settings dmm.range = 10 -- set the range to 10 volts dmm.nplc = 0.1 -- set the nplc to 0.1 dmm.limit[1].autoclear = dmm.OFF...
  • Page 574: Dmm.linesync

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference dmm.linesync This attribute determines if line synchronization is used during the measurement. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Reset Create configuration script 0 (dmm.OFF) DMM reset Save setup Recall setup...
  • Page 575: Dmm.makebuffer()

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual dmm.makebuffer() This function creates a user buffer for storing readings. Reading buffers are allocated dynamically. Type TSP-Link accessible Affected by Where saved Default value Function Reset Create configuration script None Recall setup Save setup...
  • Page 576 Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference To see readings, channels, and units: printbuffer(x, y, bufferVar, bufferVar.channels, bufferVar.units) Where x and y represent reading numbers to be returned. To see timestamps that are in buffer: bufferVar.collecttimestamps = 1 print(x, y, bufferVar, bufferVar.timestamps) Where x and y represent readings and timestamps for elements x to y.
  • Page 577: Dmm.math.enable

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual dmm.math.enable This attribute enables or disables math operations on measurements for the selected measurement function. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Reset Create configuration script 0 (dmm.OFF) DMM reset Save setup...
  • Page 578 Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference dmm.measure(MathBuffer) Store the 5 additional readings in MathBuffer with math operations enabled. printbuffer(1, 5, MathBuffer) printbuffer(6, MathBuffer.n, MathBuffer) View the readings with and without math operation. dmm.measurecount = 1 Take 3 additional math readings without using the buffer.
  • Page 579: Dmm.math.format

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual dmm.math.format This attribute specifies which math operation is performed on measurements when math operations are enabled. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Reset Create configuration script 2 (dmm.MATH_PERCENT) DMM reset Save setup...
  • Page 580: Dmm.math.mxb.bfactor

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference Example dmm.math.format = dmm.MATH_RECIPROCAL Enables the reciprocal operation on dmm.math.enable = dmm.ON measurements. Also see Math calculations (on page 4-49) dmm.configure.recall() (on page 11-165) dmm.configure.set() (on page 11-166) dmm.math.enable (on page 11-198) dmm.math.percent (on page 11-203)
  • Page 581: Dmm.math.mxb.mfactor

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual Also see Math calculations (on page 4-49) dmm.configure.recall() (on page 11-165) dmm.configure.set() (on page 11-166) dmm.math.format (on page 11-200) dmm.math.mxb.mfactor (on page 11-202) dmm.math.mxb.mfactor This attribute specifies the scale factor, m, for the y = mx + b math operation. Type TSP-Link accessible Affected by...
  • Page 582: Dmm.math.mxb.units

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference dmm.math.mxb.units This attribute specifies the unit character for the y = mX + b operation. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Reset Create configuration script DMM reset Save setup Recall setup...
  • Page 583 Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual Details This is not available for "nofunction". If command is queried when "nofunction" is selected, nil is returned. If it is written when "nofunction" is selected, an error is returned. This attribute represents the constant to use for percent when dmm.math.format = dmm.MATH_PERCENT.
  • Page 584: Dmm.measure()

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference dmm.measure() This function returns the last reading of the measurement process without using the trigger model. Type TSP-Link accessible Affected by Where saved Default value Function Usage reading = dmm.measure() reading = dmm.measure(bufferVar) reading The last reading of the measurement process...
  • Page 585: Dmm.measurecount

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual dmm.measurecount This attribute sets the number of measurements to take when a measurement is requested by a DMM measure command. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Reset Create configuration script...
  • Page 586: Dmm.measurewithtime()

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference dmm.measurewithtime() This function returns the last actual measurement and time information in UTC format without using the trigger model. You can also use a reading buffer to store additional information that is acquired while making a measurement.
  • Page 587: Dmm.measurewithptp()

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual dmm.measurewithptp() This function returns the last actual measurement and time information in PTP format without using the trigger model. You can also use a reading buffer to store additional information that is acquired while making a measurement.
  • Page 588: Dmm.nplc

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference dmm.nplc This attribute sets the integration rate in line cycles for the DMM for the function selected by dmm.func. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Reset Create configuration script 1.000000E+000...
  • Page 589: Dmm.offsetcompensation

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual dmm.offsetcompensation This attribute specifies the offset compensation setting for the DMM for the function selected by dmm.func. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Reset Create configuration script 0 (dmm.OFF) for "commonsideohms"...
  • Page 590: Dmm.open()

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference dmm.open() Opens the specified channel or channel pattern. Type TSP-Link accessible Affected by Where saved Default value Function Usage dmm.open("channelList") channelList A string that lists the channel or channel pattern to open Details This command allows you to separate the opening and closing of channels and analog backplane relays when measuring.
  • Page 591 Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual Example 1 reset() channel.setpole("slot2" , 4) channel.pattern.setimage("2005, 2911, 2922", "Chan5_4W") dmm.setconfig("Chan5_4W", "fourwireohms") dmm.open("Chan5_4W") print(channel.pattern.getimage("Chan5_4W")) Assume a Model 3721 is installed in slot 2. Reset the instrument. Configure the slot 2 channels for 4-pole operation. Create a pattern called Chan5_4W.
  • Page 592: Dmm.opendetector

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference dmm.opendetector This attributes determines if the detection of open leads is enabled or disabled. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Reset Create configuration script 0 (dmm.OFF) for "commonsideohms"...
  • Page 593: Dmm.range

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual dmm.range Indicates the range of DMM for the selected function. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Reset Create configuration script See Details DMM reset Save setup Recall setup Usage...
  • Page 594: Dmm.refjunction

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference Also see dmm.autorange (on page 11-149) dmm.configure.recall() (on page 11-165) dmm.configure.set() (on page 11-166) dmm.func (on page 11-179) dmm.reset() (on page 11-219) dmm.refjunction This attribute defines the type of the thermocouple reference junction. Type TSP-Link accessible Affected by...
  • Page 595: Dmm.rel.acquire()

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual dmm.rel.acquire() This function acquires a measurement and stores it as the relative offset value. Type TSP-Link accessible Affected by Where saved Default value Function Usage relativeValue = dmm.rel.acquire() relativeValue The internal measurement acquired for the relative offset level value Details This attribute is not applicable for "continuity"...
  • Page 596: Dmm.rel.enable

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference dmm.rel.enable Enables or disables relative measurement control for the function selected by dmm.func. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Reset Create configuration script 0 (dmm.OFF) DMM reset Save setup Recall setup...
  • Page 597: Dmm.rel.level

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual dmm.rel.level The offset value for relative measurements for the function selected by dmm.func. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Reset Create configuration script 0.000000E+000 DMM reset Save setup Recall setup...
  • Page 598: Dmm.reset()

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference Also see dmm.configure.recall() (on page 11-165) dmm.configure.set() (on page 11-166) dmm.func (on page 11-179) dmm.measure() (on page 11-205) dmm.rel.acquire() (on page 11-216) dmm.rel.enable (on page 11-217) dmm.reset() Resets the DMM functions and attributes in the instrument, as indicated by the parameter. Type TSP-Link accessible Affected by...
  • Page 599: Dmm.rtdalpha

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual dmm.rtdalpha This attribute contains the alpha value of a user-defined RTD. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Reset Create configuration script 3.850550E-03 DMM reset Save setup Recall setup Usage...
  • Page 600: Dmm.rtdbeta

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference Example 2 dmm.func = "temperature" This example sets unique alpha constants for 3-wire and dmm.transducer = dmm.TEMP_THREERTD 4-wire RTDs by creating two DMM configurations with dmm.rtdalpha = 0.005 the settings. dmm.configure.set("RTD_3wire") dmm.transducer = dmm.TEMP_FOURRTD Output:...
  • Page 601: Dmm.rtddelta

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual An error is generated if the value is out of range. Example 1 dmm.func = "temperature" Set a beta constant for RTD to 0.3 for 3-wire dmm.transducer = dmm.TEMP_THREERTD RTD.
  • Page 602 Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference This setting only applies when the transducer type is set to 3 or 4-wire RTD. For other transducer types, the setting is set but not used until the transducer type is set to an RTD type. The RTD delta setting is saved with the function setting, so if you use another function, then return to the temperature function, the RTD delta setting you set previously is retained.
  • Page 603: Dmm.rtdzero

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual dmm.rtdzero This attribute contains the zero value of a user-defined RTD. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Reset Create configuration script 1.000000E+02 DMM reset Save setup Recall setup Usage...
  • Page 604: Dmm.savebuffer()

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference Example 2 dmm.func = "temperature" This example sets unique zero constants for dmm.transducer = dmm.TEMP_THREERTD 3-wire and 4-wire RTDs by creating two dmm.rtdzero = 300 DMM configurations. dmm.configure.set("RTD_3wire") Output: 3.000000000e+00 dmm.transducer = dmm.TEMP_FOURRTD 3.000000000e+02...
  • Page 605 Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual Details The filename must specify the full path (including /usb1/). If included, the file extension must be set to .csv. If no file extension is specified, .csv is added. For options that save more than one item of time information, each item is comma-delimited.
  • Page 606: Dmm.setconfig()

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference dmm.setconfig() Associates a DMM configuration with items specified in parameter channel list. Type TSP-Link accessible Affected by Where saved Default value Function Reset Created configuration script "nofunction" Channel reset Save setup Recall setup Usage...
  • Page 607: Dmm.simreftemperature

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual Once an error is detected, the command stops processing and no channels or channel patterns are modified. Example dmm.setconfig("1001:3100", Assigns myDcv to all the channels on slots 1 and 2 and "myDcv") channels 1 to 100 on slot 3.
  • Page 608: Dmm.thermistor

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference Example dmm.func = "temperature" dmm.transducer = dmm.TEMP_THERMOCOUPLE dmm.units = dmm.UNITS_CELSIUS dmm.simreftemperature = 30 Sets 30 degrees Celsius as the simulated reference temperature for thermocouples. Also see dmm.configure.recall() (on page 11-165) dmm.configure.set() (on page 11-166) dmm.func...
  • Page 609: Dmm.thermocouple

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual Also see dmm.configure.recall() (on page 11-165) dmm.configure.set() (on page 11-166) dmm.func (on page 11-179) dmm.transducer (on page 11-233) dmm.thermocouple This attribute indicates the thermocouple type. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW)
  • Page 610: Dmm.threertd

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference dmm.threertd This attribute defines the type of three-wire RTD that is being used. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Reset Create configuration script 0 (dmm.RTD_PT100) DMM reset Save setup Recall setup...
  • Page 611: Dmm.threshold

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual dmm.threshold This attribute determines the signal level where the instrument makes frequency or period measurements. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Reset Create configuration script 1.000000E+01 DMM reset Save setup...
  • Page 612: Dmm.transducer

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference dmm.transducer This attribute contains the transducer type. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Reset Create configuration script 1 (dmm.TEMP_THERMOCOUPLE) DMM reset Save setup Recall setup Usage value = dmm.transducer dmm.transducer = value...
  • Page 613: Dmm.units

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual dmm.units This attribute contains the units that are used for voltage and temperature measurements. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Yes Reset Create configuration script 0 (dmm.UNITS_VOLTS) for "acvolts"...
  • Page 614: Errorqueue.clear()

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference errorqueue.clear() This function clears all entries out of the error queue. Type TSP-Link accessible Affected by Where saved Default value Function Usage errorqueue.clear() Details See the Error Available Bit (error or event queue) (on page C-8) topic for additional information about the error queue.
  • Page 615: Errorqueue.next()

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual errorqueue.next() This function reads the oldest entry from the error queue and removes it from the queue. Type TSP-Link accessible Affected by Where saved Default value Function Usage errorCode, message, severity, errorNode = errorqueue.next() errorCode The error code number for the entry message...
  • Page 616: Eventlog.all()

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference eventlog.all() This function returns all entries from the event log as a single string and removes them from the event log. Type TSP-Link accessible Affected by Where saved Default value Function Usage logString = eventlog.all()
  • Page 617: Eventlog.clear()

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual eventlog.clear() This function clears the event log. Type TSP-Link accessible Affected by Where saved Default value Function Usage eventlog.clear() Details This command removes all messages from the event log. Also see eventlog.all() (on page 11-237)
  • Page 618: Eventlog.enable

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference eventlog.enable This attribute enables or disables the event log. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Instrument reset Create configuration script eventlog.ENABLE Recall setup Save setup Usage status = eventlog.enable eventlog.enable = status...
  • Page 619: Eventlog.next()

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual eventlog.next() This function returns the oldest unread event message from the event log and removes it from the event log. Type TSP-Link accessible Affected by Where saved Default value Function Usage logString = eventlog.next()
  • Page 620: Eventlog.overwritemethod

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference eventlog.overwritemethod This attribute controls how the event log processes events if the event log is full. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Instrument reset Create configuration script Recall setup Save setup...
  • Page 621: Filevar:close()

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual fileVar:close() This function closes the file that is represented by the fileVar variable. Type TSP-Link accessible Affected by Where saved Default value Function Usage fileVar:close() fileVar The file descriptor variable to close Details This command is equivalent to io.close(fileVar).
  • Page 622: Filevar:read()

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference fileVar:read() This function reads data from a file. Type TSP-Link accessible Affected by Where saved Default value Function Usage data1 = fileVar:read() data1 = fileVar:read(format1) data1, data2 = fileVar:read(format1, format2) data1, ..., datan = fileVar:read(format1, ..., formatn) data1 First data read from the file...
  • Page 623: Filevar:seek()

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual fileVar:seek() This function sets and gets the present position of a file. Type TSP-Link accessible Affected by Where saved Default value Function Usage position, errorMsg = fileVar:seek() position, errorMsg = fileVar:seek(whence) position, errorMsg = fileVar:seek(whence, offset) position The new file position, measured in bytes from the beginning of the file...
  • Page 624: Filevar:write()

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference fileVar:write() This function writes data to a file. Type TSP-Link accessible Affected by Where saved Default value Function Usage fileVar:write(data) fileVar:write(data1, data2) fileVar:write(data1, ..., datan) fileVar The file descriptor variable data Write all data to the file data1...
  • Page 625: Format.byteorder

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual Details This attribute specifies the precision (number of digits) for numeric data printed with the print(), printbuffer(), and printnumber() functions. The format.asciiprecision attribute is only used with the ASCII format. The precision value must be a number from 0 to 16. Note that the precision is the number of significant digits printed.
  • Page 626: Format.data

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference Example x = 1.23 Output depends on the terminal program you format.data = format.REAL32 use, but will look something like: #0¤p?? format.byteorder = format.LITTLEENDIAN #0??p¤ printnumber(x) format.byteorder = format.BIGENDIAN printnumber(x) Also see format.asciiprecision...
  • Page 627: Fs.chdir()

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual Example format.asciiprecision = 10 Output a number represented by x in ASCII x = 3.14159265 using a precision of 10, then output the same format.data = format.ASCII number in binary using double precision printnumber(x) format.
  • Page 628: Fs.cwd()

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference fs.cwd() This function returns the absolute path of the current working directory. Type TSP-Link accessible Affected by Where saved Default value Function Usage path = fs.cwd() path The absolute path of the current working directory Also see File I/O (on page 9-27)
  • Page 629: Fs.mkdir()

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual Details The file system path may be absolute or relative to the current working system path. An error is logged to the error queue if the given path does not exist. Also see File I/O (on page 9-27)
  • Page 630: Fs.rmdir()

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference Details The directory path may be absolute or relative to the current working directory. This command is nonrecursive. For example, entries in subfolders are not returned. An error is logged to the error queue if the given path does not exist or does not represent a directory. Also see File I/O (on page 9-27)
  • Page 631: Gpib.address

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual Example timezone = gettimezone() Reads the value of the local timezone. Also see settimezone() (on page 11-353) gpib.address This attribute contains the GPIB address. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW)
  • Page 632: Io.close()

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference io.close() This function closes a file. Type TSP-Link accessible Affected by Where saved Default value Function Yes (see Details) Usage io.close() io.close(file) file The descriptor of the file to close Details If a file is not specified, the default output file closes.
  • Page 633: Io.input()

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual Using this command removes the need to close a file after writing to it and allows it to be left open to write more data. Data may be lost if the file is not closed or flushed before an application ends. To prevent the loss of data if there is going to be a time delay before more data is written (and when you want to keep the file open and not close it), flush the file after writing to it.
  • Page 634: Io.open()

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference io.open() This function opens a file for later reference. Type TSP-Link accessible Affected by Where saved Default value Function Usage fileVar, errorMsg = io.open("path") fileVar, errorMsg = io.open("path", mode) fileVar The descriptor of the opened file errorMsg...
  • Page 635: Io.read()

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual Details The path of the file to open may be absolute or relative to the current working directory. When accessed from a remote node using the TSP-Link network, this command does not accept a file descriptor parameter and does not return a value.
  • Page 636: Io.type()

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference Also see fileVar:read() (on page 11-243) Script examples (on page 9-5) io.type() This function checks whether or not a given object is a file handle. Type TSP-Link accessible Affected by Where saved Default value Function...
  • Page 637: Lan.applysettings()

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual Also see Script examples (on page 9-5) io.flush() (on page 11-253) lan.applysettings() This function re-initializes the LAN interface with new settings. Type TSP-Link accessible Affected by Where saved Default value Function Usage lan.applysettings()
  • Page 638: Lan.config.dns.domain

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference You can specify up to two addresses. The address specified by 1 is consulted first for DNS lookups. dnsAddress must be a string specifying the IP address of the DNS server in dotted decimal notation.
  • Page 639: Lan.config.dns.dynamic

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual lan.config.dns.dynamic Enables or disables the dynamic DNS registration. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) LAN restore defaults Nonvolatile memory 1 (lan.ENABLE) Usage state = lan.config.dns.dynamic lan.config.dns.dynamic = state state The dynamic DNS registration state.
  • Page 640: Lan.config.dns.verify

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference Details This attribute holds the host name to request during dynamic DNS registration. Dynamic DNS registration works with DHCP to register the host name specified in this attribute with the DNS server. The factory default value for hostName is "K-<model number>-<serial number>", where <model number>...
  • Page 641: Lan.config.gateway

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual lan.config.gateway This attribute contains the LAN default gateway address. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) LAN restore defaults Nonvolatile memory "0.0.0.0" Usage gatewayAddress = lan.config.gateway lan.config.gateway = "gatewayAddress"...
  • Page 642: Lan.config.method

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference Example ipaddress = lan.config.ipaddress Retrieves the presently set LAN IP address. Also see lan.restoredefaults() (on page 11-265) lan.status.ipaddress (on page 11-269) lan.config.method This attribute contains the LAN settings configuration method. Type TSP-Link accessible Affected by...
  • Page 643: Lan.config.subnetmask

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual lan.config.subnetmask This attribute contains the LAN subnet mask. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) LAN restore defaults Nonvolatile memory "255.255.255.0" Usage mask = lan.config.subnetmask lan.config.subnetmask = "mask"...
  • Page 644: Lan.nagle

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference lan.nagle This attribute controls the state of the LAN Nagle algorithm. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Power cycle Not saved 0 (lan.DISABLE) Usage state = lan.nagle lan.nagle = state state...
  • Page 645: Lan.status.dns.address[N]

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual Details The settings that are restored are shown in the following table. Settings that are restored to default Attribute Default setting lan.config.dns.address[N] "0.0.0.0" lan.config.dns.domain "" lan.config.dns.dynamic lan.ENABLE lan.config.dns.hostname "K-<model number>-<serial number>" lan.config.dns.verify lan.ENABLE lan.config.gateway...
  • Page 646: Lan.status.dns.name

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference Details This attribute is an array of DNS server addresses. The instrument can use up to three addresses. Unused or disabled entries are returned as "0.0.0.0" when read. The dnsAddress returned is a string specifying the IP address of the DNS server in dotted decimal notation.
  • Page 647: Lan.status.duplex

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual lan.status.duplex This attribute contains the duplex mode presently in use by the LAN interface. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Not applicable Not applicable Not applicable Usage duplex = lan.status.duplex...
  • Page 648: Lan.status.ipaddress

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference lan.status.ipaddress This attribute contains the LAN IP address presently in use by the LAN interface. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Not applicable Not applicable Not applicable Usage ipAddress = lan.status.ipaddress...
  • Page 649: Lan.status.port.dst

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual lan.status.port.dst This attribute contains the LAN dead socket termination port number. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Not applicable Not applicable Not applicable Usage port = lan.status.port.dst port Dead socket termination socket port number...
  • Page 650: Lan.status.port.telnet

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference lan.status.port.telnet This attribute contains the LAN Telnet connection port number. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Not applicable Not applicable Not applicable Usage port = lan.status.port.telnet port Telnet port number Details...
  • Page 651: Lan.status.speed

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual lan.status.speed This attribute contains the LAN speed. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Not applicable Not applicable Not applicable Usage speed = lan.status.speed speed LAN speed in Mbps, either 10 or 100 Details This attribute indicates the transmission speed currently in use by the LAN interface.
  • Page 652: Lan.trigger[N].Assert()

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference lan.trigger[N].assert() This function simulates the occurrence of the trigger and generates the corresponding event ID. Type TSP-Link accessible Affected by Where saved Default value Function Usage lan.trigger[N].assert() The LAN event number (1 to 8) Details Generates and sends a LAN trigger packet for the LAN event number specified.
  • Page 653: Lan.trigger[N].Connect()

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual Details The trigger event detector enters the detected state when an event is detected. This function clears a trigger event detector and discards the previous history of the trigger packet. This function clears all overruns associated with this LAN trigger.
  • Page 654: Lan.trigger[N].Connected

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference lan.trigger[N].connected This attribute stores the LAN event connection state. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Not applicable Not applicable Not applicable Usage connected = lan.trigger[N].connected connected The LAN event connection state: ▪...
  • Page 655: Lan.trigger[N].Disconnect()

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual lan.trigger[N].disconnect() This function disconnects the LAN trigger. Type TSP-Link accessible Affected by Where saved Default value Function Usage lan.trigger[N].disconnect() The LAN event number (1 to 8) Details For TCP connections, this closes the TCP connection. The LAN trigger automatically disconnects when either the lan.trigger[N].protocol or lan.trigger[N].ipaddress attributes for this event are changed.
  • Page 656: Lan.trigger[N].Ipaddress

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference lan.trigger[N].ipaddress This attribute specifies the address (in dotted-decimal format) of UDP or TCP listeners. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Instrument reset Create configuration script "0.0.0.0"...
  • Page 657: Lan.trigger[N].Overrun

    Use of either lan.TRIG_SYNCHRONOUSA or lan.TRIG_SYNCHRONOUSM over lan.TRIG_SYNCHRONOUS is preferred, as lan.TRIG_SYNCHRONOUS is provided for compatibility with other Keithley Instruments products. Example print(lan.trigger[1].mode) Outputs the present LAN trigger mode of LAN event 1.
  • Page 658: Lan.trigger[N].Protocol

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference Details This command indicates whether an event has been ignored because the event detector was already in the detected state when the event occurred. This is an indication of the state of the event detector built into the synchronization line itself. It does not indicate if an overrun occurred in any other part of the trigger model, or in any other construct that is monitoring the event.
  • Page 659: Lan.trigger[N].Pseudostate

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual Example print(lan.trigger[1].protocol) Get LAN protocol to use for sending trigger messages for LAN event 1. Also see lan.trigger[N].connect() (on page 11-274) lan.trigger[N].ipaddress (on page 11-277) lan.trigger[N].pseudostate This attribute sets the simulated line state for the LAN trigger. Type TSP-Link accessible Affected by...
  • Page 660 Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference Details This attribute specifies which event causes a LAN trigger packet to be sent for this trigger. Set triggerStimulus to one of the existing trigger event IDs shown in the following table. Trigger event IDs Trigger event ID Description...
  • Page 661: Lan.trigger[N].Wait()

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual Setting this attribute to zero disables automatic trigger generation. If any events are detected prior to calling lan.trigger[N].connect(), the event is ignored and the action overrun is set. Example lan.trigger[5].stimulus = trigger.timer[1].EVENT_ID Use timer 1 trigger event as the source for LAN packet 5 trigger...
  • Page 662: Localnode.define

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference localnode.define.* These constants indicate the number of available features (of each feature type) for each local node instrument. Type TSP-Link accessible Affected by Where saved Default value CONSTANT (R) .MAX_TIMERS .MAX_DIO_LINES .MAX_TSPLINK_TRIGS...
  • Page 663: Localnode.description

    The value of this attribute is also used as the mDNS service name of the instrument. This attribute's default value contains Keithley ModelNumber #SSSSSSSS, where: ModelNumber is the instrument's model number, and #SSSSSSSS is the instrument's eight-digit serial number. You can change it to a value that makes sense for your system.
  • Page 664: Localnode.linefreq

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference Details This command needs to be set if you replace a Model 3706 with a Model 3706A in a system where computer drivers may be querying the model. This can occur if you replace a Model 3706 with a Model 3706A in an existing system, or if you duplicate a system but use a Model 3706A instead of a Model 3706.
  • Page 665: Localnode.model

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual localnode.model This attribute stores the model number. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Not applicable Not applicable Not applicable Usage model = localnode.model model The model number of the instrument Example print(localnode.model)
  • Page 666: Localnode.passwordmode

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference Example localnode.password = "N3wpa55w0rd" Changes the remote interface password to N3wpa55w0rd. Also see lan.reset() (on page 11-265) localnode.passwordmode (on page 11-287) localnode.passwordmode This attribute stores the remote access password enable mode. Type TSP-Link accessible Affected by...
  • Page 667: Localnode.prompts

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual localnode.prompts This attribute determines if the instrument generates prompts in response to command messages. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Power cycle Not saved 0 (disabled) Usage prompting = localnode.prompts...
  • Page 668: Localnode.prompts4882

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference localnode.prompts4882 This attribute enables and disables the generation of prompts for IEEE Std 488.2 common commands. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Power cycle Not saved 1 (enabled) Usage...
  • Page 669: Localnode.revision

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual A local node reset includes a channel.reset("allslots"), dmm.reset("all") and a scan.reset(). In addition: • Other settings are restored to factory default settings • Existing channel patterns and DMM configurations are deleted •...
  • Page 670: Localnode.serialno

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference localnode.serialno This attribute stores the instrument's serial number. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Not applicable Not applicable Not applicable Usage serialno = localnode.serialno serialno The serial number of the instrument Details...
  • Page 671: Makegetter()

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual Example localnode.showerrors = 1 Enables sending of generated errors. Also see localnode.prompts (on page 11-288) makegetter() This function creates a function to get the value of an attribute. Type TSP-Link accessible Affected by Where saved...
  • Page 672: Memory.available()

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference Details This function is useful for aliasing attributes to improve execution speed. Calling the setter function will execute faster than accessing the attribute directly. Creating a setter function is only useful if it is going to be called several times. If you are not calling the setter function several times, it is more efficient to access the attribute directly.
  • Page 673: Memory.used()

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual Example: After recalling a setup setup.recall(1) Reads and returns the amount of memory available print(memory.available()) in the instrument after a setup is recalled. Output: 11.13, 92.84, 0.16, 97.03 Example: Used and available memory print("Memory used:", memory.used()) Reads and returns the amount memory used and print("Memory available: ",...
  • Page 674: Node[N].Execute()

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference Example MemUsed = memory.used() Reads the memory used in the instrument and print(MemUsed) returns the percentages. Output: 69.14, 0.16, 12.74, 1.04 Also see memory.available() (on page 11-293) node[N].execute() This function starts test scripts on a remote TSP-Link node. Type TSP-Link accessible Affected by...
  • Page 675: Node[N].Getglobal()

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual node[N].getglobal() This function returns the value of a global variable. Type TSP-Link accessible Affected by Where saved Default value Function Usage value = node[N].getglobal("name") value The value of the variable The node number of this instrument (1 to 64) name The global variable name...
  • Page 676: Opc()

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference Example node[3].setglobal("x", 5) Sets the global variable x on node 3 to the value of 5. Also see node[N].getglobal() (on page 11-296) TSP advanced features (on page 10-58) opc() This function sets the operation complete status bit when all overlapped commands are completed.
  • Page 677: Print()

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual Details The timespec is a table using the fields listed in the table below. year The year (1970 or later) month The month (1 to 12) The day (1 to 31) hour The hour (00 to 23) The minute (00 to 59)
  • Page 678: Printbuffer()

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference Details TSP-enabled instruments do not have inherent query commands. Like other scripting environments, the print() command and other related print() commands generate output. The print() command creates one response message. The output from multiple arguments is separated with a tab character.
  • Page 679 Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual Details If startIndex is set to less than 1 or if endIndex is more than the size of the index, 9.910000e+37 is returned for each value outside the allowed index and an event is generated. If overlapped commands use the specified reading buffers and the commands are not complete (at least to the specified index), this function outputs data as it becomes available.
  • Page 680 Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference Example 1 reset() testData = buffer.make(200) format.data = format.ASCII format.asciiprecision = 6 trigger.model.load("SimpleLoop", 6, 0, testData) trigger.model.initiate() waitcomplete() printbuffer(1, testData.n, testData.readings, testData.units, testData.relativetimestamps) Reset the instrument. Set the data format and ASCII precision. Use trigger model SimpleLoop to create a 6-count loop with no delays that stores data in the reading buffer testBuffer.
  • Page 681: Printnumber()

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual printnumber() This function prints numbers using the configured format. Type TSP-Link accessible Affected by Where saved Default value Function Usage printnumber(value1) printnumber(value1, value2) printnumber(value1, ..., valueN) value1 First value to print in the configured format value2 Second value to print in the configured format valueN...
  • Page 682: Ptp.domain

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference ptp.domain This attribute describes the IEEE Std 1588-2008 precision time protocol (PTP) domain. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Never Nonvolatile memory Usage value = ptp.domain ptp.domain = value value 0 = default domain...
  • Page 683 Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual Example print(ptp.ds.info) Output: Current DS Steps removed: Offset from Master: 0.000000000 Mean Path Delay: 0.000000000 Default DS Number of Ports: Two Step Clock: Priority 1: Priority 2: Domain: Clock Identity: 12 34 56 FF FE 65 43 21 Clock Qual - Class: Clock Qual - Accuracy:...
  • Page 684: Ptp.enable

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference Also see Not applicable ptp.enable This attribute enables or disables the precision time protocol (PTP) described in IEEE-1588 on the Series 3700A. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Not applicable...
  • Page 685: Ptp.slavepreferred

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual Example print(ptp.portstate) Output (this output indicates that PTP is disabled): 2.000000000e+00 Also see ptp.enable (on page 11-305) ptp.slavepreferred This attribute describes whether you prefer to have the instrument be a subordinate clock or not. Type TSP-Link accessible Affected by...
  • Page 686: Ptp.time()

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference ptp.time() This function is a read-only string that returns the PTP time in seconds and fractional seconds. Type TSP-Link accessible Affected by Where saved Default value Function Usage ptp.time() Example sec,fraction=ptp.time() Output:...
  • Page 687: Reset()

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual reset() This function resets commands to their default settings. Type TSP-Link accessible Affected by Where saved Default value Function Usage reset() reset(system) system What to reset: ▪ true: If the node is the master, the entire system is reset (default) ▪...
  • Page 688: Scan.add()

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference When a scan is aborted, the channels remain in the opened or closed states that they were in when the scan was aborted. Example scan.background() Starts background scan, and then aborts the scan.abort() scan.
  • Page 689 Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual The width parameter is valid for digital I/O type channels. Widths of 1, 2, 3, or 4 are supported. If specified, the scan can read up to four consecutive channels simultaneously, and then saves the resulting value into the specified reading buffer.
  • Page 690: Scan.addimagestep()

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference scan.addimagestep() This function allows you to include multiple channels in a single scan step. Type TSP-Link accessible Affected by Where saved Default value Function Usage scan.addimagestep("channelList") scan.addimagestep("channelList", "dmmConfig") channelList String specifying a list of channels dmmConfig String specifying a DMM configuration...
  • Page 691: Scan.addwrite()

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual channel.setpole("1001", 4) Set channel 1001 to 4-pole operation. scan.addimagestep("1001, 1911", "dcvolts") Adds a single step that closes channels 1001, 1031, and 1911, and then takes a DC voltage measurement. scan.addimagestep("1101, 2202, 1911", Adds three steps with the following actions: "dcvolts")
  • Page 692: Scan.background()

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference Example scan.addwrite("6001, 6003, 6005", 21845, 2) Assume a 3750 in slot 6. Add to existing scan list channels 1, 3 and 5 on slot 6 to write a 16-bit hex value of hexadecimal 5555 (decimal 21845).
  • Page 693: Scan.bypass

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual Also see scan.add() (on page 11-309) scan.create() (on page 11-315) scan.execute() (on page 11-317) scan.list() (on page 11-318) scan.state() (on page 11-326) Scanning and triggering (on page 5-23) scan.bypass This attribute indicates whether the first channel of the scan waits for the channel stimulus event to be satisfied before closing.
  • Page 694: Scan.create()

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference scan.create() This function deletes the existing scan list and creates a new list of channels and channel patterns to scan. Type TSP-Link accessible Affected by Where saved Default value Function Usage scan.create(channelList)
  • Page 695 Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual Example 3 scan.create("3001:3010", "testDCV") For this example, assume testDCV is a previously defined user DC volts configuration. Clears the old scan list and creates a new scan list with each channel (1 to 10 on slot 3).
  • Page 696: Scan.execute()

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference scan.execute() This function starts the scan immediately in the foreground with a configured scan list. Type TSP-Link accessible Affected by Where saved Default value Function Usage state, scanCount, stepCount, reading = scan.execute() state, scanCount, stepCount, reading = scan.execute(bufferVar) state The result of scanning:...
  • Page 697: Scan.list()

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual scan.list() This function queries the active scan list. Type TSP-Link accessible Affected by Where saved Default value Function Instrument reset Create configuration script Empty list Channel reset Save setup Scan reset Recall setup Change of channel or scan setting...
  • Page 698 Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference Example reset() Assume a 3721 in slot 2. dmm.setconfig("2020, 2021", "dcvolts") Configure channels 20 and 21 for DC volts dmm.nplc = 0.5 on slot 2. dmm.range = 10 Change the DMM settings for NPLC and dmm.configure.set("DCVSlot2") range and save those DC volt settings as "DCVSlot2".
  • Page 699: Scan.measurecount

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual scan.measurecount This attribute sets the number of iterations performed when a scanning measurement is requested. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Reset Create configuration script Scan reset Save setup Recall setup...
  • Page 700: Scan.mode

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference scan.mode This attribute sets the relay action when the scan starts. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Reset Create configuration script 0 (scan.MODE_OPEN_ALL) Scan reset Save setup Recall setup Usage...
  • Page 701: Scan.nobufferbackground()

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual scan.nobufferbackground() This function starts a scan in background mode and specifies that no reading buffer is used during scanning. Type TSP-Link accessible Affected by Where saved Default value Function Usage state, scancount, stepcount = scan.nobufferbackground() state...
  • Page 702: Scan.nobufferexecute()

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference scan.nobufferexecute() This function starts a scan immediately and specifies that no reading buffer is used during scanning. Type TSP-Link accessible Affected by Where saved Default value Function Usage state, scanCount, stepCount = scan.nobufferbackground() state The result of scanning: ▪...
  • Page 703: Scan.reset()

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual scan.reset() This function resets the trigger model and scan list settings to their factory default settings. Type TSP-Link accessible Affected by Where saved Default value Function Usage scan.reset() Details When scan.reset() is sent, the trigger model and scan settings that are reset to the factory defaults are: ▪...
  • Page 704: Scan.scancount

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference scan.scancount This attribute sets the number of times the scan is repeated. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Reset Create configuration script Scan reset Save setup Recall setup Usage...
  • Page 705: Scan.state()

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual scan.state() This function provides the present state of a running background scan. Type TSP-Link accessible Affected by Where saved Default value Function Usage scanState, scanCount, stepCount, reading = scan.state() scanState The present state of the scan running in the background.
  • Page 706: Scan.stepcount

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference scan.stepcount This attribute returns the number of steps in the present scan. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Not applicable Not applicable Not applicable Usage scanStepCount = scan.stepcount scanStepCount...
  • Page 707: Scan.trigger.arm.set()

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual scan.trigger.arm.set() This function sets the arm event detector to the detected state. Type TSP-Link accessible Affected by Where saved Default value Function Usage scan.trigger.arm.set() Details This function sets the arm event detector of the trigger model to the detected state. Example scan.trigger.arm.set() Sets the arm event detector to the detected...
  • Page 708 Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference eventID may be one of the following trigger event IDs. Trigger event IDs Trigger event ID Description channel.trigger[N].EVENT_ID or 41 to 48 The trigger event generated by the channel trigger N. digio.trigger[N].EVENT_ID or 1 to 14 An edge (either rising, falling, or either based on the configuration of the line) on the digital input line.
  • Page 709: Scan.trigger.channel.clear()

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual Also see scan.trigger.arm.clear() (on page 11-327) scan.trigger.arm.set() (on page 11-328) Trigger model (on page 5-24) Scanning and triggering (on page 5-23) scan.trigger.channel.clear() This function clears the channel event detector. Type TSP-Link accessible Affected by...
  • Page 710: Scan.trigger.channel.stimulus

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference scan.trigger.channel.stimulus This attribute determines which trigger events cause the channel actions to occur. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Yes Instrument reset Create Recall setup configuration script (scan.trigger.EVENT_SEQUENCE_COMP Scan reset...
  • Page 711: Scan.trigger.clear()

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual Use one of the text trigger event IDs (for example, digio.trigger[N].EVENT_ID) to set the stimulus value rather than the numeric value. Doing this will make the code compatible for future upgrades.
  • Page 712: Scan.trigger.measure.clear()

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference scan.trigger.measure.clear() This function clears the measure event detector. Type TSP-Link accessible Affected by Where saved Default value Function Usage scan.trigger.measure.clear() Details This function sets the measurement event detector of the trigger model to the undetected state. Example scan.trigger.measure.clear() Clears the measurement event detector.
  • Page 713: Scan.trigger.measure.stimulus

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual scan.trigger.measure.stimulus This attribute selects the trigger stimulus of the event detector trigger. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Instrument reset Create Recall setup configuration script Scan reset Save setup Usage...
  • Page 714: Scan.trigger.sequence.clear()

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference Trigger event IDs Trigger event ID Description scan.trigger.EVENT_SCAN_READY or 24 Scan ready event. scan.trigger.EVENT_SCAN_START or 25 Scan start event. scan.trigger.EVENT_CHANNEL_READY or 28 Channel ready event. scan.trigger.EVENT_MEASURE_COMP or 56 Measure complete event. scan.trigger.EVENT_SEQUENCE_COMP or 50 Sequence complete event.
  • Page 715: Scan.trigger.sequence.set()

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual scan.trigger.sequence.set() This function sets the sequence even detector to the detected state. Type TSP-Link accessible Affected by Where saved Default value Function Usage scan.trigger.sequence.set() Details This function sets the sequence event detector to the detected state. Example scan.trigger.sequence.set() Sets the sequence event detector to the...
  • Page 716 Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference Set eventID to one of the existing trigger event IDs shown in the following table. Trigger event IDs Trigger event ID Description channel.trigger[N].EVENT_ID or 41 to 48 The trigger event generated by the channel trigger N. digio.trigger[N].EVENT_ID or 1 to 14 An edge (either rising, falling, or either based on the configuration of the line) on the digital input line.
  • Page 717: Schedule.alarm[N].Enable

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual schedule.alarm[N].enable This attribute enables or disables an alarm. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Reset Not saved 0 (schedule.OFF) Recall setup Usage state = schedule.alarm[N].enable schedule.alarm[N].enable = state state Disable the alarm(schedule.OFF or 0)
  • Page 718: Schedule.alarm[N].Fractionalseconds

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference Details To have another trigger object respond to trigger events generated by the schedule alarm, set the other object's stimulus attribute to the value of this constant. Example scan.trigger.arm.stimulus = schedule.alarm[1].EVENT_ID Uses a trigger event on alarm 1 to be the stimulus for the trigger arm.
  • Page 719: Schedule.alarm[N].Period

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual schedule.alarm[N].period This attribute describes the time, in seconds, between adjacent firings of the alarm. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Reset Create configuration script Recall setup Save setup Usage...
  • Page 720: Schedule.alarm[N].Repetition

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference schedule.alarm[N].repetition This attribute describes the number of times an alarm repeats after the first alarm firing. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Reset Save setup Recall setup Usage count = schedule.alarm[N].repetition...
  • Page 721: Schedule.disable()

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual Also see ptp.utcoffset (on page 11-307) schedule.disable() This function disables all alarms. Type TSP-Link accessible Affected by Where saved Default value Function Usage schedule.disable() Details This command sets the schedule.alarm[N].enable attribute to 0 (schedule.OFF) for each schedule alarm N.
  • Page 722: Script.delete()

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference Also see Anonymous scripts (on page 10-3) scriptVar.autorun (on page 11-348) scriptVar.list() (on page 11-348) scriptVar.name (on page 11-349) scriptVar.run() (on page 11-350) scriptVar.save() (on page 11-351) scriptVar.source (on page 11-351) script.delete() This function deletes a script from nonvolatile memory.
  • Page 723: Script.new()

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual Script naming: • If the name parameter is an empty string, or name is absent (or nil) and the script name cannot be extracted from the file, scriptVar is the only handle to the created script. •...
  • Page 724: Script.newautorun()

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference Example 1 myTest8 = script.new( "display.clear() display.settext('Hello from myTest8')", "myTest8") myTest8() Creates a new script referenced by the variable myTest8 with the name "myTest8". Runs the script. The instrument displays "Hello from myTest8". Example 2 autoexec = script.new( "display.clear() display.settext('Hello from autoexec')", 'autoexec')
  • Page 725: Script.restore()

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual Example NewAuto = script.newautorun("print('Hello from new auto run command')", 'NewAuto') print(NewAuto.autorun) print(NewAuto.name) Creates a new script called NewAuto that automatically has the autorun attribute set to yes after it is created. The name is set to "NewAuto".
  • Page 726: Script.run()

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference script.run() This function runs the anonymous script. Type TSP-Link accessible Affected by Where saved Default value Function Usage script.run() run() Details Each time the script.run() command is given, the anonymous script is executed. This script can be run using this command many times without having to re-send it.
  • Page 727: Scriptvar.autorun

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual scriptVar.autorun This attribute controls the autorun state of a script. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Not applicable See Details See Details Usage scriptVar.autorun = "state" state = scriptVar.autorun scriptVar The name of the variable that references the script...
  • Page 728: Scriptvar.name

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference Details This function generates output in the form of a sequence of response messages (one message for each line of the script). It also generates output of the script control messages (loadscript or loadandrunscript and endscript).
  • Page 729: Scriptvar.run()

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual Changing the name of a script does not change the name of any variables that reference that script. The variables will still reference the script, but the names of the script and variables may not match. Example test7 = script.new("display.clear() display.settext('Hello from my test')", "") test7()
  • Page 730: Scriptvar.save()

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference scriptVar.save() This function saves the script to nonvolatile memory or to a USB flash drive. Type TSP-Link accessible Affected by Where saved Default value Function Usage scriptVar.save() scriptVar.save("filename") scriptVar The name of variable that references the script filename A string that contains the file name to use when saving the script to a USB flash drive...
  • Page 731: Settime()

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual Details The loadscript or loadandrunscript and endscript keywords are not included in the source code. The body of the script is a single string with lines separated by the new line character. The instrument automatically stores the source for all scripts that are loaded on the instrument.
  • Page 732: Settimezone()

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference settimezone() This function sets the local time zone. Type TSP-Link accessible Affected by Where saved Default value Function Usage settimezone(offset) settimezone("offset", "dstOffset", "dstStart", "dstEnd") offset String representing offset from UTC dstOffset String representing the daylight savings offset from UTC dstStart...
  • Page 733: Setup.cards()

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual Example settimezone("8", "1", "3.3.0/02", "11.2.0/02") Sets offset to equal +8 hours, +1 hour for DST, starts on Mar 14 at 2:00 a.m., ends on Nov 7 at 2:00 a.m. settimezone(offset) Sets local time zone to offset.
  • Page 734: Setup.poweron

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference Example 2 print(setup.card("/usb1/mysetup.set")) Query the cards associated with setup saved as JulySetup.set on the thumb drive. The following example of output shows that slots 1, 5, and 6 are empty, slot 2 has a 3723 installed, slot 3 has a 3722 installed and slot 4 has a 3720 installed: 0,3723,3722,3720,0,0...
  • Page 735: Setup.recall()

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual setup.recall() This function recalls settings from a saved setup. Type TSP-Link accessible Affected by Where saved Default value Function Usage setup.recall(id) An integer or string that specifies the location of the setup to recall: ▪...
  • Page 736: Slot[Slot].Banks.matrix

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference The id parameter can use a path that is absolute or relative to the current working directory. iIf you do not specify the id parameter, the setup is saved to the nonvolatile memory of the instrument.
  • Page 737: Slot[Slot].Columns.matrix

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual slot[slot].columns.matrix This attribute returns the number of columns in the matrix for the card in the specified slot. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Not applicable Not applicable Not applicable...
  • Page 738: Slot[Slot].Digio

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference slot[slot].digio This attribute indicates whether or not a card in the specified slot supports digital input and output channels. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Not applicable Not applicable Not applicable...
  • Page 739 Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual If only one channel in the card supports the feature, the ending channel matches the starting channel number. The commands support different types of channels: • slot[slot].endchannel.amps: Channel supports amperage measurements •...
  • Page 740 Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference slot[SlotNumber].endchannel.analogoutput) if (slot[SlotNumber].matrix == 1) then print(" Channels on card are matrix type") for x = 1,6 do print("Checking card channels in slot " .. x) CardChannels(x) If the Series 3700A contains the following cards: ▪...
  • Page 741: Slot[Slot].Idn

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual Also see Slot (on page 9-34) slot[slot].startchannel.* (on page 11-369) slot[slot].idn This attribute returns a string that contains information about the plug-in card. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Not applicable...
  • Page 742: Slot[Slot].Interlock.state

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference Details This command suppresses errors that would otherwise be generated when the interlock is not closed. If the interlock is not physically connected, channels will still not close. This attribute exists only for installed cards that support detecting an interlock break. Otherwise, the return value is nil.
  • Page 743: Slot[Slot].Isolated

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual slot[slot].isolated This attribute indicates if the card in the specified slot supports isolated channels. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Not applicable Not applicable Not applicable Usage value = slot[slot].isolated...
  • Page 744: Slot[Slot].Maxvoltage

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference slot[slot].maxvoltage This attribute returns the maximum voltage of all channels on a plug-in card in the specified slot. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Not applicable Not applicable Not applicable...
  • Page 745: Slot[Slot].Poles.four

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual slot[slot].poles.four This attribute indicates if a four-pole setting is supported for the channels on the card. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Not applicable Not applicable Not applicable Usage...
  • Page 746: Slot[Slot].Poles.two

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference Example print(slot[3].poles.one) Query to see if slot 3 supports one-pole settings for the channels on the card. Output if card supports one pole: 1.000000000e+00 Output if card does not support one pole: Also see slot[slot].poles.four (on page 11-366)
  • Page 747 Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual Usage pseudoCard = slot[slot].pseudocard slot[slot].pseudocard = pseudoCard pseudoCard Set pseudocard to one of the following values: ▪ slot.PSEUDO_NONE or 0 for no pseudocard selection ▪ 3720 for 3720 Dual 1 × 30 Multiplexer card simulation ▪...
  • Page 748: Slot[Slot].Rows.matrix

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference slot[slot].rows.matrix This attribute returns the number of rows in the matrix on the card in the specified slot. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Not applicable Not applicable Not applicable...
  • Page 749 Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual Details This attribute is only available for a slot if the installed card supports the selected feature. If the attribute is not available, the return value is nil. Channels are grouped on the cards by feature sets, so you can use the start and ending channel numbers to identify a group of channels that supports a particular feature.
  • Page 750 Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference print(" no totalizer channels") if (slot[SlotNumber].startchannel.analogoutput == nil) and (slot[SlotNumber].endchannel.analogoutput == nil) then print(" no analog output channels") else print(" Start analog output channel is " .. slot[SlotNumber].startchannel.analogoutput) print(" End analog output channel is "...
  • Page 751: Slot[Slot].Tempsensor

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual Start voltage channel is 1 End voltage channel is 40 Start amp channel is 41 End amp channel is 42 no digio channels no totalizer channels no analog output channels Checking card channels in slot 6 Slot is Empty Also see...
  • Page 752: Slot[Slot].Thermal.state

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference slot[slot].thermal.state This attribute indicates the thermal state of the card in the specified slot. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Not applicable Not applicable Not applicable Usage value = slot[slot].thermal.state...
  • Page 753 Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual > > > > > > * Least significant bit ** Most significant bit The returned value can indicate one or more status events occurred. When an enabled status event occurs, a summary bit is set in this register to indicate the event occurrence.
  • Page 754: Status.measurement

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference In addition to the above constants, when more than one bit of the register is set, statusByte equals the sum of their decimal weights. For example, if 129 is returned, bits B0 and B7 are set (1 + 128). Binary value Decimal Weights...
  • Page 755 Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual Details These attributes read or write the measurement event 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 B0, and the most significant bit is bit B15.
  • Page 756: Status.node_Enable

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference > > > > > > > > > > > > > > * Least significant bit ** Most significant bit In addition to the above constants, measurementRegister can be set to the decimal equivalent of the bit to set.
  • Page 757 Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual > > > > > > * Least significant bit ** Most significant bit Assigning a value to this attribute enables one or more status events. When an enabled status event occurs, a summary bit is set in the appropriate system summary register.
  • Page 758: Status.node_Event

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference In addition to the above values, nodeEnableRegister can be set to the numeric equivalent of the bit to set. To set more than one bit of the register, set nodeEnableRegister to the sum of their decimal weights.
  • Page 759 Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual The returned value can indicate one or more status events occurred. Value Description status.MEASUREMENT_SUMMARY_BIT Set summary bit indicates that an enabled status.MSB measurement event has occurred. Bit B0 decimal value: 1 Not used Not applicable status.ERROR_AVAILABLE...
  • Page 760: Status.operation.*

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference status.operation.* These attributes manage the operation status register set of the status model. Type TSP-Link accessible Affected by Where saved Default value Attribute .condition (R) Not applicable Not saved Not applicable .enable (RW) Status reset...
  • Page 761 Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual Value Description status.operation.CALIBRATING Set bit indicates that the DMM is calibrating. status.operation.CAL Bit B0 decimal value: 1 Not used Not applicable B1-B3 status.operation.MEASURING Set bit indicates that DMM is measuring. status.operation.MEAS Bit B4 decimal value: 16 Not used...
  • Page 762: Status.operation.user

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference Example 2 -- decimal 20480 = binary 0101 0000 0000 0000 operationRegister = 20480 status.operation.enable = operationRegister Sets the USER and PROG bits of the operation status enable register using a decimal value. Also see None status.operation.user.*...
  • Page 763 Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents (on page C-1) and Enable and transition registers (on page C-19). The individual bits of this register are defined in the following table.
  • Page 764: Status.questionable

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference Example 2 -- 18432 = binary 0100 1000 0000 0000 Uses a decimal value to set bits B11 and operationRegister = 18432 B14 of the operation status user enable status.operation.enable = operationRegister register.
  • Page 765 Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual Value Description Not used Not available status.questionable.SLOT1_INTERLOCK Sets the interlock connection of the card in status.questionable.S1INL slot 1. Bit B1 decimal value: 2 status.questionable.SLOT2_INTERLOCK Sets the interlock connection of the card in status.questionable.S2INL slot 2.
  • Page 766: Status.request_Enable

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference In addition to the above constants, questionableRegister can be set to the numeric equivalent of the bit to set. To set more than one bit of the register, set questionableRegister to the sum of their decimal weights.
  • Page 767 Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual Details This attribute is used to read or write to the service request enable register. Reading the service request enable register returns a value. The binary equivalent of the value of this attribute indicates which register bits are set.
  • Page 768: Status.request_Event

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference Binary value Decimal Weights Example 1 requestSRQEnableRegister = status.MSB + Uses constants to set the MSB and OSB status.OSB bits of the service request (SRQ) enable status.request_enable = requestSRQEnableRegister register.
  • Page 769 Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents (on page C-1) and Enable and transition registers (on page C-19). The individual bits of this register are defined in the following table.
  • Page 770: Status.reset()

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference status.reset() This function resets all bits in the status model. Type TSP-Link accessible Affected by Where saved Default value Function Usage status.reset() Details This function clears all status data structure registers (enable, event, NTR, and PTR) to their default values.
  • Page 771 Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual Details These attributes are used to read or write to the standard event status registers. Reading a status register returns a value. The binary equivalent of the returned value indicates which register bits are set.
  • Page 772: Status.system

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference Value Description status.standard.POWER_ON Set bit indicates that the instrument has been status.standard.PON turned off and turned back on since the last time this register has been read. Bit B7 decimal value: 128 Not used Not applicable B8-B15...
  • Page 773 Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual Usage enableRegister = status.system.condition enableRegister = status.system.enable enableRegister = status.system.event enableRegister = status.system.ntr enableRegister = status.system.ptr status.system.enable = enableRegister status.system.ntr = enableRegister status.system.ptr = enableRegister enableRegister The status of the system summary register; a zero (0) indicates no bits set; other values indicate various bit settings Details In an expanded system (TSP-Link), these attributes are used to read or write to the system summary...
  • Page 774: Status.system2

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference Value Description status.system.NODE14 Bit B14 decimal value: 16,384 Not used Not applicable As an example, to set bit B0 of the system summary status enable register, set status.system.enable = status.system.enable.EXT. In addition to the above constants, enableRegister can be set to the numeric equivalent of the bit to set.
  • Page 775 Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual Usage enableRegister = status.system2.condition enableRegister = status.system2.enable enableRegister = status.system2.event enableRegister = status.system2.ntr enableRegister = status.system2.ptr status.system2.enable = enableRegister status.system2.ntr = enableRegister status.system2.ptr = enableRegister enableRegister The status of the system summary 2 register; a zero (0) indicates no bits set; other values indicate various bit settings Details In an expanded system (TSP-Link), these attributes are used to read or write to the system summary...
  • Page 776 Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference Value Description status.system2.NODE28 Bit B14 decimal value: 16,384 Not used Not applicable As an example, to set bit B0 of the system summary 2 enable register, set status.system2.enable = status.system2.EXT. In addition to the above constants, enableRegister can be set to the numeric equivalent of the bit to set.
  • Page 777: Status.system3

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual status.system3.* ® These attributes manage the TSP-Link system summary register of the status model for nodes 29 through 42. Type TSP-Link accessible Affected by Where saved Default value Attribute .condition (R) Not applicable Not saved...
  • Page 778 Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents (on page C-1) and Enable and transition registers (on page C-19). The individual bits of this register are defined in the following table.
  • Page 779: Status.system4

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual Example 1 enableRegister = status.system3.NODE39 + status.system3.NODE42 status.system3.enable = enableRegister Uses constants to set bits B11 and B14 of the system summary 3 enable register. Example 2 -- decimal 18432 = binary 0100 1000 0000 0000 Uses a decimal value to set bits B11 and enableRegister = 18432 B14 of the system summary 3 enable...
  • Page 780 Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference > > > > > > > > > > > > > > * Least significant bit ** Most significant bit For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents (on page C-1) and...
  • Page 781: Status.system5

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual Binary value Decimal Weights Binary value 32,768 16,384 8,192 4,096 2,048 1,024 Decimal Weights Example 1 enableRegister = status.system4.NODE53 + status.system4.NODE56 status.system2.enable = enableRegister Uses constants to set bit B11 and bit B14 of the system summary 4 enable register. Example 2 -- decimal 18432 = binary 0100 1000 0000 0000 enableRegister = 18432...
  • Page 782 Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference Usage enableRegister = status.system5.condition enableRegister = status.system5.enable enableRegister = status.system5.event enableRegister = status.system5.ntr enableRegister = status.system5.ptr status.system5.enable = enableRegister status.system5.ntr = enableRegister status.system5.ptr = enableRegister enableRegister The status of the system summary 5 register; a zero (0) indicates no bits set; other values indicate various bit settings Details In an expanded system (TSP-Link), these attributes are used to read or write to the system summary...
  • Page 783: Timer.measure.t()

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual As an example, to set bit B1 of the system summary 5 enable register, set status.system5.enable = status.system5.NODE57. In addition to the above constants, enableRegister can be set to the numeric equivalent of the bit to set.
  • Page 784: Timer.reset()

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference Example 1 timer.reset() Resets the timer and measures the time since the -- (intervening code) reset. time = timer.measure.t() print(time) Output: 1.469077e+01 The output will vary. The above output indicates that timer.measure.t() was executed 14.69077 seconds after timer.reset().
  • Page 785: Trigger.blender[N].Clear()

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual trigger.blender[N].clear() This function clears the blender event detector and resets the overrun indicator of blender N. Type TSP-Link accessible Affected by Where saved Default value Function Usage trigger.blender[N].clear() The blender number (up to two) Details This command sets the blender event detector to the undetected state and resets the overrun indicator of the event detector.
  • Page 786: Trigger.blender[N].Orenable

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference trigger.blender[N].orenable This attribute selects whether the blender performs OR operations or AND operations. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Instrument reset Create configuration script false (AND mode) Trigger blender N reset Save setup...
  • Page 787: Trigger.blender[N].Reset()

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual Details Indicates if an event was ignored because the event detector was already in the detected state when the event occurred. This is an indication of the state of the event detector that is built into the event blender itself.
  • Page 788: Trigger.blender[N].Stimulus[M]

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference trigger.blender[N].stimulus[M] This attribute specifies the events that trigger the blender. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Reset Create configuration script Recall setup Save setup Trigger blender N reset Usage eventID = trigger.blender[N].stimulus[M]...
  • Page 789: Trigger.blender[N].Wait()

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual Example digio.trigger[3].mode = digio.TRIG_FALLING Generate a trigger blender 1 digio.trigger[5].mode = digio.TRIG_FALLING event when a digital I/O trigger.blender[1].orenable = true trigger happens on line 3 or 5. trigger.blender[1].stimulus[1] = digio.trigger[3].EVENT_ID trigger.blender[1].stimulus[2] = digio.trigger[5].EVENT_ID Also see trigger.blender[N].reset()
  • Page 790: Trigger.clear()

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference trigger.clear() This function clears the command interface trigger event detector. Type TSP-Link accessible Affected by Where saved Default value Function Usage trigger.clear() Details The trigger event detector indicates if a trigger event has been detected since the last trigger.wait() call.
  • Page 791: Trigger.timer[N].Clear()

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual trigger.timer[N].clear() This function clears the timer event detector and overrun indicator for the specified trigger timer number. Type TSP-Link accessible Affected by Where saved Default value Function Usage trigger.timer[N].clear() Trigger timer number (1 to 4) Details This command sets the timer event detector to the undetected state and resets the overrun indicator.
  • Page 792: Trigger.timer[N].Delay

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference Also see trigger.timer[N].clear() (on page 11-412) trigger.timer[N].delay (on page 11-413) trigger.timer[N].reset() (on page 11-416) trigger.timer[N].delay This attribute sets and reads the timer delay. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Instrument reset...
  • Page 793: Trigger.timer[N].Delaylist

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual trigger.timer[N].delaylist This attribute sets an array of timer intervals. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Instrument reset Create configuration script 10e-6 (10 µs) Recall setup Save setup Trigger timer N reset Usage...
  • Page 794: Trigger.timer[N].Event_Id

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference trigger.timer[N].EVENT_ID This constant specifies the trigger timer event number. Type TSP-Link accessible Affected by Where saved Default value Constant Usage eventID = trigger.timer[N].EVENT_ID eventID The trigger event number Trigger timer number (1 to 4) Details This constant is an identification number that identifies events generated by this timer.
  • Page 795: Trigger.timer[N].Passthrough

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual Example print(trigger.timer[1].overrun) If an event was ignored, the output is true. If the event was not ignored, the output is false. Also see trigger.timer[N].reset() (on page 11-416) trigger.timer[N].passthrough This attribute enables or disables the timer trigger pass-through mode. Type TSP-Link accessible Affected by...
  • Page 796: Trigger.timer[N].Stimulus

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference Details The trigger.timer[N].reset() function resets the following attributes to their factory defaults: ▪ trigger.timer[N].count ▪ trigger.timer[N].delay ▪ trigger.timer[N].delaylist ▪ trigger.timer[N].passthrough ▪ trigger.timer[N].stimulus It also clears trigger.timer[N].overrun. Example trigger.timer[1].reset() Resets the attributes associated with timer 1 back to factory default values.
  • Page 797 Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual Details The eventID parameter may be one of the trigger event IDs shown in the following table. Trigger event IDs Trigger event ID Description channel.trigger[N].EVENT_ID A channel trigger event starts the scan. digio.trigger[N].EVENT_ID An edge (either rising, falling, or either based on the configuration of the line) on the digital input line.
  • Page 798: Trigger.timer[N].Wait()

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference trigger.timer[N].wait() This function waits for a trigger. Type TSP-Link accessible Affected by Where saved Default value Function Usage triggered = trigger.timer[N].wait(timeout) triggered Trigger detection indication Trigger timer number (1 to 4) timeout Maximum amount of time in seconds to wait for the trigger Details...
  • Page 799: Tsplink.group

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual Details This function waits up to timeout seconds for a trigger on the active command interface. A command interface trigger occurs when: • A GPIB GET command is detected (GPIB only) •...
  • Page 800: Tsplink.master

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference tsplink.master This attribute reads the node number assigned to the master node. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Not applicable Not applicable Not applicable Usage masterNodeNumber = tsplink.master masterNodeNumber...
  • Page 801: Tsplink.readbit()

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual tsplink.readbit() This function reads the state of a TSP-Link synchronization line. Type TSP-Link accessible Affected by Where saved Default value Function Usage data = tsplink.readbit(N) data The state of the synchronization line The trigger line (1 to 3) Details Returns a value of zero (0) if the line is low and 1 if the line is high.
  • Page 802: Tsplink.reset()

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference Also see TSP-Link trigger lines (on page 2-32) tsplink.readbit() (on page 11-422) tsplink.writebit() (on page 11-432) tsplink.writeport() (on page 11-432) tsplink.writeport() (on page 11-432) tsplink.reset() This function initializes (resets) all nodes (instruments) in the TSP-Link system. Type TSP-Link accessible Affected by...
  • Page 803: Tsplink.state

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual tsplink.state This attribute describes the TSP-Link online state. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Not applicable Not applicable Not applicable Usage state = tsplink.state state TSP-Link state (online or offline) Details...
  • Page 804: Tsplink.trigger[N].Clear()

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference tsplink.trigger[N].clear() This function clears the event detector for a LAN trigger. Type TSP-Link accessible Affected by Where saved Default value Function Usage tsplink.trigger[N].clear() The trigger line (1 to 3) to clear Details The trigger event detector enters the detected state when an event is detected.
  • Page 805: Tsplink.trigger[N].Mode

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual Also see None tsplink.trigger[N].mode This attribute defines the trigger operation and detection mode. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Instrument reset Create 0 (tsplink.TRIG_BYPASS) Recall setup configuration script TSP-Link trigger N reset...
  • Page 806: Tsplink.trigger[N].Overrun

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference When programmed to any mode except tsplink.TRIG_BYPASS, the output state of the I/O line is controlled by the trigger logic, and the user-specified output state of the line is ignored. When the trigger mode is set to tsplink.TRIG_RISING, the user-specified output state of the line is examined.
  • Page 807: Tsplink.trigger[N].Pulsewidth

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual Example print(tsplink.trigger[1].overrun) If an event was ignored, displays true; if an event was not ignored, displays false. Also see tsplink.trigger[N].assert() (on page 11-424) tsplink.trigger[N].clear() (on page 11-425) tsplink.trigger[N].mode (on page 11-426) tsplink.trigger[N].release() (on page 11-428) tsplink.trigger[N].reset()
  • Page 808: Tsplink.trigger[N].Reset()

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference Details Releases a trigger that was asserted with an indefinite pulse width. It also releases a trigger that was latched in response to receiving a synchronous mode trigger. Example tsplink.trigger[3].release() Releases trigger line 3.
  • Page 809: Tsplink.trigger[N].Stimulus

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual tsplink.trigger[N].stimulus This attribute specifies the event that causes the synchronization line to assert a trigger. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Reset Create configuration script Recall setup Save setup TSP-Link trigger N reset...
  • Page 810: Tsplink.trigger[N].Wait()

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference Example tsplink.trigger[3].stimulus = scan.trigger.EVENT_CHANNEL_READY Sets the trigger stimulus of the TSP-Link trigger line 3 event detector to scan the trigger channel ready event. Also see tsplink.trigger[N].assert() (on page 11-424) tsplink.trigger[N].reset() (on page 11-429) tsplink.trigger[N].wait()
  • Page 811: Tsplink.writebit()

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual tsplink.writebit() This function sets a TSP-Link trigger line high or low. Type TSP-Link accessible Affected by Where saved Default value Function Usage tsplink.writebit(N, data) The trigger line (1 to 3) data The value to write to the bit: ▪...
  • Page 812: Tsplink.writeprotect

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference Details The binary representation of data indicates the output pattern that is written to the I/O port. For example, a data value of 2 has a binary equivalent of 010. Line 2 is set high (1), and the other two lines are set low (0).
  • Page 813: Tspnet.clear()

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual tspnet.clear() This function clears any pending output data from the instrument. Type TSP-Link accessible Affected by Where saved Default value Function Usage tspnet.clear(connectionID) connectionID The connection ID returned from tspnet.connect() Details This function clears any pending output data from the device.
  • Page 814 TSP-enabled. If neither a portNumber nor an initString is provided, the remote device is assumed to be a Keithley Instruments TSP-enabled device. Depending on the state of the tspnet.tsp.abortonconnect attribute, the Series 3700A sends an abort command to the remote device on connection.
  • Page 815: Tspnet.disconnect()

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual tspnet.disconnect() This function disconnects a specified TSP-Net session. Type TSP-Link accessible Affected by Where saved Default value Function Usage tspnet.disconnect(connectionID) connectionID The connection ID returned from tspnet.connect() Details This function disconnects the two devices by closing the connection. The connectionID is the session handle returned by tspnet.connect().
  • Page 816: Tspnet.idn()

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference Details This command sends a command string to the remote instrument. A termination is added to the command string when it is sent to the remote instrument (tspnet.termination()). You can also specify a format string, which causes the command to wait for a response from the remote instrument.
  • Page 817: Tspnet.read()

    = tspnet.connect("192.0.2.1") Assume the instrument is at IP address 192.0.2.1. print(tspnet.idn(deviceID)) The output that is produced when you connect to the tspnet.disconnect(deviceID) instrument and read the identification string may appear KEITHLEY INSTRUMENTS,MODEL 3706A,00000170,01.10h Also see tspnet.connect() (on page 11-434) tspnet.read() This function reads data from a remote device.
  • Page 818: Tspnet.readavailable()

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference Example tspnet.write(deviceID, "*idn?\r\n") print("write/read returns:", tspnet.read(deviceID)) Send the "*idn?\r\n" message to the instrument connected as deviceID. Display the response that is read from deviceID (based on the *idn? message). Also see tspnet.connect() (on page 11-434)
  • Page 819: Tspnet.reset()

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual tspnet.reset() This function disconnects all TSP-Net sessions. Type TSP-Link accessible Affected by Where saved Default value Function Usage tspnet.reset() Details This command disconnects all remote instruments connected through TSP-Net. For TSP-enabled devices, this causes any commands or scripts running remotely to be terminated.
  • Page 820: Tspnet.timeout

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference Example deviceID = tspnet.connect("192.0.2.1") Sets termination type for IP address if deviceID then 192.0.2.1 to TERM_LF. tspnet.termination(deviceID, tspnet.TERM_LF) Also see tspnet.connect() (on page 11-434) tspnet.disconnect() (on page 11-436) tspnet.timeout This attribute sets the timeout value for the tspnet.connect(), tspnet.execute(), and tspnet.read() commands.
  • Page 821: Tspnet.tsp.abort()

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual tspnet.tsp.abort() This function causes the TSP-enabled instrument to stop executing any of the commands that were sent to it. Type TSP-Link accessible Affected by Where saved Default value Function Usage tspnet.tsp.abort(connectionID) connectionID...
  • Page 822: Tspnet.tsp.rbtablecopy()

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference Example tspnet.tsp.abortonconnect = 0 Configure the instrument so that it does not send an abort command when connecting to a TSP-enabled instrument. Also see tspnet.connect() (on page 11-434) tspnet.tsp.rbtablecopy() This function copies a reading buffer synchronous table from a remote instrument to a TSP-enabled instrument.
  • Page 823: Tspnet.tsp.runscript()

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual tspnet.tsp.runscript() This function loads and runs a script on a remote TSP-enabled instrument. Type TSP-Link accessible Affected by Where saved Default value Function Usage tspnet.tsp.runscript(connectionID, script) tspnet.tsp.runscript(connectionID, name, script) connectionID Integer value used as an identifier for other tspnet commands name...
  • Page 824: Tspnet.write()

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference tspnet.write() This function writes a string to the remote instrument. Type TSP-Link accessible Affected by Where saved Default value Function Usage tspnet.write(connectionID, "inputString") connectionID The connection ID returned from tspnet.connect() inputString The string to be written Details...
  • Page 825: Upgrade.previous()

    Use this command with caution. Make sure your instrument can support the earlier version and that there are no compatibility issues. Check with Keithley Instruments before using this command if you have questions. Also see...
  • Page 826: Userstring.add()

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference userstring.add() This function adds a user-defined string to nonvolatile memory. Type TSP-Link accessible Affected by Where saved Default value Function Usage userstring.add("name", "value") name The name of the string; the key of the key-value pair value The string to associate with name;...
  • Page 827: Userstring.delete()

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual Details The catalog provides access for user-defined string pairs, allowing you to manipulate all the key-value pairs in nonvolatile memory. The entries are enumerated in no particular order. Example 1 for name in userstring.catalog() do Deletes all user-defined strings in nonvolatile userstring.delete(name)
  • Page 828: Userstring.get()

    Series 3700A System Switch/Multimeter Reference Manual Section 11: TSP command reference userstring.get() This function retrieves a user-defined string from nonvolatile memory. Type TSP-Link accessible Affected by Where saved Default value Function Usage value = userstring.get("name") value The value of the user-defined string key-value pair name The name (key) of the user-defined string Details...
  • Page 829: Waitcomplete()

    Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual waitcomplete() This function waits for all previously started overlapped commands to complete. Type TSP-Link accessible Affected by Where saved Default value Function Usage waitcomplete() waitcomplete(group) group Specifies which TSP-Link group on which to wait Details There are two types of instrument commands: •...
  • Page 830: Troubleshooting Guide

    Error and status messages ............ 12-9 Contacting support If you have any questions after reviewing this information, please contact your local Keithley Instruments representative or call Keithley Instruments corporate headquarters (toll-free inside the U.S. and Canada only) at 800-935-5595, or from outside the U.S. at +1-440-248-0400. For worldwide...
  • Page 831: Usb Troubleshooting

    Section 12: Troubleshooting guide Series 3700A System Switch/Multimeter Reference Manual To identify installed switching cards from the web interface: 1. Select the Unit page. 2. In the Report area, select the slots that you want information about. 3. Select Firmware Revision. 4.
  • Page 832 Series 3700A System Switch/Multimeter Reference Manual Section 12: Troubleshooting guide Figure 143: Device Manager dialog box showing USB Test and Measurement Device 3. Right-click the device. 4. Select Properties. 5. Select the Driver tab. 6. Click Driver Details. 7. Verify that the device driver is the ausbtmc.sys driver from IVI Foundation. 3700AS-901-01 Rev.
  • Page 833: Troubleshooting Gpib Interfaces

    8. If the incorrect driver is installed, click OK. 9. If this does not work, uninstall VISA, unplug the instrument, and follow the steps to reinstall VISA in the section Modifying, repairing, or removing Keithley I/O Layer software (on page 2-24). Troubleshooting GPIB interfaces...
  • Page 834: Timeout Errors

    Series 3700A System Switch/Multimeter Reference Manual Section 12: Troubleshooting guide Timeout errors If your GPIB controller is recognized by the operating system, but you get a timeout error when you try to communicate with the instrument, check the following: 1. Confirm that the GPIB address you assigned to the instrument is unique and between 0 to 30. Do not use 0 or 21 because they are common controller addresses.
  • Page 835: Use Ping To Test The Connection

    LXI consortium. For Keithley’s LXI instruments, the standard LXI pages use standard HTML. The added value pages that Keithley has added to control the instruments use Java. If Java is not installed when you select one of these instrument-specific web pages, the web page prompts you to install it.
  • Page 836: Lxi Lan Status Indicator

    When the Java applet from the instrument gets downloaded into the browser it will ask you if you trust this active content from Keithley Instruments. Select Yes. If you have resolved the problems, the instrument control pages should work and if you try to perform an action, such as closing a relay, you are prompted for the password (the default is “admin”).
  • Page 837: Communicate Using Visa Communicator

    There are several interactive communication utilities that you can use to communicate with LAN instruments: • The KIOL installs the Keithley Communicator. • NI VISA (full version) installs the NI VISA Interactive Control utility, which can also be launched from NI-MAX.
  • Page 838: Update Drivers

    Series 3700A System Switch/Multimeter Reference Manual Section 12: Troubleshooting guide Update drivers For the latest drivers and additional support information, see the Keithley Instruments support website (https://www.tek.com/support). To see what drivers are available for your instrument: 1. Go to the Product Support web page (https://www.tek.com/product-support).
  • Page 839: Retrieving Errors

    Section 12: Troubleshooting guide Series 3700A System Switch/Multimeter Reference Manual Retrieving errors When errors occur, the error messages are placed in the error queue. Use errorqueue commands to request error message information. For example, the following commands request the complete set of information about the next message in the error queue.
  • Page 840 Series 3700A System Switch/Multimeter Reference Manual Section 12: Troubleshooting guide Error and status messages Error number Error level Error message -120 RECOVERABLE Numeric data -109 RECOVERABLE Missing parameter -108 RECOVERABLE Parameter not allowed -105 RECOVERABLE Trigger not allowed -104 RECOVERABLE Data type -101 RECOVERABLE...
  • Page 841 Section 12: Troubleshooting guide Series 3700A System Switch/Multimeter Reference Manual Error and status messages Error number Error level Error message 1401 RECOVERABLE Parameter %d is invalid, where %d represents a number 1402 RECOVERABLE User scripts lost 1403 RECOVERABLE Factory scripts lost 1404 RECOVERABLE Invalid byte order...
  • Page 842 Series 3700A System Switch/Multimeter Reference Manual Section 12: Troubleshooting guide Error and status messages Error number Error level Error message 2217 RECOVERABLE File system busy 2218 RECOVERABLE Disk full 2219 RECOVERABLE File corrupt 2220 RECOVERABLE File already exists 2221 RECOVERABLE File seek error 2222 RECOVERABLE...
  • Page 843 Section 12: Troubleshooting guide Series 3700A System Switch/Multimeter Reference Manual Error and status messages Error number Error level Error message ICX parameter invalid value, %s (Line #%d), where %s and %d 4905 RECOVERABLE provide more information on error ICX invalid function id, %s (Line #%d), where %s and %d provide 4906 RECOVERABLE more information on error...
  • Page 844 Series 3700A System Switch/Multimeter Reference Manual Section 12: Troubleshooting guide Error and status messages Error number Error level Error message 5606 RECOVERABLE 100 2-w zero error 5607 RECOVERABLE 10k 2-w zero error 5608 RECOVERABLE 100k 2-w zero error 5609 RECOVERABLE 10M 2-w zero error 5610 RECOVERABLE...
  • Page 845 Section 12: Troubleshooting guide Series 3700A System Switch/Multimeter Reference Manual Error and status messages Error number Error level Error message 5647 RECOVERABLE 100m vac dac error 5648 RECOVERABLE 1 vac dac error 5649 RECOVERABLE 10 vac dac error 5650 RECOVERABLE 100 vac dac error 5651 RECOVERABLE...
  • Page 846 Series 3700A System Switch/Multimeter Reference Manual Section 12: Troubleshooting guide Error and status messages Error number Error level Error message 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...
  • Page 847 Section 12: Troubleshooting guide Series 3700A System Switch/Multimeter Reference Manual Error and status messages Error number Error level Error message 5731 RECOVERABLE 1k 4-w ocomp Ioff full scale error 5732 RECOVERABLE Questionable calibration 5733 RECOVERABLE Questionable temperature 5734 RECOVERABLE Internal DMM system error 5735 RECOVERABLE General unknown DMM error...
  • Page 848: Frequently Asked Questions

    Section 13 Frequently asked questions In this section: How do I get my LAN or web connection to work? ....13-1 Why can't I close a channel? ..........13-1 How do I know if an error has occurred on my instrument? ... 13-2 How do I find the serial number and firmware version? ..
  • Page 849: How Do I Know If An Error Has Occurred On My Instrument

    Section 13: Frequently asked questions Series 3700A System Switch/Multimeter Reference Manual Figure 145: Channel configuration dialog box 3. If the forbidden box is selected, the channel is forbidden to close. To allow the channel to close, clear the box. 4. Click OK to save the change. To check the forbidden state of a channel from a remote interface: You can also clear, check, and set the forbidden state of channels using the following commands: •...
  • Page 850: How Do I Find The Serial Number And Firmware Version

    Series 3700A System Switch/Multimeter Reference Manual Section 13: Frequently asked questions How do I find the serial number and firmware version? The serial number is on the rear panel of the instrument. You can also use the front panel MENU option to display the serial number and firmware version.
  • Page 851: Next Steps

    Additional Series 3700A information ........14-1 Additional Series 3700A information For additional information about the Series 3700A, refer to the Keithley Instruments website http://www.tek.com/keithley. It contains the most up-to-date information. From the website, you can access: • The Knowledge Center, which contains the following handbooks: ▪...
  • Page 852: Lan Concepts And Settings

    Appendix A LAN concepts and settings In this appendix: Overview .................. A-1 Establishing a point-to-point connection ........A-1 Connecting to the LAN ............. A-9 LAN speeds ................A-12 Duplex mode ................A-12 Viewing LAN status messages ..........A-13 Viewing the network settings ..........A-13 Selecting a LAN interface protocol .........
  • Page 853: Step 1: Identify And Record The Existing Ip Configuration

    Appendix A: LAN concepts and settings Series 3700A System Switch/Multimeter Reference Manual If you have problems, see LAN troubleshooting suggestions (on page 12-5). Record all network configurations before modifying any existing network configuration information on the network interface card. Once the network configuration settings are updated, the previous information is lost.
  • Page 854: Step 2: Disable Dhcp To Use The Computer's Existing Ip Address

    Series 3700A System Switch/Multimeter Reference Manual Appendix A: LAN concepts and settings 3. When the information is displayed, record the following information for the network card: ▪ DHCP mode: _______________________________ ▪ IP address: ________________________________ ▪ Subnet mask: ______________________________ ▪ Default gateway: ____________________________ ▪...
  • Page 855 Appendix A: LAN concepts and settings Series 3700A System Switch/Multimeter Reference Manual 4. Double-click Internet Protocol (TCP/IP) in the items list. The Internet Protocol (TCP/IP) Properties dialog box is displayed, as shown here. Figure 147: Internet Protocol (TCP/IP) Properties dialog box 5.
  • Page 856 Series 3700A System Switch/Multimeter Reference Manual Appendix A: LAN concepts and settings 4. In the "This connection uses the following items" list, double-click Internet Protocol (TCP/IP). The Internet Protocol (TCP/IP) Properties dialog box is displayed. Figure 148: Internet Protocol (TCP/IP) Properties dialog box 5.
  • Page 857 Appendix A: LAN concepts and settings Series 3700A System Switch/Multimeter Reference Manual 7. Double-click Internet Protocol Version 4 (TCP/IPv4) in the items list. The Internet Protocol Version 4 (TCP/IPv4) Properties dialog box is displayed. Figure 149: Internet Protocol (TCP/IP) Properties dialog box 8.
  • Page 858: Step 3: Configure The Instrument's Lan Settings

    Series 3700A System Switch/Multimeter Reference Manual Appendix A: LAN concepts and settings 4. In the items list, double-click Internet Protocol Version 4 (TCP/IPv4). The Internet Protocol Version 4 (TCP/IPv4) Properties dialog box is displayed. Figure 150: Internet Protocol (TCP/IP) Properties dialog box 5.
  • Page 859: Step 4: Install The Crossover Cable

    Appendix A: LAN concepts and settings Series 3700A System Switch/Multimeter Reference Manual 4. Enter the IP address using the LAN CONFIG menu: Select CONFIG > IP-ADDRESS. Refer to the recorded computer's IP address (Step 1: Identify and record the existing IP configuration (on page A-2)).
  • Page 860: Step 5: Access The Instrument's Web Page

    Series 3700A System Switch/Multimeter Reference Manual Appendix A: LAN concepts and settings Connect the crossover cable into the same computer LAN port used during instrument configuration to ensure that the system is using the correct network card. Figure 151: Series 3700A LAN connection Step 5: Access the instrument's web page 1.
  • Page 861: Setting The Lan Configuration Method

    Appendix A: LAN concepts and settings Series 3700A System Switch/Multimeter Reference Manual Setting the LAN configuration method There are two methods used to configure the LAN. AUTO: Use the AUTO setting to allow the DHCP server to automatically set the LAN settings. You do not need to set the LAN options manually.
  • Page 862: Setting The Subnet Mask

    Series 3700A System Switch/Multimeter Reference Manual Appendix A: LAN concepts and settings Setting the subnet mask Contact your corporate information technology (IT) department to secure a valid subnet mask for the instrument when placing the instrument on a corporate network. To set the subnet mask when LAN configuration method is set to MANUAL: 1.
  • Page 863: Lan Speeds

    Appendix A: LAN concepts and settings Series 3700A System Switch/Multimeter Reference Manual To set the DNS server IP addresses: 1. From the front panel, press the MENU key and select LAN > CONFIG > DNS. 2. Turn the navigation wheel to select either DNS-ADDRESS1 or DNS-ADDRESS2.
  • Page 864: Viewing Lan Status Messages

    Series 3700A System Switch/Multimeter Reference Manual Appendix A: LAN concepts and settings Viewing LAN status messages To view the LAN status messages: 1. From the front panel, press the MENU key and select LAN > STATUS > CONFIG/FAULT. 2. Press the ENTER key. Figure 152: LAN CONFIG/FAULT There are two types of LAN status messages: •...
  • Page 865: Confirming The Active Speed And Duplex Negotiation

    Appendix A: LAN concepts and settings Series 3700A System Switch/Multimeter Reference Manual Confirming the active speed and duplex negotiation The Series 3700A automatically detects the speed and duplex negotiation active on the LAN. Once the speed and duplex negotiation is detected, the instrument automatically adjusts its own settings to match the LAN settings.
  • Page 866: Vxi-11 Connection

    Raw socket connection All Keithley instruments that have LAN connections support raw socket communication. This means that you can connect to the TCP/IP port on the instrument and send and receive commands. A programmer can easily communicate with the instrument using the Winsock API on computers with ®...
  • Page 867 Appendix A: LAN concepts and settings Series 3700A System Switch/Multimeter Reference Manual Figure 153: Connection description dialog box 2. Type a name to identify the connection (for example, My Instrument), and then click OK. 3. In the Connect To dialog box, click the Connect using list. Select TCP/IP (Winsock). Figure 154: Connect To dialog box 4.
  • Page 868 Series 3700A System Switch/Multimeter Reference Manual Appendix A: LAN concepts and settings Figure 155: Properties dialog box 8. Click ASCII Setup. The ASCII Setup dialog box is displayed. 9. From the ASCII Setup dialog box, select the following options: ▪ Send line ends with line feeds ▪...
  • Page 869: Logging Lan Trigger Events In The Event Log

    Appendix A: LAN concepts and settings Series 3700A System Switch/Multimeter Reference Manual Logging LAN trigger events in the event log You can use the event log to record all LXI triggers generated and received by the Series 3700A, and you can view the event log using any command interface or the embedded web interface. The following figure shows the view of the LXI event log from the embedded web interface.
  • Page 870 Series 3700A System Switch/Multimeter Reference Manual Appendix A: LAN concepts and settings Event log descriptions Column title Description Example HWDetect Identifies a valid LXI trigger packet Sequence Each instrument maintains independent sequence counters: ▪ One for each combination of UDP multicast network interface and UDP multicast destination port ▪...
  • Page 872: Verification And Adjustment

    Adjustment ................B-20 Verification Use the procedures in this section to verify that the Keithley Instruments Series 3700A System Switch/Multimeter's accuracy is within the limits stated in the instrument’s one-year accuracy specifications. Verifying the accuracy of your Series 3700A is recommended: •...
  • Page 873: Verification Test Requirements

    Appendix B: Verification and adjustment Series 3700A System Switch/Multimeter Reference Manual Verification test requirements Be sure that you perform these verification tests: • Under the proper environmental conditions. • After the specified warmup period. • Using the correct line voltage. •...
  • Page 874 Series 3700A System Switch/Multimeter Reference Manual Appendix B: Verification and adjustment The Keithley Instruments Model 3706-190 backplane connector board is an accessory that can be used to make connections to the calibrator. Additional boards, such as a 4-wire short or the discrete resistors, would also be convenient to eliminate rewiring for different setups used in verification.
  • Page 875: Performing The Verification Test Procedures

    Appendix B: Verification and adjustment Series 3700A System Switch/Multimeter Reference Manual Calculating resistance reading limits Resistance reading limits must be recalculated based on the actual calibration resistance values supplied by the equipment manufacturer. Calculations are performed in the same manner as shown in the preceding example.
  • Page 876: Series 3700A Verification Tests

    Series 3700A System Switch/Multimeter Reference Manual Appendix B: Verification and adjustment Test considerations When performing the verification procedures: • Be sure to restore factory front panel defaults as outlined in Restoring factory defaults (on page B-4). • Make sure that the test equipment is properly warmed up and connected to the Series 3700A terminals.
  • Page 877 Appendix B: Verification and adjustment Series 3700A System Switch/Multimeter Reference Manual Figure 158: DC voltage verification DC voltage verification data Use the following values to verify the performance of the Series 3700A. Actual values depend on the published specifications (see Example reading limit calculation (on page B-3)).
  • Page 878 Series 3700A System Switch/Multimeter Reference Manual Appendix B: Verification and adjustment 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...
  • Page 879 Appendix B: Verification and adjustment Series 3700A System Switch/Multimeter Reference Manual ACV verification data Use the following values to verify the performance of the Series 3700A. Actual values depend on published specifications (see Example reading limit calculation (on page B-3)). Connect to the Fluke 5700A calibrator Description Range (V)
  • Page 880 Series 3700A System Switch/Multimeter Reference Manual Appendix B: Verification and adjustment Verifying DC current 10 µA to 100 µA ranges Check DC current accuracy by applying accurate current from the DC current calibrator to the Series 3700A analog backplane connector and verifying that the displayed readings fall within specified limits.
  • Page 881 To verify DC current accuracy: 1. Connect the Series 3700A AMPS and LO INPUT pins to the DC current calibrator as shown in the "DC current verification 1 mA to 3 A ranges diagram" below, using the Keithley Instruments Model 3706-751 fixture cable.
  • Page 882 Series 3700A System Switch/Multimeter Reference Manual Appendix B: Verification and adjustment Figure 162: DC current verification 3A range diagram DC current verification data 1 mA to 3 A ranges Use the following values to verify the performance of the Series 3700A. Actual values depend on published specifications (see Example reading limit calculation (on page B-3)).
  • Page 883 Appendix B: Verification and adjustment Series 3700A System Switch/Multimeter Reference Manual Verifying AC current 1 mA to 3 A ranges Check AC current accuracy by applying accurate current from the AC current calibrator at specific frequencies to the Series 3700A analog backplane connector and verifying that the displayed readings fall within specified limits.
  • Page 884 Series 3700A System Switch/Multimeter Reference Manual Appendix B: Verification and adjustment AC current verification data 1 mA to 1 A ranges Use the following values to verify the performance of the Series 3700A. Actual values depend on published specifications (see Example reading limit calculation (on page B-3)).
  • Page 885 Appendix B: Verification and adjustment Series 3700A System Switch/Multimeter Reference Manual Figure 165: Frequency verification Frequency verification data Use the following values to verify the performance of the Series 3700A. Actual values depend on published specifications (see Example reading limit calculation (on page B-3)).
  • Page 886 Series 3700A System Switch/Multimeter Reference Manual Appendix B: Verification and adjustment 7. Source the nominal full-scale resistance values for the 100 Ω to 10 MΩ ranges summarized in the 4-wire resistance verification data (on page B-15) table. Recalculate the limits based on the actual value of the resistor and verify the reading is within the calculated limits.
  • Page 887 Appendix B: Verification and adjustment Series 3700A System Switch/Multimeter Reference Manual To verify normal resistance accuracy: 1. Using shielded, Teflon-insulated or equivalent cables in a 2-wire configuration, connect the Series 3700A INPUT and SENSE pins to the calibrator as shown in the "2-wire resistance verification diagram"...
  • Page 888 Series 3700A System Switch/Multimeter Reference Manual Appendix B: Verification and adjustment To verify dry circuit resistance accuracy: 1. Using shielded, Teflon-insulated or equivalent cables in a 4-wire configuration, connect the Series 3700A INPUT and SENSE pins to the calibrator as shown for 100 Ω to 10 MΩ ranges. 2.
  • Page 889 Appendix B: Verification and adjustment Series 3700A System Switch/Multimeter Reference Manual Verifying 1 Ω and 10 Ω resistance ranges Check the normal resistance function by connecting accurate resistance values to the Series 3700A analog backplane connector and verifying that the displayed readings fall within specified limits. Do not exceed 300 V between INPUT HI and INPUT LO because instrument damage may PEAK...
  • Page 890 Series 3700A System Switch/Multimeter Reference Manual Appendix B: Verification and adjustment Verifying zeros using a 4-wire short Check the zeros of various test points while the 4-wire is connected to the Series 3700A analog backplane connector and verify that the displayed readings fall within specified limits. Do not exceed 300 V between INPUT HI and INPUT LO because instrument damage may PEAK...
  • Page 891: Adjustment

    The asterisk (*) designates the ranges that offset compensation is being used. This completes the verification procedure. Adjustment Use the procedures in this section to adjust the Keithley Instruments Series 3700A System Switch/Multimeter. The information in this section is intended for qualified service personnel only, as described...
  • Page 892: Environmental Conditions

    Series 3700A System Switch/Multimeter Reference Manual Appendix B: Verification and adjustment Environmental conditions Conduct the adjustment 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 At the factory, instruments are calibrated without any switch cards installed and all slots are covered with blank slot covers.
  • Page 893: Adjustment

    Appendix B: Verification and adjustment Series 3700A System Switch/Multimeter Reference Manual Adjustment cycle Perform adjustment at least once a year, or every 90 days to ensure the instrument meets the corresponding specifications. Recommended equipment The following table lists the recommended equipment and settings you need for DC-only, and AC- only adjustment procedures.
  • Page 894: Remote Adjustment Procedure

    1. Connect the Series 3700A to the IEEE-488 bus of the computer using a shielded IEEE-488 cable, such as the Keithley Instruments Model 7007, over the ethernet, or directly to a computer through the ethernet port using a crossover cable.
  • Page 895 Appendix B: Verification and adjustment Series 3700A System Switch/Multimeter Reference Manual Figure 171: 4-wire short diagram DC adjustment step 0: A/D MUX Offset (factory calibration only) Send the commands: dmm.calibration.dc(0) print("done") print(errorqueue.count) DC adjustment step 1: Input four-wire short circuit 1.
  • Page 896 Series 3700A System Switch/Multimeter Reference Manual Appendix B: Verification and adjustment DC adjustment step 3: +10 V Figure 172: DC voltage calibration 1. Connect a cable between the calibrator and the Series 3700A. 2. Allow the instrument to settle for 30 seconds. 3.
  • Page 897 Appendix B: Verification and adjustment Series 3700A System Switch/Multimeter Reference Manual Resistance adjustment Perform the following adjustment steps (DC adjustment step 6 through step 9): Figure 173: Resistance calibration DC adjustment step 6: 100 Ω 1. Send the commands: dmm.func = dmm.FOUR_WIRE_OHMS dmm.range = 100 2.
  • Page 898 Series 3700A System Switch/Multimeter Reference Manual Appendix B: Verification and adjustment DC adjustment step 8: 100 kΩ 1. Send the command: dmm.range = 100e+3 2. Source 100 kΩ. 3. Read the resistor value from the calibrator. 4. Send the command: dmm.calibration.dc(8, (resistorValue)) print("done") Where resistorValue is the resistor value read in step 3.
  • Page 899 Appendix B: Verification and adjustment Series 3700A System Switch/Multimeter Reference Manual DC adjustment step 11: 1 mA 1. Send the command: dmm.range = 1e-3 2. Source 1 mA. 3. Send the command: dmm.calibration.dc(11,.001) print("done") DC adjustment step 12: 10 mA 1.
  • Page 900 Series 3700A System Switch/Multimeter Reference Manual Appendix B: Verification and adjustment AC adjustment step 1: 10 mV at 1 kHz 1. Send the commands: dmm.func = dmm.AC_VOLTS dmm.range = 10e-3 2. Source 10 mV at 1 kHz. 3. Send the command: dmm.calibration.ac(1) print("done") AC adjustment step 2: 100 mV at 1 kHz 1.
  • Page 901 Appendix B: Verification and adjustment Series 3700A System Switch/Multimeter Reference Manual AC adjustment step 8: 100 V at 1 kHz 1. Send the command: dmm.range = 100 2. Source 100 V at 1 kHz. 3. Send the command: dmm.calibration.ac(8) print("done") AC adjustment step 9: 100 V at 50 kHz 1.
  • Page 902 Series 3700A System Switch/Multimeter Reference Manual Appendix B: Verification and adjustment AC adjustment step 12: 1 mA at 1 kHz 1. Send the following command: dmm.range = 1e-3 2. Source 1 mA at 1 kHz. 3. Send the following command: dmm.calibration.ac(12) print("done") AC adjustment step 13: 10 mA at 1 kHz 1.
  • Page 903 Appendix B: Verification and adjustment Series 3700A System Switch/Multimeter Reference Manual Frequency adjustment Make the connections as shown below, then perform the following adjustment steps (AC adjustment step 17 and step 18): Figure 177: Low frequency calibration AC adjustment step 17: 1 V at 10 Hz (factory calibration only) 1.
  • Page 904 Series 3700A System Switch/Multimeter Reference Manual Appendix B: Verification and adjustment Save adjustments Program today's date, calibration due date, and serial number, 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()
  • Page 906: Status Model

    TSP-Link system status ............C-20 Overview Each Keithley Instruments Series 3700A provides a number of status registers and queues that are collectively referred to as the status model. Through manipulation and monitoring of these registers and queues, you can view and control various instrument events. You can include commands in your test program that can determine if a service request (SRQ) event has occurred and the cause of the event.
  • Page 907 Appendix C: Status model Series 3700A System Switch/Multimeter Reference Manual • Positive Transition Register (PTR) (.ptr): When a bit is set in this read-write register, it enables a 0 to 1 change in the corresponding bit of the condition register to cause the corresponding bit in the event register to be set.
  • Page 908: Status Model Diagrams

    Series 3700A System Switch/Multimeter Reference Manual Appendix C: Status model Status model diagrams The register sets (and queues) monitor various instrument events. When an enabled event occurs in one of the five registers, it sets the associated summary bit in the Status Byte register. When a summary bit of the Status Byte is set and its corresponding enable bit is set (as programmed using status.request_enable), the MSS bit will set to indicate that an SRQ has occurred.
  • Page 909: Measurement Summary Bit (Measurement Event Register

    Appendix C: Status model Series 3700A System Switch/Multimeter Reference Manual Measurement summary bit (Measurement event register) The summary bit of the measurement event register provides enabled summary information to Bit B0 (MSB) of the status byte. Figure 180: Measurement event register 3700AS-901-01 Rev.
  • Page 910: System Summary Bit (System Register

    Series 3700A System Switch/Multimeter Reference Manual Appendix C: Status model System summary bit (System register) The summary bit of the system register provides enabled summary information to Bit B1 (SSB) of the status byte. Figure 181: System summary bit (System Register) 3700AS-901-01 Rev.
  • Page 911 Appendix C: Status model Series 3700A System Switch/Multimeter Reference Manual As shown above, there are five register sets associated with System Event Status. These registers summarize system status for various nodes connected to the TSP-Link. Note that all nodes on the TSP-Link share a copy of the system summary registers once the TSP-Link has been initialized.
  • Page 912: Standard Event Register

    Series 3700A System Switch/Multimeter Reference Manual Appendix C: Status model Standard Event Register The bits used in the Standard Event Register are described as follows: • Bit B0, Operation Complete (OPC): Set bit indicates that all pending selected device operations are completed and the Series 3700A instrument is ready to accept new commands.
  • Page 913: Error Available Bit (Error Or Event Queue

    Appendix C: Status model Series 3700A System Switch/Multimeter Reference Manual Standard event commands Command Description *ESR? Read Standard Event Status Register. print(status.standard.event) *ESE <mask> Program the Event Status Enable Register: <mask> = 0 to 255 status.standard.enable = <mask> Status register set contents (on page C-1).
  • Page 914: Questionable Summary Bit (Questionable Event Register

    Series 3700A System Switch/Multimeter Reference Manual Appendix C: Status model Questionable summary bit (Questionable event register) The summary bit of the questionable event register provides enabled summary information to Bit B3 (QSB) of the status byte. Figure 183: Questionable event register As shown above, there is only one register set associated with the questionable status.
  • Page 915: Message Available Bit (Output Queue

    Appendix C: Status model Series 3700A System Switch/Multimeter Reference Manual Message available bit (Output queue) The summary bit of the output queue provides enabled summary information to Bit B4 (MAV) of the status byte. The Message Available Bit (MAV) is set when the Output queue holds data that pertains to the normal operation of the instrument.
  • Page 916: Master Summary Status Bit (Mss Bit Register

    Series 3700A System Switch/Multimeter Reference Manual Appendix C: Status model For example, any of the following statements will set the operation complete enable bit: standardRegister = status.standard.OPC status.questionable.enable = status.standard.OPERATION_COMPLETE status.questionable.enable = 1 The bits used in this register set are described as follows: •...
  • Page 917: Operation Summary Bit (Operation Event Register

    Appendix C: Status model Series 3700A System Switch/Multimeter Reference Manual Operation summary bit (Operation event register) The summary bit of the operation event register provides enabled summary information to Bit B7 (OSB) of the status byte. Figure 185: Operation event registers Operation user bit (Operation user register) The summary bit of the operation user register provides the user bit (User) (Bit B12) to the operation status register.
  • Page 918: Status Function Summary

    Series 3700A System Switch/Multimeter Reference Manual Appendix C: Status model Status function summary The following functions and attributes control and read the various registers. Additional information is included in the command listings for the various register sets. Status function summary Type Function or attribute System summary...
  • Page 919: Startup State

    Appendix C: Status model Series 3700A System Switch/Multimeter Reference Manual Startup state When the System Switch/Multimeter is turned on, various register status elements are set as follows: • The power on (PON) bit in the status.operation.condition register is set. • Other bits are set appropriately based on the instrument's power-on configuration.
  • Page 920: Reading Registers

    Series 3700A System Switch/Multimeter Reference Manual Appendix C: Status model Reading registers Any register in the status structure can be read either by sending the common command query (where applicable), or by including the script command for that register in either the print() or print(tostring()) command.
  • Page 921: Service Request Enable Register

    Appendix C: Status model Series 3700A System Switch/Multimeter Reference Manual Service Request Enable Register The Service Request Enable Register controls the generation of a service request. This register is programmed by the user and is used to enable or disable the setting of bit B6 (RQS/MSS) by the Status Summary Message bits (B0, B1, B2, B3, B4, B5, and B7) of the Status Byte Register.
  • Page 922: Serial Polling And Srq

    Series 3700A System Switch/Multimeter Reference Manual Appendix C: Status model Figure 188: Status byte and service request (SRQ) The bits of the Status Byte Register are described as follows: • Bit B0, Measurement Summary Bit (MSB): Set summary bit indicates that an enabled measurement event has occurred.
  • Page 923: Spe, Spd (Serial Polling

    Appendix C: Status model Series 3700A 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 a service request (SRQ). In your test program, you can periodically read the Status Byte to check if an SRQ occurred and what caused it.
  • Page 924: Status Byte And Service Request Commands

    Series 3700A System Switch/Multimeter Reference Manual Appendix C: 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 in the table below. Note that the table includes both common commands and their script command equivalents.
  • Page 925: Tsp-Link System Status

    Appendix C: Status model Series 3700A System Switch/Multimeter Reference Manual TSP-Link system status ® The TSP-Link expansion interface allows instruments to communicate with each other. The test system can be expanded to include up to 32 TSP-enabled instruments. In a TSP-Link system, one node (instrument) is the master and the other nodes are the subordinates.
  • Page 926 Series 3700A System Switch/Multimeter Reference Manual Appendix C: Status model The following commands (sent from the master node) enable the appropriate register bits for the above example: Node 15 status registers: The following commands enable the events for Node 15: node[15].status.questionable.enable = status.questionable.S1INL node[15].status.node_enable = status.QSB The affected status registers for the above commands are indicated by labels (1) and (2) (see the...
  • Page 928: Index

    Index verification data • B-8 adjustcount • 11-40 +5 V output • 2-31 adjustdate • 11-41 allslots notation • 11-2 AMPS 1 ohm resistance range, verify • B-18 fuse replacement • 7-2 measurement • 4-17 anonymous script • 10-6 appending readings • 6-6 2-wire arrays •...
  • Page 929 Index Series 3700A System Switch/Multimeter Reference Manual overview • 6-1 channel.getclose() • 11-61 programming examples • 6-9 channel.getcount() • 11-62 ptpseconds • 11-29 channel.getdelay() • 11-64 reading attributes • 6-10 channel.getforbidden() • 11-65 reading buffer • 6-8 channel.getimage() • 11-66 read-only attributes •...
  • Page 930 Series 3700A System Switch/Multimeter Reference Manual Index low level • 4-64 port • 3-30 performance • 4-2 using TSP-Link synchronization lines • 2-34 test • B-5 digital I/O port constant-current source method • 8-8 bit weighting • 2-33 Contact information • 1-1 commands •...
  • Page 931 Index Series 3700A System Switch/Multimeter Reference Manual access recall attributes example • 6-12 groups, TSP-Link digital I/O programming • 2-34 assigning • 10-60 dynamic buffer programming example • 6-14 coordinating overlapped operations • 10-61 exceeding reading buffer capacity • 6-16 leader •...
  • Page 932 Series 3700A System Switch/Multimeter Reference Manual Index reference • 10-15 running • 10-6, 10-11 node event log • 5-44 assign number • 10-55 LXI Class B triggering (IEEE-1588) • 5-41 functions • 11-311 master overview • 10-60 nonvolatile memory storage of scripts • 10-2 MAC address •...
  • Page 933 Index Series 3700A System Switch/Multimeter Reference Manual command reference • 11-1 instrument programming • 10-1 repeating average filter • 4-72 queries • 9-2 requirements queues • C-2 verification tests • B-2 error • C-2 reset event • C-2 digio trigger • 11-126 output •...
  • Page 934 Series 3700A System Switch/Multimeter Reference Manual Index user • 10-4, 10-6, 10-8, 10-11 trigger functions and attributes • 11-432 scripts, error effects • 12-10 trigger mode serial number • 1-4 syntax rules • 11-2 serial polling • C-19 Trigger model components •...
  • Page 935 Index Series 3700A System Switch/Multimeter Reference Manual catalog • 11-475 delete • 11-476 get • 11-477 UTC • 11-41, 11-48, 11-372 values • 6-12, 11-41, 11-48 variables • 10-16 verification • 11-48 limits • B-3 test procedures • B-4, B-5 test requirements •...
  • Page 936 All Keithley trademarks and trade names are the property of Keithley Instruments. All other trademarks and trade names are the property of their respective companies. Keithley Instruments Corporate Headquarters • 28775 Aurora Road • Cleveland, Ohio 44139 • 440-248-0400 • Fax: 440-248-6168 • 1-800-935-5595 • www.tek.com/keithley 12/17...

Table of Contents