Download Print this page

Tektronix Keithley 2651A Reference Manual

High power system sourcemeter instrument

page of 924

/ 924
Contents
Table of Contents
Bookmarks

Table of Contents

Advertisement

Quick Links

Download this manual

tek.com/keithley

Model 2651A High Power

System SourceMeter Instrument

Reference Manual

2651A-901-01 Rev. C October 2021

*P2651A-901-01C*

2651A-901-01C

Table of Contents

Advertisement

Chapters

Table of Contents

Need help?

Need help?

Do you have a question about the Keithley 2651A and is the answer not in the manual?

Questions and answers

Summary of Contents for Tektronix Keithley 2651A

Page 1 tek.com/keithley Model 2651A High Power System SourceMeter Instrument Reference Manual 2651A-901-01 Rev. C October 2021 *P2651A-901-01C* 2651A-901-01C...
Page 2 Model 2651A ® High Power 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. , TSP-Link , and TSP-Net 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 Table of contents Introduction ......................1-1 Welcome ..........................1-1 Extended warranty ....................... 1-1 Contact information ......................1-1 Customer documentation ..................... 1-2 Organization of manual sections ....................1-2 Capabilities and features...................... 1-3 Model-specific capabilities ....................1-4 General information ......................1-4 Displaying the serial number ..................... 1-4 General operation ....................
Page 7 Table of contents Model 2651A High Power System SourceMeter® Instrument Reference Manual 4-wire remote sensing connections ..................2-48 Contact check connections ..................... 2-49 Multiple SMU connections ....................... 2-50 Combining SMU outputs ......................2-51 Guarding and shielding ......................2-57 Test fixture ..........................2-62 Floating a SMU ........................
Page 8 Model 2651A High Power System SourceMeter® Instrument Reference Manual Table of contents Sweep operation ........................ 3-21 Sweep characteristics ......................3-23 Configuring and running sweeps ..................... 3-31 Sweeping using factory scripts ....................3-33 Sweep programming examples ....................3-34 Triggering ........................... 3-36 Remote triggering overview.....................
Page 9 Table of contents Model 2651A High Power System SourceMeter® Instrument Reference Manual Pulse rise and fall times ......................4-29 Pulse width ..........................4-30 Remote commands ....................5-1 Introduction to TSP operation ....................5-1 Controlling the instrument by sending individual command messages ........5-1 Queries .............................
Page 10 Model 2651A High Power System SourceMeter® Instrument Reference Manual Table of contents Lua basics ..........................6-15 Standard libraries ........................6-30 Script with a for loop ........................ 6-34 Test Script Builder ......................6-34 Installing the TSB software...................... 6-35 Using Test Script Builder (TSB) ....................6-35 Project navigator ........................
Page 11 Table of contents Model 2651A High Power System SourceMeter® Instrument Reference Manual Using the TSP command reference ..................7-3 Command name and summary table ..................7-4 Command usage ........................7-5 Command details ........................7-6 Example section ........................7-6 Related commands and information ..................7-7 TSP commands ........................
Page 12 Model 2651A High Power System SourceMeter® Instrument Reference Manual Table of contents digio.trigger[N].release() ......................7-65 digio.trigger[N].reset() ......................7-65 digio.trigger[N].stimulus ......................7-66 digio.trigger[N].wait() ....................... 7-68 digio.writebit() .......................... 7-69 digio.writeport() ........................7-70 digio.writeprotect ........................7-71 display.clear() .......................... 7-71 display.getannunciators() ......................7-72 display.getcursor() ........................7-74 display.getlastkey() .........................
Page 13 Table of contents Model 2651A High Power System SourceMeter® Instrument Reference Manual i_leakage_measure() ......................7-125 i_leakage_threshold() ......................7-126 InitiatePulseTest() ......................... 7-128 io.close()..........................7-129 io.flush() ..........................7-130 io.input() ..........................7-131 io.open() ..........................7-132 io.output() ..........................7-133 io.read() ..........................7-134 io.type() ..........................7-135 io.write() ..........................
Page 14 Model 2651A High Power System SourceMeter® Instrument Reference Manual Table of contents localnode.passwordmode ..................... 7-176 localnode.prompts ......................... 7-177 localnode.prompts4882 ......................7-178 localnode.reset() ........................7-179 localnode.revision ......................... 7-180 localnode.serialno ......................... 7-180 localnode.showerrors ......................7-181 makegetter() .......................... 7-182 makesetter() .......................... 7-183 meminfo() ..........................7-184 node[N].execute() ........................
Page 15 Table of contents Model 2651A High Power System SourceMeter® Instrument Reference Manual smuX.cal.restore() ......................... 7-233 smuX.cal.save() ........................7-234 smuX.cal.state ........................7-235 smuX.cal.unlock() ........................7-236 smuX.contact.calibratehi() ..................... 7-236 smuX.contact.calibratelo() ..................... 7-238 smuX.contact.check() ......................7-239 smuX.contact.r() ........................7-240 smuX.contact.speed ......................7-241 smuX.contact.threshold ......................7-242 smuX.makebuffer() ........................
Page 16 Model 2651A High Power System SourceMeter® Instrument Reference Manual Table of contents smuX.trigger.endsweep.action ....................7-292 smuX.trigger.IDLE_EVENT_ID ..................... 7-293 smuX.trigger.initiate() ......................7-294 smuX.trigger.measure.action ....................7-295 smuX.trigger.measure.set() ....................7-296 smua.trigger.measure.stimulus ..................... 7-297 smuX.trigger.measure.Y() ..................... 7-298 smuX.trigger.MEASURE_COMPLETE_EVENT_ID .............. 7-299 smuX.trigger.PULSE_COMPLETE_EVENT_ID ..............7-299 smuX.trigger.source.action....................7-300 smuX.trigger.source.limitY ....................
Page 17 Table of contents Model 2651A High Power System SourceMeter® Instrument Reference Manual status.system2.* ........................7-385 status.system3.* ........................7-388 status.system4.* ........................7-390 status.system5.* ........................7-392 SweepILinMeasureV() ......................7-394 SweepIListMeasureV() ......................7-395 SweepILogMeasureV() ......................7-396 SweepVLinMeasureI() ......................7-398 SweepVListMeasureI() ......................7-399 SweepVLogMeasureI() ......................7-400 timer.measure.t() ........................
Page 18 Model 2651A High Power System SourceMeter® Instrument Reference Manual Table of contents tspnet.timeout ........................7-450 tspnet.tsp.abort() ........................7-451 tspnet.tsp.abortonconnect ..................... 7-452 tspnet.tsp.rbtablecopy() ......................7-453 tspnet.tsp.runscript() ......................7-454 tspnet.write() ......................... 7-455 userstring.add() ........................7-456 userstring.catalog() ....................... 7-457 userstring.delete() ......................... 7-458 userstring.get() ........................7-458 waitcomplete() ........................
Page 19 Table of contents Model 2651A High Power System SourceMeter® Instrument Reference Manual Next steps ....................... 10-1 Additional Model 2651A information .................. 10-1 Maintenance ......................11-1 Introduction ........................11-1 Line fuse replacement ......................11-1 Front-panel tests ........................ 11-2 Keys test ..........................11-2 Display patterns test ........................
Page 20 Model 2651A High Power System SourceMeter® Instrument Reference Manual Table of contents Confirming the active speed and duplex negotiation ............. 13-12 Confirming port numbers ....................... 13-12 Selecting a LAN interface protocol ................... 13-13 VXI-11 connection ......................... 13-13 Raw socket connection ......................13-13 Dead socket connection ......................
Page 21 Table of contents Model 2651A High Power System SourceMeter® Instrument Reference Manual Questionable Status Registers ....................15-24 Measurement Event Registers ....................15-24 Register programming example .................... 15-26 TSP-Link system status ....................15-26 Status model configuration example ..................15-26 Display character codes ..................16-1 Model 2651A display character codes ................
Page 22 If you have any questions after you review the information in this documentation, please contact your local Keithley Instruments office, sales partner, or distributor. You can also call the Tektronix corporate headquarters (toll-free inside the U.S. and Canada only) at 1-800-833-9200. For worldwide...
Page 23 Section 1: Introduction Model 2651A High Power System SourceMeter® Instrument Reference Manual Customer documentation The documentation for the Model 2651A includes a Quick Start Guide, User's Manual, and Reference Manual. The Model 2651A Quick Start Guide is provided as a hard copy with the instrument. You can also access it from tek.com/keithley as an Adobe Acrobat PDF file.
Page 24 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 1: Introduction • Common commands: Descriptions of IEEE Std. 488.2 common commands. • Status model: Description of the Model 2651A status model. • Display character codes: Listing of the decimal values for the display character codes and their corresponding displays.
Page 25 Section 1: Introduction Model 2651A High Power System SourceMeter® Instrument Reference Manual Model-specific capabilities Additional source and measure features: • Source ± dc voltage from 1 mV to 40.4 V • Source ± dc current from 10 pA to 20.2 A •...
Page 26: Table Of Contents
Section 2 General operation In this section: General ratings ................. 2-1 Controls, indicators, and connectors ........2-2 Cooling vents ................2-8 Starting up your instrument ............2-9 System information ..............2-11 Menu overview ............... 2-11 Beeper ................... 2-18 Display mode ................. 2-19 Basic operation ..............
Page 27: Controls, Indicators, And Connectors
Section 2: General operation Model 2651A High Power System SourceMeter® Instrument Reference Manual Controls, indicators, and connectors Model 2651A controls, indicators, and the USB port are on the front panel (on page 2-2). Make connections to the Model 2651A through connectors on the rear panel (on page 2-6).
Page 28 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 2: General operation 2. SMU setup, performance control, special operation, and numbers SMU (source-measure unit) setup Selects the source function (voltage or current) and places the cursor in the source field for editing.
Page 29 Section 2: General operation Model 2651A High Power System SourceMeter® Instrument Reference Manual Cancels the selection and returns to the previous menu or display. Also used as a EXIT LOCAL key to take the instrument out of remote operation. Accepts the selection and moves to the next choice or exits the menu. ENTER Numbers When enabled and in EDIT mode, the number keys (0 to 9, +/-, 0000) allow direct...
Page 30 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 2: General operation 5. Navigation wheel Turn the navigation wheel to: ▪ Move the cursor to the left and the right (the cursor indicates the selected value or item) ▪ While in edit mode, increase or decrease a selected source or compliance value Push the navigation wheel to: ▪...
Page 31 Section 2: General operation Model 2651A High Power System SourceMeter® Instrument Reference Manual 8. Display indicators (not shown) The items listed below represent the possible display indicators and their meanings. Indicator Meaning Remote (4-wire) sense is selected Source or measure autorange is selected AUTO Instrument is in editing mode EDIT...
Page 32 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 2: General operation 2. DIGITAL I/O Female DB-25 connector. Includes fourteen digital input or output pins, seven GND pins, three +5 V pins, and one pin for output enable. For more information, Digital I/O (on page 3-92).
Page 33: Cooling Vents
Section 2: General operation Model 2651A High Power System SourceMeter® Instrument Reference Manual 10. OUTPUT connector (40 V, 50 A maximum) This connector provides HI/LO connection points for currents. Connections are as follows: LO = Input/Output LO HI = Input/Output HI Cooling vents The Model 2651A has top and side intake vents and a rear exhaust vent.
Page 34: Starting Up Your Instrument
Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 2: General operation Starting up your instrument The following topics describe how to power your instrument on and off, place the instrument in standby, configure the line frequency, and replace the line fuse. Procedure The Model 2651A operates from a line voltage of 100 V to 240 V at a frequency of 50 Hz or 60 Hz.
Page 35 Section 2: General operation Model 2651A High Power System SourceMeter® Instrument Reference Manual Placing the Model 2651A in standby Placing the Model 2651A in standby does not place the instrument in a safe state (an interlock (on page 3-98) is provided for this function). When the instrument is on, the output may be placed in an active output state (output on) or a standby mode (output off).
Page 36: System Information
Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 2: General operation Fuse replacement The power receptacle contains a fuse drawer (refer to Rear panel (on page 2-6)). This fuse protects the power-line input of the instrument. If the line fuse needs to be replaced, refer to Line fuse replacement (on page 11-1).
Page 37 Section 2: General operation Model 2651A High Power System SourceMeter® Instrument Reference Manual Selecting menu items To navigate the Main and Configuration menus, use the front-panel keys as follows: • Press either CURSOR arrow key to highlight an option. • Rotate the navigation wheel (clockwise or counterclockwise) to highlight an option.
Page 38 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 2: General operation Menu trees You can configure instrument operation through the menus that are accessed from the front panel. Main menu The main menu structure is summarized in the following figure and table. For other menu items, see Configuration menu (on page 2-15).
Page 39 Section 2: General operation Model 2651A High Power System SourceMeter® Instrument Reference Manual The following table contains descriptions of the main menu options and cross-references to related information. To access a menu option, press the MENU key, turn the navigation wheel to move the cursor to select an item, and press the navigation wheel.
Page 40 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 2: General operation Configuration menu The configuration menu structure is summarized in the following figure and table. For directions on navigating the menu, see Menu navigation (on page 2-11). For other menu items, see Main menu page 2-13).
Page 41 Section 2: General operation Model 2651A High Power System SourceMeter® Instrument Reference Manual The following table contains descriptions of the configuration menus, as well as cross-references to related information. To select a menu, press the CONFIG key and then the front-panel key associated with the menu (see the description column in the following table).
Page 42 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 2: General operation 4. Press any of the number keys (0-9, +/-, 0000) (see 2. SMU setup, performance control, special operation, and numbers (on page 2-3)). The cursor moves to the next digit on the right. 5.
Page 43: Beeper
Section 2: General operation Model 2651A High Power System SourceMeter® Instrument Reference Manual To edit compliance limit values: 1. Press the LIMIT key. 2. Select the type of compliance (CURRENT, VOLTAGE, or POWER). 3. Press the navigation wheel or the ENTER key to enter edit mode. The EDIT indicator is illuminated.
Page 44: Display Mode
Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 2: General operation Display mode Use the DISPLAY key to scroll through the various display modes shown in the figure below. Refer to Display operations (on page 3-78) for more information about the display. Figure 5: Display modes Basic operation Hazardous voltages may be present on all output and guard terminals.
Page 45 Section 2: General operation Model 2651A High Power System SourceMeter® Instrument Reference Manual Before you begin any of the following front-panel procedures, make sure that you exit out of the menu structure. Press the EXIT (LOCAL) key as many times as needed to return to the main display.
Page 46 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 2: General operation The limit operation of the instrument changes dependent on the source mode (current or voltage), load, and the configured limits (current, voltage, and power). It is important to distinguish both the current and voltage limits from the power limit.
Page 47 Section 2: General operation Model 2651A High Power System SourceMeter® Instrument Reference Manual Setting the limit Front-panel limit Set the limit from the front panel as follows: 1. Press the LIMIT key to directly edit the limit value. Pressing the LIMIT key while in limit edit mode will toggle the display between the complementary function limit and the power limit display.
Page 48 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 2: General operation Sink operation Carefully consider and configure the appropriate output-off state, source function, and compliance limits before connecting the Model 2651A to a device that can deliver energy (for example, other voltage sources, batteries, capacitors, solar cells, or other Model 2651A instruments).
Page 49 Section 2: General operation Model 2651A High Power System SourceMeter® Instrument Reference Manual Setting the sink mode using the front panel To enable or disable the sink mode from the front panel: 1. Press the CONFIG key and then the SRC key. 2.
Page 50 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 2: General operation When sourcing current, you can measure voltage or current, as shown in the following figure. Figure 7: Fundamental source-measure configuration: Source I Current meter Current source ↑ Voltage meter Basic circuit configurations (on page 4-20) for detailed information.
Page 51 Section 2: General operation Model 2651A High Power System SourceMeter® Instrument Reference Manual To minimize the drift, make a reference and zero measurement immediately before a critical test sequence. You can use the ONCE setting to force a refresh of the reference and zero measurements used for the current aperture setting.
Page 52 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 2: General operation NPLC caching NPLC caching speeds up operation by caching A/D reference and zero values for up to the ten most recent measurement aperture settings. Whenever the integration rate is changed using the SPEED key, or a user setup is recalled, the NPLC cache is checked.
Page 53 Section 2: General operation Model 2651A High Power System SourceMeter® Instrument Reference Manual Step 2: Set the compliance limit Perform the following steps to edit the compliance limit value: 1. Press the LIMIT key. 2. Move the cursor to the digit to change, then press the navigation wheel to enter the EDIT mode, as indicated by the EDIT indicator.
Page 54 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 2: General operation 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 5-1) for more information on using these commands.
Page 55 Section 2: General operation Model 2651A High Power System SourceMeter® Instrument Reference Manual 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 56 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 2: General operation • 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 57 Section 2: General operation Model 2651A High Power System SourceMeter® Instrument Reference Manual Front-panel triggering example This example configures the trigger parameters to meet the following requirements: • Manual triggering (TRIG key) • Infinite trigger count (cycle indefinitely through measurement cycles) •...
Page 58 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 2: General operation 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 Model 2651A to measure voltage or current: 1.
Page 59 Section 2: General operation Model 2651A High Power System SourceMeter® Instrument Reference Manual 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 60 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 2: General operation Remote ohms command Use the smua.measure.r() function to get a resistance reading. The programming example below illustrates how to get a resistance reading: reading = smua.measure.r() Remote source-measure commands (on page 2-29) for more commands to set up source and measure functions, and Introduction to TSP operation...
Page 61 Section 2: General operation Model 2651A High Power System SourceMeter® Instrument Reference Manual Ohms sensing Ohms measurements can be made using either 2-wire or 4-wire sensing. See DUT test connections (on page 2-45) for information on connections and sensing methods. The 2-wire sensing method has the advantage of requiring only two test leads.
Page 62 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 2: General operation 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 63 Section 2: General operation Model 2651A High Power 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 Model 2651A is already connected to the device under test (DUT) as explained in DUT test connections page 2-45).
Page 64 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 2: General operation 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: reading = smua.measure.p()
Page 65 Section 2: General operation Model 2651A High Power System SourceMeter® Instrument Reference Manual 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 (see 4-wire remote sensing connections (on page 2-47) for more detail).
Page 66 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 2: General operation Contact check commands The following table summarizes the basic contact check commands. For complete descriptions of these commands, refer to the TSP command reference (on page 7-1). For connection information, refer to Contact check connections (on page 2-49).
Page 67 Section 2: General operation Model 2651A High Power System SourceMeter® Instrument Reference Manual Contact check programming example The following programming example illustrates the setup and command sequence for a typical contact check measurement. These commands set the contact check speed to fast and the threshold to 100 Ω.
Page 68 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 2: General operation To save a user setup to an external USB flash drive from the front panel: 1. Configure the Model 2651A to the settings that you want to save. 2.
Page 69 Section 2: General operation Model 2651A High Power System SourceMeter® Instrument Reference Manual Start-up configuration You can specify the Model 2651A start-up (power-on) configuration from the front panel. Set the start-up configuration to a previously stored setup (recalled from internal nonvolatile memory) or reset to the factory default setup.
Page 70: Dut Test Connections
Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 2: General operation DUT test connections On some sensitive or easily damaged devices under test (DUTs), the instrument power-up and power-down sequence can apply transient signals to the DUT that may affect or damage it. When testing this type of DUT, do not make final connections to it until the instrument has completed its power-up sequence and is in a known operating state.
Page 71 Section 2: General operation Model 2651A High Power System SourceMeter® Instrument Reference Manual Hazardous voltages may be present on the output and guard terminals. To prevent electrical shock that could cause injury or death, never make or break connections to the Model 2651A while the output is on.
Page 72 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 2: General operation Input/output LO and chassis ground Connections to LO on the Model 2651A 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 73 Section 2: General operation Model 2651A High Power System SourceMeter® Instrument Reference Manual Figure 13: Two-wire resistance connections 4-wire remote sensing connections By default, the Model 2651A instruments are configured to use 2-wire (local) voltage sensing. If you choose to enable 4-wire (remote) voltage sensing, it is critical that you establish and maintain the proper Kelvin connections between the corresponding force and sense leads to ensure the proper operation of the instrument and to make accurate voltage measurements.
Page 74 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 2: General operation When sourcing or measuring voltage in a low-impedance test circuit (see the figure below), there can be errors associated with lead resistance. Voltage source and measure accuracy are optimized by using 4-wire remote sense connections.
Page 75 Section 2: General operation Model 2651A High Power System SourceMeter® Instrument Reference Manual Multiple SMU connections Connections to LO on the Model 2651A 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 76 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 2: General operation Figure 15: Two SMUs connected to a 3-terminal device (local sensing) The outputs of multiple SMUs can also be combined to obtain higher current and voltage levels (pulse only operation).
Page 77 Section 2: General operation Model 2651A High Power System SourceMeter® Instrument Reference Manual Pulse characteristics of the Model 2651A When combining the outputs of two Model 2651A High Power System SourceMeter ® Instruments, restrict operation to pulse only for all operating areas (both the standard and the extended operating areas).
Page 78 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 2: General operation Configuration guidelines Configuration guidelines are presented in the following table. Additional information, including examples on combining SMU channels, can be found in application notes on tek.com/keithley. Application notes include "Testing to 100A by Combining Keithley Model 2651A High Power SourceMeter Instruments."...
Page 79 Section 2: General operation Model 2651A High Power System SourceMeter® Instrument Reference Manual SourceMeter instrument configuration Guidelines Source voltage using series SMUs Maximum Pulsed Signal Levels for Model 2651A: 80 V with 45 A compliance SMU 1 configuration: Output-off mode: smuX.source.offmode = smuX.OUTPUT_NORMAL Output-off function: smuX.source.offfunc = smuX.OUTPUT_DCVOLTS...
Page 80 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 2: General operation SourceMeter instrument configuration Guidelines Source voltage with extended current using Maximum Pulsed Signal Levels for Model 2651A: parallel SMUs 36 V with 95 A compliance SMU 1 configuration: Output-off mode: smuX.source.offmode = smuX.OUTPUT_NORMAL Output-off function:...
Page 81 Section 2: General operation Model 2651A High Power System SourceMeter® Instrument Reference Manual Higher pulse voltage can be output by connecting two (and only two) Model 2651A instrument's channels in series. When combining two SMU channels, make sure both SMUs have the same model number.
Page 82 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 2: General operation Combining channels in parallel to output higher current You can output higher pulse current by connecting the channels of two Model 2651A instruments in parallel. When combining two SMU channels, make sure both SMUs have the same model number. The figure below illustrates the connection scheme of two Model 2651A instruments connected in parallel.
Page 83 Section 2: General operation Model 2651A High Power System SourceMeter® Instrument Reference Manual Safety shielding and hazardous voltages The maximum output voltage for a Model 2651A channel is 40 V, which is considered a nonhazardous level. However, using two Model 2651A voltage sources in a series configuration or floating a SMU (on page 2-63) can cause test circuit voltage to exceed 42 V.
Page 84 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 2: General operation Guarding (shown below) is recommended when test circuit impedance is >1 GΩ. Guard (on page 4-23) for details on the principles of guarding. Guard voltage can be hazardous. With an unguarded device under test (DUT) connection, terminate the guard before the end of the cable.
Page 85 Section 2: General operation Model 2651A High Power System SourceMeter® Instrument Reference Manual Connections to LO on the Model 2651A 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 86 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 2: General operation Figure 22: Connections for noise shield, safety shield, and guarding 2651A-901-01 Rev. C October 2021 2-61...
Page 87 Section 2: General operation Model 2651A High Power System SourceMeter® Instrument Reference Manual Test fixture A test fixture can be used to house a device or test circuit. The test fixture can be a metal or nonconductive enclosure, and is typically equipped with a lid. When the test fixture is correctly connected, the output of the Model 2651A will turn off when the lid of the test fixture is opened.
Page 88 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 2: General operation The digital I/O port of the Model 2651A is not suitable for control of safety circuits and should not be used to control a safety interlock. Digital I/O (on page 3-92) for information on the digital I/O port.
Page 89: Dut Connection Settings
Section 2: General operation Model 2651A High Power System SourceMeter® Instrument Reference Manual Figure 24: Floating the 2651A SMU connections The external voltage source can be a SMU of a second Model 2651A instrument or other instrument. Keep in mind that if the combined outputs of the sources exceeds 42 V, then a safety shield will be required for the DUT (see the following WARNINGS).
Page 90 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 2: General operation Front-panel sense mode selection To check or change the voltage sense mode from the front panel: 1. Press the CONFIG key. 2. Press the SRC or MEAS key. You can access and set the Model 2651A sense mode from either the V-SOURCE or the V-MEAS menu items.
Page 91 Section 2: General operation Model 2651A High Power System SourceMeter® Instrument Reference Manual Normal output-off mode The normal output-off mode is the default output-off mode setting. When the source-measure unit (SMU) is in the normal output-off mode, you can select either the current or the voltage output-off function (see Output-off function (on page 2-67)).
Page 92 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 2: General operation To select the zero output-off mode over a remote interface: smua.source.offmode = smua.OUTPUT_ZERO Output-off function This setting is used only when the output is turned off and the Model 2651A is set to the normal output-off mode (smua.source.offmode = smua.OUTPUT_NORMAL).
Page 93 Section 2: General operation Model 2651A High Power System SourceMeter® Instrument Reference Manual To configure the output-off function remotely: To set 0 V output with current limit set by the smua.source.offlimiti attribute: smua.source.offfunc = smua.OUTPUT_DCVOLTS To set 0 A output with voltage limit set by the smua.source.offlimitv attribute: smua.source.offfunc = smua.OUTPUT_DCAMPS Output-off limits (compliance) You can set output-off limits (compliance) for the current and voltage output-off functions using the...
Page 94 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 2: General operation Remote programming output-off states quick reference The content of the following table is a quick reference of commands for programming output-off states from a remote interface. Output-off state programming quick reference Command Description smua.source.offmode = smua.OUTPUT_NORMAL...
Page 95 Section 2: General operation Model 2651A High Power System SourceMeter® Instrument Reference Manual Connecting the USB flash drive The Model 2651A supports flash drives that comply with USB 2.0 standards (as well as USB 1.0 and 1.1 standards). You can save data to the USB flash drive from the front panel, or you can create a script to save data to the USB flash drive.
Page 96: Displayed Error And Status Messages
Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 2: General operation The following Lua fs commands are not supported: fs.chmod() fs.chown() fs.stat() Displayed error and status messages During operation and programming, front-panel messages may be briefly displayed. Typical messages are either status or error notifications (refer to the Error summary list (on page 8-3) for a...
Page 97 Section 2: General operation Model 2651A High Power System SourceMeter® Instrument Reference Manual Available ranges The following table lists the available source and measurement ranges for the Keithley Instruments ® Model 2651A High Power System SourceMeter Instrument. Model 2651A source and measurement ranges Voltage ranges Current ranges 100 mV...
Page 98 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 2: General operation 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 7-248) attribute either to a specific value or to an autodelay...
Page 99 Section 2: General operation Model 2651A High Power System SourceMeter® Instrument Reference Manual If the instrument displays the overflow message on a particular range, select a higher range until an on-range reading is displayed. To ensure the best accuracy and resolution, use the lowest range possible that does not cause an overflow.
Page 100 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 2: General operation Range considerations The source range and measure range settings can interact depending on the source function. Additionally, the output state (on/off) can affect how the range is set. The following table describes these interactions: If...
Page 101 Section 2: General operation Model 2651A High Power System SourceMeter® Instrument Reference Manual Range programming Range commands The following tables summarize commands necessary to control measure and source ranges. See TSP command reference (on page 7-1) for more details about these commands. Measure range commands* Command Description...
Page 102: Digits
Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 2: General operation Range programming example The programming example below illustrates how to control both source and measure ranges. The Model 2651A is set up as follows: • Voltage source range: Auto •...
Page 103: Speed
Section 2: General operation Model 2651A High Power System SourceMeter® Instrument Reference Manual Digits programming example -- Select 5.5 digits. display.smua.digits = display.DIGITS_5_5 Speed The Model 2651A has two analog-to-digital converters (ADCs): one integrating, one high speed. Fastest reading rates are achieved by selecting the fast ADC. You can select the fast ADC by pressing the SPEED key and choosing the FAST option.
Page 104 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 2: General operation Selecting the FAST menu item selects the fast analog-to-digital converter (ADC). All other menu items on the speed menu select the integrating ADC. Setting the speed using the remote interface The following table summarizes commands to control speed.
Page 105: Remote Communications Interfaces
Section 2: General operation Model 2651A High Power System SourceMeter® Instrument Reference Manual Remote communications interfaces You can choose from one of several communication interfaces to send commands to and receive responses from the Model 2651A. You can control the Model 2651A from only one communications interface at a time. The first interface on which the instrument receives a message takes control of the instrument.
Page 106 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 2: General operation Figure 26: IEEE-488, LAN, and RS-232 connections 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.
Page 107 Section 2: General operation Model 2651A High Power System SourceMeter® Instrument Reference Manual Figure 27: LAN connection 1 Model 2651A ethernet port (LAN) 2 Straight-through LAN cable or crossover LAN cable 3 Ethernet port (on the host computer) LAN status LEDs The figure below illustrates the two status light-emitting diodes (LEDs) that are on the LAN port of the instrument.
Page 108 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 2: General operation Monitoring the LAN The lan.autoconnect command configures the instrument to monitor the LAN for lost connections. All ethernet connections are disconnected if the LAN link is disconnected for longer than the time-out value specified in the lan.linktimeout attribute.
Page 109 Section 2: General operation Model 2651A High Power System SourceMeter® Instrument Reference Manual To allow many parallel connections to one instrument, stack the connectors. Each connector has two screws on it to ensure that connections remain secure. The figure below shows a typical connection diagram for a test system with multiple instruments.
Page 110 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 2: General operation 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 111 Section 2: General operation Model 2651A High Power System SourceMeter® Instrument Reference Manual General bus commands General commands are commands that have the same general meaning, regardless of the instrument (for example, DCL). The following table lists the general bus commands. General bus commands Command Effect on Model 2651A...
Page 112 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 2: General operation 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 113 Section 2: General operation Model 2651A High Power System SourceMeter® Instrument Reference Manual SPE, SPD Use the serial polling sequence to obtain the Model 2651A serial poll byte. The serial poll byte contains important information about internal functions (see Status model (on page 15-1)).
Page 114 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 2: General operation 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 115 Section 2: General operation Model 2651A High Power 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 Model 2651A, connect a controller or personal computer to the Model 2651A RS-232 interface.
Page 116 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 2: General operation RS-232 programming example The programming example below illustrates how to set the baud rate to 9600 with no flow control: serial.baud = 9600 serial.flowcontrol = serial.FLOW_NONE Sending and receiving data The RS-232 interface transfers data using 7 or 8 data bits;...
Page 117 Section 2: General operation Model 2651A High Power System SourceMeter® Instrument Reference Manual Flow control and signal handshaking Signal handshaking between the controller and the instrument allows the two devices to communicate to each other to determine if they are ready to receive data. The RS-232 interface provides two control lines (request to send and clear to send) for this purpose.
Page 118 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 2: General operation The following table provides pinout identification for the 9-pin (DB-9) or 25-pin (DB-25) serial port connector on the computer. Computer serial port pinout Signal* DB-9 pin number DB-25 pin number DCD, data carrier detect RXD, receive data...
Page 119 Section 3 Functions and features In this section: Relative offset ................3-1 Filters ..................3-3 Reading buffers ................ 3-6 Sweep operation ..............3-21 Triggering ................3-36 High-capacitance mode ............3-73 Display operations ..............3-78 Digital I/O ................3-92 Relative offset When making measurements, you may want to subtract an offset value from a measurement.
Page 120 Section 3: Functions and features Model 2651A High Power System SourceMeter® Instrument Reference Manual Defining a relative offset value from the front panel You can establish a relative offset value for the selected measurement function. To establish a relative offset value from the front panel: 1.
Page 121 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 3: Functions and features Filters The filter feature lets you set the filter response to stabilize noisy measurements. The Model 2651A uses a digital filter, which is based on reading conversions. The displayed, stored, or transmitted reading is calculated using one or more reading conversions (from 1 to 100).
Page 122 Section 3: Functions and features Model 2651A High Power System SourceMeter® Instrument Reference Manual The moving filter uses a first-in, first-out stack. When the stack (filter count) becomes full, the measurement conversions are averaged, yielding a reading. For each subsequent conversion placed into the stack, the oldest conversion is discarded.
Page 123 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 3: Functions and features Configuring the filter from the front panel Filter type and count are configured from the filter configuration menu on the front panel. The same filter configuration is used for all measurement functions. To configure the filter: 1.
Page 124 Section 3: Functions and features Model 2651A High Power System SourceMeter® Instrument Reference Manual Reading buffers Reading buffers capture measurements, ranges, instrument status, and output state of the Keithley Instruments Model 2651A. The Model 2651A has two default reading buffers. In addition to the default buffers, you can create user-defined reading buffers.
Page 125 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 3: Functions and features • BUFFER2: Configure buffer 2. ▪ CLEAR: Clear buffer (YES or NO). ▪ ELEMENTS: Enable (ON) or disable (OFF) data storage elements: ▪ SRC-VAL: Enable or disable source values. ▪...
Page 126 Section 3: Functions and features Model 2651A High Power 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 127 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 3: Functions and features 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 128 Section 3: Functions and features Model 2651A High Power System SourceMeter® Instrument Reference Manual Saving the reading buffer to a USB flash drive After the measurements are complete, you can save the reading buffer data to a USB flash drive. To save the reading buffer data to a USB flash drive: 1.
Page 129 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 3: Functions and features Displaying other buffer readings and statistics To display other readings and statistics in the reading buffer: 1. While still in the buffer recall mode: ▪ If viewing the data stored in the buffer, turn the navigation wheel to increment and decrement the selected digit of the location number by one.
Page 130 Section 3: Functions and features Model 2651A High Power System SourceMeter® Instrument Reference Manual Reading buffer commands The following tables summarize commands associated with the reading buffers. See TSP command reference (on page 7-1) for detailed reading buffer command information. Reading buffer commands Command Description...
Page 131 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 3: Functions and features Command Description Commands to store readings smuX.trigger.measure.r(rbuffer) Configures resistance measurements to be made during a sweep, including where readings are stored (rbuffer). smuX.trigger.measure.p(rbuffer) Configures power measurements to be made during a sweep, including where readings are stored (rbuffer).
Page 132 Section 3: Functions and features Model 2651A High Power System SourceMeter® Instrument Reference Manual Buffer storage attribute Description appendmode The append mode is either off or on. When the append mode is off, a new measurement to this buffer overwrites the previous contents. When the append mode is on, the first new measurement is stored at the end of the existing data.
Page 133 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 3: Functions and features Buffer storage control programming examples The programming examples below illustrate the use of buffer storage control attributes. Buffer control programming examples Command Description smua.nvbuffer1.collectsourcevalues = 1 Enable source value storage.
Page 134 Section 3: Functions and features Model 2651A High Power System SourceMeter® Instrument Reference Manual The min and max entries have the attributes described in the following table (bufferVar is the name of the buffer). See smuX.buffer.getstats() (on page 7-223) for additional information. Min and max entry attributes Attribute Description...
Page 135 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 3: Functions and features Reading buffer attributes Use the reading buffer attributes to access the reading buffer data. The table below displays the attributes that you can use to access the reading buffer data. Recall attribute* Description measurefunctions...
Page 136 Section 3: Functions and features Model 2651A High Power System SourceMeter® Instrument Reference Manual Buffer status The buffer reading status attribute includes the status information as a numeric value; see the following table for values. For example, to access status information for the second element of SMU buffer 1, use the following command: stat_info = smua.nvbuffer1.statuses[2] Buffer status bits...
Page 137 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 3: Functions and features Buffer examples Dedicated reading buffer example The following programming example illustrates how to store data using dedicated reading buffer 1. In the example, the Model 2651A loops for voltages from 0.01 V to 1 V with 0.01 V steps (performing a staircase sweep), stores 100 current readings and source values in buffer 1, and then recalls all 100 readings and source values.
Page 138 Section 3: Functions and features Model 2651A High Power System SourceMeter® Instrument Reference Manual 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 Model 2651A stores 100 current and voltage readings and then recalls all 100 sets of readings.
Page 139 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 3: Functions and features Dynamically allocated buffer example The programming example below illustrates how to store data to an allocated buffer called mybuffer. The Model 2651A stores 100 current readings in mybuffer and then recalls all the readings. -- Restore Model 2651A defaults.
Page 140 Section 3: Functions and features Model 2651A High Power System SourceMeter® Instrument Reference Manual Figure 35: DC and pulsed linear staircase sweeps DC and pulsed logarithmic staircase sweeps: In this type of sweep, the current or voltage increases or decreases geometrically, beginning with a start voltage or current and ending with a stop voltage or current.
Page 141 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 3: Functions and features 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 3-29) for more information. Linear staircase sweeps As shown below, this sweep type steps from a start voltage or current value to an ending (stop) value.
Page 142 Section 3: Functions and features Model 2651A High Power System SourceMeter® Instrument Reference Manual The sweep can be either positive-going or negative-going, depending on the relative values of the start and stop parameters. When the sweep starts, the output goes to the start source level. The output then changes in equal steps until the stop level is reached.
Page 143 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 3: Functions and features The formula for a logarithmic sweep is: = A + kb Where: = The source value at source point i = The index of points in the sweep (ranges from 0 to N − 1), where N is the number of points in the sweep = The initial source value as an offset from the asymptote = The step size ratio...
Page 144 Section 3: Functions and features Model 2651A High Power System SourceMeter® Instrument Reference Manual Figure 40: 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 145 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 3: Functions and features The following figure is an example of a five-point logarithmic sweep from 1 V to 10 V. Figure 41: Logarithmic staircase sweep (1 V to 10 V, five steps) In this example: A = 0, V = 1, V...
Page 146 Section 3: Functions and features Model 2651A High Power System SourceMeter® Instrument Reference Manual (log step size) Therefore, b = 10 = 1.7783 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...
Page 147 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 3: Functions and features When the sweep is started, the output level goes to the first point in the sweep. The sweep continues through the steps in the order that they were programmed. The following figure shows a different example of a list sweep with six measurement points.
Page 148 Section 3: Functions and features Model 2651A High Power System SourceMeter® Instrument Reference Manual Figure 43: Pulse width control Pulse duty cycle Duty cycle is the percentage of time during the pulse period that the output is on. It is calculated as follows: Duty cycle = Pulse width / (Pulse width + Off time) For example, if the pulse width is 10 ms and the off time is 90 ms, the duty cycle is calculated...
Page 149 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 3: Functions and features Figure 44: Pulsing in the extended operating area Pulse region specification Region Region Maximum Maximum (quadrant maximum pulse width duty cycle diagram) 5 A at 40 V DC, no limit 100% 10 A at 20 V...
Page 150 Section 3: Functions and features Model 2651A High Power System SourceMeter® Instrument Reference Manual Configuring end sweep actions remotely Use the end sweep action to configure the source action at the end of the sweep. The source-measure unit (SMU) can be programmed to return to the idle source level or hold the last value of the sweep.
Page 151 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 3: Functions and features 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 152 Section 3: Functions and features Model 2651A High Power System SourceMeter® Instrument Reference Manual To run a sweep from the front panel: 1. Press the LOAD key, and then select FACTORY. 2. Select the name of the test to run. 3.
Page 153 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 3: Functions and features Linear staircase sweep example The programming example below illustrates a staircase sweep. -- Restore Model 2651A defaults. 1. Configure source functions. smua.reset() Restores defaults and sets the -- Set compliance to 1 V.
Page 154 Section 3: Functions and features Model 2651A High Power System SourceMeter® Instrument Reference Manual Triggering Triggering allows you to source signals and capture measurements when an input signal or combination of input signals meets a set of conditions that you set. Triggering controls the timing of when source and measure operations happen during a sweep.
Page 155 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 3: Functions and features 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 smua.trigger.SWEEPING_EVENT_ID Occurs when the source-measure unit (SMU) transitions from the idle state to the arm layer of the trigger model...
Page 156 Section 3: Functions and features Model 2651A High Power System SourceMeter® Instrument Reference Manual Using the remote trigger model The source-measure unit (SMU) in the Model 2651A has a remote trigger model that supports a wide range of triggering features for source sweeps, triggered measurements, and pulse actions. Measurements using the trigger model can be made synchronously with sourcing actions or they can be made asynchronously.
Page 157 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 3: Functions and features Figure 47: 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 158 Section 3: Functions and features Model 2651A High Power 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 159 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 3: Functions and features In asynchronous mode, trigger your measurements before the source completes the sweep (before the end sweep action occurs). If the source loop has completed its end sweep action, the measure loop terminates unless the measure action block is actively measuring.
Page 160 Section 3: Functions and features Model 2651A High Power System SourceMeter® Instrument Reference Manual SMU event detectors As shown in Using the remote trigger model (on page 3-38), 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 161 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 3: Functions and features 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.
Page 162 Section 3: Functions and features Model 2651A High Power 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 163 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 3: Functions and features Digital I/O port and TSP-Link synchronization lines The Model 2651A has two sets of hardware lines that can be used for triggering: 14 digital I/O lines and three TSP-Link ®...
Page 164 Section 3: Functions and features Model 2651A High Power 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 Model 2651A 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 165 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 3: Functions and features Figure 50: External instrument triggering 2651A-901-01 Rev. C October 2021 3-47...
Page 166 Section 3: Functions and features Model 2651A High Power System SourceMeter® Instrument Reference Manual 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 167 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 3: Functions and features Assigning a value to the delay attribute is the same as configuring it with a one-element delay list. Pass-through mode When enabled, the timer generates a trigger event immediately when it is triggered. The timer generates additional trigger events each time a delay expires.
Page 168 Section 3: Functions and features Model 2651A High Power System SourceMeter® Instrument Reference Manual Figure 51: Using a timer for an SDM cycle Timer action overruns The timer receives an action overrun when it generates a trigger event while a timer delay is still in progress.
Page 169 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 3: Functions and features Pulsing from a positive to a negative pulse level The following single pulse and pulse train examples pulse from a zero bias level to a positive pulse level (+5 V).
Page 170 Section 3: Functions and features Model 2651A High Power System SourceMeter® Instrument Reference Manual The following figure shows the trigger setup for this example. Figure 52: Single-pulse triggering 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.
Page 171 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 3: Functions and features -- Reset SourceMeter instrument to default conditions. reset() -- Generate a single pulse with the following characteristics: Bias (idle) level = 0 V Pulse level = 5 V Pulse width = 500 us -- Configure the source function.
Page 172 Section 3: Functions and features Model 2651A High Power System SourceMeter® Instrument Reference Manual 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 173 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 3: Functions and features • Set the trigger count equal to the total number of pulses to output. • Set the arm count to 1. The following figure shows the trigger setup for this example. Figure 54: Pulse train triggering 2651A-901-01 Rev.
Page 174 Section 3: Functions and features Model 2651A High Power System SourceMeter® Instrument Reference Manual 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 175 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 3: Functions and features -- 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. smua.trigger.source.limiti = 1 smua.measure.rangei = 1 -- Trigger SMU source action with the period timer event.
Page 176 Section 3: Functions and features Model 2651A High Power System SourceMeter® Instrument Reference Manual 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 ID of SMU A and the trigger event ID of digital I/O line 1 to stimulus inputs 1 and 2 of event blender 1: trigger.blender[1].stimulus[1] = smua.trigger.SOURCE_COMPLETE_EVENT_ID trigger.blender[1].stimulus[2] = digio.trigger[1].EVENT_ID...
Page 177 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 3: Functions and features LXI trigger edge detection Stateless event Hardware value Pseudo line state Falling edge Rising edge flag 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 178 Section 3: Functions and features Model 2651A High Power System SourceMeter® Instrument Reference Manual Make sure to use the same LXI domain on both the Model 2651A instrument and the other instrument. If the Model 2651A has a different LXI domain than the instrument at the other end of the trigger connection, the LXI trigger packets are ignored by both instruments.
Page 179 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 3: Functions and features Interactive triggering The complexity of some test system configurations may not allow a static trigger setup. These configurations require more dynamic control of triggering than the static trigger setup provides. For such cases, a setup providing interactive trigger programming allows the generation and detection of trigger events that can be controlled on demand under remote control.
Page 180 Section 3: Functions and features Model 2651A High Power System SourceMeter® Instrument Reference Manual -- Generate a falling-edge trigger on digital I/O line 3. digio.trigger[3].mode = digio.TRIG_FALLING digio.trigger[3].assert() -- Generate a rising edge trigger on TSP-Link sync line 1. tsplink.trigger[1].mode = tsplink.TRIG_RISINGM tsplink.trigger[1].assert() -- Generate a LAN trigger on LAN pseudo line 6.
Page 181 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 3: Functions and features The programming example below illustrates how to have the SMU immediately perform an action the first time through the trigger model, even if a programmed trigger event does not occur. -- Immediately sets the arm event detector of SMU A -- to the detected state.
Page 182 Section 3: Functions and features Model 2651A High Power System SourceMeter® Instrument Reference Manual Manual triggering example The programming example below illustrates how to pause a script and prompt the operator to press the TRIG key when the operator is ready to continue. If the TRIG key is not pressed, the test continues after waiting 10 minutes (600 seconds).
Page 183 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 3: Functions and features Hardware trigger modes ® You can use different hardware trigger modes for digital I/O and TSP-Link synchronization. Use hardware triggers to integrate Keithley instruments and non-Keithley instruments in a test system. The Model 2651A supports 14 digital I/O lines and three TSP-Link synchronization lines that can be used for input or output triggering.
Page 184 Section 3: Functions and features Model 2651A High Power System SourceMeter® Instrument Reference Manual Figure 56: Falling edge output trigger Rising edge master trigger mode Use the rising edge master (RisingM) trigger mode (see the figure titled "RisingM output trigger") to synchronize with non-Keithley instruments that require a high pulse.
Page 185 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 3: Functions and features 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: •...
Page 186 Section 3: Functions and features Model 2651A High Power 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 60: Either edge input trigger Output characteristics: •...
Page 187 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 3: Functions and features 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 188 Section 3: Functions and features Model 2651A High Power System SourceMeter® Instrument Reference Manual Figure 62: Synchronous master input trigger Output characteristics: • In addition to trigger events from other trigger objects, the digio.trigger[N].assert() and tsplink.trigger[N].assert() functions generate a low pulse that is similar to the falling edge trigger mode.
Page 189 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 3: Functions and features Synchronous acceptor trigger mode (SynchronousA) Use the synchronous acceptor trigger mode (SynchronousA) on a trigger subordinate that operates with a trigger master configured for the SynchronousM trigger mode. The roles of the internal and external drives are reversed in the SynchronousA trigger mode.
Page 190 Section 3: Functions and features Model 2651A High Power System SourceMeter® Instrument Reference Manual Synchronous trigger mode The synchronous trigger mode is a combination of SynchronousA and SynchronousM trigger modes. Keithley Instruments recommends using SynchronousA and SynchronousM modes only. Input characteristics: •...
Page 191 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 3: Functions and features Figure 67: Synchronous output trigger High-capacitance mode ® The Keithley Instruments Model 2651A High Power System SourceMeter Instrument features a high-capacitance mode. Because the source-measure unit (SMU) can measure low current, issues can arise when driving a capacitive load.
Page 192 Section 3: Functions and features Model 2651A High Power System SourceMeter® Instrument Reference Manual When high-capacitance mode is enabled, a minimum load capacitance of 100 nF is recommended. In absence of this minimum load capacitance, overshoot and ringing may occur. Highest throughput is achieved by using normal operation.
Page 193 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 3: Functions and features Adjusting the voltage source When driving large capacitive loads with high-capacitance mode enabled, the response time may be lengthened by the current limit. For example, see the table titled "Current measure and source settling (on page 3-74).
Page 194 Section 3: Functions and features Model 2651A High Power System SourceMeter® Instrument Reference Manual Enabling high-capacitance mode Before enabling high-capacitance mode, note the following: • It is important to read High-capacitance mode (on page 3-73) to understand the impact of high-capacitance mode.
Page 195 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 3: Functions and features Measuring current using high-capacitance mode The following inputs are required to test leakage using the factory leakage script, as shown in the following script example. ▪ SMU: Sets the Model 2651A source-measure unit to use ▪...
Page 196 Section 3: Functions and features Model 2651A High Power System SourceMeter® Instrument Reference Manual Figure 68: Enabling high-capacitance mode 3-78 2651A-901-01 Rev. C October 2021...
Page 197 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 3: Functions and features Display operations This section describes methods for using the display and determining what is displayed. Display functions and attributes The display functions and attributes are used to perform the display operations covered in this section. The following table lists each display function/attribute (in alphabetical order) and cross references it to the section topic where the function/attribute is explained.
Page 198 Section 3: Functions and features Model 2651A High Power System SourceMeter® Instrument Reference Manual Display screen The front panel displays source-measure values and readings or user-defined messages. The display screen options include: • Source-measure, compliance screens: Display SMU source-measure readings and compliance values.
Page 199 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 3: Functions and features Display messages You can define text messages that can be displayed on the front panel of the instrument. Most of the display functions and attributes that are associated with display messaging automatically select the user screen.
Page 200 Section 3: Functions and features Model 2651A High Power System SourceMeter® Instrument Reference Manual Cursor position When displaying a message, the cursor position determines where the message starts. On power-up, the cursor is positioned at row 1, column 1 (see the following figure). At this cursor position, a user-defined message is displayed on the top row (row 1).
Page 201 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 3: Functions and features The following programming example illustrates how to position the cursor on row 2, column 1, and then read the cursor position: display.setcursor(2, 1) row, column = display.getcursor() print(row, column) Output: 2.00000e+00 1.00000e+00...
Page 202 Section 3: Functions and features Model 2651A High Power System SourceMeter® Instrument Reference Manual The following programming example illustrates how to use the $N and $B character codes to display the message Test in Process on the top line and the blinking message Do Not Disturb on the bottom line: display.clear() display.settext("Test in Process $N$BDo Not Disturb")
Page 203 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 3: Functions and features Sending the command without the row parameter returns both lines of the display. The $N character code is included to show where the top line ends and the bottom line begins. The $N character code is returned even if embellished is set to false.
Page 204 Section 3: Functions and features Model 2651A High Power System SourceMeter® Instrument Reference Manual Parameter value prompting You can use the display.inputvalue() and display.prompt() functions to create an editable input field on the user screen at the present cursor position. The display.inputvalue() function uses the user screen at the present cursor position.
Page 205 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 3: Functions and features The following programming example illustrates how to prompt the operator to enter a source voltage value for SMU A: display.clear() value = display.prompt("0.00", "V", "Enter source voltage") display.screen = display.SMUA smua.source.levelv = value The script pauses after displaying the prompt message and waits for the operator to enter the voltage...
Page 206 Section 3: Functions and features Model 2651A High Power System SourceMeter® Instrument Reference Manual For example, assume the returned bitmap value is 34061. The binary equivalent of this value is as follows: 1000010100001101 For the above binary number, the following bits are set to 1: 16, 11, 9, 4, 3, and 1. Using the table, the following indicators are on: REL, REM, EDIT, AUTO, 4W, and FILT.
Page 207 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 3: Functions and features Adding USER TESTS menu entries You can use the following function in either of two ways to add an entry into the USER TESTS menu: display.loadmenu.add(displayname, code) display.loadmenu.add(displayname, code, memory) Where: displayname...
Page 208 Section 3: Functions and features Model 2651A High Power System SourceMeter® Instrument Reference Manual Deleting USER TESTS menu entries You can use the following function to delete an entry from the front-panel USER TESTS menu: display.loadmenu.delete(displayname) Where: displayname Name to delete from the menu. The following programming example removes the entry named Part1 from the front-panel USER TESTS menu: display.loadmenu.delete("Part1")
Page 209 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 3: Functions and features display.getlastkey() The display.getlastkey() function immediately returns the key code for the last pressed key. The following programming example illustrates how to display the last key pressed: key = display.getlastkey() print(key) The above code returns the key code value (see the following table).
Page 210 Section 3: Functions and features Model 2651A High Power System SourceMeter® Instrument Reference Manual The following programming example illustrates how to prompt the user to press the EXIT (LOCAL) key to abort the script, or any other key to continue it: display.clear() display.setcursor(1, 1) display.settext("Press EXIT to Abort")
Page 211 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 3: Functions and features Digital I/O lines The port provides 14 digital I/O lines. Each output is set high (+5 V) or low (0 V) and can read high or low logic levels.
Page 212 Section 3: Functions and features Model 2651A High Power System SourceMeter® Instrument Reference Manual Digital I/O configuration The following figure shows the basic configuration of the digital I/O port. Writing a 1 to a line sets that line high (~ +5 V). Writing a 0 to a line sets that line low (~0 V). Note that an external device pulls an I/O line low by shorting it to ground, so that a device must be able to sink at least 960 μA per I/O line.
Page 213 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 3: Functions and features To set digital I/O values from the front panel: 1. Press the MENU key, select DIGOUT, and then press the ENTER key or press the navigation wheel.
Page 214 Section 3: Functions and features Model 2651A High Power 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 7-1) for complete details on these commands. See the following table for decimal and hexadecimal values used to control and access the digital I/O port and individual lines.
Page 215 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 3: Functions and features 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 Model 2651A is not suitable for control of safety circuits and should not be used to control a safety interlock.
Page 216 Section 3: Functions and features Model 2651A High Power System SourceMeter® Instrument Reference Manual Remote control of output enable Use one of these commands to control output enable action: smua.source.outputenableaction = smua.OE_NONE smua.source.outputenableaction = smua.OE_OUTPUT_OFF When set to smua.OE_NONE, the Model 2651A does not take action when the output enable line is low.
Page 217 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 3: Functions and features Connecting to the TSP-Link system The TSP-Link ® trigger lines are built into the TSP-Link connection. Use the TSP-Link connectors on the back of the Model 2651A. If you are using a TSP-Link network, you do not have to modify any connections.
Page 218 Section 3: Functions and features Model 2651A High Power System SourceMeter® Instrument Reference Manual Programming example The programming example below illustrates how to set bit B1 of the TSP-Link digital I/O port high, and then read the entire port value: -- Set the TSP-Link trigger line to the trigger bypass mode.
Page 219 Section 4 Theory of operation In this section: Analog-to-digital converter ............4-1 Source-measure concepts ............4-2 Measurement settling time considerations ......4-27 Effects of load on current source settling time......4-28 Creating pulses with the Model 2651A SMU ......4-29 Analog-to-digital converter The Model 2651A has two analog-to-digital converters (ADC): An integrating ADC and a fast ADC.
Page 220 Section 4: Theory of operation Model 2651A High Power System SourceMeter® Instrument Reference Manual Source-measure concepts This section provides detailed information about source-measure concepts, including: • Limit principles (on page 4-2) • Overheating protection (on page 4-3) • Operating boundaries (on page 4-5) •...
Page 221 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 4: Theory of operation Overheating protection ® Proper ventilation is required to keep the High Power System SourceMeter Instrument from overheating. Even with proper ventilation, the instrument can overheat if the ambient temperature is ®...
Page 222 Section 4: Theory of operation Model 2651A High Power System SourceMeter® Instrument Reference Manual General power equation The instrument output amplifier voltage. This constant can be found in the table in Maximum duty cycle equation (on page 4-4). 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 223 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 4: Theory of operation 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 224 Section 4: Theory of operation Model 2651A High Power System SourceMeter® Instrument Reference Manual Continuous power operating boundaries The general operating boundaries for Model 2651A continuous power output are shown in the following figure. For derating factors, see the General power equation (on page 4-3).
Page 225 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 4: Theory of operation V-source operating boundaries Model 2651A V-source operating boundaries The following figure shows the operating boundaries for the V-source. Only the first quadrant of operation is shown; operation in the other three quadrants is similar with respect to the Continuous power operating boundaries (on page 4-6).
Page 226 Section 4: Theory of operation Model 2651A High Power System SourceMeter® Instrument Reference Manual Load considerations (V-source) The boundaries within which the Model 2651A 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 227 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 4: Theory of operation 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 228 Section 4: Theory of operation Model 2651A High Power System SourceMeter® Instrument Reference Manual The following figure shows what happens if a power limit of 60 mW is applied. As the SMU attempts to output the programmed source value of 10 V, the power compliance limit line is reached, which places the SMU in power compliance.
Page 229 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 4: Theory of operation 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). When sweeping, the actual source output varies according to the programmed source value until the current limit is reached.
Page 230 Section 4: Theory of operation Model 2651A High Power System SourceMeter® Instrument Reference Manual The current compliance limit applies both to positive and negative currents. For example, if you set the current compliance limit to 50 mA, the current limit applies to ±50 mA. For this example, the Model 2651A is programmed to source 200 V and to limit current to 50 mA.
Page 231 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 4: Theory of operation I-source operating boundaries Model 2651A I-source operating boundaries The following figure shows the operating boundaries for the I-source. Only the first quadrant of operation is shown; operation in the other three quadrants is similar with respect to the Continuous power operating boundaries (on page 4-6).
Page 232 Section 4: Theory of operation Model 2651A High Power System SourceMeter® Instrument Reference Manual 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. The following figures shows operation examples for resistive loads that are 50 Ω...
Page 233 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 4: 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 234 Section 4: Theory of operation Model 2651A High Power System SourceMeter® Instrument Reference Manual The following figure shows what happens if a power limit of 600 mW is applied. As the SMU attempts to output the programmed source value of 100 mA, the power-limited voltage compliance limit line is reached, which places the SMU in power compliance.
Page 235 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 4: Theory of operation 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). When sweeping, the actual source output varies according to the programmed source value until the voltage limit is reached.
Page 236 Section 4: Theory of operation Model 2651A High Power System SourceMeter® Instrument Reference Manual I-source sink operating boundaries The quadrant within which the Model 2651A operates depends on the device-under-test (DUT) connected to the Model 2651A output. The following example illustrates this operation by using the Model 2651A configured to provide a constant current to discharge a 1000 V power source (a battery).
Page 237 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 4: Theory of operation In the following figure, as the battery drains, the battery voltage is lowered as shown by the green arrow. Operation will continue in this direction until the user stops operation or the voltage reaches the voltage compliance limit line.
Page 238 Section 4: Theory of operation Model 2651A High Power System SourceMeter® Instrument Reference Manual Basic circuit configurations Source V When configured to source voltage (V-source), as shown in the figure below, the instrument functions as a low-impedance voltage source with current limit capability. The instrument can measure current (I-meter) or voltage (V-meter).
Page 239 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 4: Theory of operation Source I measure I, source V measure V The High Power System SourceMeter ® Instrument can measure the same function that it is sourcing. For example, when sourcing a voltage, you can measure voltage. Conversely, if you are sourcing current, you can measure the output current.
Page 240 Section 4: Theory of operation Model 2651A High Power System SourceMeter® Instrument Reference Manual Set the voltage limit to a level that is higher than the measured voltage. If the voltage limit is set to a level that is lower than the measured voltage, excessive current will flow into the instrument, resulting in operation as a sink.
Page 241 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 4: Theory of operation Contact check 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. By controlling the switches illustrated in the following figure, the current from these sources flows through the test leads and through the contact resistance, as shown.
Page 242 Section 4: Theory of operation Model 2651A High Power 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 243 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 4: Theory of operation Also in the figures below, the driven guard is connected to the cable shield and extended to the metal guard plate for the insulators. Since the voltage on either end of R is the same (0 V drop), no current can flow through the leakage resistance path.
Page 244 Section 4: Theory of operation Model 2651A High Power System SourceMeter® Instrument Reference Manual Cable considerations The Model 2651A is supplied with a 1 m (3 foot) low inductance, 6 Ω cable. The supplied cable addresses several important considerations: • Inductance •...
Page 245 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 4: Theory of operation Measurement settling time considerations Several outside factors can influence measurement settling times. Effects such as dielectric absorption, cable leakages, and noise can all extend the times required to make stable measurements.
Page 246 Section 4: Theory of operation Model 2651A High Power System SourceMeter® Instrument Reference Manual Programming example for controlling settling time delay The following code provides measure delay examples for controlling settling time delay. You can use the delay factor to apply a multiplier when smua.measure.delay is set to smua.DELAY_AUTO. Setting the delay factor above 1.0 increases the delay;...
Page 247 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 4: Theory of operation Creating pulses with the Model 2651A SMU Although the Model 2651A is not a pulse generator, you can create pulses by programming the SMU to output a dc value and then return to an idle level. For information on how to create pulses, refer to Sweep operation (on page 3-21) and Using the remote trigger model...
Page 248 Section 4: Theory of operation Model 2651A High Power System SourceMeter® Instrument Reference Manual Cable specifications and connection configuration Cable length, as well as capacitance and inductance in both the cabling and the test fixture, can affect pulse performance. See Cable considerations (on page 4-26) for pulse related considerations that may affect your connection scheme.
Page 249 Section 5 Remote commands In this section: Introduction to TSP operation........... 5-1 About TSP commands ............. 5-3 Factory scripts ................ 5-21 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 250 Section 5: Remote commands Model 2651A High Power 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 251 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 5: Remote commands To read an attribute, you can use the attribute as the parameter of a function or assign it to another variable. Example 3: Read an attribute using a function print(format.data) Reads the data format by passing the attribute to the print function.
Page 252 Section 5: Remote commands Model 2651A High Power System SourceMeter® Instrument Reference Manual About TSP commands This section contains an overview of the TSP commands for the instrument. The commands are organized into groups, with a brief description of each group. Each section contains links to the detailed descriptions for each command in the TSP command reference section of this documentation (see TSP commands...
Page 253 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 5: Remote commands The Test Script Processor (TSP) scripting engine stores all numbers internally as IEEE Std 754 double-precision floating-point values. The logical operations work on 32-bit integers. Any fractional bits are truncated.
Page 254 Section 5: Remote commands Model 2651A High Power System SourceMeter® Instrument Reference Manual There are commands to read and write to each individual bit, and commands to read and write to the entire port. digio.readbit() (on page 7-58) digio.readport() (on page 7-59) digio.trigger[N].assert() (on page 7-60) digio.trigger[N].clear()
Page 255 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 5: Remote commands Error queue When errors and events occur, the error and status messages are placed in the error queue. Use the error queue commands to request error and status message information. errorqueue.clear() (on page 7-98) errorqueue.count...
Page 256 Section 5: Remote commands Model 2651A High Power System SourceMeter® Instrument Reference Manual For basic information about navigation and directory listing of files on a flash drive, see File system navigation (on page 2-70). File descriptor commands for file I/O use a colon (:) to separate the command parts rather than a period (.), like the io commands.
Page 257 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 5: Remote commands Instrument identification These commands store strings that describe the instrument. localnode.description (on page 7-173) localnode.model (on page 7-175) localnode.revision (on page 7-180) localnode.serialno (on page 7-180) LAN and LXI The LAN commands have options that allow you to review and configure network settings.
Page 258 Section 5: Remote commands Model 2651A High Power System SourceMeter® Instrument Reference Manual lan.status.gateway (on page 7-155) lan.status.ipaddress (on page 7-156) lan.status.macaddress (on page 7-156) lan.status.port.dst (on page 7-157) lan.status.port.rawsocket (on page 7-157) lan.status.port.telnet (on page 7-158) lan.status.port.vxi11 (on page 7-158) lan.status.speed (on page 7-159) lan.status.subnetmask...
Page 259 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 5: Remote commands Parallel script execution dataqueue.add() (on page 7-51) dataqueue.CAPACITY (on page 7-52) dataqueue.clear() (on page 7-53) dataqueue.count (on page 7-54) dataqueue.next() (on page 7-55) node[N].execute() (on page 7-185) node[N].getglobal() (on page 7-186) node[N].setglobal()
Page 260 Section 5: Remote commands Model 2651A High Power System SourceMeter® Instrument Reference Manual Reading buffer Reading buffers capture measurements, ranges, instrument status, and output states of the instrument. bufferVar.appendmode (on page 7-18) bufferVar.basetimestamp (on page 7-19) bufferVar.cachemode (on page 7-20) bufferVar.capacity (on page 7-20) bufferVar.clear()
Page 261 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 5: Remote commands RS-232 serial.baud (on page 7-212) serial.databits (on page 7-213) serial.flowcontrol (on page 7-214) serial.parity (on page 7-215) serial.read() (on page 7-216) serial.write() (on page 7-217) Saved setups Use the saved setups commands to save or restore the configurations to or from the nonvolatile memory of the instrument or an installed USB flash drive.
Page 262 Section 5: Remote commands Model 2651A High Power System SourceMeter® Instrument Reference Manual localnode.linefreq (on page 7-174) localnode.autolinefreq (on page 7-172) smuX.abort() (on page 7-223) smuX.buffer.getstats() (on page 7-223) smuX.buffer.recalculatestats() (on page 7-225) smuX.contact.check() (on page 7-239) smuX.contact.r() (on page 7-240) smuX.contact.speed (on page 7-241) smuX.contact.threshold...
Page 263 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 5: Remote commands smuX.source.settling (on page 7-281) smuX.source.sink (on page 7-282) smuX.trigger.arm.count (on page 7-283) smuX.trigger.arm.set() (on page 7-284) smuX.trigger.arm.stimulus (on page 7-285) smuX.trigger.ARMED_EVENT_ID (on page 7-286) smuX.trigger.autoclear (on page 7-287) smuX.trigger.count (on page 7-287) smuX.trigger.endpulse.action...
Page 264 Section 5: Remote commands Model 2651A High Power System SourceMeter® Instrument Reference Manual Status model The status model is a set of status registers and queues. You can use the following commands to manipulate and monitor these registers and queues to view and control various instrument events. status.condition (on page 7-311) status.measurement.*...
Page 265 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 5: Remote commands status.system4.* (on page 7-390) status.system5.* (on page 7-392) Time bufferVar.basetimestamp (on page 7-19) bufferVar.collecttimestamps (on page 7-24) bufferVar.timestampresolution (on page 7-36) bufferVar.timestamps (on page 7-37) delay() (on page 7-57) gettimezone() (on page 7-121) os.time()
Page 266 Section 5: Remote commands Model 2651A High Power System SourceMeter® Instrument Reference Manual smuX.trigger.arm.count (on page 7-283) smuX.trigger.arm.set() (on page 7-284) smuX.trigger.arm.stimulus (on page 7-285) smuX.trigger.ARMED_EVENT_ID (on page 7-286) smuX.trigger.autoclear (on page 7-287) smuX.trigger.count (on page 7-287) smuX.trigger.endpulse.action (on page 7-289) smuX.trigger.endpulse.set() (on page 7-289) smuX.trigger.endpulse.stimulus...
Page 267 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 5: Remote commands tsplink.trigger[N].clear() (on page 7-429) tsplink.trigger[N].EVENT_ID (on page 7-430) tsplink.trigger[N].mode (on page 7-431) tsplink.trigger[N].overrun (on page 7-433) tsplink.trigger[N].pulsewidth (on page 7-434) tsplink.trigger[N].release() (on page 7-435) tsplink.trigger[N].reset() (on page 7-436) tsplink.trigger[N].stimulus (on page 7-437) tsplink.trigger[N].wait()
Page 268 Section 5: Remote commands Model 2651A High Power System SourceMeter® Instrument Reference Manual TSP-Net The TSP-Net module provides a simple socket-like programming interface to Test Script Processor (TSP ® ) enabled instruments. tspnet.clear() (on page 7-442) tspnet.connect() (on page 7-443) tspnet.disconnect() (on page 7-444) tspnet.execute()
Page 269 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 5: Remote commands Factory scripts ® The Keithley Instruments Model 2651A High Power System SourceMeter Instrument is shipped with one or more factory scripts saved in its flash firmware memory. A factory script is made up of a number of functions.
Page 270 Section 5: Remote commands Model 2651A High Power System SourceMeter® Instrument Reference Manual Running a factory script function from the front-panel controls 1. Press the LOAD key. 2. Select FACTORY. 3. Select the function to run and press the ENTER key or navigation wheel. 4.
Page 271 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 5: Remote commands KIPulse factory script The KIPulse factory script provides examples of how to generate pulses and to provide a simple pulsing interface. Pulses can be generated using the functions listed below. Please note the following information about the KIPulse factory script: ▪...
Page 272 Section 5: Remote commands Model 2651A High Power System SourceMeter® Instrument Reference Manual KIPulse tag parameter pulse functions ConfigPulseIMeasureV() (on page 7-38) ConfigPulseVMeasureI() (on page 7-44) ConfigPulseIMeasureVSweepLin() (on page 7-40) ConfigPulseVMeasureISweepLin() (on page 7-47) ConfigPulseIMeasureVSweepLog() (on page 7-42) ConfigPulseVMeasureISweepLog() (on page 7-49) InitiatePulseTest() (on page 7-128) QueryPulseConfig()
Page 273 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 5: Remote commands KIParlib factory script The KIParlib factory script is made up of two functions: gm_vsweep() and gm_isweep(). gm_vsweep() (on page 7-123) gm_isweep() (on page 7-122) KISavebuffer factory script The KISavebuffer script has one function: savebuffer().
Page 274 Section 6 Instrument programming In this section: Fundamentals of scripting for TSP ........... 6-1 Fundamentals of programming for TSP ......... 6-15 Test Script Builder ..............6-34 Working with TSB Embedded ..........6-39 Password management ............6-41 Advanced scripting for TSP ............ 6-43 TSP-Link system expansion interface ........
Page 275 Section 6: Instrument programming Model 2651A High Power 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 276 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 6: Instrument programming What can be included in scripts? ® Scripts can include combinations of Test Script Processor (TSP ) commands and Lua code. TSP commands instruct the instrument to do one thing and are described in the command reference (see TSP commands (on page 7-7)).
Page 277 Section 6: Instrument programming Model 2651A High Power System SourceMeter® Instrument Reference Manual Create and load a script You create scripts by loading them into the runtime environment of the instrument. You can load a script as a named script or as the anonymous script. Once a script is loaded into the instrument, you can execute it remotely or from the front panel.
Page 278 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 6: Instrument programming The following figure shows an example of how to load a script named “test.” The first command tells the instrument to start collecting the messages for the script named “test.” The last command marks the end of the script.
Page 279 Section 6: Instrument programming Model 2651A High Power System SourceMeter® Instrument Reference Manual Load a script from the instrument front panel You can also load scripts from a USB flash drive to the runtime environment of the instrument. Depending on the content of the TSP file on the drive, the script can be loaded either as an anonymous script without a designated name, or as a named script with a user-defined name.
Page 280 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 6: Instrument programming 8. If the script has the same name as a script that is already in memory, you are prompted to overwrite the script. ▪ Select Yes to continue. ▪...
Page 281 Section 6: Instrument programming Model 2651A High Power System SourceMeter® Instrument Reference Manual The SCRIPTS menu lists the names of scripts in nonvolatile memory or scripts that have been added to the runtime environment. The anonymous script also appears in this menu. If the instrument is in local control when the script is started, it switches to remote control (REM is displayed) while the script is running.
Page 282 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 6: Instrument programming 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 283 Section 6: Instrument programming Model 2651A High Power System SourceMeter® Instrument Reference Manual Autorun scripts Autorun scripts run automatically when the instrument is turned on. You can set any number of scripts to autorun. The run order for autorun scripts is arbitrary, so make sure the run order is not important. As shown in the example below, you can set a script to run automatically by setting the .autorun attribute of the script to "yes"...
Page 284 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 6: Instrument programming Example: Creating an autoexec script with the loadscript command loadscript autoexec display.clear() display.settext("Hello from autoexec") endscript autoexec.save() Creates the script autoexec. Saves the autoexec script to nonvolatile memory. The next time the instrument is turned on, Hello from autoexec is displayed.
Page 285 Section 6: Instrument programming Model 2651A High Power System SourceMeter® Instrument Reference Manual To save a script to nonvolatile memory using TSB Embedded: Select Save Script. Example: Save a user script to nonvolatile memory test1.save() Assume a script named test1 has been loaded. test1 is saved into nonvolatile memory. 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.
Page 286 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 6: Instrument programming To save a script to nonvolatile memory from the front panel: 1. Select the MENU key. 2. Select the SCRIPT option. 3. Select the SAVE option. A list of the scripts available to save is displayed. It may take a few seconds to display. The displayed list is from the script.user.scripts table in the instrument.
Page 287 Section 6: Instrument programming Model 2651A High Power System SourceMeter® Instrument Reference Manual After the output trigger occurs, the front display displays a message to the operator. When an input prompt is displayed, the script waits until the operator inputs the parameter or presses the ENTER key.
Page 288: Fundamentals Of Programming For Tsp
Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 6: Instrument programming Fundamentals of programming for TSP To conduct a test, a computer (controller) is programmed to send sequences of commands to an instrument. The controller orchestrates the actions of the instrumentation. The controller is typically programmed to request measurement results from the instrumentation and make test sequence decisions based on those measurements.
Page 289 Section 6: Instrument programming Model 2651A High Power System SourceMeter® Instrument Reference Manual An example of a short comment is: -- Turn off the front-panel display. An example of a long comment is: --[[Display a menu with three menu items. If the second menu item is selected, the selection is given the value Test2.]] Function and variable name restrictions You cannot use factory script names, functions created by factory scripts, Lua reserved words and...
Page 290 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 6: Instrument programming Values and variable types In Lua, you use variables to store values in the runtime environment for later use. Lua is a dynamically-typed language; the type of the variable is determined by the value that is assigned to the variable.
Page 291 Section 6: Instrument programming Model 2651A High Power System SourceMeter® Instrument Reference Manual Example: Nil x = nil print(x, type(x)) Example: Boolean y = false false boolean print(y, type(y)) Example: String and number x = "123" string print(x, type(x)) x = x + 7 Adding a number to x forces its type to number.
Page 292 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 6: Instrument programming Functions are first-class values in Lua. That means that functions can be stored in variables, passed as arguments to other functions, and returned as results. They can also be stored in tables. Note that when a function is defined, it is stored in the runtime environment.
Page 293 Section 6: Instrument programming Model 2651A High Power System SourceMeter® Instrument Reference Manual Example 3 function sum_diff_ratio(first_value, Returns multiple parameters (sum, difference, and second_value) ratio of the two numbers passed to it). psum = first_value + second_value Output: pdif = first_value - second_value prat = first_value / second_value 0.66666666666667 return psum, pdif, prat...
Page 294 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 6: Instrument programming 6. Run the new function with a value. MyFunction("world") The response message is: Hello world. 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.
Page 295 Section 6: Instrument programming Model 2651A High Power System SourceMeter® Instrument Reference Manual Relational operators Operator Description < less than > greater than <= less than or equal >= greater than or equal not equal equal 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.
Page 296 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 6: Instrument programming Example: Concatenation print(2 .. 3) print("Hello " .. "World") Output: Hello World Operator precedence Operator precedence in Lua follows the order below (from higher to lower priority): •...
Page 297 Section 6: Instrument programming Model 2651A High Power System SourceMeter® Instrument Reference Manual Conditional branching Lua uses the if, else, elseif, then, and end keywords to do conditional branching. Note that in Lua, nil and false are false and everything else is true. Zero (0) is true in Lua. The syntax of a conditional block is as follows: if expression then block...
Page 298 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 6: Instrument programming Example: Else and elseif x = 1 y = 2 if x and y then print("'if' expression 2 was not false.") if x or y then print("'if' expression 3 was not false.") if not x then print("'if' expression 4 was not false.") else...
Page 299 Section 6: Instrument programming Model 2651A High Power System SourceMeter® Instrument Reference Manual The output you get from this example may vary depending on the data format settings of the instrument. Example: While list = { This loop exits when list[element] = "One", "Two", "Three", "Four", "Five", "Six"} nil.
Page 300 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 6: Instrument programming Example: Repeat until list = {"One", "Two", "Three", "Four", "Five", "Six"} print("Count elements in list using repeat:") element = 1 repeat print(element, list[element]) element = element + 1 until not list[element] Output: Count elements in list...
Page 301 Section 6: Instrument programming Model 2651A High Power System SourceMeter® Instrument Reference Manual Example: Generic for days = {"Sunday", "Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday"} for i, v in ipairs(days) do print(days[i], i, v) The generic for statement works by using functions called iterators. On each iteration, the iterator function is called to produce a new value, stopping when this new value is nil.
Page 302 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 6: Instrument programming Example: Break with while statement enclosed by comment delimiters local numTable = {5, 4, 3, 2, 1} This example defines a break value local k = table.getn(numTable) (breakValue), but the break value line is -- local breakValue = 3 preceded by comment delimiters so that the...
Page 303 Section 6: Instrument programming Model 2651A High Power System SourceMeter® Instrument Reference Manual Tables and arrays Lua makes extensive use of the data type table, which is a flexible array-like data type. Table indices start with 1. Tables can be indexed not only with numbers, but with any value except nil. Tables can be heterogeneous, which means that they can contain values of all types except nil.
Page 304 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 6: Instrument programming Base library functions Base library functions Function Description collectgarbage() Sets the garbage-collection threshold to the given limit (in kilobytes) and collectgarbage(limit) checks it against the byte counter. If the new threshold is smaller than the byte counter, Lua immediately runs the garbage collector.
Page 305 Section 6: Instrument programming Model 2651A High Power System SourceMeter® Instrument Reference Manual String library functions This library provides generic functions for string manipulation, such as finding and extracting substrings. When indexing a string in Lua, the first character is at position 1 (not 0, as in ANSI C). Indices may be negative and are interpreted as indexing backward from the end of the string.
Page 306 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 6: Instrument programming Math library functions This library is an interface to most of the functions of the ANSI C math library. All trigonometric functions work in radians. The functions math.deg() and math.rad() convert between radians and degrees.
Page 307: Test Script Builder
Section 6: Instrument programming Model 2651A High Power System SourceMeter® Instrument Reference Manual Script with a for loop The following script puts a message on the front panel display slowly — one character at a time. The intent of this example is to demonstrate: •...
Page 308 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 6: Instrument programming Installing the TSB software The installation files for the TSB software are available at tek.com/keithley. To install the TSB software: 1. Close all programs. 2. Download the installer to your computer and double-click the .exe file to start the installation. 3.
Page 309 Section 6: Instrument programming Model 2651A High Power System SourceMeter® Instrument Reference Manual Figure 96: Example of the Test Script Builder workspace Item Description Project navigator Script editor; right-click to run the script that is displayed Outline view Programming interaction Help;...
Page 310 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 6: Instrument programming Script editor The script editor is where you write, modify, and debug scripts. To open and display a script file, double-click the file name in the project navigator. You can have multiple script files open in the script editor at the same time.
Page 311 Section 6: Instrument programming Model 2651A High Power System SourceMeter® Instrument Reference Manual The Outline tab is visible by default in the TSP perspective. Icon Name Examples function gFunction() Global function variable local function lFunction() Local function variable myTest(function() return 1 end) Anonymous function gTable = { } Global table variable...
Page 312: Working With Tsb Embedded
Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 6: Instrument programming Working with TSB Embedded TSB Embedded is a script management tool that is available through the web interface of the instrument. You can use TSB Embedded to create, modify, and save test scripts, and to send individual commands.
Page 313 Section 6: Instrument programming Model 2651A High Power 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 314: Password Management
Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 6: Instrument programming Delete a script You cannot retrieve a deleted script. Be sure to back up your script to your computer before deleting. To delete a script from TSB Embedded: 1.
Page 315 Section 6: Instrument programming Model 2651A High Power System SourceMeter® Instrument Reference Manual 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 316 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 6: Instrument programming Unlocking the remote interface If the remote interface is locked, you must enter the password before the Model 2651A responds to any command issued over a remote interface. The password for the example below is Keithley.
Page 317: Advanced Scripting For Tsp
Section 6: Instrument programming Model 2651A High Power System SourceMeter® Instrument Reference Manual Advanced scripting for TSP The following topics describe advanced information that can help you understand how the Test Script ® Processor (TSP ) scripting engine works. Global variables and the script.user.scripts table When working with script commands, it is helpful to understand how scripts are handled in the instrument.
Page 318 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 6: Instrument programming Figure 98: Global variables and scripts in the runtime environment Create a script using the script.new() command Use the script.new() function to copy an existing script from the local node to a remote node. This enables parallel script execution.
Page 319 Section 6: Instrument programming Model 2651A High Power System SourceMeter® Instrument Reference Manual For example, to set up a two-second beep, you can send the command: beepTwoSec = script.new("beeper.enable = 1 beeper.beep(2, 2400)", "beepTwoSec") To run the new script, send the command: beepTwoSec() When you add beepTwoSec, the global variable and script.user.scripts table entries are made to the runtime environment, as shown in the following figure.
Page 320 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 6: Instrument programming To run the script, send the command: hello() Figure 100: Create an unnamed script A script becomes unnamed if you create a new script with the same name. In this circumstance, the name of the script in the script.user.scripts table is set to an empty string before it is replaced by the new script.
Page 321 Section 6: Instrument programming Model 2651A High Power System SourceMeter® Instrument Reference Manual Figure 101: Create a new script with the name of an existing script Rename a script You can rename a script. You might want to rename a script if you need to name another script the same name as the existing script.
Page 322 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 6: Instrument programming If the new name is the same as a name that is already used for a script, the name of the existing script is removed and that script becomes unnamed. This removes the existing script if there are no other variables that reference the previous script.
Page 323 Section 6: Instrument programming Model 2651A High Power 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 324 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 6: Instrument programming Retrieve a script as a single string To retrieve the entire user script source code as a single string, use the scriptVar.source attribute. The loadscript or loadandrunscript and endscript keywords are not included. To retrieve the source code as a single string, send the command: print(scriptVar.source) Where scriptVar is the name of the script.
Page 325 Section 6: Instrument programming Model 2651A High Power System SourceMeter® Instrument Reference Manual Example: Retrieve the content of a script with scriptVar.source print(test.source) Request a listing of the source of the script named test. The loadscript and endscript commands are not included. An example of the possible instrument output is: listTones = {100, 400, 800} for index in listTones do...
Page 326 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 6: Instrument programming Restore a script to the runtime environment You can retrieve a script that was removed from the runtime environment but is still saved in nonvolatile memory. To restore a script from nonvolatile memory into the runtime environment, you can use script.restore("scriptName"), where scriptName is the user-defined name of the script to be restored.
Page 327 Section 6: Instrument programming Model 2651A High Power System SourceMeter® Instrument Reference Manual 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 328: Tsp-Link System Expansion Interface
Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 6: Instrument programming TSP-Link system expansion interface ® The TSP-Link expansion interface allows the Model 2651A instrument to communicate with other ® Test Script Processor (TSP ) enabled instruments. The test system can be expanded to include up to 32 TSP-Link enabled instruments.
Page 329 Section 6: Instrument programming Model 2651A High Power System SourceMeter® Instrument Reference Manual Computer-based system: You can use a computer and a remote communications interface to any single node in the system. This node becomes the interface to the entire system. When a command is sent through this node, all nodes go into remote operation (REM indicators turn on).
Page 330 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 6: Instrument programming You do not need to know the node number of the node that is running a script. The variable localnode is an alias for the node entry of the node where the script is running. For example, if a script is running on node 5, you can use the global variable localnode as an alias for node[5].
Page 331 Section 6: Instrument programming Model 2651A High Power System SourceMeter® Instrument Reference Manual Assigning node numbers At the factory, each Model 2651A instrument is assigned as node 1. The node number is stored in nonvolatile memory and remains in storage when the instrument is turned off. You can assign a node number to a Model 2651A using the front panel or by using a remote command.
Page 332 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 6: Instrument programming Remote programming The commands associated with the TSP-Link ® system reset are listed in the following table. TSP-Link reset commands Command Description tsplink.reset() Initializes the TSP-Link network tsplink.state Reads the state of the TSP-Link network: ▪...
Page 333 Section 6: Instrument programming Model 2651A High Power System SourceMeter® Instrument Reference Manual • The following command will reset SMU A of node 4, which is a subordinate. The other nodes are not affected. node[4].smua.reset() Using the reset() command system operations target a single node in the system, but the reset() command Most TSP-Link ®...
Page 334 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 6: Instrument programming TSP advanced features ® Use the Test Script Processor (TSP ) scripting engine's advanced features to: • Run test scripts simultaneously • Manage resources allocated to test scripts that are running simultaneously •...
Page 335 Section 6: Instrument programming Model 2651A High Power System SourceMeter® Instrument Reference Manual Figure 104: Model 2651A 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 336 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 6: Instrument programming Figure 105: Model 2651A 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 337 Section 6: Instrument programming Model 2651A High Power System SourceMeter® Instrument Reference Manual TSP-Link network group functions Group Group members Present function number Master node 1 Initiates and runs a test script on node 2 Initiates and runs a test script on node 6 Group leader node 2 Runs the test script initiated by the master node Initiates remote operations on node 3 through node 5...
Page 338 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 6: Instrument programming Group leader overview Each group has a dynamic group leader. The last node in a group that performs any operation initiated by the master node is the group leader. The group leader: •...
Page 339 Section 6: Instrument programming Model 2651A High Power System SourceMeter® Instrument Reference Manual The programming example below demonstrates how to run a test script that is defined on a remote node. For this example, scriptVar is defined on the remote node. To run a script defined on the remote node: node[N].execute("scriptVar()") It is recommended that you copy large scripts to a remote node to improve system performance.
Page 340 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 6: Instrument programming Using the data queue for real-time communication Nodes that are running test scripts at the same time can store data in the data queue for real-time communication. Each instrument has an internal data queue that uses the first-in, first-out (FIFO) structure to store data.
Page 341: Tsp-Net
Section 6: Instrument programming Model 2651A High Power System SourceMeter® Instrument Reference Manual When you run Lua code remotely, it can cause reading buffer data that is held in the cache to become stale. If the values in the reading buffer change while the Lua code runs remotely, another node can hold stale values.
Page 342 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 6: Instrument programming Using TSP-Net commands with TSP-enabled instruments, a Model 2651A can download a script to another TSP-enabled instrument and have both instruments run scripts independently. The Model 2651A can read the data from the remote instrument and either manipulate the data or send the data to a different remote instrument on the LAN.
Page 343 Section 6: Instrument programming Model 2651A High Power System SourceMeter® Instrument Reference Manual To communicate to a remote ethernet device from the Model 2651A: 1. Connect to the remote device using one of the above procedures. If the Model 2651A cannot make a connection to the remote device, it generates a timeout event.
Page 344 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 6: Instrument programming TSP-Net compared to TSP-Link to communicate with TSP-enabled devices ® The TSP-Link network interface is the preferred communication method for most applications where communication occurs between the Model 2651A and another TSP-enabled instrument. One of the advantages of using the TSP-Link network interface is that TSP-Link connections have three trigger lines that are available to each device on the TSP-Link network.
Page 345 Section 6: Instrument programming Model 2651A High Power 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 346 Section 7 TSP command reference In this section: TSP command programming notes .......... 7-1 Using the TSP command reference ......... 7-3 TSP commands ................ 7-7 TSP command programming notes This section contains general information about using TSP commands. Placeholder text This manual uses italicized text to represent the parts of remote commands that must be replaced by user specified values.
Page 347 Section 7: TSP command reference Model 2651A High Power 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 348 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Remote versus local state The instrument can be in either the local state or the remote state. When in the local state (REM indicator off), the instrument is operated using the front panel controls. When in the remote state (REM indicator on), instrument operation is being controlled by the computer.
Page 349 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual Figure 106: Example instrument command description The subsections contain information about the command. The subsections are: • Command name and summary table • Usage • Details •...
Page 350 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference 1. Instrument command name. Indicates the beginning of the command description. It is followed by a brief description of what the command does. 2. Type of command. Commands can be functions, attributes, or constants. If the command is an attribute, it can be read-only (R), read-write (RW), or write-only (W).
Page 351 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual Structure of command usage: Shows how to organize the parts of the command. If a parameter is shown to the left of the command, it is the return when you print the command. Information to the right is the parameters or other items you need to enter when setting the command.
Page 352 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Related commands and information The Also see section of the remote command description lists additional commands or sections that are related to the command. Figure 111: TSP Also see description TSP commands The TSP commands available for the instrument are listed in alphabetical order.
Page 353 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual beeper.enable This command allows you to turn the beeper on or off. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Recall setup Saved setup 1 (beeper.ON) Instrument reset Usage...
Page 354 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Example testResult = bit.bitand(10, 9) print(testResult) Performs a logical AND operation on decimal 10 (binary 1010) with decimal 9 (binary 1001), which returns a value of decimal 8 (binary 1000). Output: 8.00000e+00 Also see...
Page 355 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual bit.bitxor() This function performs a bitwise logical XOR (exclusive OR) operation on two numbers. Type TSP-Link accessible Affected by Where saved Default value Function Usage result = bit.bitxor(value1, value2) result Result of the logical XOR operation value1...
Page 356 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference bit.clear() This function clears a bit at a specified index position. Type TSP-Link accessible Affected by Where saved Default value Function Usage result = bit.clear(value, index) result Result of the bit manipulation value...
Page 357 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual bit.get() This function retrieves the weighted value of a bit at a specified index position. Type TSP-Link accessible Affected by Where saved Default value Function Usage result = bit.get(value, index) result Result of the bit manipulation...
Page 358 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference bit.getfield() This function returns a field of bits from the value starting at the specified index position. Type TSP-Link accessible Affected by Where saved Default value Function Usage result = bit.getfield(value, index, width)
Page 359 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual bit.set() This function sets a bit at the specified index position. Type TSP-Link accessible Affected by Where saved Default value Function Usage result = bit.set(value, index) result Result of the bit manipulation value...
Page 360 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference bit.setfield() This function overwrites a bit field at a specified index position. Type TSP-Link accessible Affected by Where saved Default value Function Usage result = bit.setfield(value, index, width, fieldValue) result Result of the bit manipulation value...
Page 361 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual bit.test() This function returns the Boolean value (true or false) of a bit at the specified index position. Type TSP-Link accessible Affected by Where saved Default value Function Usage result = bit.test(value, index)
Page 362 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference bit.toggle() This function toggles the value of a bit at a specified index position. Type TSP-Link accessible Affected by Where saved Default value Function Usage result = bit.toggle(value, index) result Result of the bit manipulation value...
Page 363 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual 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...
Page 364 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference 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...
Page 365 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual 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...
Page 366 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference 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...
Page 367 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual 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 368 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference 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.cachemode (on page 7-20)
Page 369 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual Example smua.nvbuffer1.collectsourcevalues = 1 Include source values with readings for dedicated reading buffer 1. Also see bufferVar.clear() (on page 7-22) Reading buffers (on page 3-6) smuX.measure.overlappedY() (on page 7-257) smuX.measure.Y() (on page 7-261)
Page 370 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Example smua.nvbuffer1.collecttimestamps = 1 Include timestamps with readings for dedicated reading buffer 1. Also see bufferVar.clear() (on page 7-22) Reading buffers (on page 3-6) smuX.measure.overlappedY() (on page 7-257) smuX.measure.Y() (on page 7-261) smuX.nvbufferY...
Page 371 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual 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...
Page 372 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference bufferVar.measurefunctions This attribute contains the measurement function that was used to acquire a reading stored in a specified reading buffer. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Clearing the buffer...
Page 373 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual bufferVar.measureranges This attribute contains the measurement range values that were used for readings stored in a specified buffer. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Clearing the buffer See Details...
Page 374 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference 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...
Page 375 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual 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...
Page 376 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference 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)
Page 377 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual 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...
Page 378 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference bufferVar.sourceranges This attribute contains the source range that was used for readings stored in a specified reading buffer. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Clearing the buffer See Details...
Page 379 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual bufferVar.sourcevalues When enabled by the bufferVar.collectsourcevalues attribute, this attribute contains the source levels being output when readings in the reading buffer were acquired. Type TSP-Link accessible Affected by Where saved Default value...
Page 380 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference 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...
Page 381 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual bufferVar.timestampresolution This attribute contains the resolution of the timestamp. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Not applicable See Details 1e-6 (1 µs) Usage resolution = bufferVar.timestampresolution resolution...
Page 382 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference bufferVar.timestamps When enabled by the bufferVar.collecttimestamps attribute, this attribute contains the timestamp when each reading saved in the specified reading buffer occurred. Type TSP-Link accessible Affected by Where saved Default value Attribute (R)
Page 383 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual ConfigPulseIMeasureV() This KIPulse factory script function configures a current pulse train with a voltage measurement at each point. Type TSP-Link accessible Affected by Where saved Default value Function Usage f, msg = ConfigPulseIMeasureV(smu, bias, level, limit, ton, toff, points, buffer, tag,...
Page 384 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference This function does not cause the specified smu to output a pulse train. It simply checks to see if all the pulse dimensions can be achieved, and if they are, assigns the indicated tag or index to the pulse train.
Page 385 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual 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...
Page 386 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference 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 387 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual ConfigPulseIMeasureVSweepLog() 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 = ConfigPulseIMeasureVSweepLog(smu, bias, start, stop, limit, ton, toff,...
Page 388 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference The magnitude of the first pulse will be start amperes; the magnitude of the last pulse will be stop amperes. The magnitude of each pulse in between will be LogStep amperes larger than the previous pulse, where: LogStepSize = (log10(stop) - log10(start)) / (points -1)
Page 389 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual ConfigPulseVMeasureI() This KIPulse factory script function configures a voltage pulse train with a current measurement at each point. Type TSP-Link accessible Affected by Where saved Default value Function Usage f, msg = ConfigPulseVMeasureI(smu, bias, level, limit, ton, toff, points, buffer,...
Page 390 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Details Data for pulsed current measurements are stored in the reading buffer specified by the buffer input parameter. This function configures a voltage pulse train with a current measurement at each point. Measurements are made at the end of the ton time.
Page 391 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual Example 3 rbi = smua.makebuffer(10) Simultaneous IV measurement during pulse. rbv = smua.makebuffer(10) rbi.appendmode = 1 rbv.appendmode = 1 rbs = { i = rbi, v = rbv } f, msg = ConfigPulseVMeasureI(smua, 0, 10, 1e-3, 1e-3, 1e-3, 2, rbs, 1) Also see...
Page 392 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: 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,...
Page 393 Section 7: TSP command reference Model 2651A High Power 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 394 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference ConfigPulseVMeasureISweepLog() This KIPulse factory script (on page 5-23) function configures a voltage pulse train with a current measurement at each point. Type TSP-Link accessible Affected by Where saved Default value Function...
Page 395 Section 7: TSP command reference Model 2651A High Power 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.
Page 396 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: 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 397 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual Also see dataqueue.CAPACITY (on page 7-52) dataqueue.clear() (on page 7-53) dataqueue.count (on page 7-54) dataqueue.next() (on page 7-55) Using the data queue for real-time communication (on page 6-67) dataqueue.CAPACITY This constant is the maximum number of entries that you can store in the data queue.
Page 398 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference dataqueue.clear() This function clears the data queue. Type TSP-Link accessible Affected by Where saved Default value Function Usage dataqueue.clear() Details This function forces all dataqueue.add() commands that are in progress to time out and deletes all data from the data queue.
Page 399 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual dataqueue.count This attribute contains the number of items in the data queue. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Not applicable Not applicable Not applicable Usage count = dataqueue.count...
Page 400 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference dataqueue.next() This function removes the next entry from the data queue. Type TSP-Link accessible Affected by Where saved Default value Function Usage value = dataqueue.next() value = dataqueue.next(timeout) value The next entry in the data queue timeout...
Page 401 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual 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 402 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference delay() This function delays the execution of the commands that follow it. Type TSP-Link accessible Affected by Where saved Default value Function Usage delay(seconds) seconds The number of seconds to delay (0 to 100 ks) Details The instrument delays execution of the commands for at least the specified number of seconds and fractional seconds.
Page 403 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual digio.readbit() This function reads one digital I/O line. Type TSP-Link accessible Affected by Where saved Default value Function Usage data = digio.readbit(N) data The state of the I/O line Digital I/O line number to be read (1 to 14) Details A returned value of zero (0) indicates that the line is low.
Page 404 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference digio.readport() This function reads the digital I/O port. Type TSP-Link accessible Affected by Where saved Default value Function Usage data = digio.readport() data The present value of the input lines on the digital I/O port Details The binary equivalent of the returned value indicates the value of the input lines on the I/O port.
Page 405 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual digio.trigger[N].assert() This function asserts a trigger pulse on one of the digital I/O lines. Type TSP-Link accessible Affected by Where saved Default value Function Usage digio.trigger[N].assert() Digital I/O trigger line (1 to 14) Details The pulse width that is set determines how long the instrument asserts the trigger.
Page 406 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference digio.trigger[N].EVENT_ID This constant identifies the trigger event generated by the digital I/O line N. Type TSP-Link accessible Affected by Where saved Default value Constant Usage eventID = digio.trigger[N].EVENT_ID eventID The trigger event number Digital I/O trigger line (1 to 14)
Page 407 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual 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. Type TSP-Link accessible Affected by Where saved Default value...
Page 408 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference 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 other Keithley Instruments products.
Page 409 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual Example overrun = digio.trigger[1].overrun print(overrun) If there is no trigger overrun, the following text is output: false Also see digio.trigger[N].clear() (on page 7-60) digio.trigger[N].reset() (on page 7-65) digio.trigger[N].pulsewidth This attribute describes the length of time that the trigger line is asserted for output triggers.
Page 410 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference digio.trigger[N].release() This function releases an indefinite length or latched trigger. Type TSP-Link accessible Affected by Where saved Default value Function Usage digio.trigger[N].release() Digital I/O trigger line (1 to 14) Details Releases a trigger that was asserted with an indefinite pulsewidth time.
Page 411 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual Example digio.trigger[3].mode = 2 digio.trigger[3].pulsewidth = 50e-6 digio.trigger[3].stimulus = digio.trigger[5].EVENT_ID print(digio.trigger[3].mode, digio.trigger[3].pulsewidth, digio.trigger[3].stimulus) digio.trigger[3].reset() print(digio.trigger[3].mode, digio.trigger[3].pulsewidth, digio.trigger[3].stimulus) Set the digital I/O trigger line 3 for a falling edge with a pulsewidth of 50 µs. Use digital I/O line 5 to trigger the event on line 3.
Page 412 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Trigger event IDs* Event ID Event description smuX.trigger.SWEEPING_EVENT_ID Occurs when the source-measure unit (SMU) transitions from the idle state to the arm layer of the trigger model smuX.trigger.ARMED_EVENT_ID Occurs when the SMU moves from the arm layer to the trigger layer of the trigger model...
Page 413 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual digio.trigger[N].wait() This function waits for a trigger. Type TSP-Link accessible Affected by Where saved Default value Function Usage triggered = digio.trigger[N].wait(timeout) triggered The value is true if a trigger is detected, or false if no triggers are detected during the timeout period Digital I/O trigger line (1 to 14) timeout...
Page 414 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference digio.writebit() This function sets a digital I/O line high or low. Type TSP-Link accessible Affected by Where saved Default value Function Usage digio.writebit(N, data) Digital I/O trigger line (1 to 14) data The value to write to the bit: ▪...
Page 415 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual digio.writeport() This function writes to all digital I/O lines. Type TSP-Link accessible Affected by Where saved Default value Function Usage digio.writeport(data) data Value to write to the port (0 to 16383) Details The binary representation of data indicates the output pattern to be written to the I/O port.
Page 416 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference digio.writeprotect This attribute contains the write-protect mask that protects bits from changes from the digio.writebit() and digio.writeport() functions. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Instrument reset Saved setup...
Page 417 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual display.getannunciators() This function reads the annunciators (indicators) that are presently turned on. Type TSP-Link accessible Affected by Where saved Default value Function Usage annunciators = display.getannunciators() annunciators The bitmasked value that shows which indicators are turned on Details...
Page 418 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Example 1 testAnnunciators = display.getannunciators() print(testAnnunciators) rem = bit.bitand(testAnnunciators, 1024) if rem > 0 then print("REM is on") else print("REM is off") REM indicator is turned on. Output: 1.28000e+03 REM is on...
Page 419 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual display.getcursor() This function reads the present position of the cursor on the front-panel display. Type TSP-Link accessible Affected by Where saved Default value Function Usage row, column, style = display.getcursor() The row where the cursor is: 1 (top row);...
Page 420 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference display.getlastkey() This function retrieves the key code for the last pressed key. Type TSP-Link accessible Affected by Where saved Default value Function Usage keyCode = display.getlastkey() keyCode A returned value that represents the last front-panel key pressed;...
Page 421 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual Example key = display.getlastkey() print(key) On the front panel, press the MENU key and then send the code shown here. This retrieves the key code for the last pressed key.
Page 422 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Example 1 display.clear() display.setcursor(1, 1) display.settext("ABCDEFGHIJ$DKLMNOPQRST") display.setcursor(2, 1) display.settext("abcdefghijklm$Bnopqrstuvwxyz$F123456") print(display.gettext()) print(display.gettext(true)) print(display.gettext(false, 2)) print(display.gettext(true, 2, 9)) print(display.gettext(false, 2, 9, 10)) This example shows how to retrieve the display text in multiple ways. The output is: ABCDEFGHIJKLMNOPQRST$Nabcdefghijklmnopqrstuvwxyz123456 $RABCDEFGHIJ$DKLMNOPQRST$N$Rabcdefghijklm$Bnopqrstuvwxyz$F123456 abcdefghijklmnopqrstuvwxyz123456...
Page 423 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual display.inputvalue() This function displays a formatted input field on the front-panel display that the operator can edit. Type TSP-Link accessible Affected by Where saved Default value Function Usage display.inputvalue("format")
Page 424 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Example display.clear() display.settext("Enter value between$N -0.10 and 2.00: ") value = display.inputvalue("+0.00", 0.5, -0.1, 2.0) print("Value entered = ", value) Displays an editable field (+0.50) for operator input. The valid input range is −0.10 to +2.00, with a default of 0.50.
Page 425 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual If you do not make a selection for memory, the code is automatically saved to nonvolatile memory. You can create a script that defines several functions, and then use the display.loadmenu.add() command to add items that call those individual functions.
Page 426 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference display.loadmenu.catalog() This function creates an iterator for the user menu items accessed using the LOAD key on the front panel. Type TSP-Link accessible Affected by Where saved Default value Function Usage...
Page 427 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual display.loadmenu.delete() This function removes an entry from the USER menu, which can be accessed using the LOAD key on the front panel. Type TSP-Link accessible Affected by Where saved Default value Function...
Page 428 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference display.locallockout This attribute describes whether or not the EXIT (LOCAL) key on the instrument front panel is enabled. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Power cycle Not saved...
Page 429 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual display.menu() This function presents a menu on the front-panel display. Type TSP-Link accessible Affected by Where saved Default value Function Usage selection = display.menu("name", "items") selection Name of the variable that holds the selected menu item name Menu name to display on the top line...
Page 430 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference display.numpad This attribute controls whether the front panel keys act as a numeric keypad during value entry. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Instrument reset Saved setup...
Page 431 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual Details This function creates an editable input field at the present cursor position, and an input prompt message on the bottom line. Example of a displayed input field and prompt: 0.00V Input 0 to +2V The format parameter uses zeros (0), the decimal point, polarity sign, and exponents to define how...
Page 432 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference display.screen This attribute contains the selected display screen. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Instrument reset Saved setup 0 (display.SMUA) Recall setup Usage displayID = display.screen display.screen = displayID...
Page 433 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual Key codes Value Key list Value Key list display.KEY_RANGEUP display.KEY_RECALL display.KEY_MENU display.KEY_MEASA display.KEY_MODEA display.KEY_DIGITSA display.KEY_RELA display.KEY_OUTPUTA display.KEY_RUN display.KEY_TRIG display.KEY_DISPLAY display.KEY_LIMITA display.KEY_AUTO display.KEY_SPEEDA display.KEY_EXIT display.KEY_LOAD display.KEY_FILTERA display.WHEEL_ENTER display.KEY_STORE display.KEY_RIGHT display.KEY_SRCA...
Page 434 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference 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 435 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual display.settext() This function displays text on the front-panel user screen. Type TSP-Link accessible Affected by Where saved Default value Function Usage display.settext("text") text Text message to be displayed, with optional character codes Details This function selects the user display screen and displays the given text.
Page 436 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Example display.clear() display.settext("Normal $BBlinking$N") display.settext("$DDim $FBackgroundBlink$R $$$$ 2 dollars") This example sets the display to: Normal Blinking Dim BackgroundBlink $$ 2 dollars with the named effect on each word. Also see display.clear() (on page 7-71)
Page 437 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual display.smuX.limit.func This attribute specifies the type of limit value setting displayed. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Instrument reset Saved setup 0 (display.LIMIT_IV) Recall setup Usage...
Page 438 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference display.smuX.measure.func This attribute specifies the type of measurement that is being displayed. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Instrument reset Saved setup 1 (display.MEASURE_DCVOLTS) Recall setup Usage...
Page 439 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual display.trigger.clear() This function clears the front-panel trigger event detector. Type TSP-Link accessible Affected by Where saved Default value Function Usage display.trigger.clear() Details The trigger event detector remembers if an event has been detected since the last display.trigger.wait() call.
Page 440 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: 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...
Page 441 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual Use the display.trigger.clear() call to clear the trigger event detector. 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.
Page 442 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Key codes Value Key (or action) Value Key (or action) display.KEY_RANGEUP display.KEY_RECALL display.KEY_MENU display.KEY_MEASA display.KEY_MODEA display.KEY_DIGITSA display.KEY_RELA display.KEY_OUTPUTA display.KEY_RUN display.KEY_TRIG display.KEY_DISPLAY display.KEY_LIMITA display.KEY_AUTO display.KEY_SPEEDA display.KEY_EXIT display.KEY_LOAD display.KEY_FILTERA display.WHEEL_ENTER display.KEY_STORE...
Page 443 Section 7: TSP command reference Model 2651A High Power 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 15-3) for additional information about the error queue.
Page 444 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: 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()
Page 445 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual Example errorcode, message = errorqueue.next() print(errorcode, message) Reads the oldest entry in the error queue. The output below indicates that the queue is empty. Output: 0.00000e+00 Queue Is Empty Also see Error queue (on page 15-3)
Page 446 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: 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 7-100)
Page 447 Section 7: TSP command reference Model 2651A High Power 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...
Page 448 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: 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 449 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual Example eventlog.overwritemethod = 0 When the log is full, the event log ignores new entries. Also see eventlog.all() (on page 7-100) eventlog.clear() (on page 7-101) eventlog.count (on page 7-101) eventlog.enable (on page 7-102)
Page 450 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: 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 451 Section 7: TSP command reference Model 2651A High Power 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")
Page 452 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference fileVar:read() This function reads data from a file. Type TSP-Link accessible Affected by Where saved Default value Function Usage data1 = fileVar:read() data1 = fileVar:read(format1) data1, data2 = fileVar:read("format1", "format2") data1, ..., datan = fileVar:read("format1", ..., "formatn") data1 First data read from the file...
Page 453 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual Example local fileName = "/usb1/myfile.txt" if fs.is_file(fileName) then os.remove(fileName) print("Removing file") else print("Nothing removed") print("fileVar:read") myfile, myfile_err, myfile_errnum = io.open(fileName, "w") myfile:write("Line 1") myfile:close() myfile, myfile_err, myfile_errnum = io.open(fileName, "r") contents = myfile:read("*a") print(contents) myfile:close()
Page 454 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Details The whence parameters may be any of the following: "set": Beginning of file "cur": Current position "end": End of file If an error is encountered, it is logged to the error queue, and the command returns nil and the error string.
Page 455 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual fileVar:write() This function writes data to a file. Type TSP-Link accessible Affected by Where saved Default value Function Usage fileVar:write(data) fileVar:write(data1, data2) fileVar:write(data1, ..., datan) fileVar The file descriptor variable data Write all data to the file...
Page 456 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference format.asciiprecision This attribute sets the precision (number of digits) for all numbers returned in the ASCII format. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Instrument reset Not saved...
Page 457 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual 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...
Page 458 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference format.data This attribute sets the data format for data that is printed using the printnumber() and printbuffer() functions. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Instrument reset Not saved...
Page 459 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual Also see format.asciiprecision (on page 7-111) format.byteorder (on page 7-112) printbuffer() (on page 7-191) printnumber() (on page 7-192) fs.chdir() This function sets the current working directory. Type TSP-Link accessible Affected by...
Page 460 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference fs.cwd() This function returns the absolute path of the current working directory. Type TSP-Link accessible Affected by Where saved Default value Function Usage path = fs.cwd() path The absolute path of the current working directory Example...
Page 461 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual fs.is_dir() This function tests whether or not the specified path refers to a directory. Type TSP-Link accessible Affected by Where saved Default value Function Usage status = fs.is_dir("path") status Whether or not the given path is a directory (true or false) path...
Page 462 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference 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 status = fs.is_file("path") status true if the given path is a file;...
Page 463 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual fs.mkdir() This function creates a directory at the specified path. Type TSP-Link accessible Affected by Where saved Default value Function Usage path = fs.mkdir("newPath") path The returned path of the new directory newpath Location (path) of where to create the new directory Details...
Page 464 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference fs.readdir() This function returns a list of the file system entries in the directory. Type TSP-Link accessible Affected by Where saved Default value Function Usage files = fs.readdir("path") files A table containing the names of all the file system entries in the specified directory path...
Page 465 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual fs.rmdir() This function removes a directory from the file system. Type TSP-Link accessible Affected by Where saved Default value Function Usage fs.rmdir("path") path The path of the directory to remove Details This path may be absolute or relative to the present working directory.
Page 466 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference gettimezone() This function retrieves the local time zone. Type TSP-Link accessible Affected by Where saved Default value Function Usage timeZone = gettimezone() timeZone The local time zone of the instrument Details See settimezone() for additional details about the time zone format and a description of the fields.
Page 467 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual gm_isweep() This KIParlib factory script function performs a linear current sweep and calculates the transconductance (G ) at each point. Type TSP-Link accessible Affected by Where saved Default value Function Usage...
Page 468 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference gm_vsweep() This KIParlib factory script function performs a linear voltage sweep and calculates the transconductance (G ) at each point. Type TSP-Link accessible Affected by Where saved Default value Function Usage...
Page 469 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual gpib.address This attribute contains the GPIB address. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Not applicable Nonvolatile memory Usage address = gpib.address gpib.address = address address The GPIB address of the instrument (1 to 30)
Page 470 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: 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...
Page 471 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual Example smua.source.highc = smua.ENABLE Enable high-capacitance mode. Charge the smua.source.levelv = 5 capacitor at 5 V for 1 second set by delay(1). smua.source.output = smua.OUTPUT_ON delay(1) imeas = i_leakage_measure(smua, 0, 1, 300e-3, The parameters passed on to the i_leakage_measure() function in this...
Page 472 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Details Use this function when high-capacitance mode is active. When the instrument is in high-capacitance mode, this function causes the SMU to: • Change its current limit to limiti with a voltage output of levelv for sourcedelay time, and then changes its current limit to measurei (that also changes the measurement range to measurei) for measuredelay time.
Page 473 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual InitiatePulseTest() This KIPulse factory script function initiates the pulse configuration assigned to tag. Type TSP-Link accessible Affected by Where saved Default value Function Usage f, msg = InitiatePulseTest(tag) A Boolean flag;...
Page 474 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Also see ConfigPulseIMeasureV() (on page 7-38) ConfigPulseIMeasureVSweepLin() (on page 7-40) ConfigPulseIMeasureVSweepLog() (on page 7-42) ConfigPulseVMeasureI() (on page 7-44) ConfigPulseVMeasureISweepLin() (on page 7-47) ConfigPulseVMeasureISweepLog() (on page 7-49) KIPulse factory script (on page 5-23) io.close()
Page 475 Section 7: TSP command reference Model 2651A High Power 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 476 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference io.input() This function assigns a previously opened file, or opens a new file, as the default input file. Type TSP-Link accessible Affected by Where saved Default value Function Yes (see Details) Usage...
Page 477 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual io.open() This function opens a file for later reference. Type TSP-Link accessible Affected by Where saved Default value Function Usage fileVar, errorMsg = io.open("path") fileVar, errorMsg = io.open("path", "mode") fileVar The descriptor of the opened file errorMsg...
Page 478 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference 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...
Page 479 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual 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...
Page 480 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Example local fileName = "/usb1/myfile.txt" if fs.is_file(fileName) then os.remove(fileName) print("Removing file") else print("Nothing removed") errorqueue.clear() -- io.read print("\n*** io.read") myfile, myfile_err, myfile_errnum = io.open(fileName, "w") myfile:write("Line 1\n") myfile:flush() myfile:close() fileHandle = io.input(fileName)
Page 481 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual Example local fileName = "/usb1/myfile.txt" if fs.is_file(fileName) then os.remove(fileName) print("Removing file") else print("Nothing removed") errorqueue.clear() print("\n*** io.type") myfile, myfile_err, myfile_errnum = io.open(fileName, "w") myfile:write("Line 1") myfile:close() fileHandle = io.output(fileName) state = io.type(fileHandle) print(state)
Page 482 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Data is not immediately written to a file when you use the io.write() function. The io.write() function buffers data; it may not be written to the USB flash drive immediately. Use the io.flush() function to immediately write buffered data to the drive.
Page 483 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual lan.applysettings() This function re-initializes the LAN interface with new settings. Type TSP-Link accessible Affected by Where saved Default value Function Usage lan.applysettings() Details Disconnects all existing LAN connections to the instrument and re-initializes the LAN with the present configuration settings.
Page 484 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference lan.autoconnect This attribute is used to enable or disable link monitoring. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) LAN restore defaults Nonvolatile memory 1 (lan.ENABLE) Usage state = lan.autoconnect...
Page 485 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual lan.config.dns.address[N] Configures DNS server IP addresses. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) LAN restore defaults Nonvolatile memory "0.0.0.0" Usage dnsAddress = lan.config.dns.address[N] lan.config.dns.address[N] = "dnsAddress"...
Page 486 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference lan.config.dns.domain Configures the dynamic DNS domain. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) LAN restore defaults Nonvolatile memory "" Usage domain = lan.config.dns.domain lan.config.dns.domain = "domain"...
Page 487 Section 7: TSP command reference Model 2651A High Power 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...
Page 488 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference lan.config.dns.hostname This attribute defines the dynamic DNS host name. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Not applicable Nonvolatile memory Instrument specific (see Details) Usage hostName = lan.config.dns.hostname lan.config.dns.hostname = "hostName"...
Page 489 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual lan.config.dns.verify This attribute defines the DNS host name verification state. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) LAN restore defaults Nonvolatile memory 1 (lan.ENABLE) Usage state = lan.config.dns.verify...
Page 490 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Details This attribute does not indicate the actual setting currently in effect. Use the lan.status.duplex attribute to determine the present operating state of the LAN. Example lan.config.duplex = lan.FULL Set the LAN duplex mode to full.
Page 491 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual lan.config.ipaddress This command specifies the LAN IP address. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) LAN restore defaults Nonvolatile memory "192.168.0.2" Usage ipAddress = lan.config.ipaddress lan.config.ipaddress = "ipAddress"...
Page 492 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference 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...
Page 493 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual lan.config.speed This attribute contains the LAN speed used when restarting in manual configuration mode. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) LAN restore defaults Nonvolatile memory 100 (100 Mbps) Usage...
Page 494 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference lan.config.subnetmask This attribute contains the LAN subnet mask. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) LAN restore defaults Nonvolatile memory "255.255.255.0" Usage mask = lan.config.subnetmask lan.config.subnetmask = "mask"...
Page 495 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual If the LAN link integrity is not restored before the timeout value expires, the instrument begins to monitor for a new connection. Example print(lan.linktimeout) Outputs the present LAN link timeout setting. Also see lan.autoconnect (on page 7-139)
Page 496 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference lan.nagle This attribute controls the state of the LAN Nagle algorithm. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Power cycle Not saved 0 (lan.DISABLE) Usage state = lan.nagle...
Page 497 Section 7: TSP command reference Model 2651A High Power 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 498 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: 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...
Page 499 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual lan.status.dns.name This attribute contains the present DNS fully qualified host name. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Not applicable Not applicable Not applicable Usage hostName = lan.status.dns.name...
Page 500 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference lan.status.duplex This attribute contains the duplex mode 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...
Page 501 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual lan.status.ipaddress This attribute contains the LAN IP address presently in use by the LAN interface. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Not applicable Not applicable Not applicable...
Page 502 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference lan.status.port.dst This attribute contains the LAN dead socket termination port number. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Not applicable Not applicable Not applicable Usage port = lan.status.port.dst...
Page 503 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual lan.status.port.telnet This attribute contains the LAN Telnet connection port number. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Not applicable Not applicable Not applicable Usage port = lan.status.port.telnet port...
Page 504 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference lan.status.speed This attribute contains the LAN speed. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Not applicable Not applicable Not applicable Usage speed = lan.status.speed speed LAN speed in Mbps, either 10 or 100 Details...
Page 505 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual lan.timedwait This attribute contains the LAN timed-wait state interval. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) LAN restore defaults Nonvolatile memory 20 (20 s) Usage timeout = lan.timedwait lan.timedwait = timeout...
Page 506 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference lan.trigger[N].assert() This function simulates the occurrence of the trigger and generates the corresponding event ID. Type TSP-Link accessible Affected by Where saved Default value Function Usage lan.trigger[N].assert() The LAN event number (1 to 8) Details...
Page 507 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual Details The trigger event detector enters the detected state when an event is detected. This function clears a trigger event detector and discards the history of the trigger packet. This function clears all overruns associated with this LAN trigger.
Page 508 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference lan.trigger[N].connected This attribute stores the LAN event connection state. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Not applicable Not applicable Not applicable Usage connected = lan.trigger[N].connected connected...
Page 509 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual lan.trigger[N].disconnect() This function disconnects the LAN trigger. Type TSP-Link accessible Affected by Where saved Default value Function Usage lan.trigger[N].disconnect() The LAN event number (1 to 8) Details For TCP connections, this closes the TCP connection.
Page 510 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference lan.trigger[N].ipaddress This attribute specifies the address (in dotted-decimal format) of UDP or TCP listeners. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Instrument reset Not saved "0.0.0.0"...
Page 511 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual lan.trigger[N].mode This attribute sets the trigger operation and detection mode of the specified LAN event. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Instrument reset Not saved 0 (lan.TRIG_EITHER)
Page 512 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Also see Digital I/O (on page 3-92) TSP-Link system expansion interface (on page 6-56) lan.trigger[N].overrun This attribute contains the overrun status of the LAN event detector. Type TSP-Link accessible Affected by...
Page 513 Section 7: TSP command reference Model 2651A High Power 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...
Page 514 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference lan.trigger[N].pseudostate This attribute sets the simulated line state for the LAN trigger. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Instrument reset Not saved LAN trigger N reset Recall setup Usage...
Page 515 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual lan.trigger[N].stimulus This attribute specifies events that cause this trigger to assert. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Instrument reset Not saved LAN trigger N reset Recall setup Usage...
Page 516 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Example lan.trigger[5].stimulus = trigger.timer[1].EVENT_ID Use timer 1 trigger event as the source for LAN packet 5 trigger stimulus. Also see lan.trigger[N].assert() (on page 7-161) lan.trigger[N].clear() (on page 7-161) lan.trigger[N].connect() (on page 7-162) lan.trigger[N].overrun...
Page 517 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual localnode.autolinefreq This attribute enables or disables automatic power line frequency detection at start-up. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Not applicable Nonvolatile memory true (enabled) Usage...
Page 518 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference localnode.description This attribute stores a user-defined description and mDNS service name of the instrument. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Not applicable Nonvolatile memory Instrument specific (see Details) Usage...
Page 519 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual localnode.license This attribute returns the product license agreements. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Not applicable Nonvolatile memory Not applicable Usage license_agreement = localnode.license license_agreement The text of the license agreements...
Page 520 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Example 2 localnode.linefreq = 60 Sets the line frequency to 60 Hz. Also see localnode.autolinefreq (on page 7-172) localnode.model This attribute stores the model number. Type TSP-Link accessible Affected by Where saved...
Page 521 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual You can reset the password by resetting the LAN from the front panel or by sending the lan.reset() command. When using this command from a remote node, localnode should be replaced with the node reference, for example, node[5].password.
Page 522 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Example mode = localnode.PASSWORD_WEB Sets value of mode to PASSWORD_WEB. localnode.passwordmode = mode Allows use of passwords on the web interface only. localnode.password = "SMU1234" Set the password to SMU1234. Also see localnode.password (on page 7-175)
Page 523 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual Do not disable prompting when using Test Script Builder. Test Script Builder requires prompts and sets the prompting mode automatically. If you disable prompting, the instrument stops responding when you communicate using Test Script Builder because it is waiting for a common complete prompt from Test Script Builder.
Page 524 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference 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 525 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual 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...
Page 526 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference 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 7-173) localnode.model (on page 7-175) localnode.revision...
Page 527 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual 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 528 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference makesetter() This function creates a function that, when called, sets the value of an attribute. Type TSP-Link accessible Affected by Where saved Default value Function Usage setter = makesetter(table, "attributeName") setter Function that sets the value of the attribute...
Page 529 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual meminfo() This function returns the present amount of available memory and the total amount of memory in the instrument. Type TSP-Link accessible Affected by Where saved Default value Function Usage...
Page 530 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference node[N].execute() This function starts test scripts on a remote TSP-Link node. Type TSP-Link accessible Affected by Where saved Default value Function Yes (see Details) Usage node[N].execute("scriptCode") The node number of this instrument (1 to 63) scriptCode A string containing the source code...
Page 531 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual node[N].getglobal() This function returns the value of a global variable. Type TSP-Link accessible Affected by Where saved Default value Function Usage value = node[N].getglobal("name") value The value of the variable The node number of this instrument (1 to 64) name The global variable name...
Page 532 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference node[N].setglobal() This function sets the value of a global variable. Type TSP-Link accessible Affected by Where saved Default value Function Usage node[N].setglobal("name", value) The node number of this instrument (1 to 64) name The global variable name to set value...
Page 533 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual opc() This function sets the operation complete status bit when all overlapped commands are completed. Type TSP-Link accessible Affected by Where saved Default value Function Usage opc() Details This function causes the operation complete bit in the Standard Event Status Register to be set when...
Page 534 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Example os.remove("testFile") Delete the file named testFile. Also see os.rename() (on page 7-189) os.rename() This function renames an existing file or directory. Type TSP-Link accessible Affected by Where saved Default value Function...
Page 535 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual Details The timespec is a table using the fields listed in the table below. year The year (1970 or later) month The month (1 to 12) The day (1 to 31) hour The hour (00 to 23)
Page 536 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Numbers are printed using the format.asciiprecision attribute. If you want use Lua formatting, print the return value from the tostring() function. Example 1 x = 10 print(x) Example of an output response message: Note that your output might be different if you set your ASCII precision setting to a different value.
Page 537 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual If you pass a reading buffer instead of a reading buffer subtable, the default subtable for that reading buffer is used. This command generates a single response message that contains all data. The response message is stored in the output queue.
Page 538 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Example format.asciiprecision = 10 x = 2.54 printnumber(x) format.asciiprecision = 3 printnumber(x, 2.54321, 3.1) Configure the ASCII precision to 10 and set x to 2.54. Read the value of x based on these settings. Change the ASCII precision to 3.
Page 539 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual To perform the specified number of pulse I, measure V cycles, this function: Sets the smu to output bias amperes and dwell for toff seconds. Sets the smu to output level amperes and dwell for ton seconds. Performs voltage measurement with source at level amperes.
Page 540 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference To perform the specified number of pulse V, measure I cycles, this function: Sets the smu to output bias volts and dwell for toff seconds Sets the smu to output level volts and dwell for ton seconds Performs voltage measurement with source at level volts Sets the smu to output bias volts for toff seconds Repeats steps 2 through 4 for the remaining points pulse-measure cycles...
Page 541 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual This function returns a table that contains the settings associated with the tag input parameter. Return values: tostring() A function that returns most settings in a string that is convenient for printing Identifying tag for this pulse train The SMU configured for pulsing func...
Page 542 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Also see ConfigPulseIMeasureV() (on page 7-38) ConfigPulseIMeasureVSweepLin() (on page 7-40) ConfigPulseIMeasureVSweepLog() (on page 7-42) ConfigPulseVMeasureI() (on page 7-44) ConfigPulseVMeasureISweepLin() (on page 7-47) ConfigPulseVMeasureISweepLog() (on page 7-49) KIPulse factory script (on page 5-23) reset()
Page 543 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual savebuffer() This KISavebuffer factory script function saves a specified reading buffer as either a CSV file or an XML file. Type TSP-Link accessible Affected by Where saved Default value Function Usage...
Page 544 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference script.anonymous This is a reference to the anonymous script. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) See Details See Details Not applicable Usage scriptVar = script.anonymous scriptVar...
Page 545 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual script.delete() This function deletes a script from nonvolatile memory. Type TSP-Link accessible Affected by Where saved Default value Function Usage script.delete("scriptName") scriptName The string that represents the name of the script Example script.delete("test8") Deletes a user script named test8 from nonvolatile memory.
Page 546 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference script.load() This function creates a script from a specified file. Type TSP-Link accessible Affected by Where saved Default value Function Usage scriptVar = script.load("file") scriptVar = script.load("file", "name") scriptVar The created script;...
Page 547 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual script.new() This function creates a script. Type TSP-Link accessible Affected by Where saved Default value Function Usage scriptVar = script.new("code") scriptVar = script.new("code", "name") scriptVar The name of the variable that references the script code A string containing the body of the script name...
Page 548 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference script.newautorun() This function creates a script and enables autorun. Type TSP-Link accessible Affected by Where saved Default value Function Usage scriptVar = script.newautorun("code") scriptVar = script.newautorun("code", "name") scriptVar The name of the variable that references the script code...
Page 549 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual script.restore() This function restores a script that was removed from the runtime environment. Type TSP-Link accessible Affected by Where saved Default value Function Usage script.restore(name) name The name of the script to be restored Details This command copies the script from nonvolatile memory into the runtime environment.
Page 550 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference script.user.catalog() This function returns an iterator that can be used in a for loop to iterate over all the scripts stored in nonvolatile memory. Type TSP-Link accessible Affected by Where saved Default value...
Page 551 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual scriptVar.autorun This attribute controls the autorun state of a script. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Not applicable See Details See Details Usage scriptVar.autorun = "state"...
Page 552 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference scriptVar.list() This function generates a script listing. Type TSP-Link accessible Affected by Where saved Default value Function Usage scriptVar.list() scriptVar The name of the variable that references the script Details This function generates output in the form of a sequence of response messages (one message for each line of the script).
Page 553 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual scriptVar.name This attribute contains the name of a script in the runtime environment. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Not applicable Not applicable Not applicable Usage...
Page 554 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference scriptVar.run() This function runs a script. Type TSP-Link accessible Affected by Where saved Default value Function Usage scriptVar.run() scriptVar() scriptVar The name of the variable that references the script Details The scriptVar.run() function runs the script referenced by scriptVar.
Page 555 Section 7: TSP command reference Model 2651A High Power 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...
Page 556 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: 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...
Page 557 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual serial.baud This attribute configures the baud rate for the RS-232 port. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Not applicable Nonvolatile memory 9600 Usage baud = serial.baud...
Page 558 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference serial.databits This attribute configures character width (data bits) for the RS-232 port. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Not applicable Nonvolatile memory Usage bits = serial.databits serial.databits = bits...
Page 559 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual serial.flowcontrol This attribute configures flow control for the RS-232 port. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Not applicable Nonvolatile memory "none" (serial.FLOW_NONE) Usage flow = serial.flowcontrol serial.flowcontrol = flow...
Page 560 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference 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...
Page 561 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual 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...
Page 562 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference serial.write() This function writes data to the serial port. Type TSP-Link accessible Affected by Where saved Default value Function Usage serial.write("data") data A string representing the data to write Details This function writes the specified string to the serial port, where it can be read by connected equipment (for example, a component handler).
Page 563 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual settime() This function sets the real-time clock (sets present time of the system). Type TSP-Link accessible Affected by Where saved Default value Function Usage settime(time) time The time in seconds since January 1, 1970 UTC Details This function sets the date and time of the instrument based on the time parameter (specified in...
Page 564 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: 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 565 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual The week of the month and day of the week fields are not specific dates. 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 566 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: 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 567 Section 7: TSP command reference Model 2651A High Power 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 568 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference smuX.abort() This function terminates all overlapped operations on the 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 569 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual Attribute When returned Description Always The number of data points on which the statistics are based mean When n > 0 The average of all readings added to the buffer stddev When n >...
Page 570 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Also see smuX.buffer.recalculatestats() (on page 7-225) 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)
Page 571 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual smuX.cal.adjustdate This attribute stores the date of the last calibration adjustment. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) SMU cal. restore SMU nonvolatile memory Initially set to factory calibration date Usage...
Page 572 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference smuX.cal.date This attribute stores the calibration date of the active calibration set. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) SMU calibration restore SMU nonvolatile memory Initially set to factory calibration date...
Page 573 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual smuX.cal.due This attribute stores the calibration due date for the next calibration. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) SMU cal. restore SMU nonvolatile memory Usage calDue = smuX.cal.due...
Page 574 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference smuX.cal.fastadc() This function performs calibration of the fast analog-to-digital converter (fast ADC). Type TSP-Link accessible Affected by Where saved Default value Function Usage smuX.cal.fastadc() Source-measure unit (SMU) channel (for example, smua.cal.fastadc() specifies SMU channel A) Details This function automatically performs all the steps required to calibrate the fast ADC.
Page 575 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual smuX.cal.lock() This function disables the commands that change calibration settings. Type TSP-Link accessible Affected by Where saved Default value Function Usage smuX.cal.lock() Details Before you can lock calibration, the calibration constants must be written to nonvolatile memory or a previous calibration set must be restored.
Page 576 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: 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"...
Page 577 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual smuX.cal.polarity This attribute controls which calibration constants are used for all subsequent measurements. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Instrument reset Not saved 0 (smuX.CAL_AUTO) SMU reset...
Page 578 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference smuX.cal.restore() This function loads a stored set of calibration constants. Type TSP-Link accessible Affected by Where saved Default value Function Usage smuX.cal.restore() smuX.cal.restore(calset) calset The calibration set to be loaded; set calset to one of the following values: ▪...
Page 579 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual smuX.cal.save() This function stores the active calibration constants to nonvolatile memory. Type TSP-Link accessible Affected by Where saved Default value Function Usage smuX.cal.save() Details This function stores the active set of calibration constants to nonvolatile memory. The previous calibration constants (from the default calibration set) are copied to the previous calibration set (smuX.CALSET_PREVIOUS) before overwriting the default calibration set.
Page 580 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference 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 581 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual 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) password Calibration password Details This function enables the calibration functions to change the calibration settings.
Page 582 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference The new calibration constants are activated immediately but are not written to nonvolatile memory. Use smuX.cal.save() to save the new constants to nonvolatile memory. The active calibration constants stay in effect until the instrument is power cycled or a calibration set is loaded from nonvolatile memory with the smuX.cal.restore() function.
Page 583 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual smuX.contact.calibratelo() This function adjusts the low/sense low contact check measurement. Type TSP-Link accessible Affected by Where saved Default value Function Usage smuX.contact.calibratelo(cp1Measured, cp1Reference, cp2Measured, cp2Reference) cp1Measured The value measured by this SMU for point 1 cp1Reference The reference measurement for point 1 as measured externally...
Page 584 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference smuX.contact.check() This function determines if contact resistance is lower than the threshold. Type TSP-Link accessible Affected by Where saved Default value Function Usage smuX.contact.check() Details This function returns true if the contact resistance is below the threshold; this function returns false if it is above the threshold.
Page 585 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual smuX.contact.r() This function measures aggregate contact resistance. Type TSP-Link accessible Affected by Where saved Default value Function Usage rhi, rlo = smuX.contact.r() The measured aggregate contact resistance on the HI/sense HI side The measured aggregate contact resistance on the LO/sense LO side Details If you attempt to perform a contact resistance measurement when any of the following conditions...
Page 586 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference smuX.contact.speed This attribute stores the speed setting for contact check measurements. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Instrument reset Not saved 0 (smuX.CONTACT_FAST) SMU reset Recall setup...
Page 587 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual smuX.contact.threshold This attribute stores the resistance threshold for the smuX.contact.check() function. Type TSP-Link accessible Affected by Where saved Default value 50 (50 Ω) Attribute (RW) Instrument reset Not saved SMU reset Recall setup...
Page 588 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference smuX.makebuffer() This function creates a reading buffer. Type TSP-Link accessible Affected by Where saved Default value Function Usage bufferVar = smuX.makebuffer(bufferSize) bufferVar The created reading buffer bufferSize Maximum number of readings that can be stored Details...
Page 589 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual Details When making measurements, the SMU uses one of two types of analog-to-digital converters. This attribute controls which analog to converter is used. Example smua.measure.adc = smua.ADC_FAST Selects the fast A/D converter for SMU channel A.
Page 590 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Example smua.measure.autorangev = smua.AUTORANGE_ON Enables voltage measurement autoranging. Also see Autoranging (on page 2-74) Range (on page 2-71) reset() (on page 7-197) setup.recall() (on page 7-221) smuX.measure.rangeY (on page 7-258) smuX.reset()
Page 591 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual Disabling automatic reference measurements may allow the instrument to gradually drift out of specification. To minimize the drift, make a reference and zero measurement immediately before any critical test sequences.
Page 592 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference The new calibration constants are activated immediately but they are not written to nonvolatile memory. Use the smuX.cal.save() function to save the new constants to nonvolatile memory. The active calibration constants stay in effect until the instrument is power cycled or a calibration set is loaded from nonvolatile memory with the smuX.cal.restore() function.
Page 593 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual Example smua.measure.count = 10 Sets the measure count to 10. Also see reset() (on page 7-197) setup.recall() (on page 7-221) smuX.measure.delay (on page 7-248) smuX.measure.interval (on page 7-254) smuX.measure.overlappedY() (on page 7-257) smuX.measure.Y()
Page 594 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Example smua.measure.delay = 0.010 Sets a 10 ms measurement delay. Also see Measure auto delay (on page 2-73) reset() (on page 7-197) smuX.measure.count (on page 7-247) smuX.measure.delayfactor (on page 7-249) smuX.source.delay...
Page 595 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual 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...
Page 596 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference 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...
Page 597 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual 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...
Page 598 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference smua.measure.highcrangedelayfactor This attribute contains a delay multiplier that is only used during range changes when the high-capacitance mode is active. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Instrument reset...
Page 599 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual smuX.measure.interval This attribute sets the interval between multiple measurements. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Instrument reset Saved setup 0 (0 s) SMU reset Recall setup Usage...
Page 600 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference smuX.measure.lowrangeY This attribute sets the lowest measurement range that is used when the instrument is autoranging. Type TSP-Link Affected by Where saved Default value accessible Attribute (RW) Instrument reset Saved setup Current: 100e-9 (100 nA)
Page 601 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual smuX.measure.nplc This command sets the integration aperture for measurements. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Instrument reset Saved setup SMU reset Recall setup Usage nplc = smuX.measure.nplc...
Page 602 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference smua.measure.overlappedY() This function starts an asynchronous (background) measurement. Type TSP-Link accessible Affected by Where saved Default value Function Usage smua.measure.overlappedY(rbuffer) smua.measure.overlappediv(ibuffer, vbuffer) SMU measurement type (v = voltage, i = current, r = resistance, p = power) rbuffer A reading buffer object where the readings are stored ibuffer...
Page 603 Section 7: TSP command reference Model 2651A High Power 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 Current:...
Page 604 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Example smua.measure.rangev = 0.5 Selects the 1 V measurement range. Also see Range (on page 2-71) reset() (on page 7-197) setup.recall() (on page 7-221) smuX.measure.autorangeY (on page 7-244) smuX.reset() (on page 7-264) smuX.source.rangeY...
Page 605 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual smua.measure.rel.levelY This attribute sets the offset value for relative measurements. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Instrument reset Not saved SMU reset Recall setup Usage relValue = smua.measure.rel.levelY...
Page 606 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference smuX.measure.Y() This function makes one or more measurements. Type TSP-Link accessible Affected by Where saved Default value Function Usage reading = smuX.measure.Y() reading = smuX.measure.Y(readingBuffer) iReading, vReading = smuX.measure.iv() iReading, vReading = smuX.measure.iv(iReadingBuffer) iReading, vReading = smuX.measure.iv(iReadingBuffer, vReadingBuffer) reading...
Page 607 Section 7: TSP command reference Model 2651A High Power 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-6) smuX.measure.count (on page 7-247) smuX.measure.overlappedY()
Page 608 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Example local ivalues = {} This use of the SMU channel A smua.source.rangev = 1 measure and step function smua.source.levelv = 0 measures current starting at a source value of 0 V.
Page 609 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual Example smua.measure.overlappedv(smua.nvbuffer1) Store voltage readings from SMU channel A into SMU channel A dedicated reading buffer 1. Also see Configuring and running sweeps (on page 3-31) Reading buffers (on page 3-6) savebuffer()
Page 610 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference smuX.savebuffer() This function saves one source-measure unit (SMU) dedicated reading buffer to nonvolatile memory. Type TSP-Link accessible Affected by Where saved Default value Function Usage smuX.savebuffer(smuX.nvbufferY) SMU dedicated reading buffer (1 or 2) Details When the instrument is turned off and back on, the dedicated reading buffers are restored from...
Page 611 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual smuX.sense This attribute contains the state of the sense mode. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) SMU reset Saved setup 0 (smuX.SENSE_LOCAL) Instrument reset Recall setup Usage...
Page 612 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference 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...
Page 613 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual 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) SMU source function (v = voltage, i = current) range The measurement range to adjust...
Page 614 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference 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...
Page 615 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual 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...
Page 616 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference 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...
Page 617 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual • smuX.measure.autoranei is set to smuX.AUTORANGE_FOLLOW_LIMIT and cannot be changed • Current ranges below 1 µA are not accessible • If smuX.source.limiti is less than 1 µA, it is raised to 1 µA •...
Page 618 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Details This attribute configures the output level of the voltage or current source. If the source is configured as a voltage source and the output is on, the new smuX.source.levelv setting is sourced immediately.
Page 619 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual 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 620 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Example smua.source.lowrangev = 1 Sets volts low range for Model 2651A SMU channel A to 1 V. This prevents the source from using the 100 mV range when sourcing voltage.
Page 621 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual smuX.source.offlimitY This attribute sets the limit (current or voltage) used when the source-measure unit (SMU) is in normal output-off mode. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) SMU reset...
Page 622 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference 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...
Page 623 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual 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...
Page 624 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference smuX.source.outputenableaction This attribute controls output enable action of the source. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) SMU reset Saved setup 0 (smuX.OE_NONE) Instrument reset Recall setup Usage...
Page 625 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual smuX.source.rangeY This attribute contains the source range. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) SMU reset Saved setup Voltage: 100e-3 (100 mV) Instrument reset Current: 100e-9 (100 nA) Recall setup...
Page 626 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference smuX.source.settling This attribute contains the source settling mode. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) SMU reset Not saved 0 (smuX.SETTLE_SMOOTH) Instrument reset Recall setup Usage settleOption = smuX.source.settling...
Page 627 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual 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 Recall setup Usage...
Page 628 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference smuX.trigger.arm.count This attribute sets the arm count in the trigger model. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) SMU reset Not saved Instrument reset Recall setup Usage...
Page 629 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual smuX.trigger.arm.set() This function sets the arm event detector to the detected state. Type TSP-Link accessible Affected by Where saved Default value Function Usage smuX.trigger.arm.set() Details The SMU automatically clears all the event detectors when the smuX.trigger.initiate() function is executed.
Page 630 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: 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...
Page 631 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual Example smua.trigger.arm.stimulus = trigger.timer[1].EVENT_ID An event on trigger timer 1 causes the arm event detector to enter the detected state. Also see Triggering (on page 3-36) smuX.trigger.ARMED_EVENT_ID This constant contains the number of the armed event.
Page 632 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: 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...
Page 633 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual 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 634 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: 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...
Page 635 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual 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 636 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: 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...
Page 637 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual Example smua.trigger.endpulse.action = smua.SOURCE_IDLE smua.trigger.endpulse.stimulus = trigger.timer[1].EVENT_ID Configure the end pulse action to achieve a pulse and select the event, trigger.timer[1].EVENT_ID, that causes the arm event detector to enter the detected state. Also see Triggering (on page 3-36)
Page 638 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: 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 Details Set the stimulus of any trigger object to the value of this constant to have the trigger object respond to idle events from this SMU.
Page 639 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual smuX.trigger.initiate() This function initiates a sweep operation. Type TSP-Link accessible Affected by Where saved Default value Function Usage smuX.trigger.initiate() Details This function causes the SMU to clear the four trigger model event detectors and enter its trigger model (moves the SMU from the idle state into the arm layer).
Page 640 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference smuX.trigger.measure.action This attribute controls measurement actions during a sweep. 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 641 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual Example smua.trigger.measure.v(smua.nvbuffer1) smua.trigger.measure.action = smua.ENABLE Configure sweep voltage measurements. Enable voltage measurements during the sweep. Also see bufferVar.collectsourcevalues (on page 7-23) smuX.measure.adc (on page 7-243) smuX.trigger.autoclear (on page 7-287) smuX.trigger.measure.Y() (on page 7-298)
Page 642 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference smua.trigger.measure.stimulus This attribute selects the event that causes the measure event detector to enter the detected state. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) SMU reset Not saved...
Page 643 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual Example smua.trigger.measure.stimulus = trigger.timer[1].EVENT_ID Sets delay before measurement begins. Also see Triggering (on page 3-36) smuX.trigger.measure.Y() This function configures the measurements that are to be made in a subsequent sweep. Type TSP-Link accessible Affected by...
Page 644 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Example smua.trigger.measure.v(vbuffername) Stores voltage readings during the sweep in smua.trigger.measure.action = smua.ENABLE buffer vbuffername. Also see Reading buffers (on page 3-6) smuX.measure.Y() (on page 7-261) smuX.nvbufferY (on page 7-263) smuX.trigger.measure.action (on page 7-295)
Page 645 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual Details Set the stimulus of any trigger object to the value of this constant to have the trigger object respond to pulse complete events. Example trigger.timer[1].stimulus = smua.trigger.PULSE_COMPLETE_EVENT_ID Trigger a timer when the SMU completes a pulse.
Page 646 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference smuX.trigger.source.limitY This attribute sets the sweep source limit. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) SMU reset Not saved 0 (smuX.LIMIT_AUTO) Instrument reset Recall setup Usage sweepSourceLimit = smuX.trigger.source.limitY...
Page 647 Section 7: TSP command reference Model 2651A High Power 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) SMU source function (v = voltage, i = current) startValue Source value of the first point endValue...
Page 648 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Example smua.trigger.source.linearv(0, 10, 11) Sweeps SMU channel A from 0 V to 10 V in 1 V steps. Also see smuX.trigger.source.action (on page 7-300) smuX.trigger.source.listY() (on page 7-303) smuX.trigger.source.logY() (on page 7-304) Sweep Operation...
Page 649 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual Example smua.trigger.source.listv({3, 1, 4, 5, 2}) Sweeps through 3 V, 1 V, 4 V, 5 V, and 2 V. Also see smuX.trigger.source.action (on page 7-300) smuX.trigger.source.linearY() (on page 7-302) smuX.trigger.source.logY() (on page 7-304)
Page 650 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference The asymptote parameter customizes the inflection and offset of the source value curve. This allows log sweeps to cross zero. Setting this parameter to zero provides a conventional logarithmic sweep.
Page 651 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual smuX.trigger.source.set() This function sets the source event detector to the detected state. Type TSP-Link accessible Affected by Where saved Default value Function Usage smuX.trigger.source.set() Details This function sets the source event detector to the detected state. The SMU automatically clears all event detectors when the smuX.trigger.initiate() function is executed.
Page 652 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference smuX.trigger.source.stimulus This attribute defines which event causes the source event detector to enter the detected state. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) SMU reset Not saved Instrument reset...
Page 653 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual Example smua.trigger.source.stimulus = digio.trigger[2].EVENT_ID Configure to start its source action when a trigger event occurs on digital I/O line 2. Also see Triggering (on page 3-36) smuX.trigger.SOURCE_COMPLETE_EVENT_ID This constant contains the source complete event number.
Page 654 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference smuX.trigger.SWEEP_COMPLETE_EVENT_ID This constant contains the sweep complete event number. Type TSP-Link accessible Affected by Where saved Default value Constant Usage eventID = smuX.trigger.SWEEP_COMPLETE_EVENT_ID eventID The sweep complete event number Details Set the stimulus of any trigger object to the value of this constant to have the trigger object respond to sweep complete events from this SMU.
Page 655 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual Example reset() period_timer = trigger.timer[1] pulse_timer = trigger.timer[2] smua.trigger.source.listv( {5} ) smua.trigger.source.action = smua.ENABLE smua.source.rangev = 5 smua.trigger.measure.action = smua.DISABLE pulse_timer.delay = 0.0006 pulse_timer.stimulus = period_timer.EVENT_ID pulse_timer.count = 1 period_timer.delay = 0.005 period_timer.count = 9...
Page 656 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference 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...
Page 657 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual Value and description status.MEASUREMENT_SUMMARY_BIT status.MSB Set summary bit indicates that an enabled measurement event has occurred. Bit B0 decimal value: 1 status.SYSTEM_SUMMARY_BIT status.SSB Set summary bit indicates that an enabled system event has occurred. Bit B1 decimal value: 2 status.ERROR_AVAILABLE status.EAV...
Page 658 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Example statusByte = status.condition print(statusByte) Returns statusByte. Sample output: 1.29000e+02 Converting this output (129) to its binary equivalent yields 1000 0001 Therefore, this output indicates that the set bits of the status byte condition register are presently B0 (MSS) and B7 (OSB).
Page 659 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual > > > > > > > > > > > > > > * Least significant bit ** Most significant bit For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents (on page 15-1) and...
Page 660 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference In addition to the above constants, measurementRegister can be set to the decimal equivalent of the bit to set. To set more than one bit of the register, set measurementRegister to the sum of their decimal weights.
Page 661 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual Details These attributes are used to read or write to the measurement event buffer available summary registers. Reading a status register returns a value. The binary equivalent of the returned value indicates which register bits are set.
Page 662 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference status.measurement.current_limit.* This attribute contains the measurement event current limit summary registers. Type TSP-Link accessible Affected by Where saved Default value Attribute .condition (R) Not applicable Not saved Not applicable .enable (RW) Status reset...
Page 663 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual Example status.measurement.current_limit.enable = Sets the SMUA bit of the status.measurement.current_limit.SMUA Measurement Event Current Limit Summary Enable Register. Also see Measurement event registers (on page 15-7) status.measurement.instrument.smuX.* (on page 7-319) status.measurement.instrument.* This attribute contains the registers of the measurement event instrument summary register set.
Page 664 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference 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 B2-B15 Not used...
Page 665 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual Details These attributes are used to read or write to the measurement event SMU X summary registers. Reading a status register returns a value. The binary equivalent of the returned value indicates which register bits are set.
Page 666 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Binary value Decimal Weights Binary value Decimal 32,768 16,384 8,192 4,096 2,048 1,024 Weights Example status.measurement.instrument.smua.enable = Sets the VLMT bit of the status.measurement.instrument.smua.VLMT measurement event SMU A summary enable register using a constant.
Page 667 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents (on page 15-1) and Enable and transition registers (on page 15-19). The individual bits of this register are defined in the following table.
Page 668 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference status.measurement.sink_limit.* This attribute contains the measurement sink limit summary register set. Type TSP-Link accessible Affected by Where saved Default value Attribute .condition (R) Not applicable Not saved Not applicable .enable (RW) Status reset...
Page 669 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual Example status.measurement.sink_limit.enable = Sets the SMU A bit of the status.measurement.sink_limit.SMUA measurement sink limit summary enable register using a constant. Also see Measurement event registers (on page 15-7) status.measurement.voltage_limit.* This attribute contains the measurement event voltage limit summary register set.
Page 670 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference As an example, to set bit B1 of the measurement event voltage limit summary enable register, set status.measurement.voltage_limit.enable = status.measurement.voltage_limit.SMUA. In addition to the above constant, measurementRegister can be set to the numeric equivalent of the bit to set.
Page 671 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual Value and description status.MEASUREMENT_SUMMARY_BIT status.MSB Set summary bit indicates that an enabled measurement event has occurred. Bit B0 decimal value: 1 Not used status.ERROR_AVAILABLE status.EAV Set summary bit indicates that an error or status message is present in the error queue. Bit B2 decimal value: 4 status.QUESTIONABLE_SUMMARY_BIT status.QSB...
Page 672 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Example 2 -- decimal 129 = binary 10000001 nodeEnableRegister = 129 status.node_enable = nodeEnableRegister Sets the MSB and OSB bits of the system node enable register using a decimal value. Also see status.condition (on page 7-311)
Page 673 Section 7: TSP command reference Model 2651A High Power 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...
Page 674 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Also see Status byte and service request (SRQ) (on page 15-15) Status model overview (on page 15-1) status.condition (on page 7-311) status.system.* (on page 7-383) status.operation.* These attributes manage the operation status register set of the status model.
Page 675 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents (on page 15-1) and Enable and transition registers (on page 15-19). The individual bits of this register are defined in the following table.
Page 676 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Binary value Decimal Weights Binary value 32,768 16,384 8,192 4,096 2,048 1,024 Decimal Weights Example 1 operationRegister = status.operation.USER + 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 677 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual status.operation.calibrating.* This attribute contains the operation 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...
Page 678 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Example status.operation.calibrating.enable = Sets the SMUA bit of the operation status.operation.calibrating.SMUA status calibration summary enable register using a constant. Also see Operation Status Registers (on page 15-9) status.operation.* (on page 7-329) status.operation.instrument.*...
Page 679 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents (on page 15-1) and Enable and transition registers (on page 15-19). The individual bits of this register are defined in the following table.
Page 680 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Example 1 operationRegister = status.operation.instrument.SMUA + Sets bit B1 and bit B10 of the status.operation.instrument.TRGBLND operation status instrument status.operation.instrument.enable = operationRegister summary enable register using constants. Example 2 -- 1026 = binary 0000 0100 0000 0010 Sets bit B1 and bit B10 of the...
Page 681 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual Details These attributes are used to read or write to the operation status digital I/O summary registers. Reading a status register returns a value. The binary equivalent of the returned value indicates which register bits are set.
Page 682 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference status.operation.instrument.digio.trigger_overrun.* This attribute contains the operation status digital I/O overrun register set. Type TSP-Link accessible Affected by Where saved Default value Attribute .condition (R) Not applicable Not saved Not applicable .enable (RW)
Page 683 Section 7: TSP command reference Model 2651A High Power 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...
Page 684 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: 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 15-9)
Page 685 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents (on page 15-1) and Enable and transition registers (on page 15-19). The individual bits of this register are defined in the following table.
Page 686 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Example 2 operationRegister = 1026 status.operation.instrument.lan.enable = operationRegister Use the decimal value to set bit B1 and bit B10 of the operation status LAN summary enable register. Also see Operation Status Registers (on page 15-9)
Page 687 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents (on page 15-1) and Enable and transition registers (on page 15-19). The individual bits of this register are defined in the following table.
Page 688 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Example 2 operationRegister = 258 status.operation.instrument.lan.trigger_overrun.enable = operationRegister Use the decimal value to set bit B1 and bit B8 of the operation status LAN trigger overrun enable register. Also see Operation Status Registers (on page 15-9)
Page 689 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents (on page 15-1) and Enable and transition registers (on page 15-19). The individual bits of this register are defined in the following table.
Page 690 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Example 2 status.operation.instrument.smua.enable = 1025 Use the decimal value to set bits B0 and B10 of the operation status SMU A summary enable register. Also see Operation Status Registers (on page 15-9) status.operation.instrument.smuX.trigger_overrrun.*...
Page 691 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual Value and description Not used status.operation.instrument.smuX.trigger_overrun.ARM Set bit indicates that the arm event detector of the SMU was already in the detected state when a trigger was received. Bit B1 decimal value: 2 status.operation.instrument.smuX.trigger_overrun.SRC Set bit indicates that the source event detector of the SMU was already in the detected state...
Page 692 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Example 2 status.operation.instrument.smua.trigger_overrun.enable = 18 Uses the decimal value to set bits B1 and B4 of the operation status SMU A trigger overrun enable register. Also see Operation Status Registers (on page 15-9) status.operation.instrument.smuX.*...
Page 693 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual Value and description Not used B0 to B9 status.operation.instrument.trigger_blender.TRIGGER_OVERRUN status.operation.instrument.trigger_blender.TRGOVR Set bit indicates one or more enabled bits for operation status trigger blender overrun register is set.
Page 694 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference 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 .condition (R) Not applicable Not saved Not applicable .enable (RW)
Page 695 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual A set bit value indicates that the specified trigger blender generated an action overrun. For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents (on page 15-1) and...
Page 696 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference 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)
Page 697 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual Example status.operation.instrument.trigger_timer.enable = 1024 Uses the decimal value to set the TRGOVR bit of the operation status trigger timer summary enable register. Also see Operation Status Registers (on page 15-9) status.operation.instrument.trigger_timer.trigger_overrun.* (on page 7-352)
Page 698 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Details These attributes are used to read or write to the operation status trigger timer overrun registers. Reading a status register returns a value. The binary equivalent of the returned value indicates which register bits are set.
Page 699 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual Binary value Decimal Weights Binary value 32,768 16,384 8,192 4,096 2,048 1,024 Decimal Weights Example 1 status.operation.instrument.trigger_timer.trigger_overrun.enable = status.operation.instrument.trigger_timer.trigger_overrun.TMR3 Uses a constant to set the timer 3 bit of the operation status trigger timer overrun enable register. Example 2 status.operation.instrument.trigger_timer.trigger_overrun.enable = 18 Uses a constant to set timer bits B1 and B4 of the operation status trigger timer overrun enable register.
Page 700 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Details These attributes are used to read or write to the operation status TSP-Link summary registers. Reading a status register returns a value. The binary equivalent of the returned value indicates which register bits are set.
Page 701 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual status.operation.instrument.tsplink.trigger_overrun.* This attribute contains the operation status TSP-Link 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 702 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents (on page 15-1) and Enable and transition registers (on page 15-19). The individual bits of this register are defined in the following table.
Page 703 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual status.operation.measuring.* This attribute contains the operation status measuring summary register set. Type TSP-Link accessible Affected by Where saved Default value Attribute .condition (R) Not applicable Not saved Not applicable .enable (RW) Status reset...
Page 704 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Example status.operation.measuring.enable = Uses a constant to set the SMUA bit status.operation.measuring.SMUA of the operation status measuring summary enable register. Also see Operation Status Registers (on page 15-9) status.operation.* (on page 7-329) status.operation.remote.*...
Page 705 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents (on page 15-1) and Enable and transition registers (on page 15-19). The individual bits of this register are defined in the following table.
Page 706 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference status.operation.sweeping.* This attribute contains the operation status sweeping 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 707 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual Example status.operation.sweeping.enable = Uses a constant to set the SMUA bit status.operation.sweeping.SMUA of the operation status sweeping summary enable register. Also see Operation Status Registers (on page 15-9) status.operation.* (on page 7-329) status.operation.trigger_overrun.*...
Page 708 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference The bits in this register summarize events in other registers. A set bit in this summary register indicates that an enabled event in one of the summarized registers is set. For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents...
Page 709 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual In addition to the above constants, operationRegister can be set to the numeric equivalent of the bit to set. To set more than one bit of the register, set operationRegister to the sum of their decimal weights.
Page 710 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: 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)
Page 711 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual Value Decimal value status.operation.user.BIT0 status.operation.user.BIT1 status.operation.user.BIT2 status.operation.user.BIT3 status.operation.user.BIT4 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 712 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Example 2 -- 18432 = binary 0100 1000 0000 0000 operationRegister = 18432 status.operation.enable = operationRegister Uses the decimal value to set bits B11 and B14 of the operation status user enable register. Also see Operation Status Registers (on page 15-9)
Page 713 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents (on page 15-1) and Enable and transition registers (on page 15-19). The individual bits of this register are defined in the following table.
Page 714 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: 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...
Page 715 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual Example status.questionable.calibration.enable = Uses a constant to set the SMUA bit status.questionable.calibration.SMUA of the questionable status calibration summary enable register. Also see Questionable Status Registers (on page 15-13) status.questionable.* (on page 7-367) status.questionable.instrument.*...
Page 716 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Value Description Not used Not applicable status.questionable.instrument.SMUA Set bit indicates that one or more enabled bits in the questionable status SMU A summary event register are set. Bit B1 decimal value: 2 Binary value: 0000 0010 B2 to...
Page 717 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual Details These attributes are used to read or write to the questionable status instrument SMU summary registers. Reading a status register returns a value. The binary equivalent of the returned value indicates which register bits are set.
Page 718 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Binary value Decimal Weights Binary value 32,768 16,384 8,192 4,096 2,048 1,024 Decimal Weights Example questionableRegister = status.questionable.instrument.smua.CAL + status.questionable.instrument.smua.UO status.questionable.instrument.smua.enable = questionableRegister Uses constants to set bit B8 and bit B9 of the questionable status SMU A summary enable register. Also see Questionable Status Registers (on page 15-13)
Page 719 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual Details These attributes are used to read or write to the questionable status over temperature summary registers. Reading a status register returns a value. The binary equivalent of the returned value indicates which register bits are set.
Page 720 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference 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 .condition (R) Not applicable Not saved Not applicable .enable (RW)
Page 721 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual Example status.questionable.unstable_output.enable = status.questionable.unstable_output.SMUA Uses a constant to set the SMU A bit in the questionable status unstable output summary enable register bit. Also see Questionable Status Registers (on page 15-13) status.questionable.* (on page 7-367)
Page 722 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Value status.MEASUREMENT_SUMMARY_BIT status.MSB Set summary bit indicates that an enabled event in the Measurement Event Register has occurred. Bit B0 decimal value: 1 status.SYSTEM_SUMMARY_BIT status.SSB Set summary bit indicates that an enabled event in the System Summary Register has occurred. Bit B1 decimal value: 2 status.ERROR_AVAILABLE status.EAV...
Page 723 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual Example 1 requestSRQEnableRegister = status.MSB + status.OSB status.request_enable = requestSRQEnableRegister Uses constants to set the MSB and OSB bits of the service request (SRQ) enable register. Example 2 -- decimal 129 = binary 10000001 requestSRQEnableRegister = 129...
Page 724 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Value and description status.MEASUREMENT_SUMMARY_BIT status.MSB Set summary bit indicates that an enabled event in the Measurement Event Register has occurred. Bit B0 decimal value: 1 status.SYSTEM_SUMMARY_BIT status.SSB Set summary bit indicates that an enabled event in the System Summary Register has occurred.
Page 725 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual Also see status.condition (on page 7-311) status.system.* (on page 7-383) Status model overview (on page 15-5) Status byte and service request (SRQ) (on page 15-15) status.reset() This function resets all bits in the status model.
Page 726 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: 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...
Page 727 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual Value status.standard.OPERATION_COMPLETE status.standard.OPC Set bit indicates that all pending selected instrument operations are completed and the instrument is ready to accept new commands. The bit is set in response to an *OPC command. The opc() function can be used in place of the *OPC command.
Page 728 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Example 1 standardRegister = status.standard.OPC + status.standard.EXE status.standard.enable = standardRegister Uses constants to set the OPC and EXE bits of the standard event status enable register. Example 2 -- decimal 17 = binary 0001 0001 standardRegister = 17...
Page 729 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual > > > > > > > > > > > > > > * Least significant bit ** Most significant bit For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents (on page 15-1) and...
Page 730 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Binary value 32,768 16,384 8,192 4,096 2,048 1,024 Decimal Weights Example 1 enableRegister = status.system.NODE11 + status.system.NODE14 status.system.enable = enableRegister Uses constants to set bits B11 and B14 of the system summary enable register. Example 2 -- decimal 18432 = binary 0100 1000 0000 0000 enableRegister = 18432...
Page 731 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual Details In an expanded system (TSP-Link), these attributes are used to read or write to the system summary registers. They are set using a constant or a numeric value but are returned as a numeric value. The binary equivalent of the value indicates which register bits are set.
Page 732 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Binary value Decimal Weights Binary value 32,768 16,384 8,192 4,096 2,048 1,024 Decimal Weights Example 1 enableRegister = status.system2.NODE25 + status.system2.NODE28 status.system2.enable = enableRegister Uses constants to set bits B11 and B14 of the system summary 2 enable register. Example 2 -- decimal 18432 = binary 0100 1000 0000 0000 enableRegister = 18432...
Page 733 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual status.system3.* ® These attributes manage the TSP-Link system summary register of the status model for nodes 29 through 42. Type TSP-Link accessible Affected by Where saved Default value Attribute .condition (R)
Page 734 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Value Decimal value status.system3.EXTENSION_BIT status.system3.EXT status.system3.NODE29 status.system3.NODE30 status.system3.NODE31 status.system3.NODE32 status.system3.NODE33 status.system3.NODE34 status.system3.NODE35 status.system3.NODE36 status.system3.NODE37 status.system3.NODE38 1,024 status.system3.NODE39 2,048 status.system3.NODE40 4,096 status.system3.NODE41 8,192 status.system3.NODE42 16,384 Not used Not applicable As an example, to set bit B0 of the system summary 3 enable register, set status.system3.enable = status.system3.EXT.
Page 735 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual 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 7-385)
Page 736 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents (on page 15-1) and Enable and transition registers (on page 15-19). The individual bits of this register are defined in the following table.
Page 737 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual 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 7-388)
Page 738 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents (on page 15-1) and Enable and transition registers (on page 15-19). The individual bits of this register are defined in the following table.
Page 739 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual Also see status.system4.* (on page 7-390) System summary and standard event registers (on page 15-7) 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 740 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Example SweepILinMeasureV(smua, -1e-3, 1e-3, 0, 100) This function performs a 100-point linear current sweep starting at −1 mA and stopping at +1 mA. Voltage is measured at every step (point) in the sweep. Because stime is set for 0 s, voltage is measured as quickly as possible after each current step.
Page 741 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual SweepILogMeasureV() This KISweep factory script function performs a logarithmic current sweep with voltage measured at every step (point). Type TSP-Link accessible Affected by Where saved Default value Function Usage SweepILogMeasureV(smuX, starti, stopi, stime, points)
Page 742 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Figure 121: 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 743 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual SweepVLinMeasureI() This KISweep factory script function performs a linear voltage sweep with current measured at every step (point). Type TSP-Link accessible Affected by Where saved Default value Function Usage SweepVLinMeasureI(smuX, startv, stopv, stime, points)
Page 744 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Example SweepVLinMeasureI(smua, -1, 1, 1e-3, 1000) This function performs a 1000-point linear voltage sweep starting at -1 V and stopping at +1 V. Current is measured at every step (point) in the sweep after a 1 ms source settling period.
Page 745 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual 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)
Page 746 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Figure 123: SweepVLogMeasureI() Example SweepVLogMeasureI(smua, 1, 10, This function performs a five-point logarithmic voltage 0.001, 5) 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 747 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual timer.measure.t() This function measures the elapsed time since the timer was last reset. Type TSP-Link accessible Affected by Where saved Default value Function Usage time = timer.measure.t() time The elapsed time in seconds (1 µs resolution) Example 1...
Page 748 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference timer.reset() This function resets the timer to zero (0) seconds. Type TSP-Link accessible Affected by Where saved Default value Function Usage timer.reset() Example timer.reset() -- (intervening code) time = timer.measure.t() print(time) Resets the timer and then measures the time since the reset.
Page 749 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual trigger.blender[N].EVENT_ID This constant contains the trigger blender event number. Type TSP-Link accessible Affected by Where saved Default value Constant Usage eventID = trigger.blender[N].EVENT_ID eventID Trigger event number The blender number (up to four) Details Set the stimulus of any trigger object to the value of this constant to have the trigger object respond to...
Page 750 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference trigger.blender[N].orenable This attribute selects whether the blender performs OR operations or AND operations. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Instrument reset Not saved false (AND mode) Trigger blender N reset...
Page 751 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual trigger.blender[N].overrun This attribute indicates whether or not an event was ignored because of the event detector state. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Instrument reset Not applicable...
Page 752 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference trigger.blender[N].reset() This function resets some of the trigger blender settings to their factory defaults. Type TSP-Link accessible Affected by Where saved Default value Function Usage trigger.blender[N].reset() The trigger event blender (up to four) Details The trigger.blender[N].reset() function resets the following attributes to their factory...
Page 753 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual Use zero to disable the blender input. The eventID parameter may be one of the existing trigger event IDs shown in the following table. Trigger event IDs* Event ID Event description smuX.trigger.SWEEPING_EVENT_ID...
Page 754 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference trigger.blender[N].wait() This function waits for a blender trigger event to occur. Type TSP-Link accessible Affected by Where saved Default value Function Usage triggered = trigger.blender[N].wait(timeout) triggered Trigger detection indication for blender The trigger blender (up to four) on which to wait timeout...
Page 755 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual 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 756 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: 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()
Page 757 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual trigger.timer[N].count This attribute sets the number of events to generate each time the timer generates a trigger event. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Instrument reset Not saved...
Page 758 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Details Once the timer is enabled, each time the timer is triggered, it uses this delay period. Assigning a value to this attribute is equivalent to: trigger.timer[N].delaylist = {interval} This creates a delay list of one value.
Page 759 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual Example trigger.timer[3].delaylist = {50e-6, 100e-6, 150e-6} DelayList = trigger.timer[3].delaylist for x = 1, table.getn(DelayList) do print(DelayList[x]) Set a delay list on trigger timer 3 with three delays (50 µs, 100 µs, and 150 µs). Read the delay list on trigger timer 3.
Page 760 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference trigger.timer[N].overrun This attribute indicates if an event was ignored because of the event detector state. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Instrument reset Not applicable false...
Page 761 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual trigger.timer[N].passthrough This attribute enables or disables the timer trigger pass-through mode. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Instrument reset Not saved false (disabled) Recall setup Trigger timer N reset...
Page 762 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference trigger.timer[N].reset() This function resets some of the trigger timer settings to their factory defaults. Type TSP-Link accessible Affected by Where saved Default value Function Usage trigger.timer[N].reset() Trigger timer number (1 to 8) Details The trigger.timer[N].reset() function resets the following attributes to their factory defaults:...
Page 763 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual trigger.timer[N].stimulus This attribute specifies which event starts the timer. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Instrument reset Not saved Recall setup Trigger timer N reset Usage eventID = trigger.timer[N].stimulus...
Page 764 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Example print(trigger.timer[1].stimulus) Prints the event that starts a trigger 1 timer action. Also see trigger.timer[N].reset() (on page 7-417) trigger.timer[N].wait() This function waits for a trigger. Type TSP-Link accessible Affected by Where saved...
Page 765 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual trigger.wait() This function waits for a command interface trigger event. Type TSP-Link accessible Affected by Where saved Default value Function Usage triggered = trigger.wait(timeout) triggered true: A trigger was detected during the timeout period false: No triggers were detected during the timeout period timeout Maximum amount of time in seconds to wait for the trigger...
Page 766 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference tsplink.group This attribute contains the group number of a TSP-Link node. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Power cycle Not applicable Usage groupNumber = tsplink.group tsplink.group = groupNumber...
Page 767 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual tsplink.master This attribute reads the node number assigned to the master node. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Not applicable Not applicable Not applicable Usage masterNodeNumber = tsplink.master...
Page 768 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference tsplink.node This attribute defines the node number. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Not applicable Nonvolatile memory Usage nodeNumber = tsplink.node tsplink.node = nodeNumber nodeNumber The node number of the instrument or enclosure (1 to 64 )
Page 769 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual tsplink.readbit() This function reads the state of a TSP-Link synchronization line. Type TSP-Link accessible Affected by Where saved Default value Function Usage data = tsplink.readbit(N) data The state of the synchronization line The trigger line (1 to 3) Details...
Page 770 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference tsplink.readport() This function reads the TSP-Link trigger lines as a digital I/O port. Type TSP-Link accessible Affected by Where saved Default value Function Usage data = tsplink.readport() data Numeric value that indicates which lines are set Details...
Page 771 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual tsplink.reset() This function initializes (resets) all nodes (instruments) in the TSP-Link system. Type TSP-Link accessible Affected by Where saved Default value Function Usage nodesFound = tsplink.reset() nodesFound = tsplink.reset(expectedNodes) nodesFound The number of nodes actually found on the system...
Page 772 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference tsplink.state This attribute describes the TSP-Link online state. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Not applicable Not applicable Not applicable Usage state = tsplink.state state TSP-Link state (online or offline)
Page 773 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual tsplink.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 tsplink.trigger[N].assert() The trigger line (1 to 3) Details...
Page 774 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference tsplink.trigger[N].clear() This function clears the event detector for a LAN trigger. Type TSP-Link accessible Affected by Where saved Default value Function Usage tsplink.trigger[N].clear() The trigger line (1 to 3) to clear Details The trigger event detector enters the detected state when an event is detected.
Page 775 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual tsplink.trigger[N].EVENT_ID This constant identifies the number that is used for the trigger events. Type TSP-Link accessible Affected by Where saved Default value Constant Usage eventID = tsplink.trigger[N].EVENT_ID eventID The trigger event number The trigger line (1 to 3)
Page 776 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference tsplink.trigger[N].mode This attribute defines the trigger operation and detection mode. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Instrument reset Not saved 0 (tsplink.TRIG_BYPASS) Recall setup TSP-Link trigger N reset Usage...
Page 777 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual When the trigger mode is set to tsplink.TRIG_RISING, the user-specified output state of the line is examined. If the output state selected when the mode is changed is high, the actual mode that is used is tsplink.TRIG_RISINGA.
Page 778 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference tsplink.trigger[N].overrun This attribute indicates if the event detector ignored an event while in the detected state. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Instrument reset Not applicable Not applicable...
Page 779 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual tsplink.trigger[N].pulsewidth This attribute sets the length of time that the trigger line is asserted for output triggers. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Instrument reset Not saved...
Page 780 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference tsplink.trigger[N].release() This function releases a latched trigger on the given TSP-Link trigger line. Type TSP-Link accessible Affected by Where saved Default value Function Usage tsplink.trigger[N].release() The trigger line (1 to 3) Details Releases a trigger that was asserted with an indefinite pulse width.
Page 781 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual tsplink.trigger[N].reset() This function resets some of the TSP-Link trigger attributes to their factory defaults. Type TSP-Link accessible Affected by Where saved Default value Function Usage tsplink.trigger[N].reset() The trigger line (1 to 3) Details The tsplink.trigger[N].reset() function resets the following attributes to their factory...
Page 782 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference tsplink.trigger[N].stimulus This attribute specifies the event that causes the synchronization line to assert a trigger. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Instrument reset Not saved Recall setup...
Page 783 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual Example print(tsplink.trigger[3].stimulus) Prints the event that starts TSP-Link trigger line 3 action. Also see tsplink.trigger[N].assert() (on page 7-428) tsplink.trigger[N].reset() (on page 7-436) tsplink.trigger[N].wait() This function waits for a trigger. Type TSP-Link accessible Affected by...
Page 784 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference tsplink.writebit() This function sets a TSP-Link trigger line high or low. Type TSP-Link accessible Affected by Where saved Default value Function Usage tsplink.writebit(N, data) The trigger line (1 to 3) data The value to write to the bit: ▪...
Page 785 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual tsplink.writeport() This function writes to all TSP-Link synchronization lines. Type TSP-Link accessible Affected by Where saved Default value Function Usage tsplink.writeport(data) data Value to write to the port (0 to 7) Details The binary representation of data indicates the output pattern that is written to the I/O port.
Page 786 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference tsplink.writeprotect This attribute contains the write-protect mask that protects bits from changes by the tsplink.writebit() and tsplink.writeport() functions. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Instrument reset Saved setup...
Page 787 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual tspnet.clear() This function clears any pending output data from the instrument. Type TSP-Link accessible Affected by Where saved Default value Function Usage tspnet.clear(connectionID) connectionID The connection ID returned from tspnet.connect() Details This function clears any pending output data from the device.
Page 788 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference tspnet.connect() This function establishes a network connection with another LAN instrument or device through the LAN interface. Type TSP-Link accessible Affected by Where saved Default value Function Usage connectionID = tspnet.connect("ipAddress")
Page 789 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual Example 2 instrumentID = tspnet.connect("192.0.2.1", 1394, "*rst\r\n") if instrumentID then -- Use instrumentID as needed here tspnet.disconnect(instrumentID) Connect to a device that is not TSP-enabled. Also see localnode.prompts (on page 7-177) localnode.showerrors...
Page 790 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: 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 791 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual Example 2 tspnet.timeout = 5 id_instr = tspnet.connect("192.0.2.23", 23, "*rst\r\n") tspnet.termination(id_instr, tspnet.TERM_CRLF) tspnet.execute(id_instr, "*idn?") print("tspnet.execute returns:", tspnet.read(id_instr)) Print the *idn? string from the remote device. Also see tspnet.connect() (on page 7-443) tspnet.read()
Page 792 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: 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...
Page 793 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual Example tspnet.write(deviceID, "*idn?\r\n") print("write/read returns:", tspnet.read(deviceID)) Send the "*idn?\r\n" message to the instrument connected as deviceID. Display the response that is read from deviceID (based on the *idn? message). Also see tspnet.connect() (on page 7-443)
Page 794 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference tspnet.reset() This function disconnects all TSP-Net sessions. Type TSP-Link accessible Affected by Where saved Default value Function Usage tspnet.reset() Details This command disconnects all remote instruments connected through TSP-Net. For TSP-enabled devices, this causes any commands or scripts running remotely to be terminated.
Page 795 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual Example deviceID = tspnet.connect("192.0.2.1") if deviceID then tspnet.termination(deviceID, tspnet.TERM_LF) Sets termination type for IP address 192.0.2.1 to TERM_LF. Also see tspnet.connect() (on page 7-443) tspnet.disconnect() (on page 7-444) tspnet.timeout This attribute sets the timeout value for the tspnet.connect(), tspnet.execute(), and tspnet.read() commands.
Page 796 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference tspnet.tsp.abort() This function causes the TSP-enabled instrument to stop executing any of the commands that were sent to it. Type TSP-Link accessible Affected by Where saved Default value Function Usage...
Page 797 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual 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 Attribute (RW) Instrument reset Not saved 1 (enable) Recall setup...
Page 798 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference 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")
Page 799 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual 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...
Page 800 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference 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 801 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual 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 802 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference 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 803 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual userstring.delete() This function deletes a user-defined string from nonvolatile memory. Type TSP-Link accessible Affected by Where saved Default value Function Usage userstring.delete("name") name The name (key) of the key-value pair of the user-defined string to delete Details This function deletes the string that is associated with name from nonvolatile memory.
Page 804 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Example userstring.add("assetnumber", "236") value = userstring.get("assetnumber") print(value) Create the user-defined string assetnumber, set to a value of 236. Read the value associated with the user-defined string named assetnumber. Store it in a variable called value, then print the variable value.
Page 805 Section 7: TSP command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual Example 1 waitcomplete() Waits for all nodes in the local group. Example 2 waitcomplete(G) Waits for all nodes in group G. Example 3 waitcomplete(0) Waits for all nodes on the TSP-Link network. Also see None 7-460...
Page 806 Section 8 Troubleshooting guide In this section: Introduction ................8-1 Error levels ................8-1 Effects of errors on scripts............8-1 Retrieving errors ............... 8-2 Error summary list ..............8-3 LAN troubleshooting suggestions ..........8-8 Introduction Troubleshooting information includes information on the Keithley Instruments Model 2651A errors (including a complete list of error messages) and LAN troubleshooting suggestions.
Page 807 Section 8: Troubleshooting guide Model 2651A High Power System SourceMeter® Instrument Reference Manual Effects of errors on scripts Most errors do not abort a running script. The only time a script is aborted is when a Lua runtime error (error code −286, "TSP runtime error") is detected. Runtime errors are caused by actions such as trying to index into a variable that is not a table.
Page 808 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 8: Troubleshooting guide Error summary list Error summary Error number Error level Error message -430 RECOVERABLE Query DEADLOCKED -420 RECOVERABLE Query UNTERMINATED -410 RECOVERABLE Query INTERRUPTED -363 RECOVERABLE Input buffer overrun -350 RECOVERABLE Queue overflow...
Page 809 Section 8: Troubleshooting guide Model 2651A High Power System SourceMeter® Instrument Reference Manual Error summary Error number Error level Error message 1106 RECOVERABLE Battery not present 1107 RECOVERABLE Cannot modify factory menu 1108 RECOVERABLE Menu name does not exist 1109 RECOVERABLE Menu name already exists 1110...
Page 810 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 8: Troubleshooting guide Error summary Error number Error level Error message 1504 RECOVERABLE Invalid flow control setting 1600 RECOVERABLE Maximum GPIB message length exceeded 1700 RECOVERABLE Display area boundary exceeded 1800 RECOVERABLE Invalid digital trigger mode...
Page 811 Section 8: Troubleshooting guide Model 2651A High Power System SourceMeter® Instrument Reference Manual Error summary Error number Error level Error message 2402 RECOVERABLE TSPnet remote error: %s, where %s explains the remote error 2403 RECOVERABLE TSPnet failure 2404 RECOVERABLE TSPnet read failure 2405 RECOVERABLE TSPnet read failure, aborted...
Page 812 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 8: Troubleshooting guide Error summary Error number Error level Error message 5033 RECOVERABLE Reading buffer not found within device 5038 RECOVERABLE Index exceeds maximum reading 5040 RECOVERABLE Cannot use same reading buffer for multiple overlapped measurements 5041 SERIOUS...
Page 813 Section 8: Troubleshooting guide Model 2651A High Power System SourceMeter® Instrument Reference Manual LAN troubleshooting suggestions If you are unable to connect to the web interface of the instrument, check the following items: • Verify that the network cable is in the LAN port on the rear panel of the instrument, not one of the ®...
Page 814 Section 9 Frequently asked questions In this section: How do I display the instrument's serial number? ....9-1 How do I optimize performance? ..........9-2 How do I upgrade the firmware? ..........9-2 How do I use the digital I/O port? ..........9-3 How do I trigger other instruments? .........
Page 815 Section 9: Frequently asked questions Model 2651A High Power System SourceMeter® Instrument Reference Manual How do I optimize performance? The primary factors that affect measurement accuracy and speed are: • Warm-up: For rated measurement accuracy, allow the Model 2651A to warm up for at least two hours before use.
Page 816 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 9: Frequently asked questions How do I use the digital I/O port? You can use the Model 2651A digital input/output with the trigger model or to control an external digital circuit, such as a device handler used to perform binning operations. To control or configure any of the six digital I/O lines, send commands to the Model 2651A over a remote interface.
Page 817 Section 9: Frequently asked questions Model 2651A High Power System SourceMeter® Instrument Reference Manual Interactive trigger programming The programming example below illustrates how to set up interactive triggering. The example sets the output trigger pulse width on line 1, then programs both lines 1 and 2 for falling edge triggers. Digital I/O line 1 trigger asserts, and then line 2 waits for the input trigger up to the timeout period specified.
Page 818 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 9: Frequently asked questions Service request programming example The example below shows how to program the Model 2651A to generate a service request (SRQ) when the current limit is exceeded. -- Clear all registers.
Page 819 Section 9: Frequently asked questions Model 2651A High Power System SourceMeter® Instrument Reference Manual When should I change the output-off state? Carefully consider and configure the appropriate output-off state, source function, and compliance limits before connecting the Model 2651A to a device that can deliver energy (for example, other voltage sources, batteries, capacitors, solar cells, or other Model 2651A instruments).
Page 820 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 9: Frequently asked questions How do I make low-current measurements? Low-current measurements (<1 mA) are subject to errors caused by leakage currents and leakage resistances in the signal path. Model 2651A instruments are equipped with triaxial connectors to minimize these problems.
Page 821 Section 9: Frequently asked questions Model 2651A High Power System SourceMeter® Instrument Reference Manual Figure 125: Typical low-current connections Protective earth (safety ground). Keithley Instruments Model CA-568-120 is a protective earth cable assembly. See tek.com/keithley for ordering information. Model 2651A interlock digital I/O. Pin 24 (INT) and pin 22 (5 Vdc) are connected to the test fixture lid switch.
Page 822 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 9: Frequently asked questions 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 823 Section 9: Frequently asked questions Model 2651A High Power System SourceMeter® Instrument Reference Manual What should I do if I get an 802 interlock error? You receive error code 802, "OUTPUT blocked by interlock," if you: • Disengage the interlock when the Model 2651A output is already on. •...
Page 824 Section 10 Next steps In this section: Additional Model 2651A information ........10-1 Additional Model 2651A information For additional information about the Model 2651A, refer to the Keithley Instruments website (tek.com/keithley), which contains the most up-to-date information. From the website, you can access: •...
Page 825 Section 11 Maintenance In this section: Introduction ................11-1 Line fuse replacement ............11-1 Front-panel tests ..............11-2 Upgrading the firmware ............11-4 Introduction The information in this section describes routine maintenance of the instrument that the operator can perform. Line fuse replacement A fuse on the Model 2651A rear panel protects the power line input of the instrument.
Page 826 Section 11: Maintenance Model 2651A High Power System SourceMeter® Instrument Reference Manual To prevent injury, death, or instrument damage, use only the correct fuse type (see table). To replace the line fuse: 1. Power off the instrument and remove the line cord. 2.
Page 827 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 11: Maintenance 3. Navigate through the menus by turning the navigation wheel. Press the ENTER key to select the menu items as follows: DISPLAY > TEST > DISPLAY-TESTS. 4. Turn the navigation wheel until the KEYS menu item is highlighted. 5.
Page 828 Section 11: Maintenance Model 2651A High Power System SourceMeter® Instrument Reference Manual Upgrading the firmware You can load a newer or older version of firmware to the instrument. The process takes about five minutes. To load the firmware, you can use a USB flash drive or select a file from a computer. From the front panel, you must use the USB flash drive.
Page 829 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 11: Maintenance 7. From the front panel, press the MENU key 8. Turn the navigation wheel to go to the UPGRADE menu item, and then press the ENTER key. 9. Turn the navigation wheel to select the file on the USB flash drive that contains the appropriate version of firmware.
Page 830 Section 11: Maintenance Model 2651A High Power System SourceMeter® Instrument Reference Manual 4. On the Instrument Console toolbar, select the down arrow and select Instrument > Flash. Figure 128: Flash menu option 5. For Select or enter a firmware image file, use the browser to select the new firmware. 6.
Page 831 Section 12 Calibration In this section: Verification ................12-1 Adjustment ................12-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 832 Section 12: Calibration Model 2651A High Power 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. •...
Page 833 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 12: 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.
Page 834 Section 12: Calibration Model 2651A High Power System SourceMeter® Instrument Reference Manual Source limit calculations As an example of how to calculate source verification limits, assume you are testing the Model 2651A 10 Vdc output range using a 9 V output value. Using the one-year accuracy specification for the 10 V range dc output of ±...
Page 835 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 12: 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 12-7) • Current measurement accuracy (on page 12-9) •...
Page 836 Section 12: Calibration Model 2651A High Power System SourceMeter® Instrument Reference Manual The maximum common-mode voltage (voltage between LO and chassis ground) is 250 V dc. Exceeding this value may cause a breakdown in insulation, creating a shock hazard that could result in personal injury or death.
Page 837 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 12: Calibration Current source accuracy Follow the steps below to verify that the Model 2651A output current accuracy is within specified limits. 1. With the power off, connect the digital multimeter to the Model 2651A terminals as shown in Connections for current verification (100 mA range and below).
Page 838 Section 12: Calibration Model 2651A High Power System SourceMeter® Instrument Reference Manual 5. Repeat the procedure for negative output currents with the same magnitudes as those listed. 6. Turn the output off, and change connections as shown in Connections for current verification (1 A range and above) (use the 0.1 Ω...
Page 839 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 12: Calibration Current measurement accuracy Follow the steps below to verify that Model 2651A current measurement accuracy is within specified limits. The procedure involves applying accurate currents from the Model 2651A current source and then verifying that Model 2651A current measurements are within required limits.
Page 840 Section 12: Calibration Model 2651A High Power System SourceMeter® Instrument Reference Manual Current measurement accuracy limits Source and measure range Source current Current reading limits (1 year, 18° C to 28° C) 10 A 5.00000 A 4.9880 A to 5.0120 A 9.00000 A 8.9832 A to 9.0168 A 20 A...
Page 841 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 12: Calibration -45 A high speed ADC pulse verification script As shown, the script generates a single -45 A pulse. To generate a different current level, edit the line: PulseLevel = -45 Refer to Instrument programming (on page 6-1) for information on loading and running scripts.
Page 842 Section 12: Calibration Model 2651A High Power System SourceMeter® Instrument Reference Manual smua.measure.delay = 0 smua.measure.count = 500 smua.measure.interval = 0.000001 -- Use dedicated buffers to receive measurements. smua.nvbuffer1.clear() smua.nvbuffer2.clear() -- Use nvbuffer1 for current and nvbuffer2 for volts smua.trigger.measure.iv(smua.nvbuffer1, smua.nvbuffer2) -- Generate an external trigger signal on digital I/O connector pin 8 (10 uS falling edge pulse in this example), synchronized to the start of the Fast ADC measurement for use by...
Page 843 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 12: Calibration Voltage source accuracy Follow the steps below to verify that the Model 2651A output voltage accuracy is within specified limits. To perform this test, you will set the output voltage to each full-range value and measure the voltages with a precision digital multimeter.
Page 844 Section 12: Calibration Model 2651A High Power System SourceMeter® Instrument Reference Manual ▪ Output voltage accuracy limits Source range Output voltage setting* Output voltage limits (1 year, 18° C to 28° C) 100 mV 50.000 mV 49.490 mV to 50.510 mV 90.000 mV 89.482 mV to 90.518 mV 0.50000 V...
Page 845 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 12: Calibration ▪ Verify that the Model 2651A voltage reading is within the limits given in the table. Voltage measurement accuracy limits Source and measure range* Source voltage** Voltage reading limits (1 year, 18° C to 28° C) 100 mV 50.000 mV 49.690 mV to 50.310 mV...
Page 846 Section 12: Calibration Model 2651A High Power System SourceMeter® Instrument Reference Manual Adjustment 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 847 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 12: Calibration Warmup period Allow the Model 2651A 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 848 Section 12: Calibration Model 2651A High Power System SourceMeter® Instrument Reference Manual 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 849 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 12: Calibration 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 12-19)).
Page 850 Section 12: Calibration Model 2651A High Power System SourceMeter® Instrument Reference Manual Model 2651A adjustment steps Function Adjustment steps Adjustment Sense mode points smua.SENSE_LOCAL Voltage source and measure 100 mV ±1e-30, ±90 mV Step 2. Voltage smua.SENSE_REMOTE 100 mV ±1e-30, ±90 mV adjustment (on page 12-22) smua.SENSE_LOCAL...
Page 851 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 12: Calibration Calibration commands quick reference The following table summarizes remote calibration commands. For a more complete description of these commands, refer to the TSP command reference (on page 7-1). Calibration commands Command Description...
Page 852 Section 12: Calibration Model 2651A High Power System SourceMeter® Instrument Reference Manual Calibration commands Command Description smua.source.calibratev(range, Adjust voltage source range calibration*: cp1Expected, cp1Reference, ±range (source range to adjust). cp2Expected, cp2Reference) cp1Expected (source value programmed for cal. point 1). cp1Reference (reference measurement for cal. point 1). cp2Expected (source value programmed for cal.
Page 853 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 12: Calibration Figure 132: Connections for voltage calibration B. Send the following commands in order to initialize voltage calibration: smua.cal.unlock("KI0026XX") smua.reset() smua.source.func = smua.OUTPUT_DCVOLTS It is not necessary to set the measure range when following this procedure for calibration because the measure range is locked to the source range when measuring the source function.
Page 854 Section 12: Calibration Model 2651A High Power System SourceMeter® Instrument Reference Manual C. Perform each calibration adjustment for the voltage source and measure function step listed in Step sequence (on page 12-19) as follows: Select the range being calibrated with this command: smua.source.rangev = range Select the correct sense mode based on the calibration step for the voltage source and measure function from the...
Page 855 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 12: Calibration 12. If this step is not on the CALA sense mode, send the measure calibration command using the multimeter and Model 2651A readings, and the range setting for the parameters. For example: smua.measure.calibratev(range, Z_rdg, DMM_Z_rdg, FS_rdg, DMM_FS_rdg) Where: range...
Page 856 Section 12: Calibration Model 2651A High Power System SourceMeter® Instrument Reference Manual Where: -range = The negative of the present calibration range src_Z = The −zero Model 2651A programmed source output value DMM_Z_rdg = The −zero DMM measurement src_FS = The −FS Model 2651A programmed source output value DMM_FS_rdg = The −FS DMM measurement Typical values for the Model 2651A 1 V range:...
Page 857 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 12: Calibration Step 3. Current calibration adjustment A. Connect the Model 2651A 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 current calibration (100 mA range and below) C.
Page 858 Section 12: Calibration Model 2651A High Power System SourceMeter® Instrument Reference Manual Select the correct sense mode based on the calibration step for the current source and measure function listed in Model 2651A step sequence (on page 12-19), for example: smua.sense = smua.SENSE_LOCAL Select positive polarity, then set the source output to the positive zero value: smua.cal.polarity = smua.CAL_POSITIVE...
Page 859 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 12: Calibration 12. If this step is not on the CALA sense mode or 100 A range, send the measure calibration command using the multimeter and Model 2651A readings, and range setting for the parameters: smua.measure.calibratei(range, Z_rdg, DMM_Z_rdg, FS_rdg, DMM_FS_rdg) Where: range...
Page 860 Section 12: Calibration Model 2651A High Power System SourceMeter® Instrument Reference Manual 21. Send the source calibration command using the -range, -zero and -FS multimeter readings, and -zero and -FS source values for the parameters: smua.source.calibratei(-range, src_Z, DMM_Z_rdg, src_FS, DMM_FS_rdg) Where: -range = The negative of the present calibration range...
Page 861 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 12: Calibration F. Select the DMM dc volts function. G. Repeat the 22 steps of C for the 1 A, 5 A, 10 A, 20 A, 50 A, and 100 A ranges. Compute the current reading from the DMM voltage reading and characterized 0.1 Ω...
Page 862 Section 12: Calibration Model 2651A High Power System SourceMeter® Instrument Reference Manual Figure 136: Connections for contact check 50 ohm calibration E. Allow the readings to settle, then get the Model 2651A readings: r50_hi, r50_lo = smua.contact.r() F. Send the contact check low calibration adjustment command: smua.contact.calibratelo(r0_lo, Z_actual, r50_lo, 50_ohm_actual) Where: r0_lo...
Page 863 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 12: Calibration Step 6. Program calibration dates Use the following command to set the calibration adjustment date: smua.cal.adjustdate = os.time{year=2019, month=12, day=1} Optionally, it is possible to set the calibration date and calibration due date with the following commands: smua.cal.date = os.time{year=2019, month=12, day=1} smua.cal.due = os.time{year=2020, month=12, day=1}...
Page 864 Section 13 LAN concepts and settings In this section: Overview ................13-1 Establishing a point-to-point connection ......... 13-1 Connecting to the LAN ............13-6 LAN speeds................13-9 Duplex mode ................ 13-10 Viewing LAN status messages ..........13-10 Viewing the network settings ..........13-11 Selecting a LAN interface protocol ........
Page 865 Section 13: LAN concepts and settings Model 2651A High Power System SourceMeter® Instrument Reference Manual Contact your corporate information technology (IT) department for permission before you connect the Model 2651A to a corporate network. If you have problems, see LAN troubleshooting suggestions (on page 8-8).
Page 866 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 13: LAN concepts and settings If the information for the ethernet adapter displays Media Disconnected, close the command prompt and go to Step 2: Disable DHCP to use the existing computer IP address (on page 13-3).
Page 867 Section 13: LAN concepts and settings Model 2651A High Power System SourceMeter® Instrument Reference Manual Figure 138: Ethernet networking properties 4. Select Properties. 5. Select Use the following IPv6 address. The option for "Use the following DNS server addresses" is automatically selected. 6.
Page 868 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 13: LAN concepts and settings 3. Change the IP address assignment method: Select CONFIG > METHOD > MANUAL, and then press the ENTER key. Press the EXIT (LOCAL) key once to return to the LAN CONFIG menu. 4.
Page 869 Section 13: LAN concepts and settings Model 2651A High Power System SourceMeter® Instrument Reference Manual Figure 139: LAN connection 1. Model 2651A LAN connection port 2. Crossover cable 3. Ethernet port (located on the host computer) Step 5: Access the web interface of the instrument 1.
Page 870 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 13: LAN concepts and settings Setting the LAN configuration method There are two methods used to configure the LAN. AUTO: Use the AUTO setting to allow the DHCP server to automatically set the LAN settings. You do not need to set the LAN options manually.
Page 871 Section 13: LAN concepts and settings Model 2651A High Power System SourceMeter® Instrument Reference Manual Setting the gateway Contact your corporate information technology (IT) department to secure a valid gateway for the instrument when placing the instrument on a corporate network. To set the gateway when LAN configuration method is set to MANUAL: 1.
Page 872 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 13: LAN concepts and settings 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.
Page 873 Section 13: LAN concepts and settings Model 2651A High Power System SourceMeter® Instrument Reference Manual Duplex mode The duplex mode is based on the LAN configuration. There are two settings: • Half-duplex: Allows communications in both directions, but only one direction is active at a time (not simultaneously).
Page 874 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 13: LAN concepts and settings The following table displays possible fault and configuration messages. LAN CONFIG/FAULT messages LAN message type Possible messages LAN fault Could not acquire IP address Duplicate IP address detected DHCP lease lost Lan Cable Disconnected LAN configuration...
Page 875 Section 13: LAN concepts and settings Model 2651A High Power System SourceMeter® Instrument Reference Manual Confirming the active speed and duplex negotiation The Model 2651A automatically detects the speed and duplex negotiation active on the LAN. Once the speed and duplex negotiation is detected, the instrument automatically adjusts its own settings to match the LAN settings.
Page 876 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 13: LAN concepts and settings The following table displays the remote interface protocols supported by the Model 2651A and their assigned port numbers. Port number Command interface Port number Raw socket 5025 Telnet VXI-11...
Page 877 Section 13: LAN concepts and settings Model 2651A High Power System SourceMeter® Instrument Reference Manual Dead socket connection The dead socket termination (DST) port is used to terminate all existing ethernet connections. A dead socket is a socket that is held open by the instrument because it has not been properly closed. This most often happens when the host computer is turned off or restarted without first closing the socket.
Page 878 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 13: LAN concepts and settings Configuring a Telnet connection This procedure uses PuTTY, which is open source, cross-platform, and usable under the MIT license. Consult the PuTTY help or user manual for other usage concerns not covered in this document. To connect with the Model 2651A using PuTTY on a Windows system: 1.
Page 879 Section 13: LAN concepts and settings Model 2651A High Power System SourceMeter® Instrument Reference Manual Figure 142: Telnet connection settings example 5. Select Open to start the Telnet session. 6. Use PuTTY to interact directly with the instrument. Figure 143: Communicating with the instrument using PuTTY 13-16 2651A-901-01 Rev.
Page 880 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 13: LAN concepts and settings Logging LAN trigger events in the event log You can use the event log to record all LXI triggers generated and received by the Model 2651A. You can view the event log using any command interface or the embedded web interface.
Page 881 Section 13: LAN concepts and settings Model 2651A High Power System SourceMeter® Instrument Reference Manual Event log descriptions Column title Description Example 11:46:44.000 11 Mar 2020 Displays the date and time that the LAN trigger Receive Time occurred in UTC, 24-hour time LAN0 = lan.trigger[1] Identifies the lan.trigger[N] that generates an Event ID...
Page 882 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 13: LAN concepts and settings Accessing the event log from the command interface You can access the event log from any remote command interface. The event log must be enabled before LXI trigger events can be viewed.
Page 883 Section 14 Common commands In this section: Common command summary ..........14-1 Script command equivalents ..........14-3 Command reference .............. 14-3 General bus commands ............14-5 Common command summary The IEEE Std 488.2 common commands that are supported by the Model 2651A are summarized in the following table.
Page 884 Section 14: Common commands Model 2651A High Power System SourceMeter® Instrument Reference Manual Command Name Description *CLS Clear status Clears all event registers and Error Queue. For detailed information including status commands, see the Status model (on page 15-1). *ESE mask Event enable command Program the Standard Event Status Enable Register.
Page 885 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 14: Common commands Script command equivalents The TSP commands that can be included in scripts that are equivalent to the common commands are defined in the table below. Common Script command equivalent command *CLS status.reset()
Page 886 Section 14: Common commands Model 2651A High Power System SourceMeter® Instrument Reference Manual Operation complete and query: *OPC and *OPC? Wait for pending overlapped commands to complete. *OPC Operation complete command that sets the OPC bit *OPC? Operation complete query that places a "1" in the output queue When *OPC is sent, the OPC bit in the Standard Event Register (see Status model (on page 15-1)) is...
Page 887 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 14: Common commands Wait-to-continue: *WAI Suspends the execution of subsequent commands until all previous overlapped commands are finished. *WAI This pauses until overlapped commands are complete Two types of device commands exist: •...
Page 888 Section 14: Common commands Model 2651A High Power System SourceMeter® Instrument Reference Manual The interface clear (IFC) command is sent by the controller to place the Model 2651A in the talker idle state and the listener idle state. The instrument responds to the IFC command by canceling illumination of the front-panel TALK or LSTN lights if the instrument was previously placed in one of these states.
Page 889 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 14: Common commands The selective device clear (SDC) command is an addressed command that performs essentially the same function as the device clear (DCL) command. However, because each device must be individually addressed, the SDC command provides a method to clear only selected instruments, instead of clearing all instruments simultaneously with the DCL command.
Page 890 Section 15 Status model In this section: Overview ................15-1 Clearing registers ..............15-13 Programming and reading registers ........15-13 Status byte and service request (SRQ) ........ 15-15 Status register sets .............. 15-20 TSP-Link system status ............15-26 Overview Each Keithley Instruments Model 2651A provides status registers and queues that are collectively referred to as the status model.
Page 891 Section 15: Status model Model 2651A High Power System SourceMeter® Instrument Reference Manual • Positive Transition Register (PTR) (.ptr): When a bit is set in this read-write register, it enables a 0 to 1 change in the corresponding bit of the condition register to cause the corresponding bit in the event register to be set.
Page 892 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 15: Status model Command queue The command queue holds commands that have been received from a remote interface that are available for execution. This allows the Model 2651A to accept multiple commands and queue them for execution.
Page 893 Section 15: Status model Model 2651A High Power System SourceMeter® Instrument Reference Manual Status function summary The following functions and attributes control and read the various registers. Additional information for the various register sets is included later in this section. Also, refer to the specific command as listed TSP commands (on page 7-7).
Page 894 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 15: Status model Status model diagrams The following figures graphically describe the status model: • Status byte and service request enable register (on page 15-5) • System summary and standard event registers (on page 15-7) •...
Page 895 Section 15: Status model Model 2651A High Power System SourceMeter® Instrument Reference Manual Figure 145: Status byte and service request enable registers 15-6 2651A-901-01 Rev. C October 2021...
Page 896 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 15: Status model Figure 146: System summary and standard event registers 2651A-901-01 Rev. C October 2021 15-7...
Page 897 Section 15: Status model Model 2651A High Power System SourceMeter® Instrument Reference Manual Figure 147: Measurement event registers 15-8 2651A-901-01 Rev. C October 2021...
Page 898 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 15: Status model Figure 148: Operation status registers 2651A-901-01 Rev. C October 2021 15-9...
Page 899 Section 15: Status model Model 2651A High Power System SourceMeter® Instrument Reference Manual Figure 149: Operation status trigger overrun registers 15-10 2651A-901-01 Rev. C October 2021...
Page 900 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 15: Status model Figure 150: Operation status trigger timer, trigger blender, and remote registers 2651A-901-01 Rev. C October 2021 15-11...
Page 901 Section 15: Status model Model 2651A High Power System SourceMeter® Instrument Reference Manual Figure 151: Operation status digital I/O and TSP-Link registers 15-12 2651A-901-01 Rev. C October 2021...
Page 902 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 15: Status model Figure 152: Questionable status registers Clearing registers You can use commands to reset the status registers. *CLS resets the bits of the event and NTR registers to 0 and sets all PTR register bits on. This command also clears the output queue.
Page 903 Section 15: Status model Model 2651A High Power System SourceMeter® Instrument Reference Manual Programming enable and transition registers A command to program an event enable or transition register is sent with a parameter value that determines the state (0 or 1) of each bit in the appropriate register. The bit positions of the register (see the following tables) indicate the binary parameter value and decimal equivalent.
Page 904 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 15: Status model Status byte and service request (SRQ) Service requests (SRQs) allow an instrument to indicate that it needs attention or that some event has occurred. When the controller receives an SRQ, it allows the controller to interrupt tasks to perform other tasks in order to address the request for service.
Page 905 Section 15: Status model Model 2651A High Power System SourceMeter® Instrument Reference Manual Figure 153: Status byte and service request (SRQ) 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 906 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 15: Status model • Bit B6, Request Service (RQS)/Master Summary Status (MSS): Set bit indicates that an enabled summary bit of the Status Byte Register is set. Depending on how it is used, bit B6 of the Status Byte Register is either the Request for Service (RQS) bit or the Master Summary Status (MSS) bit: ▪...
Page 907 Section 15: Status model Model 2651A High Power System SourceMeter® Instrument Reference Manual Serial polling and SRQ Any enabled event summary bit that goes from 0 to 1 sets bit B6 and generates a service request (SRQ). In your test program, you can periodically read the Status Byte to check if an SRQ occurred and what caused it.
Page 908 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 15: Status model Status byte and service request commands The commands to program and read the Status Byte Register and Service Request Enable Register are listed in the table below. Note that the table includes both common commands and their script command equivalents.
Page 909 Section 15: Status model Model 2651A High Power System SourceMeter® Instrument Reference Manual Status register sets ® There are five status register sets in the status structure of a High Power System SourceMeter Instrument: • System Summary • Standard Event Status •...
Page 910 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 15: Status model Standard Event Register The bits used in the Standard Event Register are described as follows: • Bit B0, Operation Complete (OPC): Set bit indicates that all pending selected device operations are completed and the Model 2651A instrument is ready to accept new commands.
Page 911 Section 15: Status model Model 2651A High Power System SourceMeter® Instrument Reference Manual Commands to program and read the register are summarized below and also in the Status function summary (on page 15-4) table. Figure 154: Standard Event Register Standard event commands Command Description *ESR?
Page 912 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 15: Status model Operation Status Registers As shown in the Operation status registers (on page 15-9) diagram of the status model, there are 22 register sets associated with operation status. Commands are summarized in Status register set contents (on page 15-1).
Page 913 Section 15: Status model Model 2651A High Power System SourceMeter® Instrument Reference Manual Questionable Status Registers This register set feeds to bit B3 (QSB) of the Status Byte. The bits used in the Questionable Status Register set are described as follows: •...
Page 914 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 15: Status model For example, either of the following commands will set the VOLTAGE_LIMIT enable bit: status.measurement.enable = status.measurement.VOLTAGE_LIMIT status.measurement.enable = 1 When reading a register, a numeric value is returned. The binary equivalent of this value indicates which bits in the register are set.
Page 915 Section 15: Status model Model 2651A High Power System SourceMeter® Instrument Reference Manual Register programming example The command sequence below programs the instrument to generate a service request (SRQ) and set the system summary bit in all TSP-Link nodes when the current limit on channel A is exceeded. -- Clear all registers.
Page 916 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 15: Status model • Node 15: Bit B0 (MSB) of the Status Byte sets. • System Summary Registers: Bit B1 (Node 15) of the System Summary Register 2 sets. The System Summary Registers are shared by all nodes in the TSP-Link system. When a bit in a system register of node 15 sets, the same bit in the master node system register also sets.
Page 917 Section 15: Status model Model 2651A High Power System SourceMeter® Instrument Reference Manual Master node service request: The following command enables the service request for the measurement event: status.request_enable = 1 The affected status register for the above command is indicated by label E, as shown in the following figure.
Page 918 Section 16 Display character codes In this section: Model 2651A display character codes ........16-1 Model 2651A display character codes The following tables contain the decimal values of the display character codes and the corresponding displays.
Page 919 Section 16: Display character codes Model 2651A High Power System SourceMeter® Instrument Reference Manual Display character codes (decimal 0 to 39) Decimal Display Decimal Display Decimal Display ▲ reserved reserved ▼ reserved reserved ◄ reserved reserved ► reserved reserved reserved µ...
Page 920 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 16: Display character codes Display character codes (decimal 40 to 102) Decimal Display Decimal Display Decimal Display > , (comma) ' (open single quote) < 2651A-901-01 Rev. C October 2021 16-3...
Page 921 Section 16: Display character codes Model 2651A High Power System SourceMeter® Instrument Reference Manual Display character codes (decimal 103 to 165) Decimal Display Decimal Display Decimal Display (space) ¼ 16-4 2651A-901-01 Rev. C October 2021...
Page 922 Model 2651A High Power System SourceMeter® Instrument Reference Manual Section 16: Display character codes Display character codes (decimal 166 to 228) Decimal Display Decimal Display Decimal Display  æ  Æ  â  ä   á  ß à...
Page 923 Section 16: Display character codes Model 2651A High Power System SourceMeter® Instrument Reference Manual Display character codes (decimal 229 to 255) Decimal Display Decimal Display Decimal Display ó ñ ò Ñ ÿ Ö † û  ü  ú  ù...
Page 924 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...