Download Print this page
Tektronix KEITHLEY 708B Reference Manual
Tektronix KEITHLEY 708B Reference Manual

Tektronix KEITHLEY 708B Reference Manual

Switching system
Hide thumbs Also See for KEITHLEY 708B:

Advertisement

Quick Links

Models 707B and 708B
Switching System
REFERENCE MANUAL
*P 707B-901-01C*
707B-901-01C
January 2025

Advertisement

loading
Need help?

Need help?

Do you have a question about the KEITHLEY 708B and is the answer not in the manual?

Questions and answers

Summary of Contents for Tektronix KEITHLEY 708B

  • Page 1 Models 707B and 708B Switching System REFERENCE MANUAL *P 707B-901-01C* 707B-901-01C January 2025...
  • Page 2 Models 707B and 708B Switching System Reference Manual...
  • Page 3 © 2025, Keithley Instruments, LLC Cleveland, Ohio, U.S.A. All rights reserved. Any unauthorized reproduction, photocopy, or use of the information herein, in whole or in part, without the prior written approval of Keithley Instruments, LLC, is strictly prohibited. These are the original instructions in English. , TSP-Link , and TSP-Net are trademarks of Keithley Instruments, Inc.
  • Page 4: Safety Precautions

    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 personnel who recognize shock hazards and are familiar with the safety precautions required to avoid possible injury.
  • Page 5 For safety, instruments and accessories must be used in accordance with the operating instructions. If the instruments or 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. Maximum signal levels are defined in the specifications and operating information and shown on the instrument panels, test fixture panels, and switching cards.
  • Page 6: Table Of Contents

    Table of contents Introduction ....................... 1-1 Overview ..........................1-1 Models 707B and 708B applications ..................1-1 Extended warranty ....................... 1-2 Contact information ......................1-2 Product documentation, drivers, and software ..............1-2 Display the serial number..................... 1-3 Switch and scan ......................2-1 Work with channels ......................
  • Page 7 Table of contents Models 707B and 708B Switching System Reference Manual Connect cables ........................3-10 Digital I/O lines ........................3-10 +5 V output ..........................3-11 Control digital I/O lines ......................3-11 Digital I/O bit weighting ......................3-12 Remote operations ....................4-1 Remote communications interfaces ..................
  • Page 8 Models 707B and 708B Switching System Reference Manual Table of contents Scan Builder page ........................4-48 TSB Embedded ........................4-53 Admin page ..........................4-58 Unit page ..........................4-59 LXI page ..........................4-60 Send raw commands to an instrument ................4-62 VISA-C sample code .......................
  • Page 9 Table of contents Models 707B and 708B Switching System Reference Manual What is Lua? ........................... 6-14 Lua basics ..........................6-14 Standard libraries ........................6-28 Programming example: Script with a for loop ................6-32 Using Test Script Builder (TSB) ..................6-33 Install the TSB software ......................
  • Page 10 Models 707B and 708B Switching System Reference Manual Table of contents bit.set() ............................ 7-13 bit.setfield()..........................7-14 bit.test() ........................... 7-15 bit.toggle() ..........................7-16 channel.clearforbidden() ......................7-17 channel.close() ........................7-18 channel.connectrule ........................ 7-19 channel.connectsequential ...................... 7-21 channel.createspecifier() ......................7-22 channel.exclusiveclose() ......................7-23 channel.exclusiveslotclose()....................
  • Page 11 Table of contents Models 707B and 708B Switching System Reference Manual display.loadmenu.catalog() ..................... 7-76 display.loadmenu.delete() ....................... 7-77 display.locallockout ......................... 7-78 display.menu() ......................... 7-78 display.prompt() ........................7-79 display.screen ......................... 7-81 display.sendkey() ........................7-82 display.setcursor() ........................7-83 display.settext() ........................7-84 display.trigger.EVENT_ID ....................... 7-85 display.waitkey() ........................
  • Page 12 Models 707B and 708B Switching System Reference Manual Table of contents lan.trigger[N].protocol ......................7-122 lan.trigger[N].pseudostate ..................... 7-123 lan.trigger[N].stimulus ......................7-123 lan.trigger[N].wait() ........................ 7-125 localnode.define.* ........................7-125 localnode.description ......................7-126 localnode.license ........................7-127 localnode.model ........................7-128 localnode.password ......................7-128 localnode.prompts ......................... 7-129 localnode.prompts4882 ......................
  • Page 13 Table of contents Models 707B and 708B Switching System Reference Manual slot[slot].idn ........................... 7-171 slot[slot].poles.four ........................ 7-172 slot[slot].poles.one ........................ 7-173 slot[slot].poles.two ......................... 7-173 slot[slot].pseudocard ......................7-174 status.condition ........................7-175 status.node_enable ....................... 7-177 status.node_event ......................... 7-179 status.operation.* ........................7-181 status.operation.user.* ......................7-183 status.questionable.* ......................
  • Page 14 Models 707B and 708B Switching System Reference Manual Table of contents tsplink.writeprotect ........................ 7-237 tspnet.clear() ......................... 7-238 tspnet.connect() ........................7-239 tspnet.disconnect() ........................ 7-240 tspnet.execute() ........................7-241 tspnet.idn() ..........................7-242 tspnet.read() .......................... 7-243 tspnet.readavailable() ......................7-244 tspnet.reset() ......................... 7-244 tspnet.termination() ....................... 7-245 tspnet.timeout ........................
  • Page 15 Table of contents Models 707B and 708B Switching System Reference Manual Program code .......................... 9-16 Program code to run the test ....................9-19 Use background scans for longer scan lists ................9-20 Work with the Series 2400 ..................10-1 About the Series 2400 examples ..................10-1 Equipment required to run the examples ................
  • Page 16 Models 707B and 708B Switching System Reference Manual Table of contents Status model ......................12-1 Overview ..........................12-1 Status register set contents ....................12-1 Summary bit ........................12-2 Queues ..........................12-2 Output queue .......................... 12-3 Status model diagrams ...................... 12-3 Status Byte Register diagram....................
  • Page 17 Table of contents Models 707B and 708B Switching System Reference Manual Set relay setup data format ..................... 13-6 GPIB EOI hold off control ......................13-7 Service request configuration ....................13-7 Digital I/O control ........................13-7 Additional channel settling time ....................13-8 Retrieve card settling time .......................
  • Page 18: In This Section

    Section 1 Introduction In this section: Overview .................. 1-1 Models 707B and 708B applications ........1-1 Extended warranty ..............1-2 Contact information ..............1-2 Product documentation, drivers, and software ......1-2 Display the serial number ............1-3 Overview The six-slot 707B and single-slot 708B Semiconductor Switch Matrix Mainframes are optimized for semiconductor test applications.
  • Page 19: Extended Warranty

    Contact information If you have any questions after you review the information in this documentation, please contact your local Tektronix office, sales partner, or distributor. You can also call the Tektronix corporate headquarters (toll-free inside the U.S. and Canada only) at 1-800-833-9200.
  • Page 20: Display The Serial Number

    Models 707B and 708B Switching System Reference Manual Section 1: Introduction Additional drivers and software are available for download from the Product and Downloads Support web page, including: • Keithley Test Script Builder (TSB): A software tool that simplifies building and creating test scripts.
  • Page 21: Switch And Scan

    Section 2 Switch and scan In this section: Work with channels ..............2-1 Reset a channel ..............2-19 Pseudocards ................2-20 Scan and trigger ..............2-21 Work with channels The 707B and 708B have specific settings that open and close channels. It also contains information about pseudocards.
  • Page 22: Channel Types

    Section 2: Switch and scan Models 707B and 708B Switching System Reference Manual Channel types The Models 707B and 708B support matrix cards with matrix channels. The documentation for your matrix card lists the available channel types. Matrix card channel specifiers The channels on the matrix cards are referred to by their slot, bank, row, and column numbers: •...
  • Page 23: Connection Methods For Close Operations

    Models 707B and 708B Switching System Reference Manual Section 2: Switch and scan Examples: • To perform an open or close operation on row 1 and columns 3 and 5 of slot 1, use ("1A03, 1A05") for the channelList parameter. •...
  • Page 24 Section 2: Switch and scan Models 707B and 708B Switching System Reference Manual Hot switching can dry weld reed relays such that they will always be on. Hot switching is recommended only when external protection is provided. The channel connect rule determines the order in which multiple channels are opened and closed on the instrument.
  • Page 25: Set Up A Sequential Connection

    Models 707B and 708B Switching System Reference Manual Section 2: Switch and scan Set up a sequential connection During normal operation, the instrument attempts to minimize the duration of any channel action for the card type and connect rule. This can result in multiple channels closing or opening simultaneously.
  • Page 26: Determine The Number Of Relay Closures

    Section 2: Switch and scan Models 707B and 708B Switching System Reference Manual To enable sequential connections through the remote command interface: Send the command: channel.connectsequential = channel.ON Refer to channel.connectsequential (on page 7-21) for detail. Determine the number of relay closures The 707B and 708B keeps an internal count of the number of times each switch card relay has been closed.
  • Page 27: Identify Installed Switching Cards

    Models 707B and 708B Switching System Reference Manual Section 2: Switch and scan To view the close count for a channel from the web interface: 1. From the list on the left, select a slot with an installed card. 2. Right-click a channel. The Channel Configuration dialog is displayed. 3.
  • Page 28: Close And Open Channels

    Section 2: Switch and scan Models 707B and 708B Switching System Reference Manual Close and open channels If you have switching channels, you can close and open the relay channels using the front panel, web interface, or remote commands. You can use scans to perform a user-specified sequence of close and open operations on multiple channels.
  • Page 29 Models 707B and 708B Switching System Reference Manual Section 2: Switch and scan Open and close channels from the Channel Action Menu You can use the options in the Channel Action Menu to open and close channels from the front panel. To use the Channel Action Menu to open and close channels: 1.
  • Page 30: View The Close Or Open Status Of A Channel

    Section 2: Switch and scan Models 707B and 708B Switching System Reference Manual Figure 1: Close a channel 4. To open a closed channel, select it again. 5. To perform an exclusive close on a channel: a. Select Exclusive Slot Close in Channel Action Type. Figure 2: Select exclusive slot close b.
  • Page 31: Channel Attributes

    Models 707B and 708B Switching System Reference Manual Section 2: Switch and scan View 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 is displayed, you can press DISPLAY to display the full list. Use the navigation wheel to scroll through the list.
  • Page 32 Section 2: Switch and scan Models 707B and 708B Switching System Reference Manual Set additional delay You can set an additional delay to incur after the relay settles when closing. The total delay for channel operation is the user delay plus the relay settling time. To set additional delay time from the front panel: 1.
  • Page 33 Models 707B and 708B Switching System Reference Manual Section 2: Switch and scan To forbid closing of a channel from the web interface: 1. From the list on the left, select the slot that contains the channel. 2. Right-click the channel. 3.
  • Page 34: Channel Patterns

    Section 2: Switch and scan Models 707B and 708B Switching System Reference Manual To set up labels from the web interface: 1. From the list on the left, select the slot that contains the channel. 2. Right-click the channel. 3. In Label, enter the label. 4.
  • Page 35 Models 707B and 708B Switching System Reference Manual Section 2: Switch and scan When you create a channel pattern, make sure to: • Include all of the channels that are needed for that channel pattern. • Check that channels contained in the pattern are correct. •...
  • Page 36 Section 2: Switch and scan Models 707B and 708B Switching System Reference Manual Figure 3: Channel pattern configuration dialog 3. In Channel Pattern, enter a name. 4. From the Channels Available list, select the channels you want to add. You can use Ctrl+click and Shift+click to select multiple channels.
  • Page 37 Models 707B and 708B Switching System Reference Manual Section 2: Switch and scan Perform close and open operations on channel patterns Careless channel pattern operation could create an electric shock hazard that could result in severe injury or death. Improper operation can also cause damage to the matrix cards and external circuitry.
  • Page 38 Section 2: Switch and scan Models 707B and 708B Switching System Reference Manual To close or open the channels in a channel pattern from the web interface: 1. From the list on the left, select a slot with an installed card. 2.
  • Page 39: Reset A Channel

    Models 707B and 708B Switching System Reference Manual Section 2: Switch and scan 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. ▪...
  • Page 40: Pseudocards

    Section 2: Switch and scan Models 707B and 708B Switching System Reference Manual To reset all channels on a slot from the web interface: 1. Select the slot that contains channels you want to reset. 2. Click RESET SLOT. 3. All channels on the slot are reset. To reset a channel from the remote interface: Send the command channel.reset()
  • Page 41: Scan And Trigger

    Models 707B and 708B Switching System Reference Manual Section 2: Switch and scan Scan and trigger A scan is a series of steps that opens and closes switches sequentially for a selected group of channels. During each step, actions occur, such as waiting for a trigger, making a measurement, and completing a step count.
  • Page 42 Section 2: Switch and scan Models 707B and 708B Switching System Reference Manual Figure 5: Models 707B and 708B triggering overview 2-22 707B-901-01 Rev. C January 2025...
  • Page 43: Trigger Model Components

    Models 707B and 708B Switching System Reference Manual Section 2: Switch and scan 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).
  • Page 44 Section 2: Switch and scan Models 707B and 708B Switching System Reference Manual Scan count complete The scan can be set to repeat. If the scan count is not complete, the instrument loops back to wait for the scan start trigger. Idle After the instrument has completed the scan list the requested number of times, the instrument generates the Idle Event.
  • Page 45: Scan And Step Counts

    Models 707B and 708B Switching System Reference Manual Section 2: Switch and scan Scan and step counts When running a scan, it may be necessary to determine the scan progress. You can use scan.state() to read the scan and step count. The scan count is the number of the present iteration through the scan portion of the trigger model.
  • Page 46: Basic Scan Procedure

    Section 2: Switch and scan Models 707B and 708B Switching System Reference Manual 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.
  • Page 47 Models 707B and 708B Switching System Reference Manual Section 2: Switch and scan If a scan is aborted, channels remain in the open or closed they were in when the abort occurred. If configured to scan the channels in the scan list again, the Model 707B or 708B waits at the control source for another trigger event.
  • Page 48: Foreground And Background Scan Execution

    Section 2: Switch and scan Models 707B and 708B Switching System Reference Manual Front-panel scan options After channels are added to the scan list, press the SCAN key to display the SCAN ACTION MENU. If no scan list exists, pressing the SCAN key causes the instrument to briefly display No Scan List.
  • Page 49: Scan And Trigger Commands

    Models 707B and 708B Switching System Reference Manual Section 2: Switch and scan Include multiple channels in a single scan step Through the remote control interface, you can use scan.addimagestep to combine a list of channels into a scan step. The following example creates five scan steps with the indicated channels.
  • Page 50: Remote Scan Examples

    Section 2: Switch and scan Models 707B and 708B Switching System Reference Manual • scan.mode (on page 7-151) • scan.reset() (on page 7-152) • scan.scancount (on page 7-153) • scan.state() (on page 7-154) • scan.stepcount (on page 7-155) • scan.trigger.arm.clear() (on page 7-155) •...
  • Page 51 Models 707B and 708B Switching System Reference Manual Section 2: Switch and scan The following table illustrates how scan count works with this scan list to determine the total number of channel closures during a scan. Number of steps Scan count value Total number of step channel closures 3 (each step channel once –...
  • Page 52 Section 2: Switch and scan Models 707B and 708B Switching System Reference Manual On the TSB Embedded page, select Save Script to save the script. For example, name the script ScanExample. In the User Scripts list, select ScanExample. Select Run. The output of the script is shown in the following table.
  • Page 53: Hardware Trigger Modes

    Models 707B and 708B Switching System Reference Manual Section 2: Switch and scan Hardware trigger modes Use the hardware trigger modes to integrate Keithley and non-Keithley instruments into an efficient test system. The hardware synchronization lines are classic trigger lines. The Model 707B or 708B contains 14 digital I/O lines and 3 TSP-Link synchronization lines that you can use for input or output triggering.
  • Page 54: Falling Edge Trigger Mode

    Section 2: Switch and scan Models 707B and 708B Switching System Reference Manual Falling edge trigger mode The falling edge trigger mode generates low pulses and detects all falling edges. The following figure shows the characteristics of the falling edge input trigger. It detects all falling edges as input triggers.
  • Page 55: Rising Edge Acceptor Trigger Mode

    Models 707B and 708B Switching System Reference Manual Section 2: Switch and scan Figure 8: Rising edge master trigger mode output trigger Rising edge acceptor trigger mode The rising edge acceptor trigger mode (RisingA) generates a low pulse and detects rising edge pulses.
  • Page 56: Either Edge Trigger Mode

    Section 2: Switch and scan Models 707B and 708B Switching System Reference Manual Either edge trigger mode The either edge trigger mode generates a low pulse and detects both rising and falling edges. The following figure shows the either edge trigger mode input trigger. All rising or falling edges generate an input trigger event.
  • Page 57 Models 707B and 708B Switching System Reference Manual Section 2: Switch and scan Synchronous master trigger mode Use the synchronous master trigger mode to generate falling edge output triggers, to detect the rising edge input triggers, and to initiate an action on one or more external nodes with the same trigger line.
  • Page 58 Section 2: Switch and scan Models 707B and 708B Switching System Reference Manual The following figure shows the output trigger. When the trigger is asserted, it generates a low pulse that is similar to the falling edge trigger mode. Figure 14: Synchronous master trigger mode output trigger Synchronous acceptor trigger mode Use the synchronous acceptor trigger mode (SynchronousA) on a trigger subordinate that operates with a trigger master configured for the SynchronousM trigger mode.
  • Page 59: Synchronous Trigger Mode

    Models 707B and 708B Switching System Reference Manual Section 2: Switch and scan Synchronous trigger mode The synchronous trigger mode is a combination of the SynchronousA and SynchronousM trigger modes. The following figure shows the synchronous trigger mode input trigger. The falling edge generates an input event and latches the internal drive low.
  • Page 60: Events

    Section 2: Switch and scan Models 707B and 708B Switching System Reference Manual Events Event detectors monitor an event. They have one input signal (the stimulus), which is the event that they monitor (in some cases, the stimulus is an action in the system, like a timer expiring or a key press).
  • Page 61: In This Section

    Section 3 Theory of operation In this section: Overview .................. 3-1 Mainframe ................3-2 Front panel ................3-6 Digital I/O port ................3-9 Overview The 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 62: Mainframe

    Section 3: Theory of operation Models 707B and 708B Switching System Reference Manual Mainframe Figure 21: Model 707B 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 63 Models 707B and 708B Switching System Reference Manual Section 3: Theory of operation It is important that you consider the following factors in your system design and use: • The international safety standard IEC 61010-1 defines voltages as hazardous if they exceed 30 V and 42.4 V or 60 VDC for equipment rated for dry locations.
  • Page 64: Instrument Fan (Model 707B Only)

    Section 3: Theory of operation Models 707B and 708B Switching System Reference Manual Instrument fan (Model 707B only) The Model 707B includes an internal fan that operates continuously when power is applied to the mainframe. The fan keeps the internal power supply and other electronics cool during operation.
  • Page 65: Backplane

    Models 707B and 708B Switching System Reference Manual Section 3: Theory of operation Backplane The Model 707B or 708B backplane is the interface between the installed relay cards and the instrument. The relay card interfaces with the backplane through a communications and power connector and possibly a separate connector for signal routing.
  • Page 66: Front Panel

    Section 3: Theory of operation Models 707B and 708B Switching System Reference Manual Front panel The front panel of the Keithley Model 707B or 708B contains: • The display • The crosspoint display (Model 707B only) • The keys and navigation wheel •...
  • Page 67 Models 707B and 708B Switching System Reference Manual Section 3: Theory of operation Figure 23: Model 707B crosspoint display block diagram Description of the crosspoint display components The front panel of the Model 707B has two main display components, the vacuum fluorescent display (VFD) and a 12×12 LED matrix display.
  • Page 68 Section 3: Theory of operation Models 707B and 708B Switching System Reference Manual 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.
  • Page 69: Digital I/O Port

    Models 707B and 708B Switching System Reference Manual Section 3: Theory of operation Slot indicators The slot LEDs are treated the same as the matrix LEDs, as additional 13th and 14th columns. 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.
  • Page 70: Connect Cables

    Section 3: Theory of operation Models 707B and 708B Switching System Reference Manual Figure 25: Models 707B and 708B digital I/O ports Description Digital I/O #1 Digital I/O #14 15 to 21 Ground +5 VDC, limited to 600 mA, solid-state fuse protected Not connected;...
  • Page 71: +5 V Output

    Models 707B and 708B Switching System Reference Manual Section 3: Theory of operation +5 V output The digital I/O port provides three +5 VDC output lines that you can use to drive external logic circuitry. The maximum combined current output for all lines is 250 mA. These lines are protected by a self-resetting fuse with a one-hour recovery time.
  • Page 72 Section 3: Theory of operation Models 707B and 708B Switching System Reference Manual To remove write protection, reset the decimal value to include only the lines that you want to write protect. To remove write protection from all lines, set the value to 0. Digital I/O bit weighting Bit weighting for the digital I/O lines is shown in the following table.
  • Page 73: Remote Operations

    Section 4 Remote operations In this section: Remote communications interfaces ......... 4-1 LAN communications ............... 4-2 GPIB setup ................4-23 USB communications ............. 4-28 Software components for applications and instrument drivers 4-36 Keithley I/O layer ..............4-37 Address instruments with VISA ..........4-38 Address instruments through the LAN ........
  • Page 74: Lan Communications

    Section 4: Remote operations Models 707B and 708B Switching System Reference Manual LAN communications When you connect using a LAN, you can use a web browser to communicate with the instrument through the internal web page of the instrument and other web apps. 707B and 708B are class C LXI compliant.
  • Page 75: Configure The Network Interface Card To Obtain An Ip Address Automatically

    Models 707B and 708B Switching System Reference Manual Section 4: Remote operations Figure 26: Model 707B rear-panel LAN connection Figure 27: Model 708B rear-panel LAN connection Configure the network interface card to obtain an IP address automatically Do not change your IP address without consulting your system administrator. Entering an incorrect IP address can prevent your computer from connecting to your corporate network.
  • Page 76: Identify And Record The Existing Ip Configuration

    Section 4: Remote operations Models 707B and 708B Switching System Reference Manual Identify and record the existing IP configuration You are responsible for returning settings to their original configuration before reconnecting the computer to a corporate network. Failure to do this could result in damage to your equipment or loss of data.
  • Page 77: Configure The Instrument To Obtain An Ip Address Automatically

    Models 707B and 708B Switching System Reference Manual Section 4: Remote operations Configure the instrument to obtain an IP address automatically 1. From the front panel of the instrument, press the MENU key. 2. Use the navigation wheel to select LAN > CONFIG > METHOD. Press the navigation wheel to display the METHOD menu.
  • Page 78 Section 4: Remote operations Models 707B and 708B Switching System Reference Manual • 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 79 Models 707B and 708B Switching System Reference Manual Section 4: Remote operations The dead socket termination port for Model 707B or 708B is 5030. When the instrument is connected to this port, when it is disconnected, the dead port is released. VXI-11 VXI-11 is a LAN protocol that emulates GPIB over ethernet.
  • Page 80: One-To-One Connection

    Section 4: Remote operations Models 707B and 708B Switching System Reference Manual One-to-one connection With most instruments, a one-to-one connection is done only when you are connecting a single instrument to a single network interface card. A one-to-one connection using a network crossover cable connection is similar to a typical RS-232 system using a null modem cable.
  • Page 81 Models 707B and 708B Switching System Reference Manual Section 4: Remote operations Figure 29: One-to-many connection using a network hub or switch Two network card connection If you need to connect independent corporate and instrumentation networks, two network interface cards are required in the computer controller. Though the two networks are independent, stations on the corporate network can access the instruments and the instruments can access the corporate network using the same computer.
  • Page 82 Section 4: Remote operations Models 707B and 708B Switching System 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.
  • Page 83 Models 707B and 708B Switching System Reference Manual Section 4: Remote operations To set up the network: 1. Create IP addresses for the three hosts (the network interface card and two instruments) on the network. This is a Class C network, so the subnet mask is 255.255.255.0. From the table in IPv4 address syntax and subnets (on page 4-14), note that the first three...
  • Page 84 Section 4: Remote operations Models 707B and 708B Switching System Reference Manual To set the IP address: 1. From the front panel, press the MENU key. 2. Use the navigation wheel to select LAN > CONFIG > METHOD. Press the navigation wheel to display the METHOD menu.
  • Page 85: Ipv4 Addressing

    Models 707B and 708B Switching System Reference Manual Section 4: Remote operations When connecting to a corporate network, the network administrator MUST provide all of the network settings for the LAN instrument. Failure to use settings provided by the network administrator could result in failures at other locations on the corporate network.
  • Page 86 Section 4: Remote operations Models 707B and 708B Switching System Reference Manual Static or fixed IP address Static IP addressing means that the person setting up and configuring the network has assigned a fixed, unique IP address to each network device. This requires enforcement to make sure everyone has a unique IP address, but it guarantees that the address will not change.
  • Page 87 Models 707B and 708B Switching System Reference Manual Section 4: Remote operations The Domain Name System (DNS) is a protocol that provides a way to associate a user- friendly name to an IP address. For example, while few people know the IP address of the Google website, most people know www.google.com.
  • Page 88: Configure Lan Settings Through The Front Panel

    Section 4: Remote operations Models 707B and 708B Switching System Reference Manual 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 89: Raw Socket Connection

    Models 707B and 708B Switching System Reference Manual Section 4: Remote operations To enable or disable a telnet connection: 1. From the front panel, press the MENU key, and then select LAN > ENABLE > TELNET. 2. Select either ON or OFF. After the power cycle reminder, you return to the LAN CONFIG menu.
  • Page 90: Check The Lan Network Settings

    Section 4: Remote operations Models 707B and 708B Switching System Reference Manual Check the LAN network settings You can check the network settings for the instrument without making changes. To check the network settings: 1. From the instrument front panel, select MENU > LAN > STATUS. 2.
  • Page 91: Set Up Instrument For Manual Lan Configuration

    Models 707B and 708B Switching System Reference Manual Section 4: Remote operations Both the host computer and the instrument should be set to use automatic LAN configuration. Though it is possible to have one set to manual configuration, it is more complicated to set up.
  • Page 92: Change Dns Settings

    Section 4: Remote operations Models 707B and 708B Switching System Reference Manual 5. If you are: ▪ Connecting directly to a host computer, refer to the recorded IP address of the computer. Set the IP address to match the IP address of the host computer. Change the last three numbers (after the last decimal point) to a number that is unique on the LAN.
  • Page 93: Change The Ip Configuration Through The Web Interface

    Models 707B and 708B Switching System Reference Manual Section 4: Remote operations To change DNS settings: 1. From the front panel, press the MENU key, and then select LAN > CONFIG > DNS > VERIFY. 2. Select either ENABLE or DISABLE. You return to the DNS menu. 3.
  • Page 94 Section 4: Remote operations Models 707B and 708B Switching System Reference Manual To change the IP configuration using the instrument web page: 1. Access the internal web page of the instrument (see Using the web interface (on page 4-39)). 2. From the navigation bar on the left, in the LXI Home menu, select IP Config. 3.
  • Page 95: Gpib Setup

    Models 707B and 708B Switching System Reference Manual Section 4: Remote operations GPIB setup This section contains information about GPIB standards, connections, and address selection. GPIB standards The GPIB is the IEEE-488 instrumentation data bus, which uses hardware and programming standards originally adopted by the Institute of Electrical and Electronic Engineers (IEEE) in 1975.
  • Page 96 Section 4: Remote operations Models 707B and 708B Switching System Reference Manual To allow many parallel connections to one instrument, stack the connectors. Each connector has two screws on it to ensure that connections remain secure. The following figure shows a typical connection diagram for a test system with multiple instruments.
  • Page 97 Models 707B and 708B Switching System Reference Manual Section 4: Remote operations Figure 35: Model 707B rear-panel IEEE-488 connection Figure 36: Model 708B rear-panel IEEE-488 connection 707B-901-01 Rev. C January 2025 4-25...
  • Page 98: Set The Gpib Address

    Section 4: Remote operations Models 707B and 708B Switching System Reference Manual 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 have up to 15 devices connected to a GPIB interface, including the controller.
  • Page 99: Communicate With Instruments

    Models 707B and 708B Switching System Reference Manual Section 4: Remote operations Communicate with instruments The GPIB driver software you installed installs an interactive dumb terminal program that allows you to send commands to the instrument. They directly call the GPIB driver support libraries.
  • Page 100: Terminator

    Section 4: Remote operations Models 707B and 708B Switching System Reference Manual Terminator When receiving data over the GPIB, the instrument terminates messages on any line feed character or any data byte with EOI asserted (line feed with EOI asserted is also valid). When sending data, it appends a line feed character to all outgoing messages.
  • Page 101: Connect The Usb Cable

    Models 707B and 708B Switching System Reference Manual Section 4: Remote operations Connect the USB cable To communicate from a computer to the instrument, you need a USB cable with a USB Type B connector end and a USB Type A connector end. You need a separate USB cable for each instrument you plan to connect to the computer at the same time using the USB interface.
  • Page 102: Communicate With The Instrument

    Section 4: Remote operations Models 707B and 708B Switching System Reference Manual 3. Turn on instrument power. When the computer detects the new USB connection, the Found New Hardware Wizard starts. 4. If the “Can Windows connect to Windows Update to search for software?” dialog opens, select No, and then select Next.
  • Page 103 Models 707B and 708B Switching System Reference Manual Section 4: Remote operations Figure 39: Select Operation dialog 3. Select Next. The Select Communication Bus dialog is displayed. Figure 40: Select Communication Bus dialog 4. Select USB. 5. Select Next. The Select Instrument Driver dialog is displayed. 707B-901-01 Rev.
  • Page 104 Section 4: Remote operations Models 707B and 708B Switching System Reference Manual Figure 41: Select Instrument Driver dialog 6. Select Auto-detect Instrument Driver - Model. 7. Select Next. The Configure USB Instrument dialog is displayed with the detected instrument VISA resource string highlighted. Figure 42: Configure USB Instrument dialog 4-32 707B-901-01 Rev.
  • Page 105 Models 707B and 708B Switching System Reference Manual Section 4: Remote operations 8. Select Next. The Name Virtual Instrument dialog is displayed. Figure 43: Name Virtual Instrument dialog 9. For Virtual Instrument Name, enter a name that you want to use to refer to the instrument.
  • Page 106: Additional Usb Information

    Section 4: Remote operations Models 707B and 708B Switching System Reference Manual 14. Select OK. 15. Send a command to the instrument and see if it responds. Figure 45: 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.
  • Page 107 Models 707B and 708B Switching System Reference Manual Section 4: Remote operations Connect 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 108: Software Components For Applications And Instrument Drivers

    Section 4: Remote operations Models 707B and 708B Switching System Reference Manual Software components for applications and instrument drivers The majority of software applications and all instrument drivers from Keithley depend on the following software components: • NI-VISA • VISA shared components •...
  • Page 109: Ivi Shared Components

    Models 707B and 708B Switching System Reference Manual Section 4: Remote operations IVI shared components The IVI shared components are similar in concept to the VISA shared components. The IVI Foundation provides class drivers for: • All the supported instruments (DMM, Scope, Fgen, and so on) •...
  • Page 110: Ni-Visa Runtime

    Section 4: Remote operations Models 707B and 708B Switching System Reference Manual NI-VISA Runtime NI-VISA is the NI implementation of the VISA standard. The Keithley I/O Layer contains a licensed version of the NI-VISA Runtime Engine that contains only the binary files (DLLs) that allow the NI-VISA drivers to operate.
  • Page 111: Address Instruments Through The Lan

    Models 707B and 708B Switching System Reference Manual Section 4: Remote operations Address 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. 707B and 708B supports this protocol.
  • Page 112: Connect To The Instrument Web Interface

    Section 4: Remote operations Models 707B and 708B Switching System Reference Manual Connect to the instrument web interface To connect to the instrument web interface, you must have an LAN connection from the computer to the instrument. The web interface requires the web browser plug-in Sun Java Runtime Environment Version 6 or higher.
  • Page 113: Web Interface Home Page

    Models 707B and 708B Switching System Reference Manual Section 4: Remote operations Web interface home page The home page of the web interface gives you basic information about the instrument, including: • The instrument model, serial number, firmware revision, and LXI information •...
  • Page 114: Card Pages

    Section 4: Remote operations Models 707B and 708B Switching System Reference Manual Figure 47: Enter password 3. Select Login. The default password is admin. If the password has been changed, it is available from the front panel of the instrument. Press MENU > LAN > STATUS > PASSWORD. Card pages The card pages are interactive pages where you can work with channels in each slot.
  • Page 115 Models 707B and 708B Switching System Reference Manual Section 4: Remote operations Open and close slots from the card pages You can open and close channels from the card pages in several ways. The simplest method is to select a connection. The channel changes state to open or closed.
  • Page 116 Section 4: Remote operations Models 707B and 708B Switching System Reference Manual Exercise: Close multiple channels using the web interface This exercise describes how to close channels and channel patterns using the web interface. To close multiple channels using the web interface: 1.
  • Page 117 Models 707B and 708B Switching System Reference Manual Section 4: Remote operations 6. To perform an exclusive close on channel 1A02, select Exclusive Slot Close in the Channel Action Type box. Figure 55: Select exclusive slot close 7. Select 1A02 to close that channel and open all other channels. Figure 56: Close a channel with exclusive close Configure channels from the web interface To configure channels from the web interface, right-click the channel.
  • Page 118: Set Up Channel Patterns From The Web Interface

    Section 4: Remote operations Models 707B and 708B Switching System Reference Manual In this dialog, you can set: • Label: The label for the channel. This is the same as the command channel.setlabel(). • Forbidden: Select to set the channel to forbidden. This prevents the channel from being closed from any interface.
  • Page 119 Models 707B and 708B Switching System Reference Manual Section 4: Remote operations Figure 58: Channel pattern configuration dialog Exercise: Close channels in "Test1Pattern" from the web interface To close channels in channel pattern "Test1Pattern" from the web interface: 1. Select Pattern (above Channel Action Type). The Channel Pattern Configuration dialog is displayed.
  • Page 120: Scan Builder Page

    Section 4: Remote operations Models 707B and 708B Switching System Reference Manual To delete a channel pattern from the web interface: 1. Select the name of the pattern that you want to delete in the Channel Pattern Configuration dialog. 2. Select Delete. 3.
  • Page 121: Create A Scan List

    Models 707B and 708B Switching System Reference Manual Section 4: Remote operations 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 a specific order during a scan. Each step contains a channel, channels, or channel patterns that you want to measure in that step.
  • Page 122: Clear The Scan List From The Web Interface

    Section 4: Remote operations Models 707B and 708B Switching System Reference Manual Clear the scan list from the web interface Clearing the scan list deletes all channels and channel patterns from the scan list. To clear the scan list from the web interface: 1.
  • Page 123: Stop The Scan

    Models 707B and 708B Switching System Reference Manual Section 4: Remote operations Stop the scan To stop the scan from the web interface: On the Build & Run tab, select Abort. Monitor the state of the scan To monitor the state of the scan, you can select Query State on the Build & Run tab. Query State displays the present state of the scan, which can be: •...
  • Page 124: Advanced Triggering

    Section 4: Remote operations Models 707B and 708B Switching System Reference Manual Channel action trigger You can select the trigger to continue channel action for each scan. The options to continue channel action are: Immediate: When immediate is selected, the scan immediately steps to the next channel in the scan list.
  • Page 125: Tsb Embedded

    Models 707B and 708B Switching System Reference Manual Section 4: Remote operations 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 126 Section 4: Remote operations Models 707B and 708B Switching System Reference Manual Script management options Existing scripts are listed in the User Scripts box on the left side of TSB Embedded. Script management options are: • Run a script: Select the name of the script and then select Run. •...
  • Page 127: Create A Script Using Tsb Embedded

    Models 707B and 708B Switching System Reference Manual Section 4: Remote operations Create a script using TSB Embedded If you are using TSB Embedded to create scripts, you do not need to use the commands loadscript or loadandrunscript and endscript. You can create a script from the instrument web interface with TSB Embedded.
  • Page 128 Section 4: Remote operations Models 707B and 708B Switching System Reference Manual 2. You must log in to the instrument to use TSB Embedded. After logging in, you can access the options on the TSB Embedded page. 3. To create the example script, enter the name, column_and_row_labels, in the TSP Script box.
  • Page 129 Models 707B and 708B Switching System Reference Manual Section 4: Remote operations Figure 63: Script added to User Scripts list 6. To run the script, select the script in the User Scripts list and select Run. 7. The Instrument Output box displays any error messages and output from the script. Script management options Existing scripts are listed in the User Scripts box on the left side of TSB Embedded.
  • Page 130: Admin Page

    Section 4: Remote operations Models 707B and 708B Switching System Reference Manual 3. To open all channels, enter channel.open("allslots") in the Console box. 4. Select Enter to send the command. Figure 64: Enter command in Console box 5. To resend a command, select the arrow on the left side of the Console box. Figure 65: Web interface console Admin page Through the Admin page, you can change the instrument password and the instrument time.
  • Page 131: Unit Page

    Models 707B and 708B Switching System Reference Manual Section 4: Remote operations Change the instrument date and time To change the date and time of the instrument: 1. In the web interface, from the left navigation, select Admin. A login page is displayed. 2.
  • Page 132: Lxi Page

    Section 4: Remote operations Models 707B and 708B Switching System Reference Manual Generate Report: Generates an instrument report you can use to: • Review card or instrument information, including a basic description, the firmware revision, and the serial number. • Review configuration information, including card configuration and number of poles.
  • Page 133 Models 707B and 708B Switching System Reference Manual Section 4: Remote operations Figure 66: Event log The timestamp, event identifier, the IP address, and the domain name identify the incoming and outgoing LXI trigger packets. The following table provides detailed descriptions for the columns in the event log.
  • Page 134: Send Raw Commands To An Instrument

    Section 4: Remote operations Models 707B and 708B Switching System Reference Manual Event log descriptions Column title Description Example HWDetect Identifies a valid LXI trigger packet Sequence Each instrument maintains independent sequence counters: ▪ One for each combination of UDP multicast network interface and UDP multicast destination port.
  • Page 135 Models 707B and 708B Switching System Reference Manual Section 4: Remote operations #include "stdafx.h" #include <visa.h> #define checkErr(fCall) if (error = (fCall), (error = (error < 0) ? error : VI_SUCCESS)) \ {goto Error;} else error = error int _tmain(int argc, _TCHAR* argv[]) ViSession defaultRM, vi;...
  • Page 136: Visa-Com Sample Code

    Section 4: Remote operations Models 707B and 708B Switching System Reference Manual VISA-COM sample code This example gets the instrument identification string using VISA-COM in C#. To do this, you need to add a reference to the VISA-COM interop DLL, which is usually located at C:\Program Files\IVI Foundation\VISA\VisaCom\Primary Interop Assemblies\Ivi.Visa.Interop.dll.
  • Page 137: Introduction To Tsp Operation

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

    Section 5: Introduction to TSP operation Models 707B and 708B Switching System Reference Manual Functions Function-based commands control actions or activities. A function-based command performs an immediate action on the instrument. Each function consists of a function name followed by a set of parentheses ( ). Only include information in the parentheses if the function takes a parameter.
  • Page 139 Models 707B and 708B Switching System 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 following Lua code starts at the beginning of a string and breaks the string into individual items at each comma.
  • Page 140: Queries

    Section 5: Introduction to TSP operation Models 707B and 708B Switching System Reference Manual To read an attribute, you can use the attribute as the parameter of a function or assign it to another variable. Example 3: Read an attribute using a function print(format.data) Reads the data format by passing the attribute to the print function.
  • Page 141: About Tsp Commands

    Models 707B and 708B Switching System Reference Manual Section 5: Introduction to TSP operation About TSP commands This section contains an overview of the TSP commands for the instrument. The commands are organized into groups, with a brief description of each group. Each section contains links to the detailed descriptions for each command in the TSP command reference section of this documentation.
  • Page 142: Channel Functions And Attributes

    Section 5: Introduction to TSP operation Models 707B and 708B Switching System Reference Manual The Test Script Processor (TSP) scripting engine stores all numbers internally as IEEE Std 754 double-precision floating-point values. The logical operations work on 32-bit integers. Any fractional bits are truncated. For numbers larger than 4294967295, only the lower 32 bits are used.
  • Page 143: Data Queue

    Models 707B and 708B Switching System Reference Manual Section 5: Introduction to TSP operation channel.reset() (on page 7-42) channel.setdelay() (on page 7-43) channel.setforbidden() (on page 7-44) channel.setlabel() (on page 7-45) channel.setlabelcolumn() (on page 7-46) channel.setlabelrow() (on page 7-48) Data queue Use the data queue commands to: •...
  • Page 144: Display

    Section 5: Introduction to TSP operation Models 707B and 708B Switching System Reference Manual digio.readbit() (on page 7-55) digio.readport() (on page 7-56) digio.trigger[N].assert() (on page 7-57) digio.trigger[N].clear() (on page 7-58) digio.trigger[N].EVENT_ID (on page 7-58) digio.trigger[N].mode (on page 7-59) digio.trigger[N].overrun (on page 7-60) digio.trigger[N].pulsewidth (on page 7-61) digio.trigger[N].release()
  • Page 145: Event Log Functions And Attributes

    Models 707B and 708B Switching System Reference Manual Section 5: Introduction to TSP operation Event log functions and attributes The functions and attributes in this group control the event log. eventlog.all() (on page 7-89) eventlog.clear() (on page 7-90) eventlog.count (on page 7-90) eventlog.enable (on page 7-91) eventlog.next()
  • Page 146: Lan And Lxi

    Section 5: Introduction to TSP operation Models 707B and 708B Switching System 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.
  • Page 147: Local Node

    Models 707B and 708B Switching System Reference Manual Section 5: Introduction to TSP operation lan.trigger[N].disconnect() (on page 7-119) lan.trigger[N].EVENT_ID (on page 7-119) lan.trigger[N].ipaddress (on page 7-120) lan.trigger[N].mode (on page 7-120) lan.trigger[N].overrun (on page 7-121) lan.trigger[N].protocol (on page 7-122) lan.trigger[N].pseudostate (on page 7-123) lan.trigger[N].stimulus (on page 7-123) lan.trigger[N].wait()
  • Page 148: Print Functions

    Section 5: Introduction to TSP operation Models 707B and 708B Switching System Reference Manual Print functions Output data from the instrument. print() (on page 7-140) printnumber() (on page 7-141) Reset Resets settings to their default settings. digio.trigger[N].reset() (on page 7-62) lan.reset() (on page 7-107) localnode.reset()
  • Page 149: Scripting

    Models 707B and 708B Switching System Reference Manual Section 5: Introduction to TSP operation Scripting Scripting helps you combine commands into a block of code that the instrument can run. Scripts help you communicate with the instrument efficiently. These commands describe how to create, load, modify, run, and exit scripts.
  • Page 150: Status Model Functions

    Section 5: Introduction to TSP operation Models 707B and 708B Switching System Reference Manual Status model functions The status model is a set of status registers and queues. You can use the following commands to manipulate and monitor these registers and queues to view and control various instrument events.
  • Page 151: Tsp-Link

    Models 707B and 708B Switching System Reference Manual Section 5: Introduction to TSP operation trigger.timer[N].count (on page 7-214) trigger.timer[N].delay (on page 7-215) trigger.timer[N].delaylist (on page 7-216) trigger.timer[N].EVENT_ID (on page 7-217) trigger.timer[N].overrun (on page 7-217) trigger.timer[N].passthrough (on page 7-218) trigger.timer[N].reset() (on page 7-219) trigger.timer[N].stimulus (on page 7-220) trigger.timer[N].wait()
  • Page 152: Tsp-Net

    Section 5: Introduction to TSP operation Models 707B and 708B Switching System Reference Manual TSP-Net The TSP-Net module provides a simple socket-like programming interface to instruments that are enabled for Test Script Processor (TSP tspnet.clear() (on page 7-238) tspnet.connect() (on page 7-239) tspnet.disconnect() (on page 7-240) tspnet.execute()
  • Page 153: In This Section

    Section 6 Instrument programming In this section: Fundamentals of scripting for TSP ........... 6-1 Fundamentals of programming for TSP ......... 6-13 Using Test Script Builder (TSB) ..........6-33 Advanced scripting for TSP ............ 6-36 TSP-Link system and running simultaneous test scripts ..6-47 TSP-Net .................
  • Page 154: What Is A Script

    Section 6: Instrument programming Models 707B and 708B Switching System 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 155: What Can Be Included In Scripts

    Models 707B and 708B Switching System Reference Manual Section 6: Instrument programming What can be included in scripts? Scripts can include combinations of Test Script Processor (TSP ) commands and Lua code. TSP commands instruct the instrument to do one thing and are described in the command reference (see TSP commands (on page 7-7)).
  • Page 156 Section 6: Instrument programming Models 707B and 708B Switching System Reference Manual TSB Embedded is a tool with a reduced set of features than the complete Keithley TSB software. TSB Embedded has both script-building functionality and console functionality (single-line commands). It is accessed from a web browser. Refer to Working with TSB Embedded for additional information.
  • Page 157 Models 707B and 708B Switching System Reference Manual Section 6: Instrument programming Load a script by sending commands over the remote interface To load a script over the remote interface, you can use the loadscript, loadandrunscript, and endscript commands. The loadscript and loadandrunscript commands start the collection of messages that make up the script.
  • Page 158: Run Scripts

    Section 6: Instrument programming Models 707B and 708B Switching System Reference Manual Create a script using TSB Embedded If you are using TSB Embedded to create scripts, you do not need to use the commands loadscript or loadandrunscript and endscript. You can create a script from the instrument web interface with TSB Embedded.
  • Page 159 Models 707B and 708B Switching System Reference Manual Section 6: Instrument programming Run the anonymous script The anonymous script can be run many times without reloading it. It remains in the runtime environment until a new anonymous script is created or until the instrument is turned off. To run the anonymous script, use any one of these commands: •...
  • Page 160 Section 6: Instrument programming Models 707B and 708B Switching System Reference Manual Run a user script from the instrument front panel From the front panel, you can load and run a script that was previously added to the USER menu. To run the code from the front panel and add it to the USER menu: 1.
  • Page 161 Models 707B and 708B Switching System Reference Manual Section 6: Instrument programming The scriptVar.save() command saves the script to nonvolatile memory, which makes the change persistent through a power cycle. Refer to Save a user script to nonvolatile memory (on page 6-10) for more detail. Example: Set a script to run automatically test5.autorun = "yes"...
  • Page 162: Work With Scripts In Nonvolatile Memory

    Section 6: Instrument programming Models 707B and 708B Switching System Reference Manual Work with scripts in nonvolatile memory This section of the manual has primarily described working with scripts in the runtime environment. You can also work with scripts in nonvolatile memory. The runtime environment and nonvolatile memory are separate storage areas in the instrument.
  • Page 163 Models 707B and 708B Switching System Reference Manual Section 6: Instrument programming Save the anonymous script as a named script To save the anonymous script to nonvolatile memory, you must name it first. To save the anonymous script as a named script: 1.
  • Page 164: Programming Example: Interactive Script

    Section 6: Instrument programming Models 707B and 708B Switching System Reference Manual Delete user scripts These steps remove a script from nonvolatile memory. To completely remove a script from the instrument, there are additional steps you must take. See Delete user scripts from the instrument (on page 6-44).
  • Page 165: Fundamentals Of Programming For Tsp

    Models 707B and 708B Switching System Reference Manual Section 6: Instrument programming -- 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.
  • Page 166: What Is Lua

    Section 6: Instrument programming Models 707B and 708B Switching System Reference Manual 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 167 Models 707B and 708B Switching System Reference Manual Section 6: Instrument programming Function and variable name restrictions You cannot use Lua reserved words and top-level command names for function or variable names. You cannot use the following Lua reserved words for function or variable names. Lua reserved words break function...
  • Page 168: Variable Types

    Section 6: Instrument programming Models 707B and 708B Switching System Reference Manual Variable types Variables can be one of the following types. Variable types and values Variable type returned Value Notes "nil" The type of the value nil, whose main property is not declared to be different from any other value;...
  • Page 169 Models 707B and 708B Switching System Reference Manual Section 6: Instrument programming 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 value (shown here as a096cd30) print(atable[1])
  • Page 170 Section 6: Instrument programming Models 707B and 708B Switching System Reference Manual Create functions using the function keyword Functions are created with a message or in Lua code in either of the following forms: function myFunction(parameterX) functionBody end myFunction = function (parameterX) functionBody end Where: •...
  • Page 171 Models 707B and 708B Switching System Reference Manual Section 6: Instrument programming Example 3 function sum_diff_ratio(first_value, Returns multiple parameters (sum, difference, and second_value) ratio of the two numbers passed to it). psum = first_value + second_value Output: pdif = first_value - second_value prat = first_value / second_value 0.66666666666667 return psum, pdif, prat...
  • Page 172: Hello World

    Section 6: Instrument programming Models 707B and 708B Switching System Reference Manual 5. Run the script as a function. For this example, send: MakeMyFunction() This instructs the instrument to run the script, which creates the MyFunction global variable. This variable is of the type "function" (see Variable types (on page 6-16)).
  • Page 173: Logical Operators

    Models 707B and 708B Switching System Reference Manual Section 6: Instrument programming Relational operators Operator Description < less than > greater than <= less than or equal >= greater than or equal not equal equal Logical operators The logical operators in Lua are and, or, and not. All logical operators consider both false and nil as false and anything else as true.
  • Page 174: Operator Precedence

    Section 6: Instrument programming Models 707B and 708B Switching System Reference Manual Example: Concatenation print(2 .. 3) print("Hello " .. "World") Output: Hello World Operator precedence Operator precedence in Lua follows the order below (from higher to lower priority): • ^ (exponentiation) •...
  • Page 175 Models 707B and 708B Switching System Reference Manual Section 6: Instrument programming Example: If if 0 then Output: print("Zero is true!") Zero is true! else print("Zero is false.") Example: Comparison x = 1 Output: y = 2 Both x and y are true if x and y then print("Both x and y are true") Example: If and else...
  • Page 176: Loop Control

    Section 6: Instrument programming Models 707B and 708B Switching System Reference Manual Loop control If you need to repeat code execution, you can use the Lua while, repeat, and for control structures. To exit a loop, you can use the break keyword. While loops To use conditional expressions to determine whether to execute or end a loop, you use while loops.
  • Page 177: For Loops

    Models 707B and 708B Switching System Reference Manual Section 6: Instrument programming Repeat until loops To repeat a command, you use the repeat ... until statement. The body of a repeat statement always executes at least once. It stops repeating when the conditions of the until clause are met.
  • Page 178 Section 6: Instrument programming Models 707B and 708B Switching System 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 179 Models 707B and 708B Switching System Reference Manual Section 6: Instrument programming Example: Break with while statement local numTable = {5, 4, 3, 2, 1} This example defines a break value local k = table.getn(numTable) (breakValue) so that the break statement is local breakValue = 3 used to exit the while loop before the value of while k >...
  • Page 180: Standard Libraries

    Section 6: Instrument programming Models 707B and 708B Switching System Reference Manual Tables and arrays Lua makes extensive use of the data type table, which is a flexible array-like data type. Table indices start with 1. Tables can be indexed not only with numbers, but with any value except nil.
  • Page 181 Models 707B and 708B Switching System Reference Manual Section 6: Instrument programming Base library functions Base library functions Function Description collectgarbage() Sets the garbage-collection threshold to the given limit (in kilobytes) and collectgarbage(limit) checks it against the byte counter. If the new threshold is smaller than the byte counter, Lua immediately runs the garbage collector.
  • Page 182 Section 6: Instrument programming Models 707B and 708B Switching System Reference Manual String library functions Function Description string.byte(s) Returns the internal numeric codes of the characters s[i], s[i+1], string.byte(s, i) ···, s[j]. The default value for i is 1; the default value for j is i. string.byte(s, i, j) string.char(···) Receives zero or more integers separated by commas.
  • Page 183 Models 707B and 708B Switching System Reference Manual Section 6: Instrument programming Math library functions This library is an interface to most of the functions of the ANSI C math library. All trigonometric functions work in radians. The functions math.deg() and math.rad() convert between radians and degrees.
  • Page 184: Programming Example: Script With A For Loop

    Section 6: Instrument programming Models 707B and 708B Switching System Reference Manual Programming example: Script with a for loop The following script puts a message on the front-panel display one character at a time. This example demonstrates: • The use of a for loop •...
  • Page 185: Using Test Script Builder (Tsb)

    Models 707B and 708B Switching System Reference Manual Section 6: Instrument programming Example: Create channels with a for loop User script created in TSB Embedded User script created in another program loadscript -- Pseudocard assignment necessary -- Pseudocard assignment necessary -- only if slot is empty.
  • Page 186 Section 6: Instrument programming Models 707B and 708B Switching System Reference Manual Keithley has created a collection of remote commands specifically for use with Keithley TSP- enabled instruments; for detailed information about those commands, refer to the "Command reference" section of the documentation for your specific instrument. You can build scripts from a combination of these commands and Lua programming statements.
  • Page 187: Install The Tsb Software

    Models 707B and 708B Switching System Reference Manual Section 6: Instrument programming Install the TSB software The installation files for the TSB software are available at tek.com/keithley. To install the TSB software: 1. Close all programs. 2. Download the installer to your computer and double-click the .exe file to start the installation.
  • Page 188: Advanced Scripting For Tsp

    Section 6: Instrument programming Models 707B and 708B Switching System Reference Manual Advanced scripting for TSP The following topics describe advanced information that can help you understand how the Test Script Processor (TSP ) scripting engine works. Global variables and the script.user.scripts table When working with script commands, it is helpful to understand how scripts are handled in the instrument.
  • Page 189: Create A Script Using The Script.new() Command

    Models 707B and 708B Switching System Reference Manual Section 6: Instrument programming Figure 69: 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.
  • Page 190 Section 6: Instrument programming Models 707B and 708B Switching System 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 runtime environment, as shown in the following figure.
  • Page 191 Models 707B and 708B Switching System Reference Manual Section 6: Instrument programming To run the script, send the command: hello() Figure 71: Create an unnamed script A script becomes 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 192: Rename A Script

    Section 6: Instrument programming Models 707B and 708B Switching System Reference Manual Figure 72: Create a new script with the name of an existing script Rename a script You can rename a script to a new name or be the autoexec script. To change the name of a script, use the command: scriptVar.name = "renamedScript"...
  • Page 193 Models 707B and 708B Switching System Reference Manual Section 6: Instrument programming If the new name is the same as a name that is already used for a script, the name of the existing script is removed and that script becomes unnamed. This removes the existing script if there are no other variables that reference the previous script.
  • Page 194: Retrieve A User Script

    Section 6: Instrument programming Models 707B and 708B Switching System Reference Manual Retrieve a user script There are several ways to retrieve the source code of a user script: • One line at a time: Use scriptVar.list() to retrieve the source code one line at a time.
  • Page 195 Models 707B and 708B Switching System Reference Manual Section 6: Instrument programming 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.
  • Page 196: Delete User Scripts From The Instrument

    Section 6: Instrument programming Models 707B and 708B Switching System Reference Manual Example: Retrieve the content of a script with scriptVar.source print(test.source) Request a listing of the source of the script named test. The loadscript and endscript commands are not included. An example of the possible instrument output is: listTones = {100, 400, 800} for index in listTones do...
  • Page 197: Restore A Script To The Runtime Environment

    Models 707B and 708B Switching System Reference Manual Section 6: Instrument programming Restore a script to the runtime environment You can retrieve a script that was removed from the runtime environment but is still saved in nonvolatile memory. To restore a script from nonvolatile memory into the runtime environment, you can use script.restore("scriptName"), where scriptName is the user-defined name of the script to be restored.
  • Page 198 Section 6: Instrument programming Models 707B and 708B Switching System Reference Manual To increase the available memory: • Turn the instrument off and on. This deletes scripts that have not been saved and reloads only scripts that have been stored in nonvolatile memory. •...
  • Page 199: Tsp-Link System And Running Simultaneous Test Scripts

    Models 707B and 708B Switching System Reference Manual Section 6: Instrument programming TSP-Link system and running simultaneous test scripts You can use the TSP-Link expansion interface to expand your test system to include up to 32 addressable TSP enabled instruments that use the TSP-LINK interface. The expanded system can be stand-alone or computer-based.
  • Page 200: Connect The Tsp-Link Cable

    Section 6: Instrument programming Models 707B and 708B Switching System Reference Manual Connect the TSP-Link cable Connect the TSP-Link connector to one of the TSP-Link connectors on the rear panel of the instrument. The locations of the TSP-Link connectors are shown in the following figures. For an example of setting up a TSP-Linked system, see Work with the Series 2600B page 9-1).
  • Page 201: Initialization

    Models 707B and 708B Switching System Reference Manual Section 6: Instrument programming Figure 75: Model 707B rear-panel TSP-Link connection Initialization Before you can use a TSP-Link system, it must be initialized. For initialization to succeed, each instrument in a TSP-Link system must be assigned a different node number. Assign node numbers At the factory, each 707B and 708B instrument is assigned as node 1.
  • Page 202: Reset The Tsp-Link Network

    Section 6: Instrument programming Models 707B and 708B Switching System Reference Manual Reset the TSP-Link network After all the node numbers are set, you must initialize the system by performing a TSP-Link network reset. If you change the system configuration after initialization, you must reinitialize the system by performing a TSP-Link network reset.
  • Page 203: Use Tsp To Run Test Scripts Simultaneously

    Models 707B and 708B Switching System Reference Manual Section 6: Instrument programming The following code illustrates a TSP-Link reset operation and displays its state: tsplink.reset() print(tsplink.state) If the reset operation is successful, online is output to indicate that communications with all nodes have been established.
  • Page 204 Section 6: Instrument programming Models 707B and 708B Switching System Reference Manual Use groups to manage nodes on TSP-Link network The primary purpose of groups is to allow each group to run a different test script simultaneously. A group can consist of one or more nodes. You must assign group numbers to each node using remote commands.
  • Page 205: Assign Groups

    Models 707B and 708B Switching System Reference Manual Section 6: Instrument programming Assign groups Group numbers can range from zero (0) to 64. The default group number is 0. You can change the group number at any time. You can also add or remove a node to or from a group at any time.
  • Page 206 Section 6: Instrument programming Models 707B and 708B Switching System Reference Manual Coordinate overlapped operations in remote groups All overlapped operations on all nodes in a group must have completed before the master node can send a command to the group. If you send a command to a node in a remote group when an overlapped operation is running on any node in that group, errors occur.
  • Page 207 Models 707B and 708B Switching System Reference Manual Section 6: Instrument programming Use the data queue for real-time communications Nodes that are running test scripts at the same time can store data in the data queue for real-time communications. Each instrument has an internal data queue that uses a first-in, first-out (FIFO) structure to store data.
  • Page 208: Tsp-Net

    Section 6: Instrument programming Models 707B and 708B Switching System Reference Manual TSP-Net TSP-Net provides a simple socket-like programming interface to Test Script Processor (TSP) enabled instruments. Using the TSP-Net library, the Models 707B and 708B can control ethernet-enabled devices directly through its LAN port. This enables the Models 707B and 708B to communicate directly with a device that is that is not TSP-enabled without the use of a controlling computer.
  • Page 209: Use Tsp-Net With Any Ethernet-Enabled Instrument

    Models 707B and 708B Switching System Reference Manual Section 6: Instrument programming Use TSP-Net with any ethernet-enabled instrument Refer to TSP command reference (on page 7-1) for details about the commands presented in this section. The 707B and 708B LAN port is auto-sensing (Auto-MDIX), so you can use either a LAN crossover cable or a LAN straight-through cable to connect directly from the Models 707B and 708B to an ethernet device or to a hub.
  • Page 210: Example Script

    Section 6: Instrument programming Models 707B and 708B Switching System Reference Manual To communicate to a remote ethernet device from the Models 707B and 708B: 1. Connect to the remote device using one of the previous procedures. If the Models 707B and 708B cannot make a connection to the remote device, it generates a timeout event.
  • Page 211: Tsp-Net Compared To Tsp-Link To Communicate With Tsp-Enabled Devices

    Models 707B and 708B Switching System Reference Manual Section 6: Instrument programming TSP-Net compared to TSP-Link to communicate with TSP-enabled devices The TSP-Link network interface is the preferred communications method for most applications where communications occurs between the Model 707B or 708B and another TSP-enabled instrument.
  • Page 212: Example: Using Tspnet Commands

    Section 6: Instrument programming Models 707B and 708B Switching System Reference Manual Example: Using tspnet commands function telnetConnect(ipAddress, userName, password) -- Connect through telnet to a computer. id = tspnet.connect(ipAddress, 23, "") -- Read the title and login prompt from the computer. print(string.format("from computer-->...
  • Page 213: Instrument Driver Types

    Models 707B and 708B Switching System Reference Manual Section 6: Instrument programming To see what drivers are available for your instrument: 1. Go to the Product Support and Downloads web page (tek.com/support/product-support). 2. Enter the model number of your instrument. 3.
  • Page 214: Vxipnp Drivers

    Section 6: Instrument programming Models 707B and 708B Switching System Reference Manual VXIPnP drivers VXIplug&play (VXIPnP) style drivers are Win32 DLLs that have some standard functions defined by the IVI Foundation (ivifoundation.org), such as: • init • close • error_message •...
  • Page 215: Labview Drivers

    Models 707B and 708B Switching System Reference Manual Section 6: Instrument programming 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 platforms and operating systems that LabVIEW and VISA supports (such as Linux on x86, Mac OS...
  • Page 216: In This Section

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

    Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual Example 3: The attribute returns a string that contains information about a card in a specified slot and is shown as: slot[slot].idn For example, to get information about the card installed in slot 1, send: print(slot[1].idn) Syntax rules Use these syntax requirements to build well-formed instrument control commands.
  • Page 218: Use The Tsp Command Reference

    Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference Use the TSP command reference The Test Script Processor (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.
  • Page 219: Command Name And Summary Table

    Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual Command name and summary table Each instrument command description starts with the command name, followed by a brief description and a table with relevant information for each command. Definitions for the numbered items in the following figure are listed after the figure.
  • Page 220: Command Usage

    Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference 5. Where saved. Indicates where the command settings reside once they are used on an instrument. Options include: ▪ Not saved: Command is not saved anywhere and must be typed each time you use it.
  • Page 221: Command Details

    Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual Parameter value options: Descriptions of the options that are available for the user-defined parameter. Command details This section lists additional information you need to know to successfully use the remote command.
  • Page 222: Tsp Commands

    Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference TSP commands The TSP commands available for the instrument are listed in alphabetical order. beeper.beep() This function generates an audible tone. Type TSP-Link accessible Affected by Where saved Default value Function Usage...
  • Page 223: Beeper.enable

    Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual beeper.enable This command allows you to turn the beeper on or off. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Recall setup Saved setup 1 (beeper.ON) Instrument reset Create configuration script...
  • Page 224: Bit.bitor()

    Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference Example testResult = bit.bitand(10, 9) print(testResult) Performs a logical AND operation on decimal 10 (binary 1010) with decimal 9 (binary 1001), which returns a value of decimal 8 (binary 1000). Output: 8.0000000e+00 Also see...
  • Page 225: Bit.bitxor()

    Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual bit.bitxor() This function performs a bitwise logical XOR (exclusive OR) operation on two numbers. Type TSP-Link accessible Affected by Where saved Default value Function Usage result = bit.bitxor(value1, value2) result Result of the logical XOR operation value1...
  • Page 226: Bit.get()

    Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference Details Any fractional part of value is truncated to make it an integer. The returned result is also an integer. The least significant bit of value is at index position 1; the most significant bit is at index position 32.
  • Page 227: Bit.getfield()

    Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual Example testResult = bit.get(10, 4) print(testResult) The binary equivalent of decimal 10 is 1010. If you get the bit at index position 4, the returned decimal value is 8. Output: 8.0000000e+00 Also see...
  • Page 228: Bit.set()

    Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference Also see Bit manipulation and logic operations (on page 5-5) bit.get() (on page 7-11) bit.set() (on page 7-13) bit.setfield() (on page 7-14) bit.set() This function sets a bit at the specified index position. Type TSP-Link accessible Affected by...
  • Page 229: Bit.setfield()

    Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual bit.setfield() This function overwrites a bit field at a specified index position. Type TSP-Link accessible Affected by Where saved Default value Function Usage result = bit.setfield(value, index, width, fieldValue) result Result of the bit manipulation value...
  • Page 230: Bit.test()

    Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference bit.test() This function returns the Boolean value (true or false) of a bit at the specified index position. Type TSP-Link accessible Affected by Where saved Default value Function Usage result = bit.test(value, index)
  • Page 231: Bit.toggle()

    Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual bit.toggle() This function toggles the value of a bit at a specified index position. Type TSP-Link accessible Affected by Where saved Default value Function Usage result = bit.toggle(value, index) result Result of the bit manipulation value...
  • Page 232: Channel.clearforbidden()

    Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference channel.clearforbidden() This function clears the list of channels specified from being forbidden to close. Type TSP-Link accessible Affected by Where saved Default value Function Usage channel.clearforbidden("channelList") channelList The channels to set, using standard channel naming Details The channelList parameter indicates the channels that will no longer be forbidden to...
  • Page 233: Channel.close()

    Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual channel.close() This function closes the channels and channel patterns that are specified by the channel list parameter. Type TSP-Link accessible Affected by Where saved Default value Function Usage channel.close("channelList") channelList...
  • Page 234: Channel.connectrule

    Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference 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...
  • Page 235 Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual You cannot guarantee the sequence of open and closure operations when the channel connect rule is set to OFF. It is highly recommended that you implement cold switching when the channel connect rule is set to OFF.
  • Page 236: Channel.connectsequential

    Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference channel.connectsequential This attribute controls whether or not channels are closed sequentially. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Instrument reset Create configuration script channel.OFF Recall setup Usage...
  • Page 237: Channel.createspecifier()

    Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual channel.createspecifier() This function creates a string channel descriptor from a series of card-dependent integer arguments. Type TSP-Link accessible Affected by Where saved Default value Function Usage specifier = channel.createspecifier(slotX, row, column) specifier The formatted string for the channel The slot number (1 to 6)
  • Page 238: Channel.exclusiveclose()

    Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference 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...
  • Page 239: Channel.exclusiveslotclose()

    Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual Example channel.exclusiveclose("") channel.close("1D01,1E12") print(channel.getclose("slot1")) channel.pattern.setimage("1B02,1B04,1B06", "myChans") channel.exclusiveclose("1A01:1A05, 1C03, myChans") print(channel.getclose("slot1")) 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.
  • Page 240 Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference When this command is sent: • Closed channels for the associated slots are opened if they are not specified in the channelList • Channels specified by the items in channelList are closed Any settling times and user-specified delay times are incurred before command processing is complete For example, if row 1, column 1 channels are closed on each of the six slots, specifying a...
  • Page 241: Channel.getclose()

    Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual channel.getclose() This function queries for the closed channels indicated by the channel list parameter. Type TSP-Link accessible Affected by Where saved Default value Function Usage closed = channel.getclose("channelList") closed A string listing the channels that are presently closed in the specified channel list parameter...
  • Page 242: Channel.getcount()

    Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference channel.getcount() This function returns the number of times the relays have been closed for the specified channels. Type TSP-Link accessible Affected by Where saved Default value Function Usage counts = channel.getcount("channelList") counts...
  • Page 243: Channel.getdelay()

    Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual Example channel.pattern.setimage("1A01,1B02,1C01","Path") PathList = channel.pattern.getimage("Path") print(PathList) print(channel.getcount(PathList)) print(channel.getcount("Path")) Gets the close counts for channels in a channel pattern called "Path". Sample output: 1A01,1B02,1C01 11001,11014,11025 11001,11014,11025 Also see channel.pattern.getimage() (on page 7-37) channel.pattern.setimage()
  • Page 244: Channel.getforbidden()

    Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference An error message is generated for the following reasons: • The specified channels do not support a delay time • A channel pattern is specified Command processing stops as soon as an error is detected and a nil response is generated.
  • Page 245: Channel.getlabel()

    Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual Details The channelList parameter indicates which channels to check, and may include: ▪ allslots or slotX (where X equals 1 to 6 for Model 707B, or 1 for Model 708B) ▪...
  • Page 246: Channel.getlabelcolumn()

    Models 707B and 708B Switching System 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.
  • Page 247: Channel.getlabelrow()

    Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual 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.
  • Page 248: Channel.getstate()

    Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference Example channel.setrowlabel("1A01", "DUT1") channel.setrowlabel("1C01", "DUT2") print(channel.getlabelrow("1A01, 1B01, 1C01, 1D01, 1E01, 1F01, 1G01, 1H01")) Label the row labels on a card. Output: DUT1,,DUT2,,,,,, Also note the change on the display. Also see channel.getlabelcolumn() (on page 7-31)
  • Page 249: Channel.gettype()

    Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual Example print(channel.getstate("4A01:4B08")) channel.pattern.setimage("1A01,2B02,3C03", "Path") print(channel.getstate("Path")) print(channel.getstate("3C03")) -- Unmasking the return value must be done -- one channel at a time. if bit.bitand(channel.IND_CLOSED, tonumber(channel.getstate("4A10"))) == 1 then print("CLOSED") else print("OPENED") Query the state of the first 20 channels on slot 4.
  • Page 250: Channel.open()

    Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference channel.open() This function opens the specified channels and channel patterns. Type TSP-Link accessible Affected by Where saved Default value Function Usage channel.open("channelList") channelList String listing the channels and channel patterns to open Details This function opens the specified channels based on the switching configuration of the channel.
  • Page 251: Channel.pattern.catalog()

    Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual 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 name The user-defined name of the channel pattern that is assigned by the catalog function during the for loop...
  • Page 252: Channel.pattern.delete()

    Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference channel.pattern.delete() This function deletes a channel pattern. Type TSP-Link accessible Affected by Where saved Default value Function Usage channel.pattern.delete("name") name A string representing the name of the channel pattern to delete Details An error is generated if the name does not exist as a channel pattern.
  • Page 253: Channel.pattern.setimage()

    Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual Example channel.pattern.setimage("1A01:1A05", "myPattern") channel.pattern.setimage("1B01,1B03,1B05", "myRoute") myImage = channel.pattern.getimage("myPattern") print(myImage) print(channel.pattern.getimage("myRoute")) print(channel.pattern.getimage("myRoute, myPattern")) Using a Model 7174 (or similar model) card in slot 1, this example creates two channel patterns and then queries these patterns.
  • Page 254 Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference Channel patterns are stored when you run the createconfigscript() command or setup.save() command. Channel patterns are lost when power is cycled. Use setup.recall() or a script created with createconfigscript() to restore them.
  • Page 255: Channel.pattern.snapshot()

    Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual Example 1 channel.pattern.setimage("1A01:1A10", "Channels") oldList = channel.pattern.getimage("Channels") newList = oldList .. ", 1C11" channel.pattern.delete("Channels") channel.pattern.setimage(newList, "Channels") channel.close("Channels, 1D11") Items = channel.pattern.getimage("Channels") channel.pattern.setimage(Items, "Pattern") channel.pattern.delete("Channels") For this example, assume there is a Keithley Model 7174 or similar card in slot 1. Creates a pattern, appends a channel to the pattern by retrieving the pattern and recreating it, and then renames the pattern.
  • Page 256 Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference Examples of valid names: • Channels • Chans • chans • Path1 • Path20 • path_3 Examples of invalid names: • 1path (invalid because it starts with a number) •...
  • Page 257: Channel.reset()

    Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual channel.reset() This function resets the specified channel list items to factory default settings. Type TSP-Link accessible Affected by Where saved Default value Function Usage channel.reset("channelList") channelList A string that lists the items to reset; the string can include: ▪...
  • Page 258: Channel.setdelay()

    Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference Example 4 channel.reset("5C05, 5D16") Resets row 3, column 5, and row 4 column 16, on slot 5. Also see Channel functions and attributes (on page 5-6) reset() (on page 7-142) channel.setdelay() This function sets additional delay time for specified channels.
  • Page 259: Channel.setforbidden()

    Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual Example 1 channel.setdelay("1A03, 1A05", 50e-6) Sets row 1 and columns 3 and 5 of slot 1 for a delay time of 50 µs. Example 2 channel.setdelay("slot1", 0) Sets the channels on slot 1 for 0 delay time.
  • Page 260: Channel.setlabel()

    Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference Example channel.pattern.setimage("1A01,1A02", "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") for name in channel.pattern.catalog() do print(name .. " = " .. channel.pattern.getimage(name)) Create three channel patterns and then print.
  • Page 261: Channel.setlabelcolumn()

    Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual The label must be unique. In addition, it cannot be the same as the name of a channel pattern, row label, or column label. If you specify a label that already exists, an error message is generated that indicates a parameter error and channel that that is already associated the specified label.
  • Page 262 Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference After defining a column label, you can use it with a row label to specify a channel instead of the channel specifier. On the crosspoint display, the first four characters of the label are displayed. On the bottom display, the full label is displayed.
  • Page 263: Channel.setlabelrow()

    Section 7: TSP command reference Models 707B and 708B Switching System 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)
  • Page 264: Createconfigscript()

    Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference Example 3 channel.setlabelrow("1A01", " ") Clears the label for row 1 on slot 1 and return to the default. Example 4 channel.setlabelrow("2B01", "Row2") print(channel.getlabelrow("slot2")) This example assumes a 7072 in slot 2. Set the label to be Row2, which assigns the label to all channels in the row.
  • Page 265: Dataqueue.add()

    Section 7: TSP command reference Models 707B and 708B Switching System 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...
  • Page 266: Dataqueue.capacity

    Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference Also see dataqueue.CAPACITY (on page 7-51) dataqueue.clear() (on page 7-52) dataqueue.count (on page 7-53) dataqueue.next() (on page 7-54) Using the data queue for real-time communications (on page 6-55) dataqueue.CAPACITY This constant is the maximum number of entries that you can store in the data queue.
  • Page 267: Dataqueue.clear()

    Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual dataqueue.clear() This function clears the data queue. Type TSP-Link accessible Affected by Where saved Default value Function Usage dataqueue.clear() Details This function forces all dataqueue.add() commands that are in progress to time out and deletes all data from the data queue.
  • Page 268: Dataqueue.count

    Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference dataqueue.count This attribute contains the number of items in the data queue. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Not applicable Not applicable Not applicable Usage count = dataqueue.count...
  • Page 269: Dataqueue.next()

    Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual dataqueue.next() This function removes the next entry from the data queue. Type TSP-Link accessible Affected by Where saved Default value Function Usage value = dataqueue.next() value = dataqueue.next(timeout) value The next entry in the data queue timeout...
  • Page 270: Delay()

    Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference Also see dataqueue.add() (on page 7-50) dataqueue.CAPACITY (on page 7-51) dataqueue.clear() (on page 7-52) dataqueue.count (on page 7-53) format.asciiprecision (on page 7-94) Using the data queue for real-time communications (on page 6-55) delay() This function delays the execution of the commands that follow it.
  • Page 271: Digio.readport()

    Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual Details A returned value of zero (0) indicates that the line is low. A returned value of one (1) indicates that the line is high. Example --Read the value of digital I/O line 2 local value = digio.readbit(2) print("The value of line 2 is: "...
  • Page 272: Digio.trigger[N].Assert()

    Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference Example data = digio.readport() print(data) Assume lines 2, 4, 6, and 8 are set high when the I/O port is read. Output: 1.7000000e+02 This is binary 10101010. Also see digio.readbit() (on page 7-55)
  • Page 273: Digio.trigger[N].Clear()

    Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual digio.trigger[N].clear() This function clears the trigger event on a digital I/O line. Type TSP-Link accessible Affected by Where saved Default value Function Usage digio.trigger[N].clear() Digital I/O trigger line: 1 to 14 Details The event detector of a trigger enters the detected state when an event is detected.
  • Page 274: Digio.trigger[N].Mode

    Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference Example 2 scan.trigger.arm.stimulus = digio.trigger[3].EVENT_ID Uses a trigger event on digital I/O trigger line 3 to be the stimulus for starting a scan. Also see None digio.trigger[N].mode This attribute sets the mode in which the trigger event detector and the output trigger generator operate on the given trigger line.
  • Page 275: Digio.trigger[N].Overrun

    Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual When programmed to any mode except digio.TRIG_BYPASS, the output state of the I/O line is controlled by the trigger logic and the user-specified output state of the line is ignored. Use of either digio.TRIG_SYNCHRONOUSA or digio.TRIG_SYNCHRONOUSM is preferred over digio.TRIG_SYNCHRONOUS.
  • Page 276: Digio.trigger[N].Pulsewidth

    Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference Example overrun = digio.trigger[1].overrun print(overrun) If there is no trigger overrun, the following text is output: false Also see digio.trigger[N].clear() (on page 7-58) digio.trigger[N].reset() (on page 7-62) digio.trigger[N].pulsewidth This attribute describes the length of time that the trigger line is asserted for output triggers.
  • Page 277: Digio.trigger[N].Release()

    Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual digio.trigger[N].release() This function releases an indefinite length or latched trigger. Type TSP-Link accessible Affected by Where saved Default value Function Usage digio.trigger[N].release() Digital I/O trigger line: 1 to 14 Details Releases a trigger that was asserted with an indefinite pulsewidth time.
  • Page 278: Digio.trigger[N].Stimulus

    Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference Example digio.trigger[3].mode = 2 digio.trigger[3].pulsewidth = 50e-6 digio.trigger[3].stimulus = digio.trigger[5].EVENT_ID print(digio.trigger[3].mode, digio.trigger[3].pulsewidth, digio.trigger[3].stimulus) digio.trigger[3].reset() print(digio.trigger[3].mode, digio.trigger[3].pulsewidth, digio.trigger[3].stimulus) Set the digital I/O trigger line 3 for a falling edge with a pulsewidth of 50 µs. Use digital I/O line 5 to trigger the event on line 3.
  • Page 279: Digio.trigger[N].Wait()

    Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual Trigger event IDs Trigger event ID Description digio.trigger[N].EVENT_ID An edge (either rising, falling, or either based on the configuration of the line) on the digital input line. display.trigger.EVENT_ID The trigger key on the front panel is pressed.
  • Page 280: Digio.writebit()

    Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference Details This function pauses trigger operation up to the seconds set by timeout for an input trigger. If one or more trigger events are detected since the last time digio.trigger[N].wait() or digio.trigger[N].clear() was called, this function returns a value immediately.
  • Page 281: Digio.writeport()

    Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual Also see digio.readbit() (on page 7-55) digio.readport() (on page 7-56) digio.trigger[N].mode (on page 7-59) digio.writeport() (on page 7-66) digio.writeprotect (on page 7-67) digio.writeport() This function writes to all digital I/O lines. Type TSP-Link accessible Affected by...
  • Page 282: Digio.writeprotect

    Models 707B and 708B Switching System 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...
  • Page 283: Display.getannunciators()

    Section 7: TSP command reference Models 707B and 708B Switching System 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() annunciators The bitmasked value that shows which indicators are turned on Details This function returns a bitmasked value showing which indicators are turned on.
  • Page 284: Display.getcursor()

    Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference Example 2 print(display.ANNUNCIATOR_EDIT) print(display.ANNUNCIATOR_TRIGGER) print(display.ANNUNCIATOR_AUTO) Output: 2.5600000e+02 3.2000000e+01 8.0000000e+00 Also see bit.bitand() (on page 7-8) display.getcursor() This function reads the present position of the cursor on the front-panel display. Type TSP-Link accessible Affected by...
  • Page 285: Display.getlastkey()

    Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual Also see display.gettext() (on page 7-71) display.screen (on page 7-81) display.setcursor() (on page 7-83) display.settext() (on page 7-84) display.getlastkey() This function retrieves the key code for the last pressed key. Type TSP-Link accessible Affected by...
  • Page 286: Display.gettext()

    Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference When using this function, use built-in constants, such as display.KEY_STEP, rather than the numeric value, such as 86. This allows for better forward compatibility with firmware revisions. Example key = display.getlastkey() print(key)
  • Page 287 Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual Details Using the command without any parameters returns both lines of the front-panel display. The $N character code is included in the returned value to show where the top line ends and the bottom line begins.
  • Page 288: Display.inputvalue()

    Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference display.inputvalue() This function displays a formatted input field on the front-panel display that the operator can edit. Type TSP-Link accessible Affected by Where saved Default value Function Usage display.inputvalue("format") display.inputvalue("format", default)
  • Page 289: Display.loadmenu.add()

    Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual For positive and negative entry (plus sign (+) used for the value field and the exponent field), polarity of a nonzero value or exponent can be toggled by positioning the cursor on the polarity sign and turning the navigation wheel .
  • Page 290 Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference Any Lua code can be included in the code parameter. If memory is set to display.SAVE, the entry (name and code) is saved in nonvolatile memory. Scripts, functions, and variables used in the code are not saved by display.SAVE.
  • Page 291: Display.loadmenu.catalog()

    Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual display.loadmenu.catalog() This function creates an iterator for the user menu items accessed using the LOAD key on the front panel. Type TSP-Link accessible Affected by Where saved Default value Function Usage...
  • Page 292: Display.loadmenu.delete()

    Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference display.loadmenu.delete() This function removes an entry from the USER TESTS menu, which can be accessed using the LOAD key on the front panel. Type TSP-Link accessible Affected by Where saved Default value Function...
  • Page 293: Display.locallockout

    Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual display.locallockout This attribute describes whether or not the EXIT (LOCAL) key on the instrument front panel is enabled. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Power cycle Not saved...
  • Page 294: Display.prompt()

    Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference After sending this command, script execution pauses for the operator to select a menu item. An item is selected by rotating the navigation wheel to place the blinking cursor on the item, and then pressing the navigation wheel (or the ENTER key).
  • Page 295 Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual 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 0.00000E+0 plus sign (+) for positive/negative exponent entry. Do not include the plus sign (+) to prevent negative value entry.
  • Page 296: Display.screen

    Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference display.screen This attribute contains the selected display screen. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Instrument reset Create configuration script display.MAIN Usage displayID = display.screen display.screen = displayID displayID One of the following values:...
  • Page 297 Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual display.sendkey() This function sends a code that simulates the action of a front-panel control. Type TSP-Link accessible Affected by Where saved Default value Function Usage display.sendkey(keyCode) keyCode A parameter that specifies the key press to simulate;...
  • Page 298: Display.setcursor()

    Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference display.setcursor() This function sets the position of the cursor. Type TSP-Link accessible Affected by Where saved Default value Function Usage display.setcursor(row, column) display.setcursor(row, column, style) The row number for the cursor: 1 or 2 column The active column position to set: ▪...
  • Page 299: Display.settext()

    Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual Also see display.clear() (on page 7-67) display.getcursor() (on page 7-69) display.gettext() (on page 7-71) display.screen (on page 7-81) display.settext() (on page 7-84) display.settext() This function displays text on the front-panel user screen. Type TSP-Link accessible Affected by...
  • Page 300: Display.trigger.event_Id

    Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference Example display.clear() display.settext("Normal $BBlinking$N") display.settext("$DDim $FBackgroundBlink$R $$$$ 2 dollars") This example sets the display to: Normal Blinking Dim BackgroundBlink $$ 2 dollars with the named effect on each word. Also see display.clear() (on page 7-67)
  • Page 301: Display.waitkey()

    Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual 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...
  • Page 302: Errorqueue.clear()

    Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference Also see display.getlastkey() (on page 7-70) display.sendkey() (on page 7-82) display.settext() (on page 7-84) errorqueue.clear() This function clears all entries out of the error queue. Type TSP-Link accessible Affected by Where saved Default value...
  • Page 303: Errorqueue.next()

    Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual errorqueue.next() This function reads the oldest entry from the error queue and removes it from the queue. Type TSP-Link accessible Affected by Where saved Default value Function Usage errorCode, message, severity, errorNode = errorqueue.next() errorCode...
  • Page 304: Eventlog.all()

    Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference eventlog.all() This function returns all entries from the event log as a single string and removes them from the event log. Type TSP-Link accessible Affected by Where saved Default value Function Usage...
  • Page 305: Eventlog.clear()

    Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual eventlog.clear() This function clears the event log. Type TSP-Link accessible Affected by Where saved Default value Function Usage eventlog.clear() Details This command removes all messages from the event log. Also see eventlog.all() (on page 7-89)
  • Page 306: Eventlog.enable

    Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference eventlog.enable This attribute enables or disables the event log. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Instrument reset Create configuration script eventlog.ENABLE Usage status = eventlog.enable eventlog.enable = status status...
  • Page 307: Eventlog.next()

    Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual eventlog.next() This function returns the oldest unread event message from the event log and removes it from the event log. Type TSP-Link accessible Affected by Where saved Default value Function Usage...
  • Page 308: Eventlog.overwritemethod

    Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference eventlog.overwritemethod This attribute controls how the event log processes events if the event log is full. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Instrument reset Create configuration script 1 (eventlog.DISCARD_OLDEST)
  • Page 309: Exit()

    Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual exit() This function stops a script that is presently running. Type TSP-Link accessible Affected by Where saved Default value Function Usage exit() Details Terminates script execution when called from a script that is being executed. This command does not wait for overlapped commands to complete before terminating script execution.
  • Page 310: Format.byteorder

    Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference Example format.asciiprecision = 10 Output: x = 2.54 2.54000000000e+00 printnumber(x) format.asciiprecision = 3 2.54e+00 printnumber(x) Also see format.byteorder (on page 7-95) format.data (on page 7-96) print() (on page 7-140) printnumber() (on page 7-141) format.byteorder...
  • Page 311: Format.data

    Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual Example x = 1.23 format.data = format.REAL32 format.byteorder = format.LITTLEENDIAN printnumber(x) format.byteorder = format.BIGENDIAN printnumber(x) The output depends on the terminal program you use, but it looks something like: #0¤p?? #0??p¤...
  • Page 312: Gettimezone()

    Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference Binary formats are not intended to be interpreted by humans. Example format.asciiprecision = 10 x = 3.14159265 format.data = format.ASCII printnumber(x) format.data = format.REAL64 printnumber(x) Output a number represented by x in ASCII using a precision of 10, then output the same number in binary using double-precision format.
  • Page 313: Gpib.address

    Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual gpib.address This attribute contains the GPIB address. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Not applicable Nonvolatile memory Usage address = gpib.address gpib.address = address address The GPIB address of the instrument: 1 to 30 Details...
  • Page 314: Lan.applysettings()

    Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference lan.applysettings() This function re-initializes the LAN interface with new settings. Type TSP-Link accessible Affected by Where saved Default value Function Usage lan.applysettings() Details Disconnects all existing LAN connections to the instrument and re-initializes the LAN with the present configuration settings.
  • Page 315: Lan.config.dns.domain

    Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual Details This attribute is an array of Domain Name System (DNS) server addresses. These addresses take priority for DNS lookups and are consulted before any server addresses that are obtained using DHCP.
  • Page 316: Lan.config.dns.dynamic

    Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference The length of the fully qualified host name (combined length of the domain and host name with separator characters) must be less than or equal to 255 characters. Although up to 255 characters are allowed, you must make sure the combined length is also no more than 255 characters.
  • Page 317: Lan.config.dns.hostname

    Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual lan.config.dns.hostname This attribute defines the dynamic DNS host name. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Not applicable Nonvolatile memory Instrument specific (see Details) Usage hostName = lan.config.dns.hostname lan.config.dns.hostname = "hostName"...
  • Page 318: Lan.config.dns.verify

    Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference 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 Nonvolatile memory 1 (lan.ENABLE) Usage state = lan.config.dns.verify lan.config.dns.verify = state...
  • Page 319: Lan.config.ipaddress

    Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual This attribute does not indicate the actual setting that is presently in effect. Use the lan.status.gateway attribute to determine the present operating state of the LAN. The IP address must be formatted in four groups of numbers, each separated by a decimal. Example print(lan.config.gateway) Outputs the default gateway address.
  • Page 320: Lan.config.method

    Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference lan.config.method This attribute contains the LAN settings configuration method. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) LAN restore defaults Nonvolatile memory 0 (lan.AUTO) Usage method = lan.config.method lan.config.method = method...
  • Page 321: Lan.lxidomain

    Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual Details This attribute specifies the LAN subnet mask that is used when the manual configuration method is used to configure the LAN. This setting is ignored when DLLA or DHCP is used. This attribute does not indicate the actual setting presently in effect.
  • Page 322: Lan.nagle

    Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference lan.nagle This attribute controls the state of the LAN Nagle algorithm. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Power cycle Not saved 0 (lan.DISABLE) Usage state = lan.nagle lan.nagle = state...
  • Page 323: Lan.restoredefaults()

    Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual lan.restoredefaults() This function resets LAN settings to default values. Type TSP-Link accessible Affected by Where saved Default value Function Usage lan.restoredefaults() Details The settings that are restored are shown in the following table. Settings that are restored to default Attribute Default setting...
  • Page 324: Lan.status.dns.address[N]

    Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference 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 Not applicable Usage dnsAddress = lan.status.dns.address[N] dnsAddress DNS server IP address...
  • Page 325: Lan.status.duplex

    Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual A FQDN is the complete domain name for a specific computer or host on the LAN. The FQDN consists of two parts: The host name and the domain name. If the DNS host name for an instrument is not found, this attribute stores the IP address in dotted decimal notation.
  • Page 326: Lan.status.ipaddress

    Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference 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...
  • Page 327: Lan.status.port.dst

    Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual Details The MAC address is a character string representing the MAC address of the instrument in hexadecimal notation. The string includes colons that separate the address octets (see Example).
  • Page 328: Lan.status.port.rawsocket

    Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference lan.status.port.rawsocket This attribute contains the LAN raw socket connection port number. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Not applicable Not applicable Not applicable Usage port = lan.status.port.rawsocket port...
  • Page 329: Lan.status.speed

    Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual lan.status.port.vxi11 This attribute contains the LAN VXI-11 connection port number. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Not applicable Not applicable Not applicable Usage port = lan.status.port.vxi11 port...
  • Page 330: Lan.status.subnetmask

    Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference lan.status.subnetmask This attribute contains the LAN subnet mask that is presently in use by the LAN interface. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Not applicable Not applicable Not applicable...
  • Page 331: Lan.trigger[N].Clear()

    Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual Example lan.trigger[5].assert() Creates a trigger with LAN packet 5. Also see lan.lxidomain (on page 7-106) lan.trigger[N].clear() (on page 7-116) lan.trigger[N].mode (on page 7-120) lan.trigger[N].overrun (on page 7-121) lan.trigger[N].stimulus (on page 7-123) lan.trigger[N].wait()
  • Page 332: Lan.trigger[N].Connect()

    Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference lan.trigger[N].connect() This function prepares the event generator for outgoing trigger events. Type TSP-Link accessible Affected by Where saved Default value Function Usage lan.trigger[N].connect() The LAN event number: 1 to 8 Details This command prepares the event generator to send event messages.
  • Page 333: Lan.trigger[N].Connected

    Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual lan.trigger[N].connected This attribute stores the LAN event connection state. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Not applicable Not applicable Not applicable Usage connected = lan.trigger[N].connected connected The LAN event connection state:...
  • Page 334: Lan.trigger[N].Disconnect()

    Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference lan.trigger[N].disconnect() This function disconnects the LAN trigger. Type TSP-Link accessible Affected by Where saved Default value Function Usage lan.trigger[N].disconnect() The LAN event number: 1 to 8 Details For TCP connections, this closes the TCP connection.
  • Page 335: Lan.trigger[N].Ipaddress

    Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual lan.trigger[N].ipaddress This attribute specifies the address of UDP or TCP listeners. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Instrument reset Create configuration script "0.0.0.0"...
  • Page 336: Lan.trigger[N].Overrun

    Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference Details This command controls how the trigger event detector and the output trigger generator operate on the given trigger. These settings are intended to provide behavior similar to the digital I/O triggers.
  • Page 337: Lan.trigger[N].Protocol

    Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual Details This command indicates whether an event has been ignored because the event detector was already in the detected state when the event occurred. This is an indication of the state of the event detector built into the synchronization line itself. It does not indicate if an overrun occurred in any other part of the trigger model, or in any other construct that is monitoring the event.
  • Page 338: Lan.trigger[N].Pseudostate

    Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference Example print(lan.trigger[1].protocol) Get LAN protocol to use for sending trigger messages for LAN event 1. Also see lan.trigger[N].connect() (on page 7-117) lan.trigger[N].ipaddress (on page 7-120) lan.trigger[N].pseudostate This attribute sets the simulated line state for the LAN trigger. Type TSP-Link accessible Affected by...
  • Page 339 Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual Usage triggerStimulus = lan.trigger[N].stimulus lan.trigger[N].stimulus = triggerStimulus triggerStimulus The LAN event identifier used to trigger the event; see Details A number specifying the trigger packet over the LAN for which to set or query the trigger source: 1 to 8 Details This attribute specifies which event causes a LAN trigger packet to be sent for this trigger.
  • Page 340: Lan.trigger[N].Wait()

    Models 707B and 708B Switching System 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...
  • Page 341: Localnode.description

    Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual Usage maxNumber = localnode.define.MAX_TIMERS maxNumber = localnode.define.MAX_DIO_LINES maxNumber = localnode.define.MAX_TSPLINK_TRIGS maxNumber = localnode.define.MAX_BLENDERS maxNumber = localnode.define.MAX_BLENDER_INPUTS maxNumber = localnode.define.MAX_LAN_TRIGS maxNumber = localnode.define.MAX_CHANNEL_TRIGS maxNumber A variable assigned the value of the constant; the constant equals the maximum number available for the specified feature on the local node instrument Details These read-only constants indicate the maximum number of each feature type that is...
  • Page 342: Localnode.license

    Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference Details This attribute stores a string that contains a description of the instrument. This value appears on the LXI welcome page and is used as the mDNS service name of the instrument.
  • Page 343: Localnode.model

    Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual localnode.model This attribute stores the model number. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Not applicable Not applicable Not applicable Usage model = localnode.model model The model number of the instrument Example...
  • Page 344: Localnode.prompts

    Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference Example localnode.password = "N3wpa55w0rd" Changes the remote interface password to N3wpa55w0rd. Also see lan.reset() (on page 7-107) localnode.prompts This attribute determines if the instrument generates prompts in response to command messages. Type TSP-Link accessible Affected by...
  • Page 345: Localnode.prompts4882

    Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual Do not disable prompting when using Test Script Builder. Test Script Builder requires prompts and sets the prompting mode automatically. If you disable prompting, the instrument stops responding when you communicate using Test Script Builder because it is waiting for a common complete prompt from Test Script Builder.
  • Page 346: Localnode.reset()

    Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference localnode.reset() This function resets the local node instrument. Type TSP-Link accessible Affected by Where saved Default value Function Usage localnode.reset() Details A local node reset includes a channel.reset("allslots") and a scan.reset(). In addition: •...
  • Page 347: Localnode.revision

    Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual localnode.revision This attribute stores the firmware revision level. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Not applicable Not applicable Not applicable Usage revision = localnode.revision revision Firmware revision level Details...
  • Page 348: Localnode.showerrors

    Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference Example display.clear() display.settext(localnode.serialno) Clears the instrument display. Places the serial number of the instrument on the top line of its display. Also see localnode.description (on page 7-126) localnode.model (on page 7-128) localnode.revision...
  • Page 349: Makegetter()

    Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual makegetter() This function creates a function to get the value of an attribute. Type TSP-Link accessible Affected by Where saved Default value Function Usage getter = makegetter(table, "attributeName") getter The return value table...
  • Page 350: Memory.available()

    Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference Details This function is useful for aliasing attributes to improve execution speed. Calling the setter function execute more quickly than accessing the attribute directly. Creating a setter function is only useful if it is going to be called several times. If you are not calling the setter function several times, it is more efficient to access the attribute directly.
  • Page 351: Memory.used()

    Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual Example: Available memory memoryAvailable = memory.available() print(memoryAvailable) Reads and returns the amount of memory available in the instrument. Output: 51.56, 92.84, 100.00 You can also use: print(memory.available()) Example: Used and available memory print("Memory used:", memory.used()) print("Memory available: ", memory.available())
  • Page 352: Node[N].Execute()

    Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference Example MemUsed = memory.used() print(MemUsed) Reads the memory used in the instrument and returns the percentages. Output: 69.14, 0.16, 12.74 Also see memory.available() (on page 7-135) node[N].execute() This function starts test scripts on a remote TSP-Link node.
  • Page 353: Node[N].Getglobal()

    Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual node[N].getglobal() This function returns the value of a global variable. Type TSP-Link accessible Affected by Where saved Default value Function Usage value = node[N].getglobal("name") value The value of the variable The node number of this instrument: 1 to 63 name The global variable name...
  • Page 354: Opc()

    Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference Details From a remote node, use this function to assign the given value to a global variable. Do not use this command to create or set the value of a global variable from the local node (set the global variable directly instead).
  • Page 355: Print()

    Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual print() This function generates a response message. Type TSP-Link accessible Affected by Where saved Default value Function Usage print(value1) print(value1, value2) print(value1, ..., valueN) value1 The first argument to output value2 The second argument to output valueN...
  • Page 356: Printnumber()

    Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference printnumber() This function prints numbers using the configured format. Type TSP-Link accessible Affected by Where saved Default value Function Usage printnumber(value1) printnumber(value1, value2) printnumber(value1, ..., valueN) value1 First value to print in the configured format value2 Second value to print in the configured format...
  • Page 357: Reset()

    Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual reset() This function resets commands to their default settings. Type TSP-Link accessible Affected by Where saved Default value Function Usage reset() reset(system) system What to reset: ▪ If the node is the master, the entire system is reset (default): true ▪...
  • Page 358: Scan.abort()

    Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference scan.abort() This function aborts a running background scan. Type TSP-Link accessible Affected by Where saved Default value Function Usage scan.abort() Details If no scan is running, the call to this function is ignored. When a scan is aborted, the channels remain in the opened or closed states that they were in when the scan was aborted.
  • Page 359: Scan.add()

    Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual scan.add() This function adds channels to the scan list. Type TSP-Link accessible Affected by Where saved Default value Function Usage scan.add("channelList") channelList String specifying channels to add using normal channel list syntax Details Use this function to add channels and channel patterns to the present scan list.
  • Page 360: Scan.addimagestep()

    Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference scan.addimagestep() This function allows you to include multiple channels in a single scan step. Type TSP-Link accessible Affected by Where saved Default value Function Usage scan.addimagestep("channelList") 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.
  • Page 361: Scan.background()

    Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual 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...
  • Page 362: Scan.bypass

    Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference 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)
  • Page 363: Scan.create()

    Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual 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 364: Scan.execute()

    Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference scan.execute() This function starts the scan immediately in the foreground with a configured scan list. Type TSP-Link accessible Affected by Where saved Default value Function Usage scanState, scanCount, stepCount = scan.execute() scanState The result of scanning: scan.EMPTY or 0...
  • Page 365 Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual Usage scanList = scan.list() scanList A string that lists the existing scan step information Details When you change a channel or scan attribute for an existing scan list item, the scan list is recreated based on this change.
  • Page 366: Scan.mode

    Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference scan.mode This attribute sets the relay action when the scan starts. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) System reset Create configuration script 0 (scan.MODE_OPEN_ALL) Scan reset Usage...
  • Page 367: Scan.reset()

    Section 7: TSP command reference Models 707B and 708B Switching System 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...
  • Page 368: Scan.scancount

    Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference scan.scancount This attribute sets the number of times the scan is repeated. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Instrument reset Create configuration script Scan reset Usage scanCount = scan.scancount...
  • Page 369: Scan.state()

    Section 7: TSP command reference Models 707B and 708B Switching System 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;...
  • Page 370: Scan.stepcount

    Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference scan.stepcount This attribute returns the number of steps in the present scan. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Not applicable Not applicable Not applicable Usage scanStepCount = scan.stepcount...
  • Page 371: Scan.trigger.arm.set()

    Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual Also see scan.trigger.arm.set() (on page 7-156) scan.trigger.arm.stimulus (on page 7-156) Trigger model (on page 2-21) Scan and trigger (on page 2-21) scan.trigger.arm.set() This function sets the arm event detector to the detected state. Type TSP-Link accessible Affected by...
  • Page 372 Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference eventID may be one of the following trigger event IDs. Trigger event IDs Trigger event ID Description digio.trigger[N].EVENT_ID An edge (either rising, falling, or either based on the configuration of the line) on the digital input line.
  • Page 373: Scan.trigger.channel.set()

    Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual 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. Also see scan.trigger.channel.set() (on page 7-158) scan.trigger.channel.stimulus...
  • Page 374 Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference Details This attribute selects which events cause the channel event detector to enter the detected state. Set this attribute to 0 to start the channel action immediately at the default setting. Set eventID to one of the existing trigger event IDs shown in the following table.
  • Page 375: Scan.trigger.clear()

    Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual 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.
  • Page 376: Script.delete()

    Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference Example 2 print(script.anonymous.source) Retrieves the source of the anonymous script. Also see Anonymous scripts (on page 6-4) scriptVar.autorun (on page 7-165) scriptVar.list() (on page 7-166) scriptVar.name (on page 7-167) scriptVar.run() (on page 7-168) scriptVar.save()
  • Page 377: Script.newautorun()

    Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual Details The name parameter is the name that is added to the script.user.scripts table. If name is not provided, an empty string is used, and the script is unnamed. If the name already exists in script.user.scripts, the name attribute of the existing script is set to an empty string before it is replaced by the new script.
  • Page 378: Script.restore()

    Models 707B and 708B Switching System 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 provided, an empty string is used, and the script is unnamed. If the name already exists in script.user.scripts, the name attribute of the existing script is set to an empty string before it is replaced by the new script.
  • Page 379: Script.run()

    Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual Details This command copies the script from nonvolatile memory into the runtime environment. It also creates a global variable with the same name as the name of the script. Example script.restore("test9") Restores a script named test9 from nonvolatile memory.
  • Page 380: Scriptvar.autorun

    Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference Details This function accesses the catalog of scripts stored in nonvolatile memory, which allows you to process all scripts in nonvolatile memory. The entries are enumerated in no particular order.
  • Page 381: Scriptvar.list()

    Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual Example test5.autorun = "yes" test5.save() Assume a script named test5 is in the runtime environment. The next time the instrument is turned on, test5 script automatically loads and runs. Also see None scriptVar.list()
  • Page 382: Scriptvar.name

    Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference scriptVar.name This attribute contains the name of a script in the runtime environment. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Not applicable Not applicable Not applicable Usage scriptVar.name = "scriptName"...
  • Page 383: Scriptvar.run()

    Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual scriptVar.run() This function runs a script. Type TSP-Link accessible Affected by Where saved Default value Function Usage scriptVar.run() scriptVar() scriptVar The name of the variable that references the script Details The scriptVar.run() function runs the script referenced by scriptVar.
  • Page 384: Scriptvar.source

    Models 707B and 708B Switching System 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...
  • Page 385: Settimezone()

    Section 7: TSP command reference Models 707B and 708B Switching System 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.
  • Page 386: Slot[Slot].Idn

    Models 707B and 708B Switching System 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.
  • Page 387: Slot[Slot].Poles.four

    Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual Details The information that is returned depends on whether the matrix card in the slot is a physical card or pseudocard. For physical cards, this returns a comma-separated string that contains the model number, description, firmware revision, and serial number of the matrix card installed in the specified slot.
  • Page 388: Slot[Slot].Poles.one

    Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference slot[slot].poles.one This attribute indicates if a one-pole setting is supported for the channels on the specified card. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Not applicable Not applicable Not applicable...
  • Page 389: Slot[Slot].Pseudocard

    Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual Example twoPole3 = slot[3].poles.two print(twoPole3) Query to see if slot 3 supports two-pole settings for the channels on the card. Output if card supports two pole: 1.00000000000e+00 Output if card does not support two pole: Also see slot[slot].poles.one...
  • Page 390: Status.condition

    Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference Example 1 myPseudoCard = slot[3].pseudocard if myPseudoCard == 7072 then print("Pseudo-7072 in Slot #3") If slot 3 is configured to have a 7072 pseudocard, the following message is output: Pseudo-7072 in Slot #3 Example 2 slot[1].pseudocard = 0...
  • Page 391 Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual > > > > > > * Least significant bit ** Most significant bit The returned value can indicate one or more status events occurred. When an enabled status event occurs, a summary bit is set in this register to indicate the event occurrence.
  • Page 392: Status.node_Enable

    Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference In addition to the above constants, when more than one bit of the register is set, statusByte equals the sum of their decimal weights. For example, if 129 is returned, bits B0 and B7 are set (1 + 128).
  • Page 393 Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual > > > > > > * Least significant bit ** Most significant bit Assigning a value to this attribute enables one or more status events. When an enabled status event occurs, a summary bit is set in the appropriate system summary register.
  • Page 394: Status.node_Event

    Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference In addition to the above values, nodeEnableRegister can be set to the numeric equivalent of the bit to set. To set more than one bit of the register, set nodeEnableRegister to the sum of their decimal weights.
  • Page 395 Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual > > > > > > * Least significant bit ** Most significant bit The returned value can indicate one or more status events occurred. Value and description status.MEASUREMENT_SUMMARY_BIT status.MSB Set summary bit indicates that an enabled measurement event has occurred.
  • Page 396: Status.operation

    Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference Example nodeEventRegister = status.node_event print(nodeEventRegister) Reads the status node event register. 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 (MSB) and B7 (OSB).
  • Page 397 Section 7: TSP command reference Models 707B and 708B Switching System 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.
  • Page 398 Models 707B and 708B Switching System 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 + status.operation.PROG status.operation.enable = operationRegister Uses constants to set the USER and PROG bits of the Operation Status Enable Register. Example 2 -- decimal 20480 = binary 0101 0000 0000 0000 operationRegister = 20480...
  • Page 399 Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual Usage operationRegister = status.operation.user.condition operationRegister = status.operation.user.enable operationRegister = status.operation.user.event operationRegister = status.operation.user.ntr operationRegister = status.operation.user.ptr status.operation.user.condition = operationRegister status.operation.user.enable = operationRegister status.operation.user.ntr = operationRegister status.operation.user.ptr = operationRegister operationRegister The status of the operation status user register;...
  • Page 400 Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference Value Decimal value status.operation.user.BIT12 4,096 status.operation.user.BIT13 8,192 status.operation.user.BIT14 16,384 Not used Not applicable As an example, to set bit B0 of the operation status user enable register, set status.operation.user.enable = status.operation.user.BIT0.
  • Page 401: Status.questionable

    Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual status.questionable.* These attributes manage the questionable status register set of the status model. Type TSP-Link accessible Affected by Where saved Default value Attribute .condition (R) Not applicable Not saved Not applicable .enable (RW)
  • Page 402 Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference Value Decimal value B0 to B8 Not used Not available status.questionable.S1THR status.questionable.SLOT1_THERMAL status.questionable.S2THR 1,024 status.questionable.SLOT2_THERMAL status.questionable.S3THR 2,048 status.questionable.SLOT3_THERMAL status.questionable.S4THR 4,096 status.questionable.SLOT4_THERMAL status.questionable.S5THR 8,192 status.questionable.SLOT5_THERMAL status.questionable.S6THR 16,384 status.questionable.SLOT6_THERMAL Not used Not available As an example, to set bit B9 of the questionable status enable register, set...
  • Page 403: Status.request_Enable

    Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual status.request_enable This attribute stores the service request (SRQ) enable register. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Status reset Not saved Usage requestSRQEnableRegister = status.request_enable status.request_enable = requestSRQEnableRegister requestSRQEnableRegister The status of the service request (SRQ) enable register;...
  • Page 404 Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference Value status.QUESTIONABLE_SUMMARY_BIT status.QSB Set summary bit indicates that an enabled event in the Questionable Status Register has occurred. Bit B3 decimal value: 8 status.MESSAGE_AVAILABLE status.MAV Set summary bit indicates that a response message is present in the output queue. Bit B4 decimal value: 16 status.EVENT_SUMMARY_BIT status.ESB...
  • Page 405: Status.request_Event

    Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual status.request_event This attribute stores the service request (SRQ) event register. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Not applicable Not saved Usage requestSRQEventRegister = status.request_event requestSRQEventRegister The status of the request event register;...
  • Page 406 Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference Value and description status.QUESTIONABLE_SUMMARY_BIT status.QSB Set summary bit indicates that an enabled event in the Questionable Status Register has occurred. Bit B3 decimal value: 8 status.MESSAGE_AVAILABLE status.MAV Set summary bit indicates that a response message is present in the output queue.
  • Page 407: Status.reset()

    Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual 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 408 Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference 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 409 Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual Value status.standard.USER_REQUEST status.standard.URQ Set bit indicates that the LOCAL key on the instrument front panel was pressed. Bit B6 decimal value: 64 status.standard.POWER_ON status.standard.PON Set bit indicates that the instrument has been turned off and turned back on since the last time this register has been read.
  • Page 410: Status.system

    Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference 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 411 Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual Value Decimal value status.system.EXTENSION_BIT status.system.EXT status.system.NODE1 status.system.NODE2 status.system.NODE3 status.system.NODE4 status.system.NODE5 status.system.NODE6 status.system.NODE7 status.system.NODE8 status.system.NODE9 status.system.NODE10 1,024 status.system.NODE11 2,048 status.system.NODE12 4,096 status.system.NODE13 8,192 status.system.NODE14 16,384 Not used Not applicable As an example, to set bit B0 of the system summary status enable register, set status.system.enable = status.system.enable.EXT.
  • Page 412: Status.system2

    Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference Example 1 enableRegister = status.system.NODE11 + status.system.NODE14 status.system.enable = enableRegister Uses constants to set bits B11 and B14 of the system summary enable register. Example 2 -- decimal 18432 = binary 0100 1000 0000 0000 enableRegister = 18432 status.system.enable = enableRegister Uses the decimal value to set bits B11 and B14 of the system summary enable register.
  • Page 413 Section 7: TSP command reference Models 707B and 708B Switching System 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 12-1) and...
  • Page 414: Status.system3

    Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference Binary value Decimal 32,768 16,384 8,192 4,096 2,048 1,024 Weights Example 1 enableRegister = status.system2.NODE25 + status.system2.NODE28 status.system2.enable = enableRegister Uses constants to set bits B11 and B14 of the system summary 2 enable register. Example 2 -- decimal 18432 = binary 0100 1000 0000 0000 enableRegister = 18432...
  • Page 415 Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual Details In an expanded system (TSP-Link), these attributes are used to read or write to the system summary registers. They are set using a constant or a numeric value but are returned as a numeric value.
  • Page 416: Status.system4

    Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference In addition to the above constants, enableRegister can be set to the decimal value of the bit to set. To set more than one bit of the register, set enableRegister to the sum of their decimal values.
  • Page 417 Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual Usage enableRegister = status.system4.condition enableRegister = status.system4.enable enableRegister = status.system4.event enableRegister = status.system4.ntr enableRegister = status.system4.ptr status.system4.enable = enableRegister status.system4.ntr = enableRegister status.system4.ptr = enableRegister enableRegister The status of the system summary 4 register; a zero (0) indicates no bits set; other values indicate various bit settings Details In an expanded system (TSP-Link), these attributes are used to read or write to the system...
  • Page 418: Status.system5

    Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference As an example, to set bit B0 of the system summary 4 enable register, set status.system4.enable = status.system4.enable.EXT. In addition to the above constants, enableRegister can be set to the decimal value of the bit to set.
  • Page 419 Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual Usage enableRegister = status.system5.condition enableRegister = status.system5.enable enableRegister = status.system5.event enableRegister = status.system5.ntr enableRegister = status.system5.ptr status.system5.enable = enableRegister status.system5.ntr = enableRegister status.system5.ptr = enableRegister enableRegister The status of the system summary 5 register; a zero (0) indicates no bits set; other values indicate various bit settings Details In an expanded system (TSP-Link), these attributes are used to read or write to the system...
  • Page 420 Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference In addition to the above constants, enableRegister can be set to the numeric equivalent of the bit to set. To set more than one bit of the register, set enableRegister to the sum of their decimal weights.
  • Page 421: Timer.measure.t()

    Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual timer.measure.t() This function measures the elapsed time since the timer was last reset. Type TSP-Link accessible Affected by Where saved Default value Function Usage time = timer.measure.t() time The elapsed time in seconds (1 µs resolution) Example 1...
  • Page 422: Timer.reset()

    Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference timer.reset() This function resets the timer to zero (0) seconds. Type TSP-Link accessible Affected by Where saved Default value Function Usage timer.reset() Example timer.reset() -- (intervening code) time = timer.measure.t() print(time) Resets the timer and then measures the time since the reset.
  • Page 423: Trigger.blender[N].Event_Id

    Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual trigger.blender[N].EVENT_ID This constant contains the trigger blender event number. Type TSP-Link accessible Affected by Where saved Default value Constant Usage eventID = trigger.blender[N].EVENT_ID eventID Trigger event number The blender number: 1 or 2 Details Set the stimulus of any trigger object to the value of this constant to have the trigger object...
  • Page 424: Trigger.blender[N].Overrun

    Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference Example 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 Generate a trigger blender 1 event when a digital I/O trigger happens on line 3 or 5. Also see trigger.blender[N].reset() (on page 7-210)
  • Page 425: Trigger.blender[N].Reset()

    Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual trigger.blender[N].reset() This function resets some of the trigger blender settings to their factory defaults. Type TSP-Link accessible Affected by Where saved Default value Function Usage trigger.blender[N].reset() The trigger event blender: 1 or 2 Details The trigger.blender[N].reset() function resets the following attributes to their factory defaults:...
  • Page 426 Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference Details There are four acceptors that can each select a different event. The eventID parameter can be the event ID of any trigger event. The eventID parameter may be one of the existing trigger event IDs shown in the following table.
  • Page 427 Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual trigger.blender[N].wait() This function waits for a blender trigger event to occur. Type TSP-Link accessible Affected by Where saved Default value Function Usage triggered = trigger.blender[N].wait(timeout) triggered Trigger detection indication for blender The trigger blender on which to wait: 1 or 2 timeout Maximum amount of time in seconds to wait for the trigger blender event...
  • Page 428: Trigger.clear()

    Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference trigger.clear() This function clears the command interface trigger event detector. Type TSP-Link accessible Affected by Where saved Default value Function Usage trigger.clear() Details The trigger event detector indicates if a trigger event has been detected since the last trigger.wait() call.
  • Page 429: Trigger.timer[N].Clear()

    Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual trigger.timer[N].clear() This function clears the timer event detector and overrun indicator for the specified trigger timer number. Type TSP-Link accessible Affected by Where saved Default value Function Usage trigger.timer[N].clear() Trigger timer number: 1 to 4...
  • Page 430: Trigger.timer[N].Delay

    Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference Example print(trigger.timer[1].count) Read trigger count for timer number 1. Also see trigger.timer[N].clear() (on page 7-214) trigger.timer[N].delay (on page 7-215) trigger.timer[N].reset() (on page 7-219) trigger.timer[N].delay This attribute sets and reads the timer delay. Type TSP-Link accessible Affected by...
  • Page 431: Trigger.timer[N].Delaylist

    Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual trigger.timer[N].delaylist This attribute sets an array of timer intervals. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Instrument reset Create configuration script 10e-6 (10 µs) Recall setup Trigger timer N reset Usage...
  • Page 432: Trigger.timer[N].Event_Id

    Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference trigger.timer[N].EVENT_ID This constant specifies the trigger timer event number. Type TSP-Link accessible Affected by Where saved Default value Constant Usage eventID = trigger.timer[N].EVENT_ID eventID The trigger event number Trigger timer number: 1 to 4 Details This constant is an identification number that identifies events generated by this timer.
  • Page 433: Trigger.timer[N].Passthrough

    Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual Example print(trigger.timer[1].overrun) If an event was ignored, the output is true. If the event was not ignored, the output is false. Also see trigger.timer[N].reset() (on page 7-219) trigger.timer[N].passthrough This attribute enables or disables the timer trigger pass-through mode.
  • Page 434: Trigger.timer[N].Reset()

    Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference trigger.timer[N].reset() This function resets some of the trigger timer settings to their factory defaults. Type TSP-Link accessible Affected by Where saved Default value Function Usage trigger.timer[N].reset() Trigger timer number: 1 to 4 Details The trigger.timer[N].reset() function resets the following attributes to their factory defaults:...
  • Page 435 Section 7: TSP command reference Models 707B and 708B Switching System 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...
  • Page 436: Trigger.timer[N].Wait()

    Models 707B and 708B Switching System 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) triggered Trigger detection indication Trigger timer number: 1 to 4 timeout Maximum amount of time in seconds to wait for the trigger Details...
  • Page 437: Trigger.wait()

    Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual trigger.wait() This function waits for a command interface trigger event. Type TSP-Link accessible Affected by Where saved Default value Function Usage triggered = trigger.wait(timeout) triggered A trigger was detected during the timeout period: true No triggers were detected during the timeout period: false timeout Maximum amount of time in seconds to wait for the trigger...
  • Page 438: Tsplink.group

    Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference tsplink.group This attribute contains the group number of a TSP-Link node. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Power cycle Not applicable Usage groupNumber = tsplink.group tsplink.group = groupNumber groupNumber...
  • Page 439: Tsplink.node

    Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual tsplink.node This attribute defines the node number. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Not applicable Nonvolatile memory Usage nodeNumber = tsplink.node tsplink.node = nodeNumber nodeNumber The node number of the instrument or enclosure: 1 to 64 Details...
  • Page 440: Tsplink.readbit()

    Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference Example data = tsplink.readbit(3) print(data) Assume line 3 is set high and is then read. Output: 1.000000e+00 Also see tsplink.readport() (on page 7-225) tsplink.writebit() (on page 7-236) tsplink.readport() This function reads the TSP-Link trigger lines as a digital I/O port.
  • Page 441: Tsplink.reset()

    Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual tsplink.reset() This function initializes (resets) all nodes (instruments) in the TSP-Link system. Type TSP-Link accessible Affected by Where saved Default value Function Usage nodesFound = tsplink.reset() nodesFound = tsplink.reset(expectedNodes) nodesFound The number of nodes actually found on the system expectedNodes...
  • Page 442: Tsplink.state

    Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference tsplink.state This attribute describes the TSP-Link online state. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Not applicable Not applicable Not applicable Usage state = tsplink.state state TSP-Link state: online or offline Details...
  • Page 443: Tsplink.trigger[N].Clear()

    Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual Also see tsplink.trigger[N].clear() (on page 7-228) tsplink.trigger[N].mode (on page 7-229) tsplink.trigger[N].overrun (on page 7-231) tsplink.trigger[N].pulsewidth (on page 7-232) tsplink.trigger[N].release() (on page 7-232) tsplink.trigger[N].stimulus (on page 7-234) tsplink.trigger[N].wait() (on page 7-235) tsplink.trigger[N].clear() This function clears the event detector for a LAN trigger.
  • Page 444 Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference tsplink.trigger[N].EVENT_ID This constant identifies the number that is used for the trigger events. Type TSP-Link accessible Affected by Where saved Default value Constant Usage eventID = tsplink.trigger[N].EVENT_ID eventID The trigger event number The trigger line: 1 to 3...
  • Page 445 Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual Mode Number Description value tsplink.TRIG_BYPASS Allows direct control of the line as a digital I/O line. tsplink.TRIG_FALLING Detects falling-edge triggers as input. Asserts a TTL-low pulse for output. tsplink.TRIG_RISING If the programmed state of the line is high, the tsplink.TRIG_RISING mode behaves similarly to...
  • Page 446: Tsplink.trigger[N].Overrun

    Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference Also see digio.writebit() (on page 7-65) digio.writeport() (on page 7-66) tsplink.trigger[N].assert() (on page 7-227) tsplink.trigger[N].clear() (on page 7-228) tsplink.trigger[N].overrun (on page 7-231) tsplink.trigger[N].release() (on page 7-232) tsplink.trigger[N].reset() (on page 7-233) tsplink.trigger[N].stimulus (on page 7-234)
  • Page 447: Tsplink.trigger[N].Pulsewidth

    Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual 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 Attribute (RW) Reset Create configuration script 10e-6 (10 µs)
  • Page 448: Tsplink.trigger[N].Reset()

    Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference Also see tsplink.trigger[N].assert() (on page 7-227) tsplink.trigger[N].clear() (on page 7-228) tsplink.trigger[N].mode (on page 7-229) tsplink.trigger[N].overrun (on page 7-231) tsplink.trigger[N].pulsewidth (on page 7-232) tsplink.trigger[N].stimulus (on page 7-234) tsplink.trigger[N].wait() (on page 7-235) tsplink.trigger[N].reset() This function resets some of the TSP-Link trigger attributes to their factory defaults.
  • Page 449 Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual tsplink.trigger[N].stimulus This attribute specifies the event that causes the synchronization line to assert a trigger. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Reset Create configuration script Recall setup TSP-Link trigger N reset...
  • Page 450: Tsplink.trigger[N].Wait()

    Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference Also see tsplink.trigger[N].assert() (on page 7-227) tsplink.trigger[N].reset() (on page 7-233) tsplink.trigger[N].wait() This function waits for a trigger. Type TSP-Link accessible Affected by Where saved Default value Function Usage triggered = tsplink.trigger[N].wait(timeout) triggered...
  • Page 451: Tsplink.writebit()

    Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual tsplink.writebit() This function sets a TSP-Link trigger line high or low. Type TSP-Link accessible Affected by Where saved Default value Function Usage tsplink.writebit(N, data) The trigger line: 1 to 3 data The value to write to the bit: ▪...
  • Page 452: Tsplink.writeprotect

    Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference Details The binary representation of data indicates the output pattern that is written to the I/O port. For example, a data value of 2 has a binary equivalent of 010. Line 2 is set high (1) and the other two lines are set low (0).
  • Page 453: Tspnet.clear()

    Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual Also see tsplink.readbit() (on page 7-224) tsplink.readport() (on page 7-225) tsplink.writebit() (on page 7-236) tsplink.writeport() (on page 7-236) tspnet.clear() This function clears any pending output data from the instrument. Type TSP-Link accessible Affected by...
  • Page 454: Tspnet.connect()

    Models 707B and 708B Switching System 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")
  • Page 455: Tspnet.disconnect()

    Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual Example 2 instrumentID = tspnet.connect("192.0.2.1", 1394, "*rst\r\n") if instrumentID then -- Use instrumentID as needed here tspnet.disconnect(instrumentID) Connect to a device that is not TSP-enabled. Also see localnode.prompts (on page 7-129) localnode.showerrors...
  • Page 456: Tspnet.execute()

    Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference tspnet.execute() This function sends a command string to the remote device. Type TSP-Link accessible Affected by Where saved Default value Function Usage tspnet.execute("connectionID", "commandString") value1 = tspnet.execute("connectionID", "commandString", formatString) value1, value2 = tspnet.execute("connectionID", "commandString", formatString) value1, ..., valueN = tspnet.execute("connectionID", "commandString", formatString) connectionID...
  • Page 457: Tspnet.idn()

    Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual Also see tspnet.connect() (on page 7-239) tspnet.read() (on page 7-243) tspnet.termination() (on page 7-245) tspnet.write() (on page 7-250) tspnet.idn() This function retrieves the response of the remote device to *IDN?. Type TSP-Link accessible Affected by...
  • Page 458: Tspnet.read()

    Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference tspnet.read() This function reads data from a remote device. Type TSP-Link accessible Affected by Where saved Default value Function Usage value1 = tspnet.read(connectionID) value1 = tspnet.read(connectionID, formatString) value1, value2 = tspnet.read(connectionID, formatString) value1, ..., valueN = tspnet.read(connectionID, formatString) value1...
  • Page 459: Tspnet.readavailable()

    Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual Also see tspnet.connect() (on page 7-239) tspnet.readavailable() (on page 7-244) tspnet.timeout (on page 7-246) tspnet.write() (on page 7-250) tspnet.readavailable() This function checks if output data is available from the remote device. Type TSP-Link accessible Affected by...
  • Page 460 Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference Details This command disconnects all remote instruments connected through TSP-Net. For TSP-enabled devices, this causes any commands or scripts running remotely to be terminated. Also see None tspnet.termination() This function sets the device line termination sequence.
  • Page 461: Tspnet.timeout

    Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual tspnet.timeout This attribute sets the timeout value for the tspnet.connect(), tspnet.execute(), and tspnet.read() commands. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Instrument reset Create configuration script 20.0 (20 s) Recall setup...
  • Page 462: Tspnet.tsp.abortonconnect

    Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference Example tspnet.tsp.abort(testConnection) Stops remote instrument execution on testConnection. Also see None tspnet.tsp.abortonconnect This attribute contains the setting for abort on connect to a TSP-enabled instrument. Type TSP-Link accessible Affected by Where saved Default value...
  • Page 463: Tspnet.tsp.rbtablecopy()

    Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual tspnet.tsp.rbtablecopy() This function copies a reading buffer synchronous table from a remote instrument to a TSP-enabled instrument. Type TSP-Link accessible Affected by Where saved Default value Function Usage table = tspnet.tsp.rbtablecopy(connectionID, "name") table = tspnet.tsp.rbtablecopy(connectionID, "name", startIndex, endIndex)
  • Page 464: Tspnet.tsp.runscript()

    Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference tspnet.tsp.runscript() This function loads and runs a script on a remote TSP-enabled instrument. Type TSP-Link accessible Affected by Where saved Default value Function Usage tspnet.tsp.runscript(connectionID, "script") tspnet.tsp.runscript(connectionID, "name", "script") connectionID Integer value used as an identifier for other tspnet commands name...
  • Page 465: Tspnet.write()

    Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual tspnet.write() This function writes a string to the remote instrument. Type TSP-Link accessible Affected by Where saved Default value Function Usage tspnet.write(connectionID, "inputString") connectionID The connection ID returned from tspnet.connect() inputString The string to be written Details...
  • Page 466: Userstring.catalog()

    Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference 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.
  • Page 467: Userstring.delete()

    Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual Example 1 for name in userstring.catalog() do userstring.delete(name) Deletes all user-defined strings in nonvolatile memory. Example 2 userstring.add("assetnumber", "236") userstring.add("product", "Widgets") userstring.add("contact", "John Doe") for name in userstring.catalog() do print(name ..
  • Page 468: Userstring.get()

    Models 707B and 708B Switching System Reference Manual Section 7: TSP command reference Also see userstring.add() (on page 7-250) userstring.catalog() (on page 7-251) userstring.get() (on page 7-253) userstring.get() This function retrieves a user-defined string from nonvolatile memory. Type TSP-Link accessible Affected by Where saved Default value...
  • Page 469 Section 7: TSP command reference Models 707B and 708B Switching System Reference Manual Details There are two types of instrument commands: • Overlapped commands: Commands that allow the execution of subsequent commands while instrument operations of the overlapped command are still in progress. •...
  • Page 470: In This Section

    Section 8 Work with the 4200-SCS or 4200A-SCS In this section: Introduction ................8-1 Equipment required to run the example ........8-1 Configure Model 707B or 708B for 4200-SCS or 4200A-SCS . 8-2 Add Model 707B or 708B to 4200A-SCS ......... 8-2 Add Model 707B or 708B to 4200-SCS ........
  • Page 471: Configure Model 707B Or 708B For 4200-Scs Or 4200A-Scs

    Section 8: Work with the 4200-SCS or 4200A-SCS Models 707B and 708B Switching System Reference Manual Configure Model 707B or 708B for 4200-SCS or 4200A-SCS To use the Model 707B or 708B with the 4200-SCS or 4200A-SCS, you need to configure the Model 707B or 708B to use compatible 707B and 708B commands.
  • Page 472 Models 707B and 708B Switching System Reference Manual Section 8: Work with the 4200-SCS or 4200A-SCS To add the 707B and 708B to a 4200A-SCS: 1. Connect the Model 707B or 708B to the GPIB controller on the 4200A-SCS. 2. Ensure that the Model 707B or 708B has a GPIB address that is different than any other instrument connected to the 4200A-SCS and is different than the address of the GPIB controller.
  • Page 473 Section 8: Work with the 4200-SCS or 4200A-SCS Models 707B and 708B Switching System Reference Manual 9. Select the GPIB Address from the list. Addresses that are in use are displayed with asterisks (*) next to them. The range of addresses is 0 to 30 (GPIB address 31 is reserved as the Models 707B and 708B controller address).
  • Page 474 Models 707B and 708B Switching System Reference Manual Section 8: Work with the 4200-SCS or 4200A-SCS 15. In the System Configuration list, expand the switching matrix. 16. Select the card. The properties are displayed. Each row and column has a list to set the card properties.
  • Page 475: Add Model 707B Or 708B To 4200-Scs

    Section 8: Work with the 4200-SCS or 4200A-SCS Models 707B and 708B Switching System Reference Manual Add Model 707B or 708B to 4200-SCS Use these instructions to add a Model 707B or 708B to a 4200-SCS. To add the 707B or 708B to the 4200-SCS: 1.
  • Page 476: Additional Information

    Models 707B and 708B Switching System Reference Manual Section 8: Work with the 4200-SCS or 4200A-SCS Additional information For the 4200A-SCS, refer to the Clarius Learning Center “Using switch matrices” topics and the video “Configuring a Series 700 switch matrix in KCon.” For the 4200-SCS, refer to the Model 4200-SCS Reference Manual, “Appendix B: Using Switch Matrices,”...
  • Page 477 Section 9 Work with the Series 2600B In this section: About the Series 2600B examples ........... 9-1 Equipment required to run the examples ......... 9-3 Connect the equipment ............9-3 Logical block diagram of test connections ........ 9-5 Example 1: Control with separate interfaces ......9-5 Example 2: Use TSP-Link to configure instruments ....
  • Page 478 Section 9: Work with the Series 2600B Models 707B and 708B Switching System Reference Manual Example 2 shows you how to use TSP-Link to configure the Series 2600B and Model 707B or 708B instruments. This example: • Can be run using TSB Embedded. •...
  • Page 479: Equipment Required To Run The Examples

    Models 707B and 708B Switching System Reference Manual Section 9: Work with the Series 2600B Equipment required to run the examples To run this test, you need the following equipment: • Six diodes with triaxial connections. • One Model 707B or 708B. •...
  • Page 480 Section 9: Work with the Series 2600B Models 707B and 708B Switching System Reference Manual All triaxial connections for both the SMU and the diodes are made to the center conductor (pin) of the triaxial connector. Figure 86: Connections to matrix card 707B-901-01 Rev.
  • Page 481: Logical Block Diagram Of Test Connections

    Models 707B and 708B Switching System Reference Manual Section 9: Work with the Series 2600B Logical block diagram of test connections The following figure shows the logical block diagram of the test connections. Figure 87: Logical block diagram of test connections Example 1: Control with separate interfaces This example controls Series 2600B and Model 707B or 708B instruments using separate communications interfaces.
  • Page 482: Set Up Communications

    Section 9: Work with the Series 2600B Models 707B and 708B Switching System Reference Manual Set up communications The communications setup is shown in the following figure. GPIB is used as an example, but this application can be run using any of the supported communications interfaces for the instruments.
  • Page 483 Models 707B and 708B Switching System Reference Manual Section 9: Work with the Series 2600B Example program code for the Model 2635B Send the following commands to configure the Model 2635B System SourceMeter Instrument. Example program code for the Model 2635B System SourceMeter Instrument Code Notes and comments reset()
  • Page 484: Example 2: Use Tsp-Link To Configure Instruments

    Section 9: Work with the Series 2600B Models 707B and 708B Switching System Reference Manual Example program code to run the test Model Code Notes and comments smua.trigger.initiate() 2635B Initiate sweep. waitcomplete() Wait until sweep is complete, then smua.source.output = smua.OUTPUT.OFF turn off the output.
  • Page 485 Models 707B and 708B Switching System Reference Manual Section 9: Work with the Series 2600B To configure the TSP-Link communications interface, each instrument must have a unique TSP-Link node number. Configure the node number for the Model 707B or 708B to 1 and the SourceMeter Instrument to 2.
  • Page 486: Example Program Code

    Section 9: Work with the Series 2600B Models 707B and 708B Switching System Reference Manual Example program code The following example code to configure the Model 707B or 708B and System SourceMeter Instrument is identical to the code used in Example 1. However, in this example, all commands are sent to the Model 707B or 708B.
  • Page 487: Example Code To Run The Test

    Models 707B and 708B Switching System Reference Manual Section 9: Work with the Series 2600B Example code to run the test To run the test, send the following commands to the Model 707B or 708B. Example program code to run the test Code Notes and comments node[2].smua.source.output =...
  • Page 488: Example 3: Configuration Using Tsp-Link And Interactive Triggers

    Section 9: Work with the Series 2600B Models 707B and 708B Switching System Reference Manual Example 3: Configuration using TSP-Link and interactive triggers This example uses a TSP script to configure and run the test. The script includes two separate functions for configuring the Model 707B or 708B and SMU and a third function for running the test.
  • Page 489: Example Program Code

    Models 707B and 708B Switching System Reference Manual Section 9: Work with the Series 2600B Figure 90: TSP-Link interface Example program code In the following table, all commands are sent from the computer to the Model 707B or 708B. This example can be run using TSB Embedded. The Model 707B or 708B sends all commands in the shaded rows to the SMU through the TSP-Link interface.
  • Page 490 Section 9: Work with the Series 2600B Models 707B and 708B Switching System Reference Manual Example program code for the Model 707B or 708B Code Notes and comments tsplink.trigger[1].mode = tsplink.TRIG_FALLING Set TSP-Link lines 1 and 2 to send tsplink.trigger[2].mode = tsplink.TRIG_FALLING and receive falling-edge triggers.
  • Page 491: Program Code To Run The Test

    Models 707B and 708B Switching System Reference Manual Section 9: Work with the Series 2600B Example program code for the Model 707B or 708B Code Notes and comments function runDiodeTest() This function sequences the crosspoint closures and triggering. xptTable = configSwitch() Call the function to configure the switch storing the result in the variable xptTable.
  • Page 492: Example 4: Use The Scan And Trigger Model

    Section 9: Work with the Series 2600B Models 707B and 708B Switching System Reference Manual Example 4: Use the scan and trigger model This example demonstrates how to use the scan and trigger model of the Model 707B or 708B to maximize the speed of the test by preconfiguring the sequence of crosspoints used. This example uses a TSP script to configure the instruments for testing.
  • Page 493 Models 707B and 708B Switching System Reference Manual Section 9: Work with the Series 2600B Example program code for the Model 707B or 708B Code Notes and comments loadscript diodeTest Create a script diodeTest to contain test configuration and execution instructions. function configSwitch() Create a function to configure the Model 707B or 708B.
  • Page 494 Section 9: Work with the Series 2600B Models 707B and 708B Switching System Reference Manual Example program code for the Model 707B or 708B Code Notes and comments function configSMU() Create a function to configure the SMU. node[2].reset() Reset the instrument. node[2].errorqueue.clear() Clear all errors and reset status bits.
  • Page 495: Program Code To Run The Test

    Models 707B and 708B Switching System Reference Manual Section 9: Work with the Series 2600B Example program code for the Model 707B or 708B Code Notes and comments function runDiodeTest() This function sequences the crosspoint closures and triggering. configSwitch() Call function to configure the Model 707B or 708B.
  • Page 496: Use Background Scans For Longer Scan Lists

    Section 9: Work with the Series 2600B Models 707B and 708B Switching System Reference Manual Use background scans for longer scan lists The previous example demonstrates use of the scan and trigger model to create a foreground scan. While running a foreground scan, you must wait for the scan to complete or you must abort the scan before you can query the instrument state or any reading buffers.
  • Page 497 Models 707B and 708B Switching System Reference Manual Section 9: Work with the Series 2600B Program code example function runDiodeTest() configSwitch() configSMU() node[2].smua.source.output = node[2].smua.OUTPUT_ON node[2].smua.trigger.initiate() scan.background() delay(2) scanState, scanCount, stepCount = scan.state() print(scanState, " ", scanCount, " ", stepCount, " ") while scanState ~=6 do delay(1) node[2].smua.source.output = node[2].smua.OUTPUT_OFF...
  • Page 498: In This Section

    Section 10 Work with the Series 2400 In this section: About the Series 2400 examples ........... 10-1 Equipment required to run the examples ....... 10-1 Connect the equipment ............10-2 Logical block diagram of test connections ......10-3 Example 1: Individual commands for switch-measure ... 10-3 Example 2: Digital I/O triggering for switch-measure synchronization ....................
  • Page 499: Connect The Equipment

    Section 10: Work with the Series 2400 Models 707B and 708B Switching System Reference Manual Connect the equipment To run the test, make the connections as shown in the following figure. All triaxial connections for the SMU and the diodes are made to the center conductor (pin) of the triaxial connector.
  • Page 500: Logical Block Diagram Of Test Connections

    Models 707B and 708B Switching System Reference Manual Section 10: Work with the Series 2400 Logical block diagram of test connections The following figure shows the logical block diagram of the test connections. Figure 91: Test system block diagram Example 1: Individual commands for switch-measure In this example, individual commands are sent to the Model 707B or 708B and SMU to perform switch closure and measure actions.
  • Page 501 Section 10: Work with the Series 2400 Models 707B and 708B Switching System Reference Manual Send the following commands to configure the 2400. Example program code for the Model 2400 SourceMeter Instrument Code Notes and comments *RST Reset the instrument. *CLS Clear all errors and reset status bits.
  • Page 502: Example 2: Digital I/O Triggering For Switch-Measure Synchronization

    Models 707B and 708B Switching System Reference Manual Section 10: Work with the Series 2400 Example program code to run the test Model Code Notes and comments :OUTP:STAT ON 2400 Turn on the output of the SMU. channel.exclusiveclose("1A01,1B02") 707B or 708B Connect first diode.
  • Page 503 Section 10: Work with the Series 2400 Models 707B and 708B Switching System Reference Manual Send the following commands to configure the Model 2400 SourceMeter Instrument. Example program code for the Model 2400 SourceMeter Instrument Code Notes and comments *RST Reset the instrument.
  • Page 504 Models 707B and 708B Switching System Reference Manual Section 10: Work with the Series 2400 Example program code for the Model 707B or 708B function setup70xChanList() Create a function that sets up the Model 707B or 708B and the list of channels to be reset() used in the test.
  • Page 505: Alternate Method To Create A List Of Crosspoints

    Section 10: Work with the Series 2400 Models 707B and 708B Switching System Reference Manual Alternate method to create a list of crosspoints The following code creates a list of crosspoints that can be used in a test. This code replaces chanTable in the previous example code.
  • Page 506: Troubleshooting Guide

    Section 11 Troubleshooting guide In this section: Introduction ................11-1 Error and status messages ............ 11-1 Troubleshoot USB communications ........11-2 Troubleshoot GPIB interfaces ..........11-4 Troubleshoot LAN interfaces ..........11-5 Test the display, keys, and channel matrix ......11-9 Update drivers ..............
  • Page 507: Troubleshooting Guide

    Section 11: Troubleshooting guide Models 707B and 708B Switching System Reference Manual Retrieve errors When errors occur, the error messages are placed in the error queue. Use errorqueue commands to request error message information. For example, the following commands request the complete set of information about the next message in the error queue. They return the code, message, severity, and node for that error: errorCode, message, severity, errorNode = errorqueue.next() print(errorCode, message, severity, errorNode)
  • Page 508: Check Driver For The Usb Test And Measurement Device

    Models 707B and 708B Switching System Reference Manual Section 11: Troubleshooting guide Check driver for the USB Test and Measurement Device 1. Open Device Manager. From the Start menu, you can enter devmgmt.msc in the Run box or the Windows search box to start Device Manager. 2.
  • Page 509: Troubleshoot Gpib Interfaces

    Section 11: Troubleshooting guide Models 707B and 708B Switching System Reference Manual Figure 93: Driver File Details dialog 8. If the incorrect driver is installed, select OK. 9. If this does not work, uninstall VISA, unplug the instrument, and follow the steps to reinstall VISA in the section Modify, repair, or remove Keithley I/O Layer software.
  • Page 510: Timeout Errors

    Models 707B and 708B Switching System Reference Manual Section 11: Troubleshooting guide Timeout errors If your GPIB controller is recognized by the operating system, but you get a timeout error when you try to communicate with the instrument, check the following: 1.
  • Page 511: Use Ping To Test The Connection

    Section 11: Troubleshooting guide Models 707B and 708B Switching System Reference Manual Use ping to test the connection Ping is a computer network administration utility that you can use to test whether a particular host can be reached across an Internet Protocol (IP) network. It also measures the round- trip time for packets sent from the local host to a destination computer, including the interfaces of the local host.
  • Page 512: Web Page Problems

    Models 707B and 708B Switching System Reference Manual Section 11: Troubleshooting guide Web page problems All LXI instruments have a web server. The LAN configuration information on these pages is mandated by the LXI consortium. For Keithley instruments that are compliant with LXI, the standard LXI pages use standard HTML.
  • Page 513: Initialize The Lan Configuration

    Section 11: Troubleshooting guide Models 707B and 708B Switching System Reference Manual When diagnosing a LAN connection issue with an LXI instrument, see if the LAN status indicator is signaling a valid or fault condition. If there is an error, you cannot communicate with the instrument through the LAN connection.
  • Page 514: Wireshark

    Models 707B and 708B Switching System Reference Manual Section 11: Troubleshooting guide WireShark WireShark is an open source LAN packet sniffer. You can run it to spy on all the packets going across a network. It allows you to filter what you spy on so that you can narrow the content down to just what you are interested in.
  • Page 515: Verify Crosspoint Display Operation (707B Only)

    Support contact information If you have any questions after reviewing this information, please contact your local Tektronix office, sales partner, or distributor. You can also call the Tektronix corporate headquarters (toll-free inside the U.S. and Canada only) at 1-800-833-9200. For worldwide contact numbers, visit tek.com/contact-tek.
  • Page 516: Overview

    Section 12 Status model In this section: Overview ................12-1 Status register set contents ............ 12-1 Summary bit ................12-2 Queues .................. 12-2 Status model diagrams ............12-3 Status function summary ............12-13 Reset and clear registers ............. 12-13 Startup state ................. 12-14 Program enable and transition registers ......
  • Page 517: Summary Bit

    Section 12: Status model Models 707B and 708B Switching System Reference Manual • Negative Transition Register (NTR) (.ntr): When a bit is set in this read-write register, it enables a 1 to 0 change in the corresponding bit of the condition register to cause the corresponding bit in the event register to be set.
  • Page 518: Output Queue

    Models 707B and 708B Switching System Reference Manual Section 12: Status model Status Byte Register overview (on page 12-4) shows how the queues are structured with the other registers. Output queue When the instrument is in the remote state, the output queue holds data that pertains to the normal operation of the instrument.
  • Page 519: Status Byte Register Diagram

    Section 12: Status model Models 707B and 708B Switching System Reference Manual Status Byte Register diagram The Status Byte Register receives summary bits from the other status register sets and queues, and also from itself (which sets the Master Summary Status, or MSS, bit). Figure 94: Status Byte Register Measurement summary bit (Measurement event register) The summary bit of the measurement event register provides enabled summary information...
  • Page 520: System Summary Bit (System Register)

    Models 707B and 708B Switching System Reference Manual Section 12: Status model System summary bit (System register) The summary bit of the system register provides enabled summary information to Bit B1 (SSB) of the status byte. Figure 95: System summary bit (System Register) 707B-901-01 Rev.
  • Page 521 Section 12: Status model Models 707B and 708B Switching System Reference Manual As shown above, there are five register sets associated with System Event Status. These registers summarize system status for the nodes connected to TSP-Link. All nodes on TSP- Link share a copy of the system summary registers once TSP-Link has been initialized.
  • Page 522: Error Available Bit (Error Or Event Queue)

    Models 707B and 708B Switching System Reference Manual Section 12: Status model Error available bit (Error or Event queue) The summary bit of the error or event queue provides enabled summary information to Bit B2, Error Available (EAV) bit, of the status byte. The EAV bit is set when a message defining an error or status is placed in the error or event queue.
  • Page 523: Questionable Summary Bit (Questionable Event Register)

    Section 12: Status model Models 707B and 708B Switching System Reference Manual Questionable summary bit (Questionable event register) The summary bit of the questionable event register provides enabled summary information to Bit B3 (QSB) of the status byte. Figure 96: Questionable summary bit (Questionable Event Register) As shown above, there is only one register set associated with the questionable status.
  • Page 524: Message Available Bit (Output Queue)

    Models 707B and 708B Switching System Reference Manual Section 12: Status model Message available bit (Output queue) The summary bit of the output queue provides enabled summary information to Bit B4, Message Available (MAV), of the status byte. The MAV bit is set when the Output queue holds data that pertains to the normal operation of the instrument.
  • Page 525 Section 12: Status model Models 707B and 708B Switching System Reference Manual For example, any of the following statements set the operation complete enable bit: standardRegister = status.standard.OPC status.questionable.enable = status.standard.OPERATION_COMPLETE status.questionable.enable = 1 The bits used in this register set are described as follows: •...
  • Page 526: Master Summary Status Bit (Mss Bit Register)

    Models 707B and 708B Switching System Reference Manual Section 12: Status model Master summary status bit (MSS bit register) The master summary status bit provides summary information to Bit B6 (MSS) of the status byte. Although this bit is always enabled for the status byte, it has to be enabled (using status.node_enable) if needed in an expanded system (TSP-Link).
  • Page 527 Section 12: Status model Models 707B and 708B Switching System Reference Manual The bits used in this register set are described as follows: • Bits B1 to B10: Not used. • Bit B11, Remote Summary (REM): Set bit indicates that an enabled bit in the Operation Status Remote Summary Register is set.
  • Page 528: Status Function Summary

    Models 707B and 708B Switching System Reference Manual Section 12: Status model Status function summary The following functions and attributes control and read the registers. Additional information is included in the command listings for the register sets. Status function summary Type Function or attribute System summary...
  • Page 529: Startup State

    Section 12: Status model Models 707B and 708B Switching System Reference Manual Startup state When the Model 707B or 708B is turned on, register status elements are set as follows: • The power on (PON) bit in the status.operation.condition register is set. •...
  • Page 530: Read Registers

    Models 707B and 708B Switching System Reference Manual Section 12: Status model Read registers You can read any register in the status structure either by sending the common command query (where applicable), or by including the script command for that register in the print() or print(tostring()) command.
  • Page 531: Service Request Enable Register

    Section 12: Status model Models 707B and 708B Switching System Reference Manual Two 8-bit registers control service requests: The Status Byte Register and the Service Request Enable Register. See Status Byte Register (on page 12-16) for a description of the structure of these registers.
  • Page 532 Models 707B and 708B Switching System Reference Manual Section 12: Status model Figure 100: Status byte and service request (SRQ) The bits of the Status Byte Register are described as follows: • Bit B0, Measurement Summary Bit (MSB): Set summary bit indicates that an enabled measurement event has occurred.
  • Page 533: Serial Polling And Srq

    Section 12: Status model Models 707B and 708B Switching System Reference Manual • Bit B5, Event Summary Bit (ESB): Set summary bit indicates that an enabled standard event has occurred. • Bit B6, Request Service (RQS)/Master Summary Status (MSS): Set bit indicates that an enabled summary bit of the Status Byte Register is set.
  • Page 534: Serial Polling And Spe And Spd

    Models 707B and 708B Switching System Reference Manual Section 12: Status model Serial polling and SPE and SPD For the GPIB interface only, the SPE and SPD general bus commands are used to serial poll the Switching System. Serial polling obtains the serial poll byte (status byte). Typically, the controller uses serial polling to determine which of several instruments has requested service with the SRQ line.
  • Page 535: Enable And Transition Registers

    Section 12: Status model Models 707B and 708B Switching System Reference Manual Enable and transition registers In general, there are three types of user-writable registers that are used to configure which bits feed the register summary bit and when it occurs. The registers are identified in each applicable command (as listed in TSP commands (on page 7-7)) as follows:...
  • Page 536: Status Model Configuration Example

    Models 707B and 708B Switching System Reference Manual Section 12: Status model Status model configuration example The following example illustrates the status model configuration for a TSP-Link system. In this example, a Node 15 thermal aspect event will set the RQS bit of the Status Byte of the master Node.
  • Page 537 Section 12: Status model Models 707B and 708B Switching System Reference Manual System registers: The following commands enable the required system summary bits for Node 15: status.system2.enable = status.system2.NODE15 status.system.enable = status.system.EXT The affected system registers for the above commands are indicated by labels (3) and (4) in the following figure.
  • Page 538: Migrate From Models 707A And 708A

    Section 13 Migrate from Models 707A and 708A In this section: Migrate Model 707A or 708A programs to Model 707B or 708B13-1 Platform differences ............... 13-2 DDC to TSP command equivalencies ........13-3 Migrate Model 707A or 708A programs to Model 707B or 708B This section provides information about migrating existing programs from the Model 707A or 708A to use the TSP programming syntax on the Model 707B or 708B.
  • Page 539: Platform Differences

    Section 13: Migrate from Models 707A and 708A Models 707B and 708B Switching System Reference Manual Platform differences When writing a script for the Model 707B or 708B instrument, consider the following platform differences. Model 707A or 708A Model 707B or 708B Execution host A computer sends commands A computer sends either commands or...
  • Page 540: Ddc To Tsp Command Equivalencies

    Models 707B and 708B Switching System Reference Manual Section 13: Migrate from Models 707A and 708A DDC to TSP command equivalencies In many cases, DDC commands have a single corresponding TSP equivalent command that performs the same or a similar function. In some cases, more than one TSP command is needed to provide the same functionality of its equivalent DDC counterpart because of the expanded capabilities and additional flexibility of the TSP scripting environment.
  • Page 541: Disable Or Enable The Scan Event Trigger

    Section 13: Migrate from Models 707A and 708A Models 707B and 708B Switching System Reference Manual There are some distinct differences between relay setups and scans: • Scans can only be accessed sequentially. Unlike relay setups, you cannot specify an alternate starting location.
  • Page 542: Trigger Polarity

    Models 707B and 708B Switching System Reference Manual Section 13: Migrate from Models 707A and 708A Trigger polarity The Model 707A or 708A instrument has one external trigger input that can 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 543: Set Front-Panel Display

    Section 13: Migrate from Models 707A and 708A Models 707B and 708B Switching System Reference Manual Example: Channel close with matrix-ready functionality function chanClose(chan) digio.writebit(10,0) channel.close(chan) digio.writebit(10,1) Function accepts valid channels as arguments. Clear the 10th digital I/O bit before the close operation. Close the channels in the argument.
  • Page 544: Gpib Eoi Hold Off Control

    Models 707B and 708B Switching System Reference Manual Section 13: Migrate from Models 707A and 708A GPIB EOI hold off control The Kn DDC command controls how the GPIB EOI line behaves. The Model 707B or 708B commands are processed from an internal buffer as they are received, so no control is required for the GPIB EOI line.
  • Page 545: Additional Channel Settling Time

    Section 13: Migrate from Models 707A and 708A Models 707B and 708B Switching System Reference Manual Additional channel settling time The Model 707A or 708A had the ability to add relay settling time to the system after a channel closes or opens. The Model 707B or 708B improves on the settling time and allows you to apply additional settling delay on a per-channel basis.
  • Page 546: Send Machine Status Word

    Models 707B and 708B Switching System Reference Manual Section 13: Migrate from Models 707A and 708A Send machine status word The DDC U0 command provides information on several areas of the Model 707A or 708A instrument in one long csv form. There is no one command to provide the same functionality as the U0 command, but the series of Model 707B or 708B commands shown in the following table can be used to provide similar information, without the need to parse a long unwieldy string.
  • Page 547: Number Of Subordinates

    Section 13: Migrate from Models 707A and 708A Models 707B and 708B Switching System Reference Manual Number of subordinates You can add the Model 707B or 708B to a TSP-Link system to communicate with other Keithley products that are enabled for TSP-Link. When the command listed in the following table is executed, it returns the number of nodes present in the TSP-Link system.
  • Page 548: Connect Rules

    Models 707B and 708B Switching System Reference Manual Section 13: Migrate from Models 707A and 708A Connect rules On the Model 707B or 708B, this command sets the connect rules for the entire instrument. You cannot set this rule on a row-by-row basis. If this feature is required, the high performance of the Model 707B or 708B instrument provides ample time to change the connection rules as needed before channel close or open operations.
  • Page 549: Models 707A And 708A Compatibility Mode

    Section 14 Models 707A and 708A compatibility mode In this section: Use Models 707A and 708A compatibility mode ....14-1 Model A to Model B differences ..........14-1 Models 707A and 708A commands ........14-4 Use Models 707A and 708A compatibility mode This document provides information about using the Models 707B and 708B as a drop-in replacement in an existing Keithley Model 707A or 708A application.
  • Page 550: Front-Panel Relay Closure Indicators

    Section 14: Models 707A and 708A compatibility mode Models 707B and 708B Switching System Reference Manual When using 707A or 708A compatibility mode, the only compatible remote interface is GPIB. You can select one of two options when enabling Model 707A or 708A DDC compatibility mode: •...
  • Page 551: Digital Interface

    Models 707B and 708B Switching System Reference Manual Section 14: Models 707A and 708A compatibility mode Digital interface When you are using Model 707A or 708A compatibility mode, the digital I/O is fixed as follows: • Digital input: Digital I/O lines 1 to 6 •...
  • Page 552: Models 707A And 708A Commands

    Section 14: Models 707A and 708A compatibility mode Models 707B and 708B Switching System Reference Manual Models 707A and 708A commands Models 707A and 708A commands Command Description Differences in 707B and 708B Edge for which an None. externally generated pulse executes a trigger Select logic sense of Actual matrix ready signal may have different timing...
  • Page 553 Models 707B and 708B Switching System Reference Manual Section 14: Models 707A and 708A compatibility mode Models 707A and 708A commands Command Description Differences in 707B and 708B Delete setup None. Restore defaults None. Programmable settle time Works as intended in 70xB-VERSION. For 70xA-VERSION, settle time is always zero (0).
  • Page 554: Next Steps

    Section 15 Next steps In this section: Additional 707B and 708B information ........15-1 Additional 707B and 708B information For additional information about the Model 707B or 708B, refer to tek.com/keithley, which contains the most up-to-date information. From the website, you can access: •...
  • Page 555 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 • 28775 Aurora Road • Cleveland, Ohio 44139 • 1-800-833-9200 • tek.com/keithley 04/2022...

This manual is also suitable for:

Keithley 707b