Download Print this page

Keithley 2657A Reference Manual

Keithley 2657A Reference Manual

High power system sourcemeter instrument

Hide thumbs Also See for 2657A:

Quick start manual (23 pages)

,

User manual (98 pages)

Table Of Contents

Table of Contents

Advertisement

Quick Links

Download this manual

Model 2657A High Power

System SourceMeter

Reference Manual

2657A-901-01 Rev. B / December 2012

*P2657A90101*

2657A-901-01

A

G

R

E

A

T

E

R

M

E

A

S

U

®

Instrument

R

E

O

F

C

O

N

F

I

D

E

www.keithley.com

N

C

E

Table of Contents

Advertisement

Table of Contents

Troubleshooting

Need help?

Need help?

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

Questions and answers

Summary of Contents for Keithley 2657A

Page 1 Model 2657A High Power System SourceMeter ® Instrument Reference Manual 2657A-901-01 Rev. B / December 2012 *P2657A90101* 2657A-901-01...
Page 2 © 2008-2012, Keithley Instruments, Inc. 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, Inc. is strictly prohibited. ® ® ®...
Page 4: Safety Precautions
Keithley Instruments products are designed for use with electrical signals that are rated Measurement Category I and Measurement Category II, as described in the International Electrotechnical Commission (IEC) Standard IEC 60664. Most measurement, control, and data I/O signals are Measurement Category I and must not be directly connected to mains voltage or to voltage sources with high transient overvoltages.
Page 5 (note that selected parts should be purchased only through Keithley Instruments to maintain accuracy and functionality of the product). If you are unsure about the applicability of a replacement component, call a Keithley Instruments office for information.
Page 6: Table Of Contents
Cooling vents ........................2-7 Turning your instrument on and off ..................2-7 Procedure..........................2-7 Placing a Model 2657A in standby .................... 2-8 Warmup period .......................... 2-8 Line frequency configuration ..................... 2-9 Fuse replacement ........................2-9 ...
Page 7 Table of Contents Model 2657A High Power System SourceMeter® Instrument Reference Manual Multiple SMU connections ....................... 2-51 Guarding and shielding ......................2-55 Test fixture ..........................2-62 Floating a SMU ........................2-63 DUT connection settings ....................2-64 ...
Page 8 Model 2657A High Power System SourceMeter® Instrument Reference Manual Table of Contents Sweep programming examples ....................3-30 Triggering ........................... 3-31 Remote triggering overview..................... 3-31 Using the remote trigger model ....................3-33 SMU event detectors ....................... 3-38 ...
Page 9 Table of Contents Model 2657A High Power System SourceMeter® Instrument Reference Manual Information on scripting and programming ................5-3 About TSP commands ......................5-3 Beeper control ........................... 5-3 Bit manipulation and logic operations ..................5-3 Data queue..........................5-4 ...
Page 10 Model 2657A High Power System SourceMeter® Instrument Reference Manual Table of Contents Using Test Script Builder (TSB) ....................6-30 Project navigator ........................6-31 Script editor ..........................6-32 Outline view ..........................6-32 Programming interaction ......................6-33 ...
Page 11 Table of Contents Model 2657A High Power System SourceMeter® Instrument Reference Manual bit.get() ............................ 7-11 bit.getfield() ..........................7-12 bit.set() ............................ 7-13 bit.setfield() ..........................7-13 bit.test() ........................... 7-14 bit.toggle() ..........................7-15 bufferVar.appendmode ......................7-16 ...
Page 12 Model 2657A High Power System SourceMeter® Instrument Reference Manual Table of Contents display.loadmenu.catalog() ..................... 7-68 display.loadmenu.delete() ....................... 7-69 display.locallockout ......................... 7-69 display.menu() ......................... 7-70 display.numpad ........................7-71 display.prompt() ........................7-71 display.screen ......................... 7-73 ...
Page 13 Table of Contents Model 2657A High Power System SourceMeter® Instrument Reference Manual lan.config.dns.domain ......................7-110 lan.config.dns.dynamic ......................7-110 lan.config.dns.hostname ....................... 7-111 lan.config.dns.verify ......................7-112 lan.config.duplex ........................7-112 lan.config.gateway ........................ 7-113 lan.config.ipaddress ......................7-113 ...
Page 14 Model 2657A High Power System SourceMeter® Instrument Reference Manual Table of Contents os.time() ..........................7-147 print() ............................. 7-148 printbuffer() ..........................7-149 printnumber() ......................... 7-150 PulseIMeasureV() ......................... 7-151 PulseVMeasureI() ......................... 7-152 QueryPulseConfig() ....................... 7-153 ...
Page 15 Table of Contents Model 2657A High Power System SourceMeter® Instrument Reference Manual smuX.measure.count ......................7-197 smuX.measure.delay ......................7-198 smuX.measure.delayfactor....................7-199 smuX.measure.filter.count ....................7-199 smuX.measure.filter.enable....................7-200 smuX.measure.filter.type ...................... 7-201 smuX.measure.interval ......................7-202 smuX.measure.lowrangeY ....................7-202 smuX.measure.nplc ......................
Page 16 Model 2657A High Power System SourceMeter® Instrument Reference Manual Table of Contents smuX.trigger.SOURCE_COMPLETE_EVENT_ID ..............7-246 smuX.trigger.SWEEP_COMPLETE_EVENT_ID ..............7-247 smuX.trigger.SWEEPING_EVENT_ID .................. 7-247 status.condition ........................7-248 status.measurement.* ......................7-250 status.measurement.buffer_available.* ................. 7-252 status.measurement.current_limit.* ..................7-253 ...
Page 17 Table of Contents Model 2657A High Power System SourceMeter® Instrument Reference Manual trigger.blender[N].overrun ..................... 7-332 trigger.blender[N].reset() ....................... 7-333 trigger.blender[N].stimulus[M] ....................7-333 trigger.blender[N].wait() ......................7-335 trigger.clear() ......................... 7-336 trigger.EVENT_ID ......................... 7-336 trigger.timer[N].clear() ......................7-337 ...
Page 18 Model 2657A High Power System SourceMeter® Instrument Reference Manual Table of Contents Troubleshooting guide ....................8-1 Introduction .......................... 8-1 Error levels ........................... 8-1 Error effects on scripts ......................8-2 Retrieving errors ........................8-2 Error summary list ........................ 8-3 ...
Page 19 Table of Contents Model 2657A High Power System SourceMeter® Instrument Reference Manual Maintenance ........................A-1 Line fuse replacement ......................A-1 Front panel tests ........................A-2 Keys test ........................... A-3 Display patterns test ........................A-3 Upgrading the firmware ......................A-4 ...
Page 20 Model 2657A High Power System SourceMeter® Instrument Reference Manual Table of Contents Telnet connection ........................C-16 Dead socket connection ......................C-19 Logging LAN trigger events in the event log ..............C-19 Accessing the event log from the command interface ............. C-20 ...
Page 21: Introduction
CD-ROM contents ..............1-2 Organization of manual sections ..........1-3 Capabilities and features ............1-4 Welcome Thank you for choosing a Keithley Instruments product. The Model 2657A High Power System ® SourceMeter instrument provides manufacturers of electronic components and semiconductor devices with an instrument that combines source and measurement capabilities in a single instrument called a source-measure unit (also called a SMU).
Page 22: Cd-Rom Contents
Quick Start Guide: Provides unpacking instructions, describes basic connections, and reviews basic operation information. If you are new to Keithley Instruments equipment, refer to the Quick Start Guide to take the steps needed to unpack, set up, and verify operation.
Page 23: Organization Of Manual Sections
• Calibration: How to verify and adjust the Model 2657A. • LAN concepts and settings: How to set up the Model 2657A for use on a local area network. • Common commands: Descriptions of IEEE Std. 488.2 common commands. •...
Page 24: Capabilities And Features
• USB flash drive access for saving data buffers, test scripts, and user setups • Digital I/O port that allows the Model 2657A to control other devices • Web-based characterization tool that provides easy access to data gathering, sweeping, and pulsing features •...
Page 25: General Operation
Digits ..................2-77 Speed ..................2-78 Remote communication interfaces ......... 2-79 General ratings The Model 2657A instrument's general ratings and connections are listed in the following table. Category Specification Supply voltage range 100 V AC to 240 V AC, 50 Hz or 60 Hz...
Page 26: Controls, Indicators, And Connectors
MENU EXIT ENTER 1. Power switch, display and configuration keys Power switch. The in position turns the Model 2657A on (I); the out position turns it off (O). POWER Toggles between the source-measure display and the user message display. DISPLAY Configures a function or operation.
Page 27 Model 2657A 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 MEAS LIMIT MODE Selects the source function (V or A) and places the cursor in the source field for editing.
Page 28 Section 2: General operation Model 2657A High Power System SourceMeter® Instrument Reference Manual Numbers When enabled and in EDIT mode, the number keys (0-9, +/-, 0000) allow direct numeric entry. Number keys Press the navigation wheel to enter EDIT mode. For more information, see Setting a value page 2-14).
Page 29: Rear Panel
Source or measure autorange is selected AUTO * (asterisk) Readings are being stored in the buffer Rear panel The rear panel of Model 2657A is shown below. The descriptions of the rear-panel components follow the figure. Figure 2: Rear panel Model 2657A LINE FUSE SLOWBLOW 5.0 A, 250 V...
Page 30: Power Module
(not provided) can be used. 6. TSP-link Expansion interface that allows a Model 2657A and other TSP-enabled instruments to trigger and communicate with each other. Use a category 5e or higher LAN crossover cable (Keithley Instruments model number CA-180-3A).
Page 31: Cooling Vents
Procedure The Model 2657A operates from a line voltage of 100 V to 240 V at a frequency of 50 Hz or 60 Hz. At the factory, each Model 2657A is configured to match the power line frequency appropriate for your country (either 50 Hz or 60 Hz).
Page 32: Placing A Model 2657A In Standby
Even though the instrument is placed in standby, the output may not be actually off. Warmup period The Model 2657A must be turned on and allowed to warm up for at least two hours to achieve rated accuracies. 2657A-901-01 Rev. B/December 2012...
Page 33: Line Frequency Configuration
Section 2: General operation Line frequency configuration At the factory, each Model 2657A is configured to match the power line frequency appropriate for your country (either 50 Hz or 60 Hz). This line frequency is used for aperture (NPLC) calculations.
Page 34: Menu Overview
Model 2657A High Power System SourceMeter® Instrument Reference Manual Menu overview Menu navigation To navigate through the menus and submenus, the Model 2657A must not be in edit mode (the EDIT indicator is not illuminated). Selecting menu items To navigate the Main and Configuration menus, use the editing keys as follows: •...
Page 35: Main Menu
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 2: General operation Main menu The main menu structure is summarized in the following figure and table. For other menu items, see Configuration menus (on page 2-13). Figure 3: Main menu tree Press the MENU key.
Page 36: Front Panel Tests
Section 2: General operation Model 2657A 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...
Page 37: Configuration Menus
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 2: General operation Configuration menus The configuration menu structure is summarized in the following figure and table. For directions on navigating the menu, see Menu navigation (on page 2-10). For other menu items, see Main menu page 2-11).
Page 38: Setting Values
Section 2: General operation Model 2657A High Power System SourceMeter® Instrument Reference Manual Quick Tip Press the EXIT key to return to a previous menu. 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 39 Setting source and compliance values When the Model 2657A is in the edit mode (EDIT indicator is on), the editing controls are used to set source and compliance values. Note that when you edit the source value, source autoranging is turned off and remains off until you turn it on again.
Page 40: Beeper
NOTE The up and down range keys change the format of the limit value. Beeper The Model 2657A includes a beeper. When it is enabled, a beep indicates one of the following actions have occurred: • A front-panel key was pressed: A short beep, similar to a key click, is issued.
Page 41: Basic Operation
Hazardous voltages may be present on all output and guard terminals. To prevent electrical shock that could cause injury or death, never make or break connections to the Model 2657A while the instrument is powered on. Turn off the equipment from the front panel or disconnect the main power cord from the rear of the Model 2657A before handling cables.
Page 42 Model 2657A can be set to limit voltage or power. In steady-state conditions, the Model 2657A output will not exceed the limit. The maximum limit is the same as the maximum values listed in the following table.
Page 43 Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 2: General operation Maximum limits for Model 2657A Range Maximum limit Range Maximum limit 200 V 120 mA 1 nA 3000 V 500 V 120 mA 10 nA 1500 V...
Page 44 CAUTION Carefully consider and configure the appropriate output-off state, source, and compliance limits before connecting the Model 2657A to a device that can deliver energy (for example, other voltage sources, batteries, capacitors, or solar cells). Configure recommended instrument settings before making connections to the device.
Page 45 (OVP) (on page 2-65) to levels that are higher than the external voltage level. Failure to do so could result in excessive current flow into the Model 2657A and incorrect measurements. The sink operating limits are shown in Continuous power operating boundaries (on page 4-4).
Page 46: Operation Considerations For The Adc
(high-speed) ADC. Autozero The integrating ADC of the Model 2657A uses a ratiometric A/D conversion technique. To ensure accuracy of readings, the instrument must periodically obtain fresh measurements of its internal ground and voltage reference. Separate reference and zero measurements are used for each aperture.
Page 47 Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 2: General operation This extra time can cause problems in sweeps and other test sequences in which measurement timing is critical. To avoid the extra time for the reference measurements in these situations, the OFF selection can be used to disable the automatic reference measurements.
Page 48: Basic Source-Measure Procedure
Hazardous voltages may be present on all output and guard terminals. To prevent electrical shock that could cause injury or death, never make or break connections to the Model 2657A while the instrument is powered on. Turn off the equipment from the front panel or disconnect the main power cord from the rear of the Model 2657A before handling cables.
Page 49 When not measuring the source (such as when sourcing V but measuring I), measurement range selection can be done manually or automatically. When using manual ranging, use the lowest possible range for best accuracy. When autorange is enabled, the Model 2657A automatically goes to the most sensitive range to make the measurement.
Page 50 Section 2: General operation Model 2657A High Power System SourceMeter® Instrument Reference Manual Basic source-measure commands Command Description smua.source.autorangei = smua.AUTORANGE_ON Enable current source autorange. Enable voltage source autorange. smua.source.autorangev = smua.AUTORANGE_ON smua.source.autorangei = smua.AUTORANGE_OFF Disable current source autorange. smua.source.autorangev = smua.AUTORANGE_OFF Disable voltage source autorange.
Page 51 Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 2: General operation -- Restore Model 2657A defaults. smua.reset() -- Select voltage source function. smua.source.func = smua.OUTPUT_DCVOLTS -- Set source range to auto. smua.source.autorangev = smua.AUTORANGE_ON -- Set voltage source to 1000 V.
Page 52: Triggering In Local Mode
Section 2: General operation Model 2657A High Power System SourceMeter® Instrument Reference Manual Triggering in local mode It is not necessary to change any trigger settings to use the basic source and measurement procedures covered in this section. Quick Tip Press the MENU key, and then select SETUP >...
Page 53: Configuring For Measure-Only Tests Using The Mode Key
2. Turn the navigation wheel to select the type of meter from the menu (I-METER, V-METER, OHM-METER, or WATT-METER). 3. Press the ENTER key to complete the configuration of the Model 2657A as the selected meter. 2657A-901-01 Rev. B/December 2012 2-29...
Page 54: V-Meter And I-Meter Measurements
Set compliance to a level that is higher than the expected measurement. CAUTION When using the Model 2657A as a voltmeter, the voltage compliance limit must be set higher than the voltage that is being measured. Failure to do this could result in excessive current flow into the Model 2657A, incorrect measurements, and possible damage to the instrument.
Page 55 (V/I) to best fit the display. There may be leading zeros if the ohms reading is less than 1 mΩ. Basic ohms measurement procedure When you use the MODE key to select ohms measurement, the Model 2657A is automatically configured as a current source with a level of 1 mA. If you wish to change the source function, source value, or compliance value (in other words, if you wish to customize the MODE key's standard ohm- meter's configuration), then perform the following steps to perform ohms measurements.
Page 56 Section 2: General operation Model 2657A High Power System SourceMeter® Instrument Reference Manual -- Restore Model 2657A defaults. smua.reset() -- Select current source function. smua.source.func = smua.OUTPUT_DCAMPS -- Set source range to 20 mA. smua.source.rangei = 20e-3 -- Set current source to 10 mA.
Page 57 Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 2: General operation Figure 8: Two-wire resistance sensing Model 2657A Test Current (I) LEAD LEAD Lead Lead Resistance Resistances Resistances Under Test LEAD LEAD I = Current sourced = Voltage measured = Voltage across resistor + (2 ×...
Page 58: Power Measurements
Basic power measurement procedure If you need to customize the MODE key's standard watt-meter configuration, perform the following steps to perform power measurements. The following procedure assumes that the Model 2657A is already connected to the device under test (DUT) as explained in...
Page 59 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 2657A while the output is on. Power off the equipment from the front panel or disconnect the main power cord from the rear of the Model 2657A before handling cables connected to the outputs.
Page 60 Section 2: General operation Model 2657A High Power System SourceMeter® Instrument Reference Manual -- Restore Model 2657A defaults. smua.reset() -- Select voltage source function. smua.source.func = smua.OUTPUT_DCVOLTS -- Enable source autoranging. smua.source.autorangev = smua.AUTORANGE_ON -- Set voltage source to 1000 V.
Page 61: Contact Check Measurements
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 2: General operation Contact check measurements Overview 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. Potential sources for this resistance include poor contact at the device under test (DUT), failing relay contacts on a switching card, and wires that are too long or thin.
Page 62: Saved Setups
= smua.OUTPUT_ON Saved setups You can restore the Model 2657A to one of six nonvolatile memory setup configurations (five user setups and one factory default), or to a setup stored on an external USB flash drive. As shipped from the factory, the Model 2657A powers up with the factory default settings, which cannot be overwritten.
Page 63 To save a user setup to an external USB flash drive from the front panel: 1. Configure the Model 2657A to the settings that you want to save. 2. Insert the USB flash drive into the USB port on the front panel of the Model 2657A. 3. Press the MENU key.
Page 64 -- Recall the saved user setup from nonvolatile memory. setup.recall(1) Restoring the factory default setups Use one of the reset functions to return the Model 2657A to the original factory defaults. An example of each type of reset is shown in the following program examples. ®...
Page 65: Dut Test Connections
Hazardous voltages may be present on all output and guard terminals. To prevent electrical shock that could cause injury or death, never make or break connections to the Model 2657A while the instrument is powered on. Turn off the equipment from the front panel or disconnect the main power cord from the rear of the Model 2657A before handling cables.
Page 66 (on page 2-62) or other safe enclosure. • Make sure that both the Model 2657A and the test fixture are properly connected to protective earth (safety ground). Connecting the test fixture to protective earth is only required if the test fixture is conductive.
Page 67 1500 V peak above the maximum rated input. Do not connect the Model 2657A terminals to CAT II, CAT III, or CAT IV circuits. Connection of the Model 2657A terminals to circuits higher than CAT I can cause damage to the equipment or expose the operator to hazardous voltage.
Page 68: High-Voltage Triaxial Cable Termination
(safety ground) connection, and LO connections. NOTE Using the chassis as a ground point for signal connections to the Model 2657A chassis may result in higher or lower noise. The tie point to the chassis can help quiet measurements if the Model 2657A common-mode current is channeled to the chassis instead of the device.
Page 69: 2-Wire Local Sensing Connections
Sourcing and measuring current. • Sourcing and measuring voltage in high impedance (more than 1 kΩ) test circuits. When using 2-wire local sensing connections, make sure to properly configure the Model 2657A Sense mode selection (on page 2-64). 2657A-901-01 Rev. B/December 2012...
Page 70 Section 2: General operation Model 2657A High Power System SourceMeter® Instrument Reference Manual WARNING Guard voltage can be hazardous. With an unguarded device under test (DUT) connection, terminate the guard before the end of the cable. Refer to High-voltage triaxial cable termination (on page 2- 44) for details.
Page 71: 4-Wire Remote Sensing Connections
When sourcing voltage in remote sense, make sure the sense leads are connected to the DUT. If a sense lead becomes disconnected, an erroneous voltage will be sensed, and the Model 2657A may increase the output voltage to compensate. You can use contact check to verify that the sense leads are connected.
Page 72 Section 2: General operation Model 2657A High Power System SourceMeter® Instrument Reference Manual WARNING Guard voltage can be hazardous. With an unguarded device under test (DUT) connection, terminate the guard before the end of the cable. Refer to High-voltage triaxial cable termination (on page 2- 44) for details.
Page 73 Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 2: General operation Item Description Notes Protective earth (safety ground) for Model Keithley Instruments Model CA-568-120 is a protective 2657A earth (safety ground) cable assembly supplied with the instrument. Interlock connection for Model 2657A Pin 24 (INT) and Pin 22 (5 VDC) connected to test fixture lid switch.
Page 74 Section 2: General operation Model 2657A High Power System SourceMeter® Instrument Reference Manual Refer to the following figure if using a test fixture with SHV connections. Figure 15: Four-wire resistance connections (remote sensing with SHV cables) Model 2657A SENSE 3030 VDC...
Page 75: Contact Check Connections
Model 2657A instruments. WARNING Connections to LO on the Model 2657A are not necessarily at 0 V. Hazardous voltages could exist between LO and chassis ground. Make sure that high-voltage precautions are taken throughout the test system. Alternatively, limit hazardous levels by adding external protection to limit the voltage between LO and chassis.
Page 76 (DUT). The following figure shows how to use a Model 263xB (on gate) and a Model 2657A (on drain) to test a 3-terminal device such as an N-channel MOSFET (see...
Page 77 Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 2: General operation WARNING Guard voltage can be hazardous. With an unguarded device under test (DUT) connection, terminate the guard before the end of the cable. Refer to High-voltage triaxial cable termination (on page 2- 44) for details.
Page 78 Interlock connection for Model 2657A Pin 24 (INT) and Pin 22 (5 VDC) are connected to the test fixture lid switch. Pin 19 is used to connect the digital grounds. Keithley Instruments Model 7709-308 is a 25-pin interlock male connector and can be used for custom connections.
Page 79: Guarding And Shielding
A safety shield must be used whenever hazardous voltages (>30 V RMS, 42 V peak) will be present in the test circuit. To prevent electrical shock that could cause injury or death, never use the Model 2657A in a test circuit without a properly installed and configured safety shield. 2657A-901-01 Rev. B/December 2012...
Page 80 Section 2: General operation Model 2657A High Power System SourceMeter® Instrument Reference Manual The safety shield can be metallic or nonconductive, and must completely surround the DUT test circuit. A metal safety shield must be connected to a known protective earth (safety ground). See...
Page 81 Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 2: General operation Figure 18: High-impedance guarding Model 2657A SENSE 3030 VDC GUARD SENSE MAX. 250 V MAX. DIGITAL I/O +5 VDC Ground symbols >1 GΩ Protective earth (safety ground)
Page 82 WARNING Connections to LO on the Model 2657A 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 83 Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 2: General operation Figure 19: Noise shield Model 2657A SENSE 3030 VDC GUARD SENSE MAX. 250 V MAX. DIGITAL I/O +5 VDC Metal noise shield Ground symbols >1 GΩ Protective earth...
Page 84 Section 2: General operation Model 2657A High Power System SourceMeter® Instrument Reference Manual Item Description Notes Protective earth (safety ground) for Model Keithley Instruments Model CA-568-120 is a protective 2657A earth (safety ground) cable assembly supplied with the instrument. Interlock connection for Model 2657A Pin 24 (INT) and Pin 22 (5 VDC) connected to test fixture lid switch.
Page 85 Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 2: General operation Figure 20: Connections for noise shield, safety shield, and guarding Model 2657A SENSE 3030 VDC GUARD SENSE MAX. 250 V MAX. DIGITAL I/O +5 VDC Metal noise...
Page 86 When the test fixture is correctly connected, the output of the Model 2657A will turn off when the lid of the test fixture is opened. Connect the enclosure of all metal test fixtures to protective earth (safety ground). See your specific test fixture for information.
Page 87: Floating A Smu
The Model 2657A digital I/O port provides an interlock line. When properly used with a test fixture, the output of the Model 2657A turns off when the lid of the test fixture is opened.
Page 88: Dut Connection Settings
Safety shield DUT connection settings Make sure to properly configure the Model 2657A sense mode for the specific DUT test connection scheme. Use care to configure both the output-off state and overvoltage protection settings to supplement safe operation of your test setup.
Page 89: Overvoltage Protection (Ovp)
To check or change the 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 2657A sense mode from either the V-SOURCE or the V-MEAS menu items.
Page 90: Output-Off States
Output-off states WARNING Do not depend on the output-off state to protect the user. The Model 2657A is provided with an interlock circuit that must be positively activated in order for the high voltage output to be enabled. The interlock helps facilitate safe operation of the equipment in a test system. Bypassing the interlock could expose the operator to hazardous voltages that could result in personal injury or death.
Page 91 • Measurements are performed and displayed. The Model 2657A can be used as an I-Meter when it is in zero output-off mode because it will output 0 V, but measure current. 2657A-901-01 Rev. B/December 2012...
Page 92 = smua.OUTPUT_ZERO Output-off function This setting is used only when the when output is turned off and the Model 2657A is in NORMAL output-off mode (smua.source.offmode = smua.OUTPUT_NORMAL). When the Model 2657A is in NORMAL output-off mode, you can set the output-off function to CURRENT or VOLTAGE through the CONFIG menu on the front panel, or by using the smua.source.offfunc attribute from a remote interface.
Page 93 You can set output-off limits (compliance) for the current and voltage output-off functions using the CONFIG menu on the Model 2657A front panel, or by setting the smua.source.offlimitY attribute from a remote interface. The output-off limits only apply when the output-off mode is normal.
Page 94: Usb Storage Overview
Connecting the USB flash drive The Model 2657A 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 95: File System Navigation
® File system navigation The Model 2657A can use commands from the Lua fs library to navigate and list files that are available on a flash drive. These Lua commands are in the fs command group in the instrument.
Page 96: Displayed Error And Status Messages
To update the displayed reading, trigger a measurement (if in local control, press the TRIG key). Available ranges The following table lists the available source and measurement ranges for the Keithley Instruments ® Model 2657A High Power System SourceMeter instrument.
Page 97: Measure Auto Delay
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 2: General operation Measure auto delay The measure delay is a specific delay that is applied before each measurement is taken. This delay is set to the auto delay setting by default (see table). You can change the default delay by setting the smuX.measure.delay...
Page 98: Low Range Limits
When you change a source value, source autoranging is automatically turned off and remains off until you re-enable it. Low range limits The low range limit sets the lowest range that the Model 2657A will use when autoranging is enabled. This feature is useful for minimizing autorange settling times when numerous range changes are involved.
Page 99: Range Considerations
Model 2657A 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 100: Range Programming
Section 2: General operation Model 2657A 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.
Page 101: Digits
Model 2657A 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 2657A is set up as follows: • Voltage source range: Auto •...
Page 102: Speed
Model 2657A High Power System SourceMeter® Instrument Reference Manual Speed The Model 2657A has two analog-to-digital converters (ADC): 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 103: Remote Communication Interfaces
You can choose from one of several communication interfaces to send commands to and receive responses from the Model 2657A. The Model 2657A can only be controlled from one communication interface at a time. The first interface on which it receives a message takes control of the instrument. It ignores the other interfaces until the instrument is returned to local operation.
Page 104: Supported Remote Interfaces
RS-232 NOTE The Model 2657A can only be controlled from one communication interface at a time. The first interface on which it receives a message takes control of the instrument. It ignores the other interfaces until the instrument is returned to local operation.
Page 105: Lan Communications
Section 2: General operation LAN communications The Model 2657A is an LXI version 1.4 Core 2011 compliant instrument that supports TCP/IP and complies with IEEE Std 802.3 (ethernet). There is one LAN port (located on the rear panel of the instrument) that supports full connectivity on a 10 Mbps or 100 Mbps network.
Page 106 When the LED is: The network: is not connected is connected Blinking is sending or receiving data Using the LAN with remote operations The following table lists the Model 2657A remote interface's available LAN protocols: LAN protocols Port number Protocol Telnet 1024 VXI-11...
Page 107: Gpib Operation
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 2: General operation GPIB operation This topic contains information about GPIB standards, bus connections, and primary address selection. GPIB standards The GPIB is the IEEE-488 instrumentation data bus, which uses hardware and programming standards originally adopted by the Institute of Electrical and Electronic Engineers (IEEE) in 1975.
Page 108 Erratic bus operation may occur if you ignore these limits. Primary address The Model 2657A ships from the factory with a GPIB primary address of 26. If the GPIB interface is enabled, it momentarily displays the primary address on power-up. You can set the address to a value from 0 to 30, but do not assign the same address to another device or to a controller that is on the same GPIB bus (controller addresses are usually 0 or 21).
Page 109: General Bus Commands
SPE, SPD (on page 2-87) for details. The remote enable (REN) command is sent to the Model 2657A by the controller to set up the instrument for remote operation. Generally, the instrument should be placed in the remote mode before you attempt to program it over the bus. Setting REN true does not place the instrument in the remote state.
Page 110 Model 2657A High Power System SourceMeter® Instrument Reference Manual The interface clear (IFC) command is sent by the controller to place the Model 2657A in the talker idle state and the listener idle state. The instrument responds to the IFC command by canceling front- panel TALK or LSTN lights, if the instrument was previously placed in one of these states.
Page 111: Front-Panel Gpib Operation
IFC (interface clear) command. LSTN This indicator is on when the Model 2657A is in the listener active state, which is activated by addressing the instrument to listen with the correct listen command. LSTN is off when the instrument is in the listener idle state.
Page 112: Rs-232 Interface Operation
This topic contains information about configuring RS-232 communication parameters, sending or receiving command messages, and requesting or retrieving data. To control the Model 2657A, connect a controller or personal computer to the Model 2657A RS-232 interface. Alternatively, you can use the Model 2657A to control another device over RS-232.
Page 113 1200 The factory-selected baud rate is 9600. Both the Model 2657A and the other device must be configured for the same baud rate. Make sure the device connected to the Model 2657A RS-232 port can support the selected baud rate.
Page 114 Model 2657A High Power System SourceMeter® Instrument Reference Manual RS-232 connections Connect the RS-232 serial port of the Model 2657A to the serial port of a computer using a straight- through RS-232 cable terminated with DB-9 connectors. Do not use a null modem cable. The serial port uses the transmit (TXD), receive (RXD), CTS and RTS (if flow control is enabled), and signal ground (GND) lines of the RS-232 standard.
Page 115: Functions And Features
Section 3 Functions and features In this section: Relative offset ................3-1 Filters ..................3-2 Reading buffers ................ 3-6 Sweep operation ..............3-19 Triggering ................3-31 High-capacitance mode ............3-63 Display operations ..............3-68 Digital I/O ................3-80 Relative offset You can use the relative offset (REL) feature to set offsets to zero (0) or subtract a baseline reading from present and future readings.
Page 116: Remote Relative Offset Programming
= smua.REL_ON Filters The filter feature lets you set the filter response to stabilize noisy measurements. The Model 2657A 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 117: Filter Types
Section 3: Functions and features Filter types The Model 2657A has three filter types. These three filter types are broken down into two averaging filters and one median filter. The two averaging filters are repeating and moving (see figure below). For the repeating filter (which is the power-on default), the stack (filter count) is filled, and the conversions are averaged to yield a reading.
Page 118: Response Time
Section 3: Functions and features Model 2657A High Power System SourceMeter® Instrument Reference Manual Figure 31: Median filter Middle Middle Middle Conversion Conversion Conversion value value value reading reading reading A. Type: Median, readings = 3 When a moving average filter or a median filter is first enabled, the stack is empty. The first reading conversion is placed in the stack and is then copied to the other stack locations in order to fill it.
Page 119: Remote Filter Programming
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 3: Functions and features Remote filter programming Filter commands The following table summarizes the filter commands. See the TSP command reference (on page 7-1) for details about commands. Filter commands...
Page 120: Reading Buffers
Reading buffers capture measurements, ranges, instrument status, and output state of the Keithley Instruments Model 2657A. The Model 2657A has two dedicated reading buffers. You can use the dedicated reading buffers to acquire readings, or you can use the smua.makebuffer() function to create dynamic reading buffers.
Page 121 Model 2657A 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 122 Section 3: Functions and features Model 2657A High Power System SourceMeter® Instrument Reference Manual To configure the instrument to append or overwrite measurements the next time data is acquired: 1. Press the CONFIG key. Select STORE, and then select STORAGE-MODE. The Storage Mode menu is shown.
Page 123 Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 3: Functions and features To save the reading buffer data: 1. From the front panel, press the STORE key, and then select SAVE. 2. Select INTERNAL to save to internal nonvolatile memory.
Page 124: Remote Reading Buffer Programming
Section 3: Functions and features Model 2657A High Power System SourceMeter® Instrument Reference Manual 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 125 Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 3: Functions and features Reading buffer commands The following table summarizes commands associated with the reading buffers. See TSP command reference (on page 7-1) for detailed reading buffer command information.
Page 126 Section 3: Functions and features Model 2657A High Power System SourceMeter® Instrument Reference Manual Commands to access readings: printbuffer(start_index, end_index, Prints data from buffer subtables: start_index (starting index of values to print). st_1, st_2, ... st_n) end_index (ending index of values to print).
Page 127 Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 3: Functions and features Buffer read-only attributes The following table contains buffer read-only attributes. Buffer read-only attributes: Read-only attributes used to access buffer parameters Storage attribute Description basetimestamp The timestamp of when the reading at rb[1] was stored, in seconds from midnight January 1, 1970 GMT.
Page 128 Section 3: Functions and features Model 2657A High Power System SourceMeter® Instrument Reference Manual Statistic attributes Use the smua.buffer.getstats() function to access the reading buffer data statistics. The table below displays the attributes that you can use to access the reading buffer statistics.
Page 129 Model 2657A 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.
Page 130 Section 3: Functions and features Model 2657A 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]...
Page 131 The following programming example illustrates how to store data using dedicated reading buffer 1. In the example, the Model 2657A loops for voltages from 21 V to 120 V with 1 V steps (essentially performing a staircase sweep), stores 100 current readings and source values in buffer 1, and then recalls all 100 readings and source values.
Page 132 The programming example below shows a script for storing both current and voltage readings using buffer 1 for current and buffer 2 for voltage readings. The Model 2657A stores 100 current and voltage readings and then recalls all 100 sets of readings.
Page 133: Sweep Operation
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 2657A stores 100 current readings in mybuffer and then recalls all the readings. -- Restore Model 2657A defaults.
Page 134 DC and pulsed list sweeps (C): The list sweep allows you to program arbitrary sweep steps anywhere within the output voltage or current range of the Model 2657A. This portion of the figure (C) shows a list sweep with arbitrary steps and a pulsed list sweep. Pulsed list sweeps function the same way that DC list sweeps function, except that pulsed list sweeps return to the idle level between pulses.
Page 135: Sweep Characteristics
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 3: Functions and features Sweep characteristics NOTE For any of the sweep types, program a pulse mode sweep by configuring the end pulse action. Refer Pulse mode sweeps (on page 3-26) for more information.
Page 136 Section 3: Functions and features Model 2657A 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 will go to the start source level. The output will then change in equal steps until the stop level is reached.
Page 137 Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 3: Functions and features Figure 34: Increasing logarithmic sweep Source level 200 to 800 with A = 0 200 to 800 with A = 180 200 to 800 with A = 850...
Page 138 Section 3: Functions and features Model 2657A High Power System SourceMeter® Instrument Reference Manual Solving for k and b provides the following formulas: k = V start log10(V - A) - log10(V - A) start b = 10 Where: = The source value at the end point...
Page 139 Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 3: Functions and features In this example: A = 0, V = 100, V = 1000, N = 5 start Using the formula above, k = 1 Step size (b) for the sweep in the above figure is calculated as follows:...
Page 140 Section 3: Functions and features Model 2657A High Power System SourceMeter® Instrument Reference Manual List sweeps Use a list sweep to configure a sweep with arbitrary steps. When enabled, a measurement is made at each point after source and measurement settling time.
Page 141 Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 3: Functions and features Timers must be used to configure the pulse width and period. Refer to Using timers to perform pulse mode sweeps (on page 3-44) for details. The pulse width is managed by controlling the duration between the source stimulus event and the end pulse stimulus event.
Page 142: Configuring And Running Sweeps
Section 3: Functions and features Model 2657A High Power System SourceMeter® Instrument Reference Manual Configuring and running sweeps Use the following topics to configure and run a sweep. Configuring compliance limits remotely Voltage and current limits can be configured using the smuX.trigger.source.limitY attribute, which sets the sweep source limits.
Page 143: Sweeping Using Factory Scripts
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 3: Functions and features Initiating and running sweeps To run a sweep, you must configure the number of sweep points to output and the number of sweeps to perform. Use the trigger count to set the number of sweep points to output. Use the arm count to set the number of times to perform the sweep.
Page 144: Sweep Programming Examples
Section 3: Functions and features Model 2657A High Power System SourceMeter® Instrument Reference Manual Sweep programming examples Procedures for programming and running a sweep for three sweep types are given on the following pages. Each of these procedures includes commands for a typical sweep example. The following table summarizes parameters for each of these examples.
Page 145: Triggering
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 3: Functions and features Pulse current sweep example The programming example below illustrates a pulse sweep. -- Restore Model 2657A defaults. 1. Configure source functions. Restores defaults and set the compliance to smua.reset()
Page 146 External triggers are possible using digital I/O, TSP-Link synchronization lines, LAN, command interface, and the manual trigger (the TRIG key). The following figure graphically represents all the trigger objects of the Model 2657A instrument. Figure 40: Triggering overview Manual trigger...
Page 147: Using The Remote Trigger Model
Using the remote trigger model The source-measure unit (SMU) in the Model 2657A has a remote trigger model that supports a wide range of triggering features for source sweeps, triggered measurements, and pulse actions.
Page 148 Section 3: Functions and features Model 2657A High Power System SourceMeter® Instrument Reference Manual Figure 41: Remote trigger model: Normal (synchronous) mode Idle Idle event Configure and enable sweep source or sweep smuX.trigger.IDLE_EVENT_ID measure actions, then send: smuX.trigger.initiate() Arm layer Sweeping event smuX.trigger.SWEEPING_EVENT_ID...
Page 149: Arm Layer
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 3: Functions and features Figure 42: Remote trigger model: Asynchronous mode Idle Idle event Configure and enable sweep source or sweep smuX.trigger.IDLE_EVENT_ID measure actions, then send: smuX.trigger.initiate() Arm layer Sweeping event smuX.trigger.SWEEPING_EVENT_ID...
Page 150 Section 3: Functions and features Model 2657A High Power System SourceMeter® Instrument Reference Manual When the smuX.trigger.measure.action attribute is set to smuX.DISABLE or smuX.ENABLE, the trigger model will operate in synchronous measurement mode. When it is set to smuX.ASYNC, it will operate in asynchronous mode.
Page 151 Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 3: Functions and features The source-measure unit (SMU) can be configured to perform any or all available measurements during a sweep using the smua.trigger.measure.Y() function. To enable the measure action for a simple synchronous sweep, set the smua.trigger.measure.action attribute to...
Page 152: Smu Event Detectors
Section 3: Functions and features Model 2657A High Power System SourceMeter® Instrument Reference Manual SMU event detectors As shown in the Using the remote trigger model (on page 3-33) topic, the source-measure unit (SMU) has multiple event detectors (see the table below) in order to control the timing of various actions.
Page 153: Using Trigger Events To Start Actions On Trigger Objects
Model 2657A 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, where each step is triggered by the front-panel TRIG key: -- Configure a 10-point source voltage sweep.
Page 154: Digital I/O Port And Tsp-Link Synchronization Lines
Digital I/O port and TSP-Link synchronization lines The Model 2657A has two sets of hardware lines that can be used for triggering: 14 digital I/O lines ®...
Page 155 Specifies the pulse width of the output trigger signal when the hardware line is asserted. Trigger configuration on hardware lines The Model 2657A can be configured to send digital signals to trigger external instruments. Linking these output triggers to the completion of certain source-measure actions enables hardware handshaking.
Page 156: Timers
A timer is a trigger object that performs a delay when triggered. Timers can be used to create delays and to start measurements and step the source value at timed intervals. When a delay expires the timer generates a trigger event. The Model 2657A has eight independent timers. Timer attributes The attributes that can be configured for each timer are described in the following sections.
Page 157 Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 3: Functions and features Timer delays Timers can be configured to perform the same delay each time or configured with a delay list that allows the timer to sequence through an array of delay values. All delay values are specified in seconds.
Page 158 Section 3: Functions and features Model 2657A High Power System SourceMeter® Instrument Reference Manual Figure 46: Using a timer for an SDM cycle Stimulus input: smua.trigger.measure.stimulus Legend: = Trigger object Timer SMU A = Trigger events = Stimulus input Trigger event: Trigger event: trigger.timer[1].EVENT_ID...
Page 159 Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 3: Functions and features The following figure shows the trigger setup for this example. Figure 47: Single pulse triggering Stimulus input: smua.trigger.endpulse.stimulus Legend: = Trigger object Timer SMU A = Trigger events...
Page 160 Section 3: Functions and features Model 2657A High Power System SourceMeter® Instrument Reference Manual Pulse train example: The 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 161 Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 3: Functions and features The following figure shows the trigger setup for this example. Figure 49: Pulse train triggering Trigger event: trigger.timer[1].EVENT_ID Stimulus input: trigger.timer[1].stimulus ulus Timer #1 Timer #2...
Page 162: Event Blenders
Section 3: Functions and features Model 2657A High Power System SourceMeter® Instrument Reference Manual Pulse train example code -- Generate a 10-point pulse train where each pulse has a width of 50 -- milliseconds and a pulse period of 100 milliseconds.
Page 163: Lan Triggering Overview
Generates an overrun when two events are detected simultaneously. LAN triggering overview Triggers can be sent and received over the LAN interface. The Model 2657A supports LAN extensions for instrumentation (LXI) and has eight LAN triggers that generate and respond to LXI trigger packets.
Page 164 The stateless event flag is a bit in the LXI trigger packet that indicates if the hardware value should be ignored. If it is set, the Model 2657A ignores the hardware value of the packet and generates a trigger event. The Model 2657A always sets the stateless flag for outgoing LXI trigger packets. If the stateless event flag is not set, the hardware value indicates the state of the signal.
Page 165: Command Interface Triggering
Make sure to use the same LXI domain on both the Model 2657A instrument and the other instrument. If the Model 2657A has a different LXI domain than the instrument at the other end of the trigger connection, the LXI trigger packets will be ignored by both instruments.
Page 166: Manual Triggering
Detecting trigger events using the wait() function All of the Model 2657A trigger objects (except for SMUs) have built-in event detectors that monitor for trigger events. The event detector only monitors events generated by that object and cannot be configured to monitor events generated by any other trigger object.
Page 167 Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 3: Functions and features Using the assert function to generate output triggers Certain trigger objects can be used to generate output triggers on demand. These trigger objects are the digital I/O lines, TSP-Link synchronization lines and the LAN.
Page 168 Section 3: Functions and features Model 2657A High Power System SourceMeter® Instrument Reference Manual The programming example below illustrates how to have the SMU immediately perform an action the first time through the trigger model, even if a programmed trigger event does not occur.
Page 169: Hardware Trigger Modes
The programming example below illustrates how to configure digital I/O line 2 as an input trigger and digital I/O line 14 as an output trigger. It commands the Model 2657A to wait for an external input trigger on digital I/O line 2. If a trigger event occurs, the Model 2657A outputs an external trigger on digital I/O line 14.
Page 170 Section 3: Functions and features Model 2657A High Power System SourceMeter® Instrument Reference Manual Falling edge trigger mode The falling edge trigger mode generates low pulses and detects all falling edges. The figure titled "Falling edge input trigger" shows the characteristics of the falling edge input trigger; the figure titled "Falling edge output trigger"...
Page 171 Use the rising edge master (RisingM) trigger mode (see the figure titled "RisingM output trigger") to synchronize with non-Keithley instruments that require a high pulse. Input trigger detection is not available in this trigger mode. You can use the RisingM trigger mode to generate rising edge pulses.
Page 172 Section 3: Functions and features Model 2657A High Power System SourceMeter® Instrument Reference Manual Figure 53: RisingA input trigger External Drive Internal Drive Physical Line State Event Stimulus Event Action Overrun Input Trigger Output characteristics: • In addition to trigger events from other trigger objects, the digio.trigger[N].assert() and tsplink.trigger[N].assert() commands generate a low pulse that is similar to the falling...
Page 173: 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 174 In this mode, the output trigger consists of a low pulse. All non-Keithley instruments attached to the synchronization line in a trigger mode equivalent to SynchronousA must latch the line low during the pulse duration.
Page 175 Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 3: Functions and features Figure 58: SynchronousM output trigger External Drive Internal Drive Physical Line State Event Stimulus Event Action Overrun Pulse Duration Output Trigger Synchronous acceptor trigger mode (SynchronousA) Use the synchronous acceptor trigger mode (SynchronousA) in conjunction with the SynchronousM trigger mode.
Page 176 Section 3: Functions and features Model 2657A High Power System SourceMeter® Instrument Reference Manual Figure 60: SynchronousA output trigger External Drive Internal Drive Physical Line State Event Stimulus Event Action Overrun Output Trigger Synchronous trigger mode The synchronous trigger mode is a combination of SynchronousA and SynchronousM trigger modes.
Page 177: High-Capacitance Mode
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 3: Functions and features Output characteristics: • In addition to trigger events from other trigger objects, the digio.trigger[N].assert() and tsplink.trigger[N].assert() functions generate a low pulse for the programmed pulse duration if the line is latched low, a falling edge does not occur.
Page 178: Understanding High-Capacitance Mode
In normal operation, the SMU in the Model 2657A can drive capacitive loads as large as 100 nF. In high-capacitance mode, the SMU can drive a maximum of 10 μF of capacitance.
Page 179: Enabling High-Capacitance Mode
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 3: Functions and features Understanding the capacitor Based on the capacitor's dielectric absorption performance, the settling time may change. NOTE Tantalum or electrolytic capacitors are well known for long dielectric absorption settling times.
Page 180 Section 3: Functions and features Model 2657A High Power System SourceMeter® Instrument Reference Manual Command interface Turning on High-C mode has the following effects on the SMU settings: • smua.measure.autorangei is set to smua.AUTORANGE_FOLLOW_LIMIT and cannot be changed. • Current ranges below 1 μA are not accessible.
Page 181 Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 3: Functions and features 2. To run the i_leakage_measure() function in the KIHighC factory script, send: -- Charges the capacitor. smua.source.levelv = 100 smua.source.output = smua.OUTPUT_ON delay(1) imeas = i_leakage_measure(smua, 0, 100e-3, 300e-3, 10e-6, 100e-3)
Page 182: Display Operations
Section 3: Functions and features Model 2657A High Power System SourceMeter® Instrument Reference Manual Display operations 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 183: Display Features
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 3: Functions and features Display features Display screen ® Keithley Instruments Model 2657A High Power System SourceMeter instrument displays source- measure values and readings or user defined messages. The display screen options include the following: •...
Page 184 Section 3: Functions and features Model 2657A High Power System SourceMeter® Instrument Reference Manual The display of the Model 2657A can be used to display user-defined messages. For example, while a test is running, the following message can be displayed on the Model 2657A.
Page 185 Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 3: Functions and features The function to set cursor position can be used two ways: display.setcursor(row, column) display.setcursor(row, column, style) Where: 1 or 2 1 to 20 (row 1) column...
Page 186 Section 3: Functions and features Model 2657A High Power System SourceMeter® Instrument Reference Manual Character codes The following special codes can be embedded in the text string to configure and customize the message: $N Starts text on the next line (newline). If the cursor is already on line 2, text will be ignored after the ‘$N’...
Page 187: Input Prompting
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 3: Functions and features Returning a text message The display.gettext() function returns the displayed message (text) and can be used in five ways: text = display.gettext() text = display.gettext(embellished) text = display.gettext(embellished, row) text = display.gettext(embellished, row, columnStart)
Page 188 Section 3: Functions and features Model 2657A High Power System SourceMeter® Instrument Reference Manual The following programming example illustrates how to present the operator with the choice of two menu items: Test1 or Test2. If Test1 is selected, the message Running Test1 is displayed. If Test2 is selected, the message Running Test2 is displayed.
Page 189: Indicators
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 3: Functions and features Both the display.inputvalue() and display.prompt() functions display the editable input field, but the display.inputvalue() function does not include the text strings for units and help. After one of the above functions is executed, command execution will pause and wait for the operator in input the source level.
Page 190: Local Lockout
Binary value * The weighted values are for bits that are set to “1.” Bits set to “0” have no value. Not all of the above indicators shown in above table may be used by the Model 2657A. Local lockout You can use the front-panel EXIT (LOCAL) key to cancel remote operation and return control to the front panel.
Page 191 Functions and variables need to be saved with the script (see Manage scripts (on page 6-3)). If the script is not saved in nonvolatile memory, it is lost when the Model 2657A is turned off. See Example 1 below. Example 1: Assume a script with a function named “DUT1”...
Page 192: Running A Test From The Front Panel
Capturing key-press codes A history of the key code for the last pressed front panel key is maintained by the Model 2657A. When the instrument is turned on (or when transitioning from local to remote operation), the key code is set to 0 (display.KEY_NONE).
Page 193 Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 3: Functions and features display.getlastkey() The display.getlastkey() function is used to immediately return the key code for the last pressed key. The following programming example illustrates how to display the last key pressed: key = display.getlastkey()
Page 194: Digital I/O
10 = Digital I/O #10 Connecting cables Use a cable equipped with a male DB-25 connector (Keithley Instruments part number CA-126-1), or a Model 2600-TLINK cable to connect the digital I/O port to other Keithley Instruments models equipped with a Trigger Link (TLINK).
Page 195 The Model 2657A interlock (INT) line of the digital I/O can be used with a switch in the test fixture or component handler. With proper use, power is removed from the DUT when the lid of the fixture is opened.
Page 196 Section 3: Functions and features Model 2657A High Power System SourceMeter® Instrument Reference Manual Controlling digital I/O lines Although the digital I/O lines are primarily intended for use with a device handler for limit testing, they can also be used for other purposes such as controlling external logic circuits. You can control lines either from the front panel or over a remote interface.
Page 197 I/O port and individual lines. Use these commands to trigger the Model 2657A using external trigger pulses applied to the digital I/O port, or to provide trigger pulses to external devices.
Page 198: Interlock
Overview The Model 2657A digital I/O port provides an interlock line for use with a test fixture switch. When properly used, the output of the SourceMeter instrument will turn off when the lid of the test fixture is opened.
Page 199 Operation When sourcing, the output of the Model 2657A can only be turned on when the interlock line is driven high through a switch to +5 V (as shown). If the lid of the test fixture opens, the switch opens, and the ®...
Page 200: Tsp-Link Synchronization Lines
The TSP-Link synchronization lines are built into the TSP-Link connection. Use the TSP-Link connectors located on the back of the Model 2657A. If you are using a TSP-Link network, you do not have to modify any connections. See TSP-Link system expansion interface (on page 6-49) for detailed information about connecting to the TSP-Link system.
Page 201 Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 3: Functions and features 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: tsplink.trigger[1].mode = tsplink.TRIG_BYPASS...
Page 202: Theory Of Operation
Creating pulses with the Model 2657A ........4-25 Analog-to-digital converter The Model 2657A has two analog-to-digital converters (ADC): An integrating ADC and a fast ADC. The integrating ADC uses a ratiometric analog-to-digital conversion technique. Depending on the configuration of the integrating ADC, periodic fresh reference measurements are required to minimize drift.
Page 203: Compliance Limit Principles
The Model 2657A can also be set to limit power. This limit can be set in addition to any voltage or current limits specified. The power limit restricts power by lowering the present limit in effect (voltage or current) as needed to restrict the SMU from exceeding the specified power limit.
Page 204 – P The maximum power generated in an instrument channel that can be properly dissipated by the instrument cooling system measured in watts. For the Model 2657A, this constant equals 200. The ambient temperature of the instrument operating environment. = 3(T...
Page 205: Operating Boundaries
Continuous power operating boundaries The general operating boundaries for Model 2657A continuous power output are shown in the following figure. For derating factors, see the General power equation (on page 4-3).
Page 206 Section 4: Theory of operation Operation as a sink When operating the Model 2657A in the second or fourth quadrant, the SMU operates as a load that sinks and dissipates the power internally. The SMU’s ability to dissipate power is defined by the boundaries shown in the previous figure.
Page 207 The first graph in the figure (labeled "A: Output characteristics"), shows the output characteristics for the V-source. As shown, the Model 2657A can continuously output up to 3.0 kV at 20 mA or up to 1.5 kV at 120 mA.
Page 208 Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 4: Theory of operation Load considerations (V-source) ® The boundaries within which the High Power System SourceMeter instrument operates depends on the load (device-under-test (DUT)) that is connected to the output. The following figure shows operation examples for resistive loads that are 200 kΩ...
Page 209 Section 4: Theory of operation Model 2657A High Power System SourceMeter® Instrument Reference Manual Notice that as resistance decreases, the slope of the DUT load line increases. As resistance approaches infinity (open output), the System SourceMeter instrument will source virtually 1000 V at 0 mA.
Page 210 Quick Tip The Model 2657A can measure the function it is sourcing (source I measure I, or source V measure V). This feature is valuable when operating with the source in compliance. When in compliance, the programmed source value is not reached.
Page 211 50 mA, the current limit applies to ±50 mA. For this example, the Model 2657A is programmed to source 200 V and to limit current to 50 mA. When the SMU turns on, the battery voltage is higher than the programmed voltage source value.
Page 212 Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 4: Theory of operation NOTE Since the battery is a power source, initial operation can occur anywhere along the initial battery voltage line. This voltage is only limited by the capability of the battery (see the following figure).
Page 213 The first graph in the figure, labeled "A: Output characteristics," shows the output characteristics for the I-source. As shown, Model 2657A instruments can continuously output up to +120 mA at 1.5 kV or up to 20 mA at 3.0 kV.
Page 214 Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 4: Theory of operation Load considerations (I-source) ® The boundaries within which the High Power System SourceMeter instrument operates depends on the load (device-under-test (DUT)) that is connected to its output. The following figure shows operation examples for resistive loads that are 5 kΩ...
Page 215 Section 4: Theory of operation Model 2657A High Power System SourceMeter® Instrument Reference Manual Notice that as resistance increases, the slope of the DUT load line increases. As resistance increases and approaches infinity (open output), the System SourceMeter instrument will source virtually 0 mA at 1000 V.
Page 216 Quick Tip The Model 2657A can measure the function it is sourcing (source I measure I, or source V measure V). This feature is valuable when operating with the source in compliance. When in compliance, the programmed source value is not reached.
Page 217 1500 V, the voltage limit applies to ±1500 V. For this example, the Model 2657A is programmed to source −50 mA (the constant current) and to limit voltage to 1500 V. When the SMU turns on, it begins sinking current as determined by the programmed I-source level (-50 mA), causing a decrease in the battery voltage.
Page 218 SMU’s measurement of the battery voltage and stop the discharge before the the Model 2657A starts to operate in quadrant III (negative voltage). You can stop the discharge by changing the programmed current source level or by disconnecting the SMU from the device.
Page 219: Basic Circuit Configurations
Section 4: Theory of operation Model 2657A 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, and can measure current (I-meter) or voltage (V-meter).
Page 220 Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 4: Theory of operation Source I When the instrument is configured to source current (I-source), as shown in the figure below, the instrument functions as a high-impedance current source with voltage limit capability and can measure current (I-meter) or voltage (V-meter).
Page 221 Section 4: Theory of operation Model 2657A High Power System SourceMeter® Instrument Reference Manual Source I measure I, source V measure V ® The High Power System SourceMeter instrument can measure the function it is sourcing. When sourcing a voltage, you can measure voltage. Conversely, if you are sourcing current, you can measure the output current.
Page 222 Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 4: Theory of operation In the following figure, the instrument uses a 2-wire local sensing configuration and is set to measure current only by setting it to source 0 V and measure current. Note that to obtain positive (+) readings, conventional current must flow from HI to LO.
Page 223 Section 4: Theory of operation Model 2657A High Power System SourceMeter® Instrument Reference Manual Figure 88: Contact check circuit configuration GUARD – 50 μA current source I-meter CCHK SW Local Remote SENSE HI Aggregate contact V-source resistances Feedback V-meter SENSE LO...
Page 224: Guard
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 4: Theory of operation Guard WARNING GUARD is at the same potential as output HI. Thus, if hazardous voltages are present at output HI, they are also present at the GUARD terminal.
Page 225 Section 4: Theory of operation Model 2657A High Power System SourceMeter® Instrument Reference Manual Inside the test fixture, a triaxial cable can be used to extend guard to the device under test (DUT). The center conductor of the cable is used for HI, and the inner shield is used for guard.
Page 226: Output Connection Considerations
Creating pulses with the Model 2657A Although the Model 2657A is not a pulse generator, you can create pulses by programming the Model 2657A to output a DC value and then return to an idle level. For information on how to create pulses, refer to...
Page 227: Pulse Rise And Fall Times
The pulse rise time is the time it takes a pulse to go from 10% to 90% of the pulse's maximum value. Pulse fall time is similar but on the pulse's trailing edge. For the Model 2657A, pulse rise and fall times can vary depending on the following factors: •...
Page 228: Pulse Width
For the integrating analog-to-digital converter (ADC), the integration period (nplc) affects the measurement speed. For the fast ADC, the measurement interval affects the measurement speed. Review the Model 2657A specifications for information on source settling time. For latest specifications, go to the Keithley Instruments website (http://www.keithley.com).
Page 229: Introduction To Tsp Operation
Section 5 Introduction to TSP operation In this section: Introduction to TSP operation ........... 5-1 About TSP commands ............. 5-3 Factory scripts ................ 5-18 Introduction to TSP operation ® Instruments that are Test Script Processor (TSP ) enabled operate like conventional instruments by responding to a sequence of commands sent by the controller.
Page 230: Queries
Section 5: Introduction to TSP operation Model 2657A High Power System SourceMeter® Instrument Reference Manual Example 2 You can use the results of a function-based command directly or assign variables to the results for later access. The following code saves the value you enter from the front panel and prints it.
Page 231: Information On Scripting And Programming
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 5: Introduction to TSP operation Information on scripting and programming If you need information about using scripts with your TSP-enabled instrument, see Fundamentals of scripting for TSP (on page 6-1).
Page 232: Data Queue
Section 5: Introduction to TSP operation Model 2657A High Power System SourceMeter® Instrument Reference Manual NOTE 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 233: Digital I/O
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 5: Introduction to TSP operation Digital I/O The digital I/O port of the instrument can control external circuitry (such as a component handler for binning operations). The I/O port has 14 lines. Each line can be at TTL logic state 1 (high) or 0 (low). See the pinout...
Page 234: Error Queue
Section 5: Introduction to TSP operation Model 2657A High Power System SourceMeter® Instrument Reference Manual Error queue When errors and events occur, the error and status messages are placed in the error queue. Use the error queue commands to request error and status message information.
Page 235: Gpib
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 5: Introduction to TSP operation ® File descriptors cannot be passed between nodes in a TSP-Link system, so the io.open(), fileVar::read(), and fileVar::write commands are not accessible to the TSP-Link system.
Page 236: Lan And Lxi
Section 5: Introduction to TSP operation Model 2657A High Power System SourceMeter® Instrument Reference Manual LAN and LXI The LAN commands have options that allow you to review and configure network settings. The lan.config.* commands allow you to configure LAN settings over the remote interface. Note that you must send lan.applysettings() for the configuration settings to take effect.
Page 237: Miscellaneous
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 5: Introduction to TSP operation localnode.passwordmode (on page 7-137) Miscellaneous delay() (on page 7-48) exit() (on page 7-87) localnode.linefreq (on page 7-135) localnode.password (on page 7-136) localnode.passwordmode (on page 7-137)
Page 238: Reading Buffer
Section 5: Introduction to TSP operation Model 2657A 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-16) bufferVar.basetimestamp (on page 7-16) bufferVar.cachemode (on page 7-17) bufferVar.capacity...
Page 239: Saved Setups
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 5: Introduction to TSP operation Saved setups Use the saved setups commands to save and restore the configuration of the instrument. You can save or restore configurations to or from the instrument's nonvolatile memory or an installed USB flash drive.
Page 240: Smu
Section 5: Introduction to TSP operation Model 2657A High Power System SourceMeter® Instrument Reference Manual localnode.linefreq (on page 7-135) smuX.abort() (on page 7-176) smuX.buffer.getstats() (on page 7-177) smuX.buffer.recalculatestats() (on page 7-178) smuX.contact.check() (on page 7-189) smuX.contact.r() (on page 7-190) smuX.contact.speed (on page 7-191) smuX.contact.threshold...
Page 241: Smu Calibration
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 5: Introduction to TSP operation smuX.trigger.measure.action (on page 7-235) smuX.trigger.measure.set() (on page 7-235) smuX.trigger.measure.stimulus (on page 7-236) smuX.trigger.measure.Y() (on page 7-238) smuX.trigger.MEASURE_COMPLETE_EVENT_ID (on page 7-238) smuX.trigger.PULSE_COMPLETE_EVENT_ID (on page 7-239) smuX.trigger.source.action (on page 7-240) smuX.trigger.source.limitY...
Page 242: Status Model
Section 5: Introduction to TSP operation Model 2657A 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.
Page 243: Time
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 5: Introduction to TSP operation Time bufferVar.basetimestamp (on page 7-16) bufferVar.collecttimestamps (on page 7-21) bufferVar.timestampresolution (on page 7-31) delay() (on page 7-48) gettimezone() (on page 7-97) os.time() (on page 7-147)
Page 244 Section 5: Introduction to TSP operation Model 2657A High Power System SourceMeter® Instrument Reference Manual smuX.trigger.source.action (on page 7-240) smuX.trigger.source.limitY (on page 7-241) smuX.trigger.source.linearY() (on page 7-242) smuX.trigger.source.listY() (on page 7-243) smuX.trigger.source.logY() (on page 7-244) smuX.trigger.source.set() (on page 7-245) smuX.trigger.source.stimulus (on page 7-245) smuX.trigger.SOURCE_COMPLETE_EVENT_ID...
Page 245: Tsp-Link
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 5: Introduction to TSP operation TSP-Link These functions and attributes allow you to set up and work with a system that is connected by a ® TSP-Link network. tsplink.group (on page 7-344) tsplink.master...
Page 246: Factory Scripts
(on page A-4) for instructions on upgrading the flash firmware of your Model 2657A instrument. A factory script is similar to a user script, except a factory script is created by Keithley Instruments at the factory and is permanently stored in nonvolatile memory. The differences between a user script and a factory script include the following: •...
Page 247: Retrieving And Modifying A Factory Script Listing
The modified script can be saved as a user script using the same name or a new name. An imported factory script can only be loaded back into the Model 2657A as a user script. The following function retrieves a script listing. The script code is output with the shell keywords (loadscript or loadandrunscript and endscript): script.factory.scripts.name.list()
Page 248: Kipulse Factory Script
Section 5: Introduction to TSP operation Model 2657A High Power System SourceMeter® Instrument Reference Manual KIPulse factory script The KIPulse factory script provides examples of how to generate pulses and to provide a simple pulsing interface. Pulses can be generated using the functions listed below.
Page 249: Kihighc Factory Script
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 5: Introduction to TSP operation Advanced features for KIPulse tag parameter pulse functions Variable off time between pulses in a pulse train The KIPulse “Configure” functions will accept the toff parameter as a table, or as a number. The table allows you to define different off times to be used after each pulse.
Page 250: Instrument Programming
Section 6 Instrument programming In this section: Fundamentals of scripting for TSP ........... 6-1 Fundamentals of programming for TSP ......... 6-10 Test Script Builder (TSB) ............6-29 Password management ............6-33 Device identification indicator ..........6-35 Working with TSB Embedded ..........6-36 Advanced scripting for TSP ............
Page 251: What Is A Script
Section 6: Instrument programming Model 2657A 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 252: Commands That Cannot Be Used In Scripts
• Test Script Builder (TSB) software: TSB software is a programming tool that is on the Test Script Builder Software Suite CD-ROM (included with your Model 2657A). You can use it to ® create, modify, debug, and store Test Script Processor (TSP ) scripting engine scripts.
Page 253 Section 6: Instrument programming Model 2657A High Power System SourceMeter® Instrument Reference Manual Named scripts A named script is a script with a unique name. You can have as many named scripts as needed in the instrument (within the limits of the memory available to the run-time environment). When a named script is loaded into the run-time environment with the loadscript or loadandrunscript commands, a global variable with the same name is created to reference the script.
Page 254 Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 6: Instrument programming To load a named script by sending commands: 1. Send the command loadscript scriptName, where scriptName is the name of the script. The name must be a legal Lua variable name.
Page 255 Section 6: Instrument programming Model 2657A High Power System SourceMeter® Instrument Reference Manual Run a named script You can run any named script that is in the run-time environment using one of the following commands: • scriptVar() • scriptVar.run() Where: scriptVar is the user-defined name of the script.
Page 256: Working With Scripts In Nonvolatile Memory
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 6: Instrument programming Example: Set a script to run automatically test5.autorun = "yes" Assume a script named test5 is in the test5.save() run-time environment. The next time the instrument is turned on, test5 script automatically loads and runs.
Page 257 Section 6: Instrument programming Model 2657A High Power System SourceMeter® Instrument Reference Manual Save a user script You can save scripts to nonvolatile memory using commands or TSB Embedded. Only named scripts can be saved to nonvolatile memory. The anonymous script must be named before it can be saved to nonvolatile memory.
Page 258: Programming Example
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 6: Instrument programming Delete user scripts NOTE These steps remove a script from nonvolatile memory. To completely remove a script from the instrument, there are additional steps you must take. See Delete user scripts from the instrument page 6-46).
Page 259: Fundamentals Of Programming For Tsp
Programming commands control script execution and provide tools such as variables, functions, branching, and loop control. ® The Test Script Processor (TSP ) scripting engine is a Lua interpreter. In TSP-enabled instruments, the Lua programming language has been extended with Keithley-specific instrument control commands. 6-10 2657A-901-01 Rev. B/December 2012...
Page 260: What Is Lua
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 6: Instrument programming What is Lua? Lua is a programming language that can be used with TSP-enabled instruments. Lua is an efficient language with simple syntax that is easy to learn.
Page 261 Section 6: Instrument programming Model 2657A High Power System SourceMeter® Instrument Reference Manual Function and variable name restrictions You cannot use factory script names, functions created by factory scripts, Lua reserved words and top level command names for function or variable names.
Page 262 Section 6: Instrument programming NOTE Do not create variable names that are the same as the top level command names of Model 2657A remote commands. Doing so will result in the loss of use of those commands. See Function and variable name restrictions (on page 6-12).
Page 263 Section 6: Instrument programming Model 2657A High Power System SourceMeter® Instrument Reference Manual Example: String and number x = "123" string print(x, type(x)) x = x + 7 Adding a number to x forces its type to number. print(x, type(x)) 1.30000e+02...
Page 264 Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 6: Instrument programming Where: • myFunction: The name of the function. • parameterX: Parameter names. To use multiple parameters, separate the names with commas. • functionBody is the code that is executed when the function is called.
Page 265 Section 6: Instrument programming Model 2657A High Power System SourceMeter® Instrument Reference Manual Create functions using scripts You can use scripts to define functions. Scripts that define a function are like any other script: They do not cause any action to be performed on the instrument until they are executed. The global variable of the function does not exist until the script that created the function is executed.
Page 266 Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 6: Instrument programming Example: User script User script created in Test Script Builder or User script created in user's own program TSB Embedded loadscript function myDisplay(name) function myDisplay(name) display.clear() display.clear() display.settext(...
Page 267 Section 6: Instrument programming Model 2657A High Power System SourceMeter® Instrument Reference Manual Example print(10 or errorqueue.next()) 1.00000e+01 print(nil or "a") print(nil and 10) print(false and errorqueue.next()) false print(false and nil) false print(false or nil) print(10 and 20) 2.00000e+01 String concatenation...
Page 268 Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 6: Instrument programming You can use parentheses to change the precedences in an expression. The concatenation ("..") and exponentiation ("^") operators are right associative. All other binary operators are left associative. The examples below show equivalent expressions.
Page 269 Section 6: Instrument programming Model 2657A High Power System SourceMeter® Instrument Reference Manual Example: If and else x = 2 Output: if not x then This is from the else block print("This is from the if block") else print("This is from the else block")
Page 270 Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 6: Instrument programming While loops To use conditional expressions to determine whether to execute or end a loop, you use while loops. These loops are similar to Conditional branching (on page 6-19) statements.
Page 271 Section 6: Instrument programming Model 2657A High Power System SourceMeter® Instrument Reference Manual For loops There are two variations of for statements supported in Lua: numeric and generic. NOTE In a for loop, the loop expressions are evaluated once, before the loop starts.
Page 272 Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 6: Instrument programming Break The break statement can be used to terminate the execution of a while, repeat, or for loop, skipping to the next statement after the loop. A break ends the innermost enclosing loop.
Page 273 Section 6: Instrument programming Model 2657A High Power System SourceMeter® Instrument Reference Manual Example: Break with infinite loop a, b = 0, 1 This example uses a break statement while true do that causes the while loop to exit if the value of a becomes greater than 500.
Page 274: Standard Libraries
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 6: Instrument programming Standard libraries In addition to the standard programming constructs described in this document, Lua includes standard libraries that contain useful functions for string manipulation, mathematics, and related ®...
Page 275 Section 6: Instrument programming Model 2657A High Power System SourceMeter® Instrument Reference Manual Lua memory management Lua automatically manages memory, which means you do not have to allocate memory for new objects and free it when the objects are no longer needed. Lua occasionally runs a garbage collector to collect all objects that are no longer accessible from Lua.
Page 276 Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 6: Instrument programming String library functions Function Description string.lower(s) Receives a string and returns a copy of this string with all uppercase letters changed to lowercase. All other characters are left unchanged.
Page 277 Section 6: Instrument programming Model 2657A High Power System SourceMeter® Instrument Reference Manual 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 278: Programming Example: Script With A For Loop
Test Script Builder (TSB) Keithley Instruments Test Script Builder (TSB) is a software tool included with your Model 2657A. You can install and use TSB to develop scripts for TSP-enabled instruments. Installing the TSB software To install the Test Script Builder (TSB) software: 1.
Page 279: Installing The Tsb Add-In
(setup.exe) located on the CD-ROM to start installation. Using Test Script Builder (TSB) Keithley Instruments Test Script Builder (TSB) is a software tool that simplifies building test scripts. You can use TSB to perform the following operations: •...
Page 280: Project Navigator
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 6: Instrument programming The following figure shows an example of the Test Script Builder. As shown, the workspace is divided into these areas: • Project navigator • Script editor •...
Page 281: Script Editor
Section 6: Instrument programming Model 2657A High Power System SourceMeter® Instrument Reference Manual Script editor The script editor is where scripts are written, modified, and debugged. 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 282: Programming Interaction
Test Script Builder (TSB). Password management The Model 2657A has password capabilities that let you decide how to password protect the instrument. You can enable password policies to lock the instrument. Locking the instrument prevents unauthorized access to any remote interface and reserves the instrument exclusively for your use.
Page 283: Password Overview
Enables passwords on all Ethernet and web interfaces. localnode.PASSWORD_ALL. Protects the LAN and all command and web interfaces. localnode.PASSWORD_NONE. Disables all passwords. The password lock feature on Model 2657A is similar to the lock feature on your computer. NOTE You must enable passwords to use this feature.
Page 284: Device Identification Indicator
Model 2657A 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 2657A responds to any command issued over a remote interface. NOTE The password for the example below is Keithley.
Page 285: Working With Tsb Embedded
TSB Embedded are similar to TSB. TSB Embedded includes a command line interface that you can use to send instrument commands and create, modify, and save test scripts to the instrument. For additional information, refer to the Model 2657A User's Manual section "Using the web interface."...
Page 286: Sending Instrument Commands With Tsb Embedded
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 6: Instrument programming Sending instrument commands with TSB Embedded NOTE The response from the instrument appears in the instrument output area. To send commands from the command line: 1. Type the command in the Console field and then press the Enter key.
Page 287: Advanced Scripting For Tsp
Section 6: Instrument programming Model 2657A 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 288: Create A Script Using The Script.new() Command
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 6: Instrument programming Figure 95: Global variables and scripts in the runtime environment Scripts in the runtime environment Global variables Name Value script name beepTwoSec beeper.enable = 1 source beeper.beep(2, 2400)
Page 289 Section 6: Instrument programming Model 2657A 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...
Page 290 Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 6: Instrument programming Figure 97: Create an unnamed script Global variables Scripts in the runtime environment Name Value script name display.clear() reference to hello source display.settext("hello") unnamed script Autorun A script will become unnamed if you create a new script with the same name. In this circumstance, the name of the script in the script.user.scripts table is set to an empty string before it is...
Page 291: Rename A Script
Section 6: Instrument programming Model 2657A High Power System SourceMeter® Instrument Reference Manual Figure 98: Create a new script with the name of an existing script Global variables Scripts in the runtime environment Name Value script name reference to an unnamed beepTwoSec beeper.enable = 1...
Page 292 Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 6: Instrument programming NOTE 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 293: Retrieve A User Script
Section 6: Instrument programming Model 2657A 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 294 Model 2657A 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.
Page 295: Delete User Scripts From The Instrument
Section 6: Instrument programming Model 2657A High Power System SourceMeter® Instrument Reference Manual Example: Retrieve the content of a script with scriptVar.list() test.list() Request a listing of the source of test. An example of the possible instrument output is shown here (note that the loadscript and endscript commands are included).
Page 296: Restore A Script To The Run-Time Environment
For example, to restore a user script named "test9" from nonvolatile memory: script.restore("test9") Memory considerations for the run-time environment The Model 2657A reserves 32 MB of memory for dynamic run-time use. Approximate allocation of this memory is shown below: 5 MB...
Page 297 Section 6: Instrument programming Model 2657A High Power System SourceMeter® Instrument Reference Manual Note that the dedicated reading buffers do not consume memory that is needed by the run-time environment; do not include them in your memory consumption calculations. Also, reading buffers for remote nodes consume memory on the remote node, not the local node.
Page 298: Tsp-Link System Expansion Interface
SourceMeter instrument. WARNING The Model 2657A High Power System SourceMeter instrument and its associated cabling are designed to be safe when operated correctly in a 3000 V system. They are only warranted to the maximum voltage and current ratings of the instrument.
Page 299: Connections
Section 6: Instrument programming Model 2657A High Power System SourceMeter® Instrument Reference Manual TSP-Link system ® You can use the TSP-Link expansion interface to expand your test system to include up to 32 ® ® addressable TSP enabled instruments that use the TSP-LINK .
Page 300: Initialization
You can assign a node number to a Model 2657A using the front panel or by using a remote command. Note that there can only be 32 physical nodes, but you can assign node numbers from 1 to 64.
Page 301: Resetting The Tsp-Link Network
Section 6: Instrument programming Model 2657A High Power System SourceMeter® Instrument Reference Manual To assign a node number using a remote command: Set the tsplink.node attribute of the instrument: tsplink.node = N Where: N = 1 to 64 To determine the node number of an instrument, you can read the tsplink.node attribute by sending the following command: print(tsplink.node)
Page 302: Using The Expanded System
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 6: Instrument programming The programming example below illustrates a TSP-Link reset operation and displays its state: tsplink.reset() print(tsplink.state) If the reset operation is successful, online is output to indicate that communications with all nodes have been established.
Page 303: Tsp Advanced Features
Section 6: Instrument programming Model 2657A High Power System SourceMeter® Instrument Reference Manual Using the reset() command ® Most TSP-Link system operations target a single node in the system, but the reset() command affects the system as a whole by resetting all nodes to their default settings: -- Reset all nodes in a TSP-Link system to their default state.
Page 304 Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 6: Instrument programming There are two methods you can use to run test scripts simultaneously: • Create multiple TSP-Link networks • Use a single TSP-Link network with groups The following figure displays the first method, which consists of multiple TSP-Link networks. Each TSP-Link network has a master node and a GPIB connection to the computer.
Page 305 Section 6: Instrument programming Model 2657A High Power System SourceMeter® Instrument Reference Manual Another method you can use to run simultaneous test scripts is to use groups with a single TSP-Link network. Each group on the TSP-Link network can run a test while other groups are running different tests.
Page 306 Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 6: Instrument programming 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 307 Section 6: Instrument programming Model 2657A High Power System SourceMeter® Instrument Reference Manual 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.
Page 308 Nodes that are running test scripts at the same time can store data in the data queue for real-time communication. Each Model 2657A has an internal data queue that uses the first-in, first-out (FIFO) structure to store data. You can use the data queue to post numeric values, strings, and tables.
Page 309 Section 6: Instrument programming Model 2657A High Power System SourceMeter® Instrument Reference Manual Copying test scripts across the TSP-Link network To run a large script on a remote node, copy the test script to the remote node to increase the speed of test script initiation.
Page 310: Tsp-Net
TSP-enabled instrument and have both instruments run scripts independently. The Model 2657A 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. You can simultaneously connect to a maximum of 32 devices using standard TCP/IP networking techniques through the LAN port of the Model 2657A.
Page 311: Using Tsp-Net With Any Ethernet-Enabled Device
(on page 7-1) for details about the commands presented in this section. The Model 2657A has Auto-MDIX, so you can use either a LAN crossover cable or a LAN straight- through cable to connect directly from the Model 2657A to an ethernet device or to a hub.
Page 312: Remote Instrument Errors
If the Model 2657A is connected to a TSP-enabled instrument through TSP-Net, all errors that occur on the remote instrument are transferred to the error queue of the Model 2657A. The Model 2657A indicates errors from the remote instrument by prefacing these errors with “Remote Error.” For example, if the remote instrument generates error code 4909, "Reading buffer not found within...
Page 313: Tsp-Net Instrument Commands: Tsp-Enabled Device Control
Section 6: Instrument programming Model 2657A High Power System SourceMeter® Instrument Reference Manual TSP-Net instrument commands: TSP-enabled device control The following instrument commands provide TSP-enabled device control: tspnet.tsp.abort() (on page 7-366) tspnet.tsp.abortonconnect (on page 7-366) tspnet.tsp.rbtablecopy() (on page 7-367) tspnet.tsp.runscript()
Page 314: Tsp Command Reference
Section 7 TSP command reference In this section: TSP command programming notes .......... 7-1 Using the TSP command reference ......... 7-4 TSP commands ................ 7-8 TSP command programming notes This section contains general information about using TSP commands. Placeholder text This manual uses italicized text to represent the parts of remote commands that must be replaced by user specified values.
Page 315: Syntax Rules
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual For example, to use SMU A to take voltage measurements and store them in buffer vbuffername, you would send: smua.trigger.measure.v(vbuffername) Syntax rules The following table lists syntax requirements to build well-formed instrument control commands.
Page 316: Time And Date Values
Remote versus local state The Model 2657A 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 317: Using The Tsp Command Reference
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual Using the TSP command reference The TSP command reference contains detailed descriptions of each of the TSP commands that you can use to control your instrument. Each command description is broken into several standard subsections.
Page 318: Command Name And Summary Table
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Command name and summary table Each instrument command description starts with the command name, followed by a table with relevant information for each command. Definitions for the numbered items in the figure below are listed following the figure.
Page 319: Command Usage
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual Command usage The Usage section of the remote command listing shows how to properly structure the command. Each line in the Usage section is a separate variation of the command usage; all possible command usage options are shown here.
Page 320: Related Commands And Information
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Figure 107: Code examples in command listings Example Enables the beeper and generates a beeper.enable = beeper.ON Working code two-second, 2400 Hz tone. beeper.beep(2, 2400) example Description of what code does 1.
Page 321: Tsp Commands
Details You can use the beeper of the Model 2657A to provide an audible signal at a specified frequency and time duration. For example, you can use the beeper to signal the end of a lengthy sweep. The beeper will not sound if it is disabled. It can be disabled or enabled with the beeper enable command, or through the front panel.
Page 322: Bit.bitand()
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Example beeper.enable = beeper.ON Enables the beeper and generates a two-second, 2400 Hz tone. beeper.beep(2, 2400) Also see beeper.beep() (on page 7-8) bit.bitand() This function performs a bitwise logical AND operation on two numbers.
Page 323: Bit.bitxor()
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual Details Any fractional parts of value1 and value2 are truncated to make them integers. The returned result is also an integer. Example testResult = bit.bitor(10, 9)
Page 324: Bit.clear()
Model 2657A 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)
Page 325: Bit.getfield()
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual Details This function returns the value of the bit in value at index. This is the same as returning value with all other bits set to zero (0).
Page 326: Bit.set()
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Also see Bit manipulation and logic operations (on page 5-3) bit.get() (on page 7-11) bit.set() (on page 7-13) bit.setfield() (on page 7-13) bit.set() This function sets a bit at the specified index position.
Page 327: Bit.test()
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual Usage result = bit.setfield(value, index, width, fieldValue) Result of the bit manipulation result Specified number value One-based bit position in value to set (1 to 32)
Page 328: Bit.toggle()
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Details This function returns result, which is the result of the tested bit. The least significant bit of value is at index position 1; the most significant bit is at index position 32.
Page 329: Buffervar.appendmode
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual Also see Bit manipulation and logic operations (on page 5-3) bit.clear() (on page 7-11) bit.get() (on page 7-11) bit.set() (on page 7-13) bit.test() (on page 7-14) bufferVar.appendmode...
Page 330: Buffervar.cachemode
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Usage basetime = bufferVar.basetimestamp The timestamp of the first stored reading basetime The reading buffer; can be a dynamically allocated buffer (user-defined), or a bufferVar dedicated reading buffer (such as smua.nvbuffer1)
Page 331: Buffervar.capacity
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual Details Assigning a value to this attribute enables or disables the reading buffer cache. When enabled, the reading buffer cache improves access speed to reading buffer data.
Page 332: Buffervar.clear()
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Also see Reading buffers (on page 3-6) smuX.makebuffer() (on page 7-193) smuX.measure.overlappedY() (on page 7-204) smuX.measure.Y() (on page 7-208) smuX.nvbufferY (on page 7-210) smuX.trigger.measure.Y() (on page 7-238) bufferVar.clear()
Page 333: Buffervar.collectsourcevalues
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual Details This function clears all readings from the specified cache. If you run successive operations that overwrite reading buffer data, the reading buffer may return stale cache data.
Page 334: Buffervar.collecttimestamps
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Example smua.nvbuffer1.collectsourcevalues = 1 Include source values with readings for dedicated reading buffer 1. Also see bufferVar.clear() (on page 7-19) Reading buffers (on page 3-6) smuX.measure.overlappedY() (on page 7-204) smuX.measure.Y()
Page 335: Buffervar.fillcount
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual bufferVar.fillcount This attribute sets the reading buffer fill count. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Not applicable See Details Usage fillCount = bufferVar.fillcount bufferVar.fillcount = fillCount...
Page 336: Buffervar.measurefunctions
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Details When this attribute is set to smuX.FILL_ONCE, the reading buffer will not overwrite readings. If the buffer fills up, new readings will be discarded. When this attribute is set to smuX.FILL_WINDOW, new readings will be added after existing data until the buffer holds bufferVar.fillcount elements.
Page 337: Buffervar.measureranges
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual Example 1 measurefunction = smua.nvbuffer1.measurefunctions[5] Store the measure function used to make reading number 5. Example 2 printbuffer(1, 5, smua.nvbuffer1.measurefunctions) Print the measurement function that was used to...
Page 338: Buffervar.n
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Example measurerange = smua.nvbuffer1.measureranges[1] Store the measure range that was used to make reading number 1. printbuffer(1, 10, smua.nvbuffer1.measureranges) Print the range values that were used for the first 10 readings saved in dedicated reading buffer 1.
Page 339: Buffervar.readings
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual Also see bufferVar.measurefunctions (on page 7-23) bufferVar.measureranges (on page 7-24) bufferVar.readings (on page 7-26) bufferVar.sourcefunctions (on page 7-27) bufferVar.sourceoutputstates (on page 7-28) bufferVar.sourceranges (on page 7-28) bufferVar.sourcevalues...
Page 340: Buffervar.sourcefunctions
Model 2657A 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...
Page 341: Buffervar.sourceoutputstates
Section 7: TSP command reference Model 2657A 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...
Page 342: Buffervar.sourcevalues
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Usage sourcerange = bufferVar.sourceranges[N] The source range used to acquire reading number N in the specified buffer sourcerange The reading buffer; can be a dynamically allocated buffer (user-defined), or a bufferVar dedicated reading buffer (such as smua.nvbuffer1)
Page 343: Buffervar.statuses
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual Usage sourcevalue = bufferVar.sourcevalues[N] The source's output value when reading N of the specified buffer was acquired sourcevalue The reading buffer; can be a dynamically allocated buffer (user-defined), or a bufferVar dedicated reading buffer (such as smua.nvbuffer1)
Page 344: Buffervar.timestampresolution
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Usage statusInformation = bufferVar.statuses[N] The status value when reading N of the specified buffer was acquired statusInformation The reading buffer; can be a dynamically allocated user-defined buffer or a...
Page 345: Buffervar.timestamps
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual Details Assigning a value to this attribute sets the resolution for the timestamps. Reading this attribute returns the timestamp resolution value. This value can only be changed with an empty buffer. Empty the buffer using the bufferVar.clear() function.
Page 346: Configpulseimeasurev()
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Example timestamp = smua.nvbuffer1.timestamps[1] Get the timestamp of the first reading stored in dedicated reading buffer 1. Also see bufferVar.clear() (on page 7-19) bufferVar.collecttimestamps (on page 7-21) bufferVar.measurefunctions...
Page 347 Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual Reading buffer where pulsed measurements will be stored; if this is nil when the function is buffer called, no measurements will be made when the pulse train is initiated Numeric identifier to be assigned to the defined pulse train Defines a digital I/O trigger input line;...
Page 348: Configpulseimeasurevsweeplin()
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference ConfigPulseIMeasureVSweepLin() This KIPulse factory script function configures a linear pulsed current sweep with a voltage measurement at each point. Type TSP-Link accessible Affected by Where saved...
Page 349 Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual Details Data for pulsed voltage measurements are stored in the reading buffer specified by the buffer input parameter. This function configures a linear pulsed current sweep with a voltage measurement at each point. Measurements are made at the end of the ton time.
Page 350: Configpulseimeasurevsweeplog()
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference 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...
Page 351 Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual Details Data for pulsed voltage measurements are stored in the reading buffer specified by the buffer input parameter. This function configures a logarithmic pulsed current sweep with a voltage measurement at each point.
Page 352: Configpulsevmeasurei()
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference ConfigPulseVMeasureI() This KIPulse factory script function configures a voltage pulse train with a current measurement at each point. Type TSP-Link accessible Affected by Where saved Default value...
Page 353 Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual Figure 112: ConfigPulseVMeasureI() level Measurement (1/NPLC seconds) bias toff Pulse initiated here Last source value before pulse train was initiated Example 1 ConfigPulseVMeasureI(smua, 0, 400, Set up a pulse train that uses System ®...
Page 354: Configpulsevmeasureisweeplin()
Model 2657A 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...
Page 355: Configpulsevmeasureisweeplog()
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual This function does not cause the specified smu to output a pulse train. It does check to see if all the pulse dimensions can be achieved, and if they can, assigns the indicated tag or index to the pulse train.
Page 356 Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Usage f, msg = ConfigPulseVMeasureISweepLog(smu, bias, start, stop, limit, ton, toff, points, buffer, tag, sync_in, sync_out, sync_in_timeout, sync_in_abort) f, msg = ConfigPulseVMeasureISweepLog(smu, bias, start, stop, limit, ton, toff,...
Page 357 Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual Details Data for pulsed current measurements are stored in the reading buffer specified by the buffer input parameter. This function configures a logarithmic pulsed voltage sweep with a current measurement at each point.
Page 358: Dataqueue.add()
Model 2657A 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)
Page 359: Dataqueue.clear()
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual Usage count = dataqueue.CAPACITY The variable assigned the value of dataqueue.CAPACITY count Details This constant always returns the maximum number of entries that can be stored in the data queue.
Page 360: Dataqueue.count
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference 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) Power cycle Not saved...
Page 361: Delay()
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual Details If the data queue is empty, the function waits up to the timeout value. If data is not available in the data queue before the timeout expires, the return value is nil.
Page 362: Digio.readbit()
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Example 1 beeper.beep(0.5, 2400) Emit a double-beep at 2400 Hz. The sequence is 0.5 s on, 0.25 s off, 0.5 s on. delay(0.250) beeper.beep(0.5, 2400) Example 2 dataqueue.clear()
Page 363: Digio.readport()
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual 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() The present value of the input lines on the digital I/O port...
Page 364: Digio.trigger[N].Clear()
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Also see digio.trigger[N].pulsewidth (on page 7-54) digio.trigger[N].clear() This function clears the trigger event on a digital I/O line. Type TSP-Link accessible Affected by Where saved Default value...
Page 365: Digio.trigger[N].Mode
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual Example 2 smua.trigger.arm.stimulus = Uses a trigger event on digital I/O trigger line 3 to be the trigger stimulus digio.trigger[3].EVENT_ID for the SMU. Also see None digio.trigger[N].mode...
Page 366: Digio.trigger[N].Overrun
Model 2657A 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.
Page 367: Digio.trigger[N].Pulsewidth
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual digio.trigger[N].pulsewidth This attribute describes the length of time that the trigger line is asserted for output triggers. Type TSP-Link accessible Affected by Where saved Default value...
Page 368: Digio.trigger[N].Reset()
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference digio.trigger[N].reset() This function resets trigger values to their factory defaults. Type TSP-Link accessible Affected by Where saved Default value Function Usage digio.trigger[N].reset() Digital I/O trigger line (1 to 14)
Page 369 Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual Usage triggerStimulus = digio.trigger[N].stimulus digio.trigger[N].stimulus = triggerStimulus The event identifier for the triggering event triggerStimulus Digital I/O trigger line (1 to 14) Details Set this attribute to zero (0) to disable the automatic trigger output.
Page 370: Digio.trigger[N].Wait()
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Example 2 digio.trigger[3].stimulus = Set the trigger stimulus of digital smua.trigger.SOURCE_COMPLETE_EVENT_ID I/O line 3 to be the source complete event. Also see digio.trigger[N].assert() (on page 7-50) digio.trigger[N].clear()
Page 371: Digio.writebit()
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual digio.writebit() This function sets a digital I/O line high or low. Type TSP-Link accessible Affected by Where saved Default value Function Usage digio.writebit(N, data) Digital I/O trigger line (1 to 14)
Page 372: Digio.writeprotect
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Details The binary representation of data indicates the output pattern to be written to the I/O port. For example, a data value of 170 has a binary equivalent of 00000010101010. Lines 2, 4, 6, and 8 are set high (1), and the other 10 lines are set low (0).
Page 373: Display.clear()
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual display.clear() This function clears all lines of the display. Type TSP-Link accessible Affected by Where saved Default value Function Usage display.clear() Details This function switches to the user screen and then clears the display.
Page 374 Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Details This function returns a bitmasked value showing which indicators are turned on. The 16-bit binary equivalent of the returned value is the bitmask. The return value is a sum of set annunciators, based on the weighted value, as shown in the following table.
Page 375: Display.getcursor()
Section 7: TSP command reference Model 2657A 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()
Page 376: Display.getlastkey()
Model 2657A 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() A returned value that represents the last front-panel key pressed;...
Page 377: Display.gettext()
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual Example key = display.getlastkey() On the front panel, press the MENU key and then send the code shown here. This retrieves print(key) the key code for the last pressed key.
Page 378: Display.inputvalue()
Model 2657A 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:...
Page 379 Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual Details The format parameter uses zeros (0), the decimal point, polarity sign, and exponents to define how the input field is formatted. The format parameter can include the options shown in the following table.
Page 380: Display.loadmenu.add()
Functions and variables need to be saved with the code. If the code is not saved in nonvolatile memory, it will be lost when the Model 2657A is turned off. See Example 2 below. If you do not make a selection for memory, the code is automatically saved to nonvolatile memory.
Page 381: Display.loadmenu.catalog()
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual Example 2 display.loadmenu.add( Assume a script with a function named “DUT1” has already been loaded into the "Test", "DUT1() beeper.beep(2, 500)", instrument, and the script has NOT been display.SAVE)
Page 382: Display.loadmenu.delete()
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Example for displayName, code in Output: display.loadmenu.catalog() do Test DUT1() beeper.beep(2, 500) print(displayName, code) Part1 testpart([[Part1]], 5.0) Test9 Test9() Also see display.loadmenu.add() (on page 7-67) display.loadmenu.delete() (on page 7-69) display.loadmenu.delete()
Page 383: Display.menu()
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual Details Set display.locallockout to display.LOCK to prevent the user from interrupting remote operation by pressing the EXIT (LOCAL) key. Set this attribute to display.UNLOCK to allow the EXIT (LOCAL) key to interrupt script or remote operation.
Page 384: Display.numpad
Model 2657A 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...
Page 385 Section 7: TSP command reference Model 2657A 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...
Page 386: Display.screen
Model 2657A 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...
Page 387: Display.setcursor()
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual Details This command simulates the pressing of a front panel key or navigation wheel, or the turning the navigation wheel one click to the left or right.
Page 388: Display.settext()
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Details Sending this command selects the user screen and then moves the cursor to the given location. The display.clear(), display.setcursor(), and display.settext() functions are overlapped commands. That is, the script does not wait for one of these commands to complete. These functions do not immediately update the display.
Page 389: Display.smux.digits
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual The character codes described in the following table can be also be included in the text string. Display character codes Character Code Description Newline, starts text on the next line; if the cursor is already on line 2, text will be ignored...
Page 390: Display.smux.limit.func
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Also see Display resolution (on page 3-69) display.smuX.limit.func This attribute specifies the type of limit value setting displayed. Type TSP-Link accessible Affected by Where saved Default value...
Page 391: Display.trigger.clear()
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual Usage func = display.smuX.measure.func display.smuX.measure.func = func One of the following values: func • 0 or display.MEASURE_DCAMPS: Selects current measurement function • 1 or display.MEASURE_DCVOLTS: Selects volts measurement function •...
Page 392: Display.trigger.event_Id
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference display.trigger.EVENT_ID This constant is the event ID of the event generated when the front-panel TRIG key is pressed. Type TSP-Link accessible Affected by Where saved Default value...
Page 393: Display.trigger.wait()
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual display.trigger.wait() This function waits for the TRIG key on the front panel to be pressed. Type TSP-Link accessible Affected by Where saved Default value Function Usage triggered = display.trigger.wait(timeout)
Page 394 Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Details After you send this function, script execution pauses until a front-panel action (for example, pressing a key or the navigation wheel , or turning the navigation wheel ).
Page 395: Errorqueue.clear()
Section 7: TSP command reference Model 2657A 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 See the Error queue (on page E-3) topic for additional information about the error queue.
Page 396 Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Usage errorCode, message, severity, errorNode = errorqueue.next() The error code number for the entry errorCode The message that describes the error code message The severity level (0, 10, 20, 30, or 40); see Details for more information...
Page 397: Eventlog.all()
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual eventlog.all() This function returns all entries from the event log as a single string and removes them from the event log. Type TSP-Link accessible Affected by...
Page 398: Eventlog.count
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Also see eventlog.all() (on page 7-84) eventlog.count (on page 7-85) eventlog.enable (on page 7-85) eventlog.next() (on page 7-86) eventlog.overwritemethod (on page 7-87) eventlog.count This attribute gets the number of events in the event log.
Page 399: Eventlog.next()
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual Example print(eventlog.enable) Displays the present status of the Model 2657A event log. eventlog.enable = eventlog.DISABLE print(eventlog.enable) Output: 1.00000e+00 0.00000e+00 Also see eventlog.all() (on page 7-84) eventlog.clear() (on page 7-84) eventlog.count...
Page 400: Eventlog.overwritemethod
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference eventlog.overwritemethod This attribute controls how the event log processes events if the event log is full. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW)
Page 401: Filevar:close()
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual fileVar:close() This function closes the file that is represented by the fileVar variable. Type TSP-Link accessible Affected by Where saved Default value Function Usage fileVar:close() The file descriptor variable to close...
Page 402: Filevar:read()
Model 2657A 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)
Page 403: Filevar:seek()
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual fileVar:seek() This function sets and gets a file's current position. Type TSP-Link accessible Affected by Where saved Default value Function Usage position, errorMsg = fileVar:seek() position, errorMsg = fileVar:seek(whence)
Page 404: Format.asciiprecision
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Details This function may buffer data until a flush (fileVar:flush() or io.flush()) or close (fileVar:close() or io.close()) operation is performed. Also see fileVar:close() (on page 7-88)
Page 405: Format.byteorder
Section 7: TSP command reference Model 2657A 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...
Page 406: Format.data
Model 2657A 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...
Page 407: Fs.chdir()
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual fs.chdir() This function sets the current working directory. Type TSP-Link accessible Affected by Where saved Default value Function Usage workingDirectory = fs.chdir(path) Returned value containing the working path...
Page 408: Fs.is_Dir()
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Usage status = fs.is_dir(path) Whether or not the given path is a directory (true or false) status The path of the file system entry to test...
Page 409: Fs.readdir()
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual 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)
Page 410: Gettimezone()
Model 2657A 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() The local timezone of the instrument...
Page 411: Gm_Vsweep()
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual Details Output data includes transconductance values, reading buffer with measured voltages, reading buffer with measured voltages and currents. If all parameters are omitted when this function is called, this function is executed with the parameters set to the default values.
Page 412: Gpib.address
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Example gm_array = gm_vsweep(smua, 0, 10, 5) SMU A returns Gm values only. gm_array, ibuf = gm_vsweep(smua, 0, 10, 5) SMU A returns Gm and reading buffer with measured currents.
Page 413 Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual i_leakage_measure() This KIHighC factory script function performs a current leakage measurement after stepping the output voltage. Type TSP-Link accessible Affected by Where saved Default value Function...
Page 414 Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference i_leakage_threshold() This KIHighC factory script function measures the current and compares it to a threshold. Type TSP-Link accessible Affected by Where saved Default value Function Usage...
Page 415: I_Leakage_Measure()
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual Example smua.source.highc = smua.ENABLE Enable high-capacitance mode. smua.source.levelv = 500 Charge the capacitor (500 V for 1 second). smua.source.output = smua.OUTPUT_ON delay(1) pass = i_leakage_threshold(smua, 0, 20e-3,...
Page 416: Io.close()
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Details This function only initiates configured pulse trains assigned to a valid tag. Configure the pulse before initiating it using one of the ConfigurePulse* functions (refer to the Also see section).
Page 417: Io.flush()
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual Details If a file is not specified, the default output file closes. Only io.close(), used without specifying a parameter, can be accessed from a remote node.
Page 418: Io.open()
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Usage fileVar = io.input() fileVar = io.input(newfile) The descriptor of the input file or an error message (if the function fails) fileVar A string representing the path of a file to open as the default input file, or the...
Page 419: Io.output()
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual io.output() This function assigns a previously opened file or opens a new file as the default output file. Type TSP-Link accessible Affected by Where saved Default value...
Page 420: Io.type()
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Details The format parameters may be any of the following: Format parameter Description "*N" Returns a number "*a" Returns the whole file, starting at the present position; returns an empty string if it is at the end of file "*l"...
Page 421: Lan.applysettings()
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual Usage io.write() io.write(data1) io.write(data1, data2) io.write(data1, ..., dataN) The data to be written data1 The data to be written data2 The data to be written dataN...
Page 422: Lan.autoconnect
Model 2657A 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)
Page 423: Lan.config.dns.domain
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual Example dnsaddress = "164.109.48.173" Configure DNS address 1 to "164.109.48.173" lan.config.dns.address[1] = dnsaddress Also see lan.config.dns.domain (on page 7-110) lan.config.dns.dynamic (on page 7-110) lan.config.dns.hostname (on page 7-111) lan.config.dns.verify...
Page 424: Lan.config.dns.hostname
<serial number> are replaced with the actual model number and serial number of the instrument (for example, "k-2657A-1234567"). Note that hyphens separate the characters of hostName. The length of the fully qualified host name (combined length of the domain and host name with separator characters) must be less than or equal to 255 characters.
Page 425: Lan.config.dns.verify
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual Example print(lan.config.dns.hostname) Outputs the present dynamic DNS host name. Also see lan.config.dns.dynamic (on page 7-110) lan.restoredefaults() (on page 7-118) lan.config.dns.verify This attribute defines the DNS host name verification state.
Page 426: Lan.config.gateway
Model 2657A 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. Also see lan.restoredefaults()
Page 427: Lan.config.method
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual Usage ipAddress = lan.config.ipaddress lan.config.ipaddress = ipAddress LAN IP address; must be a string specifying the IP address in dotted decimal ipAddress notation This attribute specifies the LAN IP address to use when the LAN is configured using the manual configuration method.
Page 428: Lan.config.speed
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference 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...
Page 429: Lan.linktimeout
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual Also see lan.restoredefaults() (on page 7-118) lan.status.subnetmask (on page 7-124) lan.linktimeout This attribute contains the LAN link timeout period. Type TSP-Link accessible Affected by Where saved...
Page 430: Lan.lxidomain
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference lan.lxidomain This attribute contains the LXI domain. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) LAN restore defaults Nonvolatile memory Usage domain = lan.lxidomain lan.lxidomain = domain...
Page 431: Lan.reset()
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual lan.reset() This function resets the LAN interface. Type TSP-Link accessible Affected by Where saved Default value Function Usage lan.reset() Details This function resets the LAN interface. It performs the commands lan.restoredefaults() and lan.applysettings().
Page 432: Lan.status.dns.address[N]
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference This command is run when lan.reset() is sent. Example lan.restoredefaults() Restores the LAN defaults. Also see lan.reset() (on page 7-118) localnode.password (on page 7-136) lan.status.dns.address[N] This attribute contains the DNS server IP addresses.
Page 433: Lan.status.duplex
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual Details A fully qualified domain name (FQDN), sometimes referred to as an absolute domain name, is a domain name that specifies its exact location in the tree hierarchy of the Domain Name System (DNS).
Page 434: Lan.status.ipaddress
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Example print(lan.status.gateway) Outputs the gateway address, such as: 192.168.0.1 Also see lan.config.gateway (on page 7-113) lan.status.ipaddress This attribute contains the LAN IP address presently in use by the LAN interface.
Page 435: Lan.status.port.dst
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual Also see None 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...
Page 436: Lan.status.port.telnet
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference lan.status.port.telnet This attribute contains the LAN Telnet connection port number. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Not applicable Not applicable Not applicable Usage port = lan.status.port.telnet...
Page 437: Lan.status.speed
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual lan.status.speed This attribute contains the LAN speed. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Not applicable Not applicable Not applicable Usage speed = lan.status.speed...
Page 438: Lan.timedwait
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference lan.timedwait This attribute contains the LAN timed-wait state interval. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) LAN restore defaults Nonvolatile memory 20 (20 s) Usage timeout = lan.timedwait...
Page 439: Lan.trigger[N].Clear()
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual Also see lan.lxidomain (on page 7-117) lan.trigger[N].clear() (on page 7-126) lan.trigger[N].mode (on page 7-130) lan.trigger[N].overrun (on page 7-131) lan.trigger[N].stimulus (on page 7-132) lan.trigger[N].wait() (on page 7-134)
Page 440: Lan.trigger[N].Connect()
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference lan.trigger[N].connect() This function prepares the event generator for outgoing trigger events. Type TSP-Link accessible Affected by Where saved Default value Function Usage lan.trigger[N].connect() The LAN event number (1 to 8) Details Prepares the event generator to send event messages.
Page 441: Lan.trigger[N].Disconnect()
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual Details This read-only attribute is set to true when the LAN trigger is connected and ready to send trigger events following a successful lan.trigger[N].connect() command; if the LAN trigger is not ready to send trigger events, this value is false.
Page 442: Lan.trigger[N].Ipaddress
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Details Set the stimulus of any trigger event detector to the value of this constant to have it respond to incoming LAN trigger packets. Example digio.trigger[14].stimulus = Route occurrences of triggers lan.trigger[1].EVENT_ID...
Page 443: Lan.trigger[N].Mode
Use of either lan.TRIG_SYNCHRONOUSA or lan.TRIG_SYNCHRONOUSM over lan.TRIG_SYNCHRONOUS is preferred, as lan.TRIG_SYNCHRONOUS is provided for compatibility with other Keithley Instruments products. Example print(lan.trigger[1].mode) Outputs the present LAN trigger mode of LAN event 1.
Page 444: Lan.trigger[N].Overrun
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference lan.trigger[N].overrun This attribute contains the event detector's overrun status. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) LAN trigger N clear Not applicable...
Page 445: Lan.trigger[N].Pseudostate
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual Details The LAN trigger listens for trigger messages on all supported protocols, but uses the designated protocol for sending outgoing messages. After changing this setting, lan.trigger[N].connect() must be called before outgoing event messages can be sent.
Page 446 Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Usage triggerStimulus = lan.trigger[N].stimulus lan.trigger[N].stimulus = triggerStimulus The LAN event identifier used to trigger the event triggerStimulus A number specifying the trigger packet over the LAN for which to set or query...
Page 447: Lan.trigger[N].Wait()
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual Also see lan.trigger[N].assert() (on page 7-125) lan.trigger[N].clear() (on page 7-126) lan.trigger[N].connect() (on page 7-127) lan.trigger[N].overrun (on page 7-131) lan.trigger[N].wait() (on page 7-134) lan.trigger[N].wait() This function waits for an input trigger.
Page 448: Localnode.linefreq
<model number> and <serial number> are replaced with the actual model number and serial number of the instrument (for example, "Keithley Instruments SMU 2657A - 1349810"). Setting this attribute to an empty string (in other words, setting this attribute to a string of length zero, or one consisting entirely of whitespace characters) will revert the description to the factory default value.
Page 449: Localnode.model
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual localnode.model This attribute stores the model number. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Not applicable Not applicable Not applicable Usage model = localnode.model...
Page 450: Localnode.passwordmode
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Example localnode.password = "N3wpa55w0rd" Changes the remote interface password to N3wpa55w0rd. Also see lan.reset() (on page 7-118) localnode.passwordmode (on page 7-137) localnode.passwordmode This attribute stores the remote access password enable mode.
Page 451: Localnode.prompts4882
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual Details The command messages do not generate prompts. The instrument generates prompts in response to command messages. When the prompting mode is enabled (set to 1), the instrument generates prompts in response to command messages.
Page 452: Localnode.reset()
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Details When set to 1, the IEEE Std 488.2 common commands generate prompts if prompting is enabled with the localnode.prompts attribute. If set to 1, limit the number of *trg commands sent to a running script to 50 regardless of the setting of the localnode.prompts attribute.
Page 453: Localnode.serialno
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual Usage revision = localnode.revision Firmware revision level revision Details This attribute indicates the revision number of the firmware that is presently running in the instrument. When using this command from a remote node, localnode should be replaced with the node reference. For example, node[5].revision.
Page 454: Localnode.showerrors
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference localnode.showerrors This attribute sets whether or not the instrument automatically sends generated errors. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Power cycle...
Page 455: Makesetter()
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual Details This function is useful for aliasing attributes to improve execution speed. Calling the function created with makegetter() executes faster than accessing the attribute directly. Creating a getter function is only useful if it is going to be called several times. Otherwise, the overhead of creating the getter function outweighs the overhead of accessing the attribute directly.
Page 456: Meminfo()
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference 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...
Page 457: Node[N].Execute()
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual node[N].execute() This function starts test scripts from a remote node. Type TSP-Link accessible Affected by Where saved Default value Function Yes (see Details) Usage node[N].execute(scriptCode) The node number of this instrument...
Page 458: Node[N].Setglobal()
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Details This function retrieves the value of a global variable from the run-time environment of this node. Do not use this command to retrieve the value of a global variable from the local node. Instead, access the global variable directly.
Page 459: Opc()
Section 7: TSP command reference Model 2657A 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...
Page 460: Os.rename()
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference os.rename() This function renames an existing file or directory. Type TSP-Link accessible Affected by Where saved Default value Function Usage success, msg = os.rename(oldname, newname) A success indicator (true or nil)
Page 461: Print()
Section 7: TSP command reference Model 2657A 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)
Page 462: Printbuffer()
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Example 1 x = 10 Example of an output response message: print(x) 1.00000e+01 Note that your output might be different if you set your ASCII precision setting to a different value.
Page 463: Printnumber()
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual Example format.data = format.ASCII format.asciiprecision = 6 printbuffer(1, rb1.n, rb1) This assumes that rb1 is a valid reading buffer in the run-time environment. The use of rb1.n (bufferVar.n) indicates that the instrument should output all readings in the reading buffer.
Page 464: Pulseimeasurev()
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Example format.asciiprecision = 10 Configure the ASCII precision to 10 and set x to x = 2.54 2.54. printnumber(x) Read the value of x based on these settings.
Page 465: Pulsevmeasurei()
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual Figure 115: PulseIMeasureV Voltage measurement level bias bias toff toff Example PulseIMeasureV(smua, 0.001, 0.01, SMU A outputs 1 mA and dwells for 40 ms, outputs 10 mA and dwells for 20 ms. The voltage 20e-3, 40e-3, 10) measurements occur during each 20 ms dwell period.
Page 466: Querypulseconfig()
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Details If any parameters are omitted or nil, the operator is prompted to enter them using the front panel. Data for pulsed current measurements, voltage levels, and timestamps are stored in smuX.nvbuffer1.
Page 467 Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual Details Once a pulse train has been configured and assigned to a tag, it is often desirable to inspect the settings of this preconfigured pulse train. The QueryPulseConfig() command can be used for this purpose.
Page 468: Reset()
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Example smua.reset() Configure channel A to generate a pulse train, query configuration, and then display as a string. The following output indicates that Channel A will smua.source.rangev = 500...
Page 469: Savebuffer()
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual Details The reset() command in its simplest form resets the entire TSP-enabled system, including the controlling node and all subordinate nodes. If you want to reset a specific instrument, use either the localnode.reset() or node[X].reset() command.
Page 470: Script.anonymous
Model 2657A 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...
Page 471: Script.delete()
Section 7: TSP command reference Model 2657A 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) The string that represents the name of the script...
Page 472: Script.load()
Model 2657A 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) The created script;...
Page 473: Script.new()
Section 7: TSP command reference Model 2657A 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) The name of the variable that will reference the script...
Page 474: Script.newautorun()
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference script.newautorun() This function is identical to the script.new() function, but it creates a script with the autorun attribute set to "yes". Type TSP-Link accessible Affected by...
Page 475: Script.run()
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual Details This command copies the script from nonvolatile memory into the run-time environment. It also creates a global variable with the same name as the name of the script.
Page 476: Script.user.catalog()
Model 2657A 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...
Page 477: Scriptvar.list()
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual NOTE Make sure to save the script in nonvolatile memory after setting the autorun attribute so that the instrument will retain the setting. Example test5.autorun = "yes"...
Page 478: Scriptvar.name
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference scriptVar.name This attribute contains the name of a script in the run-time environment. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Not applicable...
Page 479: Scriptvar.run()
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual scriptVar.run() This function runs a script. Type TSP-Link accessible Affected by Where saved Default value Function Usage scriptVar.run() scriptVar() The name of the variable that references the script...
Page 480: Scriptvar.save()
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference 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()
Page 481: Serial.baud
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual Details The loadscript or loadandrunscript and endscript keywords are not included in the source code. The body of the script is a single string with lines separated by the new line character.
Page 482: Serial.databits
Model 2657A 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...
Page 483: Serial.parity
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual Details A new flow control setting takes effect when the command to change it is processed. NOTE Allow ample time for the command to be processed before attempting to communicate with the instrument again.
Page 484: Serial.read()
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Also see RS-232 interface operation (on page 2-88) serial.baud (on page 7-168) serial.databits (on page 7-169) serial.flowcontrol (on page 7-169) serial.read() This function reads available characters (data) from the serial port.
Page 485: Settime()
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual Details This function writes the specified string to the serial port, where it can be read by connected equipment (for example, a component handler). No terminator characters are added to the data, and data is written exactly as specified by the data parameter.
Page 486: Settimezone()
Model 2657A 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) String representing offset from UTC...
Page 487: Setup.poweron
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual Example settimezone("8", "1", "3.3.0/02", "11.2.0/02") Sets offset to equal +8 hours, +1 hour for DST, starts on Mar 14 at 2:00 a.m, ends on Nov 7 at 2:00 a.m.
Page 488: Setup.recall()
Model 2657A 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 489: Smux.abort()
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual Details When the id parameter is an integer (n), it is interpreted as the setup number to save to the instrument's nonvolatile memory. NOTE When you save to a specified integer (1 to 5) in nonvolatile memory, the previous setup at that same location is overwritten.
Page 490: Smux.buffer.getstats()
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference smuX.buffer.getstats() This function returns a specified reading buffer's statistics. Type TSP-Link accessible Affected by Where saved Default value Function Usage statistics = smuX.buffer.getstats(bufferVar) The statistical data about the data in the reading buffer statistics Source-measure unit (SMU) channel (for example, smua.buffer.getstats()
Page 491: Smux.buffer.recalculatestats()
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual Also see smuX.buffer.recalculatestats() (on page 7-178) smuX.buffer.recalculatestats() This function recalculates the specified reading buffer's statistics. Type TSP-Link accessible Affected by Where saved Default value Function Usage smuX.buffer.recalculatestats(bufferVar)
Page 492: Smux.cal.date
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Details This attribute stores the adjustment date associated with the active calibration set. The adjustment date can be read at any time, but can only be assigned a new value when calibration has been enabled with the smuX.cal.unlock() function.
Page 493: Smux.cal.due
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual Details This attribute stores the calibration date that is associated with the active calibration set. The calibration date can be read at any time but can only be assigned a new value when calibration has been enabled with the smuX.cal.unlock() function.
Page 494: Smux.cal.fastadc()
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Example smua.cal.due = os.time() + 365 * 24 * 60 * 60 Sets the SMU channel A calibration due date equal to one year from the current time set on the instrument.
Page 495: Smux.cal.ovp()
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual Details This function disables functions that can change calibration settings. Before you can lock calibration, the calibration constants must be written to nonvolatile memory or a previous calibration set must be restored. Error code 5012, "Cal data not saved - save or restore before lock,"...
Page 496: Smux.cal.polarity
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Usage smuX.cal.password = newPassword SMU channel (for example, smua.cal.password applies to SMU channel A) The new password (string) newPassword Details A new password can only be assigned when calibration has been unlocked.
Page 497: Smux.cal.restore()
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual Example smua.cal.polarity = smua.CAL_POSITIVE Selects positive calibration constants for all subsequent measurements on SMU channel A. Also see Adjustment (on page B-14) reset() (on page 7-155) smuX.cal.lock()
Page 498: Smux.cal.save()
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference smuX.cal.save() This function stores the active calibration constants to nonvolatile memory. Type TSP-Link accessible Affected by Where saved Default value Function Usage smuX.cal.save() Source-measure unit (SMU) channel (for example, smua.cal.save() applies to...
Page 499: Smux.cal.unlock()
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual Usage calState = smuX.cal.state The present calibration state; when reading this attribute, calState has one of the calState following values: 0 or smuX.CALSTATE_LOCKED: Calibration is locked 1 or smuX.CALSTATE_CALIBRATING: The calibration constants or dates have...
Page 500: Smux.contact.calibratehi()
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Also see Adjustment (on page B-14) smuX.cal.lock() (on page 7-181) smuX.cal.password (on page 7-182) smuX.cal.state (on page 7-185) smuX.contact.calibratehi() This function calibrates the high/sense high contact check measurement.
Page 501: Smux.contact.calibratelo()
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual Also see Adjustment (on page B-14) smuX.cal.restore() (on page 7-184) smuX.cal.save() (on page 7-185) smuX.cal.unlock() (on page 7-186) smuX.contact.calibratelo() (on page 7-188) smuX.contact.calibratelo() This function calibrates the low/sense low contact check measurement.
Page 502: Smux.contact.check()
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Example -- Short SENSE LO and LO terminals Performs contact -- Short SENSE HI and HI terminals check on SMU -- Allow readings to settle, then get measurements channel A.
Page 503: Smux.contact.r()
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual Details This function returns true if the contact resistance is below the threshold; this function returns false if it is above the threshold. The threshold value is set by the smuX.contact.threshold attribute.
Page 504: Smux.contact.speed
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Details If you attempt to perform a contact resistance measurement when any of the following conditions exist, an error will be generated. When the output is on and any of the following: •...
Page 505: Smux.contact.threshold
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual Details This setting controls the aperture of measurements made for contact check. It does not affect the smuX.measure.nplc aperture setting. The speed setting can have a dramatic effect on the accuracy of the measurement (see specifications).
Page 506: Smux.makebuffer()
Model 2657A 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) The created reading buffer bufferVar Source-measure unit (SMU) channel (for example, smua.makebuffer() applies...
Page 507: Smux.measure.autorangey
Section 7: TSP command reference Model 2657A 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 508: Smux.measure.autozero
The time interval between updates to these reference measurements is determined by the integration aperture being used for measurements. The Model 2657A uses separate reference and zero measurements for each aperture.
Page 509: Smux.measure.calibratey()
The Model 2657A stores the reference measurements for the last ten NPLC settings that were used in a reference cache. If an NPLC setting is selected and an entry for it is not in the cache, the oldest (least recently used) entry is discarded to make room for the new entry.
Page 510: Smux.measure.count
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Details This function generates and activates new calibration constants for the given range. The positive and negative polarities of the instrument must be calibrated separately. Use a positive value for range to calibrate the positive polarity and a negative value for range to calibrate the negative polarity.
Page 511: Smux.measure.delay
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual Details This attribute controls the number of measurements taken any time a measurement is requested. When using a reading buffer with a measure command, this attribute also controls the number of readings to be stored.
Page 512: Smux.measure.delayfactor
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Also see Measure auto delay (on page 2-73) reset() (on page 7-155) smuX.measure.count (on page 7-197) smuX.measure.delayfactor (on page 7-199) smuX.source.delay (on page 7-215) smuX.reset() (on page 7-211) smuX.measure.delayfactor...
Page 513: Smux.measure.filter.enable
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual Usage filterCount = smuX.measure.filter.count smuX.measure.filter.count = filterCount The number of readings required for each filtered measurement (1 to 100) filterCount Source-measure unit (SMU) channel (for example, smua.measure.filter.count applies to SMU channel A)
Page 514: Smux.measure.filter.type
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Also see Filters (on page 3-2) reset() (on page 7-155) setup.recall() (on page 7-175) smuX.measure.filter.count (on page 7-199) smuX.measure.filter.type (on page 7-201) smuX.reset() (on page 7-211) smuX.measure.filter.type...
Page 515: Smux.measure.interval
Section 7: TSP command reference Model 2657A 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)
Page 516: Smux.measure.nplc
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Details This attribute is used with autoranging to put a lower bound on the range used. Since lower ranges generally require greater settling times, setting a lowest range limit might make measurements require less settling time.
Page 517: Smux.measure.overlappedy()
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual smuX.measure.overlappedY() This function starts an asynchronous (background) measurement. Type TSP-Link accessible Affected by Where saved Default value Function Usage smuX.measure.overlappedY(rbuffer) smuX.measure.overlappediv(ibuffer, vbuffer) Source-measure unit (SMU) channel (for example, smua.measure.overlappedv() applies to SMU channel A)
Page 518: Smux.measure.rel.enabley
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Usage rangeValue = smuX.measure.rangeY smuX.measure.rangeY = rangeValue Set to the maximum expected voltage or current to be measured rangeValue Source-measure unit (SMU) channel (for example, smua.measure.rangev...
Page 519 Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual Usage relEnable = smuX.measure.rel.enableY smuX.measure.rel.enableY = relEnable Relative measurement control. Set relEnable to one of the following values: relEnable 0 or smuX.REL_OFF: Disables relative measurements 1 or smuX.REL_ON: Enables relative measurements Source-measure unit (SMU) channel (for example, smua.measure.rel.enablev...
Page 520: Smux.measure.rel.levely
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference smuX.measure.rel.levelY This attribute sets the offset value for relative measurements. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Instrument reset Not saved SMU reset...
Page 521: Smux.measure.y()
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual smuX.measure.Y() This function makes one or more measurements. Type TSP-Link accessible Affected by Where saved Default value Function Usage reading = smuX.measure.Y() reading = smuX.measure.Y(readingBuffer) iReading, vReading = smuX.measure.iv() iReading, vReading = smuX.measure.iv(iReadingBuffer)
Page 522: Smux.measureyandstep()
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Also see Reading buffers (on page 3-6) smuX.measure.count (on page 7-197) smuX.measure.overlappedY() (on page 7-204) smuX.nvbufferY (on page 7-210) smuX.measureYandstep() This function performs one or two measurements and then steps the source.
Page 523: Smux.nvbuffery
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual Also see smuX.measure.autorangeY (on page 7-194) smuX.measure.Y() (on page 7-208) smuX.source.autorangeY (on page 7-212) smuX.trigger.source.limitY (on page 7-241) smuX.trigger.source.linearY() (on page 7-242) smuX.trigger.source.listY() (on page 7-243) smuX.trigger.source.logY()
Page 524: Smux.reset()
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference smuX.reset() This function turns off the output and resets the SMU to the default settings. Type TSP-Link accessible Affected by Where saved Default value Function Usage smuX.reset()
Page 525: Smux.sense
Section 7: TSP command reference Model 2657A 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)
Page 526: Smux.source.calibratey()
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Usage sourceAutorange = smuX.source.autorangeY smuX.source.autorangeY = sourceAutorange The state of the source autorange control. Set to one of the following: sourceAutorange 0 or smuX.AUTORANGE_OFF: Disables source autorange 1 or smuX.AUTORANGE_ON: Enables source autorange...
Page 527: Smux.source.compliance
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual Details This function generates and activates new calibration constants for the given range. The positive and negative polarities of the source must be calibrated separately. Use a positive value for range to calibrate the positive polarity and a negative value for range to calibrate the negative polarity.
Page 528: Smux.source.delay
(in seconds). Alternatively, set sDelay to smuX.DELAY_OFF or smuX.DELAY_AUTO. The smuX.DELAY_AUTO setting causes a range-dependent delay to be inserted when the source is changed. Range-dependent delays are based on the output settling time values as defined in the Model 2657A specifications.
Page 529: Smux.source.func
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual Example smua.source.delay = smua.DELAY_AUTO Sets the delay for SMU channel A to automatic (a range-dependent delay is inserted whenever the source is changed). Also see reset() (on page 7-155) smuX.measure.count...
Page 530: Smux.source.levely
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Usage highC = smuX.source.highc smuX.source.highc = highC The state of the high-capacitance mode; set to one of the following values: highC 0 or smuX.DISABLE: Disables high-capacitance mode 1 or smuX.ENABLE: Enables high-capacitance mode...
Page 531: Smux.source.limity
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual 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 532: Smux.source.lowrangey
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Details Use the smuX.source.limiti attribute to limit the current output of the voltage source. Use smuX.source.limitv to limit the voltage output of the current source. The SMU always uses autoranging for the limit setting.
Page 533: Smux.source.offfunc
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual Also see smuX.source.autorangeY (on page 7-212) smuX.source.offfunc This attribute sets the source function that is used (source 0 A or 0 V) when the output is turned off and the source-measure unit (SMU) is in normal output-off mode.
Page 534: Smux.source.offmode
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Usage sourceLimit = smuX.source.offlimitY smuX.source.offlimitY = sourceLimit Set to the limit to be used when the SMU is in normal output-off mode sourceLimit Source-measure unit (SMU) channel (for example, smua.source.offlimiti...
Page 535: Smux.source.output
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual Details Reading this attribute gives the output-off mode of the source. Setting this attribute configures the SMU output- off mode. The default sourceOffMode is smuX.OUTPUT_NORMAL. In this mode, the source function is configured according to the smuX.source.offfunc attribute.
Page 536: Smux.source.protectv
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Example smua.source.output = smua.OUTPUT_ON Turns on SMU channel A source output. Also see DUT test connections (on page 2-41) smuX.source.func (on page 7-216) smuX.source.offmode (on page 7-221) smuX.source.protectv...
Page 537: Smux.source.rangey
Section 7: TSP command reference Model 2657A 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 Current: 1e-9 (1 nA)
Page 538: Smux.source.sink
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Usage settleOption = smuX.source.settling smuX.source.settling = settleOption Set to the source settling mode. Set to one of the following values: settleOption 0 or smuX.SETTLE_SMOOTH: Turns off additional settling operations (default) 1 or smuX.SETTLE_FAST_RANGE: Instructs the source-measure unit (SMU) to use...
Page 539: Smux.trigger.arm.count
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual Example smua.source.sink = smua.ENABLE Enables sink mode for SMU channel A. Also see Source or sink (on page 4-4) smuX.trigger.arm.count This attribute sets the arm count in the trigger model.
Page 540: Smux.trigger.arm.stimulus
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Details The SMU will automatically clear all the event detectors when the smuX.trigger.initiate() function is executed. This function should be called after the sweep is initiated.
Page 541 Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual Details Set this attribute to the event ID of any trigger event generator to wait for that event. Set this attribute to zero to bypass waiting for events at the arm event detector (the SMU continues uninterrupted through the remote trigger model).
Page 542: Smux.trigger.armed_Event_Id
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Usage eventID = smuX.trigger.ARMED_EVENT_ID The armed event number eventID Source-measure unit (SMU) channel (for example, smua.trigger.ARMED_EVENT_ID applies to SMU channel A) Details Set the stimulus of any trigger object to the value of this constant to have the trigger object respond to armed events from this SMU.
Page 543: Smux.trigger.count
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual smuX.trigger.count This attribute sets the trigger count in the trigger model. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) SMU reset Not saved...
Page 544: Smux.trigger.endpulse.set()
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Example smua.trigger.endpulse.action = Configure the end pulse action to achieve a smua.SOURCE_IDLE pulse and configure trigger timer 1 to control the end of pulse. smua.trigger.endpulse.stimulus = trigger.timer[1].EVENT_ID...
Page 545 Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual Details Set this attribute to the event ID of any trigger event generator to wait for that event. To bypass waiting for an event, set this attribute's value to 0. Set eventID to one of the existing trigger event IDs, which are shown in the following table.
Page 546: Smux.trigger.endsweep.action
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference smuX.trigger.endsweep.action This attribute sets the action of the source at the end of a sweep. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW)
Page 547: Smux.trigger.initiate()
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual Example trigger.timer[1].stimulus = smua.trigger.IDLE_EVENT_ID Trigger timer 1 when the SMU returns to the idle layer. Also see Triggering (on page 3-31) smuX.trigger.initiate() This function initiates a sweep operation.
Page 548: Smux.trigger.measure.action
Model 2657A 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)
Page 549: Smux.trigger.measure.stimulus
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual Details This function is useful whenever you want the SMU to continue operation without waiting for a programmed trigger event. When called, this function immediately satisfies the event detector, allowing the SMU to continue through the trigger model.
Page 550 Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Details Set this attribute to the event ID of any trigger event generator to wait for that event. When set, the SMU waits for the event at the measurement event detector portion of the trigger model.
Page 551: Smux.trigger.measure.y()
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual smuX.trigger.measure.Y() This function configures the measurements that are to be made in a subsequent sweep. Type TSP-Link accessible Affected by Where saved Default value Function Usage smuX.trigger.measure.Y(rbuffer)
Page 552: Smux.trigger.pulse_Complete_Event_Id
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Usage eventID = smuX.trigger.MEASURE_COMPLETE_EVENT_ID The measurement complete event number eventID Source-measure unit (SMU) channel (for example, smua.trigger.MEASURE_COMPLETE_EVENT_ID applies to SMU channel A) Details Set the stimulus of any trigger object to the value of this constant to have the trigger object respond to measure complete events from this SMU.
Page 553: Smux.trigger.source.action
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual smuX.trigger.source.action This attribute enables or disables sweeping the source (on or off). Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) SMU reset Not saved 0 (smuX.DISABLE)
Page 554: Smux.trigger.source.limity
Model 2657A 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...
Page 555: Smux.trigger.source.lineary()
Section 7: TSP command reference Model 2657A 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) Source-measure unit (SMU) channel (for example, smua.trigger.source.linearv(0, 10, 11) applies to SMU channel A)
Page 556: Smux.trigger.source.listy()
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference smuX.trigger.source.listY() This function configures an array-based source sweep. Type TSP-Link accessible Affected by Where saved Default value Function Usage smuX.trigger.source.listY(sweepList) Source-measure unit (SMU) channel (for example, smua.trigger.source.listv({5}) applies to SMU channel A)
Page 557: Smux.trigger.source.logy()
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual smuX.trigger.source.logY() This function configures an exponential (geometric) source sweep. Type TSP-Link accessible Affected by Where saved Default value Function Usage smuX.trigger.source.logY(startValue, endValue, points, asymptote) Source-measure unit (SMU) channel (for example, smua.trigger.source.logv(1,...
Page 558: Smux.trigger.source.set()
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Also see smuX.trigger.source.action (on page 7-240) smuX.trigger.source.linearY() (on page 7-242) smuX.trigger.source.listY() (on page 7-243) Sweep operation (on page 3-19) smuX.trigger.source.set() This function sets the source event detector to the detected state.
Page 559: Smux.trigger.source_Complete_Event_Id
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual Details Set this attribute to the event ID of any trigger event generator to wait for that event. When set, the SMU waits for the event at the source event detector portion of the trigger model. To bypass waiting for an event, set this attribute's value to zero (0).
Page 560: Smux.trigger.sweep_Complete_Event_Id
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Usage eventID = smuX.trigger.SOURCE_COMPLETE_EVENT_ID The source action complete event number eventID Source-measure unit (SMU) channel (for example, smua.trigger.SOURCE_COMPLETE_EVENT_ID applies to SMU channel A) Details Set the stimulus of any trigger object to the value of this constant to have the trigger object respond to source complete events from this source-measure unit (SMU).
Page 561: Status.condition
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual Also see Triggering (on page 3-31) status.condition This attribute stores the status byte condition register. Type TSP-Link accessible Affected by Where saved Default value Attribute (R)
Page 562 Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference The individual bits of this register have the following meanings: Value Description status.MEASUREMENT_SUMMARY_BIT Set summary bit indicates that an enabled measurement event has occurred. status.MSB Bit B0 decimal value: 1 status.SYSTEM_SUMMARY_BIT...
Page 563: Status.measurement
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual Also see Status byte and service request (SRQ) (on page E-15) status.measurement.* This attribute contains the measurement event register set. Type TSP-Link accessible Affected by Where saved...
Page 564: Status.measurement.buffer_Available
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Value Description Set bit is a summary of the status.measurement.VOLTAGE_LIMIT status.measurement.voltage_limit register. status.measurement.VLMT Bit B0 decimal value: 1 status.measurement.CURRENT_LIMIT Set bit is a summary of the status.measurement.current_limit register.
Page 565 Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual status.measurement.buffer_available.* This attribute contains the measurement event buffer available summary register set. Type TSP-Link accessible Affected by Where saved Default value Attribute .condition (R) Not applicable...
Page 566: Status.measurement.current_Limit
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Also see Measurement event registers (on page E-8) status.measurement.current_limit.* This attribute contains the measurement event current limit summary registers. Type TSP-Link accessible Affected by Where saved...
Page 567: Status.measurement.instrument
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual Example status.measurement.current_limit.enable = Sets the SMUA bit of the Measurement Event Current Limit status.measurement.current_limit.SMUA Summary Enable Register. Also see Measurement event registers (on page E-8) status.measurement.instrument.smuX.* (on page 7-255) status.measurement.instrument.*...
Page 568: Status.measurement.instrument.smux
Model 2657A 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...
Page 569 Section 7: TSP command reference Model 2657A 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 570: Status.measurement.overvoltage
Model 2657A 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 measurement event SMU A status.measurement.instrument.smua.VLMT...
Page 571 Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual Usage measurementRegister = status.measurement.overvoltage.condition measurementRegister = status.measurement.overvoltage.enable measurementRegister = status.measurement.overvoltage.event measurementRegister = status.measurement.overvoltage.ntr measurementRegister = status.measurement.overvoltage.ptr status.measurement.overvoltage.enable = measurementRegister status.measurement.overvoltage.ntr = measurementRegister status.measurement.overvoltage.ptr = measurementRegister The status of the measurement overvoltage summary register; a zero (0) measurementRegister indicates no bits set (also send 0 to clear all bits);...
Page 572: Status.measurement.reading_Overflow
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference status.measurement.reading_overflow.* This attribute contains the measurement event reading overflow summary register set. Type TSP-Link accessible Affected by Where saved Default value Attribute .condition (R) Not applicable...
Page 573: Status.measurement.sink_Limit.*
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual Also see Measurement event registers (on page E-8) status.measurement.sink_limit.* This attribute contains the measurement sink limit summary register set. Type TSP-Link accessible Affected by Where saved...
Page 574: Status.measurement.voltage_Limit
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Example status.measurement.sink_limit.enable = Sets the SMU A bit of the measurement sink limit summary status.measurement.sink_limit.SMUA enable register using a constant. Also see Measurement event registers (on page E-8) status.measurement.voltage_limit.*...
Page 575: Status.node_Enable
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual Value Description Not used Not applicable. status.measurement.voltage_limit.SMUA Set bit indicates that the voltage limit was exceeded. Bit B1 decimal value: 2 Binary value: 0000 0010 B2-B15 Not used Not applicable.
Page 576 Model 2657A 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 page E-1) and Enable and transition registers (on page E-19). The individual bits of this register are defined in the following table.
Page 577: Status.node_Event
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual status.node_event This attribute stores the status node event register. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Not applicable Not saved Usage nodeEventRegister = status.node_event The status of the node event register;...
Page 578: Status.operation
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference In addition to the above constants, nodeEventRegister can be set to the decimal equivalent of the bits set. When more than one bit of the register is set, nodeEventRegister contains the sum of their decimal weights.
Page 579 Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual Details These attributes read or write the operation status registers. Reading a status register returns a value. The binary equivalent of the returned value indicates which register bits are set.
Page 580: Status.operation.calibrating
Model 2657A 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 1 operationRegister = status.operation.USER + Sets the USER and PROG bits of the operation status enable register using status.operation.PROG...
Page 581: Status.operation.instrument
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual Details These attributes are used to read or write to the operation status calibration summary registers. Reading a status register returns a value. The binary equivalent of the returned value indicates which register bits are set. The least significant bit of the binary number is bit B0, and the most significant bit is bit B15.
Page 582 Model 2657A 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 instrument summary registers. Reading a status register returns a value. The binary equivalent of the returned value indicates which register bits are set. The least significant bit of the binary number is bit B0, and the most significant bit is bit B15.
Page 583: Status.operation.instrument.digio
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual Binary value Decimal Weights Binary value Decimal 32,768 16,384 8,192 4,096 2,048 1,024 Weights Example 1 operationRegister = status.operation.instrument.SMUA + Sets bit B1 and bit B10 of the operation status instrument status.operation.instrument.TRGBLND...
Page 584: Status.operation.instrument.digio.trigger_Overrun
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Usage operationRegister = status.operation.instrument.digio.condition operationRegister = status.operation.instrument.digio.enable operationRegister = status.operation.instrument.digio.event operationRegister = status.operation.instrument.digio.ntr operationRegister = status.operation.instrument.digio.ptr status.operation.instrument.digio.enable = operationRegister status.operation.instrument.digio.ntr = operationRegister status.operation.instrument.digio.ptr = operationRegister The status of the operation status digital I/O summary register; a zero (0) indicates operationRegister no bits set (also send 0 to clear all bits);...
Page 585 Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual status.operation.instrument.digio.trigger_overrun.* This attribute contains the operation status digital I/O overrun register set. Type TSP-Link accessible Affected by Where saved Default value Attribute .condition (R) Not applicable...
Page 586 Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference A set bit indicates that the specified digital I/O line generated an action overrun when it was triggered to generate an output trigger. For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to...
Page 587: Status.operation.instrument.lan
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual status.operation.instrument.lan.* This attribute contains the operation status LAN summary register set. Type TSP-Link accessible Affected by Where saved Default value Attribute .condition (R) Not applicable Not saved Not applicable .enable (RW)
Page 588: Status.operation.instrument.lan.trigger_Overrun
Model 2657A 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 page E-1) and Enable and transition registers (on page E-19). The individual bits of this register are defined in the following table.
Page 589 Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual status.operation.instrument.lan.trigger_overrun.* This attribute contains the operation status LAN trigger overrun register set. Type TSP-Link accessible Affected by Where saved Default value Attribute .condition (R) Not applicable...
Page 590 Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference A set bit indicates that the specified LAN trigger generated an action overrun when triggered to generate a trigger packet. For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to...
Page 591: Status.operation.instrument.smux
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual status.operation.instrument.smuX.* This attribute contains the operation status SMU X summary register set. Type TSP-Link accessible Affected by Where saved Default value Attribute .condition (R) Not applicable...
Page 592: Status.operation.instrument.smux.trigger_Overrrun
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Value Description status.operation.instrument.smuX.CALIBRATING Set bit indicates that smuX is unlocked for status.operation.instrument.smuX.CAL calibration. Bit B0 decimal value: 1 B1-B2 Not used Not applicable. status.operation.instrument.smuX.SWEEPING Set bit indicates that smuX is sweeping.
Page 593 Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual status.operation.instrument.smuX.trigger_overrrun.* This attribute contains the operation status SMU X trigger overrun register set. Type TSP-Link accessible Affected by Where saved Default value Attribute .condition (R) Not applicable...
Page 594 Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Value Description Not used Not applicable. 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.
Page 595: Status.operation.instrument.trigger_Blender
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual status.operation.instrument.trigger_blender.* This attribute contains the operation status trigger blender summary register set. Type TSP-Link accessible Affected by Where saved Default value Attribute .condition (R) Not applicable...
Page 596: Status.operation.instrument.trigger_Blender.trigger_Overrun
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference In addition to the above constants, operationRegister can be set to the numeric equivalent of the bit to set. For example, to set bit B10, set operationRegister to 1024.
Page 597 Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual Details These attributes are used to read or write to the operation status trigger blender overrun registers. Reading a status register returns a value. The binary equivalent of the returned value indicates which register bits are set.
Page 598: Status.operation.instrument.trigger_Timer
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Binary value Decimal 32,768 16,384 8,192 4,096 2,048 1,024 Weights Example status.operation.instrument.trigger_blender.trigger_overrun.enable = status.operation.instrument.trigger_blender.trigger_overrun.BLND1 Uses a constant to set the bit for blender 1 of the operation status trigger blender overrun enable register.
Page 599: Status.operation.instrument.trigger_Timer.trigger_Overrun
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual Value Description B0-B9 Not used Not applicable status.operation.instrument.trigger_timer.TRIGGER_OVERRUN Set bit indicates one status.operation.instrument.trigger_timer.TRGOVR or more enabled bits for the operation status trigger timer overrun register is set.
Page 600 Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference status.operation.instrument.trigger_timer.trigger_overrun.* This attribute contains the operation status trigger timer overrun register set. Type TSP-Link accessible Affected by Where saved Default value Attribute .condition (R) Not applicable...
Page 601 Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual A set bit indicates the specified timer generated an action overrun because it was still processing a delay from a previous trigger when a new trigger was received.
Page 602: Status.operation.instrument.tsplink
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Also see Operation Status Registers (on page E-9) status.operation.instrument.trigger_timer.* (on page 7-285) status.operation.instrument.tsplink.* This attribute contains the operation status TSP-Link summary register set. Type TSP-Link accessible...
Page 603: Status.operation.instrument.tsplink.trigger_Overrun
Section 7: TSP command reference Model 2657A 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. For example, to set bit B10, set operationRegister to 1024.
Page 604 Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference A set bit indicates that the specified line generated an action overrun when triggered to generate an output trigger. For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to...
Page 605: Status.operation.measuring
Section 7: TSP command reference Model 2657A 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)
Page 606: Status.operation.remote
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference status.operation.remote.* This attribute contains the operation status remote 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 607: Status.operation.sweeping
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual As an example, to set bit B1 of the operation status remote summary enable register, set status.operation.remote.enable = status.operation.remote.CAV. In addition to the above constants, operationRegister can be set to the numeric equivalent of the bit to set.
Page 608: Status.operation.trigger_Overrun
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Value Description Not used Not applicable. status.operation.sweeping.SMUA Set bit indicates that SMU A is sweeping. Bit B1 decimal value: 2 Binary value: 0000 0010 B2-B5 Not used Not applicable.
Page 609 Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual > > > > > > > > > > > > > > * Least significant bit ** Most significant bit 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.
Page 610: Status.operation.user
Model 2657A 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 operationRegister = Uses constants to set bit B1 and bit B10 of the status.operation.trigger_overrun.SMUA +...
Page 611 Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual Details These attributes are used to read or write to the operation status user registers. Reading a status register returns a value. The binary equivalent of the value indicates which register bits are set. In the binary equivalent, the least significant bit is bit B0, and the most significant bit is bit B15.
Page 612: Status.questionable
Model 2657A 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 1 operationRegister = status.operation.user.BIT11 + Uses constants to set bits B11 and B14 of the operation status user enable status.operation.user.BIT14...
Page 613 Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual Details These attributes are used to read or write to the questionable status registers. Reading a status register returns a value. In the binary equivalent, the least significant bit is bit B0, and the most significant bit is bit B15. For example, if a value of 1.22880e+04 (which is 12,288) is read as the value of the condition register, the binary...
Page 614: Status.questionable.calibration
Model 2657A 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)
Page 615: Status.questionable.instrument
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual Also see Questionable Status Registers (on page E-13) status.questionable.* (on page 7-299) status.questionable.instrument.* This attribute contains the questionable status instrument summary register set. Type TSP-Link accessible...
Page 616: Status.questionable.instrument.smux
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Also see Questionable Status Registers (on page E-13) status.questionable.* (on page 7-299) status.questionable.instrument.smuX.* This attribute contains the questionable status SMU X summary register set. Type TSP-Link accessible...
Page 617 Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents page E-1) and Enable and transition registers (on page E-19). The individual bits of this register are defined in the following table.
Page 618: Status.questionable.over_Temperature
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference status.questionable.over_temperature.* This attribute contains the questionable status over temperature summary register set. Type TSP-Link accessible Affected by Where saved Default value Attribute .condition (R) Not applicable...
Page 619: Status.questionable.unstable_Output
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual 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...
Page 620: Status.request_Enable
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Also see Questionable Status Registers (on page E-13) status.questionable.* (on page 7-299) status.request_enable This attribute stores the service request (SRQ) enable register. Type TSP-Link accessible Affected by...
Page 621 Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents page E-1) and Enable and transition registers (on page E-19). The individual bits of this register are defined in the following table.
Page 622: Status.request_Event
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference status.request_event This attribute stores the service request (SRQ) event register. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Not applicable Not saved Usage requestSRQEventRegister = status.request_event...
Page 623 Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents page E-1) and Enable and transition registers (on page E-19). The individual bits of this register are defined in the following table.
Page 624: Status.reset()
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference status.reset() This function resets all bits in the status model. Type TSP-Link accessible Affected by Where saved Default value Function Usage status.reset() Details This function clears all status data structure registers (enable, event, NTR, and PTR) to their default values. For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to...
Page 625 Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual Details These attributes are used to read or write to the standard event status registers. Reading a status register returns a value. The binary equivalent of the returned value indicates which register bits are set. The least significant bit of the binary number is bit B0, and the most significant bit is bit B15.
Page 626: Status.system
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference As an example, to set bit B0 of the standard event status enable register, set status.standard.enable = status.standard.OPC. In addition to the above constants, standardRegister can be set to the numeric equivalent of the bit to set. To set more than one bit of the register, set standardRegister to the sum of their decimal weights.
Page 627 Section 7: TSP command reference Model 2657A 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 628: Status.system2
Model 2657A 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 1 enableRegister = status.system.NODE11 + Uses constants to set bits B11 and B14 of the system summary enable register.
Page 629 Section 7: TSP command reference Model 2657A 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 630: Status.system3
Model 2657A 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 1 enableRegister = status.system2.NODE25 + Uses constants to set bits B11 and B14 of the system summary 2 enable status.system2.NODE28...
Page 631 Section 7: TSP command reference Model 2657A 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 632: Status.system4
Model 2657A 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 1 enableRegister = status.system3.NODE39 + Uses constants to set bits B11 and B14 of the system summary 3 enable status.system3.NODE42...
Page 633 Section 7: TSP command reference Model 2657A 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 634: Status.system5
Model 2657A 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 1 enableRegister = status.system4.NODE53 + Uses constants to set bit B11 and bit B14 of the system summary 4 enable status.system4.NODE56...
Page 635 Section 7: TSP command reference Model 2657A 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 636: Sweepilinmeasurev()
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Example 2 -- decimal 18 = binary 0000 0000 0001 0010 Uses a decimal value to set bits B1 and B4 of the system summary 5 enable enableRegister = 18 register.
Page 637: Sweepilistmeasurev()
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual Example SweepILinMeasureV(smua, -1E-3, 1E-3, 0, 100) This function performs a 100-point linear current sweep starting at −1 mA and stopping at +1 mA. Voltage is measured at every step (point) in the sweep.
Page 638: Sweepilogmeasurev()
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference SweepILogMeasureV() This KISweep factory script function performs a logarithmic current sweep with voltage measured at every step (point). Type TSP-Link accessible Affected by Where saved Default value...
Page 639: Sweepvlinmeasurei()
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual Example SweepILogMeasureV(smua, 0.01, 0.1, This function performs a five-point linear current sweep starting at 10 mA and stopping at 100 mA. Voltage is 0.001, 5) measured at every step (point) in the sweep. The source is allowed to settle on each step for 1 ms before a measurement is performed.
Page 640: Sweepvlistmeasurei()
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Figure 119: SweepVLinMeasureI() stopv stime stime startv stime = Current measurement Example SweepVLinMeasureI(smua, 500, 3000, 15e-3, This function performs a 26-point linear voltage sweep starting at 500 V and stopping at 3000 V.
Page 641: Sweepvlogmeasurei()
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual Example myvlist = {-100, 100, -200, 200, -400, This function performs a 10-point voltage list sweep starting at the first point in myvlist. Current is 400, -800, 800, -1600, 1600} measured at every step (point) in the sweep.
Page 642: Timer.measure.t()
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Figure 120: SweepVLogMeasureI() stopv stime stime startv stime = Current measurement Example SweepVLogMeasureI(smua, 100, This function performs a five-point logarithmic voltage sweep starting at 100 V and stopping at 1000 V. Current 1000, 0.02, 5)
Page 643: Timer.reset()
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual Example 2 beeper.beep(0.5, 2400) Sets the beeper, resets the timer, sets a delay, then verifies the time of the delay before the next beeper. print("reset timer") timer.reset()
Page 644: Trigger.blender[N].Event_Id
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Example trigger.blender[2].clear() Clears the event detector for blender 2. Also see None trigger.blender[N].EVENT_ID This constant contains the trigger blender event number. Type TSP-Link accessible Affected by...
Page 645: Trigger.blender[N].Overrun
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual Details This command selects whether the blender waits for any one event (the “OR” mode) or waits for all selected events (the “AND” mode) before signaling an output event.
Page 646: Trigger.blender[N].Reset()
Model 2657A 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()
Page 647 Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual The eventID parameter may be one of the existing trigger event IDs shown in the following table. Trigger event IDs* Event ID Event description Occurs when the source-measure unit (SMU) smua.trigger.SWEEPING_EVENT_ID...
Page 648: Trigger.blender[N].Wait()
Model 2657A 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) Trigger detection indication for blender...
Page 649: Trigger.clear()
Section 7: TSP command reference Model 2657A 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 650: Trigger.timer[N].Clear()
Model 2657A 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...
Page 651: Trigger.timer[N].Delay
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual trigger.timer[N].delay This attribute sets and reads the timer delay. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Instrument reset Not saved 10e-6 (10 μs)
Page 652: Trigger.timer[N].Event_Id
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Example trigger.timer[3].delaylist = {50e-6, 100e-6, 150e-6} Set a delay list on trigger timer 3 with three delays (50 µs, 100 µs, and 150 µs). DelayList = trigger.timer[3].delaylist for x = 1, table.getn(DelayList) do...
Page 653: Trigger.timer[N].Passthrough
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual Usage overrun = trigger.timer[N].overrun Trigger overrun state overrun Trigger timer number (1 to 8) Details This attribute indicates if an event was ignored because the event detector was already in the detected state when the event occurred.
Page 654: Trigger.timer[N].Reset()
Model 2657A 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()
Page 655 Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual Details The eventID parameter may be one of the trigger event IDs shown in the following table. Trigger event IDs* Event ID Event description smua.trigger.SWEEPING_EVENT_ID Occurs when the source-measure unit (SMU)
Page 656: Trigger.timer[N].Wait()
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference trigger.timer[N].wait() This function waits for a trigger. Type TSP-Link accessible Affected by Where saved Default value Function Usage triggered = trigger.timer[N].wait(timeout) Trigger detection indication triggered Trigger timer number (1 to 8)
Page 657: Tsplink.group
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual Details This function waits up to timeout seconds for a trigger on the active command interface. A command interface trigger occurs when: • A GPIB GET command is detected (GPIB only) •...
Page 658: Tsplink.master
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference 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...
Page 659: Tsplink.readbit()
Section 7: TSP command reference Model 2657A 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) The state of the synchronization line...
Page 660: Tsplink.reset()
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Also see TSP-Link synchronization lines (on page 3-86) tsplink.readbit() (on page 7-346) tsplink.writebit() (on page 7-356) tsplink.writeport() (on page 7-357) tsplink.reset() This function initializes (resets) all nodes (instruments) in the TSP-Link system.
Page 661: Tsplink.trigger[N].Assert()
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual Usage state = tsplink.state TSP-Link state (online or offline) state Details When the instrument power is first turned on, the state is "offline". After tsplink.reset() function is successful, the state is "online".
Page 662: Tsplink.trigger[N].Clear()
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference tsplink.trigger[N].clear() This function clears the event detector for a trigger. Type TSP-Link accessible Affected by Where saved Default value Function Usage tsplink.trigger[N].clear() The trigger line (1 to 3) Details The trigger event detector enters the detected state when an event is detected.
Page 663: Tsplink.trigger[N].Mode
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual Details This number is used by the TSP-Link trigger line when it detects an input trigger. Set the stimulus of any trigger object to the value of this constant to have the trigger object respond to trigger events from this line.
Page 664 Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference The setting for mode can be one of the following values: Mode Number Description value tsplink.TRIG_BYPASS Allows direct control of the line as a digital I/O line.
Page 665: Tsplink.trigger[N].Overrun
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual Also see digio.writebit() (on page 7-58) digio.writeport() (on page 7-58) tsplink.trigger[N].assert() (on page 7-348) tsplink.trigger[N].clear() (on page 7-349) tsplink.trigger[N].overrun (on page 7-352) tsplink.trigger[N].release() (on page 7-353) tsplink.trigger[N].reset()
Page 666: Tsplink.trigger[N].Pulsewidth
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference 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...
Page 667: Tsplink.trigger[N].Reset()
Section 7: TSP command reference Model 2657A 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()
Page 668 Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Usage eventID = tsplink.trigger[N].stimulus tsplink.trigger[N].stimulus = eventID The event identifier for the triggering event eventID The trigger line (1 to 3) Details To disable automatic trigger assertion on the synchronization line, set this attribute to zero (0).
Page 669: Tsplink.trigger[N].Wait()
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual tsplink.trigger[N].wait() This function waits for a trigger. Type TSP-Link accessible Affected by Where saved Default value Function Usage triggered = tsplink.trigger[N].wait(timeout) Trigger detection indication; set to one of the following values:...
Page 670: Tsplink.writeport()
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Details Use tsplink.writebit() and tsplink.writeport() to control the output state of the trigger line when trigger operation is set to tsplink.TRIG_BYPASS. If the output line is write-protected by the tsplink.writeprotect attribute, this command is ignored.
Page 671: Tsplink.writeprotect
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual 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...
Page 672: Tspnet.connect()
Additionally, the tspnet.tsp.* commands cannot be used on devices that are not TSP-enabled. If neither a portNumber nor an initString is provided, the remote device is assumed to be a Keithley Instruments TSP-enabled device. Depending on the state of the tspnet.tsp.abortonconnect attribute, the Model 2657A sends an abort command to the remote device on connection.
Page 673: Tspnet.disconnect()
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual Example 1 instrumentID = tspnet.connect("192.0.2.1") Connect to a TSP-enabled device. if instrumentID then -- Use instrumentID as needed here tspnet.disconnect(instrumentID) Example 2 instrumentID = tspnet.connect("192.0.2.1", 1394, Connect to a device that is "*rst\r\n")
Page 674: Tspnet.execute()
(tspnet.termination()). You can also specify a format string, which causes the command to wait for a response from the remote instrument. The Model 2657A decodes the response message according to the format specified in the format string and returns the message as return values from the function (see tspnet.read() for format specifiers).
Page 675: Tspnet.idn()
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual tspnet.idn() This function retrieves the response of the remote device to *IDN?. Type TSP-Link accessible Affected by Where saved Default value Function Usage idnString = tspnet.idn(connectionID)
Page 676: Tspnet.readavailable()
If formatString is not provided, the command returns a string that contains the data until a new line is reached. If no data is available, the Model 2657A pauses operation until the requested data is available or until a timeout error is generated. Use tspnet.timeout to specify the timeout period.
Page 677: Tspnet.reset()
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual Example ID = tspnet.connect("192.0.2.1") Send commands that will create data. tspnet.write(ID, "*idn?\r\n") Wait for data to be available. repeat bytes = tspnet.readavailable(ID) until bytes > 0 print(tspnet.read(ID))
Page 678: Tspnet.timeout
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Details This function sets and gets the termination character sequence that is used to indicate the end of a line for a TSP-Net connection. Using the termSequence parameter sets the termination sequence. The present termination sequence is always returned.
Page 679: Tspnet.tsp.abort()
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual tspnet.tsp.abort() This function causes the TSP-enabled instrument to stop executing any of the commands that were previously sent to it. Type TSP-Link accessible Affected by Where saved...
Page 680: Tspnet.tsp.rbtablecopy()
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Details This setting determines if the instrument sends an abort message when it attempts to connect to a TSP-enabled instrument using the tspnet.connect() function. When you send the abort command on an interface, it causes any other active interface on that instrument to close.
Page 681: Tspnet.tsp.runscript()
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual Also see None 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)
Page 682: Userstring.add()
The tspnet.write() function sends inputString to the remote instrument. It does not wait for command completion on the remote instrument. The Model 2657A sends inputString to the remote instrument exactly as indicated. The inputString must contain any necessary new lines, termination, or other syntax elements needed to complete properly.
Page 683: Userstring.catalog()
Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual userstring.catalog() This function creates an iterator for the user string catalog. Type TSP-Link accessible Affected by Where saved Default value Function Usage for name in userstring.catalog() do body end The name of the string;...
Page 684: Userstring.get()
Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference Details This function deletes the string that is associated with name from nonvolatile memory. Example userstring.delete("assetnumber") Deletes the user-defined strings associated with the "assetnumber", "product", and "contact" names.
Page 685 Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual Usage waitcomplete() waitcomplete(group) Specifies which TSP-Link group on which to wait group Details This function will wait for all previously started overlapped commands to complete. A group number may only be specified when this node is the master node.
Page 686: Troubleshooting Guide
Retrieving errors ............... 8-2 Error summary list ..............8-3 LAN troubleshooting suggestions ..........8-8 Introduction Troubleshooting information includes information on the Keithley Instruments Model 2657A High ® Power System SourceMeter instrument errors (including a complete listing of error messages) and LAN troubleshooting suggestions.
Page 687: Error Effects On Scripts
Section 8: Troubleshooting guide Model 2657A High Power System SourceMeter® Instrument Reference Manual Error effects on scripts Most errors will not abort a running script. The only time a script is aborted is when a Lua run-time error (error code -286, "TSP runtime error") is detected. Run-time errors are caused by actions such as trying to index into a variable that is not a table.
Page 688: Error Summary List
Model 2657A 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...
Page 689 Section 8: Troubleshooting guide Model 2657A High Power System SourceMeter® Instrument Reference Manual Error summary Error number Error level Error Message 1200 RECOVERABLE TSP-Link initialization failed 1202 RECOVERABLE TSP-Link initialization failed 1203 RECOVERABLE TSP-Link initialization failed (possible loop in node chain)
Page 690 Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 8: Troubleshooting guide Error summary Error number Error level Error Message 1500 RECOVERABLE Invalid baud rate setting 1501 RECOVERABLE Invalid parity setting 1503 RECOVERABLE Invalid bits setting 1504 RECOVERABLE Invalid flow control setting...
Page 691 Section 8: Troubleshooting guide Model 2657A High Power System SourceMeter® Instrument Reference Manual Error summary Error number Error level Error Message 2410 RECOVERABLE TSPnet max connections reached 2411 RECOVERABLE TSPnet connection failed 2412 RECOVERABLE TSPnet invalid termination 2413 RECOVERABLE TSPnet invalid reading buffer table...
Page 692 Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 8: Troubleshooting guide Error summary Error number Error level Error Message 5044 RECOVERABLE Cannot perform requested operation while current measure autorange is enabled 5045 RECOVERABLE Cannot perform requested operation while filter is enabled...
Page 693: Lan Troubleshooting Suggestions
Section 8: Troubleshooting guide Model 2657A High Power System SourceMeter® Instrument Reference Manual LAN troubleshooting suggestions If you are unable to connect to the instrument's web interface, 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 694: Frequently Asked Questions (Faqs)
To display the serial number on the front panel: 1. If the Model 2657A is in remote operation, press the EXIT (LOCAL) key once to place the instrument in local operation.
Page 695: How Do I Optimize Performance
How do I optimize performance? The primary factors that affect measurement accuracy and speed are: • Warm-up: For rated measurement accuracy, allow the Model 2657A to warm up for at least two hours before use. • Speed setting: The speed setting affects both speed and accuracy (for more information, see Setting speed (on page 2-78)).
Page 696: How Do I Trigger Other Instruments
Triggering a scanner A typical test scenario might call for using the Model 2657A with a scanner to test a number of devices under test (DUTs) in sequence. A basic example of this uses the Model 2657A digital I/O port to trigger a scanner (shown in the figure below).
Page 697: How Do I Generate A Gpib Service Request
= status.MSB Polling for SRQs To determine if the Model 2657A is the GPIB device that generated the service request (SRQ), serial poll the instrument for the status byte, and test to see if the corresponding summary bits are set.
Page 698: When Should I Change The Output-Off State
This is especially true when the device can deliver energy to the Model 2657A, such as a battery or capacitor. In these situations, you should use an output-off state that isolates the instrument from the device by either setting smuX.source.offfunc = smuX.OUTPUT_DCAMPS or smuX.source.offfunc =...
Page 699: How Do I Make Low-Current Measurements
Section 9: Frequently asked questions (FAQs) Model 2657A High Power System SourceMeter® Instrument Reference Manual How do I make low-current measurements? Low-current connections Low-current measurements (<1 mA) are subject to errors caused by leakage currents and leakage resistances in the signal path. Model 2657A instruments are equipped with triaxial connectors to minimize these problems.
Page 700 Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 9: Frequently asked questions (FAQs) Figure 122: Typical low-current connections Model 2657A SENSE 3030 VDC GUARD SENSE MAX. 250 V MAX. DIGITAL I/O +5 VDC Metal noise shield Ground symbols >1 GΩ...
Page 701: Low-Current Measurement Programming Example
How can I change the line frequency or voltage? The Model 2657A requires a line voltage of 100 V AC to 240 V AC (±10%), and a line frequency of 50 Hz or 60 Hz. At the factory, each Model 2657A is configured to match the power line frequency appropriate for your country (either 50 Hz or 60 Hz).
Page 702: Where Can I Get The Labview Driver
How do I connect LO terminals of multiple SMUs together? To connect the SENSE LO and LO terminals of the Model 2657A to other source-measure units (SMUs), use the Model 2657A-LIM-3 LO Interconnect Module. For more details, refer to the Model 2657A-LIM-3 LO Interconnect Module documentation (PA-1063).
Page 703: Why Is The Reading Value 9.91E37
• Incorrect channel setup The OVP limit can be set from the Model 2657A front panel or through a remote interface. To set the OVP limit from the instrument front panel: 1. Press the CONFIG key, and then select SRC > V-SOURCE > PROTECTION.
Page 704: Next Steps
Next steps In this section: Additional Model 2657A information ........10-1 Additional Model 2657A information For additional information about the Model 2657A, refer to: • The Product Information CD-ROM (which ships with the product). Contains software tools, drivers, and product documentation •...
Page 705: Maintenance
® 2657A High Power System SourceMeter instrument that can be performed by the operator. Line fuse replacement A fuse located on the Model 2657A rear panel protects the power line input of the High Power System ® SourceMeter instrument. WARNING Disconnect the line cord at the rear panel and remove all test leads connected to the instrument before replacing the line fuse.
Page 706: Front Panel Tests
Appendix A: Maintenance Model 2657A High Power System SourceMeter® Instrument Reference Manual WARNING To prevent injury, death, or instrument damage, use only the correct fuse type (see table). Perform the following steps to replace the line fuse: 1. Power off the instrument and remove the line cord.
Page 707: Keys Test
This test lets you check the functionality of each front panel key. Perform the following steps to run the KEYS test: 1. If the Model 2657A is in remote mode, press the EXIT (LOCAL) key once to place the instrument in local mode.
Page 708: Upgrading The Firmware
2. Disconnect the input and output terminals to and from the instrument. 3. Power on the Model 2657A. 4. If the Model 2657A is in remote mode, press the EXIT (LOCAL) key once to place the instrument in local mode.
Page 709: Using Tsb For Upgrading The Firmware
Appendix A: Maintenance Using TSB for upgrading the firmware After downloading the new flash file from the Keithley Instruments website, you can use Test Script Builder (TSB) to upgrade the firmware of your Model 2657A. 1. If not already running, start Test Script Builder (on the PC desktop, double-click the icon for the Test Script Builder).
Page 710: Calibration
Do not attempt to perform these procedures unless you are qualified to do so. Use the procedures in this section to verify that the Keithley Instruments Model 2657A High Power ®...
Page 711: Verification Test Requirements
±5 ºC of that adjustment temperature. Line power The Model 2657A requires a line voltage of 100 V to 240 V and a line frequency of 50 Hz or 60 Hz. Verification tests should be performed within this range.
Page 712 2ppm/°C * A voltage divider is needed only if the available meter cannot measure full scale values of the Model 2657A. The resistors (in the sample voltage divider circuit) are used to test signals > 1000 V with the recommended equipment.
Page 713: Restoring Factory Defaults
Model 2657A 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 2657A 200 V DC output range using a 180 V output value. Using the one-year accuracy specification for the 200 V range DC output of ±...
Page 714 1500 V peak above the maximum rated input. Do not connect the Model 2657A terminals to CAT II, CAT III, or CAT IV circuits. Connection of the Model 2657A terminals to circuits higher than CAT I can cause damage to the equipment or expose the operator to hazardous voltage.
Page 715: Current Source Accuracy
Current source accuracy Follow the steps below to verify that the Model 2657A output current accuracy is within specified limits. Figure 126: Connections for current verification...
Page 716 Model 2657A High Power System SourceMeter® Instrument Reference Manual Appendix B: Calibration 1. With the power off, connect the digital multimeter to the Model 2657A as shown in the figure titled "Connections for current verification." 2. Select the multimeter DC current measuring function.
Page 717: Current Measurement Accuracy
The procedure involves applying accurate currents from the Model 2657A current source and then verifying that Model 2657A current measurements are within required limits. 1. With the power off, connect the digital multimeter to the Model 2657A terminals as shown in the figure titled "Connections for current verification" in Current source accuracy (on page B-6).
Page 718: Voltage Source Accuracy
Select the correct source range. Set the Model 2657A output current such that the digital multimeter reading is the value indicated in the "Source current" column of the table below. It may not be possible to set the current source to get exactly the required reading on the digital multimeter.
Page 719 Appendix B: Calibration Model 2657A High Power System SourceMeter® Instrument Reference Manual 1. With the power off, connect the digital multimeter (DMM) to the Model 2657A output terminals using 4-wire connections, as shown below. Use the direct connection scheme for voltage ranges the digital multimeter used for calibration can measure.
Page 720 Model 2657A High Power System SourceMeter® Instrument Reference Manual Appendix B: Calibration Figure 128: Alternate connections for voltage verification (sample voltage divider shown) LINE FUSE SLOWBLOW 5.0 A, 250 V LINE RATING 100-240 VAC DIGITAL I/O RS-232 50, 60 Hz Model 2657A 350 VA MAX.
Page 721: Voltage Measurement Accuracy
3. Enable the Model 2657A 4-wire (remote sense) mode: a. Press the CONFIG key and then the MEAS key. b. Select V-MEAS > SENSE-MODE > 4-WIRE. 4. Set the Model 2657A SMU to both source and measure voltage by pressing the SRC and then the MEAS keys. B-12...
Page 722 Select the correct source range. • Set the Model 2657A output voltage such that the digital multimeter reading is the value indicated in the source voltage column of the table below. It may not be possible to set the voltage source to get exactly the required reading on the digital multimeter.
Page 723: Adjustment
Model 2657A is adjusted at a different temperature, the specifications apply to ±5 ºC of that adjustment temperature. Line power The Model 2657A requires a line voltage of 100 V to 240 V at a line frequency of 50 Hz or 60 Hz. The instrument must be calibrated within this range. Warmup period ®...
Page 724: Adjustment Considerations
1500 V peak above the maximum rated input. Do not connect the Model 2657A terminals to CAT II, CAT III, or CAT IV circuits. Connection of the Model 2657A terminals to circuits higher than CAT I can cause damage to the equipment or expose the operator to hazardous voltage.
Page 725: Calibration Adjustment Overview
** A voltage divider is needed only if the available digital multimeter cannot measure full scale values of the Model 2657A. The resistors (in the sample voltage divider circuit) are used to test signals with the recommended equipment > 1000 V. Before use, characterize the resistor to the uncertainty shown.
Page 726 Appendix B: Calibration Step sequence Adjustment steps must be performed in a specific sequence. See the table titled "Model 2657A calibration adjustment steps." Note that all steps are performed using 2-wire (local sensing) except as noted. Adjustment of each range is performed as a four-point calibration: •...
Page 727 Appendix B: Calibration Model 2657A High Power System SourceMeter® Instrument Reference Manual Model 2657A calibration adjustment steps Adjustment Adjustment Function Sense mode steps points 200 V ±1e-30, ±180 V smua.SENSE_LOCAL Voltage source and measure Step 2. Voltage calibration 200 V ±1e-30, ±180 V...
Page 728: Calibration Commands Quick Reference
Model 2657A High Power System SourceMeter® Instrument Reference Manual Appendix B: Calibration Calibration commands quick reference The following table summarizes remote calibration commands. For a more complete description of these commands, refer to the TSP command reference (on page 7-1).
Page 729: Calibration Adjustment Procedure
A. Connect the Model 2657A to the controller IEEE-488 interface, RS-232 port, or LAN using an appropriate interface cable. B. Turn on the Model 2657A and the test equipment, and allow them to warm up for at least two hours before performing calibration adjustment.
Page 730 Model 2657A High Power System SourceMeter® Instrument Reference Manual Appendix B: Calibration Figure 129: Connections for voltage calibration LINE FUSE SLOWBLOW 5.0 A, 250 V LINE RATING DIGITAL I/O RS-232 100-240 VAC 50, 60 Hz Model 2657A 350 VA MAX.
Page 731 Appendix B: Calibration Model 2657A High Power System SourceMeter® Instrument Reference Manual Figure 130: Connections for voltage calibration (direct connection) Input HI Digital multimeter Input LO Test fixture Model 2657A LINE FUSE SLOWBLOW 5.0 A, 250 V LINE RATING DIGITAL I/O...
Page 732 Turn on the output: smua.source.output = smua.OUTPUT_ON Allow the readings to settle, then get both the multimeter and Model 2657A voltage readings at the positive zero value (the Model 2657A measurement is not necessary if this calibration step is being done on the CALA sense mode).
Page 733 14. Turn on the output: smua.source.output = smua.OUTPUT_ON 15. Allow the readings to settle, then get both the multimeter and Model 2657A voltage readings at the negative zero value (the Model 2657A measurement is not necessary if this calibration step is being done on the CALA sense mode).
Page 734 E. Select automatic polarity mode: smua.cal.polarity = smua.CAL_AUTO Step 3. Current calibration adjustment A. Connect the Model 2657A 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...
Page 735 Turn on the output: smua.source.output = smua.OUTPUT_ON Allow the readings to settle, then get both the multimeter and Model 2657A current readings at the positive zero value (the Model 2657A measurement is not necessary if this calibration step is being done on the CALA sense mode).
Page 736 14. Turn on the output: smua.source.output = smua.OUTPUT_ON 15. Allow the readings to settle, then get both the multimeter and Model 2657A current readings at the negative zero value (the Model 2657A measurement is not necessary if this calibration step is being done on the CALA sense).
Page 737 -1e-30, -1e-6, -108e-3, -107.98e-3) 22. If this step is not on the CALA sense mode, send the measure calibration command using the multimeter and Model 2657A readings, and range setting for the parameters: smua.measure.calibratei(-range, Z_rdg, DMM_Z_rdg, FS_rdg, DMM_FS_rdg) Where:...
Page 738 Pin 22 = +5 V Pin 24 = Interlock (INT) B. Allow the readings to settle, then get the Model 2657A readings: r0_hi, r0_lo = smua.contact.r() C. Characterize both 50 Ω resistors using the resistance function of the digital multimeter.
Page 739 Appendix B: Calibration Model 2657A High Power System SourceMeter® Instrument Reference Manual E. Allow the readings to settle, then get the Model 2657A 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: = Model 2657A 0 Ω...
Page 740 Model 2657A High Power System SourceMeter® Instrument Reference Manual Appendix B: Calibration Step 7. Save calibration constants Calibration adjustment is now complete, so you can store the calibration constants in nonvolatile memory by sending the following command: smua.cal.save() NOTE Unless you send the save command, the calibration adjustment you just performed will be temporary.
Page 741: Lan Concepts And Settings
The Keithley Instruments Model 2657A High Power System SourceMeter instrument is LXI version 1.4 Core 2011 compliant. The Model 2657A is a scalable test system that can connect directly to a host computer or interact with a DHCP or DNS server and other LXI-compliant instruments on a local area network (LAN).
Page 742: Step 1: Identify And Record The Existing Ip Configuration
Appendix C: LAN concepts and settings Model 2657A High Power System SourceMeter® Instrument Reference Manual CAUTION Contact your corporate information technology (IT) department for permission before you connect the Model 2657A to a corporate network. If you have problems, see LAN troubleshooting suggestions (on page 8-8).
Page 743: Step 2: Disable Dhcp To Use The Computer's Existing Ip Address
Model 2657A High Power System SourceMeter® Instrument Reference Manual Appendix C: LAN concepts and settings Figure 134: Computer IP configuration using the command prompt DHCP Enabled: Network card IP Address Subnet Mask 255.255.255.0 NOTE If the information for the ethernet adapter displays "Media Disconnected," close the command...
Page 744 Appendix C: LAN concepts and settings Model 2657A High Power System SourceMeter® Instrument Reference Manual Step 2: Disable DHCP to use the computer's existing IP address NOTE Do not change the IP address at any time without talking to your system administrator. Entering an incorrect IP address can prevent your workstation from connecting to your corporate network.
Page 745 Model 2657A High Power System SourceMeter® Instrument Reference Manual Appendix C: LAN concepts and settings 5. Select Use the following IP address. The option for "Use the following DNS server addresses" is automatically selected. 6. Set the IP address. If the IP address and subnet mask fields: •...
Page 746 Appendix C: LAN concepts and settings Model 2657A High Power System SourceMeter® Instrument Reference Manual 5. Select Use the following IP address. The option for "Use the following DNS server addresses" is automatically selected. 6. Set the IP address. If the IP address and subnet mask fields: •...
Page 747 Model 2657A High Power System SourceMeter® Instrument Reference Manual Appendix C: LAN concepts and settings 8. Select Use the following IP address. The option for "Use the following DNS server addresses" is automatically selected. 9. Set the IP address. If the IP address and subnet mask fields: •...
Page 748: Step 3: Configure The Instrument's Lan Settings
Appendix C: LAN concepts and settings Model 2657A High Power System SourceMeter® Instrument Reference Manual 5. Select Use the following IP address. The option for "Use the following DNS server addresses" is automatically selected. 6. Set the IP address. If the IP address and subnet mask fields: •...
Page 749: Step 4: Install The Crossover Cable
Connect the supplied crossover cable between the computer's network adapter card and the LAN connector on the instrument’s rear panel. There are other similar connectors on the Model 2657A rear panel. Be sure to connect to the LAN connection port (see the following figure).
Page 750: Connecting To The Lan
(IT) department for details about obtaining an IP address before you deploy the Model 2657A on a corporate or private network. CAUTION Contact your corporate IT department for permission before you connect the Model 2657A to a corporate network. Setting the LAN configuration method There are two methods used to configure the LAN.
Page 751: Setting The Ip Address
Model 2657A High Power System SourceMeter® Instrument Reference Manual Appendix C: LAN concepts and settings Setting the IP address NOTE Contact your corporate information technology (IT) department to secure a valid IP address for the instrument when placing the instrument on a corporate network.
Page 752: Configuring The Domain Name System (Dns
7. Select APPLY_SETTINGS > YES, and then press the ENTER key. LAN speeds Another characteristic of the LAN is speed. The Model 2657A negotiates with the host computer and other LXI-compliant devices on the LAN to transmit data at the highest speed possible. LAN speeds must be configured to match the speed of the other instruments on the network.
Page 753: Duplex Mode
Model 2657A High Power System SourceMeter® Instrument Reference Manual Appendix C: LAN concepts and settings To set the LAN speed: 1. From the front panel, press the MENU key and select LAN > CONFIG > SPEED. 2. Turn the navigation wheel to select either 10 Mbps or 100 Mbps.
Page 754: Viewing The Network Settings
4. Press the EXIT (LOCAL) key once to return to the STATUS menu. Confirming the active speed and duplex negotiation The Model 2657A 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 755: Confirming Port Numbers
3. Press the ENTER key to view the port number. 4. Press the EXIT (LOCAL) key once to return to the PORT menu. The following table displays the remote interface protocols supported by the Model 2657A and their assigned port numbers.
Page 756: Raw Socket Connection
Telnet requires a separate Telnet program. The Model 2657A supports the Telnet protocol, which you can use over a TCP/IP connection to send commands to the instrument. You can use a Telnet connection to interact with scripts or send real-time commands.
Page 757 Model 2657A High Power System SourceMeter® Instrument Reference Manual Appendix C: LAN concepts and settings 2. Type a name to identify the connection (for example, My Instrument), and then click OK. 3. In the Connect To dialog box, click the Connect using list. Select TCP/IP (Winsock).
Page 758 Appendix C: LAN concepts and settings Model 2657A High Power System SourceMeter® Instrument Reference Manual Figure 143: Properties dialog box My Instrument Properties 8. Click ASCII Setup. The ASCII Setup dialog box is displayed. 9. From the ASCII Setup dialog box, select the following options: •...
Page 759: Dead Socket Connection
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 2657A, and you can view the event log using any command interface or the embedded web interface. The following figure shows the view of the LXI event log from the embedded web interface.
Page 760: Accessing The Event Log From The Command Interface
Appendix C: LAN concepts and settings Model 2657A High Power System SourceMeter® Instrument Reference Manual The timestamp, event identifier, IP address, and the domain name identify the incoming and outgoing LXI trigger packets. The following table provides detailed descriptions for the columns in the event log.
Page 761 Model 2657A High Power System SourceMeter® Instrument Reference Manual Appendix C: LAN concepts and settings This command outputs one or more strings similar to the following: 14:14:02.000 17 Jun 2008, LAN0, 10.80.64.191, LXI, 0, 1213712000, not available, 0, 0x10,0x00 The string displays the same information as the web interface. Commas separate the fields. The fields output in the following order: •...
Page 762: Common Commands
Although commands are shown in uppercase, common commands are not case sensitive, and either uppercase or lowercase can be used. Note that although these commands are essentially the same as those defined by the IEEE Std 488.2 standard, the Model 2657A does not strictly conform to that standard.
Page 763 Appendix D: Common commands Model 2657A High Power System SourceMeter® Instrument Reference Manual NOTE Unlike other commands, like those listed in TSP commands (on page 7-8), each common command must be sent in a separate message. The common commands cannot be used in scripts.
Page 764: Script Command Equivalents
Model 2657A High Power System SourceMeter® Instrument Reference Manual Appendix D: Common commands Script command equivalents The commands that can be included in scripts that are equivalent to the common commands are defined in the table below. Common Script command equivalent...
Page 765: Operation Complete And Query: *Opc And *Opc
Places a zero (0) in the output queue This command always places a zero (0) in the output queue. This command is included for common command compatibility only; the Model 2657A does not actually perform a self-test. Trigger: *TRG Generates a command interface trigger event for the trigger model.
Page 766: Wait-To-Continue: *Wai
Model 2657A High Power System SourceMeter® Instrument Reference Manual Appendix D: 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 767: Status Model
TSP-Link system status ............E-26 Overview Each Keithley Instruments Model 2657A provides a number of status registers and queues that are collectively referred to as the status model. Through manipulation and monitoring of these registers and queues, you can view and control various instrument events. You can include commands in your test program that can determine if a service request (SRQ) event has occurred and the cause of the event.
Page 768: Queues
Command queue The command queue holds commands that have been received from a remote interface that are available for execution. This allows the Model 2657A to accept multiple commands and queue them for execution. When a command is received from a remote interface, the command available (CAV) bit in the Operation Status Remote Summary Register is set.
Page 769 Model 2657A High Power System SourceMeter® Instrument Reference Manual Appendix E: Status model Error queue The error queue holds error and status messages. As programming errors and status messages occur, a message that defines the error or status is placed in the error queue.
Page 770: Status Function Summary
Appendix E: Status model Model 2657A 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-8).
Page 771: Status Model Diagrams
Model 2657A High Power System SourceMeter® Instrument Reference Manual Appendix E: Status model Status model diagrams The following figures graphically describe the status model: • Status byte and service request enable registers (on page E-6) • Measurement event registers (on page E-8) •...
Page 772 Appendix E: Status model Model 2657A High Power System SourceMeter® Instrument Reference Manual Figure 147: Status byte and service request enable registers Status Byte Service Request Enable Error/Event Queue (status.conditions/STB) (request_enable/SRE) Measurement Summary Bit (MSB) & System Summary Bit (SSB) &...
Page 773 Model 2657A High Power System SourceMeter® Instrument Reference Manual Appendix E: Status model Figure 148: System summary and standard event registers System Summary System Summary Register 3 (system3) Register 2 (system2) Extension Bit (EXT) Extension Bit (EXT) Node 29 (NODE29)
Page 774 Appendix E: Status model Model 2657A High Power System SourceMeter® Instrument Reference Manual Figure 149: Measurement event registers Measurement Event Measurement Event Register (measurement) Current Limit Summary Voltage Limit (VLMT) SMU A (SMUA) Current Limit (ILMT) To Measurement Summary Bit (MSB) in Status Byte Sink Limit (SLMT) (status.condition/STB)
Page 775 Model 2657A High Power System SourceMeter® Instrument Reference Manual Appendix E: Status model Figure 150: Operation status registers Operation Status Operation Status Calibration Summary Register (operation/OSR) Calibrating (CAL) SMU A (SMUA) To Operation Summary Bit (OSB) in Status Byte (status.condition/STB)
Page 776 Appendix E: Status model Model 2657A High Power System SourceMeter® Instrument Reference Manual Figure 151: Operation status trigger overrun registers Operation Status SMU A Trigger Overrun Register Arm Overrun (ARM) Source Overrun (SRC) Measure Overrun (MEAS) End Pulse Overrun (ENDP)
Page 777 Model 2657A High Power System SourceMeter® Instrument Reference Manual Appendix E: Status model Figure 152: Operation status trigger timer, trigger blender, and remote registers Command Queue Operation Status Remote Summary Register Queue Not Empty Command Available (CAV) To Remote Summary Bit (REM) in Operation Status Summary Register (status.operation)
Page 778 Appendix E: Status model Model 2657A High Power System SourceMeter® Instrument Reference Manual Figure 153: Operation status digital I/O and TSP-Link registers Operation Status Digital I/O Operation Status Digital Summary Register I/O Overrun Register To Digital I /O Bit (DIGIO) in...
Page 779: Clearing Registers
Model 2657A High Power System SourceMeter® Instrument Reference Manual Appendix E: Status model Figure 154: Questionable status registers Questionable Status Calibration Summary Questionable Status Register Register (questionable/QSR) SMU A (SMUA) To Questionable Summary Bit (QSB) in Status Byte (STB) Calibration (CAL)
Page 780: Programming And Reading Registers
Appendix E: Status model Model 2657A High Power System SourceMeter® Instrument Reference Manual Programming and reading registers Programming enable and transition registers The only registers that you can program are the enable and transition registers. All other registers in the status structure are read-only registers. The following explains how to determine the parameter values for the various commands used to program enable registers.
Page 781: Reading Registers
Model 2657A High Power System SourceMeter® Instrument Reference Manual Appendix E: Status model Reading registers Any register in the status structure can be read either by sending the common command query (where applicable), or by including the script command for that register in either the print() or print(tostring()) command.
Page 782 Appendix E: Status model Model 2657A High Power System SourceMeter® Instrument Reference Manual Figure 156: Status byte and service request (SRQ) Status Summary Message Read by Serial Poll Service *STB? Status Byte Request (B6) Register Serial Poll (B7) (B5) (B4)
Page 783: Service Request Enable Register
Status Byte Register is either the Request for Service (RQS) bit or the Master Summary Status (MSS) bit: • When using the GPIB or VXI-11 serial poll sequence of the Model 2657A to obtain the status byte (serial poll byte), B6 is the RQS bit. See Serial polling and SRQ (on page E-18) for details on using the serial poll sequence.
Page 784: Serial Polling And Srq
Appendix E: Status model Model 2657A 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 has occurred and what caused it.
Page 785: Enable And Transition Registers
Model 2657A High Power System SourceMeter® Instrument Reference Manual Appendix E: Status model Enable and transition registers In general, there are three types of user-writable registers that are used to configure which bits feed the register summary bit and when it occurs. The registers are identified in each applicable command...
Page 786: Standard Event Register
Bit B0, Operation Complete (OPC): Set bit indicates that all pending selected device operations are completed and the Model 2657A 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 787 Model 2657A High Power System SourceMeter® Instrument Reference Manual Appendix E: Status model Commands to program and read the register are summarized below and also in the Status function summary (on page E-4) table. Figure 157: Standard event register Standard *ESR? —...
Page 788: Operation Status Registers
Appendix E: Status model Model 2657A High Power System SourceMeter® Instrument Reference Manual Operation Status Registers As shown in the status model's Operation status registers (on page E-9) diagram, there are 22 register sets associated with operation status. Commands are summarized in the...
Page 789: Questionable Status Registers
Model 2657A High Power System SourceMeter® Instrument Reference Manual Appendix E: Status model 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 790: Measurement Event Registers
Appendix E: Status model Model 2657A High Power System SourceMeter® Instrument Reference Manual Measurement Event Registers As shown in the status model's Measurement event registers (on page E-8), there are eight register sets associated with measurement event status. Commands are summarized in the...
Page 791: Register Programming Example
Model 2657A High Power System SourceMeter® Instrument Reference Manual Appendix E: Status model Register programming example The command sequence below programs the instrument to generate a service request (SRQ) and set the system summary bit in all TSP-Link nodes when the current limit on channel A is exceeded.
Page 792: Tsp-Link System Status
Appendix E: Status model Model 2657A High Power System SourceMeter® Instrument Reference Manual TSP-Link system status ® The TSP-Link expansion interface allows instruments to communicate with each other. The test system can be expanded to include up to 32 TSP-enabled instruments. In a TSP-Link system, one node (instrument) is the master and the other nodes are the subordinates.
Page 793 Model 2657A High Power System SourceMeter® Instrument Reference Manual Appendix E: Status model Status configuration (enable) commands The following commands (sent from the master node) enable the appropriate register bits for the above example: Node 15 status registers: The following commands enable the current limit events for SMU A of node node[15].status.measurement.current_limit.enable = 2...
Page 794 Appendix E: Status model Model 2657A 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 (see following figure).
Page 795: Display Character Codes
Appendix F Display character codes In this appendix: Model 2657A display character codes ........F-1 Model 2657A display character codes The following tables contain the display character codes (decimal values) and their corresponding display. Display character codes (decimal 0 to 39)
Page 796 Appendix F: Display character codes Model 2657A High Power System SourceMeter® Instrument Reference Manual Display character codes (decimal 40 to 102) Decimal Display Decimal Display Decimal Display > , (comma) ' (open single quote) < 2657A-901-01 Rev. B/December 2012...
Page 797 Model 2657A High Power System SourceMeter® Instrument Reference Manual Appendix F: Display character codes Display character codes (decimal 103 to 165 ) Decimal Display Decimal Display Decimal Display (space) ¼ 2657A-901-01 Rev. B/December 2012...
Page 798 Appendix F: Display character codes Model 2657A High Power System SourceMeter® Instrument Reference Manual Display character codes (decimal 166 to 228) Decimal Display Decimal Display Decimal Display Φ æ ∩ Æ ∪ â ÷ ä α ≤ á ß ≥...
Page 799 Model 2657A High Power System SourceMeter® Instrument Reference Manual Appendix F: Display character codes Display character codes (decimal 229 to 255 ) Decimal Display Decimal Display Decimal Display ó ñ ò Ñ ÿ Ö û † ü ↑ ↓ ú...
Page 800: Index
• A-3 device control • 6-62 resolution • 2-77, 3-69 queries • 5-2 running a test • 3-78 reference • 7-1 text messages • 3-71 compliance limits • 2-18 triggering • 3-78 principles • 4-2 2657A-901-01 Rev. B/December 2012...
Page 801 • B-2 fuse load test menu • 3-76 line, replacement • A-1 local group • 7-155 logical G logical AND operation • 7-10 GPIB • 2-83 logical OR operation • 7-10 gpib attribute loop control • 6-20 2657A-901-01 Rev. B/December 2012...
Page 802 • 3-8 output-off limits (compliance) • 2-69 status • 3-16 output-off modes • 2-66 storage • 3-8 remote programming quick reference • 2-70 storage control attributes • 3-12 overheating protection • 4-2 timestamp • 3-9 2657A-901-01 Rev. B/December 2012...
Page 803 • 6-3 pulse mode sweeps • 3-26 name attribute • 7-165 named • 6-4, 6-6 T parallel test, running • 6-57 restoring in run-time environment • 6-46 Telnet running • 6-5, 6-6, 6-57 configuring • C-19 2657A-901-01 Rev. B/December 2012...
Page 804 • 3-86 digital I/O • 3-86 remote commands • 3-86 triggering • 6-53 TSP-Net • 6-60 U unnamed scripts • 6-5 saving reading buffer to • 3-8 user scripts creating • 6-3 modifying • 6-43 2657A-901-01 Rev. B/December 2012...
Page 805 M E A S U R E C O N F I D E N C E Keithley Instruments, Inc. Corporate Headquarters • 28775 Aurora Road • Cleveland, Ohio 44139 • 440-248-0400 • Fax: 440-248-6168 • 1-888-KEITHLEY • www.keithley.com 12/06...

Save PDF