Download Print this page

Tektronix KEITHLEY 2600B Series Reference Manual

Tektronix KEITHLEY 2600B Series Reference Manual

Hide thumbs Also See for KEITHLEY 2600B Series:

User manual (102 pages)

,

Reference manual (946 pages)

page of 834

/ 834
Contents
Table of Contents
Bookmarks

Table of Contents

Advertisement

Quick Links

tek.com/keithley

Series 2600B

System SourceMeter

Instrument

®

Reference Manual

2600BS-901-01 Rev. F August 2021

*P2600BS-901-01F*

2600BS-901-01F

Table of Contents

Advertisement

Chapters

Table of Contents

Need help?

Need help?

Do you have a question about the KEITHLEY 2600B Series and is the answer not in the manual?

Questions and answers

Summary of Contents for Tektronix KEITHLEY 2600B Series

Page 1 tek.com/keithley Series 2600B System SourceMeter Instrument ® Reference Manual 2600BS-901-01 Rev. F August 2021 *P2600BS-901-01F* 2600BS-901-01F...
Page 2 Series 2600B ® System SourceMeter instrument Reference Manual...
Page 3 © 2021, 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. and TSP-Link are trademarks of Keithley Instruments, LLC.
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: Basic Operation
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 Model-specific capabilities......................1-4 Displaying the serial number ....................1-4 Sourcing and measuring ..................
Page 7 Table of contents Series 2600B System SourceMeter® instrument Reference Manual Combining SMU outputs ....................2-27 Pulse characteristics for the 2601B, 2602B, and 2604B ............2-28 Pulse characteristics for the 2611B, 2612B, 2614B, 2634B, 2635B, and 2636B ....2-29 Guidelines for combining SMU outputs ................... 2-30 Source current using two 2600B instruments in parallel ............
Page 8 Series 2600B System SourceMeter® instrument Reference Manual Table of contents Reading buffers ......................3-1 Overview ..........................3-1 Front-panel reading buffer control ..................3-1 Reading buffer options ......................3-2 Configuring reading buffers ....................... 3-2 Appending or overwriting existing reading buffers ..............3-4 Storage operation ........................
Page 9 Table of contents Series 2600B System SourceMeter® instrument Reference Manual Detecting trigger events using the wait() function ..............4-26 Using the assert function to generate output triggers .............. 4-27 Using the release function of the hardware lines ..............4-27 Using the set function to bypass SMU event detectors ............4-28 Event detector overruns ......................
Page 10 Series 2600B System SourceMeter® instrument Reference Manual Table of contents Controlling the instrument by sending individual command messages ........7-1 Queries ............................. 7-3 Information on scripting and programming ................7-3 About TSP commands ......................7-3 Beeper control ........................... 7-3 Bit manipulation and logic operations ..................7-4 Data queue..........................
Page 11 Table of contents Series 2600B System SourceMeter® instrument Reference Manual Resetting the password ......................8-34 Key-press codes ........................ 8-34 Sending key codes ........................8-34 Capturing key-press codes...................... 8-35 Remote communications interfaces ................... 8-36 Supported remote interfaces ....................8-37 Remote interface connections ....................8-37 Output queue ..........................
Page 12 Series 2600B System SourceMeter® instrument Reference Manual Table of contents TSP-Net ..........................8-96 TSP-Net capabilities ........................ 8-96 Using TSP-Net with any ethernet-enabled instrument ............8-96 TSP-Net compared to TSP-Link to communicate with TSP-enabled devices ......8-98 TSP-Net instrument commands: General device control ............8-99 TSP-Net instrument commands: TSP-enabled device control ..........
Page 13 Table of contents Series 2600B System SourceMeter® instrument Reference Manual ConfigPulseVMeasureISweepLin() ..................9-45 ConfigPulseVMeasureISweepLog() ..................9-47 dataqueue.add() ........................9-49 dataqueue.CAPACITY ......................9-50 dataqueue.clear() ........................9-50 dataqueue.count ........................9-51 dataqueue.next() ........................9-52 delay() ............................. 9-53 digio.readbit() .......................... 9-54 digio.readport() ........................9-55 digio.trigger[N].assert() ......................
Page 14 Series 2600B System SourceMeter® instrument Reference Manual Table of contents fileVar:seek() ........................... 9-98 fileVar:write() ........................... 9-99 format.asciiprecision ......................9-100 format.byteorder ........................9-101 format.data ..........................9-102 fs.chdir() ..........................9-103 fs.cwd() ..........................9-103 fs.is_dir() ..........................9-104 fs.is_file() ..........................9-105 fs.mkdir() ..........................9-105 fs.readdir() ..........................
Page 15 Table of contents Series 2600B System SourceMeter® instrument Reference Manual lan.trigger[N].connect() ......................9-145 lan.trigger[N].connected ......................9-146 lan.trigger[N].disconnect() ..................... 9-146 lan.trigger[N].EVENT_ID ....................... 9-147 lan.trigger[N].ipaddress ......................9-147 lan.trigger[N].mode ........................ 9-148 lan.trigger[N].overrun ......................9-149 lan.trigger[N].protocol ......................9-150 lan.trigger[N].pseudostate ..................... 9-150 lan.trigger[N].stimulus ......................9-151 lan.trigger[N].wait() ........................
Page 16 Series 2600B System SourceMeter® instrument Reference Manual Table of contents serial.read() ........................... 9-193 serial.write() ........................... 9-193 settime() ..........................9-194 settimezone() ........................9-195 setup.poweron ........................9-196 setup.recall() ......................... 9-197 setup.save() .......................... 9-198 smuX.abort() ......................... 9-199 smuX.buffer.getstats() ......................9-199 smuX.buffer.recalculatestats() ....................9-201 smuX.cal.adjustdate ......................
Page 17 Table of contents Series 2600B System SourceMeter® instrument Reference Manual smuX.source.offlimitY ......................9-247 smuX.source.offmode ......................9-248 smuX.source.output ......................9-249 smuX.source.outputenableaction ..................9-249 smuX.source.rangeY ......................9-251 smuX.source.settling ......................9-252 smuX.source.sink ........................9-253 smuX.trigger.arm.count ......................9-253 smuX.trigger.arm.set() ......................9-254 smuX.trigger.arm.stimulus..................... 9-255 smuX.trigger.ARMED_EVENT_ID ..................9-256 smuX.trigger.autoclear ......................
Page 18 Series 2600B System SourceMeter® instrument Reference Manual Table of contents status.operation.remote.* ...................... 9-325 status.operation.sweeping.* ....................9-327 status.operation.trigger_overrun.* ..................9-328 status.operation.user.* ......................9-331 status.questionable.* ......................9-333 status.questionable.calibration.* .................... 9-335 status.questionable.instrument.* ................... 9-336 status.questionable.instrument.smuX.* ................. 9-337 status.questionable.over_temperature.* ................9-339 status.questionable.unstable_output.* .................. 9-341 status.request_enable ......................
Page 19 Table of contents Series 2600B System SourceMeter® instrument Reference Manual tsplink.trigger[N].pulsewidth ....................9-392 tsplink.trigger[N].release() ..................... 9-393 tsplink.trigger[N].reset() ......................9-393 tsplink.trigger[N].stimulus ...................... 9-394 tsplink.trigger[N].wait() ......................9-395 tsplink.writebit() ........................9-396 tsplink.writeport() ........................9-397 tsplink.writeprotect ........................ 9-397 tspnet.clear() ......................... 9-398 tspnet.connect() ........................9-399 tspnet.disconnect() ........................
Page 20 Series 2600B System SourceMeter® instrument Reference Manual Table of contents General bus commands ..................... 11-5 REN ............................11-5 IFC ............................11-5 LLO ............................11-5 GTL ............................11-6 DCL ............................11-6 SDC ............................11-6 GET ............................11-6 SPE, SPD..........................11-6 Status model ......................12-1 Overview ..........................
Page 21 Table of contents Series 2600B System SourceMeter® instrument Reference Manual Frequently asked questions .................. 15-1 How do I display the instrument's serial number? ............. 15-1 How do I optimize performance? ..................15-1 Disabling autozero to increase speed ..................15-2 How do I upgrade the firmware? ..................15-2 How do I use the digital I/O port? ..................
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 Series 2600B System SourceMeter® instrument Reference Manual Customer documentation The documentation for the 2600B includes a Quick Start Guide, User's Manual, and Reference Manual (this document). A 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 Series 2600B System SourceMeter® instrument Reference Manual Section 1: Introduction Capabilities and features ® 2600B System SourceMeter instruments have the following features: • 4.5, 5.5, or 6.5 digit display resolution • Resistance and power measurement functions • Four-quadrant sink or source operation •...
Page 25 Section 1: Introduction Series 2600B System SourceMeter® instrument Reference Manual Model-specific capabilities Additional source and measure features: • Model 2601B, 2602B, and 2604B System SourceMeter ® instruments: ▪ Source ±dc voltage from 5 µV to 40.4 V ▪ Source ±dc current from 100 pA to 3.03 A ▪...
Page 26: Table Of Contents
Section 2 Sourcing and measuring In this section: Basic operation ................ 2-1 Source-measure capabilities ............ 2-2 Circuit configurations ..............2-2 Operation considerations for the ADC ........2-8 Remote source-measure commands ........2-10 Triggering in local mode ............2-11 Configuring trigger attributes in local mode ......2-12 Configuring for measure-only tests using the MODE key ..
Page 27: Source-Measure Capabilities
Section 2: Sourcing and measuring Series 2600B System SourceMeter® instrument Reference Manual Source-measure capabilities From the front panel, you can configure the instrument to perform the following source-measure operations: • Source voltage: Measure and display current, voltage, resistance, or power •...
Page 28 Series 2600B System SourceMeter® instrument Reference Manual Section 2: Sourcing and measuring When sourcing current, you can measure voltage or current, as shown in the following figure. Figure 2: Fundamental source-measure configuration: Source I Current meter Current source ↑ Voltage meter See the following topics for detailed information.
Page 29 Section 2: Sourcing and measuring Series 2600B System SourceMeter® instrument Reference Manual Figure 3: Source V configuration 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 30 Series 2600B System SourceMeter® instrument Reference Manual Section 2: Sourcing and measuring Figure 4: Source I configuration 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.
Page 31 Section 2: Sourcing and measuring Series 2600B System SourceMeter® instrument Reference Manual Measure only (voltage or current) The figures below show the configurations for using the instrument exclusively as a voltmeter or ammeter. As shown in the following figure, to configure the instrument to measure voltage only, set it to source 0 A and measure voltage.
Page 32 Series 2600B System SourceMeter® instrument Reference Manual Section 2: Sourcing and measuring Contact check The Models 2604B, 2614B, and 2634B do not perform contact check measurements. When a contact check measurement is made, two small current sources switch between the HI and SENSE HI terminals and the LO and SENSE LO terminals.
Page 33: Operation Considerations For The Adc
Section 2: Sourcing and measuring Series 2600B System SourceMeter® instrument Reference Manual Operation considerations for the ADC The following paragraphs discuss autozero and NPLC caching with the analog-to-digital converter (ADC) (on page 5-24). Autozero The ADC of the 2600B uses a ratiometric analog to digital (A/D) conversion technique. To ensure reading accuracy, the instrument must periodically obtain fresh measurements of its internal ground and voltage reference.
Page 34 Series 2600B System SourceMeter® instrument Reference Manual Section 2: Sourcing and measuring Setting autozero from a remote interface 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 (see smuX.measure.autozero (on page 9-218)).
Page 35: Remote Source-Measure Commands
Section 2: Sourcing and measuring Series 2600B System SourceMeter® instrument Reference Manual Remote source-measure commands Basic source-measurement procedures can also be performed through a remote interface. To do this, send the appropriate commands. The following table summarizes basic source-measure commands. Introduction to TSP operation (on page 7-1) for more information on using these commands.
Page 36: Triggering In Local Mode
Series 2600B System SourceMeter® instrument Reference Manual Section 2: 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 37: Configuring Trigger Attributes In Local Mode
Section 2: Sourcing and measuring Series 2600B System SourceMeter® instrument Reference Manual • The instrument makes one measurement. • If the number of measurements is less than the programmed trigger count, it cycles to make another measurement (the measurement cycle is repeated indefinitely if the infinite trigger count is selected).
Page 38: Configuring For Measure-Only Tests Using The Mode Key
Series 2600B System SourceMeter® instrument Reference Manual Section 2: Sourcing and measuring Front-panel triggering example This example uses the front panel to configure the trigger parameters to meet the following requirements: • Manual triggering (TRIG key) • Infinite trigger count (cycle indefinitely through measurement cycles) •...
Page 39: Voltmeter And Ammeter Measurements
Section 2: Sourcing and measuring Series 2600B System SourceMeter® instrument Reference Manual Voltmeter and ammeter measurements You can make voltmeter and ammeter measurements without using the MODE key, such as when configuring measure-only tests over the remote interface. To use the 2600B to measure voltage or current: 1.
Page 40: Ohms Measurements
Series 2600B System SourceMeter® instrument Reference Manual Section 2: Sourcing and measuring Ohms measurements Resistance readings are calculated from the measured current and measured voltage as follows: R = V/I Where: • R is the calculated resistance • V is the measured voltage •...
Page 41 Section 2: Sourcing and measuring Series 2600B System SourceMeter® instrument Reference Manual To make an ohms measurement: 1. Press the SRC key to select the source function. 2. Set the output source, as indicated by the units in the source field on the display. The flashing digit (cursor) indicates which value is presently selected for editing.
Page 42 Series 2600B System SourceMeter® instrument Reference Manual Section 2: Sourcing and measuring Ohms programming example The following programming example illustrates the setup and command sequence of a typical ohms measurement procedure with the following parameters: • Source function: Current, 10 mA range, 10 mA output •...
Page 43 Section 2: Sourcing and measuring Series 2600B System SourceMeter® instrument Reference Manual Figure 9: Two-wire resistance sensing 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 44: Power Measurements
Series 2600B System SourceMeter® instrument Reference Manual Section 2: Sourcing and measuring Figure 10: Four-wire resistance sensing Power measurements Power readings are calculated from the measured current and voltage as follows: Where: P is the calculated power V is the measured voltage I is the measured current 2600BS-901-01 Rev.
Page 45 Section 2: Sourcing and measuring Series 2600B 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 2600B is already connected to the device under test (DUT) as explained in “DUT test connections”...
Page 46 Series 2600B System SourceMeter® instrument Reference Manual Section 2: Sourcing and measuring Power measurements using the remote interface The following paragraphs summarize basic power measurement commands using the remote interface and also give a programming example for a typical power measurement situation. Remote power reading command The programming example below illustrates how to get a power reading from SMU A: reading = smua.measure.p()
Page 47: Contact Check Measurements
Section 2: Sourcing and measuring Series 2600B System SourceMeter® instrument Reference Manual Contact check measurements The Models 2604B, 2614B, and 2634B do not perform contact check measurements. The contact check function prevents measurements that may be in error due to excessive resistance in the force or sense leads when making remotely sensed (Kelvin) measurements.
Page 48 Series 2600B System SourceMeter® instrument Reference Manual Section 2: Sourcing and measuring Contact check commands The following table summarizes the contact check commands. For a more complete description of these commands, refer to the “TSP command reference (on page 9-1)” section of the Series 2600B Reference Manual.
Page 49: Multiple Smu Connections
Section 2: Sourcing and measuring Series 2600B System SourceMeter® instrument Reference Manual Multiple SMU connections Connections to LO on the 2600B are not necessarily at 0 V. Hazardous voltages could exist between LO and chassis ground. Make sure that high-voltage precautions are taken throughout the test system.
Page 50 Series 2600B System SourceMeter® instrument Reference Manual Section 2: Sourcing and measuring Figure 12: Two SMUs connected to a 3-terminal device (local sensing) 2600BS-901-01 Rev. F/August 2021 2-25...
Page 51 Section 2: Sourcing and measuring Series 2600B System SourceMeter® instrument Reference Manual Figure 13: Two SMUs (Model 2634B or 2636B) connected to a 3-terminal device (local sensing, floating) 2-26 2600BS-901-01 Rev. F/August 2021...
Page 52: Combining Smu Outputs
Series 2600B System SourceMeter® instrument Reference Manual Section 2: Sourcing and measuring Combining SMU outputs The following information provides important considerations that need to be observed when combining source-measure unit (SMU) outputs. Use care when combining SMUs. Whenever SMUs are combined, make sure both SMUs have the same model number.
Page 53 Section 2: Sourcing and measuring Series 2600B System SourceMeter® instrument Reference Manual Pulse characteristics for the 2601B, 2602B, and 2604B The following figure and table illustrate the pulse regions for each SMU. The programmed current and voltage levels for both SMUs must fall within the same pulse region. Refer to the 2600B specifications tek.com/keithley for the latest pulse width and duty cycle information.
Page 54 Series 2600B System SourceMeter® instrument Reference Manual Section 2: Sourcing and measuring Pulse characteristics for the 2611B, 2612B, 2614B, 2634B, 2635B, and 2636B The following figure and table illustrate the pulse regions for each SMU. The programmed current and voltage levels for both SMUs must fall within the same pulse region. Refer to the 2600B specifications tek.com/keithley for the latest pulse width and duty cycle information.
Page 55 Section 2: Sourcing and measuring Series 2600B System SourceMeter® instrument Reference Manual Guidelines for combining SMU outputs When combining the outputs of two 2600B SMUs, restrict operation to pulse only or limited duty cycle operations whenever possible. DC operation in Region 1 is possible if necessary. Do not place two voltage sources in parallel.
Page 56 Series 2600B System SourceMeter® instrument Reference Manual Section 2: Sourcing and measuring This configuration allows the combined SMUs to supply more current than a single SMU current source can provide. In this example, SMU 1 and SMU 2 each supply one-half of the total current for the SMU combination.
Page 57 Section 2: Sourcing and measuring Series 2600B System SourceMeter® instrument Reference Manual SMU 2 configuration (sources one-half of the total pulse current): Source function: smua.source.func = smua.OUTPUT_DCAMPS Source range: smua.source.rangei = 10 Idle (bias) source level (source level at base of pulse): smua.source.leveli = 0 Idle (bias) source limit (source limit at base of pulse).
Page 58 Series 2600B System SourceMeter® instrument Reference Manual Section 2: Sourcing and measuring Source voltage using two 2600B instruments in series This example shows the recommended approach for setting the source and limit ranges and levels when combining SMU voltage sources in series. Figure 17: Source voltage using 2600B instruments in series The following values are based on the current and voltage levels available in Region 4 of a 2601B, 2602B, or 2604B SMU, as shown in the table in...
Page 59 Section 2: Sourcing and measuring Series 2600B System SourceMeter® instrument Reference Manual Configure two 2600B SMUs to get the maximum pulsed voltage level possible in Region 4: 40 V with 9 A source limit SMU 1 configuration (sources one-half of the total pulse voltage): Source function: smua.source.func = smua.OUTPUT_DCVOLTS Source range:...
Page 60 Series 2600B System SourceMeter® instrument Reference Manual Section 2: Sourcing and measuring Pulse source limit. SMU 2 controls the source limit for the combined SMUs. Set the current source limit of SMU 1 to the maximum current allowed in Region 4: smua.trigger.source.limiti = 10 Output-off mode: smua.source.offmode = smua.OUTPUT_NORMAL...
Page 61 Section 2: Sourcing and measuring Series 2600B System SourceMeter® instrument Reference Manual Source voltage with extended current using two 2600B instruments in parallel This example shows the recommended approach for setting the source and limit ranges and levels when combining a SMU voltage source in parallel with a SMU current source. Figure 18: Source voltage with extended current using parallel SMUs The values are based on the current and voltage levels available in Region 4 of a 2601B, 2602B, or 2604B SMU, as shown in the table in...
Page 62 Series 2600B System SourceMeter® instrument Reference Manual Section 2: Sourcing and measuring Configure two 2600B SMUs to obtain the maximum pulsed voltage level possible in Region 4: 18 V with 19 A capacity SMU 1 configuration (supplies additional current that SMU 2 alone cannot provide): Source function: smua.source.func = smua.OUTPUT_DCAMPS Source range:...
Page 63 Section 2: Sourcing and measuring Series 2600B System SourceMeter® instrument Reference Manual SMU 2 configuration (SMU 2 controls the voltage applied to the device-under-test): Source function: smua.source.func = smua.OUTPUT_DCVOLTS Source range: smua.source.rangev = 20 Idle (bias) source level (source level at base of pulse): smua.source.levelv = 0 Idle (bias) source limit (source limit at base of pulse): smua.source.limiti = 1...
Page 64 Series 2600B System SourceMeter® instrument Reference Manual Section 2: Sourcing and measuring Combining channels in series to output higher voltage Channels in series can cause hazardous voltage (>30 V , 42 V ) to be present and PEAK accessible at the 2600B output connector. A safety shield must be used whenever hazardous voltages will be present in the test circuit.
Page 65: Output-Off Modes
Section 2: Sourcing and measuring Series 2600B System SourceMeter® instrument Reference Manual Combining channels in parallel to output higher current Higher pulse current can be output by connecting two 2600B instrument channels in parallel. The figure below illustrates the connection scheme of two Model 2602B channels connected in parallel.
Page 66 Series 2600B System SourceMeter® instrument Reference Manual Section 2: Sourcing and measuring Normal output-off mode The normal output-off mode is the default output-off mode setting. When the source-measure unit (SMU) is in the normal output-off mode, you can select either the current or the voltage output-off function (see Output-off function (on page 2-42)).
Page 67 Section 2: Sourcing and measuring Series 2600B System SourceMeter® instrument Reference Manual Output-off function This setting is used only when the output is turned off and the 2600B is set to the normal output-off mode (smuX.source.offmode = smuX.OUTPUT_NORMAL). You can set the output-off function to CURRENT or VOLTAGE through the CONFIG menu on the front panel, or by using the smuX.source.offfunc attribute from a remote interface.
Page 68 Series 2600B System SourceMeter® instrument Reference Manual Section 2: Sourcing and measuring Output-off limits (compliance) You can set output-off limits (compliance) for the current and voltage output-off functions using the CONFIG menu on the 2600B front panel, or by setting the smuX.source.offlimitY attribute from a remote interface.
Page 69: Range
Section 2: Sourcing and measuring Series 2600B System SourceMeter® instrument Reference Manual Range The selected measurement range affects the accuracy of the measurements and the maximum signal that can be measured. If the range is changed, the front-panel display may contain dashes instead of a reading (for example, --.---- mA).
Page 70 Series 2600B System SourceMeter® instrument Reference Manual Section 2: Sourcing and measuring Measure autodelay The measure delay is a specific delay that is applied before each measurement is made. This delay is disabled by default (measurements are made immediately). You can change the default delay by setting the smuX.measure.delay (on page 9-221) attribute either to a specific value or to an autodelay...
Page 71 Section 2: Sourcing and measuring Series 2600B System SourceMeter® instrument Reference Manual Autoranging To use automatic source ranging, press SRC then the AUTO range key. To use automatic measure ranging, press the MEAS key followed by the AUTO range key. The AUTO indicator turns on when source or measure autoranging is selected.
Page 72 Series 2600B System SourceMeter® instrument Reference Manual Section 2: Sourcing and measuring Range considerations The source range and measure range settings can interact depending on the source function. Additionally, the output state (on or off) can affect how the range is set. The following table describes these interactions.
Page 73 Section 2: Sourcing and measuring Series 2600B System SourceMeter® instrument Reference Manual Source range and limit commands* Command** Description smuX.source.autorangei = smuX.AUTORANGE_ON Enable current source autorange. smuX.source.autorangei = smuX.AUTORANGE_OFF Disable current source autorange. smuX.source.autorangev = smuX.AUTORANGE_ON Enable voltage source autorange. smuX.source.autorangev = smuX.AUTORANGE_OFF Disable voltage source autorange.
Page 74: Digits
Series 2600B System SourceMeter® instrument Reference Manual Section 2: 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 75 Section 2: Sourcing and measuring Series 2600B System SourceMeter® instrument Reference Manual Speed The SPEED key sets the integration time, or measurement aperture, of the analog to digital (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 76 Series 2600B System SourceMeter® instrument Reference Manual Section 2: Sourcing and measuring Sweep operation The 2600B can generate dc and pulsed sweeps to perform source-only sweeps, source-and-measure sweeps, or measure-only sweeps. The following information describes the sweep types of dc and pulsed linear staircase, dc and pulsed logarithmic staircase, and dc and pulsed list.
Page 77 Section 2: Sourcing and measuring Series 2600B System SourceMeter® instrument Reference Manual Figure 22: DC and pulsed list sweeps Sweep characteristics For any of the sweep types, program a pulse sweep by configuring the end pulse action. Refer to Pulse mode sweeps (on page 2-58) for more information.
Page 78 Series 2600B System SourceMeter® instrument Reference Manual Section 2: Sourcing and measuring A linear staircase sweep is configured using a start level, a stop level, and the total number of points, including the start and stop points. The step size is determined by the start and stop levels, and the number of sweep points: step = (stop - start) / (points - 1) The number of sweep steps actually performed is determined by the trigger count.
Page 79 Section 2: Sourcing and measuring Series 2600B System SourceMeter® instrument Reference Manual The number of sweep steps actually performed is determined by the trigger count. See Triggering (on page 4-1) for more information. The formula for a logarithmic sweep is: = A + kb Where: = The source value at source point i...
Page 80 Series 2600B System SourceMeter® instrument Reference Manual Section 2: Sourcing and measuring Figure 25: 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 = The asymptote value...
Page 81 Section 2: Sourcing and measuring Series 2600B System SourceMeter® instrument Reference Manual Figure 26: Logarithmic staircase sweep (1 V to 10 V, five steps) In this example: A = 0, V = 1, V = 10, N = 5 start Using the formula above, k = 1 Step size (b) for the sweep in the above figure is calculated as follows: (log step size)
Page 82 Series 2600B System SourceMeter® instrument Reference Manual Section 2: Sourcing and measuring 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 goes to the start level (1 V) and sweeps through the symmetrical log points.
Page 83 Section 2: Sourcing and measuring Series 2600B System SourceMeter® instrument Reference Manual Figure 27: List sweep example Pulse mode sweeps To create a pulse sweep for any of the sweep types, configure the end pulse action. To configure a pulse sweep for source-measure unit (SMU) A, send: smua.trigger.endpulse.action = smua.SOURCE_IDLE To configure a dc sweep for SMU A, send: smua.trigger.endpulse.action = smua.SOURCE_HOLD...
Page 84 Series 2600B System SourceMeter® instrument Reference Manual Section 2: Sourcing and measuring 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: Duty cycle...
Page 85 Section 2: Sourcing and measuring Series 2600B System SourceMeter® instrument Reference Manual Figure 29: Pulsing in the extended operating area Pulse region specification Region (quadrant diagram) Region maximum Maximum pulse width Maximum duty cycle 1 A at 40 V DC, no limit 100% 3 A at 6 V DC, no limit...
Page 86 Series 2600B System SourceMeter® instrument Reference Manual Section 2: Sourcing and measuring Configuring compliance limits remotely You can configure voltage and current limits using the smuX.trigger.source.limitY attribute, which sets the sweep source limits. For example, to set the SMU A sweep limit to 10 V, send the command: smua.trigger.source.limitv = 10 Configuring end sweep actions remotely...
Page 87 Section 2: Sourcing and measuring Series 2600B System SourceMeter® instrument Reference Manual Source and measurement delays Whenever the source-measure unit (SMU) outputs a source value in a sweep, it also applies the programmed source delay. The default source delay is zero (0) seconds. Set an additional source delay using the smuX.source.delay attribute.
Page 88 Series 2600B System SourceMeter® instrument Reference Manual Section 2: Sourcing and measuring Sweeping using factory scripts Factory script functions that perform linear staircase, logarithmic staircase, and list sweeps are described in Factory scripts (on page 7-20). You can use the factory script functions to execute simple sweeps or use them as examples for programming your own custom sweeps.
Page 89 Section 2: Sourcing and measuring Series 2600B System SourceMeter® instrument Reference Manual Linear staircase sweep example The programming example below illustrates a staircase sweep. -- Restore 2600B defaults. 1. Configure source functions. smua.reset() Restores defaults and sets the -- Set compliance to 1 V. compliance limit to 1 V.
Page 90 Series 2600B System SourceMeter® instrument Reference Manual Section 2: Sourcing and measuring Relative offset When making measurements, you may want to subtract an offset value from a measurement. The relative offset feature subtracts a set value or a baseline reading from measurement readings. When you enable relative offset, all measurements are recorded as the difference between the actual measured value and the relative offset value.
Page 91 Section 2: Sourcing and measuring Series 2600B System SourceMeter® instrument Reference Manual Relative offset commands Relative offset commands are summarized in the following table. Relative offset commands Command* Description To set relative offset values: smuX.measure.rel.leveli = relval Set current relative offset value smuX.measure.rel.levelp = relval Set power relative offset value smuX.measure.rel.levelr = relval...
Page 92 Series 2600B System SourceMeter® instrument Reference Manual Section 2: Sourcing and measuring Figure 30: Repeating and moving average filters 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 93 Section 2: Sourcing and measuring Series 2600B System SourceMeter® instrument Reference Manual Figure 31: Median filter When a moving filter or a median filter is first enabled, the stack is empty. The first reading conversion is placed in the stack and is then copied to the other stack locations to fill it. Thus, the first filtered reading is the same as the first reading conversion.
Page 94 Series 2600B System SourceMeter® instrument Reference Manual Section 2: Sourcing and measuring Setting the filter using a remote interface The following table summarizes the filter commands. See the TSP command reference (on page 9-1) for details about commands. Filter commands Command* Description smuX.measure.filter.count = count...
Page 95 Section 2: Sourcing and measuring Series 2600B System SourceMeter® instrument Reference Manual Understanding high-capacitance mode The source-measure unit (SMU) in the 2600B drives 10 nF of capacitance in normal operation. Typically, an internal capacitor across the current measuring element provides phase lead to compensate for the phase lag caused by the load capacitance on the output.
Page 96 Series 2600B System SourceMeter® instrument Reference Manual Section 2: Sourcing and measuring Model 2611B, 2612B, 2614B, 2634B, 2635B, and 2636B source setting times Range Normal mode High-capacitance mode 200 mV 50 µs 600 µs 50 µs 600 µs 20 V 110 µs 1.5 ms 200 V...
Page 97 Section 2: Sourcing and measuring Series 2600B System SourceMeter® instrument Reference Manual Understanding the capacitor Based on the capacitor dielectric absorption, the settling time may change and the values in the "Current measure and source settling times" table in Understanding source settling times page 2-70) may differ.
Page 98 Series 2600B System SourceMeter® instrument Reference Manual Section 2: Sourcing and measuring 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). 4.
Page 99 Section 2: Sourcing and measuring Series 2600B System SourceMeter® instrument Reference Manual Script example Use the smuX.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 on SMU A.
Page 100 Series 2600B System SourceMeter® instrument Reference Manual Section 2: Sourcing and measuring Saved setups You can restore the 2600B to one of six nonvolatile-memory setup configurations (five user setups and one factory default), or to a setup stored on an external USB flash drive. As shipped from the factory, the 2600B powers up with the factory default settings, which cannot be overwritten.
Page 101 Section 2: Sourcing and measuring Series 2600B System SourceMeter® instrument Reference Manual Recalling a saved setup using the front panel You can recall setups from internal nonvolatile memory or a USB flash drive. To recall a saved setup from the front panel: 1.
Page 102 Series 2600B System SourceMeter® instrument Reference Manual Section 2: Sourcing and measuring Restoring the factory default setups using remote commands Use one of the reset functions to return the 2600B to the original factory defaults. An example of each type of reset is shown in the following program examples. ®...
Page 103 Section 3 Reading buffers In this section: Overview .................. 3-1 Front-panel reading buffer control ..........3-1 Remote reading buffer programming ........3-7 Overview Reading buffers capture measurements, ranges, instrument status, and output state of the Keithley Instruments 2600B. The 2600B has two default reading buffers for each channel. In addition to the default buffers, you can create user-defined reading buffers.
Page 104 Section 3: Reading buffers Series 2600B System SourceMeter® instrument Reference Manual Reading buffer options The following list outlines the menu structure and menu items associated with front-panel reading buffer control. This section provides a description for each reading buffer option. Use the procedure in Configuring reading buffers (on page 3-2) as a guideline to configure these reading buffer options.
Page 105 Series 2600B System SourceMeter® instrument Reference Manual Section 3: Reading buffers 1. Press the CONFIG key. 2. Press the STORE key and then choose one of the following: ▪ CHANA-BUFF ▪ CHANB-BUFF (2602B, 2604B, 2612B, 2614B, 2634B, and 2636B only) 3.
Page 106 Section 3: Reading buffers Series 2600B System SourceMeter® instrument Reference Manual 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 107 Series 2600B System SourceMeter® instrument Reference Manual Section 3: Reading buffers Saving reading buffers You can save the dedicated reading buffers to nonvolatile memory or you can save them to a USB flash drive. The instrument restores the dedicated reading buffers from internal nonvolatile memory when the instrument is turned off and back on.
Page 108 Section 3: Reading buffers Series 2600B System SourceMeter® instrument Reference Manual 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: CHANx-BUFF1 or CHANx-BUFF2 (where X is A on the 2601B, 2611B, or 2635B, or X is A or B on the 2602B, 2604B, 2612B, 2614B, 2634B, or 2636B).
Page 109 Series 2600B System SourceMeter® instrument Reference Manual Section 3: Reading buffers Dual buffer example The programming example below shows a script that stores current and voltage readings using buffer 1 for current and buffer 2 for voltage readings. The 2600B stores 100 current and voltage readings and then recalls all 100 sets of readings.
Page 110 Section 3: Reading buffers Series 2600B System SourceMeter® instrument Reference Manual A reading buffer is based on a Lua table. The measurements are accessed by ordinary array accesses. If rb is a reading buffer, the first measurement is accessed as rb[1] and the ninth measurement as rb[9].
Page 111 Series 2600B System SourceMeter® instrument Reference Manual Section 3: Reading buffers -- Set the bias voltage to 0 V. smua.source.levelv = 0.0 -- Turn on the output. smua.source.output = smua.OUTPUT_ON -- Loop for voltages from 0.01 V to 1 V. for v = 1, 100 do -- Set the source voltage.
Page 112 Section 3: Reading buffers Series 2600B System SourceMeter® instrument Reference Manual Command Description Commands to store readings smuX.measure.v(rbuffer) Makes voltage measurements; stores readings in rbuffer. smuX.measure.i(rbuffer) Makes current measurements; stores readings in rbuffer. smuX.measure.iv(ibuffer, vbuffer) Makes both current and voltage measurements; stores current readings in ibuffer and stores voltage readings in vbuffer.
Page 113 Series 2600B System SourceMeter® instrument Reference Manual Section 3: Reading buffers Buffer storage control attributes The following table contains buffer storage control attributes. Before changing the collectsourcevalues, collecttimestamps, or timestampresolution attributes, you must clear the buffer using the smuX.nvbuffer1.clear() or smuX.nvbuffer2.clear() command.
Page 114 Section 3: Reading buffers Series 2600B System SourceMeter® instrument Reference Manual Buffer storage control programming examples The programming examples below illustrate the use of buffer storage control attributes. Buffer control programming examples Command Description smua.nvbuffer1.collectsourcevalues = 1 Enable source value storage. smua.nvbuffer1.appendmode = 1 Enable buffer append mode.
Page 115 Series 2600B System SourceMeter® instrument Reference Manual Section 3: Reading buffers If n equals zero (0), all other attributes are nil because there is no data to base any statistics on. If n equals 1, the stddev attribute is nil because the standard deviation of a sample size of 1 is undefined.
Page 116 Section 3: Reading buffers Series 2600B System SourceMeter® instrument Reference Manual 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 attribute* Description measurefunctions...
Page 117 Series 2600B System SourceMeter® instrument Reference Manual Section 3: Reading buffers Buffer status The buffer reading status attribute includes the status information as a numeric value; see the following table for values. For example, to access status information for the second element of SMU channel A buffer 1, use the following command: stat_info = smua.nvbuffer1.statuses[2] Buffer status bits...
Page 118 Section 3: Reading buffers Series 2600B System SourceMeter® instrument Reference Manual Dynamically allocated buffer example The programming example below illustrates how to store data to an allocated buffer called mybuffer. The 2600B stores 100 current readings in mybuffer and then recalls all the readings. -- Restore 2600B defaults.
Page 119 Section 4 Triggering In this section: Triggering ................. 4-1 Remote triggering overview............4-1 SMU event detectors ..............4-8 Using trigger events to start actions on trigger objects ... 4-10 Digital I/O port and TSP-Link synchronization lines ....4-11 Timers ..................4-14 Event blenders ...............
Page 120 Section 4: Triggering Series 2600B System SourceMeter® instrument Reference Manual The following figure graphically represents all the trigger objects of the 2600B instrument. Figure 33: Triggering overview The Models 2604B, 2614B, and 2634B do not have digital I/O lines or TSP-Link. 2600BS-901-01 Rev.
Page 121 Series 2600B System SourceMeter® instrument Reference Manual Section 4: Triggering Trigger events are identified by means of an event ID. The following table describes the trigger event IDs. Trigger event IDs* Event ID** Event description smuX.trigger.SWEEPING_EVENT_ID Occurs when the source-measure unit (SMU) transitions from the idle state to the arm layer of the trigger model smuX.trigger.ARMED_EVENT_ID...
Page 122 Section 4: Triggering Series 2600B System SourceMeter® instrument Reference Manual Figure 34: Remote trigger model: Normal (synchronous) mode 2600BS-901-01 Rev. F/August 2021...
Page 123 Series 2600B System SourceMeter® instrument Reference Manual Section 4: Triggering Figure 35: Remote trigger model: Asynchronous mode When the smuX.trigger.measure.action attribute is set to smuX.DISABLE or smuX.ENABLE, the trigger model operates in synchronous measurement mode. When it is set to smuX.ASYNC, it operates in asynchronous mode.
Page 124 Section 4: Triggering Series 2600B System SourceMeter® instrument Reference Manual Each section of the trigger model performs a function: If a sweep is not in process, the SMU is in the idle state. Use the Idle state smuX.trigger.initiate() function to move the SMU from the idle state to the arm layer.
Page 125 Series 2600B System SourceMeter® instrument Reference Manual Section 4: Triggering For more information about the sweep functions, refer to Sweep operations (on page 2-51). Configured source and measure delays are imposed when the SMU executes the source and measure action blocks. Additionally, if the measure count setting is greater than one, then the measure count is satisfied each time the measure action is performed.
Page 126: Smu Event Detectors
Section 4: Triggering Series 2600B System SourceMeter® instrument Reference Manual SMU event detectors As shown in Using the remote trigger model (on page 4-3), the source-measure unit (SMU) has multiple event detectors to control the timing of various actions, as shown in the table below. Each event detector monitors for the trigger event assigned to the associated stimulus input.
Page 127 Series 2600B System SourceMeter® instrument Reference Manual Section 4: Triggering The programming example below illustrates how to configure a 10-point linear voltage sweep on SMU A, in which 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 the TRIG key press as an input trigger for source action.
Page 128: Using Trigger Events To Start Actions On Trigger Objects
Section 4: Triggering Series 2600B System SourceMeter® instrument Reference Manual Using trigger events to start actions on trigger objects You can configure trigger objects 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 129: Digital I/O Port And Tsp-Link Synchronization Lines
Series 2600B System SourceMeter® instrument Reference Manual Section 4: Triggering Digital I/O port and TSP-Link synchronization lines The 2600B 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 are configured and controlled in the same way.
Page 130 Section 4: Triggering Series 2600B System SourceMeter® instrument Reference Manual Pulse width Specifies the pulse width of the output trigger signal when the hardware line is asserted. Trigger configuration on hardware lines You can configure the 2600B to send digital signals to trigger external instruments. You can link the output triggers to the completion of certain source-measure actions to enable hardware handshaking.
Page 131 Series 2600B System SourceMeter® instrument Reference Manual Section 4: Triggering Figure 38: External instrument 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 132: Timers
Section 4: Triggering Series 2600B System SourceMeter® instrument Reference Manual Timers A timer is a trigger object that performs a delay when triggered. You can use timers to create delays, to start measurements, and step the source value at timed intervals. When a delay expires, the timer generates a trigger event.
Page 133 Series 2600B System SourceMeter® instrument Reference Manual Section 4: Triggering Triggering a timer You can configure a timer to start a delay when a trigger object generates a trigger event. Timers cannot be started with a command. A trigger event from a trigger object must be used to initiate a delay.
Page 134 Section 4: Triggering Series 2600B System SourceMeter® instrument Reference Manual Using timers to perform pulse mode sweeps You can use timers to control the pulse width during a pulsed sweep. To create a pulse train, a second timer must be used to configure the pulse period. The following topics provide examples that show a single pulse output and a pulse train output.
Page 135 Series 2600B System SourceMeter® instrument Reference Manual Section 4: Triggering Single pulse example The SMU programming example below illustrates how to use a single timer to control the pulse width of a single-shot pulse measurement. The programming example configures the timer and SMU as follows: Timer 1: Pulse-width timer •...
Page 136 Section 4: Triggering Series 2600B System SourceMeter® instrument Reference Manual Single pulse example code Even though no measurements are made in this example, a measure range is set. When sourcing voltage, it is good practice to set the current measure range equal to the triggered source limit range. This is especially important when the triggered limit is greater than 100 mA.
Page 137 Series 2600B System SourceMeter® instrument Reference Manual Section 4: 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 138 Section 4: Triggering Series 2600B System SourceMeter® instrument Reference Manual The following figure shows the trigger setup for this example. Figure 42: Pulse train triggering 4-20 2600BS-901-01 Rev. F/August 2021...
Page 139 Series 2600B System SourceMeter® instrument Reference Manual Section 4: Triggering Pulse train example code Even though no measurements are made in this example, a measure range is set. When sourcing voltage, it is good practice to set the current measure range equal to the triggered source limit range. This is especially important when the triggered limit is greater than 100 mA.
Page 140: Event Blenders
Section 4: Triggering Series 2600B System SourceMeter® instrument Reference Manual -- Configure the trigger model to execute a 10-point fixed-level voltage pulse -- train. No measurements are made. smua.trigger.source.listv({5}) smua.trigger.source.action = smua.ENABLE smua.trigger.measure.action = smua.DISABLE -- Set the trigger source limit, which can be different than the bias limit. -- This is an important setting for pulsing in the extended operating area.
Page 141: Lan Triggering Overview
Series 2600B System SourceMeter® instrument Reference Manual Section 4: Triggering Assigning input trigger events Each event blender has four stimulus inputs. You can assign a different trigger event ID to each stimulus input. The programming example below illustrates how to assign the source complete event IDs of SMU A and SMU B to stimulus inputs 1 and 2 of event blender 1: trigger.blender[1].stimulus[1] = smua.SOURCE_COMPLETE_EVENT_ID trigger.blender[1].stimulus[2] = smub.SOURCE_COMPLETE_EVENT_ID...
Page 142 Section 4: Triggering Series 2600B System SourceMeter® instrument Reference Manual LXI trigger edge detection Stateless event flag Hardware value Pseudo line state Falling edge Rising edge Detected Detected Detected Detected Detected Detected Detected Detected Set the LAN trigger mode to configure the edge detection method in incoming LXI trigger packets. The mode that is selected also determines the hardware value in outgoing LXI trigger packets.
Page 143: Command Interface Triggering
Series 2600B System SourceMeter® instrument Reference Manual Section 4: Triggering Command interface triggering A command interface trigger occurs when: • A GPIB GET command is detected (GPIB only) • A VXI-11 device_trigger method is invoked (VXI-11 only) • A *TRG message is received •...
Page 144: Manual Triggering
Section 4: Triggering Series 2600B System SourceMeter® instrument Reference Manual Manual triggering The TRIG key is used for manual triggering. Each time the TRIG key is pressed, a trigger event is generated. You can monitor for a manual trigger event using the event ID display.trigger.EVENT_ID.
Page 145 Series 2600B System SourceMeter® instrument Reference Manual Section 4: Triggering Using the assert function to generate output triggers You can use certain trigger objects to generate output triggers on demand. These trigger objects are the digital I/O lines, TSP-Link synchronization lines, and the LAN. The programming example below illustrates how to generate an output trigger using the assert function of the trigger object.
Page 146 Section 4: Triggering Series 2600B System SourceMeter® instrument Reference Manual Using the set function to bypass SMU event detectors The set functions are useful whenever you want the source-measure unit (SMU) to continue operation without waiting for a programmed trigger event. There is a set function for each SMU event detector.
Page 147 Series 2600B System SourceMeter® instrument Reference Manual Section 4: Triggering Examples using interactive triggering The following examples demonstrate how to use interactive triggering. Command interface interactive trigger example The programming example below illustrates how to clear triggers, turn on the SMU output, and then enable a 30-second timeout to wait for a command interface trigger.
Page 148: Hardware Trigger Modes
Section 4: Triggering Series 2600B System SourceMeter® instrument Reference Manual Digital I/O triggering interactive example The programming example below illustrates how to configure digital I/O line 2 as an input trigger and digital I/O line 14 as an output trigger. The 2600B to wait for an external input trigger on digital I/O line 2.
Page 149 Series 2600B System SourceMeter® instrument Reference Manual Section 4: Triggering Falling edge trigger mode The falling edge trigger mode generates low pulses and detects all falling edges. The figure titled "Falling edge input trigger" shows the characteristics of the falling edge input trigger; the figure titled "Falling edge output trigger"...
Page 150 Section 4: Triggering Series 2600B System SourceMeter® instrument Reference Manual 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 151 Series 2600B System SourceMeter® instrument Reference Manual Section 4: Triggering 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 46: RisingA input trigger Output characteristics: •...
Page 152 Section 4: Triggering Series 2600B System SourceMeter® instrument Reference Manual 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 48: Either edge input trigger Output characteristics: •...
Page 153: Understanding Synchronous Triggering Modes
Series 2600B System SourceMeter® instrument Reference Manual Section 4: Triggering 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 154 Section 4: Triggering Series 2600B System SourceMeter® instrument Reference Manual Output characteristics: • In addition to trigger events from other trigger objects, the digio.trigger[N].assert() and tsplink.trigger[N].assert() functions generate a low pulse that is similar to the falling edge trigger mode. •...
Page 155 Series 2600B System SourceMeter® instrument Reference Manual Section 4: Triggering Output characteristics: • In addition to trigger events from other trigger objects, the digio.trigger[N].assert() and tsplink.trigger[N].assert() functions release the line if the line is latched low. The pulse width is not used. •...
Page 156: Digital I/O
Section 4: Triggering Series 2600B System SourceMeter® instrument Reference Manual Output characteristics: • In addition to trigger events from other trigger objects, the digio.trigger[N].assert() and tsplink.trigger[N].assert() functions generate a low pulse for the programmed pulse duration if the line is latched low; a falling edge does not occur. •...
Page 157 Series 2600B System SourceMeter® instrument Reference Manual Section 4: Triggering Connecting cables for Trigger Link Use a cable equipped with a male DB-25 connector (L-com part number CSMN25MF-5) to connect the digital I/O port to other Keithley Instruments models equipped with a Trigger Link (TLINK) interface.
Page 158 Section 4: Triggering Series 2600B System SourceMeter® instrument Reference Manual Interlock line At no time should you bypass the interlock feature of the 2600B. Safe operation requires a separate interlock circuit that meets the requirements of the application to reliably protect the operator from exposed voltages.
Page 159 Series 2600B System SourceMeter® instrument Reference Manual Section 4: Triggering Controlling digital I/O lines Although the digital I/O lines are primarily intended for use with a device handler for limit testing, they can also be used for other purposes, such as controlling external logic circuits. You can control lines either from the front panel or over a remote interface.
Page 160 Section 4: Triggering Series 2600B System SourceMeter® instrument Reference Manual 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 9-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 161 Series 2600B System SourceMeter® instrument Reference Manual Section 4: Triggering When an interlock is required for safety, a separate circuit should be provided that meets the requirements of the application to reliably protect the operator from exposed voltages. The digital I/O port of the 2601B, 2602B, or 2604B is not suitable for control of safety circuits and should not be used to control a safety interlock.
Page 162 Section 4: Triggering Series 2600B System SourceMeter® instrument Reference Manual Remote control of output enable Use one of these commands to control output enable action: smuX.source.outputenableaction = smuX.OE_NONE smuX.source.outputenableaction = smuX.OE_OUTPUT_OFF For the 2601B, smuX is smua (SMU Channel A). For the 2602B and 2604B, this value can be smua or smub (for SMU channel A or SMU channel B, respectively).
Page 163 Series 2600B System SourceMeter® instrument Reference Manual Section 4: Triggering Figure 59: Using 2611B, 2612B, 2614B, 2634B, 2635B, and 2636B interlock 1 INTERLOCK pin (on DIGITAL I/O or INTERLOCK connector) pin 24 2 Read by firmware 3 To output stage 4 Coil resistance 5 Chassis ground 6 Rear panel...
Page 164 Section 4: Triggering Series 2600B System SourceMeter® instrument Reference Manual Using TSP-Link trigger lines for digital I/O Each trigger line is an open-drain signal. When using the TSP-Link ® trigger lines for digital I/O, any node that sets the programmed line state to zero (0) causes all nodes to read 0 from the line state. This occurs regardless of the programmed line state of any other node.
Page 165 Section 5 Theory of operation In this section: Source-measure concepts ............5-1 Analog-to-digital converter ............. 5-24 Measurement settling time considerations ......5-24 Effects of load on current source settling time......5-25 Creating pulses with the 2600B SMU ........5-26 Source-measure concepts This section provides detailed information about source-measure concepts, including: •...
Page 166 Section 5: Theory of operation Series 2600B System SourceMeter® instrument Reference Manual Overheating protection ® Proper ventilation is required to keep the System SourceMeter instrument from overheating. Even with proper ventilation, the instrument can overheat if the ambient temperature is too high or the ®...
Page 167 Series 2600B System SourceMeter® instrument Reference Manual Section 5: Theory of operation General power equation The instrument output amplifier voltage. This constant can be found in the tables in Maximum duty cycle equation (on page 5-3). The voltage level the instrument is attempting to force while at the pulse level. When operating in quadrants 1 or 3 (sourcing power), the sign of this voltage must be positive when used in the power equations.
Page 168 Section 5: Theory of operation Series 2600B System SourceMeter® instrument Reference Manual Operating boundaries Depending on how the instrument is programmed and what is connected to the output (load or source), the instrument can operate in any of the four quadrants. The four quadrants of operation are shown in the following figure.
Page 169 Series 2600B System SourceMeter® instrument Reference Manual Section 5: Theory of operation Figure 61: 2601B, 2602B, or 2604B continuous power operating boundaries The general operating boundaries for 2611B, 2612B, 2614B, 2634B, 2635B, or 2636B continuous power output are shown in the following figure (for derating factors, see General power equation page 5-3)).
Page 170 Section 5: Theory of operation Series 2600B System SourceMeter® instrument Reference Manual Operation as a sink When the 2600B is operating in the second quadrant or fourth quadrant, the SMU operates as a load that sinks and dissipates power internally. The ability of the SMU to dissipate power is defined by the boundaries shown in the previous figure.
Page 171 Series 2600B System SourceMeter® instrument Reference Manual Section 5: Theory of operation The following figure shows the limit lines for the voltage source. The voltage source limit line represents the maximum source value possible for the presently selected voltage source range. For example, if you are using the 6 V source range, the voltage source limit line is at 6.3 V.
Page 172 Section 5: Theory of operation Series 2600B System SourceMeter® instrument Reference Manual Figure 65: Voltage source output characteristics (2611B, 2612B, 2614B, 2634B, 2635B, 2636B) The following figure shows the limit lines for the voltage source. The voltage source limit line represents the maximum source value possible for the presently selected voltage source range.
Page 173 Series 2600B System SourceMeter® instrument Reference Manual Section 5: Theory of operation Load considerations (V-source) The boundaries within which the 2600B operates depend on the load (device-under-test, or DUT) that is connected to the output. The following figures show operation examples for resistive loads that are 2 kΩ...
Page 174 Section 5: Theory of operation Series 2600B System SourceMeter® instrument Reference Manual The following figure shows what happens if the resistance of the load is decreased to 800 Ω. The DUT load line for 800 Ω intersects the current compliance limit line, which places the SMU in compliance.
Page 175 Series 2600B System SourceMeter® instrument Reference Manual Section 5: Theory of operation Figure 69: Voltage source operation in power compliance × R = (6 mA)(800 Ω) = 4.8 V The following figure shows a voltage sweep on a resistive load of 800 Ω. For this example, the SMU is programmed to sweep voltage to 10 V, limit current (6 mA), and limit power (50 mW).
Page 176 Section 5: Theory of operation Series 2600B System SourceMeter® instrument Reference Manual V-source sink operating boundaries The quadrant within which the 2600B operates depends on the device-under-test (DUT) that is connected to the 2600B output. The following example illustrates this operation using the 2600B configured as a voltage source to discharge a 12 V power source (a battery).
Page 177 Series 2600B System SourceMeter® instrument Reference Manual Section 5: Theory of operation In the following figure, as the battery drains, the battery voltage is lowered (shown by the green arrow in the figure). Operation continues in this direction until the SMU can deliver the programmed voltage source value.
Page 178 Section 5: Theory of operation Series 2600B System SourceMeter® instrument Reference Manual I-source operating boundaries 2601B, 2602B, and 2604B current source operating boundaries The following figure shows the operating boundaries and output characteristics for the current source. Only the first quadrant of operation is shown; operation in the other three quadrants is similar. As shown, the 2601B, 2602B, and 2604B can output up to 1.01 A at 40 V, or 3.03 A at 6 V.
Page 179 Series 2600B System SourceMeter® instrument Reference Manual Section 5: Theory of operation Figure 74: Current source limit lines (2601B, 2602B, and 2604B) 2611B, 2612B, 2614B, 2634B, 2635B, and 2636B current source operating boundaries The following figure show the operating boundaries and output characteristics for the current source. Only the first quadrant of operation is shown;...
Page 180 Section 5: Theory of operation Series 2600B System SourceMeter® instrument Reference Manual Figure 75: Current source limit line (2611B, 2612B, 2614B, 2634B, 2635B, and 2636B) Load considerations (I-source) The boundaries within which the SMU operates depend on the load (device-under-test, or DUT) that is connected to its output.
Page 181 Series 2600B System SourceMeter® instrument Reference Manual Section 5: Theory of operation The following figure shows what happens if the resistance of the load is increased to 200 Ω. The DUT load line for 200 Ω intersects the voltage compliance limit line, which places the SMU in voltage compliance.
Page 182 Section 5: Theory of operation Series 2600B System SourceMeter® instrument Reference Manual Figure 78: Current source operation in power compliance = 6 V / 200 Ω) = 30 mA The following figure shows a current sweep on a resistive load of 200 Ω. For this example, the SMU is programmed to sweep current to 100 mA, limit voltage (6 V), and limit power (500 mW).
Page 183 Series 2600B System SourceMeter® instrument Reference Manual Section 5: Theory of operation Figure 79: Programmed current source sweep operation in voltage and power compliance I-source sink operating boundaries The quadrant within which the 2600B operates depends on the device-under-test (DUT) connected to the 2600B output.
Page 184 Section 5: Theory of operation Series 2600B System SourceMeter® instrument Reference Manual 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 2600B is programmed to source −50 mA (the constant current) and to limit voltage to 15 V.
Page 185 Series 2600B System SourceMeter® instrument Reference Manual Section 5: Theory of operation Figure 81: Considerations when sourcing current and sinking power 2600BS-901-01 Rev. F/August 2021 5-21...
Page 186 Section 5: Theory of operation Series 2600B System SourceMeter® instrument Reference Manual Guard GUARD is at the same potential as output HI. 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 187 Series 2600B System SourceMeter® instrument Reference Manual Section 5: Theory of operation Inside the test fixture, a triaxial cable can be used to extend guard to the DUT. The center conductor of the cable is used for HI, and the inner shield is used for guard. The figures below show how cable guard can eliminate leakage current through the insulators in a test fixture.
Page 188 Section 5: Theory of operation Series 2600B System SourceMeter® instrument Reference Manual Analog-to-digital converter The 2600B SMUs have integrating analog-to-digital converter (ADCs). The integrating ADCs use a ratiometric analog-to-digital conversion technique. Depending on the configuration of the integrating ADCs, periodic fresh reference measurements are required to minimize drift. The measurement aperture is used to determine the time interval between these measurement updates.
Page 189 Series 2600B System SourceMeter® instrument Reference Manual Section 5: Theory of operation Delays are on by default for the 2634B, 2635B, and 2636B. Delays are off by default for the 2601B, 2602B, 2604B, 2611B, 2612B, and 2614B but can be enabled. You can manipulate both the analog filter and the default delays to produce faster response times.
Page 190 Section 5: Theory of operation Series 2600B System SourceMeter® instrument Reference Manual There is a maximum DUT impedance for each current source range for which the specified current settling times are maintained. The following table lists the DUT impedances for each of these current source ranges.
Page 191 Series 2600B System SourceMeter® instrument Reference Manual Section 5: Theory of operation Refer to the 2600B specifications for details on source settling times. For the latest specifications, go to tek.com/keithley. Figure 84: Pulse rise and fall times Range and pulse settling Each SMU range has different specifications for source settling times.
Page 192 Section 6 Troubleshooting guide In this section: Introduction ................6-1 Error levels ................6-1 Effects of errors on scripts............6-1 Retrieving errors ............... 6-2 Error summary list ..............6-2 LAN troubleshooting suggestions ..........6-6 Introduction Troubleshooting information includes information on the Keithley Instruments 2600B errors (including a complete list of error messages) and LAN troubleshooting suggestions.
Page 193 Section 6: Troubleshooting guide Series 2600B 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 194 Series 2600B System SourceMeter® instrument Reference Manual Section 6: Troubleshooting guide Error summary Error number Error level Error message RECOVERABLE Reading buffer data lost RECOVERABLE Power on state lost FATAL Unresponsive digital FPGA RECOVERABLE OUTPUT blocked by interlock RECOVERABLE Error parsing exponent RECOVERABLE Error parsing value FATAL...
Page 195 Section 6: Troubleshooting guide Series 2600B System SourceMeter® instrument Reference Manual Error summary Error number Error level Error message 1600 RECOVERABLE Maximum GPIB message length exceeded 1700 RECOVERABLE Display area boundary exceeded 1800 RECOVERABLE Invalid digital trigger mode 1801 RECOVERABLE Invalid digital I/O line 2000 SERIOUS...
Page 196 Series 2600B System SourceMeter® instrument Reference Manual Section 6: 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 197 Section 6: Troubleshooting guide Series 2600B System SourceMeter® instrument Reference Manual Error summary Error number Error level Error message 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 198 Section 7 Introduction to TSP operation In this section: Introduction to TSP operation........... 7-1 About TSP commands ............. 7-3 Factory scripts ................ 7-20 Introduction to TSP operation Instruments that are enabled for Test Script Processor (TSP ® ) operate like conventional instruments by responding to a sequence of commands sent by the controller.
Page 199 Section 7: Introduction to TSP operation Series 2600B 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 ( ). Only include information in the parentheses if the function takes a parameter.
Page 200 Series 2600B System SourceMeter® instrument Reference Manual Section 7: Introduction to TSP operation Example 3: Read an attribute using a function print(format.data) Reads the data format by passing the attribute to the print function. If the data format is set to 3, the output is: 3.00000e+00 This shows that the data format is set to double precision floating point.
Page 201 Section 7: Introduction to TSP operation Series 2600B 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 202 Series 2600B System SourceMeter® instrument Reference Manual Section 7: Introduction to TSP operation Data queue Use the data queue commands to: • Share data between test scripts running in parallel • ® Access data from a remote group or a local node on a TSP-Link network at any time ®...
Page 203 Section 7: Introduction to TSP operation Series 2600B System SourceMeter® instrument Reference Manual Display display.clear() (on page 9-65) display.getannunciators() (on page 9-65) display.getcursor() (on page 9-67) display.getlastkey() (on page 9-68) display.gettext() (on page 9-69) display.inputvalue() (on page 9-70) display.loadmenu.add() (on page 9-72) display.loadmenu.catalog() (on page 9-73) display.loadmenu.delete()
Page 204 Series 2600B System SourceMeter® instrument Reference Manual Section 7: Introduction to TSP operation File I/O You can use the file I/O commands to open and close directories and files, write data, or to read a file on an installed USB flash drive. File I/O commands are organized into two groups: •...
Page 205 Section 7: Introduction to TSP operation Series 2600B System SourceMeter® instrument Reference Manual io.input() (on page 9-118) io.open() (on page 9-119) io.output() (on page 9-120) io.read() (on page 9-121) io.type() (on page 9-122) io.write() (on page 9-123) os.remove() (on page 9-168) os.rename() (on page 9-168) The following standard I/O commands are not supported:...
Page 206 Series 2600B System SourceMeter® instrument Reference Manual Section 7: Introduction to TSP operation GPIB This attribute stores the GPIB address. gpib.address (on page 9-110) Instrument identification These commands store strings that describe the instrument. localnode.description (on page 9-154) localnode.model (on page 9-156) localnode.revision (on page 9-161) localnode.serialno...
Page 207 Section 7: Introduction to TSP operation Series 2600B System SourceMeter® instrument Reference Manual lan.reset() (on page 9-135) lan.restoredefaults() (on page 9-136) lan.status.dns.address[N] (on page 9-137) lan.status.dns.name (on page 9-137) lan.status.duplex (on page 9-138) lan.status.gateway (on page 9-139) lan.status.ipaddress (on page 9-139) lan.status.macaddress (on page 9-140) lan.status.port.dst...
Page 208 Series 2600B System SourceMeter® instrument Reference Manual Section 7: Introduction to TSP operation Parallel script execution dataqueue.add() (on page 9-49) dataqueue.CAPACITY (on page 9-50) dataqueue.clear() (on page 9-50) dataqueue.count (on page 9-51) dataqueue.next() (on page 9-52) node[N].execute() (on page 9-165) node[N].getglobal() (on page 9-166) node[N].setglobal()
Page 209 Section 7: Introduction to TSP operation Series 2600B System SourceMeter® instrument Reference Manual bufferVar.n (on page 9-28) bufferVar.readings (on page 9-29) bufferVar.sourcefunctions (on page 9-30) bufferVar.sourceoutputstates (on page 9-31) bufferVar.sourceranges (on page 9-31) bufferVar.sourcevalues (on page 9-32) bufferVar.statuses (on page 9-34) bufferVar.timestampresolution (on page 9-35) bufferVar.timestamps...
Page 210 Series 2600B System SourceMeter® instrument Reference Manual Section 7: Introduction to TSP operation Scripting Scripting helps you combine commands into a block of code that the instrument can run. Scripts help you communicate with the instrument efficiently. These commands describe how to create, load, modify, run, and exit scripts.
Page 211 Section 7: Introduction to TSP operation Series 2600B System SourceMeter® instrument Reference Manual smuX.measure.overlappedY() (on page 9-229) smuX.measure.rangeY (on page 9-230) smuX.measure.rel.enableY (on page 9-231) smuX.measure.rel.levelY (on page 9-232) smuX.measure.Y() (on page 9-233) smuX.measureYandstep() (on page 9-234) smuX.nvbufferY (on page 9-235) smuX.reset() (on page 9-236) smuX.savebuffer()
Page 212 Series 2600B System SourceMeter® instrument Reference Manual Section 7: Introduction to TSP operation smuX.trigger.SOURCE_COMPLETE_EVENT_ID (on page 9-277) smuX.trigger.SWEEP_COMPLETE_EVENT_ID (on page 9-278) smuX.trigger.SWEEPING_EVENT_ID (on page 9-278) SMU calibration smuX.cal.adjustdate (on page 9-201) smuX.cal.date (on page 9-202) smuX.cal.due (on page 9-203) smuX.cal.lock() (on page 9-204) smuX.cal.password (on page 9-205)
Page 213 Section 7: Introduction to TSP operation Series 2600B System SourceMeter® instrument Reference Manual status.operation.instrument.tsplink.* (on page 9-321) status.operation.instrument.tsplink.trigger_overrun.* (on page 9-322) status.operation.measuring.* (on page 9-324) status.operation.remote.* (on page 9-325) status.operation.sweeping.* (on page 9-327) status.operation.trigger_overrun.* (on page 9-328) status.operation.user.* (on page 9-331) status.questionable.* (on page 9-333) status.questionable.calibration.*...
Page 214 Series 2600B System SourceMeter® instrument Reference Manual Section 7: Introduction to TSP operation digio.trigger[N].overrun (on page 9-58) digio.trigger[N].pulsewidth (on page 9-59) digio.trigger[N].release() (on page 9-59) digio.trigger[N].reset() (on page 9-60) digio.trigger[N].stimulus (on page 9-61) digio.trigger[N].wait() (on page 9-62) display.trigger.clear() (on page 9-84) display.trigger.EVENT_ID (on page 9-84) display.trigger.overrun...
Page 215 Section 7: Introduction to TSP operation Series 2600B System SourceMeter® instrument Reference Manual smuX.trigger.SWEEP_COMPLETE_EVENT_ID (on page 9-278) smuX.trigger.SWEEPING_EVENT_ID (on page 9-278) trigger.blender[N].clear() (on page 9-368) trigger.blender[N].EVENT_ID (on page 9-368) trigger.blender[N].orenable (on page 9-369) trigger.blender[N].overrun (on page 9-369) trigger.blender[N].reset() (on page 9-370) trigger.blender[N].stimulus[M] (on page 9-371) trigger.blender[N].wait()
Page 216 Series 2600B System SourceMeter® instrument Reference Manual Section 7: Introduction to TSP operation tsplink.readport() (on page 9-385) tsplink.reset() (on page 9-386) tsplink.state (on page 9-387) tsplink.trigger[N].assert() (on page 9-388) tsplink.trigger[N].clear() (on page 9-388) tsplink.trigger[N].EVENT_ID (on page 9-389) tsplink.trigger[N].mode (on page 9-390) tsplink.trigger[N].overrun (on page 9-391) tsplink.trigger[N].pulsewidth...
Page 217 Section 7: Introduction to TSP operation Series 2600B System SourceMeter® instrument Reference Manual Userstrings Use the functions in this group to store and retrieve user-defined strings in nonvolatile memory. These strings are stored as key-value pairs. The key is a unique identifier such as a part number or identification string.
Page 218 Series 2600B System SourceMeter® instrument Reference Manual Section 7: Introduction to TSP operation Running a factory script Use either of the following commands to run a factory script: script.factory.scripts.name() script.factory.scripts.name.run() Where: name is the name of the factory script. Example: Run the factory script named KISweep.
Page 219 Section 7: Introduction to TSP operation Series 2600B System SourceMeter® instrument Reference Manual KISweep factory script The KISweep factory script provides simple sweep test programming and shows how to use the sweeping function. This script is made up of the following functions. Access these functions from the front panel or the remote interfaces.
Page 220 Series 2600B System SourceMeter® instrument Reference Manual Section 7: Introduction to TSP operation Conditions that must be true for successful function execution Conditions for Config functions Conditions for InitiatePulseTest Conditions for InitiatePulseTestDual functions functions Source autorange (I and V) off Output on Output on Measure autorange (I and V) off...
Page 221 Section 7: Introduction to TSP operation Series 2600B System SourceMeter® instrument Reference Manual Simultaneous IV measurement during pulse The KIPulse “Configure” functions optionally accept an extra reading buffer to activate simultaneous IV measurements during pulsing. Previous usage of passing in a reading buffer or a nil (for no measurement) is still supported.
Page 222 Section 8 Instrument programming In this section: Fundamentals of scripting for TSP ........... 8-1 Fundamentals of programming for TSP ......... 8-13 Password management ............8-32 Key-press codes ..............8-34 Remote communications interfaces ........8-36 Test Script Builder ..............8-67 Working with TSB Embedded ..........8-70 Advanced scripting for TSP ............
Page 223 Section 8: Instrument programming Series 2600B 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 224 Series 2600B System SourceMeter® instrument Reference Manual Section 8: 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 225 Section 8: Instrument programming Series 2600B System SourceMeter® instrument Reference Manual Anonymous scripts If a script is created with the loadscript or loadandrunscript command with no name defined, it is called the anonymous script. There can only be one anonymous script in the runtime environment. If another anonymous script is loaded into the runtime environment, it replaces the existing anonymous script.
Page 226 Series 2600B System SourceMeter® instrument Reference Manual Section 8: Instrument programming Figure 85: 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 227 Section 8: Instrument programming Series 2600B System SourceMeter® instrument Reference Manual If the loaded file does not contain loadscript and endscript keywords, or if no name is included after the loadscript keyword, the code is loaded as the anonymous script. Loading an unnamed script overwrites the existing anonymous script.
Page 228 Series 2600B System SourceMeter® instrument Reference Manual Section 8: 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 229 Section 8: Instrument programming Series 2600B 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 230 Series 2600B System SourceMeter® instrument Reference Manual Section 8: Instrument programming Autoexec script The autoexec script runs automatically when the instrument is turned on. It runs after all the scripts have loaded and any scripts defined as autorun have run. To create a script that executes automatically, create and load a new script and name it autoexec.
Page 231 Section 8: Instrument programming Series 2600B System SourceMeter® instrument Reference Manual The scriptVar.save() command saves the script to nonvolatile memory, which makes the change persistent through a power cycle. See Save a user script to nonvolatile memory (on page 8-10) for more detail. Example: Set a script to run automatically test5.autorun = "yes"...
Page 232 Series 2600B System SourceMeter® instrument Reference Manual Section 8: Instrument programming To save a script to an external USB flash drive using a remote interface: When you save a script to a USB flash drive, you do not need to specify a file extension. The extension .tsp is automatically added.
Page 233 Section 8: Instrument programming Series 2600B System SourceMeter® instrument Reference Manual Delete user scripts These steps remove a script from nonvolatile memory. To completely remove a script from the instrument, there are additional steps you must take. See Delete user scripts from the instrument page 8-81).
Page 234 Series 2600B System SourceMeter® instrument Reference Manual Section 8: Instrument programming reset() -- Clear the display. display.clear() -- Prompt the user for a voltage value to source. srcVoltage = display.prompt("+000.00", " V", "Enter source voltage", 5, -20, 20) -- Prompt the user to enable measurements. measEnable = display.menu("Measurements?", "ENABLE DISABLE") if measEnable == "ENABLE"...
Page 235 Section 8: Instrument programming Series 2600B System SourceMeter® instrument Reference Manual What is Lua? Lua is a programming language that can be used with TSP-enabled instruments. Lua is an efficient language with simple syntax that is easy to learn. Lua is also a scripting language, which means that scripts are compiled and run when they are sent to the instrument.
Page 236 Series 2600B System SourceMeter® instrument Reference Manual Section 8: Instrument programming You cannot use the following Lua reserved words for function or variable names. Lua reserved words break function repeat return else then elseif local true until false while You also cannot use top-level command names as variable names. If you use these names, it results in the loss of use of the commands.
Page 237 Section 8: Instrument programming Series 2600B System SourceMeter® instrument Reference Manual Variable types Variables can be one of the following types. Variable types and values Variable type returned Value Notes "nil" The type of the value nil, whose main property is not declared to be different from any other value;...
Page 238 Series 2600B System SourceMeter® instrument Reference Manual Section 8: Instrument programming Example: Function function add_two(first_value, function second_value) return first_value + second_value print(add_two(3, 4), type(add_two)) Example: Table atable = {1, 2, 3, 4} Defines a table with four numeric elements. print(atable, type(atable)) Note that the table value (shown here as a096cd30) print(atable[1]) varies.
Page 239 Section 8: Instrument programming Series 2600B System SourceMeter® instrument Reference Manual To execute a function, substitute appropriate values for parameterX and insert them into a message formatted as: myFunction(valueForParameterX, valueForParameterY) Where valueForParameterX and valueForParameterY represent the values to be passed to the function call for the given parameters.
Page 240 Series 2600B System SourceMeter® instrument Reference Manual Section 8: Instrument programming Create functions using scripts You can use scripts to define functions. Scripts that define a function are like any other script: They do not cause any action to be performed on the instrument until they are executed. The global variable of the function does not exist until the script that created the function is executed.
Page 241 Section 8: Instrument programming Series 2600B System SourceMeter® instrument Reference Manual Group commands using the function keyword The following script contains instrument commands that display the name of the person that is using the script on the front panel of the instrument. It takes one parameter to represent this name. When this script is run, the function is loaded in memory.
Page 242 Series 2600B System SourceMeter® instrument Reference Manual Section 8: Instrument programming Logical operators The logical operators in Lua are and, or, and not. All logical operators consider both false and nil as false and anything else as true. The operator not always returns false or true. The conjunction operator and returns its first argument if the first argument is false or nil;...
Page 243 Section 8: Instrument programming Series 2600B System SourceMeter® instrument Reference Manual Operator precedence Operator precedence in Lua follows the order below (from higher to lower priority): • ^ (exponentiation) • not, - (unary) • *, / • +, – • ..
Page 244 Series 2600B System SourceMeter® instrument Reference Manual Section 8: Instrument programming Example: If if 0 then Output: print("Zero is true!") Zero is true! else print("Zero is false.") Example: Comparison x = 1 Output: y = 2 Both x and y are true if x and y then print("Both x and y are true") Example: If and else...
Page 245 Section 8: Instrument programming Series 2600B System SourceMeter® instrument Reference Manual Loop control If you need to repeat code execution, you can use the Lua while, repeat, and for control structures. To exit a loop, you can use the break keyword. While loops To use conditional expressions to determine whether to execute or end a loop, you use while loops.
Page 246 Series 2600B System SourceMeter® instrument Reference Manual Section 8: Instrument programming The output you get from this example may vary depending on the data format settings of the instrument. Example: Repeat until list = {"One", "Two", "Three", "Four", "Five", "Six"} print("Count elements in list using repeat:") element = 1 repeat...
Page 247 Section 8: Instrument programming Series 2600B System SourceMeter® instrument Reference Manual Example: Numeric for list = {"One", "Two", "Three", "Four", "Five", "Six"} ---------- For loop ----------- print("Counting from one to three:") for element = 1, 3 do print(element, list[element]) print("Counting from one to four, in steps of two:") for element = 1, 4, 2 do print(element, list[element]) The numeric for loop repeats a block of code while a control variable runs through an arithmetic progression.
Page 248 Series 2600B System SourceMeter® instrument Reference Manual Section 8: Instrument programming Break The break statement terminates 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 249 Section 8: Instrument programming Series 2600B System SourceMeter® instrument Reference Manual Example: Break with infinite loop a, b = 0, 1 This example uses a break statement that while true do causes the while loop to exit if the value of a print(a, b) becomes greater than 500.
Page 250 Series 2600B System SourceMeter® instrument Reference Manual Section 8: 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 ) scripting engine instruments also include instrument control extension libraries, which provide programming interfaces to the instrumentation that can be accessed by the TSP scripting engine.
Page 251 Section 8: Instrument programming Series 2600B 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 252 Series 2600B System SourceMeter® instrument Reference Manual Section 8: 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 253 Section 8: Instrument programming Series 2600B System SourceMeter® instrument Reference Manual Programming example: User script The following script puts a message on the front panel display slowly, one character at a time. The intent of this example is to demonstrate: •...
Page 254 Series 2600B System SourceMeter® instrument Reference Manual Section 8: Instrument programming Setting the password from a command or web interface The attribute localnode.passwordmode enables passwords and sets the mode. The password mode identifies which interface to password protect. Set this attribute to one of the values below to enable password checking: •...
Page 255 Section 8: Instrument programming Series 2600B System SourceMeter® instrument Reference Manual Unlocking the remote interface If the remote interface is locked, you must enter the password before the 2600B responds to any command issued over a remote interface. The password for the example below is Keithley. To unlock the remote interface, send the following command: password Keithley The 2600B is unlocked and communicates with any remote interface.
Page 256 Series 2600B System SourceMeter® instrument Reference Manual Section 8: Instrument programming Capturing key-press codes A history of the key code for the last pressed front-panel key is maintained by the 2600B. When the instrument is turned on (or when transitioning from local to remote operation), the key code is set to 0 (display.KEY_NONE).
Page 257 Section 8: Instrument programming Series 2600B System SourceMeter® instrument Reference Manual display.waitkey() The display.waitkey() function captures the key code value for the next key press: key = display.waitkey() After sending the display.waitkey() function, the script pauses and waits for the operator to press a front-panel key.
Page 258 Series 2600B System SourceMeter® instrument Reference Manual Section 8: Instrument programming Supported remote interfaces The 2600B 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 259 Section 8: Instrument programming Series 2600B System SourceMeter® instrument Reference Manual Figure 86: 2602B and 2612B IEEE-488, LAN, USB, and RS-232 connections (2601B, 2604B, 2611B, and 2614B similar) 1 IEEE-488 connection 2 LAN connection 3 USB connection 4 RS-232 connection Figure 87: 2636B IEEE-488, LAN, USB, and RS-232 connections (2634B and 2635B similar) 1 IEEE-488 connection 2 LAN connection...
Page 260 Series 2600B System SourceMeter® instrument Reference Manual Section 8: Instrument programming 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 261 Section 8: Instrument programming Series 2600B System SourceMeter® instrument Reference Manual 5. Select File > Open Instrument to open the instrument you named in the wizard. Figure 88: 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 262 Series 2600B System SourceMeter® instrument Reference Manual Section 8: Instrument programming LAN cable connection The 2601B, 2602B, 2611B, 2612B, 2635B, and 2636B include two LAN crossover cables. Use one ® cable for the TSP-Link network and use the other cable for the LAN. ®...
Page 263 Section 8: Instrument programming Series 2600B System SourceMeter® instrument Reference Manual 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 264 Series 2600B System SourceMeter® instrument Reference Manual Section 8: Instrument programming To select a LAN configuration method: 1. From the front panel, press the MENU key, and then select LAN > CONFIG > METHOD. 2. Select either AUTO or MANUAL. 3.
Page 265 Section 8: Instrument programming Series 2600B System SourceMeter® instrument Reference Manual Setting the subnet mask Contact your corporate information technology (IT) department to secure a valid subnet mask for the instrument when placing the instrument on a corporate network. To set the subnet mask when LAN configuration method is set to MANUAL: 1.
Page 266 Series 2600B System SourceMeter® instrument Reference Manual Section 8: Instrument programming To enable or disable DNS host name verification: 1. From the front panel, press the MENU key, and then select LAN > CONFIG > DNS > VERIFY. 2. Turn the navigation wheel to select either ENABLE or DISABLE. When enabled, the instrument performs a DNS lookup to verify the DNS host name matches the value specified in the lan.config.dns.hostname attribute.
Page 267 Section 8: Instrument programming Series 2600B System SourceMeter® instrument Reference Manual To set the duplex mode: 1. From the front panel, press the MENU key and select LAN > CONFIG > DUPLEX. 2. Turn the navigation wheel to select either HALF or FULL. 3.
Page 268 Series 2600B System SourceMeter® instrument Reference Manual Section 8: Instrument programming Record all network configurations before modifying any existing network configuration information on the network interface card. Once the network configuration settings are updated, the previous information is lost. This may cause a problem reconnecting the host computer to a corporate network, particularly if DHCP Enabled = NO (disabled).
Page 269 Section 8: Instrument programming Series 2600B System SourceMeter® instrument Reference Manual The ipconfig/all command displays the configuration of every network card. Make sure that you record the information for the proper network card. 4. If: ▪ DHCP Enabled = Yes: Go to Step 2: Disable DHCP to use the existing computer IP address (on page 8-48) ▪...
Page 270 Series 2600B System SourceMeter® instrument Reference Manual Section 8: Instrument programming 4. Select Properties. 5. Select Use the following IPv6 address. The option for "Use the following DNS server addresses" is automatically selected. 6. Set the IP address. If the IP address and subnet mask fields: ▪...
Page 271 Section 8: Instrument programming Series 2600B System SourceMeter® instrument Reference Manual Use the navigation wheel to select and enter an appropriate IP address for the instrument. Be sure to record the IP address to use in Step 4: Access the web interface of the instrument (on page 8-50).
Page 272 Series 2600B System SourceMeter® instrument Reference Manual Section 8: Instrument programming 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 93: LAN CONFIG/FAULT There are two types of LAN status messages: •...
Page 273 Section 8: Instrument programming Series 2600B System SourceMeter® instrument Reference Manual Selecting a LAN interface protocol You can use a remote interface protocol to connect to the 2600B. The 2600B provides Telnet, VXI-11, and raw socket LAN interfaces, with associated LAN protocols (each interface uses a different protocol).
Page 274 Series 2600B System SourceMeter® instrument Reference Manual Section 8: Instrument programming Confirming port numbers To view the port number assigned to each remote interface protocol: 1. From the front panel, press the MENU key, and then select LAN > STATUS > PORT. 2.
Page 275 Section 8: Instrument programming Series 2600B System SourceMeter® instrument Reference Manual To connect with the 2600B using PuTTY on a Windows system: 1. On the host computer, open PuTTY. The PuTTY Configuration dialog box opens. Figure 94: PuTTY configuration description dialog box 2.
Page 276 Series 2600B System SourceMeter® instrument Reference Manual Section 8: Instrument programming Use PuTTY to interact directly with the instrument. 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 277 Section 8: Instrument programming Series 2600B System SourceMeter® instrument Reference Manual GPIB operation The following topics contain information about GPIB standards, bus connections, and primary address selection. GPIB standards The GPIB is the IEEE-488 instrumentation data bus, which uses hardware and programming standards originally adopted by the Institute of Electrical and Electronic Engineers (IEEE) in 1975.
Page 278 Series 2600B System SourceMeter® instrument Reference Manual Section 8: Instrument programming Figure 97: IEEE-488 connections Figure 98: IEEE-488 connector location Connect any additional connectors from other instruments as required for your application. Make sure the other end of the cable is properly connected to the controller. You can have up to 15 devices connected to a GPIB interface, including the controller.
Page 279 Section 8: Instrument programming Series 2600B System SourceMeter® instrument Reference Manual To set the primary address remotely: gpib.address = address To set the primary address remotely to 20: gpib.address = 20 Note that changing the GPIB address takes effect when the command is processed. Any response messages generated after processing this command are sent with the new settings.
Page 280 Series 2600B System SourceMeter® instrument Reference Manual Section 8: Instrument programming 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 281 Section 8: Instrument programming Series 2600B System SourceMeter® instrument Reference Manual RS-232 interface operation The following topics contain information about configuring RS-232 communication parameters, sending or receiving command messages, and requesting or retrieving data. To control the 2600B, connect a controller or personal computer to the 2600B RS-232 interface. Alternatively, you can use the 2600B to control another device over RS-232.
Page 282 Series 2600B System SourceMeter® instrument Reference Manual Section 8: Instrument programming Sending and receiving data The RS-232 interface transfers data using 7 or 8 data bits; 1 stop bit; and no, even, or odd parity. Make sure the device you connect to the 2600B also uses the same settings. RS-232 terminator When receiving data over the RS-232 interface, the command interface terminates on line feeds.
Page 283 Section 8: Instrument programming Series 2600B System SourceMeter® instrument Reference Manual RS-232 connections Connect the RS-232 serial port of the 2600B 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 284 Series 2600B System SourceMeter® instrument Reference Manual Section 8: Instrument programming Software components for applications and instrument drivers The majority of software applications and all instrument drivers from Keithley Instruments depend on the following software components: • NI-VISA • VISA shared components •...
Page 285 Section 8: Instrument programming Series 2600B System SourceMeter® instrument Reference Manual 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 •...
Page 286 Series 2600B System SourceMeter® instrument Reference Manual Section 8: Instrument programming Instrument driver examples All Keithley drivers come with examples written in several programming languages that show you how to do common tasks with the instruments. The examples are available in the drivers and through Test Script Builder.
Page 287 Section 8: Instrument programming Series 2600B System SourceMeter® instrument Reference Manual Keithley I/O layer The Keithley I/O Layer (KIOL) is a software package that contains several utilities and drivers. It is mainly used as a supplement to IVI drivers or application software like Test Script Builder (TSB). For additional detail on the Keithley I/O layer, including computer requirements and installation instructions, see the tek.com/keithley...
Page 288 Series 2600B System SourceMeter® instrument Reference Manual Section 8: Instrument programming Test Script Builder Keithley Instruments Test Script Builder (TSB) is a software tool you can use to develop scripts for TSP-enabled instruments. Installing the TSB software The installation files for the TSB software are available at tek.com/keithley. To install the TSB software: 1.
Page 289 Section 8: Instrument programming Series 2600B System SourceMeter® instrument Reference Manual The following figure shows an example of the Test Script Builder. As shown, the workspace is divided into these areas: • Project navigator • Script editor • Outline view •...
Page 290 Series 2600B System SourceMeter® instrument Reference Manual Section 8: 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 291 Section 8: Instrument programming Series 2600B 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 292 Series 2600B System SourceMeter® instrument Reference Manual Section 8: Instrument programming Simplify the display You can simplify the TSB Embedded display to show only the TSP Script Editor or only the instrument Console. The TSP Script Editor includes the list of User Scripts, the script entry area, and the script management buttons.
Page 293 Section 8: Instrument programming Series 2600B System SourceMeter® instrument Reference Manual Run a script Running a script executes the script on the instrument. To run a script: 1. Select a script from the User Scripts list. 2. Click Run Script. To stop a running script, select Abort.
Page 294 Series 2600B System SourceMeter® instrument Reference Manual Section 8: Instrument programming To import a script from the host computer: 1. Select Import from PC. 2. Choose Select File to select a file. You can also drag the file into the Select File box. 3.
Page 295 Section 8: Instrument programming Series 2600B System SourceMeter® instrument Reference Manual Send individual instrument commands with TSB Embedded You can send individual commands to the instrument using TSB Embedded. The response from the instrument appears in the Output box. To send commands from the console: 1.
Page 296 Series 2600B System SourceMeter® instrument Reference Manual Section 8: Instrument programming When you create a script using the script.new() function without providing a name, the script is added to the runtime environment as an unnamed script. The script.new() function returns the script, but the script is not added to the script.user.scripts table.
Page 297 Section 8: Instrument programming Series 2600B System SourceMeter® instrument Reference Manual 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. You can create a script with the script.new() function using the command: scriptVar = script.new(code, name) Where:...
Page 298 Series 2600B System SourceMeter® instrument Reference Manual Section 8: Instrument programming Create an unnamed script using script.new() Unnamed scripts are not available from the front-panel display of the instrument. Only the anonymous script and named scripts are available from the front-panel display. When you create a script using script.new(), if you do not include name, the script is added to the runtime environment as an unnamed script.
Page 299 Section 8: Instrument programming Series 2600B System SourceMeter® instrument Reference Manual In this example, you can access the new script by sending either of the following commands: beepTwoSec1200() script.user.scripts.beepTwoSec() To access the unnamed script, you can send the command: beepTwoSec() Figure 105: Create a new script with the name of an existing script Rename a script You can rename a script.
Page 300 Series 2600B System SourceMeter® instrument Reference Manual Section 8: Instrument programming Run the beep2sec script using the following command: script.user.scripts.beep2sec() 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.
Page 301 Section 8: Instrument programming Series 2600B 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 302 Series 2600B System SourceMeter® instrument Reference Manual Section 8: 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 303 Section 8: Instrument programming Series 2600B 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 304 Series 2600B System SourceMeter® instrument Reference Manual Section 8: 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 305 Section 8: Instrument programming Series 2600B System SourceMeter® instrument Reference Manual Combining two 2600B instruments to achieve greater currents in both source voltage and source current applications requires specific precautions, including configuration settings. Make sure that you adequately understand the risks involved and the measures needed to accommodate the combination of two 2600B instruments.
Page 306 Series 2600B System SourceMeter® instrument Reference Manual Section 8: Instrument programming TSP-Link nodes Each instrument (node) attached to the TSP-Link ® network must be identified by assigning it a unique TSP-Link node number. Commands for remote nodes are stored in the node table. An individual node is accessed as node[N], where N is the node number assigned to the node.
Page 307 Section 8: Instrument programming Series 2600B System SourceMeter® instrument Reference Manual Initialization Before you can use a TSP-Link ® system, it must be initialized. For initialization to succeed, each instrument in a TSP-Link system must be assigned a different node number. Assigning node numbers At the factory, each 2600B instrument is assigned as node 1.
Page 308 Series 2600B System SourceMeter® instrument Reference Manual Section 8: Instrument programming Front-panel operation ® To reset the TSP-Link network from the front panel: 1. Power on all instruments connected to the TSP-Link network. 2. Press the MENU key, select TSPLINK, and then press the ENTER key. 3.
Page 309 Section 8: Instrument programming Series 2600B System SourceMeter® instrument Reference Manual The variable localnode is an alias for node[N], where N is the node number of the node on which the code is running. For example, if node 1 is running the code, you can use localnode instead of node[1].
Page 310 Series 2600B System SourceMeter® instrument Reference Manual Section 8: Instrument programming Using the abort command An abort command terminates an executing script and returns all nodes to local operation (REM indicators turn off). This dissolves the master/subordinate relationships between nodes. To invoke an abort operation, either send an abort command to a specific node or press the EXIT (LOCAL) key on any node in the system.
Page 311 Section 8: Instrument programming Series 2600B System SourceMeter® instrument Reference Manual Figure 108: Multiple TSP-Link networks Another method you can use to run simultaneous test scripts is to use groups with a single TSP-Link network. Each group on the TSP-Link network can run a test while other groups are running different tests.
Page 312 Series 2600B System SourceMeter® instrument Reference Manual Section 8: Instrument programming Figure 109: Single TSP-Link network with groups The following table shows an example of the functions of a single TSP-Link network. Each group in this example runs a different test script than the other groups, which allows the system to run multiple tests simultaneously.
Page 313 Section 8: Instrument programming Series 2600B System SourceMeter® instrument Reference Manual 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 314 Series 2600B System SourceMeter® instrument Reference Manual Section 8: Instrument programming Running simultaneous test scripts You can send the execute() command from the master node to initiate a test script and Lua code on a remote node. The execute() command places the remote node in the overlapped operation state.
Page 315 Section 8: Instrument programming Series 2600B System SourceMeter® instrument Reference Manual The following code shows two examples of using the waitcomplete() command from the master node: -- Wait for each node in group N to complete all overlapped operations. waitcomplete(N) -- Wait for all groups on the TSP-Link network to complete overlapped operations.
Page 316 Series 2600B System SourceMeter® instrument Reference Manual Section 8: Instrument programming -- Add the source code from the script -- testScript to the data queue. node[2].dataqueue.add(testScript.source) -- Create a new script on the remote node -- using the source code from testScript. node[2].execute(testScript.name ..
Page 317 Section 8: Instrument programming Series 2600B System SourceMeter® instrument Reference Manual TSP-Net ® The TSP-Net library allows the 2600B to control LAN-enabled devices directly through its LAN port. ® This enables the 2600B to communicate directly with a device that is not TSP enabled without the use of a controlling computer.
Page 318 Series 2600B System SourceMeter® instrument Reference Manual Section 8: Instrument programming 2. Send the command: connectionID = tspnet.connect(ipAddress) Where: ▪ connectionID is the connection ID that is used as a handle in all other TSP-Net function calls. ▪ ipAddress is the IP address, entered as a string, of the remote instrument. tspnet.connect() (on page 9-399) for additional detail.
Page 319 Section 8: Instrument programming Series 2600B System SourceMeter® instrument Reference Manual -- Set tspnet timeout to 5 s. tspnet.timeout = 5 -- Establish connection to another device with IP address 192.168.1.51 -- at port 1394. id_instr = tspnet.connect("192.168.1.51", 1394, "*rst\r\n") -- Print the device ID from connect string.
Page 320 Series 2600B System SourceMeter® instrument Reference Manual Section 8: Instrument programming TSP-Net instrument commands: General device control The following instrument commands provide general device control: tspnet.clear() (on page 9-398) tspnet.connect() (on page 9-399) tspnet.disconnect() (on page 9-400) tspnet.execute() (on page 9-401) tspnet.idn() (on page 9-402) tspnet.read()
Page 321 Section 8: Instrument programming Series 2600B 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 322 Section 9 TSP command reference In this section: TSP command programming notes .......... 9-1 Using the TSP command reference ......... 9-3 TSP commands ................ 9-7 TSP command programming notes This section contains general information about using TSP commands. Placeholder text This manual uses italicized text to represent the parts of remote commands that must be replaced by user specified values.
Page 323 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual Example 3: smuX.trigger.measure.Y(rbuffer) Where: X refers to the source-measure unit (SMU) channel (use a for SMU A). Y is the measurement type that you specify (v, i, r, or p). rbuffer is the reading buffer object where the readings are stored.
Page 324 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference 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 325 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual Figure 111: 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 326 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference Command usage The Usage section of the remote command listing shows how to properly structure the command. Each line in the Usage section is a separate variation of the command usage. All possible command usage options are shown.
Page 327 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual Example section The Example section of the remote command description shows examples of how you can use the command. Figure 114: TSP example code Actual example code that you can copy from this table and paste into your own programming application.
Page 328 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference TSP commands The TSP commands available for the instrument are listed in alphabetical order. beeper.beep() This function generates an audible tone. Type TSP-Link accessible Affected by Where saved Default value Function Usage...
Page 329 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual 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 beeper.enable = beeper.ON beeper.beep(2, 2400)
Page 330 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference 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 Result of the logical OR operation value1 Operand for the logical OR operation...
Page 331 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual Example testResult = bit.bitxor(10, 9) print(testResult) Performs a logical XOR operation on decimal 10 (binary 1010) with decimal 9 (binary 1001), which returns a value of decimal 3 (binary 0011). Output: 3.00000e+00 Also see...
Page 332 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference bit.get() This function retrieves the weighted value of a bit at a specified index position. Type TSP-Link accessible Affected by Where saved Default value Function Usage result = bit.get(value, index) result Result of the bit manipulation value...
Page 333 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual 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 Result of the bit manipulation...
Page 334 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference bit.set() This function sets a bit at the specified index position. Type TSP-Link accessible Affected by Where saved Default value Function Usage result = bit.set(value, index) result Result of the bit manipulation value Specified number index...
Page 335 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual 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 Result of the bit manipulation value...
Page 336 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference 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...
Page 337 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual 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 Result of the bit manipulation value...
Page 338 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference bufferVar.appendmode This attribute sets the state of the append mode of the reading buffer. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Not applicable See Details 0 (disabled) Usage state = bufferVar.appendmode...
Page 339 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual bufferVar.basetimestamp This attribute contains the timestamp that indicates when the first reading was stored in the buffer. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Not applicable See Details Usage...
Page 340 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference bufferVar.cachemode This attribute enables or disables the reading buffer cache (on or off). Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Not applicable Not saved 1 (enabled) Usage cacheMode = bufferVar.cachemode...
Page 341 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual bufferVar.capacity This attribute sets the number of readings a buffer can store. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Not applicable See Details Not applicable Usage bufferCapacity = bufferVar.capacity bufferCapacity...
Page 342 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference bufferVar.clear() This function empties the buffer. Type TSP-Link accessible Affected by Where saved Default value Function Usage bufferVar.clear() bufferVar The reading buffer; can be a dynamically allocated user-defined buffer or a dedicated reading buffer Details This function clears all readings and related recall attributes from the buffer (for example,...
Page 343 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual To avoid this, you can include explicit calls to the bufferVar.clearcache() function to remove stale values from the reading buffer cache. Example smua.nvbuffer1.clearcache() Clears the reading buffer cache for dedicated reading buffer 1. Also see bufferVar.fillmode (on page 9-25)
Page 344 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference Also see bufferVar.clear() (on page 9-21) Reading buffers (on page 3-1) smuX.measure.overlappedY() (on page 9-229) smuX.measure.Y() (on page 9-233) smuX.nvbufferY (on page 9-235) smuX.trigger.measure.action (on page 9-264) smuX.trigger.measure.Y() (on page 9-268) bufferVar.collecttimestamps This attribute sets whether or not timestamp values are stored with the readings in the buffer.
Page 345 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual Also see bufferVar.clear() (on page 9-21) Reading buffers (on page 3-1) smuX.measure.overlappedY() (on page 9-229) smuX.measure.Y() (on page 9-233) smuX.nvbufferY (on page 9-235) smuX.trigger.measure.Y() (on page 9-268) bufferVar.fillcount This attribute sets the reading buffer fill count.
Page 346 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference bufferVar.fillmode This attribute sets the reading buffer fill mode. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Not applicable See Details 0 (smuX.FILL_ONCE) Usage fillMode = bufferVar.fillmode bufferVar.fillmode = fillMode fillMode The reading buffer fill mode;...
Page 347 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual Usage measurefunction = bufferVar.measurefunctions[N] measurefunction The measurement function used (Current, Voltage, Ohms, or Watts) to acquire reading number N in the specified buffer bufferVar The reading buffer; can be a dynamically allocated buffer (user-defined), or a dedicated reading buffer (such as smua.nvbuffer1) The reading number (1 to bufferVar.n) Details...
Page 348 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference Usage measurerange = bufferVar.measureranges[N] measurerange The measurement range used to acquire reading number N in the specified buffer bufferVar The reading buffer; can be a dynamically allocated buffer (user-defined), or a dedicated reading buffer (such as smua.nvbuffer1) The reading number (1 to bufferVar.n) Details...
Page 349 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual bufferVar.n This attribute contains the number of readings in the buffer. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Clearing the buffer See Details Not applicable Usage numberOfReadings = bufferVar.n numberOfReadings...
Page 350 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference bufferVar.readings This attribute contains the readings stored in a specified reading buffer. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Clearing the buffer See Details Not applicable Usage reading = bufferVar.readings[N]...
Page 351 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual bufferVar.sourcefunctions This attribute contains the source function that was being used when the readings were stored in a specified reading buffer. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Clearing the buffer...
Page 352 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference bufferVar.sourceoutputstates This attribute indicates the state of the source output for readings that are stored in a specified buffer. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Clearing the buffer See Details...
Page 353 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual Usage sourcerange = bufferVar.sourceranges[N] sourcerange The source range used to acquire reading number N in the specified buffer bufferVar The reading buffer; can be a dynamically allocated buffer (user-defined), or a dedicated reading buffer (such as smua.nvbuffer1) The reading number (1 to bufferVar.n) Details...
Page 354 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference Usage sourcevalue = bufferVar.sourcevalues[N] sourcevalue The output value of the source when reading N of the specified buffer was acquired bufferVar The reading buffer; can be a dynamically allocated buffer (user-defined) or a dedicated reading buffer (such as smua.nvbuffer1) The reading number (1 to bufferVar.n) Details...
Page 355 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual bufferVar.statuses This attribute contains the status values of readings in the reading buffer. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Clearing the buffer See Details Not applicable Usage statusInformation = bufferVar.statuses[N]...
Page 356 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference Example reset() Reset the instrument. smua.source.func = smua.OUTPUT_DCVOLTS Set the voltage source function to dc volts. smua.source.autorangev = smua.AUTORANGE_ON Set the range to auto. smua.source.levelv = 5 Set the voltage source to 5 V. smua.source.limiti = 10e-3 Set current measure limit to 10 mA.
Page 357 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual For dedicated reading buffers, all buffer attributes are saved to nonvolatile memory only when the reading buffer is saved to nonvolatile memory. Example smua.nvbuffer1.timestampresolution = 0.000008 Sets the timestamp resolution of dedicated reading buffer 1 to 8 μs.
Page 358 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference Also see bufferVar.clear() (on page 9-21) bufferVar.collecttimestamps (on page 9-23) bufferVar.measurefunctions (on page 9-25) bufferVar.measureranges (on page 9-26) bufferVar.n (on page 9-28) bufferVar.readings (on page 9-29) bufferVar.sourcefunctions (on page 9-30) bufferVar.sourceoutputstates (on page 9-31) bufferVar.sourceranges...
Page 359 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual sync_out Defines a digital I/O trigger output line; if programmed, the pulse train generates a trigger output immediately before the start of ton sync_in_timeout Specifies the length of time (in seconds) to wait for input trigger; default value is 10 s sync_in_abort Specifies whether or not to abort the pulse if an input trigger is not received;...
Page 360 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference ConfigPulseIMeasureVSweepLin() This KIPulse factory script function configures a linear pulsed current sweep with a voltage measurement at each point. Type TSP-Link accessible Affected by Where saved Default value Function Usage f, msg = ConfigPulseIMeasureVSweepLin(smu, bias, start, stop, limit, ton, toff,...
Page 361 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual The magnitude of the first pulse is start amperes; the magnitude of the last pulse is stop amperes. The magnitude of each pulse in between is step amperes larger than the previous pulse, where: step = (stop - start) / (points - 1) This function does not cause the specified smu to output a pulse train.
Page 362 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference ConfigPulseIMeasureVSweepLog() This KIPulse factory script (on page 7-22) function configures a voltage pulse train with a current measurement at each point. Type TSP-Link accessible Affected by Where saved Default value Function Usage...
Page 363 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual The magnitude of the first pulse is start amperes; the magnitude of the last pulse is stop amperes. The magnitude of each pulse in between is LogStep amperes larger than the previous pulse, where: LogStepSize = (log10(stop) - log10(start)) / (points -1) LogStepn = (n - 1) * (LogStepSize), where n = [2, points]...
Page 364 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference ConfigPulseVMeasureI() This KIPulse factory script function configures a voltage pulse train with a current measurement at each point. Type TSP-Link accessible Affected by Where saved Default value Function Usage f, msg = ConfigPulseVMeasureI(smu, bias, level, limit, ton, toff, points, buffer, tag, sync_in, sync_out, sync_in_timeout, sync_in_abort)
Page 365 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual Figure 119: ConfigPulseVMeasureI() Example 1 ConfigPulseVMeasureI(smua, 0, 20, 1, 0.001, 0.080, 10, smua.nvbuffer1, 2) Set up a pulse train that uses channel A. The pulse amplitude is 20 V and returns to 0 V after 1 ms. The pulse remains at 0 V for 80 ms, and the current limit is 1 A during the pulse.
Page 366 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference ConfigPulseVMeasureISweepLin() This KIPulse factory script function configures a voltage pulse train with a current measurement at each point. Type TSP-Link accessible Affected by Where saved Default value Function Usage f, msg = ConfigPulseVMeasureISweepLin(smu, bias, start, stop, limit, ton, toff, points, buffer, tag, sync_in, sync_out, sync_in_timeout, sync_in_abort)
Page 367 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual The magnitude of the first pulse is start volts; the magnitude of the last pulse is stop volts. The magnitude of each pulse in between is step volts larger than the previous pulse, where: step = (stop - start) / (points - 1) This function does not cause the specified smu to output a pulse train.
Page 368 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference ConfigPulseVMeasureISweepLog() This KIPulse factory script (on page 7-22) function configures a voltage pulse train with a current measurement at each point. Type TSP-Link accessible Affected by Where saved Default value Function Usage...
Page 369 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual LogStepSize = (log10(stop) - log10(start)) / (points -1) LogStep = (n - 1) * (LogStepSize), where n = [2, points] SourceStepLevel = antilog(LogStep ) * start This function does not cause the specified smu to output a pulse train. It does check to see if all the pulse dimensions can be achieved, and if they can, assigns the indicated tag or index to the pulse train.
Page 370 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference dataqueue.add() This function adds an entry to the data queue. Type TSP-Link accessible Affected by Where saved Default value Function Usage result = dataqueue.add(value) result = dataqueue.add(value, timeout) result The resulting value of true or false based on the success of the function value...
Page 371 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual dataqueue.CAPACITY This constant is the maximum number of entries that you can store in the data queue. Type TSP-Link accessible Affected by Where saved Default value Constant Usage count = dataqueue.CAPACITY count The variable that is assigned the value of dataqueue.CAPACITY...
Page 372 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference Example MaxCount = dataqueue.CAPACITY while dataqueue.count < MaxCount do dataqueue.add(1) print("There are " .. dataqueue.count .. " items in the data queue") dataqueue.clear() print("There are " .. dataqueue.count ..
Page 373 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual Example MaxCount = dataqueue.CAPACITY while dataqueue.count < MaxCount do dataqueue.add(1) print("There are " .. dataqueue.count .. " items in the data queue") dataqueue.clear() print("There are " .. dataqueue.count ..
Page 374 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference Example dataqueue.clear() for i = 1, 10 do dataqueue.add(i) print("There are " .. dataqueue.count .. " items in the data queue") while dataqueue.count > 0 do x = dataqueue.next() print(x) print("There are "...
Page 375 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual Example beeper.beep(0.5, 2400) delay(0.250) beeper.beep(0.5, 2400) Emit a double-beep at 2400 Hz. The sequence is 0.5 s on, 0.25 s off, 0.5 s on. Also see None digio.readbit() This function reads one digital I/O line.
Page 376 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference digio.readport() This function reads the digital I/O port. This command is not available on the 2604B, 2614B, or 2634B. Type TSP-Link accessible Affected by Where saved Default value Function Usage data = digio.readport()
Page 377 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual Also see digio.trigger[N].pulsewidth (on page 9-59) digio.trigger[N].clear() This function clears the trigger event on a digital I/O line. This command is not available on the 2604B, 2614B, or 2634B.
Page 378 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference Example digio.trigger[5].stimulus = digio.trigger[3].EVENT_ID Uses a trigger event on digital I/O trigger line 3 to be the stimulus for digital I/O trigger line 5. Also see None digio.trigger[N].mode This attribute sets the mode in which the trigger event detector and the output trigger generator operate on the given trigger line.
Page 379 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual When programmed to any mode except digio.TRIG_BYPASS, the output state of the I/O line is controlled by the trigger logic, and the user-specified output state of the line is ignored. Use of either digio.TRIG_SYNCHRONOUSA or digio.TRIG_SYNCHRONOUSM is preferred over digio.TRIG_SYNCHRONOUS, because digio.TRIG_SYNCHRONOUS is provided for compatibility with the digital I/O and TSP-Link triggering on older firmware.
Page 380 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference Also see digio.trigger[N].clear() (on page 9-56) digio.trigger[N].reset() (on page 9-60) digio.trigger[N].pulsewidth This attribute describes the length of time that the trigger line is asserted for output triggers. This command is not available on the 2604B, 2614B, or 2634B.
Page 381 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual Details Releases a trigger that was asserted with an indefinite pulsewidth time. It also releases a trigger that was latched in response to receiving a synchronous mode trigger. Only the specified trigger line is affected.
Page 382 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference Also see digio.trigger[N].mode (on page 9-57) digio.trigger[N].overrun (on page 9-58) digio.trigger[N].pulsewidth (on page 9-59) digio.trigger[N].stimulus (on page 9-61) digio.trigger[N].stimulus This attribute selects the event that causes a trigger to be asserted on the digital output line. This command is not available on the 2604B, 2614B, or 2634B.
Page 383 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual Trigger event IDs* Event ID Event description trigger.EVENT_ID Occurs when a *TRG command is received on the 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...
Page 384 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference for a trigger with this function, the event detector is automatically reset and ready to detect the next trigger. This is true regardless of the number of events detected. Example triggered = digio.trigger[4].wait(3) print(triggered)
Page 385 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual digio.writeport() This function writes to all digital I/O lines. This command is not available on the 2604B, 2614B, or 2634B. Type TSP-Link accessible Affected by Where saved Default value Function Usage digio.writeport(data)
Page 386 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference Details Bits that are set to one cause the corresponding line to be write-protected. The binary equivalent of mask indicates the mask to be set for the I/O port. For example, a mask value of 7 has a binary equivalent of 00000000000111.
Page 387 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual Annunciator (indicator) bitmasked values and equivalent constants Indicator Weighted Equivalent constant value display.ANNUNCIATOR_FILTER FILT display.ANNUNCIATOR_MATH MATH display.ANNUNCIATOR_4_WIRE display.ANNUNCIATOR_AUTO AUTO display.ANNUNCIATOR_ARM display.ANNUNCIATOR_TRIGGER TRIG display.ANNUNCIATOR_STAR * (asterisk) display.ANNUNCIATOR_SAMPLE SMPL display.ANNUNCIATOR_EDIT EDIT display.ANNUNCIATOR_ERROR display.ANNUNCIATOR_REMOTE...
Page 388 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference 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 389 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual display.getlastkey() This function retrieves the key code for the last pressed key. Type TSP-Link accessible Affected by Where saved Default value Function Usage keyCode = display.getlastkey() keyCode A returned value that represents the last front-panel key pressed; see Details for more information Details A history of the key code for the last pressed front-panel key is maintained by the instrument.
Page 390 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference You cannot use this function to track the OUTPUT ON/OFF controls for SMU A or SMU B. 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.
Page 391 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual Example 1 display.clear() display.setcursor(1, 1) display.settext("ABCDEFGHIJ$DKLMNOPQRST") display.setcursor(2, 1) display.settext("abcdefghijklm$Bnopqrstuvwxyz$F123456") print(display.gettext()) print(display.gettext(true)) print(display.gettext(false, 2)) print(display.gettext(true, 2, 9)) print(display.gettext(false, 2, 9, 10)) This example shows how to retrieve the display text in multiple ways. The output is: ABCDEFGHIJKLMNOPQRST$Nabcdefghijklmnopqrstuvwxyz123456 $RABCDEFGHIJ$DKLMNOPQRST$N$Rabcdefghijklm$Bnopqrstuvwxyz$F123456 abcdefghijklmnopqrstuvwxyz123456...
Page 392 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference Details The format parameter uses zeros (0), the decimal point, polarity sign, and exponents to define how the input field is formatted. The format parameter can include the options shown in the following table.
Page 393 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual display.loadmenu.add() This function adds an entry to the USER menu, which can be accessed by pressing the LOAD key on the front panel. Type TSP-Link accessible Affected by Where saved Default value Function...
Page 394 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference Example 2 display.loadmenu.add("Test", "DUT1() beeper.beep(2, 500)", display.SAVE) Assume a script with a function named “DUT1” is 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 395 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual Also see display.loadmenu.add() (on page 9-72) display.loadmenu.delete() (on page 9-74) display.loadmenu.delete() This function removes an entry from the USER menu, which can be accessed using the LOAD key on the front panel.
Page 396 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference Details Set display.locallockout to display.LOCK to prevent the user from interrupting remote operation by pressing the EXIT (LOCAL) key. Set this attribute to display.UNLOCK to allow the EXIT (LOCAL) key to interrupt script or remote operation.
Page 397 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual 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 398 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference Details This function creates an editable input field at the present cursor position, and an input prompt message on the bottom line. Example of a displayed input field and prompt: 0.00V Input 0 to +2V The format parameter uses zeros (0), the decimal point, polarity sign, and exponents to define how...
Page 399 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual display.screen This attribute contains the selected display screen. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Instrument reset Saved setup Models 2601B/2611B/2635B: Recall setup 0 (display.SMUA) Models 2602B/2604B/2612B/2614B/2634B/ 2636B:...
Page 400 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference display.sendkey() This function sends a code that simulates the action of a front-panel control. Type TSP-Link accessible Affected by Where saved Default value Function Usage display.sendkey(keyCode) keyCode A parameter that specifies the key press to simulate; see Details Details This command simulates pressing a front-panel key or navigation wheel, or turning the navigation wheel one click to the left or right.
Page 401 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual display.setcursor() This function sets the position of the cursor. Type TSP-Link accessible Affected by Where saved Default value Function Usage display.setcursor(row, column) display.setcursor(row, column, style) The row number for the cursor (1 or 2) column The active column position to set;...
Page 402 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference 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 Text message to be displayed, with optional character codes Details This function selects the user display screen and displays the given text.
Page 403 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual Also see display.clear() (on page 9-65) display.getcursor() (on page 9-67) display.gettext() (on page 9-69) display.screen (on page 9-78) display.setcursor() (on page 9-80) display.smuX.digits This attribute sets the front-panel display resolution of the selected measurement. Type TSP-Link accessible Affected by...
Page 404 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference Usage func = display.smuX.limit.func display.smuX.limit.func = func func One of the following values: ▪ 0 or display.LIMIT_IV: Displays the primary limit setting ▪ 1 or display.LIMIT_P: Displays the power limit setting Source-measure unit (SMU) channel (for example, display.smua.limit.func applies to SMU channel A) Details...
Page 405 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual Example display.smua.measure.func = display.MEASURE_DCAMPS Selects the current measure function for SMU A. Also see display.smuX.limit.func (on page 9-82) display.trigger.clear() This function clears the front-panel trigger event detector. Type TSP-Link accessible Affected by Where saved...
Page 406 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference display.trigger.overrun This attribute contains the event detector overrun status. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Display trigger clear Not saved false Instrument reset Recall setup Usage overrun = display.trigger.overrun...
Page 407 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual Example triggered = display.trigger.wait(5) Waits up to five seconds for the TRIG key to print(triggered) be pressed. If TRIG is pressed within five seconds, the output is true. If not, the output is false.
Page 408 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference The table below lists the keyCode values for each front panel action. Key codes Value Key (or action) Value Key (or action) display.KEY_RANGEUP display.KEY_MEASB display.KEY_MODEB display.KEY_DIGITSB display.KEY_RELB display.KEY_RECALL display.KEY_MENU display.KEY_MEASA display.KEY_MODEA...
Page 409 Section 9: TSP command reference Series 2600B 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 Error queue (on page 12-3) for additional information about the error queue. Also see errorqueue.count (on page 9-88)
Page 410 Series 2600B System SourceMeter® instrument Reference Manual Section 9: 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() errorCode The error code number for the entry...
Page 411 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual Also see Error queue (on page 12-3) errorqueue.clear() (on page 9-88) errorqueue.count (on page 9-88) Error summary list (on page 6-2) eventlog.all() This function returns all entries from the event log as a single string and removes them from the event log. Type TSP-Link accessible Affected by...
Page 412 Series 2600B System SourceMeter® instrument Reference Manual Section 9: 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 9-90)
Page 413 Section 9: TSP command reference Series 2600B 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 414 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference Details Returns the next entry from the event log and removes it from the log. If there are no entries in the event log, returns the value nil. Example 1 print(eventlog.next()) Get the oldest message in the event log and remove that entry from the log.
Page 415 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual Also see eventlog.all() (on page 9-90) eventlog.clear() (on page 9-91) eventlog.count (on page 9-91) eventlog.enable (on page 9-92) eventlog.next() (on page 9-92) exit() This function stops a script that is presently running. Type TSP-Link accessible Affected by...
Page 416 Series 2600B System SourceMeter® instrument Reference Manual Section 9: 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") print("\n*** fileVar:close") myfile, myfile_err, myfile_errnum = io.open(fileName, "w") myfile:write("Line 1") myfile:close() myfile, myfile_err, myfile_errnum = io.open(fileName, "r") myfile:close() os.remove(fileName) Opens file myfile.txt for writing.
Page 417 Section 9: TSP command reference Series 2600B 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.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") print(value) fileHandle:close()
Page 418 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference Details The format parameters may be any of the following: "*n": Returns a number. "*a": Returns the whole file, starting at the current position (returns an empty string if the current file position is at the end of the file).
Page 419 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual fileVar:seek() This function sets and gets the present position of a file. Type TSP-Link accessible Affected by Where saved Default value Function Usage position, errorMsg = fileVar:seek() position, errorMsg = fileVar:seek("whence") position, errorMsg = fileVar:seek("whence", offset) position The new file position, measured in bytes from the beginning of the file...
Page 420 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference Also see io.open() (on page 9-119) fileVar:write() This function writes data to a file. Type TSP-Link accessible Affected by Where saved Default value Function Usage fileVar:write(data) fileVar:write(data1, data2) fileVar:write(data1, ..., datan) fileVar The file descriptor variable...
Page 421 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual Also see fileVar:close() (on page 9-94) fileVar:flush() (on page 9-95) io.close() (on page 9-117) io.flush() (on page 9-118) io.open() (on page 9-119) format.asciiprecision This attribute sets the precision (number of digits) for all numbers returned in the ASCII format. Type TSP-Link accessible Affected by...
Page 422 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference format.byteorder This attribute sets the binary byte order for the 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...
Page 423 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual 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 424 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference fs.chdir() This function sets the current working directory. Type TSP-Link accessible Affected by Where saved Default value Function Usage workingDirectory = fs.chdir("path") workingDirectory Returned value containing the working path path A string indicating the new working directory path Details...
Page 425 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual Example if fs.is_dir("/usb1/temp") == true then fs.chdir("/usb1/temp") testPath = fs.cwd() print(testPath) else testPath = fs.cwd() print(testPath) Insert a USB flash drive into the front panel of the instrument. Verify that /usb1/temp is a directory and change it to be the current working directory.
Page 426 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference Also see fs.is_file() (on page 9-105) fs.is_file() Tests whether the specified path refers to a file (as opposed to a directory). Type TSP-Link accessible Affected by Where saved Default value Function Usage...
Page 427 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual Example if fs.is_dir("/usb1/temp") == false then fs.mkdir("/usb1/temp") Insert a USB flash drive into the front panel of the instrument. Check to see if the temp directory exists. If it does not exist, create a directory named temp. Also see fs.rmdir() (on page 9-107)
Page 428 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference fs.rmdir() This function removes a directory from the file system. Type TSP-Link accessible Affected by Where saved Default value Function Usage fs.rmdir("path") path The path of the directory to remove Details This path may be absolute or relative to the present working directory.
Page 429 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual Details See settimezone() for additional details about the time zone format and a description of the fields. timeZone can be in either of the following formats: ▪ If one parameter was used with settimezone(), the format used is: GMThh:mm:ss ▪...
Page 430 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference Example gm_array = gm_isweep(smua, 0, 0.01, 20) Source-measure unit (SMU) A returns G values only. gm_array, vbuf = gm_isweep(smua, 0, 0.01, 20) SMU A returns G and reading buffer with measured voltages.
Page 431 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual Also see gm_isweep() (on page 9-108) KIParlib factory script (on page 7-24) gpib.address This attribute contains the GPIB address. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Not applicable Nonvolatile memory...
Page 432 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference 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(smuX, levelv, limiti, sourcedelay, measurei, measuredelay) imeas The measured current Instrument channel (for example, smua refers to SMU channel A)
Page 433 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual Also see i_leakage_threshold() (on page 9-112) High-capacitance mode (on page 2-69) KIHighC factory script (on page 7-24) 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 434 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference 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 435 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual Example smua.reset() smua.source.rangev = 5 smua.source.rangei = 1 smua.source.levelv = 0 smua.measure.rangev = 5 smua.measure.rangei = 1 smua.measure.nplc = 0.01 smua.measure.autozero = smua.AUTOZERO_ONCE smua.nvbuffer1.clear() smua.nvbuffer1.appendmode = 1 smua.source.output = smua.OUTPUT_ON f1, msg1 = ConfigPulseVMeasureI(smua, 0, 5, 1, 0.002, 0.2, 10, smua.nvbuffer1, 1) if f1 == true then f2, msg2 = InitiatePulseTest(1)
Page 436 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference InitiatePulseTestDual() (on page 7-22) function initiates the pulse configuration assigned tag1 and tag2. This KIPulse factory script Type TSP-Link accessible Affected by Where saved Default value Function Usage f, msg = InitiatePulseTestDual(tag1, tag2) A Boolean flag;...
Page 437 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual Example smua.reset() smua.source.rangev = 5 smua.source.rangei = 1 smua.source.levelv = 0 smua.measure.rangev = 5 smua.measure.rangei = 1 smua.measure.nplc = 0.01 smua.measure.autozero = smua.AUTOZERO_ONCE smua.nvbuffer1.clear() smua.nvbuffer1.appendmode = 1 smua.source.output = smua.OUTPUT_ON smub.reset() smub.source.func = smub.OUTPUT_DCAMPS smub.source.rangei = 1...
Page 438 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference Also see ConfigPulseIMeasureV() (on page 9-37) ConfigPulseIMeasureVSweepLin() (on page 9-39) ConfigPulseIMeasureVSweepLog() (on page 9-41) ConfigPulseVMeasureI() (on page 9-43) ConfigPulseVMeasureISweepLin() (on page 9-45) ConfigPulseVMeasureISweepLog() (on page 9-47) io.close() This function closes a file. Type TSP-Link accessible Affected by...
Page 439 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual io.flush() This function saves buffered data to a file. Type TSP-Link accessible Affected by Where saved Default value Function Usage io.flush() Details You must use the io.flush() or io.close() functions to write data to the file system. Data is not automatically written to a file when you use the io.write() function.
Page 440 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference Details The newfile path may be absolute or relative to the current working directory. ® When using this function from a remote TSP-Link node, this command does not accept a file descriptor and does not return a value.
Page 441 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual io.output() This function assigns a previously opened file or opens a new file as the default output file. Type TSP-Link accessible Affected by Where saved Default value Function Yes (see Details) Usage fileVar = io.output()
Page 442 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference 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() data1 = io.read("format1") data1, data2 = io.read("format1", "format2") data1, ..., dataN = io.read("format1", ..., "formatN") data1 The data read from the file...
Page 443 Section 9: TSP command reference Series 2600B 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() -- 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 444 Series 2600B System SourceMeter® instrument Reference Manual Section 9: 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() 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 445 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual Details All data parameters must be either strings or numbers. 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 446 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference lan.applysettings() This function re-initializes the LAN interface with new settings. Type TSP-Link accessible Affected by Where saved Default value Function Usage lan.applysettings() Details Disconnects all existing LAN connections to the instrument and re-initializes the LAN with the present configuration settings.
Page 447 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual Details This attribute sets the LAN link monitoring and automatic connection state. When this is set to lan.ENABLE, all connections are closed if the link to the LAN is lost for more than the time specified by lan.linktimeout.
Page 448 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference Also see lan.config.dns.domain (on page 9-127) lan.config.dns.dynamic (on page 9-128) lan.config.dns.hostname (on page 9-128) lan.config.dns.verify (on page 9-129) lan.restoredefaults() (on page 9-136) lan.config.dns.domain Configures the dynamic DNS domain. Type TSP-Link accessible Affected by...
Page 449 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual lan.config.dns.dynamic Enables or disables the dynamic DNS registration. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) LAN restore defaults Nonvolatile memory 1 (lan.ENABLE) Usage state = lan.config.dns.dynamic lan.config.dns.dynamic = state state The dynamic DNS registration state.
Page 450 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference Details This attribute holds the host name to request during dynamic DNS registration. Dynamic DNS registration works with DHCP to register the host name specified in this attribute with the DNS server. The factory default value for hostName is "k-<model number>-<serial number>", where <model number>...
Page 451 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual Also see lan.config.dns.hostname (on page 9-128) lan.restoredefaults() (on page 9-136) lan.config.duplex This attribute defines the LAN duplex mode. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) LAN restore defaults Nonvolatile memory 1 (lan.FULL)
Page 452 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference The IP address must be formatted in four groups of numbers, each separated by a decimal. Example print(lan.config.gateway) Outputs the default gateway address. For example, you might see the output: 192.168.0.1 Also see lan.restoredefaults()
Page 453 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual lan.config.method This attribute contains the LAN settings configuration method. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) LAN restore defaults Nonvolatile memory 0 (lan.AUTO) Usage method = lan.config.method lan.config.method = method method...
Page 454 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference Details This attribute stores the speed that is used if the LAN is restarted for manual configuration operation. This attribute does not indicate the actual setting presently in effect. Use the lan.status.speed attribute to determine the present operating state of the LAN.
Page 455 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual lan.linktimeout This attribute contains the LAN link timeout period. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) LAN restore defaults Nonvolatile memory 20 (20 s) Usage timeout = lan.linktimeout lan.linktimeout = timeout...
Page 456 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference Example print(lan.lxidomain) Displays the LXI domain. Also see None lan.nagle This attribute controls the state of the LAN Nagle algorithm. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Power cycle Not saved...
Page 457 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual lan.restoredefaults() This function resets LAN settings to default values. Type TSP-Link accessible Affected by Where saved Default value Function Usage lan.restoredefaults() Details The settings that are restored are shown in the following table. Settings that are restored to default Attribute Default setting...
Page 458 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference 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] dnsAddress DNS server IP address Entry index (1, 2, or 3)
Page 459 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual Details A fully qualified domain name (FQDN) specifies its exact location in the tree hierarchy of the Domain Name System (DNS). A FQDN is the complete domain name for a specific computer or host on the LAN. The FQDN consists of two parts: The host name and the domain name.
Page 460 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference 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 461 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual 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 macAddress The instrument MAC address Details...
Page 462 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference 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 port...
Page 463 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual 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 port LAN VXI-11 port number...
Page 464 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference 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 465 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual 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 466 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference 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 467 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual 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 connected The LAN event connection state: ▪...
Page 468 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference 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 9-147) lan.trigger[N].protocol...
Page 469 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual 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 lan.trigger[3].protocol = lan.TCP lan.trigger[3].ipaddress = "192.168.1.100"...
Page 470 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference 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 instead of lan.TRIG_SYNCHRONOUS is preferred. Use of lan.TRIG_SYNCHRONOUS is provided for compatibility with older products and other Keithley Instruments products.
Page 471 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual lan.trigger[N].protocol This attribute sets the LAN protocol to use for sending trigger messages. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Instrument reset Not saved 0 (lan.TCP) LAN trigger N reset Recall setup...
Page 472 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference 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 print(lan.trigger[1].pseudostate) Get the present simulated line state for the LAN event 1.
Page 473 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual Trigger event IDs* Event ID Event description trigger.EVENT_ID Occurs when a *TRG command is received on the remote interface GPIB only: Occurs when a GET bus command is received USB only: Occurs when a USBTMC TRIGGER message is received...
Page 474 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference 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 475 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual 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 476 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference Example print(localnode.license) Returns the license agreements for the 2600B. Also see None localnode.linefreq This attribute contains the power line frequency setting that is used for NPLC calculations. Type TSP-Link accessible Affected by Where saved...
Page 477 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual localnode.model This attribute stores the model number. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Not applicable Not applicable Not applicable Usage model = localnode.model model The model number of the instrument Example...
Page 478 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference Example localnode.password = "N3wpa55w0rd" Changes the remote interface password to N3wpa55w0rd. Also see lan.reset() (on page 9-135) localnode.passwordmode (on page 9-157) localnode.passwordmode This attribute stores the password enable mode for remote access to the instrument. Type TSP-Link accessible Affected by...
Page 479 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual localnode.prompts This attribute determines if the instrument generates prompts in response to command messages. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Power cycle Not saved 0 (disabled) Usage prompting = localnode.prompts...
Page 480 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference Example localnode.prompts = 1 Enable prompting. Also see localnode.showerrors (on page 9-162) tsplink.reset() (on page 9-386) localnode.prompts4882 This attribute enables and disables the generation of prompts for IEEE Std 488.2 common commands. Type TSP-Link accessible Affected by...
Page 481 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual localnode.reset() This function resets the local node instrument. Type TSP-Link accessible Affected by Where saved Default value Function Usage localnode.reset() Details If you want to reset a specific instrument or a subordinate node, use the node[X].reset() command.
Page 482 Series 2600B System SourceMeter® instrument Reference Manual Section 9: 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 revision Firmware revision level Details...
Page 483 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual Details This indicates the instrument serial number. Example display.clear() display.settext(localnode.serialno) Clears the instrument display. Places the serial number of the instrument on the top line of its display. Also see localnode.description (on page 9-154)
Page 484 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference makegetter() This function creates a function to get the value of an attribute. Type TSP-Link accessible Affected by Where saved Default value Function Usage getter = makegetter(table, "attributeName") getter The return value table...
Page 485 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual makesetter() This function creates a function that, when called, sets the value of an attribute. Type TSP-Link accessible Affected by Where saved Default value Function Usage setter = makesetter(table, "attributeName") setter Function that sets the value of the attribute table...
Page 486 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference Details This function returns two values: • The amount of free dynamically allocated memory available in kilobytes • The total amount of dynamically allocated memory on the instrument in kilobytes The difference between the two values is the amount presently used.
Page 487 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual Example 3 node[32].execute(TestDut.source) Runs the test script stored in the variable TestDut (previously stored on the master node) on node 32. Also see TSP advanced features (on page 8-89) tsplink.group (on page 9-383) node[N].getglobal()
Page 488 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference node[N].setglobal() This function sets the value of a global variable. This command is not available on the 2604B, 2614B, or 2634B. Type TSP-Link accessible Affected by Where saved Default value Function Usage...
Page 489 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual Example opc() waitcomplete() print("1") Output: Also see Status model (on page 12-1) waitcomplete() (on page 9-415) os.remove() This function deletes the file or directory with a given name. Type TSP-Link accessible Affected by...
Page 490 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference Details If this function fails, it returns nil (for success) and an error message string (for msg). Example os.rename("testFile", "exampleFile") Changes the name of the existing file testFile to the name exampleFile. Also see os.remove() (on page 9-168)
Page 491 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual 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) value1 The first argument to output value2 The second argument to output valueN...
Page 492 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference printbuffer() This function prints data from tables or reading buffer subtables. Type TSP-Link accessible Affected by Where saved Default value Function Usage printbuffer(startIndex, endIndex, bufferVar) printbuffer(startIndex, endIndex, bufferVar, bufferVar2) printbuffer(startIndex, endIndex, bufferVar, ..., bufferVarN) startIndex Beginning index of the buffer to print;...
Page 493 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual Also see bufferVar.n (on page 9-28) bufferVar.readings (on page 9-29) format.asciiprecision (on page 9-100) format.byteorder (on page 9-101) format.data (on page 9-102) printnumber() (on page 9-172) printnumber() This function prints numbers using the configured format. Type TSP-Link accessible Affected by...
Page 494 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference Also see format.asciiprecision (on page 9-100) format.byteorder (on page 9-101) format.data (on page 9-102) print() (on page 9-170) printbuffer() (on page 9-171) PulseIMeasureV() This KIPulse factory script function performs a specified number of pulse I, measure V cycles. Type TSP-Link accessible Affected by...
Page 495 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual Example PulseIMeasureV(smua, 0.001, 1.0, SMU A outputs 1 mA and dwells for 40 ms, outputs 20e-3, 40e-3, 10) 1 A and dwells for 20 ms. The voltage measurements occur during each 20 ms dwell period.
Page 496 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference Example smua.measure.nplc = 0.001 SMU A outputs −1 V and dwells for 2 ms, PulseVMeasureI(smua, -1, 1, 1E-3, 2E-3, 20) outputs 1 V and dwells for 1 ms. The current measurements occur during each 1 ms dwell period.
Page 497 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual Example smua.reset() Configure channel A to generate a pulse train, query configuration, and then display as a string. smua.source.rangev = 5 Channel A pulses voltage from a bias level of 0 V smua.source.rangei = 1 to a pulse level of 5 V.
Page 498 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference reset() This function resets commands to their default settings. Type TSP-Link accessible Affected by Where saved Default value Function Usage reset() reset(system) system What to reset: ▪ true: If the node is the master, the entire system is reset (default) ▪...
Page 499 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual Details Use this function to save the specified buffer to a USB flash drive. This function only saves to a USB flash drive. You are not required to qualify the path to the USB flash drive, but you can add /usb1/ before the fileName (see Example 2).
Page 500 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference Also see Anonymous scripts (on page 8-4) scriptVar.autorun (on page 9-184) scriptVar.list() (on page 9-185) scriptVar.name (on page 9-186) scriptVar.run() (on page 9-187) scriptVar.save() (on page 9-188) scriptVar.source (on page 9-189) script.delete() This function deletes a script from nonvolatile memory.
Page 501 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual Example for name in script.factory.catalog() do Retrieve the catalog listing for factory scripts. print(name) Also see None script.load() This function creates a script from a specified file. Type TSP-Link accessible Affected by Where saved...
Page 502 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference script.new() This function creates a script. Type TSP-Link accessible Affected by Where saved Default value Function Usage scriptVar = script.new("code") scriptVar = script.new("code", "name") scriptVar The name of the variable that references the script code A string containing the body of the script name...
Page 503 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual 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") scriptVar The name of the variable that references the script code A string that contains the body of the script...
Page 504 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference 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) name The name of the script to be restored Details This command copies the script from nonvolatile memory into the runtime environment.
Page 505 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual script.user.catalog() This function returns an iterator that can be used in a for loop to iterate over all the scripts stored in nonvolatile memory. Type TSP-Link accessible Affected by Where saved Default value Function...
Page 506 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference 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 507 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual Example test7 = script.new("display.clear() display.settext('Hello from my test')", "test7") test7() test7.save() test7.list() The above example code creates a script named test7 that displays text on the front panel and lists the script with the following output: loadscript test7 display.clear() display.settext("Hello from my test")
Page 508 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference Example test7 = script.new("display.clear() display.settext('Hello from my test')", "") test7() print(test7.name) test7.name = "test7" print(test7.name) test7.save() This example calls the script.new() function to create a script with no name, runs the script, names the script test7, and then saves the script in nonvolatile memory.
Page 509 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual scriptVar.save() This function saves the script to nonvolatile memory or to a USB flash drive. Type TSP-Link accessible Affected by Where saved Default value Function Usage scriptVar.save() scriptVar.save("filename") scriptVar The name of variable that references the script filename...
Page 510 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference scriptVar.source This attribute contains the source code of a script. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Not applicable Not saved Not applicable (see Details) Usage code = scriptVar.source scriptVar.source = nil...
Page 511 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual Details A new baud rate 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 512 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference Also see RS-232 interface operation (on page 8-60) serial.baud (on page 9-189) serial.flowcontrol (on page 9-191) serial.parity (on page 9-192) serial.flowcontrol This attribute configures flow control for the RS-232 port. Type TSP-Link accessible Affected by...
Page 513 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual serial.parity This attribute configures parity for the RS-232 port. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Not applicable Nonvolatile memory "none" (serial.PARITY_NONE) Usage parity = serial.parity serial.parity = parity parity Set parity to one of the following values:...
Page 514 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference serial.read() This function reads available characters (data) from the serial port. Type TSP-Link accessible Affected by Where saved Default value Function Usage data = serial.read(maxchars) data A string that consists of all data read from the serial port maxchars An integer that specifies the maximum number of characters to read Details...
Page 515 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual Details This function writes the specified string to the serial port, where it can be read by connected equipment (for example, a component handler). No terminator characters are added to the data, and data is written exactly as specified by the data parameter.
Page 516 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference settimezone() This function sets the local time zone. Type TSP-Link accessible Affected by Where saved Default value Function Usage settimezone(offset) settimezone("offset", "dstOffset", "dstStart", "dstEnd") offset String representing offset from UTC dstOffset String representing the daylight savings offset from UTC dstStart...
Page 517 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual Example settimezone("8", "1", "3.3.0/02", "11.2.0/02") settimezone(offset) Sets offset to equal +8 hours, +1 hour for DST, starts on Mar 14 at 2:00 am, ends on Nov 7 at 2:00 am. Sets local time zone to offset.
Page 518 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference setup.recall() This function recalls settings from a saved setup. Type TSP-Link accessible Affected by Where saved Default value Function Usage setup.recall(id) An integer or string that specifies the location of the setup to recall: ▪...
Page 519 Section 9: TSP command reference Series 2600B 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 520 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference smuX.abort() This function terminates all overlapped operations on the specified source-measure unit (SMU). Type TSP-Link accessible Affected by Where saved Default value Function Usage smuX.abort() Source-measure unit (SMU) channel (for example, smua.abort() applies to SMU channel A) Details The smuX.abort() function does not turn the output off or change any settings.
Page 521 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual The statistics parameter has the attributes described in the following table. Attribute When returned Description Always The number of data points on which the statistics are based mean When n >...
Page 522 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference smuX.buffer.recalculatestats() This function recalculates the statistics of the specified reading buffer. Type TSP-Link accessible Affected by Where saved Default value Function Usage smuX.buffer.recalculatestats(bufferVar) Source-measure unit (SMU) channel (for example, smua.buffer.recalculatestats() specifies SMU channel A) bufferVar The reading buffer to process...
Page 523 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual Details This attribute stores the adjustment date associated with the active calibration set. The adjustment date can be read at any time but can only be assigned a new value when calibration has been enabled with the smuX.cal.unlock() function.
Page 524 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference Details This attribute stores the calibration date that is associated with the active calibration set. The calibration date can be read at any time but can only be assigned a new value when calibration has been enabled with the smuX.cal.unlock() function.
Page 525 Section 9: TSP command reference Series 2600B 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 due date stored with that set. smuX.cal.due must be set to the date the next calibration is required using the UTC time and date. The date is stored as the number of seconds since UTC 12:00 am Jan 1, 1970.
Page 526 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference smuX.cal.password This attribute stores the password required to enable calibration. Type TSP-Link accessible Affected by Where saved Default value Attribute (W) Not applicable SMU nonvolatile memory "KI0026XX" Usage smuX.cal.password = "newPassword"...
Page 527 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual This attribute does not affect the smuX.measure.calibrateY() command. The polarity for smuX.measure.calibrateY() is dictated by the range parameter that is defined for it. The measurement calibration commands require the measurements provided to have been made using the polarity being calibrated.
Page 528 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference Details This function overwrites the present set of calibration constants with constants read from nonvolatile memory. This function is disabled until a successful call to smuX.cal.unlock() is made. If calset is not specified, smuX.CALSET_DEFAULT is used.
Page 529 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual smuX.cal.state This attribute returns the present calibration state. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Not applicable Not saved Not applicable Usage calState = smuX.cal.state calState The present calibration state;...
Page 530 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference smuX.cal.unlock() This function enables the commands that change calibration settings. Type TSP-Link accessible Affected by Where saved Default value Function Usage smuX.cal.unlock(password) Source-measure unit (SMU) channel (for example, smua.cal.unlock() applies to SMU channel A) password Calibration password...
Page 531 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual Details Contact check measurement calibration 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 calibration set that is active.
Page 532 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference smuX.contact.calibratelo() This function adjusts the low/sense low contact check measurement. This command is not available on the 2604B, 2614B, or 2634B. Type TSP-Link accessible Affected by Where saved Default value Function Usage...
Page 533 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual Also see Adjustment (on page 10-15) smuX.cal.restore() (on page 9-206) smuX.cal.save() (on page 9-207) smuX.cal.unlock() (on page 9-209) smuX.contact.calibratehi() (on page 9-209) smuX.contact.check() This function determines if contact resistance is lower than the threshold. This command is not available on the 2604B, 2614B, or 2634B.
Page 534 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference Also see Contact check measurements (on page 2-22) smuX.contact.speed (on page 9-214) smuX.contact.threshold (on page 9-215) smuX.source.offfunc (on page 9-246) smuX.contact.r() This function measures aggregate contact resistance. This command is not available on the 2604B, 2614B, or 2634B.
Page 535 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual smuX.contact.speed This attribute stores the speed setting for contact check measurements. This command is not available on the 2604B, 2614B, or 2634B. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Instrument reset...
Page 536 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference smuX.contact.threshold This attribute stores the resistance threshold for the smuX.contact.check() function. This command is not available on the 2604B, 2614B, or 2634B. Type TSP-Link accessible Affected by Where saved Default value 50 (50 Ω) Attribute (RW)
Page 537 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual To delete a reading buffer, set all references to the reading buffer equal to nil, then run the garbage collector (see the collectgarbage() function in Standard libraries (on page 8-29)). Example mybuffer2 = smua.makebuffer(200) Creates a 200 element reading buffer (mybuffer2) for SMU...
Page 538 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference smuX.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 (smuX.AUTORANGE_ON) SMU reset Recall setup Usage autoRange = smuX.measure.autorangeY smuX.measure.autorangeY = autoRange...
Page 539 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual smuX.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 (smuX.AUTOZERO_AUTO)
Page 540 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference Also see Autozero (on page 2-8) reset() (on page 9-177) setup.recall() (on page 9-197) smuX.measure.nplc (on page 9-228) smuX.reset() (on page 9-236) smuX.measure.calibrateY() This function generates and activates new measurement calibration constants. Type TSP-Link accessible Affected by...
Page 541 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual Example smua.measure.calibratev(1, 1e-4, 1e-5, 0.92, 0.903) Adjust SMU channel A voltage measurement using the following values: ▪ 1 V calibration range ▪ 1e−4 for +zero measurement reading ▪ 1e−5 for +zero DMM measurement reading ▪...
Page 542 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference Also see reset() (on page 9-177) setup.recall() (on page 9-197) smuX.measure.delay (on page 9-221) smuX.measure.interval (on page 9-226) smuX.measure.overlappedY() (on page 9-229) smuX.measure.Y() (on page 9-233) smuX.reset() (on page 9-236) smuX.measure.delay This attribute controls the measurement delay.
Page 543 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual Also see Measure auto delay (on page 2-45) reset() (on page 9-177) smuX.measure.count (on page 9-220) smuX.measure.delayfactor (on page 9-222) smuX.source.delay (on page 9-241) smuX.reset() (on page 9-236) smuX.measure.delayfactor This attribute stores a multiplier to the delays that are used when smuX.measure.delay is set to smuX.DELAY_AUTO.
Page 544 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference smuX.measure.filter.count This command sets the number of measured readings that are required to yield one filtered measurement. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Instrument reset Saved setup SMU reset...
Page 545 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual smuX.measure.filter.enable This command enables or disables filtered measurements. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Instrument reset Saved setup 0 (smuX.FILTER_OFF) SMU reset Recall setup Usage filterState = smuX.measure.filter.enable smuX.measure.filter.enable = filterState...
Page 546 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference smuX.measure.filter.type This command sets the type of filter used for measurements when the measurement filter is enabled. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Instrument reset Saved setup 1 (smuX.FILTER_REPEAT_AVG)
Page 547 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual smuX.measure.highcrangedelayfactor This attribute contains a delay multiplier that is only used during range changes when the high-capacitance mode is active. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Instrument reset Saved setup...
Page 548 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference Details This attribute sets the time interval between measurements when smuX.measure.count is set to a value greater than 1. The SMU attempts to start each measurement when scheduled. If the SMU cannot keep up with the interval setting, measurements are made as quickly as possible.
Page 549 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual Example smua.measure.lowrangev = 1 Sets voltage low range for SMU channel A to 1 V. Also see Range (on page 2-44) reset() (on page 9-177) setup.recall() (on page 9-197) smuX.measure.autorangeY (on page 9-217) smuX.reset()
Page 550 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference smuX.measure.overlappedY() This function starts an asynchronous (background) measurement. Type TSP-Link accessible Affected by Where saved Default value Function Usage smuX.measure.overlappedY(rbuffer) smuX.measure.overlappediv(ibuffer, vbuffer) Source-measure unit (SMU) channel (for example, smua.measure.overlappedv() applies to SMU channel A) SMU measurement type (v = voltage, i = current, r = resistance, p = power) rbuffer...
Page 551 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual smuX.measure.rangeY This attribute contains the positive full-scale value of the measurement range for voltage or current. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Instrument reset Saved setup Voltage: SMU reset...
Page 552 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference Example smua.measure.rangev = 0.5 Selects the 1 V measurement range for SMU channel A. Also see Range (on page 2-44) reset() (on page 9-177) setup.recall() (on page 9-197) smuX.measure.autorangeY (on page 9-217) smuX.reset()
Page 553 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual smuX.measure.rel.levelY This attribute sets the offset value for relative measurements. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Instrument reset Not saved SMU reset Recall setup Usage relValue = smuX.measure.rel.levelY smuX.measure.rel.levelY = relValue...
Page 554 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference smuX.measure.Y() This function makes one or more measurements. Type TSP-Link accessible Affected by Where saved Default value Function Usage reading = smuX.measure.Y() reading = smuX.measure.Y(readingBuffer) iReading, vReading = smuX.measure.iv() iReading, vReading = smuX.measure.iv(iReadingBuffer) iReading, vReading = smuX.measure.iv(iReadingBuffer, vReadingBuffer) reading...
Page 555 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual Example smua.measure.count = 10 Makes 10 voltage measurements using SMU channel A and smua.measure.v(smua.nvbuffer1) stores them in a buffer. Also see Reading buffers (on page 3-1) smuX.measure.count (on page 9-220) smuX.measure.overlappedY() (on page 9-229) smuX.nvbufferY...
Page 556 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference Example local ivalues = {} This use of the SMU channel A smua.source.rangev = 1 measure and step function measures smua.source.levelv = 0 current starting at a source value of 0 V.
Page 557 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual Also see Configuring and running sweeps (on page 2-60) Reading buffers (on page 3-1) savebuffer() (on page 9-177) smuX.makebuffer() (on page 9-215) smuX.measure.overlappedY() (on page 9-229) smuX.savebuffer() (on page 9-236) smuX.trigger.measure.action (on page 9-264) smuX.trigger.measure.set()
Page 558 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference Details When the instrument is turned off and back on, the dedicated reading buffers are restored from nonvolatile memory to their last saved values. Example smua.savebuffer(smua.nvbuffer1) Saves buffer 1 (SMU channel A) to internal memory. Also see Reading buffers (on page 3-1)
Page 559 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual smuX.source.autorangeY This attribute contains the state of the source autorange control (on/off). Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) SMU reset Saved setup 1 (smuX.AUTORANGE_ON) Instrument reset Recall setup Usage...
Page 560 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference smuX.source.calibrateY() This function generates and activates new source calibration constants. Type TSP-Link accessible Affected by Where saved Default value Function Usage smuX.source.calibrateY(range, cp1Expected, cp1Reference, cp2Expected, cp2Reference) Source-measure unit (SMU) channel (for example, smua.source.calibratev() applies to SMU channel A) SMU source function (v = voltage, i = current) range...
Page 561 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual smuX.source.compliance This attribute contains the state of source compliance. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Not applicable Not saved Not applicable Usage compliance = smuX.source.compliance compliance The state of source compliance: ▪...
Page 562 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference smuX.source.delay This attribute contains the source delay. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) SMU reset Not saved 0 (smuX.DELAY_OFF) Instrument reset Recall setup Usage sDelay = smuX.source.delay smuX.source.delay = sDelay...
Page 563 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual smuX.source.func This attribute contains the source function, which can be voltage or current. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) SMU reset Saved setup 1 (smuX.OUTPUT_DCVOLTS) Instrument reset Recall setup...
Page 564 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference Details When enabled, the high-capacitance mode has the following effects on the SMU settings: • smuX.measure.autorangei is set to smuX.AUTORANGE_FOLLOW_LIMIT and cannot be changed • Current ranges below 1 µA are not accessible •...
Page 565 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual If the source is configured as a current source and the output is on, the new smuX.source.leveli setting is sourced immediately. If the output is off or the source is configured as a voltage source, the current level is sourced when the source is configured as a current source and the output is turned on.
Page 566 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference Details Use the smuX.source.limiti attribute to limit the current output of the voltage source. Use smuX.source.limitv to limit the voltage output of the current source. The SMU always uses autoranging for the limit setting.
Page 567 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual Details This attribute is used with source autoranging to put a lower bound on the range that is used. Lower ranges generally require greater settling times. If you set a low range value, you might be able to source small values with less settling time.
Page 568 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference Also see Output-off states (on page 2-40) smuX.source.offlimitY (on page 9-247) smuX.source.offmode (on page 9-248) smuX.source.output (on page 9-249) smuX.source.offlimitY This attribute sets the limit (current or voltage) used when the source-measure unit (SMU) is in normal output-off mode.
Page 569 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual smuX.source.offmode This attribute sets the source output-off mode. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) SMU reset Saved setup 0 (smuX.OUTPUT_NORMAL) Instrument reset Recall setup Usage sourceOffMode = smuX.source.offmode smuX.source.offmode = sourceOffMode...
Page 570 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference smuX.source.output This attribute enables or disables the source output. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) SMU reset Not saved 0 (smuX.OUTPUT_OFF) Instrument reset Recall setup Usage sourceOutput = smuX.source.output...
Page 571 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual Usage outputAction = smuX.source.outputenableaction smuX.source.outputenableaction = outputAction outputAction The output enable action of the source; set to one of the following values: ▪ 0 or smuX.OE_NONE: No action ▪...
Page 572 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference Example smua.source.outputenableaction = smua.OE_OUTPUT_OFF Sets SMU channel A to turn off the output if the output enable line goes low (deasserted). Also see smuX.source.offmode (on page 9-248) smuX.source.output (on page 9-249) smuX.source.rangeY This attribute contains the source range.
Page 573 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual Also see Range (on page 2-44) reset() (on page 9-177) setup.recall() (on page 9-197) smuX.measure.rangeY (on page 9-230) smuX.reset() (on page 9-236) smuX.source.autorangeY (on page 9-238) smuX.source.settling This attribute contains the source settling mode. Type TSP-Link accessible Affected by...
Page 574 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference Also see Range (on page 2-44) smuX.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 (smuX.DISABLE) Instrument reset...
Page 575 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual Details During a sweep, the SMU iterates through the arm layer of the trigger model this many times. After performing this many iterations, the SMU returns to an idle state. If this count is set to zero, the SMU stays in the trigger model indefinitely until aborted.
Page 576 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference smuX.trigger.arm.stimulus This attribute selects the event that causes 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 577 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual Trigger event IDs* Event ID Event description * Use the name of the trigger event ID to set the stimulus value rather than the numeric value. Using the name makes the code compatible for future upgrades (for example, if the numeric values must change when enhancements are added to the instrument).
Page 578 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference smuX.trigger.autoclear This attribute turns automatic clearing of the event detectors on or off. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) SMU reset Not saved 0 (smuX.DISABLE) Instrument reset Recall setup...
Page 579 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual Details During a sweep, the SMU iterates through the trigger layer of the trigger model the number of times set by this attribute. After performing the iterations, the SMU returns to the arm layer. If this count is set to zero (0), the SMU stays in the trigger model indefinitely until aborted.
Page 580 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference smuX.trigger.endpulse.action This attribute enables or disables pulse mode sweeps. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) SMU reset Not saved 1 (smuX.SOURCE_HOLD) Instrument reset Recall setup Usage pulseAction = smuX.trigger.endpulse.action...
Page 581 Section 9: TSP command reference Series 2600B 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 smuX.trigger.initiate() function is executed. Therefore, call smuX.trigger.endpulse.set() after the sweep is initiated. If the event detectors are configured to clear automatically because the smuX.trigger.autoclear attribute is set to smuX.ENABLE, make sure that smuX.trigger.endpulse.set() is issued after the SMU has entered the trigger layer.
Page 582 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference smuX.trigger.endpulse.stimulus This attribute defines which event causes 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 583 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual Trigger event IDs* Event ID Event description * Use the name of the trigger event ID to set the stimulus value rather than the numeric value. Using the name makes the code compatible for future upgrades (for example, if the numeric values must change when enhancements are added to the instrument).
Page 584 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference smuX.trigger.IDLE_EVENT_ID This constant contains the idle event number. Type TSP-Link accessible Affected by Where saved Default value Constant Usage eventID = smuX.trigger.IDLE_EVENT_ID eventID The idle event number Source-measure unit (SMU) channel (for example, smua.trigger.IDLE_EVENT_ID applies to SMU channel A) Details Set the stimulus of any trigger object to the value of this constant to have the trigger object respond to...
Page 585 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual To make measurements during the sweep, you must also configure and enable the measure action using smuX.trigger.measure.Y(). If you run this function more than once without reconfiguring the sweep measurements, the caches on the configured measurement reading buffers hold stale data.
Page 586 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference Details With this attribute enabled (setting action to smuX.ENABLE or smuX.ASYNC), configure the measurement with one of the smuX.trigger.measure.Y() functions. If this attribute is set to smuX.ASYNC: • Asynchronous sweep measurements can only be used with measure autoranging turned off.
Page 587 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual If the event detectors are configured to clear automatically because the smuX.trigger.autoclear attribute is set to smuX.ENABLE, make sure that smuX.trigger.measure.set() is issued after the SMU has entered the trigger layer. This function can also be used to start actions on the SMU in case of a missed trigger event.
Page 588 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference Trigger event IDs* Event ID Event description smuX.trigger.SWEEPING_EVENT_ID Occurs when the source-measure unit (SMU) transitions from the idle state to the arm layer of the trigger model smuX.trigger.ARMED_EVENT_ID Occurs when the SMU moves from the arm layer to the trigger layer of the trigger model smuX.trigger.SOURCE_COMPLETE_EVENT_ID...
Page 589 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual smuX.trigger.measure.Y() This function configures the measurements that are to be made in a subsequent sweep. Type TSP-Link accessible Affected by Where saved Default value Function Usage smuX.trigger.measure.Y(rbuffer) smuX.trigger.measure.iv(ibuffer, vbuffer) Source-measure unit (SMU) channel (for example, smua.trigger.measure.v() applies to SMU channel A) SMU measurement type (v = voltage, i = current, r = resistance, p = power)
Page 590 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference smuX.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 = smuX.trigger.MEASURE_COMPLETE_EVENT_ID eventID The measurement complete event number Source-measure unit (SMU) channel (for example, smua.trigger.MEASURE_COMPLETE_EVENT_ID applies to SMU channel A) Details...
Page 591 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual smuX.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 (smuX.DISABLE) Instrument reset Recall setup Usage...
Page 592 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference smuX.trigger.source.limitY This attribute sets the sweep source limit. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) SMU reset Not saved 0 (smuX.LIMIT_AUTO) Instrument reset Recall setup Usage sweepSourceLimit = smuX.trigger.source.limitY smuX.trigger.source.limitY = sweepSourceLimit...
Page 593 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual smuX.trigger.source.linearY() This function configures a linear source sweep. Type TSP-Link accessible Affected by Where saved Default value Function Usage smuX.trigger.source.linearY(startValue, endValue, points) Source-measure unit (SMU) channel (for example, smua.trigger.source.linearv(0, 10, 11) applies to SMU channel A) SMU source function (v = voltage, i = current) startValue...
Page 594 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference Also see smuX.trigger.source.action (on page 9-270) smuX.trigger.source.listY() (on page 9-273) smuX.trigger.source.logY() (on page 9-274) Sweep Operation (on page 2-51) smuX.trigger.source.listY() This function configures an array-based source sweep. Type TSP-Link accessible Affected by Where saved...
Page 595 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual Also see smuX.trigger.source.action (on page 9-270) smuX.trigger.source.linearY() (on page 9-272) smuX.trigger.source.logY() (on page 9-274) Sweep operation (on page 2-51) smuX.trigger.source.logY() This function configures an exponential (geometric) source sweep. Type TSP-Link accessible Affected by...
Page 596 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference The asymptote value must not be equal to or between the starting and ending values. It must be outside the range defined by the starting and ending values. The SMU stores only the most recent configured source action.
Page 597 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual Also see smuX.trigger.arm.set() (on page 9-254) smuX.trigger.autoclear (on page 9-257) smuX.trigger.endpulse.set() (on page 9-259) smuX.trigger.initiate() (on page 9-263) smuX.trigger.measure.set() (on page 9-265) Triggering (on page 4-1) smuX.trigger.source.stimulus This attribute defines which event causes the source event detector to enter the detected state. Type TSP-Link accessible Affected by...
Page 598 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference Trigger event IDs* Event ID Event description trigger.EVENT_ID Occurs when a *TRG command is received on the remote interface GPIB only: Occurs when a GET bus command is received USB only: Occurs when a USBTMC TRIGGER message is received...
Page 599 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual smuX.trigger.SWEEP_COMPLETE_EVENT_ID This constant contains the sweep complete event number. Type TSP-Link accessible Affected by Where saved Default value Constant Usage eventID = smuX.trigger.SWEEP_COMPLETE_EVENT_ID eventID The sweep complete event number Source-measure unit (SMU) channel (for example, smua.trigger.SWEEP_COMPLETE_EVENT_ID applies to SMU channel A) Details...
Page 600 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference 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 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual status.condition This attribute stores the status byte condition register. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Not applicable Not saved Not applicable Usage statusByte = status.condition statusByte The status byte;...
Page 602 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference Value and description 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 Set summary bit indicates that an enabled standard event has occurred. Bit B5 decimal value: 32 status.MASTER_SUMMARY_STATUS status.MSS...
Page 603 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual status.measurement.* This attribute contains the measurement event register set. Type TSP-Link accessible Affected by Where saved Default value Attribute .condition (R) Not applicable Not saved Not applicable .enable (RW) Status reset Not saved .event (R)
Page 604 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference Value Description status.measurement.VOLTAGE_LIMIT Set bit is a summary of the status.measurement.voltage_limit status.measurement.VLMT register. Bit B0 decimal value: 1 status.measurement.CURRENT_LIMIT Set bit is a summary of the status.measurement.current_limit status.measurement.ILMT register.
Page 605 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual Example status.measurement.enable = status.measurement.BAV Sets the BAV bit of the measurement event enable register. Also see Measurement event registers (on page 12-7) status.measurement.buffer_available.* This attribute contains the measurement event buffer available summary register set. Type TSP-Link accessible Affected by...
Page 606 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference Value Description Not used Not applicable. 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 status.measurement.buffer_available.SMUB This bit is only available on 2602B,...
Page 607 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual 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 measurementRegister The status of the measurement event current limit summary register; a zero (0) indicates no bits set (also send 0 to clear all bits);...
Page 608 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference Also see Measurement event registers (on page 12-7) status.measurement.instrument.smuX.* (on page 9-288) 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...
Page 609 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual Value Description Not used Not applicable. status.measurement.instrument.SMUA Set bit indicates one or more enabled bits of the measurement event SMU A summary register is set. Bit B1 decimal value: 2 Binary value: 0000 0010 status.measurement.instrument.SMUB This bit is only available on Models 2602B, 2604B,...
Page 610 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference Usage measurementRegister = status.measurement.instrument.smuX.condition measurementRegister = status.measurement.instrument.smuX.enable measurementRegister = status.measurement.instrument.smuX.event measurementRegister = status.measurement.instrument.smuX.ntr measurementRegister = status.measurement.instrument.smuX.ptr status.measurement.instrument.smuX.enable = measurementRegister status.measurement.instrument.smuX.ntr = measurementRegister status.measurement.instrument.smuX.ptr = measurementRegister measurementRegister The status of the instrument measurement status SMU X summary register; a zero (0) indicates no bits set (also send 0 to clear all bits);...
Page 611 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual Value Description status.measurement.instrument.smuX.BUFFER_AVAILABLE Set bit indicates that status.measurement.instrument.smuX.BAV there is at least one reading stored in either or both dedicated reading buffers. Bit B8 decimal value: 256 Not used Not applicable.
Page 612 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference Usage measurementRegister = status.measurement.reading_overflow.condition measurementRegister = status.measurement.reading_overflow.enable measurementRegister = status.measurement.reading_overflow.event measurementRegister = status.measurement.reading_overflow.ntr measurementRegister = status.measurement.reading_overflow.ptr status.measurement.reading_overflow.enable = measurementRegister status.measurement.reading_overflow.ntr = measurementRegister status.measurement.reading_overflow.ptr = measurementRegister measurementRegister The status of the measurement reading overflow summary register;...
Page 613 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual Also see Measurement event registers (on page 12-7) 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...
Page 614 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference Value Description status.measurement.voltage_limit.SMUB This bit is only available on 2602B, 2604B, 2612B, 2614B, 2634B, or 2636B. Set bit indicates the enabled VLMT bit for the SMU B measurement register is set.
Page 615 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual > > > > > > * Least significant bit ** Most significant bit Assigning a value to this attribute enables one or more status events. When an enabled status event occurs, a summary bit is set in the appropriate system summary register.
Page 616 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference Binary value Decimal Weights Example 1 nodeEnableRegister = status.MSB + status.OSB status.node_enable = nodeEnableRegister Use constants to set the MSB and OSB bits of the system node enable register. Example 2 -- decimal 129 = binary 10000001 nodeEnableRegister = 129...
Page 617 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual The returned value can indicate one or more status events occurred. 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...
Page 618 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference Also see Status byte and service request (SRQ) (on page 12-15) status.condition (on page 9-280) status.system.* (on page 9-349) status.operation.* These attributes manage the operation status register set of the status model. Type TSP-Link accessible Affected by...
Page 619 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual Value and description status.operation.CALIBRATING status.operation.CAL Set bit indicates that the summary bit of the status.operation.calibrating register has been set. Bit B0 decimal value: 1 Not used B1 to B2 status.operation.SWEEPING status.operation.SWE Set bit indicates that the summary bit from the status.operation.sweeping register is set.
Page 620 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference Binary value Decimal Weights Binary value 32,768 16,384 8,192 4,096 2,048 1,024 Decimal Weights Example 1 operationRegister = status.operation.USER + 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 621 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual Usage operationRegister = status.operation.calibrating.condition operationRegister = status.operation.calibrating.enable operationRegister = status.operation.calibrating.event operationRegister = status.operation.calibrating.ntr operationRegister = status.operation.calibrating.ptr status.operation.calibrating.enable = operationRegister status.operation.calibrating.ntr = operationRegister status.operation.calibrating.ptr = operationRegister operationRegister The status of the operation calibrating event register; a zero (0) indicates no bits set (also send 0 to clear all bits);...
Page 622 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference status.operation.instrument.* This attribute contains the operation status instrument summary register set. Type TSP-Link accessible Affected by Where saved Default value Attribute .condition (R) Not applicable Not saved Not applicable .enable (RW) Status reset Not saved...
Page 623 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual Value Description Not used Not applicable. status.operation.instrument.SMUA Set bit indicates one or more enabled bits for the operation status SMU A summary register is set. Bit B1 decimal value: 2 status.operation.instrument.SMUB This bit is only available on 2602B, 2604B, 2612B, 2614B, 2634B, 2636B.
Page 624 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference Binary value Decimal Weights Binary value Decimal 32,768 16,384 8,192 4,096 2,048 1,024 Weights Example 1 operationRegister = status.operation.instrument.SMUA + status.operation.instrument.TRGBLND status.operation.instrument.enable = operationRegister Sets bit B1 and bit B10 of the operation status instrument summary enable register using constants. Example 2 -- 1026 = binary 0000 0100 0000 0010 operationRegister = 1026...
Page 625 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual Usage operationRegister = status.operation.instrument.digio.condition operationRegister = status.operation.instrument.digio.enable operationRegister = status.operation.instrument.digio.event operationRegister = status.operation.instrument.digio.ntr operationRegister = status.operation.instrument.digio.ptr status.operation.instrument.digio.enable = operationRegister status.operation.instrument.digio.ntr = operationRegister status.operation.instrument.digio.ptr = operationRegister operationRegister The status of the operation status digital I/O summary register; a zero (0) indicates no bits set (also send 0 to clear all bits);...
Page 626 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference status.operation.instrument.digio.trigger_overrun.* This attribute contains the operation status digital I/O overrun register set. This command is not available on the 2604B, 2614B, or 2634B. Type TSP-Link accessible Affected by Where saved Default value Attribute...
Page 627 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual Value Decimal value Not used Not applicable status.operation.instrument.digio.trigger_overrun.LINE1 status.operation.instrument.digio.trigger_overrun.LINE2 status.operation.instrument.digio.trigger_overrun.LINE3 status.operation.instrument.digio.trigger_overrun.LINE4 status.operation.instrument.digio.trigger_overrun.LINE5 status.operation.instrument.digio.trigger_overrun.LINE6 status.operation.instrument.digio.trigger_overrun.LINE7 status.operation.instrument.digio.trigger_overrun.LINE8 status.operation.instrument.digio.trigger_overrun.LINE9 status.operation.instrument.digio.trigger_overrun.LINE10 1,024 status.operation.instrument.digio.trigger_overrun.LINE11 2,048 status.operation.instrument.digio.trigger_overrun.LINE12 4,096 status.operation.instrument.digio.trigger_overrun.LINE13 8,192 status.operation.instrument.digio.trigger_overrun.LINE14 16,384 Not used Not applicable As an example, to set bit B1 of the operation status digital I/O overrun enable register, set status.operation.instrument.digio.trigger_overrun.enable =...
Page 628 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference Example 2 operationRegister = 1026 status.operation.instrument.digio.trigger_overrun.enable = operationRegister Uses the decimal value to set bit B1 and bit B10 of the operation status digital I/O overrun enable register. Also see Operation Status Registers (on page 12-8)
Page 629 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual 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 630 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference 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 631 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual Value Decimal value Not used Not applicable status.operation.instrument.lan.trigger_overrun.LAN1 2 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 632 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference status.operation.instrument.smuX.* This attribute contains the operation status SMU X summary register set. Type TSP-Link accessible Affected by Where saved Default value Attribute .condition (R) Not applicable Not saved Not applicable .enable (RW) Status reset...
Page 633 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual Value and description Not used B1 to B2 status.operation.instrument.smuX.SWEEPING status.operation.instrument.smuX.SWE Set bit indicates that smuX is sweeping. Bit B3 decimal value: 8 status.operation.instrument.smuX.MEASURING status.operation.instrument.smuX.MEAS Bit is set when making an overlapped measurement, but it is not set when making a normal synchronous measurement.
Page 634 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference status.operation.instrument.smuX.trigger_overrrun.* This attribute contains the operation status SMU X 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 635 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual Value and description status.operation.instrument.smuX.trigger_overrun.SRC Set bit indicates that the source event detector of the SMU was already in the detected state when a trigger was received. Bit B2 decimal value: 4 status.operation.instrument.smuX.trigger_overrun.MEAS Set bit indicates that the measurement event detector of the SMU was already in the detected state when a trigger was received.
Page 636 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference status.operation.instrument.trigger_blender.* This attribute contains the operation status trigger blender summary register set. Type TSP-Link accessible Affected by Where saved Default value Attribute .condition (R) Not applicable Not saved Not applicable .enable (RW) Status reset...
Page 637 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual Also see Operation Status Registers (on page 12-8) status.operation.instrument.trigger_blender.trigger_overrun.* (on page 9-316) status.operation.instrument.trigger_blender.trigger_overrun.* This attribute contains the operation status trigger blender overrun register set. Type TSP-Link accessible Affected by Where saved Default value Attribute...
Page 638 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents (on page 12-1) and Enable and transition registers (on page 12-19). The individual bits of this register are defined in the following table.
Page 639 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual status.operation.instrument.trigger_timer.* This attribute contains the operation status trigger timer 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 640 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference Also see Operation Status Registers (on page 12-8) status.operation.instrument.trigger_timer.trigger_overrun.* (on page 9-319) status.operation.instrument.trigger_timer.trigger_overrun.* This attribute contains the operation status trigger timer overrun register set. Type TSP-Link accessible Affected by Where saved Default value Attribute...
Page 641 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual A set bit indicates the specified timer generated an action overrun because it was still processing a delay from a previous trigger when a new trigger was received. For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents...
Page 642 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference 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. Also see Operation Status Registers (on page 12-8) status.operation.instrument.trigger_timer.* (on page 9-318)
Page 643 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual Value and description Not used B0 to B9 status.operation.instrument.tsplink.TRIGGER_OVERRUN status.operation.instrument.tsplink.TRGOVR Set bit indicates one or more enabled bits for the operation status TSP-Link overrun register is set. Bit B10 decimal value: 1,024 Binary value: 0100 0000 0000 B11 to B15 Not used...
Page 644 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference Details These attributes are used to read or write to the operation status TSP-link overrun registers. Reading a status register returns a value. The binary equivalent of the returned value indicates which register bits are set.
Page 645 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual 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. Also see Operation Status Registers (on page 12-8)
Page 646 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference Value Description Not used Not applicable. status.operation.measuring.SMUA Bit is set when SMU A is making an overlapped measurement, but it is not set when making a normal synchronous measurement. Bit B1 decimal value: 2 Binary value: 0000 0010 status.operation.measuring.SMUB...
Page 647 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual 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 operationRegister The status of the operation status remote summary register; a zero (0) indicates no bits set (also send 0 to clear all bits);...
Page 648 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference Also see Operation Status Registers (on page 12-8) status.operation.* (on page 9-297) status.operation.sweeping.* This attribute contains the operation status sweeping summary register set. Type TSP-Link accessible Affected by Where saved Default value Attribute...
Page 649 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual As an example, to set bit B1 of the operation status sweeping summary enable register, set status.operation.sweeping.enable = status.operation.sweeping.SMUA. In addition to the above constants, operationRegister can be set to the numeric equivalent of the bit to set.
Page 650 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference 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 651 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual Value Description status.operation.trigger_overrun.TSPLINK This bit is only available on 2601B, 2602B, 2611B, 2612B, 2635B, 2636B. Set bit indicates one of the enabled bits in the operation status TSP-Link overrun event register is set.
Page 652 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference status.operation.user.* These attributes manage the operation status user register set of the status model. Type TSP-Link accessible Affected by Where saved Default value Attribute .condition (RW) Status reset Not saved .enable (RW) Status reset...
Page 653 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual Value Decimal value status.operation.user.BIT5 status.operation.user.BIT6 status.operation.user.BIT7 status.operation.user.BIT8 status.operation.user.BIT9 status.operation.user.BIT10 1,024 status.operation.user.BIT11 2,048 status.operation.user.BIT12 4,096 status.operation.user.BIT13 8,192 status.operation.user.BIT14 16,384 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.
Page 654 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference 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 655 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual Value Description status.questionable.HIGHV_NOT_READY Only 2611B, 2612B, 2614B, 2634B, 2635B, 2636B: Either the interlock is not engaged or the interlock was engaged recently and the high voltage supply is still stabilizing. If the interlock is engaged and this bit is set, attempting to turn on the output on the 200 V range results in error code 5052,...
Page 656 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference 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 657 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual As an example, to set bit B1 of the questionable status calibration summary enable register, set status.questionable.calibration.enable = status.questionable.calibration.SMUA. In addition to the above constants, questionableRegister can be set to the numeric equivalent of the bit to set.
Page 658 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents (on page 12-1) and Enable and transition registers (on page 12-19). The individual bits of this register are defined in the following table.
Page 659 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual Usage questionableRegister = status.questionable.instrument.smuX.condition questionableRegister = status.questionable.instrument.smuX.enable questionableRegister = status.questionable.instrument.smuX.event questionableRegister = status.questionable.instrument.smuX.ntr questionableRegister = status.questionable.instrument.smuX.ptr status.questionable.instrument.smuX.enable = questionableRegister status.questionable.instrument.smuX.ntr = questionableRegister status.questionable.instrument.smuX.ptr = questionableRegister questionableRegister The status of the questionable status SMU X summary register; a zero (0) indicates no bits set (also send 0 to clear all bits);...
Page 660 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference Value Description status.questionable.instrument.smuX.OVER_TEMPERATURE Set bit indicates that an status.questionable.instrument.smuX.OTEMP over temperature condition was detected. Bit B12 decimal value: 4,096 B13 to B15 Not used Not applicable. As an example, to set bit B8 of the questionable status SMU A summary enable register, set status.questionable.instrument.smua.enable = status.questionable.instrument.smua.CAL.
Page 661 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual Usage questionableRegister = status.questionable.over_temperature.condition questionableRegister = status.questionable.over_temperature.enable questionableRegister = status.questionable.over_temperature.event questionableRegister = status.questionable.over_temperature.ntr questionableRegister = status.questionable.over_temperature.ptr status.questionable.over_temperature.enable = questionableRegister status.questionable.over_temperature.ntr = questionableRegister status.questionable.over_temperature.ptr = questionableRegister operationRegister The status of the questionable status over temperature summary register;...
Page 662 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference Also see Questionable Status Registers (on page 12-13) status.questionable.* (on page 9-333) status.questionable.unstable_output.* This attribute contains the questionable status unstable output summary register set. Type TSP-Link accessible Affected by Where saved Default value Attribute...
Page 663 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual Value Description status.questionable.unstable_output.SMUB This bit is only available on 2602B, 2604B, 2612B, 2614B, 2634B, 2636B. Set bit indicates that an unstable output condition was detected on SMU B. Bit B2 decimal value: 4 Binary value: 0000 0100 Not used...
Page 664 Series 2600B System SourceMeter® instrument Reference Manual Section 9: 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 12-1) and Enable and transition registers...
Page 665 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual Binary value Decimal Weights Example 1 requestSRQEnableRegister = status.MSB + status.OSB status.request_enable = requestSRQEnableRegister Uses constants to set the MSB and OSB bits of the service request (SRQ) enable register. Example 2 -- decimal 129 = binary 10000001 requestSRQEnableRegister = 129...
Page 666 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents (on page 12-1) and Enable and transition registers (on page 12-19). The individual bits of this register are defined in the following table.
Page 667 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual 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 668 Series 2600B System SourceMeter® instrument Reference Manual Section 9: 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 669 Section 9: TSP command reference Series 2600B 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 670 Series 2600B System SourceMeter® instrument Reference Manual Section 9: 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 12-21)
Page 671 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual Value Decimal value status.system.EXTENSION_BIT status.system.EXT status.system.NODE1 status.system.NODE2 status.system.NODE3 status.system.NODE4 status.system.NODE5 status.system.NODE6 status.system.NODE7 status.system.NODE8 status.system.NODE9 status.system.NODE10 1,024 status.system.NODE11 2,048 status.system.NODE12 4,096 status.system.NODE13 8,192 status.system.NODE14 16,384 Not used Not applicable As an example, to set bit B0 of the system summary status enable register, set status.system.enable = status.system.enable.EXT.
Page 672 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference 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. Also see status.system2.* (on page 9-351)
Page 673 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents (on page 12-1) and Enable and transition registers (on page 12-19). The individual bits of this register are defined in the following table.
Page 674 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference Example 2 -- decimal 18432 = binary 0100 1000 0000 0000 enableRegister = 18432 status.system2.enable = enableRegister Uses the decimal value to set bits B11 and B14 of the system summary 2 enable register. Also see status.system.* (on page 9-349)
Page 675 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents (on page 12-1) and Enable and transition registers (on page 12-19). The individual bits of this register are defined in the following table.
Page 676 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference Example 2 -- decimal 18432 = binary 0100 1000 0000 0000 enableRegister = 18432 status.system3.enable = enableRegister Uses the decimal value to set bits B11 and B14 of the system summary 3 enable register. Also see status.system2.* (on page 9-351)
Page 677 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents (on page 12-1) and Enable and transition registers (on page 12-19). The individual bits of this register are defined in the following table.
Page 678 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference Example 2 -- decimal 18432 = binary 0100 1000 0000 0000 enableRegister = 18432 status.system4.enable = enableRegister Uses a decimal value to set bit B11 and bit B14 of the system summary 4 enable register. Also see status.system3.* (on page 9-353)
Page 679 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents (on page 12-1) and Enable and transition registers (on page 12-19). The individual bits of this register are defined in the following table.
Page 680 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference Also see status.system4.* (on page 9-355) System summary and standard event registers (on page 12-6) SweepILinMeasureV() This KISweep factory script function performs a linear current sweep with voltage measured at every step (point). Type TSP-Link accessible Affected by...
Page 681 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual 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 682 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference 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(smuX, starti, stopi, stime, points) Source-measure unit (SMU) channel (for example, smua.reset() applies to SMU...
Page 683 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual Figure 126: 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 684 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference Details Data for current measurements, voltage source values, and timestamps are stored in smuX.nvbuffer1. If all parameters are omitted when this function is called, this function is executed with the parameters set to the default values.
Page 685 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual SweepVListMeasureI() This KISweep factory script function performs a voltage list sweep with current measured at every step (point). Type TSP-Link accessible Affected by Where saved Default value Function Usage SweepVListMeasureI(smuX, vlist, stime, points) Source-measure unit (SMU) channel (for example, smua.reset() applies to SMU...
Page 686 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference SweepVLogMeasureI() This KISweep factory script function performs a logarithmic voltage sweep with current measured at every step (point). Type TSP-Link accessible Affected by Where saved Default value Function Usage SweepVLogMeasureI(smuX, startv, stopv, stime, points) Source-measure unit (SMU) channel (for example, smua applies to SMU channel A)
Page 687 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual Figure 128: SweepVLogMeasureI() Example SweepVLogMeasureI(smua, 1, 10, 0.001, 5) This function performs a five-point logarithmic voltage sweep starting at 1 V and stopping at 10 V. Current is measured at every step (point) in the sweep after a 1 ms source settling period.
Page 688 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference Example 2 beeper.enable = beeper.ON beeper.beep(0.5, 2400) print("reset timer") timer.reset() delay(0.5) dt = timer.measure.t() print("timer after delay:", dt) beeper.beep(0.5, 2400) Enable the beeper. Emit a beep and set the beeper. Reset the timer.
Page 689 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual trigger.blender[N].clear() This function clears the blender event detector and resets the overrun indicator of blender N. Type TSP-Link accessible Affected by Where saved Default value Function Usage trigger.blender[N].clear() The blender number (up to six) Details This command sets the blender event detector to the undetected state and resets the overrun...
Page 690 Series 2600B System SourceMeter® instrument Reference Manual Section 9: 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 691 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual Details Indicates if an event was 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 that is built into the event blender itself.
Page 692 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference trigger.blender[N].stimulus[M] This attribute specifies the events that trigger the blender. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Trigger blender N reset Not applicable trigger.EVENT_NONE Usage eventID = trigger.blender[N].stimulus[M] trigger.blender[N].stimulus[M] = eventID...
Page 693 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual Trigger event IDs* Event ID Event description trigger.generator[N].EVENT_ID Occurs when the trigger.generator[N].assert() function is executed * Use the name of the trigger event ID to set the stimulus value rather than the numeric value. Using the name makes the code compatible for future upgrades (for example, if the numeric values must change when enhancements are added to the instrument).
Page 694 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference Also see trigger.blender[N].clear() (on page 9-368) trigger.clear() This function clears the command interface trigger event detector. Type TSP-Link accessible Affected by Where saved Default value Function Usage trigger.clear() Details The trigger event detector indicates if a trigger event has been detected since the last trigger.wait() call.
Page 695 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual trigger.generator[N].assert() This function generates a trigger event. Type TSP-Link accessible Affected by Where saved Default value Function Usage trigger.generator[N].assert() The generator number (1 or 2) Details Use this function to directly trigger events from the command interface or a script. For example, you can trigger a sweep while the instrument is under script control.
Page 696 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference trigger.timer[N].clear() This function clears the timer event detector and overrun indicator for the specified trigger timer number. Type TSP-Link accessible Affected by Where saved Default value Function Usage trigger.timer[N].clear() Trigger timer number (1 to 8) Details...
Page 697 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual Also see trigger.timer[N].clear() (on page 9-375) trigger.timer[N].delay (on page 9-376) trigger.timer[N].reset() (on page 9-379) trigger.timer[N].delay This attribute sets and reads the timer delay. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW)
Page 698 Series 2600B System SourceMeter® instrument Reference Manual Section 9: 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 699 Section 9: TSP command reference Series 2600B 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 eventID The trigger event number Trigger timer number (1 to 8) Details This constant is an identification number that identifies events generated by this timer.
Page 700 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference Example print(trigger.timer[1].overrun) If an event was ignored, the output is true. If the event was not ignored, the output is false. Also see trigger.timer[N].reset() (on page 9-379) trigger.timer[N].passthrough This attribute enables or disables the timer trigger pass-through mode.
Page 701 Section 9: TSP command reference Series 2600B 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 trigger.timer[1].reset() Resets the attributes associated with timer 1 back to factory default values.
Page 702 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference Trigger event IDs* Event ID Event description smuX.trigger.MEASURE_COMPLETE_EVENT_ID Occurs when the SMU completes a measurement action smuX.trigger.PULSE_COMPLETE_EVENT_ID Occurs when the SMU completes a pulse smuX.trigger.SWEEP_COMPLETE_EVENT_ID Occurs when the SMU completes a sweep smuX.trigger.IDLE_EVENT_ID Occurs when the SMU returns to the idle state digio.trigger[N].EVENT_ID...
Page 703 Section 9: TSP command reference Series 2600B 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) triggered Trigger detection indication Trigger timer number (1 to 8) timeout Maximum amount of time in seconds to wait for the trigger Details...
Page 704 Series 2600B System SourceMeter® instrument Reference Manual Section 9: 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 705 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual Also see Using groups to manage nodes on a TSP-Link system (on page 8-92) tsplink.master This attribute reads the node number assigned to the master node. This command is not available on the 2604B, 2614B, or 2634B.
Page 706 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference Example tsplink.node = 3 Sets the TSP-Link node for this instrument to number 3. Also see tsplink.reset() (on page 9-386) tsplink.state (on page 9-387) tsplink.readbit() This function reads the state of a TSP-Link synchronization line. This command is not available on the 2604B, 2614B, or 2634B.
Page 707 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual Details The binary equivalent of the returned value indicates the input pattern on the I/O port. The least significant bit of the binary number corresponds to line 1 and the value of bit 3 corresponds to line 3. For example, a returned value of 2 has a binary equivalent of 010.
Page 708 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference Example nodesFound = tsplink.reset(2) print("Nodes found = " .. nodesFound) Perform a TSP-Link reset and indicate how many nodes are found. Sample output if two nodes are found: Nodes found = 2 Sample output if fewer nodes are found and if localnode.showerrors = 1: 1219, TSP-Link found fewer nodes than expected...
Page 709 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual tsplink.trigger[N].assert() This function simulates the occurrence of the trigger and generates the corresponding event ID. This command is not available on the 2604B, 2614B, or 2634B. Type TSP-Link accessible Affected by Where saved Default value...
Page 710 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference Example tsplink.trigger[2].clear() Clears trigger event on synchronization line 2. Also see tsplink.trigger[N].mode (on page 9-390) tsplink.trigger[N].overrun (on page 9-391) tsplink.trigger[N].release() (on page 9-393) tsplink.trigger[N].stimulus (on page 9-394) tsplink.trigger[N].wait() (on page 9-395) tsplink.trigger[N].EVENT_ID This constant identifies the number that is used for the trigger events.
Page 711 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual tsplink.trigger[N].mode This attribute defines the trigger operation and detection mode. This command is not available on the 2604B, 2614B, or 2634B. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Instrument reset...
Page 712 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference When programmed to any mode except tsplink.TRIG_BYPASS, the output state of the I/O line is controlled by the trigger logic and the user-specified output state of the line is ignored. When the trigger mode is set to tsplink.TRIG_RISING, the user-specified output state of the line is examined.
Page 713 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual Example print(tsplink.trigger[1].overrun) If an event was ignored, displays true; if an event was not ignored, displays false. Also see tsplink.trigger[N].assert() (on page 9-388) tsplink.trigger[N].clear() (on page 9-388) tsplink.trigger[N].mode (on page 9-390) tsplink.trigger[N].release() (on page 9-393)
Page 714 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference tsplink.trigger[N].release() This function releases a latched trigger on the given TSP-Link trigger line. This command is not available on the 2604B, 2614B, or 2634B. Type TSP-Link accessible Affected by Where saved Default value Function...
Page 715 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual Details The tsplink.trigger[N].reset() function resets these attributes to their factory defaults: ▪ tsplink.trigger[N].mode ▪ tsplink.trigger[N].stimulus ▪ tsplink.trigger[N].pulsewidth This also clears tsplink.trigger[N].overrun. Example tsplink.trigger[3].reset() Resets TSP-Link trigger line 3 attributes back to factory default values. Also see tsplink.trigger[N].mode (on page 9-390)
Page 716 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference Trigger event IDs* Event ID Event description smuX.trigger.PULSE_COMPLETE_EVENT_ID Occurs when the SMU completes a pulse smuX.trigger.SWEEP_COMPLETE_EVENT_ID Occurs when the SMU completes a sweep smuX.trigger.IDLE_EVENT_ID Occurs when the SMU returns to the idle state digio.trigger[N].EVENT_ID Occurs when an edge is detected on a digital I/O line tsplink.trigger[N].EVENT_ID...
Page 717 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual Details This function waits up to the timeout value for an input trigger. If one or more trigger events were detected since the last time tsplink.trigger[N].wait() or tsplink.trigger[N].clear() was called, this function returns immediately.
Page 718 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference Also see tsplink.readbit() (on page 9-385) tsplink.readport() (on page 9-385) tsplink.writeport() (on page 9-397) tsplink.writeprotect (on page 9-397) tsplink.writeport() This function writes to all TSP-Link synchronization lines. This command is not available on the 2604B, 2614B, or 2634B.
Page 719 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual Usage mask = tsplink.writeprotect tsplink.writeprotect = mask mask An integer that specifies the value of the bit pattern for write-protect; set bits to 1 to write-protect the corresponding TSP-Link trigger line Details The binary equivalent of mask indicates the mask to be set for the TSP-Link trigger line.
Page 720 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference Also see tspnet.connect() (on page 9-399) tspnet.readavailable() (on page 9-404) tspnet.write() (on page 9-410) tspnet.connect() This function establishes a network connection with another LAN instrument or device through the LAN interface. Type TSP-Link accessible Affected by...
Page 721 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual Example 1 instrumentID = tspnet.connect("192.0.2.1") if instrumentID then -- Use instrumentID as needed here tspnet.disconnect(instrumentID) Connect to a TSP-enabled device. 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.
Page 722 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference tspnet.execute() This function sends a command string to the remote device. Type TSP-Link accessible Affected by Where saved Default value 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) connectionID...
Page 723 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual Also see tspnet.connect() (on page 9-399) tspnet.read() (on page 9-403) tspnet.termination() (on page 9-405) tspnet.write() (on page 9-410) tspnet.idn() This function retrieves the response of the remote device to *IDN?. Type TSP-Link accessible Affected by...
Page 724 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference tspnet.read() This function reads data from a remote device. Type TSP-Link accessible Affected by Where saved Default value Function Usage value1 = tspnet.read(connectionID) value1 = tspnet.read(connectionID, formatString) value1, value2 = tspnet.read(connectionID, formatString) value1, ..., valueN = tspnet.read(connectionID, formatString) value1 The first value decoded from the response message...
Page 725 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual tspnet.readavailable() This function checks to see if data is available from the remote device. Type TSP-Link accessible Affected by Where saved Default value Function Usage bytesAvailable = tspnet.readavailable(connectionID) bytesAvailable The number of bytes available to be read from the connection connectionID...
Page 726 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference tspnet.termination() This function sets the device line termination sequence. Type TSP-Link accessible Affected by Where saved Default value Function Usage type = tspnet.termination(connectionID) type = tspnet.termination(connectionID, termSequence) type An enumerated value indicating the termination type: ▪...
Page 727 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual tspnet.timeout This attribute sets the timeout value for the tspnet.connect(), tspnet.execute(), and tspnet.read() commands. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Instrument reset Not saved 20.0 (20 s) Recall setup Usage...
Page 728 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference Example tspnet.tsp.abort(testConnection) Stops remote instrument execution on testConnection. Also see None tspnet.tsp.abortonconnect This attribute contains the setting for abort on connect to a TSP-enabled instrument. Type TSP-Link accessible Affected by Where saved Default value...
Page 729 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual tspnet.tsp.rbtablecopy() This function copies a reading buffer synchronous table from a remote instrument to a TSP-enabled instrument. Type TSP-Link accessible Affected by Where saved Default value Function Usage table = tspnet.tsp.rbtablecopy(connectionID, "name") table = tspnet.tsp.rbtablecopy(connectionID, "name", startIndex, endIndex) table...
Page 730 Series 2600B System SourceMeter® instrument Reference Manual Section 9: 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") connectionID Integer value used as an identifier for other tspnet commands name...
Page 731 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual tspnet.write() This function writes a string to the remote instrument. Type TSP-Link accessible Affected by Where saved Default value Function Usage tspnet.write(connectionID, "inputString") connectionID The connection ID returned from tspnet.connect() inputString The string to be written Details...
Page 732 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference userstring.add() This function adds a user-defined string to nonvolatile memory. Type TSP-Link accessible Affected by Where saved Default value Function Usage userstring.add("name", "value") name The name of the string; the key of the key-value pair value The string to associate with name;...
Page 733 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual userstring.catalog() This function creates an iterator for the user-defined string catalog. Type TSP-Link accessible Affected by Where saved Default value Function Usage for name in userstring.catalog() do body end name The name of the string;...
Page 734 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference userstring.delete() This function deletes a user-defined string from nonvolatile memory. Type TSP-Link accessible Affected by Where saved Default value Function Usage userstring.delete("name") name The name (key) of the key-value pair of the user-defined string to delete Details This function deletes the string that is associated with name from nonvolatile memory.
Page 735 Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual 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") value The value of the user-defined string key-value pair name The name (key) of the user-defined string Details...
Page 736 Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference waitcomplete() This function waits for all previously started overlapped commands to complete. Type TSP-Link accessible Affected by Where saved Default value Function Usage waitcomplete() waitcomplete(group) group Specifies which TSP-Link group on which to wait Details There are two types of instrument commands: •...
Page 737 Section 10 Calibration In this section: Verification ................10-1 Adjustment ................10-15 Verification 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 738 Section 10: Calibration Series 2600B 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 739 Series 2600B System SourceMeter® instrument Reference Manual Section 10: Calibration Recommended verification equipment The following table summarizes recommended maximum allowable test equipment uncertainty for verification points. Total test equipment measurement uncertainty should meet or be less than the listed values at each test point. Generally, test equipment uncertainty should be at least four times better than corresponding 2600B specifications.
Page 740 Section 10: Calibration Series 2600B System SourceMeter® instrument Reference Manual Calibration limits The calibration limits stated in this section have been calculated using only the 2600B 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 2600B specifications and corresponding test equipment specifications.
Page 741 Series 2600B System SourceMeter® instrument Reference Manual Section 10: Calibration Performing the calibration test procedures Perform the following calibration tests to make sure the instrument is operating within specifications: • Current source accuracy (on page 10-6) • Current measurement accuracy (on page 10-9) •...
Page 742 Section 10: Calibration Series 2600B System SourceMeter® instrument Reference Manual 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 2600B while the instrument is powered on.
Page 743 Series 2600B System SourceMeter® instrument Reference Manual Section 10: Calibration 5. Verify output current accuracy for each of the currents for the 100 nA to 1 A ranges (for 2634B, 2635B, or 2636B, verify currents for the 1 µA to 1 A ranges) using the values listed in the following table for your model number.
Page 744 Section 10: Calibration Series 2600B System SourceMeter® instrument Reference Manual 9. Repeat steps 4 through 6 for the 3 A range (Model 2601B, 2602B, or 2604B) or the 1.5 A range (Model 2611B, 2612B, 2614B, 2634B, 2635B, or 2636B). Calculate the current from the DMM voltage reading and the characterized 0.5 Ω...
Page 745 Series 2600B System SourceMeter® instrument Reference Manual Section 10: Calibration Figure 130: Connections for 1.5 A and 3 A current ranges Current measurement accuracy Follow the steps below to verify that 2600B current measurement accuracy is within specified limits. The procedure involves applying accurate currents from the 2600B current source and then verifying that 2600B current measurements are within required limits.
Page 746 Section 10: Calibration Series 2600B System SourceMeter® instrument Reference Manual 6. Verify measure current accuracy for each of the currents listed using the values listed in the following table for your model number. For each measurement: ▪ Select the correct source range. ▪...
Page 747 Series 2600B System SourceMeter® instrument Reference Manual Section 10: Calibration 2634B, 2635B, and 2636B current measurement accuracy limits Source and measure range Source current Current reading limits (1 year, 18° C to 28° C) 100 pA to 100 nA ranges Model 2634B, 2635B, 2636B current measurement accuracy 100 pA to 100 nA ranges (on page 10-11)
Page 748 Section 10: Calibration Series 2600B System SourceMeter® instrument Reference Manual 2. Characterize the 2634B, 2635B, or 2636B current ranges. a. Connect guarded resistance standard. b. Source the appropriate voltage for ± full-scale reading. c. Wait 30 seconds for stable measurement. d.
Page 749 Series 2600B System SourceMeter® instrument Reference Manual Section 10: Calibration 2. Set the multimeter measuring function to dc volts. 3. On a two-channel instrument (2602B, 2604B, 2612B, 2614B, 2634B, or 2636B), select the single-channel display mode. 4. Press the SRC key to source voltage and make sure the source output is turned on. 5.
Page 750 Section 10: Calibration Series 2600B System SourceMeter® instrument Reference Manual Voltage measurement accuracy Follow the steps below to verify that the 2600B voltage measurement accuracy is within specified limits. To perform this test, you set the source voltage, as measured by a precision digital multimeter, and then verify that the 2600B voltage readings are within required limits.
Page 751 Series 2600B System SourceMeter® instrument Reference Manual Section 10: Calibration 2611B, 2612B, 2614B, 2634B, 2635B, 2636B voltage measurement accuracy limits Source and measure range Source voltage Voltage reading limits (1 year, 18 °C to 28 °C) 200 mV 180.000 mV 179.748 mV to 180.252 mV 1.80000 V 1.79929 V to 1.80071 V...
Page 752 Section 10: Calibration Series 2600B System SourceMeter® instrument Reference Manual Warmup period Allow the 2600B to warm up for at least two hours before adjusting the instrument. If the instrument has been subjected to temperature extremes (those outside the ranges stated above), allow additional time for the internal temperature of the instrument to stabilize.
Page 753 Series 2600B System SourceMeter® instrument Reference Manual Section 10: Calibration Adjustment cycle Perform an adjustment at least once a year to make sure the instrument meets or exceeds its specifications. Recommended calibration adjustment equipment The table below contains the recommended equipment for the calibration adjustment procedures. You can use alternate equipment as long as that equipment has specifications equal to or greater than those listed in the table.
Page 754 Section 10: Calibration Series 2600B System SourceMeter® instrument Reference Manual Calibration adjustment overview The following topics contain an overview of the entire calibration adjustment procedure. Parameter values The full-scale parameters are 90 percent of full-scale as indicated (see the table in Step sequence page 10-18)).
Page 755 Series 2600B System SourceMeter® instrument Reference Manual Section 10: Calibration 2601B, 2602B, or 2604B calibration steps Function Calibration steps Calibration points Sense mode smuX.SENSE_LOCAL Voltage Source 100 mV ±1e-30, ±90 mV smuX.SENSE_REMOTE and Measure 100 mV ±1e-30, ±90 mV smuX.SENSE_LOCAL ±1e-30, ±0.9 V smuX.SENSE_CALA ±1e-30, ±0.9 V...
Page 756 Section 10: Calibration Series 2600B System SourceMeter® instrument Reference Manual 2634B, 2635B, 2636B calibration steps Function Calibration steps Calibration points Sense mode smuX.SENSE_LOCAL Voltage Source 200 mV ±1e-30, ±180 mV smuX.SENSE_REMOTE and Measure 200 mV ±1e-30, ±180 mV smuX.SENSE_LOCAL ±1e-30, ±1.8 V smuX.SENSE_CALA ±1e-30, ±1.8 V smuX.SENSE_LOCAL...
Page 757 Series 2600B System SourceMeter® instrument Reference Manual Section 10: Calibration Calibration commands Command** Description smuX.cal.save() Stores the active calibration constants to nonvolatile memory as the DEFAULT calibration set. calstate = smuX.cal.state Returns the present calibration state: smuX.CALSTATE_CALIBRATING smuX.CALSTATE_LOCKED smuX.CALSTATE_UNLOCKED smuX.cal.unlock("password") Unlocks calibration (default password: KI0026XX) smuX.measure.calibratei(range, Adjusts the current measurement range:*...
Page 758 Section 10: Calibration Series 2600B 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 759 Series 2600B System SourceMeter® instrument Reference Manual Section 10: Calibration It is not necessary to set the measure range when following this procedure for calibration because the measure range is locked to the source range when measuring the source function. C.
Page 760 Section 10: Calibration Series 2600B 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: range = The present calibration range src_Z = The +zero 2600B programmed source output value...
Page 761 Series 2600B System SourceMeter® instrument Reference Manual Section 10: Calibration 19. Allow the readings to settle, then get both the multimeter and 2600B voltage readings at the negative full-scale output value (the 2600B measurement is not necessary if this calibration step is being done on the CALA sense mode).
Page 762 Section 10: Calibration Series 2600B System SourceMeter® instrument Reference Manual Step 3. Current calibration adjustment A. Connect the 2600B SMU to the digital multimeter (see the following figure), and then select the multimeter dc current function. B. Send this command to initialize current calibration: smua.source.func = smua.OUTPUT_DCAMPS Figure 133: Connections for 100 nA to 1 A current ranges It is not necessary to set the measure range when following this procedure for calibration because...
Page 763 Series 2600B System SourceMeter® instrument Reference Manual Section 10: Calibration C. Perform each calibration step listed in Model 2601B, 2602B, 2604B step sequence, Model 2611B, 2612B, 2614B step sequence, or Model 2634B, 2635B, 2636B step sequence for the 100 nA through 1 A ranges as follows: Select the range being calibrated: smua.source.rangei = range...
Page 764 Section 10: Calibration Series 2600B System SourceMeter® instrument Reference Manual 12. If this step is not on the CALA sense mode, send the measure calibration command using the multimeter and 2600B readings, and range setting for the parameters: smua.measure.calibratei(range, Z_rdg, DMM_Z_rdg, FS_rdg, DMM_FS_rdg) Where: range = The present calibration range...
Page 765 Series 2600B System SourceMeter® instrument Reference Manual Section 10: Calibration Typical values for the 100 mA range: smua.source.calibratei(-100e-3, -1e-30, -1e-6, -90e-3, -89.2e-3) 22. If this step is not on the CALA sense mode, send the measure calibration command using the multimeter and 2600B readings, and range setting for the parameters: smua.measure.calibratei(-range, Z_rdg, DMM_Z_rdg, FS_rdg, DMM_FS_rdg) Where:...
Page 766 Section 10: Calibration Series 2600B System SourceMeter® instrument Reference Manual Models 2634B, 2635B, and 2636B: 1. Connect the 2600B to the digital multimeter. Use the figure titled "Connections for current calibration (1.5 A through 10 A ranges)" as a guideline, but replace the 0.5 Ω resistor with the 1 GΩ...
Page 767 Series 2600B System SourceMeter® instrument Reference Manual Section 10: Calibration Step 4. Contact check calibration adjustment Skip this step for the 2604B, 2614B, and 2634B. These models do not perform contact check measurements. A. As illustrated in the following figure: ▪...
Page 768 Section 10: Calibration Series 2600B System SourceMeter® instrument Reference Manual F. Send the contact check low calibration adjustment command: smua.contact.calibratelo(r0_lo, Z_actual, r50_lo, 50_ohm_actual) Where: r0_lo = 2600B 0 Ω low measurement Z_actual = Actual zero value; the resistance of the short between the SENSE LO and LO terminals r50_lo = 2600B 50 Ω...
Page 769 Series 2600B System SourceMeter® instrument Reference Manual Section 10: Calibration The actual year, month, day, and (optional) hour and minute should be used (seconds can be given but are essentially ignored due to the precision of the internal date storage format). The allowable range for the year is from 1970 to 2037, the month is from 1 to 12, and the day is from 1 to 31.
Page 770 Section 11 Common commands In this section: Common command summary ..........11-1 Script command equivalents ..........11-2 Command reference .............. 11-3 General bus commands ............11-5 Common command summary The IEEE Std 488.2 common commands that are supported by the 2600B are summarized in the following table.
Page 771 Section 11: Common commands Series 2600B System SourceMeter® instrument Reference Manual Command Name Description *OPC Operation complete Set the Operation Complete bit in the Standard Event Register after all pending commands, including overlapped command commands, have completed. For detailed information, see Operation complete and query: *OPC and *OPC? page 11-3).
Page 772 Series 2600B System SourceMeter® instrument Reference Manual Section 11: 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 12-1). Identification query: *IDN? Retrieves the identification string.
Page 773 Section 11: Common commands Series 2600B System SourceMeter® instrument Reference Manual Self-test query: *TST? Requests self-test results. *TST? Places a zero (0) in the output queue This command always places a zero (0) in the output queue. This command is included for common command compatibility only;...
Page 774 Series 2600B System SourceMeter® instrument Reference Manual Section 11: Common commands 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 2600B Returns the 2600B and all devices on the GPIB to known conditions.
Page 775 Section 11: Common commands Series 2600B System SourceMeter® instrument Reference Manual Use the go to local (GTL) command to put a remote-mode instrument into local mode. Leaving the remote state also restores operation of all front-panel controls. Use the device clear (DCL) command to clear the GPIB interface and return it to a known state. The DCL command is not an addressed command, so all instruments equipped to implement DCL are returned to a known state simultaneously.
Page 776 Section 12 Status model In this section: Overview ................12-1 Clearing registers ..............12-14 Programming enable and transition registers ....... 12-14 Reading registers ..............12-15 Status byte and service request (SRQ) ........ 12-15 Status register sets .............. 12-20 TSP-Link system status ............12-25 Overview Each Keithley Instruments 2600B provides status registers and queues that are collectively referred to as the status model.
Page 777 Section 12: Status model Series 2600B 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 778 Series 2600B System SourceMeter® instrument Reference Manual Section 12: 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 779 Section 12: Status model Series 2600B System SourceMeter® instrument Reference Manual Status function summary Type Function or attribute status.condition Status summary status.node_enable status.node_event status.request_enable status.request_event status.reset status.measurement.* Measurement event status.measurement.buffer_available.* status.measurement.current_limit.* status.measurement.instrument.* status.measurement.instrument.smuX.* status.measurement.protection.* status.measurement.reading_overflow.* status.measurement.voltage_limit.* status.operation.* Operation status status.operation.calibrating.* status.operation.instrument.* status.operation.instrument.digio.* status.operation.instrument.digio.trigger_overrun.*...
Page 780 Series 2600B System SourceMeter® instrument Reference Manual Section 12: Status model Status model diagrams The following figures graphically describe the status model: • Status byte and service request enable register (on page 12-5) • System summary and standard event registers (on page 12-6) •...
Page 781 Section 12: Status model Series 2600B System SourceMeter® instrument Reference Manual Figure 137: Status byte and service request enable register 12-6 2600BS-901-01 Rev. F/August 2021...
Page 782 Series 2600B System SourceMeter® instrument Reference Manual Section 12: Status model Figure 138: System summary and standard event registers 2600BS-901-01 Rev. F/August 2021 12-7...
Page 783 Section 12: Status model Series 2600B System SourceMeter® instrument Reference Manual Figure 139: Measurement event registers 12-8 2600BS-901-01 Rev. F/August 2021...
Page 784 Series 2600B System SourceMeter® instrument Reference Manual Section 12: Status model Figure 140: Operation status registers 2600BS-901-01 Rev. F/August 2021 12-9...
Page 785 Section 12: Status model Series 2600B System SourceMeter® instrument Reference Manual Figure 141: Operation status trigger overrun registers 12-10 2600BS-901-01 Rev. F/August 2021...
Page 786 Series 2600B System SourceMeter® instrument Reference Manual Section 12: Status model Figure 142: Operation status trigger timer, trigger blender, and remote registers 2600BS-901-01 Rev. F/August 2021 12-11...
Page 787 Section 12: Status model Series 2600B System SourceMeter® instrument Reference Manual Figure 143: Operation status digital I/O and TSP-Link registers 12-12 2600BS-901-01 Rev. F/August 2021...
Page 788 Series 2600B System SourceMeter® instrument Reference Manual Section 12: Status model Figure 144: Questionable status registers 2600BS-901-01 Rev. F/August 2021 12-13...
Page 789 Section 12: Status model Series 2600B System SourceMeter® instrument Reference Manual 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 790 Series 2600B System SourceMeter® instrument Reference Manual Section 12: 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 791 Section 12: Status model Series 2600B 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 792 Series 2600B System SourceMeter® instrument Reference Manual Section 12: 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 793 Section 12: Status model Series 2600B System SourceMeter® instrument Reference Manual You can set or clear the individual bits of the Service Request Enable Register 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 794 Series 2600B System SourceMeter® instrument Reference Manual Section 12: 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 795 Section 12: Status model Series 2600B 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 796 Series 2600B System SourceMeter® instrument Reference Manual Section 12: 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 2600B instrument is ready to accept new commands.
Page 797 Section 12: Status model Series 2600B System SourceMeter® instrument Reference Manual Figure 146: Standard Event Register Standard event commands Command Description *ESR? Read Standard Event Status Register. print(status.standard.event) *ESE mask Program the Event Status Enable Register: mask = 0 to 255 status.standard.enable = mask Status register set contents (on page 12-1).
Page 798 Series 2600B System SourceMeter® instrument Reference Manual Section 12: Status model This register set feeds to bit B7 (OSB) of the Status Byte. The bits used in the Operation Status Register set are described as follows: • Bit B0, Calibrating (CAL): Set bit indicates that one or more channels are calibrating. •...
Page 799 Section 12: Status model Series 2600B System SourceMeter® instrument Reference Manual When reading a register, a numeric value is returned. The binary equivalent of this value indicates which bits in the register are set. For details, see Reading registers (on page 12-15). For example, the following command reads the Questionable Status Enable Register: print(status.questionable.enable) For more information about the Questionable Status Registers, refer to...
Page 800 Series 2600B System SourceMeter® instrument Reference Manual Section 12: Status model Commands to program and read the register are summarized in the Status function summary page 12-3) table. For more information about the Measurement Event Registers, refer to Status register set contents (on page 12-1) and the figures in this section.
Page 801 Section 12: Status model Series 2600B System SourceMeter® instrument Reference Manual Status model configuration example In this example, a current limit (compliance) event in SMU A or B of node 15 sets the RQS bit of the Status Byte of the master node. The commands to configure the status model for this example are provided in Status configuration (enable) commands (on page 12-26).
Page 802 Series 2600B System SourceMeter® instrument Reference Manual Section 12: Status model The affected status registers for the above commands are indicated by labels A, B and C (see following figure). Master node system summary registers: The following commands enable the required system summary bits for node 15: status.system2.enable = 2 status.system.enable = 1...
Page 803 Section 13 Display character codes In this section: 2600B display character codes ..........13-1 2600B display character codes The following tables contain the decimal values of the display character codes and the corresponding displays. Display character codes (decimal 0 to 39) Decimal Display Decimal...
Page 804 Section 13: Display character codes Series 2600B System SourceMeter® instrument Reference Manual Display character codes (decimal 40 to 102) Decimal Display Decimal Display Decimal Display > , (comma) ' (open single quote) < 13-2 2600BS-901-01 Rev. F/August 2021...
Page 805 Series 2600B System SourceMeter® instrument Reference Manual Section 13: Display character codes Display character codes (decimal 103 to 165) Decimal Display Decimal Display Decimal Display (space) ¼ 2600BS-901-01 Rev. F/August 2021 13-3...
Page 806 Section 13: Display character codes Series 2600B System SourceMeter® instrument Reference Manual Display character codes (decimal 166 to 228) Decimal Display Decimal Display Decimal Display  æ  Æ  â  ä   á  ß à  ...
Page 807 Series 2600B System SourceMeter® instrument Reference Manual Section 13: Display character codes Display character codes (decimal 229 to 255) Decimal Display Decimal Display Decimal Display ó ñ ò Ñ ÿ Ö † û  ü  ú  ù → Ü...
Page 808 Section 14 Model 2400 emulation In this section: Model 2400 emulation ............14-1 Model 2400 compatibility ............14-3 Model 2400 emulation The 2600B provides for emulation of the Model 2400 command set using a personality script named Persona2400. When run, this script takes control of the remote command interfaces and interprets any commands received.
Page 809 Section 14: Model 2400 emulation Series 2600B System SourceMeter® instrument Reference Manual To use a flash drive to load the script to the instrument, refer to Load a script from the instrument front panel (on page 8-5). To use a remote command interface to load the script to the instrument, refer to Load a script by sending commands over the remote interface (on page 8-4).
Page 810 Series 2600B System SourceMeter® instrument Reference Manual Section 14: Model 2400 emulation Execute SCPI commands when not in Model 2400 emulation mode You can execute SCPI commands when not in Model 2400 emulation mode. To accomplish this, send the Initialize2400() command once and then send the Execute2400() command with the SCPI command as a parameter in quotes.
Page 811 Section 14: Model 2400 emulation Series 2600B System SourceMeter® instrument Reference Manual Timestamps When the automatic timestamp reset feature is enabled, the timestamp is automatically reset when the first measurement is made. This differs from the operation of an actual Model 2400, where the timestamp is automatically reset when exiting the idle layer of the trigger model.
Page 812 Series 2600B System SourceMeter® instrument Reference Manual Section 14: Model 2400 emulation Digital I/O mapping The 2604B, 2614B, and 2634B do not have digital input/output lines. When in Model 2400 emulation mode, digital I/O lines 1 through 9 are used to emulate different Model 2400 lines through the digital I/O port (see Digital I/O port (on page 4-38)).
Page 813 Section 14: Model 2400 emulation Series 2600B System SourceMeter® instrument Reference Manual Model 2400 SCPI command support The following table provides a listing of Model 2400 commands and emulation support for the 2600B. In the supported column: Yes indicates the command is fully supported; No indicates the command is not supported;...
Page 814 Series 2600B System SourceMeter® instrument Reference Manual Section 14: Model 2400 emulation Subsystem Command Supported :CALCulate :CALCulate2:LIMit[2|3|5-12]:LOWer[:DATA]? [DEFault|MINimum|MAXimum] :CALCulate :CALCulate2:LIMit[2|3|5-12]:LOWer:SOURce2 <NRf>|<NDN> :CALCulate :CALCulate2:LIMit[2|3|5-12]:LOWer:SOURce2? :CALCulate :CALCulate2:LIMit[2|3|5-12]:PASS:SOURce2 <NRf>|<NDN> :CALCulate :CALCulate2:LIMit[2|3|5-12]:PASS:SOURce2? :CALCulate :CALCulate2:LIMit[2|3|5-12]:STATe <Bool> :CALCulate :CALCulate2:LIMit[2|3|5-12]:STATe? :CALCulate :CALCulate2:LIMit[2|3|5-12]:UPPer[:DATA] <NRf>|DEFault|MINimum|MAXimum :CALCulate :CALCulate2:LIMit[2|3|5-12]:UPPer[:DATA]? [DEFault|MINimum|MAXimum] :CALCulate :CALCulate2:LIMit[2|3|5-12]:UPPer:SOURce2 <NRf>|<NDN> :CALCulate :CALCulate2:LIMit[2|3|5-12]:UPPer:SOURce2? :CALCulate :CALCulate2:LIMit4:FAIL? :CALCulate :CALCulate2:LIMit4:SOURce2 <NRf>...
Page 815 Section 14: Model 2400 emulation Series 2600B System SourceMeter® instrument Reference Manual Subsystem Command Supported :FORMat:SREGister ASCii|HEXadecimal|OCTal|BINary :FORMat :FORMat:SREGister? :FORMat :CONFigure? :MEASure :CONFigure:CURRent[:DC] :MEASure :CONFigure:RESistance :MEASure :CONFigure:VOLTage[:DC] :MEASure :FETCh? :MEASure :MEASure? :MEASure :MEASure:CURRent[:DC]? :MEASure :MEASure:RESistance? :MEASure :MEASure:VOLTage[:DC]? :MEASure :OUTPut[1]:ENABle:STATe <Bool> :OUTPut :OUTPut[1]:ENABle:STATe? :OUTPut...
Page 816 Series 2600B System SourceMeter® instrument Reference Manual Section 14: Model 2400 emulation Subsystem Command Supported [:SENSe[1]]:FUNCtion[:ON]:ALL :SENSe[1] [:SENSe[1]]:FUNCtion[:ON]:COUNt? :SENSe[1] [:SENSe[1]]:FUNCtion:STATe? "CURRent[:DC]"|"VOLTage[:DC]"|"RESistance" :SENSe[1] [:SENSe[1]]:RESistance:MODE MANual|AUTO :SENSe[1] Partially [:SENSe[1]]:RESistance:MODE? :SENSe[1] [:SENSe[1]]:RESistance:NPLCycles <NRf>|DEFault|MINimum|MAXimum :SENSe[1] [:SENSe[1]]:RESistance:NPLCycles? [DEFault|MINimum|MAXimum] :SENSe[1] [:SENSe[1]]:RESistance:OCOMpensated <Bool> :SENSe[1] [:SENSe[1]]:RESistance:OCOMpensated? :SENSe[1] [:SENSe[1]]:RESistance:RANGe:AUTO <Bool> :SENSe[1] Partially [:SENSe[1]]:RESistance:RANGe:AUTO?
Page 817 Section 14: Model 2400 emulation Series 2600B System SourceMeter® instrument Reference Manual Subsystem Command Supported :SOURce[1]:CURRent:MODE FIXed|LIST|SWEep :SOURce :SOURce[1]:CURRent:MODE? :SOURce :SOURce[1]:CURRent:RANGe <NRf>|DEFault|MINimum|MAXimum|UP|DOWN :SOURce :SOURce[1]:CURRent:RANGe? [DEFault|MINimum|MAXimum] :SOURce :SOURce[1]:CURRent:RANGe:AUTO <Bool> :SOURce :SOURce[1]:CURRent:RANGe:AUTO? :SOURce :SOURce[1]:CURRent:SPAN <NRf>|DEFault|MINimum|MAXimum :SOURce :SOURce[1]:CURRent:SPAN? [DEFault|MINimum|MAXimum] :SOURce :SOURce[1]:CURRent:STARt <NRf>|DEFault|MINimum|MAXimum :SOURce :SOURce[1]:CURRent:STARt? [DEFault|MINimum|MAXimum] :SOURce :SOURce[1]:CURRent:STEP <NRf>|DEFault|MINimum|MAXimum...
Page 818 Series 2600B System SourceMeter® instrument Reference Manual Section 14: Model 2400 emulation Subsystem Command Supported :SOURce[1]:SWEep:POINts? [DEFault|MINimum|MAXimum] :SOURce :SOURce[1]:SWEep:RANGing BEST|AUTO|FIXed :SOURce Partially :SOURce[1]:SWEep:RANGing? :SOURce :SOURce[1]:SWEep:SPACing LINear|LOGarithmic :SOURce :SOURce[1]:SWEep:SPACing? :SOURce :SOURce[1]:VOLTage:CENTer <NRf>|DEFault|MINimum|MAXimum :SOURce :SOURce[1]:VOLTage:CENTer? [DEFault|MINimum|MAXimum] :SOURce :SOURce[1]:VOLTage[:LEVel][:IMMediate][:AMPLitude] :SOURce <NRf>|DEFault|MINimum|MAXimum :SOURce[1]:VOLTage[:LEVel][:IMMediate][:AMPLitude]? :SOURce [DEFault|MINimum|MAXimum] :SOURce[1]:VOLTage[:LEVel]:TRIGgered[:AMPLitude] :SOURce...
Page 819 Section 14: Model 2400 emulation Series 2600B System SourceMeter® instrument Reference Manual Subsystem Command Supported :STATus:MEASurement[:EVENt]? :STATus :STATus:OPERation:CONDition? :STATus :STATus:OPERation:ENABle <NDN>|<NRf> :STATus :STATus:OPERation:ENABle? :STATus :STATus:OPERation[:EVENt]? :STATus :STATus:PRESet :STATus :STATus:QUEStionable:CONDition? :STATus :STATus:QUEStionable:ENABle <NDN>|<NRf> :STATus :STATus:QUEStionable:ENABle? :STATus :STATus:QUEStionable[:EVENt]? :STATus :STATus:QUEue:CLEar :STATus :STATus:QUEue:DISable <list> :STATus :STATus:QUEue:DISable? :STATus...
Page 820 Series 2600B System SourceMeter® instrument Reference Manual Section 14: Model 2400 emulation Subsystem Command Supported :SYSTem:PRESet :SYSTem :SYSTem:RCMode SINGle|MULTiple :SYSTem :SYSTem:RCMode? :SYSTem :SYSTem:RSENse <Bool> :SYSTem :SYSTem:RSENse? :SYSTem :SYSTem:RWLock <Bool> :SYSTem :SYSTem:RWLock? :SYSTem :SYSTem:TIME? :SYSTem :SYSTem:TIME:RESet :SYSTem :SYSTem:TIME:RESet:AUTO <Bool> :SYSTem :SYSTem:TIME:RESet:AUTO? :SYSTem :SYSTem:VERSion? :SYSTem...
Page 821 Section 14: Model 2400 emulation Series 2600B System SourceMeter® instrument Reference Manual Subsystem Command Supported :TRIGger[:SEQuence[1]][:TCONfigure][:ASYNchronous]:INPut :TRIGger Partially SOURce|DELay|SENSe|NONE :TRIGger[:SEQuence[1]][:TCONfigure][:ASYNchronous]:INPut? :TRIGger :TRIGger[:SEQuence[1]][:TCONfigure][:ASYNchronous]:OLINe 1|2|3|4 :TRIGger Partially :TRIGger[:SEQuence[1]][:TCONfigure][:ASYNchronous]:OLINe? :TRIGger :TRIGger[:SEQuence[1]][:TCONfigure][:ASYNchronous]:OUTPut :TRIGger SOURce|DELay|SENSe|NONE :TRIGger[:SEQuence[1]][:TCONfigure][:ASYNchronous]:OUTPut? :TRIGger :TRIGger[:SEQuence[1]][:TCONfigure]:DIRection SOURce|ACCeptor :TRIGger :TRIGger[:SEQuence[1]][:TCONfigure]:DIRection? :TRIGger :TRIGger:SEQuence2:SOURce <name> :TRIGger :TRIGger:SEQuence2:SOURce? :TRIGger :TRIGger:SEQuence2:TOUT <NRf>|DEFault|MINimum|MAXimum...
Page 822 Series 2600B System SourceMeter® instrument Reference Manual Section 14: Model 2400 emulation :ROUte subsystem :ROUTe:TERMinals FRONt|REAR The instrument accepts the command and ignores it. :ROUTe:TERMinals? The instrument always returns REAR. :SENSe[1] subsystem [:SENSe[1]]:CURRent[:DC]:PROTection:RSYNchronize <Bool> The measurement range only tracks the limit range when the output is on. [:SENSe[1]]:FUNCtion:OFF:ALL Readings are not made when all the functions are turned off.
Page 823 Section 14: Model 2400 emulation Series 2600B System SourceMeter® instrument Reference Manual :SYSTem subsystem :SYSTem:AZERo:CACHing:NPLCycles? Always returns 0. :SYSTem:AZERo:CACHing:REFResh This command is accepted and ignored. Causes no action or response. :SYSTem:AZERo:CACHing:RESet This command is accepted and ignored. Causes no action or response. :SYSTem:AZERo:CACHing[:STATe] <Bool>...
Page 824 Section 15 Frequently asked questions In this section: How do I display the instrument's serial number? ....15-1 How do I optimize performance? ..........15-1 How do I upgrade the firmware? ..........15-2 How do I use the digital I/O port? ........... 15-2 How do I trigger other instruments? ........
Page 825 Section 15: Frequently asked questions Series 2600B System SourceMeter® instrument Reference Manual Disabling autozero to increase speed Disabling autozero (setting it to OFF) can increase measurement speed. If autozero is disabled, accuracy drifts with time and temperature. Turning autozero OFF disables the autozero function and possibly increases measurement speed. To minimize drift, setting autozero to ONCE performs an autozero operation one time (when it is selected), and then disables the autozero function.
Page 826 Series 2600B System SourceMeter® instrument Reference Manual Section 15: Frequently asked questions How do I trigger other instruments? You can use the 2600B digital input/output to control an external digital circuit, such as a device handler used to perform binning operations. For more information about the 2600B digital I/O port, Digital I/O (on page 4-38).
Page 827 Section 15: Frequently asked questions Series 2600B System SourceMeter® instrument Reference Manual More information about triggering To obtain precise timing and synchronization between instruments, use the remote trigger model. For more information about the remote trigger model and interactive triggering using other trigger objects, Triggering (on page 4-1).
Page 828 Series 2600B System SourceMeter® instrument Reference Manual Section 15: Frequently asked questions How do I store measurements in nonvolatile memory? After the measurements are complete, you can save the reading buffer data to the nonvolatile memory in the instrument. To save the reading buffer data: 1.
Page 829 Section 15: Frequently asked questions Series 2600B System SourceMeter® instrument Reference Manual How do I make contact check measurements? The Models 2604B, 2614B, and 2634B do not perform contact check measurements. For information about making contact check measurements, see Contact check measurements page 2-22) and Contact check (on page 2-7).
Page 830 Series 2600B System SourceMeter® instrument Reference Manual Section 15: Frequently asked questions Figure 149: Typical low-current connections 2600B interlock digital I/O. Pin 24 (INT) and pin 22 (5 V dc) are connected to the test fixture lid switch. The interlock switch is shown in the disengaged, or lid open, position. Normally-open (NO) interlock metal safety enclosure.
Page 831 Section 15: Frequently asked questions Series 2600B System SourceMeter® instrument Reference Manual Low-current measurement programming example Example code for a typical low-current measurement is shown below. This code assumes that a 100 GΩ resistor is being tested. -- Restore defaults. smua.reset() -- Set source to DC V.
Page 832 Series 2600B System SourceMeter® instrument Reference Manual Section 15: Frequently asked questions To configure the line frequency from a remote interface: Set the localnode.linefreq or the localnode.autolinefreq attribute. To set the line frequency to 60 Hz, send: localnode.linefreq = 60 To configure the instrument to automatically detect line frequency at each power-up: localnode.autolinefreq = true Where can I get the LabVIEW driver?
Page 833 Section 15: Frequently asked questions Series 2600B System SourceMeter® instrument Reference Manual Where can I find the Model 2400 emulation script? The 2600B provides for emulation of the Model 2400 command set using an emulation script. When run, this script takes control of the remote command interfaces and interprets any commands received.
Page 834 Specifications are subject to change without notice. All Keithley trademarks and trade names are the property of Keithley Instruments. All other trademarks and trade names are the property of their respective companies. Keithley Instruments Corporate Headquarters • 28775 Aurora Road • Cleveland, Ohio 44139 • 440-248-0400 • 1-800-833-9200 • tek.com/keithley 07/2020...

This manual is also suitable for:

Keithley 2604b Keithley 2614b Keithley 2634b

Save PDF