Keithley 2606B System SourceMeter Reference Manual
  1. Manuals
  2. Brands
  3. Keithley Manuals
  4. Power Supply
  5. 2606B System SourceMeter
  6. Reference manual

Keithley 2606B System SourceMeter Reference Manual

Hide thumbs
1
2
3
4
5
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
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
Table of Contents

Advertisement

Quick Links

Download this manual
tek.com/keithley
Model 2606B
System SourceMeter
Instrument
®
Reference Manual
2606B-901-01 Rev. B / May 2018
*P2606B-901-01B*
2606B-901-01B

Advertisement

Table of Contents
loading

Related Manuals for Keithley 2606B System SourceMeter

Summary of Contents for Keithley 2606B System SourceMeter

  • Page 1 Model 2606B System SourceMeter Instrument ® Reference Manual 2606B-901-01 Rev. B / May 2018 *P2606B-901-01B* 2606B-901-01B...
  • Page 2 Cleveland, Ohio, U.S.A. All rights reserved. Any unauthorized reproduction, photocopy, or use of the information herein, in whole or in part, without the prior written approval of Keithley Instruments, LLC, is strictly prohibited. These are the original instructions in English. ®...
  • Page 3 Keithley products are designed for use with electrical signals that are measurement, control, and data I/O connections, with low transient overvoltages, and must not be directly connected to mains voltage or to voltage sources with high transient overvoltages.
  • Page 4 (note that selected parts should be purchased only through Keithley to maintain accuracy and functionality of the product). If you are unsure about the applicability of a replacement component, call a Keithley office for information.

  • Page 5: Table Of Contents

    Output queue ..........................2-9 USB communications ........................ 2-9 LAN communications ......................2-13 2606B web interface ....................... 2-15 Supplied software ........................2-23 Keithley I/O layer ........................2-26 System information ......................2-28 Menu overview ........................2-28 Menu navigation ........................2-28 Menu trees ..........................2-29 Setting a value ........................
  • Page 6 Table of contents 2606B System SourceMeter® Instrument Reference Manual Source-measure capabilities ....................2-35 Limits ............................2-35 Fundamental circuit configurations ..................2-37 Operation considerations for the ADC ..................2-37 Basic source-measure procedure ................... 2-39 Triggering in local mode ......................2-43 Configuring for measure-only tests using the MODE key ............2-44 V-meter and I-meter measurements ..................
  • Page 7 2606B System SourceMeter® Instrument Reference Manual Table of contents Front-panel reading buffer control ..................... 3-6 Remote reading buffer programming ..................3-10 Sweep operation ........................ 3-19 Linear staircase sweeps ......................3-20 Logarithmic staircase sweeps ....................3-22 List sweeps ..........................3-25 Pulse mode sweeps ........................ 3-26 Configuring and running sweeps .....................
  • Page 8 Table of contents 2606B System SourceMeter® Instrument Reference Manual Effects of load on current source settling time ..............4-19 Creating pulses with the 2606B ..................4-19 Pulse rise and fall times ......................4-19 Pulse width ..........................4-20 Remote commands ..................... 5-1 Introduction to TSP operation ....................
  • Page 9 2606B System SourceMeter® Instrument Reference Manual Table of contents Fundamentals of programming for TSP ................6-13 What is Lua? ........................... 6-13 Lua basics ..........................6-13 Standard libraries ........................6-27 Programming example ......................6-30 Test Script Builder (TSB) ....................6-30 Installing the TSB software...................... 6-30 Installing the TSB add-in ......................
  • Page 10 Table of contents 2606B System SourceMeter® Instrument Reference Manual Command details ........................7-5 Example section ........................7-6 Related commands and information ..................7-6 TSP commands ........................7-7 beeper.beep() ..........................7-7 beeper.enable ........................... 7-8 bit.bitand() ..........................7-8 bit.bitor() ............................ 7-9 bit.bitxor() ..........................7-9 bit.clear() ..........................
  • Page 11 2606B System SourceMeter® Instrument Reference Manual Table of contents digio.trigger[N].wait() ....................... 7-59 digio.writebit() .......................... 7-59 digio.writeport() ........................7-60 digio.writeprotect ........................7-61 display.clear() .......................... 7-61 display.getannunciators() ......................7-62 display.getcursor() ........................7-63 display.getlastkey() ......................... 7-64 display.gettext() ........................7-65 display.inputvalue() ......................... 7-66 display.loadmenu.add() ......................7-68 display.loadmenu.catalog() .....................
  • Page 12 Table of contents 2606B System SourceMeter® Instrument Reference Manual io.close()..........................7-107 io.flush() ..........................7-107 io.input() ..........................7-108 io.open() ..........................7-109 io.output() ..........................7-109 io.read() ..........................7-110 io.type() ..........................7-111 io.write() ..........................7-111 lan.applysettings() ......................... 7-112 lan.autoconnect ........................7-112 lan.config.dns.address[N] ...................... 7-113 lan.config.dns.domain ......................
  • Page 13 2606B System SourceMeter® Instrument Reference Manual Table of contents localnode.revision ......................... 7-144 localnode.serialno ......................... 7-145 localnode.showerrors ......................7-145 makegetter() .......................... 7-146 makesetter() .......................... 7-147 meminfo() ..........................7-147 node[N].execute() ........................7-148 node[N].getglobal() ........................ 7-149 node[N].setglobal() ........................ 7-149 opc() ............................7-150 os.remove() ........................... 7-150 os.rename() ...........................
  • Page 14 Table of contents 2606B System SourceMeter® Instrument Reference Manual smuX.measure.autorangeY....................7-191 smuX.measure.autozero ....................... 7-192 smuX.measure.calibrateY() ....................7-194 smuX.measure.count ......................7-195 smuX.measure.delay ......................7-196 smuX.measure.delayfactor....................7-197 smuX.measure.filter.count ....................7-197 smuX.measure.filter.enable....................7-198 smuX.measure.filter.type ...................... 7-199 smuX.measure.highcrangedelayfactor .................. 7-200 smuX.measure.interval ......................7-200 smuX.measure.lowrangeY ....................7-201 smuX.measure.nplc ......................
  • Page 15 2606B System SourceMeter® Instrument Reference Manual Table of contents smuX.trigger.source.listY() ....................7-244 smuX.trigger.source.logY()....................7-245 smuX.trigger.source.set() ...................... 7-246 smuX.trigger.source.stimulus ....................7-247 smuX.trigger.SOURCE_COMPLETE_EVENT_ID ..............7-248 smuX.trigger.SWEEP_COMPLETE_EVENT_ID ..............7-249 smuX.trigger.SWEEPING_EVENT_ID .................. 7-249 status.condition ........................7-250 status.measurement.* ......................7-252 status.measurement.buffer_available.* ................. 7-254 status.measurement.current_limit.* ..................7-255 status.measurement.instrument.* ..................
  • Page 16 Table of contents 2606B System SourceMeter® Instrument Reference Manual trigger.blender[N].clear() ....................... 7-340 trigger.blender[N].EVENT_ID ....................7-340 trigger.blender[N].orenable....................7-341 trigger.blender[N].overrun ..................... 7-341 trigger.blender[N].reset() ....................... 7-342 trigger.blender[N].stimulus[M] ....................7-343 trigger.blender[N].wait() ......................7-344 trigger.clear() ......................... 7-345 trigger.EVENT_ID ......................... 7-346 trigger.generator[N].assert() ....................7-346 trigger.generator[N].EVENT_ID ..................... 7-347 trigger.timer[N].clear() ......................
  • Page 17 2606B System SourceMeter® Instrument Reference Manual Table of contents waitcomplete() ........................7-383 Troubleshooting guide ....................8-1 Introduction .......................... 8-1 Error levels ........................... 8-1 Effects of errors on scripts ....................8-1 Retrieving errors ........................8-2 Error summary list ........................ 8-2 LAN troubleshooting suggestions ..................8-6 Frequently asked questions ..................
  • Page 18 Table of contents 2606B System SourceMeter® Instrument Reference Manual Current source accuracy ......................B-6 Current measurement accuracy ....................B-7 Voltage source accuracy ......................B-9 Voltage measurement accuracy ....................B-10 Adjustment ......................... B-10 Environmental conditions ......................B-11 Adjustment considerations ...................... B-11 Calibration adjustment overview .....................
  • Page 19 2606B System SourceMeter® Instrument Reference Manual Table of contents Status function summary ......................E-3 Status model diagrams ......................E-4 Clearing registers ....................... E-11 Programming and reading registers ................... E-12 Programming enable and transition registers ................E-12 Reading registers ........................E-12 Status byte and service request (SRQ) ................

  • Page 21: Introduction

    If you have any questions after you review the information in this documentation, please contact your local Keithley Instruments office, sales partner, or distributor. You can also call the corporate headquarters of Keithley Instruments (toll-free inside the U.S. and Canada only) at 1-800-935-5595,...

  • Page 22: 2606B Documentation

    J2SE™ Runtime Environment: Web browser plug-in required to run the web applications that are available through the instrument web interface. • Keithley I/O layer and release notes: Software that manages communications between Keithley instrument drivers, software applications, and the instrument. 2606B-901-01 Rev. B / May 2018...

  • Page 23: Capabilities And Features

    2606B System SourceMeter® Instrument Reference Manual Section 1: Introduction For more information, see Installing the TSB software (on page 6-30) and Installing the TSB add-in (on page 6-31). To identify IP addresses of instruments connected to the local area network (LAN) that support...

  • Page 24: What You Should Have Received

    Cage nut (part of the Model 4299-13 Rack Mount Kit) 7709-308 25-pin D-shell connector kit 0713411 Safety Precautions CS-1195-8 Eight-pin custom cable connector (refer to Keithley document number PA-907 for instruction) CS-1196-8 Cable housing (refer to Keithley document number PA-907 for instruction) Instrument and module serial numbers Each 2606B has three serial numbers, one for the instrument and one for each module.

  • Page 25: General Operation

    Section 2 General operation In this section: General ratings ................. 2-1 Front panel ................2-2 Rear panel................2-3 Installing the 2606B ..............2-4 Starting up your instrument ............2-6 Remote communications interfaces ......... 2-8 System information ..............2-28 Menu overview ............... 2-28 Beeper ...................

  • Page 26: Front Panel

    Section 2: General operation 2606B System SourceMeter® Instrument Reference Manual Front panel The front panel of the 2606B is shown below. The descriptions of the front-panel controls, USB port, and indicators follow the figure. Figure 1: 2606B front panel The power switch turns the instrument on or off. The indicator is Power indicator illuminated when the instrument is on.

  • Page 27: Rear Panel

    2606B System SourceMeter® Instrument Reference Manual Section 2: General operation ® Connections for the TSP-Link system expansion TSP-Link ports interface, which test system builders can use to connect multiple instruments in a master and subordinate configuration. TSP-Link is a high-speed trigger synchronization and communication bus.

  • Page 28: Installing The 2606B

    Section 2: General operation 2606B System SourceMeter® Instrument Reference Manual Installing the 2606B The 2606B is intended for mounting in a rack only. For detailed instructions, refer to the documentation for the Model 4299-13 Rack Mount Kit (part number 0713574).

  • Page 29: Dimensions

    2606B System SourceMeter® Instrument Reference Manual Section 2: General operation Dimensions The following figures show the instrument dimensions. Figure 3: 2606B dimensions - top view Figure 4: Dimensions - front view 2606B-901-01 Rev. B / May 2018...

  • Page 30: Starting Up Your Instrument

    Section 2: General operation 2606B System SourceMeter® Instrument Reference Manual Figure 5: Dimensions - side view Starting up your instrument The following topics describe how to power your instrument on and off, place the instrument in standby, configure the line frequency, and replace the line fuse.

  • Page 31: Placing The 2606B In Standby

    2606B System SourceMeter® Instrument Reference Manual Section 2: General operation Hazardous voltages may be present on all output and guard terminals. To prevent electrical shock that could cause injury or death, remove power from the instrument or test system and discharge any energy storage components (for example, capacitors or cables) before changing any connections that might allow contact with an uninsulated conductor.

  • Page 32: Remote Communications Interfaces

    Section 2: General operation 2606B System SourceMeter® Instrument Reference Manual Line frequency configuration The factory configures the 2606B to automatically detect the power line frequency (either 50 Hz or 60 Hz) at each power-up. This detected line frequency is used for aperture (NPLC) calculations.

  • Page 33: Remote Interface Connections

    This requires that you 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 ®...
  • Page 34 2606B System SourceMeter® Instrument Reference Manual To use the Keithley Configuration Panel to determine the VISA resource string: 1. Start the Keithley Configuration Panel. The Select Operation dialog box is displayed. 2. Select Add. Figure 7: Select Operation dialog box 3.
  • Page 35 2606B System SourceMeter® Instrument Reference Manual Section 2: General operation Figure 9: Select Instrument Driver dialog box 6. Select Auto-detect Instrument Driver - Model. 7. Click Next. The Configure USB Instrument dialog box is displayed with the detected instrument VISA resource string displayed.
  • Page 36 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 11: Keithley Communicator Open an Instrument 14.

  • Page 37: Lan Communications

    2606B System SourceMeter® Instrument Reference Manual Section 2: General operation If you have a full version of NI VISA on your system, you can run NI-MAX or the VISA Interactive Utility. See their documentation for information. If you have the Agilent IO Libraries on your system, you can run Agilent Connection Expert to check out your USB instruments.
  • Page 38 Section 2: General operation 2606B System SourceMeter® Instrument Reference Manual LAN status LEDs The figure below illustrates the two status light emitting diodes (LED) that are on the LAN port of the instrument. The table below the figure provides explanations of the LED states.

  • Page 39: B Web Interface

    2606B System SourceMeter® Instrument Reference Manual Section 2: General operation 2606B web interface The 2606B 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 40 Section 2: General operation 2606B System SourceMeter® Instrument Reference Manual Web interface Welcome page The Welcome page of the module provides information about the module. It includes: • The model number, manufacturer, serial number, and firmware revision number of the module.
  • Page 41 2606B System SourceMeter® Instrument Reference Manual Section 2: General operation Change the IP configuration through the web interface You can change the LAN settings, such as IP address, subnet mask, gateway, and DNS address, through the web page of the instrument.
  • Page 42 3. In the New Password and Confirm New Password boxes, enter the new password. 4. Click Submit. Use TSB Embedded TSB Embedded is a tool with a reduced set of features compared to the Keithley Test Script Builder (TSB) software. TSB Embedded allows both script-building functionality and console functionality (single-line commands).
  • Page 43 2606B System SourceMeter® Instrument Reference Manual Section 2: General operation Virtual front panel options The virtual front panel of the 2606B is shown below. The descriptions of the controls and indicators follow the figure. Figure 17: Virtual front panel options 1.
  • Page 44 Section 2: General operation 2606B System SourceMeter® Instrument Reference Manual Performance control DIGITS Sets the display resolution (4½, 5½, or 6½ digits). SPEED Sets the measurement speed (FAST, MEDium, NORMAL, HI-ACCURACY, or OTHER). Speed and accuracy are set by controlling the measurement aperture. Also see Speed (on page 2-76).
  • Page 45 2606B System SourceMeter® Instrument Reference Manual Section 2: General operation 4. Cursor keys Use the CURSOR keys to move the cursor left or right. When the cursor is on the source or compliance value digit, press the navigation wheel to enter edit mode, and turn the navigation wheel to edit the value.
  • Page 46 Section 2: General operation 2606B System SourceMeter® Instrument Reference Manual Display indicators (not shown) The items listed below represent the possible display indicators and their meanings. Indicator Meaning Instrument is in editing mode EDIT Questionable reading or invalid calibration step...

  • Page 47: Supplied Software

    To clear the event log and update the information on the screen, select the Refresh button. Supplied software The majority of software applications and all instrument drivers from Keithley Instruments depend on some, or all, of the following software components: •...
  • Page 48 2606B System SourceMeter® Instrument Reference Manual Instrument driver types There are several different styles of instrument drivers. Keithley Instruments provides three different instrument drivers for the 2606B: 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 49 , you can also go to the National Instruments website and search their instrument driver database. 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. ®...

  • Page 50: 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 Test Script Builder (TSB). The KIOL contains: •...
  • Page 51 2606B System SourceMeter® Instrument Reference Manual Section 2: General operation Keithley Configuration Panel The Keithley Configuration Panel is a configuration utility for IVI drivers, similar to NI-MAX. It can also autodetect USBTMC instruments and LAN instruments that support the VXI-11 protocol. Keithley Communicator The Keithley Communicator is a dumb terminal program that uses VISA to communicate with the instrument.

  • Page 52: System Information

    Section 2: General operation 2606B System SourceMeter® Instrument Reference Manual System information You can retrieve serial number, firmware revision, and calibration dates from the instrument. To view the system information from the virtual front panel: 1. Press the MENU key.

  • Page 53: Menu Trees

    2606B System SourceMeter® Instrument Reference Manual Section 2: General operation Menu trees You can configure instrument operation through the menus that are accessed from the virtual front panel. Main menu The main menu structure is summarized in the following figure and table. For other menu items, see Configuration menus (on page 2-30).

  • Page 54: Upgrading The Firmware

    Section 2: General operation 2606B System SourceMeter® Instrument Reference Manual The following table contains descriptions of the main menu options and cross-references to related information. To access a menu option, press the MENU key, turn the navigation wheel to move the cursor to select an item, and press the navigation wheel .
  • Page 55 2606B System SourceMeter® Instrument Reference Manual Section 2: General operation Figure 20: 2606B CONFIG menu tree 2606B-901-01 Rev. B / May 2018 2-31...

  • Page 56: Setting A Value

    Section 2: General operation 2606B System SourceMeter® Instrument Reference Manual Press the EXIT key to return to a previous menu. The following table contains descriptions of the configuration menus with cross references to related information. To select a menu: 1. Select the CONFIG key.

  • Page 57: Beeper

    2606B System SourceMeter® Instrument Reference Manual Section 2: General operation Setting source and compliance values When the 2606B is in the edit mode (EDIT indicator is on), the editing controls are used to set source and compliance values. Note that when you edit the source value, source autoranging is turned off and remains off until you turn it on again.

  • Page 58: Display Mode

    Section 2: General operation 2606B System SourceMeter® Instrument Reference Manual To turn the beeper on or off from the virtual front panel: 1. Press the MENU key, and then select BEEPER. 2. Select one of the following:  ENABLE ...

  • Page 59: Basic Operation

    2606B System SourceMeter® Instrument Reference Manual Section 2: General operation Basic operation Hazardous voltages may be present on all output and guard terminals. To prevent electrical shock that could cause injury or death, never make or break connections to the 2606B while the instrument is powered on.
  • Page 60 Section 2: General operation 2606B System SourceMeter® Instrument Reference Manual Virtual front-panel limit To set the limit from the virtual front panel: 1. Select the LIMIT key for the channel. 2. Select CURRENT, VOLTAGE, or POWER as needed. 3. Select the ENTER key.

  • Page 61: Fundamental Circuit Configurations

    2606B System SourceMeter® Instrument Reference Manual Section 2: General operation Fundamental circuit configurations The fundamental source-measure configurations for the 2606B are shown in the following figure. When sourcing voltage, you can measure current or voltage (see A: Source V). When sourcing current, you can measure voltage or current (see B: Source I).
  • Page 62 Section 2: General operation 2606B System SourceMeter® Instrument Reference Manual To minimize the drift, a reference and zero measurement should be made immediately before the critical test sequence. The ONCE setting can be used to force a refresh of the reference and zero measurements used for the current aperture setting.

  • Page 63: Basic Source-Measure Procedure

    2606B System SourceMeter® Instrument Reference Manual Section 2: General operation NPLC caching NPLC caching speeds up operation by caching A/D reference and zero values for up to the ten most recent measurement aperture settings. Whenever the integration rate is changed using the SPEED key, or a user setup is recalled, the NPLC cache is checked.
  • Page 64 Section 2: General operation 2606B System SourceMeter® Instrument Reference Manual Step 3: Select the measurement function and range To select the measurement function and range: 1. Select the DISPLAY key to place it in single-channel-display mode. 2. Select the measurement function by pressing the MEAS key.
  • Page 65 2606B System SourceMeter® Instrument Reference Manual Section 2: General operation Basic source-measure commands Command* Description Enable current source autorange. smuX.source.autorangei = smuX.AUTORANGE_ON smuX.source.autorangev = smuX.AUTORANGE_ON Enable voltage source autorange. smuX.source.autorangei = smuX.AUTORANGE_OFF Disable current source autorange. smuX.source.autorangev = smuX.AUTORANGE_OFF Disable voltage source autorange.
  • Page 66 Section 2: General operation 2606B System SourceMeter® Instrument Reference Manual -- Restore 2606B defaults. smua.reset() -- Select voltage source function. smua.source.func = smua.OUTPUT_DCVOLTS -- Set source range to auto. smua.source.autorangev = smua.AUTORANGE_ON -- Set voltage source to 5 V. smua.source.levelv = 5 -- Set current limit to 10 mA.

  • Page 67: Triggering In Local Mode

    2606B System SourceMeter® Instrument Reference Manual Section 2: General operation Triggering in local mode It is not necessary to change any trigger settings to use the basic source and measurement procedures covered in this section. Press the MENU key, and then select SETUP > RECALL > INTERNAL > FACTORY to reset the factory default conditions.

  • Page 68: Configuring For Measure-Only Tests Using The Mode Key

    Section 2: General operation 2606B System SourceMeter® Instrument Reference Manual INTERVAL: Sets the time interval between measurements (0 s to 999.999 s) when the count is greater than 1. DELAY: Sets the delay period between the trigger and the start of measurement (0 s to 999.999 s).

  • Page 69: V-Meter And I-Meter Measurements

    2606B System SourceMeter® Instrument Reference Manual Section 2: General operation V-meter and I-meter measurements To make V-meter and I-meter measurements without using the MODE key (such as when configuring measure-only tests over the remote interface), follow the procedure below. To use the 2606B to measure voltage or current: 1.
  • Page 70 Section 2: General operation 2606B System SourceMeter® Instrument Reference Manual Basic ohms measurement procedure When you use the MODE key to select ohms measurement, the 2606B is automatically configured as a current source with a level of 1 mA. To change the source function, source value, or compliance value (in other words, customize the standard ohmmeter configuration of the MODE key), then use the following steps to make ohms measurements.
  • Page 71 2606B System SourceMeter® Instrument Reference Manual Section 2: General operation -- Restore 2606B defaults. smua.reset() -- Select current source function. smua.source.func = smua.OUTPUT_DCAMPS -- Set source range to 10 mA. smua.source.rangei = 10e-3 -- Set current source to 10 mA.

  • Page 72: Power Measurements

    Section 2: General operation 2606B System SourceMeter® Instrument Reference Manual The 4-wire sensing method, as shown in the following figure (4-wire resistance sensing), minimizes or eliminates the effects of lead resistance by measuring the voltage across the resistor under test with a second set of test leads.
  • Page 73 2606B System SourceMeter® Instrument Reference Manual Section 2: General operation Hazardous voltages may be present on the output and guard terminals. To prevent electrical shock that could cause injury or death, never make or break connections to the 2606B while the output is on.

  • Page 74: Contact Check Measurements

    Section 2: General operation 2606B System SourceMeter® Instrument Reference Manual -- Restore 2606B defaults. smua.reset() -- Select voltage source function. smua.source.func = smua.OUTPUT_DCVOLTS -- Enable source autoranging. smua.source.autorangev = smua.AUTORANGE_ON -- Set voltage source to 5 V. smua.source.levelv = 5 -- Set current limit to 50 mA.
  • Page 75 2606B System SourceMeter® Instrument Reference Manual Section 2: General operation Contact check commands The following table summarizes the basic contact check commands. For a more complete description of these commands, refer to the TSP command reference (on page 7-1). For connection information,...

  • Page 76: Saved Setups

    Section 2: General operation 2606B System SourceMeter® Instrument Reference Manual Saved setups You can restore the 2606B to one of six nonvolatile memory setup configurations (five user setups and one factory default), or to a setup stored on an external USB flash drive. As shipped from the factory, the 2606B powers up with the factory default settings, which cannot be overwritten.
  • Page 77 2606B System SourceMeter® Instrument Reference Manual Section 2: General operation Start-up configuration You can specify the 2606B start-up (power-on) configuration from the virtual front panel. Set the start-up configuration to a previously stored setup (recalled from internal nonvolatile memory) or reset to the factory default setup.

  • Page 78: Dut Test Connections

    Section 2: General operation 2606B System SourceMeter® Instrument Reference Manual Start-up (power-on) configuration You can specify the 2606B start-up (power-on) configuration. Use the setup.poweron attribute to select which setup to return to upon power-up. To set the setup.poweron configuration attribute: setup.poweron = n...
  • Page 79 2606B System SourceMeter® Instrument Reference Manual Section 2: General operation Hazardous voltages may be present on the output and guard terminals. To prevent electrical shock that could cause injury or death, never make or break connections to the 2606B while the output is on.
  • Page 80 Section 2: General operation 2606B System SourceMeter® Instrument Reference Manual Input/output LO and chassis ground The SMU input/output LOs are available at the rear-panel terminal blocks. Input/output LOs are not connected between channels and are electrically isolated from chassis ground.

  • Page 81: Wire Local Sensing Connections

    2606B System SourceMeter® Instrument Reference Manual Section 2: General operation 2-wire local sensing connections You can use 2-wire local sensing measurements, shown in the following figure, for the following source-measure conditions: • Sourcing and measuring current. • Sourcing and measuring voltage in high impedance (more than 1 kΩ) test circuits.

  • Page 82: Contact Check Connections

    Section 2: General operation 2606B System SourceMeter® Instrument Reference Manual Use 4-wire remote sensing for the following source-measure conditions: • Sourcing or measuring voltage in low impedance (<1 kΩ) test circuits. • Enforcing voltage compliance limit directly at the DUT.

  • Page 83: Guarding And Shielding

    2606B System SourceMeter® Instrument Reference Manual Section 2: General operation The following figures illustrate using three channels to test the same 3-terminal N-channel JFET device. The third channel is connected to the source (S) terminal of the JFET. This allows the source terminal to be biased above signal LO.
  • Page 84 Section 2: General operation 2606B System SourceMeter® Instrument Reference Manual Safety shielding and hazardous voltages The maximum output voltage for a 2606B channel is 20 V, which is considered a nonhazardous level. However, using multiple voltage sources in a series configuration or...
  • Page 85 2606B System SourceMeter® Instrument Reference Manual Section 2: General operation Connections to LO on the 2606B are not necessarily at 0 V. Hazardous voltages could exist between LO and chassis ground. Make sure that high-voltage precautions are taken throughout the test system. Alternatively, limit hazardous levels by adding external protection to limit the voltage between LO and chassis.

  • Page 86: Test Fixtures

    Section 2: General operation 2606B System SourceMeter® Instrument Reference Manual Figure 34: Connections for noise shield, safety shield, and guarding Test fixtures A test fixture can be used to house a device or test circuit. The test fixture can be a metal or nonconductive enclosure, and is typically equipped with a lid.

  • Page 87: Floating A Smu

    2606B System SourceMeter® Instrument Reference Manual Section 2: General operation Construction material: A metal test fixture must be connected to a known protective earth (safety ground) as described in the above WARNING. A nonconductive test fixture must be constructed of materials that are suitable for flammability, voltage, and temperature conditions that may exist in the test circuit.

  • Page 88: Dut Connection Settings

    Section 2: General operation 2606B System SourceMeter® Instrument Reference Manual The 2606B connections for the floating configuration are shown below. Figure 36: Connections for floating a SMU The maximum floating (common mode) voltage for a source-measure unit (SMU) is ±250 V.

  • Page 89: Output-Off States

    2606B System SourceMeter® Instrument Reference Manual Section 2: General operation Front panel sense mode selection To check or change the sense mode from the virtual front panel: 1. Press the CONFIG key. 2. Press the SRC or MEAS key. You can access and set the 2606B sense mode from either the V- SOURCE or the V-MEAS menu items.
  • Page 90 Section 2: General operation 2606B System SourceMeter® Instrument Reference Manual Normal output-off mode The normal output-off mode is the default output-off mode setting. When the source-measure unit (SMU) is in the normal output-off mode, you can select either the current or the voltage output-off...
  • Page 91 2606B System SourceMeter® Instrument Reference Manual Section 2: General operation To select the normal output-off mode over a remote interface: Channel A: smua.source.offmode = smua.OUTPUT_NORMAL Channel B: smub.source.offmode = smub.OUTPUT_NORMAL To select the high-impedance output-off mode over a remote interface: Channel A: smua.source.offmode = smua.OUTPUT_HIGH_Z...
  • Page 92 Section 2: General operation 2606B System SourceMeter® Instrument Reference Manual To configure the output-off function remotely: To set 0 V output with current limit set by the smuX.source.offlimiti attribute: Channel A: smua.source.offfunc = smua.OUTPUT_DCVOLTS Channel B: smub.source.offfunc = smub.OUTPUT_DCVOLTS To set 0 A output with voltage limit set by the smuX.source.offlimitv attribute: Channel A: smua.source.offfunc = smua.OUTPUT_DCAMPS...

  • Page 93: Usb Storage Overview

    2606B System SourceMeter® Instrument Reference Manual Section 2: General operation Remote programming output-off states quick reference The content of the following table is a quick reference of commands for programming output-off states from a remote interface. Output-off state programming quick reference...

  • Page 94: Connecting The Usb Flash Drive

    Section 2: General operation 2606B System SourceMeter® Instrument Reference Manual Connecting the USB flash drive The 2606B supports flash drives that comply with USB 2.0 standards, 1.0, and 1.1 standards. You can save data to the USB flash drive from the virtual front panel, or you can create a script to save data to the USB flash drive.

  • Page 95: Displayed Error And Status Messages

    2606B System SourceMeter® Instrument Reference Manual Section 2: General operation Displayed error and status messages During operation and programming, virtual front-panel messages may be briefly displayed. Typical messages are either status or error notifications (refer to the Error summary list (on page 8-2) for a complete list of these messages and their meanings).

  • Page 96: Ranging Limitations

    Section 2: General operation 2606B System SourceMeter® Instrument Reference Manual Ranging limitations If the source and measure functions are different (such as source V and measure I, or source I and measure V), you can set source and measure ranges separately. If both source and measure functions are the same, the measure range is locked to the source range.

  • Page 97: Range Considerations

    2606B System SourceMeter® Instrument Reference Manual Section 2: General operation To individually set low range limits for Source V, Source I, Measure V, and Measure I from the virtual front panel: 1. Press the CONFIG key, then press either the SRC key (for source) or the MEAS key (for measure).

  • Page 98: Range Commands

    Section 2: General operation 2606B System SourceMeter® Instrument Reference Manual Range commands The following tables summarize commands necessary to control measure and source ranges. See TSP command reference (on page 7-1) for more details about these commands. Measure range commands...

  • Page 99: Digits

    2606B System SourceMeter® Instrument Reference Manual Section 2: General operation Range programming example The programming example below illustrates how to control both source and measure ranges. The 2606B is set up as follows: • Voltage source range: Auto • Current measure range: 10 mA •...

  • Page 100: Speed

    Section 2: General operation 2606B System SourceMeter® Instrument Reference Manual Speed The SPEED key on the virtual front panel sets the integration time, or measurement aperture, of the A/D converter (period the input signal is measured). The integration time affects the usable digits, the amount of reading noise, and the reading rate of the instrument.

  • Page 101: Functions And Features

    Section 3 Functions and features In this section: Relative offset ................3-1 Filters ..................3-3 Reading buffers ................ 3-5 Sweep operation ..............3-19 Triggering ................3-30 High-capacitance mode ............3-61 Display operations ..............3-66 Digital I/O ................3-78 Relative offset When making measurements, you may want to subtract an offset value from a measurement.

  • Page 102: Remote Relative Offset Programming

    Section 3: Functions and features 2606B System SourceMeter® Instrument Reference Manual Defining a relative offset value A unique relative offset value can be established for the selected measurement function. To establish a unique relative offset value from the virtual front panel: 1.

  • Page 103: Filters

    2606B System SourceMeter® Instrument Reference Manual Section 3: Functions and features Filters The filter feature lets you set the filter response to stabilize noisy measurements. The 2606B uses a digital filter, which is based on reading conversions. The displayed, stored, or transmitted reading is calculated using one or more reading conversions (from 1 to 100).

  • Page 104: Response Time

    Section 3: Functions and features 2606B System SourceMeter® Instrument Reference Manual Figure 39: Median filter When a moving average filter or a median filter is first enabled, the stack is empty. The first reading conversion is placed in the stack and is then copied to the other stack locations in order to fill it. Thus, the first filtered reading is the same as the first reading conversion.

  • Page 105: Remote Filter Programming

    = smua.FILTER_ON Reading buffers Reading buffers capture measurements, ranges, instrument status, and output state of the Keithley Instruments 2606B. The 2606B has two default reading buffers for each channel. In addition to the default buffers, you can create user-defined reading buffers. You can use the reading buffers to acquire readings.

  • Page 106: Front-Panel Reading Buffer Control

    Section 3: Functions and features 2606B System SourceMeter® Instrument Reference Manual Front-panel reading buffer control The dedicated reading buffers can be configured, stored, and recalled when in local mode operation. Use the virtual front panel to navigate and configure the reading buffers options and to save and recall stored readings.
  • Page 107 2606B System SourceMeter® Instrument Reference Manual Section 3: Functions and features Configuring reading buffers To configure reading buffers from the virtual front panel: Enabling or disabling the source value or the timestamp is optional. 1. Press the CONFIG key. 2. Press the STORE key and then choose one of the following: ...
  • Page 108 Section 3: Functions and features 2606B System SourceMeter® Instrument Reference Manual Storage operation Use this option to initiate a storage operation and to configure the number of readings to acquire during the storage operation. The reading count can range from 1 to 60,000 with timestamps and source values enabled;...
  • Page 109 2606B System SourceMeter® Instrument Reference Manual Section 3: Functions and features Saving the reading buffer to a USB flash drive After the measurements are complete, you can save the reading buffer data to a USB flash drive. To save the reading buffer data to a USB flash drive: 1.

  • Page 110: Remote Reading Buffer Programming

    Section 3: Functions and features 2606B System SourceMeter® Instrument Reference Manual Remote reading buffer programming You can get readings by making overlapped or sequential measurements. Overlapped commands do not finish executing before the next command starts. Sequential commands complete execution before the next command starts executing.
  • Page 111 2606B System SourceMeter® Instrument Reference Manual Section 3: Functions and features Commands to store readings smuX.measure.count = count The number of measurements to acquire. smuX.measure.overlappedi(rbuffer) Takes current measurements; stores readings in rbuffer. smuX.measure.overlappediv(ibuffer, Takes both current and voltage measurements; stores...
  • Page 112 Section 3: Functions and features 2606B System SourceMeter® Instrument Reference Manual Buffer storage control attributes The following table contains buffer storage control attributes. Before changing the collectsourcevalues, collecttimestamps, or timestampresolution attributes, you must clear the buffer using the smuX.nvbuffer1.clear() or smuX.nvbuffer2.clear() command.
  • Page 113 2606B System SourceMeter® Instrument Reference Manual Section 3: Functions and features Buffer storage control programming examples The programming examples below illustrate the use of buffer storage control attributes. Buffer control programming examples: Command Description smua.nvbuffer1.collectsourcevalues = 1 Enable source value storage.
  • Page 114 Section 3: Functions and features 2606B System SourceMeter® Instrument Reference Manual The min and max entries each have the attributes described in the following table. Min and max entry attributes Attribute Description measurefunction String indicating the function measured for the reading (current, voltage, ohms or watts).
  • Page 115 2606B System SourceMeter® Instrument Reference Manual Section 3: Functions and features Reading buffer attributes Use the reading buffer attributes to access the reading buffer data. The table below displays the attributes that you can use to access the reading buffer data.
  • Page 116 Section 3: Functions and features 2606B System SourceMeter® Instrument Reference Manual Buffer status The buffer reading status attribute includes the status information as a numeric value; see the following table for values. For example, to access status information for the second element of SMU channel A buffer 1, use the following command: stat_info = smua.nvbuffer1.statuses[2]...
  • Page 117 2606B System SourceMeter® Instrument Reference Manual Section 3: Functions and features Buffer examples Dedicated reading buffer example The following programming example illustrates how to store data using dedicated reading buffer 1 for channel A. In the example, the 2606B loops for voltages from 0.01 V to 1 V with 0.01 V steps (essentially performing a staircase sweep), stores 100 current readings and source values in buffer 1, and then recalls all 100 readings and source values.
  • Page 118 Section 3: Functions and features 2606B System SourceMeter® Instrument Reference Manual Dual buffer example The programming example below shows a script for storing both current and voltage readings using buffer 1 for current and buffer 2 for voltage readings. The 2606B stores 100 current and voltage readings and then recalls all 100 sets of readings.

  • Page 119: Sweep Operation

    2606B System SourceMeter® Instrument Reference Manual Section 3: Functions and features Dynamically allocated buffer example The programming example below illustrates how to store data to an allocated buffer called mybuffer. The 2606B stores 100 current readings in mybuffer and then recalls all the readings.

  • Page 120: Linear Staircase Sweeps

    Section 3: Functions and features 2606B System SourceMeter® Instrument Reference Manual Figure 40: DC and pulsed linear staircase sweeps DC and pulsed logarithmic staircase sweeps: In this type of sweep, the current or voltage increases or decreases geometrically, beginning with a start voltage or current and ending with a stop voltage or current.
  • Page 121 2606B System SourceMeter® Instrument Reference Manual Section 3: Functions and features Figure 43: Linear staircase sweep A linear staircase sweep is configured using a start level, a stop level, and the total number of points, including the start and stop points. The step size is determined by the start and stop levels, and the...

  • Page 122: Logarithmic Staircase Sweeps

    Section 3: Functions and features 2606B System SourceMeter® Instrument Reference Manual Logarithmic staircase sweeps This type of sweep is similar to the linear staircase sweep. The steps, however, are done on a logarithmic scale. Like a linear staircase sweep, logarithmic sweeps are configured using a start level, a stop level, and the number of points.
  • Page 123 2606B System SourceMeter® Instrument Reference Manual Section 3: Functions and features Figure 45: Decreasing logarithmic sweep Solving for k and b provides the following formulas: Where: = The source value at the end point = The source value at the start point...
  • Page 124 Section 3: Functions and features 2606B System SourceMeter® Instrument Reference Manual The following figure is an example of a five-point logarithmic sweep from 1 V to 10 V. Figure 46: Logarithmic staircase sweep (1V to 10V, five steps) In this example:...

  • Page 125: List Sweeps

    2606B System SourceMeter® Instrument Reference Manual Section 3: Functions and features Example: -- Configure a sweep from 1 to 10 V in 10 steps with an asymptote of 0 V. smua.trigger.source.logv(1, 10, 11, 0) -- Enable the source action. smua.trigger.source.action = smua.ENABLE For more information, see smuX.trigger.source.logY()

  • Page 126: Pulse Mode Sweeps

    Section 3: Functions and features 2606B System SourceMeter® Instrument Reference Manual Pulse mode sweeps A pulse mode sweep can be created for any of the sweep types by configuring the end pulse action. To configure a pulse mode sweep for source-measure unit (SMU) A, send: smua.trigger.endpulse.action = smua.SOURCE_IDLE...

  • Page 127: Configuring And Running Sweeps

    2606B System SourceMeter® Instrument Reference Manual Section 3: Functions and features Configuring and running sweeps Use the following topics to configure and run a sweep. Configuring compliance limits remotely Voltage and current limits can be configured using the smuX.trigger.source.limitY attribute, which sets the sweep source limits.

  • Page 128: Sweeping Using Factory Scripts

    Section 3: Functions and features 2606B System SourceMeter® Instrument Reference Manual Examples: To start a sweep, use the smuX.trigger.initiate() function. Sweeps are overlapped operations, so you can use the waitcomplete() function as a way to suspend further operation until the sweep is complete.

  • Page 129: Sweep Programming Examples

    2606B System SourceMeter® Instrument Reference Manual Section 3: Functions and features Sweep programming examples Procedures for programming and running a sweep for three sweep types are given on the following pages. Each of these procedures includes commands for a typical sweep example. The following table summarizes parameters for each of these examples.

  • Page 130: Triggering

    Section 3: Functions and features 2606B System SourceMeter® Instrument Reference Manual Pulse current sweep example The programming example below illustrates a pulse sweep. -- Restore 2606B defaults. 1. Configure source functions. smua.reset() Restores defaults and set the compliance to 10 V.
  • Page 131 2606B System SourceMeter® Instrument Reference Manual Section 3: Functions and features You can obtain very precise timing and synchronization between channels of multiple instruments using the trigger model to control the actions of the source-measure unit (SMU). To achieve such precise timing, use a static trigger configuration.
  • Page 132 Section 3: Functions and features 2606B System SourceMeter® Instrument Reference Manual Trigger events are identified by means of an event ID. The following table describes the trigger event IDs. Trigger event IDs* Event ID** Event description smuX.trigger.SWEEPING_EVENT_ID Occurs when the source-measure unit (SMU)

  • Page 133: Using The Remote Trigger Model

    2606B System SourceMeter® Instrument Reference Manual Section 3: Functions and features Using the remote trigger model The source-measure unit (SMU) in the 2606B has a remote trigger model that supports a wide range of triggering features for source sweeps, triggered measurements, and pulse actions.
  • Page 134 Section 3: Functions and features 2606B System SourceMeter® Instrument Reference Manual Figure 51: Remote trigger model: Asynchronous mode When the smuX.trigger.measure.action attribute is set to smuX.DISABLE or smuX.ENABLE, the trigger model will operate in synchronous measurement mode. When it is set to smuX.ASYNC, it will operate in asynchronous mode.
  • Page 135 2606B System SourceMeter® Instrument Reference Manual Section 3: Functions and features Each section of the trigger model performs a function: Idle state: If a sweep is not in process, the SMU is in the idle state. Use the smuX.trigger.initiate() function to move the SMU from the idle state to the arm layer.

  • Page 136: Smu Event Detectors

    Section 3: Functions and features 2606B System SourceMeter® Instrument Reference Manual The arm and trigger counts must be set to control how many times the SMU executes the source and measure actions. The arm count indicates the number of times to execute the complete sweep. The trigger count sets the number of loops in the trigger layer.
  • Page 137 2606B System SourceMeter® Instrument Reference Manual Section 3: Functions and features Clearing SMU event detectors When an event detector is cleared, the event detector discards previously detected trigger events. This prevents the source-measure unit (SMU) from using trigger events that were detected during the last sweep or while it is in the arm layer, and allows it to start monitoring for new trigger events.

  • Page 138: Using Trigger Events To Start Actions On Trigger Objects

    Section 3: Functions and features 2606B System SourceMeter® Instrument Reference Manual Figure 52: Front panel TRIG key triggering Using trigger events to start actions on trigger objects Trigger objects can be configured to respond to events generated by other trigger objects, such as using a digital I/O trigger to initiate a sweep.

  • Page 139: Digital I/O Port And Tsp-Link Synchronization Lines

    2606B System SourceMeter® Instrument Reference Manual Section 3: Functions and features Digital I/O port and TSP-Link synchronization lines Each module of the 2606B has two sets of hardware lines that can be used for triggering: 14 digital ® I/O lines and three TSP-Link synchronization lines.
  • Page 140 Section 3: Functions and features 2606B System SourceMeter® Instrument Reference Manual Trigger configuration on hardware lines The 2606B can be configured to send digital signals to trigger external instruments. Linking these output triggers to the completion of certain source-measure actions enables hardware handshaking.

  • Page 141: Timers

    2606B System SourceMeter® Instrument Reference Manual Section 3: Functions and features Timers A timer is a trigger object that performs a delay when triggered. Timers can be used to create delays and to start measurements and step the source value at timed intervals. When a delay expires, the timer generates a trigger event.
  • Page 142 Section 3: Functions and features 2606B System SourceMeter® Instrument Reference Manual Triggering a timer A timer can be configured to start a delay when a trigger object generates a trigger event. Timers cannot be started with a command. A trigger event from a trigger object must be used to initiate a delay.
  • Page 143 2606B System SourceMeter® Instrument Reference Manual Section 3: Functions and features Single pulse example: The programming example below illustrates how to use a single timer to control the pulse width of a single-shot pulse measurement. The programming example configures the timer and SMU as follows: Timer 1: Pulse width timer •...
  • Page 144 Section 3: Functions and features 2606B System SourceMeter® Instrument Reference Manual Single pulse example code -- Generate a single 500 us, 5 V pulse. -- Configure a single-point voltage list sweep. smua.trigger.source.listv({5}) smua.trigger.source.action = smua.ENABLE smua.trigger.measure.action = smua.DISABLE -- Configure other source parameters for best timing possible.
  • Page 145 2606B System SourceMeter® Instrument Reference Manual Section 3: Functions and features Timer 2: Pulse width timer • Set the delay attribute to an appropriate pulse width (see the following figure). • Set the stimulus input to Timer 1's event ID (the start of each pulse is the start of the pulse period).

  • Page 146: Event Blenders

    Section 3: Functions and features 2606B System SourceMeter® Instrument Reference Manual Pulse train example code -- Generate a 10-point pulse train where each pulse has a width of 600 -- microseconds and a pulse period of 5 milliseconds. -- Alias the trigger timers to use for pulse width and period.
  • Page 147 2606B System SourceMeter® Instrument Reference Manual Section 3: Functions and features Event blender modes Event blenders can be used to perform logical AND and logical OR functions on trigger events. For example, trigger events can be triggered when either a manual trigger or external input trigger is detected.

  • Page 148: Lan Triggering Overview

    Section 3: Functions and features 2606B System SourceMeter® Instrument Reference Manual LAN triggering overview Triggers can be sent and received over the LAN interface. The 2606B supports LAN extensions for instrumentation (LXI) and has eight LAN triggers that generate and respond to LXI trigger packets.

  • Page 149: Command Interface Triggering

    2606B System SourceMeter® Instrument Reference Manual Section 3: Functions and features Understanding LXI trigger event designations LAN trigger objects generate LXI trigger events, which are LAN0 to LAN7 (zero based). In the command table, the LXI trigger events can be accessed using lan.trigger[1] through lan.trigger[8].

  • Page 150: Trigger Generator

    Section 3: Functions and features 2606B System SourceMeter® Instrument Reference Manual Trigger generator The 2606B has two trigger generators available from each module that you can use to generate trigger events. Use the trigger.generator[N].assert()function to directly trigger events from the command interface or a script (for example, you can trigger a sweep while the instrument is under script control).
  • Page 151 2606B System SourceMeter® Instrument Reference Manual Section 3: Functions and features Using the assert function to generate output triggers Certain trigger objects can be used to generate output triggers on demand. These trigger objects are the digital I/O lines, TSP-Link synchronization lines and the LAN.
  • Page 152 Section 3: Functions and features 2606B System SourceMeter® Instrument Reference Manual The programming example below illustrates how to have the SMU immediately perform an action the first time through the trigger model, even if a programmed trigger event does not occur.
  • Page 153 2606B System SourceMeter® Instrument Reference Manual Section 3: Functions and features Manual triggering example The programming example below illustrates how to pause a script and prompt the operator to press the TRIG key when they are ready to continue. If the TRIG key is not pressed, the test will continue after waiting 10 minutes (600 seconds).

  • Page 154: Hardware Trigger Modes

    Different hardware trigger modes can be used for digital I/O and TSP-Link synchronization. Use hardware triggers to integrate Keithley instruments and non-Keithley instruments in a test system. The 2606B supports 14 digital I/O lines and three TSP-Link synchronization lines that can be used for input or output triggering.
  • Page 155 Use the rising edge master (RisingM) trigger mode (see the figure titled "RisingM output trigger") 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 156 Section 3: Functions and features 2606B System SourceMeter® Instrument Reference Manual Output characteristics: • In addition to trigger events from other trigger objects, the digio.trigger[N].assert() and tsplink.trigger[N].assert() commands generate a low pulse that is similar to the falling edge trigger mode.

  • Page 157: Understanding Synchronous Triggering Modes

    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 158 Section 3: Functions and features 2606B System SourceMeter® Instrument Reference Manual Input characteristics: • All rising edges are input triggers. • When all external drives release the physical line, the rising edge is detected as an input trigger. • A rising edge is not detected until all external drives release the line and the line floats high.
  • Page 159 2606B System SourceMeter® Instrument Reference Manual Section 3: Functions and features Synchronous acceptor trigger mode (SynchronousA) Use the synchronous acceptor trigger mode (SynchronousA) with the SynchronousM trigger mode. The roles of the internal and external drives are reversed in the SynchronousA trigger mode.
  • Page 160 2606B System SourceMeter® Instrument Reference Manual Synchronous trigger mode The synchronous trigger mode is a combination of SynchronousA and SynchronousM trigger modes. Use the Synchronous trigger mode for compatibility with older Keithley Instruments products. Keithley Instruments recommends using SynchronousA and SynchronousM modes only. Input characteristics: •...

  • Page 161: High-Capacitance Mode

    2606B System SourceMeter® Instrument Reference Manual Section 3: Functions and features High-capacitance mode ® The Keithley Instruments 2606B System SourceMeter instrument has a high-capacitance mode. Because the source-measure unit (SMU) can measure low current, issues can arise when driving a capacitive load.
  • Page 162 Section 3: Functions and features 2606B System SourceMeter® Instrument Reference Manual Source settling times Each 2606B source-measure unit (SMU) can drive up to 50 µF of a capacitance in high-capacitance mode. To accomplish this, the speed of the 2606B SMU is reduced. Source settling times increase when high-capacitance mode is enabled.

  • Page 163: Enabling High-Capacitance Mode

    2606B System SourceMeter® Instrument Reference Manual Section 3: Functions and features Understanding the capacitor Based on the capacitor dielectric absorption, the settling time may change and the values in the "Current measure and source settling times" table in Understanding source settling times (on page 3- 62) may differ.
  • Page 164 Section 3: Functions and features 2606B System SourceMeter® Instrument Reference Manual Command interface Turning on high-capacitance mode has the following effects on the SMU* settings: • smuX.measure.autorangei is set to smuX.AUTORANGE_FOLLOW_LIMIT and cannot be changed. • Current ranges below 1 µA are not accessible.
  • Page 165 2606B System SourceMeter® Instrument Reference Manual Section 3: Functions and features 2. To run the i_leakage_measure() function in the KIHighC factory script, send: -- Charges the capacitor. smua.source.levelv = 5 smua.source.output = smua.OUTPUT_ON delay(1) imeas = i_leakage_measure(smua, 0, 1, 300e-3, 10e-6, 100e-3)

  • Page 166: Display Operations

    Section 3: Functions and features 2606B System SourceMeter® Instrument Reference Manual Display operations Display functions and attributes The display functions and attributes for the virtual front panel are described in this section. The following table lists each display function and attribute (in alphabetical order) and cross references it to the section topic where the function or attribute is explained.

  • Page 167: Display Features

    2606B System SourceMeter® Instrument Reference Manual Section 3: Functions and features Display features You can set the virtual front-panel display to display the units of measure, number of digits, and customized text messages for your applications. Display screen The virtual front panel displays source-measure values and readings or user-defined messages. The display screen options include: •...

  • Page 168: Display Messages

    Section 3: Functions and features 2606B System SourceMeter® Instrument Reference Manual Display messages Most of the display functions and attributes that are associated with display messaging will automatically select the user screen. The attribute for the display screen is explained in...
  • Page 169 2606B System SourceMeter® Instrument Reference Manual Section 3: Functions and features Figure 73: Row and column format for display messaging The function to set cursor position can be used two ways: display.setcursor(row, column) display.setcursor(row, column, style) Where: 1 or 2...
  • Page 170 Section 3: Functions and features 2606B System SourceMeter® Instrument Reference Manual Character codes The following special codes can be embedded in the text string to configure and customize the message: $N Starts text on the next line (newline). If the cursor is already on line 2, text is ignored after the ‘$N’...

  • Page 171: Input Prompting

    2606B System SourceMeter® Instrument Reference Manual Section 3: Functions and features Returning a text message The display.gettext() function returns the displayed message (text) and can be used in five ways: text = display.gettext() text = display.gettext(embellished) text = display.gettext(embellished, row) text = display.gettext(embellished, row, columnStart)
  • Page 172 Section 3: Functions and features 2606B System SourceMeter® Instrument Reference Manual The following programming example illustrates how to present the operator with the choice of two menu items: Test1 or Test2. If Test1 is selected, the message Running Test1 is displayed. If Test2 is selected, the message Running Test2 is displayed.

  • Page 173: Indicators

    2606B System SourceMeter® Instrument Reference Manual Section 3: Functions and features Both the display.inputvalue() and display.prompt() functions display the editable input field, but the display.inputvalue() function does not include the text strings for units and help. After one of the above functions is executed, command execution will pause and wait for the operator in input the source level.

  • Page 174: Local Lockout

    Section 3: Functions and features 2606B System SourceMeter® Instrument Reference Manual Bit identification for indicators Annunciator REAR LSTN TALK EDIT Weighted value* 32768 16384 8192 4096 2048 1024 Binary value Annunciator SMPL STAR TRIG AUTO MATH FILT Weighted value* Binary value * The weighted values are for bits that are set to “1.”...
  • Page 175 2606B System SourceMeter® Instrument Reference Manual Section 3: Functions and features User tests User tests can be added to or deleted from the USER TESTS submenu. Adding USER TESTS menu entries You can use the following function in either of two ways to add an entry into the USER TESTS menu: display.loadmenu.add(displayname, code)

  • Page 176: Running A Test From The Virtual Front Panel

    Section 3: Functions and features 2606B System SourceMeter® Instrument Reference Manual Deleting USER TESTS menu entries You can use the following function to delete an entry from the virtual front-panel USER TESTS menu: display.loadmenu.delete(displayname) Where: displayname Name to delete from the menu.
  • Page 177 2606B System SourceMeter® Instrument Reference Manual Section 3: Functions and features display.getlastkey() The display.getlastkey() function immediately returns the key code for the last pressed key. The following programming example illustrates how to display the last key pressed: key = display.getlastkey() print(key) The above code will return the key code value (see the following table).

  • Page 178: Digital I/O

    Section 3: Functions and features 2606B System SourceMeter® Instrument Reference Manual The following programming example illustrates how to prompt the user to press the EXIT (LOCAL) key to abort the script, or any other key to continue it: display.clear() display.setcursor(1, 1) display.settext("Press EXIT to Abort")

  • Page 179: Digital I/O Configuration

    If you are using other Keithley Instrument models that are equipment with a Trigger Link (TLINK), use a cable equipped with a male DB-25 connector (Keithley Instruments part number CA-126-1), or a Model 2600-TLINK cable to connect the digital I/O port to the other equipment.

  • Page 180: Controlling Digital I/O Lines

    Section 3: Functions and features 2606B System SourceMeter® Instrument Reference Manual Controlling digital I/O lines Although the 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 virtual front panel or over a remote interface.

  • Page 181: Using Output Enable

    2606B System SourceMeter® Instrument Reference Manual Section 3: Functions and features Remote digital I/O commands Commands that control and access the digital I/O port are summarized in the following table. See the TSP command reference (on page 7-1) for complete details on these commands. See the following table for decimal and hexadecimal values used to control and access the digital I/O port and individual lines.
  • Page 182 Section 3: Functions and features 2606B System SourceMeter® Instrument Reference Manual When enabled, you can only turn on the output of the module when the output enable line is pulled high through a switch to +5 V (as shown). If the lid of the test fixture opens, the switch opens, and the output enable line goes low, turning the output of the 2606B off.

  • Page 183: Tsp-Link Trigger Lines

    2606B System SourceMeter® Instrument Reference Manual Section 3: Functions and features TSP-Link trigger lines The 2606B has three trigger lines that you can use for triggering, digital I/O, and to synchronize ® multiple instruments on a TSP-Link network. ® The TSP-Link trigger lines are built into the TSP-Link connection.

  • Page 185: Theory Of Operation

    Section 4 Theory of operation In this section: Analog-to-digital converter ............4-1 Source-measure concepts ............4-1 Measurement settling time considerations ......4-18 Effects of load on current source settling time ......4-19 Creating pulses with the 2606B ..........4-19 Analog-to-digital converter The 2606B SMUs have an integrating analog-to-digital converter (ADC).

  • Page 186: Overheating Protection

    Section 4: Theory of operation 2606B System SourceMeter® Instrument Reference Manual Overheating protection Proper ventilation is required to keep the 2606B from overheating. Even with proper ventilation, the 2606B can overheat if the ambient temperature is too high. The 2606B has an over-temperature protection circuit that turns the output off if the instrument overheats.

  • Page 187: Operating Boundaries

    Operation in Quadrant II or IV can result in overheating and possible equipment damage. Refer to the specifications, available on tek.com/keithley, for more information on the quadrants of operation. Continuous power operating boundaries...
  • Page 188 Section 4: Theory of operation 2606B System SourceMeter® Instrument Reference Manual V-source operating boundaries The following figures show the operating boundaries for the voltage source. Only the first quadrant of operation is shown. Operation in the other quadrant is similar.
  • Page 189 2606B System SourceMeter® Instrument Reference Manual Section 4: Theory of operation Load considerations for voltage source The boundaries within which the 2606B operates depend on the load of the device-under-test (DUT) that is connected to the output. The following topics show operation examples for resistive loads that are 2 kΩ...
  • Page 190 Section 4: Theory of operation 2606B System SourceMeter® Instrument Reference Manual Voltage sorce operation in current compliance In the following figure, the resistance of the load is decreased to 800 Ω. The DUT load line for 800 Ω intersects the current compliance limit line, placing the 2606B in compliance. When it is in compliance, the 2606B cannot source its programmed voltage (10 V).
  • Page 191 2606B System SourceMeter® Instrument Reference Manual Section 4: Theory of operation Figure 82: Voltage source operation in power compliance Voltage source sweep operation in current and power compliance The following figure shows a voltage sweep on a resistive load of 800 Ω. For this example, the 2606B is programmed to sweep voltage to 10 V, limit current (6 mA) and limit power (50 mW).
  • Page 192 Section 4: Theory of operation 2606B System SourceMeter® Instrument Reference Manual I-source operating boundaries The following figures show the operating boundaries for the I-source. Only the first quadrant of operation is shown; operation in the other quadrant is similar. The first figure shows the output characteristics for the I-source. As shown, the 2606B can output up to 1.01 A at 20 V, or 3.03 A at 6 V.
  • Page 193 2606B System SourceMeter® Instrument Reference Manual Section 4: Theory of operation Load considerations for current source The boundaries within which the 2606B operates depend on the load (device-under-test (DUT)) that is connected to its output. The following topics show operation examples for resistive loads that are 50 Ω...
  • Page 194 Section 4: Theory of operation 2606B System SourceMeter® Instrument Reference Manual Current source operation in voltage compliance The following figure shows what happens if the resistance of the load is increased to 200 Ω. The DUT load line for 200 Ω intersects the voltage compliance limit line, placing the instrument in voltage compliance.
  • Page 195 2606B System SourceMeter® Instrument Reference Manual Section 4: Theory of operation Figure 88: Current source operation in power compliance The following figure shows a current sweep on a resistive load of 200 Ω. For this example, the instrument is programmed to sweep current to 100 mA, limit voltage (6 V), and limit power (500 mW).

  • Page 196: Basic Circuit Configurations

    Section 4: Theory of operation 2606B System SourceMeter® Instrument Reference Manual Basic circuit configurations Source V When configured to source voltage (V-source) as shown in the figure below, the 2606B functions as a low-impedance voltage source with current limit capability, and can measure current (I-meter) or voltage (V-meter).
  • Page 197 2606B System SourceMeter® Instrument Reference Manual Section 4: Theory of operation Source I When the instrument is configured to source current (I-source), as shown in the figure below, the instrument functions as a high-impedance current source with voltage limit capability and can measure current (I-meter) or voltage (V-meter).
  • Page 198 Section 4: Theory of operation 2606B System SourceMeter® Instrument Reference Manual Source I measure I, source V measure V ® The System SourceMeter instrument can measure the function it is sourcing. When sourcing a voltage, you can measure voltage. Conversely, if you are sourcing current, you can measure the output current.
  • Page 199 2606B System SourceMeter® Instrument Reference Manual Section 4: Theory of operation Contact check When a contact check measurement is being performed, two small current sources are switched in between the HI and SENSE HI terminals and the LO and SENSE LO terminals. By controlling the switches illustrated in the following figure, the current from these sources flows through the test leads and through the contact resistance, as shown.

  • Page 200: Guard

    Section 4: Theory of operation 2606B System SourceMeter® Instrument Reference Manual Guard GUARD is at the same potential as output HI. Thus, if hazardous voltages are present at output HI, they are also present at the GUARD terminal. The rear-panel GUARD terminals are always enabled and provide a buffered voltage that is at the same level as the HI (or SENSE HI for remote sense) voltage.
  • Page 201 2606B System SourceMeter® Instrument Reference Manual Section 4: Theory of operation The figures below show how cable guard can eliminate leakage current through the insulators in a test fixture. In this figure, leakage current (I ) flows through the insulators (R...

  • Page 202: Measurement Settling Time Considerations

    Section 4: Theory of operation 2606B System SourceMeter® Instrument Reference Manual Measurement settling time considerations Several outside factors can influence measurement settling times. Effects such as dielectric absorption, cable leakages, and noise can all extend the times required to make stable measurements.

  • Page 203: Effects Of Load On Current Source Settling Time

    The following table lists the DUT impedances for each of these current source ranges. For latest specifications, go to tek.com/keithley. The settling time on a current source range can increase significantly when measuring DUTs that have an impedance that is higher than the maximum DUT impedance listed below.

  • Page 204: Pulse Width

    Section 4: Theory of operation 2606B System SourceMeter® Instrument Reference Manual Refer to the 2606B specifications for details on source settling times. For latest specifications, go to tek.com/keithley. Figure 97: Pulse rise and fall times Range and pulse settling Each range has different specifications for source settling times. This causes different rise and fall time characteristics depending on the set range.

  • Page 205: Remote Commands

    Section 5 Remote commands In this section: Introduction to TSP operation ........... 5-1 About TSP commands ............. 5-3 Factory scripts ................ 5-16 Introduction to TSP operation ® Instruments that are enabled for Test Script Processor (TSP ) operate like conventional instruments by responding to a sequence of commands sent by the controller.

  • Page 206: Queries

    Section 5: Remote commands 2606B System SourceMeter® Instrument Reference Manual Example 2 You can use the results of a function-based command directly or assign variables to the results for later access. The following code defines x and prints it. x = math.abs(-100)

  • Page 207: Information On Scripting And Programming

    2606B System SourceMeter® Instrument Reference Manual Section 5: Remote commands Information on scripting and programming If you need information about using scripts with your TSP-enabled instrument, see Fundamentals of scripting for TSP (on page 6-1). If you need information about using the Lua programming language with the instrument, see Fundamentals of programming for TSP (on page 6-13).

  • Page 208: Data Queue

    Section 5: Remote commands 2606B System SourceMeter® Instrument Reference Manual bit.bitand() (on page 7-8) bit.bitor() (on page 7-9) bit.bitxor() (on page 7-9) bit.clear() (on page 7-10) bit.get() (on page 7-11) bit.getfield() (on page 7-11) bit.set() (on page 7-12) bit.setfield() (on page 7-13) bit.test()

  • Page 209: Display

    2606B System SourceMeter® Instrument Reference Manual Section 5: Remote commands Display display.clear() (on page 7-61) display.getannunciators() (on page 7-62) display.getcursor() (on page 7-63) display.getlastkey() (on page 7-64) display.gettext() (on page 7-65) display.inputvalue() (on page 7-66) display.loadmenu.add() (on page 7-68) display.loadmenu.catalog() (on page 7-69) display.loadmenu.delete()

  • Page 210: File I/O

    Section 5: Remote commands 2606B System SourceMeter® Instrument Reference Manual File I/O You can use the file I/O commands to open and close directories and files, write data, or to read a file on an installed USB flash drive. File I/O commands are organized into two groups: •...

  • Page 211: Instrument Identification

    2606B System SourceMeter® Instrument Reference Manual Section 5: Remote commands The following standard I/O commands are not supported at this time: File   fileVar:lines() io.lines()   fileVar:setvbuf() io.popen() Instrument identification These commands store strings that describe the instrument.

  • Page 212: Miscellaneous

    Section 5: Remote commands 2606B System SourceMeter® Instrument Reference Manual lan.status.subnetmask (on page 7-128) lan.timedwait (on page 7-129) lan.trigger[N].assert() (on page 7-129) lan.trigger[N].clear() (on page 7-130) lan.trigger[N].connect() (on page 7-130) lan.trigger[N].connected (on page 7-131) lan.trigger[N].disconnect() (on page 7-132) lan.trigger[N].EVENT_ID (on page 7-132) lan.trigger[N].ipaddress...

  • Page 213: Queries And Response Messages

    2606B System SourceMeter® Instrument Reference Manual Section 5: Remote commands Queries and response messages You can use the print(), printbuffer(), and printnumber() functions to query the instrument and generate response messages. The format attributes control how the data is formatted for the print functions used.

  • Page 214: Reset

    Section 5: Remote commands 2606B System SourceMeter® Instrument Reference Manual Reset Resets settings to their default settings. digio.trigger[N].reset() (on page 7-56) lan.reset() (on page 7-121) localnode.reset() (on page 7-144) reset() (on page 7-159) smuX.reset() (on page 7-210) timer.reset() (on page 7-339) trigger.blender[N].reset()
  • Page 215 2606B System SourceMeter® Instrument Reference Manual Section 5: Remote commands localnode.linefreq (on page 7-140) smuX.abort() (on page 7-174) smuX.buffer.getstats() (on page 7-175) smuX.buffer.recalculatestats() (on page 7-176) smuX.contact.check() (on page 7-187) smuX.contact.r() (on page 7-188) smuX.contact.speed (on page 7-189) smuX.contact.threshold (on page 7-190) smuX.makebuffer()

  • Page 216: Smu Calibration

    Section 5: Remote commands 2606B System SourceMeter® Instrument Reference Manual smuX.trigger.measure.set() (on page 7-236) smuX.trigger.measure.stimulus (on page 7-237) smuX.trigger.measure.Y() (on page 7-238) smuX.trigger.MEASURE_COMPLETE_EVENT_ID (on page 7-239) smuX.trigger.PULSE_COMPLETE_EVENT_ID (on page 7-239) smuX.trigger.source.action (on page 7-240) smuX.trigger.source.limitY (on page 7-241) smuX.trigger.source.linearY() (on page 7-243) smuX.trigger.source.listY()

  • Page 217: Time

    2606B System SourceMeter® Instrument Reference Manual Section 5: Remote commands status.operation.instrument.tsplink.* (on page 7-292) status.operation.instrument.tsplink.trigger_overrun.* (on page 7-293) status.operation.measuring.* (on page 7-295) status.operation.remote.* (on page 7-296) status.operation.sweeping.* (on page 7-297) status.operation.trigger_overrun.* (on page 7-299) status.operation.user.* (on page 7-301) status.questionable.* (on page 7-303, on page 7-305) status.questionable.calibration.*...
  • Page 218 Section 5: Remote commands 2606B System SourceMeter® Instrument Reference Manual lan.trigger[N].disconnect() (on page 7-132) lan.trigger[N].EVENT_ID (on page 7-132) lan.trigger[N].ipaddress (on page 7-133) lan.trigger[N].mode (on page 7-133) lan.trigger[N].overrun (on page 7-134) lan.trigger[N].protocol (on page 7-135) lan.trigger[N].pseudostate (on page 7-136) lan.trigger[N].stimulus (on page 7-136) lan.trigger[N].wait()

  • Page 219: Tsp-Link

    2606B System SourceMeter® Instrument Reference Manual Section 5: Remote commands tsplink.trigger[N].EVENT_ID (on page 7-360) tsplink.trigger[N].mode (on page 7-361) tsplink.trigger[N].overrun (on page 7-362) tsplink.trigger[N].pulsewidth (on page 7-363) tsplink.trigger[N].release() (on page 7-363) tsplink.trigger[N].reset() (on page 7-364) tsplink.trigger[N].stimulus (on page 7-365) tsplink.trigger[N].wait() (on page 7-366)

  • Page 220: Userstrings

    2606B instrument. A factory script is similar to a user script, except a factory script is created by Keithley Instruments at the factory and is permanently stored in nonvolatile memory. The differences between a user script and a factory script include the following: •...

  • Page 221: Retrieving And Modifying A Factory Script Listing

    2606B System SourceMeter® Instrument Reference Manual Section 5: Remote commands Running a factory script function from the virtual front-panel controls 1. Press the LOAD key. 2. Select FACTORY. 3. Select the function to run and press the ENTER key or navigation wheel .

  • Page 222: Kipulse Factory Script

    Section 5: Remote commands 2606B System SourceMeter® Instrument Reference Manual KIPulse factory script The KIPulse factory script provides examples of how to generate pulses and to provide a simple pulsing interface. Pulses can be generated using the functions listed below.
  • Page 223 2606B System SourceMeter® Instrument Reference Manual Section 5: Remote commands KIPulse tag parameter pulse functions ConfigPulseIMeasureV() (on page 7-34) ConfigPulseVMeasureI() (on page 7-40) ConfigPulseIMeasureVSweepLin() (on page 7-35) ConfigPulseVMeasureISweepLin() (on page 7-42) ConfigPulseIMeasureVSweepLog() (on page 7-38) ConfigPulseVMeasureISweepLog() (on page 7-44) InitiatePulseTest()

  • Page 224: Kihighc Factory Script

    Section 5: Remote commands 2606B System SourceMeter® Instrument Reference Manual KIHighC factory script The KIHighC factory script is made up of two functions: i_leakage_measure() and i_leakage_threshold(). These functions are intended to be used when high capacitance mode is active. Output is generally at a non-zero voltage before calling these functions. These functions can also be used to step the voltage to zero volts in order to measure the leakage current.

  • Page 225: Instrument Programming

    Section 6 Instrument programming In this section: Fundamentals of scripting for TSP ........... 6-1 Fundamentals of programming for TSP ......... 6-13 Test Script Builder (TSB) ............6-30 Password management ............6-34 Working with TSB Embedded ..........6-36 Advanced scripting for TSP ............ 6-37 TSP-Link system expansion interface ........

  • Page 226: What Is A Script?

    Section 6: Instrument programming 2606B System SourceMeter® Instrument 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 virtual front panel of the instrument that prompt the operator to enter parameters.

  • Page 227: Commands That Cannot Be Used In Scripts

    To manage scripts, you can send messages to the instrument, use your own development tool or program, use Keithley Instruments Test Script Builder (TSB) software, or use TSB Embedded on the instrument's web interface. TSB and TSB Embedded are described below.
  • Page 228 Section 6: Instrument programming 2606B System SourceMeter® Instrument Reference Manual Named scripts A named script is a script with a unique name. You can have as many named scripts as needed in the instrument (within the limits of the memory available to the run-time environment). When a named script is loaded into the run-time environment with the loadscript or loadandrunscript commands, a global variable with the same name is created to reference the script.
  • Page 229 2606B System SourceMeter® Instrument Reference Manual Section 6: Instrument programming To load a named script by sending commands: 1. Send the command loadscript scriptName, where scriptName is the name of the script. The name must be a legal Lua variable name.
  • Page 230 Section 6: Instrument programming 2606B System SourceMeter® Instrument Reference Manual If the loaded file does not contain loadscript and endscript keywords, or if no name is included after the loadscript keyword, the code is loaded as the anonymous script. Loading an unnamed script overwrites the existing anonymous script.
  • Page 231 2606B System SourceMeter® Instrument Reference Manual Section 6: Instrument programming Run scripts This section describes how to run the anonymous and named scripts. On the virtual front panel, items are available through the USER menu if you explicitly add them to the menu.
  • Page 232 Section 6: Instrument programming 2606B System SourceMeter® Instrument Reference Manual Run a user script from the instrument front panel From the virtual front panel, you can load and run a script that was previously added to the USER menu. To run the code from the virtual front panel and add it to the USER menu: 1.

  • Page 233: Working With Scripts In Nonvolatile Memory

    2606B System SourceMeter® Instrument Reference Manual Section 6: Instrument programming The scriptVar.save() command saves the script to nonvolatile memory, which makes the change persistent through a power cycle. See Save a user script to nonvolatile memory (on page 6- 10) for more detail.
  • Page 234 Section 6: Instrument programming 2606B System SourceMeter® Instrument Reference Manual Save a user script You can save scripts to nonvolatile memory using commands or TSB Embedded. Only named scripts can be saved to nonvolatile memory. The anonymous script must be named before it can be saved to nonvolatile memory.
  • Page 235 2606B System SourceMeter® Instrument Reference Manual Section 6: Instrument programming Save a script from the instrument front panel You can save scripts from the run-time environment to nonvolatile memory or the USB port on the instrument front panel. If you want to save the anonymous script to nonvolatile memory, you must name it first. See...

  • Page 236: Interactive Script Example

    Section 6: Instrument programming 2606B System SourceMeter® Instrument Reference Manual Interactive script example An interactive script prompts the operator to input values using virtual front panel controls. The following example script uses display messages to prompt the operator to: •...

  • Page 237: Fundamentals Of Programming For Tsp

    ® The Test Script Processor (TSP ) scripting engine is a Lua interpreter. In TSP-enabled instruments, the Lua programming language has been extended with Keithley-specific instrument control 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 238 Section 6: Instrument programming 2606B System SourceMeter® Instrument Reference Manual Function and variable name restrictions You cannot use factory script names, functions created by factory scripts, Lua reserved words and top level command names for function or variable names. You cannot use the following Lua reserved words for function or variable names.
  • Page 239 2606B System SourceMeter® Instrument Reference Manual Section 6: Instrument programming Variable types Variables can be one of the following types. Variable types and values Variable type returned Value Notes "nil" not declared The type of the value nil, whose main property is to be different from any other value;...
  • Page 240 Section 6: Instrument programming 2606B System SourceMeter® Instrument Reference Manual Example: Function function add_two(first_value, function second_value) return first_value + second_value print(add_two(3, 4), type(add_two)) Example: Table atable = {1, 2, 3, 4} Defines a table with four numeric elements. print(atable, type(atable)) Note that the "table"...
  • Page 241 2606B System SourceMeter® Instrument Reference Manual Section 6: Instrument programming To execute a function, substitute appropriate values for parameterX and insert them into a message formatted as: myFunction(valueForParameterX, valueForParameterY) Where valueForParameterX and valueForParameterY represent the values to be passed to the function call for the given parameters.
  • Page 242 Section 6: Instrument programming 2606B System SourceMeter® Instrument Reference Manual The following steps use TSB Embedded. You can also use the loadscript and endscript commands to create the script over the remote interface. See Load a script by sending commands over the remote interface (on page 6-4).
  • Page 243 2606B System SourceMeter® Instrument Reference Manual Section 6: Instrument programming 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 greater than or equal >=...
  • Page 244 Section 6: Instrument programming 2606B System SourceMeter® Instrument Reference Manual Example: Concatenation print(2 .. 3) print("Hello " .. "World") Output: Hello World Operator precedence Operator precedence in Lua follows the order below (from higher to lower priority): • ^ (exponentiation) •...
  • Page 245 2606B System SourceMeter® Instrument Reference Manual Section 6: Instrument programming The syntax of a conditional block is as follows: if expression then block elseif expression then block else block Where: • expression is Lua code that evaluates to either true or false •...
  • Page 246 Section 6: Instrument programming 2606B System SourceMeter® Instrument Reference Manual Example: Else and elseif 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 247 2606B System SourceMeter® Instrument Reference Manual Section 6: Instrument programming Example: While list = { This loop exits when list[element] "One", "Two", "Three", "Four", "Five", "Six"} = nil. print("Count list elements on numeric index:") Output: element = 1 Count list elements on...
  • Page 248 Section 6: Instrument programming 2606B System SourceMeter® Instrument Reference Manual For loops There are two variations of for statements supported in Lua: Numeric and generic. In a for loop, the loop expressions are evaluated once, before the loop starts. The output you get from these examples may vary depending on the data format settings of the instrument.
  • Page 249 2606B System SourceMeter® Instrument Reference Manual Section 6: Instrument programming 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 250 Section 6: Instrument programming 2606B System SourceMeter® Instrument Reference Manual Example: Break with infinite loop a, b = 0, 1 This example uses a break statement that while true do causes the while loop to exit if the value of a print(a, b) becomes greater than 500.

  • Page 251: Standard Libraries

    2606B System SourceMeter® Instrument Reference Manual Section 6: Instrument programming 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 related ® functions. Test Script Processor (TSP...
  • Page 252 Section 6: Instrument programming 2606B System SourceMeter® Instrument Reference Manual String library functions This library provides generic functions for string manipulation, such as finding and extracting substrings. When indexing a string in Lua, the first character is at position 1 (not 0, as in ANSI C).
  • Page 253 2606B System SourceMeter® Instrument 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 254: Test Script Builder (Tsb)

    Test Script Builder (TSB) Keithley Instruments Test Script Builder (TSB) is a software tool you can use to develop scripts for TSP-enabled instruments. Installing the TSB software The installation files for the Test Script Builder software are available at tek.com/keithley.

  • Page 255: Installing The Tsb Add-In

    2. Download the Add-in to your computer and double-click it to start installation. 3. Follow the on-screen instructions. Using Test Script Builder (TSB) Keithley Instruments Test Script Builder (TSB) is a software tool that simplifies building test scripts. You can use TSB to perform the following operations: •...

  • Page 256: Project Navigator

    Section 6: Instrument programming 2606B System SourceMeter® Instrument Reference Manual Figure 99: Example of the Test Script Builder workspace Item Description Project navigator Script editor; right-click to run the script that is displayed Outline view Programming interaction Help; includes detailed information on using Test Script Builder Project navigator The project navigator consists of project folders and the script files (.tsp) created for each project.

  • Page 257: Script Editor

    2606B System SourceMeter® Instrument Reference Manual Section 6: Instrument programming Script editor The script editor is where you write, modify, and debug scripts. To open and display a script file, double-click the file name in the project navigator. You can have multiple script files open in the script editor at the same time.

  • Page 258: Password Management

    To set the password: 1. From the web interface, click Set Password. The LXI - Keithley Instruments - 2606B - Administration page is displayed. 2. In Current Password, type the existing password. 3. In New Password, type the new password.
  • Page 259 If the remote interface is locked, you must enter the password before the module of the 2606B responds to any command issued over a remote interface. The password for the example below is Keithley. To unlock the remote interface, send the following command: password Keithley The module of the 2606B is unlocked and communicates with any remote interface.

  • Page 260: Working With Tsb Embedded

    Section 6: Instrument programming 2606B System SourceMeter® Instrument Reference Manual Working with TSB Embedded TSB Embedded is an alternative to the full version of the Test Script Builder (TSB) Suite. The capabilities of TSB Embedded are similar to TSB. It includes a command line interface that you can use to send instrument commands and create, modify, and save test scripts to the instrument.

  • Page 261: Advanced Scripting For Tsp

    2606B System SourceMeter® Instrument Reference Manual Section 6: Instrument programming Advanced scripting for TSP The following topics describe advanced information that can help you understand how the Test Script ® Processor (TSP ) scripting engine works. Global variables and the script.user.scripts table When working with script commands, it is helpful to understand how scripts are handled in the instrument.

  • Page 262: Create A Script Using The Script.new() Command

    Section 6: Instrument programming 2606B System SourceMeter® Instrument Reference Manual Figure 100: Global variables and scripts in the runtime environment Create a script using the script.new() command Use the script.new() function to copy an existing script from the local node to a remote node. This enables parallel script execution.
  • Page 263 2606B System SourceMeter® Instrument Reference Manual Section 6: Instrument programming For example, to set up a two-second beep, you can send the command: beepTwoSec = script.new("beeper.enable = 1 beeper.beep(2, 2400)", "beepTwoSec") To run the new script, send the command: beepTwoSec() When you add beepTwoSec, the global variable and script.user.scripts table entries are...
  • Page 264 Section 6: Instrument programming 2606B System SourceMeter® Instrument Reference Manual A script will become unnamed if you create a new script with the same name. In this circumstance, the name of the script in the script.user.scripts table is set to an empty string before it is replaced by the new script.

  • Page 265: Rename A Script

    2606B System SourceMeter® Instrument Reference Manual Section 6: Instrument programming Rename a script You can rename a script. You might want to rename a script if you need to name another script the same name as the existing script. You could also rename an existing script to be the autoexec script.

  • Page 266: Retrieve A User Script

    Section 6: Instrument programming 2606B System SourceMeter® Instrument Reference Manual For example, to change the name of the script named test2 to be autoexec: test2.name = "autoexec" test2.save() The autoexec script runs automatically when the instrument is turned on. It runs after all the scripts have loaded and any scripts marked as autorun have run.

  • Page 267: Delete User Scripts From The Instrument

    2606B System SourceMeter® Instrument Reference Manual Section 6: Instrument programming Example: Retrieve source code one line at a time test.list() Retrieve the source of a script named "test". The output will look similar to: loadscript test display.clear() display.settext("This is a test") print("This is a test")

  • Page 268: Restore A Script To The Run-Time Environment

    Section 6: Instrument programming 2606B System SourceMeter® Instrument Reference Manual To completely remove a script: 1. Remove the script from the run-time environment. Set any variables that refer to the script to nil or assign the variables a different value. For example, to remove the script "beepTwoSec"...
  • Page 269 2606B System SourceMeter® Instrument Reference Manual Section 6: Instrument programming Note that the dedicated reading buffers do not consume memory that is needed by the run-time environment; do not include them in your memory consumption calculations. Also, reading buffers for remote nodes consume memory on the remote node, not the local node.

  • Page 270: Tsp-Link System Expansion Interface

    Section 6: Instrument programming 2606B System SourceMeter® Instrument Reference Manual TSP-Link system expansion interface ® The TSP-Link expansion interface allows the 2606B instrument to communicate with other Test ® Script Processor (TSP ) enabled instruments. The test system can be expanded to include up to 32 TSP-Link enabled instruments.

  • Page 271: Tsp-Link Nodes

    2606B System SourceMeter® Instrument Reference Manual Section 6: Instrument programming TSP-Link nodes ® Each instrument (node) attached to the TSP-Link network must be identified by assigning it a unique TSP-Link node number. Commands for remote nodes are stored in the node table. An individual node is accessed as node[N], where N is the node number assigned to the node.

  • Page 272: Initialization

    Section 6: Instrument programming 2606B System SourceMeter® Instrument Reference Manual Initialization ® Before a TSP-Link system can be used, it must be initialized. For initialization to succeed, each instrument in a TSP-Link system must be assigned a different node number.

  • Page 273: Using The Expanded System

    2606B System SourceMeter® Instrument Reference Manual Section 6: Instrument programming Remote programming ® The commands associated with the TSP-Link system reset are listed in the following table. Command Description Initializes the TSP-Link network tsplink.reset() tsplink.state Reads the state of the TSP-Link network: ...

  • Page 274: Tsp Advanced Features

    Section 6: Instrument programming 2606B System SourceMeter® Instrument Reference Manual Using the reset() command ® Most TSP-Link system operations target a single node in the system, but the reset() command affects the system as a whole by resetting all nodes to their default settings: -- Reset all nodes in a TSP-Link system to their default state.
  • Page 275 2606B System SourceMeter® Instrument Reference Manual Section 6: Instrument programming There are two methods you can use to run test scripts simultaneously: • Create multiple TSP-Link networks • Use a single TSP-Link network with groups The following figure displays the first method, which consists of multiple TSP-Link networks. Each TSP-Link network has a master node and a remote connection to the computer.
  • Page 276 Section 6: Instrument programming 2606B System SourceMeter® Instrument Reference Manual Another method you can use to run simultaneous test scripts is to use groups with a single TSP-Link network. Each group on the TSP-Link network can run a test while other groups are running different tests.

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

    2606B System SourceMeter® Instrument Reference Manual Section 6: Instrument programming TSP-Link network group functions Group leader Runs the test script initiated by the master node Node 5 Initiates remote operations on node 4 Node 4 Performs remote operations initiated by node 5...

  • Page 278: Running Simultaneous Test Scripts

    Section 6: Instrument programming 2606B System SourceMeter® Instrument Reference Manual Assigning groups Group numbers can range from zero (0) to 64. The default group number is 0. You can change the group number at any time. You can also add or remove a node to or from a group at any time.

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

    2606B System SourceMeter® Instrument Reference Manual Section 6: Instrument programming For additional information, refer to waitcomplete() (on page 7-383). The following code shows two examples of using the waitcomplete() command from the master node: -- Wait for each node in group N to complete all overlapped operations.

  • Page 280: Tsp-Net

    Section 6: Instrument programming 2606B System SourceMeter® Instrument Reference Manual Removing stale values from the reading buffer cache The node that acquires the data also stores the data for the reading buffer. To optimize data access, all nodes can cache data from the node that stores the reading buffer data.

  • Page 281: Using Tsp-Net With Any Ethernet-Enabled Instrument

    2606B System SourceMeter® Instrument Reference Manual Section 6: Instrument programming Using TSP-Net commands with TSP-enabled instruments, a 2606B can download a script to another TSP-enabled instrument and have both instruments run scripts independently. The 2606B can read the data from the remote instrument and either manipulate the data or send the data to a different remote instrument on the LAN.
  • Page 282 Section 6: Instrument programming 2606B System SourceMeter® Instrument Reference Manual To communicate to a remote ethernet device from the 2606B: 1. Connect to the remote device using one of the above procedures. If the 2606B cannot make a connection to the remote device, it generates a timeout event. Use tspnet.timeout to set the timeout value.

  • Page 283: Tsp-Net Compared To Tsp-Link To Communicate With Tsp-Enabled Devices

    2606B System SourceMeter® Instrument Reference Manual Section 6: Instrument programming TSP-Net compared to TSP-Link to communicate with TSP-enabled devices ® The TSP-Link network interface is the preferred communication method for most applications where communication occurs between the 2606B and another TSP-enabled instrument.

  • Page 284: Example: Using Tspnet Commands

    Section 6: Instrument programming 2606B System SourceMeter® Instrument 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.

  • Page 285: Example 1

    Section 7 TSP command reference In this section: TSP command programming notes .......... 7-1 Using the TSP command reference ......... 7-3 TSP commands ................ 7-7 TSP command programming notes This section contains general information about using TSP commands. Placeholder text This manual uses italicized text to represent the parts of remote commands that must be replaced by user specified values.

  • Page 286: Example 3

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual Example 3: smuX.trigger.measure.Y(rbuffer) Where: X refers to the source-measure unit (SMU) channel (use a for SMU A). Y is the measurement type that you specify (v, i, r, or p).

  • Page 287: Time And Date Values

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Time and date values Time and date values are represented as the number of seconds since some base. Representing time as a number of seconds is referred to as “standard time format.” There are three time bases: •...

  • Page 288: Command Name And Summary Table

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual Command name and summary table Each instrument command description starts with the command name, followed by a table with relevant information for each command. Definitions for the numbered items in the figure below are listed following the figure.

  • Page 289: Command Usage

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Command usage The Usage section of the remote command listing shows how to properly structure the command. Each line in the Usage section is a separate variation of the command usage. All possible command usage options are shown.

  • Page 290: Example Section

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual Example section The Example section of the remote command description shows examples of how you can use the command. Figure 112: TSP example code Actual example code that you can copy from this table and paste into your own programming application.

  • Page 291: Beeper.beep()

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference TSP commands The TSP commands available for the instrument are listed in alphabetic order. beeper.beep() This function generates an audible tone. Type TSP-Link accessible Affected by Where saved Default value...

  • Page 292: Output

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual beeper.enable This command allows you to turn the beeper on or off. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Recall setup Saved setup 1 (beeper.ON)

  • Page 293: Output

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Also see Bit manipulation and logic operations (on page 5-3) bit.bitor() (on page 7-9) bit.bitxor() (on page 7-9) bit.bitor() This function performs a bitwise logical OR operation on two numbers.

  • Page 294: Output

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual Details Any fractional parts of value1 and value2 are truncated to make them integers. The returned result is also an integer. Example testResult = bit.bitxor(10, 9) Performs a logical XOR operation on decimal 10 (binary 1010) with decimal 9 (binary 1001), which returns a value of decimal 3 (binary 0011).

  • Page 295: Bit.get()

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference bit.get() This function retrieves the weighted value of a bit at a specified index position. Type TSP-Link accessible Affected by Where saved Default value Function Usage result = bit.get(value, index)

  • Page 296: Bit.set()

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual Details A field of bits is a contiguous group of bits. This function retrieves a field of bits from value starting at index. The index position is the least significant bit of the retrieved field. The number of bits to return is specified by width.

  • Page 297: Bit.setfield()

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Also see Bit manipulation and logic operations (on page 5-3) bit.clear() (on page 7-10) bit.get() (on page 7-11) bit.getfield() (on page 7-11) bit.setfield() (on page 7-13) bit.test() (on page 7-14) bit.toggle()

  • Page 298: Bit.test()

    Section 7: TSP command reference 2606B System SourceMeter® Instrument 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 299: Buffervar.appendmode

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Usage result = bit.toggle(value, index) result Result of the bit manipulation Specified number value index One-based bit position within value to toggle (1 to 32) Details This function returns result, which is the result of toggling the bit index in value.

  • Page 300: Buffervar.basetimestamp

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual Details Assigning a value to this attribute enables or disables the buffer append mode. This value can only be changed with an empty buffer. Use bufferVar.clear() to empty the buffer.

  • Page 301: Buffervar.cachemode

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Example basetime = smua.nvbuffer1.basetimestamp print(basetime) Read the timestamp for the first reading stored in dedicated reading buffer 1 (source-measure unit (SMU) channel A). Output: 1.28300e+09 This output indicates that the timestamp is 1,283,000,000 seconds (which is Saturday, August 28, 2010 at 12:53:20 PM).

  • Page 302: Buffervar.capacity

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual Also see bufferVar.clearcache() (on page 7-19) bufferVar.fillmode (on page 7-22) Reading buffers (on page 3-5) bufferVar.capacity This attribute contains the number of readings a buffer can store. Type TSP-Link accessible...

  • Page 303: Buffervar.clear()

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference bufferVar.clear() This function empties the buffer. Type TSP-Link accessible Affected by Where saved Default value Function Usage bufferVar.clear() bufferVar The reading buffer; can be a dynamically allocated user-defined buffer or a...

  • Page 304: Buffervar.collectsourcevalues

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual To avoid this, you can include explicit calls to the bufferVar.clearcache() function to remove stale values from the reading buffer cache. Example smua.nvbuffer1.clearcache() Clears the reading buffer cache for dedicated reading buffer 1 (source-measure unit (SMU) channel A).

  • Page 305: Buffervar.collecttimestamps

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Also see bufferVar.clear() (on page 7-19) Reading buffers (on page 3-5) smuX.measure.overlappedY() (on page 7-203) smuX.measure.Y() (on page 7-207) smuX.nvbufferY (on page 7-209) smuX.trigger.measure.Y() (on page 7-238) bufferVar.collecttimestamps This attribute sets whether or not timestamp values are stored with the readings in the buffer.

  • Page 306: Buffervar.fillcount

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual bufferVar.fillcount This attribute sets the reading buffer fill count. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Not applicable See Details Usage fillCount = bufferVar.fillcount bufferVar.fillcount = fillCount...

  • Page 307: Buffervar.measurefunctions

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Usage fillMode = bufferVar.fillmode bufferVar.fillmode = fillMode fillMode The reading buffer fill mode; set to one of the following:  0 or smuX.FILL_ONCE: Do not overwrite old data ...

  • Page 308: Buffervar.measureranges

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual For dedicated reading buffers, all buffer attributes are saved to nonvolatile memory only when the reading buffer is saved to nonvolatile memory. Example 1 measurefunction = smua.nvbuffer1.measurefunctions[5] Store the measure function used to make reading number 5.

  • Page 309: Buffervar.n

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Example 1 measurerange = smua.nvbuffer1.measureranges[1] Store the measure range that was used to make reading number 1. Example 2 printbuffer(1, 10, smua.nvbuffer1.measureranges) Print the range values that were used for the first 10 readings saved in dedicated reading buffer 1.

  • Page 310: Buffervar.readings

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual Example numberOfReadings = smua.nvbuffer1.n print(numberOfReadings) Reads the number of readings stored in dedicated reading buffer 1 (source-measure unit (SMU) channel A). Output: 1.25000+02 The above output indicates that there are 125 readings stored in the buffer.

  • Page 311: Buffervar.sourcefunctions

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Example print(smua.nvbuffer1.readings[1]) Output the first reading saved in source-measure unit (SMU) channel A, dedicated reading buffer 1. Output: 8.81658e-08 Also see bufferVar.measurefunctions (on page 7-23) bufferVar.measureranges (on page 7-24) bufferVar.n...

  • Page 312: Buffervar.sourceoutputstates

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual Example 2 printbuffer(1, 10, smua.nvbuffer1.sourcefunctions) Print the source function used for 10 readings stored in dedicated reading buffer 1. Example output: Voltage, Voltage, Voltage, Voltage, Voltage, Voltage, Voltage, Voltage,...

  • Page 313: Buffervar.sourceranges

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Also see bufferVar.measurefunctions (on page 7-23) bufferVar.measureranges (on page 7-24) bufferVar.n (on page 7-25) bufferVar.readings (on page 7-26) bufferVar.sourcefunctions (on page 7-27) bufferVar.sourceranges (on page 7-29) bufferVar.sourcevalues (on page 7-30) bufferVar.statuses...

  • Page 314: Buffervar.sourcevalues

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual Also see bufferVar.measurefunctions (on page 7-23) bufferVar.measureranges (on page 7-24) bufferVar.n (on page 7-25) bufferVar.readings (on page 7-26) bufferVar.sourcefunctions (on page 7-27) bufferVar.sourceoutputstates (on page 7-28) bufferVar.sourcevalues (on page 7-30) bufferVar.statuses...

  • Page 315: Buffervar.statuses

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Also see bufferVar.measurefunctions (on page 7-23) bufferVar.measureranges (on page 7-24) bufferVar.n (on page 7-25) bufferVar.readings (on page 7-26) bufferVar.sourcefunctions (on page 7-27) bufferVar.sourceoutputstates (on page 7-28) bufferVar.sourceranges (on page 7-29) bufferVar.statuses...

  • Page 316: Buffervar.timestampresolution

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual Also see bufferVar.measurefunctions (on page 7-23) bufferVar.measureranges (on page 7-24) bufferVar.n (on page 7-25) bufferVar.readings (on page 7-26) bufferVar.sourcefunctions (on page 7-27) bufferVar.sourceoutputstates (on page 7-28) bufferVar.sourceranges (on page 7-29) bufferVar.sourcevalues...

  • Page 317: Buffervar.timestamps

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference bufferVar.timestamps When enabled by the bufferVar.collecttimestamps attribute, this attribute contains the timestamp when each reading saved in the specified reading buffer occurred. Type TSP-Link accessible Affected by Where saved...

  • Page 318: Configpulseimeasurev()

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual ConfigPulseIMeasureV() This KIPulse factory script function configures a current pulse train with a voltage measurement at each point. Type TSP-Link accessible Affected by Where saved Default value Function Usage...

  • Page 319: Configpulseimeasurevsweeplin()

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference This function does not cause the specified smu to output a pulse train. It simply checks to see if all the pulse dimensions can be achieved, and if they are, assigns the indicated tag or index to the pulse train.
  • Page 320 Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual A Boolean flag; this flag is true if the pulse was successfully configured, false when errors were encountered A string message; if the f flag is false, msg contains an error message; if it is true,...
  • Page 321 2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Figure 115: ConfigPulseIMeasureVSweepLin() Example ConfigPulseIMeasureVSweepLin(smua, 0, 0.01, 0.05, 1, 1e-3, 0.1, 20, smua.nvbuffer2, 3) Set up a pulsed sweep that uses channel A. The pulsed sweep starts at 10 mA, ends at 50 mA, and returns to a 0 mA bias level between pulses.

  • Page 322: Configpulseimeasurevsweeplog()

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual ConfigPulseIMeasureVSweepLog() This KIPulse factory script (on page 5-18) function configures a voltage pulse train with a current measurement at each point. Type TSP-Link accessible Affected by Where saved Default value...
  • Page 323 2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference The magnitude of the first pulse will be start amperes; the magnitude of the last pulse will be stop amperes. The magnitude of each pulse in between will be LogStep...

  • Page 324: Configpulsevmeasurei()

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual ConfigPulseVMeasureI() This KIPulse factory script function configures a voltage pulse train with a current measurement at each point. Type TSP-Link accessible Affected by Where saved Default value Function Usage...
  • Page 325 2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference This function does not cause the specified smu to output a pulse train. It does check to see if all the pulse dimensions can be achieved, and if they can, assigns the indicated tag or index to the pulse train.

  • Page 326: Configpulsevmeasureisweeplin()

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual ConfigPulseVMeasureISweepLin() This KIPulse factory script function configures a voltage pulse train with a current measurement at each point. Type TSP-Link accessible Affected by Where saved Default value Function Usage...
  • Page 327 2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference The magnitude of the first pulse will be start volts; the magnitude of the last pulse will be stop volts. The magnitude of each pulse in between will be step volts larger than the previous pulse,...

  • Page 328: Configpulsevmeasureisweeplog()

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual ConfigPulseVMeasureISweepLog() This KIPulse factory script function configures a voltage pulse train with a current measurement at each point. Type TSP-Link accessible Affected by Where saved Default value Function Usage...
  • Page 329 2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference This function configures a logarithmic pulsed voltage sweep with a current measurement at each point. Measurements are made at the end of the ton time. The magnitude of the first pulse will be start volts; the magnitude of the last pulse will be stop volts.

  • Page 330: Dataqueue.add()

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual dataqueue.add() This function adds an entry to the data queue. Type TSP-Link accessible Affected by Where saved Default value Function Usage result = dataqueue.add(value) result = dataqueue.add(value, timeout) result...

  • Page 331: Dataqueue.capacity

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference 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 count The variable that is assigned the value of dataqueue.CAPACITY...

  • Page 332: Dataqueue.count

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual 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 333: Dataqueue.next()

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Also see dataqueue.add() (on page 7-46) dataqueue.CAPACITY (on page 7-47) dataqueue.clear() (on page 7-47) dataqueue.next() (on page 7-49) Using the data queue for real-time communication (on page 6-55) dataqueue.next() This function removes the next entry from the data queue.

  • Page 334: Delay()

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual Also see dataqueue.add() (on page 7-46) dataqueue.CAPACITY (on page 7-47) dataqueue.clear() (on page 7-47) dataqueue.count (on page 7-48) format.asciiprecision (on page 7-92) Using the data queue for real-time communication...

  • Page 335: Digio.readport()

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Example Assume line 4 is set high, and it is then read. print(digio.readbit(4)) Output: 1.00000e+00 Also see digio.readport() (on page 7-51) digio.writebit() (on page 7-59) digio.writeport() (on page 7-60)

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

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual digio.trigger[N].assert() This function asserts a trigger pulse on one of the digital I/O lines. Type TSP-Link accessible Affected by Where saved Default value Function Usage digio.trigger[N].assert() Digital I/O trigger line (1 to 14) Details The pulse width that is set determines how long the instrument asserts the trigger.

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

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference digio.trigger[N].EVENT_ID This constant identifies the trigger event generated by the digital I/O line N. Type TSP-Link accessible Affected by Where saved Default value Constant Usage eventID = digio.trigger[N].EVENT_ID The trigger event number...
  • Page 338 If the programmed state of the line is low, the digio.TRIG_RISING mode behavior is similar to digio.TRIG_RISINGM. This setting should only be used if necessary for compatibility with other Keithley Instruments products. Detects rising- or falling-edge triggers as input. Asserts a digio.TRIG_EITHER or 3...

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

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference digio.trigger[N].overrun This attribute returns the event detector overrun status. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Instrument reset Not saved Not applicable Digital I/O trigger N clear...

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

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual Details Setting the pulse width to zero (0) seconds asserts the trigger indefinitely. To release the trigger line, use digio.trigger[N].release(). Example Sets the pulse width for trigger line 4 to digio.trigger[4].pulsewidth = 20e-6...

  • Page 341: Digio.trigger[N].Stimulus

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Details This function resets the following attributes to factory default settings:  digio.trigger[N].mode  digio.trigger[N].pulsewidth  digio.trigger[N].stimulus It also clears digio.trigger[N].overrun. Example digio.trigger[3].mode = 2 digio.trigger[3].pulsewidth = 50e-6 digio.trigger[3].stimulus = digio.trigger[5].EVENT_ID print(digio.trigger[3].mode, digio.trigger[3].pulsewidth,...
  • Page 342 Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual The trigger stimulus for a digital I/O line may be set to one of the existing trigger event IDs, described in the following table. Trigger event IDs* Event ID Event description smuX.trigger.SWEEPING_EVENT_ID...

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

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference 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 The value true if a trigger is detected, or false if no triggers are detected during...

  • Page 344: Digio.writeport()

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual 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 345: Digio.writeprotect

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference digio.writeprotect This attribute contains the write-protect mask that protects bits from changes from the digio.writebit() and digio.writeport() functions. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW)

  • Page 346: Display.getannunciators()

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual display.getannunciators() This function reads the annunciators (indicators) that are presently turned on. Type TSP-Link accessible Affected by Where saved Default value Function Usage annunciators = display.getannunciators() The bitmasked value that shows which indicators are turned on...

  • Page 347: Display.getcursor()

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Example 2 Output: print(display.ANNUNCIATOR_EDIT) 2.56000e+02 print(display.ANNUNCIATOR_TRIGGER) 3.20000e+01 print(display.ANNUNCIATOR_AUTO) 8.00000e+00 Also see bit.bitand() (on page 7-8) display.getcursor() This function reads the present position of the cursor on the virtual front-panel display.

  • Page 348: Display.getlastkey()

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual display.getlastkey() This function retrieves the key code for the last pressed key. Type TSP-Link accessible Affected by Where saved Default value Function Usage keyCode = display.getlastkey() A returned value that represents the last virtual front-panel key pressed; see Details...

  • Page 349: Display.gettext()

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Example key = display.getlastkey() On the virtual front panel, press the MENU key and then send the code shown here. This print(key) retrieves the key code for the last pressed key.

  • Page 350: Display.inputvalue()

    Section 7: TSP command reference 2606B System SourceMeter® Instrument 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 351 2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Details The format parameter uses zeros (0), the decimal point, polarity sign, and exponents to define how the input field is formatted. The format parameter can include the options shown in the following table.

  • Page 352: Display.loadmenu.add()

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual display.loadmenu.add() This function adds an entry to the USER menu, which can be accessed by pressing the LOAD key on the virtual front panel. Type TSP-Link accessible Affected by...

  • Page 353: Display.loadmenu.catalog()

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Example 2 display.loadmenu.add("Test", "DUT1() beeper.beep(2, 500)", display.SAVE) Assume a script with a function named “DUT1” has already been loaded into the instrument, and the script has not been saved in nonvolatile memory.

  • Page 354: Display.loadmenu.delete()

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual display.loadmenu.delete() This function removes an entry from the USER menu, which can be accessed using the LOAD key on the virtual front panel. Type TSP-Link accessible Affected by Where saved...

  • Page 355: Display.menu()

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Also see None display.menu() This function presents a menu on the virtual front-panel display. Type TSP-Link accessible Affected by Where saved Default value Function Usage selection = display.menu(name, items)

  • Page 356: Display.prompt()

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual Usage numericKeypad = display.numpad display.numpad = numericKeypad numericKeypad Enable the numeric keypad feature (1 or display.ENABLE) Disable the numeric keypad feature (0 or display.DISABLE) Details The numeric keypad feature is only available when editing a numeric value at the same time that the EDIT indicator is lit.
  • Page 357 2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Option Description Examples Include the E to display the value exponentially. Include a plus sign (+) for positive/negative exponent entry. Do not 0.00000E+0 include the plus sign (+) to prevent negative value entry. 0 defines the digit positions for the exponent.

  • Page 358: Display.screen

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual display.screen This attribute contains the selected display screen. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Instrument reset Saved setup 2 (display.SMUA_SMUB) Recall setup Usage displayID = display.screen display.screen = displayID...

  • Page 359: Display.setcursor()

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Key codes Value Key list Value Key list display.KEY_NONE display.KEY_ENTER display.KEY_RANGEUP display.KEY_MEASB display.KEY_MODEB display.KEY_DIGITSB display.KEY_RELB display.KEY_RECALL display.KEY_MENU display.KEY_MEASA display.KEY_MODEA display.KEY_DIGITSA display.KEY_RELA display.KEY_OUTPUTA display.KEY_RUN display.KEY_LIMITB display.KEY_DISPLAY display.KEY_SPEEDB display.KEY_AUTO display.KEY_TRIG display.KEY_FILTERB display.KEY_LIMITA...

  • Page 360: Display.settext()

    Section 7: TSP command reference 2606B System SourceMeter® Instrument 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 commands. That is, the script does not wait for one of these commands to complete.

  • Page 361: Display.smux.digits

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference The text starts at the present cursor position. After the text is displayed, the cursor is after the last character in the display message. Top line text does not wrap to the bottom line of the display automatically. Any text that does not fit on the current line is truncated.

  • Page 362: Display.smux.limit.func

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual Usage digits = display.smuX.digits display.smuX.digits = digits digits Set digits to one of the following values:  Select 4-1/2 digit resolution (4 or display.DIGITS_4_5)  Select 5-1/2 digit resolution (5 or display.DIGITS_5_5) ...

  • Page 363: Display.smux.measure.func

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference display.smuX.measure.func This attribute specifies the type of measurement that is being displayed. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Instrument reset Saved setup 1 (display.MEASURE_DCVOLTS)

  • Page 364: Display.trigger.event_Id

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual Also see display.trigger.overrun (on page 7-80) display.trigger.wait() (on page 7-81) display.trigger.EVENT_ID This constant is the event ID of the event generated when the virtual front-panel TRIG key is pressed.

  • Page 365: Display.trigger.wait()

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference display.trigger.wait() This function waits for the TRIG key on the virtual front panel to be pressed. Type TSP-Link accessible Affected by Where saved Default value Function Usage triggered = display.trigger.wait(timeout)
  • Page 366 Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual A typical use for this function is to prompt the user to press the EXIT (LOCAL) key to abort the script or press any other key to continue. For example, if the keyCode value 75 is returned (the EXIT (LOCAL) key was pressed), you can call the exit() function to abort the script.

  • Page 367: Errorqueue.clear()

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference errorqueue.clear() This function clears all entries out of the error queue. Type TSP-Link accessible Affected by Where saved Default value Function Usage errorqueue.clear() Details See the Error queue (on page E-2) topic for additional information about the error queue.

  • Page 368: Errorqueue.next()

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual errorqueue.next() This function reads the oldest entry from the error queue and removes it from the queue. Type TSP-Link accessible Affected by Where saved Default value Function Usage errorCode, message, severity, errorNode = errorqueue.next()

  • Page 369: Eventlog.all()

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Example Reads the oldest entry in the error queue. The errorcode, message = errorqueue.next() output below indicates that the queue is empty. print(errorcode, message) Output: 0.00000e+00 Queue Is Empty...

  • Page 370: Eventlog.clear()

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual eventlog.clear() This function clears the event log. Type TSP-Link accessible Affected by Where saved Default value Function Usage eventlog.clear() Details This command removes all messages from the event log.

  • Page 371: Eventlog.enable

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference eventlog.enable This attribute enables or disables the event log. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Instrument reset Not saved 1 (eventlog.ENABLE) Recall setup Usage status = eventlog.enable...

  • Page 372: Eventlog.overwritemethod

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual Example 1 print(eventlog.next()) Get the oldest message in the event log and remove that entry from the log. Output: 17:28:22.085 10 Oct 2009, LAN2, 192.168.1.102, LXI, 0, 1192037134, <no time>, 0, Example 2 print(eventlog.next())

  • Page 373: Exit()

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference exit() This function stops a script that is presently running. Type TSP-Link accessible Affected by Where saved Default value Function Usage exit() Details Terminates script execution when called from a script that is being executed.

  • Page 374: Filevar:flush()

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual fileVar:flush() This function writes buffered data to a file. Type TSP-Link accessible Affected by Where saved Default value Function Usage fileVar:flush() fileVar The file descriptor variable to flush Details The fileVar:write() or io.write() functions buffer data, which may not be written immediately...

  • Page 375: Filevar:seek()

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference "*a": Returns the whole file, starting at the current position (returns an empty string if the current file position is at the end of the file). "*l": Returns the next line, skipping the end of line; returns nil if the current file position is at the end of file.

  • Page 376: Filevar:write()

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual fileVar:write() This function writes data to a file. Type TSP-Link accessible Affected by Where saved Default value Function Usage fileVar:write(data) fileVar:write(data1, data2) fileVar:write(data1, ..., datan) fileVar The file descriptor variable...

  • Page 377: Format.byteorder

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Note that the precision is the number of significant digits printed. There is always one digit to the left of the decimal point; be sure to include this digit when setting the precision.

  • Page 378: Format.data

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual Example x = 1.23 Output depends on the terminal program you use, but will look something like: format.data = format.REAL32 #0¤p?? format.byteorder = format.LITTLEENDIAN #0??p¤ printnumber(x) format.byteorder = format.BIGENDIAN...

  • Page 379: Fs.chdir()

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Example format.asciiprecision = 10 Output a number represented by x in ASCII using a precision of 10, then output the same x = 3.14159265 number in binary using double precision format.data = format.ASCII...

  • Page 380: Fs.cwd()

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual fs.cwd() This function returns the absolute path of the current working directory. Type TSP-Link accessible Affected by Where saved Default value Function Usage path = fs.cwd() path The absolute path of the current working directory...

  • Page 381: Fs.mkdir()

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Also see fs.is_dir() (on page 7-96) fs.mkdir() This function creates a directory at the specified path. Type TSP-Link accessible Affected by Where saved Default value Function Usage path = fs.mkdir(newPath)

  • Page 382: Fs.rmdir()

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual fs.rmdir() This function removes a directory from the file system. Type TSP-Link accessible Affected by Where saved Default value Function Usage fs.rmdir(path) The path of the directory to remove...

  • Page 383: Gm_Isweep()

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference gm_isweep() This KIParlib factory script function performs a linear current sweep and calculates the transconductance (G ) at each point. Type TSP-Link accessible Affected by Where saved Default value...

  • Page 384: Gm_Vsweep()

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual gm_vsweep() This KIParlib factory script function performs a linear voltage sweep and calculates the transconductance (G ) at each point. Type TSP-Link accessible Affected by Where saved Default value...
  • Page 385 2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Usage imeas = i_leakage_measure(smu, levelv, limiti, sourcedelay, measurei, measuredelay) imeas The measured current Instrument channel (for example, smua refers to SMU channel A) Voltage level to step to when this function is called...

  • Page 386: I_Leakage_Threshold()

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual i_leakage_threshold() This KIHighC factory script function measures the current and compares it to a threshold. This continues until either the measured current drops below the threshold or the timeout expires.

  • Page 387: Initiatepulsetest()

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Example smua.source.highc = smua.ENABLE Enable high-capacitance mode. smua.source.levelv = 5 Charge the capacitor. smua.source.output = smua.OUTPUT_ON delay(1) pass = i_leakage_threshold(smua, 0, 1, The parameters passed on to the 300e-3, 10e-6, 100e-3, 1e-6, 1)
  • Page 388 Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual Example smua.reset() smua.source.rangev = 5 smua.source.rangei = 1 smua.source.levelv = 0 smua.measure.rangev = 5 smua.measure.rangei = 1 smua.measure.nplc = 0.01 smua.measure.autozero = smua.AUTOZERO_ONCE smua.nvbuffer1.clear() smua.nvbuffer1.appendmode = 1 smua.source.output = smua.OUTPUT_ON f1, msg1 = ConfigPulseVMeasureI(smua, 0, 5, 1, 0.002, 0.2, 10, smua.nvbuffer1, 1)

  • Page 389: Initiatepulsetestdual()

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference InitiatePulseTestDual() This KIPulse factory script (on page 5-18) function initiates the pulse configuration assigned tag1 and tag2. Type TSP-Link accessible Affected by Where saved Default value Function Usage f, msg = InitiatePulseTestDual(tag1, tag2) A Boolean flag;...
  • Page 390 Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual Example smua.reset() smua.source.rangev = 5 smua.source.rangei = 1 smua.source.levelv = 0 smua.measure.rangev = 5 smua.measure.rangei = 1 smua.measure.nplc = 0.01 smua.measure.autozero = smua.AUTOZERO_ONCE smua.nvbuffer1.clear() smua.nvbuffer1.appendmode = 1 smua.source.output = smua.OUTPUT_ON smub.reset()

  • Page 391: Io.close()

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Also see ConfigPulseIMeasureV() (on page 7-34) ConfigPulseIMeasureVSweepLin() (on page 7-35) ConfigPulseIMeasureVSweepLog() (on page 7-38) ConfigPulseVMeasureI() (on page 7-40) ConfigPulseVMeasureISweepLin() (on page 7-42) ConfigPulseVMeasureISweepLog() (on page 7-44) io.close() This function closes a file.

  • Page 392: Io.input()

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual Data is not automatically written to a file when you use the io.write() function. The io.write() function buffers data; it may not be written to the USB flash drive immediately. Use the io.flush() function to immediately write buffered data to the drive.

  • Page 393: Io.open()

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference io.open() This function opens a file for later reference. Type TSP-Link accessible Affected by Where saved Default value Function Usage fileVar, errorMsg = io.open(path) fileVar, errorMsg = io.open(path, mode)

  • Page 394: Io.read()

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual Details The path of the file to open may be absolute or relative to the current working directory. When accessed from a remote node using the TSP-Link network, this command does not accept a file descriptor parameter and does not return a value.

  • Page 395: Io.type()

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Also see None io.type() This function checks whether or not a given object is a file handle. Type TSP-Link accessible Affected by Where saved Default value Function Usage type = io.type(obj)

  • Page 396: Lan.applysettings()

    Section 7: TSP command reference 2606B System SourceMeter® Instrument 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 present configuration settings.

  • Page 397: Lan.config.dns.address[N]

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Also see lan.linktimeout (on page 7-120) lan.restoredefaults() (on page 7-122) lan.config.dns.address[N] Configures DNS server IP addresses. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) LAN restore defaults Nonvolatile memory "0.0.0.0"...

  • Page 398: Lan.config.dns.domain

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual lan.config.dns.domain Configures the dynamic DNS domain. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) LAN restore defaults Nonvolatile memory "" Usage domain = lan.config.dns.domain lan.config.dns.domain = domain domain Dynamic DNS registration domain;...

  • Page 399: Lan.config.dns.hostname

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Example Outputs the dynamic registration state. print(lan.config.dns.dynamic) If dynamic DNS registration is enabled, the response is: 1.00000e+00 Also see lan.config.dns.hostname (on page 7-115) lan.restoredefaults() (on page 7-122) lan.config.dns.hostname This attribute defines the dynamic DNS host name.

  • Page 400: Lan.config.dns.verify

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual lan.config.dns.verify This attribute defines the DNS host name verification state. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) LAN restore defaults Nonvolatile memory 1 (lan.ENABLE) Usage state = lan.config.dns.verify...

  • Page 401: Lan.config.gateway

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference lan.config.gateway This attribute contains the LAN default gateway address. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) LAN restore defaults Nonvolatile memory "0.0.0.0" Usage gatewayAddress = lan.config.gateway lan.config.gateway = gatewayAddress...

  • Page 402: Lan.config.method

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual Example ipaddress = lan.config.ipaddress Retrieves the presently set LAN IP address. Also see lan.restoredefaults() (on page 7-122) lan.status.ipaddress (on page 7-125) lan.config.method This attribute contains the LAN settings configuration method.

  • Page 403: Lan.config.subnetmask

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Usage speed = lan.config.speed lan.config.speed = speed speed LAN speed setting in Mbps (10 or 100) Details This attribute stores the speed that will be used if the LAN is restarted for manual configuration operation.

  • Page 404: Lan.linktimeout

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual lan.linktimeout This attribute contains the LAN link timeout period. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) LAN restore defaults Nonvolatile memory 20 (20 s) Usage timeout = lan.linktimeout...

  • Page 405: Lan.nagle

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Also see None lan.nagle This attribute controls the state of the LAN Nagle algorithm. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Power cycle Not saved 0 (lan.DISABLE)

  • Page 406: Lan.restoredefaults()

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual lan.restoredefaults() This function resets LAN settings to default values. Type TSP-Link accessible Affected by Where saved Default value Function Usage lan.restoredefaults() Details The settings that are restored are shown in the following table.

  • Page 407: Lan.status.dns.name

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Usage dnsAddress = lan.status.dns.address[N] dnsAddress DNS server IP address Entry index (1, 2, or 3) Details This attribute is an array of DNS server addresses. The instrument can use up to three addresses.

  • Page 408: Lan.status.duplex

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual Also see lan.config.dns.address[N] (on page 7-113) lan.config.dns.hostname (on page 7-115) lan.status.duplex This attribute contains the duplex mode presently in use by the LAN interface. Type TSP-Link accessible Affected by...

  • Page 409: Lan.status.ipaddress

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference lan.status.ipaddress This attribute contains the LAN IP address presently in use by the LAN interface. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Not applicable Not applicable...

  • Page 410: Lan.status.port.dst

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual lan.status.port.dst This attribute contains the LAN dead socket termination port number. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Not applicable Not applicable Not applicable Usage port = lan.status.port.dst...

  • Page 411: Lan.status.port.telnet

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference lan.status.port.telnet This attribute contains the LAN Telnet connection port number. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Not applicable Not applicable Not applicable Usage port = lan.status.port.telnet...

  • Page 412: Lan.status.speed

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual lan.status.speed This attribute contains the LAN speed. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Not applicable Not applicable Not applicable Usage speed = lan.status.speed speed...

  • Page 413: Lan.timedwait

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference lan.timedwait This attribute contains the LAN timed-wait state interval. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) LAN restore defaults Nonvolatile memory 20 (20 s) Usage timeout = lan.timedwait...

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

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual Also see lan.lxidomain (on page 7-120) lan.trigger[N].clear() (on page 7-130) lan.trigger[N].mode (on page 7-133) lan.trigger[N].overrun (on page 7-134) lan.trigger[N].stimulus (on page 7-136) lan.trigger[N].wait() (on page 7-138) Understanding hardware value and pseudo line state (on page 3-48) lan.trigger[N].clear()

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

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference The event generator automatically disconnects when either the protocol or IP address for this event is changed. Example lan.trigger[1].protocol = lan.MULTICAST Set the protocol for LAN trigger 1 to be multicast when sending LAN triggers.

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

    Section 7: TSP command reference 2606B System SourceMeter® Instrument 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 417: Lan.trigger[N].Ipaddress

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP 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) Instrument reset Not saved "0.0.0.0"...

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

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual LAN trigger mode values Mode Number Trigger packets detected as LAN trigger packet generated input for output with a… lan.TRIG_EITHER Rising or falling edge (positive negative state or negative state)

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

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference It also is not an indication of an output trigger overrun. Output trigger overrun indications are provided in the status model. Example overrun = lan.trigger[5].overrun Checks the overrun status of a trigger on LAN5 and...

  • Page 420: Lan.trigger[N].Pseudostate

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual lan.trigger[N].pseudostate This attribute sets the simulated line state for the LAN trigger. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Instrument reset Not saved LAN trigger N reset...
  • Page 421 2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Trigger event IDs* Event ID Event description smuX.trigger.SWEEPING_EVENT_ID Occurs when the source-measure unit (SMU) transitions from the idle state to the arm layer of the trigger model smuX.trigger.ARMED_EVENT_ID Occurs when the SMU moves from the arm layer to the trigger layer of the trigger model smuX.trigger.SOURCE_COMPLETE_EVENT_ID...

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

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual lan.trigger[N].wait() This function waits for an input trigger. Type TSP-Link accessible Affected by Where saved Default value Function Usage triggered = lan.trigger[N].wait(timeout) triggered Trigger detection indication (true or false)

  • Page 423: Localnode.description

    The value of this attribute is also used as the mDNS service name of the instrument. This attribute's factory default value is "Keithley Instruments SMU <model number> - <serial number>", where <model number> and <serial number> are replaced with the actual model number and serial number of the instrument.

  • Page 424: Localnode.linefreq

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual localnode.linefreq This attribute contains the power line frequency setting that is used for NPLC calculations. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Not applicable Nonvolatile memory...

  • Page 425: Localnode.password

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference localnode.password This attribute stores the remote access password. Type TSP-Link accessible Affected by Where saved Default value Attribute (W) LAN reset Nonvolatile memory "" LAN restore defaults Usage localnode.password = "password"...

  • Page 426: Localnode.prompts

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual Details This attribute controls if and where remote access passwords are required. Set this attribute to one of the values below to enable password checking: • localnode.PASSWORD_NONE or 0: Disable passwords everywhere •...

  • Page 427: Localnode.prompts4882

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Commands do not generate prompts. The instrument generates prompts in response to command completion. Prompts are enabled or disabled only for the remote interface that is active when you send the command.

  • Page 428: Localnode.reset()

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual localnode.reset() This function resets the local node instrument. Type TSP-Link accessible Affected by Where saved Default value Function Usage localnode.reset() Details If you want to reset a specific instrument or a subordinate node, use the node[X].reset() command.

  • Page 429: Localnode.serialno

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Example print(localnode.revision) Outputs the present revision level. Sample output: 3.3.0 Also see localnode.description (on page 7-139) localnode.model (on page 7-140) localnode.serialno (on page 7-145) localnode.serialno This attribute stores the serial number of the module.

  • Page 430: Makegetter()

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual Details If this attribute is set to 1, the instrument automatically sends any generated errors stored in the error queue, and then clears the queue. Errors are processed after executing a command message (just before issuing a prompt, if prompts are enabled).

  • Page 431: Makesetter()

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP 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 432: Node[N].Execute()

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual Also see None node[N].execute() This function starts test scripts from a remote node. Type TSP-Link accessible Affected by Where saved Default value Function Yes (see Details) Usage node[N].execute(scriptCode) The node number of this instrument...

  • Page 433: Node[N].Getglobal()

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference node[N].getglobal() This function returns the value of a global variable. Type TSP-Link accessible Affected by Where saved Default value Function Usage value = node[N].getglobal("name") The value of the variable...

  • Page 434: Opc()

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual Example node[3].setglobal("x", 5) Sets the global variable x on node 3 to the value of 5. Also see node[N].getglobal() (on page 7-149) TSP advanced features (on page 6-50) opc() This function sets the operation complete status bit when all overlapped commands are completed.

  • Page 435: Os.rename()

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference If this function fails, it returns nil (for success) and an error message string (for msg). Example os.remove("testFile") Delete the file named testFile. Also see os.rename() (on page 7-151) os.rename()

  • Page 436: Print()

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual year The year (1970 or later) month The month (1 to 12) The day (1 to 31) hour The hour (00 to 23) The minute (00 to 59) The second (00 to 59) If the time (hour, minute, and second) options are not used, they default to noon for that day.

  • Page 437: Printbuffer()

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Example 1 x = 10 Example of an output response message: print(x) Note that your output might be different if you set your ASCII precision setting to a different value.

  • Page 438: Printnumber()

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual Example format.data = format.ASCII format.asciiprecision = 6 printbuffer(1, rb1.n, rb1) This assumes that rb1 is a valid reading buffer in the run-time environment. The use of rb1.n (bufferVar.n) indicates that the instrument should output all readings in the reading buffer. In this example, rb1.n equals 10.

  • Page 439: Pulseimeasurev()

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Also see format.asciiprecision (on page 7-92) format.byteorder (on page 7-93) format.data (on page 7-94) print() (on page 7-152) printbuffer() (on page 7-153) PulseIMeasureV() This KIPulse factory script function performs a specified number of pulse I, measure V cycles.

  • Page 440: Pulsevmeasurei()

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual Example PulseIMeasureV(smua, 0.001, 1.0, SMU A outputs 1 mA and dwells for 40 ms, outputs 1 A and dwells for 20 ms. The voltage measurements 20e-3, 40e-3, 10) occur during each 20 ms dwell period. After the measurement, the output returns to 1 mA and dwells for 40 ms.

  • Page 441: Querypulseconfig()

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Example SMU A outputs −1 V and dwells for 2 ms, smua.measure.nplc = 0.001 outputs 1 V and dwells for 1 ms. The current PulseVMeasureI(smua, -1, 1, 1E-3, 2E-3, 20) measurements occur during each 1 ms dwell period.
  • Page 442 Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual sync_out The sync_out digio line, if used sourcevalues A table containing the source value for each point in the pulse train Example smua.reset() Configure channel A to generate a pulse train, query configuration, and then display as a string.

  • Page 443: Reset()

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference reset() This function resets commands to their default settings. Type TSP-Link accessible Affected by Where saved Default value Function Usage reset() reset(system) What to reset: system  true: If the node is the master, the entire system is reset (default) ...

  • Page 444: Script.anonymous

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual This function will only save to a USB flash drive. You are not required to qualify the path to the USB flash drive, but you can add /usb1/ before the fileName (see Example 2).

  • Page 445: Script.delete()

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference script.delete() This function deletes a script from nonvolatile memory. Type TSP-Link accessible Affected by Where saved Default value Function Usage script.delete(scriptName) scriptName The string that represents the name of the script Example script.delete("test8")

  • Page 446: Script.load()

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual script.load() This function creates a script from a specified file. Type TSP-Link accessible Affected by Where saved Default value Function Usage scriptVar = script.load(file) scriptVar = script.load(file, name) scriptVar The created script;...

  • Page 447: Script.new()

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference script.new() This function creates a script. Type TSP-Link accessible Affected by Where saved Default value Function Usage scriptVar = script.new(code) scriptVar = script.new(code, name) The name of the variable that will reference the script...

  • Page 448: Script.newautorun()

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual script.newautorun() This function is same as the script.new() function, except that that autorun is enabled. Type TSP-Link accessible Affected by Where saved Default value Function Usage scriptVar = script.newautorun(code) scriptVar = script.newautorun(code, name)

  • Page 449: Script.run()

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Details This command copies the script from nonvolatile memory into the run-time environment. It also creates a global variable with the same name as the name of the script.

  • Page 450: Scriptvar.autorun

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual Each time the body of the function executes, name takes on the name of one of the scripts stored in nonvolatile memory. The for loop repeats until all scripts have been iterated.

  • Page 451: Scriptvar.list()

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference scriptVar.list() This function generates a script listing. Type TSP-Link accessible Affected by Where saved Default value Function Usage scriptVar.list() scriptVar The name of the variable that references the script...

  • Page 452: Scriptvar.run()

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual This attribute must be either a valid Lua identifier or the empty string. Changing the name of a script changes the index that is used to access the script in the script.user.scripts table. Setting the attribute to an empty string removes the script from the table completely, and the script becomes an unnamed script.

  • Page 453: Scriptvar.save()

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Example test8.run() Runs the script referenced by the variable test8. Also see None scriptVar.save() This function saves the script to nonvolatile memory or to a USB flash drive. Type...

  • Page 454: Scriptvar.source

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual scriptVar.source This attribute contains the source code of a script. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Not applicable Not saved Not applicable (see Details) Usage "code"...

  • Page 455: Settimezone()

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Details This function sets the date and time of the instrument based on the time parameter (specified in UTC time). UTC time is specified as the number of seconds since Jan 1, 1970, UTC. You can use UTC time from a local time specification, or you can use UTC time from another source (for example, your computer).

  • Page 456: Setup.poweron

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual For example, to set the UTC-5 time zone, you specify the string "5", because UTC-5 is 5 hours behind UTC and you must add 5 hours to the local time to determine UTC time. To specify the time zone UTC4, you specify "-4", because UTC4 is 4 hours ahead of UTC and 4 hours must be...

  • Page 457: Setup.recall()

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference To save a script that is used when the instrument is powered on, you can create a configuration script and name it autoexec. Example setup.poweron = 0 Set the instrument to use the factory default setup when power is turned on.

  • Page 458: Setup.save()

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual setup.save() This function saves the present setup as a user-saved setup. Type TSP-Link accessible Affected by Where saved Default value Function Usage setup.save(id) An integer or string specifying where to save the user setup: ...

  • Page 459: Smux.buffer.getstats()

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference If this function is used to abort a sweep, when it is executed, the SMU exits its trigger model immediately and returns to the idle state of the trigger model.

  • Page 460: Smux.buffer.recalculatestats()

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual Attribute Description measurefunction String indicating the function that was measured for the reading (current, voltage, ohms or watts) measurerange The full-scale range value for the measurement range used when the...

  • Page 461: Smux.cal.adjustdate

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference smuX.cal.adjustdate This attribute stores the date of the last calibration adjustment. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) SMU cal. restore SMU nonvolatile Initially set to factory calibration date...

  • Page 462: Smux.cal.date

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual smuX.cal.date This attribute stores the calibration date of the active calibration set. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) SMU cal. restore SMU nonvolatile Initially set to factory calibration date...

  • Page 463: Smux.cal.due

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference smuX.cal.due This attribute stores the calibration due date for the next calibration. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) SMU cal. restore SMU nonvolatile memory Usage calDue = smuX.cal.due...

  • Page 464: Smux.cal.lock()

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual smuX.cal.lock() This function disables the commands that change calibration settings. Type TSP-Link accessible Affected by Where saved Default value Function Usage smuX.cal.lock() Source-measure unit (SMU) channel (for example, smua.cal.lock() specifies SMU channel A) Details This function disables functions that can change calibration settings.

  • Page 465: Smux.cal.polarity

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Also see Adjustment (on page B-10) smuX.cal.unlock() (on page 7-184) smuX.cal.polarity This attribute controls which calibration constants are used for all subsequent measurements. Type TSP-Link accessible Affected by Where saved...

  • Page 466: Smux.cal.restore()

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual smuX.cal.restore() This function loads a stored set of calibration constants. Type TSP-Link accessible Affected by Where saved Default value Function Usage smuX.cal.restore() smuX.cal.restore(calset) Source-measure unit (SMU) channel (for example, smua.cal.restore() applies...

  • Page 467: Smux.cal.save()

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference smuX.cal.save() This function stores the active calibration constants to nonvolatile memory. Type TSP-Link accessible Affected by Where saved Default value Function Usage smuX.cal.save() Source-measure unit (SMU) channel (for example, smua.cal.save() applies to...

  • Page 468: Smux.cal.unlock()

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual Usage calState = smuX.cal.state calState The present calibration state; when reading this attribute, calState has one of the following values:  0 or smuX.CALSTATE_LOCKED: Calibration is locked  1 or smuX.CALSTATE_CALIBRATING: The calibration constants or dates have been changed but not yet saved to nonvolatile memory ...

  • Page 469: Smux.contact.calibratehi()

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Also see Adjustment (on page B-10) smuX.cal.lock() (on page 7-180) smuX.cal.password (on page 7-180) smuX.cal.state (on page 7-183) smuX.contact.calibratehi() This function calibrates the high/sense high contact check measurement. Type...

  • Page 470: Smux.contact.calibratelo()

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual Example -- Short SENSE LO and LO terminals -- Short SENSE HI and HI terminals -- Allow readings to settle, then get measurements r0_hi, r0_lo = smua.contact.r() -- Connect 50 OHM resistor between SENSE LO and LO...

  • Page 471: Smux.contact.check()

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference This function is disabled until a successful call to smuX.cal.unlock() is made. Example -- Short SENSE LO and LO terminals -- Short SENSE HI and HI terminals -- Allow readings to settle, then get measurements r0_hi, r0_lo = smua.contact.r()

  • Page 472: Smux.contact.r()

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual When the output is off and any of the following: • The output off mode is High-Z (error code 5048, "Contact check not valid with HIGH-Z OUTPUT off") •...

  • Page 473: Smux.contact.speed

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference When the output is off and any of the following: • The output off mode is High-Z (error code 5048, "Contact check not valid with HIGH-Z OUTPUT off") •...

  • Page 474: Smux.contact.threshold

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual Example smua.contact.speed = smua.CONTACT_SLOW Configure contact check for higher accuracy on SMU channel A. Also see Contact check connections (on page 2-51) Contact check measurements (on page 2-50) reset() (on page 7-159) smuX.contact.check()

  • Page 475: Smux.makebuffer()

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference smuX.makebuffer() This function creates a reading buffer. Type TSP-Link accessible Affected by Where saved Default value Function Usage bufferVar = smuX.makebuffer(bufferSize) The created reading buffer bufferVar Source-measure unit (SMU) channel (for example, smua.makebuffer() applies...

  • Page 476: Smux.measure.autozero

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual Usage autoRange = smuX.measure.autorangeY smuX.measure.autorangeY = autoRange autoRange The state of the measurement autorange setting; set to one of the following values:  0 or smuX.AUTORANGE_OFF: Disabled  1 or smuX.AUTORANGE_ON: Enabled ...
  • Page 477 2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Usage azMode = smuX.measure.autozero smuX.measure.autozero = azMode azMode Indicates status of autozero; set to one of the following values:  0 or smuX.AUTOZERO_OFF: Autozero disabled  1 or smuX.AUTOZERO_ONCE: Performs autozero once, then disables autozero ...

  • Page 478: Smux.measure.calibratey()

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual smuX.measure.calibrateY() This function generates and activates new measurement calibration constants. Type TSP-Link accessible Affected by Where saved Default value Function Usage smuX.measure.calibrateY(range, cp1Measured, cp1Reference, cp2Measured, cp2Reference) Source-measure unit (SMU) channel (for example, smua.measure.calibratev() applies to SMU channel A)

  • Page 479: Smux.measure.count

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Also see Adjustment (on page B-10) smuX.cal.lock() (on page 7-180) smuX.cal.restore() (on page 7-182) smuX.cal.save() (on page 7-183) smuX.cal.unlock() (on page 7-184) smuX.source.calibrateY() (on page 7-213) smuX.measure.count This attribute sets the number of measurements made when a measurement is requested.

  • Page 480: Smux.measure.delay

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual smuX.measure.delay This attribute controls the measurement delay. Type TSP-Link Affected by Where saved Default value accessible −1 (smuX.DELAY_AUTO) Attribute (RW) Instrument reset Saved setup SMU reset Recall setup Usage mDelay = smuX.measure.delay...

  • Page 481: Smux.measure.delayfactor

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference smuX.measure.delayfactor This attribute stores a multiplier to the delays that are used when smuX.measure.delay is set to smuX.DELAY_AUTO. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW)

  • Page 482: Smux.measure.filter.enable

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual Details This attribute sets the size of the stack used for filtered measurements. Example Sets the filter count for SMU channel A to 10. smua.measure.filter.count = 10 Also see...

  • Page 483: Smux.measure.filter.type

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference smuX.measure.filter.type This command sets the type of filter used for measurements when the measurement filter is enabled. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Instrument reset Saved setup 1 (smuX.FILTER_REPEAT_AVG)

  • Page 484: Smux.measure.highcrangedelayfactor

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual smuX.measure.highcrangedelayfactor This attribute contains a delay multiplier that is only used during range changes when the high-capacitance mode is active. Type TSP-Link accessible Affected by Where saved Default value...

  • Page 485: Smux.measure.lowrangey

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Details This attribute sets the time interval between measurements when smuX.measure.count is set to a value greater than 1. The SMU attempts to start each measurement when scheduled. If the SMU cannot keep up with the interval setting, measurements are made as quickly as possible.

  • Page 486: Smux.measure.nplc

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual Also see Range (on page 2-71) reset() (on page 7-159) setup.recall() (on page 7-173) smuX.measure.autorangeY (on page 7-191) smuX.reset() (on page 7-210) smuX.measure.nplc This command sets the integration aperture for measurements.

  • Page 487: Smux.measure.overlappedy()

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference smuX.measure.overlappedY() This function starts an asynchronous (background) measurement. Type TSP-Link accessible Affected by Where saved Default value Function Usage smuX.measure.overlappedY(rbuffer) smuX.measure.overlappediv(ibuffer, vbuffer) Source-measure unit (SMU) channel (for example, smua.measure.overlappedv() applies to SMU channel A)

  • Page 488: Smux.measure.rangey

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual smuX.measure.rangeY This attribute contains the positive full-scale value of the measurement range for voltage or current. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Instrument reset...

  • Page 489: Smux.measure.rel.enabley

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Also see Range (on page 2-71) reset() (on page 7-159) setup.recall() (on page 7-173) smuX.measure.autorangeY (on page 7-191) smuX.reset() (on page 7-210) smuX.source.rangeY (on page 7-224) smuX.measure.rel.enableY This attribute turns relative measurements on or off.

  • Page 490: Smux.measure.rel.levely

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual smuX.measure.rel.levelY This attribute sets the offset value for relative measurements. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Instrument reset Not saved SMU reset Recall setup Usage relValue = smuX.measure.rel.levelY...

  • Page 491: Smux.measure.y()

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference smuX.measure.Y() This function makes one or more measurements. Type TSP-Link accessible Affected by Where saved Default value Function Usage reading = smuX.measure.Y() reading = smuX.measure.Y(readingBuffer) iReading, vReading = smuX.measure.iv() iReading, vReading = smuX.measure.iv(iReadingBuffer)

  • Page 492: Smux.measureyandstep()

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual Example Makes 10 voltage measurements using SMU channel smua.measure.count = 10 A and stores them in a buffer. smua.measure.v(smua.nvbuffer1) Also see Reading buffers (on page 3-5) smuX.measure.count (on page 7-195) smuX.measure.overlappedY()

  • Page 493: Smux.nvbuffery

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Example local ivalues = {} This use of the SMU channel A measure and step function smua.source.rangev = 1 measures current starting at a smua.source.levelv = 0 source value of 0 V. After each smua.measure.rangei = 0.01...

  • Page 494: Smux.reset()

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual Also see Configuring and running sweeps (on page 3-27) Reading buffers (on page 3-5) savebuffer() (on page 7-159) smuX.makebuffer() (on page 7-191) smuX.measure.overlappedY() (on page 7-203) smuX.savebuffer() (on page 7-210) smuX.trigger.measure.action...

  • Page 495: Smux.sense

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Details When the instrument is turned off and back on, the dedicated reading buffers are restored from nonvolatile memory to their last saved values. Example Saves buffer 1 (SMU channel A) to internal memory.

  • Page 496: Smux.source.autorangey

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual smuX.source.autorangeY This attribute contains the state of the source autorange control (on/off). Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) SMU reset Saved setup 1 (smuX.AUTORANGE_ON)

  • Page 497: Smux.source.calibratey()

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference smuX.source.calibrateY() This function generates and activates new source calibration constants. Type TSP-Link accessible Affected by Where saved Default value Function Usage smuX.source.calibrateY(range, cp1Expected, cp1Reference, cp2Expected, cp2Reference) Source-measure unit (SMU) channel (for example, smua.source.calibratev()

  • Page 498: Smux.source.compliance

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual smuX.source.compliance This attribute contains the state of source compliance. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Not applicable Not saved Not applicable Usage compliance = smuX.source.compliance...

  • Page 499: Smux.source.func

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Usage sDelay = smuX.source.delay smuX.source.delay = sDelay sDelay Set to the source delay value (for example, to specify an additional 10 ms source delay, set the value to 0.010); you can also set it one of the following values: ...

  • Page 500: Smux.source.highc

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual Details Reading this attribute indicates the output function of the source for the specified SMU channel. Setting this attribute configures the specified SMU channel as either a voltage source or a current source.

  • Page 501: Smux.source.levely

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference smuX.source.levelY This attribute sets the source level. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) SMU reset Saved setup Instrument reset Recall setup Usage sourceLevel = smuX.source.levelY smuX.source.levelY = sourceLevel...

  • Page 502: Smux.source.limity

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual smuX.source.limitY This attribute sets compliance limits. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) SMU reset Saved setup Limit voltage: 20 (20 V) Instrument reset Limit current: 1 (1 A)

  • Page 503: Smux.source.lowrangey

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference smuX.source.lowrangeY This attribute sets the lowest source range that is used during autoranging. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Yes SMU reset Saved setup...

  • Page 504: Smux.source.offfunc

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual smuX.source.offfunc This attribute sets the source function that is used (source 0 A or 0 V) when the output is turned off and the source-measure unit (SMU) is in normal output-off mode.

  • Page 505: Smux.source.offmode

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Usage sourceLimit = smuX.source.offlimitY smuX.source.offlimitY = sourceLimit sourceLimit Set to the limit to be used when the SMU is in normal output-off mode Source-measure unit (SMU) channel (for example, smua.source.offlimiti...

  • Page 506: Smux.source.output

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual The default sourceOffMode is smuX.OUTPUT_NORMAL. In this mode, the source function is configured according to the smuX.source.offfunc attribute. The smuX.source.offfunc attribute controls whether the SMU is configured as a 0 V voltage source or a 0 A current source.

  • Page 507: Smux.source.outputenableaction

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Setting this attribute to smuX.OUTPUT_HIGH_Z causes the output to turn off and go to the High Z mode. If the smuX.source.output is read after setting this attribute to smuX.OUTPUT_HIGH_Z, it returns 0.

  • Page 508: Smux.source.rangey

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual Also see smuX.source.offmode (on page 7-221) smuX.source.output (on page 7-222) smuX.source.rangeY This attribute contains the source range. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) SMU reset...

  • Page 509: Smux.source.settling

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference smuX.source.settling This attribute contains the source settling mode. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) SMU reset Not saved 0 (smuX.SETTLE_SMOOTH) Instrument reset Recall setup Usage settleOption = smuX.source.settling...

  • Page 510: Smux.trigger.arm.count

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual smuX.trigger.arm.count This attribute sets the arm count in the trigger model. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) SMU reset Not saved Instrument reset Recall setup Usage triggerArmCount = smuX.trigger.arm.count...

  • Page 511: Smux.trigger.arm.stimulus

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Example smua.trigger.arm.set() Sets the arm event detector to the detected state for SMU channel A. Also see smuX.trigger.initiate() (on page 7-234) smuX.trigger.measure.set() (on page 7-236) smuX.trigger.source.set() (on page 7-246) smuX.trigger.arm.stimulus...
  • Page 512 Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual Trigger event IDs* Event ID Event description smuX.trigger.SWEEPING_EVENT_ID Occurs when the source-measure unit (SMU) transitions from the idle state to the arm layer of the trigger model smuX.trigger.ARMED_EVENT_ID Occurs when the SMU moves from the arm layer to the trigger layer of the trigger model smuX.trigger.SOURCE_COMPLETE_EVENT_ID...

  • Page 513: Smux.trigger.armed_Event_Id

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference smuX.trigger.ARMED_EVENT_ID This constant contains the armed event number. Type TSP-Link accessible Affected by Where saved Default value Constant Usage eventID = smuX.trigger.ARMED_EVENT_ID eventID The armed event number Source-measure unit (SMU) channel (for example, smua.trigger.ARMED_EVENT_ID applies to SMU channel A)

  • Page 514: Smux.trigger.count

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual The overrun statuses of the event detectors are not automatically cleared when the SMU transitions from the arm layer to the trigger layer. The event detectors are always cleared when a sweep is initiated.

  • Page 515: Smux.trigger.endpulse.set()

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Details When set to smuX.SOURCE_HOLD, this attribute disables pulse mode sweeps, holding the source level for the remainder of the step. When set to smuX.SOURCE_IDLE, this attribute enables pulse mode sweeps, setting the source level to the programmed (idle) level at the end of the pulse.

  • Page 516: Smux.trigger.endpulse.stimulus

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual smuX.trigger.endpulse.stimulus This attribute defines which event will cause the end pulse event detector to enter the detected state. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW)

  • Page 517: Smux.trigger.endsweep.action

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Trigger event IDs* Event ID Event description trigger.timer[N].EVENT_ID Occurs when a delay expires trigger.generator[N].EVENT_ID Occurs when the trigger.generator[N].assert() function is executed * Use the name of the trigger event ID to set the stimulus value rather than the numeric value. Using the name makes the code compatible for future upgrades (for example, if the numeric values must change when enhancements are added to the instrument).

  • Page 518: Smux.trigger.idle_Event_Id

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual smuX.trigger.IDLE_EVENT_ID This constant contains the idle event number. Type TSP-Link accessible Affected by Where saved Default value Constant Usage eventID = smuX.trigger.IDLE_EVENT_ID The idle event number eventID Source-measure unit (SMU) channel (for example, smua.trigger.IDLE_EVENT_ID applies to SMU channel A)

  • Page 519: Smux.trigger.measure.action

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference If you run this function more than once without reconfiguring the sweep measurements, the caches on the configured measurement reading buffers will hold stale data; use the bufferVar.clearcache() function to remove stale values from the reading buffer cache.

  • Page 520: Smux.trigger.measure.set()

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual If this attribute is set to smuX.ASYNC: • Asynchronous sweep measurements can only be used with measure autoranging turned off. To turn measure autoranging off for all measurements during the sweep, set the smuX.measure.autorangeY attribute to smuX.AUTORANGE_OFF.

  • Page 521: Smux.trigger.measure.stimulus

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference smuX.trigger.measure.stimulus This attribute selects the event that causes the measure event detector to enter the detected state. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) SMU reset...

  • Page 522: Smux.trigger.measure.y()

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual Trigger event IDs* Event ID Event description trigger.timer[N].EVENT_ID Occurs when a delay expires trigger.generator[N].EVENT_ID Occurs when the trigger.generator[N].assert() function is executed * Use the name of the trigger event ID to set the stimulus value rather than the numeric value. Using the name makes the code compatible for future upgrades (for example, if the numeric values must change when enhancements are added to the instrument).

  • Page 523: Smux.trigger.measure_Complete_Event_Id

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Example smua.trigger.measure.v(vbuffername) Stores voltage readings during the sweep for SMU channel A in buffer smua.trigger.measure.action = smua.ENABLE vbuffername. Also see Reading buffers (on page 3-5) smuX.measure.Y() (on page 7-207) smuX.nvbufferY...

  • Page 524: Smux.trigger.source.action

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual Details Set the stimulus of any trigger object to the value of this constant to have the trigger object respond to pulse complete events from this SMU. Also see...

  • Page 525: Smux.trigger.source.limity

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference smuX.trigger.source.limitY This attribute sets the sweep source limit. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) SMU reset Not saved 0 (smuX.LIMIT_AUTO) Instrument reset Recall setup Usage sweepSourceLimit = smuX.trigger.source.limitY...

  • Page 526: Smux.trigger.source.limity

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual smuX.trigger.source.limitY This attribute sets the sweep source limit. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) SMU reset Not saved 0 (smuX.LIMIT_AUTO) Instrument reset Recall setup Usage sweepSourceLimit = smuX.trigger.source.limitY...

  • Page 527: Smux.trigger.source.lineary()

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference smuX.trigger.source.linearY() This function configures a linear source sweep. Type TSP-Link accessible Affected by Where saved Default value Function Usage smuX.trigger.source.linearY(startValue, endValue, points) Source-measure unit (SMU) channel (for example, smua.trigger.source.linearv(0, 10, 11) applies to SMU channel A)

  • Page 528: Smux.trigger.source.listy()

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual Also see smuX.trigger.source.action (on page 7-240) smuX.trigger.source.listY() (on page 7-244) smuX.trigger.source.logY() (on page 7-245) Sweep Operation (on page 3-19) smuX.trigger.source.listY() This function configures an array-based source sweep. Type TSP-Link accessible...

  • Page 529: Smux.trigger.source.logy()

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference smuX.trigger.source.logY() This function configures an exponential (geometric) source sweep. Type TSP-Link accessible Affected by Where saved Default value Function Usage smuX.trigger.source.logY(startValue, endValue, points, asymptote) Source-measure unit (SMU) channel (for example, smua.trigger.source.logv(1,...

  • Page 530: Smux.trigger.source.set()

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual The SMU stores only the most recent configured source action. The last call to smuX.trigger.source.linearY(), smuX.trigger.source.listY(), or smuX.trigger.source.logY() is used for the source action. Source functions cannot be changed within a sweep.

  • Page 531: Smux.trigger.source.stimulus

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference smuX.trigger.source.stimulus This attribute defines which event causes the source event detector to enter the detected state. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) SMU reset...

  • Page 532: Smux.trigger.source_Complete_Event_Id

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual Trigger event IDs* Event ID Event description trigger.blender[N].EVENT_ID Occurs after a collection of events is detected trigger.timer[N].EVENT_ID Occurs when a delay expires trigger.generator[N].EVENT_ID Occurs when the trigger.generator[N].assert() function is executed * Use the name of the trigger event ID to set the stimulus value rather than the numeric value.

  • Page 533: Smux.trigger.sweep_Complete_Event_Id

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference smuX.trigger.SWEEP_COMPLETE_EVENT_ID This constant contains the sweep complete event number. Type TSP-Link accessible Affected by Where saved Default value Constant Usage eventID = smuX.trigger.SWEEP_COMPLETE_EVENT_ID The sweep complete event number eventID Source-measure unit (SMU) channel (for example, smua.trigger.SWEEP_COMPLETE_EVENT_ID applies to SMU channel A)

  • Page 534: Status.condition

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual status.condition This attribute stores the status byte condition register. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Not applicable Not saved Not applicable Usage statusByte = status.condition statusByte The status byte;...
  • Page 535 2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Value Description status.MASTER_SUMMARY_STATUS Request Service (RQS)/Master Summary Status (MSS). Depending on how it is used, bit B6 of the status.MSS status byte register is either the Request for Service (RQS) bit or the Master Summary Status (MSS) bit: ...

  • Page 536: Status.measurement.*

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual status.measurement.* This attribute contains the measurement event register set. Type TSP-Link accessible Affected by Where saved Default value Attribute .condition (R) Not applicable Not saved Not applicable .enable (RW)
  • Page 537 2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Value Description Set bit is a summary of the status.measurement.VOLTAGE_LIMIT status.measurement.voltage_limit status.measurement.VLMT register. Bit B0 decimal value: 1 Set bit is a summary of the status.measurement.CURRENT_LIMIT status.measurement.current_limit status.measurement.ILMT register.

  • Page 538: Status.measurement.buffer_Available.*

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual Also see Measurement event registers (on page E-21) status.measurement.buffer_available.* This attribute contains the measurement event buffer available summary register set. Type TSP-Link accessible Affected by Where saved Default value Attribute .condition (R)

  • Page 539: Status.measurement.current_Limit.*

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference As an example, to set bit B1 of the measurement event buffer available summary enable register, set status.measurement.buffer_available.enable = status.measurement.buffer_available.SMUA. In addition to the above constants, measurementRegister can be set to the decimal equivalent of the bit to set.
  • Page 540 Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents (on page E-1) and Enable and transition registers (on page E-16). The individual bits of this register are defined in the following table.

  • Page 541: Status.measurement.instrument.*

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference status.measurement.instrument.* This attribute contains the registers of the measurement event instrument summary register set. Type TSP-Link accessible Affected by Where saved Default value Attribute .condition (R) Not applicable Not saved Not applicable .enable (RW)

  • Page 542: Status.measurement.instrument.smux.*

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual As an example, to set bit B1 of the measurement event instrument summary enable register, set status.measurement.instrument.enable = status.measurement.instrument.SMUA. In addition to the above constants, measurementRegister can be set to the decimal equivalent of the bit to set.
  • Page 543 2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference > > > > > > > > > > > > > > * Least significant bit ** Most significant bit For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to...

  • Page 544: Status.measurement.reading_Overflow.*

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual Binary value Decimal Weights Binary value 32,768 16,384 8,192 4,096 2,048 1,024 Decimal Weights Example status.measurement.instrument.smua.enable = status.measurement.instrument.smua.VLMT Sets the VLMT bit of the measurement event SMU A summary enable register using a constant.
  • Page 545 2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Usage measurementRegister = status.measurement.reading_overflow.condition measurementRegister = status.measurement.reading_overflow.enable measurementRegister = status.measurement.reading_overflow.event measurementRegister = status.measurement.reading_overflow.ntr measurementRegister = status.measurement.reading_overflow.ptr status.measurement.reading_overflow.enable = measurementRegister status.measurement.reading_overflow.ntr = measurementRegister status.measurement.reading_overflow.ptr = measurementRegister measurementRegister The status of the measurement reading overflow summary register; a zero (0) indicates no bits set (also send 0 to clear all bits);...

  • Page 546: Status.measurement.voltage_Limit.*

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual Also see Measurement event registers (on page E-21) status.measurement.voltage_limit.* This attribute contains the measurement event voltage limit summary register set. Type TSP-Link accessible Affected by Where saved Default value Attribute .condition (R)

  • Page 547: Status.node_Enable

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference As an example, to set bit B1 of the measurement event voltage limit summary enable register, set status.measurement.voltage_limit.enable = status.measurement.voltage_limit.SMUA. In addition to the above constants, measurementRegister can be set to the decimal equivalent of the bit to set.
  • Page 548 Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual Value Description status.MEASUREMENT_SUMMARY_BIT Set summary bit indicates that an enabled status.MSB measurement event has occurred. Bit B0 decimal value: 1 Not used Not applicable. status.ERROR_AVAILABLE Set summary bit indicates that an error or status status.EAV...

  • Page 549: Status.node_Event

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP 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 status of the node event register;...

  • Page 550: Status.operation.*

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual In addition to the above constants, nodeEventRegister can be set to the decimal equivalent of the bits set. When more than one bit of the register is set, nodeEventRegister contains the sum of their decimal weights.
  • Page 551 2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Reading a status register returns a value. The binary equivalent of the returned value indicates which register bits are set. The least significant bit of the binary number is bit B0, and the most significant bit is bit B15.

  • Page 552: Status.operation.calibrating.*

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual As an example, to set bit B12 of the operation status enable register, set status.operation.enable = status.operation.USER. In addition to the above constants, operationRegister can be set to the numeric equivalent of the bit to set.
  • Page 553 2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Usage operationRegister = status.operation.calibrating.condition operationRegister = status.operation.calibrating.enable operationRegister = status.operation.calibrating.event operationRegister = status.operation.calibrating.ntr operationRegister = status.operation.calibrating.ptr status.operation.calibrating.enable = operationRegister status.operation.calibrating.ntr = operationRegister status.operation.calibrating.ptr = operationRegister operationRegister The status of the operation calibrating event register; a zero (0) indicates no bits set (also send 0 to clear all bits);...

  • Page 554: Status.operation.instrument.*

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual status.operation.instrument.* This attribute contains the operation status instrument summary register set. Type TSP-Link accessible Affected by Where saved Default value Attribute .condition (R) Not applicable Not saved Not applicable .enable (RW)
  • Page 555 2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Value Description Not used Not applicable. status.operation.instrument.SMUA Set bit indicates one or more enabled bits for the operation status SMU A summary register is set. Bit B1 decimal value: 2 status.operation.instrument.SMUB...

  • Page 556: Status.operation.instrument.digio.*

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual Binary value Decimal Weights Binary value 32,768 16,384 8,192 4,096 2,048 1,024 Decimal Weights Example 1 operationRegister = status.operation.instrument.SMUA + status.operation.instrument.TRGBLND status.operation.instrument.enable = operationRegister Sets bit B1 and bit B10 of the operation status instrument summary enable register using constants.
  • Page 557 2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Usage operationRegister = status.operation.instrument.digio.condition operationRegister = status.operation.instrument.digio.enable operationRegister = status.operation.instrument.digio.event operationRegister = status.operation.instrument.digio.ntr operationRegister = status.operation.instrument.digio.ptr status.operation.instrument.digio.enable = operationRegister status.operation.instrument.digio.ntr = operationRegister status.operation.instrument.digio.ptr = operationRegister operationRegister The status of the operation status digital I/O summary register; a zero (0) indicates no bits set (also send 0 to clear all bits);...

  • Page 558: Status.operation.instrument.digio.trigger_Overrun.*

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual status.operation.instrument.digio.trigger_overrun.* This attribute contains the operation status digital I/O overrun register set. Type TSP-Link accessible Affected by Where saved Default value Attribute .condition (R) Not applicable Not saved Not applicable .enable (RW)
  • Page 559 2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Value Decimal value Not used Not applicable status.operation.instrument.digio.trigger_overrun.LINE1 status.operation.instrument.digio.trigger_overrun.LINE2 status.operation.instrument.digio.trigger_overrun.LINE3 status.operation.instrument.digio.trigger_overrun.LINE4 status.operation.instrument.digio.trigger_overrun.LINE5 status.operation.instrument.digio.trigger_overrun.LINE6 status.operation.instrument.digio.trigger_overrun.LINE7 status.operation.instrument.digio.trigger_overrun.LINE8 status.operation.instrument.digio.trigger_overrun.LINE9 status.operation.instrument.digio.trigger_overrun.LINE10 1,024 status.operation.instrument.digio.trigger_overrun.LINE11 2,048 status.operation.instrument.digio.trigger_overrun.LINE12 4,096 8,192 status.operation.instrument.digio.trigger_overrun.LINE13 status.operation.instrument.digio.trigger_overrun.LINE14 16,384 Not used Not applicable As an example, to set bit B1 of the operation status digital I/O overrun enable register, set status.operation.instrument.digio.trigger_overrun.enable =...

  • Page 560: Status.operation.instrument.lan.*

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual Binary value Decimal Weights Binary value 32,768 16,384 8,192 4,096 2,048 1,024 Decimal Weights Example 1 operationRegister = status.operation.instrument.digio.trigger_overrun.LINE1 + status.operation.instrument.digio.trigger_overrun.LINE10 status.operation.instrument.digio.trigger_overrun.enable = operationRegister Uses constants to set bit B1 and bit B10 of the operation status digital I/O overrun enable register.
  • Page 561 2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Details These attributes are used to read or write to the operation status LAN summary registers. The binary equivalent of the value indicates which register bits are set. In the binary equivalent, the least significant bit is bit B0, and the most significant bit is bit B15.

  • Page 562: Status.operation.instrument.lan.trigger_Overrun.*

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual Binary value Decimal Weights Binary value 32,768 16,384 8,192 4,096 2,048 1,024 Decimal Weights Example operationRegister = status.operation.instrument.lan.CONF + status.operation.instrument.lan.TRGOVR status.operation.instrument.lan.enable = operationRegister Use constants to set bit B1 and bit B10 of the operation status LAN summary enable register.
  • Page 563 2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Details These attributes are used to read or write to the operation status LAN trigger overrun registers. Reading a status register returns a value. The binary equivalent of the returned value indicates which register bits are set.

  • Page 564: Status.operation.instrument.smux.*

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual Binary value Decimal Weights Binary value 32,768 16,384 8,192 4,096 2,048 1,024 Decimal Weights Example operationRegister = status.operation.instrument.lan.trigger_overrun.LAN1 + status.operation.instrument.lan.trigger_overrun.LAN8 status.operation.instrument.lan.trigger_overrun.enable = operationRegister Use constants to set bit B1 and bit B8 of the operation status LAN trigger overrun enable register.
  • Page 565 2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Details These attributes are used to read or write to the operation status SMU X summary registers. Reading a status register returns a value. The binary equivalent of the returned value indicates which register bits are set.

  • Page 566: Status.operation.instrument.smux.trigger_Overrrun.*

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual As an example, to set bit B0 of the operation status SMU A summary enable register, set status.operation.instrument.smua.enable = status.operation.instrument.smua.C In addition to the above constants, operationRegister can be set to the numeric equivalent of the bit to set.
  • Page 567 2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Usage operationRegister = status.operation.instrument.smuX.trigger_overrun.condition operationRegister = status.operation.instrument.smuX.trigger_overrun.enable operationRegister = status.operation.instrument.smuX.trigger_overrun.event operationRegister = status.operation.instrument.smuX.trigger_overrun.ntr operationRegister = status.operation.instrument.smuX.trigger_overrun.ptr status.operation.instrument.smuX.trigger_overrun.enable = operationRegister status.operation.instrument.smuX.trigger_overrun.ntr = operationRegister status.operation.instrument.smuX.trigger_overrun.ptr = operationRegister operationRegister The status of the operation status SMU X trigger overrun register; a zero (0) indicates no bits set (also send 0 to clear all bits);...
  • Page 568 Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual Value Description status.operation.instrument.smuX.trigger_overrun.MEAS Set bit indicates that the measurement event detector of the SMU was already in the detected state when a trigger was received. Bit B3 decimal value: 8 status.operation.instrument.smuX.trigger_overrun.ENDP Set bit indicates that the...

  • Page 569: Status.operation.instrument.trigger_Blender.*

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference status.operation.instrument.trigger_blender.* This attribute contains the operation status trigger blender summary register set. Type TSP-Link accessible Affected by Where saved Default value Attribute .condition (R) Not applicable Not saved Not applicable .enable (RW)

  • Page 570: Status.operation.instrument.trigger_Blender.trigger_Overrun.*

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual In addition to the above constants, operationRegister can be set to the numeric equivalent of the bit to set. For example, to set bit B10, set operationRegister to 1024.
  • Page 571 2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference > > > > > > > > > > > > > > * Least significant bit ** Most significant bit A set bit value indicates that the specified trigger blender generated an action overrun.

  • Page 572: Status.operation.instrument.trigger_Timer.*

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual Example status.operation.instrument.trigger_blender.trigger_overrun.enable = status.operation.instrument.trigger_blender.trigger_overrun.BLND1 Uses a constant to set the bit for blender 1 of the operation status trigger blender overrun enable register. Also see Operation Status Registers (on page E-7) status.operation.instrument.trigger_blender.*...

  • Page 573: Status.operation.instrument.trigger_Timer.trigger_Overrun.*

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Value Description Not used Not applicable B0-B9 status.operation.instrument.trigger_timer.TRIGGER_OVERRUN Set bit indicates one or more status.operation.instrument.trigger_timer.TRGOVR enabled bits for the operation status trigger timer overrun register is set. Bit B10 decimal...
  • Page 574 Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual Usage operationRegister = status.operation.instrument.trigger_timer.trigger_overrun.condition operationRegister = status.operation.instrument.trigger_timer.trigger_overrun.enable operationRegister = status.operation.instrument.trigger_timer.trigger_overrun.event operationRegister = status.operation.instrument.trigger_timer.trigger_overrun.ntr operationRegister = status.operation.instrument.trigger_timer.trigger_overrun.ptr status.operation.instrument.trigger_timer.trigger_overrun.enable = operationRegister status.operation.instrument.trigger_timer.trigger_overrun.ntr = operationRegister status.operation.instrument.trigger_timer.trigger_overrun.ptr = operationRegister operationRegister The status of the operation status trigger timer trigger overrun register; a zero (0) indicates no bits set (also send 0 to clear all bits);...
  • Page 575 2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Value Decimal value Not used applicable status.operation.instrument.trigger_timer.trigger_overrun.TMR1 status.operation.instrument.trigger_timer.trigger_overrun.TMR2 status.operation.instrument.trigger_timer.trigger_overrun.TMR3 status.operation.instrument.trigger_timer.trigger_overrun.TMR4 status.operation.instrument.trigger_timer.trigger_overrun.TMR5 status.operation.instrument.trigger_timer.trigger_overrun.TMR6 status.operation.instrument.trigger_timer.trigger_overrun.TMR7 status.operation.instrument.trigger_timer.trigger_overrun.TMR8 Not used B9-B15 applicable As an example, to set bit B1 of the operation status trigger timer trigger overrun enable register, set status.operation.instrument.trigger_timer.trigger_overrun.enable =...

  • Page 576: Status.operation.instrument.tsplink.*

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual status.operation.instrument.tsplink.* This attribute contains the operation status TSP-Link summary register set. Type TSP-Link accessible Affected by Where saved Default value Attribute .condition (R) Not applicable Not saved Not applicable .enable (RW)

  • Page 577: Status.operation.instrument.tsplink.trigger_Overrun.*

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Example Uses a decimal value to set status.operation.instrument.tsplink.enable = 1024 the trigger overrun bit of the operation status TSP-Link summary enable register. Also see Operation Status Registers (on page E-7) status.operation.instrument.tsplink.trigger_overrun.*...
  • Page 578 Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents (on page E-1) and Enable and transition registers (on page E-16). The individual bits of this register are defined in the following table.

  • Page 579: Status.operation.measuring.*

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference status.operation.measuring.* This attribute contains the operation status measuring summary register set. Type TSP-Link accessible Affected by Where saved Default value Attribute .condition (R) Not applicable Not saved Not applicable .enable (RW)

  • Page 580: Status.operation.remote.*

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual As an example, to set bit B1 of the operation status measuring summary enable register, set status.operation.measuring.enable = status.operation.measuring.SMUA. In addition to the above constants, operationRegister can be set to the numeric equivalent of the bit to set.

  • Page 581: Status.operation.sweeping.*

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Value Description Not used Not applicable. status.operation.remote.COMMAND_AVAILABLE Set bit indicates there is a command available in the execution queue. status.operation.remote.CAV Bit B1 decimal value: 2 Binary value: 0000 0000 0000 0010 Not used Not applicable.
  • Page 582 Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual Usage operationRegister = status.operation.sweeping.condition operationRegister = status.operation.sweeping.enable operationRegister = status.operation.sweeping.event operationRegister = status.operation.sweeping.ntr operationRegister = status.operation.sweeping.ptr status.operation.sweeping.enable = operationRegister status.operation.sweeping.ntr = operationRegister status.operation.sweeping.ptr = operationRegister operationRegister The status of the operation status sweeping summary register; a zero (0) indicates no bits set (also send 0 to clear all bits);...

  • Page 583: Status.operation.trigger_Overrun.*

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference status.operation.trigger_overrun.* This attribute contains the operation status trigger overrun summary register set. Type TSP-Link accessible Affected by Where saved Default value Attribute .condition (R) Not applicable Not saved Not applicable .enable (RW)
  • Page 584 Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual Value Description Not used Not applicable. status.operation.trigger_overrun.SMUA Set bit indicates one of the enabled bits in the operation status SMU A trigger overrun event register is set. Bit B1 decimal value: 2 Set bit indicates one of the status.operation.trigger_overrun.SMUB...

  • Page 585: Status.operation.user.*

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Binary value Decimal Weights Binary value 32,768 16,384 8,192 4,096 2,048 1,024 Decimal Weights Example operationRegister = status.operation.trigger_overrun.SMUA + status.operation.trigger_overrun.TRGBLND status.operation.trigger_overrun.enable = operationRegister Uses constants to set bit B1 and bit B10 of the operation status trigger overrun summary enable register.
  • Page 586 Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual Details These attributes are used to read or write to the operation status user registers. Reading a status register returns a value. The binary equivalent of the value indicates which register bits are set. In the binary equivalent, the least significant bit is bit B0, and the most significant bit is bit B15.

  • Page 587: Status.questionable.*

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Binary value Decimal Weights Binary value 32,768 16,384 8,192 4,096 2,048 1,024 Decimal Weights Example 1 operationRegister = status.operation.user.BIT11 + Uses constants to set bits B11 and B14 of the operation status user enable status.operation.user.BIT14...
  • Page 588 Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual Details These attributes are used to read or write to the questionable status registers. Reading a status register returns a value. In the binary equivalent, the least significant bit is bit B0, and the most significant bit is bit B15.

  • Page 589: Status.questionable.*

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference In addition to the above constants, questionableRegister can be set to the numeric equivalent of the bit to set. To set more than one bit of the register, set questionableRegister to the sum of their decimal weights.
  • Page 590 Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual Details These attributes are used to read or write to the questionable status registers. Reading a status register returns a value. In the binary equivalent, the least significant bit is bit B0, and the most significant bit is bit B15.

  • Page 591: Status.questionable.calibration.*

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Binary value Decimal Weights Binary value 32,768 16,384 8,192 4,096 2,048 1,024 Decimal Weights Example status.questionable.enable = status.questionable.OTEMP Uses a constant to set the OTEMP bit of the questionable status enable register.

  • Page 592: Status.questionable.instrument.*

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents (on page E-1) and Enable and transition registers (on page E-16). The individual bits of this register are defined in the following table.
  • Page 593 2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Usage questionableRegister = status.questionable.instrument.condition questionableRegister = status.questionable.instrument.enable questionableRegister = status.questionable.instrument.event questionableRegister = status.questionable.instrument.ntr questionableRegister = status.questionable.instrument.ptr status.questionable.instrument.enable = questionableRegister status.questionable.instrument.ntr = questionableRegister status.questionable.instrument.ptr = questionableRegister questionableRegister The status of the questionable status instrument summary register; a zero (0) indicates no bits set (also send 0 to clear all bits);...

  • Page 594: Status.questionable.instrument.smux.*

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual status.questionable.instrument.smuX.* This attribute contains the questionable status SMU X summary register set. Type TSP-Link accessible Affected by Where saved Default value Attribute .condition (R) Not applicable Not saved Not applicable .enable (RW)
  • Page 595 2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Value Description Not used Not applicable. B0-B7 status.questionable.instrument.smuX.CALIBRATION Set bit indicates that the calibration constants status.questionable.instrument.smuX.CAL stored in nonvolatile memory were corrupted and could not be loaded when the instrument powered up.

  • Page 596: Status.questionable.over_Temperature.*

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual status.questionable.over_temperature.* This attribute contains the questionable status over temperature summary register set. Type TSP-Link accessible Affected by Where saved Default value Attribute .condition (R) Not applicable Not saved Not applicable .enable (RW)

  • Page 597: Status.questionable.unstable_Output.*

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference In addition to the above constants, questionableRegister can be set to the numeric equivalent of the bit to set. To set more than one bit of the register, set operationRegister to the sum of their decimal weights.

  • Page 598: Status.request_Enable

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual Value Description Not used Not applicable. status.questionable.unstable_output.SMUA Set bit indicates that an unstable output condition was detected on SMU A. Bit B1 decimal value: 2 Binary value: 0000 0010 status.questionable.unstable_output.SMUB...
  • Page 599 2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference > > > > > > * Least significant bit ** Most significant bit For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set...

  • Page 600: Status.request_Event

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual Example 1 requestSRQEnableRegister = status.MSB + status.OSB status.request_enable = requestSRQEnableRegister Uses constants to set the MSB and OSB bits of the service request (SRQ) enable register. Example 2 -- decimal 129 = binary 10000001 requestSRQEnableRegister = 129 status.request_enable = requestSRQEnableRegister...
  • Page 601 2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Value Description status.MEASUREMENT_SUMMARY_BIT Set summary bit indicates that an enabled event in the Measurement Event Register has occurred. status.MSB Bit B0 decimal value: 1 status.SYSTEM_SUMMARY_BIT Set summary bit indicates that an enabled event in the System Summary Register has occurred.

  • Page 602: Status.reset()

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual status.reset() This function resets all bits in the status model. Type TSP-Link accessible Affected by Where saved Default value Function Usage status.reset() Details This function clears all status data structure registers (enable, event, NTR, and PTR) to their default values.

  • Page 603: Queues

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Details These attributes are used to read or write to the standard event status registers. Reading a status register returns a value. The binary equivalent of the returned value indicates which register bits are set.
  • Page 604 Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual Value Description status.standard.COMMAND_ERROR Set bit indicates that a command error has occurred. Command errors include: status.standard.CME IEEE Std 488.2 syntax error: Instrument received a message that does not follow the defined syntax of the IEEE Std 488.2...

  • Page 605: Status.system.*

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference status.system.* ® These attributes manage the TSP-Link system summary register of the status model for nodes 1 through 14. Type TSP-Link accessible Affected by Where saved Default value Attribute .condition (R)
  • Page 606 Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual Value Description Bit B0 decimal value: 1 status.system.EXTENSION_BIT status.system.EXT status.system.NODE1 Bit B1 decimal value: 2 status.system.NODE2 Bit B2 decimal value: 4 Bit B3 decimal value: 8 status.system.NODE3 status.system.NODE4 Bit B4 decimal value: 16 status.system.NODE5...

  • Page 607: Status.system2.*

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Example 2 -- decimal 18432 = binary 0100 1000 0000 0000 Uses a decimal value to set bits B11 and B14 of the system summary enable enableRegister = 18432 register.
  • Page 608 Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents (on page E-1) and Enable and transition registers (on page E-16). The individual bits of this register are defined in the following table.

  • Page 609: Status.system3.*

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Example 1 enableRegister = status.system2.NODE25 + status.system2.NODE28 status.system2.enable = enableRegister Uses constants to set bits B11 and B14 of the system summary 2 enable register. Example 2 -- decimal 18432 = binary 0100 1000 0000 0000 enableRegister = 18432 status.system2.enable = enableRegister...
  • Page 610 Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual > > > > > > > > > > > > > > * Least significant bit ** Most significant bit For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to...

  • Page 611: Status.system4.*

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Binary value Decimal Weights Binary value 32,768 16,384 8,192 4,096 2,048 1,024 Decimal Weights Example 1 enableRegister = status.system3.NODE39 + status.system3.NODE42 status.system3.enable = enableRegister Uses constants to set bits B11 and B14 of the system summary 3 enable register.
  • Page 612 Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual Details In an expanded system (TSP-Link), these attributes are used to read or write to the system summary registers. They are set using a constant or a numeric value, but are returned as a numeric value. The binary equivalent of the value indicates which register bits are set.

  • Page 613: Status.system5.*

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Binary value Decimal Weights Binary value 32,768 16,384 8,192 4,096 2,048 1,024 Decimal Weights Example 1 enableRegister = status.system4.NODE53 + status.system4.NODE56 status.system2.enable = enableRegister Uses constants to set bit B11 and bit B14 of the system summary 4 enable register.
  • Page 614 Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual Usage enableRegister = status.system5.condition enableRegister = status.system5.enable enableRegister = status.system5.event enableRegister = status.system5.ntr enableRegister = status.system5.ptr status.system5.enable = enableRegister status.system5.ntr = enableRegister status.system5.ptr = enableRegister enableRegister The status of the system summary 5 register; a zero (0) indicates no bits set; other...

  • Page 615: Sweepilinmeasurev()

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference In addition to the above constants, enableRegister can be set to the numeric equivalent of the bit to set. To set more than one bit of the register, set enableRegister to the sum of their decimal weights.

  • Page 616: Sweepilistmeasurev()

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual If all parameters are omitted when this function is called, this function is executed with the parameters set to the default values. Performs a linear current sweep with voltage measured at every step (point): 1.

  • Page 617: Sweepilogmeasurev()

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Details Data for voltage measurements, current source values, and timestamps are stored in smuX.nvbuffer1. If all parameters are omitted when this function is called, this function is executed with the parameters set to the default values.
  • Page 618 Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual Details Data for voltage measurements, current source values, and timestamps are stored in smuX.nvbuffer1. If all parameters are omitted when this function is called, this function is executed with the parameters set to the default values.

  • Page 619: Sweepvlinmeasurei()

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference SweepVLinMeasureI() This KISweep factory script function performs a linear voltage sweep with current measured at every step (point). Type TSP-Link accessible Affected by Where saved Default value Function Usage...

  • Page 620: Sweepvlistmeasurei()

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual SweepVListMeasureI() This KISweep factory script function performs a voltage list sweep with current measured at every step (point). Type TSP-Link accessible Affected by Where saved Default value Function Usage...

  • Page 621: Sweepvlogmeasurei()

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference SweepVLogMeasureI() This KISweep factory script function performs a logarithmic voltage sweep with current measured at every step (point). Type TSP-Link accessible Affected by Where saved Default value Function Usage...

  • Page 622: Timer.measure.t()

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual Figure 126: SweepVLogMeasureI() Example SweepVLogMeasureI(smua, 1, 10, This function performs a five-point logarithmic voltage sweep starting at 1 V and stopping at 10 V. Current is 0.001, 5) measured at every step (point) in the sweep after a 1 ms source settling period.

  • Page 623: Timer.reset()

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Example 1 timer.reset() Resets the timer and measures the time since the reset. -- (intervening code) time = timer.measure.t() Output: print(time) 1.469077e+01 The output will vary. The above output indicates that timer.measure.t() was executed 14.69077...

  • Page 624: Trigger.blender[N].Clear()

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual trigger.blender[N].clear() This function clears the blender event detector and resets the overrun indicator of blender N. Type TSP-Link accessible Affected by Where saved Default value Function Usage trigger.blender[N].clear() The blender number (up to six)

  • Page 625: Trigger.blender[N].Orenable

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference trigger.blender[N].orenable This attribute selects whether the blender performs OR operations or AND operations. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Instrument reset Not saved false (AND mode)

  • Page 626: Trigger.blender[N].Reset()

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual This command does not indicate if an overrun occurred in any other part of the trigger model or in any other trigger object that is monitoring the event. It also is not an indication of an action overrun.

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

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference trigger.blender[N].stimulus[M] This attribute specifies the events that trigger the blender. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Restore configuration Configuration script trigger.EVENT_NONE Instrument reset Power cycle...

  • Page 628: Trigger.blender[N].Wait()

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual Trigger event IDs* Event ID Event description trigger.blender[N].EVENT_ID Occurs after a collection of events is detected trigger.timer[N].EVENT_ID Occurs when a delay expires trigger.generator[N].EVENT_ID Occurs when the trigger.generator[N].assert() function is executed * Use the name of the trigger event ID to set the stimulus value rather than the numeric value.

  • Page 629: Trigger.clear()

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference 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. trigger.blender[1].stimulus[1] = digio.trigger[3].EVENT_ID trigger.blender[1].stimulus[2] = digio.trigger[5].EVENT_ID...

  • Page 630: Trigger.event_Id

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual trigger.EVENT_ID This constant contains the command interface trigger event number. Type TSP-Link accessible Affected by Where saved Default value Constant Usage eventID = trigger.EVENT_ID eventID The event ID for the command interface triggers...

  • Page 631: Trigger.generator[N].Event_Id

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference trigger.generator[N].EVENT_ID This constant identifies the trigger event generated by the trigger event generator. Type TSP-Link accessible Affected by Where saved Default value Constant Usage eventID = trigger.generator[N].EVENT_ID The trigger event number...

  • Page 632: Trigger.timer[N].Count

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual trigger.timer[N].count This attribute sets the number of events to generate each time the timer generates a trigger event. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW)

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

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Details Once the timer is enabled, each time the timer is triggered, it uses this delay period. Assigning a value to this attribute is equivalent to: trigger.timer[N].delaylist = {interval} This creates a delay list of one value.

  • Page 634: Trigger.timer[N].Event_Id

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual Also see trigger.timer[N].reset() (on page 7-352) trigger.timer[N].EVENT_ID This constant specifies the trigger timer event number. Type TSP-Link accessible Affected by Where saved Default value Constant Usage eventID = trigger.timer[N].EVENT_ID...

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

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference This is an indication of the state of the event detector built into the timer itself. It does not indicate if an overrun occurred in any other part of the trigger model or in any other construct that is monitoring the delay completion event.

  • Page 636: Trigger.timer[N].Reset()

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual trigger.timer[N].reset() This function resets some of the trigger timer settings to their factory defaults. Type TSP-Link accessible Affected by Where saved Default value Function Usage trigger.timer[N].reset() Trigger timer number (1 to 8) Details The trigger.timer[N].reset() function resets the following attributes to their factory defaults:...
  • Page 637 2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Details The eventID parameter may be one of the trigger event IDs shown in the following table. Trigger event IDs* Event ID Event description smuX.trigger.SWEEPING_EVENT_ID Occurs when the source-measure unit (SMU)

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

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual trigger.timer[N].wait() This function waits for a trigger. Type TSP-Link accessible Affected by Where saved Default value Function Usage triggered = trigger.timer[N].wait(timeout) Trigger detection indication triggered Trigger timer number (1 to 8)

  • Page 639: Tsplink.group

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference • A USBTMC TRIGGER message is received (USB only) • A VXI-11 device_trigger method is invoked (VXI-11 only) • A *TRG message is received If one or more of these trigger events were previously detected, this function returns immediately.

  • Page 640: Tsplink.master

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual tsplink.master This attribute reads the node number assigned to the master node. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Not applicable Not applicable Not applicable Usage masterNodeNumber = tsplink.master...

  • Page 641: Tsplink.readbit()

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference tsplink.readbit() This function reads the state of a TSP-Link synchronization line. Type TSP-Link accessible Affected by Where saved Default value Function Usage data = tsplink.readbit(N) The state of the synchronization line...

  • Page 642: Tsplink.reset()

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual Also see TSP-Link trigger lines (on page 3-83) tsplink.readbit() (on page 7-357) tsplink.writebit() (on page 7-367) tsplink.writeport() (on page 7-367) tsplink.reset() This function initializes (resets) all nodes (instruments) in the TSP-Link system.

  • Page 643: Tsplink.state

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference tsplink.state This attribute describes the TSP-Link online state. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Not applicable Not applicable Not applicable Usage state = tsplink.state...

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

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual tsplink.trigger[N].clear() This function clears the event detector for a LAN trigger. Type TSP-Link accessible Affected by Where saved Default value Function Usage tsplink.trigger[N].clear() The trigger line (1 to 3) to clear Details The trigger event detector enters the detected state when an event is detected.

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

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Also see None tsplink.trigger[N].mode This attribute defines the trigger operation and detection mode. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Instrument reset Not saved 0 (tsplink.TRIG_BYPASS)

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

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual When programmed to any mode except tsplink.TRIG_BYPASS, the output state of the I/O line is controlled by the trigger logic, and the user-specified output state of the line is ignored.

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

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Example print(tsplink.trigger[1].overrun) If an event was ignored, displays true; if an event was not ignored, displays false. Also see tsplink.trigger[N].assert() (on page 7-359) tsplink.trigger[N].clear() (on page 7-360) tsplink.trigger[N].mode (on page 7-361) tsplink.trigger[N].release()

  • Page 648: Tsplink.trigger[N].Reset()

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual Details Releases a trigger that was asserted with an indefinite pulse width. It also releases a trigger that was latched in response to receiving a synchronous mode trigger. Example tsplink.trigger[3].release()

  • Page 649: Tsplink.trigger[N].Stimulus

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference tsplink.trigger[N].stimulus This attribute specifies the event that causes the synchronization line to assert a trigger. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Instrument reset Not saved...

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

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual Trigger event IDs* Event ID Event description trigger.blender[N].EVENT_ID Occurs after a collection of events is detected trigger.timer[N].EVENT_ID Occurs when a delay expires trigger.generator[N].EVENT_ID Occurs when the trigger.generator[N].assert() function is executed * Use the name of the trigger event ID to set the stimulus value rather than the numeric value.

  • Page 651: Tsplink.writebit()

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference tsplink.writebit() This function sets a TSP-Link trigger line high or low. Type TSP-Link accessible Affected by Where saved Default value Function Usage tsplink.writebit(N, data) The trigger line (1 to 3)

  • Page 652: Tsplink.writeprotect

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual 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. The reset() function does not affect the present states of the trigger lines.

  • Page 653: Tspnet.clear()

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference 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 654 TSP-enabled. If neither a portNumber nor an initString is provided, the remote device is assumed to be a Keithley Instruments TSP-enabled device. Depending on the state of the tspnet.tsp.abortonconnect attribute, the 2606B sends an abort command to the remote device on connection.

  • Page 655: Tspnet.disconnect()

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference tspnet.disconnect() This function disconnects a specified TSP-Net session. Type TSP-Link accessible Affected by Where saved Default value Function Usage tspnet.disconnect(connectionID) connectionID The connection ID returned from tspnet.connect() Details This function disconnects the two devices by closing the connection. The connectionID is the session handle returned by tspnet.connect().

  • Page 656: Tspnet.idn()

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual Details This command sends a command string to the remote instrument. A termination is added to the command string when it is sent to the remote instrument (tspnet.termination()). You can also specify a format string, which causes the command to wait for a response from the remote instrument.

  • Page 657: Tspnet.read()

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Example deviceID = tspnet.connect("192.0.2.1") Assume the instrument is at IP address 192.0.2.1. print(tspnet.idn(deviceID)) The output that is produced when you connect to the instrument and read the identification string may appear tspnet.disconnect(deviceID)

  • Page 658: Tspnet.readavailable()

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual When the 2606B reads from a TSP-enabled remote instrument, the 2606B removes Test Script ® Processor (TSP ) prompts and places any errors it receives from the remote instrument into its own error queue.

  • Page 659: Tspnet.reset()

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference tspnet.reset() This function disconnects all TSP-Net sessions. Type TSP-Link accessible Affected by Where saved Default value Function Usage tspnet.reset() Details This command disconnects all remote instruments connected through TSP-Net. For TSP-enabled devices, this causes any commands or scripts running remotely to be terminated.

  • Page 660: Tspnet.timeout

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual Example deviceID = tspnet.connect("192.0.2.1") Sets termination type for IP address 192.0.2.1 to TERM_LF. if deviceID then tspnet.termination(deviceID, tspnet.TERM_LF) Also see tspnet.connect() (on page 7-369) tspnet.disconnect() (on page 7-371) tspnet.timeout This attribute sets the timeout value for the tspnet.connect(), tspnet.execute(), and tspnet.read()

  • Page 661: Tspnet.tsp.abort()

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference tspnet.tsp.abort() This function causes the TSP-enabled instrument to stop executing any of the commands that were sent to it. Type TSP-Link accessible Affected by Where saved Default value Function Usage tspnet.tsp.abort(connectionID)

  • Page 662: Tspnet.tsp.rbtablecopy()

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual Example Configure the instrument so that it does not tspnet.tsp.abortonconnect = 0 send an abort command when connecting to a TSP-enabled instrument. Also see tspnet.connect() (on page 7-369) tspnet.tsp.rbtablecopy() This function copies a reading buffer synchronous table from a remote instrument to a TSP-enabled instrument.

  • Page 663: Tspnet.tsp.runscript()

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference tspnet.tsp.runscript() This function loads and runs a script on a remote TSP-enabled instrument. Type TSP-Link accessible Affected by Where saved Default value Function Usage tspnet.tsp.runscript(connectionID, script) tspnet.tsp.runscript(connectionID, name, script)

  • Page 664: Tspnet.write()

    Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual tspnet.write() This function writes a string to the remote instrument. Type TSP-Link accessible Affected by Where saved Default value Function Usage tspnet.write(connectionID, "inputString") connectionID The connection ID returned from tspnet.connect()

  • Page 665: Userstring.catalog()

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Use the userstring.get() function to retrieve the value associated with the specified name. You can use the userstring functions to store custom, instrument-specific information in the instrument, such as department number, asset number, or manufacturing plant location.

  • Page 666: Userstring.delete()

    Section 7: TSP command reference 2606B System SourceMeter® Instrument 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 user-defined string to delete Details This function deletes the string that is associated with name from nonvolatile memory.

  • Page 667: Waitcomplete()

    2606B System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Example userstring.add("assetnumber", "236") Create the user-defined string assetnumber, set to a value of 236. value = userstring.get("assetnumber") print(value) Read the value associated with the user- defined string named assetnumber.
  • Page 668 Section 7: TSP command reference 2606B System SourceMeter® Instrument Reference Manual Example 2 waitcomplete(G) Waits for all nodes in group G. Example 3 waitcomplete(0) Waits for all nodes on the TSP-Link network. Also see None 7-384 2606B-901-01 Rev. B / May 2018...

  • Page 669: Troubleshooting Guide

    Retrieving errors ............... 8-2 Error summary list ..............8-2 LAN troubleshooting suggestions ..........8-6 Introduction Troubleshooting information includes information on the Keithley Instruments 2606B errors (including a complete listing of error messages) and LAN troubleshooting suggestions. Error levels Error messages are listed in Error summary list (on page 8-2).

  • Page 670: Retrieving Errors

    Section 8: Troubleshooting guide 2606B System SourceMeter® Instrument Reference Manual Retrieving errors When errors occur, the error messages are placed in the error queue. Use errorqueue commands to request error message information. For example, the following commands request the complete set of information about the next message in the error queue.
  • Page 671 2606B System SourceMeter® Instrument Reference Manual Section 8: Troubleshooting guide Error summary Error number Error level Error message -105 RECOVERABLE Trigger not allowed -104 RECOVERABLE Data type error NO_SEVERITY Queue Is Empty RECOVERABLE Calibration overflow RECOVERABLE Reading buffer data lost...
  • Page 672 Section 8: Troubleshooting guide 2606B System SourceMeter® Instrument Reference Manual Error summary Error number Error level Error message RECOVERABLE Invalid bits setting 1503 1504 RECOVERABLE Invalid flow control setting 1700 RECOVERABLE Display area boundary exceeded 1800 RECOVERABLE Invalid digital trigger mode...
  • Page 673 2606B System SourceMeter® Instrument Reference Manual Section 8: Troubleshooting guide Error summary Error number Error level Error message 2414 RECOVERABLE TSPnet invalid reading buffer index range 2415 RECOVERABLE TSPnet feature only supported on TSP connections 2416 RECOVERABLE TSPnet must specify both port and init...

  • Page 674: Lan Troubleshooting Suggestions

    Section 8: Troubleshooting guide 2606B System SourceMeter® Instrument Reference Manual Error summary Error number Error level Error message 5044 RECOVERABLE Cannot perform requested operation while current measure autorange is enabled 5045 RECOVERABLE Cannot perform requested operation while filter is enabled...

  • Page 675: Frequently Asked Questions

    Section 9 Frequently asked questions In this section: How do I find the serial number? ..........9-1 How do I optimize performance? ..........9-1 How do I upgrade the firmware? ..........9-2 How do I use the digital I/O port? ..........9-2 How do I trigger other instruments? .........

  • Page 676: Disabling Autozero To Increase Speed

    Section 9: Frequently asked questions 2606B System SourceMeter® Instrument Reference Manual Disabling autozero to increase speed Disabling autozero (setting it to OFF) can increase measurement speed. If autozero is disabled, accuracy will drift with time and temperature. Turning autozero OFF will disable the autozero function and possibly increase measurement speed.

  • Page 677: How Do I Trigger Other Instruments?

    2606B System SourceMeter® Instrument Reference Manual Section 9: Frequently asked questions How do I trigger other instruments? You can use the 2606B digital input/output to control an external digital circuit, such as a device handler used to perform binning operations. For more information about the 2606B digital I/O port, Digital I/O (on page 3-78).

  • Page 678: How Do I Store Measurements In Nonvolatile Memory?

    Section 9: Frequently asked questions 2606B System SourceMeter® Instrument Reference Manual How do I store measurements in nonvolatile memory? After the measurements are complete, you can save the reading buffer data to the nonvolatile memory in the instrument. To save the reading buffer data: 1.

  • Page 679: Where Can I Get The Labview Driver?

    2606B System SourceMeter® Instrument Reference Manual Section 9: Frequently asked questions Where can I get the LabVIEW driver? The latest NI LabVIEW driver is available on tek.com/keithley. Why is the reading value 9.91e37? This value indicates that there is a measurement overflow error. This error occurs when: •...

  • Page 680: Additional 2606B Information

    Additional 2606B information For additional information about the 2606B, refer to the Keithley Instruments website (tek.com/keithley), which has the most up-to-date information. From the website, you can access: • The Low Level Measurements Handbook: Precision DC Current, Voltage, and Resistance Measurements •...
  • Page 681 Appendix A Maintenance In this appendix: Introduction ................A-1 Line fuse replacement .............. A-1 Upgrading the firmware ............A-2 Introduction The information in this section describes routine maintenance of the instrument that the operator can perform. It also contains information on how to optimize your measurements. Line fuse replacement Fuses on the 2606B rear panel protect the power line input of the instrument.
  • Page 682 You can upgrade the firmware using a USB flash drive on the virtual front panel, through the web interface, or using TSB. Upgrade files are available for download from the Keithley Downloads web page (https://www.tek.com/product-support). Disconnect the input terminals before you upgrade or downgrade.

  • Page 683: Using Tsb To Upgrade The Firmware

    8. After the instrument automatically restarts, it is ready for use. Using TSB to upgrade the firmware After downloading the new flash file from tek.com/keithley, you can use Test Script Builder (TSB) to upgrade the firmware of your 2606B. 1. If not already running, start Test Script Builder (on the computer desktop, double-click the icon for the Test Script Builder).

  • Page 685: Calibration

    (on page 5-1) for information on using commands to control the instrument. If the instrument is still under warranty and its performance is outside specified limits, contact your Keithley Instruments representative or the factory to determine the correct course of action.

  • Page 686: Verification Test Requirements

    Appendix B: Calibration 2606B System SourceMeter® Instrument Reference Manual Verification test requirements Be sure that you perform the verification tests: • Under the proper environmental conditions. • After the specified warm-up period. • Using the correct line voltage. • Using the proper test equipment.
  • Page 687 2606B System SourceMeter® Instrument Reference Manual Appendix B: Calibration Recommended verification equipment The following table summarizes recommended maximum allowable test equipment uncertainty for verification points. Total test equipment measurement uncertainty should meet or be less than the listed values at each test point. Generally, test equipment uncertainty should be at least four times better than corresponding 2606B specifications.

  • Page 688: Restoring Factory Defaults

    Appendix B: Calibration 2606B System SourceMeter® Instrument Reference Manual Verification limits The verification limits stated in this section have been calculated using only the 2606B one-year accuracy specifications, and they do not include test equipment uncertainty. If a particular measurement falls outside the allowable range, recalculate new limits based both on the 2606B specifications and corresponding test equipment specifications.
  • Page 689 Exceeding this value may cause a breakdown in insulation, creating a shock hazard that could result in personal injury or death. ® The input/output terminals of the 2606B System SourceMeter instrument SMUs are rated for connection to circuits rated Measurement Category I only, with transients rated less than 1500 V peak above the maximum rated input.

  • Page 690: Current Source Accuracy

    Appendix B: Calibration 2606B System SourceMeter® Instrument Reference Manual Current source accuracy To verify that the 2606B output current accuracy is within specified limits: 1. With the power off, connect the digital multimeter to the 2606B terminals as shown in the figure below.

  • Page 691: Current Measurement Accuracy

    2606B System SourceMeter® Instrument Reference Manual Appendix B: Calibration 2. Select the multimeter DC current measuring function. 3. Select the single-channel display mode. 4. Press the SRC key to source current and make sure the source output is turned on.
  • Page 692 Appendix B: Calibration 2606B System SourceMeter® Instrument Reference Manual 5. Verify measure current accuracy for each of the currents listed using the values listed in the following table for your model number. For each measurement:  Select the correct source range.

  • Page 693: Voltage Source Accuracy

    2606B System SourceMeter® Instrument Reference Manual Appendix B: Calibration Voltage source accuracy To perform this test, you will set the output voltage to each full-range value and measure the voltages with a precision digital multimeter. To verify that the 2606B output voltage accuracy is within specified limits: 1.

  • Page 694: Voltage Measurement Accuracy

    Appendix B: Calibration 2606B System SourceMeter® Instrument Reference Manual Voltage measurement accuracy To perform this test, you set the source voltage, as measured by a precision digital multimeter, and then verify that the 2606B voltage readings are within required limits.

  • Page 695: Environmental Conditions

    2606B System SourceMeter® Instrument Reference Manual Appendix B: Calibration Use the procedures in this section to calibrate the 2606B. These procedures require accurate test equipment to measure precise DC voltages and currents. The 2606B contains two independent SMU modules. Each module requires separate adjustment.
  • Page 696 Exceeding this value may cause a breakdown in insulation, creating a shock hazard that could result in personal injury or death. ® The input/output terminals of the 2606B System SourceMeter instrument SMUs are rated for connection to circuits rated Measurement Category I only, with transients rated less than 1500 V peak above the maximum rated input.

  • Page 697: Calibration Adjustment Overview

    2606B System SourceMeter® Instrument Reference Manual Appendix B: Calibration 0.5 Ω, 250 W, 0.1% 0.5 Ω: Isotek ±125 ppm Resistance Precision Resistor RUG-Z-R500-0.1-TK3 50 Ω Resistors (2) Any suitable 1 GΩ, 200 V, 1% 1 GΩ: Keithley Instruments ±250 ppm...
  • Page 698 Appendix B: Calibration 2606B System SourceMeter® Instrument Reference Manual Step sequence Adjustment steps must be performed in a specific sequence. See the following table that is specific table to your model. Note that all steps are performed using 2-wire (local sensing) except as noted.

  • Page 699: Calibration Commands Quick Reference

    2606B System SourceMeter® Instrument Reference Manual Appendix B: Calibration Calibration commands quick reference The following table summarizes remote calibration commands. For a more complete description of these commands, refer to the TSP command reference (on page 7-1). Calibration commands Description Command smuX.cal.adjustdate = adjustDate...

  • Page 700: Calibration Adjustment Procedure

    Appendix B: Calibration 2606B System SourceMeter® Instrument Reference Manual Calibration commands Command Description Adjust current source range calibration*: smuX.source.calibratei(range, cp1Expected, cp1Reference, ±range (source range to adjust). cp2Expected, cp2Reference) cp1Expected (source value programmed for calibration point 1). cp1Reference (reference measurement for calibration point 1).
  • Page 701 2606B System SourceMeter® Instrument Reference Manual Appendix B: Calibration Prepare the 2606B for calibration adjustment 1. Connect the 2606B to the controller using an appropriate interface cable. 2. Turn on the 2606B and the test equipment and allow them to warm up for at least two hours before performing calibration adjustment.
  • Page 702 Appendix B: Calibration 2606B System SourceMeter® Instrument Reference Manual 2. Select the multimeter DC volts function. 3. To initialize voltage calibration, send the following commands: smua.cal.unlock("KI0026XX") smua.reset() smua.source.func = smua.OUTPUT_DCVOLTS You do not need to set the measure range when following this procedure for calibration because the measure range is locked to the source range when measuring the source function.
  • Page 703 2606B System SourceMeter® Instrument Reference Manual Appendix B: Calibration src_FS = The +FS 2606B programmed source output value DMM_FS_rdg = The +FS DMM measurement Typical values for the 1 V range: smua.source.calibratev(1, 1e-30, 1e-5, 0.9, 0.903) 12. If this step is not on the CALA sense mode, send the measure calibration command using the multimeter and 2606B readings, and the range setting for the parameters.
  • Page 704 Appendix B: Calibration 2606B System SourceMeter® Instrument Reference Manual Typical values for the 1 V range: smua.source.calibratev(-1, -1e-30, -1e-4, -0.9, -0.896) 22. If this step is not on the CALA sense mode, send the measure calibration command using the multimeter and 2606B readings and range setting for the parameters: smua.measure.calibratev(-range, Z_rdg, DMM_Z_rdg, FS_rdg, DMM_FS_rdg)
  • Page 705 2606B System SourceMeter® Instrument Reference Manual Appendix B: Calibration It is not necessary to set the measure range when following this procedure for calibration because the measure range is locked to the source range when measuring the source function. Be sure to complete the steps for the 100 nA to 1 A ranges before continuing with 3 A calibration.
  • Page 706 Appendix B: Calibration 2606B System SourceMeter® Instrument Reference Manual Typical values for the 100 mA range: smua.source.calibratei(100e-3, 1e-30, 1e-5, 90e-3, 88e-3) 12. If this step is not on the CALA sense mode, send the measure calibration command using the multimeter and 2606B readings, and range setting for the parameters: smua.measure.calibratei(range, Z_rdg, DMM_Z_rdg, FS_rdg, DMM_FS_rdg)
  • Page 707 2606B System SourceMeter® Instrument Reference Manual Appendix B: Calibration Typical values for the 100 mA range: smua.source.calibratei(-100e-3, -1e-30, -1e-6, -90e-3, -89.2e-3) 22. If this step is not on the CALA sense mode, send the measure calibration command using the multimeter and 2606B readings, and range setting for the parameters: smua.measure.calibratei(-range, Z_rdg, DMM_Z_rdg, FS_rdg, DMM_FS_rdg)
  • Page 708 Appendix B: Calibration 2606B System SourceMeter® Instrument Reference Manual Contact check calibration adjustment 1. As illustrated in the following figure:  Short the 2606B SENSE LO and LO terminals together.  Short the SENSE HI and HI terminals together. Figure 137: Connections for contact check 0 ohm calibration 2.
  • Page 709 2606B System SourceMeter® Instrument Reference Manual Appendix B: Calibration 5. Allow the readings to settle, then get the 2606B readings: r50_hi, r50_lo = smua.contact.r() 6. Send the contact check low calibration adjustment command: smua.contact.calibratelo(r0_lo, Z_actual, r50_lo, 50_ohm_actual) Where: = 2606B 0 Ω low measurement r0_lo = Actual zero value;...
  • Page 710 Appendix B: Calibration 2606B System SourceMeter® Instrument Reference Manual If you do not wish to set a calibration date or calibration due date and want to clear the previous values, use the following commands: smua.cal.date = 0 smua.cal.due = 0 The actual year, month, day, and (optional) hour and minute should be used (seconds can be given but are essentially ignored due to the precision of the internal date storage format).

  • Page 711: Lan Concepts And Settings

    Appendix C LAN concepts and settings In this appendix: Overview ................. C-1 Install the crossover cable ............C-2 Connecting to the LAN ............C-2 Establishing a point-to-point connection ........C-5 LAN speeds ................C-6 Duplex mode ................C-7 Viewing LAN status messages ..........C-7 Viewing the network settings ...........

  • Page 712: Install The Crossover Cable

    Appendix C: LAN concepts and settings 2606B System SourceMeter® Instrument Reference Manual Install the crossover cable Use a LAN crossover cable (RJ-45, male to male) or a straight-through cable to connect your ® equipment. The 2606B includes a cable that you can use for the TSP-Link network or LAN communications.

  • Page 713: Set The Ip Address To Be Set Automatically

    2606B System SourceMeter® Instrument Reference Manual Appendix C: LAN concepts and settings Set the IP address to be set automatically When the TCP/IP configuration mode is set to Automatic, a DHCP server automatically sets the IP address, subnet mask, and the default gateway. To use this option, a DHCP server must be available on the network.

  • Page 714: Configuring The Domain Name System (Dns)

    Appendix C: LAN concepts and settings 2606B System SourceMeter® Instrument Reference Manual Configuring the domain name system (DNS) The domain name system (DNS) lets you type a domain name in the address bar to connect to the instrument. If you use DNS, you can use a name instead of an IP address.

  • Page 715: Establishing A Point-To-Point Connection

    2606B System SourceMeter® Instrument Reference Manual Appendix C: LAN concepts and settings Establishing a point-to-point connection To enable access to the instrument web page and other web applications from a computer, use a one-to-one LAN connection and set up a static IP address between the host computer and the instrument.

  • Page 716: Lan Speeds

    Appendix C: LAN concepts and settings 2606B System SourceMeter® Instrument Reference Manual 5. Enter the IP address using the LAN CONFIG menu: Select CONFIG > IP-ADDRESS. Enter the IP address. A portion of the computer's IP address is used as a base for the instrument's unique ID.

  • Page 717: Duplex Mode

    2606B System SourceMeter® Instrument Reference Manual Appendix C: LAN concepts and settings Duplex mode The duplex mode is based on the LAN configuration. There are two settings: • Half-duplex: Allows communications in both directions, but only one direction is active at a time (not simultaneously).

  • Page 718: Viewing The Network Settings

    Appendix C: LAN concepts and settings 2606B System SourceMeter® Instrument Reference Manual Viewing the network settings To view the active network settings: 1. From the virtual front panel, press the MENU key, and then select LAN > STATUS. 2. Use the navigation wheel to select one of the following network settings: ...

  • Page 719: Selecting A Lan Interface Protocol

    Raw socket connection 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. A programmer can easily communicate with the instrument using Winsock on Windows computers or Berkley sockets on Linux or Apple computers.

  • Page 720: Telnet Connection

    Appendix C: LAN concepts and settings 2606B System SourceMeter® Instrument Reference Manual Telnet connection The Telnet protocol is similar to raw socket, and can be used when you need to interact directly with the instrument. Telnet is often used for debugging and troubleshooting. You will need a separate Telnet program to use this protocol.
  • Page 721 2606B System SourceMeter® Instrument Reference Manual Appendix C: LAN concepts and settings The timestamp, event identifier, 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 722: Accessing The Event Log From The Command Interface

    Appendix C: LAN concepts and settings 2606B System SourceMeter® Instrument Reference Manual Accessing the event log from the command interface You can access the event log from any remote command interface. The event log must be enabled before LXI trigger events can be viewed. To enable the event log, send: eventlog.enable = 1...

  • Page 723: Common Commands

    Appendix D Common commands In this appendix: Command summary ..............D-1 Script command equivalents ........... D-3 Command reference ..............D-3 Command summary The IEEE Std 488.2 common commands that are supported by the 2606B are summarized in the following table. Although commands are shown in uppercase, common commands are not case sensitive, and either uppercase or lowercase can be used.
  • Page 724 Appendix D: Common commands 2606B System SourceMeter® Instrument Reference Manual Command Name Description Clear status Clears all event registers and Error Queue. For detailed *CLS information including status commands, see the Status model (on page 5-12, on page E-1). *ESE <mask>...

  • Page 725: Script Command Equivalents

    2606B System SourceMeter® Instrument Reference Manual Appendix D: Common commands Script command equivalents The TSP commands that can be included in scripts that are equivalent to the common commands are defined in the table below. Common Script command equivalent command *CLS status.reset()

  • Page 726: Operation Complete And Query: *Opc And *Opc?

    Appendix D: Common commands 2606B System SourceMeter® Instrument Reference Manual Operation complete and query: *OPC and *OPC? Wait for pending overlapped commands to complete. *OPC Operation complete command that sets the OPC bit *OPC? Operation complete query that places a "1" in the output queue...

  • Page 727: Status Register Set Contents

    Appendix E Status model In this appendix: Overview .................. E-1 Clearing registers ..............E-11 Programming and reading registers ........E-12 Status byte and service request (SRQ) ........E-13 Status register sets ..............E-16 TSP-Link system status ............E-22 Overview Each 2606B provides a number of status registers and queues that are collectively referred to as the status model.
  • Page 728 Appendix E: Status model 2606B System SourceMeter® Instrument Reference Manual Queues The 2606B uses queues to store messages. The queues include: • Command queue: Holds commands that are available for execution. • Output queue: Holds response messages. • Error queue: Holds error and status messages.

  • Page 729: Status Function Summary

    2606B System SourceMeter® Instrument Reference Manual Appendix E: Status model Status function summary The following functions and attributes control and read the various registers. Additional information for the various register sets is included later in this section. Also, refer to the specific command as listed TSP commands (on page 7-7).

  • Page 730: Status Model Diagrams

    Appendix E: Status model 2606B System SourceMeter® Instrument Reference Manual Status model diagrams The following figures graphically describe the status model: • Status byte and service request enable register (on page E-4) • System summary and standard event registers (on page E-6) •...
  • Page 731 2606B System SourceMeter® Instrument Reference Manual Appendix E: Status model Figure 142: Status byte and service request enable register 2606B-901-01 Rev. B / May 2018...
  • Page 732 Appendix E: Status model 2606B System SourceMeter® Instrument Reference Manual Figure 143: System summary and standard event registers 2606B-901-01 Rev. B / May 2018...
  • Page 733 2606B System SourceMeter® Instrument Reference Manual Appendix E: Status model Measurement event registers Figure 144: Measurement event registers 2606B-901-01 Rev. B / May 2018...
  • Page 734 Appendix E: Status model 2606B System SourceMeter® Instrument Reference Manual Figure 145: Operation status registers 2606B-901-01 Rev. B / May 2018...
  • Page 735 2606B System SourceMeter® Instrument Reference Manual Appendix E: Status model Figure 146: Operation status trigger overrun registers 2606B-901-01 Rev. B / May 2018...
  • Page 736 Appendix E: Status model 2606B System SourceMeter® Instrument Reference Manual Figure 147: Operation status trigger timer, trigger blender, and remote registers Figure 148: Operation status digital I/O and TSP-Link registers E-10 2606B-901-01 Rev. B / May 2018...

  • Page 737: Clearing Registers

    2606B System SourceMeter® Instrument Reference Manual Appendix E: Status model Figure 149: Questionable status registers Clearing registers Commands to reset the status registers are listed in the table below. In addition to these commands, you can reset the enable registers and the NTR to 0. To do this, send the individual command to program the register with a 0 as its parameter value.

  • Page 738: Programming And Reading Registers

    Appendix E: Status model 2606B System SourceMeter® Instrument Reference Manual Programming and reading registers Programming enable and transition registers The only registers that you can program are the enable and transition registers. All other registers in the status structure are read-only registers. The following explains how to determine the parameter values for the various commands used to program enable registers.

  • Page 739: Status Byte And Service Request (Srq)

    2606B System SourceMeter® Instrument Reference Manual Appendix E: Status model Status byte and service request (SRQ) Service requests (SRQs) allow an instrument to indicate that it needs attention or that some event has occurred. When the controller receives an SRQ, it allows the controller to interrupt tasks to perform other tasks in order to address the request for service.
  • Page 740 Appendix E: Status model 2606B System SourceMeter® Instrument Reference Manual Figure 151: Status byte and service request (SRQ) The bits of the Status Byte Register are: • Bit B0, Measurement Summary Bit (MSB): When set, indicates that an enabled measurement event has occurred.

  • Page 741: Service Request Enable Register

    2606B System SourceMeter® Instrument Reference Manual Appendix E: Status model Service Request Enable Register The Service Request Enable Register controls the generation of a service request. This register is programmed by the user and is used to enable or disable the setting of bit B6 (RQS/MSS) by the Status Summary Message bits (B0, B1, B2, B3, B4, B5, and B7) of the Status Byte Register.

  • Page 742: Enable And Transition Registers

    Appendix E: Status model 2606B System SourceMeter® Instrument Reference Manual Status Byte and Service Request Enable Register commands Command Description *STB? Read the Status Byte Register. print(status.condition) *SRE <mask> Program the Service Request Enable Register where <mask> = 0 to 255.

  • Page 743: System Summary Registers

    2606B System SourceMeter® Instrument Reference Manual Appendix E: Status model System Summary Registers As shown in Status model diagrams (on page E-4), there are five register sets associated with system status events. These registers summarize the system status for various nodes connected to the ®...
  • Page 744 Appendix E: Status model 2606B System SourceMeter® Instrument Reference Manual • Bit B5, Command Error (CME): Set bit indicates that a command error has occurred. Command errors include:  IEEE Std 488.2 syntax error: The 2606B instrument received a message that does not follow the defined syntax of IEEE Std 488.2.

  • Page 745: Operation Status Registers

    2606B System SourceMeter® Instrument Reference Manual Appendix E: Status model Operation Status Registers As shown in the status model's Operation status registers (on page E-7) diagram, there are 22 register sets associated with operation status. Commands are summarized in the...

  • Page 746: Questionable Status Registers

    Appendix E: Status model 2606B System SourceMeter® Instrument Reference Manual Questionable Status Registers This register set feeds to bit B3 (QSB) of the Status Byte. The bits used in the Questionable Status Register set are described as follows: • Bit B8, Calibration (CAL): Set bit indicates that calibration is questionable.

  • Page 747: Measurement Event Registers

    2606B System SourceMeter® Instrument Reference Manual Appendix E: Status model Measurement Event Registers As shown in the status model's Measurement event registers (on page E-21), there are eight register sets associated with measurement event status. Commands are summarized in the...

  • Page 748: Register Programming Example

    Appendix E: Status model 2606B System SourceMeter® Instrument Reference Manual Register programming example The command sequence below programs the instrument to generate a service request (SRQ) and set the system summary bit in all TSP-Link nodes when the current limit on channel A is exceeded.
  • Page 749 2606B System SourceMeter® Instrument Reference Manual Appendix E: Status model The System Summary Registers are shared by all nodes in the TSP-Link system. When a bit in a system register of node 15 sets, the same bit in the master node system register also sets.
  • Page 750 Appendix E: Status model 2606B System SourceMeter® Instrument Reference Manual The affected status register for the above command is indicated by label E (see the following figure). Figure 153: TSP-Link status model configuration example E-24 2606B-901-01 Rev. B / May 2018...

  • Page 751: Index

    Index source accuracy • B-6 cursor • 7-63 analog-to-digital converter • 2-37, 2-76, 4-1 anonymous script • 6-7 arrays • 6-26 data queue • 6-55 attribute • 5-2 data store assigning a value to • 5-2 overview • 3-5 reading • 5-2 programming examples •...
  • Page 752 Index 2606B System SourceMeter® Instrument Reference Manual contact check • 2-51 digital I/O programming • 3-81 filter programming • 3-5 Keithley I/O layer • 2-27 interactive triggering • 3-52 Keithley website • 10-1 power programming • 2-49 key-press codes • 3-76 pulse train •...
  • Page 753 2606B System SourceMeter® Instrument Reference Manual Index auto • 2-72 low range limits • 2-72 output value • B-5 named scripts reading buffer overview • 6-4 attributes • 3-15 running • 6-7 defined buffer example • 3-17 node dual buffer example • 3-18 accessing •...
  • Page 754 Index 2606B System SourceMeter® Instrument Reference Manual scripts • 5-3, 6-2 autoexec • 6-9 autorun scripts • 6-8 test deleting • 6-43 considerations • B-5, B-11 error effects • 8-1 Test Script Builder • 6-30, 6-31 exporting • 6-36 time • 7-170, 7-171 function, using •...
  • Page 755 2606B System SourceMeter® Instrument Reference Manual Index saving reading buffer to • 3-9 user scripts creating • 6-3 modifying • 6-42 running • 6-7 save • 6-10 user setups recalling • 2-52 saving • 2-52 userstring functions • 6-53, 7-380 add •...
  • Page 756 All Keithley trademarks and trade names are the property of Keithley Instruments. All other trademarks and trade names are the property of their respective companies. Keithley Instruments Corporate Headquarters • 28775 Aurora Road • Cleveland, Ohio 44139 • 440-248-0400 • Fax: 440-248-6168 • 1-800-935-5595 • www.tek.com/keithley 12/17...

Table of Contents