Tektronix KEITHLEY 707B User manual

www.keithley.com
Reference Manual
707B-901-01 Rev. B / January 2015
*P707B90101B*
707B-901-01
A Tektr onix Company
A Greater Measure of Condence
Models 707B and 708B Switching Matrix

Switching Matrix
Reference Manual
© 2015, Keithley Instruments
Cleveland, Ohio, U.S.A.
All rights reserved.
Any unauthorized reproduction, photocopy, or use of the information herein, in whole or in part,
without the prior written approval of Keithley Instruments is strictly prohibited.
TSPTM, TSP-LinkTM, and TSP-NetTM are trademarks of Keithley Instruments, Inc. All Keithley
Instruments product names are trademarks or registered trademarks of Keithley Instruments. Other
brand names are trademarks or registered trademarks of their respective holders.
The Lua 5.0 software and associated documentation files are copyright © 1994-2008, Tecgraf,
PUC-Rio. Terms of license for the Lua software and associated documentation can be accessed at
the Lua licensing site (http://www.lua.org/license.html).
Document number: 707B-901-01 Rev. B / January 2015
Models 707B and 708B

Safety precautions
The following safety precautions should be observed before using this product and any associated instrumentation. Although
some instruments and accessories would normally be used with nonhazardous voltages, there are situations where hazardous
conditions may be present.
This product is intended for use by qualified personnel who recognize shock hazards and are familiar with the safety precautions
required to avoid possible injury. Read and follow all installation, operation, and maintenance information carefully before using
the product. Refer to the user documentation for complete product specifications.
If the product is used in a manner not specified, the protection provided by the product warranty may be impaired.
The types of product users are:
Responsible body is the individual or group responsible for the use and maintenance of equipment, for ensuring that the
equipment is operated within its specifications and operating limits, and for ensuring that operators are adequately trained.
Operators use the product for its intended function. They must be trained in electrical safety procedures and proper use of the
instrument. They must be protected from electric shock and contact with hazardous live circuits.
Maintenance personnel perform routine procedures on the product to keep it operating properly, for example, setting the line
voltage or replacing consumable materials. Maintenance procedures are described in the user documentation. The procedures
explicitly state if the operator may perform them. Otherwise, they should be performed only by service personnel.
Service personnel are trained to work on live circuits, perform safe installations, and repair products. Only properly trained
service personnel may perform installation and service procedures.
Keithley Instruments products are designed for use with electrical signals that are measurement, control, and data I/O
connections, with low transient overvoltages, and must not be directly connected to mains voltage or to voltage sources with high
transient overvoltages. Measurement Category II (as referenced in IEC 60664) connections require protection for high transient
overvoltages often associated with local AC mains connections. Certain Keithley measuring instruments may be connected to
mains. These instruments will be marked as category II or higher.
Unless explicitly allowed in the specifications, operating manual, and instrument labels, do not connect any instrument to mains.
Exercise extreme caution when a shock hazard is present. Lethal voltage may be present on cable connector jacks or test
fixtures. The American National Standards Institute (ANSI) states that a shock hazard exists when voltage levels greater than
30 V RMS, 42.4 V peak, or 60 VDC are present. A good safety practice is to expect that hazardous voltage is present in any
unknown circuit before measuring.
Operators of this product must be protected from electric shock at all times. The responsible body must ensure that operators
are prevented access and/or insulated from every connection point. In some cases, connections must be exposed to potential
human contact. Product operators in these circumstances must be trained to protect themselves from the risk of electric shock. If
the circuit is capable of operating at or above 1000 V, no conductive part of the circuit may be exposed.
Do not connect switching cards directly to unlimited power circuits. They are intended to be used with impedance-limited
sources. NEVER connect switching cards directly to AC mains. When connecting sources to switching cards, install protective
devices to limit fault current and voltage to the card.
Before operating an instrument, ensure that the line cord is connected to a properly-grounded power receptacle. Inspect the
connecting cables, test leads, and jumpers for possible wear, cracks, or breaks before each use.
When installing equipment where access to the main power cord is restricted, such as rack mounting, a separate main input
power disconnect device must be provided in close proximity to the equipment and within easy reach of the operator.
For maximum safety, do not touch the product, test cables, or any other instruments while power is applied to the circuit under
test. ALWAYS remove power from the entire test system and discharge any capacitors before: connecting or disconnecting
cables or jumpers, installing or removing switching cards, or making internal changes, such as installing or removing jumpers.
Do not touch any object that could provide a current path to the common side of the circuit under test or power line (earth)
ground. Always make measurements with dry hands while standing on a dry, insulated surface capable of withstanding the
voltage being measured.
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, as defined in the specifications and operating
information, and as shown on the instrument or test fixture panels, or switching card.
When fuses are used in a product, replace with the same type and rating for continued protection against fire hazard.
Chassis connections must only be used as shield connections for measuring circuits, NOT as protective earth (safety ground)
connections.
If you are using a test fixture, keep the lid closed while power is applied to the device under test. Safe operation requires the use
of a lid interlock.
If a screw is present, connect it to protective earth (safety ground) using the wire recommended in the user documentation.
The symbol on an instrument means caution, risk of danger. The user must refer to the operating instructions located in the
user documentation in all cases where the symbol is marked on the instrument.
The symbol on an instrument means caution, risk of electric shock. Use standard safety precautions to avoid personal
contact with these voltages.
The symbol on an instrument shows that the surface may be hot. Avoid personal contact to prevent burns.
The symbol indicates a connection terminal to the equipment frame.
If this symbol is on a product, it indicates that mercury is present in the display lamp. Please note that the lamp must be
properly disposed of according to federal, state, and local laws.
The WARNING heading in the user documentation explains dangers that might result in personal injury or death. Always read
the associated information very carefully before performing the indicated procedure.
The CAUTION heading in the user documentation explains hazards that could damage the instrument. Such damage may
invalidate the warranty.
Instrumentation and accessories shall not be connected to humans.
Before performing any maintenance, disconnect the line cord and all test cables.
To maintain protection from electric shock and fire, replacement components in mains circuits — including the power
transformer, test leads, and input jacks — must be purchased from Keithley Instruments. Standard fuses with applicable national
safety approvals may be used if the rating and type are the same. Other components that are not safety-related may be
purchased from other suppliers as long as they are equivalent to the original component (note that selected parts should be
purchased only through Keithley Instruments to maintain accuracy and functionality of the product). If you are unsure about the
applicability of a replacement component, call a Keithley Instruments office for information.
To clean an instrument, use a damp cloth or mild, water-based cleaner. Clean the exterior of the instrument only. Do not apply
cleaner directly to the instrument or allow liquids to enter or spill on the instrument. Products that consist of a circuit board with
no case or chassis (e.g., a data acquisition board for installation into a computer) should never require cleaning if handled
according to instructions. If the board becomes contaminated and operation is affected, the board should be returned to the
factory for proper cleaning/servicing.
Safety precaution revision as of January 2013.

Introduction...............................................................................................................1-1
Contact information.............................................................................................................. 1-1
Overview .............................................................................................................................. 1-1
Extended warranty............................................................................................................... 1-1
General operation.....................................................................................................2-1
Rear panel overview ............................................................................................................ 2-1
Model 707B Rear panel ............................................................................................................2-2
Model 708B Rear panel ............................................................................................................2-2
Wiring................................................................................................................................... 2-2
Communication connections.....................................................................................................2-3
Digital I/O port...........................................................................................................................2-7
Power-up............................................................................................................................ 2-10
Line power connection............................................................................................................2-10
Power-up sequence................................................................................................................2-10
Front-panel operation......................................................................................................... 2-11
Model 707B front panel...........................................................................................................2-11
Model 708B front panel...........................................................................................................2-11
Display....................................................................................................................................2-12
Crosspoint display (Model 707B only).....................................................................................2-14
Selecting channels from the front panel..................................................................................2-15
Keys and navigation wheel......................................................................................................2-16
Menu options...........................................................................................................................2-19
Remote communications interfaces................................................................................... 2-22
USB communications..............................................................................................................2-23
GPIB setup.............................................................................................................................. 2-30
LAN communications..............................................................................................................2-35
Supplied software....................................................................................................................2-56
Keithley I/O layer.....................................................................................................................2-57
Addressing instruments with VISA..........................................................................................2-61
Using the web interface...................................................................................................... 2-66
Introduction .............................................................................................................................2-66
Card pages..............................................................................................................................2-68
Scan Builder page...................................................................................................................2-71
TSB Embedded.......................................................................................................................2-75
Admin page.............................................................................................................................2-77
Unit page.................................................................................................................................2-77
LXI page..................................................................................................................................2-78
Switch operation................................................................................................................. 2-80
Working with channels............................................................................................................2-80
Reset a channel......................................................................................................................2-97
Pseudocards...........................................................................................................................2-98
Save the present configuration................................................................................................2-98
Functions and features ............................................................................................3-1
Scanning and triggering....................................................................................................... 3-1
Trigger model....................................................................................................................... 3-1
Table of Contents

Table of Contents
Models 707B and 708B Switching Matrix
Reference Manual
Trigger model components........................................................................................................3-3
Trigger model events and associated commands.....................................................................3-3
Scan and step counts........................................................................................................... 3-4
Basic scan procedure........................................................................................................... 3-5
Changing attributes of an existing scan ....................................................................................3-6
Front-panel scanning ................................................................................................................3-6
Foreground and background scan execution............................................................................3-7
Include multiple channels in a single scan step.........................................................................3-7
Remote interface scanning .................................................................................................. 3-8
Scan and trigger commands .....................................................................................................3-8
Scanning examples...................................................................................................................3-9
Hardware trigger modes..................................................................................................... 3-13
Falling edge trigger mode .......................................................................................................3-14
Rising edge master trigger mode............................................................................................3-15
Rising edge acceptor trigger mode .........................................................................................3-15
Either edge trigger mode.........................................................................................................3-16
Understanding synchronous triggering modes .................................................................. 3-17
Synchronous master trigger mode..........................................................................................3-17
Synchronous acceptor trigger mode .......................................................................................3-19
Synchronous trigger mode......................................................................................................3-19
Events ................................................................................................................................ 3-21
Event blenders........................................................................................................................ 3-21
Theory of operation..................................................................................................4-1
Theory of operation.............................................................................................................. 4-1
Models 707B and 708B theory of operations overview............................................................. 4-1
Mainframe.................................................................................................................................4-1
Front panel................................................................................................................................4-5
Introduction to TSP operation..................................................................................5-1
Introduction to TSP operation .............................................................................................. 5-1
Controlling the instrument by sending individual command messages.....................................5-1
Queries .....................................................................................................................................5-3
Data retrieval commands..........................................................................................................5-3
Information on scripting and programming................................................................................ 5-3
About TSP commands......................................................................................................... 5-3
Beeper control...........................................................................................................................5-3
Bit manipulation and logic operations........................................................................................5-4
channel functions and attributes................................................................................................5-4
createconfigscript function.........................................................................................................5-7
Data queue................................................................................................................................5-7
delay function............................................................................................................................5-7
Digital I/O..................................................................................................................................5-8
Display......................................................................................................................................5-8
Error queue............................................................................................................................... 5-8
eventlog functions and attributes...............................................................................................5-9
exit function...............................................................................................................................5-9
Queries and response messages..............................................................................................5-9
GPIB .........................................................................................................................................5-9
LAN and LXI............................................................................................................................5-10
Local node...............................................................................................................................5-11
make accessor functions.........................................................................................................5-11
memory functions....................................................................................................................5-11

Models 707B and 708B
Switching Matrix Reference Manual Table
of Contents
opc function.............................................................................................................................5-11
print functions..........................................................................................................................5-11
Reset.......................................................................................................................................5-11
Scan........................................................................................................................................5-12
Scripting..................................................................................................................................5-12
Slot..........................................................................................................................................5-13
Status model functions............................................................................................................5-13
timer functions......................................................................................................................... 5-13
trigger functions and attributes................................................................................................5-14
TSP-Link .................................................................................................................................5-14
TSP-Net .................................................................................................................................. 5-15
Userstrings..............................................................................................................................5-15
waitcomplete function..............................................................................................................5-15
Overview of instrument drivers .......................................................................................... 5-16
Instrument driver types............................................................................................................5-16
VXIPnP drivers........................................................................................................................5-17
Interchangeable Virtual Instruments (IVI) style drivers............................................................5-17
LabVIEW drivers.....................................................................................................................5-18
Getting instrument drivers.......................................................................................................5-18
Instrument driver examples.....................................................................................................5-18
Migrating from Models 707A and 708A.............................................................................. 5-19
Migrating Model 707A or 708A programs to Model 707B or 708B..........................................5-19
DDC to ICL command equivalencies ......................................................................................5-20
Instrument programming .........................................................................................6-1
Fundamentals of scripting for TSP....................................................................................... 6-1
Fundamentals of scripting for TSP............................................................................................6-1
Fundamentals of programming for TSP............................................................................. 6-10
Introduction .............................................................................................................................6-10
What is Lua?...........................................................................................................................6-11
Lua basics...............................................................................................................................6-11
Standard libraries....................................................................................................................6-25
Programming example: Script with a for loop..........................................................................6-29
Using Test Script Builder (TSB)......................................................................................... 6-31
Installing the TSB software......................................................................................................6-32
Project navigator.....................................................................................................................6-33
Script editor.............................................................................................................................6-33
Programming interaction.........................................................................................................6-33
Advanced scripting for TSP ............................................................................................... 6-33
Global variables and the script.user.scripts table....................................................................6-33
Create a script using the script.new() command.....................................................................6-35
Rename a script......................................................................................................................6-37
Retrieve a user script..............................................................................................................6-39
Delete user scripts from the instrument...................................................................................6-41
Restore a script to the run-time environment..........................................................................6-42
Memory considerations for the run-time environment.............................................................6-42
TSP-Link system and running simultaneous test scripts................................................... 6-44
TSP-Link system.....................................................................................................................6-44
TSP-Link nodes.......................................................................................................................6-44
Connect the TSP-Link cable....................................................................................................6-44
Initialization .............................................................................................................................6-46
Using TSP to run test scripts simultaneously..........................................................................6-48
TSP-Net ............................................................................................................................. 6-52
Overview.................................................................................................................................6-52
TSP-Net Capabilities...............................................................................................................6-52

Table of Contents
Models 707B and 708B Switching Matrix
Reference Manual
Using TSP-Net with any Ethernet-enabled device ..................................................................6-53
TSP-Net compared to TSP-Link to communicate with TSP-enabled devices.........................6-54
TSP-Net instrument commands: General device control ........................................................6-54
TSP-Net instrument commands: TSP-enabled device control................................................6-54
Example: Using tspnet commands..........................................................................................6-55
TSP command reference..........................................................................................7-1
Command programming notes ............................................................................................ 7-1
Placeholder text ........................................................................................................................7-1
Syntax rules ..............................................................................................................................7-2
Logical instruments...................................................................................................................7-3
Time and date values................................................................................................................ 7-3
Using the TSP command reference..................................................................................... 7-4
Command name and standard parameters summary...............................................................7-4
Command usage.......................................................................................................................7-5
Command details......................................................................................................................7-6
Example section........................................................................................................................7-6
Related commands and information..........................................................................................7-7
Instrument Control Library (ICL) command reference......................................................... 7-8
beeper.beep()............................................................................................................................7-8
beeper.enable...........................................................................................................................7-8
bit.bitand().................................................................................................................................7-9
bit.bitor().................................................................................................................................... 7-9
bit.bitxor()................................................................................................................................ 7-10
bit.clear().................................................................................................................................7-11
bit.get().................................................................................................................................... 7-11
bit.getfield().............................................................................................................................7-12
bit.set()....................................................................................................................................7-13
bit.setfield()..............................................................................................................................7-14
bit.test()...................................................................................................................................7-14
bit.toggle()...............................................................................................................................7-15
channel.clearforbidden() .........................................................................................................7-16
channel.close()........................................................................................................................7-17
channel.connectrule................................................................................................................7-18
channel.connectsequential......................................................................................................7-19
channel.createspecifier()......................................................................................................... 7-20
channel.exclusiveclose()......................................................................................................... 7-22
channel.exclusiveslotclose()....................................................................................................7-23
channel.getclose()...................................................................................................................7-24
channel.getcount() ..................................................................................................................7-25
channel.getdelay()...................................................................................................................7-26
channel.getforbidden()............................................................................................................7-27
channel.getlabel()....................................................................................................................7-28
channel.getlabelcolumn()........................................................................................................7-30
channel.getlabelrow()..............................................................................................................7-31
channel.getstate() ...................................................................................................................7-32
channel.gettype() ....................................................................................................................7-33
channel.open()........................................................................................................................7-33
channel.pattern.catalog() ........................................................................................................7-35
channel.pattern.delete()..........................................................................................................7-36
channel.pattern.getimage().....................................................................................................7-36
channel.pattern.setimage()......................................................................................................7-37
channel.pattern.snapshot()......................................................................................................7-39
channel.reset()........................................................................................................................7-40
channel.setdelay()...................................................................................................................7-41
channel.setforbidden() ............................................................................................................7-42
channel.setlabel()....................................................................................................................7-43
channel.setlabelcolumn()........................................................................................................7-44

Models 707B and 708B
Switching Matrix Reference Manual Table
of Contents
channel.setlabelrow()..............................................................................................................7-46
createconfigscript()..................................................................................................................7-47
dataqueue.add()......................................................................................................................7-48
dataqueue.CAPACITY ............................................................................................................7-49
dataqueue.clear()....................................................................................................................7-49
dataqueue.count .....................................................................................................................7-50
dataqueue.next().....................................................................................................................7-51
delay().....................................................................................................................................7-52
digio.readbit()..........................................................................................................................7-52
digio.readport()........................................................................................................................7-53
digio.trigger[N].assert()............................................................................................................7-53
digio.trigger[N].clear()..............................................................................................................7-54
digio.trigger[N].EVENT_ID ......................................................................................................7-54
digio.trigger[N].mode............................................................................................................... 7-55
digio.trigger[N].overrun............................................................................................................ 7-57
digio.trigger[N].pulsewidth.......................................................................................................7-57
digio.trigger[N].release()..........................................................................................................7-58
digio.trigger[N].reset() .............................................................................................................7-58
digio.trigger[N].stimulus........................................................................................................... 7-59
digio.trigger[N].wait()............................................................................................................... 7-61
digio.writebit()..........................................................................................................................7-61
digio.writeport() .......................................................................................................................7-62
digio.writeprotect.....................................................................................................................7-63
display.clear()..........................................................................................................................7-63
display.getannunciators()........................................................................................................7-64
display.getcursor()...................................................................................................................7-65
display.getlastkey() .................................................................................................................7-66
display.gettext()....................................................................................................................... 7-67
display.inputvalue().................................................................................................................7-68
display.loadmenu.add()...........................................................................................................7-70
display.loadmenu.catalog().....................................................................................................7-71
display.loadmenu.delete()....................................................................................................... 7-72
display.locallockout .................................................................................................................7-72
display.menu().........................................................................................................................7-73
display.prompt() ......................................................................................................................7-74
display.screen.........................................................................................................................7-75
display.sendkey()....................................................................................................................7-76
display.setcursor()...................................................................................................................7-77
display.settext().......................................................................................................................7-79
display.trigger.clear()............................................................................................................... 7-80
display.trigger.EVENT_ID .......................................................................................................7-80
display.waitkey()......................................................................................................................7-81
errorqueue.clear() ...................................................................................................................7-82
errorqueue.count.....................................................................................................................7-83
errorqueue.next() ....................................................................................................................7-83
eventlog.all()............................................................................................................................7-84
eventlog.clear() .......................................................................................................................7-85
eventlog.count.........................................................................................................................7-86
eventlog.enable.......................................................................................................................7-86
eventlog.next() ........................................................................................................................7-87
eventlog.overwritemethod.......................................................................................................7-88
exit()........................................................................................................................................7-88
format.asciiprecision ...............................................................................................................7-89
format.byteorder......................................................................................................................7-89
format.data..............................................................................................................................7-90
gettimezone()..........................................................................................................................7-92
gpib.address............................................................................................................................7-92
lan.applysettings()...................................................................................................................7-93
lan.config.dns.address[N]........................................................................................................7-94
lan.config.dns.domain.............................................................................................................7-95
lan.config.dns.dynamic............................................................................................................7-95