background image

Section 6: Instrument programming 

Models 707B and 708B Switching Matrix Reference Manual 

 

6-52 

707B-901-01 Rev. B / January 2015 

 

Removing stale values from the reading buffer cache 

The node that acquires the data also stores the data for the reading buffer. To optimize data access, 
all nodes can cache data from the node that stores the reading buffer data. 

When you run Lua code remotely, it can cause reading buffer data that is held in the cache to 
become stale. If the values in the reading buffer change while the Lua code runs remotely, another 
node can hold stale values. Use the 

clearcache()

 command to clear the cache. 

 

The following example code demonstrates how stale values occur and how to use the

 

clearcache()

 command to clear the cache on node 2, which is part of group 7. 

 
 

TSP-Net 

Overview 

TSP-Net allows the Model 707B or 708B to control Ethernet-enabled devices directly through its LAN 
port. This enables the Model 707B or 708B to communicate directly with a device that is not TSP

®

-

enabled without the use of a controlling computer. 

 

TSP-Net Capabilities 

For both Test Script Processor (TSP

®

) and non-TSP devices, the TSP-Net

®

 library permits the Model 

707B or 708B to control a remote device through the LAN port. Using TSP-Net methods, you can 
transfer string data to and from a remote device, transfer and format data into Lua variables, and 
clear input buffers. TSP-Net is only accessible using Instrument Control Library (ICL) commands from 
a remote command interface and is not available from the front panel.  

You can use TSP-Net to communicate with any Ethernet-enabled device. However, specific TSP-Net 
commands exist for TSP-enabled devices to allow for support of features unique to TSP. These 
features include script downloads, reading buffer access, wait completion, and handling of TSP 
prompts.  

Using TSP-Net with TSP-enabled instruments, a Model 707B or 708B can download a script to 
another TSP-enabled device and have both devices run scripts independently. The Model 707B or 
708B can read the data from the remote device and either manipulate the data or send the data to a 
different remote device on the LAN. You can simultaneously connect to a maximum of 32 devices 
using standard TCP/IP networking techniques through the LAN port of the Model 707B or 708B. 

 

Summary of Contents for KEITHLEY 707B

Page 1: ...www keithley com Reference Manual 707B 901 01 Rev B January 2015 P707B90101B 707B 901 01 A Tektronix Company A Greater Measure of Confidence Models 707B and 708B Switching Matrix...

Page 2: ...ks 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...

Page 3: ......

Page 4: ...tegory 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 presen...

Page 5: ...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...

Page 6: ...cting 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...

Page 7: ...ger 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 operat...

Page 8: ...r 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 fo...

Page 9: ...y 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 bi...

Page 10: ...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...

Page 11: ...clear 7 108 lan trigger N connect 7 109 lan trigger N connected 7 109 lan trigger N disconnect 7 110 lan trigger N EVENT_ID 7 111 lan trigger N ipaddress 7 111 lan trigger N mode 7 112 lan trigger N...

Page 12: ...r list 7 162 scriptVar name 7 162 scriptVar run 7 163 scriptVar save 7 164 scriptVar source 7 165 settime 7 165 settimezone 7 166 slot X idn 7 168 slot X poles four 7 169 slot X poles one 7 170 slot X...

Page 13: ...ink trigger N mode 7 220 tsplink trigger N overrun 7 222 tsplink trigger N pulsewidth 7 223 tsplink trigger N release 7 223 tsplink trigger N reset 7 224 tsplink trigger N stimulus 7 224 tsplink trigg...

Page 14: ...ront panel key operation 8 9 Verify display operation 8 9 Verify crosspoint display operation 707B only 8 10 Update drivers 8 10 Contacting support 8 10 Frequently asked questions 9 1 Frequently asked...

Page 15: ...nd 708B Switching Matrix Reference Manual Status function summary C 13 Clearing registers C 13 Startup state C 14 Programming and reading registers C 14 Status byte and service request SRQ C 16 TSP Li...

Page 16: ...nt matrix capability and let you control up to 576 matrix crosspoints in real time Their large matrix format makes them well suited for your large ATE system applications such as semiconductor device...

Page 17: ......

Page 18: ...he slot with a slot cover For model and firmware version information on the installed cards press the SLOT key IEEE 488 IEEE 488 GPIB connector See GPIB quick start on page 2 31 Digital I O Digital in...

Page 19: ...ar panel Figure 1 Model 707B rear panel Model 708B Rear panel Figure 2 Model 708B full rear panel Wiring This section describes communication digital I O and power connections Note that all signal wir...

Page 20: ...ns for the communication interfaces To properly set up the communications interfaces after connection see the information in Remote communications interfaces on page 4 4 Connect the USB cable To conne...

Page 21: ...raight through cable The instrument automatically senses which cable you have connected The location of the LAN connector on the instrument is shown below The TSP Link connectors will accept a LAN con...

Page 22: ...st system with multiple instruments Figure 7 IEEE 488 connections To avoid possible mechanical damage stack no more than three connectors on any one instrument To minimize interference caused by elect...

Page 23: ...nnected to an IEEE 488 bus including the controller The maximum cable length is either two meters 6 5 feet multiplied by the number of devices or 20 meters 65 6 feet whichever is less Erratic bus oper...

Page 24: ...nk connection Figure 10 Model 707B rear panel TSP Link connection Digital I O port The Models 707B and 708B have a digital input output port that can be used to control external digital circuitry For...

Page 25: ...el 707A or 708A see Using Models 707A and 708A compatibility mode on page B 1 Connecting cables Use a cable equipped with a standard male DB 25 connector Keithley Instruments part number CA 126 1 Digi...

Page 26: ...write protect specific digital I O lines to prevent their values from being changed 1 Press the MENU key then select DIGIO and then press the ENTER key or the navigation wheel 2 Select WRITE PROTECT...

Page 27: ...nadequately rated cords Failure to use properly rated cords may result in personal injury or death due to electric shock Operating the instrument on an incorrect line voltage may cause damage to the i...

Page 28: ...and navigation wheel The LAN status indicator The POWER button You can use the keys displays and the navigation wheel to change the selected channel or channel pattern You can also use them to access...

Page 29: ...between the display of the channel or pattern the closed channel list or a screen message During setup the display shows menu choices that you can use to configure the instrument Display during opera...

Page 30: ...e column 4 Turn the wheel to go to a new column 5 Press the navigation wheel or ENTER when selection is complete The new channel is displayed After CLS on the lower line of the display the closed chan...

Page 31: ...w of the cards in the instrument s slots Figure 17 Model 707B slot indicators The red lights indicate closed channels If a red light is on a channel in that slot is closed If the red light is not lit...

Page 32: ...age 2 91 You can also open and close channels by pressing CHAN to use the CHANNEL ACTION menu options on page 2 20 Selecting channels from the front panel From the front panel you can change the displ...

Page 33: ...or to change the selected value Push the navigation wheel to open menus or to select a menu option or a value In most cases pressing the navigation wheel performs the same action as pressing the ENTE...

Page 34: ...attern CLOSE Closes the selected channel or channel pattern LOAD Loads code or scripts that can be run from the front panel RUN Runs the last code or script selected through the LOAD key INS Appends t...

Page 35: ...del See Scanning and triggering on page 3 1 Also see display trigger EVENT_ID on page 7 80 MENU Opens the Main menu options on page 2 22 which allows you to manage scripts manage communications select...

Page 36: ...you to set up and run the instrument LOAD TEST menu options Allows you to run scripts and code from the front panel that you created through the communication interface or configuration scripts create...

Page 37: ...ows you to bypass the trigger for the first step of the first scan See Trigger model on page 3 1 for more information MODE Selects how the scan initializes the instrument when the scan is executed Cho...

Page 38: ...ted slots VIEW Displays the channels that are in the selected pattern DELETE Deletes the channel pattern RESET Displays options that allow you to reset the channels in the selected channel pattern to...

Page 39: ...ls are opened and closed and select whether to connect sequentially Connection methods for close operations on page 2 82 DISPLAY Verify operation of the keys display and crosspoint display LEDs Testin...

Page 40: ...ww ni com website Using USB A USB cable is shipped with the instrument If the original cable is not available you will need a USB cable with a USB Type B connector end and a USB type A connector end Y...

Page 41: ...Rev B January 2015 To use the Keithley Configuration Panel to determine the VISA resource string 1 Start the Keithley Configuration Panel The Select Operation dialog box is displayed 2 Select Add Figu...

Page 42: ...witching Matrix Reference Manual Section 2 General operation 707B 901 01 Rev B January 2015 2 25 Figure 22 Select Communication Bus dialog box 4 Select USB 5 Click Next The Select Instrument Driver di...

Page 43: ...B 901 01 Rev B January 2015 Figure 23 Select Instrument Driver dialog box 6 Select Auto detect Instrument Driver Model 7 Click Next The Configure USB Instrument dialog box is displayed with the detect...

Page 44: ...isplayed Figure 25 Name Virtual Instrument dialog box 9 In the Virtual Instrument Name box enter a name that you want to use to refer to the instrument 10 Click Finish 11 Click Cancel to close the Wiz...

Page 45: ...Section 2 General operation Models 707B and 708B Switching Matrix Reference Manual 2 28 707B 901 01 Rev B January 2015 Figure 26 Keithley Communicator Open an Instrument...

Page 46: ...a full version of NI VISA on your system you can run NI MAX or the VISA Interactive Utility See their documentation for information If you have the Agilent IO Libraries on your system you can run Agil...

Page 47: ...power supply and can supply up to 500 mA per port USB 2 0 USB VISA identifiers The USB identifiers to communicate with your Keithley instrument using VISA are 707B USB0 0x05E6 0x707B serial number IN...

Page 48: ...the hardware This prevents associating the incorrect driver to the hardware Install the GPIB cards in your computer Refer to the documentation from the GPIB controller vendor for information about in...

Page 49: ...ll and tighten the screws securely making sure not to overtighten them The following figure shows the location of the connector Figure 30 Model 707B rear panel IEEE 488 connection Connect any addition...

Page 50: ...When the GPIB bus is operating you can use the gpib address on page 7 92 attribute to change the GPIB address remotely Enable GPIB By default the instrument is set to GPIB enabled You only need to ena...

Page 51: ...on the instrument GPIB USB LAN VXI 11 and raw socket it is good practice to add a line feed to the end of the outgoing command Use VISA and the same program will work with all the I O buses by changi...

Page 52: ...ng a LAN connection To do this you will 1 Identify and record network settings 2 Configure the network settings on the computer and instrument 3 Create a direct instrument to PC LAN connection 4 Set u...

Page 53: ...tomatically 2 Click OK Close the network settings dialog boxes Configure the instrument to obtain an IP address automatically 1 From the front panel of the instrument press the MENU key 2 Use the navi...

Page 54: ...2 37 Figure 33 Model 707B rear panel LAN connection z Wait for the LAN status indicator on the front panel to turn solid green A solid green LAN status indicator confirms that the instrument was assig...

Page 55: ...that it finds on the network and their associated IP addresses 4 Double click an IP address in the LXI Discovery Browser dialog box The instrument web page for that instrument opens LAN reference Ove...

Page 56: ...communication This means that you can connect to the TCP IP port on the instrument and send and receive commands There is no extra protocol overhead above and beyond what TCP gives you A programmer ca...

Page 57: ...tions are 10 100BaseT 10Base2 and 10BaseF which use unshielded twisted pair UTP coaxial cable and optical fiber respectively Most of Keithley s instruments work with a 10 100 BaseT network and use a s...

Page 58: ...ngle instrument With only the instruments connected to the hub this is an isolated instrumentation network However with a corporate network attached to the hub the instruments become part of the large...

Page 59: ...rough cables The hub is connected to the network interface card in the computer The network interface card and its driver must be properly installed on the computer according to the manufacturer s ins...

Page 60: ...key 2 Use the navigation wheel to select LAN CONFIG METHOD Press the navigation wheel to display the METHOD menu 3 Select MANUAL Press the navigation wheel to select your choice and return to the LAN...

Page 61: ...rovide 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 Failure to...

Page 62: ...ice the same IP address each time but that means a system administrator needs to be involved Dynamic Link local Addressing DLLA Also called Auto IP DLLA was originally used for ad hoc networks DLLA al...

Page 63: ...ID number and the last byte is the host ID on the network Host ID numbers 1 through 254 are available for assignment All hosts on the same isolated network must have the same subnet mask As a general...

Page 64: ...lable on that device The packets are usually blocked from going any further than the nearest router This limits the scope of mDNS but multicast packets are more network friendly than broadcast packets...

Page 65: ...00 Internet Protocol TCP IP Properties dialog box You can review and change IP settings in the Internet Protocol Properties dialog box To open this dialog box in Windows 2000 1 Click Start and select...

Page 66: ...n this dialog box in Windows Vista 1 Click Start and select Control Panel 2 Click Network and Internet 3 Open Network Sharing Center 4 In the list click View Status for the applicable connection The L...

Page 67: ...review and change IP settings in the Internet Protocol Version 4 TCP IPv4 dialog box To open this dialog box in Windows 7 1 Click Start and select Control Panel 2 Click Network and Sharing Center 3 C...

Page 68: ...through a DHCP server first and if this fails it will revert to Auto IP mode Manual is static IP addressing Subnet Mask Gateway DNS Server address if you are using DNS Instruments with front panel dis...

Page 69: ...h this protocol To enable or disable a VXI 11 connection 1 From the front panel press the MENU key and then select LAN ENABLE VXI11 2 Select either ON or OFF After the power cycle reminder you return...

Page 70: ...ect connection between the instrument and a host computer you can use automatic IP address selection If you select Auto the instrument attempts to get an IP address from a DHCP server If this fails it...

Page 71: ...R key when the gateway is complete The LAN CONFIG menu is displayed 11 Select SUBNET 12 Set the subnet value to match the settings of the host computer or use the value supplied by your system adminis...

Page 72: ...P address assignment using a DHCP server If this happens you need to revert to either using the front panel to set the IP address or use an automatic discovery tool to determine the new IP address You...

Page 73: ...strument connectivity I O The VISA specifications formerly maintained by the VXIplug play Systems Alliance are now being maintained by the IVI Foundation http www ivifoundation org The VISA library st...

Page 74: ...and is compliant with the latest version of the instrument programming specifications defined by the IVI Foundation The NI ICP installer installs the IVI shared components CVI runtime engine and the...

Page 75: ...nicator is a dumb terminal program that uses VISA to communicate with the instrument Computer requirements for the Keithley I O Layer The Keithley I O Layer version C02 supports the following operatin...

Page 76: ...y a screen with software installation links If you need to manually open the web page use a file explorer to navigate to the CD ROM drive and open the file named index html 4 From the web page select...

Page 77: ...detected VISA in its title bar if this can be determined Make a note of the vendor name At this point you may elect to continue the installation which will overwrite the existing VISA installation wi...

Page 78: ...nects many other installers To remove all the KIOL components you need to uninstall the following applications using Control Panel National Instruments NI TM IVI Compliance Package National Instrument...

Page 79: ...A raw socket connection requires more work by the driver or application program to make sure the correct amount of data has been sent or received correctly All Keithley instruments support the raw soc...

Page 80: ...commands Refer to your VISA documentation for more details on how to use this class The GPIB INSTR resource class format is GPIB board primary address secondary address INSTR board is the number of th...

Page 81: ...rgv ViSession defaultRM vi char buf 256 0 ViStatus error VI_SUCCESS Open session to GPIB device at address 22 checkErr viOpenDefaultRM defaultRM checkErr viOpen defaultRM GPIB0 14 INSTR VI_NULL VI_NUL...

Page 82: ...Interop namespace WindowsApplication1 public class IdnSample System Windows Forms Form private Ivi Visa Interop FormattedIO488 ioDmm private void IdnSample_Load object sender System EventArgs e ioDmm...

Page 83: ...web browser plug in Sun Java TM Runtime Environment Version 6 or higher Installation files are available from http www java com en download manual jsp http www java com en download manual jsp The Act...

Page 84: ...ages are always listed in the navigation panel on the left side of the web interface You can review information on any of the pages without logging in but to change information you must log in Pages t...

Page 85: ...Figure 45 Web interface Cards page Open and close slots from the card pages You can open and close channels from the card pages in several ways The simplest method is to click a connection The channel...

Page 86: ...ou can open all channels in a slot by clicking Open Slot You can open all channels in the instrument by clicking Open All For more information on opening and closing channels see Working with channels...

Page 87: ...numeric name When you perform close or open operations on a channel pattern only the channels that are in the channel pattern are affected There is no speed difference when performing close and open o...

Page 88: ...The rest of the instrument settings are unaffected Scan Builder page The Scan Builder page allows you to set up and run scans and triggers A scan is a series of steps that opens and closes switches s...

Page 89: ...ls and patterns in the same scan list 3 If you selected Number select the channel numbers from the list To remove your selections from the Add Channel By list click Clear Channel Selection You can use...

Page 90: ...veral ways Background Runs the scan in the background so that you can perform other tasks while the scan is running You can use the Query State to check scan status Step by Step Steps through the scan...

Page 91: ...he options to continue channel action are Immediate When immediate is selected the scan immediately steps to the next channel in the scan list This is the default setting Digital Input When selected y...

Page 92: ...channels are opened before the start of the scan You can select Open all All slots are opened Open select All channels selected in the scan list are opened any closed channels remain closed if they a...

Page 93: ...of the Console box Figure 52 Web interface console Instrument control To reset the entire TSP enabled system including the controlling node and all subordinate nodes click Reset Create a script using...

Page 94: ...d 4 Enter the Year 5 Select the Month Day Hour Minutes and Seconds from the lists 6 Click Submit The new time and date information takes effect immediately Unit page Create Config Script Save the set...

Page 95: ...ll other cards To print the report click Print To clear the report information from the screen click Clear LXI page The Model 707B or 708B is a LXI Class C instrument The LXI page is a read only page...

Page 96: ...r 8 From Displays the IP address for the device that generates the LAN trigger localhost 192 168 5 20 System Timestamp A timestamp that identifies the time the event occurred The timestamp uses the fo...

Page 97: ...el The channels on the cards that you can use with the Model 707B or 708B are referred to by a channel specifier You will use the specifier to identify channels for use with close and open operations...

Page 98: ...is a string type parameter that is used when controlling the relays of the Model 707B or 708B using a remote command interface You can specify a list of individual channels or a range of channels in t...

Page 99: ...d switch channels When the connection rule is set to make before break the instrument ensures that all switch channels close before any switch channels open This behavior should be applied with cautio...

Page 100: ...nnel connect rule through the front panel interface 1 Press the MENU key 2 Use the navigation wheel to scroll to the CHANNEL menu item 3 Press the ENTER key or the navigation wheel to display the CONN...

Page 101: ...osing relays in a sequential manner also uses minimum power Since only one relay is closed or opened at any given time the power used for that action is for a single relay and not additive By default...

Page 102: ...ycle of the card 7072 7072 HV 7173 50 7174A For all other cards the number of closures are the closures that have occurred over the lifetime of the card To view the close count for a channel from the...

Page 103: ...8x12 Fast Low I Matrix 01 00a Module Serial Number 7072 8x12 Semi Matrix 01 00a Module Serial Number Empty Slot Empty Slot Empty Slot Empty Slot Selecting a channel from the front panel You can perfo...

Page 104: ...panel operations Open and close channels from the Channel Action Menu You can also use the options in the Channel Action Menu to open and close channels To use the Channel Action Menu to open and clo...

Page 105: ...Figure 54 Web interface Cards list 3 To close a channel click the channel The display of the channel depends on the card that you have installed Some examples are shown here Figure 55 Selecting closin...

Page 106: ...pening a channel using remote commands To close or open a channel from the remote interface You can open and close channels using the following commands channel close on page 7 17 channel exclusiveclo...

Page 107: ...Channel attributes You can use the front panel and command options to set attributes for specific channels Some of the attributes you can set are adding a delay forbidding closure of a channel and se...

Page 108: ...s the navigation wheel to save the change To forbid closing of a channel from the web interface 1 From the list on the left select the slot that contains the channel you want to forbid close on 2 Righ...

Page 109: ...label on 2 Right click the channel 3 In the Label box enter the label 4 Click OK To set up labels from the remote interface Use the commands channel setlabel on page 7 43 channel setlabelrow on page 7...

Page 110: ...nels contained in the pattern create the desired path connection Make sure that channels that you want to include in the pattern are not set to forbidden to close When naming the channel pattern be aw...

Page 111: ...dialog box is displayed Figure 59 Channel pattern configuration dialog box 3 Enter a name in the box at the top 4 From the Channels Available list select the channels you want to add You can use Ctrl...

Page 112: ...il When you request a close or open operation the Model 707B or 708B verifies that the channels exist for a pattern but does not verify that the switch path connection is correct You must ensure the r...

Page 113: ...annel Close then click CLOSE Close the channels in the channel pattern and open any other closed channels on the instrument Select Exclusive Close and click CLOSE Close the channels in the channel pat...

Page 114: ...ional user delay is set to zero Labels return to default value If the channel is forbidden to close it is cleared from being forbidden to close If the channel is used in channel patterns the channel p...

Page 115: ...urn to that configuration or set it up to be the autoexec script The configuration script is a normal TSP script once created you can use it and modify it as you would any other script The configurati...

Page 116: ...1B02 Row1_2_col_2 channel pattern setimage 1A03 1B03 Row1_2_col_3 channel pattern setimage 1A04 1B04 Row1_2_col_4 channel pattern setimage 1A05 1B05 Row1_2_col_5 channel pattern setimage 1A06 1B06 Ro...

Page 117: ...t Yes or No 5 If AUTOEXEC is set to no at the name prompt enter the name of the configuration The default name is config01 6 Press ENTER 7 The AUTOEXEC message is displayed again Press EXIT several ti...

Page 118: ...nd events that occur during the scan is called the trigger model Scanning and triggering allow you to synchronize actions across channels You can set up a scan using the trigger model to precisely tim...

Page 119: ...Matrix Reference Manual 3 2 707B 901 01 Rev B January 2015 You cannot use an external trigger event for example digital I O for the channel stimulus setting of the trigger model when using the front p...

Page 120: ...n trigger is an event that tells the instrument to begin processing the next channel action You can bypass the channel action trigger if this is the first step of the first scan count Bypass is availa...

Page 121: ...and close commands have no interaction with the trigger model 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 s...

Page 122: ...ctions on the channels involved in scanning Front panel When you press the STEP key the Models 707B and 708B leave the idle state and perform the channel action associated with the first step in the s...

Page 123: ...ation use the scan list function You can clear an existing scan list before making any changes after making a scan list From the front panel press the SCAN key and select the CLEAR option For bus oper...

Page 124: ...to be removed and then press the DEL key Press the STEP key to single step through a scan list Foreground and background scan execution You can execute a scan in the foreground or background Backgroun...

Page 125: ...an trigger N assert on page 7 108 lan trigger N clear on page 7 108 lan trigger N overrun on page 7 113 lan trigger N stimulus on page 7 115 lan trigger N wait on page 7 117 scan add on page 7 136 sca...

Page 126: ...works with the scan list Number of steps Scan count value Total number of step channel closures 3 1 default 3 each step channel once 1A05 1B05 1C05 3 2 6 each step channel twice 1A05 1B05 1C05 then 1A...

Page 127: ...s Models 707B and 708B Switching Matrix Reference Manual 3 10 707B 901 01 Rev B January 2015 The following represents a script you can enter using the TSB Embedded page on the web to experiment with t...

Page 128: ...e ScanCount StepCount scan state Get the current scan state information print ScanState ScanCount StepCount Show the state of scanning delay 3 Delay 3 seconds to allow viewing of state print state sca...

Page 129: ...000 3 000000000e 000 Shows scan is running state 2 and just completed step 3 for scan count of 1 2 000000000e 000 2 000000000e 000 1 000000000e 000 Shows scan is running state 2 and just completed st...

Page 130: ...rigger overrun Falling edge High Low Falling Rising edge N A N A N A The programmed state of the line determines if the behavior is similar to RisingA or RisingM High similar to RisingA Low similar to...

Page 131: ...tes low pulses and detects all falling edges The following graphic illustrates the characteristics for the falling edge input trigger Figure 63 Falling edge input trigger Input characteristics Detects...

Page 132: ...t trigger detection is not available in this trigger mode You can use the RisingM trigger mode to generate rising edge pulses The RisingM trigger mode does not function properly if the line is driven...

Page 133: ...gure 67 RisingA output trigger Output characteristics When the trigger is asserted generates a low pulse that is similar to the falling edge trigger mode Either edge trigger mode The either edge trigg...

Page 134: ...mode or the non Keithley equivalent Configure all other nodes in the test system to SynchronousA trigger mode or a non Keithley equivalent Synchronous master trigger mode Use the synchronous master t...

Page 135: ...ng edges are input triggers When all external drives release the physical line the rising edge is detected as an input trigger A rising edge cannot be detected until all external drives release the li...

Page 136: ...mode Figure 72 SynchronousA input trigger Input characteristics The falling edge is detected as the external drive pulses the line low and the internal drive latches the line low Figure 73 Synchronou...

Page 137: ...e low Figure 75 Synchronous output trigger Output characteristics When the trigger is asserted it generates a low pulse for the programmed pulse duration If the line is latched low a falling edge does...

Page 138: ...several events or all of several events An event blender provides for this combining or blending of events An event blender can combine up to four events in either an or mode or an and mode When in o...

Page 139: ......

Page 140: ...e 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 c...

Page 141: ...onsider 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 rms and 42 4 V peak or 60 V dc for equipment...

Page 142: ...are damage Of course read and follow all safety warnings provided with the specific instruments to keep system users safe For Model 707B or 708B also see Safety Precautions on page 1 1 Instrument fan...

Page 143: ...Bus USB Local area network LAN General Purpose Interface Bus GPIB or IEEE 488 Trigger and control interfaces You can use rear panel connections to control external digital circuits and instruments th...

Page 144: ...g items The display The crosspoint display Model 707B only The keys and navigation wheel The LAN status indicator The POWER button You can use the keys displays and the navigation wheel to change the...

Page 145: ...lay open or closures or other actions For details on indicators and additional options see Crosspoint display Model 707B only on page 2 14 Figure 80 Model 707B crosspoint display block diagram Descrip...

Page 146: ...he data changes and a command from the instrument is issued to update the label 12 x 12 LED matrix The 12 x 12 matrix array of LEDs is driven by PWM signals that cause the intensity of the LED to be b...

Page 147: ...the watchdog shuts down the display the first several row labels show SLOT GRID LEDS OFF Description of basic display operation This display board is a subordinate device to the microprocessor board...

Page 148: ...control in the way that works best for your test application Controlling the instrument by sending individual command messages The simplest method of controlling an instrument through the communicatio...

Page 149: ...or assigned to another variable To set the characteristics attribute based commands define a value For many attributes the value is in the form of a number or a predefined constant Example 1 Set an a...

Page 150: ...The comma delimited string that is returned starts with the lowest channel and goes to the highest channel on Slot 1 It then lists each subsequent slot until the highest slot is reached Information on...

Page 151: ...tions The rest of the functions in this group are used for operations on the bits of a given number These functions can be used to Clear a bit Toggle a bit Test a bit Set a bit or bit field Retrieve t...

Page 152: ...installed Bank number The bank number if used by your card See your card documentation Row number The row number is either 1 to 8 or A to Z See your card documentation Column number Always two digits...

Page 153: ...rn snapshot on page 7 39 channel reset on page 7 40 channel setdelay on page 7 41 channel setforbidden on page 7 42 channel setlabel on page 7 43 channel setlabelcolumn on page 7 44 channel setlabelro...

Page 154: ...subString then print subString else print tonumber subString end index1 index2 1 end createconfigscript function This function captures the present settings of the instrument createconfigscript on pa...

Page 155: ...reset on page 7 58 digio trigger N stimulus on page 7 59 digio trigger N wait on page 7 61 digio writebit on page 7 61 digio writeport on page 7 62 digio writeprotect on page 7 63 Display display cle...

Page 156: ...sponse messages You can use the print printbuffer and printnumber functions to query the instrument and generate response messages The format attributes control how the data is formatted for the print...

Page 157: ...lan config method on page 7 98 lan config subnetmask on page 7 99 lan lxidomain on page 7 100 lan nagle on page 7 100 lan reset on page 7 101 lan restoredefaults on page 7 101 lan status dns address...

Page 158: ...etglobal on page 7 126 make accessor functions Use these functions to create functions to get and set attribute values makegetter on page 7 127 makesetter on page 7 128 memory functions Check the amou...

Page 159: ...age 7 152 scan trigger channel set on page 7 152 scan trigger channel stimulus on page 7 153 scan trigger clear on page 7 155 Scripting Scripting helps you combine commands into a block of code that t...

Page 160: ...age 7 172 status node_enable on page 7 174 status node_event on page 7 176 status operation on page 7 177 status operation user on page 7 179 status questionable on page 7 181 status request_enable on...

Page 161: ...210 trigger timer N passthrough on page 7 210 trigger timer N reset on page 7 211 trigger timer N stimulus on page 7 212 trigger timer N wait on page 7 213 trigger wait on page 7 213 TSP Link These fu...

Page 162: ...on page 7 238 tspnet write on page 7 239 Userstrings Use the functions in this group to store and retrieve user defined strings in nonvolatile memory These strings are stored as key value pairs Key v...

Page 163: ...generate an error if it was impossible to set the requested values For information on finding instrument drivers on the Keithley website see Getting instrument drivers on page 5 18 Instrument driver...

Page 164: ...s was that the API was not specific to the instrument For something as standard as measuring DC volts on a digital multimeter DMM it would be a good idea if there were a set of standard functions to d...

Page 165: ...all in the driver since a DLL only has a flat API entry point scheme unlike COM or NET Any CVI generated fp file can be imported into LabVIEW and LabVIEW will generate a wrapper for the DLL The drawba...

Page 166: ...ds over GPIB from a user generated program such as Visual Basic C or C C A computer sends either commands or user generated scripts over GPIB USB or Ethernet Scripts can also be run from the front pan...

Page 167: ...control framework DDC to ICL command equivalencies In many cases DDC commands have a single corresponding ICL equivalent command that performs the same or a similar function In some cases more than o...

Page 168: ...name and any operation that occurs to the pattern such as close or open happens to each channel in the pattern For more information see Channel patterns on page 2 92 Scanning trigger DDC TSP equivalen...

Page 169: ...s output includes the settling time of the specific channel fixed in hardware added to a programmed settling time that could be specified by the user These commands are shown in the table below Matrix...

Page 170: ...can also be cleared with the display clear command VFD display DDC TSP equivalent command Description Dccccccc display screen display USER Set VFD display text display settext Set relay setup data for...

Page 171: ...ovides increased flexibility with fourteen digital I O lines compared to the Model 707A which has eight input lines and eight output lines and the Model 708A which has sixteen input lines and sixteen...

Page 172: ...triggering on page 3 1 Trigger source control DDC TSP equivalent command Description T0 or T1 No corresponding command Trigger on Talk T2 or T3 scan trigger channel stimulus trigger EVENT_ID Trigger...

Page 173: ...eturns the channels contained in the pattern as a csv list There is no need to send a pattern to the relays Operations that are to be done to the channels of a pattern are done on the pattern correctl...

Page 174: ...so this command is not supported Relay test input DDC TSP equivalent command Description U8 No corresponding command Send relay test input Connect rules On the Model 707B or 708B this command sets th...

Page 175: ......

Page 176: ...s you combine commands into a block of code that the instrument can run Scripts help you communicate with the instrument more efficiently Scripts offer several advantages compared to sending individua...

Page 177: ...r Information in the run time environment is lost when the instrument is turned off Nonvolatile memory is where information is stored even when the instrument is turned off Save scripts to nonvolatile...

Page 178: ...ncluded with your Models 707B and 708B You can use it to create modify debug and store Test Script Processor TSP scripting engine scripts For more information about using the TSB software see Using Te...

Page 179: ...nstrument to be turned off without losing the script See Working with scripts in nonvolatile memory on page 6 7 Load a script by sending commands over the remote interface To load a script over the re...

Page 180: ...information about using TSB Embedded select the Help button on a web page or the Help option from the navigation pane on the left side of the web interface To create a script using TSB Embedded 1 In t...

Page 181: ...a script with the script name autoexec see Autoexec script on page 6 7 Autorun scripts Autorun scripts run automatically when the instrument is turned on You can set any number of scripts to autorun...

Page 182: ...t using TSB Embedded display clear display settext Hello from autoexec In the TSP Script box enter autoexec Enter the code in the entry box Click Save Script Creates a new script that clears the displ...

Page 183: ...Var save usb1 filename tsp where scriptVar is the variable referencing the script and filename tsp is the name of the file You can also use TSB Embedded to save a script to a USB flash drive or any ac...

Page 184: ...ractive script prompts the operator to input values using the instrument front panel The following example script uses display messages to prompt the operator to Enter the digital I O line on which to...

Page 185: ...Line assert Alert the user through the display that the output trigger has occurred display setcursor 1 1 display settext Trigger asserted Non digital I O line intMyDigioLine Wait five seconds and the...

Page 186: ...diately after a double hyphen is anything other than double left brackets the comment is a short comment which continues only until the end of the line If double left brackets follow the double hyphen...

Page 187: ...l command names beeper localnode bit opc channel reset dataqueue scan delay slot digio status display timer errorqueue trigger eventlog tsplink exit tspnet format userstring gpib waitcomplete lan Valu...

Page 188: ...bers there is no distinction between integers and floating point numbers string sequence of words or characters function a block of code Functions perform a task or compute and return values table an...

Page 189: ...ou can use functions to form expressions that calculate and return a value Functions can also act as statements that execute specific tasks Functions are first class values in Lua That means that func...

Page 190: ...e return first_value second_value third_value end print add_three 3 4 5 Creates a variable named add_three that has a variable type of function Output 12 Example 3 function sum_diff_ratio first_value...

Page 191: ...global variable This variable is of the type function see Variable types on page 6 13 5 Run the new function with a value MyFunction world The response message is Hello world Group commands using the...

Page 192: ...st argument if the first argument is false or nil otherwise and returns its second argument The disjunction operator or returns its first argument if this value is different from nil and false otherwi...

Page 193: ...e concatenation and exponentiation operators are right associative All other binary operators are left associative The examples below show equivalent expressions Equivalent expressions reading offset...

Page 194: ...expression is Lua code that evaluates to either true or false block consists of one or more Lua statements Example If if 0 then print Zero is true else print Zero is false end Output Zero is true Exam...

Page 195: ...not false if expression 3 was not false if expression 4 was false x is not equal to 10 and y is not greater than 2 Loop control If you need to repeat code execution you can use the Lua while repeat a...

Page 196: ...ntil clause are met repeat block until expression Where block consists of one or more Lua statements expression is Lua code that evaluates to either true or false The output you get from this example...

Page 197: ...while a control variable runs through an arithmetic progression Output Counting from one to three 1 One 2 Two 3 Three Counting from one to four in steps of two 1 One 3 Three Example Generic for days S...

Page 198: ...ocal k table getn numTable local breakValue 3 while k 0 do if numTable k breakValue then print Going to break and k k break end k k 1 end if k 0 then print Break value not found end This example defin...

Page 199: ...n be heterogeneous which means that they can contain values of all types except nil Tables are the sole data structuring mechanism in Lua They may be used to represent ordinary arrays symbol tables se...

Page 200: ...If the new threshold is smaller than the byte counter Lua immediately runs the garbage collector If there is no limit parameter it defaults to zero 0 which forces a garbage collection cycle See the L...

Page 201: ...Description string byte s string byte s i string byte s i j Returns the internal numeric codes of the characters s i s i 1 s j The default value for i is 1 the default value for j is i string char Re...

Page 202: ...ring that is the concatenation of n copies of the string s string sub s i string sub s i j Returns the substring of s that starts at i and continues until j i and j can be negative If j is absent it i...

Page 203: ...ger and the absolute value of m is in the range 0 5 1 or zero when x is zero math ldexp m e Returns m2 e e should be an integer math log x Returns the natural logarithm of x math log10 x Returns the b...

Page 204: ...oop The following script puts a message on the front panel display slowly one character at a time The intent of this example is to demonstrate The use of a for loop Simple display remote commands Simp...

Page 205: ...splay settext x print x delay 1 end endscript Example Create channels with a for loop User script created in TSB Embedded User script created in user s own program loadscript Pseudocard assignment nec...

Page 206: ...xtended with Keithley specific instrument control commands For more information about using the Lua scripting language with Keithley TSP enabled instruments refer to the Fundamentals of programming fo...

Page 207: ...view 4 Programming interaction 5 Help includes detailed information on using Test Script Builder Installing the TSB software The installation files for the Test Script Builder software are available...

Page 208: ...open click the tab that contains the script in the script editor area Programming interaction This part of the workspace is where you interact with the scripts that you are building in Test Script Bui...

Page 209: ...able When you create a script using the script new function without providing a name the script is added to the run time environment as an unnamed script The script new function returns the script but...

Page 210: ...command Use the script new function to copy an existing script from the local node to a remote node This enables parallel script execution You can create a script with the script new function using t...

Page 211: ...Unnamed scripts are not available from the front panel display of the instrument Only the anonymous script and named scripts are available from the front panel display When you create a script using s...

Page 212: ...hat was in the run time environment as beepTwoSec is changed to an unnamed script the name attribute is set to an empty string The global variable beepTwoSec remains in the run time environment unchan...

Page 213: ...me 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 t...

Page 214: ...back into the instrument To get a list of scripts that are in nonvolatile memory use the script user catalog on page 7 160 function Retrieve source code one line at a time To retrieve the source code...

Page 215: ...scriptVar source Where scriptVar is the name of the script Example Retrieve the source code as a single string print test source Retrieve the source of a script named test Output might look similar t...

Page 216: ...en turn the instrument off and back on again However if you cannot turn the instrument off you can use the following steps to completely remove a script from the instrument When you completely remove...

Page 217: ...mory patternMemory where systemMemory The percentage of memory used or available in the instrument scriptMemory The percentage of memory used or available in the instrument to store user scripts patte...

Page 218: ...ts of five channels Example String concatenation lines Optimized with the table concat function testPattern 1A03 testPattern testPattern 1B03 testPattern testPattern 1C03 testPattern testPattern 1D03...

Page 219: ...and becomes the master and can control all of the other nodes which become its subordinates In a computer based system the master subordinate relationship between nodes can only be dissolved by perfor...

Page 220: ...programming 707B 901 01 Rev B January 2015 6 45 For an example of setting up a TSP Linked system see Working with a Series 2600A in the Models 707B and 708B User s Manual Figure 89 Model 708B rear pa...

Page 221: ...key then select TSPLINK NODE 2 Press the navigation wheel and select the desired number 3 Press the ENTER key to save the node number To assign a node number using a remote command Set the tsplink nod...

Page 222: ...d with the TSP Link system reset are listed in the following table TSP Link reset commands Command Description tsplink reset Initializes the TSP Link network tsplink state Reads the state of the TSP L...

Page 223: ...node Initiates and runs a test script on Node 2 Initiates and runs a test script on Node 5 Initiates and runs a test script on Node 6 1 Group leader Node 2 Runs the test script initiated by the master...

Page 224: ...t node in a group running any operation initiated by the master node is the group leader The following list describes the functionality of the group leader Runs operations initiated by the master node...

Page 225: ...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 err...

Page 226: ...ading buffers or global variables from any node in a remote group while a node in that group is performing an overlapped operation However you can use the data queue to retrieve data from any node in...

Page 227: ...puter TSP Net Capabilities For both Test Script Processor TSP and non TSP devices the TSP Net library permits the Model 707B or 708B to control a remote device through the LAN port Using TSP Net metho...

Page 228: ...eout value is 20 seconds Set tspnet tsp abortonconnect to 1 to abort any script currently running on a remote TSP device 4 Use tspnet write or tspnet execute to send strings to a remote device tspnet...

Page 229: ...ctions have three synchronization lines that are available to each device on the TSP Link network You can use any one of the synchronization lines to perform hardware triggering between devices on the...

Page 230: ...tspnet read id n print string format from computer s tspnet read id n print string format from computer s tspnet read id n end function test_tspnet tspnet reset Connect to a computer using Telnet teln...

Page 231: ......

Page 232: ...0 to 30 that you specify For example to set this attribute to 15 you would send gpib address 15 Example 2 digio trigger N assert Where N is an integer 1 to 14 that you specify For example to assert tr...

Page 233: ...h set digital I O line 3 low are equivalent digio writebit 3 0 digio writebit 3 0 Function parameters All functions are required to have a set of parentheses immediately following the function You can...

Page 234: ...aqueue slot digio status display timer eventlog trigger errorqueue tsplink format tspnet gpib userstring Do not create variable names that are the same as names of logical instruments Doing so will re...

Page 235: ...d following the figure 1 Instrument command name Signals the beginning of the command description and is followed by a brief description of what the command does 2 Type of command Options are Function...

Page 236: ...e used on an instrument Options include Create configuration script This command is saved as part of the configuration script if you save the current configuration into a script with the createconfigs...

Page 237: ...the order presented in the Usage section You cannot leave out any parameters that precede the optional parameter Optional parameters are shown as separate lines in usage presented in the required ord...

Page 238: ...ction 7 TSP command reference 707B 901 01 Rev B January 2015 7 7 Related commands and information The Also See section of the remote command description lists additional commands or sections that are...

Page 239: ...nd of a lengthy sweep The beeper will not sound if it is disabled It can be disabled or enabled with the beeper enable command or through the front panel Example beeper enable beeper ON beeper beep 2...

Page 240: ...AND operation value1 Operand for the logical AND operation value2 Operand for the logical AND operation Details Any fractional parts of value1 and value2 are truncated to form integers The returned re...

Page 241: ...1011 Output 1 1000000e 01 Also see Bit manipulation and logic operations on page 5 4 bit bitand on page 7 9 bit bitxor on page 7 10 bit bitxor This function performs a bitwise logical XOR exclusive OR...

Page 242: ...ils 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 inde...

Page 243: ...decimal value is 8 Output 8 0000000e 00 Also see Bit manipulation and logic operations on page 5 4 bit clear on page 7 11 bit set on page 7 13 bit test on page 7 14 bit toggle on page 7 15 bit getfiel...

Page 244: ...result bit set value index result Result of the bit manipulation value Specified number index One based bit position within value to set 1 to 32 Details This function returns result which is value wi...

Page 245: ...is at index position 1 the most significant bit is at index position 32 Before setting the field of bits any fractional parts of value and fieldValue are truncated to form integers If fieldValue is wi...

Page 246: ...cimal 10 is 1010 Testing the bit at index position 4 returns a Boolean value of true Output true Also see Bit manipulation and logic operations on page 5 4 bit clear on page 7 11 bit get on page 7 11...

Page 247: ...ation Details The channelList parameter indicates the channels that will no longer be forbidden to close and may include allslots or slotX where X equals 1 to 6 for Model 707B or 1 for Model 708B Chan...

Page 248: ...ed with this function include Close the specified items in channelList Incur the settling time and any user specified delay An error is generated if The parameter string contains slotX where X is 1 to...

Page 249: ...the relays has expired When the connection rule is set to channel BREAK_BEFORE_MAKE the instrument ensures that all switch channels open before any switch channels close When switch channels are both...

Page 250: ...own as hot switching can dry weld reed relays so that they will always be on Hot switching is recommended only when external protection is provided Example channel connectrule channel BREAK_BEFORE_MAK...

Page 251: ...nels at once The order in which channels are opened or closed is not guaranteed with sequential off The sequential setting affects all channels in the instrument Example channel connectsequential chan...

Page 252: ...nt for the type of card in the specified slot an error is generated Example 1 cs channel createspecifier 1 1 1 print cs Creates a channel descriptor for row 1 column 1 on the card in slot 1 Output 1A0...

Page 253: ...closed Settling and user specified delay times are applied as defined by the connection rules and delay settings If the channelList parameter is an empty string or a string of spaces all channels are...

Page 254: ...slots and opens any channels that are not specified Type TSP Link accessible Affected by Where saved Default value Function Yes Usage channel exclusiveslotclose channelList channelList A string that l...

Page 255: ...nel getclose allslots Open all channels on all slots Close row A column 1 channels on all slots Open row A column 1 on slot 3 and close row A column 3 on slot 3 without affecting any other slot with c...

Page 256: ...en on page 7 33 Data retrieval commands on page 5 3 channel getcount This function returns a string with the close counts for the specified channels Type TSP Link accessible Affected by Where saved De...

Page 257: ...s are generated numbers not actual count values if a pseudocard is used Example channel pattern setimage 1A01 1B02 1C01 Path PathList channel pattern getimage Path print PathList print channel getcoun...

Page 258: ...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 Pse...

Page 259: ...n for matrix channels Example channel reset slot1 channel setforbidden 1A01 1A05 print channel getforbidden allslots print channel getforbidden slot1 print channel getforbidden 1A01 1A03 1B04 1B08 1B1...

Page 260: ...r Model 707B or 1 for Model 708B or allslots In this case the channels are listed before the analog backplane relays An error is generated if The slot is empty The specified channel is not on the inst...

Page 261: ...ls The parameter channelList can contain more than one channel Use a comma to delimit the labels for the channels The return string label lists the labels in the same order that the channels are speci...

Page 262: ...ated with them Details The parameter channelList can contain more than one channel If it does use a comma to delimit the labels for the channel rows The return string label lists the labels in the sam...

Page 263: ...e condition has occurred since the last reset command or power cycle Unlatched indicators mean that the condition occurred when the channel getstate command was issued Although the channel getstate co...

Page 264: ...e for the Models 707B and 708B is channel TYPE_SWITCH or 1 Example 1 print channel gettype 1A01 Query the channel type of row 1 column 1 in slot 1 Also see None channel open This function opens the sp...

Page 265: ...lslots Opens all channels on all slots Also see channel close on page 7 17 channel exclusiveclose on page 7 22 channel exclusiveslotclose on page 7 23 channel getclose on page 7 24 channel getdelay on...

Page 266: ...ete all user created channel patterns in the run time environment The entries that are returned are listed in random order Example channel pattern setimage 1A01 1A02 patternA channel pattern setimage...

Page 267: ...ies a channel pattern for associated channels Type TSP Link accessible Affected by Where saved Default value Function Yes Instrument reset Channel reset Recall setup Pole setting change Create configu...

Page 268: ...value Function Yes Instrument reset Channel reset Recall setup Pole setting change Create configuration script Save setup Not applicable Usage channel pattern setimage channelList name channelList A s...

Page 269: ...s a comma Path1 10 invalid because it contains a colon An error is generated if The name parameter already exists as a label Any channel is forbidden to close Insufficient memory exists to create the...

Page 270: ...command stores an image of presently closed channels and associates them with the name parameter If name is already used for an existing channel pattern that pattern is overwritten with the new patte...

Page 271: ...l pattern catalog on page 7 35 channel pattern delete on page 7 36 channel pattern getimage on page 7 36 channel pattern setimage on page 7 37 channel reset This function resets the specified channel...

Page 272: ...es Instrument reset Channel reset Recalls setup Create configuration script Save setup 0 Usage channel setdelay channelList value channelList A string listing the channels that need modifications to t...

Page 273: ...te configuration script Save setup Not forbidden Usage channel setforbidden channelList channelList A string that lists the channels to make forbidden to close Details The channelList parameter indica...

Page 274: ...l from patternA and patternB then print the catalog again Only patternC should remain Assuming no existing channel patterns the output is patternC 1C01 1C02 patternA 1A01 1A02 patternB 1B01 1B02 patte...

Page 275: ...ontains a space however if the first character is a space the label is cleared The label is already used to represent a channel pattern The label does not persist through a power cycle Example 1 chann...

Page 276: ...the full label is displayed Since a column label is common to all channels in that column you only need to assign the column label to one channel Example 1 channel setlabelrow 1B01 SMU2 channel setla...

Page 277: ...The row and column label parameters must be unique In addition they cannot be the same as the name of a channel pattern You can only set labels for slots and channels that are installed in the instrum...

Page 278: ...ures most of the present settings of the instrument Type TSP Link accessible Affected by Where saved Default value Function No Usage createconfigscript scriptName scriptName A string that represents t...

Page 279: ...eue The timeout value is ignored if the data queue is not full The dataqueue add function returns false If the timeout expires before space is available in the data queue If the data queue is full and...

Page 280: ...ta queue Example MaxCount dataqueue CAPACITY while dataqueue count MaxCount do dataqueue add 1 end print There are dataqueue count items in the data queue This example fills the data queue until it is...

Page 281: ...ed by Where saved Default value Attribute R Yes Power cycle Not saved Not applicable Usage count dataqueue count count The number of items in the data queue Details The count is updated as entries are...

Page 282: ...nal table and any subtables is made The duplicate table does not contain any references to the original table or to any subtables Example dataqueue clear for i 1 10 do dataqueue add i end print There...

Page 283: ...me may cause the instrument to delay 5 s to 10 s typical more than the requested delay Example beeper beep 0 5 2400 delay 0 250 beeper beep 0 5 2400 Emit a double beep at 2400 Hz The sequence is 0 5 s...

Page 284: ...rt The least significant bit bit B1 of the binary number corresponds to line 1 bit B14 corresponds to line 14 For example a returned value of 170 has a binary equivalent of 000000010101010 which indic...

Page 285: ...event detector of a trigger enters the detected state when an event is detected It is cleared when digio trigger N wait or digio trigger N clear is called digio trigger N clear clears the event detect...

Page 286: ...e 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...

Page 287: ...the falling edge input triggers and automatically latches and drives the trigger line low Asserts a TTL low pulse as an output trigger digio TRIG_SYNCHRONOUSM or 6 Detects rising edge triggers as inp...

Page 288: ...tself It does not indicate if an overrun occurred in any other part of the trigger model or in any other detector that is monitoring the event Example overrun digio trigger 1 overrun print overrun If...

Page 289: ...e Function Yes Usage digio trigger N release N Digital I O trigger line 1 to 14 Details Releases a trigger that was asserted with an indefinite pulsewidth time It also releases a trigger that was latc...

Page 290: ...idth of 50 microseconds Use digital I O line 5 to trigger the event on line 3 Reset the line back to factory default values Output before reset 2 0000000e 00 5 0000000e 05 5 0000000e 00 Output after r...

Page 291: ...GPIB is the active command interface a GET message also generates this event trigger blender N EVENT_ID A combination of events has occurred trigger timer N EVENT_ID A delay expired tsplink trigger N...

Page 292: ...igio trigger N wait or digio trigger N clear was called this function returns a value immediately After waiting for a trigger with this function the event detector is automatically reset and ready to...

Page 293: ...n page 7 63 digio writeport This function writes to all digital I O lines Type TSP Link accessible Affected by Where saved Default value Function Yes Usage digio writeport data data Value to write to...

Page 294: ...r the I O port For example a mask value of 7 has a binary equivalent of 00000000000111 This mask write protects lines 1 2 and 3 Example digio writeprotect 15 Write protects lines 1 2 3 and 4 Also see...

Page 295: ...bitmasked values and equivalent constants Indicator Bit Weighted value Equivalent constant FILT 1 1 display ANNUNCIATOR_FILTER MATH 2 2 display ANNUNCIATOR_MATH 4W 3 4 display ANNUNCIATOR_4_WIRE AUTO...

Page 296: ...he cursor is in the bottom row 1 to 32 style Visibility of the cursor 0 invisible cursor 1 blinking cursor Details This function switches the display to the user screen the text set by display settext...

Page 297: ...L key normally aborts a script To use this function with the EXIT LOCAL key you must set display locallockout to display LOCK The table below lists the keyCode value for each front panel action Key co...

Page 298: ...Selects the row from which to read the text 1 row 1 2 row 2 If row is not included both rows of text are read columnStart Selects the first column from which to read text for row 1 the valid column n...

Page 299: ...play clear display settext User Screen text display gettext print text This outputs all text in both lines of the display User Screen N This indicates that the message User Screen is on the top line T...

Page 300: ...nput value is limited to 1e37 Before calling display inputvalue you should send a message prompt to the operator using display prompt Make sure to position the cursor where the edit field should appea...

Page 301: ...available code to load Pressing the RUN key will then run the script You can add items in any order They are always displayed in alphabetic order when the menu is selected Any Lua code can be can be...

Page 302: ...ipt was not saved in nonvolatile memory the function named DUT1 is lost when you turn the instrument on When Test is again run from the front panel an error is generated because DUT1 no longer exists...

Page 303: ...n the instrument front panel Type TSP Link accessible Affected by Where saved Default value Function Yes Usage display loadmenu delete displayName displayName The name to be deleted from the USER TEST...

Page 304: ...ration by pressing the EXIT LOCAL key Set this attribute to display UNLOCK to allow the EXIT LOCAL key to interrupt script or remote operation Example display locallockout display LOCK Disables the fr...

Page 305: ...e value Test2 Output Test2 Also see None display prompt This function prompts the user to enter a parameter from the front panel of the instrument Type TSP Link accessible Affected by Where saved Defa...

Page 306: ...se limits The input value is limited to 1e37 After sending this command script execution pauses for the operator to enter a value and press ENTER For positive and negative entry plus sign used for the...

Page 307: ...d this attribute to determine which of the available display screens was last selected This does not support the CLOSED CHANNELS option that is available from the DISPLAY key Example display screen di...

Page 308: ...isplay WHEEL_ENTER 79 display KEY_OPENALL 107 display WHEEL_LEFT 80 display KEY_CONFIG 114 display WHEEL_RIGHT When using this function send built in constants such as display KEY_STEP rather than the...

Page 309: ...row 2 An out of range parameter for column sets the cursor to column 20 for row 1 or 32 for row 2 An out of range parameter for style sets it to 0 invisible A blinking cursor is only visible when it i...

Page 310: ...splay as soon as processing time becomes available The text starts at the present cursor position After the text is displayed the cursor is after the last character in the display message Top line tex...

Page 311: ...er event detector and discards the previous history of TRIG key presses This attribute also clears the display trigger overrun attribute Also see display trigger overrun display trigger wait display t...

Page 312: ...ue For example if the keyCode value 75 is returned the EXIT LOCAL key was pressed the exit function can be called to abort the script The table below lists the keyCode value for each front panel actio...

Page 313: ...e 01 It indicates that the MEAS A key was pressed Also see Capturing key press codes display getlastkey on page 7 66 display sendkey on page 7 76 display settext on page 7 79 errorqueue clear This fun...

Page 314: ...0000000e 00 Also see errorqueue clear on page 7 82 errorqueue next on page 7 83 errorqueue next This function reads the oldest entry from the error queue and removes it from the queue Type TSP Link a...

Page 315: ...ariable errorNode stores the node number where the error originated Example errorcode message errorqueue next print errorcode message Reads the oldest entry in the error queue The output below indicat...

Page 316: ...I 0 1192037133 1192037159 052777000 0 0x0 Also see eventlog clear on page 7 85 eventlog count on page 7 86 eventlog enable on page 7 86 eventlog next on page 7 87 eventlog overwritemethod on page 7 88...

Page 317: ...3 0000000e 00 Also see eventlog all on page 7 84 eventlog clear on page 7 85 eventlog enable on page 7 86 eventlog next on page 7 87 eventlog overwritemethod on page 7 88 eventlog enable This attribut...

Page 318: ...m the event log Type TSP Link accessible Affected by Where saved Default value Function Yes Usage logString eventlog next logString The next log entry Details Returns the next entry from the event log...

Page 319: ...set to eventlog DISCARD_NEWEST new entries are not logged When this attribute is set to eventlog DISCARD_OLDEST the oldest entry is discarded when a new entry is added Example eventlog overwritemetho...

Page 320: ...the print printbuffer and printnumber functions The format asciiprecision attribute is only used with the ASCII format The precision value must be a number from 0 to 16 Note that the precision is the...

Page 321: ...WAPPED or format LITTLEENDIAN byte order when sending data to a computer with a Microsoft Windows operating system Example x 1 23 format data format REAL32 format byteorder format LITTLEENDIAN printnu...

Page 322: ...formats use four bytes for single precision values and eight bytes for double precision values When data is written with any of the binary formats the response message starts with 0 and ends with a ne...

Page 323: ...fields timeZone can be in either of the following formats If one parameter was used with settimezone the format used is GMThh mm ss If four parameters were used with settimezone the format used is GMT...

Page 324: ...dress to communicate with the instrument The reset function does not affect the GPIB address Example gpib address 26 address gpib address print address Sets the GPIB address and reads the address Outp...

Page 325: ...o be specified that take priority over DHCP configured global DNS servers You can specify up to two addresses The address specified by 1 is consulted first for DNS lookups dnsAddress must be a string...

Page 326: ...he 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...

Page 327: ...a letter end with a letter or digit contain only letters digits and hyphens Details This attribute holds the host name to request during dynamic DNS registration Dynamic DNS registration works with D...

Page 328: ...verification disabled Details When this is enabled the instrument performs DNS lookups to verify that the DNS host name matches the value specified by lan config dns hostname Example print lan config...

Page 329: ...ddress Type TSP Link accessible Affected by Where saved Default value Attribute RW Yes LAN restore defaults Nonvolatile memory 192 168 0 2 Usage ipAddress lan config ipaddress lan config ipaddress ipA...

Page 330: ...ANUAL only the manually specified settings are used Neither DHCP nor DLLA are attempted Example print lan config method Outputs the current method For example 1 0000000e 00 Also see lan restoredefault...

Page 331: ...ng LXI packets are generated with this domain number All inbound LXI packets are ignored unless they have this domain number Example print lan lxidomain Displays the LXI domain Also see None lan nagle...

Page 332: ...settings to default values Type TSP Link accessible Affected by Where saved Default value Function Yes Usage lan restoredefaults Details The settings that are restored are shown in the following tabl...

Page 333: ...n dotted decimal notation You can only specify two addresses manually However the instrument uses up to three DNS server addresses If two are specified only the one given by a DHCP server is used If n...

Page 334: ...address N on page 7 94 lan config dns hostname on page 7 96 lan status duplex This attribute contains the duplex mode presently in use by the LAN interface Type TSP Link accessible Affected by Where...

Page 335: ...e ipAddress lan status ipaddress ipAddress LAN IP address specified in dotted decimal notation Details The IP address is a character string that represents the IP address assigned to the instrument Ex...

Page 336: ...et port number Details This attribute holds the TCP port number used to reset all other LAN socket connections To reset all LAN connections open a connection to the DST port number Example print lan s...

Page 337: ...mber Details This attribute holds the TCP port number used to connect to the instrument to control it over a Telnet interface Example print lan status port telnet Get the LAN Telnet connection port nu...

Page 338: ...sently in use such as 1 0000000e 02 Also see None 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 W...

Page 339: ...N0 2 LAN1 3 LAN2 8 LAN7 Example lan trigger 5 assert Creates a trigger with LAN packet 5 Also see lan lxidomain on page 7 100 lan trigger N clear on page 7 108 lan trigger N mode on page 7 112 lan tri...

Page 340: ...ges For TCP connections this opens the TCP connection The event generator automatically disconnects when either the protocol or IP address for this event is changed Example lan trigger 1 protocol lan...

Page 341: ...e changed or the remote connection closes the connection Example lan trigger 1 protocol lan MULTICAST print lan trigger 1 connected Outputs true if connected or false if not connected Example output f...

Page 342: ...trigger 1 EVENT_ID Route occurrences of triggers on LAN trigger 1 to digital I O trigger 14 Also see None lan trigger N ipaddress This attribute specifies the address in dotted decimal format of UDP...

Page 343: ...trigger mode 0 to 7 see the Details section for more information N A number representing the LAN event number 1 to 8 Details This command controls how the trigger event detector and the output trigger...

Page 344: ...trigger N reset Instrument reset Recall setup Not applicable Not applicable Usage overrun lan trigger N overrun overrun The trigger overrun state for the specified LAN packet true or false N The LAN e...

Page 345: ...ending outgoing messages After changing this setting lan trigger N connect must be called before outgoing event messages can be sent When the lan MULTICAST protocol is selected the lan trigger N ipadd...

Page 346: ...simulated line state for the LAN event 1 Also see None lan trigger N stimulus This attribute specifies events that cause this trigger to assert Type TSP Link accessible Affected by Where saved Defaul...

Page 347: ...xpired tsplink trigger N EVENT_ID An edge rising falling or either based on the configuration of the line on the TSP Link trigger line lan trigger N EVENT_ID A LAN trigger event has occurred scan trig...

Page 348: ...nt of time in seconds to wait for the trigger event Details If one or more trigger events have been detected since the last time lan trigger N wait or lan trigger N clear was called this function retu...

Page 349: ...S 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 consta...

Page 350: ...ent This value appears on LXI welcome page of the instrument The value of this attribute is also used as the mDNS service name of the instrument This attribute s default value contains Keithley ModelN...

Page 351: ...ion may only be called when the group number of the node is different than the node of the master This function does not wait for the script to finish execution Example 1 node 2 execute sourcecode Run...

Page 352: ...ttribute stores the model number Type TSP Link accessible Affected by Where saved Default value Attribute R Yes Not applicable Not applicable Not applicable Usage model localnode model model The model...

Page 353: ...res the remote access password enable mode Type TSP Link accessible Affected by Where saved Default value Attribute RW Yes Not applicable Nonvolatile memory 1 localnode PASSWORD_WEB Usage mode localno...

Page 354: ...ndicates that processing of the command is complete It does not mean the previous command generated an error only that there were still errors in the queue when the command processing was complete The...

Page 355: ...erate prompts if prompting is enabled with the localnode prompts attribute If localnode prompts4882 is enabled limit the number of trg commands sent to a running script to 50 regardless of the setting...

Page 356: ...reset Example localnode reset Resets the local node Also see channel reset on page 7 40 reset on page 7 135 scan reset on page 7 146 localnode revision This attribute stores the firmware revision lev...

Page 357: ...rument on the top line of its display Also see localnode description on page 7 119 localnode model on page 7 121 localnode revision on page 7 125 node N setglobal This function sets the value of a glo...

Page 358: ...the instrument automatically sends any generated errors stored in the error queue and then clears the queue Errors are processed after executing a command message just before issuing a prompt if prom...

Page 359: ...en called sets the value of an attribute Type TSP Link accessible Affected by Where saved Default value Function No Usage setter makesetter table attributeName setter Function that sets the value of t...

Page 360: ...ge of memory available in the instrument to store channel patterns Details Use this function to view the available memory in the overall instrument as well as the memory available for storing user scr...

Page 361: ...of memory used in the instrument scriptMemory The percentage of memory used in the instrument to store user scripts patternMemory The percentage of memory used in the instrument to store channel patte...

Page 362: ...de independently sets its operation complete bits in its own status model Any nodes that are not actively performing overlapped commands set their bits immediately All remaining nodes set their own bi...

Page 363: ...on on page 7 89 printbuffer This function prints data from tables or reading buffer subtables Type TSP Link accessible Affected by Where saved Default value Function No Usage printbuffer startIndex en...

Page 364: ...r n to retrieve the number of readings in the specified reading buffer Example 1 reset testData buffer make 200 format data format ASCII format asciiprecision 6 trigger model load SimpleLoop 6 0 testD...

Page 365: ...t value to print in the configured format One or more values separated with commas Details There are multiple ways to use this function depending on how many numbers are to be printed This function pr...

Page 366: ...reset command for the local instrument Use the node X reset command to reset an instrument on a subordinate node When no value is specified for system the default value is true You can only reset the...

Page 367: ...ist If the scan list does not exist it also creates a scan list See scan create for information about creating a scan list Channels and channel patterns added using the scan add function are added to...

Page 368: ...columns 1 through 8 on slot 1 to the new scan list Adds row A column 10 on slot 1 to the end of the scan list Adds row A column 9 on slot 1 to the end of the scan list Scan list now includes channels...

Page 369: ...1D01 scan addimagestep 1A01 1B01 1C03 scan add 1F03 scan addimagestep 1A03 1B03 1C03 scan addimagestep 1A05 1B05 1C03 scan addimagestep 1A07 1B07 1C03 scan addimagestep 1A09 1B09 1C03 print scan list...

Page 370: ...scan ABORTED or 3 scan FAILED or 4 scan FAILED_INIT or 5 scan SUCCESS or 6 scanCount The present number of scans completed stepCount The present number of steps completed Details Before using this co...

Page 371: ...n ON or 1 Enabled Details When bypass is ON and the scan trigger arm stimulus is set to a non zero value the first channel of the scan closes the scan trigger channel stimulus setting is ignored For o...

Page 372: ...ally specified in the channel list an error is generated If an error occurs the scan list of channels or channel patterns is cleared even though no new scan list is created The function scan reset cle...

Page 373: ...FAILED_INIT or 5 scan SUCCESS or 6 scanCount The present number of scans that have completed stepCount The present number of steps have completed Details Before using this command use scan create and...

Page 374: ...xisting scan step information Details This function lists the existing scan list When you change a channel or scan attribute for an existing scan list item the scan list is recreated based on this cha...

Page 375: ...itiate the scan list to be output Outputs the existing scan list Output Init OPEN 1 STEP 1A07 CLOSE 1A07 2 STEP 1A08 OPEN 1A07 CLOSE 1A08 3 STEP 1A09 OPEN 1A08 CLOSE 1A09 4 STEP 1A10 OPEN 1A09 CLOSE 1...

Page 376: ...The present scan mode setting Set to one of the following values scan MODE_OPEN_ALL or 0 scan MODE_OPEN_SELECTIVE or 1 See Details Details When this attribute is set to scan MODE_OPEN_ALL all channels...

Page 377: ...lts are scan bypass scan mode scan scancount scan trigger arm stimulus scan trigger channel stimulus In addition the scan list is cleared Sending this function only affects the trigger model and scan...

Page 378: ...scan scancount scan scancount scanCount scanCount The present scan count value 1 to 2 000 000 000 Details The scan count attribute setting indicates how many times the scan list is iterated through b...

Page 379: ...ns Therefore if the instrument is waiting for an input to trigger a scan start the scan count represents the previous number of scan iterations If no scan has begun the scan count is zero 0 stepCount...

Page 380: ...magestep and scan add functions updates this attribute s value Example print scan stepcount Responds with the present step count Output assuming there are five steps in the scan list 5 0000000e 00 Als...

Page 381: ...aved Default value Attribute RW Yes Instrument reset Recall setup Scan reset Create configuration script Save setup 0 Usage eventID scan trigger arm stimulus scan trigger arm stimulus eventID eventID...

Page 382: ...SCAN_COMP Scan Complete Event scan trigger EVENT_IDLE Idle Event Use one of the text trigger event IDs for example digio trigger N EVENT_ID to set the stimulus value rather than the numeric value Doin...

Page 383: ...trigger channel set on page 7 152 scan trigger channel stimulus on page 7 153 Trigger model on page 3 1 Scanning and triggering on page 3 1 scan trigger channel set This function sets the channel even...

Page 384: ...the following table Trigger event IDs Trigger event ID Description channel trigger N EVENT_ID or 41 to 48 The trigger event generated by the channel trigger N digio trigger N EVENT_ID or 1 to 14 An ed...

Page 385: ...QUENCE_COMP or 50 Sequence complete event scan trigger EVENT_SCAN_COMP or 26 Scan complete event scan trigger EVENT_IDLE or 27 Idle event schedule alarm N EVENT_ID or 37 to 38 Trigger event generated...

Page 386: ...l stimulus on page 7 153 Scanning and triggering on page 3 1 Trigger model on page 3 1 script anonymous This is a reference to the anonymous script Type TSP Link accessible Affected by Where saved Def...

Page 387: ...Type TSP Link accessible Affected by Where saved Default value Function No Usage script delete scriptName scriptName The string that represents the name of the script Example script delete test8 Delet...

Page 388: ...rom the instrument front panel You must save the new script into nonvolatile memory to keep it when the instrument is turned off Example 1 myTest8 script new display clear display settext Hello from m...

Page 389: ...Details The script newautorun function is identical to the script new function except that the autorun attribute of the script is set to yes The script is also automatically run immediately after it...

Page 390: ...ry into the run time 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 Also...

Page 391: ...all scripts in nonvolatile memory The entries will be enumerated in no particular order Each time the body of the function executes name takes on the name of one of the scripts stored in nonvolatile m...

Page 392: ...ault value for scriptVar autorun depends on how the script was loaded The default is no if the script was loaded with loadscript or script new It is yes for scripts loaded with loadandrunscript or scr...

Page 393: ...ple test7 script new display clear display settext Hello from my test test7 test7 test7 save test7 list The above example code creates a script named test7 that displays text on the front panel and li...

Page 394: ...nment If the new name is the same as a name that is already used for another script the name of the other script is set to an empty string and that script becomes unnamed Changing the name of a script...

Page 395: ...atile memory or a USB flash drive The root folder of the USB flash drive has the absolute path usb1 If no filename is specified the filename parameter is an empty string the script is saved to interna...

Page 396: ...with lines separated by the new line character The instrument automatically stores the source for all scripts that are loaded on the instrument To free up memory or to obfuscate the code assign nil t...

Page 397: ...fault value Function No Usage settimezone offset settimezone offset dstOffset dstStart dstEnd offset String representing offset from UTC dstOffset String representing the daylight savings offset from...

Page 398: ...ins and ends respectively MM is a number between 1 and 12 that represents the month w is a number between 1 and 5 that represents the week in the month dw is a number between 0 and 6 that represents t...

Page 399: ...string X Slot number 1 to 6 Details The information that is returned depends on whether the card in the slot is an actual card or pseudocard For actual cards this returns a comma separated string tha...

Page 400: ...sage fourPole slot X poles four fourPole The return value X Slot number 1 to 6 Details This attribute only exists if a card is installed and if the card supports four pole settings for the channels on...

Page 401: ...plicable Usage onePole slot X poles one onePole The return value X Slot number 1 to 6 Details This attribute only exists if a card is installed and if the card supports one pole settings for the chann...

Page 402: ...e settings for the channels on the card Output if card supports two pole 1 00000000000e 00 Output if card does not support two pole nil Also see slot X poles one on page 7 170 slot X poles four on pag...

Page 403: ...eudocard 7070 print slot 1 idn This example requires an empty slot The slot is set to empty and then set to a valid value Output Empty Slot 7072 Pseudo 8x12 SemiMatrix 00 00a To change the pseudocard...

Page 404: ...cates that a response message is present in the Output Queue Bit B4 decimal value 16 B5 status EVENT_SUMMARY_BIT status ESB Set summary bit indicates that an enabled standard event has occurred Bit B5...

Page 405: ...able nodeEnableRegister nodeEnableRegister The status of the system node enable register a zero 0 indicates no bits set also send 0 to clear all bits other values indicate various bit settings Details...

Page 406: ...ecimal value 32 B6 status MASTER_SUMMARY_STATUS status MSS Set bit indicates that an enabled Master Summary Status MSS bit of the Status Byte Register is set Bit B6 decimal value 64 B7 status OPERATIO...

Page 407: ...B2 B1 B0 1 0 0 0 0 0 0 1 Least significant bit Most significant bit The returned value can indicate one or more status events occurred Bit Value Description B0 status MEASUREMENT_SUMMARY_BIT status M...

Page 408: ...resently B0 MSB and B7 OSB Also see Status byte and service request SRQ on page C 16 status condition on page 7 172 status system on page 7 190 status operation These attributes manage the operation s...

Page 409: ...ents on page C 1 and Enable and transition registers on page C 20 The individual bits of this register are defined in the following table Bit Value Description B0 B10 Not used Not applicable B11 statu...

Page 410: ...gister using a decimal value Also see None status operation user These attributes manage the operation status user register set of the status model Type TSP Link accessible Affected by Where saved Def...

Page 411: ...e 1 B1 status operation user BIT1 Bit B1 decimal value 2 B2 status operation user BIT2 Bit B2 decimal value 4 B3 status operation user BIT3 Bit B3 decimal value 8 B4 status operation user BIT4 Bit B4...

Page 412: ...operation status user enable register Also see status operation on page 7 177 status questionable These attributes manage the status model s questionable status register set Type TSP Link accessible A...

Page 413: ...the following table Bit Value Description B0 B8 Not used Not available B9 status questionable S1THR status questionable SLOT1_THERMAL Bit B9 decimal value 512 B10 status questionable S2THR status ques...

Page 414: ...atus questionable enable register Also see None status request_enable This attribute stores the service request SRQ enable register Type TSP Link accessible Affected by Where saved Default value Attri...

Page 415: ...t in the Questionable Status Register has occurred Bit B3 decimal value 8 B4 status MESSAGE_AVAILABLE status MAV Set summary bit indicates that a response message is present in the Output Queue Bit B4...

Page 416: ...estSRQEventRegister status request_event requestSRQEventRegister The status of the request event register a zero 0 indicates no bits set other values indicate various bit settings Details This attribu...

Page 417: ...V Set summary bit indicates that a response message is present in the Output Queue Bit B4 decimal value 16 B5 status EVENT_SUMMARY_BIT status ESB Set summary bit indicates that an enabled event in the...

Page 418: ...standard These attributes manage the standard event status register set of the status model Type TSP Link accessible Affected by Where saved Default value Attribute condition R Yes Not applicable Not...

Page 419: ...Status register set contents on page C 1 and Enable and transition registers on page C 20 The individual bits of this register are defined in the following table Bit Value Description B0 status stand...

Page 420: ...d turned back on since the last time this register has been read Bit B7 decimal value 128 B8 B15 Not used Not applicable As an example to set bit B0 of the standard event status enable register set st...

Page 421: ...tus of the system summary register a zero 0 indicates no bits set other values indicate various bit settings Details In an expanded system TSP Link these attributes are used to read or write to the sy...

Page 422: ...he system summary status enable register set status system enable status system enable EXT In addition to the above constants enableRegister can be set to the numeric equivalent of the bit to set To s...

Page 423: ...gister status system2 ntr enableRegister status system2 ptr status system2 enable enableRegister status system2 ntr enableRegister status system2 ptr enableRegister enableRegister The status of the sy...

Page 424: ...e 512 B10 status system2 NODE24 Bit B10 decimal value 1 024 B11 status system2 NODE25 Bit B11 decimal value 2 048 B12 status system2 NODE26 Bit B12 decimal value 4 096 B13 status system2 NODE27 Bit B1...

Page 425: ...saved 32 767 All bits set Usage enableRegister status system3 condition enableRegister status system3 enable enableRegister status system3 event enableRegister status system3 ntr enableRegister statu...

Page 426: ...e 512 B10 status system3 NODE38 Bit B10 decimal value 1 024 B11 status system3 NODE39 Bit B11 decimal value 2 048 B12 status system3 NODE40 Bit B12 decimal value 4 096 B13 status system3 NODE41 Bit B1...

Page 427: ...saved 32 767 All bits set Usage enableRegister status system4 condition enableRegister status system4 enable enableRegister status system4 event enableRegister status system4 ntr enableRegister statu...

Page 428: ...B10 status system4 NODE52 Bit B10 decimal value 1 024 B11 status system4 NODE53 Bit B11 decimal value 2 048 B12 status system4 NODE54 Bit B12 decimal value 4 096 B13 status system4 NODE55 Bit B13 dec...

Page 429: ...Not saved 510 All bits set Usage enableRegister status system5 condition enableRegister status system5 enable enableRegister status system5 event enableRegister status system5 ntr enableRegister statu...

Page 430: ...256 B9 B15 Not used Not applicable As an example to set bit B1 of the system summary 5 enable register set status system5 enable status system5 NODE57 In addition to the above constants enableRegiste...

Page 431: ...er measure t print time Resets the timer and measures the time since the reset Output 1 469077e 01 The output will vary The above output indicates that timer measure t was executed 14 69077 seconds af...

Page 432: ...ent detector and resets the overrun indicator of blender N Type TSP Link accessible Affected by Where saved Default value Function Yes Usage trigger blender N clear N The blender number 1 or 2 Details...

Page 433: ...P Link accessible Affected by Where saved Default value Attribute RW Yes Instrument reset Trigger blender N reset Recall setup Create configuration script false AND mode Usage orenable trigger blender...

Page 434: ...ate of the event detector that is built into the event blender itself This command does not indicate if an overrun occurred in any other part of the trigger model or in any other trigger object that i...

Page 435: ...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 Trigger event ID...

Page 436: ...wait for the trigger blender event Details This function waits for an event blender trigger event If one or more trigger events were detected since the last time trigger blender N wait or trigger blen...

Page 437: ...nts Also see trigger wait on page 7 213 trigger EVENT_ID This constant contains the command interface trigger event number Type TSP Link accessible Affected by Where saved Default value Constant Yes U...

Page 438: ...e saved Default value Attribute RW Yes Instrument reset Recall setup Trigger timer N reset Create configuration script 1 Usage count trigger timer N count trigger timer N count count count Number of t...

Page 439: ...d it uses this delay period Assigning a value to this attribute is equivalent to trigger timer N delaylist interval This creates a delay list of one value Reading this attribute returns the delay inte...

Page 440: ...ist do print DelayList x end Set a delay list on trigger timer 3 with three delays 50 s 100 s and 150 s Read the delay list on trigger timer 3 Output assuming the delay list was set to 50 s 100 s and...

Page 441: ...ector built into the timer 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 delay completion event It also is...

Page 442: ...ts Type TSP Link accessible Affected by Where saved Default value Function Yes Usage trigger timer N reset N Trigger timer number 1 to 4 Details The trigger timer N reset function resets the following...

Page 443: ...he trigger key on the front panel is pressed trigger EVENT_ID A trg message on the active command interface If GPIB is the active command interface a GET message also generates this event trigger blen...

Page 444: ...ately After waiting for a trigger with this function the event detector is automatically reset and rearmed This is true regardless of the number of events detected Example triggered trigger timer 3 wa...

Page 445: ...e 10 second timeout If true is returned a trigger was detected Also see trigger clear on page 7 206 tsplink group This attribute contains the group number of a TSP Link node Type TSP Link accessible A...

Page 446: ...er node number in a variable called LinkMaster Also see tsplink reset on page 7 217 tsplink node This attribute defines the node number Type TSP Link accessible Affected by Where saved Default value A...

Page 447: ...high and it is then read Output 1 000000e 00 Also see tsplink readport on page 7 216 tsplink writebit on page 7 226 tsplink readport This function reads the TSP Link synchronization lines as a digita...

Page 448: ...depending on the ASCII precision setting Also see tsplink readbit on page 7 216 tsplink writebit on page 7 226 tsplink writeport on page 7 227 tsplink reset This function initializes resets all nodes...

Page 449: ...ork Also returns the number of nodes found Example nodesFound tsplink reset 2 print Nodes found nodesFound Perform a TSP Link reset and indicate how many nodes are found Sample output if two nodes are...

Page 450: ...ink trigger N clear on page 7 219 tsplink trigger N mode on page 7 220 tsplink trigger N overrun on page 7 222 tsplink trigger N pulsewidth on page 7 223 tsplink trigger N release on page 7 223 tsplin...

Page 451: ...D eventID The trigger event number N The trigger line 1 to 3 Details This number is used by the TSP Link trigger line when it detects an input trigger Set the stimulus of any trigger object to the val...

Page 452: ...er line low tsplink TRIG_SYNCHRONOUS 5 Detects the falling edge input triggers and automatically latches and drives the trigger line low Asserts a TTL low pulse as an output trigger tsplink TRIG_SYNCH...

Page 453: ...ot applicable Usage overrun tsplink trigger N overrun overrun Trigger overrun state N The trigger line 1 to 3 Details This command indicates whether an event has been ignored because the event detecto...

Page 454: ...0e 6 Sets pulse width for trigger line 3 to 20 s Also see tsplink trigger N release on page 7 223 tsplink trigger N release This function releases a latched trigger on the given TSP Link trigger line...

Page 455: ...This also clears tsplink trigger N overrun Example tsplink trigger 3 reset Resets TSP Link trigger line 3 attributes back to factory default values Also see tsplink trigger N mode on page 7 220 tspli...

Page 456: ...rigger timer N EVENT_ID A delay expired tsplink trigger N EVENT_ID An edge rising falling or either based on the configuration of the line on the TSP Link trigger line lan trigger N EVENT_ID A LAN tri...

Page 457: ...cond timeout If true is returned a trigger was detected Also see tsplink trigger N clear on page 7 219 tsplink writebit This function sets a TSP Link synchronization line high or low Type TSP Link acc...

Page 458: ...reset function does not affect the present states of the trigger lines Example tsplink writeport 3 Sets the synchronization lines 1 and 2 high binary 011 Also see tsplink readbit on page 7 216 tsplink...

Page 459: ...ere saved Default value Function No Usage tspnet clear connectionID connectionID The connection ID returned from tspnet connect Details This function clears any pending output data from the device No...

Page 460: ...07B or 708B does not perform any extra processing prompt handling error handling or sending of commands In addition the tspnet tsp commands cannot be used on devices that are not TSP enabled If neithe...

Page 461: ...nect on page 7 230 tspnet disconnect This function disconnects a specified TSP Net session Type TSP Link accessible Affected by Where saved Default value Function No Usage tspnet disconnect connection...

Page 462: ...when it is sent to the remote instrument tspnet termination You can also specify a format string which causes the command to wait for a response from the remote instrument The Models 707B and 708B de...

Page 463: ...the instrument and read the IDN string may appear as KEITHLEY INSTRUMENTS INC MODEL 707B 00000170 01 10h Also see tspnet connect on page 7 229 tspnet read This function reads data from a remote device...

Page 464: ...t the Model 707B or 708B removes Test Script Processor TSP prompts and places any errors it receives from the remote instrument into its own error queue The Model 707B or 708B prefaces errors from the...

Page 465: ...Default value Function No Usage tspnet reset Details This command disconnects all remote instruments connected through TSP Net For TSP enabled devices this causes any commands or scripts running remot...

Page 466: ...tspnet termination deviceID tspnet TERM_LF end Sets termination type for IP address 192 0 2 1 to TERM_LF Also see tspnet connect on page 7 229 tspnet disconnect on page 7 230 tspnet timeout This attri...

Page 467: ...for other tspnet commands Details This function is appropriate only for TSP enabled instruments Sends an abort command to the remote instrument Example tspnet tsp abort testConnection Stops remote in...

Page 468: ...ment Type TSP Link accessible Affected by Where saved Default value Function No Usage table tspnet tsp rbtablecopy connectionID name table tspnet tsp rbtablecopy connectionID name startIndex endIndex...

Page 469: ...t The body of the script as a string Details This function is appropriate only for TSP enabled instruments This function downloads a script to a remote instrument and runs it It automatically adds the...

Page 470: ...ary new lines termination or other syntax elements needed to complete properly Because tspnet write does not process output from the remote instrument do not send commands that generate too much outpu...

Page 471: ...string get name end Stores user defined strings in nonvolatile memory and recalls them from the instrument using a for loop Also see userstring catalog on page 7 240 userstring delete on page 7 241 us...

Page 472: ...9 userstring delete on page 7 241 userstring get on page 7 242 userstring delete This function deletes a user defined string from nonvolatile memory Type TSP Link accessible Affected by Where saved De...

Page 473: ...is function retrieves the string that is associated with name from nonvolatile memory Example value userstring get assetnumber print value Read the value associated with a user defined string named as...

Page 474: ...B is a TSP master to a subordinate device with overlapped commands use this function to wait until all overlapped operations are completed A group number may only be specified when this node is the ma...

Page 475: ......

Page 476: ...nformation on error levels and how to read errors Error summary Error and status messages are assigned a level of severity as listed in the table below Severity level descriptions Number Level Descrip...

Page 477: ...message severity and node for that error errorCode message severity errorNode errorqueue next print errorCode message severity errorNode The following table lists the commands associated with the err...

Page 478: ...guide 707B 901 01 Rev B January 2015 8 3 Figure 96 Device Manager dialog box showing USB Test and Measurement Device 3 Right click the device 4 Select Properties 5 Select the Driver tab 6 Click Driver...

Page 479: ...r is installed click OK 9 On the Driver tab click Update Driver 10 Browse for the driver select the C windows inf folder Locate the winusb inf file Select this and make sure the driver is now in use 1...

Page 480: ...ssistance Timeout errors If your GPIB controller is recognized by the operating system but you get a timeout error when you try to communicate with the instrument check the following 1 Confirm that th...

Page 481: ...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 l...

Page 482: ...ment specific web pages the web page prompts you to install it To do this your computer must have access to the Internet so it can access the web browser plug in Sun Java Runtime Environment Version 6...

Page 483: ...tch or a menu option on the front panel that will put all the LAN settings back to known defaults If you cannot communicate with your instrument perform this reset If you perform a reset the instrumen...

Page 484: ...n narrow the content down to just what you are interested in For example you could check just web page packets http or all packets being sent by a device on a certain IP address Refer to the WireShark...

Page 485: ...pport information see the Keithley Instruments support website To see what drivers are available for your instrument 1 Go to the Keithley Instruments support website http www keithley com support 2 En...

Page 486: ...switching cards from the front panel Press the SLOT key to scroll through the model numbers descriptions and firmware revisions of the installed switching cards To identify installed switching cards f...

Page 487: ......

Page 488: ...he forbidden state of a channel from the front panel 1 Display a channel you might need to press DISPLAY 2 Use the navigation wheel to select the channel you want to check 3 Press CONFIG then press CH...

Page 489: ...getforbidden on page 7 27 channel setforbidden on page 7 42 How do I know if an error has occurred on my instrument If you are using TSB Embedded error messages are displayed in the Instrument Output...

Page 490: ...MENU option to display the serial number and firmware version To display serial number or firmware revision on the front panel 1 If the Model 707B or 708B is in remote mode press the EXIT LOCAL key o...

Page 491: ......

Page 492: ...e Center which contains the following handbooks The Low Level Measurements Handbook Precision DC Current Voltage and Resistance Measurements Switching Handbook A Guide to Signal Switching in Automated...

Page 493: ......

Page 494: ...message is displayed Select the appropriate option 6 Select the file 7 Click Open A progress dialog box is displayed When the upgrade begins the front panel display will also display the progress Duri...

Page 495: ...nel of the instrument as shown below Replacement fuses are listed in the following table Replacement fuses Model Rating Keithley Instruments part number 707B 250V dual 2 0A slow blow Two FU 106 2 0 70...

Page 496: ...Models 707B and 708B Switching Matrix Reference Manual Appendix A Maintenance 707B 901 01 Rev B January 2015 A 3 Figure 99 707B fuse location Figure 100 708B fuse module location...

Page 497: ...stallation instructions are included with the kit Parts list for Model 707B rack mounting Item Description Keithley Part Number Quantity A Chassis support left 707 321 1 B Chassis support right 707 32...

Page 498: ...at holes 28 89 cm 11 38 in and 33 05 cm 13 13 in from the top of the selected space Figure 101 Captive nut installation 3 Loosely attach a nut bar item F to each rear rack flange with two binder head...

Page 499: ...support item A and temporarily install the two pieces in the rack by sliding them apart until the flanged ends fit as shown in the following figure Note which holes will be used to attach the two piec...

Page 500: ...ws attaching the two pieces of the chassis support assemblies Mainframe installation To install the mainframe in the rack 1 Lift the Model 707B or 708B mainframe onto the chassis supports and slide it...

Page 501: ......

Page 502: ...708A DDC compatibility mode 70xA VERSION This option most closely matches Model 707A or 708A operation Use this version if you are transferring applications directly from a Model 707A or 708A with fe...

Page 503: ...When using code from an older switch model be aware that timing problems could be introduced into the system Digital interface When you are using Model 707A or 708A compatibility mode the digital I O...

Page 504: ...nel key Only Model 707A This command has no effect and does not issue an error message when used In Insert blank setup None Jn Self test There is no self test for the Models 707B and 708B Kn EOI and h...

Page 505: ...erface specifications see digital input output difference For U8 the test relay is not supported and always reads 15 Vabcdefgh Make before break None Wabcdefgh Break before make None cmd X Execute Non...

Page 506: ...etails see Status Byte Register on page C 16 Status register set contents Typically a status register set contains the following registers Condition condition A read only register that is constantly u...

Page 507: ...ta it sets the condition bit for that queue in one of the registers The condition bits are Command queue CAV in the Operation Status Remote Summary Register Output queue MAV in the Status Byte Registe...

Page 508: ...n a summary bit of the Status Byte is set and its corresponding enable bit is set as programmed using status request_enable the MSS bit will set to indicate that an SRQ has occurred View the master su...

Page 509: ...Appendix C Status model Models 707B and 708B Switching Matrix Reference Manual C 4 707B 901 01 Rev B January 2015 Status Byte Register overview Figure 105 Status Byte register...

Page 510: ...ment event register provides enabled summary information to Bit B0 MSB of the status byte Since the Models 707B and 708B has no internal measurement capabilities none of the bits in the measurement re...

Page 511: ...Appendix C Status model Models 707B and 708B Switching Matrix Reference Manual C 6 707B 901 01 Rev B January 2015 Figure 106 System summary bit System register...

Page 512: ...e is returned The binary equivalent of this value indicates which bits in the register are set For details see Reading registers on page C 15 For example the following command will read the system ena...

Page 513: ...here are problems detected during power on entries will be placed in the queue If no problems are detected the error number 0 and No Error will be returned Error queue command Description errorqueue c...

Page 514: ...provides enabled summary information to Bit B4 MAV of the status byte The Message Available Bit MAV is set when the Output queue holds data that pertains to the normal operation of the instrument The...

Page 515: ...88 2 syntax error The instrument received a message that does not follow the defined syntax of the IEEE 488 2 standard Semantic error instrument received a command that was misspelled or received an o...

Page 516: ...Summary REM Set bit indicates that an enabled in the Operation Status Remote Summary Register is set Bit B12 User USER Set bit indicates that an enabled bit in the operation status user register is s...

Page 517: ...erence Manual C 12 707B 901 01 Rev B January 2015 Figure 110 Operation user summary bit Operation user register The bits used in this register set are described as follows Bits B0 B14 status operation...

Page 518: ...ard event status standard on page 7 187 System events status system on page 7 190 status system2 on page 7 192 status system3 on page 7 194 status system4 on page 7 196 status system5 on page 7 198 Cl...

Page 519: ...The only registers that you can program are the enable and transition registers All other registers in the status structure are read only registers The following explains how to determine the paramet...

Page 520: ...ample any of the following commands requests the Service Request Enable Register value SRE print tostring status request_enable print status request_enable The response message will be a decimal value...

Page 521: ...ical AND operation is performed on the summary bits with the corresponding enable bits of the Service Request Enable Register When a logical AND operation is performed with a set summary bit 1 and wit...

Page 522: ...Models 707B and 708B Switching Matrix Reference Manual Appendix C Status model 707B 901 01 Rev B January 2015 C 17 Figure 112 Status byte and service request SRQ...

Page 523: ...mmands on page C 20 to read the status byte B6 is the MSS bit Bit B7 Operation Summary OSB Set summary bit indicates that an enabled operation event has occurred Serial polling and SRQ Any enabled eve...

Page 524: ...Manual Appendix C Status model 707B 901 01 Rev B January 2015 C 19 Service requests Service requests SRQs affect both the GPIB and the VXI 11 connections On a GPIB connection the SRQ line is asserted...

Page 525: ...sters 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...

Page 526: ...rmal aspect event occurs on Node 15 the following sequence of events will occur 1 On Node 15 with Bit B9 of the Questionable event register enabled when the thermal aspect event occurs Bit B9 bit sets...

Page 527: ...and 2 see the TSP Link status model configuration example figure below System registers The following commands enable the required system summary bits for Node 15 status system2 enable status system2...

Page 528: ...707B and 708B Switching Matrix Reference Manual Appendix C Status model 707B 901 01 Rev B January 2015 C 23 TSP Link status model configuration exampl e Figure 113 TSP Link status model configuration...

Page 529: ......

Page 530: ...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 channe...

Page 531: ...n execution 3 7 front panel display 2 14 2 16 2 18 keys 2 16 Model 707B front panel 2 11 Model 708B front panel 2 11 scanning 3 6 functions 5 1 Lua 6 14 G gpib attribute gpib address 7 92 groups TSP L...

Page 532: ...ode 3 15 trigger mode 3 15 RJ 45 Ethernet connector 2 4 run time environment script restoring 6 42 storage of scripts 6 2 S scanning counts 3 4 execution foreground and background 3 7 fundamentals 3 1...

Page 533: ...yntax rules 7 2 Trigger model components 3 3 Described 3 1 troubleshooting web page 2 66 TSB Embedded installing software 6 32 TSP 5 1 programming methods 6 1 TSP Link 6 44 6 48 advanced features 6 44...

Page 534: ...property of Keithley Instruments All other trademarks and trade names are the property of their respective companies Keithley Instruments Corporate Headquarters 28775 Aurora Road Cleveland Ohio 44139...

Reviews: