Tektronix Keithley 2601B-PULSE Reference Manual
  1. Manuals
  2. Brands
  3. Tektronix Manuals
  4. Measuring Instruments
  5. Keithley 2601B-PULSE
  6. Reference manual

Tektronix Keithley 2601B-PULSE Reference Manual

System sourcemeter instrument
Hide thumbs Also See for Keithley 2601B-PULSE:
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
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
Table of Contents

Advertisement

Quick Links

Download this manual
Model 2601B-PULSE
System SourceMeter Instrument
Reference Manual
2601B-PULSE-901-01 Rev. A April 2020
Test Equipment Depot - 800.517.8431 - 99 Washington Street Melrose, MA 02176 - TestEquipmentDepot.com
*P2601B-PULSE-901-01A*
2601B-PULSE-901-01A

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the Keithley 2601B-PULSE and is the answer not in the manual?

Questions and answers

Related Manuals for Tektronix Keithley 2601B-PULSE

Summary of Contents for Tektronix Keithley 2601B-PULSE

  • Page 1 Model 2601B-PULSE System SourceMeter Instrument Reference Manual 2601B-PULSE-901-01 Rev. A April 2020 Test Equipment Depot - 800.517.8431 - 99 Washington Street Melrose, MA 02176 - TestEquipmentDepot.com *P2601B-PULSE-901-01A* 2601B-PULSE-901-01A...
  • Page 2 Model 2601B-PULSE System SourceMeter Instrument Reference Manual...
  • Page 3 © 2020, Keithley Instruments, LLC 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 4 Safety precautions The following safety precautions should be observed before using this product and any associated instrumentation. Although some instruments and accessories would normally be used with nonhazardous voltages, there are situations where hazardous conditions may be present. This product is intended for use by personnel who recognize shock hazards and are familiar with the safety precautions required to avoid possible injury.
  • Page 5 For safety, instruments and accessories must be used in accordance with the operating instructions. If the instruments or accessories are used in a manner not specified in the operating instructions, the protection provided by the equipment may be impaired. Do not exceed the maximum signal levels of the instruments and accessories. Maximum signal levels are defined in the specifications and operating information and shown on the instrument panels, test fixture panels, and switching cards.

  • Page 6: Introduction

    Table of contents Introduction ......................1-1 Welcome ..........................1-1 Extended warranty ....................... 1-1 Contact information ......................1-1 Customer documentation ..................... 1-2 Product software and drivers ....................1-2 Capabilities and features...................... 1-3 Power and environmental ratings ..................1-4 Installation ........................ 2-1 Introduction ..........................
  • Page 7 Table of contents Model 2601B-PULSE System SourceMeter Instrument Reference Manual Beeper ..........................3-13 Displayed error and status messages ................3-13 Display operations ......................3-14 Display mode .......................... 3-14 Display functions and attributes ....................3-15 Display features ........................3-15 Display messages ........................3-17 Input prompting ........................
  • Page 8 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Table of contents Ohms ranging .......................... 4-46 Basic ohms measurement procedure ..................4-46 Ohms sensing ......................... 4-48 Power measurements ......................4-49 Basic power measurement procedure ..................4-50 Power measurements using the remote interface ..............4-50 Saved setups ........................
  • Page 9 Table of contents Model 2601B-PULSE System SourceMeter Instrument Reference Manual Storage operation ........................5-3 Saving reading buffers ......................5-4 Recalling readings ........................5-5 Remote reading buffer programming ................... 5-6 Dedicated reading buffer designations ..................5-6 Reading buffer commands ......................5-6 Buffer status ..........................
  • Page 10 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Table of contents Either edge trigger mode ......................6-31 Understanding synchronous triggering modes ..............6-32 Synchronous master trigger mode (SynchronousM) ............... 6-32 Synchronous acceptor trigger mode (SynchronousA) ............. 6-34 Synchronous trigger mode ...................... 6-35 Digital I/O ...........................
  • Page 11 Table of contents Model 2601B-PULSE System SourceMeter Instrument Reference Manual Digital I/O ..........................9-6 Display ............................9-6 Error queue ..........................9-7 Event log ........................... 9-7 File I/O ............................9-7 GPIB ............................9-8 Instrument identification ......................9-9 LAN and LXI ..........................9-9 Miscellaneous .........................
  • Page 12 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Table of contents Advanced scripting for TSP ..................... 10-36 Global variables and the script.user.scripts table ..............10-36 Create a script using the script.new() command ..............10-37 Rename a script ........................10-40 Retrieve a user script ......................10-42 Delete user scripts from the instrument .................
  • Page 13 Table of contents Model 2601B-PULSE System SourceMeter Instrument Reference Manual bufferVar.basetimestamp ...................... 11-18 bufferVar.cachemode ......................11-19 bufferVar.capacity ......................... 11-20 bufferVar.clear() ........................11-21 bufferVar.clearcache() ......................11-22 bufferVar.collectsourcevalues ....................11-23 bufferVar.collecttimestamps ....................11-24 bufferVar.fillcount ........................11-25 bufferVar.fillmode ........................11-25 bufferVar.measurefunctions ....................11-26 bufferVar.measureranges .....................
  • Page 14 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Table of contents display.trigger.clear() ......................11-72 display.trigger.EVENT_ID ..................... 11-73 display.trigger.overrun ......................11-73 display.trigger.wait() ......................11-74 display.waitkey() ........................11-74 errorqueue.clear() ......................... 11-76 errorqueue.count ........................11-76 errorqueue.next() ........................11-77 eventlog.all() .......................... 11-78 eventlog.clear() ........................11-79 eventlog.count ........................
  • Page 15 Table of contents Model 2601B-PULSE System SourceMeter Instrument Reference Manual lan.restoredefaults() ......................11-121 lan.status.dns.address[N] ....................11-122 lan.status.dns.name ......................11-122 lan.status.duplex ......................... 11-123 lan.status.gateway ......................11-124 lan.status.ipaddress ......................11-124 lan.status.macaddress ......................11-125 lan.status.port.dst ........................ 11-125 lan.status.port.rawsocket ....................11-126 lan.status.port.telnet ......................11-126 lan.status.port.vxi11 ......................
  • Page 16 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Table of contents script.restore() ........................11-162 script.run() ........................... 11-162 script.user.catalog() ......................11-163 scriptVar.autorun ......................... 11-163 scriptVar.list() ........................11-164 scriptVar.name ........................11-165 scriptVar.run() ........................11-166 scriptVar.save() ........................11-166 scriptVar.source ........................11-167 serial.baud........................... 11-168 serial.databits ........................11-169 serial.flowcontrol .........................
  • Page 17 Table of contents Model 2601B-PULSE System SourceMeter Instrument Reference Manual smua.pulser.enable ......................11-212 smua.pulser.measure.aperture ................... 11-213 smua.pulser.measure.calibrateY() ..................11-214 smua.pulser.measure.delay ....................11-215 smua.pulser.protect.sensev ....................11-216 smua.pulser.protect.sourcev ....................11-217 smua.pulser.protect.tripped ....................11-218 smua.pulser.source.calibratebiasi() ..................11-219 smua.pulser.rangeY ......................11-220 smua.pulser.source.calibratei() ................... 11-221 smua.reset() ........................
  • Page 18 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Table of contents status.measurement.current_limit.* ..................11-268 status.measurement.instrument.* ..................11-270 status.measurement.instrument.smua.* ................11-271 status.measurement.protection.* ..................11-273 status.measurement.reading_overflow.* ................11-274 status.measurement.voltage_limit.* ..................11-276 status.node_enable ......................11-277 status.node_event ....................... 11-279 status.operation.* ........................ 11-281 status.operation.calibrating.* ....................11-283 status.operation.instrument.*....................
  • Page 19 Table of contents Model 2601B-PULSE System SourceMeter Instrument Reference Manual trigger.generator[N].EVENT_ID ................... 11-356 trigger.timer[N].clear() ......................11-357 trigger.timer[N].count ......................11-357 trigger.timer[N].delay ......................11-358 trigger.timer[N].delaylist ...................... 11-359 trigger.timer[N].EVENT_ID ....................11-360 trigger.timer[N].overrun ....................... 11-360 trigger.timer[N].passthrough ....................11-361 trigger.timer[N].reset() ......................11-361 trigger.timer[N].stimulus ...................... 11-362 trigger.timer[N].wait() ......................
  • Page 20 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Table of contents Retrieving errors ......................... 12-2 Error summary list ......................12-2 Calibration ......................13-1 Calibration .......................... 13-1 Calibration test requirements ....................13-2 Uninstalling the 2601B-P-INT ....................13-5 Restoring factory defaults......................13-5 Performing the calibration test procedures ................13-6 Current source accuracy ......................
  • Page 21 Table of contents Model 2601B-PULSE System SourceMeter Instrument Reference Manual Status register sets ......................15-20 System Summary Registers ....................15-20 Standard Event Register ....................... 15-21 Operation Status Registers ....................15-22 Questionable Status Registers ....................15-23 Measurement Event Registers ....................15-24 Register programming example ....................
  • Page 22 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 Tektronix corporate headquarters (toll-free inside the U.S. and Canada only) at 1-800-833-9200. For worldwide...
  • Page 23 Section 1: Introduction Model 2601B-PULSE System SourceMeter Instrument Reference Manual Customer documentation The documentation for the 2601B-PULSE includes a Quick Start Guide and Reference Manual (this document). The 2601B-PULSE Quick Start Guide is provided as a hard copy with the instrument. You can also access it from tek.com/keithley as an Adobe Acrobat PDF file.
  • Page 24 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 1: Introduction Capabilities and features Key features: • Pulser output of 10 A at 10 V • SMU outupt of 10 A at 20 V • No tuning required; works with inductive loads up to 3 μH •...
  • Page 25 Section 1: Introduction Model 2601B-PULSE System SourceMeter Instrument Reference Manual Power and environmental ratings The 2601B-PULSE power and environmental ratings and connections are listed in the following tables. Category Specification Power supply 100 V ac to 240 V ac, 50 Hz or 60 Hz (autosensing). 240 VA maximum Input and output connections Front panel (on page 3-1) and...

  • Page 26: Table Of Contents

    Section 2 Installation In this section: Introduction ................2-1 2601B-PULSE weights and dimensions ........2-1 Installing the 2601B-P-INT ............2-6 Cooling vents ................2-8 Turning the instrument on and off ..........2-9 Placing a 2601B-PULSE in standby ........2-10 Warmup period ............... 2-10 Line frequency configuration ..........
  • Page 27 Section 2: Installation Model 2601B-PULSE System SourceMeter Instrument Reference Manual The following figures show the dimensions when the handle is installed. Figure 2: 2601B-PULSE dimensions front and rear with handle 2601B-PULSE-901-01A April 2020...
  • Page 28 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 2: Installation The following figures show the dimensions when the handle has been removed. Figure 3: 2601B-PULSE front and rear panel dimensions with handle removed 2601B-PULSE-901-01A April 2020...
  • Page 29 Section 2: Installation Model 2601B-PULSE System SourceMeter Instrument Reference Manual Figure 4: 2601B-PULSE height and length Figure 5: 2601B-PULSE with 2601B-P-INT length 2601B-PULSE-901-01A April 2020...
  • Page 30 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 2: Installation Preparing the instrument for rack mounting To remove the handle, mounting ears, and rear feet: 1. Adjust the handle by gently pulling it away from the sides of the instrument case and swinging it up or down until the orientation arrows on the handles line up with the orientation arrows on the mounting ears, as shown in the figure below.

  • Page 31: Installing The 2601B-P-Int

    Section 2: Installation Model 2601B-PULSE System SourceMeter Instrument Reference Manual 2601B-P-INT dimensions The following figure show the dimensions of the 2601B-P-INT Interlock and Cable Connector Box. The 2601B-P-INT weighs 0.5 kg (1 lb). Figure 7: 2601B-P-INT dimensions Installing the 2601B-P-INT The 2601B-PULSE is shipped with the 2601B-P-INT Rear Panel Interlock and Cable Connector Box accessory.
  • Page 32 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 2: Installation To install the 2601B-P-INT: 1. Remove power connections from the 2601B-PULSE. 2. On the rear panel of the 2601B-PULSE, remove the screws to the left of the CHANNEL A: DC/PULSE terminal strip and to the right of the CHANNEL A: DC terminal strip. Save the screws for operation with the 2601B-P-INT uninstalled.

  • Page 33: Cooling Vents

    Section 2: Installation Model 2601B-PULSE System SourceMeter Instrument Reference Manual Figure 10: Installation of the 2601B-P-INT Replacement jumpers are available from Keystone Electronics Corp., part number 1430-1, Uninsulated Shorting Pin. Cooling vents The 2601B-PULSE has side and top intake and rear exhaust vents. One side must be unobstructed to dissipate heat.

  • Page 34: Turning The Instrument On And Off

    Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 2: Installation If high power dissipation equipment is rack mounted next to the 2601B-PULSE, it could cause excessive heating. To produce specified 2601B-PULSE accuracies, maintain the specified ambient temperature around the surfaces of the 2601B-PULSE. In rack configurations with convection cooling only, proper cooling practice places the hottest non-precision equipment (for example, the power supply) at the top of the rack away from and above precision equipment (such as the 2601B-PULSE).

  • Page 35: Placing A 2601B-Pulse In Standby

    Section 2: Installation Model 2601B-PULSE System SourceMeter Instrument Reference Manual Hazardous voltages may be present in the test system. To prevent 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 36: Line Frequency Configuration

    Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 2: Installation Line frequency configuration The factory configures the 2601B-PULSE to detect the power line frequency automatically at each power-up. This detected line frequency (either 50 Hz or 60 Hz) is used for aperture (NPLC) calculations.
  • Page 37 Section 2: Installation Model 2601B-PULSE System SourceMeter Instrument Reference Manual Remote interface connections The 2601B-PULSE supports the following remote interfaces: • USB: Communicate with the instrument over a USB connection. • LAN: Local area network (LAN) communications provide the flexibility to build scalable and functional test or data acquisition systems with a large degree of flexibility.
  • Page 38 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 2: Installation Output queue Response messages, such as those generated from print commands, are placed in the output queue. All remote command interfaces share the same output queue. The output queue sets the message available (MAV) bit in the status model. The data in the output queue is cleared by the *CLS command.
  • Page 39 Section 2: Installation Model 2601B-PULSE System SourceMeter Instrument Reference Manual 5. Select File > Open Instrument to open the instrument you named in the wizard. Figure 12: Keithley Communicator Open an Instrument 6. Select OK. 7. Send a command to the instrument and see if it responds. If you have a full version of NI-VISA on your system, you can run NI-MAX or the VISA Interactive Utility.
  • Page 40 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 2: Installation LAN communications You can communicate with the instrument using a local area network (LAN). The 2601B-PULSE can connect directly to a host computer or interact with a DHCP or DNS server and other LXI-compliant instruments on a local area network (LAN).
  • Page 41 Section 2: Installation Model 2601B-PULSE System SourceMeter Instrument Reference Manual Figure 13: 2601B-PULSE ethernet connection 1 2601B-PULSE ethernet port (LAN) 2 Straight-through LAN cable or crossover LAN cable 3 Ethernet port (on the host computer) You can connect the instrument to the LAN in a one-to-one, one-to-many, two network card, or enterprise configuration, as described in the following topics.
  • Page 42 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 2: Installation The 2601B-PULSE supports Auto-MDIX and can use either normal LAN CAT-5 cables (patch) or crossover cables. The instrument automatically adjusts to support either cable. One-to-many connection With a LAN hub, a single network interface card can be connected to as many instruments as the hub can support.
  • Page 43 Section 2: Installation Model 2601B-PULSE System SourceMeter Instrument Reference Manual Figure 16: Two network card connection Instrumentation connection to enterprise routers or servers This connection uses an existing network infrastructure to connect instruments to the computer controller. In this case, you must get the network resources from the network administrator. Usually, the instruments are kept inside the corporate firewall, but the network administrator can assign resources that allow them to be outside the firewall.
  • Page 44 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 2: Installation Set up LAN communications on the instrument The following topics describe how to check the existing LAN communications settings and set up manual or automatic LAN communications. Check communications settings Before configuring the LAN, you can check the communications settings on the instrument without making any changes.
  • Page 45 Section 2: Installation Model 2601B-PULSE System SourceMeter Instrument Reference Manual Set up manual LAN configuration These steps assume that you are making all the settings in the order shown here. If you only change one or a few settings, be aware that you need to apply the settings before they will be in effect. To apply the settings, from the LAN CONFIG menu, select APPLY_SETTINGS >...
  • Page 46 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 2: Installation LAN speeds Another characteristic of the LAN is speed. The 2601B-PULSE negotiates with the host computer and other LXI-compliant devices on the LAN to transmit data at the highest speed possible. LAN speeds must be configured to match the speed of the other instruments on the network.
  • Page 47 Section 2: Installation Model 2601B-PULSE System SourceMeter Instrument Reference Manual To set the DNS server IP addresses: 1. From the front panel, press the MENU key and select LAN > CONFIG > DNS. 2. Turn the navigation wheel to select either DNS-ADDRESS1 or DNS-ADDRESS2. 3.
  • Page 48 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 2: Installation LAN status LEDs The figure below illustrates the two status light emitting diodes (LEDs) that are on the LAN port of the instrument. The table below the figure provides explanations of the LED states. The LED labeled 1 indicates the LAN port is connected to a 100 Mbps network.
  • Page 49 Section 2: Installation Model 2601B-PULSE System SourceMeter Instrument Reference Manual Raw socket connection All Keithley instruments that have LAN connections support raw socket communication, which means you can connect to the TCP/IP port on the instrument and send and receive commands. You can communicate with the instrument using the Winsock API on computers with the Microsoft Windows ®...
  • Page 50 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 2: Installation Reset LAN settings To reset the LAN settings to the factory defaults from the front panel, select MENU > LAN > RESET. LAN troubleshooting suggestions If you are unable to connect to the web interface of the instrument, check the following items: •...
  • Page 51 Section 2: Installation Model 2601B-PULSE System SourceMeter Instrument Reference Manual Viewing LAN status messages To view the LAN status messages: 1. From the front panel, press the MENU key and select LAN > STATUS > CONFIG/FAULT. 2. Press the ENTER key. Figure 19: LAN CONFIG/FAULT There are two types of LAN status messages: •...
  • Page 52 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 2: Installation Logging LAN trigger events in the event log You can use the event log to record all LXI triggers generated and received by the 2601B-PULSE. You can view the event log using any command interface or the embedded web interface. The following figure shows the view of the LXI event log from the embedded web interface.
  • Page 53 Section 2: Installation Model 2601B-PULSE System SourceMeter Instrument Reference Manual Event log descriptions Column title Description Example Domain Displays the LXI domain number; the default value is 0 (zero) Flags Contain data about the LXI trigger packet; values are: ▪ 1 - Error ▪...
  • Page 54 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 2: Installation To generate log traffic, send the code: local id = 1 lan.trigger[id].ipaddress = lan.status.ipaddress lan.trigger[id].connect() for domain = 1, 255 do print(domain) lan.lxidomain = domain lan.trigger[id].assert() delay(1) GPIB operation The following topics contain information about GPIB standards, bus connections, and primary address selection.
  • Page 55 Section 2: Installation Model 2601B-PULSE System SourceMeter Instrument Reference Manual To connect the instrument to the IEEE-488 bus, line up the cable connector with the connector on the rear panel. Install and tighten the screws securely, making sure not to overtighten them. The following figure shows the location of the connector.
  • Page 56 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 2: Installation Terminator When receiving data over the GPIB, the instrument terminates messages on any line feed character or any data byte with EOI asserted (line feed with EOI asserted is also valid). When sending data, it appends a line feed character to all outgoing messages.
  • Page 57 Section 2: Installation Model 2601B-PULSE System SourceMeter Instrument Reference Manual TALK This indicator is on when the instrument is in the talker active state. Place the instrument in the talk state by addressing it to talk with the correct talk command. TALK is off when the instrument is in the talker idle state.
  • Page 58 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 2: Installation Setting RS-232 interface parameters To set interface parameters from the front panel: 1. Press the MENU key, select RS232, and then press the ENTER key or the navigation wheel 2. Select and enter the following interface parameters: BAUD: Set baud rate (see Baud rate (on page 2-34))
  • Page 59 Section 2: Installation Model 2601B-PULSE System SourceMeter Instrument Reference Manual Terminator When receiving data over the RS-232 interface, the command interface terminates on line feeds. A line feed is appended to all output messages when the RS-232 interface is being used as a command interface.
  • Page 60 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 2: Installation RS-232 connections Connect the RS-232 serial port of the 2601B-PULSE to the serial port of a computer using a straight-through RS-232 cable terminated with DB-9 connectors. Do not use a null modem cable. The serial port uses the transmit (TXD), receive (RXD), CTS and RTS (if flow control is enabled), and signal ground (GND) lines of the RS-232 standard.
  • Page 61 Section 2: Installation Model 2601B-PULSE System SourceMeter Instrument Reference Manual Software components for applications and instrument drivers The majority of software applications and all instrument drivers from Keithley Instruments depend on some, or all, of the following software components: • NI-VISA •...
  • Page 62 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 2: Installation VXIPnP drivers VXIplug&play (VXIPnP) style drivers are Win32 DLLs that have some standard functions defined by IVI Foundation (ivifoundation.org), such as: • init • close • error_message • reset • self_test •...
  • Page 63 Section 2: Installation Model 2601B-PULSE System SourceMeter Instrument Reference Manual Getting instrument drivers To see what drivers are available for your instrument: 1. Go to the Product Support web page (tek.com/product-support). 2. Enter the model number of your instrument. 3. Select Software from the list. 4.
  • Page 64 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 2: Installation NI IVI Compliance Package The National Instruments (NI ) IVI Compliance Package (ICP) is a software package that contains IVI class drivers and support libraries that are needed for the development and use of applications that leverage IVI instrument interchangeability.
  • Page 65 Section 2: Installation Model 2601B-PULSE System SourceMeter Instrument Reference Manual General bus commands General commands are commands that have the same general meaning, regardless of the instrument (for example, DCL). The following table lists the general bus commands. General bus commands Command Effect on 2601B-PULSE Returns the 2601B-PULSE and all devices on the GPIB to known conditions.
  • Page 66 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 2: Installation The interface clear (IFC) command is sent by the controller to place the 2601B-PULSE in the talker idle state and the listener idle state. The instrument responds to the IFC command by canceling illumination of the front-panel TALK or LSTN lights if the instrument was previously placed in one of these states.

  • Page 67: Using The Interlock

    Section 2: Installation Model 2601B-PULSE System SourceMeter Instrument Reference Manual SPE, SPD Use the serial polling sequence to obtain the 2601B-PULSE serial poll byte. The serial poll byte contains important information about internal functions (see Status model (on page 15-1)). Generally, the serial polling sequence is used by the controller to determine which of several instruments has requested service with the SRQ line.
  • Page 68 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 2: Installation Interlock operation You can set up the interlock using the +5 V supply pins on the digital I/O port on the rear panel of the instrument or by using an external 5 V source. Both methods use the Model 2601B-P-INT Interlock and Cable Connector Box to make connections.
  • Page 69 Section 2: Installation Model 2601B-PULSE System SourceMeter Instrument Reference Manual Interlock connections through digital I/O port The following figure shows digital I/O port pin 20 as ground. You can also use pin 15, 16, 17, 18, 19, or 21 as ground. The +5 V source is shown as digital I/O port pin 22.
  • Page 70 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 2: Installation Figure 25: External source interlock connections Wiring the interlock mating connector Use the Keithley Instruments CS-1616-3 Safety Interlock Mating Connector supplied with the 2601B-PULSE to make the interlock connection to the 2601B-P-INT. You must supply connection wire.

  • Page 71: System Information

    Section 2: Installation Model 2601B-PULSE System SourceMeter Instrument Reference Manual The interlock pin locations and connections are shown in the following figure. The pins are: • Pin 3: Earth and chassis ground • Pin 2: Interlock • Pin 1 (next to tab): +6 V dc out (current limited) Figure 26: Interlock mating connector pins System information You can retrieve serial number, firmware revision, calibration dates, and memory usage...
  • Page 72 Section 3 Instrument description In this section: Controls, indicators, and connectors ........3-1 Menu overview ................. 3-7 Beeper ................... 3-13 Displayed error and status messages ........3-13 Display operations ..............3-14 USB storage overview ............3-28 Controls, indicators, and connectors 2601B-PULSE controls, indicators, and the USB port are on the front panel (on page 3-1).
  • Page 73 Section 3: Instrument description Model 2601B-PULSE System SourceMeter Instrument Reference Manual 2. SMU setup, performance control, special operation, and numbers SMU (source-measure unit) setup When the pulser is disabled, selects the source function (voltage or current) and places the cursor in the source field for editing. When the pulser is enabled, this key has no action.
  • Page 74 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 3: Instrument description Numbers When enabled and in EDIT mode, the number keys (0-9, +/-, 0000) allow direct numeric Number keys entry. Press the navigation wheel to enter EDIT mode. For more information, see Setting a value (on page 3-11).
  • Page 75 Section 3: Instrument description Model 2601B-PULSE System SourceMeter Instrument Reference Manual 7. Navigation wheel Turn the navigation wheel ▪ Move the cursor to the left and the right (the cursor indicates the selected value or item) ▪ While in edit mode, increase or decrease a selected source or compliance value Push the navigation wheel ▪...
  • Page 76 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 3: Instrument description Rear panel The 2601B-PULSE rear panel with the 2601B-P-INT installed is shown below. The descriptions of the rear-panel components follow the figure. Figure 28: Rear panel 1. FORCE HI and FORCE LO connectors These connectors provide connections for FORCE HI and FORCE LO.
  • Page 77 Section 3: Instrument description Model 2601B-PULSE System SourceMeter Instrument Reference Manual 5. Digital I/O Female DB-25 connector. Use a cable equipped with a male DB-25 connector (Keithley Instruments part number CA-126-1A; L-com part number CSMN25MF-5). Pins provided: ▪ Fourteen digital input or output pins ▪...

  • Page 78: Menu Overview

    Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 3: Instrument description 12. Power module Contains the ac line receptacle and power line fuse. The instrument can operate on line voltages of 100 V ac to 240 V ac at line frequencies of 50 Hz or 60 Hz.
  • Page 79 Section 3: Instrument description Model 2601B-PULSE System SourceMeter Instrument Reference Manual Main menu The main menu structure is summarized in the following figure and table. For other menu items, see Configuration menus (on page 3-10). Figure 29: Main menu tree 2601B-PULSE-901-01A April 2020...
  • Page 80 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 3: Instrument description 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 Menu selection Description...
  • Page 81 Section 3: Instrument description Model 2601B-PULSE System SourceMeter Instrument Reference Manual Configuration menus The configuration menu structure is summarized in the following figure and table. For directions on navigating the menu, see Menu navigation (on page 3-7). For other menu items, see Main menu page 3-8).
  • Page 82 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 3: Instrument description Descriptions of the configuration menus The following table contains descriptions of the configuration menus and cross-references to related information. To access, press the Options For more information, see: CONFIG key and then: V-source sense and low range;...
  • Page 83 Section 3: Instrument description Model 2601B-PULSE System SourceMeter Instrument Reference Manual Numeric entry method: 1. If the keypad is disabled, press the MENU key, then select DISPLAY > NUMPAD > ENABLE. 2. Use the CURSOR arrow keys (or turn the navigation wheel ) to move the cursor to the value that needs to be changed.

  • Page 84: Beeper

    Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 3: Instrument description To edit compliance limit values: 1. Press the LIMIT key. 2. Select the type of compliance. 3. Press the navigation wheel or the ENTER key to enter edit mode. The EDIT indicator is illuminated.

  • Page 85: Display Operations

    Section 3: Instrument description Model 2601B-PULSE System SourceMeter Instrument Reference Manual Display operations This section describes methods for using the display and determining what is displayed. Display mode Use the DISPLAY key to scroll through the display modes shown in the figure below. Figure 31: Display modes when the pulser is disabled Figure 32: Display modes when the pulser is enabled 3-14...
  • Page 86 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 3: Instrument description Display functions and attributes The display functions and attributes for the 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 topic where the function or attribute is explained.
  • Page 87 Section 3: Instrument description Model 2601B-PULSE System SourceMeter Instrument Reference Manual Display screen The front panel displays source-measure values and readings or user-defined messages. The display screen options include: • Source-measure, compliance screens: Display SMU source-measure readings and compliance values. •...
  • Page 88 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 3: Instrument description Display messages You can define text messages that can be displayed on the front panel of the instrument. Most of the display functions and attributes that are associated with display messaging will automatically select the user screen.
  • Page 89 Section 3: Instrument description Model 2601B-PULSE System SourceMeter Instrument Reference Manual Cursor position When displaying a message, the cursor position determines where the message will start. On power-up, the cursor is positioned at row 1, column 1 (see the following figure). At this cursor position, a user-defined message will be displayed on the top row (row 1).
  • Page 90 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 3: Instrument description Displaying text messages To define and display a message, use the display.settext(text) function, where text is the text string to be displayed. The message starts at the present cursor position. The following programming example illustrates how to display Test in Process on the top line, and Do Not Disturb on the bottom line: display.clear()
  • Page 91 Section 3: Instrument description Model 2601B-PULSE System SourceMeter Instrument Reference Manual Be careful when embedding character codes in the text string. It is easy to forget that the character following the $ is part of the code. For example, if you want to display Hello on the top line and Nate on the bottom line, send the following command: display.settext("Hello$Nate") The above command displays Hello on the top line and ate on the bottom line.
  • Page 92 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 3: Instrument description Input prompting You can use display messaging with front panel controls to make a user script interactive. In an interactive script, input prompts are displayed so that the operator can perform a prescribed action using the front panel controls.
  • Page 93 Section 3: Instrument description Model 2601B-PULSE System SourceMeter Instrument Reference Manual Each of these functions can be used in the following ways: display.inputvalue(format) display.inputvalue(format, default) display.inputvalue(format, default, min) display.inputvalue(format, default, min, max) display.prompt(format, units, help) display.prompt(format, units, help, default) display.prompt(format, units, help, default, min) display.prompt(format, units, help, default, min, max) Where: String that creates an editable input field on the user screen at the present cursor position...
  • Page 94 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 3: Instrument description If the operator presses EXIT(LOCAL) instead of entering a source value, value will be set to nil. The second line of the above code can be replaced using the other input field function: value = display.inputvalue("0.00") The only difference is that the display prompt will not include the “V”...
  • Page 95 Section 3: Instrument description Model 2601B-PULSE System SourceMeter Instrument Reference Manual Local lockout You can use the front-panel EXIT (LOCAL) key to cancel remote operation and return control to the front panel. However, this key can be locked out to prevent a test from being interrupted. When locked, this key becomes a NO-OP (no operation).
  • Page 96 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 3: Instrument description Scripts, functions, and variables that are used in the code are not saved when display.SAVE is used. Functions and variables need to be saved with the script (see Manage scripts (on page 10-3)).
  • Page 97 Section 3: Instrument description Model 2601B-PULSE System SourceMeter Instrument Reference Manual Running a test from the front panel To run a user, factory, or script test from the front panel: 1. Press the LOAD key to display the LOAD TEST menu. 2.
  • Page 98 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 3: Instrument description Key codes Value Key list Value Key list display.KEY_NONE display.KEY_ENTER display.KEY_RANGEUP display.KEY_RECALL display.KEY_MENU display.KEY_MEASA display.KEY_MODEA display.KEY_DIGITSA display.KEY_RELA display.KEY_TRIG display.KEY_RUN display.KEY_LIMITA display.KEY_DISPLAY display.KEY_SPEEDA display.KEY_AUTO display.KEY_LOAD display.KEY_EXIT display.WHEEL_ENTER display.KEY_FILTERA display.KEY_RIGHT display.KEY_STORE display.KEY_LEFT display.KEY_SRCA display.WHEEL_LEFT...

  • Page 99: Usb Storage Overview

    Section 3: Instrument description Model 2601B-PULSE System SourceMeter Instrument Reference Manual USB storage overview The 2601B-PULSE includes a USB port on the front panel. To store scripts and to transfer files from the instrument to the host computer, you need a USB flash drive. •...
  • Page 100 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 3: Instrument description File system navigation The 2601B-PULSE can use commands from the Lua fs library to navigate and list files that are available on a flash drive. These Lua commands are in the fs command group in the instrument. The fs commands make the file system of any given node available to the entire TSP-Link ®...
  • Page 101 Section 4 Sourcing and measuring In this section: Operation overview ..............4-1 DUT test connections ............... 4-6 DUT connection settings ............4-25 Basic source-measure procedure .......... 4-30 Operation considerations for the ADC ........4-41 Triggering in local mode ............4-42 Configuring trigger attributes in local mode ......
  • Page 102 Section 4: Sourcing and measuring Model 2601B-PULSE System SourceMeter Instrument Reference Manual When the pulser is disabled, the instrument provides the full functionality of a 4-quadrant SMU. You can use the front panel or remote commands to configure the instrument to perform the following source-measure operations: •...
  • Page 103 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 4: Sourcing and measuring Source range Maximum limit 100 mV 40 V 100 nA 40 V 1 µA 40 V 10 µA 40 V 100 µA 40 V 1 mA 40 V 10 mA 40 V 100 mA...
  • Page 104 Section 4: Sourcing and measuring Model 2601B-PULSE System SourceMeter Instrument Reference Manual The following programming example illustrates how to print the limit state: print(smua.source.compliance) A returned value of true indicates one of the following things: • If the instrument is configured as a current source, the voltage limit has been reached •...
  • Page 105 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 4: Sourcing and measuring To determine if a pulser level protection was tripped, send: print(smua.pulser.protect.tripped) A returned value of true indicates that the protection circuit was tripped. The following events can trip the protection circuit: •...

  • Page 106: Dut Test Connections

    Section 4: Sourcing and measuring Model 2601B-PULSE System SourceMeter Instrument Reference Manual When using the SMU current source as a sink, always set the voltage compliance to a level that is higher than the external voltage level. Failure to do so could result in excessive current flow into the instrument and incorrect measurements.
  • Page 107 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 4: Sourcing and measuring On some sensitive or easily damaged devices under test (DUTs), the instrument power-up and power-down sequence can apply transient signals to the DUT that may affect or damage it. When testing this type of DUT, do not make final connections to it until the instrument has completed its power-up sequence and is in a known operating state.
  • Page 108 Section 4: Sourcing and measuring Model 2601B-PULSE System SourceMeter Instrument Reference Manual FORCE and SENSE connectors You make connections from the instrument to the device under test (DUT) using the BNC connections on the 2601B-P-INT. The FORCE HI, FORCE LO, and SENSE HI connectors of the 2601B-P-INT have GUARD on the shell.
  • Page 109 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 4: Sourcing and measuring The chassis screw terminal is connected to the metal chassis of the 2601B-PULSE. Figure 40: Chassis ground banana jack Do not use the chassis as a ground point for signal connections. High frequencies on the chassis of the 2601B-PULSE may result in higher noise.
  • Page 110 Section 4: Sourcing and measuring Model 2601B-PULSE System SourceMeter Instrument Reference Manual 2-wire local sensing connections Local voltage sensing is only available when the pulser is disabled. You can use 2-wire local sensing measurements, shown in the following figure, for the following source-measure conditions: •...
  • Page 111 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 4: Sourcing and measuring When sourcing voltage with remote sense, the instrument relies on the voltage detected with the sense lines to provide the proper closed-loop control of its output voltage and to properly limit the voltage across the device-under-test.
  • Page 112 Section 4: Sourcing and measuring Model 2601B-PULSE System SourceMeter Instrument Reference Manual The signal present at the FORCE terminals is affected by the total inductance in the test circuit. The signal present at the SENSE terminals is only affected by the inductance beyond the Kelvin connection points.
  • Page 113 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 4: Sourcing and measuring Figure 43: Contact check measurement connections to 2601B-P-INT The contact check function is not available if the pulser is enabled. If you need to use the contact check function in a pulser application, you can disable the pulser, run the contact check measurements, then enable the pulser.
  • Page 114 Section 4: Sourcing and measuring Model 2601B-PULSE System SourceMeter Instrument Reference Manual Contact check programming example The following programming example illustrates the setup and command sequence for a typical contact check measurement. These commands set the contact check speed to fast and the threshold to 100 Ω.
  • Page 115 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 4: Sourcing and measuring Figure 44: Combining SMU outputs Pulse region specification (pulser disabled) Region Region Maximum Maximum duty (quadrant maximum pulse width cycle diagram) 1 A at 40 V DC, no limit 100% 3 A at 6 V DC, no limit...
  • Page 116 Section 4: Sourcing and measuring Model 2601B-PULSE System SourceMeter Instrument Reference Manual Additional guidelines for combining SMU outputs: • When combining the outputs of two 2601B-PULSE instruments, restrict operation to pulse only or limited duty cycle operations whenever possible. DC operation in Region 1 is possible if necessary.
  • Page 117 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 4: Sourcing and measuring Output-off function: smua.source.offfunc = smua.OUTPUT_DCAMPS Normal output-off voltage limit: smua.source.offlimitv = 20 Voltage compliance must be 10% higher than the voltage compliance of SMU 2. Voltage compliance limit (maximum): smua.trigger.source.limitv = 20 SMU 2 configuration: Output-off mode:...
  • Page 118 Section 4: Sourcing and measuring Model 2601B-PULSE System SourceMeter Instrument Reference Manual The following values are based on the current and voltage levels available in Region 4, as shown in the table in Combining SMU outputs (on page 4-14). Set the pulser to disabled: smua.pulser.enable = smua.DISABLE Maximum pulsed signal levels for 2601B-PULSE: 40 V with 9 A compliance...
  • Page 119 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 4: Sourcing and measuring Source voltage with extended current using two 2601B-PULSE instruments in parallel Figure 47: Source voltage with extended current using parallel SMUs The following values are based on the current and voltage levels available in Region 4, as shown in the table in Combining SMU outputs (on page 4-14).
  • Page 120 Section 4: Sourcing and measuring Model 2601B-PULSE System SourceMeter Instrument Reference Manual SMU 2 configuration: Output-off mode: smua.source.offmode = smua.OUTPUT_NORMAL Output-off function: smua.source.offfunc = smua.OUTPUT_DCVOLTS Normal output-off current limit: smua.source.offlimiti = 1e-3 The current compliance of SMU 2 (the voltage source) must be 10% greater than the maximum programmed current of SMU 1 (the current source).
  • Page 121 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 4: Sourcing and measuring Figure 48: Connections for guarding Noise shield Use a noise shield (see following figure) to prevent unwanted signals from being introduced into the test circuit. Low-level signals may benefit from effective shielding. The metal noise shield surrounds the test circuit and should be connected to LO, as shown.
  • Page 122 Section 4: Sourcing and measuring Model 2601B-PULSE System SourceMeter Instrument Reference Manual Figure 49: Noise shield Using shielding and guarding together The following figures show connections for a test system that uses a noise shield, a safety shield, and guarding. The guard shields are connected to the driven guard of the SMU. The noise shield is connected to LO.
  • Page 123 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 4: Sourcing and measuring Figure 50: Using shielding and guarding together Test fixture 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 and an interlock switch.
  • Page 124 Section 4: Sourcing and measuring Model 2601B-PULSE System SourceMeter Instrument Reference Manual To provide protection from shock hazards, an enclosure should be provided that surrounds all live parts. Nonconductive enclosures must be constructed of materials that are suitably rated for flammability and the voltage and temperature requirements of the test circuit.

  • Page 125: Dut Connection Settings

    Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 4: Sourcing and measuring DUT connection settings This section describes the sense mode and output-off state settings. Sense mode selection When the pulser is disabled, the voltage sense mode can be set to use 2-wire local sensing connections (on page 4-10) or...
  • Page 126 Section 4: Sourcing and measuring Model 2601B-PULSE System SourceMeter Instrument Reference Manual Output-off modes Carefully consider and configure the appropriate output-off state, source function, and compliance limits before connecting the 2601B-PULSE to a device that can deliver energy (for example, other voltage sources, batteries, capacitors, solar cells, or other 2601B-PULSE instruments).
  • Page 127 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 4: Sourcing and measuring To configure the output-off mode from the front panel: 1. Press the CONFIG key. 2. Press the OUTPUT ON/OFF control. 3. Select OFF-STATE. 4. Select MODE. 5. Select the output-off mode: HI-Z (high-impedance), NORMAL, or ZERO. 6.
  • Page 128 Section 4: Sourcing and measuring Model 2601B-PULSE System SourceMeter Instrument Reference Manual Selecting the output-off function This setting is used only when the output is turned off and the source-measure unit (SMU) is in NORMAL output-off mode. To configure the output-off function from the front panel: 1.
  • Page 129 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 4: Sourcing and measuring To configure the output-off limits from the front panel: 1. Press the CONFIG key. 2. Press the OUTPUT ON/OFF control. 3. Select OFF-STATE and then select LIMIT. 4. Select CURRENT or VOLTAGE. 5.

  • Page 130: Basic Source-Measure Procedure

    Section 4: Sourcing and measuring Model 2601B-PULSE System SourceMeter Instrument Reference Manual Basic source-measure procedure Front-panel source-measure procedure Use the following procedure to perform the basic source-measure operations of the 2601B-PULSE SMU using the front panel. The following procedure assumes that the 2601B-PULSE is already connected to the device under test (DUT), as explained in DUT test connections (on page 4-6).
  • Page 131 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 4: Sourcing and measuring Step 3: Select the measurement function and range Select measurement function and range as follows: 1. Select the measurement function by pressing the MEAS key. 2. Set the measurement range with the RANGE keys, or enable AUTO range. When setting the range, consider the following points: When measuring the source (such as when sourcing V and measuring V), you cannot select ▪...
  • Page 132 Section 4: Sourcing and measuring Model 2601B-PULSE System SourceMeter Instrument Reference Manual Basic source-measure commands Command Description Enable current measure autorange smua.measure.autorangei = smua.AUTORANGE_ON Enable voltage measure autorange smua.measure.autorangev = smua.AUTORANGE_ON Disable current measure autorange smua.measure.autorangei = smua.AUTORANGE_OFF Disable voltage measure autorange smua.measure.autorangev = smua.AUTORANGE_OFF Set current measure range smua.measure.rangei = rangeval...
  • Page 133 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 4: Sourcing and measuring Source-measure programming example The following SMU programming example illustrates the setup and command sequence of a basic source-measure procedure with the following parameters: • Source function and range: Voltage, autorange •...
  • Page 134 Section 4: Sourcing and measuring Model 2601B-PULSE System SourceMeter Instrument Reference Manual • Some SMU settings are ignored; see Settings ignored when the pulser is enabled (on page 4-36) for details. • The smua.trigger.source.pulsewidth and smua.pulser.measure.delay attributes provide more precise timing than you can achieve using the smua.trigger.endpulse.stimulus and smua.trigger.measure.stimulus attributes.
  • Page 135 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 4: Sourcing and measuring Enable and disable the pulser To use the pulser of the 2601B-PULSE, you must enable it. To enable the pulser, send the command: smua.pulser.enable = smua.ENABLE To disable the pulser, send the command: smua.pulser.enable = smua.DISABLE You can also disable the pulser by resetting the instrument through the front panel or a remote command.
  • Page 136 Section 4: Sourcing and measuring Model 2601B-PULSE System SourceMeter Instrument Reference Manual Settings ignored when the pulser is enabled The following source-measure unit (SMU) settings are ignored when the pulser is enabled: • display.smua.limit.func • smua.measure.autorangeY • smua.measure.autozero • smua.measure.delay •...
  • Page 137 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 4: Sourcing and measuring Examples The following topics contain TSP programming examples for the 2601B-PULSE pulser. You can use these examples as a starting point for your own applications, editing them as needed. Example 1: Ten-point pulse sweep The code in this example uses the trigger model to program a 10-point pulse sweep of 10 µs pulses from 1 A to 10 A with a 1 ms pulse period.
  • Page 138 Section 4: Sourcing and measuring Model 2601B-PULSE System SourceMeter Instrument Reference Manual -- Check contacts against threshold. if not smua.contact.check() then -- Set speed to slow. smua.contact.speed = smua.CONTACT_SLOW -- Get aggregate resistance readings. rhi, rlo = smua.contact.r() -- Return contact resistances to the host. print(rhi, rlo) -- Terminate execution.
  • Page 139 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 4: Sourcing and measuring -- Initiate the trigger model. smua.trigger.initiate() -- Wait for pulse commands to complete. waitcomplete() -- Turn the source output off. smua.source.output = smua.OUTPUT_OFF -- Output the readings stored in the buffer as a comma-separated string. printbuffer(1, smua.nvbuffer1.n, smua.nvbuffer1) Example 2: Generate a pulse with a voltage protection level This example demonstrates how to use the 2601B-PULSE pulser to generate a current pulse with a...
  • Page 140 Section 4: Sourcing and measuring Model 2601B-PULSE System SourceMeter Instrument Reference Manual To program the example pulse, send the following commands: -- Restore instrument defaults and clear measure buffer. reset() smua.nvbuffer1.clear() -- Set the number of pulses to 1. smua.trigger.count = 1 -- Enable source level changes.

  • Page 141: Operation Considerations For The Adc

    Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 4: Sourcing and measuring Operation considerations for the ADC The following paragraphs discuss autozero and NPLC caching with the analog-to-digital converter page 7-1) (ADC). Autozero When the pulser is disabled, the ADC of the 2601B-PULSE uses a ratiometric A/D conversion technique.

  • Page 142: Triggering In Local Mode

    Section 4: Sourcing and measuring Model 2601B-PULSE System SourceMeter Instrument Reference Manual Remote command autozero To set autozero from a remote interface: Use the autozero command with the appropriate option shown in the following table to set autozero through a remote interface. For additional detail, refer to smua.measure.autozero (on page 11-195)).
  • Page 143 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 4: Sourcing and measuring The following figure shows the general sequence for SMU measurement triggering. The basic sequence is as follows: • When the output is turned on, the programmed source value is immediately applied to the device under test (DUT).

  • Page 144: Configuring Trigger Attributes In Local Mode

    Section 4: Sourcing and measuring Model 2601B-PULSE System SourceMeter Instrument Reference Manual Configuring trigger attributes in local mode From the front panel, press the CONFIG key and select TRIG. These menu items are available: • TRIGGER-IN: Use these options to select the trigger-in source: IMMEDIATE: Triggering occurs immediately and the instrument starts to make ▪...

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

    Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 4: Sourcing and measuring Configuring for measure-only tests using the MODE key In addition to being used for conventional source-measure operations, the 2601B-PULSE can also be used like a meter to measure current, voltage, resistance, or power. Measure-only tests are not available when the pulser is enabled.

  • Page 146: Ohms Measurements

    Section 4: Sourcing and measuring Model 2601B-PULSE System SourceMeter Instrument Reference Manual When using the 2601B-PULSE as a voltmeter, the voltage compliance limit must be set higher than the voltage that is being measured. Failure to do this could result in excessive current flow into the 2601B-PULSE, incorrect measurements, and possible damage to the instrument.
  • Page 147 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 4: Sourcing and measuring To make an ohms measurement: 1. Press the SRC key to select the source function. 2. Set the output source (current or voltage, dependent on which function is selected) to a value based on the expected resistance.
  • Page 148 Section 4: Sourcing and measuring Model 2601B-PULSE System SourceMeter Instrument Reference Manual -- Set voltage range to auto. smua.measure.autorangev = smua.AUTORANGE_ON -- Turn on output. smua.source.output = smua.OUTPUT_ON -- Get resistance reading. print(smua.measure.r()) -- Turn off output. smua.source.output = smua.OUTPUT_OFF Ohms sensing Ohms measurements can be made using either 2-wire or 4-wire sensing.

  • Page 149: Power Measurements

    Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 4: Sourcing and measuring 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 150 Section 4: Sourcing and measuring Model 2601B-PULSE System SourceMeter Instrument Reference Manual Basic power measurement procedure If you need to customize the standard wattmeter configuration of the MODE key, perform the following steps to make power measurements. The following procedure assumes that the 2601B-PULSE is already connected to the device under test (DUT) as explained in DUT test connections...

  • Page 151: Saved Setups

    Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 4: Sourcing and measuring Power measurement programming example The following SMU programming example illustrates the setup and command sequence for a typical power measurement procedure with the following parameters: • Source function: Voltage, source autorange, 5 V output •...
  • Page 152 Section 4: Sourcing and measuring Model 2601B-PULSE System SourceMeter Instrument Reference Manual To save a user setup to nonvolatile memory from the front panel: 1. Configure the 2601B-PULSE to the settings that you want to save. 2. Press the MENU key. 3.
  • Page 153 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 4: Sourcing and measuring Start-up configuration You can specify the 2601B-PULSE start-up (power-on) configuration from the 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 154: Range

    Section 4: Sourcing and measuring Model 2601B-PULSE System SourceMeter Instrument Reference Manual Start-up (power-on) configuration You can specify the 2601B-PULSE 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 -- Select power-on setup.
  • Page 155 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 4: Sourcing and measuring The 2601B-PULSE can sustain a measurement speed of 33,000, as determined by: (Pulse rate per second) + (Measurements per second  Filter count) < 33000 If this rate is exceeded, the instrument may not be able to sustain the sweep. Maximum source values and readings The full-scale output for each voltage and current source range is 101 percent of the selected range, but the full-scale measurement is 102 percent of the range.
  • Page 156 Section 4: Sourcing and measuring Model 2601B-PULSE 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 the source and the measure functions are the same, the measure range is locked to the source range.
  • Page 157 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 4: Sourcing and measuring Range considerations The source range and measure range settings can interact depending on the source function. Additionally, the output state (on/off) can affect how the range is set. The following table describes these interactions: If...
  • Page 158 Section 4: Sourcing and measuring Model 2601B-PULSE System SourceMeter Instrument Reference Manual Source range and limit commands Command Description Enable current source autorange. smua.source.autorangei = smua.AUTORANGE_ON Disable current source autorange. smua.source.autorangei = smua.AUTORANGE_OFF Enable voltage source autorange. smua.source.autorangev = smua.AUTORANGE_ON Disable voltage source autorange.

  • Page 159: Digits

    Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 4: Sourcing and measuring Digits The display resolution of the measured reading depends on the DIGITS setting. The default display resolution setting is 6.5 digits. The DIGITS setting selects display resolution for all measurement functions.

  • Page 160: Speed When The Pulser Is Disabled

    Section 4: Sourcing and measuring Model 2601B-PULSE System SourceMeter Instrument Reference Manual Speed when the pulser is disabled The SPEED key 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 161: Sweep Operation

    Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 4: Sourcing and measuring Speed programming example Use the NPLC command to set the speed of the integrating analog-to-digital converter (ADC). The programming example below illustrates how to set the speed to 10 PLC: -- Set NPLC to 10.
  • Page 162 Section 4: Sourcing and measuring Model 2601B-PULSE System SourceMeter Instrument Reference Manual Figure 58: DC and pulsed logarithmic staircase sweeps DC and pulsed list sweeps: The list sweep allows you to program arbitrary sweep steps anywhere within the output voltage or current range of the 2601B-PULSE. The following figure shows a list sweep with arbitrary steps and a pulsed list sweep.
  • Page 163 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 4: Sourcing and measuring 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 164 Section 4: Sourcing and measuring Model 2601B-PULSE System SourceMeter Instrument Reference Manual Linear staircase sweeps As shown below, this sweep type steps from a start voltage or current value to an ending (stop) value. When enabled, a measurement is made at each point after the source and measurement settling time.
  • Page 165 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 4: Sourcing and measuring To configure a linear staircase sweep, use smua.trigger.source.linearY(). This function configures the source values the SMU will output when performing a linear sweep. After configuring the sweep, you must also enable the source action by setting the following attribute: smua.trigger.source.action Example: -- Configure a sweep from 0 to 10 V in 1 V steps.
  • Page 166 Section 4: Sourcing and measuring Model 2601B-PULSE System SourceMeter Instrument Reference Manual Figure 64: Increasing logarithmic sweep Figure 65: 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 start = The number of points in the sweep...
  • Page 167 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 4: Sourcing and measuring The number of points in a sweep is one greater than the number of steps in the sweep. The following figure is an example of a five-point logarithmic sweep from 1 V to 10 V. Figure 66: Logarithmic staircase sweep (1 V to 10 V, five steps) In this example: A = 0, V...
  • Page 168 Section 4: Sourcing and measuring Model 2601B-PULSE System SourceMeter Instrument Reference Manual The log steps for this sweep are listed in the table below. Logarithmic sweep points Source point (N) Source level (V) Step number (i) 1.7783 3.1623 5.6234 When this sweep starts, the output will go to the start level (1 V) and sweep through the symmetrical log points.
  • Page 169 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 4: Sourcing and measuring When the sweep is started, the output level goes to the first point in the sweep. The sweep will continue through the steps in the order that they were programmed. The following figure shows a different example of a list sweep with six measurement points.
  • Page 170 Section 4: Sourcing and measuring Model 2601B-PULSE System SourceMeter Instrument Reference Manual Figure 68: Pulse width control Pulse duty cycle Duty cycle is the percentage of time during the pulse period that the output is on. It is calculated as follows: Duty cycle = Pulse width / (Pulse width + Off time) For example, if the pulse width is 10 ms and the off time is 90 ms, the duty cycle is calculated as follows:...
  • Page 171 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 4: Sourcing and measuring Figure 69: Pulsing in the extended operating area (EOA) Pulse region specification Region Region Maximum Maximum (quadrant maximum pulse width duty cycle diagram) 1 A at 40 V DC, no limit 100% 3 A at 6 V...
  • Page 172 Section 4: Sourcing and measuring Model 2601B-PULSE System SourceMeter Instrument Reference Manual Configuring end sweep actions remotely When the pulser is disabled, use the end sweep action to configure the source action at the end of the sweep. The source-measure unit (SMU) can be programmed to return to the idle source level or hold the last value of the sweep.
  • Page 173 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 4: Sourcing and measuring Source and measurement delays The source and measurement delays described here only apply when the pulser is disabled. Whenever the source-measure unit (SMU) outputs a source value in a sweep, it also applies the programmed source delay.
  • Page 174 Section 4: Sourcing and measuring Model 2601B-PULSE System SourceMeter Instrument Reference Manual Front panel To run a sweep from the front panel: 1. Press the LOAD key, and then select FACTORY. 2. Select the name of the test to run. 3.

  • Page 175: Relative Offset

    Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 4: Sourcing and measuring List sweep example The SMU programming example below illustrates a list sweep. -- Restore 2601B-PULSE defaults. This disables the pulser. smua.reset() -- Set compliance to 10 mA. smua.source.limiti = 10e-3 -- Define voltage list.
  • Page 176 Section 4: Sourcing and measuring Model 2601B-PULSE 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 front panel: 1.

  • Page 177: Filters

    Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 4: Sourcing and measuring Filters The filter feature lets you set the filter response to stabilize noisy measurements. The 2601B-PULSE 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 178 Section 4: Sourcing and measuring Model 2601B-PULSE System SourceMeter Instrument Reference Manual The moving filter uses a first-in, first-out stack. When the stack (filter count) becomes full, the measurement conversions are averaged, yielding a reading. For each subsequent conversion placed into the stack, the oldest conversion is discarded.
  • Page 179 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 4: Sourcing and measuring Configuring the filter Filter type and count are configured from the filter configuration menu on the front panel. The same filter configuration is used for all measurement functions. To configure the filter: 1.

  • Page 180: High-Capacitance Mode

    Section 4: Sourcing and measuring Model 2601B-PULSE System SourceMeter Instrument Reference Manual High-capacitance mode The Keithley Instruments 2601B-PULSE has a high-capacitance mode. Because the source-measure unit (SMU) can measure low current, issues can arise when driving a capacitive load. The pole formed by the load capacitance and the current range resistor can cause a phase shift in the SMU voltage control loop.
  • Page 181 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 4: Sourcing and measuring Understanding source settling times Each 2601B-PULSE can drive up to 50 μF of a capacitance in high-capacitance mode. To accomplish this, the speed of the 2601B-PULSE SMU is reduced. Source settling times increase when high-capacitance mode is enabled.
  • Page 182 Section 4: Sourcing and measuring Model 2601B-PULSE System SourceMeter Instrument Reference Manual relationship between the current limit and the charging time. As the current limit decreases, the amount of time required to charge the capacitor increases. 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"...
  • Page 183 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 4: Sourcing and measuring Front panel To enable high-capacitance mode from the front panel: 1. Press the CONFIG key. 2. Press the SRC key and then select HIGHC-MODE. 3. Select SRC-ENABLE and then press the navigation wheel (or the ENTER key).
  • Page 184 Section 4: Sourcing and measuring Model 2601B-PULSE System SourceMeter Instrument Reference Manual Script example Use the smua.source.highc attribute to set and control the options for high-capacitance mode. The programming examples and figure below illustrate how to enable high-capacitance mode. 1. To enable high-capacitance mode, send: -- Enables high-capacitance mode.
  • Page 185 Section 5 Reading buffers In this section: Overview .................. 5-1 Front-panel reading buffer control ..........5-1 Remote reading buffer programming ........5-6 Overview Reading buffers capture measurements, ranges, instrument status, and output state of the Keithley Instruments 2601B-PULSE. The 2601B-PULSE has two default reading buffers. In addition to the default buffers, you can create user-defined reading buffers.
  • Page 186 Section 5: Reading buffers Model 2601B-PULSE System SourceMeter Instrument Reference Manual • BUFFER1: Configure Buffer 1. CLEAR: Clear buffer (YES or NO). ▪ ELEMENTS: Enable (ON) or disable (OFF) data storage elements. ▪ SRC-VAL: Enable or disable source values. ▪ TSTAMP: Enable or disable timestamps.
  • Page 187 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 5: Reading buffers Appending or overwriting existing reading buffers When storing data to a reading buffer that already holds data, the new data can be appended to the reading buffer data, or it can overwrite the old data. To configure the instrument to append or overwrite measurements the next time data is acquired: 1.
  • Page 188 Section 5: Reading buffers Model 2601B-PULSE System SourceMeter Instrument Reference Manual Saving reading buffers You can save the dedicated reading buffers to nonvolatile memory, or you can save them to a USB flash drive. Note that the instrument restores the dedicated reading buffers from internal nonvolatile memory when the unit is turned off and back on.
  • Page 189 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 5: Reading buffers Recalling readings To recall the data stored in a reading buffer: 1. Press the RECALL key. 2. Select DATA or STATISTICS. 3. Select the buffer to display CHANA-BUFF1 or CHANA-BUFF2. The data or statistics are displayed.

  • Page 190: Command

    Section 5: Reading buffers Model 2601B-PULSE 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 191 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 5: Reading buffers Commands to store readings The number of measurements to acquire. smua.measure.count = count Makes current measurements; stores readings in smua.measure.overlappedi(rbuffer) rbuffer. Makes both current and voltage measurements; stores smua.measure.overlappediv(ibuffer, current readings in ibuffer and stores voltage vbuffer) readings in vbuffer.
  • Page 192 Section 5: Reading buffers Model 2601B-PULSE 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 smua.nvbuffer1.clear() or smua.nvbuffer2.clear() command.
  • Page 193 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 5: Reading buffers Buffer read-only attributes The following table contains buffer read-only attributes. Buffer read-only attributes: Read-only attributes used to access buffer parameters Storage attribute Description The timestamp of when the reading at rb[1] was stored, in seconds from midnight basetimestamp January 1, 1970 GMT.
  • Page 194 Section 5: Reading buffers Model 2601B-PULSE System SourceMeter Instrument Reference Manual Statistic attributes Use the smua.buffer.getstats() function to access the reading buffer data statistics. The table below displays the attributes that you can use to access the reading buffer statistics. The returned parameter has the attributes described in the following table.
  • Page 195 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 5: Reading buffers 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. Recall attributes Recall attribute* Description...
  • Page 196 Section 5: Reading buffers Model 2601B-PULSE 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 buffer 1, use the following command: stat_info = smua.nvbuffer1.statuses[2] Buffer status bits...

  • Page 197: Smua.measure.autorangei = Smua.autorange_On

    Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 5: Reading buffers -- Restore 2601B-PULSE defaults. smua.reset() -- Select channel A display. display.screen = display.SMUA -- Display current. display.smua.measure.func = display.MEASURE_DCAMPS -- Select measure I autorange. smua.measure.autorangei = smua.AUTORANGE_ON -- Select ASCII data format. format.data = format.ASCII -- Clear buffer 1.
  • Page 198 Section 5: Reading buffers Model 2601B-PULSE System SourceMeter Instrument Reference Manual -- Set buffer count to 100. smua.measure.count = 100 -- Set measure interval to 0.1 s. smua.measure.interval = 0.1 -- Select source voltage function. smua.source.func = smua.OUTPUT_DCVOLTS -- Output 1 V. smua.source.levelv = 1 -- Turn on output.
  • Page 199 Section 6 Triggering In this section: Triggering ................. 6-1 Remote triggering overview............6-1 SMU event detectors ..............6-8 Using trigger events to start actions on trigger objects ... 6-10 Digital I/O port and TSP-Link synchronization lines ....6-11 Timers ..................6-13 Event blenders ...............
  • Page 200 Section 6: Triggering Model 2601B-PULSE System SourceMeter Instrument Reference Manual The following figure graphically represents all the trigger objects of the 2601B-PULSE instrument. Figure 73: Triggering overview Trigger events are identified by means of an event ID. The following table describes the trigger event IDs.
  • Page 201 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 6: Triggering Trigger event IDs* Event ID Event description Occurs when a *TRG command is received on the trigger.EVENT_ID remote interface GPIB only: Occurs when a GET bus command is received USB only: Occurs when a USBTMC TRIGGER message is received VXI-11 only: Occurs with the VXI-11 command device_trigger;...
  • Page 202 Section 6: Triggering Model 2601B-PULSE System SourceMeter Instrument Reference Manual Figure 74: Trigger model: Synchronous mode 2601B-PULSE-901-01A April 2020...
  • Page 203 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 6: Triggering Figure 75: Trigger model: Asynchronous mode Trigger model sections As shown in the previous figures, the trigger model consists of the sections idle, arm layer, and trigger layer. The SMU is in the idle state if a sweep is not in process. Use the smua.trigger.initiate() function to move the SMU from the idle state to the arm layer.
  • Page 204 Section 6: Triggering Model 2601B-PULSE System SourceMeter Instrument Reference Manual Each sweep starts and ends in the arm layer. All source, measurement, and pulse actions occur in the trigger layer. The source outputs the programmed voltage or current source value. Measurements can be current, voltage, resistance, or power.
  • Page 205 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 6: Triggering 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 206: Smu Event Detectors

    Section 6: Triggering Model 2601B-PULSE System SourceMeter Instrument Reference Manual SMU event detectors As shown in the Using the remote trigger model (on page 6-3) topic, the source-measure unit (SMU) has multiple event detectors (see the table below) in order to control the timing of various actions. Each event detector monitors for the trigger event assigned to the associated stimulus input.
  • Page 207 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 6: Triggering The programming example below illustrates how to configure a 10-point linear voltage sweep on SMU A, where each step is triggered by the TRIG key: -- Configure a 10-point source voltage sweep. smua.trigger.source.linearv(1, 10, 10) smua.trigger.source.action = smua.ENABLE -- Configure TRIG key press as input trigger for source action.

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

    Section 6: Triggering Model 2601B-PULSE System SourceMeter Instrument Reference Manual 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. To configure a trigger object to monitor for an event, assign the event ID of the trigger event to the stimulus input.

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

    Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 6: Triggering Digital I/O port and TSP-Link synchronization lines The 2601B-PULSE has two sets of hardware lines that can be used for triggering: 14 digital I/O lines and three TSP-Link synchronization lines. These trigger objects can be configured and controlled in ®...
  • Page 210 Section 6: Triggering Model 2601B-PULSE System SourceMeter Instrument Reference Manual -- Configure the 2601B-PULSE to detect a rising -- edge on digital I/O line 2. digio.trigger[2].mode = digio.TRIG_RISINGA digio.trigger[2].clear() -- Configure SMU A to start its source action when a -- trigger event occurs on digital I/O line 2.

  • Page 211: Timers

    Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 6: Triggering Action overruns on hardware lines An action overrun occurs when a trigger event is received before the digital I/O or TSP-Link line is ® ready to process it. The generation of an action overrun is dependent upon the trigger mode selected for that line.
  • Page 212 Section 6: Triggering Model 2601B-PULSE System SourceMeter Instrument Reference Manual Pass-through mode When enabled, the timer generates a trigger event immediately when it is triggered. The timer generates additional trigger events each time a delay expires. If the pass-through attribute is disabled, the timer does not generate a trigger event until after the first delay elapses.
  • Page 213 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 6: Triggering Timer action overruns The timer receives an action overrun when it generates a trigger event while a timer delay is still in progress. Use the status model to monitor for the occurrence of action overruns. For details, see the Status model (on page 15-1).
  • Page 214 Section 6: Triggering Model 2601B-PULSE System SourceMeter Instrument Reference Manual Figure 80: Single pulse triggering 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 215 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 6: Triggering Pulse train example The SMU programming example below illustrates how to use two timers: One to control the pulse period, a second to control the pulse width. The example configures the timers and SMU as follows: Timer 1: Pulse period timer •...
  • Page 216 Section 6: Triggering Model 2601B-PULSE System SourceMeter Instrument Reference Manual The following figure shows the trigger setup for this example. Figure 82: Pulse train triggering 6-18 2601B-PULSE-901-01A April 2020...

  • Page 217: Event Blenders

    Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 6: Triggering 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. period_timer = trigger.timer[1] pulse_timer = trigger.timer[2] -- Create a fixed level voltage sweep.

  • Page 218: Lan Triggering Overview

    Section 6: Triggering Model 2601B-PULSE System SourceMeter Instrument Reference Manual 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 219 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 6: Triggering Understanding hardware value and pseudo line state LAN triggering is similar to hardware synchronization except that LXI trigger packets are used instead of hardware signals. A bit in the LXI trigger packet called the hardware value simulates the state of a hardware trigger line.

  • Page 220: Command Interface Triggering

    Section 6: Triggering Model 2601B-PULSE System SourceMeter Instrument Reference Manual 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 221: Trigger Generator

    Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 6: Triggering The command queue can fill up with trigger entries if too many *TRG messages are received while a test script is running, even if the script is processing triggers. You can avoid this by using the localnode.prompts4882 attribute (see TSP command reference (on page 11-1) for more...
  • Page 222 Section 6: Triggering Model 2601B-PULSE System SourceMeter Instrument Reference Manual Detecting trigger events using the wait() function All the 2601B-PULSE trigger objects (except for SMUs) have built-in event detectors that monitor for trigger events. The event detector only monitors events generated by that object and cannot be configured to monitor events generated by any other trigger object.
  • Page 223 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 6: Triggering Using the release function of the hardware lines Use the release function to allow the hardware line to output another external trigger when the pulse width is set to 0. Setting the pulse width to 0 results in an indefinite length pulse when the assert function is used to output an external trigger.
  • Page 224 Section 6: Triggering Model 2601B-PULSE System SourceMeter Instrument Reference Manual Event detector overruns If a second trigger event is generated before an event detector clears, the trigger object generates a detector overrun. You can check for detector overruns by reading the overrun attribute of the trigger object.
  • Page 225 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 6: Triggering 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 226: Hardware Trigger Modes

    Section 6: Triggering Model 2601B-PULSE System SourceMeter Instrument Reference Manual 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 2601B-PULSE supports 14 digital I/O lines and three TSP-Link synchronization lines that can be used for input or output triggering.
  • Page 227 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 6: Triggering Figure 84: Falling edge output trigger Rising edge master trigger mode 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.
  • Page 228 Section 6: Triggering Model 2601B-PULSE System SourceMeter Instrument Reference Manual Rising edge acceptor trigger mode The rising edge acceptor trigger mode (RisingA) generates a low pulse and detects rising edge pulses. Refer to the following figures. Input characteristics: • All rising edges generate an input event. Figure 86: RisingA input trigger Output characteristics: •...
  • Page 229 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 6: Triggering Either edge trigger mode The either edge trigger mode generates a low pulse and detects both rising and falling edges. Input characteristics: • All rising or falling edges generate an input trigger event. Figure 88: Either edge input trigger Output characteristics: •...

  • Page 230: Understanding Synchronous Triggering Modes

    Section 6: Triggering Model 2601B-PULSE System SourceMeter Instrument Reference Manual Understanding synchronous triggering modes Use the synchronous triggering modes to implement bidirectional triggering, to wait for one node, or to wait for a collection of nodes to complete all triggered actions. All non-Keithley instrumentation must have a trigger mode that functions similar to the SynchronousA or SynchronousM trigger modes.
  • Page 231 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 6: Triggering Figure 90: Synchronous master input trigger Output characteristics: • In addition to trigger events from other trigger objects, the digio.trigger[N].assert() and tsplink.trigger[N].assert() functions generate a low pulse that is similar to the falling edge trigger mode.
  • Page 232 Section 6: Triggering Model 2601B-PULSE System SourceMeter Instrument Reference Manual Synchronous acceptor trigger mode (SynchronousA) Use the synchronous acceptor trigger mode (SynchronousA) on a trigger subordinate that operates with a trigger master configured for the SynchronousM trigger mode. The roles of the internal and external drives are reversed in the SynchronousA trigger mode.
  • Page 233 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 6: Triggering 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 234: Digital I/O

    Section 6: Triggering Model 2601B-PULSE System SourceMeter Instrument Reference Manual Digital I/O The 2601B-PULSE has a digital input/output port that can be used to control external digital circuitry. For example, you can use a handler that is used to perform binning operations with a digital I/O port. Port configuration The digital I/O port, a standard female DB-25 connector (shown below), is on the rear panel.
  • Page 235 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 6: Triggering Digital I/O configuration The following figure shows the basic configuration of the digital I/O port. Writing a 1 to a line sets that line high (~ +5 V). Writing a 0 to a line sets that line low (~0 V). Note that an external device pulls an I/O line low by shorting it to ground, so that a device must be able to sink at least 960 μA per I/O line.
  • Page 236 Section 6: Triggering Model 2601B-PULSE System SourceMeter Instrument Reference Manual To write-protect specific digital I/O lines to prevent their values from being changed: 1. Press the MENU key, then select DIGOUT, and then press the ENTER key or the navigation wheel 2.
  • Page 237 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 6: Triggering 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 11-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 238 Section 6: Triggering Model 2601B-PULSE System SourceMeter Instrument Reference Manual Connecting to the TSP-Link system The TSP-Link ® trigger lines are built into the TSP-Link connection. Use the TSP-Link connectors on the back of the 2601B-PULSE. If you are using a TSP-Link network, you do not have to modify any connections.
  • Page 239 Section 7 Theory of operation In this section: Analog-to-digital converters............7-1 Source-measure concepts ............7-1 Measurement settling time considerations ......7-26 Effects of load on current source settling time......7-27 Creating pulses with the 2601B-PULSE SMU ......7-28 Analog-to-digital converters The 2601B-PULSE uses analog-to-digital converters (ADCs) in the SMU and pulser circuits.
  • Page 240 Section 7: Theory of operation Model 2601B-PULSE System SourceMeter Instrument Reference Manual Limit principles A limit acts as a clamp. If the output reaches the limit value, the 2601B-PULSE SMU attempts to prevent the output from exceeding that value. This action switches the source from a voltage source to a current source (or from a current source to a voltage source) when a limit is reached.
  • Page 241 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 7: Theory of operation To calculate the maximum duty cycle (DC ), use the general power equation shown below. The general power equation describes how much power an instrument can source and sink before the total power cannot be fully dissipated by the cooling system of the instrument.
  • Page 242 Section 7: Theory of operation Model 2601B-PULSE System SourceMeter Instrument Reference Manual Duty cycle with the pulser enabled When the pulser is enabled, the instrument limits the duty cycle using the formula shown below. If a trigger model attempts to exceed this duty cycle, the output is turned off and an error is generated. To avoid this, use the following formula to calculate the maximum allowed duty cycle for your pulser operating conditions.
  • Page 243 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 7: Theory of operation Optimizing apertures and filters for the 1 MS/s sample rate When the pulser is enabled, a measurement request or measurement trigger generates a burst of readings. Each burst is equal to the measure count times the filter count. A burst is limited to a maximum of 3500 readings.
  • Page 244 Section 7: Theory of operation Model 2601B-PULSE System SourceMeter Instrument Reference Manual Figure 99: Data acquisition to reading buffer flow Operating boundaries Source or sink Depending on how it is programmed and what is connected to the output (load or source), the instrument can operate in any of the four quadrants.
  • Page 245 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 7: Theory of operation Continuous power operating boundaries The general operating boundaries for continuous power output are shown in the following figure (for derating factors, see General power and maximum duty cycle equations (on page 7-2)).
  • Page 246 Section 7: Theory of operation Model 2601B-PULSE System SourceMeter Instrument Reference Manual Voltage source operating boundaries The following figure shows the operating boundaries for the V-source when the pulser is disabled. Only the first quadrant of operation is shown. Operation in the other three quadrants is similar. The following graph shows the output characteristics for the V-source.
  • Page 247 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 7: Theory of operation Load considerations for voltage source The boundaries within which the 2601B-PULSE 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 248 Section 7: Theory of operation Model 2601B-PULSE System SourceMeter Instrument Reference Manual Figure 105: Voltage source operation in current compliance Voltage source operation in power compliance The figure below shows what happens if a power limit of 60 mW is applied. As the instrument attempts to output the programmed source value of 10 V, the power compliance limit line is reached, placing the 2601B-PULSE in power compliance.
  • Page 249 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 7: Theory of operation 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 2601B-PULSE is programmed to sweep voltage to 10 V, limit current (6 mA) and limit power (50 mW). When sweeping, the actual source output varies according to the programmed source value until the current limit is reached.
  • Page 250 Section 7: Theory of operation Model 2601B-PULSE System SourceMeter Instrument Reference Manual The current compliance limit applies both to positive and negative currents. For example, if you set the current compliance limit to 50 mA, the current limit applies to ±50 mA. For this example, the 2601B-PULSE is programmed to source 2 V and to limit current to 50 mA.
  • Page 251 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 7: Theory of operation Source-measure capabilities The following table lists the source and measure limits for the voltage and current functions. The maximum power is 40.4 W per channel. Source-measure capabilities Voltage range Source Measure 100 mV...
  • Page 252 Section 7: Theory of operation Model 2601B-PULSE System SourceMeter Instrument Reference Manual Current source operating boundaries The following figures show the operating boundaries for the current source when the pulser is disabled. Only the first quadrant of operation is shown; operation in the other quadrants is similar. The first figure shows the output characteristics for the current source.
  • Page 253 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 7: Theory of operation Load considerations for current source The boundaries within which the 2601B-PULSE 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 254 Section 7: Theory of operation Model 2601B-PULSE System SourceMeter Instrument Reference Manual Figure 113: Current source operation in voltage compliance Current source operation in power compliance The following figure shows the results when a power limit of 600 mW is applied. As the instrument attempts to output the programmed source value of 100 mA, the power limited voltage compliance limit line is reached, placing the instrument in power compliance.
  • Page 255 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 7: Theory of operation 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). When sweeping, the actual source output varies according to the programmed source value until the voltage limit is reached.
  • Page 256 Section 7: Theory of operation Model 2601B-PULSE System SourceMeter Instrument Reference Manual Figure 116: Sourcing current sink operation example The voltage compliance limit applies both to positive and negative voltages. For example, if you set the voltage compliance limit to 15 V, the voltage limit applies to ±15 V. For this example, the 2601B-PULSE is programmed to source −50 mA (the constant current) and to limit voltage to 15 V.
  • Page 257 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 7: Theory of operation Figure 117: Considerations when sourcing current and sinking power Basic circuit configurations The following topics describe the source, measure, and contact check circuit configurations when the pulser is disabled. 2601B-PULSE-901-01A April 2020 7-19...
  • Page 258 Section 7: Theory of operation Model 2601B-PULSE System SourceMeter Instrument Reference Manual Source V When configured to source voltage (V-source) as shown in the figure below, the 2601B-PULSE functions as a low-impedance voltage source with current limit capability and can measure current (I-meter) or voltage (V-meter).
  • Page 259 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 7: 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 260 Section 7: Theory of operation Model 2601B-PULSE System SourceMeter Instrument Reference Manual Source I measure I, source V measure V The System SourceMeter ® Instrument can measure the same function that it is sourcing. For example, when sourcing a voltage, you can measure voltage. Conversely, if you are sourcing current, you can measure the output current.
  • Page 261 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 7: Theory of operation In the following figure, the instrument uses a 2-wire local sensing configuration and is set to measure current only by setting it to source 0 V and measure current. Note that to obtain positive (+) readings, conventional current must flow from HI to LO.
  • Page 262 Section 7: Theory of operation Model 2601B-PULSE System SourceMeter Instrument Reference Manual Figure 122: Contact check circuit 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 263 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 7: Theory of operation Guard connections Guard is typically used to drive the guard shields of cables and test fixtures. Guard is extended to a test fixture from the cable guard shield. Inside the test fixture, the guard can be connected to a guard plate or shield that surrounds the device-under-test (DUT).
  • Page 264 Section 7: Theory of operation Model 2601B-PULSE System SourceMeter Instrument Reference Manual Figure 124: Guarded measurements Measurement settling time considerations This information applies when the pulser is disabled. 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 265 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 7: Theory of operation You can manipulate both the analog filter and the default delays to produce faster response times. Turn off the analog filter to yield faster settling times. Control the default delays by using the delay factor multiplier.
  • Page 266 Section 7: Theory of operation Model 2601B-PULSE System SourceMeter Instrument Reference Manual Maximum DUT impedances for specified settling time performance Range SMU feedback impedance Maximum DUT impedance 1 nA 1 GΩ 2 GΩ 10 nA 120 MΩ 60 MΩ 100 nA 40 MΩ...
  • Page 267 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 7: Theory of operation Figure 125: Pulse rise and fall times When the pulser is enabled, pulse rise and fall times are largely independent of range, load (within the specified limits of ±10 V and < 3 µH), or protection limit settings. Refer to the 2601B-PULSE SMU specifications for details on source settling times.
  • Page 268 Section 7: Theory of operation Model 2601B-PULSE System SourceMeter Instrument Reference Manual SMU pulse width The pulse width is the interval between 10% on the rising (leading) edge to 90% on the falling (trailing) edge. In the extended operating area, the SMU automatically limits the pulse width to the maximum value allowed for the region in which the SMU is operating, even if you have configured a longer pulse width.
  • Page 269 Section 8 Maintenance In this section: Introduction ................8-1 Displaying the serial number ............ 8-1 Line fuse replacement .............. 8-2 Front-panel tests ..............8-3 Upgrading the firmware ............8-5 Introduction The information in this section describes routine maintenance of the instrument that the operator can perform.
  • Page 270 Section 8: Maintenance Model 2601B-PULSE System SourceMeter Instrument Reference Manual Line fuse replacement A fuse on the 2601B-PULSE rear panel protects the power line input of the instrument. See the following instructions to replace the fuse. You do not need to return your instrument for service if the fuse is damaged.
  • Page 271 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 8: Maintenance Front-panel tests The front-panel tests test the functionality of the front-panel keys and the display. In the following procedures, highlight the menu item and press the ENTER key to select it. You can also select a menu item by pressing the navigation wheel Keys test This test lets you check the functionality of each front-panel key.
  • Page 272 Section 8: Maintenance Model 2601B-PULSE System SourceMeter Instrument Reference Manual Display patterns test This test lets you verify that each pixel and indicator in the vacuum fluorescent display is working properly. Perform the following steps to run the display test: 1.
  • Page 273 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 8: Maintenance Upgrading the firmware You can upgrade or downgrade the firmware using the front-panel USB port or Test Script Builder (TSB). The process should take less than five minutes. The upgrade file has a name such as 2600B-P-850SVn.n.n.x, where n.n.n is the firmware version.
  • Page 274 Section 8: Maintenance Model 2601B-PULSE System SourceMeter Instrument Reference Manual 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 2601B-PULSE. To upgrade the firmware using Test Script Builder: 1.
  • Page 275 Section 9 Introduction to TSP operation In this section: Introduction to TSP operation........... 9-1 About TSP commands ............. 9-3 Factory scripts ................ 9-19 Introduction to TSP operation Instruments that are enabled for Test Script Processor (TSP ) operate like conventional instruments ®...
  • Page 276 Section 9: Introduction to TSP operation Model 2601B-PULSE System SourceMeter Instrument Reference Manual Functions Function-based commands control actions or activities. A function-based command performs an immediate action on the instrument. Each function consists of a function name followed by a set of parentheses ( ). You should only include information in the parentheses if the function takes a parameter.
  • Page 277 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 9: Introduction to TSP operation To read an attribute, you can use the attribute as the parameter of a function, or assign it to another variable. Example 3: Read an attribute using a function print(format.data) Reads the data format by passing the attribute to the print function.
  • Page 278 Section 9: Introduction to TSP operation Model 2601B-PULSE System SourceMeter Instrument Reference Manual Bit manipulation and logic operations The bit functions perform bitwise logic operations on two given numbers, and bit operations on one given number. Logic and bit operations truncate the fractional part of given numbers to make them integers.
  • Page 279 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 9: Introduction to TSP operation Calibration smua.cal.adjustdate (on page 11-179) smua.cal.date (on page 11-180) smua.cal.due (on page 11-181) smua.cal.lock() (on page 11-182) smua.cal.password (on page 11-182) smua.cal.polarity (on page 11-183) smua.cal.restore() (on page 11-184) smua.cal.save() (on page 11-184) smua.cal.state...
  • Page 280 Section 9: Introduction to TSP operation Model 2601B-PULSE System SourceMeter Instrument Reference Manual Digital I/O The digital I/O port of the instrument can control external circuitry (such as a component handler for binning operations). The I/O port has 14 lines. Each line can be at TTL logic state 1 (high) or 0 (low). See the pinout diagram in Digital I/O port (on page 6-36) for additional information.
  • Page 281 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 9: Introduction to TSP operation display.trigger.clear() (on page 11-72) display.trigger.EVENT_ID (on page 11-73) display.trigger.overrun (on page 11-73) display.trigger.wait() (on page 11-74) display.waitkey() (on page 11-74) Error queue When errors and events occur, the error and status messages are placed in the error queue. Use the error queue commands to request error and status message information.
  • Page 282 Section 9: Introduction to TSP operation Model 2601B-PULSE System SourceMeter Instrument Reference Manual For basic information about navigation and directory listing of files on a flash drive, see File system navigation (on page 3-29). File descriptor commands for file I/O use a colon (:) to separate the command parts rather than a period (.), like the io commands.
  • Page 283 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 9: Introduction to TSP operation Instrument identification These commands store strings that describe the instrument. localnode.description (on page 11-139) localnode.model (on page 11-140) localnode.revision (on page 11-145) localnode.serialno (on page 11-145) LAN and LXI The LAN commands have options that allow you to review and configure network settings.
  • Page 284 Section 9: Introduction to TSP operation Model 2601B-PULSE System SourceMeter Instrument Reference Manual lan.status.port.dst (on page 11-125) lan.status.port.rawsocket (on page 11-126) lan.status.port.telnet (on page 11-126) lan.status.port.vxi11 (on page 11-127) lan.status.speed (on page 11-127) lan.status.subnetmask (on page 11-128) lan.timedwait (on page 11-128) lan.trigger[N].assert() (on page 11-129) lan.trigger[N].clear()
  • Page 285 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 9: Introduction to TSP operation 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 286 Section 9: Introduction to TSP operation Model 2601B-PULSE System SourceMeter Instrument Reference Manual Reset Resets settings to their default settings. digio.trigger[N].reset() (on page 11-49) lan.reset() (on page 11-120) localnode.reset() (on page 11-144) reset() (on page 11-156) smua.reset() (on page 11-222) timer.reset() (on page 11-349) trigger.blender[N].reset()
  • Page 287 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 9: Introduction to TSP operation script.new() (on page 11-160) script.newautorun() (on page 11-161) script.restore() (on page 11-162) script.run() (on page 11-162) script.user.catalog() (on page 11-163) scriptVar.autorun (on page 11-163) scriptVar.list() (on page 11-164) scriptVar.name (on page 11-165) scriptVar.run()
  • Page 288 Section 9: Introduction to TSP operation Model 2601B-PULSE System SourceMeter Instrument Reference Manual smua.reset() (on page 11-222) smua.savebuffer() (on page 11-222) smua.sense (on page 11-223) smua.source.autorangeY (on page 11-224) smua.source.compliance (on page 11-226) smua.source.delay (on page 11-226) smua.source.func (on page 11-227) smua.source.highc (on page 11-228) smua.source.levelY...
  • Page 289 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 9: Introduction to TSP operation Status model The status model is a set of status registers and queues. You can use the following commands to manipulate and monitor these registers and queues to view and control various instrument events. status.condition (on page 11-263) status.measurement.*...
  • Page 290 Section 9: Introduction to TSP operation Model 2601B-PULSE System SourceMeter Instrument Reference Manual Time bufferVar.basetimestamp (on page 11-18) bufferVar.collecttimestamps (on page 11-24) bufferVar.timestampresolution (on page 11-36) bufferVar.timestamps (on page 11-37) delay() (on page 11-42) gettimezone() (on page 11-97) os.time() (on page 11-152) settime() (on page 11-172) settimezone()
  • Page 291 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 9: Introduction to TSP operation smua.trigger.arm.count (on page 11-237) smua.trigger.arm.set() (on page 11-238) smua.trigger.arm.stimulus (on page 11-239) smua.trigger.ARMED_EVENT_ID (on page 11-240) smua.trigger.autoclear (on page 11-240) smua.trigger.count (on page 11-241) smua.trigger.endpulse.action (on page 11-243) smua.trigger.endpulse.set() (on page 11-243) smua.trigger.endpulse.stimulus...
  • Page 292 Section 9: Introduction to TSP operation Model 2601B-PULSE System SourceMeter Instrument Reference Manual trigger.timer[N].wait() (on page 11-364) trigger.wait() (on page 11-364) tsplink.trigger[N].assert() (on page 11-369) tsplink.trigger[N].clear() (on page 11-370) tsplink.trigger[N].EVENT_ID (on page 11-370) tsplink.trigger[N].mode (on page 11-371) tsplink.trigger[N].overrun (on page 11-372) tsplink.trigger[N].pulsewidth (on page 11-373) tsplink.trigger[N].release()
  • Page 293 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 9: Introduction to TSP operation tspnet.read() (on page 11-383) tspnet.readavailable() (on page 11-384) tspnet.reset() (on page 11-385) tspnet.termination() (on page 11-385) tspnet.timeout (on page 11-386) tspnet.tsp.abort() (on page 11-387) tspnet.tsp.abortonconnect (on page 11-387) tspnet.tsp.rbtablecopy() (on page 11-388) tspnet.tsp.runscript()
  • Page 294 Section 9: Introduction to TSP operation Model 2601B-PULSE System SourceMeter Instrument Reference Manual 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 295 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 9: Introduction to TSP operation Retrieving and modifying a factory script listing The script listing for a factory script can be retrieved and modified. However, it cannot be saved as a factory script. The modified script can be saved as a user script using the same name or a new name. An imported factory script can only be loaded back into the 2601B-PULSE as a user script.
  • Page 296 Section 9: Introduction to TSP operation Model 2601B-PULSE System SourceMeter Instrument Reference Manual KIParlib factory script The KIParlib factory script is made up of two functions: gm_vsweep() and gm_isweep(). gm_vsweep() (on page 11-98) gm_isweep() (on page 11-97) KISavebuffer factory script The KISavebuffer script has one function: savebuffer().

  • Page 297: Fundamentals Of Scripting For Tsp

    Section 10 Instrument programming In this section: Fundamentals of scripting for TSP ......... 10-1 Fundamentals of programming for TSP ....... 10-13 Test Script Builder ..............10-30 Password management ............10-34 Advanced scripting for TSP ..........10-36 TSP-Link system expansion interface ........10-45 TSP-Net ................
  • Page 298 Section 10: Instrument programming Model 2601B-PULSE 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 front panel of the instrument that prompt the operator to enter parameters.
  • Page 299 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 10: Instrument programming Commands that cannot be used in scripts Though the instrument accepts the following commands, you cannot use these commands in scripts. Commands that cannot be used in scripts General commands IEEE Std 488.2 common commands abort *CLS...
  • Page 300 Section 10: Instrument programming Model 2601B-PULSE 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 runtime environment). When a named script is loaded into the runtime environment with the loadscript or loadandrunscript commands, a global variable with the same name is created to reference the script.
  • Page 301 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 10: Instrument programming Figure 129: Loadscript and endscript example 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. 2.
  • Page 302 Section 10: Instrument programming Model 2601B-PULSE System SourceMeter Instrument Reference Manual When you load the file MyScript1.tsp from the flash drive, a script named Beeper is created in the runtime environment. Note that the script is named using the name that follows the loadscript keyword, not the name of the TSP file on the flash drive.
  • Page 303 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 10: Instrument programming Run scripts This section describes how to run the anonymous and named scripts. On the front panel, items are available through the USER menu if you explicitly add them to the menu. The items the menu selections represent can be scripts, function calls, or instrument commands.
  • Page 304 Section 10: Instrument programming Model 2601B-PULSE System SourceMeter Instrument Reference Manual Run a user script from the instrument front panel From the front panel, you can load and run a script that was previously added to the USER menu. To run the code from the front panel and add it to the USER menu: 1.
  • Page 305 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 10: Instrument programming Autorun scripts Autorun scripts run automatically when the instrument is turned on. You can set any number of scripts to autorun. The run order for autorun scripts is arbitrary, so make sure the run order is not important. As shown in the example below, you can set a script to run automatically by setting the .autorun attribute of the script to "yes"...
  • Page 306 Section 10: Instrument programming Model 2601B-PULSE System SourceMeter Instrument Reference Manual Working with scripts in nonvolatile memory Fundamentals of scripting for TSP (on page 10-1) section in this manual describes working with scripts, primarily in the runtime environment. You can also work with scripts in nonvolatile memory. The runtime environment and nonvolatile memory are separate storage areas in the instrument.
  • Page 307 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 10: Instrument programming Save the anonymous script as a named script To save the anonymous script to nonvolatile memory, you must name it first. To save the anonymous script as a named script: 1.
  • Page 308 Section 10: Instrument programming Model 2601B-PULSE System SourceMeter Instrument Reference Manual Example: Delete a user script from nonvolatile memory Delete a user script named test8 from nonvolatile memory. script.delete("test8") Interactive script example An interactive script prompts the operator to input values using front panel controls. The following example script uses display messages to prompt the operator to: •...

  • Page 309: Fundamentals Of Programming For Tsp

    Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 10: Instrument programming if measEnable == "ENABLE" then -- Inform the user that measurements are in progress display.setcursor(1, 1) display.settext("$BPlease wait.$R$NMeasure operation in progress.") smua.measure.i(smua.nvbuffer1) display.clear() -- Inform the user that the Source Measure operation has finished display.settext("Operation Finished$NSource-Measure Complete") else -- Inform the user that the Source operation has finished...
  • Page 310 Section 10: Instrument programming Model 2601B-PULSE System SourceMeter Instrument Reference Manual Comments You can start a comment anywhere outside a string by typing a double hyphen (--). If the text immediately after -- is anything other than double left brackets ([[), the comment is a short comment, which continues until the end of the line.
  • Page 311 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 10: Instrument programming Top level command names beeper gcinfo status gettimezone print string collectgarbage gpib printbuffer timer dataqueue printnumber tonumber delay reset tostring digio localnode savebuffer trigger display makegetter script tsplink errorqueue makesetter serial tspnet...
  • Page 312 Section 10: Instrument programming Model 2601B-PULSE System SourceMeter Instrument Reference Manual To determine the type of a variable, you can call the type() function, as shown in the examples below. The output you get from these examples may vary depending on the data format that is set. Example: Nil x = nil print(x, type(x))
  • Page 313 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 10: Instrument programming Functions With Lua, you can group commands and statements using the function keyword. Functions can take zero, one, or multiple parameters, and they return zero, one, or multiple values. You can use functions to form expressions that calculate and return a value.
  • Page 314 Section 10: Instrument programming Model 2601B-PULSE System SourceMeter Instrument Reference Manual Example 2 Creates a variable named add_three that has a add_three = function(first_value, variable type of function. second_value, third_value) return first_value + second_value + Output: third_value print(add_three(3, 4, 5)) Example 3 Returns multiple parameters (sum, difference, and function sum_diff_ratio(first_value,...
  • Page 315 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 10: Instrument programming Operators You can compare and manipulate Lua variables and constants using operators. Arithmetic operators Operator Description addition subtraction multiplication division negation (for example, c = −a) exponentiation Relational operators Operator Description less than...
  • Page 316 Section 10: Instrument programming Model 2601B-PULSE System SourceMeter Instrument Reference Manual String concatenation String operators Operator Description Concatenates two strings. If either argument is a number, it is coerced to a string (in a reasonable format) before concatenation. Example: Concatenation print(2 ..
  • Page 317 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 10: Instrument programming Conditional branching Lua uses the if, else, elseif, then, and end keywords to do conditional branching. Note that in Lua, nil and false are false and everything else is true. Zero (0) is true in Lua. The syntax of a conditional block is as follows: if expression then block...
  • Page 318 Section 10: Instrument programming Model 2601B-PULSE 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.") else...
  • Page 319 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 10: Instrument programming Example: While This loop exits when list[element] = list = { "One", "Two", "Three", "Four", "Five", "Six"} nil. print("Count list elements on numeric index:") Output: element = 1 Count list elements on while list[element] do numeric index: print(element, list[element])
  • Page 320 Section 10: Instrument programming Model 2601B-PULSE 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 321 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 10: 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. Return and break statements can only be written as the last statement of a block.
  • Page 322 Section 10: Instrument programming Model 2601B-PULSE System SourceMeter Instrument Reference Manual Example: Break with infinite loop This example uses a break statement that a, b = 0, 1 causes the while loop to exit if the value of a while true do becomes greater than 500.
  • Page 323 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 10: 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 324 Section 10: Instrument programming Model 2601B-PULSE System SourceMeter Instrument Reference Manual Lua uses two numbers to control its garbage-collection cycles. One number counts how many bytes of dynamic memory Lua is using; the other is a threshold. When the number of bytes crosses the threshold, Lua runs the garbage collector, which reclaims the memory of all inaccessible objects.
  • Page 325 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 10: 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 326: Test Script Builder

    Section 10: Instrument programming Model 2601B-PULSE System SourceMeter Instrument Reference Manual Programming example The following script puts a message on the front-panel display slowly, one character at a time. This example demonstrates: • The use of a for loop • Simple display remote commands •...
  • Page 327 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 10: Instrument programming 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 328 Section 10: Instrument programming Model 2601B-PULSE System SourceMeter Instrument Reference Manual Figure 130: 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 329 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 10: 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 330: Password Management

    Section 10: Instrument programming Model 2601B-PULSE System SourceMeter Instrument Reference Manual Programming interaction This part of the workspace is where you interact with the scripts that you are building in Test Script Builder (TSB). The actual contents of the programming interaction area of the workspace can vary. You can send commands from the Instrument Console command line, retrieve data, view variables and errors, and view and set breakpoints when using the debug feature.
  • Page 331 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 10: Instrument programming To enable the password from a command interface: To lock the instrument when you are away from the testing area, send the following command: password The remote interface is locked. The 2601B-PULSE does not respond to commands issued from the command interface until you unlock the interface.

  • Page 332: Advanced Scripting For Tsp

    Section 10: Instrument programming Model 2601B-PULSE System SourceMeter Instrument Reference Manual Advanced scripting for TSP The following topics describe advanced information that can help you understand how the Test Script Processor (TSP ) scripting engine works. ® Global variables and the script.user.scripts table When working with script commands, it is helpful to understand how scripts are handled in the instrument.
  • Page 333 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 10: Instrument programming Figure 131: 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 334 Section 10: Instrument programming Model 2601B-PULSE System SourceMeter Instrument Reference Manual For example, to set up a two-second beep, you can send the command: beepTwoSec = script.new("beeper.enable = 1 beeper.beep(2, 2400)", "beepTwoSec") To run the new script, send the command: beepTwoSec() When you add beepTwoSec, the global variable and script.user.scripts table entries are made to the runtime environment, as shown in the following figure.
  • Page 335 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 10: Instrument programming Figure 133: Create an unnamed script A script becomes unnamed if you create a new script with the same name. In this circumstance, the name of the script in the script.user.scripts table is set to an empty string before it is replaced by the new script.
  • Page 336 Section 10: Instrument programming Model 2601B-PULSE System SourceMeter Instrument Reference Manual Figure 134: Create a new script with the name of an existing script 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.
  • Page 337 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 10: Instrument programming If the new name is the same as a name that is already used for a script, the name of the existing script is removed and that script becomes unnamed. This removes the existing script if there are no other variables that reference the previous script.
  • Page 338 Section 10: Instrument programming Model 2601B-PULSE System SourceMeter Instrument Reference Manual Retrieve a user script There are several ways to retrieve the source code of a user script: • One line at a time: Use scriptVar.list() to retrieve the source code one line at a time •...
  • Page 339 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 10: Instrument programming Retrieve a script as a single string To retrieve the entire user script source code as a single string, use the scriptVar.source attribute. The loadscript or loadandrunscript and endscript keywords are not included. To retrieve the source code as a single string, send the command: print(scriptVar.source) Where scriptVar is the name of the script.
  • Page 340 Section 10: Instrument programming Model 2601B-PULSE System SourceMeter Instrument Reference Manual Restore a script to the runtime environment You can retrieve a script that was removed from the runtime environment but is still saved in nonvolatile memory. To restore a script from nonvolatile memory into the runtime environment, you can use script.restore("scriptName"), where scriptName is the user-defined name of the script to be restored.

  • Page 341: Tsp-Link System Expansion Interface

    Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 10: Instrument programming If the instrument encounters memory allocation errors when the memory used is above 95 percent, the state of the instrument cannot be guaranteed. After attempting to save any important data, turn off power to the instrument and turn it back on to reset the runtime environment and return the instrument to a known state.
  • Page 342 Section 10: Instrument programming Model 2601B-PULSE System SourceMeter Instrument Reference Manual Master and subordinates In a TSP-Link ® system, one of the nodes (instruments) is the master node and the other nodes are the subordinate nodes. The master node in a TSP-Link system can control the other nodes ®...
  • Page 343 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 10: Instrument programming Connections Connections for an expanded system are shown in the following figure. As shown, one instrument is optionally connected to the computer using the GPIB, LAN, USB, or RS-232 interface. Details about these computer communication connections are described in Remote communications interfaces page 2-11).
  • Page 344 Section 10: Instrument programming Model 2601B-PULSE System SourceMeter Instrument Reference Manual To assign a node number using a remote command: Set the tsplink.node attribute of the instrument: tsplink.node = N Where N = 1 to 64 To determine the node number of an instrument, you can read the tsplink.node attribute by sending the following command: print(tsplink.node) The above print command outputs the node number.
  • Page 345 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 10: Instrument programming An attempted TSP-Link reset operation will fail if any of the following conditions are true: • Two or more instruments in the system have the same node number • There are no other instruments connected to the instrument performing the reset (only if the expected number of nodes was not provided in the reset call) •...
  • Page 346 Section 10: Instrument programming Model 2601B-PULSE 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 347 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 10: Instrument programming TSP advanced features Use the Test Script Processor (TSP ) scripting engine's advanced features to: ® • Run test scripts simultaneously • Manage resources allocated to test scripts that are running simultaneously •...
  • Page 348 Section 10: Instrument programming Model 2601B-PULSE System SourceMeter Instrument Reference Manual A group consists of one or more nodes with the same group number. The following figure displays a single TSP-Link network with groups. This method requires one TSP-Link network and a single GPIB connection to the computer.
  • Page 349 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 10: Instrument programming Using groups to manage nodes on TSP-Link network The primary purpose of groups is to allow each group to run a different test script simultaneously. A group can consist of one or more nodes. You must assign group numbers to each node using remote commands.
  • Page 350 Section 10: Instrument programming Model 2601B-PULSE 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. Each time the power for a node is turned off, the group number for that node changes to 0.
  • Page 351 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 10: Instrument programming Coordinating overlapped operations in remote groups All overlapped operations on all nodes in a group must have completed before the master node can send a command to the group. If you send a command to a node in a remote group when an overlapped operation is running on any node in that group, errors will occur.
  • Page 352 Section 10: Instrument programming Model 2601B-PULSE System SourceMeter Instrument Reference Manual Using the data queue for real-time communication Nodes that are running test scripts at the same time can store data in the data queue for real-time communication. Each instrument has an internal data queue that uses the first-in, first-out (FIFO) structure to store data.
  • Page 353 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 10: Instrument programming Removing stale values from the reading buffer cache The node that acquires the data also stores the data for the reading buffer. To optimize data access, all nodes can cache data from the node that stores the reading buffer data. When you run Lua code remotely, it can cause reading buffer data that is held in the cache to become stale.

  • Page 354: Tsp-Net

    Section 10: Instrument programming Model 2601B-PULSE System SourceMeter Instrument Reference Manual TSP-Net The TSP-Net library allows the 2601B-PULSE to control LAN-enabled devices directly through its ® LAN port. This enables the 2601B-PULSE to communicate directly with a device that is not TSP ®...
  • Page 355 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 10: Instrument programming To set up communication to a remote ethernet-enabled instrument that is TSP ® enabled: 1. Send the following command to configure TSP-Net to send an abort command when a connection to a TSP instrument is established: tspnet.tsp.abortonconnect = 1 If the scripts are allowed to run, the connection is made, but the remote instrument may be busy.
  • Page 356 Section 10: Instrument programming Model 2601B-PULSE System SourceMeter Instrument Reference Manual Example script The following example demonstrates how to connect to a remote device that is not TSP enabled, ® and send and receive data from this device: -- Set tspnet timeout to 5 s. tspnet.timeout = 5 -- Establish connection to another device with IP address 192.168.1.51 -- at port 1394.
  • Page 357 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 10: Instrument programming TSP-Net instrument commands: General device control The following instrument commands provide general device control: tspnet.clear() (on page 11-379) tspnet.connect() (on page 11-380) tspnet.disconnect() (on page 11-381) tspnet.execute() (on page 11-382) tspnet.idn() (on page 11-383) tspnet.read()
  • Page 358 Section 10: Instrument programming Model 2601B-PULSE 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. print(string.format("from computer-->...
  • Page 359 Section 11 TSP command reference In this section: TSP command programming notes ........11-1 Using the TSP command reference ........11-4 TSP commands ..............11-8 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 360 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual Example 3: smua.trigger.measure.Y(rbuffer) Where: • Y is the measurement type that you specify (v, i, r, or p). • rbuffer is the reading buffer object where the readings will be stored. For example, to make voltage measurements and store them in buffer vbuffername, you would send: smua.trigger.measure.v(vbuffername)
  • Page 361 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference Settings ignored when the pulser is enabled The following source-measure unit (SMU) settings are ignored when the pulser is enabled: • display.smua.limit.func • smua.measure.autorangeY • smua.measure.autozero • smua.measure.delay •...
  • Page 362 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual Using the TSP command reference The Test Script Processor (TSP ) command reference contains detailed descriptions of each of the ® TSP commands that you can use to control your instrument. Each command description is broken into subsections.
  • Page 363 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference Figure 140: TSP command name and summary table 1. Instrument command name. Indicates the beginning of the command description. It is followed by a brief description of what the command does. 2.
  • Page 364 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual 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 365 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference Example section The Example section of the remote command description shows examples of how you can use the command. Figure 143: TSP example code Actual example code that you can copy from this table and paste into your own programming application.
  • Page 366 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual 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 Function Usage...
  • Page 367 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference Details This command enables or disables the beeper. When enabled, a beep signals that a front-panel key has been pressed. Disabling the beeper also disables front-panel key clicks. Example Enables the beeper and generates a beeper.enable = beeper.ON...
  • Page 368 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual bit.bitor() This function performs a bitwise logical OR operation on two numbers. Type TSP-Link accessible Affected by Where saved Default value Function Usage result = bit.bitor(value1, value2) Result of the logical OR operation result Operand for the logical OR operation value1...
  • Page 369 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference Example Performs a logical XOR operation on decimal 10 (binary 1010) testResult = bit.bitxor(10, 9) with decimal 9 (binary 1001), which returns a value of decimal 3 (binary 0011). print(testResult) Output: 3.00000e+00...
  • Page 370 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual 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) Result of the bit manipulation result Specified number...
  • Page 371 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference bit.getfield() This function returns a field of bits from the value starting at the specified index position. Type TSP-Link accessible Affected by Where saved Default value Function Usage result = bit.getfield(value, index, width) Result of the bit manipulation result...
  • Page 372 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual bit.set() This function sets a bit at the specified index position. Type TSP-Link accessible Affected by Where saved Default value Function Usage result = bit.set(value, index) Result of the bit manipulation result Specified number value...
  • Page 373 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference bit.setfield() This function overwrites a bit field at a specified index position. Type TSP-Link accessible Affected by Where saved Default value Function Usage result = bit.setfield(value, index, width, fieldValue) Result of the bit manipulation result Specified number...
  • Page 374 Section 11: TSP command reference Model 2601B-PULSE 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) Result of the bit manipulation...
  • Page 375 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference bit.toggle() This function toggles the value of a bit at a specified index position. Type TSP-Link accessible Affected by Where saved Default value Function Usage result = bit.toggle(value, index) Result of the bit manipulation result Specified number...
  • Page 376 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual Usage state = bufferVar.appendmode bufferVar.appendmode = state The reading buffer append mode; set to one of the following: state ▪ 0: Append mode off; new measurement data overwrites the previous buffer content ▪...
  • Page 377 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference Details This read-only attribute contains the timestamp (in seconds) of the first reading stored in a buffer (rb[1] stored in reading buffer rb). The timestamp is the number of seconds since 12:00 am January 1, 1970 (UTC) that the measurement was performed and stored.
  • Page 378 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual If you run successive operations that overwrite reading buffer data, the reading buffer may return stale cache data. This can happen when initiating successive sweeps without reconfiguring the sweep measurements or when overwriting data in the reading buffer by setting the bufferVar.fillmode attribute to smua.FILL_WINDOW.
  • Page 379 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference Example Reads the capacity of dedicated reading bufferCapacity = smua.nvbuffer1.capacity buffer 1 (source-measure unit (SMU) channel A). print(bufferCapacity) Output: 1.49789e+05 The above output indicates that the buffer can hold 149789 readings. Also see Reading buffers (on page 5-1)
  • Page 380 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual bufferVar.clearcache() This function clears the cache. Type TSP-Link accessible Affected by Where saved Default value Function Usage bufferVar.clearcache() The reading buffer; can be a dynamically allocated user-defined buffer or a dedicated bufferVar reading buffer Details...
  • Page 381 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference bufferVar.collectsourcevalues This attribute sets whether or not source values are stored with the readings in the buffer. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Not applicable See Details 0 (disabled)
  • Page 382 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual bufferVar.collecttimestamps This attribute sets whether or not timestamp values are stored with the readings in the buffer. Type TSP-Link accessible Affected by Where saved Default value See Details Attribute (RW) Not applicable 0 (disabled)
  • Page 383 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference 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 The reading buffer fill count fillCount...
  • Page 384 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual Usage fillMode = bufferVar.fillmode bufferVar.fillmode = fillMode The reading buffer fill mode; set to one of the following: fillMode ▪ 0 or smua.FILL_ONCE: Do not overwrite old data ▪...
  • Page 385 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference Details The measurefunctions buffer recall attribute is like an array (a Lua table) of strings indicating the function measured for the reading. For dedicated reading buffers, all buffer attributes are saved to nonvolatile memory only when the reading buffer is saved to nonvolatile memory.
  • Page 386 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual Details The measureranges buffer recall attribute is like an array (a Lua table) of full-scale range values for the measure range used when the measurement was made. For dedicated reading buffers, all buffer attributes are saved to nonvolatile memory only when the reading buffer is saved to nonvolatile memory.
  • Page 387 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference 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. Also see bufferVar.measurefunctions (on page 11-26)
  • Page 388 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual Example Output the first reading saved in print(smua.nvbuffer1.readings[1]) source-measure unit (SMU) channel A, dedicated reading buffer 1. Output: 8.81658e-08 Also see bufferVar.measurefunctions (on page 11-26) bufferVar.measureranges (on page 11-27) bufferVar.n (on page 11-28) bufferVar.sourcefunctions...
  • Page 389 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference Example 2 Print the source function used printbuffer(1, 10, smua.nvbuffer1.sourcefunctions) for 10 readings stored in dedicated reading buffer 1. Example output: Voltage, Voltage, Voltage, Voltage, Voltage, Voltage, Voltage, Voltage, Voltage, Voltage Also see bufferVar.measurefunctions...
  • Page 390 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual Example Print the source output for the first printbuffer(1, 1, smua.nvbuffer1.sourceoutputstates) reading stored in dedicated reading buffer 1. Example output: Also see bufferVar.measurefunctions (on page 11-26) bufferVar.measureranges (on page 11-27) bufferVar.n (on page 11-28) bufferVar.readings...
  • Page 391 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference Example 2 Print the source ranges that were used for printbuffer(1, 6, smua.nvbuffer1.sourceranges) the first 6 readings stored in source-measure unit (SMU) A, buffer 1. Example output: 1.00000e-04, 1.00000e-04, 1.00000e-04, 1.00000e-04, 1.00000e-04, 1.00000e-04 Also see...
  • Page 392 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual Example 1 Get the sourced value of the first reading sourcevalue = smua.nvbuffer1.sourcevalues[1] stored in dedicated reading buffer 1. Example 2 Print the sourced value of the first 6 readings printbuffer(1, 6, smua.nvbuffer1.sourcevalues) stored in source-measure unit (SMU) A, buffer 1.
  • Page 393 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference Buffer status bits Name Description when bit is true Pulser 0x01 Pulser is enabled Overtemp 0x02 Overtemperature condition AutoRangeMeas 0x04 Measure range was autoranged AutoRangeSrc 0x08 Source range was autoranged 4Wire 0x10 4-wire (remote) sense mode enabled...
  • Page 394 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual bufferVar.timestampresolution This attribute contains the resolution of the timestamp. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Not applicable See Details 1e-6 (1 µs) Usage resolution = bufferVar.timestampresolution Timestamp resolution in seconds (minimum 1 µs) resolution...
  • Page 395 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: 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 Default value Attribute (R) Clearing the buffer...
  • Page 396 Section 11: TSP command reference Model 2601B-PULSE 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) The resulting value of true or false based on the success of the function result value...
  • Page 397 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: 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 The variable that is assigned the value of dataqueue.CAPACITY count...
  • Page 398 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual Example This example fills the data queue and prints the MaxCount = dataqueue.CAPACITY number of items in the queue. It then clears the while dataqueue.count < MaxCount do queue and prints the number of items again.
  • Page 399 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference Also see dataqueue.add() (on page 11-38) dataqueue.CAPACITY (on page 11-39) dataqueue.clear() (on page 11-39) dataqueue.next() (on page 11-41) Using the data queue for real-time communication (on page 10-56) dataqueue.next() This function removes the next entry from the data queue.
  • Page 400 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual Also see dataqueue.add() (on page 11-38) dataqueue.CAPACITY (on page 11-39) dataqueue.clear() (on page 11-39) dataqueue.count (on page 11-40) format.asciiprecision (on page 11-89) Using the data queue for real-time communication (on page 10-56) delay() This function delays the execution of the commands that follow it.
  • Page 401 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: 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 11-43) digio.writebit() (on page 11-52) digio.writeport() (on page 11-52) Digital I/O port (on page 6-36) digio.readport()
  • Page 402 Section 11: TSP command reference Model 2601B-PULSE 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 403 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: 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 eventID Digital I/O trigger line (1 to 14)
  • Page 404 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual Details Set triggerMode to one of the following values: Trigger mode values Description triggerMode digio.TRIG_BYPASS or 0 Allows direct control of the line. Detects falling-edge triggers as input; asserts a TTL-low pulse digio.TRIG_FALLING or 1 for output.
  • Page 405 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: 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 Digital I/O trigger N reset Recall setup Usage...
  • Page 406 Section 11: TSP command reference Model 2601B-PULSE 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 20 μs.
  • Page 407 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference digio.trigger[N].reset() This function resets trigger values to their factory defaults. Type TSP-Link accessible Affected by Where saved Default value Function Usage digio.trigger[N].reset() Digital I/O trigger line (1 to 14) Details This function resets the following attributes to factory default settings: ▪...
  • Page 408 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual digio.trigger[N].stimulus This attribute selects the event that causes a trigger to be asserted on the digital output line. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Instrument reset Not saved Digital I/O trigger N reset...
  • Page 409 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference Example 1 digio.trigger[3].stimulus = 0 Clear the trigger stimulus of digital I/O line 3. Example 2 digio.trigger[3].stimulus = smua.trigger.SOURCE_COMPLETE_EVENT_ID Set the trigger stimulus of digital I/O line 3 to be the source complete event. Also see digio.trigger[N].assert() (on page 11-44)
  • Page 410 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual digio.writebit() This function sets a digital I/O line high or low. Type TSP-Link accessible Affected by Where saved Default value Function Usage digio.writebit(N, data) Digital I/O trigger line (1 to 14) The value to write to the bit: data ▪...
  • Page 411 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference Details The binary representation of data indicates the output pattern to be written to the I/O port. For example, a data value of 170 has a binary equivalent of 00000010101010. Lines 2, 4, 6, and 8 are set high (1), and the other 10 lines are set low (0).
  • Page 412 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual display.clear() This function clears all lines of the front-panel display. Type TSP-Link accessible Affected by Where saved Default value Function Usage display.clear() Details This function switches to the user screen and then clears the front-panel display. The display.clear(), display.setcursor(), and display.settext() functions are overlapped commands.
  • Page 413 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference Annunciator (indicator) bitmasked values and equivalent constants Indicator Weighted Equivalent constant value FILT display.ANNUNCIATOR_FILTER MATH display.ANNUNCIATOR_MATH display.ANNUNCIATOR_4_WIRE AUTO display.ANNUNCIATOR_AUTO display.ANNUNCIATOR_ARM TRIG display.ANNUNCIATOR_TRIGGER * (asterisk) display.ANNUNCIATOR_STAR SMPL display.ANNUNCIATOR_SAMPLE EDIT display.ANNUNCIATOR_EDIT display.ANNUNCIATOR_ERROR 1024...
  • Page 414 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual display.getcursor() This function reads the present position of the cursor on the front-panel display. Type TSP-Link accessible Affected by Where saved Default value Function Usage row, column, style = display.getcursor() The row where the cursor is: 1 (top row);...
  • Page 415 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference 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 front-panel key pressed; see Details for keyCode more information Details...
  • Page 416 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual Example key = display.getlastkey() print(key) On the front panel, press the MENU key and then send the code shown here. This retrieves the key code for the last pressed key. Output: 6.80000e+01 Also see...
  • Page 417 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference 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: ABCDEFGHIJKLMNOPQRST$Nabcdefghijklmnopqrstuvwxyz123456 $RABCDEFGHIJ$DKLMNOPQRST$N$Rabcdefghijklm$Bnopqrstuvwxyz$F123456 abcdefghijklmnopqrstuvwxyz123456...
  • Page 418 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual 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 419 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference display.loadmenu.add() This function adds an entry to the USER menu, which can be accessed by pressing the LOAD key on the front panel. Type TSP-Link accessible Affected by Where saved Default value Function...
  • Page 420 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual 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. Now assume you want to add a test named “Test”...
  • Page 421 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference display.loadmenu.delete() This function removes an entry from the USER menu, which can be accessed using the LOAD key on the front panel. Type TSP-Link accessible Affected by Where saved Default value Function Usage...
  • Page 422 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual Example Disables the front-panel EXIT (LOCAL) key. display.locallockout = display.LOCK Also see None display.menu() This function presents a menu on the front-panel display. Affected by Where saved Default value Type TSP-Link accessible Function...
  • Page 423 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference display.numpad This attribute controls whether the front panel keys act as a numeric keypad during value entry. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Instrument reset Saved setup 1 (display.ENABLE)
  • Page 424 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual Details This function creates an editable input field at the present cursor position, and an input prompt message on the bottom line. Example of a displayed input field and prompt: 0.00V Input 0 to +2V The format parameter uses zeros (0), the decimal point, polarity sign, and exponents to define how...
  • Page 425 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference display.screen This attribute contains the selected display screen. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Instrument reset Saved setup 0 (display.SMUA) Recall setup Usage displayID = display.screen display.screen = displayID One of the following values:...
  • Page 426 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual Key codes Value Key list Value Key list display.KEY_RANGEUP 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_TRIG display.KEY_DISPLAY display.KEY_LIMITA display.KEY_AUTO display.KEY_SPEEDA display.KEY_EXIT display.KEY_LOAD display.KEY_FILTERA display.WHEEL_ENTER display.KEY_STORE display.KEY_RIGHT display.KEY_SRCA display.KEY_LEFT display.KEY_CONFIG...
  • Page 427 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference Example Select 5-1/2 digit resolution. display.smua.digits = display.DIGITS_5_5 Also see Display resolution (on page 3-16) display.setcursor() This function sets the position of the cursor. Affected by Where saved Default value Type TSP-Link accessible...
  • Page 428 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual display.settext() This function displays text on the front-panel user screen. Type TSP-Link accessible Affected by Where saved Default value Function Usage display.settext("text") Text message to be displayed, with optional character codes text Details This function selects the user display screen and displays the given text.
  • Page 429 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference Also see display.clear() (on page 11-54) display.getcursor() (on page 11-56) display.gettext() (on page 11-58) display.screen (on page 11-67) display.setcursor() (on page 11-69) display.smua.limit.func This attribute specifies the type of limit value setting displayed for the SMU. Type TSP-Link accessible Affected by...
  • Page 430 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual Usage func = display.smua.measure.func display.smua.measure.func = func The type of measurement: func ▪ 0 or display.MEASURE_DCAMPS: Current measurement function ▪ 1 or display.MEASURE_DCVOLTS: Voltage measurement function ▪ 2 or display.MEASURE_OHMS: Resistance measurement function ▪...
  • Page 431 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference display.trigger.EVENT_ID This constant is the event ID of the event generated when the front-panel TRIG key is pressed. Type TSP-Link accessible Affected by Where saved Default value Constant Usage eventID = display.trigger.EVENT_ID The trigger event number...
  • Page 432 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual display.trigger.wait() This function waits for the TRIG key on the front panel to be pressed. Type TSP-Link accessible Affected by Where saved Default value Function Usage triggered = display.trigger.wait(timeout) true: Trigger was detected triggered false: The operation timed out...
  • Page 433 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference 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 434 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual 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 15-3) topic for additional information about the error queue.
  • Page 435 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference 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() The error code number for the entry errorCode...
  • Page 436 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual Also see Error queue (on page 15-3) errorqueue.clear() (on page 11-76) errorqueue.count (on page 11-76) Error summary list (on page 12-2) eventlog.all() This function returns all entries from the event log as a single string and removes them from the event log. Affected by Where saved Default value...
  • Page 437 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference eventlog.clear() This function clears the event log. Type TSP-Link accessible Affected by Where saved Default value Function Usage eventlog.clear() Details This command removes all messages from the event log. Also see eventlog.all() (on page 11-78)
  • Page 438 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual 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 eventlog.enable = status...
  • Page 439 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference eventlog.next() This function returns the oldest unread event message from the event log and removes it from the event log. Type TSP-Link accessible Affected by Where saved Default value Function Usage logString = eventlog.next()
  • Page 440 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual eventlog.overwritemethod This attribute controls how the event log processes events if the event log is full. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Instrument reset Not saved 1 (eventlog.DISCARD_OLDEST) Recall setup...
  • Page 441 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference Also see waitcomplete() (on page 11-393) fileVar:close() This function closes the file that is represented by the fileVar variable. Type TSP-Link accessible Affected by Where saved Default value Function Usage fileVar:close()
  • Page 442 Section 11: TSP command reference Model 2601B-PULSE 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() The file descriptor variable to flush fileVar Details The fileVar:write() or io.write() functions buffer data, which may not be written immediately to the USB flash drive.
  • Page 443 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference fileVar:read() This function reads data from a file. Type TSP-Link accessible Affected by Where saved Default value Function Usage data1 = fileVar:read() data1 = fileVar:read(format1) data1, data2 = fileVar:read("format1", "format2") data1, ..., datan = fileVar:read("format1", ..., "formatn") First data read from the file data1...
  • Page 444 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual Example local fileName = "/usb1/myfile.txt" if fs.is_file(fileName) then os.remove(fileName) print("Removing file") else print("Nothing removed") print("fileVar:read") myfile, myfile_err, myfile_errnum = io.open(fileName, "w") myfile:write("Line 1") myfile:close() myfile, myfile_err, myfile_errnum = io.open(fileName, "r") contents = myfile:read("*a") print(contents) myfile:close()
  • Page 445 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference Details The whence parameters may be any of the following: "set": Beginning of file "cur": Current position "end": End of file If an error is encountered, it is logged to the error queue, and the command returns nil and the error string.
  • Page 446 Section 11: TSP command reference Model 2601B-PULSE 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) The file descriptor variable fileVar Write all data to the file data...
  • Page 447 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference format.asciiprecision This attribute sets the precision (number of digits) for all numbers returned in the ASCII format. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Instrument reset Not saved Recall setup...
  • Page 448 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual Usage order = format.byteorder format.byteorder = order Byte order value as follows: order ▪ Most significant byte first: 0, format.NORMAL, format.NETWORK, or format.BIGENDIAN ▪ Least significant byte first: 1, format.SWAPPED or format.LITTLEENDIAN Details This attribute selects the byte order in which data is written when you are printing data values with the printnumber() and printbuffer() functions.
  • Page 449 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference format.data This attribute sets the data format for data that is printed using the printnumber() and printbuffer() functions. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Instrument reset Not saved 1 (format.ASCII)
  • Page 450 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual Also see format.asciiprecision (on page 11-89) format.byteorder (on page 11-89) printbuffer() (on page 11-154) printnumber() (on page 11-155) fs.chdir() This function sets the current working directory. Affected by Where saved Default value Type...
  • Page 451 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference 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() The absolute path of the current working directory path Example if fs.is_dir("/usb1/temp") == true then...
  • Page 452 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual Example 1 print("Is directory: ", fs.is_dir("/usb1/")) Because /usb1/ is always the root directory of an inserted flash drive, you can use this command to verify that USB flash drive is inserted. Example 2 if fs.is_dir("/usb1/temp") == false then fs.mkdir("/usb1/temp")
  • Page 453 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference 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") The returned path of the new directory path Location (path) of where to create the new directory newpath...
  • Page 454 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual Example rootDirectory = "/usb1/" entries = fs.readdir(rootDirectory) count = table.getn(entries) print("Found a total of "..count.." files and directories") for i = 1, count do print(entries[i]) Insert a USB flash drive into the front panel of the instrument. Set rootDirectory to be the USB port.
  • Page 455 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference gettimezone() This function retrieves the local time zone. Type TSP-Link accessible Affected by Where saved Default value Function Usage timeZone = gettimezone() The local time zone of the instrument timeZone Details See settimezone() for additional details about the time zone format and a description of the fields.
  • Page 456 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual Details Output data includes transconductance values, reading buffer with measured voltages, reading buffer with measured voltages and currents. If all parameters are omitted when this function is called, this function is executed with the parameters set to the default values.
  • Page 457 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference Example SMU A returns G values only. gm_array = gm_vsweep(smua, 0, 5, 20) SMU A returns G and reading buffer with gm_array, ibuf = gm_vsweep(smua, 0, 5, 20) measured currents.
  • Page 458 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual i_leakage_measure() This KIHighC factory script function performs a current leakage measurement after stepping the output voltage. Type TSP-Link accessible Affected by Where saved Default value Function Usage imeas = i_leakage_measure(smua, levelv, limiti, sourcedelay, measurei, measuredelay) The measured current imeas Voltage level to step to when this function is called...
  • Page 459 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference Also see i_leakage_threshold() (on page 11-101) High-capacitance mode (on page 4-80) KIHighC factory script (on page 9-21) 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 460 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual Example smua.source.highc = smua.ENABLE smua.source.levelv = 5 smua.source.output = smua.OUTPUT_ON delay(1) pass = i_leakage_threshold(smua, 0, 1, 300e-3, 10e-6, 100e-3, 1e-6, 1) Enable high-capacitance mode. Charge the capacitor. The parameters passed on to the i_threshold_measure() function in this example are: smu = smua levelv = 0 V limiti = 1 A...
  • Page 461 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference Example testFile, testError = io.open("testfile.txt", "w") if nil == testError then testFile:write("This is my test file") io.close(testFile) Opens file testfile.txt for writing. If no errors were found while opening, writes "This is my test file" and closes the file.
  • Page 462 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual io.input() This function assigns a previously opened file, or opens a new file, as the default input file. Type TSP-Link accessible Affected by Where saved Default value Yes (see Details) Function Usage fileVar = io.input()
  • Page 463 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference Example Opens file testfile.txt for writing. testFile, testError = io.open("testfile.txt", "w") If no errors were found while opening, if testError == nil then writes "This is my test file" and testFile:write("This is my test file") closes the file.
  • Page 464 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual Also see io.input() (on page 11-104) io.open() (on page 11-104) io.read() This function reads data from the default input file. Type TSP-Link accessible Affected by Where saved Default value Function Usage data1 = io.read()
  • Page 465 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference Example local fileName = "/usb1/myfile.txt" if fs.is_file(fileName) then os.remove(fileName) print("Removing file") else print("Nothing removed") errorqueue.clear() -- io.read print("\n*** io.read") myfile, myfile_err, myfile_errnum = io.open(fileName, "w") myfile:write("Line 1\n") myfile:flush() myfile:close() fileHandle = io.input(fileName) value = io.read("*a")
  • Page 466 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual Example local fileName = "/usb1/myfile.txt" if fs.is_file(fileName) then os.remove(fileName) print("Removing file") else print("Nothing removed") errorqueue.clear() print("\n*** io.type") myfile, myfile_err, myfile_errnum = io.open(fileName, "w") myfile:write("Line 1") myfile:close() fileHandle = io.output(fileName) state = io.type(fileHandle) print(state) io.close(fileHandle)
  • Page 467 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference Data is not immediately 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 468 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual Re-initialization takes effect even if the configuration has not changed since the last time the instrument connected to the LAN. Example Re-initialize the LAN interface with new settings. lan.applysettings() Also see None...
  • Page 469 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference 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" Usage dnsAddress = lan.config.dns.address[N] lan.config.dns.address[N] = "dnsAddress" DNS server IP address dnsAddress Entry index (1 or 2)
  • Page 470 Section 11: TSP command reference Model 2601B-PULSE 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" Dynamic DNS registration domain;...
  • Page 471 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference Details Dynamic DNS registration works with DHCP to register the host name with the DNS server. The host name is specified in the lan.config.dns.hostname attribute. Example Outputs the dynamic registration state. print(lan.config.dns.dynamic) If dynamic DNS registration is enabled, the response is: 1.00000e+00...
  • Page 472 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual Also see lan.config.dns.domain (on page 11-112) lan.config.dns.dynamic (on page 11-112) lan.restoredefaults() (on page 11-121) 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)
  • Page 473 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference Details This attribute does not indicate the actual setting currently in effect. Use the lan.status.duplex attribute to determine the present operating state of the LAN. Example Select the LAN duplex mode to full. lan.config.duplex = lan.FULL Also see lan.restoredefaults()
  • Page 474 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual lan.config.ipaddress This command specifies the LAN IP address. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) LAN restore defaults Nonvolatile memory "192.168.0.2" Usage ipAddress = lan.config.ipaddress lan.config.ipaddress = "ipAddress"...
  • Page 475 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference Details This attribute controls how the LAN IP address, subnet mask, default gateway address, and DNS server addresses are determined. When method is lan.AUTO, the instrument first attempts to configure the LAN settings using dynamic host configuration protocol (DHCP).
  • Page 476 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual lan.config.subnetmask This attribute contains the LAN subnet mask. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) LAN restore defaults Nonvolatile memory "255.255.255.0" Usage mask = lan.config.subnetmask lan.config.subnetmask = "mask"...
  • Page 477 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference Example Outputs the present LAN link timeout setting. print(lan.linktimeout) Also see lan.autoconnect (on page 11-110) lan.restoredefaults() (on page 11-121) lan.lxidomain This attribute contains the LXI domain. Type TSP-Link accessible Affected by Where saved Default value...
  • Page 478 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual lan.nagle This attribute controls the state of the LAN Nagle algorithm. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Power cycle Not saved 0 (lan.DISABLE) Usage state = lan.nagle lan.nagle = state...
  • Page 479 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference lan.restoredefaults() This function resets LAN settings to default values. Type TSP-Link accessible Affected by Where saved Default value Function Usage lan.restoredefaults() Details The settings that are restored are shown in the following table. Settings that are restored to default Attribute Default setting...
  • Page 480 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual lan.status.dns.address[N] This attribute contains the DNS server IP addresses. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Not applicable Not applicable Not applicable Usage dnsAddress = lan.status.dns.address[N] DNS server IP address dnsAddress Entry index (1, 2, or 3)
  • Page 481 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference Details A fully qualified domain name (FQDN), sometimes referred to as an absolute domain name, is a domain name that specifies its exact location in the tree hierarchy of the Domain Name System (DNS).
  • Page 482 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual lan.status.gateway This attribute contains the gateway address presently in use by the LAN interface. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Not applicable Not applicable Not applicable Usage gatewayAddress = lan.status.gateway...
  • Page 483 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference lan.status.macaddress This attribute contains the LAN MAC address. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Not applicable Not applicable Not applicable Usage macAddress = lan.status.macaddress The instrument MAC address macAddress Details...
  • Page 484 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual lan.status.port.rawsocket This attribute contains the LAN raw socket connection port number. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Not applicable Not applicable Not applicable Usage port = lan.status.port.rawsocket Raw socket port number...
  • Page 485 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference lan.status.port.vxi11 This attribute contains the LAN VXI-11 connection port number. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Not applicable Not applicable Not applicable Usage port = lan.status.port.vxi11 LAN VXI-11 port number port...
  • Page 486 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual lan.status.subnetmask This attribute contains the LAN subnet mask that is presently in use by the LAN interface. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Not applicable Not applicable Not applicable...
  • Page 487 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference lan.trigger[N].assert() This function simulates the occurrence of the trigger and generates the corresponding event ID. Type TSP-Link accessible Affected by Where saved Default value Function Usage lan.trigger[N].assert() The LAN event number (1 to 8) Details Generates and sends a LAN trigger packet for the LAN event number specified.
  • Page 488 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual Details The trigger event detector enters the detected state when an event is detected. This function clears a trigger event detector and discards the history of the trigger packet. This function clears all overruns associated with this LAN trigger.
  • Page 489 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference lan.trigger[N].connected This attribute stores the LAN event connection state. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Not applicable Not applicable Not applicable Usage connected = lan.trigger[N].connected The LAN event connection state: connected ▪...
  • Page 490 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual Details For TCP connections, this closes the TCP connection. The LAN trigger automatically disconnects when either the lan.trigger[N].protocol or lan.trigger[N].ipaddress attributes for this event are changed. Also see lan.trigger[N].ipaddress (on page 11-132) lan.trigger[N].protocol...
  • Page 491 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference Details Sets the IP address for outgoing trigger events. Set to "0.0.0.0" for multicast. After changing this setting, the lan.trigger[N].connect() command must be called before outgoing messages can be sent. Example Set the protocol for LAN trigger 3 to be lan.trigger[3].protocol = lan.TCP...
  • Page 492 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual lan.TRIG_RISING and lan.TRIG_RISINGA are the same. lan.TRIG_RISING and lan.TRIG_RISINGM are the same. Use of either lan.TRIG_SYNCHRONOUSA or lan.TRIG_SYNCHRONOUSM over lan.TRIG_SYNCHRONOUS is preferred, as lan.TRIG_SYNCHRONOUS is provided for compatibility with older firmware.
  • Page 493 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference lan.trigger[N].protocol This attribute sets the LAN protocol to use for sending trigger messages. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Instrument reset Not saved 0 (lan.TCP) LAN trigger N reset Recall setup...
  • Page 494 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual Details This attribute can be set to initialize the pseudo line state to a known value. Setting this attribute does not cause the LAN trigger to generate any events or output packets. Example Get the present simulated line state for the LAN event 1.
  • Page 495 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference Trigger event IDs* Event ID Event description Occurs when a *TRG command is received on the trigger.EVENT_ID remote interface GPIB only: Occurs when a GET bus command is received USB only: Occurs when a USBTMC TRIGGER message is received...
  • Page 496 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual Details If one or more trigger events have been detected since the last time lan.trigger[N].wait() or lan.trigger[N].clear() was called, this function returns immediately. After waiting for a LAN trigger event with this function, the event detector is automatically reset and rearmed regardless of the number of events detected.
  • Page 497 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference localnode.description This attribute stores a user-defined description and mDNS service name of the instrument. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Not applicable Nonvolatile memory Instrument specific (see Details) Usage localnode.description = "description"...
  • Page 498 Section 11: TSP command reference Model 2601B-PULSE 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 60 (60 Hz) Usage...
  • Page 499 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: 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 500 Section 11: TSP command reference Model 2601B-PULSE 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 501 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference When prompting is enabled, the instrument might generate the following prompts: • TSP>. The standard prompt, which indicates that the previous command completed normally. • TSP?. The prompt that is issued if there are unread entries in the error queue when the prompt is issued.
  • Page 502 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual Details When this attribute is enabled, the IEEE Std 488.2 common commands generate prompts if prompting is enabled with the localnode.prompts attribute. If localnode.prompts4882 is enabled, limit the number of *trg commands sent to a running script to 50 regardless of the setting of the localnode.prompts attribute.
  • Page 503 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference localnode.revision This attribute stores the firmware revision level. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Not applicable Not applicable Not applicable Usage revision = localnode.revision Firmware revision level revision Details...
  • Page 504 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual localnode.showerrors This attribute sets whether or not the instrument automatically sends generated errors. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Power cycle Not saved 0 (disabled) Usage errorMode = localnode.showerrors...
  • Page 505 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference Example getlevel = makegetter(smua.source, "levelv") v = getlevel() Creates a getter function called getlevel. When getlevel() is called, it returns the value of smua.source.levelv. Also see makesetter() (on page 11-147) makesetter() This function creates a function that, when called, sets the value of an attribute.
  • Page 506 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual meminfo() This function returns the present amount of available memory and the total amount of memory in the instrument. Type TSP-Link accessible Affected by Where saved Default value Function Usage freeMem, totalMem = meminfo()
  • Page 507 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference This function does not wait for the script to finish execution. This command should only be used from a remote master when controlling this instrument over a TSP-Link ®...
  • Page 508 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual node[N].setglobal() This function sets the value of a global variable. Type TSP-Link accessible Affected by Where saved Default value Function Usage node[N].setglobal("name", value) The node number of this instrument (1 to 6463) The global variable name to set name The value to assign to the variable...
  • Page 509 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference Also see Status model (on page 15-1) waitcomplete() (on page 11-393) os.remove() This function deletes the file or directory with a given name. Type TSP-Link accessible Affected by Where saved Default value Function...
  • Page 510 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual Example Changes the name of the existing file os.rename("testFile", "exampleFile") testFile to the name exampleFile. Also see os.remove() (on page 11-151) os.time() This function generates a time value in UTC time. Type TSP-Link accessible Affected by...
  • Page 511 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference print() This function generates a response message. Type TSP-Link accessible Affected by Where saved Default value Function Usage print(value1) print(value1, value2) print(value1, ..., valueN) The first argument to output value1 The second argument to output value2...
  • Page 512 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual printbuffer() This function prints data from tables or reading buffer subtables. Affected by Where saved Default value Type TSP-Link accessible Function Usage printbuffer(startIndex, endIndex, bufferVar) printbuffer(startIndex, endIndex, bufferVar, bufferVar2) printbuffer(startIndex, endIndex, bufferVar, ..., bufferVarN) Beginning index of the buffer to print;...
  • Page 513 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference printnumber() This function prints numbers using the configured format. Type TSP-Link accessible Affected by Where saved Default value Function Usage printnumber(value1) printnumber(value1, value2) printnumber(value1, ..., valueN) First value to print in the configured format value1 Second value to print in the configured format value2...
  • Page 514 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual reset() This function resets commands to their default settings. Affected by Where saved Default value Type TSP-Link accessible Function Usage reset() reset(system) What to reset: system ▪ true: If the node is the master, the entire system is reset (default) ▪...
  • Page 515 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference You are not required to qualify the path to the USB flash drive, but you can add /usb1/ before the fileName (see Example 2). Example 1 savebuffer(smua.nvbuffer1, "csv", "mybuffer.csv") Save smua dedicated reading buffer 1 as a CSV file named mybuffer.csv.
  • Page 516 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual 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") The string that represents the name of the script scriptName Example Deletes a user script named "test8"...
  • Page 517 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference 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") The created script;...
  • Page 518 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual 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 scriptVar A string containing the body of the script code...
  • Page 519 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference script.newautorun() This function creates a script and enables autorun. Type TSP-Link accessible Affected by Where saved Default value Function Usage scriptVar = script.newautorun("code") scriptVar = script.newautorun("code", "name") The name of the variable that will reference the script scriptVar A string that contains the body of the script code...
  • Page 520 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual script.restore() This function restores a script that was removed from the runtime environment. Type TSP-Link accessible Affected by Where saved Default value Function Usage script.restore(name) The name of the script to be restored name Details This command copies the script from nonvolatile memory into the runtime environment.
  • Page 521 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference script.user.catalog() This function returns an iterator that can be used in a for loop to iterate over all the scripts stored in nonvolatile memory. Affected by Where saved Default value Type TSP-Link accessible...
  • Page 522 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual Details Autorun scripts run automatically when the instrument is turned on. You can set any number of scripts to autorun. The run order for autorun scripts is arbitrary, so make sure the run order is not important. The default value for scriptVar.autorun depends on how the script was loaded.
  • Page 523 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference Also see Load a script by sending commands over the remote interface (on page 10-4) Retrieve source code one line at a time (on page 10-42) scriptVar.name This attribute contains the name of a script in the runtime environment. Type TSP-Link accessible Affected by...
  • Page 524 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual scriptVar.run() This function runs a script. Affected by Where saved Default value Type TSP-Link accessible Function Usage scriptVar.run() scriptVar() The name of the variable that references the script scriptVar Details The scriptVar.run() function runs the script referenced by scriptVar.
  • Page 525 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference Example 1 Saves the script referenced by the variable test8.save() test8 to nonvolatile memory. Example 2 Saves the script referenced by the variable test8.save("/usb1/myScript.tsp") test8 to a file named myScript.tsp on your USB flash drive.
  • Page 526 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual serial.baud This attribute configures the baud rate for the RS-232 port. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Not applicable Nonvolatile memory 9600 Usage baud = serial.baud serial.baud = baud The baud rate (300, 600, 1200, 2400, 4800, 9600, 19200, 38400, 57600, or 115200)
  • Page 527 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference serial.databits This attribute configures character width (data bits) for the RS-232 port. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Not applicable Nonvolatile memory Usage bits = serial.databits serial.databits = bits An integer representing the character width (7 or 8)
  • Page 528 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual serial.flowcontrol This attribute configures flow control for the RS-232 port. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Not applicable Nonvolatile memory "none" (serial.FLOW_NONE) Usage flow = serial.flowcontrol serial.flowcontrol = flow A string or value that represents flow control configuration;...
  • Page 529 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference Details A new parity setting takes effect when the command to change it is processed. Allow ample time for the command to be processed before attempting to communicate with the instrument again.
  • Page 530 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual Example Read data from the serial port. data = serial.read(200) Output: print(data) John Doe The above output indicates that the string "John Doe" was read from the serial port. Also see serial.write() (on page 11-172)
  • Page 531 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: 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 532 Section 11: TSP command reference Model 2601B-PULSE 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 subtracted from the local time to determine UTC.
  • Page 533 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference Only setups stored in nonvolatile memory are available (you cannot recall a script from a USB flash drive with this command). To save a script that is used when the instrument is powered on, you can create a configuration script and name it autoexec.
  • Page 534 Section 11: TSP command reference Model 2601B-PULSE 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 535 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference Details The smua.abort() function does not turn the output off or change any settings. 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 536 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual The min and max entries each have the attributes defined in the following table. Attribute Description String indicating the function that was measured for the reading (current, measurefunction voltage, ohms, or watts) The full-scale range value for the measurement range used when the measurerange...
  • Page 537 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference smua.buffer.recalculatestats() This function recalculates the statistics of the specified reading buffer. Type TSP-Link accessible Affected by Where saved Default value Function Usage smua.buffer.recalculatestats(bufferVar) The reading buffer to process bufferVar Details This function causes the SMU to regenerate the reading buffer statistics about the specified reading...
  • Page 538 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual This attribute is stored with the active calibration set. If a different calibration set is restored, this attribute reflects the date stored with that set. smua.cal.adjustdate must be set to the date the adjustment was done using the UTC time and date.
  • Page 539 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference Also see Adjustment (on page 13-19) os.time() (on page 11-152) smua.cal.adjustdate (on page 11-179) smua.cal.lock() (on page 11-182) smua.cal.restore() (on page 11-184) smua.cal.save() (on page 11-184) smua.cal.state (on page 11-185) smua.cal.unlock() (on page 11-186) smua.cal.due...
  • Page 540 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual smua.cal.lock() This function disables the commands that change calibration settings. Type TSP-Link accessible Affected by Where saved Default value Function Usage smua.cal.lock() Details Before you can lock calibration, the calibration constants must be written to nonvolatile memory or a previous calibration set must be restored.
  • Page 541 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference smua.cal.polarity This attribute controls which calibration constants are used for all subsequent measurements. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Instrument reset Not saved 0 (smua.CAL_AUTO) SMU reset SMU calibration lock...
  • Page 542 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual smua.cal.restore() This function loads a stored set of calibration constants. Type TSP-Link accessible Affected by Where saved Default value Function Usage smua.cal.restore() smua.cal.restore(calset) The calibration set to be loaded; set calset to one of the following values: calset ▪...
  • Page 543 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference Details This function stores the active set of calibration constants to nonvolatile memory. The previous calibration constants (from the default calibration set) are copied to the previous calibration set (smua.CALSET_PREVIOUS) before overwriting the default calibration set.
  • Page 544 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual Also see Adjustment (on page 13-19) smua.cal.lock() (on page 11-182) smua.cal.restore() (on page 11-184) smua.cal.save() (on page 11-184) smua.cal.unlock() (on page 11-186) smua.cal.unlock() This function enables the commands that change calibration settings. Type TSP-Link accessible Affected by...
  • Page 545 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference Details Contact check measurement calibration does not require range information. Typically, points one and two will be near 0 Ω and 50 Ω, respectively. All four measurements (cp1Measured, cp1Reference, cp2Measured, and cp2Reference) must be made with the calibration set that is active.
  • Page 546 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual Details Contact check measurement adjustment does not require range information. Typically, points one and two are near 0 Ω and 50 Ω, respectively. All four measurements (cp1Measured, cp1Reference, cp2Measured, and cp2Reference) must be made with the active calibration set.
  • Page 547 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference Details Contact check is not available when the pulser is enabled. If you need to use the contact check function in a pulser application, you can disable the pulser, run the contact check measurements, then enable the pulser.
  • Page 548 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual smua.contact.r() This function measures aggregate contact resistance. Type TSP-Link accessible Affected by Where saved Default value Function Usage rhi, rlo = smua.contact.r() The measured aggregate contact resistance on the HI/sense HI side The measured aggregate contact resistance on the LO/sense LO side Details If you attempt to perform a contact resistance measurement when any of the following conditions...
  • Page 549 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference smua.contact.speed This attribute stores the speed setting for contact check measurements. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Instrument reset Not saved 0 (smua.CONTACT_FAST) SMU reset Recall setup Usage...
  • Page 550 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual smua.contact.threshold This attribute stores the resistance threshold for the smua.contact.check() function. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Instrument reset Not saved 50 (50 Ω) SMU reset Recall setup Usage...
  • Page 551 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference Details The setting of this attribute must match the jumper setting on the 2601B-P-INT Interlock and Cable Connector Box. Example smua.interlock.enable = smua.ENABLE Enable the interlock. Also see Using the interlock (on page 2-42) smua.makebuffer()
  • Page 552 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual smua.measure.autorangeY This attribute stores the measurement autorange setting. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Instrument reset Saved setup 1 (smua.AUTORANGE_ON) SMU reset Recall setup Usage autoRange = smua.measure.autorangeY smua.measure.autorangeY = autoRange...
  • Page 553 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference smua.measure.autozero This attribute enables or disables automatic updates to the internal reference measurements (autozero) of the instrument. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Instrument reset Saved setup 2 (smua.AUTOZERO_AUTO)
  • Page 554 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual Also see Autozero (on page 4-41) reset() (on page 11-156) smua.measure.nplc (on page 11-204) setup.recall() (on page 11-175) smua.reset() (on page 11-222) smua.measure.calibrateY() This function generates and activates new measurement calibration constants. Type TSP-Link accessible Affected by...
  • Page 555 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference Also see Adjustment (on page 13-19) smua.cal.lock() (on page 11-182) smua.cal.restore() (on page 11-184) smua.cal.save() (on page 11-184) smua.cal.unlock() (on page 11-186) smua.source.calibrateY() (on page 11-225) smua.measure.count This attribute sets the number of measurements made when a measurement is requested. Type TSP-Link accessible Affected by...
  • Page 556 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual smua.measure.delay This attribute controls the measurement delay. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Instrument reset Saved setup 0 (smua.DELAY_OFF) SMU reset Recall setup Usage mDelay = smua.measure.delay smua.measure.delay = mDelay...
  • Page 557 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference smua.measure.delayfactor This attribute stores a multiplier to the delays that are used when smua.measure.delay is set to smua.DELAY_AUTO. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Instrument reset Not saved SMU reset...
  • Page 558 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual Example smua.measure.filter.count = 10 smua.measure.filter.type = smua.FILTER_MOVING_AVG smua.measure.filter.enable = smua.FILTER_ON Sets the filter count to 10. Sets the filter type to moving average. Enables the filter. Also see Filters (on page 4-77) reset()
  • Page 559 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference smua.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 (smua.FILTER_REPEAT_AVG)
  • Page 560 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual smua.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 Attribute (RW) Instrument reset Saved setup...
  • Page 561 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference Details This attribute sets the time interval between measurements when smua.measure.count is set to a value greater than 1. The SMU attempts to start each measurement when scheduled. When the pulser is disabled, if the SMU cannot keep up with the interval setting, measurements are made as quickly as possible.
  • Page 562 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual Also see Range (on page 4-54) reset() (on page 11-156) setup.recall() (on page 11-175) smua.measure.autorangeY (on page 11-194) smua.reset() (on page 11-222) smua.measure.nplc This command sets the integration aperture for measurements when the pulser is disabled. Type TSP-Link accessible Affected by...
  • Page 563 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference smua.measure.overlappedY() This function starts an asynchronous (background) measurement. Type TSP-Link accessible Affected by Where saved Default value Function Usage smua.measure.overlappedY(rbuffer) smua.measure.overlappediv(ibuffer, vbuffer) SMU measurement type (v = voltage, i = current, r = resistance, p = power) A reading buffer object where the readings are stored rbuffer A reading buffer object where current readings are stored...
  • Page 564 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual smua.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 Saved setup Voltage: 100e-3 (100 mV) SMU reset...
  • Page 565 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference Also see Range (on page 4-54) reset() (on page 11-156) setup.recall() (on page 11-175) smua.measure.autorangeY (on page 11-194) smua.pulser.rangeY (on page 11-220) smua.reset() (on page 11-222) smua.source.rangeY (on page 11-235) smua.measure.rel.enableY This attribute turns relative measurements on or off.
  • Page 566 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual smua.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 = smua.measure.rel.levelY smua.measure.rel.levelY = relValue...
  • Page 567 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference smua.measure.Y() This function makes one or more measurements. Type TSP-Link accessible Affected by Where saved Default value Function Usage reading = smua.measure.Y() reading = smua.measure.Y(readingBuffer) iReading, vReading = smua.measure.iv() iReading, vReading = smua.measure.iv(iReadingBuffer) iReading, vReading = smua.measure.iv(iReadingBuffer, vReadingBuffer) Returned value of the last (or only) reading of the measurement process...
  • Page 568 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual Also see Reading buffers (on page 5-1) smua.measure.count (on page 11-197) smua.measure.overlappedY() (on page 11-205) smua.nvbufferY (on page 11-211) smua.measureYandstep() This function makes one or two measurements and then steps the source. Type TSP-Link accessible Affected by...
  • Page 569 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference Example local ivalues = {} smua.source.rangev = 1 smua.source.levelv = 0 smua.measure.rangei = 0.01 smua.source.output = smua.OUTPUT_ON for index = 1, 10 do ivalues[index] = smua.measureiandstep(index / 10) ivalues[11] = smua.measure.i() This use of the measure and step function measures current, starting at a source value of 0 V.
  • Page 570 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual Also see Configuring and running sweeps (on page 4-71) Reading buffers (on page 5-1) savebuffer() (on page 11-156) smua.makebuffer() (on page 11-193) smua.measure.overlappedY() (on page 11-205) smua.savebuffer() (on page 11-222) smua.trigger.measure.action (on page 11-248) smua.trigger.measure.set()
  • Page 571 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference • You cannot make measurements when the output is off. • Compliance limits (smua.source.limitY) are not used to control the output. Pulser protection levels are used instead. Refer to Pulser protection levels (on page 4-4)for information.
  • Page 572 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual smua.pulser.measure.calibrateY() This function generates and activates new measurement calibration constants for the pulser. Type TSP-Link accessible Affected by Where saved Default value Function Usage smua.pulser.measure.calibrateY(range, cp1Measured, cp1Reference, cp2Measured, cp2Reference) The pulse measurement range to adjust range...
  • Page 573 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference smua.pulser.measure.delay This attribute sets the measurement delay when the pulser is enabled. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Instrument reset Saved setup SMU reset Recall setup Usage delay = smua.pulser.measure.delay...
  • Page 574 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual smua.pulser.protect.sensev This attribute sets a voltage protection level used to monitor the sense terminals when the pulser is enabled. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Instrument reset Saved setup...
  • Page 575 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference smua.pulser.protect.sourcev This attribute sets an absolute voltage protection level used to monitor the force terminals when the pulser is enabled. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Instrument reset Saved setup...
  • Page 576 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual smua.pulser.protect.tripped This attribute indicates if the protection circuit was tripped. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Instrument reset None Not applicable SMU reset Usage tripped = smua.pulser.protect.tripped The voltage protection status:...
  • Page 577 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference smua.pulser.source.calibratebiasi() This function adjusts the new bias source calibration constants for the pulser. Type TSP-Link accessible Affected by Where saved Default value Function Usage smua.pulser.source.calibratebiasi(range, cp1Expected, cp1Reference, cp2Expected, cp2Reference) The pulser bias-current range to adjust range...
  • Page 578 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual smua.pulser.rangeY This attribute sets the source and measure ranges when the pulser is enabled. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Instrument reset Saved setup Current: 10 A SMU reset Voltage: 10 V...
  • Page 579 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference smua.pulser.source.calibratei() This function generates and activates new source calibration constants for the pulser. Type TSP-Link accessible Affected by Where saved Default value Function Usage smua.pulser.source.calibratei(range, cp1Expected, cp1Reference, cp2Expected, cp2Reference) The pulser current range to adjust range...
  • Page 580 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual smua.reset() This function turns off the output and resets the commands that begin with smua. to their default settings. Affected by Where saved Default value Type TSP-Link accessible Function Usage smua.reset()
  • Page 581 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference smua.sense This attribute contains the state of the sense mode. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) SMU reset Saved setup 0 (smua.SENSE_LOCAL) Instrument reset Recall setup Usage senseMode = smua.sense...
  • Page 582 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual smua.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 (smua.AUTORANGE_ON) Instrument reset Recall setup Usage...
  • Page 583 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference smua.source.calibrateY() This function generates and activates new source calibration constants. Type TSP-Link accessible Affected by Where saved Default value Function Usage smua.source.calibrateY(range, cp1Expected, cp1Reference, cp2Expected, cp2Reference) SMU source function (v = voltage, i = current) The measurement range to adjust range The source value set for point 1...
  • Page 584 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual smua.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 = smua.source.compliance The state of source compliance: compliance ▪...
  • Page 585 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference Details This attribute allows for additional delay (settling time) after an output step. The smua.DELAY_AUTO setting causes a range-dependent delay to be inserted when the source is changed. Range-dependent delays are based on the output settling time values as defined in the 2601B-PULSE specifications.
  • Page 586 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual smua.source.highc This attribute enables or disables high-capacitance mode. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) SMU reset Saved setup 0 (smua.DISABLE) Instrument reset Recall setup Usage highC = smua.source.highc smua.source.highc = highC...
  • Page 587 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference smua.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 = smua.source.levelY smua.source.levelY = sourceLevel The source value;...
  • Page 588 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual smua.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: 40 (40 V) Instrument reset Limit current: 1 (1 A) Recall setup Limit power: 0 (disabled)
  • Page 589 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference smua.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 Voltage: 100e-3 (100 mV) Instrument reset Current: 100e-9 (100 nA)
  • Page 590 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual Details This attribute controls the source function used when the output is turned off and smua.source.offmode is set to smua.OUTPUT_NORMAL. Set this attribute to smua.OUTPUT_DCVOLTS for the source to be a 0 V source when the output is off (smua.source.offlimiti is used).
  • Page 591 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference Also see smua.contact.check() (on page 11-188) smua.contact.r() (on page 11-190) smua.source.offfunc (on page 11-231) smua.source.offmode (on page 11-233) smua.source.offmode This attribute sets the source output-off mode. Type TSP-Link accessible Affected by Where saved Default value...
  • Page 592 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual Example smua.source.offmode = smua.OUTPUT_HIGH_Z Sets the output-off mode to open the output relay when the output is turned off. Also see Output-off states (on page 4-26) smua.source.offfunc (on page 11-231) smua.source.offlimitY (on page 11-232) smua.source.output...
  • Page 593 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference smua.source.rangeY This attribute contains the source range. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) SMU reset Saved setup Voltage: 100e-3 (100 mV) Instrument reset Current: 100e-9 (100 nA) Recall setup Usage...
  • Page 594 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual smua.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 (smua.SETTLE_SMOOTH) Instrument reset Recall setup Usage settleOption = smua.source.settling smua.source.settling = settleOption...
  • Page 595 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference smua.source.sink This attribute turns sink mode on or off. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) SMU reset Saved setup 0 (smua.DISABLE) Instrument reset Recall setup Usage sinkMode = smua.source.sink...
  • Page 596 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual Example smua.trigger.arm.count = 5 Sets the SMU to iterate through the arm layer of the trigger model five times and then return to the idle state. Also see smua.trigger.count (on page 11-241) smua.trigger.arm.set()
  • Page 597 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference smua.trigger.arm.stimulus This attribute selects the event that will cause the arm event detector to enter the detected state. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) SMU reset Not saved Instrument reset...
  • Page 598 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual Example smua.trigger.arm.stimulus = trigger.timer[1].EVENT_ID An event on trigger timer 1 causes the arm event detector to enter the detected state. Also see Triggering (on page 6-1) smua.trigger.ARMED_EVENT_ID This constant contains the number of the armed event. Type TSP-Link accessible Affected by...
  • Page 599 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference Details This attribute enables or disables automatic clearing of the trigger model state machine event detectors when the SMU transitions from the arm layer to the trigger layer. Only the detected states of the event detectors are cleared.
  • Page 600 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual Example reset() period_timer = trigger.timer[1] pulse_timer = trigger.timer[2] smua.trigger.source.listv( {5} ) smua.trigger.source.action = smua.ENABLE smua.source.rangev = 5 smua.trigger.measure.action = smua.DISABLE pulse_timer.delay = 0.0006 pulse_timer.stimulus = period_timer.EVENT_ID pulse_timer.count = 1 period_timer.delay = 0.005 period_timer.count = 9 period_timer.stimulus = smua.trigger.SWEEPING_EVENT_ID...
  • Page 601 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference smua.trigger.endpulse.action This attribute enables or disables pulse sweeps when the pulser is disabled. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) SMU reset Not saved 1 (smua.SOURCE_HOLD) Instrument reset Recall setup...
  • Page 602 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual Details This function sets the end pulse event detector to the detected state. The SMU automatically clears all the event detectors when the smua.trigger.initiate() function is executed. Therefore, smua.trigger.endpulse.set() should be called after the sweep is initiated.
  • Page 603 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference smua.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) SMU reset Not saved Instrument reset...
  • Page 604 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual Example smua.trigger.endpulse.action = smua.SOURCE_IDLE smua.trigger.endpulse.stimulus = trigger.timer[1].EVENT_ID Configure the end pulse action to achieve a pulse and select the event, trigger.timer[1].EVENT_ID, that causes the arm event detector to enter the detected state. Also see Triggering (on page 6-1)
  • Page 605 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference Details Set the stimulus of any trigger object to the value of this constant to have the trigger object respond to idle events from this SMU. Example trigger.timer[1].stimulus = smua.trigger.IDLE_EVENT_ID Trigger timer 1 when the SMU returns to the idle layer.
  • Page 606 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual Also see bufferVar.clearcache() (on page 11-22) Configuring and running sweeps (on page 4-71) smua.trigger.measure.action (on page 11-248) smua.trigger.measure.Y() (on page 11-251) smua.trigger.source.action (on page 11-253) smua.trigger.source.linearY() (on page 11-254) smua.trigger.source.listY() (on page 11-255) smua.trigger.source.logY()
  • Page 607 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference Example smua.trigger.measure.v(smua.nvbuffer1) smua.trigger.measure.action = smua.ENABLE Configure sweep voltage measurements. Enable voltage measurements during the sweep. Also see bufferVar.collectsourcevalues (on page 11-23) smua.trigger.autoclear (on page 11-240) smua.trigger.measure.Y() (on page 11-251) Triggering (on page 6-1) smua.trigger.measure.set()
  • Page 608 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual smua.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 Not saved Instrument reset...
  • Page 609 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference Example smua.trigger.measure.stimulus = trigger.timer[1].EVENT_ID Sets delay before measurement begins. Also see Triggering (on page 6-1) smua.trigger.measure.Y() This function configures the measurements that are to be made in a subsequent sweep. Type TSP-Link accessible Affected by...
  • Page 610 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual smua.trigger.MEASURE_COMPLETE_EVENT_ID This constant contains the measurement complete event number. Type TSP-Link accessible Affected by Where saved Default value Constant Usage eventID = smua.trigger.MEASURE_COMPLETE_EVENT_ID The measurement complete event number eventID Details Set the stimulus of any trigger object to the value of this constant to have the trigger object respond to...
  • Page 611 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference smua.trigger.source.action This attribute enables or disables sweeping the source (on or off). Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) SMU reset Not saved 0 (smua.DISABLE) Instrument reset Recall setup Usage...
  • Page 612 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual Details Use this attribute to perform extended operating area (EOA) pulse mode sweeps. If this attribute is set to smua.LIMIT_AUTO (or 0), the SMU uses the normal limit setting during sweeping.
  • Page 613 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference The points parameter does not set the number of steps in a sweep, but rather is used to calculate source values within a subsequent sweep. If the subsequent sweep has more points than specified in points, the source will restart at the beginning.
  • Page 614 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual If the subsequent sweep has more points than specified in sweepList, the source will restart at the beginning. This means that if the trigger count is greater than the number of points in a sweep as configured, the SMU will satisfy the trigger count by restarting the sweep values from the beginning.
  • Page 615 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference The points parameter does not set the number of steps in a sweep, but rather is used to calculate source values within a subsequent sweep. If the subsequent sweep has more points than specified in points, the source restarts at the beginning.
  • Page 616 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual smua.trigger.source.pulsewidth This attribute sets the source pulse width when using a trigger model sweep when the pulser is enabled Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Instrument reset Saved setup...
  • Page 617 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference Details This function sets the source event detector to the detected state. The SMU automatically clears all event detectors when the smua.trigger.initiate() function is executed. This function should be called after the sweep is initiated. If the event detectors are configured to clear automatically because the smua.trigger.autoclear attribute is set to smua.ENABLE, make sure that smua.trigger.source.set() is issued after the SMU has entered the trigger layer.
  • Page 618 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual Details Set this attribute to the event ID of any trigger event generator to wait for that event. When set, the SMU waits for the event at the source event detector portion of the trigger model. To bypass waiting for an event, set the value of this attribute to zero (0).
  • Page 619 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference smua.trigger.SOURCE_COMPLETE_EVENT_ID This constant contains the source complete event number. Type TSP-Link accessible Affected by Where saved Default value Constant Usage eventID = smua.trigger.SOURCE_COMPLETE_EVENT_ID The source action complete event number eventID Details Set the stimulus of any trigger object to the value of this constant to have the trigger object respond to...
  • Page 620 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual Also see Triggering (on page 6-1) smua.trigger.SWEEPING_EVENT_ID This constant contains the sweeping event number. Type TSP-Link accessible Affected by Where saved Default value Constant Usage eventID = smua.trigger.SWEEPING_EVENT_ID The sweeping event number eventID Details...
  • Page 621 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference Set the trigger model counts. Configure the SMU to execute a 10-point pulse train. Start the trigger model. Wait for the sweep to complete. Also see Triggering (on page 6-1) status.condition This attribute stores the status byte condition register.

  • Page 622: Bit Value And Description

    Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual Value and description status.QUESTIONABLE_SUMMARY_BIT status.QSB Set summary bit indicates that an enabled questionable event has occurred. Bit B3 decimal value: 8 status.MESSAGE_AVAILABLE status.MAV Set summary bit indicates that a response message is present in the Output Queue. Bit B4 decimal value: 16 status.EVENT_SUMMARY_BIT status.ESB...
  • Page 623 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference 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) Status reset Not saved .event (R)
  • Page 624 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual Value and description status.measurement.VOLTAGE_LIMIT status.measurement.VLMT Set bit is a summary of the status.measurement.voltage_limit register. Bit B0 decimal value: 1 status.measurement.CURRENT_LIMIT status.measurement.ILMT Set bit is a summary of the status.measurement.current_limit register. Bit B1 decimal value: 2 Not used status.measurement.PROTECTION...
  • Page 625 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference Binary value 32,768 16,384 8,192 4,096 2,048 1,024 Decimal Weights Example status.measurement.enable = status.measurement.BAV Sets the BAV bit of the measurement event enable register. Also see Measurement event registers (on page 15-7) smua.pulser.protect.tripped (on page 11-218)
  • Page 626 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual Value and description Not used status.measurement.buffer_available.SMUA Set bit indicates that there is at least one reading stored in either or both of the dedicated reading buffers. Bit B1 decimal value: 2 Binary value: 0000 0010 Not used B2 to B15...

  • Page 627: Bit B1 Decimal Value: 2

    Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference Usage measurementRegister = status.measurement.current_limit.condition measurementRegister = status.measurement.current_limit.enable measurementRegister = status.measurement.current_limit.event measurementRegister = status.measurement.current_limit.ntr measurementRegister = status.measurement.current_limit.ptr status.measurement.current_limit.enable = measurementRegister status.measurement.current_limit.ntr = measurementRegister status.measurement.current_limit.ptr = measurementRegister The status of the measurement event current limit summary register; a zero (0) measurementRegister indicates no bits set (also send 0 to clear all bits);...
  • Page 628 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual 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 629 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference Example 1 status.measurement.instrument.enable = status.measurement.instrument.SMUA Uses the constant to set the SMU A bit of the measurement event instrument summary enable register. Example 2 status.measurement.instrument.enable = 2 Uses the decimal value to set the SMU A bit of the measurement event instrument summary enable register. Also see Measurement event registers (on page 15-7)
  • Page 630 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents (on page 15-1) and Enable and transition registers (on page 15-19). The individual bits of this register are defined in the following table.
  • Page 631 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference Example 1 status.measurement.instrument.smua.enable = status.measurement.instrument.smua.VLMT Uses a constant to set the VLMT bit of the measurement event SMU A summary enable register. Example 2 status.measurement.instrument.smua.enable = 1 Uses the decimal value to set the VLMT bit of the measurement event SMU A summary enable register. Also see Measurement event registers (on page 15-7)
  • Page 632 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual Value Not used status.measurement.protection.SMUA Set bit indicates one of the pulser protection circuits have tripped. Bit B1 decimal value: 2 Binary value: 0000 0010 Not used B2 to B15 In addition to the above constants, measurementRegister can be set to the decimal value of the bit to set.
  • Page 633 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference Details These attributes are used to read or write to the measurement event reading overflow summary registers. Reading a status register returns a value. The binary equivalent of the returned value indicates which register bits are set.
  • Page 634 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual 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) Not applicable Not saved Not applicable .enable (RW) Status reset...
  • Page 635 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference Example 2 status.measurement.voltage_limit.enable = 2 Uses the decimal value to set the SMUA bit, B1, of the measurement event voltage limit summary enable register. Also see Measurement event registers (on page 15-7) status.node_enable This attribute stores the system node enable register.

  • Page 636: B2 Status.error_Available

    Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual Value and description status.MEASUREMENT_SUMMARY_BIT status.MSB Set summary bit indicates that an enabled measurement event has occurred. Bit B0 decimal value: 1 Not used status.ERROR_AVAILABLE status.EAV Set summary bit indicates that an error or status message is present in the error queue. Bit B2 decimal value: 4 status.QUESTIONABLE_SUMMARY_BIT status.QSB...
  • Page 637 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference Example 2 -- decimal 129 = binary 10000001 nodeEnableRegister = 129 status.node_enable = nodeEnableRegister Sets the MSB and OSB bits of the system node enable register using a decimal value. Also see status.condition (on page 11-263)

  • Page 638: B3 Status.questionable_Summary_Bit

    Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual Value and description status.QUESTIONABLE_SUMMARY_BIT status.QSB Set summary bit indicates that an enabled questionable event has occurred. Bit B3 decimal value: 8 status.MESSAGE_AVAILABLE status.MAV Set summary bit indicates that a response message is present in the output queue. Bit B4 decimal value: 16 status.EVENT_SUMMARY_BIT status.ESB...
  • Page 639 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference status.operation.* These attributes manage the operation status register set of the status model. Type TSP-Link accessible Affected by Where saved Default value Attribute .condition (R) Not applicable Not saved Not applicable .enable (RW) Status reset...
  • Page 640 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual Value and description status.operation.SWEEPING status.operation.SWE Set bit indicates that the summary bit from the status.operation.sweeping register is set. Bit B3 decimal value: 8 status.operation.MEASURING status.operation.MEAS Set bit indicates that the summary bit of the status.operation.measuring register is set. Bit B4 decimal value: 16 Not used B5 to B9...
  • Page 641 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference Binary value 32,768 16,384 8,192 4,096 2,048 1,024 Decimal Weights Example 1 operationRegister = status.operation.USER + status.operation.PROG status.operation.enable = operationRegister Uses constants to set the USER and PROG bits of the operation status enable register. Example 2 -- decimal 20480 = binary 0101 0000 0000 0000 operationRegister = 20480...
  • Page 642 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents (on page 15-1) and Enable and transition registers (on page 15-19). The individual bits of this register are defined in the following table.
  • Page 643 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference Details These attributes are used to read or write to the operation status instrument summary registers. Reading a status register returns a value. The binary equivalent of the returned value indicates which register bits are set.
  • Page 644 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual In addition to the above constants, operationRegister can be set to the decimal value of the bit to set. To set more than one bit of the register, set operationRegister to the sum of their decimal values.
  • Page 645 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: 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 The status of the operation status digital I/O summary register; a operationRegister zero (0) indicates no bits set (also send 0 to clear all bits);...
  • Page 646 Section 11: TSP command reference Model 2601B-PULSE 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) Status reset...
  • Page 647 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference Value Decimal value 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 1,024 status.operation.instrument.digio.trigger_overrun.LINE10 2,048 status.operation.instrument.digio.trigger_overrun.LINE11 4,096 status.operation.instrument.digio.trigger_overrun.LINE12 8,192 status.operation.instrument.digio.trigger_overrun.LINE13 16,384 status.operation.instrument.digio.trigger_overrun.LINE14 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 = status.operation.instrument.digio.trigger_overrun.LINE1.
  • Page 648 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual Also see Operation Status Registers (on page 15-8) status.operation.instrument.digio.* (on page 11-286) status.operation.instrument.lan.* This attribute contains the operation status LAN summary register set. Type TSP-Link accessible Affected by Where saved Default value Attribute...
  • Page 649 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference Value and description status.operation.instrument.lan.CONNECTION status.operation.instrument.lan.CON Set bit indicates that the LAN cable is connected and a link has been detected. Bit B0 decimal value: 1 status.operation.instrument.lan.CONFIGURING status.operation.instrument.lan.CONF Set bit indicates the LAN is performing its configuration sequence. Bit B1 decimal value: 2 Not used B2 to B9...
  • Page 650 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual status.operation.instrument.lan.trigger_overrun.* This attribute contains the operation status LAN trigger overrun register set. Type TSP-Link accessible Affected by Where saved Default value Attribute .condition (R) Not applicable Not saved Not applicable .enable (RW) Status reset...

  • Page 651: B9 To B15

    Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference Value Decimal value status.operation.instrument.lan.trigger_overrun.LAN2 4 status.operation.instrument.lan.trigger_overrun.LAN3 8 status.operation.instrument.lan.trigger_overrun.LAN4 16 status.operation.instrument.lan.trigger_overrun.LAN5 32 status.operation.instrument.lan.trigger_overrun.LAN6 64 status.operation.instrument.lan.trigger_overrun.LAN7 128 status.operation.instrument.lan.trigger_overrun.LAN8 256 Not used Not applicable B9 to B15 As an example, to set bit B1 of the operation status LAN trigger overrun enable register, set status.operation.instrument.lan.trigger_overrun.enable = status.operation.instrument.lan.trigger_overrun.LAN1.
  • Page 652 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual status.operation.instrument.smua.* This attribute contains the operation status SMU summary register set. Type TSP-Link accessible Affected by Where saved Default value Attribute .condition (R) Not applicable Not saved Not applicable .enable (RW) Status reset Not saved...
  • Page 653 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference Value and description status.operation.instrument.smua.SWEEPING status.operation.instrument.smua.SWE Set bit indicates that smua is sweeping. Bit B3 decimal value: 8 status.operation.instrument.smua.MEASURING status.operation.instrument.smua.MEAS Bit is set when making an overlapped measurement, but it will not set when taking a normal synchronous measurement.
  • Page 654 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual status.operation.instrument.smua.trigger_overrrun.* This attribute contains the operation status SMU trigger overrun register set. Type TSP-Link accessible Affected by Where saved Default value Attribute .condition (R) Not applicable Not saved Not applicable .enable (RW) Status reset...

  • Page 655: Binary Value Decimal Weights

    Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference Value and description status.operation.instrument.smua.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.smua.trigger_overrun.ENDP Set bit indicates that the end pulse event detector of the SMU was already in the detected state when a trigger was received.
  • Page 656 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual 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) Status reset...
  • Page 657 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference Example status.operation.instrument.trigger_blender.enable = 1024 Uses a decimal value to set the TRGOVR bit of the operation status trigger blender summary enable. Also see Operation Status Registers (on page 15-8) status.operation.instrument.trigger_blender.trigger_overrun.* (on page 11-299) status.operation.instrument.trigger_blender.trigger_overrun.*...
  • Page 658 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual > > > > > > > > > > > > > > * Least significant bit ** Most significant bit A set bit value indicates that the specified trigger blender generated an action overrun. For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents...
  • Page 659 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference Example status.operation.instrument.trigger_blender.trigger_overrun.enable = status.operation.instrument.trigger_blender.trigger_overrun.BLND1 Uses the constant to set the bit for blender 1 of the operation status trigger blender overrun enable register. Example status.operation.instrument.trigger_blender.trigger_overrun.enable = 18 Uses the decimal value to set the bits for blenders 1 and 4 of the operation status trigger blender overrun enable register.
  • Page 660 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual Value and description Not used B0 to B9 status.operation.instrument.trigger_timer.TRIGGER_OVERRUN status.operation.instrument.trigger_timer.TRGOVR Set bit indicates one or more enabled bits for the operation status trigger timer overrun register is set. Bit B10 decimal value: 1,024 Binary value: 0100 0000 0000...
  • Page 661 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference The status of the operation status trigger timer trigger overrun operationRegister register; a zero (0) indicates no bits set (also send 0 to clear all bits); other values indicate various bit settings Details These attributes are used to read or write to the operation status trigger timer overrun registers.
  • Page 662 Section 11: TSP command reference Model 2601B-PULSE 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 status.operation.instrument.trigger_timer.trigger_overrun.enable = status.operation.instrument.trigger_timer.trigger_overrun.TMR3 Uses a constant to set the timer 3 bit of the operation status trigger timer overrun enable register. Example 2 status.operation.instrument.trigger_timer.trigger_overrun.enable = 18 Uses a constant to set timer bits B1 and B4 of the operation status trigger timer overrun enable register.
  • Page 663 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference Details These attributes are used to read or write to the operation status TSP-Link summary registers. Reading a status register returns a value. The binary equivalent of the returned value indicates which register bits are set.
  • Page 664 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual Usage operationRegister = status.operation.instrument.tsplink.trigger_overrun.condition operationRegister = status.operation.instrument.tsplink.trigger_overrun.enable operationRegister = status.operation.instrument.tsplink.trigger_overrun.event operationRegister = status.operation.instrument.tsplink.trigger_overrun.ntr operationRegister = status.operation.instrument.tsplink.trigger_overrun.ptr status.operation.instrument.tsplink.trigger_overrun.enable = operationRegister status.operation.instrument.tsplink.trigger_overrun.ntr = operationRegister status.operation.instrument.tsplink.trigger_overrun.ptr = operationRegister The status of the operation status TSP-link overrun register; a operationRegister zero (0) indicates no bits set (also send 0 to clear all bits);...
  • Page 665 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: 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 status.operation.instrument.tsplink.trigger_overrun.enable = status.operation.instrument.tsplink.trigger_overrun.LINE1 Uses a constant to set the line 1 bit of the operation status TSP-Link overrun enable register. Example 2 status.operation.instrument.tsplink.trigger_overrun.enable = 10 Uses the decimal value to set bits for lines 1 and 3 of the operation status TSP-Link overrun enable register.
  • Page 666 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual Details These attributes are used to read or write to the operation status measuring summary registers. Reading a status register returns a value. The binary equivalent of the returned value indicates which register bits are set.
  • Page 667 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference Usage operationRegister = status.operation.remote.condition operationRegister = status.operation.remote.enable operationRegister = status.operation.remote.event operationRegister = status.operation.remote.ntr operationRegister = status.operation.remote.ptr status.operation.remote.enable = operationRegister status.operation.remote.ntr = operationRegister status.operation.remote.ptr = operationRegister The status of the operation status remote summary register; a operationRegister zero (0) indicates no bits set (also send 0 to clear all bits);...
  • Page 668 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual Example 2 status.operation.remote.enable = 2050 Uses the decimal value to set bits B1 and B11 of the operation status remote summary enable register. Also see Operation Status Registers (on page 15-8) status.operation.* (on page 11-281)
  • Page 669 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference Value and description Not used status.operation.sweeping.SMUA Set bit indicates that SMU A is sweeping. Bit B1 decimal value: 2 Binary value: 0000 0010 Not used B2 to B15 As an example, to set bit B1 of the operation status sweeping summary enable register, set status.operation.sweeping.enable = status.operation.sweeping.SMUA.
  • Page 670 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual Details These attributes are used to read or write to the operation status trigger overrun summary registers. Reading a status register returns a value. The binary equivalent of the returned value indicates which register bits are set.
  • Page 671 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference As an example, to set bit B1 of the operation status trigger overrun summary enable register, set status.operation.trigger_overrun.enable = status.operation.trigger_overrun.SMUA. In addition to the above constants, operationRegister can be set to the numeric equivalent of the bit to set.
  • Page 672 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual Usage operationRegister = status.operation.user.condition operationRegister = status.operation.user.enable operationRegister = status.operation.user.event operationRegister = status.operation.user.ntr operationRegister = status.operation.user.ptr status.operation.user.condition = operationRegister status.operation.user.enable = operationRegister status.operation.user.ntr = operationRegister status.operation.user.ptr = operationRegister The status of the operation status user register;...
  • Page 673 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference Value Decimal value 16,384 status.operation.user.BIT14 Not used Not applicable As an example, to set bit B0 of the operation status user enable register, set status.operation.user.enable = status.operation.user.BIT0. In addition to the above constants, operationRegister can be set to the decimal value of the bit to set.
  • Page 674 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual status.questionable.* These attributes manage the questionable status register set of the status model. Type TSP-Link accessible Affected by Where saved Default value Attribute .condition (R) Not applicable Not saved Not applicable .enable (RW) Status reset...
  • Page 675 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference Value and description status.questionable.UNSTABLE_OUTPUT status.questionable.UO An enabled bit in the questionable status unstable output summary event register is set. Bit B9 decimal value: 512 Not used Not used status.questionable.OVER_TEMPERATURE status.questionable.OTEMP An enabled bit in the questionable status over temperature summary event register is set.
  • Page 676 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual status.questionable.calibration.* This attribute contains the questionable status calibration summary register set. Type TSP-Link accessible Affected by Where saved Default value Attribute .condition (R) Not applicable Not saved Not applicable .enable (RW) Status reset Not saved...
  • Page 677 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference Example status.questionable.calibration.enable = status.questionable.calibration.SMUA Uses a constant to set the SMUA bit of the questionable status calibration summary enable register. Also see Questionable Status Registers (on page 15-13) status.questionable.* (on page 11-316) status.questionable.instrument.*...
  • Page 678 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual As an example, to set bit B1 of the questionable status instrument summary enable register, set status.questionable.instrument.enable = status.questionable.instrument.SMUA. In addition to the constant, questionableRegister can be set to the decimal value of the bit. Example status.questionable.instrument.enable = status.questionable.instrument.SMUA Uses a constant to set the SMUA bit of the questionable status instrument summary enable register.
  • Page 679 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference > > > > > > > > > > > > > > * Least significant bit ** Most significant bit For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents (on page 15-1) and...
  • Page 680 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual Example questionableRegister = status.questionable.instrument.smua.CAL + status.questionable.instrument.smua.UO status.questionable.instrument.smua.enable = questionableRegister Uses constants to set bits B8 and bit B9 of the questionable status SMU A summary enable register. Example questionableRegister = 768 status.questionable.instrument.smua.enable = questionableRegister Uses the decimal value to set bits B8 and bit B9 of the questionable status SMU A summary enable register.
  • Page 681 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference Value Not used status.questionable.over_temperature.SMUA Set bit indicates that an over temperature condition was detected on SMU A. Bit B1 decimal value: 2 Binary value: 0000 0010 Not used B2 to B15 As an example, to set bit B1 of the questionable status over temperature summary enable register, set status.questionable.instrument.enable =...
  • Page 682 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual Details These attributes are used to read or write to the questionable status unstable output summary registers. Reading a status register returns a value. The binary equivalent of the returned value indicates which register bits are set.
  • Page 683 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference Details This attribute is used to read or write to the service request enable register. Reading the service request enable register returns a value. The binary equivalent of the value of this attribute indicates which register bits are set.
  • Page 684 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual As an example, to set bit B0 of the service request enable register, set status.request_enable = status.MSB. In addition to the above values, requestSRQEnableRegister can be set to the decimal value of the bit to set.
  • Page 685 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference > > > > > > * Least significant bit ** Most significant bit The returned value can indicate one or more status events occurred. For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents (on page 15-1) and...
  • Page 686 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual Binary value Decimal Weights Example requestEventRegister = status.request_event print(requestEventRegister) Reads the status request event register. Sample output: 1.29000e+02 Converting this output (129) to its binary equivalent yields 1000 0001. Therefore, this output indicates that the set bits of the status request event register are presently B0 (MSB) and B7 (OSB).
  • Page 687 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference status.standard.* These attributes manage the standard event status register set of the status model. Type TSP-Link accessible Affected by Where saved Default value Attribute .condition (R) Not applicable Not saved Not applicable .enable (RW)
  • Page 688 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual Value status.standard.QUERY_ERROR status.standard.QYE Set bit indicates that you attempted to read data from an empty Output Queue. Bit B2 decimal value: 4 status.standard.DEVICE_DEPENDENT_ERROR status.standard.DDE Set bit indicates that an instrument operation did not execute properly due to some internal condition.

  • Page 689: Status.system2.Enable = Enableregister

    Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference Example 2 -- decimal 17 = binary 0001 0001 standardRegister = 17 status.standard.enable = standardRegister Uses the decimal value to set the OPC and EXE bits of the standard event status enable register. Also see Standard Event Register (on page 15-21)
  • Page 690 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents (on page 15-1) and Enable and transition registers (on page 15-19). The individual bits of this register are defined in the following table.
  • Page 691 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference Example 1 enableRegister = status.system.NODE11 + status.system.NODE14 status.system.enable = enableRegister Uses constants to set bits B11 and B14 of the system summary enable register. Example 2 -- decimal 18432 = binary 0100 1000 0000 0000 enableRegister = 18432 status.system.enable = enableRegister Uses the decimal value to set bits B11 and B14 of the system summary enable register.
  • Page 692 Section 11: TSP command reference Model 2601B-PULSE 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 693 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: 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.system2.NODE25 + status.system2.NODE28 status.system2.enable = enableRegister Uses constants to set bits B11 and B14 of the system summary 2 enable register. Example 2 -- decimal 18432 = binary 0100 1000 0000 0000 enableRegister = 18432...
  • Page 694 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual Usage enableRegister = status.system3.condition enableRegister = status.system3.enable enableRegister = status.system3.event enableRegister = status.system3.ntr enableRegister = status.system3.ptr status.system3.enable = enableRegister status.system3.ntr = enableRegister status.system3.ptr = enableRegister The status of the system summary 3 register; a zero (0) indicates no bits set; other enableRegister values indicate various bit settings Details...
  • Page 695 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference Value Decimal value 16,384 status.system3.NODE42 Not used Not applicable As an example, to set bit B0 of the system summary 3 enable register, set status.system3.enable = status.system3.EXT. In addition to the above constants, enableRegister can be set to the decimal value of the bit to set.
  • Page 696 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual status.system4.* These attributes manage the TSP-Link system summary register of the status model for nodes 43 through 56. ® Type TSP-Link accessible Affected by Where saved Default value Attribute .condition (R) Not applicable...
  • Page 697 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference Value Decimal value status.system4.NODE48 status.system4.NODE49 status.system4.NODE50 status.system4.NODE51 1,024 status.system4.NODE52 2,048 status.system4.NODE53 4,096 status.system4.NODE54 status.system4.NODE55 8,192 16,384 status.system4.NODE56 Not used Not applicable As an example, to set bit B0 of the system summary 4 enable register, set status.system4.enable = status.system4.enable.EXT.

  • Page 698: Status.system5.Enable = Enableregister

    Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual status.system5.* These attributes manage the TSP-Link system summary register of the status model for nodes 57 through 64. ® Type TSP-Link accessible Affected by Where saved Default value Attribute .condition (R) Not applicable...
  • Page 699 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference Value Decimal value status.system5.NODE61 status.system5.NODE62 status.system5.NODE63 status.system5.NODE64 Not used Not applicable B9 to B15 As an example, to set bit B1 of the system summary 5 enable register, set status.system5.enable = status.system5.NODE57.
  • Page 700 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual SweepILinMeasureV() This KISweep factory script function performs a linear current sweep with voltage measured at every step (point). Type TSP-Link accessible Affected by Where saved Default value Function Usage SweepILinMeasureV(smua, starti, stopi, stime, points) Sweep start current in amperes...
  • Page 701 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference Example SweepILinMeasureV(smua, -1e-3, 1e-3, 0, 100) This function performs a 100-point linear current sweep starting at −1 mA and stopping at +1 mA. Voltage is measured at every step (point) in the sweep. Because stime is set for 0 s, voltage is measured as quickly as possible after each current step.
  • Page 702 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual SweepILogMeasureV() This KISweep factory script function performs a logarithmic current sweep with voltage measured at every step (point). Type TSP-Link accessible Affected by Where saved Default value Function Usage SweepILogMeasureV(smua, starti, stopi, stime, points) Sweep start current in amperes...
  • Page 703 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference Figure 146: SweepILogMeasureV() Example SweepILogMeasureV(smua, 0.01, 0.1, 0.001, 5) This function performs a five-point linear current sweep starting at 10 mA and stopping at 100 mA. Voltage is measured at every step (point) in the sweep.
  • Page 704 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual Performs a linear voltage sweep with current measured at every step (point): 1. Sets the SMU to output startv amperes, allows the source to settle for stime seconds, and then makes a current measurement.
  • Page 705 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference Details Data for current measurements, voltage source values, and timestamps are stored in smua.nvbuffer1. If all parameters are omitted when this function is called, this function is executed with the parameters set to the default values.
  • Page 706 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual Performs a logarithmic voltage sweep with current measured at every step (point): 1. Sets the SMU to output startv amperes, allows the source to settle for stime seconds, and then makes a current measurement.
  • Page 707 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference timer.measure.t() This function measures the elapsed time since the timer was last reset. Type TSP-Link accessible Affected by Where saved Default value Function Usage time = timer.measure.t() The elapsed time in seconds (1 µs resolution) time Example 1 This example resets the timer and measures the time since the...
  • Page 708 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual Also see timer.measure.t() (on page 11-349) 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...
  • Page 709 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: 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) Trigger blender N reset Recall setup...
  • Page 710 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual trigger.blender[N].overrun This attribute indicates whether or not an event was ignored because of the event detector state. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Instrument reset Not applicable Not applicable...
  • Page 711 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference Example Resets the trigger blender 1 settings to trigger.blender[1].reset() factory defaults. Also see trigger.blender[N].orenable (on page 11-351) trigger.blender[N].overrun (on page 11-352) trigger.blender[N].stimulus[M] (on page 11-353) trigger.blender[N].stimulus[M] This attribute specifies the events that trigger the blender. Type TSP-Link accessible Affected by...
  • Page 712 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual Trigger event IDs* Event ID Event description Occurs when a *TRG command is received on the trigger.EVENT_ID remote interface GPIB only: Occurs when a GET bus command is received USB only: Occurs when a USBTMC TRIGGER message is received...
  • Page 713 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference Example digio.trigger[3].mode = digio.TRIG_FALLING digio.trigger[5].mode = digio.TRIG_FALLING trigger.blender[1].orenable = true trigger.blender[1].stimulus[1] = digio.trigger[3].EVENT_ID trigger.blender[1].stimulus[2] = digio.trigger[5].EVENT_ID print(trigger.blender[1].wait(3)) Generate a trigger blender 1 event when a digital I/O trigger happens either on line 3 or 5. Wait three seconds while checking if trigger blender 1 event has occurred.
  • Page 714 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual Example Sets the trigger stimulus of trigger timer 1 to trigger.timer[1].stimulus = trigger.EVENT_ID the command interface trigger event. Also see None trigger.generator[N].assert() This function generates a trigger event. Type TSP-Link accessible Affected by...
  • Page 715 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference Example digio.trigger[5].stimulus = trigger.generator[2].EVENT_ID Uses a trigger event on generator 2 to be the stimulus for digital I/O trigger line 5. Also see trigger.generator[N].assert() (on page 11-356) trigger.timer[N].clear() This function clears the timer event detector and overrun indicator for the specified trigger timer number.
  • Page 716 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual If you use the trigger timer with a trigger model, make sure the count value is the same or more than any count values expected in the trigger model. Example print(trigger.timer[1].count) Read trigger count for timer number 1.
  • Page 717 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference trigger.timer[N].delaylist This attribute sets an array of timer intervals. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Instrument reset Not saved 10e-6 (10 µs) Recall setup Trigger timer N reset Usage intervals = trigger.timer[N].delaylist...
  • Page 718 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual 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 The trigger event number eventID Trigger timer number (1 to 8) Details This constant is an identification number that identifies events generated by this timer.
  • Page 719 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference Example If an event was ignored, the output is true. print(trigger.timer[1].overrun) If the event was not ignored, the output is false. Also see trigger.timer[N].reset() (on page 11-361) trigger.timer[N].passthrough This attribute enables or disables the timer trigger pass-through mode.
  • Page 720 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual Details The trigger.timer[N].reset() function resets the following attributes to their factory defaults: ▪ trigger.timer[N].count ▪ trigger.timer[N].delay ▪ trigger.timer[N].delaylist ▪ trigger.timer[N].passthrough ▪ trigger.timer[N].stimulus It also clears trigger.timer[N].overrun. Example Resets the attributes associated with timer 1 back to factory trigger.timer[1].reset() default values.
  • Page 721 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference Trigger event IDs* Event ID Event description Occurs when the SMU completes a measurement action smua.trigger.MEASURE_COMPLETE_EVENT_ID Occurs when the SMU completes a pulse smua.trigger.PULSE_COMPLETE_EVENT_ID Occurs when the SMU completes a sweep smua.trigger.SWEEP_COMPLETE_EVENT_ID Occurs when the SMU returns to the idle state smua.trigger.IDLE_EVENT_ID...
  • Page 722 Section 11: TSP command reference Model 2601B-PULSE 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) Maximum amount of time in seconds to wait for the trigger timeout Details...
  • Page 723 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference Details This function waits up to timeout seconds for a trigger on the active command interface. A command interface trigger occurs when: • A GPIB GET command is detected (GPIB only) •...
  • Page 724 Section 11: TSP command reference Model 2601B-PULSE 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 The node number of the master node...
  • Page 725 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: 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 data The trigger line (1 to 3) Details...
  • Page 726 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual Also see TSP-Link trigger lines (on page 6-39) tsplink.readbit() (on page 11-367) tsplink.writebit() (on page 11-377) tsplink.writeport() (on page 11-378) tsplink.reset() This function initializes (resets) all nodes (instruments) in the TSP-Link system. Type TSP-Link accessible Affected by...
  • Page 727 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: 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 TSP-Link state (online or offline) state Details...
  • Page 728 Section 11: TSP command reference Model 2601B-PULSE 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 729 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference Example Sets the trigger stimulus of trigger.timer[1].stimulus = tsplink.trigger[2].EVENT_ID trigger timer 1 to the TSP-Link trigger 2 event. Also see None tsplink.trigger[N].mode This attribute defines the trigger operation and detection mode. Type TSP-Link accessible Affected by...
  • Page 730 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual Mode Number Description value Detects rising-edge triggers as an input. Asserts a TTL-low tsplink.TRIG_SYNCHRONOUSM pulse for output. Detects rising-edge triggers as input. Asserts a TTL-low tsplink.TRIG_RISINGA pulse for output. Edge detection as an input is not available.
  • Page 731 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference Details This command indicates whether an event has been ignored because the event detector was already in the detected state when the event occurred. This is an indication of the state of the event detector built into the synchronization line itself. It does not indicate if an overrun occurred in any other part of the trigger model, or in any other construct that is monitoring the event.
  • Page 732 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual tsplink.trigger[N].release() This function releases a latched trigger on the given TSP-Link trigger line. Type TSP-Link accessible Affected by Where saved Default value Function Usage tsplink.trigger[N].release() The trigger line (1 to 3) Details Releases a trigger that was asserted with an indefinite pulse width.
  • Page 733 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference Example Resets TSP-Link trigger line 3 attributes back to factory default values. tsplink.trigger[3].reset() Also see tsplink.trigger[N].mode (on page 11-371) tsplink.trigger[N].overrun (on page 11-372) tsplink.trigger[N].pulsewidth (on page 11-373) tsplink.trigger[N].stimulus (on page 11-375) tsplink.trigger[N].stimulus This attribute specifies the event that causes the synchronization line to assert a trigger.
  • Page 734 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual Trigger event IDs* Event ID Event description Occurs when a *TRG command is received on the trigger.EVENT_ID remote interface GPIB only: Occurs when a GET bus command is received USB only: Occurs when a USBTMC TRIGGER message is received...
  • Page 735 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference Example Waits up to 10 seconds for a trigger on triggered = tsplink.trigger[3].wait(10) TSP-Link ® line 3. print(triggered) If false is returned, no trigger was detected during the 10-second timeout. If true is returned, a trigger was detected.
  • Page 736 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual tsplink.writeport() This function writes to all TSP-Link synchronization lines. Type TSP-Link accessible Affected by Where saved Default value Function Usage tsplink.writeport(data) Value to write to the port (0 to 7) data Details The binary representation of data indicates the output pattern that is written to the I/O port.
  • Page 737 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference Details The binary equivalent of mask indicates the mask to be set for the TSP-Link trigger line. For example, a mask value of 5 has a binary equivalent of 101. This mask write-protects TSP-Link trigger lines 1 and 3.
  • Page 738 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual tspnet.connect() This function establishes a network connection with another LAN instrument or device through the LAN interface. Type TSP-Link accessible Affected by Where saved Default value Function Usage connectionID = tspnet.connect("ipAddress") connectionID = tspnet.connect("ipAddress", portNumber, "initString") The connection ID to be used as a handle in all other tspnet function calls...
  • Page 739 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference Example 2 instrumentID = tspnet.connect("192.0.2.1", 1394, "*rst\r\n") if instrumentID then -- Use instrumentID as needed here tspnet.disconnect(instrumentID) Connect to a device that is not TSP-enabled. Also see localnode.prompts (on page 11-142) localnode.showerrors (on page 11-146)
  • Page 740 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual tspnet.execute() This function sends a command string to the remote device. Affected by Where saved Default value Type TSP-Link accessible Function Usage tspnet.execute("connectionID", "commandString") value1 = tspnet.execute("connectionID", "commandString", formatString) value1, value2 = tspnet.execute("connectionID", "commandString", formatString) value1, ..., valueN = tspnet.execute("connectionID", "commandString", formatString) The connection ID returned from tspnet.connect()
  • Page 741 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference tspnet.idn() This function retrieves the response of the remote device to *IDN?. Type TSP-Link accessible Affected by Where saved Default value Function Usage idnString = tspnet.idn(connectionID) The returned *IDN? string idnString The connection ID returned from tspnet.connect() connectionID...
  • Page 742 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual Details This command reads available data from the remote instrument and returns responses for the specified number of arguments. The format string can contain the following specifiers: Read data until the specified length %[width]s Read data until the specified length or until punctuation is found, whichever comes first %[max width]t...
  • Page 743 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference Example ID = tspnet.connect("192.0.2.1") tspnet.write(ID, "*idn?\r\n") repeat bytes = tspnet.readavailable(ID) until bytes > 0 print(tspnet.read(ID)) tspnet.disconnect(ID) Send commands that will create data. Wait for data to be available. Also see tspnet.connect() (on page 11-380)
  • Page 744 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual Details This function sets and gets the termination character sequence that is used to indicate the end of a line for a TSP-Net connection. Using the termSequence parameter sets the termination sequence. The present termination sequence is always returned.
  • Page 745 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: 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 746 Section 11: TSP command reference Model 2601B-PULSE 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 11-380) tspnet.tsp.rbtablecopy() This function copies a reading buffer synchronous table from a remote instrument to a TSP-enabled instrument.
  • Page 747 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: 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") Integer value used as an identifier for other tspnet commands connectionID name...
  • Page 748 Section 11: TSP command reference Model 2601B-PULSE 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") The connection ID returned from tspnet.connect() connectionID The string to be written inputString...
  • Page 749 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference Details This function associates the string value with the string name and stores this key-value pair in nonvolatile memory. Use the userstring.get() function to retrieve the value associated with the specified name. 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 750 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual Example 2 Prints all userstring key-value pairs. userstring.add("assetnumber", "236") userstring.add("product", "Widgets") Output: userstring.add("contact", "John Doe") product = Widgets for name in userstring.catalog() do assetnumber = 236 print(name .. " = " .. contact = John Doe userstring.get(name)) Notice the key-value pairs are not listed in...
  • Page 751 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference userstring.get() This function retrieves a user-defined string from nonvolatile memory. Type TSP-Link accessible Affected by Where saved Default value Function Usage value = userstring.get("name") The value of the user-defined string key-value pair value The name (key) of the user-defined string name...
  • Page 752 Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual Details There are two types of instrument commands: • Overlapped commands: Commands that allow the execution of subsequent commands while instrument operations of the overlapped command are still in progress. •...
  • Page 753 Section 12 Troubleshooting guide In this section: Introduction ................12-1 Error levels ................12-1 Effects of errors on scripts............12-1 Retrieving errors ..............12-2 Error summary list ..............12-2 Introduction Troubleshooting information includes information on the Keithley Instruments 2601B-PULSE errors (including a complete listing of error messages) and LAN troubleshooting suggestions.
  • Page 754 Section 12: Troubleshooting guide Model 2601B-PULSE 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 755 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 12: Troubleshooting guide Error summary Error number Error level Error message NO_SEVERITY Queue Is Empty RECOVERABLE Calibration overflow RECOVERABLE Reading buffer data lost RECOVERABLE Power on state lost FATAL Unresponsive digital FPGA RECOVERABLE OUTPUT blocked by interlock RECOVERABLE...
  • Page 756 Section 12: Troubleshooting guide Model 2601B-PULSE System SourceMeter Instrument Reference Manual Error summary Error number Error level Error message 1504 RECOVERABLE Invalid flow control setting 1600 RECOVERABLE Maximum GPIB message length exceeded 1700 RECOVERABLE Display area boundary exceeded 1800 RECOVERABLE Invalid digital trigger mode 1801 RECOVERABLE...
  • Page 757 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 12: 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 2417 RECOVERABLE TSPnet disconnected by other side...
  • Page 758 Section 12: Troubleshooting guide Model 2601B-PULSE System SourceMeter Instrument Reference Manual Error summary Error number Error level Error message 5047 RECOVERABLE Minimum timestamp resolution is 1us 5048 RECOVERABLE Contact check not valid with HIGH-Z OUTPUT off 5049 RECOVERABLE Contact check not valid while an active current source 5050 RECOVERABLE I limit too low for contact check...
  • Page 759 Section 13 Calibration In this section: Calibration ................13-1 Adjustment ................13-19 Calibration The information in this section is intended for qualified service personnel only, as described by the types of product users in the Safety Precautions pages, provided at the beginning of this document.
  • Page 760 Section 13: Calibration Model 2601B-PULSE System SourceMeter Instrument Reference Manual Calibration test requirements Be sure that you perform the calibration tests: • Under the proper environmental conditions. • After the specified warmup period. • Using the correct line voltage. • Using the proper test equipment.
  • Page 761 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 13: Calibration Recommended calibration equipment The following table summarizes recommended maximum allowable test equipment uncertainty for calibration 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 2601B-PULSE specifications.
  • Page 762 Section 13: Calibration Model 2601B-PULSE System SourceMeter Instrument Reference Manual Figure 149: Pulse load schematic Calibration limits The calibration limits stated in this section have been calculated using only the 2601B-PULSE one-year accuracy specifications. They do not include test equipment uncertainty. If a particular measurement falls outside the allowable range, recalculate new limits based both on the 2601B-PULSE specifications and corresponding test equipment specifications.
  • Page 763 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 13: Calibration Uninstalling the 2601B-P-INT The 2601B-PULSE is normally operated with the 2601B-P-INT Interlock and Cable Connector Box installed on the rear panel of the instrument. To perform the calibration and adjust procedures, you must uninstall the 2601B-P-INT.
  • Page 764 Section 13: Calibration Model 2601B-PULSE System SourceMeter Instrument Reference Manual Performing the calibration test procedures Perform the following calibration tests to make sure the instrument is operating within specifications: • Current source accuracy (on page 13-8) • Current measurement accuracy (on page 13-10) •...
  • Page 765 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 13: Calibration 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 2601B-PULSE while the instrument is powered on. Turn off the equipment from the front panel or disconnect the main power cord from the rear of the 2601B-PULSE before handling cables.
  • Page 766 Section 13: Calibration Model 2601B-PULSE System SourceMeter Instrument Reference Manual Current source accuracy To verify the 2601B-PULSE output current accuracy is within specified limits, perform these steps: 1. With the power off, connect the digital multimeter to the 2601B-PULSE terminals as shown in the figure below.
  • Page 767 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 13: Calibration 5. Repeat the procedure for negative output currents with the same magnitudes as those listed. 6. Turn the output off, and change connections as shown in the figure below. Figure 152: Connections for the 3 A current range 7.
  • Page 768 Section 13: Calibration Model 2601B-PULSE System SourceMeter Instrument Reference Manual Current measurement accuracy Follow the steps below to verify that 2601B-PULSE current measurement accuracy is within specified limits. The procedure involves applying accurate currents from the 2601B-PULSE current source and then verifying that 2601B-PULSE current measurements are within required limits.
  • Page 769 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 13: Calibration Current measurement accuracy limits Source and measure range Source current Current reading limits (1 year, 18° C to 28° C) 100 nA 90.000 nA 89.855 nA to 90.145 nA 1 µA 0.9000 µA 0.89928 µA to 0.90073 µA 10 µA...
  • Page 770 Section 13: Calibration Model 2601B-PULSE System SourceMeter Instrument Reference Manual 9. Select the DMM volts function. 10. Set the 2601B-PULSE SMU to both source and measure current by pressing the SRC and then the MEAS keys. 11. Make sure the source output is turned on. 12.
  • Page 771 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 13: Calibration Figure 155: Connections for voltage verification 2. Set the multimeter measuring function to DC volts. 3. Press the SRC key to source voltage and make sure the source output is turned on. 4.
  • Page 772 Section 13: Calibration Model 2601B-PULSE System SourceMeter Instrument Reference Manual Voltage measurement accuracy Follow the steps below to verify that the 2601B-PULSE voltage measurement accuracy is within specified limits. To perform this test, you will set the source voltage, as measured by a precision digital multimeter, and then verify that the 2601B-PULSE voltage readings are within required limits.
  • Page 773 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 13: Calibration Pulse accuracy These steps verify that the 2601B-PULSE pulse current, voltage measurement, and current measurement accuracy is within specified limits. For detail on wiring the pulse load, refer to Pulse loads (on page 13-3).
  • Page 774 Section 13: Calibration Model 2601B-PULSE System SourceMeter Instrument Reference Manual 3. Select the digitizing function on the multimeter. 4. Reconnect power to the 2601B-PULSE and turn on the instrument. 5. Create a pulse using the code provided below (following the tables). 6.
  • Page 775 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 13: Calibration -- Set the bias level. smua.source.leveli = 0 -- Set up the pulser. smua.measure.autozero = smua.AUTOZERO_OFF smua.source.offmode = smua.OUTPUT_HIGH_Z smua.pulser.protect.sensev = 10 smua.pulser.protect.sourcev = 20 --Set the voltage range. if (pulseRange > 5) then smua.pulser.rangev = 10 else smua.pulser.rangev = 5...
  • Page 776 Section 13: Calibration Model 2601B-PULSE System SourceMeter Instrument Reference Manual -- Pulse is done. Turn off the output. smua.source.output = 0 smua.pulser.enable = 0 -- Retrieve measurements as a comma-separated list. format.data = format.ASCII printbuffer(1, 1, smua.nvbuffer1) -- current measurements printbuffer(1, 1, smua.nvbuffer2) -- voltage measurements Bias source accuracy For detail on wiring the pulse load, refer to...
  • Page 777 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 13: Calibration 2. Select the multimeter DC current measuring function. 3. Reconnect power to the 2601B-PULSE and turn on the instrument. 4. Enable the pulser output using the code below. 5. Verify bias source accuracy for each of the currents using the values in the following table. For each test point: Set the 2601B-PULSE output current to the correct value.
  • Page 778 Section 13: Calibration Model 2601B-PULSE System SourceMeter Instrument Reference Manual Environmental conditions Temperature and relative humidity Conduct the adjustment procedures at an ambient temperature of 18 °C to 28 °C, with relative humidity of less than 70 percent (unless otherwise noted). Product specifications that are listed as 18 °C to 28 °C assume adjustment has been done at 23 °C.
  • Page 779 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 13: Calibration The FORCE and SENSE connectors of the 2601B-PULSE are rated for connection to circuits rated Measurement Category I only, with transients rated less than 1500 V . Do not PEAK connect the 2601B-PULSE terminals to CAT II, CAT III, or CAT IV circuits.
  • Page 780 Section 13: Calibration Model 2601B-PULSE System SourceMeter Instrument Reference Manual Recommended adjustment equipment Description Manufacturer/Model Accuracy 1 Ω, 10 V, 1% pulse Resistance 1 Ω: ±100 ppm load 10 Ω, 10 V, 1% pulse Resistance 10 Ω: ±25 ppm load 1.
  • Page 781 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 13: Calibration 2601B-PULSE adjustment steps Function Adjustment steps Adjustment points Sense mode Voltage source 100 mV ±1e-30, ±90 mV smua.SENSE_LOCAL and measure 100 mV ±1e-30, ±90 mV smua.SENSE_REMOTE ±1e-30, ±0.9 V smua.SENSE_LOCAL ±1e-30, ±0.9 V smua.SENSE_CALA ±1e-30, ±5.4 V...
  • Page 782 Section 13: Calibration Model 2601B-PULSE System SourceMeter Instrument Reference Manual Command Description Stores the date of the last calibration adjustment. smua.cal.adjustdate = adjustDate Stores the calibration date of the active calibration set. smua.cal.date = calDate Stores the calibration due date for the next calibration smua.cal.due = calDue (calDue of 0 indicates date not set).
  • Page 783 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 13: Calibration Command Description Adjusts the voltage source range*: smua.source.calibratev(range, ±range (source range to adjust). cp1Expected, cp1Reference, cp2Expected, cp2Reference) cp1Expected (source value programmed for point 1). cp1Reference (reference measurement for point 1). cp2Expected (source value programmed for point 2).
  • Page 784 Section 13: Calibration Model 2601B-PULSE System SourceMeter Instrument Reference Manual Adjustment procedure Use the following procedure to perform remote calibration adjustment by sending commands over a communications interface. The remote commands and appropriate parameters are separately summarized for each step. Step 1.
  • Page 785 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 13: Calibration B. Send the following commands to initialize voltage adjustment: smua.cal.unlock("KI0026XX") smua.reset() smua.source.func = smua.OUTPUT_DCVOLTS It is not necessary to set the measure range when following this procedure for adjustment because the measure range is locked to the source range when measuring the source function.
  • Page 786 Section 13: Calibration Model 2601B-PULSE System SourceMeter Instrument Reference Manual 11. Send the source calibration command using the range, +zero and +FS multimeter readings, and +zero and +FS source values for the parameters: smua.source.calibratev(range, src_Z, DMM_Z_rdg, src_FS, DMM_FS_rdg) Where: = The present adjustment range range = The +zero 2601B-PULSE programmed source output value src_Z...
  • Page 787 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 13: Calibration 20. Turn off the output: smua.source.output = smua.OUTPUT_OFF 21. Send the source calibration command using the range, -zero and -FS multimeter readings, and -zero and -FS source values for the parameters: smua.source.calibratev(-range, src_Z, DMM_Z_rdg, src_FS, DMM_FS_rdg) Where: = The negative of the present adjustment range...
  • Page 788 Section 13: Calibration Model 2601B-PULSE System SourceMeter Instrument Reference Manual Step 3. Current adjustment A. Connect the 2601B-PULSE SMU to the digital multimeter (see the following figure), and then select the multimeter DC current function. B. Send this command to initialize current adjustment: smua.source.func = smua.OUTPUT_DCAMPS Figure 159: Connections for 100 nA to 1 A current ranges It is not necessary to set the measure range when following this procedure for adjustment because...
  • Page 789 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 13: Calibration Allow the readings to settle, then get both the multimeter and 2601B-PULSE current readings at the positive zero value (the 2601B-PULSE measurement is not necessary if this step is being done on the CALA sense mode).
  • Page 790 Section 13: Calibration Model 2601B-PULSE System SourceMeter Instrument Reference Manual 14. Turn on the output: smua.source.output = smua.OUTPUT_ON 15. Allow the readings to settle, then get both the multimeter and 2601B-PULSE current readings at the negative zero value (the 2601B-PULSE measurement is not necessary if this step is being done on the CALA sense).
  • Page 791 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 13: Calibration D. Before continuing, be sure to complete all steps for the 100 nA to 1 A ranges before continuing with 3 A and 10 A range adjustment. E. Change connections as shown in the following figure. Figure 160: Connections for 1.5 A and 3 A current ranges F.
  • Page 792 Section 13: Calibration Model 2601B-PULSE System SourceMeter Instrument Reference Manual Step 4. Contact check adjustment A. As illustrated in the following figure: Short the 2601B-PULSE SENSE LO and LO terminals together. ▪ Short the SENSE HI and HI terminals together. ▪...
  • Page 793 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 13: Calibration Figure 162: Connections for contact check 50 Ω calibration E. Allow the readings to settle, then get the 2601B-PULSE readings: r50_hi, r50_lo = smua.contact.r() F. Send the contact check low calibration command: smua.contact.calibratelo(r0_lo, Z_actual, r50_lo, 50_ohm_actual) Where: = 2601B-PULSE 0 Ω...
  • Page 794 Section 13: Calibration Model 2601B-PULSE System SourceMeter Instrument Reference Manual G. Send the contact check high calibration command: smua.contact.calibratehi(r0_hi, Z_actual, r50_hi, 50_ohm_actual) Where: = 2601B-PULSE 0 Ω high measurement r0_hi = Actual zero value; the resistance of the short between the SENSE HI and HI Z_actual terminals = 2601B-PULSE 50 Ω...
  • Page 795 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 13: Calibration C. Perform each step listed in the step sequence for the 250 mA range as follows: Characterize the resistor. Reset the instrument. Set the High-Z output-off mode. smua.reset() smua.source.offmode = smua.OUTPUT_HIGH_Z Select the range being adjusted: smua.pulser.rangev = 5 smua.pulser.rangei = 5...
  • Page 796 Section 13: Calibration Model 2601B-PULSE System SourceMeter Instrument Reference Manual 16. Send the source calibration command using the range, zero and +FS multimeter readings, and zero and +FS source values for the parameters: smua.pulser.source.calibratebiasi(range, src_Z, DMM_Z_rdg, src_FS, DMM_FS_rdg) Where: = The present adjustment range range = The +zero 2601B-PULSE source output value src_Z...
  • Page 797 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 13: Calibration The two measurements should be made as close as possible in time. Use this command for the 2601B-PULSE: FS_rdg = smua.measure.i() 26. Turn off the output and disable the pulser: smua.source.output = smua.OUTPUT_OFF smua.pulser.enable = 0 27.
  • Page 798 Section 13: Calibration Model 2601B-PULSE System SourceMeter Instrument Reference Manual To adjust the pulse: A. Connect the 2601B-PULSE to the digitizer as shown in the following figure. Figure 164: Pulse accuracy calibration and adjustment connections B. Select the multimeter DC current function. C.
  • Page 799 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 13: Calibration Select positive polarity, set the bias source output to 5 mA, and turn autozero off: smua.cal.polarity = smua.CAL_POSITIVE smua.source.leveli = 5e-3 smua.measure.autozero = smua.AUTOZERO_OFF Configure the trigger so the external digitizer can synchronize measurements: digio.trigger[1].mode = digio.TRIG_RISING digio.trigger[1].pulsewidth = 10e-6 digio.trigger[1].stimulus = smua.trigger.SOURCE_COMPLETE_EVENT_ID...
  • Page 800 Section 13: Calibration Model 2601B-PULSE System SourceMeter Instrument Reference Manual 11. Read out the buffer: ZS_IRdg = printbuffer(1, 1, smua.nvbuffer1) ZS_VRdg(1, 1, smua.nvbuffer2) -- voltage measurements. 12. Do this 10 times and average the results. 13. Set the source output to the positive full-scale value for the present range, for example: smua.trigger.source.listi({0.75}) 14.
  • Page 801 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 13: Calibration 21. Send the current measure calibration command using the range, averaged zero and averaged full scale digitizer readings, and averaged zero and averaged full scale source values for the parameters: smua.pulser.source.calibratei(range, ZS_IRdg, digi_Z_rdg, FS_IRdg, digi_FS_rdg) Where: = The present adjustment range...
  • Page 802 Section 13: Calibration Model 2601B-PULSE System SourceMeter Instrument Reference Manual 30. Read out the buffer: ZS_IRdg = printbuffer(1, 1, smua.nvbuffer1) ZS_VRdg(1, 1, smua.nvbuffer2) -- voltage measurements. 31. Do this 10 times and average the results. 32. Set the source output to the positive full-scale value for the present range, for example: smua.trigger.source.listi({-0.75}) 33.
  • Page 803 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 13: Calibration 40. Send the current measure calibration command using the range, averaged zero and averaged full scale digitizer readings, and averaged zero and averaged full scale source values for the parameters: smua.pulser.measure.calibratei(range, DMM_Z_Rdg, digi_Z_rdg, FS_IRdg, digi_FS_rdg) Where:...
  • Page 804 Section 13: Calibration Model 2601B-PULSE System SourceMeter Instrument Reference Manual Step 7. Program calibration dates Use the following command to set the calibration adjustment date: smua.cal.adjustdate = os.time{year=2019, month=12, day=1} Optionally, it is possible to set the calibration date and calibration due date with the following commands: smua.cal.date = os.time{year=2019, month=12, day=1} smua.cal.due = os.time{year=2020, month=12, day=1}...
  • Page 805 Section 14 Common commands In this section: Command summary ............... 14-1 Script command equivalents ..........14-2 Command reference .............. 14-3 Command summary The IEEE Std 488.2 common commands that are supported by the 2601B-PULSE 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 806 Section 14: Common commands Model 2601B-PULSE System SourceMeter Instrument Reference Manual Command Name Description Operation complete query Places an ASCII "1" into the output queue when all selected *OPC? device operations have completed. For detailed information, Operation complete and query: *OPC and *OPC? page 14-3).
  • Page 807 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 14: Common commands Command reference Details of all common commands (except those associated with the status model) are described below. Status command usage is in the Status model (on page 15-1). Identification query: *IDN? Retrieves the identification string.
  • Page 808 Section 14: Common commands Model 2601B-PULSE System SourceMeter Instrument Reference Manual Self-test query: *TST? Requests self-test results. Places a zero (0) in the output queue *TST? This command always places a zero (0) in the output queue. This command is included for common command compatibility only;...
  • Page 809 Section 15 Status model In this section: Overview ................15-1 Clearing registers ..............15-13 Programming enable and transition registers ....... 15-14 Reading registers ..............15-15 Status byte and service request (SRQ) ........ 15-15 Status register sets .............. 15-20 TSP-Link system status ............15-25 Overview Each Keithley Instruments 2601B-PULSE provides status registers and queues that are collectively referred to as the status model.
  • Page 810 Section 15: Status model Model 2601B-PULSE System SourceMeter Instrument Reference Manual An event is represented by a condition register bit changing from a 1 to 0 or 0 to 1. When an event occurs and the appropriate NTR or PTR bit is set, the corresponding event register bit is set to 1. The event bit remains latched to 1 until the event register is read or the status model is reset.
  • Page 811 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 15: Status model Output queue Response messages, such as those generated from print commands, are placed in the output queue. All remote command interfaces share the same output queue. The output queue sets the message available (MAV) bit in the status model. The data in the output queue is cleared by the *CLS command.
  • Page 812 Section 15: Status model Model 2601B-PULSE System SourceMeter Instrument Reference Manual Status function summary Type Function or attribute Measurement event status.measurement.* status.measurement.buffer_available.* status.measurement.current_limit.* status.measurement.instrument.* status.measurement.instrument.smua.* status.measurement.protection.* status.measurement.reading_overflow.* status.measurement.voltage_limit.* Operation status status.operation.* status.operation.calibrating.* status.operation.instrument.* status.operation.instrument.digio.* status.operation.instrument.digio.trigger_overrun.* status.operation.instrument.lan.* status.operation.instrument.lan.trigger_overrun.* status.operation.instrument.smua.* status.operation.instrument.smua.trigger_overrun.* status.operation.instrument.trigger_blender.* status.operation.instrument.trigger_blender.trigger_overrun.* status.operation.instrument.trigger_timer.* status.operation.instrument.trigger_timer.trigger_overrun.*...
  • Page 813 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 15: Status model Status model diagrams The following figures graphically describe the status model: • Status byte and service request enable register (on page 15-5) • System summary and standard event registers (on page 15-6) •...
  • Page 814 Section 15: Status model Model 2601B-PULSE System SourceMeter Instrument Reference Manual Figure 165: Status byte and service request enable register 15-6 2601B-PULSE-901-01A April 2020...
  • Page 815 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 15: Status model Figure 166: System summary and standard event registers 2601B-PULSE-901-01A April 2020 15-7...
  • Page 816 Section 15: Status model Model 2601B-PULSE System SourceMeter Instrument Reference Manual Figure 167: Measurement event registers 15-8 2601B-PULSE-901-01A April 2020...
  • Page 817 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 15: Status model Figure 168: Operation Status Registers 2601B-PULSE-901-01A April 2020 15-9...
  • Page 818 Section 15: Status model Model 2601B-PULSE System SourceMeter Instrument Reference Manual Figure 169: Operation status trigger overrun registers 15-10 2601B-PULSE-901-01A April 2020...
  • Page 819 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 15: Status model Figure 170: Operation status trigger timer, trigger blender, and remote registers 2601B-PULSE-901-01A April 2020 15-11...
  • Page 820 Section 15: Status model Model 2601B-PULSE System SourceMeter Instrument Reference Manual Figure 171: Operation status digital I/O and TSP-Link registers 15-12 2601B-PULSE-901-01A April 2020...
  • Page 821 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 15: Status model Figure 172: Questionable Status Registers Clearing registers You can use commands to reset the status registers. *CLS resets the bits of the event and NTR registers to 0 and sets all PTR register bits on. This command also clears the output queue.
  • Page 822 Section 15: Status model Model 2601B-PULSE System SourceMeter Instrument Reference Manual 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 823 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 15: Status model Reading registers Any register in the status structure can be read either by sending the common command query (where applicable), or by including the script command for that register in either the print() or print(tostring()) command.
  • Page 824 Section 15: Status model Model 2601B-PULSE System SourceMeter Instrument Reference Manual Status Byte Register The summary messages from the status registers and queues are used to set or clear the appropriate bits (B0, B1, B2, B3, B4, B5, and B7) of the Status Byte Register. These summary bits do not latch, and their states (0 or 1) are dependent upon the summary messages (0 or 1).
  • Page 825 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 15: Status model The bits of the Status Byte Register are described as follows: • Bit B0, Measurement Summary Bit (MSB): Set summary bit indicates that an enabled measurement event has occurred. •...
  • Page 826 Section 15: Status model Model 2601B-PULSE System SourceMeter Instrument Reference Manual The individual bits of the Service Request Enable Register can be set or cleared by using the *SRE common command or status.request_enable. To read the Service Request Enable Register, use the *SRE? query or print(status.request_enable).
  • Page 827 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 15: Status model Status byte and service request commands The commands to program and read the Status Byte Register and Service Request Enable Register are listed in the table below. Note that the table includes both common commands and their script command equivalents.
  • Page 828 Section 15: Status model Model 2601B-PULSE System SourceMeter Instrument Reference Manual Status register sets There are five status register sets in the status structure of a System SourceMeter Instrument: ® • System Summary • Standard Event Status • Operation Status •...
  • Page 829 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 15: Status model Standard Event Register The bits used in the Standard Event Register are described as follows: • Bit B0, Operation Complete (OPC): Set bit indicates that all pending selected device operations are completed and the 2601B-PULSE instrument is ready to accept new commands.
  • Page 830 Section 15: Status model Model 2601B-PULSE System SourceMeter Instrument Reference Manual Standard event commands Command Description Read Standard Event Status Register. *ESR? print(status.standard.event) Program the Event Status Enable Register: *ESE mask mask = 0 to 255 Status register set contents (on page 15-1).
  • Page 831 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 15: Status model • Bit B13, Instrument Summary (INST): Set bit indicates that an enabled bit in the Operation Status Instrument Summary Register is set. • Bit B14, Program Running (PROG): Set bit indicates that a program is running. For more information on the Operation Status Registers, refer to Status register set contents (on page...
  • Page 832 Section 15: Status model Model 2601B-PULSE System SourceMeter Instrument Reference Manual Measurement Event Registers As shown in the Measurement event registers (on page 15-7) of the status model, there are eight register sets associated with measurement event status. Commands are summarized in the Status register set contents (on page 15-1) topic.
  • Page 833 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 15: Status model 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. -- Clear all registers.
  • Page 834 Section 15: Status model Model 2601B-PULSE System SourceMeter Instrument Reference Manual When a current limit (compliance) condition occurs in node 15, the following sequence of events occurs: • Node 15: Bit B1 or B2 of the Measurement Event Current Limit Summary Register sets when the current limit (compliance) event occurs.
  • Page 835 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 15: Status model The affected system summary registers for the above commands are indicated by labels D and E (see following figure). Master node service request: The following command enables the service request for the measurement event: status.request_enable = 1 The affected status register for the above command is indicated by label E (see the following figure).
  • Page 836 Section 16 Display character codes In this section: 2601B-PULSE display character codes ......... 16-1 2601B-PULSE display character codes The following tables contain the display character codes (decimal values) and their corresponding display. Display character codes (decimal 0 to 39) Decimal Display Decimal Display...
  • Page 837 Section 16: Display character codes Model 2601B-PULSE System SourceMeter Instrument Reference Manual Display character codes (decimal 40 to 102) Decimal Display Decimal Display Decimal Display > , (comma) ' (open single quote) < 16-2 2601B-PULSE-901-01A April 2020...
  • Page 838 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 16: Display character codes Display character codes (decimal 103 to 165) Decimal Display Decimal Display Decimal Display (space) ¼ 2601B-PULSE-901-01A April 2020 16-3...
  • Page 839 Section 16: Display character codes Model 2601B-PULSE System SourceMeter Instrument Reference Manual Display character codes (decimal 166 to 228) Decimal Display Decimal Display Decimal Display æ  Æ  â  ä    á ß à  å ...
  • Page 840 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 16: Display character codes Display character codes (decimal 229 to 255) Decimal Display Decimal Display Decimal Display ó ñ ò Ñ ÿ Ö û † ü  ú  ù  Ü →...
  • Page 841 Section 17 Frequently asked questions In this section: How do I display the instrument's serial number? ....17-1 How do I optimize performance? ..........17-2 How do I upgrade the firmware? ..........17-2 How do I use the digital I/O port? ........... 17-3 How do I trigger other instruments? ........
  • Page 842 Section 17: Frequently asked questions Model 2601B-PULSE System SourceMeter Instrument Reference Manual How do I optimize performance? The primary factors that affect measurement accuracy and speed are: • Warm-up: For rated measurement accuracy, allow the 2601B-PULSE to warm up for at least two hours before use.
  • Page 843 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 17: Frequently asked questions How do I use the digital I/O port? You can use the 2601B-PULSE digital input/output with the trigger model or to control an external digital circuit, such as a device handler used to perform binning operations. To control or configure any of the six digital input/output lines, send commands to the 2601B-PULSE over a remote interface.
  • Page 844 Section 17: Frequently asked questions Model 2601B-PULSE System SourceMeter Instrument Reference Manual Interactive trigger programming The programming example below illustrates how to set up interactive triggering. The example sets the output trigger pulse width on line 1, then programs both lines 1 and 2 for falling edge triggers. Digital I/O line 1 trigger asserts, and then line 2 waits for the input trigger up to the timeout period specified.
  • Page 845 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 17: Frequently asked questions Service request programming example The example below shows how to program the 2601B-PULSE to generate a service request (SRQ) when the current limit is exceeded. -- Clear all registers. status.reset() -- Enable the current limit bit in the current limit register.
  • Page 846 Section 17: Frequently asked questions Model 2601B-PULSE System SourceMeter Instrument Reference Manual When should I change the output-off state? Carefully consider and configure the appropriate output-off state, source function, and compliance limits before connecting the 2601B-PULSE to a device that can deliver energy (for example, other voltage sources, batteries, capacitors, solar cells, or other 2601B-PULSE instruments).
  • Page 847 Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 17: Frequently asked questions How can I change the line frequency or voltage? The 2601B-PULSE requires a line voltage of 100 V AC to 240 V AC (±10%) and a line frequency of 50 Hz or 60 Hz.
  • Page 848 Section 18 Next steps In this section: Additional 2601B-PULSE information ........18-1 Additional 2601B-PULSE information For additional information about the 2601B-PULSE, refer to the Keithley Instruments website, which contains 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 849 Specifications are subject to change without notice. All Keithley trademarks and trade names are the property of Keithley Instruments, LLC. All other trademarks and trade names are the property of their respective companies. 4/2020...

Table of Contents