Keithley 708B Reference Manual
  1. Manuals
  2. Brands
  3. Keithley Manuals
  4. Matrix Switcher
  5. 708B
  6. Reference manual
Keithley 708B Reference Manual

Keithley 708B Reference Manual

Switching matrix
Hide thumbs Also See for 708B:
1
2
3
4
5
Table Of Contents
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
Table of Contents

Advertisement

Quick Links

See also: User Manual
w
w
w
k .
i e
h t
e l
. y
o c
m
Models 707B and 708B
Switching Matrix
Reference Manual
707B-901-01 Rev. A / August 2010
A
G
R
E
A
T
E
R
M
E
A
S
U
R
E
O
F
C
O
N
F
I
D
E
N
C
E

Advertisement

Table of Contents
loading
Need help?

Need help?

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

Questions and answers

Related Manuals for Keithley 708B

Summary of Contents for Keithley 708B

  • Page 1 Models 707B and 708B Switching Matrix Reference Manual 707B-901-01 Rev. A / August 2010...
  • Page 2 All rights reserved. Any unauthorized reproduction, photocopy, or use the information herein, in whole or in part, without the prior written approval of Keithley Instruments, Inc. is strictly prohibited. All Keithley Instruments product names are trademarks or registered trademarks of Keithley Instruments, Inc.
  • Page 4 Keithley Instruments products are designed for use with electrical signals that are rated Measurement Category I and Measurement Category II, as described in the International Electrotechnical Commission (IEC) Standard IEC 60664. Most measurement, control, and data I/O signals are Measurement Category I and must not be directly connected to mains voltage or to voltage sources with high transient over-voltages.
  • Page 5 (note that selected parts should be purchased only through Keithley Instruments to maintain accuracy and functionality of the product). If you are unsure about the applicability of a replacement component, call a Keithley Instruments office for information.

  • Page 6: Table Of Contents

    Overview ..........................1-1 Warranty information......................1-1 General operation ....................... 2-1 Rear panel overview ......................2-1 Model 707B Rear panel ......................2-2 Model 708B Rear panel ......................2-2 Wiring ........................... 2-2 Communication connections ..................... 2-3 Digital I/O port ........................... 2-7 Power-up..........................2-10 Line power connection ......................
  • Page 7 Synchronous trigger mode ...................... 3-20 Events ..........................3-21 Event blenders ........................3-22 Theory of operations ....................4-1 Models 707B and 708B theory of operations overview ............4-1 Mainframe ..........................4-1 Important test system safety information................... 4-2 Instrument fan (Model 707B only) ..................... 4-3 AC power entry .........................
  • Page 8 Obtaining instrument drivers ....................5-20 Instrument driver examples ..................... 5-20 Migrating from Models 707A and 708A................5-21 Migrating Model 707A or 708A programs to Model 707B or 708B .......... 5-21 DDC to ICL command equivalencies ..................5-22 Instrument programming ................... 6-1 Fundamentals of scripting for TSP..................
  • Page 9 Table of Contents Models 707B and 708B Switching Matrix Reference Manual Using Test Script Builder (TSB) ..................6-35 Installing the TSB software...................... 6-35 Project Navigator........................6-35 Script Editor..........................6-36 Programming interaction ......................6-36 Advanced scripting for TSP ....................6-36 Global variables and the script.user.scripts table ..............6-36 Create a script using the script.new command................
  • Page 10 Models 707B and 708B Switching Matrix Reference Manual Table of Contents bit.test() ........................... 7-16 bit.toggle() ..........................7-17 channel.clearforbidden() ......................7-18 channel.close()........................7-19 channel.connectrule ........................ 7-20 channel.connectsequential...................... 7-21 channel.createspecifier() ......................7-23 channel.exclusiveclose() ......................7-24 channel.exclusiveslotclose()....................7-25 channel.getclose()........................7-27 channel.getcount() ........................7-28 channel.getdelay()........................
  • Page 11 Table of Contents Models 707B and 708B Switching Matrix Reference Manual display.locallockout ......................... 7-77 display.menu()......................... 7-77 display.prompt() ........................7-78 display.screen ......................... 7-80 display.sendkey() ........................7-80 display.setcursor()........................7-81 display.settext() ........................7-82 display.trigger.EVENT_ID ....................... 7-84 display.waitkey()........................7-84 errorqueue.clear() ........................7-85 errorqueue.count........................7-86 errorqueue.next() ........................
  • Page 12 Models 707B and 708B Switching Matrix Reference Manual Table of Contents lan.trigger[N].stimulus ......................7-123 lan.trigger[N].wait()........................ 7-125 localnode.define.*........................7-125 localnode.description ......................7-126 localnode.execute()....................... 7-127 localnode.getglobal()......................7-128 localnode.model ........................7-128 localnode.password ......................7-129 localnode.prompts......................... 7-129 localnode.prompts4882......................7-130 localnode.reset() ........................7-131 localnode.revision ......................... 7-131 localnode.serialno .........................
  • Page 13 Table of Contents Models 707B and 708B Switching Matrix Reference Manual slot[X].poles.one........................7-171 slot[X].poles.two ........................7-171 slot[X].pseudocard ........................ 7-172 status.condition ........................7-173 status.node_enable....................... 7-175 status.node_event......................... 7-177 status.operation.* ........................7-178 status.operation.user.* ......................7-180 status.questionable.*......................7-182 status.request_enable......................7-184 status.request_event......................7-186 status.reset() ......................... 7-187 status.standard.* ........................
  • Page 14 Models 707B and 708B Switching Matrix Reference Manual Table of Contents tspnet.connect() ........................7-229 tspnet.disconnect()........................ 7-230 tspnet.execute() ........................7-230 tspnet.idn() ..........................7-232 tspnet.read().......................... 7-232 tspnet.readavailable()......................7-233 tspnet.reset() ......................... 7-234 tspnet.termination() ....................... 7-235 tspnet.timeout........................7-236 tspnet.tsp.abort() ........................7-236 tspnet.tsp.abortonconnect ..................... 7-237 tspnet.tsp.rbtablecopy()......................
  • Page 15 Table of Contents Models 707B and 708B Switching Matrix Reference Manual How do I know if an error has occurred on my instrument? ..........9-2 How do I find the serial number and firmware version of the instrument?......9-3 Next steps........................10-1 Additional Models 707B and 708B information..............
  • Page 16 Models 707B and 708B Switching Matrix Reference Manual Table of Contents Status byte and service request commands................C-18 Enable and transition registers....................C-19 Controlling node and SRQ enable registers ................C-19 TSP-Link system status .....................C-19 Status model configuration example ..................C-19 Index........................Index-1 Limitation of Warranty ........................

  • Page 18: Introduction

    ATE system applications, such as semiconductor device characterization, wafer level reliability, parallel test, and modeling. The Model 707B can host up to six test cards. The Model 708B is a single slot chassis. Warranty information Detailed warranty information is located at the back of this manual. Should your Model 707B or 708B require warranty service, contact the Keithley Instruments representative or authorized repair facility in your area for further information.
  • Page 19 Models 707B and 708B Switching Matrix Reference Manual WARNING Before removing or installing switching cards, make sure you turn off the Model 707B or 708B and disconnect the line cord. Also, remove any other external power connected to the instrument or switching cards.

  • Page 20: General Operation

    Slots Use the slots in the Keithley Instruments Models 707B and 708B for the switching cards. The Model 707B can accept up to six switching cards. The Model 708B can accept one switching card. If a slot does not contain a card, make sure to cover the slot with a slot cover. For model and firmware version information on the installed cards, press the SLOT key.

  • Page 21: Model 707B Rear Panel

    Section 2: General operation Models 707B and 708B Switching Matrix Reference Manual Model 707B Rear panel Figure 1: Model 707B rear panel MADE IN U.S.A. IEEE-488 (GPIB) connection IEEE-488 WARNING: NO INTERNAL OPERATOR SERVICEABLE PARTS. SERVICE BY QUALIFIED PERSONNEL ONLY. FOR CONTINUED PROTECTION AGAINST FIRE HAZARD, REPLACE FUSE WITH SAME TYPE AND RATING.

  • Page 22: Communication Connections

    Models 707B and 708B Switching Matrix Reference Manual Section 2: General operation Communication connections The following topics describe how to connect the cable connections for the communication interfaces. To properly set up the communications interfaces after connection, see the information in Communication interfaces (on page 2-24).
  • Page 23 Section 2: General operation Models 707B and 708B Switching Matrix Reference Manual Connect the LAN cable Connect the LAN connector between the rear panel of the instrument and the host computer or network router. You can use an LAN crossover cable (RJ-45, male/male) or straight-through cable.
  • Page 24 Models 707B and 708B Switching Matrix Reference Manual Section 2: General operation Connect the GPIB cable To connect a Model 707B or 708B to the GPIB bus, use a cable equipped with standard IEEE-488 connectors, as shown below. Figure 7: IEEE-488 connector To allow many parallel connections to one instrument, stack the connectors.
  • Page 25 Models 707B and 708B Switching Matrix Reference Manual To connect the Model 707B or 708B to the IEEE-488 bus, line up the cable connector with the connector located on the rear panel. Install and tighten the screws securely, making sure not to overtighten them (the following figure shows the location of the connections).

  • Page 26: Digital I/O Port

    EXTERNAL HAZARDOUS VOLTAGES (>42V) 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 example, a handler that is used to perform binning operations can be used with a digital I/O port.
  • Page 27 Using Models 707A and 708A compatibility mode page B-1). Connecting cables Use a cable equipped with a standard male DB-25 connector (Keithley Instruments part number CA-126-1). Digital I/O lines (pins 1 through 14) The port provides 14 digital I/O lines. Each output is set high (+5 V) or low (0 V) and can read high or low logic levels.
  • Page 28 Models 707B and 708B Switching Matrix Reference Manual Section 2: General operation Controlling digital I/O lines Digital I/O lines are primarily intended for use with a device handler for limit testing. They can also be used for other purposes, such as controlling external logic circuits. You can control lines either from the front panel or over a remote interface.

  • Page 29: Power-Up

    The Model 707B or 708B operates from a line voltage of 100 V to 240 V at a frequency of 50 Hz or 60 Hz. Line voltage is automatically sensed (there are no switches to set). Make sure the operating voltage in your area is compatible.

  • Page 30: Power-Up Sequence

    Error messages are listed in Error and status messages. NOTE If a problem develops while the instrument is under warranty, return it to Keithley Instruments, Inc., for repair. See the Warranty page at the back of this manual for more information.

  • Page 31: Model 707B Front Panel

    CLS: 2C04 DISPLAY POWER CONFIG Navigation Display wheel Change scan Instrument Change and channel attributes power button screen display Model 708B front panel The front panel of the Model 708B is shown below. 2-12 707B-901-01 Rev. A / August 2010...

  • Page 32: Display

    Display NOTE This section describes the front-panel display of the Model 708B and the bottom display of the Model 707B. During operation, the display provides information about the selected channel, channel pattern, channel state, and errors. You can press DISPLAY to cycle between the display of the channel or pattern, the closed channel list, or a screen message.
  • Page 33 Section 2: General operation Models 707B and 708B Switching Matrix Reference Manual If you are connecting to the instrument through GPIB, you may also see the following indicators: • TALK: Instrument is addressed to talk • LSTN: Instrument is addressed to listen •...

  • Page 34: Crosspoint Display (Model 707B Only)

    Models 707B and 708B Switching Matrix Reference Manual Section 2: General operation Figure 15: Front-panel Main Menu display MAIN MENU DIGIO BEEPER UNIT-INFO Arrow indicates that there Arrow indicates that there Menu options are more options. are more options. Turn the navigation wheel Turn the navigation wheel to the left to see them.
  • Page 35 Section 2: General operation Models 707B and 708B Switching Matrix Reference Manual The crosspoint display has a list of slots on the right. To the left of the slot list are lights that show you an overview of the cards in the instrument's slots.

  • Page 36: Selecting Channels From The Front Panel

    Models 707B and 708B Switching Matrix Reference Manual Section 2: General operation Selecting channels from the front panel From the front panel, you can change the display to show another card slot, choose a specific channel, and open and close channels. For the 707B, the crosspoint display shows you the status of the channels for one card at a time.

  • Page 37: Keys And Navigation Wheel

    Section 2: General operation Models 707B and 708B Switching Matrix Reference Manual To open and close channels: You can use the crosspoint display to view the open or closed status of a specific channel crosspoint. After selecting the channel crosspoint so that the channel is displayed on the bottom display, you can press OPEN or CLOSE to open or close the channel.
  • Page 38 Keys The top row of keys under the display allows you to open and close channels, work with scan lists, and load and run scripts. Figure 19: Models 707B and 708B top row of keys Key descriptions Description OPEN ALL Opens all closed channels.
  • Page 39 Section 2: General operation Models 707B and 708B Switching Matrix Reference Manual Key descriptions Description CHAN If a channel is displayed, opens the Channel Action Menu options (on page 2-22), which allows you to open and close channels. If a pattern is displayed, pressing CHAN switches to channel view.

  • Page 40: Menu Options

    Models 707B and 708B Switching Matrix Reference Manual Section 2: General operation Set beeper and key clicks You can turn the instrument beeper and key click sounds on or off. NOTE Disabling the beeper also disables the keyclicks. To enable keyclicks, you must also enable the beeper.
  • Page 41 Section 2: General operation Models 707B and 708B Switching Matrix Reference Manual The options are: • LABEL: Sets the label that is displayed on the front panel for the specified channel. • LABEL-ROW: Sets the label that is displayed on the front panel for the specified row.
  • Page 42 Models 707B and 708B Switching Matrix Reference Manual Section 2: General operation Pattern Action Menu options Allows you to configure and change patterns from the front panel. To open this menu, in pattern view, press PATT. Options include: • CREATE: If no patterns have been created, this is the only option that is displayed. Allows you to create a new pattern.

  • Page 43: Communication Interfaces

    It describes how to configure and troubleshoot these interfaces on computers with Windows 2000, Windows XP, Windows Vista, and Windows 7 operating systems. It also describes the I/O software, drivers, and application software that can be used with Keithley’s instruments.
  • Page 44 This requires you to determine the parameters. You can gather this information by running a utility that automatically detects all instruments connected to the computer. If you installed the Keithley I/O Layer, the Keithley Configuration Panel is available from the Windows Start menu in the Keithley Instruments menu.
  • Page 45 Section 2: General operation Models 707B and 708B Switching Matrix Reference Manual Figure 21: Select Operation dialog box 3. Click Next. The Select Communication Bus dialog box is displayed. Figure 22: Select Communication Bus dialog box 2-26 707B-901-01 Rev. A / August 2010...
  • Page 46 Models 707B and 708B Switching Matrix Reference Manual Section 2: General operation 4. Select USB. 5. Click Next. The Select Instrument Driver dialog box is displayed. Figure 23: Select Instrument Driver dialog box 6. Select Auto-detect Instrument Driver - Model.
  • Page 47 Section 2: General operation Models 707B and 708B Switching Matrix Reference Manual Figure 24: Configure USB Instrument dialog box 8. Click Next. The Name Virtual Instrument dialog box is displayed. Figure 25: Name Virtual Instrument dialog box.png 2-28 707B-901-01 Rev. A / August 2010...
  • Page 48 11. Click Cancel to close the Wizard. 12. Save the configuration. From the Configuration Utility, select File > Save. 13. In the Keithley Communicator, select File > Open Instrument to open the instrument you just named. Figure 26: Keithley Communicator Open Instrument 14.
  • Page 49 Section 2: General operation Models 707B and 708B Switching Matrix Reference Manual Figure 27: Send a command to the instrument NOTE If you have a full version of NI VISA on your system, you can run NI-MAX or the VISA Interactive Utility.

  • Page 50: Gpib

    To gain more ports, you can use a USB hub or add more USB controller cards if you have available PCI or PCI Express slots. There are two types of USB hubs, either of which can be used with Model 707B or 708B: •...
  • Page 51 Refer the manufacturer's documentation for information on installing the GPIB cards. Connect the GPIB cable To connect a Model 707B or 708B to the GPIB bus, use a cable equipped with standard IEEE-488 connectors, as shown below. Figure 28: IEEE-488 connector To allow many parallel connections to one instrument, stack the connectors.
  • Page 52 Models 707B and 708B Switching Matrix Reference Manual Section 2: General operation To connect the Model 707B or 708B to the IEEE-488 bus, line up the cable connector with the connector located on the rear panel. Install and tighten the screws securely, making sure not to overtighten them (the following figure shows the location of the connections).
  • Page 53 Section 2: General operation Models 707B and 708B Switching Matrix Reference Manual Figure 32: Model 708B rear panel IEEE-488 connection CAUTION REFER TO SAFETY INSTRUCTIONS IN MANUAL BEFORE CONNECTING TO EXTERNAL HAZARDOUS DIGITAL I/O IEEE-488 VOLTAGES (>42V) IEEE-488 (GPIB) connection Set the GPIB address The GPIB address value is set to 16 at the factory.
  • Page 54 They directly call the GPIB driver support libraries. For the KPCI-488LPA and KUSB-488B GPIB controller from Keithley Instruments, the configuration utility is called the KI-488 Diagnostic Tool. It is available from the Windows Start menu at Keithley Instruments > KI-488 > KI-488 Diagnostic Tool.

  • Page 55: Lan Communications

    Models 707B and 708B are class C LXI version 1.2 compliant. They are scalable test instruments with direct connections to host computers. They can also interact with a DHCP or DNS server and other LXI compliant instruments on a LAN.
  • Page 56 Models 707B and 708B Switching Matrix Reference Manual Section 2: General operation Identify and record the existing IP configuration CAUTION You are responsible for returning settings to their original configuration before reconnecting the computer to a corporate network. Failure to do this could result in damage to your equipment or loss of data.
  • Page 57 Wait for the LAN Status indicator on the front panel to turn solid green The LAN status indicator confirms that the Model 707B or 708B has been assigned an IP address. Note that it may take several minutes for the computer and Model 707B or 708B to establish a connection.
  • Page 58 1. Select the Support tab. 2. In the model number box, type 707B or 708B. 3. From the list, select Software. A list of software applications for the Model 707B or 708B is displayed. 4. See the readme file included with the application for more information.
  • Page 59 Instrument LAN protocols Raw socket communications All Keithley instruments that have LAN connections support raw socket 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 can easily communicate with the instrument using Winsock on Windows computers or Berkley sockets on Linux or Apple computers.
  • Page 60 LAN connections are terminated and closed when the connection to the dead socket termination port is closed. The dead socket termination port for Models 707B and 708B is 5030. Connect to this port, and then when you disconnect, the dead port will be cleaned up (released) VXI-11 VXI-11 is a LAN protocol that emulates GPIB over Ethernet.
  • Page 61 Figure 35: One-to-one connection with a crossover cable NOTE The Models 707B and 708B support Auto-MDIX and can use either normal Ethernet CAT-5 cables (patch) or crossover cables. The instrument automatically adjusts to support either cable. One-to-many connection With an Ethernet hub, a single network interface card can be connected to as many instruments as the hub can support.
  • Page 62 Models 707B and 708B Switching Matrix Reference Manual Section 2: General operation Use two network interface cards to connect to a corporate network and instrumentation hub If you need to connect independent corporate and instrumentation networks, two network interface cards are required in the computer controller. While the two networks are independent, stations on the corporate network can access the instrumentation, and vice versa, using the same computer.
  • Page 63 ID. For purposes of this example, a network ID of 192.68.1 is used, which is the default network ID that is shipped with the most of Keithley’s instruments. If a corporate network is also connected to the same computer using dual network interface cards, the instrumentation network ID must be different than the corporate network ID.
  • Page 64 Models 707B and 708B Switching Matrix Reference Manual Section 2: General operation To set the IP address: 1. From the front panel, press the MENU key. 2. Use the navigation wheel to select LAN > CONFIG > METHOD. Press the navigation wheel to display the METHOD menu.
  • Page 65 Section 2: General operation Models 707B and 708B Switching Matrix Reference Manual IPv4 addressing Models 707B and 708B support IPv4 addressing There are three ways of assigning an IP address to a host: DCHP, DLLA, and static. DHCP The Dynamic Host Configuration Protocol (DHCP) protocol is a way for network devices to request Internet protocol (IP) parameters such as the IP address, gateway, subnet mask, and DNS server addresses.
  • Page 66 Models 707B and 708B Switching Matrix Reference Manual Section 2: General operation The network ID must be unique among all network subnets that connect to the Internet or corporate intranet. If the subnet will be connected to the public Internet, the network ID must be obtained from the Network Information Center, which assigns and preserves unique IDs.
  • Page 67 Section 2: General operation Models 707B and 708B Switching Matrix Reference Manual Dynamic DNS DNS is a rigid and inflexible system, because you must have a system administration add the DNS entry to the DNS server for it to work. Dynamic DNS tries to address this inflexibility. It addresses the needs of network devices that are powered up and down with IP addresses that can change several times a day.
  • Page 68 Models 707B and 708B Switching Matrix Reference Manual Section 2: General operation Figure 39: Internet protocol (TCP/IP) Properties dialog box 192 . 168 . 1 . 100 255 . 255 . 255 . 0 5. Click OK. Windows 2000 Internet Protocol (TCP/IP) Properties dialog box You can review and change IP settings in the Internet Protocol Properties dialog box.
  • Page 69 Section 2: General operation Models 707B and 708B Switching Matrix Reference Manual 4. In the Items list, double-click Internet Protocol (TCP/IP). The Internet Protocol (TCP/IP) Properties dialog box is displayed. Figure 40: Internet protocol (TCP/IP) Properties dialog box 192 . 168 . 1 . 100 255 .
  • Page 70 Models 707B and 708B Switching Matrix Reference Manual Section 2: General operation Figure 41: Internet protocol (TCP/IP) Properties dialog box 192 . 168 . 1 . 100 255 . 255 . 255 . 0 Windows 7 Internet Protocol Version 6 (TCP/IPv6) Properties dialog box You can review and change IP settings in the Internet Protocol Version 4 (TCP/IPv4) dialog box.
  • Page 71 • IP Addressing mode: Models 707B and 708B have a choice of Auto or Manual. Auto mode means the instrument will try to get and address through a DHCP server first and if this fails it will revert to Auto-IP mode.
  • Page 72 Models 707B and 708B Switching Matrix Reference Manual Section 2: General operation Web connection You can enable or disable access to the instrument's web interface. To enable or disable a web connection: 1. From the front panel, press the MENU key, and then select LAN > ENABLE > WEB.
  • Page 73 Section 2: General operation Models 707B and 708B Switching Matrix Reference Manual Raw socket connection Raw socket is a basic Ethernet connection that communicates in a manner similar to RS-232. The instrument will always terminate messages with a line feed, but because binary data may include bytes that resemble line feed characters, it may be difficult to distinguish between data and line feed characters.
  • Page 74 Models 707B and 708B Switching Matrix Reference Manual Section 2: General operation Set up automatic IP address selection If you are connecting to a LAN that has a DHCP server or if you have a direct connection between the instrument and a host computer, you can use automatic IP address selection.
  • Page 75 Section 2: General operation Models 707B and 708B Switching Matrix Reference Manual 8. Select GATEWAY. 9. Set the gateway value to match the gateway of the host computer. 10. Press the ENTER key when the gateway is complete. The LAN CONFIG menu is displayed.
  • Page 76 Models 707B and 708B Switching Matrix Reference Manual Section 2: General operation NOTE You can also change the IP configuration using ICL commands. See lan functions and attributes page 5-12) for more information. To change the IP configuration using the instrument web page: 1.

  • Page 77: Supplied Software

    Section 2: General operation Models 707B and 708B Switching Matrix Reference Manual Supplied software The majority of software applications and all instrument drivers from Keithley Instruments depend on some, or all, of the following software components: • NI-VISA™ • VISA shared components •...

  • Page 78: Keithley I/O Layer

    Keithley I/O layer The Keithley I/O Layer (KIOL) is a software package that contains several utilities and drivers. It is mainly used as a supplement to IVI drivers or application software like TSB.
  • Page 79 If you do not have NI software installed, to use Keithley drivers or application software, you must install the KIOL. This installs a valid, licensed copy of the NI Visa runtime to use with Keithley drivers or application software. KIOL installs a valid license for the VISA runtime only (not the full version of NI VISA).
  • Page 80 3. Reboot your computer. How to install the Keithley I/O Layer NOTE Before installing, it is a good idea to check to see if a later version of the Keithley I/O Layer is available. Check the Keithley Instruments website (http://www.keithley.com). Select the Support tab, type in KIOL, and select software driver.
  • Page 81 The recommended way to resolve this situation is to perform the following steps: 1. Exit the Keithley I/O Layer software when the warning message is displayed. Make note of the vendor of the VISA vendor in the warning message (if any).
  • Page 82 8. If the pre-existing version of VISA was supplied by a vendor other than Tektronix or Agilent, it is recommended that you do not reinstall it as this will likely cause the Keithley I/O Layer software to malfunction.

  • Page 83: Addressing Instruments With Visa

    The following sections describe the resource strings for some of the communication types that Keithley supports. Any field that has [] (square brackets) around it is optional and will revert to a default value. Addressing instruments through the LAN VISA supports two different LAN protocols, each of which has a different resource string.
  • Page 84 TCPIP[board]::host address::port::SOCKET The board and the host address are the same as for the VXI-11 protocol. port is the port to which to connect on the instrument. For the Models 707B and 708B, the port is 5025. See Instrument LAN protocols (on page 2-40) for a complete list of port numbers.
  • Page 85 Section 2: General operation Models 707B and 708B Switching Matrix Reference Manual Addressing instruments through GPIB There are two different resource classes in VISA for the GPIB bus. INSTR is the basic class that everyone uses. It allows application software to send and receive data and commands without dealing with some low level GPIB nuances.
  • Page 86 Models 707B and 708B Switching Matrix Reference Manual Section 2: General operation VISA-C sample code The following is a simple C/C++ console application that reads back the instrument identification string using VISA-C. You need to include visa.h and link with the visa32.lib file.
  • Page 87 Section 2: General operation Models 707B and 708B Switching Matrix Reference Manual VISA-COM sample code This example gets the instrument identification string using VISA-COM in C#. The first thing to do is add a reference to the VISA-COM interop DLL, which is usually located at C:\Program Files\IVI Foundation\VISA\VisaCom\Primary Interop Assemblies\Ivi.Visa.Interop.dll.

  • Page 88: Using The Web Interface

    Using the web interface Introduction The Model 707B or 708B web interface allows you to review instrument status, control the instrument, and upgrade the instrument over a LAN connection. The instrument web page resides in the firmware of the instrument. Changes you make through the web interface are immediately made in the instrument.
  • Page 89 Section 2: General operation Models 707B and 708B Switching Matrix Reference Manual Identify the instrument If you have a bank of instruments, you can click ID to determine which one you are communicating with. Make sure you have a remote connection to the instrument. In the upper right corner of the Home page, click The button turns green, and the LAN status indicator on the instrument blinks.

  • Page 90: Card Pages

    Models 707B and 708B Switching Matrix Reference Manual Section 2: General operation 3. Enter the password (the default is admin). Figure 46: Enter password 4. Click Login. NOTE The default password is admin. If the password has been changed, it is available from the front panel of the instrument.
  • Page 91 Section 2: General operation Models 707B and 708B Switching Matrix Reference Manual Figure 47: Web interface Cards page Open and close slots from the card pages You can open and close slots from the card pages in several ways. The simplest method is to click a connection. The channel changes state to open or closed. When the...
  • Page 92 Models 707B and 708B Switching Matrix Reference Manual Section 2: General operation To specify the type of close, select a Channel Action Type from the box in the upper right before closing a channel. The options are: • Channel Close: Close the selected channel without affecting the state of any other channels.
  • Page 93 Section 2: General operation Models 707B and 708B Switching Matrix Reference Manual In this dialog box, you can set: • Label: The label for the channel. This is the same as the command channel.setlabel(). • Forbidden: Select this box to set the channel to forbidden. This prevents the channel from being closed from any interface.
  • Page 94 Models 707B and 708B Switching Matrix Reference Manual Section 2: General operation 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+click and Shift+click to select multiple channels.

  • Page 95: Scan Builder Page

    Scanning and triggering allow you to synchronize actions across channels. You can set up a scan using the trigger model to precisely time and synchronize the Model 707B or 708B between channels and multiple instruments. You can also use triggers without the triggering model to set up a scan to meet the needs of a specific application that does not fit the triggering model.
  • Page 96 Models 707B and 708B Switching Matrix Reference Manual Section 2: General operation To create a scan list from the web interface: 1. From the left navigation of the web interface Home page, select Scan Builder. 2. In the Add Channel By list on the right, select Number to add the channels individually or Pattern to select patterns.
  • Page 97 Section 2: General operation Models 707B and 708B Switching Matrix Reference Manual The settings that are affected are: • Channels and patterns are removed from the scan list • Bypass: Returned to default setting of ON • Mode: Returned to default setting of Open All •...
  • Page 98 Models 707B and 708B Switching Matrix Reference Manual Section 2: General operation Set up simple triggers You can set up triggers to control your scan using the options on the Simple Triggers tab. You can set: • The event that starts the scan •...
  • Page 99 Section 2: General operation Models 707B and 708B Switching Matrix Reference Manual Advanced triggering The Advanced Trigger tab of the Scan Builder allows you to set the options that are available from the Simple Trigger tab, as well as more sophisticated options to control scan triggering.

  • Page 100: Tsb Embedded

    The commands and output are shown in the Instrument Output box. To resend a command, click the button at the left of the Console box. Figure 52: Model 707B or 708B web interface console 707B-901-01 Rev. A / August 2010...

  • Page 101: Admin Page

    Section 2: General operation Models 707B and 708B Switching Matrix Reference Manual Instrument control To reset the entire TSP-enabled system, including the controlling node and all subordinate nodes, click Reset. Create a script using TSB Embedded NOTE If you are using TSB Embedded to create scripts, you do not need to use the commands loadscript or loadandrunscript and endscript.

  • Page 102: Unit Page

    Models 707B and 708B Switching Matrix Reference Manual Section 2: General operation Change the instrument date and time To change the date and time of the instrument: 1. In the web interface, from the left navigation, click Admin. A login page is displayed.

  • Page 103: Lxi Page

    To clear the report information from the screen, click Clear. LXI page The Model 707B or 708B is an LXI Class C instrument. The LXI page is a read-only page that displays the LXI information about the instrument. IP Config The IP Config allows you to review and change the LAN connection information.
  • Page 104 Models 707B and 708B Switching Matrix Reference Manual Section 2: General operation Figure 53: Event log The time stamp, event identifier, the IP address and the domain name identify the incoming and outgoing LXI trigger packets. The following table provides detailed descriptions for the columns in the event log.
  • Page 105 Timestamp occurred. The timestamp uses the following: PTP timestamp Seconds Fractional seconds The Model 707B or 708B does not support the IEEE-1588 standard; the values in this field are always 0 (zero) HWDetect Identifies a valid LXI trigger packet Sequence...

  • Page 106: Switch Operation

    Channel identification The channels on the cards that you can use with the Model 707B or 708B are referred to by a channel specifier. The specifier is used to identify channels for use with close and open operations, scans, and channel patterns, using the front panel, web, or remote command interface.
  • Page 107 Section 2: General operation Models 707B and 708B Switching Matrix Reference Manual Channel identifiers The channels on the matrix cards are referred to by their slot, bank, row, and column numbers: • Slot number: The number of the slot in which the card is installed.
  • Page 108 Queries that return a list of channels For queries that return a channel list parameter, the Model 707B or 708B separates the channels by a comma or semicolon, depending on the command. When multiple channels are used in the query, the information for the lowest numbered channel is listed first, increasing to the highest numbered channel.
  • Page 109 Section 2: General operation Models 707B and 708B Switching Matrix Reference Manual 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 caution because it will connect two test devices together for the duration of the switch close settle time.
  • Page 110 Models 707B and 708B Switching Matrix Reference Manual Section 2: General operation To set the channel connect rule through the front panel interface: 1. Press the MENU key. 2. Use the navigation wheel to scroll to the CHANNEL menu item.
  • Page 111 Section 2: General operation Models 707B and 708B Switching Matrix Reference Manual To enable sequential connections 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.
  • Page 112 Determining the number of relay closures The Models 707B and 708B keeps an internal count of the number of times each switching card relay has been closed. The total number of relay closures is stored in nonvolatile memory on the switching card.
  • Page 113 • Channel open. The Model 707B or 708B verifies that the operation being requested for a channel is supported by the specified channel and that the channel exists in the instrument. 2-94 707B-901-01 Rev. A / August 2010...
  • Page 114 Close and open channel operations and commands NOTE When you turn on the Model 707B or 708B, relays for all switch cards in the instrument are opened. When you close channels, you have the option to do an exclusive close for the channel or slot. An exclusive channel close closes the selected channel and opens any other channels that are closed.
  • Page 115 Section 2: General operation Models 707B and 708B Switching Matrix Reference Manual To close or open a channel from the remote interface: You can also open and close channels using the following commands: • channel.close() (on page 7-19) • channel.exclusiveclose() (on page 7-24) •...
  • Page 116 Models 707B and 708B Switching Matrix Reference Manual Section 2: General operation Viewing status from the remote command interface To view a list of closed channels, use the channel.getclose() command. For example: print(channel.getclose("allslots")) To view the close and open status of channels, use the channel.getstate() command.
  • Page 117 Section 2: General operation Models 707B and 708B Switching Matrix Reference Manual Forbid closing a channel You can prevent a channel from being closed from any interface by setting it to forbidden. NOTE If the channel that is to be forbidden is used in a channel pattern, the pattern is deleted when you set the channel to be forbidden to close.
  • Page 118 Models 707B and 708B Switching Matrix Reference Manual Section 2: General operation To set up labels from the front panel: 1. Display a channel (you might need to press DISPLAY first). 2. Select the channel for which you want to set labels.
  • Page 119 Section 2: General operation Models 707B and 708B Switching Matrix Reference Manual NOTE Channel patterns inherit the delay times of the individual channels that comprise the pattern. For information on the sequence of close operations on multiple channels, refer to...
  • Page 120 Models 707B and 708B Switching Matrix Reference Manual Section 2: General operation To create a channel pattern from the web interface: 1. From the left navigation, click a slot. 2. Click Pattern (above the Channel Action Type box). The Channel Pattern Configuration dialog box is displayed.
  • Page 121 (on page 2-95) for detail. 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 requested operation is safe for a channel pattern and that a good connection will result for your application with the channel pattern.
  • Page 122 Models 707B and 708B Switching Matrix Reference Manual Section 2: General operation 3. Perform any of the following actions: • Open the channels in the channel pattern: Press OPEN. • Close the channels in the channel pattern without affecting any other channels: Press CLOSE.
  • Page 123 Deleted when a channel associated with the pattern is reset. • Allocated 32KB of memory in the Models 707B and 708B instrument for all channel patterns. To see how much of the channel pattern memory is available or used, send the command: print(memory.available())

  • Page 124: Reset A Channel

    Models 707B and 708B Switching Matrix Reference Manual Section 2: General operation Reset a channel You can reset a channel to its factory default settings. When you reset a channel: • A closed channel opens • Additional user delay is set to zero •...

  • Page 125: Pseudocards

    Section 2: General operation Models 707B and 708B Switching Matrix Reference Manual Pseudocards You can perform open, close, and scan operations and configure your instrument without having an actual switching card installed in your instrument. Using the remote interface, you can assign a pseudocard to an empty switching card slot, allowing the instrument to operate as if a switching card were installed.
  • Page 126 Models 707B and 708B Switching Matrix Reference Manual Section 2: General operation A sample configuration script is shown in the following example. --Auto created configuration script Indicates that this was created with the Create Configuration Script feature --Tue Jul 13 13:02:12 2010...
  • Page 127 Section 2: General operation Models 707B and 708B Switching Matrix Reference Manual Create a configuration script When you run the create configuration script feature, it automatically generates a user script that is saved to a script with a name that you define. Create configuration script is available from the front panel of the instrument, the web interface, and the remote interface.
  • Page 128 Models 707B and 708B Switching Matrix Reference Manual Section 2: General operation Running the configuration script You can run the configuration using the same methods as any other script. See Run scripts (on page 6-6) for information. 707B-901-01 Rev. A / August 2010...

  • Page 130: Functions And Features

    Scanning and triggering allow you to synchronize actions across channels. You can set up a scan using the trigger model to precisely time and synchronize the Model 707B or 708B between channels and multiple instruments. You can also use triggers without the triggering model to set up a scan to meet the needs of a specific application that does not fit the triggering model.
  • Page 131 Section 3: Functions and features Models 707B and 708B Switching Matrix Reference Manual NOTE You cannot use an external trigger event (for example, digital I/O) for the channel stimulus setting of the trigger model when using the front-panel STEP key.

  • Page 132: Trigger Model Components

    Models 707B and 708B Switching Matrix Reference Manual Section 3: Functions and features Trigger model components The individual components of the trigger model are explained in the following paragraphs. Start scan When a scan is initiated, the instrument leaves the idle state and prepares to start scanning. To prepare for scanning, it verifies that channel settings match the scan settings (such as opening all channels or opening only channels on specific slot).

  • Page 133: Trigger Model Events And Associated Commands

    Models 707B and 708B Switching Matrix Reference Manual Trigger model events and associated commands The Models 707B and 708B trigger model has the following events and associated command attributes. These events, along with other events in the system, may be used to configure various stimulus settings.

  • Page 134: Basic Scan Procedure

    If configured to scan the channels in the scan list again, the Model 707B or 708B waits at the control source for another trigger event. After the scan is complete, the Model 707B or 708B outputs another trigger pulse, if configured to do so.

  • Page 135: Changing Attributes Of An Existing Scan

    When a scan already exists, changing channel attributes also causes the scan to change. Once a scan list has been defined, the Model 707B or 708B tries to incorporate your changes into the scan. If the change impacts the ability of the scan to function properly (such as deleting something referenced by the scan), an error message is logged and the scan list may be cleared.

  • Page 136: Foreground And Background Scan Execution

    Models 707B and 708B Switching Matrix Reference Manual Section 3: Functions and features The menu contains the following items: • BACKGROUND: Runs scan list in the background • CREATE: Displays Use INS key • LIST: Displays the current scan list steps. Turn the navigation wheel to scroll through the list.

  • Page 137: Remote Interface Scanning

    Section 3: Functions and features Models 707B and 708B Switching Matrix Reference Manual Remote interface scanning Scan and trigger commands The following list contains commands associated with triggers and bus operation scanning: • trigger.blender[N].clear() (on page 7-201) • trigger.blender[N].orenable (on page 7-202) •...

  • Page 138: Scanning Examples

    Models 707B and 708B Switching Matrix Reference Manual Section 3: Functions and features • scan.trigger.channel.set() (on page 7-156) • scan.trigger.channel.stimulus (on page 7-157) • scan.trigger.clear() (on page 7-158) Scanning examples Assume you have a 7072 card installed in slot 1 of your instrument and you want to scan column 5 on rows 1 to 3.
  • Page 139 Section 3: Functions and features Models 707B and 708B Switching Matrix Reference Manual Flow Chart for Scan Example START SCAN DETECT TRIGGER ON DIGIO TRIGGER LINE 3 STEP 1 CLOSE CHANNEL 1A05 DETECT TRIGGER ON DIGIO TRIGGER LINE 3 STEP 2...
  • Page 140 Models 707B and 708B Switching Matrix Reference Manual Section 3: Functions and features Reset the instrument reset() scan.add("1A05, 1B05, 1C05") Create a three channel scan list Detect falling edges on digio trigger line 3 digio.trigger[3].mode = digio.TRIG_FALLING Configure digio trigger line 3 to pace the scan.trigger.channel.stimulus =...

  • Page 141: Hardware Trigger Modes

    The hardware synchronization lines are classic trigger lines. The Model 707B or 708B contains 14 digital I/O lines and three TSP-Link synchronization lines that you can use for input or output triggering. The following table provides a summary for each hardware trigger mode.
  • Page 142 Models 707B and 708B Switching Matrix Reference Manual Section 3: Functions and features Trigger mode Output Input Notes Unasserted Asserted Detects RisingM High None • Synchronous High Falling Behaves similar to latching SynchronousA • Trigger overrun detection is disabled •...

  • Page 143: Falling Edge Trigger Mode

    Section 3: Functions and features Models 707B and 708B Switching Matrix Reference Manual Falling edge trigger mode The falling edge trigger mode generates low pulses and detects all falling edges. The following graphic illustrates the characteristics for the falling edge input trigger.

  • Page 144: Rising Edge Master Trigger Mode

    Section 3: Functions and features Rising edge master trigger mode Use the rising edge master trigger mode (RisingM) to synchronize with non-Keithley Instruments that require a high pulse. Input trigger detection is not available in this trigger mode. You can use the RisingM trigger mode to generate rising edge pulses.

  • Page 145: Either Edge Trigger Mode

    Section 3: Functions and features Models 707B and 708B Switching Matrix Reference Manual Input characteristics: • All rising edges generate an input event. Figure 63: RisingA output trigger Output characteristics: • When the trigger is asserted, generates a low pulse that is similar to the falling edge trigger mode.

  • Page 146: Understanding Synchronous Triggering Modes

    Use the synchronous triggering modes to implement bidirectional triggering, to wait for one node, or to wait for a collection of nodes to complete all triggered actions. All non-Keithley instrumentation must have a trigger mode that functions similar to the SynchronousA or SynchronousM trigger modes.

  • Page 147: Synchronous Master Trigger Mode

    In this mode, the output trigger consists of a low pulse. All non-Keithley instruments attached to the synchronization line in a trigger mode equivalent to SynchronousA must latch the line low during the pulse duration.

  • Page 148: Synchronous Acceptor Trigger Mode

    Models 707B and 708B Switching Matrix Reference Manual Section 3: Functions and features Figure 67: SynchronousM output trigger Output characteristics: • When the trigger is asserted, it generates a low pulse that is similar to the Falling Edge trigger mode Synchronous acceptor trigger mode Use the synchronous acceptor trigger mode (SynchronousA) with the SynchronousM trigger mode.

  • Page 149: Synchronous Trigger Mode

    Section 3: Functions and features Models 707B and 708B Switching Matrix Reference Manual Input characteristics: • The falling edge is detected as the external drive pulses the line low, and the internal drive latches the line low Figure 69: SynchronousA output trigger Output characteristics: •...

  • Page 150: Events

    Models 707B and 708B Switching Matrix Reference Manual Section 3: Functions and features Input characteristics: • The falling edge generates an input event and latches the internal drive low. Figure 71: 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 not occur.

  • Page 151: Event Blenders

    Section 3: Functions and features Models 707B and 708B Switching Matrix Reference Manual Figure 72: Event detector Event blenders Advanced event handling requires a way to wait for one of 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"...

  • Page 152: Theory Of Operations

    The Models 707B and 708B are composed of several components assembled into an aluminum frame. The Model 707B supports the operation of up to six relay matrix cards; the Model 708B supports the operation of a single relay matrix card. Each of the components is briefly described below.

  • Page 153: Important Test System Safety Information

    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 rated for dry locations. Keithley Instruments, Inc. products are only rated for dry locations.

  • Page 154: Instrument Fan (Model 707B Only)

    The fan keeps the internal power supply and other electronics cool during operation. AC power entry The Model 707B or 708B is powered from standard AC mains supply through a power entry card that is located on the rear panel of the instrument.

  • Page 155: Communication Interfaces

    Section 4: Theory of operations Models 707B and 708B Switching Matrix Reference Manual Communication interfaces You can operate the Model 707B or 708B over one of several standard remote interfaces. The rear panel includes connectors for these communication interfaces: •...
  • Page 156 Models 707B and 708B Switching Matrix Reference Manual Section 4: Theory of operations Figure 75: Model 707B backplane Slot 1 Slot 2 Slot 3 Slot 4 Slot 5 Slot 6 707B-901-01 Rev. A / August 2010...

  • Page 157: Front Panel

    Section 4: Theory of operations Models 707B and 708B Switching Matrix Reference Manual Front panel The front panel of the Keithley Instruments Model 707B or 708B contains the following items: • The display • The crosspoint display (Model 707B only) •...
  • Page 158 Models 707B and 708B Switching Matrix Reference Manual Section 4: Theory of operations Figure 76: Model 707B crosspoint display block diagram Serial Communication Self-refreshing System 5x7 dot character displays Communication Microcontroller Matrix Data PWM Signals Column LED drivers Shut Rrefresh...
  • Page 159 Section 4: Theory of operations Models 707B and 708B Switching Matrix Reference Manual 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 bright or dim based on the appropriate setting from the instrument.
  • Page 160 Models 707B and 708B Switching Matrix Reference Manual Section 4: Theory of operations Display watchdog Once the display tasks are started, if the microcontroller stops refreshing, the watchdog circuit shuts off the column drivers to preserve the life of the LEDs.

  • Page 162: Remote Commands

    Overview of instrument drivers......... 5-18 Migrating from Models 707A and 708A ....5-21 Introduction to remote operation Keithley Instruments Test Script Processor-enabled instruments operate like conventional instruments by responding to a sequence of commands sent by the controller. You can send individual commands ®...
  • Page 163 Section 5: Remote commands Models 707B and 708B Switching Matrix Reference Manual Functions Function-based commands control actions or activities. For example, performing a channel closure is a function. A function-based command is not always directly related to instrument operation. For example, the bit.bitand function will perform a logical AND operation on two numbers.

  • Page 164: Queries

    If you need information on using scripts with Model 707B or 708B, see Fundamentals of scripting for (on page 6-1). If you need information on using the Lua programming language with Model 707B or 708B, see Fundamentals of programming for TSP (on page 6-15).

  • Page 165: About Icl Commands

    Section 5: Remote commands Models 707B and 708B Switching Matrix Reference Manual About ICL commands This section contains an overview of the ICL commands organized into to groups, with a brief description of each group and links to the detailed command descriptions in the...

  • Page 166: Channel Functions And Attributes

    Models 707B and 708B Switching Matrix Reference Manual Section 5: Remote commands NOTE The Test Script Processor (TSP) stores all numbers internally as IEEE Std 754 double-precision floating point values. The logical operations work on 32-bit integers. Any fractional bits will be truncated.
  • Page 167 When the channelList parameter for these functions is "allslots", the response starts with Slot 1 and increases to Slot 6 for the Model 707B. The Model 708B has only one slot, thus "allslots" is the same as "slot1" for this model. Each slot is processed completely before going to the next.
  • Page 168 Models 707B and 708B Switching Matrix Reference Manual Section 5: Remote commands When the response is a comma-delimited string, the individual return items can be identified by iterating through the list using the comma delimiters. For example, the Lua code below will start at the beginning of a string and break the string into individual items at each comma.

  • Page 169: Createconfigscript Function

    Section 5: Remote commands Models 707B and 708B Switching Matrix Reference Manual The channel functions and attributes are: channel.clearforbidden() (on page 7-18) channel.close() (on page 7-19) channel.connectrule (on page 7-20) channel.connectsequential (on page 7-21) channel.createspecifier() (on page 7-23) channel.exclusiveclose() (on page 7-24) channel.exclusiveslotclose()

  • Page 170: Dataqueue Functions And Attributes

    The digital I/O port of the Model 707B or 708B can control external circuitry (such as a component handler for binning operations). The I/O port has 14 lines. Each line can be at TTL logic state 1 (high) or 0 (low).

  • Page 171: Display Functions And Attributes

    Section 5: Remote commands Models 707B and 708B Switching Matrix Reference Manual Example: Write to one bit of the digital I/O port Command Description Writes a 0 to Bit 4 digio.writebit(4, 0) data = digio.readbit(4) Reads the value at Bit 4...

  • Page 172: Eventlog Functions And Attributes

    Models 707B and 708B Switching Matrix Reference Manual Section 5: Remote commands eventlog functions and attributes The functions and attributes in this group control the event log. eventlog.all() (on page 7-87) eventlog.clear() (on page 7-88) eventlog.count (on page 7-89) eventlog.enable (on page 7-90) eventlog.next()

  • Page 173: Lan Functions And Attributes

    Section 5: Remote commands Models 707B and 708B Switching Matrix Reference Manual lan functions and attributes The LAN commands has options that allow you to review and configure network settings. The lan.config.* commands allow you to configure LAN settings over the remote interface. Note that you must send lan.applysettings() in order for the configuration settings to take effect.

  • Page 174: Localnode Functions And Attributes

    Models 707B and 708B Switching Matrix Reference Manual Section 5: Remote commands lan.trigger[N].pseudostate (on page 7-122) lan.trigger[N].stimulus (on page 7-123) lan.trigger[N].wait() (on page 7-125) localnode functions and attributes Commands that allow you to set and read from the local node.

  • Page 175: Scan Functions And Attributes

    Section 5: Remote commands Models 707B and 708B Switching Matrix Reference Manual scan functions and attributes The scan functions and attributes allow you to set up scanning over the remove interface. scan.abort() (on page 7-141) scan.add() (on page 7-142) scan.addimagestep() (on page 7-143) scan.background()

  • Page 176: Slot[X] Attributes

    Models 707B and 708B Switching Matrix Reference Manual Section 5: Remote commands slot[X] attributes The slot attributes configure and read the settings of the cards in the slots. You can also set up pseudocards. slot[X].idn (on page 7-169) slot[X].poles.four (on page 7-170) slot[X].poles.one...

  • Page 177: Trigger Functions And Attributes

    Section 5: Remote commands Models 707B and 708B Switching Matrix Reference Manual trigger functions and attributes Use the trigger functions and attributes to control specific trigger objects. trigger.blender[N].clear() (on page 7-201) trigger.blender[N].EVENT_ID (on page 7-202) trigger.blender[N].orenable (on page 7-202) trigger.blender[N].overrun (on page 7-203) trigger.blender[N].reset()

  • Page 178: Tspnet Functions And Attributes

    Models 707B and 708B Switching Matrix Reference Manual Section 5: Remote commands tspnet functions and attributes ® The TSP-Net module provides a simple socket-like programming interface to TSP enabled instruments. tspnet.clear() (on page 7-228) tspnet.connect() (on page 7-229) tspnet.disconnect() (on page 7-230) tspnet.execute()

  • Page 179: Overview Of Instrument Drivers

    There are several different styles of instrument drivers. Keithley Instruments provides three different instrument drivers for the Models 707B and 708B: a native LabVIEW driver, an IVI-C driver, and an IVI-COM driver. You need to pick the style that best suits the application development environment (ADE) that you are using.

  • Page 180: Vxipnp Drivers

    Models 707B and 708B Switching Matrix Reference Manual Section 5: Remote commands VXIPnP drivers VXI (Vixie) Plug-n-Play (VXIPnP) style drivers are Win32 DLLs that have some standard functions defined by the VXIPnP Alliance, such as: • init • close •...

  • Page 181: Labview Drivers

    Instrument driver examples All Keithley drivers come with examples written in several programming languages that show you how to do the most common things with the instruments. Install the driver. The examples are in the Windows Start menu, under Keithley Instruments >...

  • Page 182: Migrating From Models 707A And 708A

    The ability of the Model 707B or 708B to run scripts that are stored locally results in fast execution time and no communications bottlenecks between the instrument and the computer.

  • Page 183: Ddc To Icl Command Equivalencies

    The DDC structure of the Model 707A or 708A instrument is based on a single ASCII capital letter with possible alphanumeric arguments and terminated with the "X" execute command. The Model 707B or 708B instrument uses a modern dot notation format that logically organizes commands by family, subset 1, subset 2 – optional, and argument. For example: channel.open("allslots")
  • Page 184 When enabling external triggering on the Model 707A or 708A instruments, there were two possible trigger sources, the external trigger line or a GPIB Get command. The Model 707B or 708B has multiple trigger events that are available to iterate through a scan list. The following table shows that specifying a scan event trigger automatically enables it.
  • Page 185 The Model 707B or 708B instrument allows 14 TTL level inputs through the digital I/O connector to act as events to iterate through a scan list. The handling of this command is similar to the F0 and F1 DDC commands shown in the table below, except that you must specify [N] as the digital I/O line polarity you wish to set.
  • Page 186 Set relay setup data format The Gn DDC command controls the data format of relay setups that are returned when queried with the U2,s command. The Model 707B or 708B uses a string format for returning scan list, so data formatting is not used.
  • Page 187 The Model 707A or 708A had the ability to add relay settling time to the system after a channel closes or opens. The Model 707B or 708B improves on the settling time and allows you to apply additional settling delay on a per-channel basis. For more information, see channel functions and attributes page 5-5).
  • Page 188 There is no one command to provide the same functionality as the U0 command, but the series of Model 707B or 708B commands shown in the following table can be used to provide very similar information, without the need to parse a long, unwieldy string.
  • Page 189 TSP-linked system. A feature of the Model 707B or 708B is that these remote nodes are not limited to Model 707B or 708B instruments. They can be remotely linked to any Keithley product that supports TSP-Link. For...
  • Page 190 Models 707B and 708B Switching Matrix Reference Manual Section 5: Remote commands Termination character sent by instrument The Model 707B or 708B always sends a linefeed (ASCII 10) as a termination character after any data. This behavior cannot be changed. Termination characters...

  • Page 192: Instrument Programming

    Section 6 Instrument programming In this section: Fundamentals of scripting for TSP ......6-1 Fundamentals of programming for TSP ....6-15 Using Test Script Builder (TSB) ....... 6-35 Advanced scripting for TSP........6-36 TSP-Link system and running parallel test scripts..6-45 TSP-Net ..............

  • Page 193: What Is A Script

    Section 6: Instrument programming Models 707B and 708B Switching Matrix Reference Manual What is a script? A script is a collection of instrument control commands and programming statements. Scripts that you create are referred to as user scripts. Your scripts can be interactive. Interactive scripts display messages on the front panel of the instrument to prompt the operator to enter parameters.

  • Page 194: What Can Be Included In Scripts

    Models 707B and 708B Switching Matrix Reference Manual Section 6: Instrument programming What can be included in scripts? Scripts can include combinations of commands, instrument control commands, and Lua code. Commands tell the instrument to do one thing. Instrument control commands are commands that are specific to instrument control. They are similar to commands sent to a conventional instrument.
  • Page 195 Builder (TSB) (on page 6-35). TSB Embedded is a tool with a reduced set of features from the complete Keithley TSB IDE. TSB Embedded has both script-building functionality and console functionality (single line ICL commands). It is accessed from an Internet browser.
  • Page 196 Models 707B and 708B Switching Matrix Reference Manual Section 6: Instrument programming Create a script by sending commands over the remote interface You can send commands over the remote interface instead of using TSB Embedded. To create a script over the remote interface, you can use the loadscript, loadandrunscript, and endscript commands.
  • Page 197 Section 6: Instrument programming Models 707B and 708B Switching Matrix Reference Manual Create a script using TSB Embedded NOTE If you are using TSB Embedded to create scripts, you do not need to use the commands loadscript or loadandrunscript and endscript. For information on using TSB Embedded, select the Help button on a web page or the Help option from the navigational pane on the left hand side.
  • Page 198 Models 707B and 708B Switching Matrix Reference Manual Section 6: Instrument programming Run the anonymous script The anonymous script can be run many times without reloading it. It remains in the runtime environment until a new anonymous script is created or until the instrument is turned off.
  • Page 199 Section 6: Instrument programming Models 707B and 708B Switching Matrix Reference Manual NOTE The .save() command saves the script to nonvolatile memory. This saves the change when the instrument is turned off. See Save a user script to nonvolatile memory (on page 6-9) for more detail.

  • Page 200: Working With Scripts In Nonvolatile Memory

    Models 707B and 708B Switching Matrix Reference Manual Section 6: Instrument programming Save the anonymous script as a named script To save the anonymous script to a named script and save it to nonvolatile memory: 1. To name the script, send the following command: script.anonymous.name = "myTest"...
  • Page 201 Section 6: Instrument programming Models 707B and 708B Switching Matrix Reference Manual Example: Save a user script Code Notes test1.save() Assume a script named "test1" has been created and loaded. test1 is saved into nonvolatile memory. Retrieve a user script You can retrieve the source code of a user script that is stored in nonvolatile memory.
  • Page 202 Models 707B and 708B Switching Matrix Reference Manual Section 6: Instrument programming Retrieve a script as a single string To retrieve the entire user script source code as a single string, use the scriptVar.source attribute. The loadscript or loadandrunscript and endscript keywords are not included.
  • Page 203 Section 6: Instrument programming Models 707B and 708B Switching Matrix Reference Manual Example: Retrieve the content of the script with scriptVar.source Code Description print(scriptVarTest.source) Request the source of scriptVarTest. The instrument returns the following. Note that the loadscript and endscript commands are not included errorqueue.clear()

  • Page 204: Programming Examples

    Models 707B and 708B Switching Matrix Reference Manual Section 6: Instrument programming Delete user scripts NOTE These steps remove a script from nonvolatile memory. To completely remove a script from the system, there are additional steps you must take. See Delete user scripts from the instrument page 6-43).
  • Page 205 Section 6: Instrument programming Models 707B and 708B Switching Matrix Reference Manual Interactive script An interactive script prompts the operator to input values using the instrument front panel. The following example script uses display messages to prompt the operator to: •...

  • Page 206: Fundamentals Of Programming For Tsp

    ® is a Lua interpreter. In TSP, the Lua programming language has been extended with the Keithley Instrument Control Library (ICL), which adds instrument control commands to the standard Lua commands. What is Lua? Lua is a programming language that can be used with TSP-enabled instruments. Lua is an efficient language with simple syntax that is easy to learn.
  • Page 207 Section 6: Instrument programming Models 707B and 708B Switching Matrix Reference Manual Type of Comment Usage Example comment delimiters Short comment Use when the --Disable the front-panel LOCAL key. comment text is short enough that it will not display.locallockout = display.lock wrap to a second line.
  • Page 208 Global variables do not exist until they have been used. NOTE Do not create variable names that are the same as the base names of Model 707B or 708B Instrument Control Library (ICL) commands. Doing so will result in the loss of use of those commands.
  • Page 209 Section 6: Instrument programming Models 707B and 708B Switching Matrix Reference Manual Example: Boolean Code Output y = false false boolean print(y, type(y)) Example: String and number Code Output x = "123" string print(x, type(x)) Adding a number to x forces its type to number...
  • Page 210 Models 707B and 708B Switching Matrix Reference Manual Section 6: Instrument programming Functions Lua makes it simple to group commands and statements using the function keyword. Functions can take zero, one, or multiple parameters, and they return zero, one, or multiple parameters.
  • Page 211 Section 6: Instrument programming Models 707B and 708B Switching Matrix Reference Manual Example 2 Code Notes and output add_three = function(parameter1, Creates a variable named add_three that has a variable type of function. parameter2, parameter3) return parameter1 + parameter2 +...
  • Page 212 Models 707B and 708B Switching Matrix Reference Manual Section 6: Instrument programming Steps to create a function using a script Steps Example MakeMyFunction 1. In TSB Embedded, enter a name into the TSP Script box This example concatenates two strings: 2.
  • Page 213 Section 6: Instrument programming Models 707B and 708B Switching Matrix Reference Manual Arithmetic operators Operator Description addition subtraction multiplication division negation (for example, c = -a) exponentiation Relational operators Operator Description less than < > greater than less than or equal <=...
  • Page 214 Models 707B and 708B Switching Matrix Reference Manual Section 6: Instrument programming String concatenation String operators Operator Description Concatenates two strings. If both operands are strings or number, they are converted to strings according to Lua coercion rules, as follows: •...
  • Page 215 Section 6: Instrument programming Models 707B and 708B Switching Matrix Reference Manual Conditional branching Lua uses the if, else, elseif, then, and end keywords to do conditional branching. Note that in Lua, nil and false are false and everything else is true. Zero is true in Lua.
  • Page 216 Models 707B and 708B Switching Matrix Reference Manual Section 6: Instrument programming Example: Else and elseif Code x = 1 y = 2 if x and y then print("'if' expression 2 was not false.") if x or y then print("'if' expression 3 was not false.") if not x then print("'if' expression 4 was not false.")
  • Page 217 Section 6: Instrument programming Models 707B and 708B Switching Matrix Reference Manual Example: While Code Notes and output This loop will exit when list = {"One", "Two", "Three", "Four", "Five", "Six"} list[element] = nil. print("Count list elements on numeric index:")
  • Page 218 Models 707B and 708B Switching Matrix Reference Manual Section 6: Instrument programming Example: Numeric for Code list = {"One", "Two", "Three", "Four", "Five", "Six"} ---------- For loop ----------- print("Counting from one to three:") for element = 1, 3 do print(element, list[element]) print("Counting from one to four, in steps of two:")
  • Page 219 Section 6: Instrument programming Models 707B and 708B Switching Matrix Reference Manual Break The break statement can be used to terminate the execution of a while, repeat, or for loop, skipping to the next statement after the loop. A break ends the innermost enclosing loop.
  • Page 220 Models 707B and 708B Switching Matrix Reference Manual Section 6: Instrument programming Example: Break with infinite loop Code Notes a, b = 0, 1 This example uses a break statement that causes the while loop to exit if the value of a while true do becomes greater than 500.

  • Page 221: Standard Libraries

    Section 6: Instrument programming Models 707B and 708B Switching Matrix Reference Manual Standard libraries In addition to the standard programming constructs described in this document, Lua includes standard libraries that contain useful functions for string manipulation, mathematics, and more. TSP instruments also include instrument control extension libraries, which provide programming interfaces to the instrumentation that can be accessed by the TSP.
  • Page 222 Models 707B and 708B Switching Matrix Reference Manual Section 6: Instrument programming Lua does automatic memory management, which means you do not have to allocate memory for new objects and free it when the objects are no longer needed. Lua manages memory automatically by occasionally running a garbage collector to collect all objects that are no longer accessible from Lua.
  • Page 223 Section 6: Instrument programming Models 707B and 708B Switching Matrix Reference Manual String library functions Function Description string.byte(s) Returns the internal numeric codes of the characters s[i], s[i+1], ···, s[j]. The default value for i is 1; the default string.byte(s, i) value for j is i.
  • Page 224 Models 707B and 708B Switching Matrix Reference Manual Section 6: Instrument programming Math library functions This library is an interface to most of the functions of the ANSI C math library. All trigonometric functions work in radians. The functions math.deg() and math.rad() convert between radians and degrees.

  • Page 225: Programming Example

    Section 6: Instrument programming Models 707B and 708B Switching Matrix Reference Manual Programming example Script with a for loop The following script puts a message on the front panel display slowly — one character at a time. The intent of this example is to demonstrate: •...

  • Page 226: Using Test Script Builder (Tsb)

    Installing the TSB software To install the TSB software: 1. Close all programs. 2. Place the Test Script Builder Software Suite CD (Keithley Instruments part number KTS-850B01 or greater) into your CD-ROM drive. 3. Follow the on-screen instructions. If your web browser does not start automatically and display a screen with software installation links, open the installation file (setup.exe) found on the CD to initiate installation.

  • Page 227: Programming Interaction

    Section 6: Instrument programming Models 707B and 708B Switching Matrix Reference Manual Script Editor The script is written and modified in the Script Editor. Notice that there is a tab available for each opened script file. A script project is then downloaded to the instrument, where it can be run.
  • Page 228 Models 707B and 708B Switching Matrix Reference Manual Section 6: Instrument programming Figure 80: Global variables and scripts in the runtime environment Scripts in the runtime environment Global variables name value script name beepTwoSec beeper.enable = 1 source beeper.beep(2, 2400)

  • Page 229: Create A Script Using The Script.new Command

    Section 6: Instrument programming Models 707B and 708B Switching Matrix Reference Manual Create a script using the script.new command Use script.new to copy an existing script from the local node to a remote node. This can enable parallel script execution.
  • Page 230 Models 707B and 708B Switching Matrix Reference Manual Section 6: Instrument programming Create an unnamed script using script.new NOTE 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.
  • Page 231 Section 6: Instrument programming Models 707B and 708B Switching Matrix Reference Manual Unnamed scripts are also created if you create a new script with the name attribute of a script that is already in the script.user.scripts table. In this case, the name of the script in the script.user.scripts table is set to an empty string before it is replaced by the new script.

  • Page 232: Restore A Script To The Runtime Environment

    Models 707B and 708B Switching Matrix Reference Manual Section 6: Instrument programming Restore a script to the runtime environment You can retrieve a script that was removed from the runtime environment but is still saved in nonvolatile memory. To restore a script from nonvolatile memory back into the runtime environment: script.restore("scriptName")
  • Page 233 Section 6: Instrument programming Models 707B and 708B Switching Matrix Reference Manual Figure 84: Rename script Scripts in the runtime environment Global variables name value script name beep2sec beeper.enable = 1 pointer to script named source beeper.beep(2, 2400) beep2sec beepTwoSec Autorun script.user.scripts table...

  • Page 234: Delete User Scripts From The Instrument

    Models 707B and 708B Switching Matrix Reference Manual Section 6: Instrument programming Delete user scripts from the instrument In most cases, you can delete the script using script.delete() as described in Delete user scripts (on page 6-13) and then turning the instrument off and then 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.

  • Page 235: Memory Considerations For The Runtime Environment

    Section 6: Instrument programming Models 707B and 708B Switching Matrix Reference Manual Memory considerations for the runtime environment The runtime environment has a fixed amount of memory for storing user scripts, channel patterns, and other runtime information. You can check the amount of memory in the instrument with the memory.used() and memory.available() functions.

  • Page 236: Tsp-Link System And Running Parallel Test Scripts

    Models 707B and 708B Switching Matrix Reference Manual Section 6: Instrument programming Example String concatenation lines Optimized with the table.concat function MyPattern = "1A03" MyTable = { } MyPattern = MyPattern .. ",1B03" MyTable[1] = "1A03," MyPattern = MyPattern .. ",1C03"...

  • Page 237: Tsp-Link Nodes

    Section 6: Instrument programming Models 707B and 708B Switching Matrix Reference Manual TSP-Link nodes Uniquely identify each instrument or enclosure attached to the TSP-Link bus. Identify each instrument using a TSP-Link node number, and each enclosure using a node. Each node must be assigned a unique node number.

  • Page 238: Initialization

    Models 707B and 708B Switching Matrix Reference Manual Section 6: Instrument programming Figure 85: Model 708B rear panel TSP-Link connection TSP-Link TSP-Link connections Figure 86: Model 707B rear panel TSP-Link connection LINE RATING 100-240VAC 50, 60Hz 210VA MAX. LINE FUSE SLOWBLOW 2.0A, 250V...
  • Page 239 You can assign a node number (1 to 64) to a Models 707B and 708B using the front panel or through programming.

  • Page 240: Introduction To Tsp Advanced Features

    Models 707B and 708B Switching Matrix Reference Manual Section 6: Instrument programming Front panel operation To reset the TSP-Link network from the front panel: 1. Press the Menu key, then select TSPLINK and press the ENTER key. 2. Turn the navigation wheel to select RESET and then press the ENTER key.

  • Page 241: Using Groups To Manage Nodes On Tsp-Link Network

    Section 6: Instrument programming Models 707B and 708B Switching Matrix Reference Manual TSP-Link network group functions Group number Group members Current function • Master node Initiates and runs a test script on Node 2 • Initiates and runs a test script on Node 5 •...
  • Page 242 Models 707B and 708B Switching Matrix Reference Manual Section 6: Instrument programming Group leader overview Each group has a dynamic group leader. The last node in a group running any operation initiated by the master node is the group leader.

  • Page 243: Running Parallel Test Scripts

    Section 6: Instrument programming Models 707B and 708B Switching Matrix Reference Manual Running parallel test scripts You can issue the execute command from the master node to initiate test script and Lua code on a remote node. The execute command places the remote node in the overlapped operation state. As a test script runs on the remote node, the master node continues to process other commands in parallel.

  • Page 244: Using The Data Queue For Real-Time Communication

    The data queue uses the first-in, first-out (FIFO) structure to store data. Nodes running test scripts in parallel can store data in the data queue for real-time communication. Each Models 707B and 708B has an internal data queue. You can access the data queue from any node at any time.

  • Page 245: Copying Test Scripts Across The Tsp-Link Network

    Section 6: Instrument programming Models 707B and 708B Switching Matrix Reference Manual Copying test scripts across the TSP-Link network To run a large script on a remote node, it is recommended that you copy the test script to the remote node to increase the speed of test script initiation.

  • Page 246: Tsp-Net

    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.

  • Page 247: Using Tsp-Net With Any Ethernet-Enabled Device

    708B assumes the remote device is TSP-enabled and enables TSP prompts and error handling. If the Model 707B or 708B is not able to make a connection to the remote device, it generates a timeout error. Use tspnet.timeout to set the timeout value. The default timeout value is 20 seconds.
  • Page 248 Models 707B and 708B Switching Matrix Reference Manual Section 6: Instrument programming Example script The following example demonstrates how to connect to a remote device that is not TSP-enabled, and send and receive data from this device: -- Disconnect all existing TSP-Net connections.

  • Page 249: Using Tsp-Net Vs. Tsp-Link For Communication With Tsp-Enabled Devices

    Error checking: When connected to a TSP-enabled device, all errors that occur on the remote device are transferred to the error queue of the Model 707B or 708B. The Model 707B or 708B indicates errors from the remote device by prefacing these errors with “Remote Error”.

  • Page 250: Instrument Control Library (Icl) - General Device Control

    Models 707B and 708B Switching Matrix Reference Manual Section 6: Instrument programming Instrument Control Library (ICL) - General device control The following Instrument Control Library (ICL) commands provide general device control: tspnet.clear() (on page 7-228) tspnet.connect() (on page 7-229) tspnet.disconnect() (on page 7-230) tspnet.execute()

  • Page 251: Example: Using Tspnet Commands

    Section 6: Instrument programming Models 707B and 708B Switching Matrix Reference Manual Example: Using tspnet commands function telnetConnect(ipAddress, userName, password) -- Connect through telnet to a computer id = tspnet.connect(ipAddress, 23, "") -- Read the title and login prompt from the computer print(string.format("from computer-->...
  • Page 252 Models 707B and 708B Switching Matrix Reference Manual Section 6: Instrument programming print(string.format("from computer--> (%s)", tspnet.read(id, "%s"))) tspnet.disconnect(id) test_tspnet() 707B-901-01 Rev. A / August 2010 6-61...

  • Page 254: Command Reference

    The function to assert an output trigger is shown as: user-defined parameters that must be replaced digio.trigger[N].assert with a value in the actual code. For example, to program the Model 707B or 708B to NOTE assert an output trigger on trigger line 5, you would send: Do not send placeholder characters digio.trigger[5].assert()

  • Page 255: Syntax Rules

    Section 7: Command reference Models 707B and 708B Switching Matrix Reference Manual Syntax rules for Instrument Control Library commands Syntax rule Details Examples Case sensitivity: Function and attribute An example of the scriptVar.save() Instrument control names should be in function (where test8 is the name of the commands are case lowercase characters.

  • Page 256: Logical Instruments

    Models 707B and 708B Switching Matrix Reference Manual Section 7: Command reference Logical instruments You would normally refer to all instrumentation in one enclosure or node as a single instrument. In the context of TSP and instrument control libraries, it is useful to think of each individual subdivision in an enclosure, such as a card slot or the channels, as a standalone instrument.

  • Page 257: Using The Instrument Control Library Documentation

    Using the Instrument Control Library documentation The Instrument Control Library documentation contains detailed descriptions of each of the instrument control commands you can use to control your Models 707B and 708B. Each instrument control command description is broken into several standardized subsections. The figure below shows an example of an instrument control command description.
  • Page 258 Models 707B and 708B Switching Matrix Reference Manual Section 7: Command reference Figure 88: Command name and standard parameters summary Attribute (RW) System reset Nonvolatile memory 1. Instrument control command name. Signals the beginning of the command description and is followed by a brief description of what the command does.

  • Page 259: Command Usage

    Section 7: Command reference Models 707B and 708B Switching Matrix Reference Manual 5. Where saved. Indicates where the command settings reside once they are 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 createconfigscript() command or the MENU - SCRIPT - CREATE-CONFIG option from the front panel.

  • Page 260: Command Details

    Models 707B and 708B Switching Matrix Reference Manual Section 7: Command reference If there are optional parameters, they must be entered in the order presented in usage. You cannot leave out any parameters that precede the optional parameter, but you can leave off subsequent optional parameters.

  • Page 261: Also See: Related Commands And Information

    Section 7: Command reference Models 707B and 708B Switching Matrix Reference Manual Also see: Related commands and information The Also see section of the instrument control command description lists commands that are related to the command being described. Figure 92: Links to related commands and information Instrument Control Library (ICL) command reference beeper.beep()

  • Page 262: Beeper.enable

    Models 707B and 708B Switching Matrix Reference Manual Section 7: Command reference beeper.enable This attribute allows you to turn the beeper on or off. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Reset Create Enabled configuration script Usage state = beeper.enable...

  • Page 263: Bit.bitor()

    Section 7: Command reference Models 707B and 708B Switching Matrix Reference Manual Example testResult = bit.bitand(10, 9) Performs a logical AND operation on decimal 10 (binary 1010) with decimal 9 (binary 1001), which returns a value of decimal 8 (binary 1000).

  • Page 264: Bit.bitxor()

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

  • Page 265: Bit.get()

    Section 7: Command reference Models 707B and 708B Switching Matrix Reference Manual Details Any fractional part of value is truncated to make it an integer. The returned result is also an integer. The least significant bit of value is at index position 1; the most significant bit is at index position 32.

  • Page 266: Bit.getfield()

    Models 707B and 708B Switching Matrix Reference Manual Section 7: Command reference Also see bit.clear() (on page 7-11) bit.set() (on page 7-14) bit.test() (on page 7-16) bit.toggle() (on page 7-17) Logical operators (on page 6-22) bit.getfield() This function returns a field of bits from the value starting at the specified index position.

  • Page 267: Bit.set()

    Section 7: Command reference Models 707B and 708B Switching Matrix Reference Manual bit.set() This function sets a bit at the specified index position. Type TSP-Link accessible Affected by Where saved Default value Function Usage result = bit.set(value, index) result Result of the bit manipulation...

  • Page 268: Bit.setfield()

    Models 707B and 708B Switching Matrix Reference Manual Section 7: Command reference bit.setfield() This function overwrites a bit field at a specified index position. Type TSP-Link accessible Affected by Where saved Default value Function Usage result = bit.setfield(value, index, width, fieldValue)

  • Page 269: Bit.test()

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

  • Page 270: Bit.toggle()

    Models 707B and 708B Switching Matrix Reference Manual Section 7: Command reference bit.toggle() This function toggles the value of a bit at a specified index position. Type TSP-Link accessible Affected by Where saved Default value Function Usage result = bit.toggle(value, index)

  • Page 271: Channel.clearforbidden()

    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) • Channel ranges or individual channels This function allows all items contained in the channelList parameter to be closed (removes the "forbidden to...

  • Page 272: Channel.close()

    Models 707B and 708B Switching Matrix Reference Manual Section 7: Command reference channel.close() This function closes channels and channel patterns specified by the channel list parameter without opening any channels. Type TSP-Link accessible Affected by Where saved Default value Function Usage channel.close(channelList)

  • Page 273: Channel.connectrule

    Section 7: Command reference Models 707B and 708B Switching Matrix Reference Manual channel.connectrule This attribute controls the connection rule for closing and opening channels in the instrument. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) System reset Create channel.BREAK_BEFORE_MAKE...

  • Page 274: Channel.connectsequential

    Models 707B and 708B Switching Matrix Reference Manual Section 7: Command reference • channel.BREAK_BEFORE_MAKE open settle time + close settle time • channel.MAKE_BEFORE_BREAK close settle time + open settle time • channel.OFF maximum of open settle time or close settle time This behavior is also affected by channel.connectsequential and any additional user delay times.
  • Page 275 Section 7: Command reference Models 707B and 708B Switching Matrix Reference Manual Details When channel.connectsequential is enabled, the list of channel actions is acted on sequentially. No two relays are opened or closed simultaneously. Using a sequential close allows you to determine the time for a close operation to happen. For example, if you close three channels and each takes 4 ms to closej (assuming no additional user delay times), with sequential on, it will take 12 ms.

  • Page 276: Channel.createspecifier()

    Models 707B and 708B Switching Matrix Reference Manual Section 7: Command reference channel.createspecifier() This function creates a string channel descriptor from a series of card-dependent integer arguments. Type TSP-Link accessible Affected by Where saved Default value Function Usage specifier = channel.createspecifier(slot, row, column)

  • Page 277: Channel.exclusiveclose()

    Therefore, when channels are closed, sending channel.exclusiveclose("") is equivalent to channel.open(channel.getclose("allslots")). An error is generated if: • The parameter string contains slotX, where X equals 1 to 6 for Model 707B, or 1 for Model 708B or allslots • A specified channel or channel pattern is invalid •...

  • Page 278: Channel.exclusiveslotclose()

    Models 707B and 708B Switching Matrix Reference Manual Section 7: Command reference Open all channels because the channelList parameter is empty. Close 1D01 and 1E12. Output: 1D01;1E12 Create the pattern myChans. Exclusively close the channels in myChans and additional specified channels. The originally closed channels (1D01 and 1E12) are now open.
  • Page 279 1, 3, 5, and 6. An error is generated if: • The parameter string contains slotX, where X equals 1 to 6 for Model 707B, or 1 for Model 708B, or allslots • A forbidden item is specified Once an error is detected, the command stops processing.

  • Page 280: Channel.getclose()

    The channelList parameter indicates the scope of channels affected, and can include: • allslots or slotX (where X equals 1 to 6 for Model 707B, or 1 for Model 708B) • Channel ranges, individual channels, or channel patterns An error message is generated if an empty parameter string is specified or the scope of the channel list specified contains no valid channels (for example, a channel list equaling "slotX"...

  • Page 281: Channel.getcount()

    • Channel patterns (channels will be listed in the order in which they are listed in the pattern) • slotX, where X equals 1 to 6 for the Model 707B or 1 for the Model 708B • allslots Details A close count is the number of times a relay has been closed. The count values are returned in the order in which the channels are specified.

  • Page 282: Channel.getdelay()

    A string listing the channels to query for their delay times. Details The channelList parameter may contain slotX (where X equals 1 to 6 for Model 707B, or 1 for Model 708B) or allslots. A command, after closing the state of channels, incurs the delay time indicated in the response for a channel before it completes.

  • Page 283: Channel.getforbidden()

    Details The channelList parameter indicates which channels to check, and may include: • allslots or slotX (where X equals 1 to 6 for Model 707B, or 1 for Model 708B) • Channel ranges or individual channels •...

  • Page 284: Channel.getlabel()

    The return string lists the labels in the same order that the channels were specified. The channelList parameter cannot be an empty string and must be a valid channel. The channelList parameter can contain slotX (where X equals 1 to 6 for Model 707B, or 1 for Model 708B) or allslots.

  • Page 285: Channel.getlabelcolumn()

    You cannot specify a channel pattern. The channelList parameter can contain slotX (where X equals 1 to 6 for Model 707B, or 1 for Model 708B) or allslots. It can also contain a label. However, if the label exists, it is in the returned response and not the numeric channel number.

  • Page 286: Channel.getlabelrow()

    The return string label lists the labels in the same order that the channels are specified. The channelList parameter can contain slotX (where X equals 1 to 6 for Model 707B, or 1 for Model 708B) or allslots.

  • Page 287: Channel.getstate()

    Section 7: Command reference Models 707B and 708B Switching Matrix Reference Manual channel.getstate() Queries the state indicators of the channels in the instrument. Type TSP-Link accessible Affected by Where saved Default value Function System reset Not saved Channel reset Usage state = channel.getstate(channelList)

  • Page 288: Channel.gettype()

    String specifying the channels to query, using normal channelList syntax Details The channel type is defined by the physical hardware of the card on which the channel exists. The only valid channel type for the Models 707B and 708B is channel.TYPE_SWITCH or 1. Example print(channel.gettype("1A01")) Queries the channel type of Row 1, Column 1, in Slot 1.
  • Page 289 Section 7: Command reference Models 707B and 708B Switching Matrix Reference Manual Example 1 channel.open("1A01:1A05, 3B03, Chans") Opens channels in Row 1, Columns 01 to 05 on Slot 1; Row 2, Column 03 on Slot 3; and the channels in the channel pattern Chans.

  • Page 290: Channel.pattern.catalog()

    Models 707B and 708B Switching Matrix Reference Manual Section 7: Command reference channel.pattern.catalog() This function creates a list of the user-created channel patterns. Type TSP-Link accessible Affected by Where saved Default value Function Usage for name in channel.pattern.catalog() do name String representing the user-defined name of the channel pattern.

  • Page 291: Channel.pattern.delete()

    Section 7: Command reference Models 707B and 708B Switching Matrix Reference Manual channel.pattern.delete() This function deletes a channel pattern. Type TSP-Link accessible Affected by Where saved Default value Function Usage channel.pattern.delete(name) A string representing the name of the channel pattern to delete...

  • Page 292: Channel.pattern.setimage()

    Models 707B and 708B Switching Matrix Reference Manual Section 7: Command reference Example channel.pattern.setimage("1A01:1A05", "myPattern") Using a Model 7174 (or similar model) card in Slot 1, this example channel.pattern.setimage("1B01,1B03,1B05", creates two channel patterns and "myRoute") then queries these patterns. myImage = channel.pattern.getimage("myPattern")
  • Page 293 Any channel is forbidden to close • Insufficient memory exists to create the channel pattern • The parameter string contains slotX (where X equals 1 to 6 for Model 707B, or 1 for Model 708B) or allslots • The name parameter contains a space character •...

  • Page 294: Channel.pattern.snapshot()

    Models 707B and 708B Switching Matrix Reference Manual Section 7: Command reference Example channel.pattern.setimage("1A01:1A10", "Channels") For this example, assume there is a Keithley Model 7174 or similar card in Slot oldList = channel.pattern.getimage("Channels") newList = oldList .. ", 1C11" Creates a pattern, appends a channel to channel.pattern.delete("Channels")
  • Page 295 Section 7: Command reference Models 707B and 708B Switching Matrix Reference Manual Issuing this function on an existing pattern invalidates the existing scan list (the pattern may or may not be used in the current scan list). Creating a new pattern does not invalidate the existing scan list.

  • Page 296: Channel.reset()

    Models 707B and 708B Switching Matrix Reference Manual Section 7: Command reference channel.reset() This function resets the specified channels to factory default settings. Type TSP-Link accessible Affected by Where saved Default value Function Usage channel.reset(channelList) A string that lists the items to reset. The string can include: channelList •...

  • Page 297: Channel.setdelay()

    Section 7: Command reference Models 707B and 708B Switching Matrix Reference Manual channel.setdelay() This function sets additional delay time for specified channels. Type TSP-Link accessible Affected by Where saved Default value Function System reset Create configuration script Channel reset Usage channel.setdelay(channelList, value)

  • Page 298: Channel.setforbidden()

    Details The channelList parameter indicates the scope of channels affected and may include: • allslots or slotX (where X equals 1 to 6 for Model 707B, or 1 for Model 708B) • Channel ranges or individual channels This function prevents all items contained in the channel list parameter from closing (applies the "forbidden to close"...

  • Page 299: Channel.setlabel()

    Section 7: Command reference Models 707B and 708B Switching Matrix Reference Manual Example channel.pattern.setimage("1A01,1A02", Create three channel patterns, and then print. "patternA") channel.pattern.setimage("1B01,1B02", "patternB") channel.pattern.setimage("1C01,1C02", "patternC") for name in channel.pattern.catalog() do print(name .. " = " .. channel.pattern.getimage(name)) channel.setforbidden("1A02, 1B01") Set forbidden for one channel from patternA and for name in channel.pattern.catalog() do...

  • Page 300: Channel.setlabelcolumn()

    Models 707B and 708B Switching Matrix Reference Manual Section 7: Command reference Details This command sets the label of the channel specified in channelList to the value specified in the label parameter. The label parameter must be unique. In addition, it cannot be the same as the name of a channel pattern, row label, or column label.
  • Page 301 Section 7: Command reference Models 707B and 708B Switching Matrix Reference Manual Details A column label can be applied to columns of a matrix card. The label is then used on the display and can be accessed in a channel list (see About channel commands (on page 5-5)).

  • Page 302: Channel.setlabelrow()

    Models 707B and 708B Switching Matrix Reference Manual Section 7: Command reference channel.setlabelrow() This function assigns a label to a row. Type TSP-Link accessible Affected by Where saved Default value Function System reset Create Empty string or blank configuration script...

  • Page 303: Createconfigscript()

    Section 7: Command reference Models 707B and 708B Switching Matrix Reference Manual Example 4 channel.setlabelrow("2B01", "Row2") This example assumes a 7072 in slot 2. print(channel.getlabelrow("slot2")) Set the label to be Row2, which assigns the label to all channels in the row. The output is now :...

  • Page 304: Dataqueue.add()

    Models 707B and 708B Switching Matrix Reference Manual Section 7: Command reference dataqueue.add() This function adds an entry to the data queue. Type TSP-Link accessible Affected by Where saved Default value Function Usage results = dataqueue.add(value) results = dataqueue.add(value, timeout)

  • Page 305: Dataqueue.capacity

    Section 7: Command reference Models 707B and 708B Switching Matrix Reference Manual dataqueue.CAPACITY This constant is the maximum number of entries that you can store in the data queue. Type TSP-Link accessible Affected by Where saved Default value Constant Usage count = dataqueue.CAPACITY...

  • Page 306: Dataqueue.count

    Models 707B and 708B Switching Matrix Reference Manual Section 7: Command reference Example MaxCount = dataqueue.CAPACITY This example fills the data queue and prints the number of items in the queue. It then clears the while dataqueue.count < MaxCount do queue and prints the number of items again.

  • Page 307: Dataqueue.next()

    Section 7: Command reference Models 707B and 708B Switching Matrix Reference Manual Also see dataqueue.add() (on page 7-51) dataqueue.CAPACITY (on page 7-52) dataqueue.clear() (on page 7-52) dataqueue.next() (on page 7-54) dataqueue.next() This function removes the next entry from the data queue.

  • Page 308: Delay()

    Models 707B and 708B Switching Matrix Reference Manual Section 7: Command reference dataqueue.CAPACITY (on page 7-52) dataqueue.clear() (on page 7-52) dataqueue.count (on page 7-53) delay() This function delays the execution of the commands that follow it. Type TSP-Link accessible Affected by...

  • Page 309: Digio.readport()

    Section 7: Command reference Models 707B and 708B Switching Matrix Reference Manual Usage data = digio.readbit(N) data A custom variable that stores the state of the I/O line Digital I/O line number to be read (1 to 14) Details A returned value of zero (0) indicates that the line is low. A returned value of one (1) indicates that the line is high.

  • Page 310: Digio.trigger[N].Assert()

    Models 707B and 708B Switching Matrix Reference Manual Section 7: Command reference Also see Digital I/O port (on page 2-7) digio.readbit() (on page 7-55) digio.writebit() (on page 7-64) digio.writeport() (on page 7-65) digio.trigger[N].assert() This function asserts a trigger on one of the digital I/O lines.

  • Page 311: Digio.trigger[N].Event_Id

    Section 7: Command reference Models 707B and 708B Switching Matrix Reference Manual Example digio.trigger[2].clear() Clears the trigger event on I/O line 2. Also see digio.trigger[N].overrun (on page 7-60) digio.trigger[N].stimulus (on page 7-62) digio.trigger[N].wait() (on page 7-64) digio.trigger[N].EVENT_ID This attribute identifies the trigger event generated by the digital I/O line N.
  • Page 312 Models 707B and 708B Switching Matrix Reference Manual Section 7: Command reference Usage triggerMode = digio.trigger[N].mode digio.trigger[N].mode = triggerMode triggerMode The trigger mode; see Details for values. Digital I/O trigger line (1 to 14). Details Set tmode to one of the following values:...

  • Page 313: Digio.trigger[N].Overrun

    Section 7: Command reference Models 707B and 708B Switching Matrix Reference Manual Also see digio.trigger[N].reset() (on page 7-62) digio.writebit() (on page 7-64) digio.writeport() (on page 7-65) Scanning and triggering (on page 3-1) digio.trigger[N].overrun Use this attribute to read the event detector overrun status.

  • Page 314: Digio.trigger[N].Release()

    Models 707B and 708B Switching Matrix Reference Manual Section 7: Command reference Usage width = digio.trigger[N].pulsewidth digio.trigger[N].pulsewidth = width width The pulse width (seconds) Digital I/O trigger line (1 to 14) Details Setting width to zero (0) (seconds) asserts the trigger indefinitely. To release the trigger line, use digio.trigger[N].release().

  • Page 315: Digio.trigger[N].Reset()

    Section 7: Command reference Models 707B and 708B Switching Matrix Reference Manual digio.trigger[N].reset() This function resets trigger values to their factory defaults. Type TSP-Link accessible Affected by Where saved Default value Function Usage digio.trigger[N].reset() Digital I/O trigger line (1 to 14)
  • Page 316 Models 707B and 708B Switching Matrix Reference Manual Section 7: Command reference Trigger event IDs Trigger event ID Description digio.trigger[N].EVENT_ID An edge (either rising, falling, or either based on the configuration of the line) on the digital input line The trigger key on the front panel is pressed display.trigger.EVENT_ID...

  • Page 317: Digio.trigger[N].Wait()

    Section 7: Command reference Models 707B and 708B Switching Matrix Reference Manual digio.trigger[N].wait() This function waits for a trigger. Type TSP-Link accessible Affected by Where saved Default value Function Usage triggered = digio.trigger[N].wait(timeout) triggered Returns true if a trigger is detected, or false if no triggers are detected during the...

  • Page 318: Digio.writeport()

    Models 707B and 708B Switching Matrix Reference Manual Section 7: Command reference Details If the output line is write-protected using the digio.writeprotect attribute, the command is ignored. The reset() function does not affect the present state of the digital I/O lines.

  • Page 319: Digio.writeprotect

    Section 7: Command reference Models 707B and 708B Switching Matrix Reference Manual Also see digio.readbit() (on page 7-55) digio.readport() (on page 7-56) digio.writebit() (on page 7-64) digio.writeprotect (on page 7-66) digio.writeprotect This attribute describes the write-protect mask that protects bits from changes from the digio.writebit() and digio.writeport() functions.

  • Page 320: Display.clear()

    Models 707B and 708B Switching Matrix Reference Manual Section 7: Command reference display.clear() This function clears all lines of the display. Type TSP-Link accessible Affected by Where saved Default value Function Usage display.clear() Details This function switches to the user screen and then clears the display.

  • Page 321: Display.getcursor()

    Section 7: Command reference Models 707B and 708B Switching Matrix Reference Manual The following definitions exist: display.ANNUNCIATOR_X Where: X equals FILTER, MATH, 4_WIRE, AUTO, ARM, TRIG, STAR, SAMPLE, EDIT, ERROR, REMOTE, TALK, LISTEN, SRQ, REAR, or REL The values correspond to the indicators listed above.

  • Page 322: Display.getlastkey()

    Models 707B and 708B Switching Matrix Reference Manual Section 7: Command reference Details This function switches the display to the user screen (the text set by display.settext()), and then returns values to indicate the cursor's row and column position and cursor style.

  • Page 323: Display.gettext()

    Section 7: Command reference Models 707B and 708B Switching Matrix Reference Manual Key codes Value Key list Value Key list display.KEY_NONE display.KEY_RUN display.KEY_DELETE display.KEY_TRIG display.KEY_EXIT display.KEY_STEP display.KEY_CLOSE display.KEY_CHAN display.KEY_SLOT display.KEY_INSERT display.KEY_DISPLAY display.KEY_MENU display.KEY_ENTER display.KEY_OPEN display.KEY_LOAD display.KEY_PATT display.KEY_SCAN display.WHEEL_ENTER display.KEY_OPENALL display.WHEEL_LEFT display.KEY_CONFIG...
  • Page 324 Models 707B and 708B Switching Matrix Reference Manual Section 7: Command reference Usage text = display.gettext() text = display.gettext(embellished) text = display.gettext(embellished, row) text = display.gettext(embellished, row, columnStart) text = display.gettext(embellished, row, columnStart, columnEnd) text The returned value, which contains the text that is presently displayed...
  • Page 325 Section 7: Command reference Models 707B and 708B Switching Matrix Reference Manual Example 1 display.clear() display.setcursor(1, 1) display.settext("ABCDEFGHIJ$DKLMNOPQRST") display.setcursor(2, 1) display.settext("abcdefghijklm$Bnopqrstuvwxyz$F123456") print(display.gettext()) print(display.gettext(true)) print(display.gettext(false, 2)) print(display.gettext(true, 2, 9)) print(display.gettext(false, 2, 9, 10)) This example shows how to retrieve the display text in multiple ways. The output is:...

  • Page 326: Display.inputvalue()

    Models 707B and 708B Switching Matrix Reference Manual Section 7: Command reference display.inputvalue() This function displays a formatted input field on the instrument display that the operator can edit. Type TSP-Link accessible Affected by Where saved Default value Function Usage display.inputvalue(format)

  • Page 327: Display.loadmenu.add()

    Functions and variables need to be saved along with the script. If the script is not saved in nonvolatile memory, it will be lost when the Models 707B and 708B are turned off. See Example 2 below.
  • Page 328 Models 707B and 708B Switching Matrix Reference Manual Section 7: Command reference Quick Tip You can create a script that defines several functions, and then use the display.loadmenu.add() command to add items that call those individual functions. This allows the operator to run tests from the front panel.

  • Page 329: Display.loadmenu.catalog()

    Section 7: Command reference Models 707B and 708B Switching Matrix Reference Manual display.loadmenu.catalog() This function creates an iterator for the User menu items, accessed using the LOAD key on the instrument front panel. Type TSP-Link accessible Affected by Where saved...

  • Page 330: Display.locallockout

    Models 707B and 708B Switching Matrix Reference Manual Section 7: Command reference Example display.loadmenu.delete("Test9") Deletes the script named "Test9" for displayName, code in display.loadmenu.catalog() do Output: print(displayName, code) Test DUT1() beeper.beep(2, 500) Part1 testpart([[Part1]], 5.0) Also see display.loadmenu.add() (on page 7-74) display.loadmenu.catalog()

  • Page 331: Display.prompt()

    Section 7: Command reference Models 707B and 708B Switching Matrix Reference Manual Usage selection = display.menu(name, items) selection Name of the variable that holds the menu item selected name Menu name to display on the top line items Menu items to display on the bottom line Details The menu consists of the menu name string on the top line, and a selectable list of items on the bottom line.
  • Page 332 Models 707B and 708B Switching Matrix Reference Manual Section 7: Command reference Details This function creates an editable input field at the present cursor position, and an input prompt message on the bottom line. Example of a displayed input field and prompt: 0.00V...

  • Page 333: Display.screen

    Section 7: Command reference Models 707B and 708B Switching Matrix Reference Manual display.screen This attribute describes the selected display screen. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) System reset Create configuration script display.MAIN Usage displayID = display.screen display.screen = displayID...
  • Page 334 Models 707B and 708B Switching Matrix Reference Manual Section 7: Command reference Key codes Value Key list Value Key list display.KEY_NONE display.KEY_RUN display.KEY_DELETE display.KEY_TRIG display.KEY_EXIT display.KEY_STEP display.KEY_CLOSE display.KEY_CHAN display.KEY_SLOT display.KEY_INSERT display.KEY_DISPLAY display.KEY_MENU display.KEY_ENTER display.KEY_OPEN display.KEY_LOAD display.KEY_PATT display.KEY_SCAN display.WHEEL_ENTER display.KEY_OPENALL display.WHEEL_LEFT display.KEY_CONFIG...

  • Page 335: Display.setcursor

    Section 7: Command reference Models 707B and 708B Switching Matrix Reference Manual Details Sending this command selects the user screen and then moves the cursor to the given location. The display.clear(), display.setcursor(), and display.settext() functions are overlapped, nonblocking commands. That is, the script does NOT wait for one of these commands to complete. These nonblocking functions do not immediately update the display.
  • Page 336 Models 707B and 708B Switching Matrix Reference Manual Section 7: Command reference Details This function selects the user display screen and displays the given text. After the instrument is turned on, the first time you use a display command to write to the display, the message "USER SCREEN"...

  • Page 337: Display.trigger.event_Id

    Section 7: Command reference Models 707B and 708B Switching Matrix Reference Manual display.trigger.EVENT_ID This constant describes the trigger event number. Type TSP-Link accessible Affected by Where saved Default value Constant Usage eventID = display.trigger.EVENT_ID The trigger event number eventID Details Set the stimulus of any trigger event detector to the value of this constant to have it respond to front panel trigger events.

  • Page 338: Errorqueue.clear()

    Models 707B and 708B Switching Matrix Reference Manual Section 7: Command reference Key codes Value Key list Value Key list display.KEY_NONE display.KEY_RUN display.KEY_DELETE display.KEY_TRIG display.KEY_EXIT display.KEY_STEP display.KEY_CLOSE display.KEY_CHAN display.KEY_SLOT display.KEY_INSERT display.KEY_DISPLAY display.KEY_MENU display.KEY_ENTER display.KEY_OPEN display.KEY_LOAD display.KEY_PATT display.KEY_SCAN display.WHEEL_ENTER display.KEY_OPENALL display.WHEEL_LEFT display.KEY_CONFIG...

  • Page 339: Errorqueue.count

    Section 7: Command reference Models 707B and 708B Switching Matrix Reference Manual errorqueue.count This attribute gets the number of entries in the error queue. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Power cycle Not applicable Not applicable...

  • Page 340: Eventlog.all()

    Models 707B and 708B Switching Matrix Reference Manual Section 7: Command reference Severity level descriptions Number Level Description Informational Indicates that there are no entries in the queue. Informational Indicates a status message or minor error. Recoverable Indicates possible invalid user input; operation continues but action should be taken to correct the error.

  • Page 341: Eventlog.clear()

    Section 7: Command reference Models 707B and 708B Switching Matrix Reference Manual Example print(eventlog.all()) Output: 17:26:35.690 10 Oct 2007, LAN0, 192.168.1.102, LXI, 0, 1192037132, 1192037155.733269000, 0, 17:26:39.009 10 Oct 2007, LAN5, 192.168.1.102, LXI, 0, 1192037133, 1192037159.052777000, 0, Also see eventlog.clear() (on page 7-88) eventlog.count...

  • Page 342: Eventlog.count

    Models 707B and 708B Switching Matrix Reference Manual Section 7: Command reference eventlog.count This attribute gets the number of events contained in the event log. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) System reset Not applicable...

  • Page 343: Eventlog.enable

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

  • Page 344: Eventlog.overwritemethod

    Models 707B and 708B Switching Matrix Reference Manual Section 7: Command reference Details Returns the next entry from the event log and removes it from the log. If there are no entries in the event log, returns the value nil.

  • Page 345: Exit()

    Section 7: Command reference Models 707B and 708B Switching Matrix Reference Manual Usage method = eventlog.overwritemethod eventlog.overwritemethod = method method Set to one of the following values: • 0 or eventlog.DISCARD_NEWEST: New entries are not logged • 1 or eventlog.DISCARD_OLDEST: Old entries are deleted as new events...

  • Page 346: Format.asciiprecision

    Models 707B and 708B Switching Matrix Reference Manual Section 7: Command reference format.asciiprecision This attribute sets the precision (number of digits) for all numbers printed with the ASCII format. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW)

  • Page 347: Format.data

    Section 7: Command reference Models 707B and 708B Switching Matrix Reference Manual Usage order = format.byteorder format.byteorder = order order Byte order value as follows: • Most significant byte first: 0, format.NORMAL, format.NETWORK, or format.BIGENDIAN • Least significant byte first: 1, format.SWAPPED or format.LITTLEENDIAN...
  • Page 348 Models 707B and 708B Switching Matrix Reference Manual Section 7: Command reference Usage format = format.data format.data = format value The format to use for data, set to one of the following values: • ASCII format: 1 or format.ASCII •...

  • Page 349: Gettimezone()

    Section 7: Command reference Models 707B and 708B Switching Matrix Reference Manual gettimezone() This function retrieves the local time zone. Type TSP-Link accessible Affected by Where saved Default value Function Usage timeZone = gettimezone() The local timezone of the instrument...

  • Page 350: Gpib.address

    Models 707B and 708B Switching Matrix Reference Manual Section 7: Command reference gpib.address This attribute describes the GPIB address. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Not applicable Nonvolatile memory Usage address = gpib.address gpib.address = address...

  • Page 351: Lan.applysettings()

    Section 7: Command reference Models 707B and 708B Switching Matrix Reference Manual lan.applysettings() This function re-initializes the LAN interface with new settings. Type TSP-Link accessible Affected by Where saved Default value Function Usage lan.applysettings() Details Disconnects all existing LAN connections to the instrument and re-initializes the LAN with the current configuration settings.

  • Page 352: Lan.config.dns.domain

    Models 707B and 708B Switching Matrix Reference Manual Section 7: Command reference Details This attribute is an array of DNS (domain name system) server addresses. These addresses take priority for DNS lookups and are consulted before any server addresses that are obtained using DHCP. This allows local DNS servers to be specified that take priority over DHCP-configured global DNS servers.

  • Page 353: Lan.config.dns.dynamic

    Section 7: Command reference Models 707B and 708B Switching Matrix Reference Manual Example print(lan.config.dns.domain) Returns the present dynamic DNS domain. For example, if the domain is "Matrix", the response would be: Matrix Also see lan.config.dns.dynamic (on page 7-100) lan.config.dns.hostname (on page 7-101) lan.config.dns.verify...

  • Page 354: Lan.config.dns.hostname

    Models 707B and 708B Switching Matrix Reference Manual Section 7: Command reference lan.config.dns.hostname This attribute defines the dynamic DNS host name. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) LAN restore defaults Nonvolatile memory Instrument specific (see Details) Usage hostName = lan.config.dns.hostname...

  • Page 355: Lan.config.gateway

    Section 7: Command reference Models 707B and 708B Switching Matrix Reference Manual Usage state = lan.config.dns.verify lan.config.dns.verify = state state DNS hostname verification state: • lan.ENABLE or 1: DNS host name verification enabled • lan.DISABLE or 0: DNS host name verification disabled...
  • Page 356 Models 707B and 708B Switching Matrix Reference Manual Section 7: Command reference Also see lan.status.gateway (on page 7-110) lan.restoredefaults() (on page 7-107) 707B-901-01 Rev. A / August 2010 7-103...

  • Page 357: Lan.config.ipaddress

    Section 7: Command reference Models 707B and 708B Switching Matrix Reference Manual lan.config.ipaddress This attribute describes the LAN IP address. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) LAN restore defaults Nonvolatile memory "0.0.0.0" Usage ipAddress = lan.config.ipaddress lan.config.ipaddress = ipAddress...

  • Page 358: Lan.config.subnetmask

    Models 707B and 708B Switching Matrix Reference Manual Section 7: Command reference When method is lan.AUTO, the instrument first attempts to configure the LAN settings using dynamic host configuration protocol (DHCP). If DHCP fails, it tries dynamic link local addressing (DLLA). If DLLA fails, it uses the manually specified settings.

  • Page 359: Lan.lxidomain

    Section 7: Command reference Models 707B and 708B Switching Matrix Reference Manual lan.lxidomain This attribute describes the LXI domain. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) LAN restore defaults Nonvolatile memory Usage domain = lan.lxidomain lan.lxidomain = domain...

  • Page 360: Lan.reset()

    Models 707B and 708B Switching Matrix Reference Manual Section 7: Command reference lan.reset() This function resets the LAN interface. Type TSP-Link accessible Affected by Where saved Default value Function Usage lan.reset() Details This function resets the LAN interface. It performs the commands lan.restoredefaults() and lan.applysettings().

  • Page 361: Lan.status.dns.address[N]

    Section 7: Command reference Models 707B and 708B Switching Matrix Reference Manual Example lan.restoredefaults() Restores the LAN defaults. Also see lan.reset() (on page 7-107) localnode.password (on page 7-129) lan.status.dns.address[N] Reads DNS server IP addresses. Type TSP-Link accessible Affected by Where saved...

  • Page 362: Lan.status.dns.name

    Models 707B and 708B Switching Matrix Reference Manual Section 7: Command reference lan.status.dns.name Reads present DNS fully qualified host name. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Not applicable Not applicable Not applicable Usage hostName = lan.status.dns.name...

  • Page 363: Lan.status.gateway

    Section 7: Command reference Models 707B and 708B Switching Matrix Reference Manual lan.status.gateway This attribute reads the LAN default gateway address. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Not applicable Not applicable Not applicable Usage gatewayAddress = lan.status.gateway...

  • Page 364: Lan.status.macaddress

    Models 707B and 708B Switching Matrix Reference Manual Section 7: Command reference lan.status.macaddress This attribute returns the LAN MAC address. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Not applicable Not applicable Not applicable Usage macAddress = lan.status.macaddress...

  • Page 365: Lan.status.port.rawsocket

    Details Stores the TCP port number used to connect the instrument and to control the instrument over a raw socket communication interface. Example print(lan.status.port.rawsocket) Returns the Model 707B or 708B raw socket port number, such as: 5.025000000e+03 Also see None lan.status.port.telnet...

  • Page 366: Lan.status.port.vxi11

    Models 707B and 708B Switching Matrix Reference Manual Section 7: Command reference Example print(lan.status.port.telnet) Get the LAN Telnet connection port number. Output: 2.3000000e+01 Also see None lan.status.port.vxi11 This attribute gets the LAN VXI-11 connection port number. Type TSP-Link accessible Affected by...

  • Page 367: Lan.status.subnetmask

    Section 7: Command reference Models 707B and 708B Switching Matrix Reference Manual Example print(lan.status.speed) Returns the instrument's transmission speed presently in use, such as: 1.0000000e+02 Also see None lan.status.subnetmask This attribute reads the LAN subnet mask that is presently in use.

  • Page 368: Lan.trigger[N].Clear()

    Models 707B and 708B Switching Matrix Reference Manual Section 7: Command reference Details Generates and sends a LAN trigger packet for the LAN event number specified. Sets the pseudostate to the appropriate state. The following indexes provide the listed events: •...

  • Page 369: Lan.trigger[N].Connect()

    Section 7: Command reference Models 707B and 708B Switching Matrix Reference Manual Also see lan.trigger[N].assert() (on page 7-114) lan.trigger[N].overrun (on page 7-121) lan.trigger[N].stimulus (on page 7-123) lan.trigger[N].wait() (on page 7-125) lan.trigger[N].connect() This function connects the lan.trigger instance to the listeners specified by protocol and IP address.

  • Page 370: Lan.trigger[N].Connected

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

  • Page 371: Lan.trigger[N].Disconnect()

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

  • Page 372: Lan.trigger[N].Ipaddress

    Models 707B and 708B Switching Matrix Reference Manual Section 7: Command reference lan.trigger[N].ipaddress This attribute specifies the address (in dotted-decimal format) of UDP or TCP listeners. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) System reset Create "0.0.0.0"...
  • Page 373 Section 7: Command reference Models 707B and 708B Switching Matrix Reference Manual Details This attribute controls the mode in which the trigger event detector and the output trigger generator operate on the given trigger. These settings are intended to provide behavior similar to the digital I/O triggers.

  • Page 374: Lan.trigger[N].Overrun

    Models 707B and 708B Switching Matrix Reference Manual Section 7: Command reference lan.trigger[N].overrun This attribute describes event detector overrun status. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Not applicable Not applicable Not applicable Usage overrun = lan.trigger[N].overrun...

  • Page 375: Lan.trigger[N].Protocol

    Section 7: Command reference Models 707B and 708B Switching Matrix Reference Manual lan.trigger[N].protocol This attribute sets the LAN protocol to use for sending trigger messages. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) System reset Create lan.TCP...

  • Page 376: Lan.trigger[N].Stimulus

    Models 707B and 708B Switching Matrix Reference Manual Section 7: Command reference Details This attribute can initialize the pseudo state to a known value. Setting this attribute will not cause the LAN trigger to generate any events or output packets.
  • Page 377 Section 7: Command reference Models 707B and 708B Switching Matrix Reference Manual Trigger event IDs Trigger event ID Description digio.trigger[N].EVENT_ID An edge (either rising, falling, or either based on the configuration of the line) on the digital input line display.trigger.EVENT_ID The trigger key on the front panel is pressed A *trg message on the active command interface.

  • Page 378: Lan.trigger[N].Wait()

    Models 707B and 708B Switching Matrix Reference Manual Section 7: Command reference lan.trigger[N].wait() This function waits for an input trigger. Type TSP-Link accessible Affected by Where saved Default value Function Usage triggered = lan.trigger[N].wait(timeout) Trigger detection indication triggered The trigger packet over LAN to wait for (1 to 8)

  • Page 379: Localnode.description

    This attribute stores a string that contains a description of the instrument. This value appears on instrument's LXI home page. This attribute's default value contains Keithley MMMM #SSSSSSSS, where: MMMM is the instrument's four-digit model number, and #SSSSSSSS is the instrument's eight-digit serial number. You can change it to a value that makes sense for your system.

  • Page 380: Localnode.execute()

    Models 707B and 708B Switching Matrix Reference Manual Section 7: Command reference Also see Using the web interface (on page 2-69) localnode.execute() This function starts test scripts on a remote node. Type TSP-Link accessible Affected by Where saved Default value...

  • Page 381: Localnode.getglobal()

    Section 7: Command reference Models 707B and 708B Switching Matrix Reference Manual localnode.getglobal() This function returns the value of a global variable. Type TSP-Link accessible Affected by Where saved Default value Function Yes (see Details) Usage value = node[N].getglobal(name) The value of the variable...

  • Page 382: Localnode.password

    Models 707B and 708B Switching Matrix Reference Manual Section 7: Command reference localnode.serialno (on page 7-132) localnode.password This attribute stores the remote access password. Type TSP-Link accessible Affected by Where saved Default value Attribute (W) LAN reset Nonvolatile "admin" memory...

  • Page 383: Localnode.prompts4882

    Section 7: Command reference Models 707B and 708B Switching Matrix Reference Manual Details This attribute controls prompting. When set to 1, prompts are issued after each command message is processed by the instrument. When set to 0, prompts are not issued.

  • Page 384: Localnode.reset()

    Models 707B and 708B Switching Matrix Reference Manual Section 7: Command reference This attribute resets to the default value each time the instrument power is cycled. Example Disables IEEE Std. 488.2 common command prompting. localnode.prompts4882 = 0 Also see localnode.prompts (on page 7-129) localnode.reset()

  • Page 385: Localnode.serialno

    Section 7: Command reference Models 707B and 708B Switching Matrix Reference Manual Details This attribute indicates the firmware revision number currently running in the instrument. Example print(localnode.revision) Outputs the present revision level. Sample output: 01.00a Also see localnode.description (on page 7-126) localnode.model...

  • Page 386: Localnode.setglobal()

    Models 707B and 708B Switching Matrix Reference Manual Section 7: Command reference localnode.setglobal() This function sets the value of a global variable. Type TSP-Link accessible Affected by Where saved Default value Function Yes (see Details) Usage node[N].setglobal(name, value) The node number of the instrument...

  • Page 387: Makegetter()

    Section 7: Command reference Models 707B and 708B Switching Matrix Reference Manual When used in an expanded system (TSP-Link), localnode.showerrors is sent to the remote master node only. Use node[N].showerrors (where N is the node number) to send the command to any node in the system.

  • Page 388: Makesetter()

    Models 707B and 708B Switching Matrix Reference Manual Section 7: Command reference makesetter() This function creates a function that, when called, sets the value of an attribute. Type TSP-Link accessible Affected by Where saved Default value Function Usage setter = makesetter(table, attributeName)
  • Page 389 Section 7: Command reference Models 707B and 708B Switching Matrix Reference Manual Usage memoryAvailable = memory.available() memoryAvailable Comma-delimited string with percentages for available memory; the format is systemMemory, scriptMemory, patternMemory, where: • systemMemory: The percentage of memory available in the instrument •...

  • Page 390: Memory.used()

    Models 707B and 708B Switching Matrix Reference Manual Section 7: Command reference memory.used() This function reports the amount of memory used in the instrument overall and for user scripts, and storing channel patterns. Type TSP-Link accessible Affected by Where saved...

  • Page 391: Print()

    Section 7: Command reference Models 707B and 708B Switching Matrix Reference Manual Note that each node independently sets its operation complete bits in its own status model. Any nodes not actively performing overlapped commands will set their bits immediately. All remaining nodes will set their own bits as they complete their own overlapped commands.
  • Page 392 Models 707B and 708B Switching Matrix Reference Manual Section 7: Command reference Usage printbuffer(startIndex, endIndex, buffer1) printbuffer(startIndex, endIndex, buffer1, buffer2) printbuffer(startIndex, endIndex, buffer1, …, bufferN) startIndex Beginning index of the buffer that is to be printed endIndex Ending index of the buffer that is to be printed...

  • Page 393: Printnumber()

    Section 7: Command reference Models 707B and 708B Switching Matrix Reference Manual printnumber() This function prints numbers using the configured format. Type TSP-Link accessible Affected by Where saved Default value Function Usage printnumber(value) printnumber(value, value2, …, value_N) value, value2, value_N...

  • Page 394: Scan.abort()

    Models 707B and 708B Switching Matrix Reference Manual Section 7: Command reference Details command in its simplest form resets the entire TSP-enabled system, including the controlling reset() node and all subordinate nodes. If you want to reset a specific instrument, use either the localnode.reset()

  • Page 395: Scan.add()

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

  • Page 396: Scan.addimagestep()

    Models 707B and 708B Switching Matrix Reference Manu Section 7: Command reference Example 3 scan.create("") Clears the old scan list and creates a new empty scan list. Also see scan.create() (on page 7-146) Scanning and triggering (on page 3-1) scan.addimagestep() This function allows you to include multiple channels in a single scan step.

  • Page 397: Scan.background()

    Section 7: Command reference Models 707B and 708B Switching Matrix Reference Manual Example scan.create() Generate a scan list that has multiple steps, with some steps that include scan.add("1D01") multiple channels. scan.addimagestep("1A01, 1B01, 1C03") scan.add("1F03") Output: scan.addimagestep("1A03, 1B03, 1C03") Init) OPEN...

  • Page 398: Scan.bypass

    Models 707B and 708B Switching Matrix Reference Manual Section 7: Command reference state The result of scanning: scan.EMPTY or 0 scan.BUILDING or 1 scan.RUNNING or 2 scan.ABORTED or 3 scan.FAILED or 4 scan.FAILED_INIT or 5 scan.SUCCESS or 6 The present number of scans completed...

  • Page 399: Scan.create()

    Section 7: Command reference Models 707B and 708B Switching Matrix Reference Manual Details When bypass is ON and the scan.trigger.arm.stimulus is satisfied, the first channel of the scan closes (the scan.trigger.channel.stimulus setting is ignored). For other channels (other than the first), the channel stimulus must be satisfied before the channel action takes place.

  • Page 400: Scan.execute()

    Models 707B and 708B Switching Matrix Reference Manual Section 7: Command reference Example 2 scan.create() Replaces the active scan list with an empty scan list. Loops through column 1 to 10 on row 1 of slot for column = 1, 10 do 1 to add ten channels to the scan list.

  • Page 401: Scan.list()

    Section 7: Command reference Models 707B and 708B Switching Matrix Reference Manual Example scan.execute() Runs a scan immediately. Also see scan.add() (on page 7-142) scan.background() (on page 7-144) scan.create() (on page 7-146) scan.list() (on page 7-148) scan.state() (on page 7-152) scan.list()
  • Page 402 Models 707B and 708B Switching Matrix Reference Manual Section 7: Command reference Example scan.create("1A07:1B03") Populate the scan list with the function scan.create("1A07:1B03"), then initiate the print(scan.list()) scan list to be output. Outputs the existing scan list. Output: Init) OPEN... 1) STEP: 1A07...

  • Page 403: Scan.mode

    Section 7: Command reference Models 707B and 708B Switching Matrix Reference Manual scan.mode This attribute controls the scan mode setting. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) System reset Create scan.MODE_OPEN_ALL configuration script Scan reset Usage scanModeSetting = scan.mode...

  • Page 404: Scan.scancount

    Models 707B and 708B Switching Matrix Reference Manual Section 7: Command reference • scan.scancount • scan.trigger.arm.stimulus • scan.trigger.channel.stimulus In addition, the scan list is cleared. NOTE Sending this function only affects the trigger model and scan list settings. To reset the entire system to factory default settings, use the reset() command.

  • Page 405: Scan.state()

    Section 7: Command reference Models 707B and 708B Switching Matrix Reference Manual Example scan.scancount = 5 Sets the scan count to 5. Also see Trigger model (on page 3-1) scan.state() This function provides the present state of a running background scan.

  • Page 406: Scan.stepcount

    Models 707B and 708B Switching Matrix Reference Manual Section 7: Command reference Also see scan.mode (on page 7-150) scan.background() (on page 7-144) scan.stepcount This attribute contains the number of steps in the present scan. Type TSP-Link accessible Affected by Where saved...

  • Page 407: Scan.trigger.arm.set()

    Section 7: Command reference Models 707B and 708B Switching Matrix Reference Manual Example scan.trigger.arm.clear() Clears the arm event detector. Also see scan.trigger.arm.set() (on page 7-154) scan.trigger.arm.stimulus (on page 7-154) Trigger model (on page 3-1) scan.trigger.arm.set() This function sets the arm event detector to the detected state.
  • Page 408 Models 707B and 708B Switching Matrix Reference Manu Section 7: Command reference Details This attribute selects which events cause the arm event detector to enter the detected state. Set this attribute to 0 to start the scan without waiting for an event. eventID may be one of the following trigger event IDs: •...

  • Page 409: Scan.trigger.channel.clear()

    Section 7: Command reference Models 707B and 708B Switching Matrix Reference Manual scan.trigger.channel.clear() This function clears the channel event detector. Type TSP-Link accessible Affected by Where saved Default value Function Usage scan.trigger.channel.clear() Details This function clears the channel event detector of the trigger model (sets it to the undetected state).

  • Page 410: Scan.trigger.channel.stimulus

    Models 707B and 708B Switching Matrix Reference Manual Section 7: Command reference scan.trigger.channel.stimulus This attribute determines which trigger events cause the channel actions to occur. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Yes System reset Create configuration scan.trigger.EVENT_CHANNEL_READY...

  • Page 411: Scan.trigger.clear()

    Section 7: Command reference Models 707B and 708B Switching Matrix Reference Manual Example 1 scan.trigger.channel.stimulus = Sets the trigger stimulus of the channel event detector to scan start event. scan.trigger.EVENT_SCAN_START Example 2 scan.trigger.channel.stimulus = 0 Starts the channel action immediately after the Scan Start Event.

  • Page 412: Script.anonymous

    Models 707B and 708B Switching Matrix Reference Manual Section 7: Command reference script.anonymous This is a reference to the anonymous script. Type TSP-Link accessible Affected by Where saved Default value See Details See Details Not applicable Attribute Usage scriptVar = script.anonymous Details You can use the script.anonymous script like any other script.

  • Page 413: Script.new()

    Section 7: Command reference Models 707B and 708B Switching Matrix Reference Manual Example script.delete("test8") Deletes a user script named "test8" from nonvolatile memory. Also see Delete user scripts (on page 6-13) Delete user scripts from the instrument (on page 6-43) scriptVar.save()

  • Page 414: Script.newautorun()

    Models 707B and 708B Switching Matrix Reference Manual Section 7: Command reference Example 2: Create new autoexec script autoexec = script.new( "display.clear() display.settext('Hello from autoexec')", 'autoexec') Creates a new script that clears the display when the instrument is turned on and displays "Hello from autoexec".

  • Page 415: Script.restore()

    Section 7: Command reference Models 707B and 708B Switching Matrix Reference Manual script.restore() This function restores a script that was removed from the runtime environment. Type TSP-Link accessible Affected by Where saved Default value Function Usage script.restore(name) The name of the script to be restored...

  • Page 416: Script.user.catalog()

    Models 707B and 708B Switching Matrix Reference Manual Section 7: Command reference script.user.catalog() This function returns an iterator that can be used in a for loop to iterate over all the scripts stored in nonvolatile memory. Type TSP-Link accessible Affected by...

  • Page 417: Scriptvar.list()

    Section 7: Command reference Models 707B and 708B Switching Matrix Reference Manual NOTE Save the script in nonvolatile memory after setting the autorun attribute to save the change when the instrument is turned off. Example test5.autorun = "yes" Assume a script named "test5" is in the runtime environment.
  • Page 418 Models 707B and 708B Switching Matrix Reference Manual Section 7: Command reference Usage scriptVar.name = scriptName scriptName = scriptVar.name scriptVar Name of the variable that references the script scriptName A string that represents the name of the script Details When setting the script name, this attribute renames the script that the variable scriptVar references.

  • Page 419: Scriptvar.run()

    Section 7: Command reference Models 707B and 708B Switching Matrix Reference Manual scriptVar.run() This function runs a script. Type TSP-Link accessible Affected by Where saved Default value Function Usage scriptVar.run() scriptVar() scriptVar The name of variable that references the script Example test8.run()

  • Page 420: Scriptvar.source

    Models 707B and 708B Switching Matrix Reference Manual Section 7: Command reference scriptVar.source This attribute holds the source code of a user script. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Not applicable Not saved Not applicable Usage code = scriptVar.source...

  • Page 421: Settimezone()

    Section 7: Command reference Models 707B and 708B Switching Matrix Reference Manual Details This function sets the date and time of the system based on the os.time() response passed in as its parameter. Use year, month, day, hour, min, and sec to set the time as desired. The first three parameters to os.time() are mandatory while the rest are optional.

  • Page 422: Slot[X].Idn

    Models 707B and 708B Switching Matrix Reference Manual Section 7: Command reference Details The time zone is only used when converting between local time and UTC time when using the os.time() and os.date() functions. The instrument does not track daylight savings time.

  • Page 423: Slot[X].Poles.four

    Section 7: Command reference Models 707B and 708B Switching Matrix Reference Manual For pseudocards, the response is Pseudo, followed by the model number, description, firmware revision, and ??? for the serial number. Example If a Model 7173 card is installed in slot 1, the response is: print(slot[1].idn)

  • Page 424: Slot[X].Poles.one

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

  • Page 425: Slot[X].Pseudocard

    Nonvolatile memory Usage pseudoCard = slot[X].pseudocard slot[X].pseudocard = pseudoCard pseudoCard The pseudocards available for Models 707B and 708B are: • slot.PSEUDO_NONE or 0 for no pseudocard selection • 7072 for the Model 7072 8x12 Semiconductor Matrix Card • 70721 for the Model 7072-HV 8x12 High-Voltage Semiconductor Matrix Card •...

  • Page 426: Status.condition

    Models 707B and 708B Switching Matrix Reference Manual Section 7: Command reference Example 2 slot[1].pseudocard = 0 This example requires an empty slot. print(slot[1].idn) The slot is set to empty and then set to a valid value. slot[1].pseudocard = 7072 Output: print(slot[1].idn)
  • Page 427 Section 7: Command reference Models 707B and 708B Switching Matrix Reference Manual The following table contains descriptions of the bits: Value Description status.MEASUREMENT_SUMMARY_BIT Set summary bit indicates that an enabled measurement event has occurred. status.MSB Bit 0 decimal value: 1 Set summary bit indicates that an enabled system status.SYSTEM_SUMMARY_BIT...

  • Page 428: Status.node_Enable

    Models 707B and 708B Switching Matrix Reference Manual Section 7: Command reference Example statusByte = status.condition Returns statusByte. print(statusByte) Sample output: 1.29000e+02 Converting this output (129) to its binary equivalent yields: 1000 0001 Therefore, this output indicates that the set bits of the status byte condition register are presently B0 (MSS) and B7 (OSB).
  • Page 429 Section 7: Command reference Models 707B and 708B Switching Matrix Reference Manual Value Description status.ERROR_AVAILABLE Set summary bit indicates that an error or status message status.EAV is present in the Error Queue. Bit 2 decimal value: 4 Set summary bit indicates that an enabled questionable status.QUESTIONABLE_SUMMARY_BIT...
  • Page 430 Models 707B and 708B Switching Matrix Reference Manual Section 7: Command reference status.node_event This attribute stores the status node event register. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Not applicable Not saved Usage nodeEventRegister = status.node_event nodeEventRegister The node event register's status in decimal form.

  • Page 431: Status.node_Event

    Section 7: Command reference Models 707B and 708B Switching Matrix Reference Manual Binary value Decimal Weights Example Reads the status node event register. nodeEventRegister = status.node_event print(nodeEventRegister) Sample output: 1.29000e+02 Converting this output (129) to its binary equivalent yields: 1000 0001...
  • Page 432 Models 707B and 708B Switching Matrix Reference Manual Section 7: Command reference Details Although the status logical instrument reset affects these attributes, a system reset does not. These attribute's values are set using a constant or a decimal value, but are returned as a decimal value. The binary equivalent of the value indicates which register bits are set.

  • Page 433: Status.operation.user

    Section 7: Command reference Models 707B and 708B Switching Matrix Reference Manual Example 2 -- decimal 18432 = binary 0100 1000 0000 0000 Sets the PRMPTS and PROG bits of the operation status enable register using a operationRegister = 18432 decimal value.
  • Page 434 Models 707B and 708B Switching Matrix Reference Manual Section 7: Command reference Details Although the status logical instrument reset affects these attributes, a system reset does not. These attribute's values are set using a constant or a decimal value, but are returned as a decimal value. The binary equivalent of the value indicates which register bits are set.

  • Page 435: Status.questionable

    Section 7: Command reference Models 707B and 708B Switching Matrix Reference Manual Example 1 operationRegister = status.operation.user.BIT11 + Sets BIT11 and BIT14 of the operation status enable register register using status.operation.user.BIT14 constants. status.operation.user.enable = operationRegister Example 2 -- 18432 = binary 0100 1000 0000 0000...
  • Page 436 Models 707B and 708B Switching Matrix Reference Manual Section 7: Command reference Details Although the status logical instrument reset affects these attributes, a system reset does not. This attribute's values are set using a constant or a decimal value, but are returned as a decimal value.

  • Page 437: Status Reset

    Section 7: Command reference Models 707B and 708B Switching Matrix Reference Manual Example 2 -- decimal 2560 = binary 00001010 0000 0000 Sets BIT9 and BIT11 of the status questionable enable register using a quesRegister = 2560 decimal value. status.questionable.enable = quesRegister...
  • Page 438 Models 707B and 708B Switching Matrix Reference Manual Section 7: Command reference The individual bits of the status byte condition register can be set using constants (for example, to set the enable bit of the status register to B0, set status.request_enable = status.MSB). The following table contains...
  • Page 439 Section 7: Command reference Models 707B and 708B Switching Matrix Reference Manual status.request_event This attribute stores the service request (SRQ) event register. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Not applicable Not saved Usage requestSRQEventRegister = status.request_event requestSRQEventRegister The request event register's status in decimal form.
  • Page 440 Models 707B and 708B Switching Matrix Reference Manual Section 7: Command reference In addition to the above constants, requestEventRegister can be set to the decimal equivalent of the bit(s) set. When more than one bit of the register is set, requestEventRegister contains the sum of their decimal weights.

  • Page 441: Status.standard

    Section 7: Command reference Models 707B and 708B Switching Matrix Reference Manual status.standard.* These attributes manage the status model's standard register set. Type TSP-Link accessible Affected by Where saved Default value Attribute .condition (R) Not applicable Not saved Not applicable .enable (RW)
  • Page 442 Models 707B and 708B Switching Matrix Reference Manual Section 7: Command reference The individual bits of the status byte condition register can be set using constants (for example, to set the enable bit of the standard event status register to B0, set status.standard.enable = status.standard.OPC).

  • Page 443: Status.system

    Section 7: Command reference Models 707B and 708B Switching Matrix Reference Manual Example 2 -- decimal 17 = binary 0001 0001 Sets the OPC and EXE bits of the standard event status register using a standardRegister = 17 decimal value.
  • Page 444 Models 707B and 708B Switching Matrix Reference Manual Section 7: Command reference Details Although the status logical instrument reset affects these attributes, a system reset does not. In an expanded system (TSP-Link), these attributes are used to read or write to the system summary registers.

  • Page 445: Status.system2

    Section 7: Command reference Models 707B and 708B Switching Matrix Reference Manual Example 1 enableRegister = status.system.NODE11 + Sets BIT11 and BIT14 of the status system enable register set 1 using status.system.NODE14 constants. status.system.enable = enableRegister Example 2 -- decimal 18432 = binary 0100 1000 0000 0000...
  • Page 446 Models 707B and 708B Switching Matrix Reference Manual Section 7: Command reference Details Although the status logical instrument reset affects these attributes, a system reset does not. In an expanded system (TSP-Link), these attributes are used to read or write to the system summary registers.

  • Page 447: Status.system3

    Section 7: Command reference Models 707B and 708B Switching Matrix Reference Manual Example 1 enableRegister = status.system2.NODE25 + Sets BIT11 and BIT14 of the status system enable register set 2 using status.system2.NODE28 constants. status.system2.enable = enableRegister Example 2 -- decimal 18432 = binary 0100 1000 0000 0000...
  • Page 448 Models 707B and 708B Switching Matrix Reference Manual Section 7: Command reference Details Although the status logical instrument reset affects these attributes, a system reset does not. In an expanded system (TSP-Link), these attributes are used to read or write to the system summary registers.

  • Page 449: Status.system4

    Section 7: Command reference Models 707B and 708B Switching Matrix Reference Manual Example 1 enableRegister = status.system3.NODE39 + Sets BIT11 and BIT14 of the status system enable register set 3 using status.system3.NODE42 constants. status.system3.enable = enableRegister Example 2 Sets BIT11 and BIT14 of the status...
  • Page 450 Models 707B and 708B Switching Matrix Reference Manual Section 7: Command reference Details Although the status logical instrument reset affects these attributes, a system reset does not. In an expanded system (TSP-Link), these attributes are used to read or write to the system summary registers.

  • Page 451: Status.system5

    Section 7: Command reference Models 707B and 708B Switching Matrix Reference Manual Example 1 enableRegister = status.system4.NODE53 + Sets BIT11 and BIT14 of the status system enable register set 4 using status.system4.NODE56 constants. status.system2.enable = enableRegister Example 2 -- decimal 18432 = binary 0100 1000 0000 0000...
  • Page 452 Models 707B and 708B Switching Matrix Reference Manual Section 7: Command reference Details Although the status logical instrument reset affects these attributes, a system reset does not. In an expanded system (TSP-Link), these attributes are used to read or write to the system summary registers.
  • Page 453 Section 7: Command reference Models 707B and 708B Switching Matrix Reference Manual Example 2 -- decimal 18 = binary 0000 0000 0001 0010 Sets BIT1 and BIT5 of the status system enable register set 5 register using a enableRegister = 18 decimal value.

  • Page 454: Timer.reset()

    Models 707B and 708B Switching Matrix Reference Manual Section 7: Command reference timer.reset() This function resets the timer to zero (0) seconds. Type TSP-Link accessible Affected by Where saved Default value Function Usage timer.reset() Example timer.reset() Resets the timer and then measures the time since the reset.

  • Page 455: Trigger.blender[N].Event_Id

    Section 7: Command reference Models 707B and 708B Switching Matrix Reference Manual trigger.blender[N].EVENT_ID This attribute sets the trigger blender event number. Type TSP-Link accessible Affected by Where saved Default value Constant Usage eventID = trigger.blender[N].EVENT_ID Trigger event number eventID The blender number (1 or 2)

  • Page 456: Trigger.blender[N].Overrun

    Models 707B and 708B Switching Matrix Reference Manual Section 7: Command reference trigger.blender[N].overrun This attribute indicates whether or not an event was ignored because of the event detector state. Type TSP-Link accessible Affected by Where saved Default value Attribute (R)

  • Page 457: Trigger.blender[N].Stimulus[M]

    Section 7: Command reference Models 707B and 708B Switching Matrix Reference Manual Also see trigger.blender[N].orenable (on page 7-202) trigger.blender[N].overrun (on page 7-203) trigger.blender[N].stimulus[M] (on page 7-204) trigger.blender[N].stimulus[M] This attribute specifies which events trigger the blender. Type TSP-Link accessible Affected by...
  • Page 458 Models 707B and 708B Switching Matrix Reference Manual Section 7: Command reference Use zero to disable the blender input. NOTE Use the eventID parameter rather than the numeric value to set the stimulus value. This will help make the code compatible for future upgrades.
  • Page 459 Section 7: Command reference Models 707B and 708B Switching Matrix Reference Manual Example digio.trigger[3].mode = digio.TRIG_FALLING Generate a trigger blender 1 event when a digital I/O digio.trigger[5].mode = digio.TRIG_FALLING trigger happens either on trigger.blender[1].orenable = true line 3 or 5.

  • Page 460: Trigger.timer[N].Clear()

    Models 707B and 708B Switching Matrix Reference Manual Section 7: Command reference Details You can set the stimulus of any trigger event detector to the value of this constant to have it respond to command interface trigger events. Also see None trigger.timer[N].clear()

  • Page 461: Trigger.timer[N].Delay

    Section 7: Command reference Models 707B and 708B Switching Matrix Reference Manual Example print(trigger.timer[1].count) Read retrigger count for timer number 1. Also see trigger.timer[N].clear() (on page 7-207) trigger.timer[N].reset() (on page 7-211) trigger.timer[N].delay This attribute sets and reads the timer delay.

  • Page 462: Trigger.timer[N].Delaylist

    Models 707B and 708B Switching Matrix Reference Manual Section 7: Command reference trigger.timer[N].delaylist This attribute sets an array of timer intervals that are used when triggered. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) System reset Create...

  • Page 463: Trigger.timer[N].Overrun

    Section 7: Command reference Models 707B and 708B Switching Matrix Reference Manual Details This constant is an identification number that identifies events generated by this timer. Set the stimulus of any trigger event detector to the value of this constant to have it respond to events from this timer.

  • Page 464: Trigger.timer[N].Passthrough

    Models 707B and 708B Switching Matrix Reference Manual Section 7: Command reference trigger.timer[N].passthrough This attribute enables or disables the timer trigger passthrough. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) System reset Create False configuration script Trigger timer N reset Usage passthrough = trigger.timer[N].passthrough...
  • Page 465 Section 7: Command reference Models 707B and 708B Switching Matrix Reference Manual Also see trigger.timer[N].count (on page 7-207) trigger.timer[N].delay (on page 7-208) trigger.timer[N].delaylist (on page 7-209) trigger.timer[N].overrun (on page 7-210) trigger.timer[N].passthrough (on page 7-211) trigger.timer[N].stimulus (on page 7-212) trigger.timer[N].stimulus This attribute specifies which event starts the timer.

  • Page 466: Trigger.timer[N].Wait()

    Models 707B and 708B Switching Matrix Reference Manual Section 7: Command reference Set this attribute to the eventID of any trigger event to wait for that event. Use zero to disable event processing. NOTE Use trigger event ID rather than the numeric value to set the stimulus value. This will help make the code compatible with future upgrades.

  • Page 467: Trigger.wait()

    Section 7: Command reference Models 707B and 708B Switching Matrix Reference Manual trigger.wait() This function waits for a command interface trigger event. Type TSP-Link accessible Affected by Where saved Default value Function Usage triggered = trigger.wait(timeout) triggered True: A trigger was detected during the timeout period...

  • Page 468: Tsplink.master

    Models 707B and 708B Switching Matrix Reference Manual Section 7: Command reference Details To remove the node from all groups, set the attribute value to 0. When the node is turned off, the group number for that node changes to 0.

  • Page 469: Tsplink.readbit()

    Section 7: Command reference Models 707B and 708B Switching Matrix Reference Manual Also see tsplink.reset() (on page 7-217) tsplink.state (on page 7-218) tsplink.readbit() This function reads the state of a TSP-Link synchronization line. Type TSP-Link accessible Affected by Where saved...

  • Page 470: Tsplink.reset()

    Models 707B and 708B Switching Matrix Reference Manual Section 7: Command reference Example data = tsplink.readport() Reads state of all three TSP lines. print(data) Assuming Line 2 is set high, the output is: 2.000000e+00 (binary 010) Also see tsplink.readbit() (on page 7-216) tsplink.writebit()

  • Page 471: Tsplink.state

    Section 7: Command reference Models 707B and 708B Switching Matrix Reference Manual tsplink.state This attribute describes the TSP-Link online state. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Not applicable Not applicable Not applicable Usage state = tsplink.state...

  • Page 472: Tsplink.trigger[N].Clear()

    Models 707B and 708B Switching Matrix Reference Manual Section 7: Command reference tsplink.trigger[N].pulsewidth (on page 7-222) tsplink.trigger[N].release() (on page 7-223) tsplink.trigger[N].stimulus (on page 7-224) tsplink.trigger[N].wait() (on page 7-225) tsplink.trigger[N].clear() This function clears the event detector for a trigger. Type TSP-Link accessible...

  • Page 473: Tsplink.trigger[N].Mode

    Section 7: Command reference Models 707B and 708B Switching Matrix Reference Manual Details This number is used by the TSP-Link trigger line when it detects an input trigger. Set the stimulus of any trigger event detector to the value of this constant to have it respond to trigger events from this line.

  • Page 474: Tsplink.trigger[N].Overrun

    Models 707B and 708B Switching Matrix Reference Manual Section 7: Command reference tsplink.TRIG_SYNCHRONOUSM Detects rising-edge triggers as an input. Asserts a TTL-low pulse for output. tsplink.TRIG_RISINGA Detects rising-edge triggers as input. Asserts a TTL-low pulse for output. Edge detection as an input is not available. Generates a tsplink.TRIG_RISINGM...

  • Page 475: Tsplink.trigger[N].Pulsewidth

    Section 7: Command reference Models 707B and 708B Switching Matrix Reference Manual Indicates the overrun state of the event detector built into the line itself. It does not indicate whether an overrun occurred in any other part of the trigger model or in any other detector that is monitoring the event.

  • Page 476: Tsplink.trigger[N].Release()

    Models 707B and 708B Switching Matrix Reference Manual Section 7: Command reference tsplink.trigger[N].release() This function releases a latched trigger on the given TSP-Link trigger line. Type TSP-Link accessible Affected by Where saved Default value Function Usage tsplink.trigger[N].release() The trigger line (1 to 3)
  • Page 477 Section 7: Command reference Models 707B and 708B Switching Matrix Reference Manual Also see tsplink.trigger[N].pulsewidth (on page 7-222) tsplink.trigger[N].mode (on page 7-220) tsplink.trigger[N].overrun (on page 7-221) tsplink.trigger[N].stimulus (on page 7-224) tsplink.trigger[N].stimulus This attribute specifies the event that causes the synchronization line to assert a trigger.

  • Page 478: Tsplink.trigger[N].Wait()

    Models 707B and 708B Switching Matrix Reference Manual Section 7: Command reference NOTE Use the constant for EVENT_ID rather than the numeric value to set the stimulus. This will help make the code compatible for future upgrades. Also see tsplink.trigger[N].assert() (on page 7-218) tsplink.trigger[N].reset()

  • Page 479: Tsplink.writebit()

    Section 7: Command reference Models 707B and 708B Switching Matrix Reference Manual tsplink.writebit() This function sets a TSP-Link synchronization line high or low. Type TSP-Link accessible Affected by Where saved Default value Function Usage tsplink.writebit(bit, data) The trigger line (1 to 3)

  • Page 480: Tsplink.writeprotect

    Models 707B and 708B Switching Matrix Reference Manual Section 7: Command reference Use the tsplink.writebit() and tsplink.writeport() commands to control the output state of the synchronization line when trigger operation is set to tsplink.TRIG_BYPASS. Example Sets the synchronization Lines 1 and 2 high (binary 011).

  • Page 481: Tspnet.clear()

    Section 7: Command reference Models 707B and 708B Switching Matrix Reference Manual tspnet.clear() This function clears any pending output data from the instrument. Type TSP-Link accessible Affected by Where saved Default value Function Usage tspnet.clear(connectionID) connectionID The connection ID returned from tspnet.connect() Details This function clears any pending output data from the device.

  • Page 482: Tspnet.connect()

    Instruments TSP-enbled device. Depending on the state of tspnet.tsp.abortonconnect, the Model 707B or 708B sends an abort command to the remote device on connection. The Model 707B or 708B also enables TSP prompts on the remote device and error management. The Model 707B or 708B places remote errors from the TSP-enabled device in its own error queue and prefaces these errors with Remote Error, followed by an error description.

  • Page 483: Tspnet.disconnect()

    Section 7: Command reference Models 707B and 708B Switching Matrix Reference Manual Also see localnode.prompts (on page 7-129) localnode.showerrors (on page 7-133) tspnet.tsp.abortonconnect (on page 7-237) tspnet.disconnect() (on page 7-230) tspnet.disconnect() This function disconnects the TSP-Net session specified. Type TSP-Link accessible...
  • Page 484 When this command is sent to a TSP-enabled device, the Model 707B or 708B blocks operation until the device responds or until a timeout error is generated. The TSP prompt from the remote device is read and thrown away.

  • Page 485: Tspnet.idn()

    Section 7: Command reference Models 707B and 708B Switching Matrix Reference Manual tspnet.idn() This function retrieves the response of the remote device to *IDN. Type TSP-Link accessible Affected by Where saved Default value Function Usage idnString = tspnet.idn(connectionID) The returned *IDN string...

  • Page 486: Tspnet.readavailable()

    If formatString is not provided, the command returns a string containing the data until a new line is reached. If no data is available, the Model 707B or 708B holds off operation until the requested data is available or until a timeout error is generated.

  • Page 487: Tspnet.reset()

    Section 7: Command reference Models 707B and 708B Switching Matrix Reference Manual Example Send commands that will create data. ID = tspnet.connect("192.0.2.1") tspnet.write(ID, "*idn?\r\n") Wait for data to be available. repeat bytes = tspnet.readavailable(ID) until bytes > 0 print(tspnet.read(ID)) tspnet.disconnect(ID) Also see tspnet.connect()

  • Page 488: Tspnet.termination()

    Models 707B and 708B Switching Matrix Reference Manual Section 7: Command reference tspnet.termination() This function sets the device line termination sequence. Type TSP-Link accessible Affected by Where saved Default value Function Usage type = tspnet.termination(connectionID) type = tspnet.termination(connectionID, termSequence) type An enumerated value indicating the termination type: •...

  • Page 489: Tspnet.timeout

    Section 7: Command reference Models 707B and 708B Switching Matrix Reference Manual tspnet.timeout This attribute sets the timeout value for the tspnet.connect(), tspnet.execute(), and tspnet.read() commands. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) System reset Create 20.0...

  • Page 490: Tspnet.tsp.abortonconnect

    Models 707B and 708B Switching Matrix Reference Manual Section 7: Command reference Example tspnet.tsp.abort(myConnection) Stops myConnection. Also see None tspnet.tsp.abortonconnect This attribute contains the setting for abort on connect. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW)

  • Page 491: Tspnet.tsp.rbtablecopy()

    Section 7: Command reference Models 707B and 708B Switching Matrix Reference Manual tspnet.tsp.rbtablecopy() This function copies a reading buffer synchronous table from a remote instrument. Type TSP-Link accessible Affected by Where saved Default value Function Usage array = tspnet.tsp.rbtablecopy(connectionID, name) array = tspnet.tsp.rbtablecopy(connectionID, name, startIndex, endIndex)

  • Page 492: Tspnet.tsp.runscript()

    Models 707B and 708B Switching Matrix Reference Manual Section 7: Command reference tspnet.tsp.runscript() This function loads and runs a script on a remote instrument. Type TSP-Link accessible Affected by Where saved Default value Function Usage tspnet.tsp.runscript(connectionID, script) tspnet.tsp.runscript(connectionID, name, script)

  • Page 493: Tspnet.write()

    The tspnet.write() function sends inputString to the remote instrument. It does not wait for command completion on the remote instrument. The Model 707B or 708B sends inputString to the remote instrument exactly as indicated. The inputString must contain any necessary new lines, termination, or other syntax elements needed to complete properly.

  • Page 494: Userstring.catalog()

    Models 707B and 708B Switching Matrix Reference Manual Section 7: Command reference Example userstring.add("assetnumber", "236") Stores user-defined strings in nonvolatile memory. userstring.add("product", "Widgets") userstring.add("contact", "John Doe") Also see userstring.catalog() (on page 7-241) userstring.delete() (on page 7-242) userstring.get() (on page 7-242) userstring.catalog()

  • Page 495: Userstring.delete()

    Section 7: Command reference Models 707B and 708B Switching Matrix Reference Manual userstring.delete() This function deletes a user-defined string from nonvolatile memory. Type TSP-Link accessible Affected by Where saved Default value Function Usage userstring.delete(name) name The name (key) of the key-value pair of the userstring to delete Details This function deletes the string that is associated with name from nonvolatile memory.

  • Page 496: Waitcomplete()

    708B have no overlapped commands implemented. However, other TSP-enabled products like the Series 2600A SourceMeter Instruments have overlapped commands. Therefore, when the Model 707B or 708B is a TSP master to a subordinate device with overlapped commands, use this function to wait until all overlapped operations are completed.

  • Page 498: Error Summary

    Section 8 Troubleshooting guide In this section: Troubleshooting guide..........8-1 Error and status messages ........8-1 USB troubleshooting ..........8-2 Troubleshooting GPIB interfaces ....... 8-5 Troubleshooting LAN interfaces ......... 8-5 Testing the display, keys, and channel matrix.... 8-9 Update drivers............8-10 Contacting support ...........

  • Page 499: Effects Of Errors On Scripts

    Section 8: Troubleshooting guide Models 707B and 708B Switching Matrix Reference Manual Effects of errors on scripts Most errors will not abort a running script. The only time a script is aborted is when a Lua runtime error (error number –286) is detected.
  • Page 500 Models 707B and 708B Switching Matrix Reference Manual Section 8: Troubleshooting guide Figure 93: Device Manager dialog box showing USB Test and Measurement Device 3. Right-click the device. 4. Select Properties. 5. Select the Driver tab. 6. Click Driver Details.
  • Page 501 Section 8: Troubleshooting guide Models 707B and 708B Switching Matrix Reference Manual Figure 94: Driver File Details dialog box 8. If the incorrect driver is installed, click OK. 9. On the Driver tab, click Update Driver. 10. Browse for the driver; select the C:\windows\inf folder and you should see the winusb.inf file.

  • Page 502: Troubleshooting Gpib Interfaces

    Models 707B and 708B Switching Matrix Reference Manual Section 8: Troubleshooting guide Troubleshooting GPIB interfaces If the hardware is not recognized by the computer: 1. Uninstall the software drivers. 2. Reboot the computer. 3. Check for newer drivers on the vendor’s website. Check that the drivers are valid for the operating system you have and any updates that might be necessary.

  • Page 503: Verify Connections And Settings

    Section 8: Troubleshooting guide Models 707B and 708B Switching Matrix Reference Manual Verify connections and settings If you are unable to connect to the instrument's internal web page, check the following items: • Verify that the crossover cable is in the correct LAN port on the instrument. Do not connect to one of the TSP-Link ports.

  • Page 504: Open Ports On Firewalls

    LXI consortium. For Keithley’s LXI instruments, the standard LXI pages use standard HTML. The added value pages that Keithley has added to control the instruments use Java. If Java is not installed when you select one of these instrument-specific web pages, the web page prompts you to install it.

  • Page 505: Lxi Lan Status Indicator

    Also check the LAN status indicator to verify that there are no faults. To reset the Model 707B or 708B, from the front panel, select MENU, then select LAN > RESET. Install LXI Discovery Browser software on your computer You can use the LXI Discovery Browser to identify the IP addresses of LXI certified instruments that are set up for automatic IP address selection.

  • Page 506: Communicate Using Visa Communicator

    Models 707B and 708B Switching Matrix Reference Manual Section 8: Troubleshooting guide Communicate using VISA communicator There are several interactive communication utilities that you can use to communicate with LAN instruments: • The KIOL installs the Keithley Communicator. • NI VISA (full version) installs the NI VISA Interactive Control utility, which can also be launched from NI-MAX.

  • Page 507: Verify Display Operation

    Section 8: Troubleshooting guide Models 707B and 708B Switching Matrix Reference Manual Verify display operation You can verify that all the pixels on the vacuum fluorescent display (VFD) are working. To verify VFD operation: 1. From the front panel, select MAIN MENU > DISPLAY > TEST > DISPLAY-PATTERNS. A pattern is displayed.

  • Page 508: Contacting Support

    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 once to place the instrument in local mode.
  • Page 509 Use print(slot[X].idn)to query and identify installed switching cards: print(slot[X].idn) Where: X = slot number (from 1 to 6 for Model 707B or 1 for Model 708B) Example To get a list of all switching cards installed in the slots of a Model 707B, send the following command over the remote command interface: for x=1,6 do print (slot[x].idn) end...

  • Page 510: Frequently Asked Questions

    Section 9 Frequently asked questions In this section: How do I get my LAN or web connection to work?..9-1 Why can't I close a channel?........9-1 How do I know if an error has occurred on my instrument? ..............9-2 How do I find the serial number and firmware version of the instrument? ............

  • Page 511: How Do I Know If An Error Has Occurred On My Instrument

    Section 9: Frequently asked questions Models 707B and 708B Switching Matrix Reference Manual Figure 95: Channel configuration dialog box 3. If the forbidden box is selected, the channel is forbidden to close. To allow the channel to close, clear the box.

  • Page 512: How Do I Find The Serial Number And Firmware Version Of The Instrument

    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 once to place the instrument in local mode.

  • Page 514: Next Steps

    In this section: Additional Models 707B and 708B information..10-1 Additional Models 707B and 708B information For additional information on the Model 707B or 708B, refer to: • The CD-ROM (ships with the product): Contains software tools, drivers, and product...

  • Page 516: Maintenance

    Appendix A Maintenance In this appendix: Upgrading firmware ........... A-1 Check fan status............A-2 Fuse replacement............A-2 Upgrading firmware You can upgrade the instrument firmware from the web interface. To upgrade the firmware: 1. From the left navigation area, select Unit. 2.

  • Page 517: Check Fan Status

    If the fan is not operating, contact Keithley Instruments. See Contacting support (on page 8-11). Fuse replacement The fuses on the Model 707B or 708B are located on the rear panel of the instrument, as shown below. Replacement fuses are listed in the following table. Replacement fuses...
  • Page 518 Models 707B and 708B Switching Matrix Reference Manual Appendix A: Maintenance To replace a fuse: 1. Use a small flat-tip screwdriver to lift the tab at the bottom of the fuse module. 2. Pull the fuse module out. 3. Replace the fuse.

  • Page 520: Using Models 707A And 708A Compatibility Mode

    Model A to Model B differences......... B-1 Models 707A and 708A commands......B-3 Model A to Model B differences You can use a Model 707B or 708B in an existing Model 707A or 708A application. The units are compatible with the following exceptions: •...

  • Page 521: Timing Issues

    Models 707B and 708B channel notation is different than on the Models 707A and 708A. For Models 707A and 708A, the slot number is built into the column number. For Models 707B and 708B, the slot number is the first number of the channel notation. For example, in Models 707A and 708A, crosspoint "A56"...

  • Page 522: Models 707A And 708A Commands

    20 and the text is displayed on the first line of the VFD display. Set digital output Only available on Model 708B. The actual digital output settings Db,s will not function for bits that are outside of the physical interface...
  • Page 523 Trigger source The trigger source 0/1 (GPIB Talk) is not available for the Models 707B and 708B. The factory default address for the Models 707B and 708B is 16. The trigger source 8/9 (front panel key) is not implemented. Instrument Config/Status For U0, the last pressed key always reads 05.

  • Page 524: Status Model

    TSP-Link system status........... C-19 Overview Each Keithley Instruments Models 707B and 708B Switching Matrix provides a number of status registers and queues that are collectively referred to as the "status model." Through manipulation and monitoring of these registers and queues, you can view and control various instrument events.

  • Page 525: Status Byte Register

    Appendix C: Status model Models 707B and 708B Switching Matrix Reference Manual Status Byte register The Status Byte register receives summary bits from the other status register sets and queues, and also from itself (which sets the Master Summary Status, or MSS, bit). The register sets are structured...

  • Page 526: Status Model Diagrams

    Models 707B and 708B Switching Matrix Reference Manual Appendix C: Status model Summary bit The summary bit of each register is either set (1) or clear (0). A set summary bit indicates that one (or more) of the enabled events in that register has occurred.

  • Page 527: Status Byte Register Overview

    Appendix C: Status model Models 707B and 708B Switching Matrix Reference Manual Status Byte register overview Status Byte register overview Figure 98: Status Byte register Error or Legend Event queue • Summary bit from the applicable register. • Queue not empty { •...

  • Page 528: System Summary Bit (System Register

    The summary bit of the measurement event register provides enabled summary information to Bit 0 (MSB) of the status byte. Since the Models 707B and 708B Switching Matrix has no internal measurement capabilities, none of the bits in the measurement registers are defined. Therefore, this bit is always 0.
  • Page 529 Appendix C: Status model Models 707B and 708B Switching Matrix Reference Manual As shown above, there are five register sets associated with System Event Status. These registers summarize system status for various nodes connected to the TSP-Link . Note that all nodes on the TSP-Link share a copy of the system summary registers once the TSP-Link has been initialized.

  • Page 530: Error Available Bit (Error Or Event Queue

    Models 707B and 708B Switching Matrix Reference Manual Appendix C: Status model Error available bit (Error or Event queue) The summary bit of the Error or Event queue provides enabled summary information to Bit 2 (EAV) of the status byte.
  • Page 531 Appendix C: Status model Models 707B and 708B Switching Matrix Reference Manual Questionable summary bit (Questionable event register) Figure 100: Questionable summary bit (Questionable event register) Legend Summary Message Bit: A single bit indicating one or more enabled status.questionable.event events occured.

  • Page 532: Event Summary Bit (Esb Register

    Models 707B and 708B Switching Matrix Reference Manual Appendix C: Status model As an example, when a print command is sent, the response message is placed in the Output queue. When data is placed in the Output queue, the Message Available (MAV) bit in the Status Byte Register sets.

  • Page 533: Master Summary Status Bit (Mss Bit Register

    Appendix C: Status model Models 707B and 708B Switching Matrix Reference Manual The bits used in this register set are described as follows: • Bit B0, Operation Complete (OPC): Set bit indicates that all pending selected device operations are completed and the instrument is ready to accept new commands. The bit is set in response to an *OPC command.

  • Page 534: Operation Summary Bit (Operation Event Register

    Models 707B and 708B Switching Matrix Reference Manual Appendix C: Status model Operation summary bit (Operation event register) The summary bit of the operation event register provides enabled summary information to Bit 7 (OSB) of the status byte. Operation summary bit (Operation event register)

  • Page 535: Status Function Summary

    Appendix C: Status model Models 707B and 708B Switching Matrix Reference Manual Figure 103: Operation user summary bit (Operation user register) Legend Summary Message Bit: A single bit indicating one or more enabled events occured. status.operation.user.event Performs a logical AND of input bits, with the result feeding the status.operation.user.enable...

  • Page 536: Clearing Registers And Queues

    Models 707B and 708B Switching Matrix Reference Manual Appendix C: Status model Clearing registers and queues Commands to reset the status registers and the Error queue are listed in the table below. In addition to these commands, any programmable register can be reset by sending the individual command to program the register with a 0 as its parameter value.

  • Page 537: Reading Registers

    Appendix C: Status model Models 707B and 708B Switching Matrix Reference Manual 16-bit status register Figure 104: 16-bit status register Bit Position Binary Value Decimal Weights A. Bits 0 through 7 Bit Position Binary Value Decimal 32768 16384 8192 4096 2048 1024 Weights B.

  • Page 538: Register Programming Example

    Models 707B and 708B Switching Matrix Reference Manual Appendix C: Status model Register programming example The command sequence below programs the instrument to generate an SRQ and set the system summary bit in all TSP-Link nodes when the thermal aspect bit of a card in slot 1 is set: -- Clear all registers.

  • Page 539: Status Byte Register

    Appendix C: Status model Models 707B and 708B Switching Matrix Reference Manual Status byte register The summary messages from the status registers and queues are used to set or clear the appropriate bits (B0, B1, B2, B3, B4, B5, and B7) of the Status Byte Register. These summary bits do not latch, and their states (0 or 1) are dependent upon the summary messages (0 or 1).

  • Page 540: Serial Polling And Srq

    Status Byte Register is either the Request for Service (RQS) bit or the Master Summary Status (MSS) bit: • When using the GPIB serial poll sequence of the Models 707B and 708B to obtain the status byte (serial poll byte), B6 is the RQS bit. See Serial polling and SRQ (on page C-17) for details on using the serial poll sequence.

  • Page 541: Spe, Spd (Serial Polling

    Appendix C: Status model Models 707B and 708B Switching Matrix Reference Manual SPE, SPD (serial polling) For the GPIB interface only, the SPE and SPD General Bus Commands are used to serial poll the Switching Matrix. Serial polling obtains the serial poll byte (status byte). Typically, serial polling is used by the controller to determine which of several instruments has requested service with the SRQ line.

  • Page 542: Controlling Node And Srq Enable Registers

    Models 707B and 708B Switching Matrix Reference Manual Appendix C: Status model Enable and transition registers In general, there are three types of user-writable registers that are used to configure which bits feed the register summary bit and when it occurs. The registers are identified in each applicable Instrument Control Library command table and defined as follows: •...
  • Page 543 Appendix C: Status model Models 707B and 708B Switching Matrix Reference Manual When the thermal 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 (status.questionable.condition) which causes Bit B9 to be...
  • Page 544 Models 707B and 708B Switching Matrix Reference Manual Appendix C: Status model TSP-Link status model configuration example Figure 106: TSP-Link status model configuration example TSP-Link system (status model) A questionable event at Node 15 will set the RQS bit of the Status Byte of the Master Node.

  • Page 546: Index

    Index field • 7-13 < index • 7-11, 7-12, 7-13, 7-14, 7-15, 7-16 <ch_list> queries • 2-89 toggle • 7-17 weighted value, bit • 7-12 acceptor trigger mode • 3-15, 3-19 bit functions • 7-9, 7-10, 7-11, 7-12, 7-13, 7-14, 7-15, annunciators •...
  • Page 547 Index Models 707B and 708B Switching Matrix Reference Manual channel.reset() • 7-43 close/open operations and commands • 2-95, 7- 19, 7-20 channel.setdelay() • 7-44 connect rule • 2-89 channel.setforbidden() • 7-45 designations • 2-87 channel.setlabel() • 7-46 existing scan • 3-6 channel.setlabelcolumn() •...
  • Page 548 Models 707B and 708B Switching Matrix Reference Manual Index Bit weighting • 2-9 crosspoint • 2-15 display (crosspoint) • 2-16, 2-17 Display cursor • 7-68, 7-81 DISPLAY key • 2-18 Model 707B front panel • 2-12 Model 708B front panel • 2-12...
  • Page 549 Index Models 707B and 708B Switching Matrix Reference Manual errorqueue functions and attribute format.byteorder • 7-93 errorqueue.clear() • 7-85 format.data • 7-94 errorqueue.count • 7-86 front panel errors display • 2-15, 2-18, 2-20 effects on scripts • 8-2 keys • 2-18, 2-19 summary •...
  • Page 550 Models 707B and 708B Switching Matrix Reference Manual Index lan.status.ipaddress • 7-110 index • 7-11, 7-12, 7-13, 7-14, 7-15, 7-16 lan.status.macaddress • 7-111 lan.status.port.dst • 7-111 keys lan.status.port.rawsocket • 7-112 DISPLAY • 2-18 lan.status.port.telnet • 7-112 key-value pairs • 5-17, 7-240, 7-241, 7-242 lan.status.port.vxi11 •...
  • Page 551 Index Models 707B and 708B Switching Matrix Reference Manual localnode.getglobal() • 7-128 matrix card notation • 2-88 localnode.gettimezone() • 7-96 Memory functions localnode.model • 7-128 memory.available() • 7-135 localnode.password • 7-129 memory.used() • 7-137 localnode.prompts • 7-129 modules localnode.prompts4882 • 7-130 identify installed •...
  • Page 552 Models 707B and 708B Switching Matrix Reference Manual Index Precedence • 6-23 lan.reset() • 7-107 print functions localnode.reset() • 7-131 print() • 7-138 reset() • 7-140 printbuffer() • 7-138 scan.reset() • 7-150 printnumber() • 7-140 status.reset() • 7-187 programming timer.reset() • 7-201 interaction •...
  • Page 553 Index Models 707B and 708B Switching Matrix Reference Manual scripts scan.scancount • 7-151 scan.state() • 7-152 autoexec • 6-8 scan.stepcount • 7-153 autorun scripts • 6-7 scan.trigger.arm.clear() • 7-153 deleting • 6-43 scan.trigger.arm.set() • 7-154 error effects • 8-2 scan.trigger.arm.stimulus • 7-154 examples •...
  • Page 554 Models 707B and 708B Switching Matrix Reference Manual Index Clearing registers and queues • C-13 sound • 7-9 SRQ (Service Request) • C-15 Programming registers and queues • C-13 standard Queues • C-3 libraries • 6-30 Status byte and SRQ • C-2, C-15 standard libraries •...
  • Page 555 Index Models 707B and 708B Switching Matrix Reference Manual components • 3-3 trigger.blender[N].overrun • 7-203 trigger.blender[N].reset() • 7-203 described • 3-1 trigger.blender[N].stimulus[M] • 7-204 trigger.blender[N].wait() • 7-205 advanced features • 6-45 trigger.clear() • 7-206 installing software • 6-35 trigger.EVENT_ID • 7-206 tsplink function and attributes trigger.timer[N].clear() •...
  • Page 556 Models 707B and 708B Switching Matrix Reference Manual Index communicating between TSP-enabled userstring functions • 6-50 instruments • 6-58 userstring.add() • 7-240 Initialization • 6-47 userstring.catalog() • 7-241 Node numbers • 6-48 userstring.delete() • 7-242 Reset • 6-48 userstring.get() • 7-242 tspnet functions and attributes UTC •...

  • Page 558: Limitation Of Warranty

    Warranty Limitation of Warranty This warranty does not apply to defects resulting from product modification without Keithley Instruments’ express written consent, or misuse of any product or part. This warranty also does not apply to fuses, software, non-rechargeable batteries, damage from battery leakage, or problems arising from normal wear or failure to follow instructions.
  • Page 559 M E A S U R E C O N F I D E N C E Keithley Instruments, Inc. Corporate Headquarters • 28775 Aurora Road • Cleveland, Ohio 44139 • 440-248-0400 • Fax: 440-248-6168 • 1-888-KEITHLEY • www.keithley.com 12/06...

This manual is also suitable for:

707b

Table of Contents