Page 1
www.keithley.com Models 707B and 708B Switching Matrix Reference Manual 707B-901-01 Rev. B / January 2015 *P707B90101B* 707B-901-01 A Greater M easure of Confidence A T ektr onix Company...
Page 4
Safety precautions The following safety precautions should be observed before using this product and any associated instrumentation. Although some instruments and accessories would normally be used with nonhazardous voltages, there are situations where hazardous conditions may be present. This product is intended for use by qualified personnel who recognize shock hazards and are familiar with the safety precautions required to avoid possible injury.
Page 5
accessories are used in a manner not specified in the operating instructions, the protection provided by the equipment may be impaired. Do not exceed the maximum signal levels of the instruments and accessories, as defined in the specifications and operating information, and as shown on the instrument or test fixture panels, or switching card.
Table of Contents Introduction ....................... 1-1 Contact information ......................1-1 Overview ..........................1-1 Extended warranty ....................... 1-1 General operation ..................... 2-1 Rear panel overview ......................2-1 Model 707B Rear panel ......................2-2 Model 708B Rear panel ......................2-2 Wiring ........................... 2-2 Communication connections .....................
Page 7
Table of Contents Models 707B and 708B Switching Matrix Reference Manual Trigger model components......................3-3 Trigger model events and associated commands ..............3-3 Scan and step counts......................3-4 Basic scan procedure ......................3-5 Changing attributes of an existing scan ..................3-6 Front-panel scanning ........................
Page 8
Models 707B and 708B Switching Matrix Reference Manual Table of Contents opc function ..........................5-11 print functions .......................... 5-11 Reset ............................5-11 Scan ............................5-12 Scripting ..........................5-12 Slot ............................5-13 Status model functions ......................5-13 timer functions ......................... 5-13 trigger functions and attributes ....................
Page 9
Table of Contents Models 707B and 708B Switching Matrix Reference Manual Using TSP-Net with any Ethernet-enabled device ..............6-53 TSP-Net compared to TSP-Link to communicate with TSP-enabled devices ......6-54 TSP-Net instrument commands: General device control ............6-54 TSP-Net instrument commands: TSP-enabled device control ..........6-54 Example: Using tspnet commands ..................
Page 14
Models 707B and 708B Switching Matrix Reference Manual Table of Contents Retrieving errors ........................8-2 USB troubleshooting ......................8-2 Check driver for the USB Test and Measurement Device ............8-2 Troubleshooting GPIB interfaces ..................8-5 Controller (hardware) not recognized ..................8-5 Timeout errors ...........................
Page 15
Table of Contents Models 707B and 708B Switching Matrix Reference Manual Status function summary ......................C-13 Clearing registers ........................C-13 Startup state ..........................C-14 Programming and reading registers ..................C-14 Status byte and service request (SRQ) ................... C-16 TSP-Link system status ......................C-21 Index ...........................
Section 1 Introduction In this section: Contact information ..............1-1 Overview .................. 1-1 Extended warranty ..............1-1 Contact information If you have any questions after you review the information in this documentation, please contact your local Keithley Instruments office, sales partner, or distributor, or call Keithley Instruments corporate headquarters (toll-free inside the U.S.
Section 2 General operation In this section: Rear panel overview ..............2-1 Wiring ..................2-2 Power-up ................2-10 Front-panel operation ............. 2-11 Remote communications interfaces ........2-22 Using the web interface ............2-66 Switch operation ..............2-80 Rear panel overview You make power and communications connections to the rear panel of the instrument.
Section 2: General operation Models 707B and 708B Switching Matrix Reference Manual Model 707B Rear panel Figure 1: Model 707B rear panel Model 708B Rear panel Figure 2: Model 708B full rear panel Wiring This section describes communication, digital I/O, and power connections. Note that all signal wiring to devices and instruments is done through the switch cards.
Models 707B and 708B Switching Matrix Reference Manual Section 2: General operation Communication connections The following topics describe how to connect the cable connections for the communication interfaces. To properly set up the communications interfaces after connection, see the information in Remote communications interfaces (on page 4-4).
Page 21
Section 2: General operation Models 707B and 708B Switching Matrix Reference Manual Connect the LAN cable Connect the LAN connector between the rear panel of the instrument and the host computer or network router. You can use an LAN crossover cable (RJ-45, male/male) or straight-through cable. The instrument automatically senses which cable you have connected.
Page 22
Models 707B and 708B Switching Matrix Reference Manual Section 2: General operation Figure 6: GPIB connector To allow many parallel connections to one instrument, stack the connectors. Each connector has two screws to ensure that connections remain secure. The figure below shows a typical connection diagram for a test system with multiple instruments.
Page 23
Section 2: General operation Models 707B and 708B Switching Matrix Reference Manual Figure 8: Model 707B rear panel IEEE-488 connection Connect any additional connectors from other instruments as required for your application. Make sure the other end of the cable is properly connected to the controller. You can only have 15 devices connected to an IEEE-488 bus, including the controller.
Models 707B and 708B Switching Matrix Reference Manual Section 2: General operation Figure 9: Model 708B rear panel TSP-Link connection Figure 10: Model 707B rear panel TSP-Link connection Digital I/O port The Models 707B and 708B have a digital input/output port that can be used to control external digital circuitry.
Page 25
Section 2: General operation Models 707B and 708B Switching Matrix Reference Manual Figure 11: Models 707B and 708B digital I/O ports Description Digital I/O #1 Digital I/O #14 15-21 Ground +5V D (fused, 600 mA) Not connected; pin reserved for future use Not connected;...
Page 26
Models 707B and 708B Switching Matrix Reference Manual Section 2: General operation Controlling digital I/O lines Although the digital I/O lines are primarily intended for use with a device handler for limit testing, they can also be used for other purposes such as controlling external logic circuits. You can control lines either from the front panel or over a remote interface.
Section 2: General operation Models 707B and 708B Switching Matrix Reference Manual Power-up Line power connection Follow the procedure below to connect the Model 707B or 708B to line power and turn on the instrument. The Model 707B or 708B operates from a line voltage of 100 V to 240 V at a frequency of 50 Hz or 60 Hz.
Models 707B and 708B Switching Matrix Reference Manual Section 2: General operation Front-panel operation The front panel of the Keithley Instruments Model 707B or 708B contains the following items: • The display • The crosspoint display (Model 707B only) • The keys and navigation wheel •...
Section 2: General operation Models 707B and 708B Switching Matrix Reference Manual Figure 13: Model 708B front panel Display This section describes the front-panel display of the Model 708B and the bottom display of the Model 707B. During operation, the display provides information about the selected channel, channel pattern, channel state, and errors.
Page 30
Models 707B and 708B Switching Matrix Reference Manual Section 2: General operation If you are connecting to the instrument through GPIB, you may also see the following indicators: • TALK: Instrument is addressed to talk • LSTN: Instrument is addressed to listen •...
Section 2: General operation Models 707B and 708B Switching Matrix Reference Manual Crosspoint display (Model 707B only) The crosspoint display on the front panel of the Model 707B displays information about the slots that contain cards and the open and closed state of the channels for one card slot at a time. If there are no cards in the instrument's slots, the crosspoint display shows "No card in unit."...
Models 707B and 708B Switching Matrix Reference Manual Section 2: General operation Crosspoint display description The crosspoint display displays all channels for one card slot at a time. If there are no cards in the instrument's slots, the crosspoint display shows "No card in unit." The rows are labeled by default with the slot number following by the row number.
Section 2: General operation Models 707B and 708B Switching Matrix Reference Manual To choose a specific column in the selected row: 1. After choosing the row, press the navigation wheel . A column of red lights is displayed. 2. Turn the navigation wheel to go to the column.
Page 34
Models 707B and 708B Switching Matrix Reference Manual Section 2: General operation Keys The top row of keys under the display allows you to open and close channels, work with scan lists, and load and run scripts. Figure 19: Models 707B and 708B top row of keys Key descriptions Description OPEN ALL...
Page 35
Section 2: General operation Models 707B and 708B Switching Matrix Reference Manual Key descriptions Description CHAN If a channel is displayed, opens the CHANNEL ACTION menu options (on page 2-20), which allows you to open and close channels. If a pattern is displayed, pressing CHAN switches to channel view.
Models 707B and 708B Switching Matrix Reference Manual Section 2: General operation Set beeper and key clicks You can turn the instrument beeper and key click sounds on or off. Disabling the beeper also disables the keyclicks. To enable keyclicks, you must also enable the beeper.
Page 37
Section 2: General operation Models 707B and 708B Switching Matrix Reference Manual The options are: • LABEL: Sets the label that is displayed on the front panel for the specified channel. • LABEL-ROW: Sets the label that is displayed on the front panel for the specified row. •...
Page 38
Models 707B and 708B Switching Matrix Reference Manual Section 2: General operation PATTERN ACTION menu options Allows you to configure and change patterns from the front panel. To open this menu, in pattern view, press PATT. Options include: • CREATE: If no patterns have been created, this is the only option that is displayed. Allows you to create a new pattern.
Section 2: General operation Models 707B and 708B Switching Matrix Reference Manual Main menu options The options in the main menu allow you to create a configuration script, set up communications, verify and set some instrument operation, set up digital input/output, and get instrument information. To open the main menu, press MENU.
Models 707B and 708B Switching Matrix Reference Manual Section 2: General operation USB communications To use the rear-panel USB port, you must have the Virtual Instrument Software Architecture (VISA) layer on the host computer. See How to install the Keithley I/O Layer (on page 2-59) for more information.
Page 41
Section 2: General operation Models 707B and 708B Switching Matrix Reference Manual To use the Keithley Configuration Panel to determine the VISA resource string: 1. Start the Keithley Configuration Panel. The Select Operation dialog box is displayed. 2. Select Add. Figure 21: Select Operation dialog box 3.
Page 42
Models 707B and 708B Switching Matrix Reference Manual Section 2: General operation Figure 22: Select Communication Bus dialog box 4. Select USB. 5. Click Next. The Select Instrument Driver dialog box is displayed. 707B-901-01 Rev. B / January 2015 2-25...
Page 43
Section 2: General operation Models 707B and 708B Switching Matrix Reference Manual Figure 23: Select Instrument Driver dialog box 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.
Page 44
Models 707B and 708B Switching Matrix Reference Manual Section 2: General operation 8. Click Next. The Name Virtual Instrument dialog box is displayed. Figure 25: Name Virtual Instrument dialog box 9. In the Virtual Instrument Name box, enter a name that you want to use to refer to the instrument. 10.
Page 45
Section 2: General operation Models 707B and 708B Switching Matrix Reference Manual Figure 26: Keithley Communicator Open an Instrument 2-28 707B-901-01 Rev. B / January 2015...
Page 46
Models 707B and 708B Switching Matrix Reference Manual Section 2: General operation 14. Click OK. 15. Send a command to the instrument and see if it responds. Figure 27: Send a command to the instrument If you have a full version of NI VISA on your system, you can run NI-MAX or the VISA Interactive Utility.
Section 2: General operation Models 707B and 708B Switching Matrix Reference Manual Connecting multiple USB instruments to the computer The most convenient way to connect USB instrumentation to the computer is to plug a USB cable directly from the instrument to the computer. If you have more than one USB instrument or have other USB devices, such as printers, keyboards, and mice, you might not have enough USB connectors on the computer.
Page 48
Models 707B and 708B Switching Matrix Reference Manual Section 2: General operation GPIB quick start 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 49
Section 2: General operation Models 707B and 708B Switching Matrix Reference Manual 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 IEEE-488 cables. Contact Keithley Instruments for shielded cables. To connect the instrument to the IEEE-488 bus, line up the cable connector with the connector on the rear panel.
Page 50
Models 707B and 708B Switching Matrix Reference Manual Section 2: General operation Figure 32: Model 708B rear panel IEEE-488 connection Set the GPIB address The GPIB address is set to 16 at the factory. The address can be set to any address value from 0 to 30.
Page 51
Section 2: General operation Models 707B and 708B Switching Matrix Reference Manual For the KUSB-488A GPIB controller from Keithley Instruments, the configuration utility is called TrTest. It is available from the Windows Start Menu at Keithley Instruments > GPIB-488-CEC > TrTest.
Models 707B and 708B Switching Matrix Reference Manual Section 2: General operation LAN communications You can communicate with the instrument using a local area network (LAN). When you connect using a LAN, you can use a web browser to communicate with the instrument through the instrument's internal web page and other web applets.
Page 53
Section 2: General operation Models 707B and 708B Switching Matrix Reference Manual DHCP Enabled IP Address Subnet Mask Default Gateway DNS Servers Set up automatic IP address selection If you are connecting to a LAN that has a DHCP server or if you have a direct connection between the instrument and a host computer, you can use automatic IP address selection.
Page 54
Models 707B and 708B Switching Matrix Reference Manual Section 2: General operation Figure 33: Model 707B rear panel LAN connection Wait for the LAN status indicator on the front panel to turn solid green A solid green LAN status indicator confirms that the instrument was assigned an IP address. Note that it may take several minutes for the computer and instrument to establish a connection.
Page 55
Section 2: General operation Models 707B and 708B Switching Matrix Reference Manual Install LXI Discovery Browser software on your computer You can use the LXI Discovery Browser to identify the IP addresses of LXI-certified instruments. Once identified, you can double-click the IP address in the LXI Discovery Browser to open the web interface for the instrument.
Page 56
Models 707B and 708B Switching Matrix Reference Manual Section 2: General operation • A reserved URL in the instrument that provides an xml document that has standard configuration information. This can be useful for software tools that need to identify the instruments and their capabilities.
Page 57
Section 2: General operation Models 707B and 708B Switching Matrix Reference Manual VXI-11 VXI-11 is a LAN protocol that emulates GPIB over Ethernet. It uses remote procedure calls to call functions in the instrument for creating a link, sending data, reading data, and so on. There is also a small header that indicates how much data is being sent.
Page 58
Models 707B and 708B Switching Matrix Reference Manual Section 2: General operation The Models 707B and 708B supports Auto-MDIX and can use either normal LAN CAT-5 cables (patch) or crossover cables. The instrument automatically adjusts to support either cable. One-to-many connection With a LAN hub, a single network interface card can be connected to as many instruments as the hub can support.
Page 59
Section 2: General operation Models 707B and 708B Switching Matrix Reference Manual Instrumentation connection to enterprise routers or servers This connection uses an existing network infrastructure to connect instruments to the computer controller. In this case, you must get the network resources from the network administrator. Usually, the instruments are kept inside the corporate firewall, but the network administrator can assign resources that allow them to be outside the firewall.
Page 60
Models 707B and 708B Switching Matrix Reference Manual Section 2: General operation 3. In a Windows operating system, use the Windows Control Panel to assign the network interface card IP address. The exact steps differ somewhat for each version of Windows. See Windows network configuration settings (on page 2-47).
Page 61
Section 2: General operation Models 707B and 708B Switching Matrix Reference Manual TCP/IP network basics Regardless of the type of network connection used, there must be a way to identify each network device on a network. A software driver installed in the computer provides the means of controlling the instrument.
Page 62
Models 707B and 708B Switching Matrix Reference Manual Section 2: General operation IPv4 addressing Models 707B and 708B support IPv4 addressing There are three ways of assigning an IP address to a host: DCHP, DLLA, and static. DHCP The Dynamic Host Configuration Protocol (DHCP) protocol is a way for network devices to request Internet protocol (IP) parameters such as the IP address, gateway, subnet mask, and DNS server addresses.
Page 63
Section 2: General operation Models 707B and 708B Switching Matrix Reference Manual The network ID must be unique among all network subnets that connect to the Internet or corporate intranet. If the subnet will be connected to the public Internet, the network ID must be obtained from the Network Information Center, which assigns and preserves unique IDs.
Page 64
Models 707B and 708B Switching Matrix Reference Manual Section 2: General operation Dynamic DNS DNS is a rigid and inflexible system, because you must have a system administration add the DNS entry to the DNS server for it to work. Dynamic DNS tries to address this inflexibility. It addresses the needs of network devices that are powered up and down with IP addresses that can change several times a day.
Page 65
Section 2: General operation Models 707B and 708B Switching Matrix Reference Manual Figure 38: Internet Protocol (TCP/IP) Properties dialog box Windows 2000 Internet Protocol (TCP/IP) Properties dialog box You can review and change IP settings in the Internet Protocol Properties dialog box. To open this dialog box in Windows 2000: 1.
Page 66
Models 707B and 708B Switching Matrix Reference Manual Section 2: General operation 4. In the Items list, double-click Internet Protocol (TCP/IP). The Internet Protocol (TCP/IP) Properties dialog box is displayed. Figure 39: Internet Protocol (TCP/IP) Properties dialog box Windows Vista Internet Protocol Properties dialog box You can review and change IP settings in the Internet Protocol Properties dialog box.
Page 67
Section 2: General operation Models 707B and 708B Switching Matrix Reference Manual Figure 40: Internet Protocol (TCP/IP) Properties dialog box Windows 7 Internet Protocol Version 6 (TCP/IPv6) Properties dialog box You can review and change IP settings in the Internet Protocol Version 4 (TCP/IPv4) dialog box. To open this dialog box in Windows 7: 1.
Page 68
Models 707B and 708B Switching Matrix Reference Manual Section 2: General operation Figure 41: Windows 7 Internet Protocol Version 6 dialog box Configure LAN settings through the front panel All instruments need to be configured before they can be used on a network. The main parameters that need to be configured for IPv4 are: •...
Page 69
Section 2: General operation Models 707B and 708B Switching Matrix Reference Manual Telnet connection The Telnet protocol is similar to raw socket, and can be used when you need to interact directly with the instrument. Telnet is often used for debugging and troubleshooting. You will need a separate Telnet program to use this protocol.
Page 70
Models 707B and 708B Switching Matrix Reference Manual Section 2: General operation 2. Use the navigation wheel to select the following network settings: IP_ADDRESS: The IP address that the instrument is using to communicate over the LAN. GATEWAY: The gateway address that the instrument is using to communicate over the LAN. ...
Page 71
Section 2: General operation Models 707B and 708B Switching Matrix Reference Manual To set up the LAN on the instrument: 1. From the front panel, press the MENU key. 2. Use the navigation wheel to select LAN > CONFIG > METHOD. Press the navigation wheel display the METHOD menu.
Page 72
Models 707B and 708B Switching Matrix Reference Manual Section 2: General operation Change the IP configuration through the web interface The LAN settings, such as IP address, subnet mask, gateway, and DNS address, can be changed through the web page of the instrument. If you change the IP address through the web page, the web page will try to redirect to the IP address that gets configured in the instrument.
Ethernet, USB, RS-232, GPIB, and so on. VPP-4.3 is a software API standard — several instrument vendors have implementations of VPP-4.3, including National Instruments, Agilent Technologies, and Tektronix. There are three types of programming interfaces to VISA: VISA-C, VISA-COM and VISA .NET.
Models 707B and 708B Switching Matrix Reference Manual Section 2: General operation IVI shared components The IVI shared components are a similar concept to the VISA shared components. The IVI Foundation provides class drivers for: • All the supported instruments (DMM, Scope, Fgen, and so on) •...
Page 75
Section 2: General operation Models 707B and 708B Switching Matrix Reference Manual If you already have NI software (such as LabVIEW or LabWindows) installed, you have a valid license that can be used with Keithley drivers and application software. If you do not have NI software installed, to use Keithley drivers or application software, you must install the KIOL.
Page 76
Models 707B and 708B Switching Matrix Reference Manual Section 2: General operation How to install the Keithley I/O Layer Before installing, it is a good idea to check the Keithley Instruments website (http://www.keithley.com) to see if a later version of the Keithley I/O Layer is available. On the website, select the Support tab, under model number, type KIOL, and select Software Driver.
Page 77
VISA version, which you should do. This will usually restore the operation of any dependent applications or drivers. 8. If the pre-existing version of VISA was supplied by a vendor other than Tektronix or Agilent, we recommend that you do not reinstall it, because this will likely cause the Keithley I/O Layer software to malfunction.
Models 707B and 708B Switching Matrix Reference Manual Section 2: General operation Installation troubleshooting If problems occur during installation, it might be helpful to install the components individually. Errors messages might appear that will help you resolve the installation issue. If problems occur during installation: 1.
Page 79
Section 2: General operation Models 707B and 708B Switching Matrix Reference Manual Addressing instruments through the LAN VISA supports two different LAN protocols, each of which has a different resource string. VXI-11 is a protocol that emulates GPIB over the LAN. Models 707B and 708B supports this protocol. The resource string is: TCPIP[board]::host address[::LAN device name][::INSTR] board is the network interface card in the computer.
Page 80
Models 707B and 708B Switching Matrix Reference Manual Section 2: General operation 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 81
Section 2: General operation Models 707B and 708B Switching Matrix Reference Manual VISA-C sample code The following is a simple C/C++ console application that reads back the instrument identification string using VISA-C. You need to include visa.h and link with the visa32.lib file. #include "stdafx.h"...
Page 82
Models 707B and 708B Switching Matrix Reference Manual Section 2: General operation 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.
Section 2: General operation Models 707B and 708B Switching Matrix Reference Manual Using the web interface Introduction The Model 707B or 708B web interface can be used with your choice of web browsers, including ® ® ® ® ® ® Microsoft Internet Explorer , Mozilla...
Page 84
Models 707B and 708B Switching Matrix Reference Manual Section 2: General operation Identify the instrument If you have a bank of instruments, you can click the ID button to determine which one you are communicating with. To identify the instrument: In the middle of the left side of the Home page, click the ID button.
Section 2: General operation Models 707B and 708B Switching Matrix Reference Manual Card pages The card pages are interactive pages where you can work with channels in each slot. To open a card page, on the left navigation, click the slot number. There is a specific page for each card installed in the mainframe.
Page 86
Models 707B and 708B Switching Matrix Reference Manual Section 2: General operation 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 87
Section 2: General operation Models 707B and 708B Switching Matrix Reference Manual • Delay Time: The additional delay to incur after the relay settles when closing the channel. Enter the value for the delay in seconds. The total delay for channel close is this delay plus the relay settling time.
Models 707B and 708B Switching Matrix Reference Manual Section 2: General operation To create a channel pattern from the web interface using the Snapshot feature: 1. Close the channels that you want to include in the pattern. 2. Click Pattern (above the Channel Action Type box). The Channel Pattern Configuration dialog box is displayed.
Page 89
Section 2: General operation Models 707B and 708B Switching Matrix Reference Manual Create a scan list Before you can run a scan, you must create a scan list. A scan list is a set of steps that runs in order during a scan.
Page 90
Models 707B and 708B Switching Matrix Reference Manual Section 2: General operation The settings that are affected are: • Channels and patterns are removed from the scan list • Bypass: Returned to default setting of ON • Mode: Returned to default setting of Open All •...
Page 91
Section 2: General operation Models 707B and 708B Switching Matrix Reference Manual Trigger to start scan You can choose the triggers that will be used to start the scan. The options to start the scan are: Immediate: When Immediate is selected, the scan starts as soon as you click Execute Background on the Build &...
Models 707B and 708B Switching Matrix Reference Manual Section 2: General operation The options on the Advanced Trigger tab include: • Mode: Select Open All to open all slots before the scan starts. Select Open Selective to open only channels that are involved in scanning; closed channels that are not involved in scanning remain closed.
Page 93
Section 2: General operation Models 707B and 708B Switching Matrix Reference Manual To import scripts from the computer, click Import from PC. Select the directory that contains the file. You can only import files with the extension tsp. To clear the name box and the box that contains the script, click Clear. To view the contents of a script, type the name of a script in the TSP Script box and click View Script.
Models 707B and 708B Switching Matrix Reference Manual Section 2: General operation 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.
Section 2: General operation Models 707B and 708B Switching Matrix Reference Manual Generate Report: This generates an instrument report you can use to: • Review card or instrument information, including a basic description, the firmware revision, and the serial number. •...
Page 96
Models 707B and 708B Switching Matrix Reference Manual Section 2: General operation 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.
Section 2: General operation Models 707B and 708B Switching Matrix Reference Manual Switch operation Working with channels Overview This section gives an overview of working with channels, including a discussion of channel types, selecting channels, opening and closing channels, setting common channel attributes, and setting up channel patterns.
Page 98
Models 707B and 708B Switching Matrix Reference Manual Section 2: General operation Matrix card channel specifiers The channels on the matrix cards are referred to by their slot, bank, row, and column numbers: • Slot number: The number of the slot in which the card is installed. •...
Page 99
Section 2: General operation Models 707B and 708B Switching Matrix Reference Manual Queries that return a list of channels For queries that return a channel list parameter, the Model 707B or 708B separates the channels by a comma or semicolon, depending on the command. When multiple channels are used in the query, the information for the lowest numbered channel is listed first, increasing to the highest numbered channel.
Page 100
Models 707B and 708B Switching Matrix Reference Manual Section 2: General operation 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 101
Section 2: General operation Models 707B and 708B Switching Matrix Reference Manual 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 102
Models 707B and 708B Switching Matrix Reference Manual Section 2: General operation Determining the number of relay closures The Models 707B and 708B 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.
Page 103
Section 2: General operation Models 707B and 708B Switching Matrix 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 104
Models 707B and 708B Switching Matrix Reference Manual Section 2: General operation You can perform operations on a single channel from the front panel. To select a channel: 1. If the instrument is being controlled remotely, press EXIT to allow control from the front panel. 2.
Page 105
Section 2: General operation Models 707B and 708B Switching Matrix Reference Manual Figure 54: 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 55: Selecting, closing, and opening a channel from the web interface Figure 56: Selecting, closing, and opening a channel from the web interface 2-88...
Page 106
Models 707B and 708B Switching Matrix Reference Manual Section 2: General operation Figure 57: 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. Figure 58: Select exclusive slot close Click a channel to close that channel and open all other channels.
Page 107
Section 2: General operation Models 707B and 708B Switching Matrix Reference Manual Viewing status from the front panel Closed channels are shown on the display of the instrument, separated by commas. If more than one line of closed channels are displayed, you can press DISPLAY to display the full list. Use the navigation wheel to scroll through the list.
Page 108
Models 707B and 708B Switching Matrix Reference Manual Section 2: General operation To set additional delay time through the remote interface: Use the command: channel.setdelay() (on page 7-41) Forbid closing a channel You can prevent a channel from being closed from any interface by setting it to forbidden. If the channel that is to be forbidden is used in a channel pattern, the pattern is deleted when you set the channel to be forbidden to close.
Page 109
Section 2: General operation Models 707B and 708B Switching Matrix Reference Manual 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 110
Models 707B and 708B Switching Matrix Reference Manual Section 2: General operation Channel patterns inherit the delay times of the individual channels that comprise the pattern. For information on the sequence of close operations on multiple channels, refer to Connection methods for close operations (on page 2-82).
Page 111
Section 2: General operation Models 707B and 708B Switching Matrix Reference Manual To create a channel pattern from the web interface: 1. From the left navigation, click a slot. 2. Click Pattern (above the Channel Action Type box). The Channel Pattern Configuration dialog box is displayed.
Page 112
Models 707B and 708B Switching Matrix Reference Manual Section 2: General operation To create a channel pattern from the remote command interface: You can also work with channel patterns using the following commands: channel.pattern.catalog() (on page 7-35) channel.pattern.delete() (on page 7-36) channel.pattern.getimage() (on page 7-36) channel.pattern.setimage()
Page 113
Section 2: General operation Models 707B and 708B Switching Matrix Reference Manual Figure 60: Channel Pattern Configuration dialog box 3. Select the pattern. 4. In the Actions box, to: • Open the channels in the channel pattern: Click OPEN. • Close the channels in the channel pattern without affecting any other channels: Select Channel Close, then click CLOSE.
Models 707B and 708B Switching Matrix Reference Manual Section 2: General operation Channel pattern storage Channel patterns are: • Part of the script that is created with Create Config Script. • Deleted when the instrument is reset. • Deleted when a channel associated with the pattern is reset. •...
Section 2: General operation Models 707B and 708B Switching Matrix Reference Manual Pseudocards You can perform open, close, and scan operations and configure your system without having an actual switching card installed in your instrument. Using the remote interface, you can assign a pseudocard to an empty switching card slot, allowing the instrument to operate as if a switching card were installed.
Page 116
Models 707B and 708B Switching Matrix Reference Manual Section 2: General operation --Auto created configuration script Indicates that this was created with the Create Configuration Script feature --Tue Jul 13 13:02:12 2010 Date and time stamp if string.find(slot[1].idn, "7174") == nil then Code that verifies that card and slot are in agreement print(...
Page 117
Section 2: General operation Models 707B and 708B Switching Matrix Reference Manual 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.
Section 3 Functions and features In this section: Scanning and triggering ............3-1 Trigger model ................3-1 Scan and step counts ............... 3-4 Basic scan procedure ............... 3-5 Remote interface scanning............3-8 Hardware trigger modes ............3-13 Understanding synchronous triggering modes ....... 3-17 Events ..................
Page 119
Section 3: Functions and features Models 707B and 708B Switching Matrix Reference Manual You cannot use an external trigger event (for example, digital I/O) for the channel stimulus setting of the trigger model when using the front-panel STEP key. Figure 62: Models 707B and 708B triggering overview 707B-901-01 Rev.
Models 707B and 708B Switching Matrix Reference Manual Section 3: Functions and features Trigger model components The individual components of the trigger model are explained in the following paragraphs. Start scan When a scan is initiated, the instrument leaves the idle state and prepares to start scanning. To prepare for scanning, it verifies that channel settings match the scan settings (such as opening all channels or opening only channels on specific slot).
Section 3: Functions and features Models 707B and 708B Switching Matrix Reference Manual For example, the channel ready event (scan.trigger.EVENT_CHANNEL_READY) may be set to pulse digital I/O line 3 when it gets generated. The command message for this would be: digio.trigger[3].stimulus = scan.trigger.EVENT_CHANNEL_READY Likewise, you can use the digital I/O line 5 trigger event to satisfy the scan trigger channel stimulus, which causes the channel action to occur when a trigger is detected on line 5.
Models 707B and 708B Switching Matrix Reference Manual Section 3: Functions and features Basic scan procedure It is always better to configure all channel attributes before creating a scan. You cannot use an external trigger event, like digital I/O, for the channel stimulus setting of the trigger model when using the front panel STEP key.
Section 3: Functions and features Models 707B and 708B Switching Matrix Reference Manual Changing attributes of an existing scan When a scan already exists, changing channel attributes also causes the scan to change. Once a scan list has been defined, the Model 707B or 708B tries to incorporate your changes into the scan. If the change impacts the ability of the scan to function properly (such as deleting something referenced by the scan), an error message is logged and the scan list may be cleared.
Models 707B and 708B Switching Matrix Reference Manual Section 3: Functions and features The menu contains the following items: • BACKGROUND: Runs scan list in the background • CREATE: Displays Use INS key • LIST: Displays the current scan list steps. Turn the navigation wheel to scroll through the list. •...
Section 3: Functions and features Models 707B and 708B Switching Matrix Reference Manual Remote interface scanning Scan and trigger commands The following list contains commands associated with triggers and bus operation scanning: • trigger.blender[N].clear() (on page 7-201) • trigger.blender[N].orenable (on page 7-202) •...
Models 707B and 708B Switching Matrix Reference Manual Section 3: Functions and features Scanning examples Assume you have a 7072 card installed in slot 1 of your instrument and you want to scan column 5 on rows 1 to 3. To create this scan, send the following command: scan.create("1A05, 1B05, 1C05") To see the scan list generated from this command, send: print(scan.list())
Page 127
Section 3: Functions and features Models 707B and 708B Switching Matrix Reference Manual The following represents a script you can enter using the TSB Embedded page on the web to experiment with the scan points discussed above. 3-10 707B-901-01 Rev. B / January 2015...
Page 128
Models 707B and 708B Switching Matrix Reference Manual Section 3: Functions and features Reset the instrument reset() Create a three channel scan list scan.add("1A05, 1B05, 1C05") digio.trigger[3].mode = digio.TRIG_FALLING Detect falling edges on digio trigger line 3 scan.trigger.channel.stimulus = Configure digio trigger line 3 to pace the scan sequence digio.trigger[3].EVENT_ID Set the scan count to 3...
Page 129
Section 3: Functions and features Models 707B and 708B Switching Matrix Reference Manual Init) OPEN... 1) STEP: 1A05 CLOSE: 1A05 2) STEP: 1B05 OPEN: 1A05 CLOSE: 1B05 3) STEP: 1C05 OPEN: 1B05 CLOSE: 1C05 2.000000000e+000 1.000000000e+000 0.000000000e+000 Shows scan is running (state = 2) and no steps have completed for scan count of 1...
Models 707B and 708B Switching Matrix Reference Manual Section 3: Functions and features For more examples of using scanning and triggering, see the Models 707B and 708B User's Manual, section "Using a Series 2600 with your Model 707B or 708B." Hardware trigger modes Use the hardware trigger modes to integrate Keithley Instruments and non-Keithley instruments into an efficient test system.
Section 3: Functions and features Models 707B and 708B Switching Matrix Reference Manual Falling edge trigger mode The falling edge trigger mode generates low pulses and detects all falling edges. The following graphic illustrates the characteristics for the falling edge input trigger. Figure 63: Falling edge input trigger Input characteristics: •...
Models 707B and 708B Switching Matrix Reference Manual Section 3: Functions and features Rising edge master trigger mode Use the rising edge master trigger mode (RisingM) to synchronize with non-Keithley Instruments that require a high pulse. Input trigger detection is not available in this trigger mode. You can use the RisingM trigger mode to generate rising edge pulses.
Section 3: Functions and features Models 707B and 708B Switching Matrix Reference Manual Input characteristics: • All rising edges generate an input event. Figure 67: RisingA output trigger Output characteristics: • When the trigger is asserted, generates a low pulse that is similar to the falling edge trigger mode. Either edge trigger mode The either edge trigger mode generates a low pulse and detects both rising and falling edges.
Models 707B and 708B Switching Matrix Reference Manual Section 3: Functions and features Figure 69: Either edge output trigger Output characteristics: • When the trigger is asserted, it generates a low pulse that is similar to the falling edge trigger mode. Understanding synchronous triggering modes Use the synchronous triggering modes to implement bidirectional triggering, to wait for one node, or to wait for a collection of nodes to complete all triggered actions.
Page 135
Section 3: Functions and features Models 707B and 708B Switching Matrix Reference Manual Figure 70: SynchronousM input trigger 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. •...
Models 707B and 708B Switching Matrix Reference Manual Section 3: Functions and features Synchronous acceptor trigger mode 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. Figure 72: SynchronousA input trigger Input characteristics: •...
Page 137
Section 3: Functions and features Models 707B and 708B Switching Matrix Reference Manual Figure 74: Synchronous input trigger Input characteristics: • The falling edge generates an input event and latches the internal drive low. Figure 75: Synchronous output trigger Output characteristics: •...
Models 707B and 708B Switching Matrix Reference Manual Section 3: Functions and features 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).
Section 4 Theory of operation In this section: Theory of operation ..............4-1 Theory of operation Models 707B and 708B theory of operations overview The Models 707B and 708B are composed of several components assembled into an aluminum frame. The Model 707B supports the operation of up to six relay matrix cards; the Model 708B supports the operation of a single relay matrix card.
Page 141
Section 4: Theory of operation Models 707B and 708B Switching Matrix Reference Manual Figure 78: Model 708B mainframe block diagram Important test system safety information This product is sold as a stand-alone instrument that may become part of a system that could contain hazardous voltages and energy sources.
Page 142
Models 707B and 708B Switching Matrix Reference Manual Section 4: Theory of operation • Double insulate all electrical connections that an operator could touch. Double insulation ensures the operator is still protected even if one insulation layer fails. Refer to IEC 61010-1 for specific requirements.
Page 143
Section 4: Theory of operation Models 707B and 708B Switching Matrix Reference Manual Remote communications interfaces You can operate the Model 707B or 708B over one of several standard remote interfaces. The rear panel includes connectors for these communication interfaces: •...
Models 707B and 708B Switching Matrix Reference Manual Section 4: Theory of operation Figure 79: Model 707B backplane Front panel The front panel of the Keithley Instruments Model 707B or 708B contains the following items: • The display • The crosspoint display (Model 707B only) •...
Page 145
Section 4: Theory of operation Models 707B and 708B Switching Matrix Reference Manual Upper crosspoint display (Model 707B only) The larger upper display on the Model 707B mainframe provides a visual means of determining the relay status of each card slot in the instrument at any given time. It also shows the label names for each row and column of the given slot.
Page 146
Models 707B and 708B Switching Matrix Reference Manual Section 4: Theory of operation Row and column labels The row and column labels are updated by writing to the devices serially. They handle their own brightness and refresh controls, alleviating the main microcontroller from performing these tasks. As a result, these are only updated when the data changes and a command from the instrument is issued to update the label.
Page 147
Section 4: Theory of operation Models 707B and 708B Switching Matrix Reference Manual Display watchdog Once the display tasks are started, if the microcontroller stops refreshing, the watchdog circuit shuts off the column drivers to preserve the life of the LEDs. The display watchdog is part of the standard display test (see Testing the display, keys, and channel matrix...
Section 5 Introduction to TSP operation In this section: Introduction to TSP operation........... 5-1 About TSP commands ............. 5-3 Overview of instrument drivers ..........5-16 Migrating from Models 707A and 708A ........5-19 Introduction to TSP operation ® Instruments that are Test Script Processor (TSP ) enabled operate like conventional instruments by responding to a sequence of commands sent by the controller.
Page 149
Section 5: Introduction to TSP operation Models 707B and 708B Switching Matrix Reference Manual Example 1 beeper.beep(0.5, 2400) Emit a double-beep at 2400 Hz. The sequence is 0.5 s on, 0.25 s off, 0.5 s on. delay(0.250) beeper.beep(0.5, 2400) Example 2 You can use the results of a function-based command directly or assign variables to the results for later access.
Models 707B and 708B Switching Matrix Reference Manual Section 5: Introduction to TSP operation Queries ® Test Script Processor (TSP ) enabled instruments do not have inherent query commands. Like any other scripting environment, the print() and printnumber() commands generate output in the form of response messages.
Section 5: Introduction to TSP operation Models 707B and 708B Switching Matrix Reference Manual Bit manipulation and logic operations The bit functions perform bitwise logic operations on two given numbers, and bit operations on one given number. Logic and bit operations truncate the fractional part of given numbers to make them integers.
Page 152
Models 707B and 708B Switching Matrix Reference Manual Section 5: Introduction to TSP operation About channel commands Matrix card channel specifiers The channels on the matrix cards are referred to by their slot, bank, row, and column numbers: • Slot number: The number of the slot in which the card is installed. •...
Page 153
Section 5: Introduction to TSP operation Models 707B and 708B Switching Matrix Reference Manual 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.clearforbidden() (on page 7-16)
Models 707B and 708B Switching Matrix Reference Manual Section 5: Introduction to TSP operation 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.
Section 5: Introduction to TSP operation Models 707B and 708B Switching Matrix Reference Manual Digital I/O The digital I/O port of the instrument can control external circuitry (such as a component handler for binning operations). The I/O port has 14 lines. Each line can be at TTL logic state 1 (high) or 0 (low). See the pinout diagram in Digital I/O port (on page 2-7) for additional information.
Models 707B and 708B Switching Matrix Reference Manual Section 5: Introduction to TSP operation eventlog functions and attributes The functions and attributes in this group control the event log. eventlog.all() (on page 7-84) eventlog.clear() (on page 7-85) eventlog.count (on page 7-86) eventlog.enable (on page 7-86) eventlog.next()
Section 5: Introduction to TSP operation Models 707B and 708B Switching Matrix Reference Manual 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.
Models 707B and 708B Switching Matrix Reference Manual Section 5: Introduction to TSP operation Local node Commands that allow you to set and read from the local node. localnode.define.* (on page 7-118) localnode.description (on page 7-119) localnode.model (on page 7-121) localnode.password (on page 7-121) localnode.prompts...
Section 5: Introduction to TSP operation Models 707B and 708B Switching Matrix Reference Manual Scan The scan functions and attributes allow you to set up scanning over the remove interface. scan.abort() (on page 7-135) scan.add() (on page 7-136) scan.addimagestep() (on page 7-138) scan.background() (on page 7-139) scan.bypass...
Models 707B and 708B Switching Matrix Reference Manual Section 5: Introduction to TSP operation Slot The slot attributes configure and read the settings of the cards in the slots. You can also set up pseudocards. slot[X].idn (on page 7-168) slot[X].poles.four (on page 7-169) slot[X].poles.one (on page 7-170)
Section 5: Introduction to TSP operation Models 707B and 708B Switching Matrix Reference Manual trigger functions and attributes Use the trigger functions and attributes to control specific trigger objects. trigger.blender[N].clear() (on page 7-201) trigger.blender[N].EVENT_ID (on page 7-201) trigger.blender[N].orenable (on page 7-202) trigger.blender[N].overrun (on page 7-203) trigger.blender[N].reset()
Section 5: Introduction to TSP operation Models 707B and 708B Switching Matrix Reference Manual Overview of instrument drivers To use an instrument connected to a computer, you need to send instrument commands to it to make it do what you want. This can be tedious, as the programmer has to learn the low level syntax and also deal with how their programming language or development environment interfaces to the remote communication interface driver or VISA I/O library.
Models 707B and 708B Switching Matrix Reference Manual Section 5: Introduction to TSP operation VXIPnP drivers VXI (Vixie) plug-and-play (VXIPnP) style drivers are Win32 DLLs that have some standard functions defined by the VXIPnP Alliance, such as: • init • close •...
Section 5: Introduction to TSP operation Models 707B and 708B Switching Matrix Reference Manual LabVIEW drivers Native LabVIEW drivers A native LabVIEW driver is a LabVIEW driver that is created using entirely built-in LabVIEW VIs — it does not make any calls to external DLLs or Library files. This makes the driver portable to all the ®...
Models 707B and 708B Switching Matrix Reference Manual Section 5: Introduction to TSP operation Migrating from Models 707A and 708A Migrating Model 707A or 708A programs to Model 707B or 708B This section is intended to assist you if you are migrating existing programs from the Model 707A or 708A to use the TSP programming syntax on the Model 707B or 708B.
Section 5: Introduction to TSP operation Models 707B and 708B Switching Matrix Reference Manual Command structure The DDC structure of the Model 707A or 708A instrument is based on a single ASCII capital letter with possible alphanumeric arguments and terminated with the "X" execute command. The Model 707B or 708B instrument uses a modern dot notation format that logically organizes commands by family, subset 1, subset 2 –...
Page 168
Models 707B and 708B Switching Matrix Reference Manual Section 5: Introduction to TSP operation Relay setup commands The following table shows DDC commands that refer to Model 707A and 708A relay setups. The Model 707B or 708B equivalent of relay setups are called scans and patterns. Scans allow a predetermined set of channels to be closed in a sequential order based on a particular event or combination of events.
Page 169
Section 5: Introduction to TSP operation Models 707B and 708B Switching Matrix Reference Manual Trigger polarity The Model 707A or 708A instrument has one external trigger input that was available to accept TTL level trigger inputs to advance the stored relay setup step. The Model 707B or 708B instrument allows 14 TTL level inputs through the digital I/O connector to act as events to iterate through a scan list.
Page 170
Models 707B and 708B Switching Matrix Reference Manual Section 5: Introduction to TSP operation Example: Channel open with matrix-ready functionality function chanOpen(chan) Function accepts valid channels as arguments digio.writebit(10,0) Clear the 10th digital I/O bit before the open operation channel.open(chan) Open the channels in the argument digio.writebit(10,1) Set the 10th digital I/O bit after the open...
Page 171
Section 5: Introduction to TSP operation Models 707B and 708B Switching Matrix Reference Manual Service request configuration These commands control the behavior of the SRQ line. The Model 707B or 708B instrument can configure some of the events that cause the SRQ to assert, but none of those events address Matrix Ready or when the instrument is ready for trigger.
Page 172
Models 707B and 708B Switching Matrix Reference Manual Section 5: Introduction to TSP operation Retrieve card settling time Although base channel settle time cannot be returned, additional delay time that was specified with the channel.setdelay(channelList,delay) command can be returned using: channel.getdelay("allslots") Delays for each channel in csv format are returned.
Page 173
Section 5: Introduction to TSP operation Models 707B and 708B Switching Matrix Reference Manual Error status word This series of commands provides a descriptive list of error codes and error messages until no more errors are present. For more information, see Error queue (on page 5-8).
Page 174
Models 707B and 708B Switching Matrix Reference Manual Section 5: Introduction to TSP operation The following command returns the model of the card in the specified slot of the local instrument, along with a description of the card, the firmware version, and the serial number. To get information from cards in TSP-Link connected instruments, send: print(node[nodeNumber].slot[slotNumber].idn) Where: nodeNumber is the TSP-Link node of the remote system and slotNumber is the slot on the...
Section 6 Instrument programming In this section: Fundamentals of scripting for TSP ........... 6-1 Fundamentals of programming for TSP ......... 6-10 Using Test Script Builder (TSB) ..........6-31 Advanced scripting for TSP ............ 6-33 TSP-Link system and running simultaneous test scripts ..6-44 TSP-Net .................
Page 177
Section 6: Instrument programming Models 707B and 708B Switching Matrix 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 178
Models 707B and 708B Switching Matrix Reference Manual Section 6: Instrument programming Commands that cannot be used in scripts Though an instrument accepts the following commands, you cannot use these commands in scripts. Commands that cannot be used in scripts General commands IEEE Std 488.2 common commands abort...
Page 179
Section 6: Instrument programming Models 707B and 708B Switching Matrix 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 180
Models 707B and 708B Switching Matrix Reference Manual Section 6: 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 181
Section 6: Instrument programming Models 707B and 708B Switching Matrix Reference Manual Run a named script You can run any named script that is in the run-time environment using one of the following commands: • scriptVar() • scriptVar.run() Where: scriptVar is the user-defined name of the script. To run a named script from TSB Embedded, select the script from the User Scripts list and click Run.
Page 182
Models 707B and 708B Switching Matrix Reference Manual Section 6: Instrument programming Autoexec script 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. To create a script that executes automatically, create and load a new script and name it autoexec.
Page 183
Section 6: Instrument programming Models 707B and 708B Switching Matrix Reference Manual To save a script to nonvolatile memory: 1. Create and load a named script (see Create and load a script (on page 6-3)). 2. Do one of the following: •...
Page 184
Models 707B and 708B Switching Matrix Reference Manual Section 6: Instrument programming Where: name is the user-defined name of the script. To delete a script from nonvolatile memory using TSB Embedded: 1. In TSB Embedded, select the script from the User Scripts list. 2.
Section 6: Instrument programming Models 707B and 708B Switching Matrix Reference Manual -- Clear the display. display.clear() -- Prompt user for digital I/O line on which to output trigger. myDigioLine = display.menu("Select digio line", "1 2 3 4 5 6 7 8 9") -- Convert user input to a number.
Models 707B and 708B Switching Matrix Reference Manual Section 6: Instrument programming 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. Lua is also a scripting language, which means that scripts are compiled and run when they are sent to the instrument.
Page 187
Section 6: Instrument programming Models 707B and 708B Switching Matrix Reference Manual You also cannot use top-level command names as variable names. If you use these names, it will result in the loss of use of the commands. For example, if you send the command digio = 5, you cannot access the digio.* commands until you turn the instrument power off and then turn it on again.
Page 188
Models 707B and 708B Switching Matrix Reference Manual Section 6: Instrument programming Variable types Variables can be one of the following types. Variable types and values Variable type returned Value Notes "nil" not declared The type of the value nil, whose main property is to be different from any other value;...
Page 189
Section 6: Instrument programming Models 707B and 708B Switching Matrix 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 elements. print(atable, type(atable)) Note that the "table"...
Page 190
Models 707B and 708B Switching Matrix Reference Manual Section 6: 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 191
Section 6: Instrument programming Models 707B and 708B Switching Matrix 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. Steps to create a function using a script: 1.
Page 192
Models 707B and 708B Switching Matrix Reference Manual Section 6: Instrument programming Arithmetic operators Operator Description addition subtraction multiplication division negation (for example, c = −a) exponentiation Relational operators Operator Description < less than > greater than <= less than or equal >= greater than or equal not equal...
Page 193
Section 6: Instrument programming Models 707B and 708B Switching Matrix Reference Manual Example: Concatenation print(2 .. 3) print("Hello " .. "World") Hello World Operator precedence Operator precedence in Lua follows the order below (from higher to lower priority): • ^ (exponentiation) •...
Page 194
Models 707B and 708B Switching Matrix Reference Manual Section 6: Instrument programming The syntax of a conditional block is as follows: if expression then block elseif expression then block else block Where: • expression is Lua code that evaluates to either true or false •...
Page 195
Section 6: Instrument programming Models 707B and 708B Switching Matrix 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 196
Models 707B and 708B Switching Matrix Reference Manual Section 6: 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:...
Page 197
Section 6: Instrument programming Models 707B and 708B Switching Matrix Reference Manual Example: Numeric for list = {"One", "Two", "Three", "Four", "Five", "Six"} ---------- For loop ----------- print("Counting from one to three:") for element = 1, 3 do print(element, list[element]) print("Counting from one to four, in steps of two:") for element = 1, 4, 2 do print(element, list[element])
Page 198
Models 707B and 708B Switching Matrix Reference Manual Section 6: 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 199
Section 6: Instrument programming Models 707B and 708B Switching Matrix Reference Manual Example: Break with infinite loop a, b = 0, 1 This example uses a break statement while true do that causes the while loop to exit if the value of a becomes greater than 500.
Models 707B and 708B Switching Matrix Reference Manual Section 6: 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.
Page 201
Section 6: Instrument programming Models 707B and 708B Switching Matrix 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 202
Models 707B and 708B Switching Matrix Reference Manual Section 6: 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 203
Section 6: Instrument programming Models 707B and 708B Switching Matrix 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.
Models 707B and 708B Switching Matrix Reference Manual Section 6: Instrument programming Programming example: Script with a for loop The following script puts a message on the front panel display slowly — one character at a time. The intent of this example is to demonstrate: •...
Page 205
Section 6: Instrument programming Models 707B and 708B Switching Matrix Reference Manual Example: User script User script created in TSB Embedded User script created in user's own program loadscript display.clear() display.clear() myMessage = "Hello World!" myMessage = "Hello World!" for k = 1, string.len(myMessage) do for k = 1, string.len(myMessage) do x = string.sub(myMessage, k, k) x = string.sub(myMessage, k, k)
Models 707B and 708B Switching Matrix Reference Manual Section 6: Instrument programming 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: •...
Section 6: Instrument programming Models 707B and 708B Switching Matrix Reference Manual Figure 83: Example of the Test Script Builder workspace Item Description Project navigator Script editor; right-click to run the script that is displayed Outline view Programming interaction Help; includes detailed information on using Test Script Builder Installing the TSB software The installation files for the Test Script Builder software are available for download on the Keithley...
Models 707B and 708B Switching Matrix Reference Manual Section 6: 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 (+) next to the project folder.
Page 209
Section 6: Instrument programming Models 707B and 708B Switching Matrix Reference Manual Script names can be assigned by using the loadscript command or by defining the scriptVar parameter of the script.new() function. When a named script is loaded into the run-time environment: •...
Models 707B and 708B Switching Matrix Reference Manual Section 6: Instrument programming Figure 84: 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 211
Section 6: Instrument programming Models 707B and 708B Switching Matrix 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.
Models 707B and 708B Switching Matrix Reference Manual Section 6: 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 213
Section 6: Instrument programming Models 707B and 708B Switching Matrix Reference Manual To change the name of a script, use the command: scriptVar.name = "renamedScript" Where: scriptVar The global variable name "renamedScript" The new name of the user script that was referenced by the scriptVar global variable After changing the name, you need to save the original script to save the change to the name attribute.
Models 707B and 708B Switching Matrix Reference Manual Section 6: Instrument programming You can also use the script.new() and the scriptVar.source attribute commands to create a script with a new name. For example, if you had an existing script named test1, you could create a new script named test2 by sending the command: test2 = script.new(test1.source, "test2") script.new()
Page 215
Section 6: Instrument programming Models 707B and 708B Switching Matrix Reference Manual Retrieve a script as a single string To retrieve the entire user script source code as a single string, use the scriptVar.source attribute. The loadscript or loadandrunscript and endscript keywords are not included. To retrieve the source code as a single string, send the command: print(scriptVar.source) Where scriptVar is the name of the script.
Models 707B and 708B Switching Matrix Reference Manual Section 6: Instrument programming Example: Retrieve the content of a script with scriptVar.list() test.list() Request a listing of the source of test. An example of the possible instrument output is shown here (note that the loadscript and endscript commands are included).
Section 6: Instrument programming Models 707B and 708B Switching Matrix 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 218
Models 707B and 708B Switching Matrix Reference Manual Section 6: Instrument programming • Delete unneeded global variables from the run-time environment by setting them to nil. • Set the source attribute of all scripts to nil. • Adjust the collectgarbage() settings in Lua. See Lua memory management (on page 6-26) for information.
Section 6: Instrument programming Models 707B and 708B Switching Matrix Reference Manual TSP-Link system and running simultaneous test scripts TSP-Link system ® You can use the TSP-Link expansion interface to expand your test system to include up to 32 ® ®...
Page 220
Models 707B and 708B Switching Matrix Reference Manual Section 6: Instrument programming For an example of setting up a TSP-Linked system, see "Working with a Series 2600A" in the Models 707B and 708B User's Manual. Figure 89: Model 708B rear panel TSP-Link connection Figure 90: Model 707B rear panel TSP-Link connection 707B-901-01 Rev.
Section 6: Instrument programming Models 707B and 708B Switching Matrix Reference Manual Initialization ® Before a TSP-Link system can be used, it must be initialized. For initialization to succeed, each instrument in a TSP-Link system must be assigned a different node number. Assigning node numbers At the factory, each Models 707B and 708B instrument is assigned as node 1.
Page 222
Models 707B and 708B Switching Matrix Reference Manual Section 6: Instrument programming If you change the system configuration after initialization, you must reinitialize the system by performing a TSP-Link network reset. Changes that require that you reinitialize the TSP-Link network include turning off power or rebooting any instrument in the system, or rearranging or disconnecting the TSP-Link cable connections between instruments.
Section 6: Instrument programming Models 707B and 708B Switching Matrix Reference Manual Using TSP to run test scripts simultaneously You can use TSP to run test scripts simultaneously on multiple nodes on the TSP-Link network. Running test scripts simultaneously improves functional testing, provides higher throughput, and expands system flexibility.
Page 224
Models 707B and 708B Switching Matrix Reference Manual Section 6: 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 225
Section 6: Instrument programming Models 707B and 708B Switching Matrix 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 226
Models 707B and 708B Switching Matrix Reference Manual Section 6: Instrument programming A group leader can issue the waitcomplete() command to wait for the local group to complete all overlapped operations. The following code is an example of how to use the waitcomplete() command from a group leader: -- Wait for all nodes in the local group to complete all overlapped operations.
Section 6: Instrument programming Models 707B and 708B Switching Matrix Reference Manual Removing stale values from the reading buffer cache The node that acquires the data also stores the data for the reading buffer. To optimize data access, all nodes can cache data from the node that stores the reading buffer data. When you run Lua code remotely, it can cause reading buffer data that is held in the cache to become stale.
Models 707B and 708B Switching Matrix Reference Manual Section 6: Instrument programming Using TSP-Net with any Ethernet-enabled device Refer to TSP commands for more details about the commands presented in this section. To communicate to a remote ethernet-enabled device from the Model 707B or 708B, perform the following steps: 1.
Section 6: Instrument programming Models 707B and 708B Switching Matrix Reference Manual -- Print the device ID from connect string. print("ID is: ", id_instr) -- Set termination character to CRLF. You must do this -- on a per connection basis after connection has been made. tspnet.termination(id_instr, tspnet.TERM_CRLF) -- Send the command string to the connected device tspnet.write(id_instr, "*idn?"...
Models 707B and 708B Switching Matrix Reference Manual Section 6: Instrument programming 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-->...
Section 7 TSP command reference In this section: Command programming notes ..........7-1 Using the TSP command reference ......... 7-4 Instrument Control Library (ICL) command reference ....7-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.
Section 7: TSP command reference Models 707B and 708B Switching Matrix Reference Manual Syntax rules The following table lists syntax requirements to build well-formed instrument control commands. Syntax rules for instrument commands Syntax rule Details Examples Case sensitivity: Function and attribute An example of the scriptVar.save() function (where Instrument names should be in...
Models 707B and 708B Switching Matrix Reference Manual Section 7: TSP command reference Logical instruments You would normally refer to all instrumentation in one enclosure or node as a single instrument. In the ® context of Test Script Processor (TSP ) scripting engine and instrument commands, it is useful to think of each individual subdivision in an enclosure, such as a card slot or the channels, as a stand-alone instrument.
Section 7: TSP command reference Models 707B and 708B Switching Matrix Reference Manual Using the TSP command reference The TSP command reference contains detailed descriptions of each of the TSP commands that you can use to control your instrument. Each command description is broken into subsections. The figure below shows an example of a command description.
Models 707B and 708B Switching Matrix Reference Manual Section 7: TSP command reference 3. TSP-Link accessible. Yes or No; indicates whether or not the command can accessed through a TSP-Link network. 4. Affected by. Commands or actions that have a direct effect on the instrument command. ...
Section 7: TSP command reference Models 707B and 708B Switching Matrix Reference Manual Structure of command usage: Shows how the parts of the command should be organized. If a parameter is shown to the left of the command, it is the return when you print the command. Information to the right are the parameters or other items you need to enter when setting the command.
Models 707B and 708B Switching Matrix Reference Manual Section 7: TSP command reference Related commands and information The Also See section of the remote command description lists additional commands or sections that are related to the command. Figure 95: TSP Also See description 707B-901-01 Rev.
Section 7: TSP command reference Models 707B and 708B Switching Matrix Reference Manual Instrument Control Library (ICL) command reference beeper.beep() This function generates an audible tone. Type TSP-Link accessible Affected by Where saved Default value Function Usage beeper.beep(duration, frequency) The amount of time to play the tone (0.001 to 100 s) duration The frequency of the tone in Hertz (Hz) frequency...
Models 707B and 708B Switching Matrix Reference Manual Section 7: TSP command reference Example beeper.enable = beeper.ON Enables the beeper and generates a two-second, 2400 Hz tone. beeper.beep(2, 2400) Also see beeper.beep() (on page 7-8) bit.bitand() This function performs a bitwise logical AND operation on two numbers. Type TSP-Link accessible Affected by...
Section 7: TSP command reference Models 707B and 708B Switching Matrix Reference Manual Usage result = bit.bitor(value1, value2) result Result of the logical OR operation value1 Operand for the logical OR operation Operand for the logical OR operation value2 Details Any fractional parts of value1 and value2 are truncated to make them integers.
Models 707B and 708B Switching Matrix Reference Manual Section 7: TSP command reference Also see Bit manipulation and logic operations (on page 5-4) bit.bitand() (on page 7-9) bit.bitor() (on page 7-9) bit.clear() This function clears a bit at a specified index position. Type TSP-Link accessible Affected by...
Section 7: TSP command reference Models 707B and 708B Switching Matrix Reference Manual Usage result = bit.get(value, index) result Result of the bit manipulation value Specified number index One-based bit position within value to get (1 to 32) 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).
Models 707B and 708B Switching Matrix Reference Manual Section 7: 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).
Section 7: TSP command reference Models 707B and 708B Switching Matrix 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...
Models 707B and 708B Switching Matrix Reference Manual Section 7: TSP command reference Usage result = bit.test(value, index) result Result of the bit manipulation value Specified number index One-based bit position within value to test (1 to 32) Details This function returns result, which is the result of the tested bit. The least significant bit of value is at index position 1;...
Section 7: TSP command reference Models 707B and 708B Switching Matrix Reference Manual Example testResult = bit.toggle(10, 3) The binary equivalent of decimal 10 is 1010. Toggling the bit at index position 3 returns a decimal value of 14 (binary 1110). print(testResult) Output: 1.4000000e+01...
Models 707B and 708B Switching Matrix Reference Manual Section 7: TSP command reference channel.close() This function closes the channels and channel patterns that are specified by the channel list parameter without opening any channels. Type TSP-Link accessible Affected by Where saved Default value Function Usage...
Section 7: TSP command reference Models 707B and 708B Switching Matrix Reference Manual channel.connectrule This attribute controls the connection rule for closing and opening channels in the instrument. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Instrument reset Create configuration script channel.BREAK_BEFORE_MAKE Recall setup...
Models 707B and 708B Switching Matrix Reference Manual Section 7: TSP command reference In general, the settling time of single commands that open and close switch channels depends on several factors, such as card type and channel numbers. However, the opening and closing of two sequential channels including no others can be guaranteed as follows: •...
Section 7: TSP command reference Models 707B and 708B Switching Matrix Reference Manual Details When channel.connectsequential is enabled, the list of channel actions is acted on sequentially. No two relays are opened or closed simultaneously. Using a sequential close allows you to determine the time for a close operation to happen. For example, if you close three channels and each takes 4 ms to closej (assuming no additional user delay times), with sequential on, it will take 12 ms.
Page 252
Models 707B and 708B Switching Matrix Reference Manual Section 7: TSP command reference Details The arguments are dependent upon the card type in the specified slot. This command can only create valid channel descriptors; if an illegal argument is sent for the type of card in the specified slot, an error is generated.
Section 7: TSP command reference Models 707B and 708B Switching Matrix Reference Manual 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 Where saved Default value Function Usage...
Models 707B and 708B Switching Matrix Reference Manual Section 7: TSP command reference Open all channels because the channelList parameter is empty. Close 1D01 and 1E12. Output: 1D01;1E12 Create the pattern myChans. Exclusively close the channels in myChans and additional specified channels. The originally closed channels (1D01 and 1E12) are now open.
Section 7: TSP command reference Models 707B and 708B Switching Matrix Reference Manual For example, if row 1, column 1 channels are closed on each of the six slots, specifying a channelList parameter of "2A02, 4A04" opens the row 1, column 1 channels (slots 2 and 4 only). Then, the row 1, column 2 channel on slot 2, and the row 1, column 4 channel on slot 4 close.
Models 707B and 708B Switching Matrix Reference Manual Section 7: TSP command reference Example 1 channelList = "1A01:1H12" For this example, assume there is a card or pseudocard in slot 1 with no previously closed channel.close("1A01") channels. The output is: print(channel.getclose(channelList)) 1A01 channel.close("1C03")
Section 7: TSP command reference Models 707B and 708B Switching Matrix Reference Manual When the channelList parameter for this function is "slotX", the response first lists the channels starting from lowest to highest (from slot 1 to slot 6). Because each slot is processed completely before going to the next, all slot 1 channels are listed before slot 2 channels.
Models 707B and 708B Switching Matrix Reference Manual Section 7: TSP command reference Details The channelList parameter may contain slotX (where X equals 1 to 6 for Model 707B, or 1 for Model 708B) or allslots. A command, after closing the state of channels, incurs the delay time indicated in the response for a channel before it completes.
Section 7: TSP command reference Models 707B and 708B Switching Matrix Reference Manual Usage forbiddenList = channel.getforbidden(channelList) forbiddenList Comma-delimited string listing the channels in the channel list that are forbidden to close channelList A string listing the channels and channel patterns that are to be checked to see if they are forbidden to close Details The channelList parameter indicates which channels to check, and may include:...
Page 260
Models 707B and 708B Switching Matrix Reference Manual Section 7: TSP command reference Details The channelList parameter can contain more than one channel. If it does, a comma delimits the labels for the channels. The return string lists the labels in the same order that the channels were specified.
Section 7: TSP command reference Models 707B and 708B Switching Matrix Reference Manual channel.getlabelcolumn() This function retrieves the label that was assigned to a column. Type TSP-Link accessible Affected by Where saved Default value Function Instrument reset Create configuration script Empty string or blank Channel reset Usage...
Models 707B and 708B Switching Matrix Reference Manual Section 7: TSP command reference channel.getlabelrow() This function retrieves the label assigned to a row. Type TSP-Link accessible Affected by Where saved Default value Function Instrument reset Create configuration script Empty string or blank Channel reset Usage label = channel.getlabelrow(channelList)
Section 7: TSP command reference Models 707B and 708B Switching Matrix Reference Manual channel.getstate() Queries 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)
Models 707B and 708B Switching Matrix Reference Manual Section 7: 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 string listing the comma-delimited types for channels in channelList channelList String specifying the channels to query, using normal channelList syntax Details...
Page 265
Section 7: TSP command reference Models 707B and 708B Switching Matrix Reference Manual Example 2 channel.open("slot3, slot5") Opens all channels on slots 3 and 5. Example 3 channel.open("allslots") Opens all channels on all slots. Also see channel.close() (on page 7-17) channel.exclusiveclose() (on page 7-22) channel.exclusiveslotclose()
Models 707B and 708B Switching Matrix Reference Manual Section 7: TSP command reference channel.pattern.catalog() This function creates a list of the user-created channel patterns. Type TSP-Link accessible Affected by Where saved Default value Function Usage for name in channel.pattern.catalog() do String representing the user-defined name of the channel pattern that is assigned name by the catalog function during the for loop...
Section 7: TSP command reference Models 707B and 708B Switching Matrix 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) A string representing the name of the channel pattern to delete name Details An error is generated if the name does not exist as a channel pattern.
Models 707B and 708B Switching Matrix Reference Manual Section 7: TSP command reference Example channel.pattern.setimage("1A01:1A05", "myPattern") Using a Model 7174 (or similar model) card in slot 1, this example channel.pattern.setimage("1B01,1B03,1B05", "myRoute") creates two channel patterns and then queries these patterns. myImage = channel.pattern.getimage("myPattern") print(myImage) Output:...
Page 269
Section 7: TSP command reference Models 707B and 708B Switching Matrix Reference Manual 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.
Models 707B and 708B Switching Matrix Reference Manual Section 7: TSP command reference Also see createconfigscript() (on page 7-47) channel.pattern.catalog() (on page 7-35) channel.pattern.delete() (on page 7-36) channel.pattern.getimage() (on page 7-36) channel.pattern.snapshot() (on page 7-39) channel.pattern.snapshot() This function creates a channel pattern. Type TSP-Link accessible Affected by...
Section 7: TSP command reference Models 707B and 708B Switching Matrix Reference Manual Issuing this function on an existing pattern invalidates the existing scan list (the pattern may or may not be used in the current scan list). Creating a new pattern does not invalidate the existing scan list. Channel patterns are stored when you run the createconfigscript() command or setup.save() command.
Models 707B and 708B Switching Matrix Reference Manual Section 7: TSP command reference Example 1 channel.reset("allslots") Performs a reset operation on all channels on the instrument. Example 2 channel.reset("slot1") Resets channels on slot 1 only. Example 3 Resets only row 1, columns 1 through 5 on channel.reset("3A01:3A05") Slot 3.
Section 7: TSP command reference Models 707B and 708B Switching Matrix Reference Manual An error message is generated if: • The value is an invalid setting for the specified channel • A channel pattern is specified • The channel is for an empty slot Command processing will stop as soon as an error is detected and no delay times will be modified.
Models 707B and 708B Switching Matrix Reference Manual Section 7: TSP command reference Example channel.pattern.setimage("1A01,1A02", Create three channel patterns, and then print. "patternA") channel.pattern.setimage("1B01,1B02", "patternB") channel.pattern.setimage("1C01,1C02", "patternC") for name in channel.pattern.catalog() do print(name .. " = " .. channel.pattern.getimage(name)) channel.setforbidden("1A02, 1B01") Set forbidden for one channel from patternA for name in channel.pattern.catalog() do and patternB, then print the catalog again.
Section 7: TSP command reference Models 707B and 708B Switching Matrix Reference Manual Details This command sets the label of the channel specified in channelList to the value specified in the label parameter. The channel attributes associated with each channel remain unchanged except for their labels.
Page 276
Models 707B and 708B Switching Matrix Reference Manual Section 7: TSP command reference Details A column label can be applied to columns of a matrix card. The label is then used on the display and can be accessed in a channel list (see About channel commands (on page 5-5)).
Section 7: TSP command reference Models 707B and 708B Switching Matrix Reference Manual channel.setlabelrow() This function assigns a label to a row. Type TSP-Link accessible Affected by Where saved Default value Function Instrument reset Create configuration script Empty string or blank Channel reset Usage channel.setlabelrow(channel, label)
Models 707B and 708B Switching Matrix Reference Manual Section 7: TSP command reference Example 4 channel.setlabelrow("2B01", "Row2") This example assumes a 7072 in slot 2. print(channel.getlabelrow("slot2")) Set the label to be Row2, which assigns the label to all channels in the row. The output is now : ,,,,,,,,,,,,Row2,Row2,Row2,Row2,Row2 ,Row2,Row2,Row2,Row2,Row2,Row2,Ro w2,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,...
Section 7: TSP command reference Models 707B and 708B Switching Matrix Reference Manual dataqueue.add() This function adds an entry to the data queue. Type TSP-Link accessible Affected by Where saved Default value Function Usage result = dataqueue.add(value) result = dataqueue.add(value, timeout) result The resulting value of true or false based on the success of the function value...
Models 707B and 708B Switching Matrix Reference Manual Section 7: TSP command reference dataqueue.CAPACITY This constant is the maximum number of entries that you can store in the data queue. Type TSP-Link accessible Affected by Where saved Default value Constant Usage count = dataqueue.CAPACITY count...
Section 7: TSP command reference Models 707B and 708B Switching Matrix Reference Manual Example MaxCount = dataqueue.CAPACITY This example fills the data queue and prints the number of items in the queue. It then clears the while dataqueue.count < MaxCount do queue and prints the number of items again.
Page 282
Models 707B and 708B Switching Matrix Reference Manual Section 7: TSP command reference 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...
Section 7: TSP command reference Models 707B and 708B Switching Matrix Reference Manual 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,000 s) Details The instrument delays execution of the commands for at least the specified number of seconds and fractional seconds.
Models 707B and 708B Switching Matrix Reference Manual Section 7: TSP command reference Also see digio.readport() (on page 7-53) digio.writebit() (on page 7-61) digio.writeport() (on page 7-62) Digital I/O port (on page 2-7) digio.readport() This function reads the digital I/O port. Type TSP-Link accessible Affected by...
Section 7: TSP command reference Models 707B and 708B Switching Matrix Reference Manual Details The pulse width that is set determines how long the instrument asserts the trigger. Example Asserts a trigger on digital I/O line 2. digio.trigger[2].assert() Also see digio.trigger[N].pulsewidth (on page 7-57) digio.trigger[N].clear()
Models 707B and 708B Switching Matrix Reference Manual Section 7: TSP command reference Details To have another trigger object respond to trigger events generated by the trigger line, set the other object's stimulus attribute to the value of this constant. Example 1 digio.trigger[5].stimulus = digio.trigger[3].EVENT_ID Uses a trigger event on digital I/O trigger line 3 to be the stimulus for...
Page 287
Section 7: TSP command reference Models 707B and 708B Switching Matrix Reference Manual Details Set triggerMode to one of the following values: Trigger mode values triggerMode Description Allows direct control of the line. digio.TRIG_BYPASS or 0 Detects falling-edge triggers as input; asserts a TTL-low pulse for digio.TRIG_FALLING or 1 output.
Models 707B and 708B Switching Matrix Reference Manual Section 7: TSP command reference digio.trigger[N].overrun This attribute returns the event detector overrun status. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Instrument reset Not saved Not applicable Digital I/O trigger N clear Digital I/O trigger N reset Recall setup Usage...
Section 7: TSP command reference Models 707B and 708B Switching Matrix Reference Manual Example digio.trigger[4].pulsewidth = 20e-6 Sets the pulse width for trigger line 4 to 20 μs. Also see digio.trigger[N].assert() (on page 7-53) digio.trigger[N].reset() (on page 7-58) digio.trigger[N].release() (on page 7-58) digio.trigger[N].release() This functionreleases an indefinite length or latched trigger.
Page 290
Models 707B and 708B Switching Matrix Reference Manual Section 7: TSP command reference Details This function resets the following attributes to factory default settings: • digio.trigger[N].mode • digio.trigger[N].pulsewidth • digio.trigger[N].stimulus It also clears digio.trigger[N].overrun. 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)
Page 291
Section 7: TSP command reference Models 707B and 708B Switching Matrix Reference Manual Details Set this attribute to zero (0) to disable the automatic trigger output. Do not use the stimulus attribute for generating output triggers under script control. Use digio.trigger[N].assert() instead.
Models 707B and 708B Switching Matrix Reference Manual Section 7: TSP command reference 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 in seconds...
Section 7: TSP command reference Models 707B and 708B Switching Matrix Reference Manual 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.
Models 707B and 708B Switching Matrix Reference Manual Section 7: TSP command reference 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...
Section 7: TSP command reference Models 707B and 708B Switching Matrix Reference Manual 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() The bitmasked value that shows which indicators are turned on annunciators Details This function returns a bitmasked value showing which indicators are turned on.
Models 707B and 708B Switching Matrix Reference Manual Section 7: TSP command reference Example 2 Output: print(display.ANNUNCIATOR_EDIT) 2.5600000e+02 print(display.ANNUNCIATOR_TRIGGER) 3.2000000e+01 print(display.ANNUNCIATOR_AUTO) 8.0000000e+00 Also see bit.bitand() (on page 7-9) display.getcursor() This function reads the present position of the cursor on the front panel display. Type TSP-Link accessible Affected by...
Section 7: TSP command reference Models 707B and 708B Switching Matrix Reference Manual display.getlastkey() This function retrieves the key code for the last pressed key. Type TSP-Link accessible Affected by Where saved Default value Function Usage keyCode = display.getlastkey() A returned value that represents the last front-panel key pressed; see Details for keyCode more information Details...
Models 707B and 708B Switching Matrix Reference Manual Section 7: TSP command reference Example key = display.getlastkey() On the front panel, press the MENU key and then send the code shown here. This retrieves print(key) the key code for the last pressed key. Output: 6.8000000e+01 Also see...
Section 7: TSP command reference Models 707B and 708B Switching Matrix Reference Manual 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 300
Models 707B and 708B Switching Matrix Reference Manual Section 7: TSP command reference 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.
Section 7: TSP command reference Models 707B and 708B Switching Matrix Reference Manual display.loadmenu.add() This function adds an entry to the USER TESTS menu, which can be accessed by pressing the LOAD key on the instrument front panel. Type TSP-Link accessible Affected by Where saved Default value...
Models 707B and 708B Switching Matrix Reference Manual Section 7: TSP command reference Example 2 display.loadmenu.add( Assume a script with a function named “DUT1” has already been loaded into the "Test", "DUT1() beeper.beep(2, 500)", instrument, and the script has NOT been display.SAVE) saved in nonvolatile memory.
Section 7: TSP command reference Models 707B and 708B Switching Matrix Reference Manual Details Each time through the loop, displayName and code will take on the values in the USER TESTS menu. The instrument goes through the list in random order. Example for displayName, code in Output:...
Models 707B and 708B Switching Matrix Reference Manual Section 7: TSP command reference Usage lockout = display.locallockout display.locallockout = lockout lockout 0 or display.UNLOCK: Unlocks EXIT (LOCAL) key 1 or display.LOCK: Locks out EXIT (LOCAL) key Details Set display.locallockout to display.LOCK to prevent the user from interrupting remote operation by pressing the EXIT (LOCAL) key.
Section 7: TSP command reference Models 707B and 708B Switching Matrix Reference Manual Details The menu consists of the menu name string on the top line, and a selectable list of items on the bottom line. The menu items must be a single string with each item separated by whitespace. The name for the top line is limited to 20 characters.
Models 707B and 708B Switching Matrix Reference Manual Section 7: TSP command reference The format parameter can include the options shown in the following table. Option Description Examples Include the E to display the value exponentially. Include a plus sign (+) for positive/negative exponent entry. Do not 0.00000E+0 include the plus sign (+) to prevent negative value entry.
Section 7: TSP command reference Models 707B and 708B Switching Matrix Reference Manual Usage displayID = display.screen display.screen = displayID displayID One of the following values: • 1 or display.MAIN: Displays the main screen • 2 or display.USER: Displays the user screen. Details Setting this attribute selects the display screen for the front panel.
Page 308
Models 707B and 708B Switching Matrix Reference Manual Section 7: TSP command reference The table below lists the keyCode value for each front panel action. Key codes Value Key list Value Key list display.KEY_NONE display.KEY_RUN display.KEY_DELETE display.KEY_TRIG display.KEY_EXIT display.KEY_STEP display.KEY_CLOSE display.KEY_CHAN display.KEY_SLOT display.KEY_INSERT...
Section 7: TSP command reference Models 707B and 708B Switching Matrix Reference Manual Details Sending this command selects the user screen and then moves the cursor to the given location. The display.clear(), display.setcursor(), and display.settext() functions are overlapped commands. That is, the script does not wait for one of these commands to complete. These functions do not immediately update the display.
Models 707B and 708B Switching Matrix Reference Manual Section 7: TSP command reference display.settext() This function displays text on the user screen. Type TSP-Link accessible Affected by Where saved Default value Function Usage display.settext(text) Text message to be displayed, with optional character codes text Details This function selects the user display screen and displays the given text.
Section 7: TSP command reference Models 707B and 708B Switching Matrix Reference Manual Also see display.clear() (on page 7-63) display.getcursor() (on page 7-65) display.gettext() (on page 7-67) display.screen (on page 7-75) display.setcursor() (on page 7-77) display.trigger.clear() This function clears the front-panel trigger event detector. Type TSP-Link accessible Affected by...
Models 707B and 708B Switching Matrix Reference Manual Section 7: TSP command reference display.waitkey() This function captures the key code value for the next front-panel action. Type TSP-Link accessible Affected by Where saved Default value Function Usage keyCode = display.waitkey() keyCode See Details for more information Details...
Section 7: TSP command reference Models 707B and 708B Switching Matrix Reference Manual Example key = display.waitkey() Pause script execution until the operator presses a key or the navigation wheel, or rotates the print(key) navigation wheel. If the output is: 8.60000e+01 It indicates that the MEAS(A) key was pressed.
Models 707B and 708B Switching Matrix Reference Manual Section 7: TSP command reference errorqueue.count This attribute gets the number of entries in the error queue. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Power cycle Not applicable Not applicable Clearing error queue Reading error messages...
Section 7: TSP command reference Models 707B and 708B Switching Matrix Reference Manual Returned severity levels are described in the following table. Severity level descriptions Number Level Description Informational Indicates that there are no entries in the queue. Informational Indicates a status message or minor error. Recoverable Indicates possible invalid user input;...
Models 707B and 708B Switching Matrix Reference Manual Section 7: TSP command reference Example print(eventlog.all()) Get and print all entries from the event log and remove the entries from the log. Output: 17:26:35.690 10 Oct 2007, LAN0, 192.168.1.102, LXI, 0, 1192037132, 1192037155.733269000, 0, 0x0 17:26:39.009 10 Oct 2007, LAN5, 192.168.1.102, LXI, 0, 1192037133, 1192037159.052777000, 0, 0x0...
Section 7: TSP command reference Models 707B and 708B Switching Matrix Reference Manual eventlog.count This attribute returns the number of unread events in the event log. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Instrument reset Not applicable Not applicable Clearing event log Reading event log...
Models 707B and 708B Switching Matrix Reference Manual Section 7: TSP command reference Example print(eventlog.enable) Displays the present status of the Model 707B or 708B event log. eventlog.enable = eventlog.DISABLE print(eventlog.enable) Output: 1.0000000e+00 0.0000000e+00 Also see eventlog.all() (on page 7-84) eventlog.clear() (on page 7-85) eventlog.count...
Section 7: TSP command reference Models 707B and 708B Switching Matrix Reference Manual 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...
Models 707B and 708B Switching Matrix Reference Manual Section 7: TSP command reference format.asciiprecision This attribute sets the precision (number of digits) for all numbers returned in the ASCII format. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Instrument reset Create configuration script Recall setup...
Section 7: TSP command reference Models 707B and 708B Switching Matrix Reference Manual Usage order = format.byteorder format.byteorder = order order Byte order value as follows: • Most significant byte first: 0, format.NORMAL, format.NETWORK, or format.BIGENDIAN • Least significant byte first: 1, format.SWAPPED or format.LITTLEENDIAN Details This attribute selects the byte order in which data is written when you are printing data values with the printnumber() and printbuffer() functions.
Page 322
Models 707B and 708B Switching Matrix Reference Manual Section 7: TSP command reference Details The precision of numeric values can be controlled with the format.asciiprecision attribute. The byte order of format.SREAL, format.REAL, format.REAL32, and format.REAL64 can be selected with the format.byteorder attribute. REAL32 and SREAL select the same single precision format.
Section 7: TSP command reference Models 707B and 708B Switching Matrix Reference Manual gettimezone() This function retrieves the local time zone. Type TSP-Link accessible Affected by Where saved Default value Function Usage timeZone = gettimezone() The local timezone of the instrument timeZone Details See settimezone() for additional details about the time zone format and a description of the fields.
Models 707B and 708B Switching Matrix Reference Manual Section 7: TSP command reference Details The address can be set to any address value from 1 to 30. However, the address must be unique in the system. It cannot conflict with an address that is assigned to another instrument or to the GPIB controller.
Section 7: TSP command reference Models 707B and 708B Switching Matrix Reference Manual Example lan.applysettings() Re-initialize the LAN interface with new settings. Also see None lan.config.dns.address[N] Configures DNS server IP addresses. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) LAN restore defaults Nonvolatile memory...
Section 7: TSP command reference Models 707B and 708B Switching Matrix Reference Manual Details Dynamic DNS registration works with DHCP to register the host name with the DNS server. The host name is specified in the lan.config.dns.hostname attribute. Example print(lan.config.dns.dynamic) Outputs the dynamic registration state.
Models 707B and 708B Switching Matrix Reference Manual Section 7: TSP command reference Also see lan.config.dns.dynamic (on page 7-95) lan.restoredefaults() (on page 7-101) lan.config.dns.verify This attribute defines the DNS host name verification state. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) LAN restore defaults...
Section 7: TSP command reference Models 707B and 708B Switching Matrix Reference Manual Details This attribute specifies the default gateway IP address to use when manual or DLLA configuration methods are used to configure the LAN. If DHCP is enabled, this setting is ignored. This attribute does not indicate the actual setting that is presently in effect.
Models 707B and 708B Switching Matrix Reference Manual Section 7: TSP command reference Usage method = lan.config.method lan.config.method = method method The method for configuring LAN settings; it can be one of the following values: 0 or lan.AUTO: Selects automatic sequencing of configuration methods 1 or lan.MANUAL: Use only manually specified configuration settings Details This attribute controls how the LAN IP address, subnet mask, default gateway address, and DNS...
Section 7: TSP command reference Models 707B and 708B Switching Matrix Reference Manual Also see lan.restoredefaults() (on page 7-101) lan.status.subnetmask (on page 7-107) lan.lxidomain This attribute contains the LXI domain. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) LAN restore defaults Nonvolatile memory Usage...
Models 707B and 708B Switching Matrix Reference Manual Section 7: TSP command reference lan.reset() This function resets the LAN interface. Type TSP-Link accessible Affected by Where saved Default value Function Usage lan.reset() Details This function resets the LAN interface. It performs the commands lan.restoredefaults() and lan.applysettings().
Section 7: TSP command reference Models 707B and 708B Switching Matrix Reference Manual Also see lan.reset() (on page 7-101) localnode.password (on page 7-121) lan.status.dns.address[N] This attribute contains the DNS server IP addresses. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Not applicable Not applicable...
Models 707B and 708B Switching Matrix Reference Manual Section 7: TSP command reference Details A fully qualified domain name (FQDN), sometimes referred to as an absolute domain name, is a domain name that specifies its exact location in the tree hierarchy of the Domain Name System (DNS).
Section 7: TSP command reference Models 707B and 708B Switching Matrix Reference Manual Details The value of gatewayAddress is a string that indicates the IP address of the gateway in dotted decimal notation. Example print(lan.status.gateway) Outputs the gateway address, such as: 192.168.0.1 Also see lan.config.gateway...
Models 707B and 708B Switching Matrix Reference Manual Section 7: TSP command reference Example print(lan.status.macaddress) Outputs the MAC address of the instrument, for example: 00:60:1A:00:00:57 Also see None lan.status.port.dst This attribute contains the LAN dead socket termination port number. Type TSP-Link accessible Affected by Where saved...
Section 7: TSP command reference Models 707B and 708B Switching Matrix Reference Manual Example print(lan.status.port.rawsocket) Outputs the LAN raw socket port number, such as: 5.02500e+03 Also see None lan.status.port.telnet This attribute contains the LAN Telnet connection port number. Type TSP-Link accessible Affected by Where saved Default value...
Models 707B and 708B Switching Matrix Reference Manual Section 7: TSP command reference Also see None 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...
Section 7: TSP command reference Models 707B and 708B Switching Matrix Reference Manual 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.
Models 707B and 708B Switching Matrix Reference Manual Section 7: TSP command reference Example lan.trigger[5].clear() Clears the event detector with LAN packet 5. Also see lan.trigger[N].assert() (on page 7-108) lan.trigger[N].overrun (on page 7-113) lan.trigger[N].stimulus (on page 7-115) lan.trigger[N].wait() (on page 7-117) lan.trigger[N].connect() This functionprepares the event generator for outgoing trigger events.
Section 7: TSP command reference Models 707B and 708B Switching Matrix Reference Manual Usage connected = lan.trigger[N].connected connected The LAN event connection state: • true: Connected • false: Not connected The LAN event number (1 to 8) Details This read-only attribute is set to true when the LAN trigger is connected and ready to send trigger events following a successful lan.trigger[N].connect() command;...
Models 707B and 708B Switching Matrix Reference Manual Section 7: TSP command reference lan.trigger[N].EVENT_ID This constant is the event identifier used to route the LAN trigger to other subsystems (using stimulus properties). Type TSP-Link accessible Affected by Where saved Default value Constant Usage lan.trigger[N].EVENT_ID...
Page 343
Section 7: TSP command reference Models 707B and 708B Switching Matrix Reference Manual Example lan.trigger[3].protocol = lan.TCP Set the protocol for LAN trigger 3 to be lan.TCP when sending LAN triggers. lan.trigger[3].ipaddress = "192.168.1.100" lan.trigger[3].connect() Use IP address "192.168.1.100" to connect the LAN trigger.
Models 707B and 708B Switching Matrix Reference Manual Section 7: TSP command reference lan.TRIG_RISING and lan.TRIG_RISINGA are the same. lan.TRIG_RISING and lan.TRIG_RISINGM are the same. 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.
Section 7: TSP command reference Models 707B and 708B Switching Matrix Reference Manual lan.trigger[N].protocol This attribute sets the LAN protocol to use for sending trigger messages. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Instrument reset Create configuration script 0 (lan.TCP) LAN trigger N reset Recall setup...
Models 707B and 708B Switching Matrix Reference Manual Section 7: TSP command reference Details This attribute can be set to initialize the pseudo line state to a known value. Setting this attribute does not cause the LAN trigger to generate any events or output packets. Example print(lan.trigger[1].pseudostate) Get the present simulated line state for the LAN...
Page 347
Section 7: TSP command reference Models 707B and 708B Switching Matrix Reference Manual 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...
Models 707B and 708B Switching Matrix Reference Manual Section 7: TSP command reference lan.trigger[N].wait() This function waits for an input trigger. Type TSP-Link accessible Affected by Where saved Default value Function Usage triggered = lan.trigger[N].wait(timeout) triggered Trigger detection indication (true or false) The trigger packet over LAN to wait for (1 to 8) timeout Maximum amount of time in seconds to wait for the trigger event...
Section 7: TSP command reference Models 707B and 708B Switching Matrix Reference Manual 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...
Models 707B and 708B Switching Matrix Reference Manual Section 7: TSP command reference localnode.description This attribute stores a user-defined description and mDNS service name of the instrument. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Not applicable Nonvolatile memory Instrument specific (see Details) Usage...
Section 7: TSP command reference Models 707B and 708B Switching Matrix Reference Manual node[N].execute() This function starts test scripts on a remote TSP-Link node. Type TSP-Link accessible Affected by Where saved Default value Function Yes (see Details) Usage node[N].execute(scriptCode) The node number of this instrument (1 to 64) scriptCode A string containing the source code Details...
Models 707B and 708B Switching Matrix Reference Manual Section 7: TSP command reference Details This function retrieves the value of a global variable from the run-time environment of this node. Do not use this command to retrieve the value of a global variable from the local node. Instead, access the global variable directly.
Section 7: TSP command reference Models 707B and 708B Switching Matrix Reference Manual The instrument continues to use the old password for all interactions until the command to change it executes. When changing the password, give the instrument time to execute the command before attempting to use the new password.
Models 707B and 708B Switching Matrix Reference Manual Section 7: TSP command reference 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...
Section 7: TSP command reference Models 707B and 708B Switching Matrix Reference Manual 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)
Models 707B and 708B Switching Matrix Reference Manual Section 7: TSP command reference Details If you want to reset a specific instrument or a subordinate node, use the node[X].reset() command. A local node reset includes a channel.reset("allslots") and a scan.reset(). In addition: •...
Section 7: TSP command reference Models 707B and 708B Switching Matrix Reference Manual 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 The serial number of the instrument serialno Details...
Models 707B and 708B Switching Matrix Reference Manual Section 7: 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 7-120) Using TSP to run test scripts simultaneously (on page 6-48) localnode.showerrors This attribute sets whether or not the instrument automatically sends generated errors.
Section 7: TSP command reference Models 707B and 708B Switching Matrix Reference Manual Details This function is useful for aliasing attributes to improve execution speed. Calling the function created with makegetter() executes faster than accessing the attribute directly. Creating a getter function is only useful if it is going to be called several times. Otherwise, the overhead of creating the getter function outweighs the overhead of accessing the attribute directly.
Models 707B and 708B Switching Matrix Reference Manual Section 7: TSP command reference memory.available() This function reads and returns the amount of memory that is available in the instrument overall for storing user scripts and channel patterns. Type TSP-Link accessible Affected by Where saved Default value...
Section 7: TSP command reference Models 707B and 708B Switching Matrix Reference Manual memory.used() This function reports the amount of memory used in the instrument overall and for user scripts, and storing channel patterns. Type TSP-Link accessible Affected by Where saved Default value Function Usage...
Models 707B and 708B Switching Matrix Reference Manual Section 7: TSP command reference opc() This function sets the operation complete status bit when all overlapped commands are completed. Type TSP-Link accessible Affected by Where saved Default value Function Usage opc() Details This function causes the operation complete bit in the Standard Event Status Register to be set when all previously started local overlapped commands are complete.
Page 363
Section 7: TSP command reference Models 707B and 708B Switching Matrix Reference Manual Details TSP-enabled instruments do not have inherent query commands. Like any other scripting environment, 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 364
Models 707B and 708B Switching Matrix Reference Manual Section 7: TSP command reference 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.
Section 7: TSP command reference Models 707B and 708B Switching Matrix Reference Manual Also see format.asciiprecision (on page 7-89) format.byteorder (on page 7-89) format.data (on page 7-90) printnumber() (on page 7-134) printnumber() This function prints numbers using the configured format. Type TSP-Link accessible Affected by...
Models 707B and 708B Switching Matrix Reference Manual Section 7: TSP command reference 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 true: If the node is the master, the entire system is reset false: Only the local group is reset Details The reset() command in its simplest form resets the entire TSP-enabled system, including the...
Section 7: TSP command reference Models 707B and 708B Switching Matrix Reference Manual Example scan.background() Starts background scan, and then aborts the scan. scan.abort() Also see scan.background() (on page 7-139) Scanning and triggering (on page 3-1) scan.add() This function adds a scan step to the scan list. Type TSP-Link accessible Affected by...
Page 368
Models 707B and 708B Switching Matrix Reference Manual Section 7: TSP command reference Example 2 scan.create("1A01:1A08") Replaces the active scan list with an empty scan list, and then adds row A, columns 1 through 8 on slot 1 to the new scan list. scan.add("1A10") Adds row A, column 10 on slot 1 to the end of the scan list.
Section 7: TSP command reference Models 707B and 708B Switching Matrix Reference Manual 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) channelList String specifying a list of channels Details This function adds a list of channels to be closed simultaneously in a single step of a scan.
Models 707B and 708B Switching Matrix Reference Manual Section 7: TSP command reference scan.background() This function starts a scan and runs the scan in the background. Type TSP-Link accessible Affected by Where saved Default value Function Usage state, scanCount, stepCount = scan.background() state The result of scanning: scan.EMPTY or 0...
Section 7: TSP command reference Models 707B and 708B Switching Matrix Reference Manual scan.bypass This attribute indicates whether the first channel of the scan waits for the channel stimulus event to be satisfied before closing. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW)
Models 707B and 708B Switching Matrix Reference Manual Section 7: 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...
Page 373
Section 7: TSP command reference Models 707B and 708B Switching Matrix Reference Manual 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 scanState, scanCount, stepCount = scan.execute() scanState The result of scanning: scan.EMPTY or 0...
Models 707B and 708B Switching Matrix Reference Manual Section 7: TSP command reference 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...
Page 375
Section 7: TSP command reference Models 707B and 708B Switching Matrix Reference Manual Example scan.create("1A07:1B03") Populate the scan list with the function scan.create("1A07:1B03"), then initiate print(scan.list()) the scan list to be output. Outputs the existing scan list. Output: Init) OPEN... 1) STEP: 1A07 CLOSE: 1A07 2) STEP: 1A08...
Section 7: TSP command reference Models 707B and 708B Switching Matrix 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...
Section 7: TSP command reference Models 707B and 708B Switching Matrix 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 = scan.state() scanState The present state of the scan running in the background.
Models 707B and 708B Switching Matrix Reference Manual Section 7: TSP command reference scan.stepcount This attribute contains 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...
Section 7: TSP command reference Models 707B and 708B Switching Matrix 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 382
Models 707B and 708B Switching Matrix Reference Manual Section 7: TSP command reference • tsplink.trigger[N].EVENT_ID: An edge (either rising, falling, or either based on the configuration of the line) on the tsplink trigger line. • lan.trigger[N].EVENT_ID: Event identifier use to route the LAN trigger to other subsystems (using stimulus properties).
Section 7: TSP command reference Models 707B and 708B Switching Matrix Reference Manual scan.trigger.channel.clear() This function clears the channel event detector. Type TSP-Link accessible Affected by Where saved Default value Function Usage scan.trigger.channel.clear() Details This function clears the channel event detector of the trigger model (sets it to the undetected state). Example scan.trigger.channel.clear() Clears the channel event detector.
Page 384
Models 707B and 708B Switching Matrix Reference Manual Section 7: 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 configuration scan.trigger.EVENT_CHANNEL_READ Scan reset...
Page 385
Section 7: TSP command reference Models 707B and 708B Switching Matrix Reference Manual trigger.blender[N].EVENT_ID or 58 A combination of events has occurred. to 59 A delay expired. trigger.timer[N].EVENT_ID or 20 to 23 An edge (either rising, falling, or either based on the tsplink.trigger[N].EVENT_ID or 17 configuration of the line) on the TSP-Link trigger line.
Models 707B and 708B Switching Matrix Reference Manual Section 7: TSP command reference scan.trigger.clear() This function clears the trigger model. Type TSP-Link accessible Affected by Where saved Default value Function Usage scan.trigger.clear() Details This function sets the arm and channel event detectors of the trigger model to the undetected state. Example scan.trigger.clear() Clears the trigger model.
Section 7: TSP command reference Models 707B and 708B Switching Matrix Reference Manual Example 2 print(script.anonymous.source) Retrieves the source of the anonymous script. Also see scriptVar.autorun (on page 7-160) scriptVar.list() (on page 7-162) scriptVar.name (on page 7-162) scriptVar.run() (on page 7-163) scriptVar.save() (on page 7-164) scriptVar.source...
Page 388
Models 707B and 708B Switching Matrix Reference Manual Section 7: TSP command reference Details The name parameter is the name that is added to the script.user.scripts table. If name is not given, an empty string will be used, and the script will be unnamed. If the name already exists in script.user.scripts, the existing script's name attribute is set to an empty string before it is replaced by the new script.
Section 7: TSP command reference Models 707B and 708B Switching Matrix Reference Manual script.newautorun() This function is identical to the script.new() function, but it creates a script with the autorun attribute set to "yes". Type TSP-Link accessible Affected by Where saved Default value Function Usage...
Models 707B and 708B Switching Matrix Reference Manual Section 7: TSP command reference script.restore() This function restores a script that was removed from the run-time environment. Type TSP-Link accessible Affected by Where saved Default value Function Usage script.restore(name) name The name of the script to be restored Details This command copies the script from nonvolatile memory into the run-time environment.
Section 7: TSP command reference Models 707B and 708B Switching Matrix Reference Manual script.user.catalog() This function returns an iterator that can be used in a for loop to iterate over all the scripts stored in nonvolatile memory. Type TSP-Link accessible Affected by Where saved Default value...
Page 392
Models 707B and 708B Switching Matrix Reference Manual Section 7: TSP command reference Details Autorun scripts run automatically when the instrument is turned on. You can set any number of scripts to autorun. The run order for autorun scripts is arbitrary, so make sure the run order is not important. The default value for scriptVar.autorun depends on how the script was loaded.
Section 7: TSP command reference Models 707B and 708B Switching Matrix Reference Manual scriptVar.list() This function generates a script listing. Type TSP-Link accessible Affected by Where saved Default value Function Usage scriptVar.list() scriptVar The name of variable that references the script Details This function generates output in the form of a sequence of response messages (one message for each line of the script).
Models 707B and 708B Switching Matrix Reference Manual Section 7: TSP command reference Details When setting the script name, this attribute renames the script that the variable scriptVar references. This attribute must be either a valid Lua identifier or the empty string. Changing the name of a script changes the index that is used to access the script in the script.user.scripts table.
Section 7: TSP command reference Models 707B and 708B Switching Matrix Reference Manual Details The scriptVar.run() function runs the script referenced by scriptVar. You can also run the script by using scriptVar(). Example Runs the script referenced by the variable test8.run() test8.
Models 707B and 708B Switching Matrix Reference Manual Section 7: TSP command reference scriptVar.source This attribute contains the source code of a script. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Not applicable Not saved Not applicable (see Details) Usage code = scriptVar.source...
Section 7: TSP command reference Models 707B and 708B Switching Matrix Reference Manual Details This function sets the date and time of the instrument based on the time parameter (specified in UTC time). UTC time is specified as the number of seconds since Jan 1, 1970, UTC. You can use UTC time from a local time specification, or you can use UTC time from another source (for example, your computer).
Page 398
Models 707B and 708B Switching Matrix Reference Manual Section 7: TSP command reference For example, to set the UTC-5 time zone, you specify the string "5", because UTC-5 is 5 hours behind UTC and you must add 5 hours to the local time to determine UTC time. To specify the time zone UTC4, you specify "-4", because UTC4 is 4 hours ahead of UTC and 4 hours must be subtracted from the local time to determine UTC.
Section 7: TSP command reference Models 707B and 708B Switching Matrix Reference Manual slot[X].idn This attribute returns a string that contains information about the card in slot X. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Not applicable Not applicable Not applicable Usage...
Models 707B and 708B Switching Matrix Reference Manual Section 7: TSP command reference slot[X].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...
Section 7: TSP command reference Models 707B and 708B Switching Matrix Reference Manual slot[X].poles.one This attribute indicates if a one-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...
Models 707B and 708B Switching Matrix Reference Manual Section 7: TSP command reference slot[X].poles.two This attribute indicates if a two-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...
Page 403
Section 7: TSP command reference Models 707B and 708B Switching Matrix Reference Manual Details This attribute only exists for a slot if that slot has no card installed in it. If a card is installed, the response is nil when queried. If no card installed and the slot is empty, the response is 0. After assigning a pseudocard, the valid commands and attributes based on that pseudocard exist for that slot.
Page 404
Models 707B and 708B Switching Matrix Reference Manual Section 7: TSP command reference > > > > > > * 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 405
Section 7: TSP command reference Models 707B and 708B Switching Matrix Reference Manual Binary value Decimal Weights Example statusByte = status.condition Returns statusByte. print(statusByte) Sample output: 1.29000e+02 Converting this output (129) to its binary equivalent yields 1000 0001 Therefore, this output indicates that the set bits of the status byte condition register are presently B0 (MSS) and B7 (OSB).
Page 406
Models 707B and 708B Switching Matrix Reference Manual Section 7: 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-20). The individual bits of this register are defined in the following table.
Page 407
Section 7: TSP command reference Models 707B and 708B Switching Matrix Reference Manual status.node_event This attribute stores the status node event register. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Not applicable Not saved Usage nodeEventRegister = status.node_event nodeEventRegister The status of the node event register;...
Models 707B and 708B Switching Matrix Reference Manual Section 7: TSP command reference In addition to the above constants, nodeEventRegister can be set to the decimal equivalent of the bits set. When more than one bit of the register is set, nodeEventRegister contains the sum of their decimal weights.
Page 409
Section 7: TSP command reference Models 707B and 708B Switching Matrix Reference Manual Details These attributes read or write the operation status registers. Reading a status register returns a value. The binary equivalent of the returned value indicates which register bits are set. The least significant bit of the binary number is bit B0, and the most significant bit is bit B15.
Models 707B and 708B Switching Matrix Reference Manual Section 7: TSP command reference Binary value Decimal Weights Binary value Decimal 32,768 16,384 8,192 4,096 2,048 1,024 Weights Example 1 operationRegister = status.operation.USER + Sets the USER and PROG bits of the operation status enable register using status.operation.PROG constants.
Page 411
Section 7: TSP command reference Models 707B and 708B Switching Matrix Reference Manual Details These attributes are used to read or write to the operation status user registers. Reading a status register returns a value. The binary equivalent of the value indicates which register bits are set. In the binary equivalent, the least significant bit is bit B0, and the most significant bit is bit B15.
Models 707B and 708B Switching Matrix Reference Manual Section 7: TSP command reference Binary value Decimal Weights Binary value Decimal 32,768 16,384 8,192 4,096 2,048 1,024 Weights Example 1 operationRegister = status.operation.user.BIT11 + Uses constants to set bits B11 and B14 of the operation status user enable status.operation.user.BIT14 register.
Page 413
Section 7: TSP command reference Models 707B and 708B Switching Matrix Reference Manual Details These attributes are used to read or write to the questionable status registers. Reading a status register returns a value. In the binary equivalent, the least significant bit is bit B0, and the most significant bit is bit B15.
Models 707B and 708B Switching Matrix Reference Manual Section 7: TSP command reference Binary value Decimal Weights Binary value Decimal 32,768 16,384 8,192 4,096 2,048 1,024 Weights Example 1 questionableRegister = status.questionable.S1THR Uses constants to set bits B9 and B11 of the status questionable enable register.
Page 415
Section 7: TSP command reference Models 707B and 708B Switching Matrix Reference Manual > > > > > > * 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 Enable and transition registers...
Models 707B and 708B Switching Matrix Reference Manual Section 7: TSP command reference Example 2 -- decimal 129 = binary 10000001 Uses a decimal value to set the MSB and OSB bits of the service request (SRQ) requestSRQEnableRegister = 129 enable register.
Page 417
Section 7: TSP command reference Models 707B and 708B Switching Matrix 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-20). The individual bits of this register are defined in the following table.
Models 707B and 708B Switching Matrix Reference Manual Section 7: 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 419
Section 7: TSP command reference Models 707B and 708B Switching Matrix 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 420
Models 707B and 708B Switching Matrix Reference Manual Section 7: TSP command reference Value Description Set bit indicates that a command error has status.standard.COMMAND_ERROR status.standard.CME occurred. Command errors include: IEEE Std 488.2 syntax error: Instrument received a message that does not follow the defined syntax of the IEEE Std 488.2 standard.
Section 7: TSP command reference Models 707B and 708B Switching Matrix Reference Manual status.system.* ® These attributes manage the TSP-Link system summary register of the status model for nodes 1 through 14. Type TSP-Link accessible Affected by Where saved Default value Attribute .condition (R) Not applicable...
Page 422
Models 707B and 708B Switching Matrix Reference Manual Section 7: TSP command reference Value Description status.system.EXTENSION_BIT Bit B0 decimal value: 1 status.system.EXT Bit B1 decimal value: 2 status.system.NODE1 status.system.NODE2 Bit B2 decimal value: 4 status.system.NODE3 Bit B3 decimal value: 8 Bit B4 decimal value: 16 status.system.NODE4 Bit B5 decimal value: 32...
Section 7: TSP command reference Models 707B and 708B Switching Matrix Reference Manual status.system2.* ® These attributes manage the TSP-Link system summary register of the status model for nodes 15 through 28. Type TSP-Link accessible Affected by Where saved Default value Attribute .condition (R) Not applicable...
Page 424
Models 707B and 708B Switching Matrix Reference Manual Section 7: 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...
Section 7: TSP command reference Models 707B and 708B Switching Matrix Reference Manual Example 2 -- decimal 18432 = binary 0100 1000 0000 0000 Uses a decimal value to set bits B11 and B14 of the system summary 2 enable enableRegister = 18432 register.
Page 426
Models 707B and 708B Switching Matrix Reference Manual Section 7: 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...
Section 7: TSP command reference Models 707B and 708B Switching Matrix Reference Manual Example 2 -- decimal 18432 = binary 0100 1000 0000 0000 Uses a decimal value to set bits B11 and B14 of the system summary 3 enable enableRegister = 18432 register.
Page 428
Models 707B and 708B Switching Matrix Reference Manual Section 7: 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...
Section 7: TSP command reference Models 707B and 708B Switching Matrix Reference Manual Example 2 -- decimal 18432 = binary 0100 1000 0000 0000 Uses a decimal value to set bit B11 and bit B14 of the system summary 4 enable enableRegister = 18432 register.
Page 430
Models 707B and 708B Switching Matrix Reference Manual Section 7: 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...
Section 7: TSP command reference Models 707B and 708B Switching Matrix Reference Manual Also see status.system4.* (on page 7-196) System summary bit (System register) (on page C-5) timer.measure.t() This function measures the elapsed time since the timer was last reset. Type TSP-Link accessible Affected by...
Models 707B and 708B Switching Matrix Reference Manual Section 7: TSP command reference Example timer.reset() Resets the timer and then measures the time since the reset. -- (intervening code) Output: time = timer.measure.t() 1.469077e+01 print(time) The above output indicates that timer.measure.t() was executed 14.69077 seconds after timer.reset().
Section 7: TSP command reference Models 707B and 708B Switching Matrix Reference Manual Details Set the stimulus of any trigger object to the value of this constant to have the trigger object respond to trigger events from this trigger blender. Example Set the trigger stimulus of digio.trigger[1].stimulus = trigger.blender[2].EVENT_ID...
Models 707B and 708B Switching Matrix Reference Manual Section 7: TSP command reference trigger.blender[N].overrun This attribute indicates whether or not an event was ignored because of the event detector state. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Instrument reset Not applicable Not applicable...
Page 435
Section 7: TSP command reference Models 707B and 708B Switching Matrix Reference Manual Example trigger.blender[1].reset() Resets the trigger blender 1 settings to factory defaults. Also see trigger.blender[N].orenable (on page 7-202) trigger.blender[N].overrun (on page 7-203) trigger.blender[N].stimulus[M] (on page 7-204) trigger.blender[N].stimulus[M] This attribute specifies which events trigger the blender. Type TSP-Link accessible Affected by...
Page 436
Models 707B and 708B Switching Matrix Reference Manual Section 7: TSP command reference Example digio.trigger[3].mode = digio.TRIG_FALLING Generate a trigger blender 1 event when a digital I/O digio.trigger[5].mode = digio.TRIG_FALLING trigger happens on line 3 or trigger.blender[1].orenable = true 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()
Section 7: TSP command reference Models 707B and 708B Switching Matrix Reference Manual 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.
Models 707B and 708B Switching Matrix Reference Manual Section 7: TSP command reference Details This command sets the timer event detector to the undetected state and resets the overrun indicator. Example Clears trigger timer 1. trigger.timer[1].clear() Also see trigger.timer[N].count (on page 7-207) trigger.timer[N].count This attribute sets the number of events to generate each time the timer generates a trigger event.
Models 707B and 708B Switching Matrix Reference Manual Section 7: TSP command reference Details Each time the timer is triggered after it is enabled, it uses the next delay period from the array. The default value is an array with one value of 10 µs. After all elements in the array have been used, the delays restart at the beginning of the list.
Section 7: TSP command reference Models 707B and 708B Switching Matrix Reference Manual trigger.timer[N].overrun This attribute indicates if an event was ignored because of the event detector state. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Instrument reset Not applicable false Recall setup...
Models 707B and 708B Switching Matrix Reference Manual Section 7: TSP command reference Details When pass-through mode is enabled, triggers are passed through immediately and initiate the delay. When disabled, a trigger only initiates a delay. Example Enables pass-through mode on trigger timer 1. trigger.timer[1].passthrough = true Also see trigger.timer[N].reset()
Page 443
Section 7: TSP command reference Models 707B and 708B Switching Matrix Reference Manual trigger.timer[N].stimulus This attribute specifies which event starts the timer. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Reset Create configuration script Recall setup Trigger timer N reset Usage eventID = trigger.timer[N].stimulus trigger.timer[N].stimulus = eventID...
Models 707B and 708B Switching Matrix Reference Manual Section 7: 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) Trigger detection indication triggered Trigger timer number (1 to 4) timeout Maximum amount of time in seconds to wait for the trigger Details...
Section 7: TSP command reference Models 707B and 708B Switching Matrix 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) •...
Models 707B and 708B Switching Matrix Reference Manual Section 7: 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...
Section 7: TSP command reference Models 707B and 708B Switching Matrix 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) The state of the synchronization line data The trigger line (1 to 3) Details...
Models 707B and 708B Switching Matrix Reference Manual Section 7: TSP command reference Example data = tsplink.readport() Reads state of all three TSP-Link lines. print(data) Assuming line 2 is set high, the output is: 2.000000e+00 (binary 010) The format of the output may vary depending on the ASCII precision setting.
Section 7: TSP command reference Models 707B and 708B Switching Matrix Reference Manual Details This function erases all information regarding other nodes connected on the TSP-Link system and regenerates the system configuration. This function must be called at least once before any remote nodes can be accessed.
Models 707B and 708B Switching Matrix Reference Manual Section 7: TSP command reference tsplink.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 tsplink.trigger[N].assert() The trigger line (1 to 3) Details The set pulse width determines how long the trigger is asserted.
Section 7: TSP command reference Models 707B and 708B Switching Matrix Reference Manual Example tsplink.trigger[2].clear() Clears trigger event on synchronization line 2. Also see tsplink.trigger[N].mode (on page 7-220) tsplink.trigger[N].overrun (on page 7-222) tsplink.trigger[N].release() (on page 7-223) tsplink.trigger[N].stimulus (on page 7-224) tsplink.trigger[N].wait() (on page 7-225) tsplink.trigger[N].EVENT_ID...
Page 452
Models 707B and 708B Switching Matrix Reference Manual Section 7: TSP command reference Details This attribute controls the mode in which the trigger event detector and the output trigger generator operate on the given trigger line. The setting for mode can be one of the following values: Mode Number Description...
Section 7: TSP command reference Models 707B and 708B Switching Matrix Reference Manual Also see digio.writebit() (on page 7-61) digio.writeport() (on page 7-62) tsplink.trigger[N].assert() (on page 7-219) tsplink.trigger[N].clear() (on page 7-219) tsplink.trigger[N].overrun (on page 7-222) tsplink.trigger[N].release() (on page 7-223) tsplink.trigger[N].reset() (on page 7-224) tsplink.trigger[N].stimulus (on page 7-224)
Models 707B and 708B Switching Matrix Reference Manual Section 7: TSP command reference tsplink.trigger[N].pulsewidth This attribute sets the length of time that the trigger line is asserted for output triggers. Type TSP-Link accessible Affected by Where saved Default value 10e-6 (10 µs) Attribute (RW) Reset Create configuration script...
Section 7: TSP command reference Models 707B and 708B Switching Matrix Reference Manual tsplink.trigger[N].reset() This function resets some of the TSP-Link trigger attributes to their factory defaults. Type TSP-Link accessible Affected by Where saved Default value Function Usage tsplink.trigger[N].reset() The trigger line (1 to 3) Details The tsplink.trigger[N].reset() function resets the following attributes to their factory defaults:...
Page 456
Models 707B and 708B Switching Matrix Reference Manual Section 7: TSP command reference Details To disable automatic trigger assertion on the synchronization line, set this attribute to zero (0). Do not use this attribute when triggering under script control. Use tsplink.trigger[N].assert() instead.
Section 7: TSP command reference Models 707B and 708B Switching Matrix Reference Manual Details This function waits up to the timeout value for an input trigger. If one or more trigger events were detected since the last time tsplink.trigger[N].wait() or tsplink.trigger[N].clear() was called, this function returns immediately.
Models 707B and 708B Switching Matrix Reference Manual Section 7: TSP command reference tsplink.writeport() This function writes to all TSP-Link synchronization lines. Type TSP-Link accessible Affected by Where saved Default value Function Usage tsplink.writeport(data) Value to write to the port (0 to 7) data Details The binary representation of data indicates the output pattern that is written to the I/O port.
Section 7: TSP command reference Models 707B and 708B Switching Matrix Reference Manual Example tsplink.writeprotect = 5 Write-protects TSP-Link trigger lines 1 and 3. Also see tsplink.readbit() (on page 7-216) tsplink.readport() (on page 7-216) tsplink.writebit() (on page 7-226) tsplink.writeport() (on page 7-227) tspnet.clear() This function clears any pending output data from the instrument.
Models 707B and 708B Switching Matrix Reference Manual Section 7: TSP command reference tspnet.connect() This function establishes a network connection with another LAN instrument or device through the LAN interface. Type TSP-Link accessible Affected by Where saved Default value Function Usage connectionID = tspnet.connect(ipAddress) connectionID = tspnet.connect(ipAddress, portNumber, initString)
Section 7: TSP command reference Models 707B and 708B Switching Matrix Reference Manual Example 2 instrumentID = tspnet.connect("192.0.2.1", 1394, "*rst\r\n") Connect to a device that is not TSP-enabled. if instrumentID then -- Use instrumentID as needed here tspnet.disconnect(instrumentID) Also see localnode.prompts (on page 7-123) localnode.showerrors...
Section 7: TSP command reference Models 707B and 708B Switching Matrix Reference Manual tspnet.idn() This function retrieves the response of the remote device to *IDN?. Type TSP-Link accessible Affected by Where saved Default value Function Usage idnString = tspnet.idn(connectionID) idnString The returned *IDN? string connectionID The connection ID returned from tspnet.connect()
Models 707B and 708B Switching Matrix Reference Manual Section 7: TSP command reference Details This command reads available data from the remote instrument and returns responses for the specified number of arguments. The format string can contain the following specifiers: %[width]s Read data until the specified length %[max width]t...
Section 7: TSP command reference Models 707B and 708B Switching Matrix Reference Manual Example ID = tspnet.connect("192.0.2.1") Send commands that will create data. tspnet.write(ID, "*idn?\r\n") Wait for data to be available. repeat bytes = tspnet.readavailable(ID) until bytes > 0 print(tspnet.read(ID)) tspnet.disconnect(ID) Also see tspnet.connect()
Models 707B and 708B Switching Matrix Reference Manual Section 7: TSP command reference Details This function sets and gets the termination character sequence that is used to indicate the end of a line for a TSP-Net connection. Using the termSequence parameter sets the termination sequence. The present termination sequence is always returned.
Section 7: TSP command reference Models 707B and 708B Switching Matrix 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)
Models 707B and 708B Switching Matrix Reference Manual Section 7: TSP command reference Details This setting determines if the instrument sends an abort message when it attempts to connect to a TSP-enabled instrument using the tspnet.connect() function. When you send the abort command on an interface, it causes any other active interface on that instrument to close.
Section 7: TSP command reference Models 707B and 708B Switching Matrix Reference Manual Example 2 times = Copy the specified timestamps table for items tspnet.tsp.rbtablecopy(testTspdevice, 1 through 3, then display the table. Example output: "testRemotebuffername.timestamps", 1, 3) 01/01/2011 print(times) 10:10:10.0000013,01/01/2011 10:10:10.0000233,01/01/2011 10:10:10.0000576 Also see...
Models 707B and 708B Switching Matrix Reference Manual Section 7: 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...
Section 7: TSP command reference Models 707B and 708B Switching Matrix Reference Manual Details This function associates the string value with the string name and stores this key-value pair in nonvolatile memory. Use the userstring.get() function to retrieve the value associated with the specified name. You can use the userstring functions to store custom, instrument-specific information in the instrument, such as department number, asset number, or manufacturing plant location.
Models 707B and 708B Switching Matrix Reference Manual Section 7: TSP command reference Example 2 for name in userstring.catalog() do Prints all userstring key-value pairs. print(name .. " = " .. Output: userstring.get(name)) product = Widgets assetnumber = 236 contact = John Doe The above output lists the user-defined strings added in the example for the userstring.add() function.
Section 7: TSP command reference Models 707B and 708B Switching Matrix Reference Manual 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 474
Models 707B and 708B Switching Matrix Reference Manual Section 7: TSP command reference Details This function will wait for all previously started overlapped commands to complete. Currently, the Models 707B and 708B have no overlapped commands implemented. However, other ® TSP-enabled products, such as the Series 2600A System SourceMeter Instruments, have overlapped commands.
Section 8 Troubleshooting guide In this section: Troubleshooting guide .............. 8-1 Error and status messages ............8-1 USB troubleshooting ..............8-2 Troubleshooting GPIB interfaces ..........8-5 Troubleshooting LAN interfaces ..........8-5 Testing the display, keys, and channel matrix ......8-9 Update drivers ................
Section 8: Troubleshooting guide Models 707B and 708B Switching Matrix Reference Manual Effects of errors on scripts Most errors will not abort a running script. The only time a script is aborted is when a Lua runtime error (error number –286) is detected. Runtime errors are caused by actions such as trying to index into a variable that is not a table.
Page 478
Models 707B and 708B Switching Matrix Reference Manual Section 8: Troubleshooting guide Figure 96: 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.
Page 479
Section 8: Troubleshooting guide Models 707B and 708B Switching Matrix Reference Manual Figure 97: Driver File Details dialog box 8. If the incorrect driver is installed, click OK. 9. On the Driver tab, click Update Driver. 10. Browse for the driver; select the C:\windows\inf folder. Locate the winusb.inf file. Select this and make sure the driver is now in use.
Models 707B and 708B Switching Matrix Reference Manual Section 8: Troubleshooting guide Troubleshooting GPIB interfaces Controller (hardware) not recognized If the hardware is not recognized by the computer: 1. Uninstall the software drivers. 2. Reboot the computer. 3. Check for newer drivers on the vendor’s website. Check that the drivers are valid for the operating system you have and any updates that might be necessary.
Section 8: Troubleshooting guide Models 707B and 708B Switching Matrix Reference Manual Verify connections and settings If you are unable to connect to the instrument's internal web page, check the following items: • Verify that the crossover cable is in the correct LAN port on the instrument. Do not connect to one of the TSP-Link ports.
Models 707B and 708B Switching Matrix Reference Manual Section 8: Troubleshooting guide Open ports on firewalls A firewall is a part of a computer system or network that is designed to block unauthorized access while permitting authorized communications. It is a device or set of devices that are configured to permit or deny applications based on a set of rules and other criteria.
Section 8: Troubleshooting guide Models 707B and 708B Switching Matrix Reference Manual LXI LAN status indicator Most LAN network interface cards have two LEDs, one that indicates LAN traffic and one that designates the LAN speed (10 MBits, 100 MBits, 1 GBits) through the color of the LED. LXI goes one level higher than this and states that all LXI compliant devices need a LAN status indicator.
Models 707B and 708B Switching Matrix Reference Manual Section 8: Troubleshooting guide 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.
Section 8: Troubleshooting guide Models 707B and 708B Switching Matrix Reference Manual Verify crosspoint display operation (707B only) You can verify that the LEDs and displays on the crosspoint display are working properly. To verify crosspoint display operation: 1. From the front panel, select MAIN MENU > DISPLAY > TEST > LED-PATTERNS. The text "ALPH NUMERIC COL LEDS"...
Page 486
Models 707B and 708B Switching Matrix Reference Manual Section 8: Troubleshooting guide Locating serial number or firmware revision 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. To display serial number or firmware revision on the front panel: 1.
Section 9 Frequently asked questions In this section: Frequently asked questions ............. 9-1 Frequently asked questions How do I get my LAN or web connection to work? For troubleshooting suggestions, see Troubleshooting LAN interfaces (on page 8-5). For more detailed information on remote interface connections, see Remote communications interfaces (on page 4-4).
Section 9: Frequently asked questions Models 707B and 708B Switching Matrix Reference Manual Figure 98: 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.
Models 707B and 708B Switching Matrix Reference Manual Section 9: Frequently asked questions How do I find the serial number and firmware version of the instrument? 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.
Section 10 Next steps In this section: Additional Models 707B and 708B information....... 10-1 Additional Models 707B and 708B information For additional information about the Model 707B or 708B, refer to: • The Product Information CD-ROM (ships with the product): Contains software tools, drivers, and product documentation •...
Appendix A Maintenance In this appendix: Maintenance ................A-1 Maintenance Upgrading firmware You can upgrade the instrument firmware from the web interface. To upgrade the firmware from the web interface: 1. From the left navigation area, select Unit. 2. Log in if necessary. 3.
Appendix A: Maintenance Models 707B and 708B Switching Matrix Reference Manual Check fan status You can check the status of the fan from the front panel of the Model 707B. In addition, if the fan is not operating on power up, the message "Failed to sense fan" is displayed. To check the fan status: 1.
Page 496
Models 707B and 708B Switching Matrix Reference Manual Appendix A: Maintenance Figure 99: 707B fuse location Figure 100: 708B fuse module location 707B-901-01 Rev. B / January 2015...
Appendix A: Maintenance Models 707B and 708B Switching Matrix Reference Manual Fixed rack installation The Model 707B ships with a fixed rack-mounting kit. The following table lists the included hardware for a fixed mounting of the Model 707B in a 48.26 cm wide × 60.96 cm tall × 76.20 cm deep (19 in. ×...
Page 498
Models 707B and 708B Switching Matrix Reference Manual Appendix A: Maintenance 2. As shown in the following figure, install two captive nuts (item C) on each front rack flange at holes 28.89 cm (11.38 in.) and 33.05 cm (13.13 in.) from the top of the selected space. Figure 101: Captive nut installation 3.
Page 499
Appendix A: Maintenance Models 707B and 708B Switching Matrix Reference Manual Chassis support preparation To prepare the chassis support for Model 707B or 708B installation: 1. Place a rear support bracket (item D) on the left chassis support (item A) and temporarily install the two pieces in the rack by sliding them apart until the flanged ends fit as shown in the following figure.
Page 500
Models 707B and 708B Switching Matrix Reference Manual Appendix A: Maintenance Chassis support mounting To mount the chassis support: 1. Reinstall the chassis support assemblies in the rack and secure them to the captive nuts with binder head screws. Also tighten the binder screws at the rear rack flange. 2.
Appendix B Using Models 707A and 708A compatibility mode In this appendix: Using Models 707A and 708A compatibility mode ....B-1 Using Models 707A and 708A compatibility mode Model A to Model B differences You can use a Model 707B or 708B in an existing Model 707A or 708A application. The units are compatible with the following exceptions: •...
Page 503
Appendix B: Using Models 707A and 708A compatibility mode Models 707B and 708B Switching Matrix Reference Manual Models 707B and 708B channel notation is different than on the Models 707A and 708A. For Models 707A and 708A, the slot number is built into the column number. For Models 707B and 708B, the slot number is the first number of the channel notation.
Models 707B and 708B Switching Matrix Reference Manual Appendix B: Using Models 707A and 708A compatibility mode Models 707A and 708A commands Models 707A and 708A commands Command Description Differences in Models 707B and 708B Edge for which an externally None.
Page 505
Appendix B: Using Models 707A and 708A compatibility mode Models 707B and 708B Switching Matrix Reference Manual Trigger source The trigger source 0/1 (GPIB Talk) is not available for the Models 707B and 708B. The factory default address for the Models 707B and 708B is 16.
Appendix C Status model In this appendix: Status model ................C-1 Status model Overview Each Keithley Instruments Models 707B and 708B 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.
Page 507
Appendix C: Status model Models 707B and 708B Switching Matrix Reference Manual An event is represented by a condition register bit changing from a 1 to 0 or 0 to 1. When an event occurs and the appropriate NTR or PTR bit is set, the corresponding event register bit is set to 1. The event bit remains latched to 1 until the event register is read or the status model is reset.
Models 707B and 708B Switching Matrix 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 509
Appendix C: Status model Models 707B and 708B Switching Matrix Reference Manual Status Byte Register overview Figure 105: Status Byte register 707B-901-01 Rev. B / January 2015...
Page 510
Models 707B and 708B Switching Matrix Reference Manual Appendix C: Status model 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. Since the Models 707B and 708B has no internal measurement capabilities, none of the bits in the measurement registers are defined.
Page 511
Appendix C: Status model Models 707B and 708B Switching Matrix Reference Manual Figure 106: System summary bit (System register) 707B-901-01 Rev. B / January 2015...
Page 512
Models 707B and 708B Switching Matrix Reference Manual Appendix C: Status model 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 513
Appendix C: Status model Models 707B and 708B Switching Matrix Reference Manual The following sequence outlines typical events associated with this queue: 1. When an error or status event occurs, a message defining the error (or status) is placed in the Error queue.
Page 514
Models 707B and 708B Switching Matrix Reference Manual Appendix C: Status model As shown above, there is only one register set associated with the questionable status. Attributes are summarized in status.questionable.* (on page 7-181). Keep in mind that bits can also be set by using numeric parameter values.
Page 515
Appendix C: Status model Models 707B and 708B Switching Matrix Reference Manual As shown above, there is only one register set associated with the event status register. Attributes are summarized in status.standard.* (on page 7-187). Keep in mind that bits can also be set by using numeric parameter values.
Page 516
Models 707B and 708B Switching Matrix Reference Manual Appendix C: Status model 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 109: Operation summary bit (Operation event register) The bits used in this register set are described as follows: •...
Page 517
Appendix C: Status model Models 707B and 708B Switching Matrix Reference Manual Figure 110: Operation user summary bit (Operation user register) The bits used in this register set are described as follows: • Bits B0-B14: status.operation.user.BIT0 through status.operation.user.BIT14 • Bits B15: Not used. C-12 707B-901-01 Rev.
Models 707B and 708B Switching Matrix 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...
Appendix C: Status model Models 707B and 708B Switching Matrix Reference Manual Startup state When the Switching Matrix is turned on, various register status elements are set as follows: • The power on (PON) bit in the status.operation.condition register is set. •...
Page 520
Models 707B and 708B Switching Matrix Reference Manual Appendix C: Status model When using a numeric parameter, registers are programmed by including the appropriate <mask> value. For example: *ese 1169 status.standard.enable = 1169 To convert from decimal to binary, use the information shown in the above figure. For example, to set bits B0, B4, B7, and B10, a decimal value of 1169 would be used for the mask parameter (1169 = 1 + 16 + 128 + 1024).
Appendix C: Status model Models 707B and 708B Switching Matrix Reference Manual Status byte and service request (SRQ) Service requests (SRQs) allow an instrument to indicate that it needs attention or that some event has occurred. When the controller receives an SRQ, it allows the controller to interrupt tasks to perform other tasks in order to address the request for service.
Page 522
Models 707B and 708B Switching Matrix Reference Manual Appendix C: Status model Figure 112: Status byte and service request (SRQ) 707B-901-01 Rev. B / January 2015 C-17...
Page 523
Appendix C: Status model Models 707B and 708B Switching Matrix Reference Manual 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 524
Models 707B and 708B Switching Matrix Reference Manual Appendix C: Status model Service requests Service requests (SRQs) affect both the GPIB and the VXI-11 connections. On a GPIB connection, the SRQ line is asserted. On a VXI-11 connection, an SRQ event is generated. 707B-901-01 Rev.
Page 525
Appendix C: Status model Models 707B and 708B Switching Matrix Reference Manual Status byte and service request commands The commands to program and read the Status Byte Register and Service Request Enable Register are listed in Status byte and service request commands (on page C-20).
Models 707B and 708B Switching Matrix Reference Manual Appendix C: Status model 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 527
Appendix C: Status model Models 707B and 708B Switching Matrix Reference Manual 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.S1THR 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 528
Models 707B and 708B Switching Matrix Reference Manual Appendix C: Status model TSP- Link status model c onfiguration exampl e Figure 113: TSP-Link status model configuration example 707B-901-01 Rev. B / January 2015 C-23...
Page 532
Models 707B and 708B Switching Matrix Reference Manual Index assign number • 6-46 RJ-45 master overview • 6-49 Ethernet connector • 2-4 nonvolatile memory run-time environment storage of scripts • 6-2 script, restoring • 6-42 storage of scripts • 6-2 operator precedence •...
Page 533
Index Models 707B and 708B Switching Matrix Reference Manual triggering modes, understanding • 3-17 warranty • 1-1 Test Script Builder • 6-31 web interface time • 7-165, 7-166 Home page • 2-66 trigger mode • 3-15, 3-19 access trigger mode • 3-15, 3-19 either edge •...
Page 534
Specifications are subject to change without notice. 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.keithley.com A G r eater Mea sur e of Confi denc e 8/14...
Need help?
Do you have a question about the Keithley 707B and is the answer not in the manual?
Questions and answers