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.
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 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 .......................
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.
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.
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.
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.
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: •...
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.
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.
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.
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.
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.
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.
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.
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.
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. ▪...
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()
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...
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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).
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.
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.
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.
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.
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.
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.
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;...
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.
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 ........
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.
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.
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.
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.
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.
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.
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: •...
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.
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.
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.
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.
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.
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...
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.
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.
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.
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.
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.
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.
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 •...
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) •...
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.
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.
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.
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 •...
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.
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.
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.
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.
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.
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: •...
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.
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. •...
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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: •...
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()
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()
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.
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()
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()
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.
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.
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()
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()
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 .................
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.
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.
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"...
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.
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).
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.
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...
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...
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)).
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.
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...
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.
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 >...
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.
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 •...
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.
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.
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.
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.
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.
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.
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...
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. •...
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.
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).
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.
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.
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.
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.
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.
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.
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.
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.
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-->...
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.
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 •...
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...
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.
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.
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.
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.
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.
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.
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...
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...
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...
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...
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.
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...
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...
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...
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)
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...
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...
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...
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.
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...
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)
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...
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...
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...
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...
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()
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.
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) ▪...
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.
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.
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)
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.
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.
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...
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.
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.
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) •...
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: ▪...
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.
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.
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.
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.
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)
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.
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...
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.
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.
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...
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...
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.
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: "...
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)
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.
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.
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.
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.
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.
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.
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.
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.
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...
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...
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.
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...
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...
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.
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)
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.
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...
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...
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...
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.
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;...
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: ▪...
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...
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)
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...
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...
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...
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...
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)
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...
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...
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)
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.
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...
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¤...
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.
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...
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.
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.
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.
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"...
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...
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.
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...
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.
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...
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...
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...
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.
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...
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).
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...
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...
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...
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()
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.
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:...
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.
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"...
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.
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.
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.
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...
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...
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.
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...
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...
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.
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: •...
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...
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...
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...
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.
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())
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.
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...
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).
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...
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...
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 ▪...
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.
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.
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.
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...
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)
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...
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.
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...
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...
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...
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;...
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...
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.
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.
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.
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()
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.
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.
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.
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.
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()
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"...
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.
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...
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.
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.
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.
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...
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...
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.
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.
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.
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.
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...
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...
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.
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.
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.
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...
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.
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...
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.
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...
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.
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...
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)
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...
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.
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...
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...
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...
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.
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.
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...
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...
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...
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...
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...
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.
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...
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...
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...
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)
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)
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...
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...
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: ▪...
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).
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...
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")
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...
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...
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...
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...
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.
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...
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...
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)
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...
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...
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.
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 ..
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. •...
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 ........
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.
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.
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. •...
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.
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.
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()
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.
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.
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 =...
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.
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.
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.
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.
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.
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...
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 ....................
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.
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.
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.
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.
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 ..............
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)
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.
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.
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.
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.
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.
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.
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.
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.
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 ......
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.
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.
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...
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.
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.
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.
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: •...
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.
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...
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. •...
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.
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.
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.
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.
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:...
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.
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.
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...
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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: •...
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 •...
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).
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...
Need help?
Do you have a question about the KEITHLEY 708B and is the answer not in the manual?
Questions and answers